From 9e9b1af438cc70bb0955993c3cf0fac1fb473446 Mon Sep 17 00:00:00 2001 From: Ruslan Piatrovich Date: Wed, 7 Aug 2024 16:52:02 +0300 Subject: [PATCH] init --- .venv/bin/Activate.ps1 | 247 + .venv/bin/activate | 70 + .venv/bin/activate.csh | 27 + .venv/bin/activate.fish | 69 + .venv/bin/normalizer | 8 + .venv/bin/pip | 8 + .venv/bin/pip3 | 8 + .venv/bin/pip3.12 | 8 + .venv/bin/python | 1 + .venv/bin/python3 | 1 + .venv/bin/python3.12 | 1 + .../certifi-2024.7.4.dist-info/INSTALLER | 1 + .../certifi-2024.7.4.dist-info/LICENSE | 20 + .../certifi-2024.7.4.dist-info/METADATA | 67 + .../certifi-2024.7.4.dist-info/RECORD | 14 + .../certifi-2024.7.4.dist-info/WHEEL | 5 + .../certifi-2024.7.4.dist-info/top_level.txt | 1 + .../site-packages/certifi/__init__.py | 4 + .../site-packages/certifi/__main__.py | 12 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 305 bytes .../__pycache__/__main__.cpython-312.pyc | Bin 0 -> 620 bytes .../certifi/__pycache__/core.cpython-312.pyc | Bin 0 -> 3190 bytes .../site-packages/certifi/cacert.pem | 4798 +++++++++ .../python3.12/site-packages/certifi/core.py | 114 + .../python3.12/site-packages/certifi/py.typed | 0 .../INSTALLER | 1 + .../LICENSE | 21 + .../METADATA | 683 ++ .../charset_normalizer-3.3.2.dist-info/RECORD | 35 + .../charset_normalizer-3.3.2.dist-info/WHEEL | 6 + .../entry_points.txt | 2 + .../top_level.txt | 1 + .../charset_normalizer/__init__.py | 46 + .../charset_normalizer/__main__.py | 4 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 1724 bytes .../__pycache__/__main__.cpython-312.pyc | Bin 0 -> 294 bytes .../__pycache__/api.cpython-312.pyc | Bin 0 -> 17327 bytes .../__pycache__/cd.cpython-312.pyc | Bin 0 -> 13487 bytes .../__pycache__/constant.cpython-312.pyc | Bin 0 -> 38751 bytes .../__pycache__/legacy.cpython-312.pyc | Bin 0 -> 2495 bytes .../__pycache__/md.cpython-312.pyc | Bin 0 -> 24509 bytes .../__pycache__/models.cpython-312.pyc | Bin 0 -> 16599 bytes .../__pycache__/utils.cpython-312.pyc | Bin 0 -> 14362 bytes .../__pycache__/version.cpython-312.pyc | Bin 0 -> 321 bytes .../site-packages/charset_normalizer/api.py | 626 ++ .../site-packages/charset_normalizer/cd.py | 395 + .../charset_normalizer/cli/__init__.py | 6 + .../charset_normalizer/cli/__main__.py | 296 + .../cli/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 282 bytes .../cli/__pycache__/__main__.cpython-312.pyc | Bin 0 -> 10386 bytes .../charset_normalizer/constant.py | 1995 ++++ .../charset_normalizer/legacy.py | 54 + .../md.cpython-312-x86_64-linux-gnu.so | Bin 0 -> 16064 bytes .../site-packages/charset_normalizer/md.py | 615 ++ .../md__mypyc.cpython-312-x86_64-linux-gnu.so | Bin 0 -> 272640 bytes .../charset_normalizer/models.py | 340 + .../site-packages/charset_normalizer/py.typed | 0 .../site-packages/charset_normalizer/utils.py | 421 + .../charset_normalizer/version.py | 6 + .../python3.12/site-packages/dns/__init__.py | 70 + .../dns/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 716 bytes .../__pycache__/_asyncbackend.cpython-312.pyc | Bin 0 -> 4784 bytes .../_asyncio_backend.cpython-312.pyc | Bin 0 -> 14121 bytes .../dns/__pycache__/_ddr.cpython-312.pyc | Bin 0 -> 7833 bytes .../dns/__pycache__/_features.cpython-312.pyc | Bin 0 -> 3282 bytes .../_immutable_ctx.cpython-312.pyc | Bin 0 -> 3229 bytes .../__pycache__/_trio_backend.cpython-312.pyc | Bin 0 -> 13172 bytes .../__pycache__/asyncbackend.cpython-312.pyc | Bin 0 -> 3412 bytes .../__pycache__/asyncquery.cpython-312.pyc | Bin 0 -> 31670 bytes .../__pycache__/asyncresolver.cpython-312.pyc | Bin 0 -> 21326 bytes .../dns/__pycache__/dnssec.cpython-312.pyc | Bin 0 -> 50891 bytes .../__pycache__/dnssectypes.cpython-312.pyc | Bin 0 -> 1970 bytes .../dns/__pycache__/e164.cpython-312.pyc | Bin 0 -> 4903 bytes .../dns/__pycache__/edns.cpython-312.pyc | Bin 0 -> 22032 bytes .../dns/__pycache__/entropy.cpython-312.pyc | Bin 0 -> 5965 bytes .../dns/__pycache__/enum.cpython-312.pyc | Bin 0 -> 4878 bytes .../dns/__pycache__/exception.cpython-312.pyc | Bin 0 -> 7222 bytes .../dns/__pycache__/flags.cpython-312.pyc | Bin 0 -> 3072 bytes .../dns/__pycache__/grange.cpython-312.pyc | Bin 0 -> 1772 bytes .../dns/__pycache__/immutable.cpython-312.pyc | Bin 0 -> 3782 bytes .../dns/__pycache__/inet.cpython-312.pyc | Bin 0 -> 6695 bytes .../dns/__pycache__/ipv4.cpython-312.pyc | Bin 0 -> 2722 bytes .../dns/__pycache__/ipv6.cpython-312.pyc | Bin 0 -> 6858 bytes .../dns/__pycache__/message.cpython-312.pyc | Bin 0 -> 83663 bytes .../dns/__pycache__/name.cpython-312.pyc | Bin 0 -> 49224 bytes .../dns/__pycache__/namedict.cpython-312.pyc | Bin 0 -> 4356 bytes .../__pycache__/nameserver.cpython-312.pyc | Bin 0 -> 14133 bytes .../dns/__pycache__/node.cpython-312.pyc | Bin 0 -> 16639 bytes .../dns/__pycache__/opcode.cpython-312.pyc | Bin 0 -> 3130 bytes .../dns/__pycache__/query.cpython-312.pyc | Bin 0 -> 59067 bytes .../dns/__pycache__/rcode.cpython-312.pyc | Bin 0 -> 4427 bytes .../dns/__pycache__/rdata.cpython-312.pyc | Bin 0 -> 37461 bytes .../__pycache__/rdataclass.cpython-312.pyc | Bin 0 -> 3518 bytes .../dns/__pycache__/rdataset.cpython-312.pyc | Bin 0 -> 22964 bytes .../dns/__pycache__/rdatatype.cpython-312.pyc | Bin 0 -> 10114 bytes .../dns/__pycache__/renderer.cpython-312.pyc | Bin 0 -> 16226 bytes .../dns/__pycache__/resolver.cpython-312.pyc | Bin 0 -> 88375 bytes .../__pycache__/reversename.cpython-312.pyc | Bin 0 -> 4724 bytes .../dns/__pycache__/rrset.cpython-312.pyc | Bin 0 -> 12483 bytes .../dns/__pycache__/serial.cpython-312.pyc | Bin 0 -> 5182 bytes .../dns/__pycache__/set.cpython-312.pyc | Bin 0 -> 12157 bytes .../dns/__pycache__/tokenizer.cpython-312.pyc | Bin 0 -> 26544 bytes .../__pycache__/transaction.cpython-312.pyc | Bin 0 -> 29402 bytes .../dns/__pycache__/tsig.cpython-312.pyc | Bin 0 -> 16756 bytes .../__pycache__/tsigkeyring.cpython-312.pyc | Bin 0 -> 2910 bytes .../dns/__pycache__/ttl.cpython-312.pyc | Bin 0 -> 2443 bytes .../dns/__pycache__/update.cpython-312.pyc | Bin 0 -> 16328 bytes .../dns/__pycache__/version.cpython-312.pyc | Bin 0 -> 775 bytes .../dns/__pycache__/versioned.cpython-312.pyc | Bin 0 -> 14685 bytes .../dns/__pycache__/win32util.cpython-312.pyc | Bin 0 -> 9862 bytes .../dns/__pycache__/wire.cpython-312.pyc | Bin 0 -> 5449 bytes .../dns/__pycache__/xfr.cpython-312.pyc | Bin 0 -> 14488 bytes .../dns/__pycache__/zone.cpython-312.pyc | Bin 0 -> 67615 bytes .../dns/__pycache__/zonefile.cpython-312.pyc | Bin 0 -> 33830 bytes .../dns/__pycache__/zonetypes.cpython-312.pyc | Bin 0 -> 1344 bytes .../site-packages/dns/_asyncbackend.py | 99 + .../site-packages/dns/_asyncio_backend.py | 275 + .../lib/python3.12/site-packages/dns/_ddr.py | 154 + .../python3.12/site-packages/dns/_features.py | 92 + .../site-packages/dns/_immutable_ctx.py | 76 + .../site-packages/dns/_trio_backend.py | 250 + .../site-packages/dns/asyncbackend.py | 101 + .../site-packages/dns/asyncquery.py | 780 ++ .../site-packages/dns/asyncresolver.py | 475 + .../python3.12/site-packages/dns/dnssec.py | 1223 +++ .../site-packages/dns/dnssecalgs/__init__.py | 120 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 5516 bytes .../__pycache__/base.cpython-312.pyc | Bin 0 -> 4560 bytes .../__pycache__/cryptography.cpython-312.pyc | Bin 0 -> 3825 bytes .../__pycache__/dsa.cpython-312.pyc | Bin 0 -> 6164 bytes .../__pycache__/ecdsa.cpython-312.pyc | Bin 0 -> 5977 bytes .../__pycache__/eddsa.cpython-312.pyc | Bin 0 -> 4140 bytes .../__pycache__/rsa.cpython-312.pyc | Bin 0 -> 7196 bytes .../site-packages/dns/dnssecalgs/base.py | 84 + .../dns/dnssecalgs/cryptography.py | 68 + .../site-packages/dns/dnssecalgs/dsa.py | 101 + .../site-packages/dns/dnssecalgs/ecdsa.py | 89 + .../site-packages/dns/dnssecalgs/eddsa.py | 65 + .../site-packages/dns/dnssecalgs/rsa.py | 119 + .../site-packages/dns/dnssectypes.py | 71 + .../lib/python3.12/site-packages/dns/e164.py | 116 + .../lib/python3.12/site-packages/dns/edns.py | 516 + .../python3.12/site-packages/dns/entropy.py | 130 + .../lib/python3.12/site-packages/dns/enum.py | 116 + .../python3.12/site-packages/dns/exception.py | 169 + .../lib/python3.12/site-packages/dns/flags.py | 123 + .../python3.12/site-packages/dns/grange.py | 72 + .../python3.12/site-packages/dns/immutable.py | 68 + .../lib/python3.12/site-packages/dns/inet.py | 197 + .../lib/python3.12/site-packages/dns/ipv4.py | 77 + .../lib/python3.12/site-packages/dns/ipv6.py | 219 + .../python3.12/site-packages/dns/message.py | 1888 ++++ .../lib/python3.12/site-packages/dns/name.py | 1283 +++ .../python3.12/site-packages/dns/namedict.py | 109 + .../site-packages/dns/nameserver.py | 359 + .../lib/python3.12/site-packages/dns/node.py | 359 + .../python3.12/site-packages/dns/opcode.py | 117 + .../lib/python3.12/site-packages/dns/py.typed | 0 .../lib/python3.12/site-packages/dns/query.py | 1578 +++ .../site-packages/dns/quic/__init__.py | 75 + .../quic/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 3086 bytes .../quic/__pycache__/_asyncio.cpython-312.pyc | Bin 0 -> 16844 bytes .../quic/__pycache__/_common.cpython-312.pyc | Bin 0 -> 10291 bytes .../quic/__pycache__/_sync.cpython-312.pyc | Bin 0 -> 15787 bytes .../quic/__pycache__/_trio.cpython-312.pyc | Bin 0 -> 13679 bytes .../site-packages/dns/quic/_asyncio.py | 228 + .../site-packages/dns/quic/_common.py | 224 + .../site-packages/dns/quic/_sync.py | 238 + .../site-packages/dns/quic/_trio.py | 210 + .../lib/python3.12/site-packages/dns/rcode.py | 168 + .../lib/python3.12/site-packages/dns/rdata.py | 884 ++ .../site-packages/dns/rdataclass.py | 118 + .../python3.12/site-packages/dns/rdataset.py | 516 + .../python3.12/site-packages/dns/rdatatype.py | 332 + .../site-packages/dns/rdtypes/ANY/AFSDB.py | 45 + .../site-packages/dns/rdtypes/ANY/AMTRELAY.py | 91 + .../site-packages/dns/rdtypes/ANY/AVC.py | 26 + .../site-packages/dns/rdtypes/ANY/CAA.py | 71 + .../site-packages/dns/rdtypes/ANY/CDNSKEY.py | 33 + .../site-packages/dns/rdtypes/ANY/CDS.py | 29 + .../site-packages/dns/rdtypes/ANY/CERT.py | 116 + .../site-packages/dns/rdtypes/ANY/CNAME.py | 28 + .../site-packages/dns/rdtypes/ANY/CSYNC.py | 68 + .../site-packages/dns/rdtypes/ANY/DLV.py | 24 + .../site-packages/dns/rdtypes/ANY/DNAME.py | 27 + .../site-packages/dns/rdtypes/ANY/DNSKEY.py | 33 + .../site-packages/dns/rdtypes/ANY/DS.py | 24 + .../site-packages/dns/rdtypes/ANY/EUI48.py | 30 + .../site-packages/dns/rdtypes/ANY/EUI64.py | 30 + .../site-packages/dns/rdtypes/ANY/GPOS.py | 125 + .../site-packages/dns/rdtypes/ANY/HINFO.py | 66 + .../site-packages/dns/rdtypes/ANY/HIP.py | 85 + .../site-packages/dns/rdtypes/ANY/ISDN.py | 77 + .../site-packages/dns/rdtypes/ANY/L32.py | 41 + .../site-packages/dns/rdtypes/ANY/L64.py | 47 + .../site-packages/dns/rdtypes/ANY/LOC.py | 354 + .../site-packages/dns/rdtypes/ANY/LP.py | 42 + .../site-packages/dns/rdtypes/ANY/MX.py | 24 + .../site-packages/dns/rdtypes/ANY/NID.py | 47 + .../site-packages/dns/rdtypes/ANY/NINFO.py | 26 + .../site-packages/dns/rdtypes/ANY/NS.py | 24 + .../site-packages/dns/rdtypes/ANY/NSEC.py | 67 + .../site-packages/dns/rdtypes/ANY/NSEC3.py | 126 + .../dns/rdtypes/ANY/NSEC3PARAM.py | 69 + .../dns/rdtypes/ANY/OPENPGPKEY.py | 53 + .../site-packages/dns/rdtypes/ANY/OPT.py | 77 + .../site-packages/dns/rdtypes/ANY/PTR.py | 24 + .../site-packages/dns/rdtypes/ANY/RP.py | 58 + .../site-packages/dns/rdtypes/ANY/RRSIG.py | 157 + .../site-packages/dns/rdtypes/ANY/RT.py | 24 + .../site-packages/dns/rdtypes/ANY/SMIMEA.py | 9 + .../site-packages/dns/rdtypes/ANY/SOA.py | 86 + .../site-packages/dns/rdtypes/ANY/SPF.py | 26 + .../site-packages/dns/rdtypes/ANY/SSHFP.py | 68 + .../site-packages/dns/rdtypes/ANY/TKEY.py | 142 + .../site-packages/dns/rdtypes/ANY/TLSA.py | 9 + .../site-packages/dns/rdtypes/ANY/TSIG.py | 160 + .../site-packages/dns/rdtypes/ANY/TXT.py | 24 + .../site-packages/dns/rdtypes/ANY/URI.py | 79 + .../site-packages/dns/rdtypes/ANY/X25.py | 57 + .../site-packages/dns/rdtypes/ANY/ZONEMD.py | 66 + .../site-packages/dns/rdtypes/ANY/__init__.py | 68 + .../ANY/__pycache__/AFSDB.cpython-312.pyc | Bin 0 -> 1061 bytes .../ANY/__pycache__/AMTRELAY.cpython-312.pyc | Bin 0 -> 4181 bytes .../ANY/__pycache__/AVC.cpython-312.pyc | Bin 0 -> 634 bytes .../ANY/__pycache__/CAA.cpython-312.pyc | Bin 0 -> 3361 bytes .../ANY/__pycache__/CDNSKEY.cpython-312.pyc | Bin 0 -> 721 bytes .../ANY/__pycache__/CDS.cpython-312.pyc | Bin 0 -> 829 bytes .../ANY/__pycache__/CERT.cpython-312.pyc | Bin 0 -> 4449 bytes .../ANY/__pycache__/CNAME.cpython-312.pyc | Bin 0 -> 844 bytes .../ANY/__pycache__/CSYNC.cpython-312.pyc | Bin 0 -> 3330 bytes .../ANY/__pycache__/DLV.cpython-312.pyc | Bin 0 -> 631 bytes .../ANY/__pycache__/DNAME.cpython-312.pyc | Bin 0 -> 907 bytes .../ANY/__pycache__/DNSKEY.cpython-312.pyc | Bin 0 -> 718 bytes .../ANY/__pycache__/DS.cpython-312.pyc | Bin 0 -> 628 bytes .../ANY/__pycache__/EUI48.cpython-312.pyc | Bin 0 -> 716 bytes .../ANY/__pycache__/EUI64.cpython-312.pyc | Bin 0 -> 716 bytes .../ANY/__pycache__/GPOS.cpython-312.pyc | Bin 0 -> 6126 bytes .../ANY/__pycache__/HINFO.cpython-312.pyc | Bin 0 -> 2991 bytes .../ANY/__pycache__/HIP.cpython-312.pyc | Bin 0 -> 4827 bytes .../ANY/__pycache__/ISDN.cpython-312.pyc | Bin 0 -> 3451 bytes .../ANY/__pycache__/L32.cpython-312.pyc | Bin 0 -> 2496 bytes .../ANY/__pycache__/L64.cpython-312.pyc | Bin 0 -> 2953 bytes .../ANY/__pycache__/LOC.cpython-312.pyc | Bin 0 -> 14067 bytes .../ANY/__pycache__/LP.cpython-312.pyc | Bin 0 -> 2468 bytes .../ANY/__pycache__/MX.cpython-312.pyc | Bin 0 -> 628 bytes .../ANY/__pycache__/NID.cpython-312.pyc | Bin 0 -> 2946 bytes .../ANY/__pycache__/NINFO.cpython-312.pyc | Bin 0 -> 640 bytes .../ANY/__pycache__/NS.cpython-312.pyc | Bin 0 -> 628 bytes .../ANY/__pycache__/NSEC.cpython-312.pyc | Bin 0 -> 3111 bytes .../ANY/__pycache__/NSEC3.cpython-312.pyc | Bin 0 -> 6350 bytes .../__pycache__/NSEC3PARAM.cpython-312.pyc | Bin 0 -> 3382 bytes .../__pycache__/OPENPGPKEY.cpython-312.pyc | Bin 0 -> 2306 bytes .../ANY/__pycache__/OPT.cpython-312.pyc | Bin 0 -> 3520 bytes .../ANY/__pycache__/PTR.cpython-312.pyc | Bin 0 -> 631 bytes .../ANY/__pycache__/RP.cpython-312.pyc | Bin 0 -> 2560 bytes .../ANY/__pycache__/RRSIG.cpython-312.pyc | Bin 0 -> 6559 bytes .../ANY/__pycache__/RT.cpython-312.pyc | Bin 0 -> 646 bytes .../ANY/__pycache__/SMIMEA.cpython-312.pyc | Bin 0 -> 646 bytes .../ANY/__pycache__/SOA.cpython-312.pyc | Bin 0 -> 3788 bytes .../ANY/__pycache__/SPF.cpython-312.pyc | Bin 0 -> 634 bytes .../ANY/__pycache__/SSHFP.cpython-312.pyc | Bin 0 -> 3115 bytes .../ANY/__pycache__/TKEY.cpython-312.pyc | Bin 0 -> 5085 bytes .../ANY/__pycache__/TLSA.cpython-312.pyc | Bin 0 -> 640 bytes .../ANY/__pycache__/TSIG.cpython-312.pyc | Bin 0 -> 5900 bytes .../ANY/__pycache__/TXT.cpython-312.pyc | Bin 0 -> 634 bytes .../ANY/__pycache__/URI.cpython-312.pyc | Bin 0 -> 4147 bytes .../ANY/__pycache__/X25.cpython-312.pyc | Bin 0 -> 2344 bytes .../ANY/__pycache__/ZONEMD.cpython-312.pyc | Bin 0 -> 4164 bytes .../ANY/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 558 bytes .../site-packages/dns/rdtypes/CH/A.py | 59 + .../site-packages/dns/rdtypes/CH/__init__.py | 22 + .../rdtypes/CH/__pycache__/A.cpython-312.pyc | Bin 0 -> 2514 bytes .../CH/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 260 bytes .../site-packages/dns/rdtypes/IN/A.py | 51 + .../site-packages/dns/rdtypes/IN/AAAA.py | 51 + .../site-packages/dns/rdtypes/IN/APL.py | 150 + .../site-packages/dns/rdtypes/IN/DHCID.py | 54 + .../site-packages/dns/rdtypes/IN/HTTPS.py | 9 + .../site-packages/dns/rdtypes/IN/IPSECKEY.py | 91 + .../site-packages/dns/rdtypes/IN/KX.py | 24 + .../site-packages/dns/rdtypes/IN/NAPTR.py | 110 + .../site-packages/dns/rdtypes/IN/NSAP.py | 60 + .../site-packages/dns/rdtypes/IN/NSAP_PTR.py | 24 + .../site-packages/dns/rdtypes/IN/PX.py | 73 + .../site-packages/dns/rdtypes/IN/SRV.py | 75 + .../site-packages/dns/rdtypes/IN/SVCB.py | 9 + .../site-packages/dns/rdtypes/IN/WKS.py | 100 + .../site-packages/dns/rdtypes/IN/__init__.py | 35 + .../rdtypes/IN/__pycache__/A.cpython-312.pyc | Bin 0 -> 2108 bytes .../IN/__pycache__/AAAA.cpython-312.pyc | Bin 0 -> 2132 bytes .../IN/__pycache__/APL.cpython-312.pyc | Bin 0 -> 6902 bytes .../IN/__pycache__/DHCID.cpython-312.pyc | Bin 0 -> 2252 bytes .../IN/__pycache__/HTTPS.cpython-312.pyc | Bin 0 -> 642 bytes .../IN/__pycache__/IPSECKEY.cpython-312.pyc | Bin 0 -> 4195 bytes .../rdtypes/IN/__pycache__/KX.cpython-312.pyc | Bin 0 -> 645 bytes .../IN/__pycache__/NAPTR.cpython-312.pyc | Bin 0 -> 5021 bytes .../IN/__pycache__/NSAP.cpython-312.pyc | Bin 0 -> 2697 bytes .../IN/__pycache__/NSAP_PTR.cpython-312.pyc | Bin 0 -> 653 bytes .../rdtypes/IN/__pycache__/PX.cpython-312.pyc | Bin 0 -> 3445 bytes .../IN/__pycache__/SRV.cpython-312.pyc | Bin 0 -> 3694 bytes .../IN/__pycache__/SVCB.cpython-312.pyc | Bin 0 -> 639 bytes .../IN/__pycache__/WKS.cpython-312.pyc | Bin 0 -> 4604 bytes .../IN/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 341 bytes .../site-packages/dns/rdtypes/__init__.py | 33 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 340 bytes .../__pycache__/dnskeybase.cpython-312.pyc | Bin 0 -> 3864 bytes .../__pycache__/dsbase.cpython-312.pyc | Bin 0 -> 4163 bytes .../__pycache__/euibase.cpython-312.pyc | Bin 0 -> 3523 bytes .../__pycache__/mxbase.cpython-312.pyc | Bin 0 -> 4394 bytes .../__pycache__/nsbase.cpython-312.pyc | Bin 0 -> 2825 bytes .../__pycache__/svcbbase.cpython-312.pyc | Bin 0 -> 28482 bytes .../__pycache__/tlsabase.cpython-312.pyc | Bin 0 -> 3361 bytes .../__pycache__/txtbase.cpython-312.pyc | Bin 0 -> 5026 bytes .../rdtypes/__pycache__/util.cpython-312.pyc | Bin 0 -> 12831 bytes .../site-packages/dns/rdtypes/dnskeybase.py | 87 + .../site-packages/dns/rdtypes/dsbase.py | 85 + .../site-packages/dns/rdtypes/euibase.py | 70 + .../site-packages/dns/rdtypes/mxbase.py | 87 + .../site-packages/dns/rdtypes/nsbase.py | 63 + .../site-packages/dns/rdtypes/svcbbase.py | 553 ++ .../site-packages/dns/rdtypes/tlsabase.py | 71 + .../site-packages/dns/rdtypes/txtbase.py | 104 + .../site-packages/dns/rdtypes/util.py | 257 + .../python3.12/site-packages/dns/renderer.py | 346 + .../python3.12/site-packages/dns/resolver.py | 2054 ++++ .../site-packages/dns/reversename.py | 105 + .../lib/python3.12/site-packages/dns/rrset.py | 285 + .../python3.12/site-packages/dns/serial.py | 118 + .venv/lib/python3.12/site-packages/dns/set.py | 307 + .../python3.12/site-packages/dns/tokenizer.py | 708 ++ .../site-packages/dns/transaction.py | 651 ++ .../lib/python3.12/site-packages/dns/tsig.py | 352 + .../site-packages/dns/tsigkeyring.py | 68 + .venv/lib/python3.12/site-packages/dns/ttl.py | 92 + .../python3.12/site-packages/dns/update.py | 386 + .../python3.12/site-packages/dns/version.py | 58 + .../python3.12/site-packages/dns/versioned.py | 318 + .../python3.12/site-packages/dns/win32util.py | 252 + .../lib/python3.12/site-packages/dns/wire.py | 89 + .venv/lib/python3.12/site-packages/dns/xfr.py | 343 + .../lib/python3.12/site-packages/dns/zone.py | 1434 +++ .../python3.12/site-packages/dns/zonefile.py | 746 ++ .../python3.12/site-packages/dns/zonetypes.py | 37 + .../dnspython-2.6.1.dist-info/INSTALLER | 1 + .../dnspython-2.6.1.dist-info/METADATA | 147 + .../dnspython-2.6.1.dist-info/RECORD | 291 + .../dnspython-2.6.1.dist-info/REQUESTED | 0 .../dnspython-2.6.1.dist-info/WHEEL | 4 + .../licenses/LICENSE | 35 + .../idna-3.7.dist-info/INSTALLER | 1 + .../idna-3.7.dist-info/LICENSE.md | 31 + .../site-packages/idna-3.7.dist-info/METADATA | 243 + .../site-packages/idna-3.7.dist-info/RECORD | 22 + .../site-packages/idna-3.7.dist-info/WHEEL | 4 + .../python3.12/site-packages/idna/__init__.py | 44 + .../idna/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 868 bytes .../idna/__pycache__/codec.cpython-312.pyc | Bin 0 -> 4973 bytes .../idna/__pycache__/compat.cpython-312.pyc | Bin 0 -> 874 bytes .../idna/__pycache__/core.cpython-312.pyc | Bin 0 -> 15835 bytes .../idna/__pycache__/idnadata.cpython-312.pyc | Bin 0 -> 99463 bytes .../__pycache__/intranges.cpython-312.pyc | Bin 0 -> 2625 bytes .../__pycache__/package_data.cpython-312.pyc | Bin 0 -> 203 bytes .../__pycache__/uts46data.cpython-312.pyc | Bin 0 -> 158835 bytes .../python3.12/site-packages/idna/codec.py | 118 + .../python3.12/site-packages/idna/compat.py | 13 + .../lib/python3.12/site-packages/idna/core.py | 395 + .../python3.12/site-packages/idna/idnadata.py | 4245 ++++++++ .../site-packages/idna/intranges.py | 54 + .../site-packages/idna/package_data.py | 2 + .../python3.12/site-packages/idna/py.typed | 0 .../site-packages/idna/uts46data.py | 8598 +++++++++++++++++ .../pip-24.2.dist-info/AUTHORS.txt | 796 ++ .../pip-24.2.dist-info/INSTALLER | 1 + .../pip-24.2.dist-info/LICENSE.txt | 20 + .../site-packages/pip-24.2.dist-info/METADATA | 89 + .../site-packages/pip-24.2.dist-info/RECORD | 853 ++ .../pip-24.2.dist-info/REQUESTED | 0 .../site-packages/pip-24.2.dist-info/WHEEL | 5 + .../pip-24.2.dist-info/entry_points.txt | 3 + .../pip-24.2.dist-info/top_level.txt | 1 + .../python3.12/site-packages/pip/__init__.py | 13 + .../python3.12/site-packages/pip/__main__.py | 24 + .../site-packages/pip/__pip-runner__.py | 50 + .../pip/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 683 bytes .../pip/__pycache__/__main__.cpython-312.pyc | Bin 0 -> 839 bytes .../__pip-runner__.cpython-312.pyc | Bin 0 -> 2202 bytes .../site-packages/pip/_internal/__init__.py | 18 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 785 bytes .../__pycache__/build_env.cpython-312.pyc | Bin 0 -> 14514 bytes .../__pycache__/cache.cpython-312.pyc | Bin 0 -> 12663 bytes .../__pycache__/configuration.cpython-312.pyc | Bin 0 -> 17664 bytes .../__pycache__/exceptions.cpython-312.pyc | Bin 0 -> 35577 bytes .../__pycache__/main.cpython-312.pyc | Bin 0 -> 668 bytes .../__pycache__/pyproject.cpython-312.pyc | Bin 0 -> 5127 bytes .../self_outdated_check.cpython-312.pyc | Bin 0 -> 10220 bytes .../__pycache__/wheel_builder.cpython-312.pyc | Bin 0 -> 13636 bytes .../site-packages/pip/_internal/build_env.py | 315 + .../site-packages/pip/_internal/cache.py | 290 + .../pip/_internal/cli/__init__.py | 4 + .../cli/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 276 bytes .../autocompletion.cpython-312.pyc | Bin 0 -> 8630 bytes .../__pycache__/base_command.cpython-312.pyc | Bin 0 -> 10203 bytes .../__pycache__/cmdoptions.cpython-312.pyc | Bin 0 -> 30396 bytes .../command_context.cpython-312.pyc | Bin 0 -> 1779 bytes .../__pycache__/index_command.cpython-312.pyc | Bin 0 -> 7133 bytes .../cli/__pycache__/main.cpython-312.pyc | Bin 0 -> 2298 bytes .../__pycache__/main_parser.cpython-312.pyc | Bin 0 -> 4903 bytes .../cli/__pycache__/parser.cpython-312.pyc | Bin 0 -> 15064 bytes .../__pycache__/progress_bars.cpython-312.pyc | Bin 0 -> 3853 bytes .../__pycache__/req_command.cpython-312.pyc | Bin 0 -> 12273 bytes .../cli/__pycache__/spinners.cpython-312.pyc | Bin 0 -> 7838 bytes .../__pycache__/status_codes.cpython-312.pyc | Bin 0 -> 373 bytes .../pip/_internal/cli/autocompletion.py | 176 + .../pip/_internal/cli/base_command.py | 231 + .../pip/_internal/cli/cmdoptions.py | 1075 +++ .../pip/_internal/cli/command_context.py | 27 + .../pip/_internal/cli/index_command.py | 170 + .../site-packages/pip/_internal/cli/main.py | 80 + .../pip/_internal/cli/main_parser.py | 134 + .../site-packages/pip/_internal/cli/parser.py | 294 + .../pip/_internal/cli/progress_bars.py | 94 + .../pip/_internal/cli/req_command.py | 329 + .../pip/_internal/cli/spinners.py | 159 + .../pip/_internal/cli/status_codes.py | 6 + .../pip/_internal/commands/__init__.py | 132 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 4000 bytes .../__pycache__/cache.cpython-312.pyc | Bin 0 -> 9709 bytes .../__pycache__/check.cpython-312.pyc | Bin 0 -> 2614 bytes .../__pycache__/completion.cpython-312.pyc | Bin 0 -> 5190 bytes .../__pycache__/configuration.cpython-312.pyc | Bin 0 -> 13210 bytes .../__pycache__/debug.cpython-312.pyc | Bin 0 -> 10112 bytes .../__pycache__/download.cpython-312.pyc | Bin 0 -> 7506 bytes .../__pycache__/freeze.cpython-312.pyc | Bin 0 -> 4388 bytes .../commands/__pycache__/hash.cpython-312.pyc | Bin 0 -> 2981 bytes .../commands/__pycache__/help.cpython-312.pyc | Bin 0 -> 1671 bytes .../__pycache__/index.cpython-312.pyc | Bin 0 -> 6674 bytes .../__pycache__/inspect.cpython-312.pyc | Bin 0 -> 3974 bytes .../__pycache__/install.cpython-312.pyc | Bin 0 -> 29161 bytes .../commands/__pycache__/list.cpython-312.pyc | Bin 0 -> 15766 bytes .../__pycache__/search.cpython-312.pyc | Bin 0 -> 7543 bytes .../commands/__pycache__/show.cpython-312.pyc | Bin 0 -> 10490 bytes .../__pycache__/uninstall.cpython-312.pyc | Bin 0 -> 4731 bytes .../__pycache__/wheel.cpython-312.pyc | Bin 0 -> 8873 bytes .../pip/_internal/commands/cache.py | 225 + .../pip/_internal/commands/check.py | 67 + .../pip/_internal/commands/completion.py | 130 + .../pip/_internal/commands/configuration.py | 280 + .../pip/_internal/commands/debug.py | 201 + .../pip/_internal/commands/download.py | 146 + .../pip/_internal/commands/freeze.py | 109 + .../pip/_internal/commands/hash.py | 59 + .../pip/_internal/commands/help.py | 41 + .../pip/_internal/commands/index.py | 139 + .../pip/_internal/commands/inspect.py | 92 + .../pip/_internal/commands/install.py | 783 ++ .../pip/_internal/commands/list.py | 375 + .../pip/_internal/commands/search.py | 172 + .../pip/_internal/commands/show.py | 217 + .../pip/_internal/commands/uninstall.py | 114 + .../pip/_internal/commands/wheel.py | 182 + .../pip/_internal/configuration.py | 383 + .../pip/_internal/distributions/__init__.py | 21 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 939 bytes .../__pycache__/base.cpython-312.pyc | Bin 0 -> 2891 bytes .../__pycache__/installed.cpython-312.pyc | Bin 0 -> 1698 bytes .../__pycache__/sdist.cpython-312.pyc | Bin 0 -> 8480 bytes .../__pycache__/wheel.cpython-312.pyc | Bin 0 -> 2279 bytes .../pip/_internal/distributions/base.py | 53 + .../pip/_internal/distributions/installed.py | 29 + .../pip/_internal/distributions/sdist.py | 158 + .../pip/_internal/distributions/wheel.py | 42 + .../site-packages/pip/_internal/exceptions.py | 777 ++ .../pip/_internal/index/__init__.py | 2 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 230 bytes .../__pycache__/collector.cpython-312.pyc | Bin 0 -> 21623 bytes .../package_finder.cpython-312.pyc | Bin 0 -> 40680 bytes .../index/__pycache__/sources.cpython-312.pyc | Bin 0 -> 12602 bytes .../pip/_internal/index/collector.py | 494 + .../pip/_internal/index/package_finder.py | 1020 ++ .../pip/_internal/index/sources.py | 285 + .../pip/_internal/locations/__init__.py | 456 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 16449 bytes .../__pycache__/_distutils.cpython-312.pyc | Bin 0 -> 6854 bytes .../__pycache__/_sysconfig.cpython-312.pyc | Bin 0 -> 8031 bytes .../__pycache__/base.cpython-312.pyc | Bin 0 -> 3779 bytes .../pip/_internal/locations/_distutils.py | 172 + .../pip/_internal/locations/_sysconfig.py | 214 + .../pip/_internal/locations/base.py | 81 + .../site-packages/pip/_internal/main.py | 12 + .../pip/_internal/metadata/__init__.py | 128 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 5880 bytes .../__pycache__/_json.cpython-312.pyc | Bin 0 -> 2928 bytes .../metadata/__pycache__/base.cpython-312.pyc | Bin 0 -> 35222 bytes .../__pycache__/pkg_resources.cpython-312.pyc | Bin 0 -> 16103 bytes .../pip/_internal/metadata/_json.py | 84 + .../pip/_internal/metadata/base.py | 688 ++ .../_internal/metadata/importlib/__init__.py | 6 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 356 bytes .../__pycache__/_compat.cpython-312.pyc | Bin 0 -> 4489 bytes .../__pycache__/_dists.cpython-312.pyc | Bin 0 -> 12571 bytes .../__pycache__/_envs.cpython-312.pyc | Bin 0 -> 11141 bytes .../_internal/metadata/importlib/_compat.py | 85 + .../_internal/metadata/importlib/_dists.py | 221 + .../pip/_internal/metadata/importlib/_envs.py | 189 + .../pip/_internal/metadata/pkg_resources.py | 301 + .../pip/_internal/models/__init__.py | 2 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 264 bytes .../__pycache__/candidate.cpython-312.pyc | Bin 0 -> 1602 bytes .../__pycache__/direct_url.cpython-312.pyc | Bin 0 -> 10837 bytes .../format_control.cpython-312.pyc | Bin 0 -> 4225 bytes .../models/__pycache__/index.cpython-312.pyc | Bin 0 -> 1692 bytes .../installation_report.cpython-312.pyc | Bin 0 -> 2270 bytes .../models/__pycache__/link.cpython-312.pyc | Bin 0 -> 26602 bytes .../models/__pycache__/scheme.cpython-312.pyc | Bin 0 -> 1021 bytes .../__pycache__/search_scope.cpython-312.pyc | Bin 0 -> 4994 bytes .../selection_prefs.cpython-312.pyc | Bin 0 -> 1849 bytes .../__pycache__/target_python.cpython-312.pyc | Bin 0 -> 4952 bytes .../models/__pycache__/wheel.cpython-312.pyc | Bin 0 -> 5778 bytes .../pip/_internal/models/candidate.py | 25 + .../pip/_internal/models/direct_url.py | 224 + .../pip/_internal/models/format_control.py | 78 + .../pip/_internal/models/index.py | 28 + .../_internal/models/installation_report.py | 56 + .../pip/_internal/models/link.py | 590 ++ .../pip/_internal/models/scheme.py | 25 + .../pip/_internal/models/search_scope.py | 127 + .../pip/_internal/models/selection_prefs.py | 53 + .../pip/_internal/models/target_python.py | 121 + .../pip/_internal/models/wheel.py | 93 + .../pip/_internal/network/__init__.py | 2 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 252 bytes .../network/__pycache__/auth.cpython-312.pyc | Bin 0 -> 22106 bytes .../network/__pycache__/cache.cpython-312.pyc | Bin 0 -> 6516 bytes .../__pycache__/download.cpython-312.pyc | Bin 0 -> 8506 bytes .../__pycache__/lazy_wheel.cpython-312.pyc | Bin 0 -> 11661 bytes .../__pycache__/session.cpython-312.pyc | Bin 0 -> 18880 bytes .../network/__pycache__/utils.cpython-312.pyc | Bin 0 -> 2258 bytes .../__pycache__/xmlrpc.cpython-312.pyc | Bin 0 -> 2947 bytes .../pip/_internal/network/auth.py | 566 ++ .../pip/_internal/network/cache.py | 106 + .../pip/_internal/network/download.py | 187 + .../pip/_internal/network/lazy_wheel.py | 210 + .../pip/_internal/network/session.py | 522 + .../pip/_internal/network/utils.py | 98 + .../pip/_internal/network/xmlrpc.py | 62 + .../pip/_internal/operations/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 195 bytes .../__pycache__/check.cpython-312.pyc | Bin 0 -> 7151 bytes .../__pycache__/freeze.cpython-312.pyc | Bin 0 -> 10179 bytes .../__pycache__/prepare.cpython-312.pyc | Bin 0 -> 25868 bytes .../_internal/operations/build/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 201 bytes .../__pycache__/build_tracker.cpython-312.pyc | Bin 0 -> 7717 bytes .../__pycache__/metadata.cpython-312.pyc | Bin 0 -> 1878 bytes .../metadata_editable.cpython-312.pyc | Bin 0 -> 1912 bytes .../metadata_legacy.cpython-312.pyc | Bin 0 -> 3025 bytes .../build/__pycache__/wheel.cpython-312.pyc | Bin 0 -> 1682 bytes .../wheel_editable.cpython-312.pyc | Bin 0 -> 2023 bytes .../__pycache__/wheel_legacy.cpython-312.pyc | Bin 0 -> 3855 bytes .../operations/build/build_tracker.py | 138 + .../_internal/operations/build/metadata.py | 39 + .../operations/build/metadata_editable.py | 41 + .../operations/build/metadata_legacy.py | 74 + .../pip/_internal/operations/build/wheel.py | 37 + .../operations/build/wheel_editable.py | 46 + .../operations/build/wheel_legacy.py | 102 + .../pip/_internal/operations/check.py | 181 + .../pip/_internal/operations/freeze.py | 258 + .../_internal/operations/install/__init__.py | 2 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 264 bytes .../editable_legacy.cpython-312.pyc | Bin 0 -> 1817 bytes .../install/__pycache__/wheel.cpython-312.pyc | Bin 0 -> 34244 bytes .../operations/install/editable_legacy.py | 47 + .../pip/_internal/operations/install/wheel.py | 741 ++ .../pip/_internal/operations/prepare.py | 732 ++ .../site-packages/pip/_internal/pyproject.py | 185 + .../pip/_internal/req/__init__.py | 90 + .../req/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 3474 bytes .../__pycache__/constructors.cpython-312.pyc | Bin 0 -> 21237 bytes .../req/__pycache__/req_file.cpython-312.pyc | Bin 0 -> 21479 bytes .../__pycache__/req_install.cpython-312.pyc | Bin 0 -> 38537 bytes .../req/__pycache__/req_set.cpython-312.pyc | Bin 0 -> 5473 bytes .../__pycache__/req_uninstall.cpython-312.pyc | Bin 0 -> 32248 bytes .../pip/_internal/req/constructors.py | 560 ++ .../pip/_internal/req/req_file.py | 551 ++ .../pip/_internal/req/req_install.py | 934 ++ .../pip/_internal/req/req_set.py | 82 + .../pip/_internal/req/req_uninstall.py | 633 ++ .../pip/_internal/resolution/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 195 bytes .../__pycache__/base.cpython-312.pyc | Bin 0 -> 1183 bytes .../pip/_internal/resolution/base.py | 20 + .../_internal/resolution/legacy/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 202 bytes .../__pycache__/resolver.cpython-312.pyc | Bin 0 -> 22615 bytes .../_internal/resolution/legacy/resolver.py | 597 ++ .../resolution/resolvelib/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 206 bytes .../__pycache__/base.cpython-312.pyc | Bin 0 -> 8146 bytes .../__pycache__/candidates.cpython-312.pyc | Bin 0 -> 29191 bytes .../__pycache__/factory.cpython-312.pyc | Bin 0 -> 32339 bytes .../found_candidates.cpython-312.pyc | Bin 0 -> 6805 bytes .../__pycache__/provider.cpython-312.pyc | Bin 0 -> 10521 bytes .../__pycache__/reporter.cpython-312.pyc | Bin 0 -> 5043 bytes .../__pycache__/requirements.cpython-312.pyc | Bin 0 -> 15348 bytes .../__pycache__/resolver.cpython-312.pyc | Bin 0 -> 12349 bytes .../_internal/resolution/resolvelib/base.py | 139 + .../resolution/resolvelib/candidates.py | 569 ++ .../resolution/resolvelib/factory.py | 817 ++ .../resolution/resolvelib/found_candidates.py | 174 + .../resolution/resolvelib/provider.py | 258 + .../resolution/resolvelib/reporter.py | 81 + .../resolution/resolvelib/requirements.py | 245 + .../resolution/resolvelib/resolver.py | 317 + .../pip/_internal/self_outdated_check.py | 244 + .../pip/_internal/utils/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 190 bytes .../__pycache__/_jaraco_text.cpython-312.pyc | Bin 0 -> 4530 bytes .../utils/__pycache__/_log.cpython-312.pyc | Bin 0 -> 1861 bytes .../utils/__pycache__/appdirs.cpython-312.pyc | Bin 0 -> 2405 bytes .../utils/__pycache__/compat.cpython-312.pyc | Bin 0 -> 2902 bytes .../compatibility_tags.cpython-312.pyc | Bin 0 -> 5556 bytes .../__pycache__/datetime.cpython-312.pyc | Bin 0 -> 679 bytes .../__pycache__/deprecation.cpython-312.pyc | Bin 0 -> 4185 bytes .../direct_url_helpers.cpython-312.pyc | Bin 0 -> 3531 bytes .../__pycache__/egg_link.cpython-312.pyc | Bin 0 -> 3221 bytes .../__pycache__/encoding.cpython-312.pyc | Bin 0 -> 2153 bytes .../__pycache__/entrypoints.cpython-312.pyc | Bin 0 -> 3988 bytes .../__pycache__/filesystem.cpython-312.pyc | Bin 0 -> 7347 bytes .../__pycache__/filetypes.cpython-312.pyc | Bin 0 -> 1159 bytes .../utils/__pycache__/glibc.cpython-312.pyc | Bin 0 -> 2414 bytes .../utils/__pycache__/hashes.cpython-312.pyc | Bin 0 -> 7644 bytes .../utils/__pycache__/logging.cpython-312.pyc | Bin 0 -> 13552 bytes .../utils/__pycache__/misc.cpython-312.pyc | Bin 0 -> 33554 bytes .../__pycache__/packaging.cpython-312.pyc | Bin 0 -> 2578 bytes .../utils/__pycache__/retry.cpython-312.pyc | Bin 0 -> 2103 bytes .../setuptools_build.cpython-312.pyc | Bin 0 -> 4545 bytes .../__pycache__/subprocess.cpython-312.pyc | Bin 0 -> 8659 bytes .../__pycache__/temp_dir.cpython-312.pyc | Bin 0 -> 12057 bytes .../__pycache__/unpacking.cpython-312.pyc | Bin 0 -> 13526 bytes .../utils/__pycache__/urls.cpython-312.pyc | Bin 0 -> 2072 bytes .../__pycache__/virtualenv.cpython-312.pyc | Bin 0 -> 4475 bytes .../utils/__pycache__/wheel.cpython-312.pyc | Bin 0 -> 5894 bytes .../pip/_internal/utils/_jaraco_text.py | 109 + .../site-packages/pip/_internal/utils/_log.py | 38 + .../pip/_internal/utils/appdirs.py | 52 + .../pip/_internal/utils/compat.py | 79 + .../pip/_internal/utils/compatibility_tags.py | 165 + .../pip/_internal/utils/datetime.py | 11 + .../pip/_internal/utils/deprecation.py | 124 + .../pip/_internal/utils/direct_url_helpers.py | 87 + .../pip/_internal/utils/egg_link.py | 80 + .../pip/_internal/utils/encoding.py | 36 + .../pip/_internal/utils/entrypoints.py | 84 + .../pip/_internal/utils/filesystem.py | 149 + .../pip/_internal/utils/filetypes.py | 27 + .../pip/_internal/utils/glibc.py | 101 + .../pip/_internal/utils/hashes.py | 147 + .../pip/_internal/utils/logging.py | 347 + .../site-packages/pip/_internal/utils/misc.py | 777 ++ .../pip/_internal/utils/packaging.py | 57 + .../pip/_internal/utils/retry.py | 42 + .../pip/_internal/utils/setuptools_build.py | 146 + .../pip/_internal/utils/subprocess.py | 245 + .../pip/_internal/utils/temp_dir.py | 296 + .../pip/_internal/utils/unpacking.py | 337 + .../site-packages/pip/_internal/utils/urls.py | 55 + .../pip/_internal/utils/virtualenv.py | 104 + .../pip/_internal/utils/wheel.py | 134 + .../pip/_internal/vcs/__init__.py | 15 + .../vcs/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 529 bytes .../vcs/__pycache__/bazaar.cpython-312.pyc | Bin 0 -> 5059 bytes .../vcs/__pycache__/git.cpython-312.pyc | Bin 0 -> 19025 bytes .../vcs/__pycache__/mercurial.cpython-312.pyc | Bin 0 -> 7610 bytes .../__pycache__/subversion.cpython-312.pyc | Bin 0 -> 12523 bytes .../versioncontrol.cpython-312.pyc | Bin 0 -> 29006 bytes .../site-packages/pip/_internal/vcs/bazaar.py | 112 + .../site-packages/pip/_internal/vcs/git.py | 527 + .../pip/_internal/vcs/mercurial.py | 163 + .../pip/_internal/vcs/subversion.py | 324 + .../pip/_internal/vcs/versioncontrol.py | 688 ++ .../pip/_internal/wheel_builder.py | 354 + .../site-packages/pip/_vendor/__init__.py | 116 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 4548 bytes .../typing_extensions.cpython-312.pyc | Bin 0 -> 139544 bytes .../pip/_vendor/cachecontrol/__init__.py | 28 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 901 bytes .../__pycache__/_cmd.cpython-312.pyc | Bin 0 -> 2645 bytes .../__pycache__/adapter.cpython-312.pyc | Bin 0 -> 6463 bytes .../__pycache__/cache.cpython-312.pyc | Bin 0 -> 3808 bytes .../__pycache__/controller.cpython-312.pyc | Bin 0 -> 16223 bytes .../__pycache__/filewrapper.cpython-312.pyc | Bin 0 -> 4346 bytes .../__pycache__/heuristics.cpython-312.pyc | Bin 0 -> 6693 bytes .../__pycache__/serialize.cpython-312.pyc | Bin 0 -> 5264 bytes .../__pycache__/wrapper.cpython-312.pyc | Bin 0 -> 1673 bytes .../pip/_vendor/cachecontrol/_cmd.py | 70 + .../pip/_vendor/cachecontrol/adapter.py | 161 + .../pip/_vendor/cachecontrol/cache.py | 74 + .../_vendor/cachecontrol/caches/__init__.py | 8 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 434 bytes .../__pycache__/file_cache.cpython-312.pyc | Bin 0 -> 7787 bytes .../__pycache__/redis_cache.cpython-312.pyc | Bin 0 -> 2737 bytes .../_vendor/cachecontrol/caches/file_cache.py | 182 + .../cachecontrol/caches/redis_cache.py | 48 + .../pip/_vendor/cachecontrol/controller.py | 499 + .../pip/_vendor/cachecontrol/filewrapper.py | 119 + .../pip/_vendor/cachecontrol/heuristics.py | 154 + .../pip/_vendor/cachecontrol/py.typed | 0 .../pip/_vendor/cachecontrol/serialize.py | 146 + .../pip/_vendor/cachecontrol/wrapper.py | 43 + .../pip/_vendor/certifi/__init__.py | 4 + .../pip/_vendor/certifi/__main__.py | 12 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 317 bytes .../__pycache__/__main__.cpython-312.pyc | Bin 0 -> 644 bytes .../certifi/__pycache__/core.cpython-312.pyc | Bin 0 -> 3219 bytes .../pip/_vendor/certifi/cacert.pem | 4798 +++++++++ .../site-packages/pip/_vendor/certifi/core.py | 114 + .../pip/_vendor/certifi/py.typed | 0 .../pip/_vendor/distlib/__init__.py | 33 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 1268 bytes .../__pycache__/compat.cpython-312.pyc | Bin 0 -> 45604 bytes .../__pycache__/database.cpython-312.pyc | Bin 0 -> 66026 bytes .../distlib/__pycache__/index.cpython-312.pyc | Bin 0 -> 24365 bytes .../__pycache__/locators.cpython-312.pyc | Bin 0 -> 60157 bytes .../__pycache__/manifest.cpython-312.pyc | Bin 0 -> 15124 bytes .../__pycache__/markers.cpython-312.pyc | Bin 0 -> 7681 bytes .../__pycache__/metadata.cpython-312.pyc | Bin 0 -> 41798 bytes .../__pycache__/resources.cpython-312.pyc | Bin 0 -> 17324 bytes .../__pycache__/scripts.cpython-312.pyc | Bin 0 -> 19791 bytes .../distlib/__pycache__/util.cpython-312.pyc | Bin 0 -> 88255 bytes .../__pycache__/version.cpython-312.pyc | Bin 0 -> 30365 bytes .../distlib/__pycache__/wheel.cpython-312.pyc | Bin 0 -> 51860 bytes .../pip/_vendor/distlib/compat.py | 1138 +++ .../pip/_vendor/distlib/database.py | 1359 +++ .../pip/_vendor/distlib/index.py | 508 + .../pip/_vendor/distlib/locators.py | 1303 +++ .../pip/_vendor/distlib/manifest.py | 384 + .../pip/_vendor/distlib/markers.py | 167 + .../pip/_vendor/distlib/metadata.py | 1068 ++ .../pip/_vendor/distlib/resources.py | 358 + .../pip/_vendor/distlib/scripts.py | 466 + .../site-packages/pip/_vendor/distlib/t32.exe | Bin 0 -> 97792 bytes .../pip/_vendor/distlib/t64-arm.exe | Bin 0 -> 182784 bytes .../site-packages/pip/_vendor/distlib/t64.exe | Bin 0 -> 108032 bytes .../site-packages/pip/_vendor/distlib/util.py | 2025 ++++ .../pip/_vendor/distlib/version.py | 751 ++ .../site-packages/pip/_vendor/distlib/w32.exe | Bin 0 -> 91648 bytes .../pip/_vendor/distlib/w64-arm.exe | Bin 0 -> 168448 bytes .../site-packages/pip/_vendor/distlib/w64.exe | Bin 0 -> 101888 bytes .../pip/_vendor/distlib/wheel.py | 1099 +++ .../pip/_vendor/distro/__init__.py | 54 + .../pip/_vendor/distro/__main__.py | 4 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 959 bytes .../__pycache__/__main__.cpython-312.pyc | Bin 0 -> 291 bytes .../distro/__pycache__/distro.cpython-312.pyc | Bin 0 -> 53844 bytes .../pip/_vendor/distro/distro.py | 1403 +++ .../site-packages/pip/_vendor/distro/py.typed | 0 .../pip/_vendor/idna/__init__.py | 44 + .../idna/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 880 bytes .../idna/__pycache__/codec.cpython-312.pyc | Bin 0 -> 4985 bytes .../idna/__pycache__/compat.cpython-312.pyc | Bin 0 -> 886 bytes .../idna/__pycache__/core.cpython-312.pyc | Bin 0 -> 15847 bytes .../idna/__pycache__/idnadata.cpython-312.pyc | Bin 0 -> 99475 bytes .../__pycache__/intranges.cpython-312.pyc | Bin 0 -> 2637 bytes .../__pycache__/package_data.cpython-312.pyc | Bin 0 -> 215 bytes .../__pycache__/uts46data.cpython-312.pyc | Bin 0 -> 158847 bytes .../site-packages/pip/_vendor/idna/codec.py | 118 + .../site-packages/pip/_vendor/idna/compat.py | 13 + .../site-packages/pip/_vendor/idna/core.py | 395 + .../pip/_vendor/idna/idnadata.py | 4245 ++++++++ .../pip/_vendor/idna/intranges.py | 54 + .../pip/_vendor/idna/package_data.py | 2 + .../site-packages/pip/_vendor/idna/py.typed | 0 .../pip/_vendor/idna/uts46data.py | 8598 +++++++++++++++++ .../pip/_vendor/msgpack/__init__.py | 55 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 1740 bytes .../__pycache__/exceptions.cpython-312.pyc | Bin 0 -> 2024 bytes .../msgpack/__pycache__/ext.cpython-312.pyc | Bin 0 -> 8169 bytes .../__pycache__/fallback.cpython-312.pyc | Bin 0 -> 42073 bytes .../pip/_vendor/msgpack/exceptions.py | 48 + .../site-packages/pip/_vendor/msgpack/ext.py | 168 + .../pip/_vendor/msgpack/fallback.py | 951 ++ .../pip/_vendor/packaging/__init__.py | 15 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 557 bytes .../__pycache__/_elffile.cpython-312.pyc | Bin 0 -> 4973 bytes .../__pycache__/_manylinux.cpython-312.pyc | Bin 0 -> 9729 bytes .../__pycache__/_musllinux.cpython-312.pyc | Bin 0 -> 4568 bytes .../__pycache__/_parser.cpython-312.pyc | Bin 0 -> 13999 bytes .../__pycache__/_structures.cpython-312.pyc | Bin 0 -> 3240 bytes .../__pycache__/_tokenizer.cpython-312.pyc | Bin 0 -> 7910 bytes .../__pycache__/markers.cpython-312.pyc | Bin 0 -> 11012 bytes .../__pycache__/metadata.cpython-312.pyc | Bin 0 -> 24991 bytes .../__pycache__/requirements.cpython-312.pyc | Bin 0 -> 4409 bytes .../__pycache__/specifiers.cpython-312.pyc | Bin 0 -> 38763 bytes .../__pycache__/tags.cpython-312.pyc | Bin 0 -> 21452 bytes .../__pycache__/utils.cpython-312.pyc | Bin 0 -> 7338 bytes .../__pycache__/version.cpython-312.pyc | Bin 0 -> 19501 bytes .../pip/_vendor/packaging/_elffile.py | 110 + .../pip/_vendor/packaging/_manylinux.py | 262 + .../pip/_vendor/packaging/_musllinux.py | 85 + .../pip/_vendor/packaging/_parser.py | 354 + .../pip/_vendor/packaging/_structures.py | 61 + .../pip/_vendor/packaging/_tokenizer.py | 194 + .../pip/_vendor/packaging/markers.py | 325 + .../pip/_vendor/packaging/metadata.py | 804 ++ .../pip/_vendor/packaging/py.typed | 0 .../pip/_vendor/packaging/requirements.py | 91 + .../pip/_vendor/packaging/specifiers.py | 1009 ++ .../pip/_vendor/packaging/tags.py | 568 ++ .../pip/_vendor/packaging/utils.py | 174 + .../pip/_vendor/packaging/version.py | 563 ++ .../pip/_vendor/pkg_resources/__init__.py | 3676 +++++++ .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 161524 bytes .../pip/_vendor/platformdirs/__init__.py | 627 ++ .../pip/_vendor/platformdirs/__main__.py | 55 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 19828 bytes .../__pycache__/__main__.cpython-312.pyc | Bin 0 -> 1967 bytes .../__pycache__/android.cpython-312.pyc | Bin 0 -> 10706 bytes .../__pycache__/api.cpython-312.pyc | Bin 0 -> 12930 bytes .../__pycache__/macos.cpython-312.pyc | Bin 0 -> 8006 bytes .../__pycache__/unix.cpython-312.pyc | Bin 0 -> 15031 bytes .../__pycache__/version.cpython-312.pyc | Bin 0 -> 596 bytes .../__pycache__/windows.cpython-312.pyc | Bin 0 -> 13672 bytes .../pip/_vendor/platformdirs/android.py | 249 + .../pip/_vendor/platformdirs/api.py | 292 + .../pip/_vendor/platformdirs/macos.py | 130 + .../pip/_vendor/platformdirs/py.typed | 0 .../pip/_vendor/platformdirs/unix.py | 275 + .../pip/_vendor/platformdirs/version.py | 16 + .../pip/_vendor/platformdirs/windows.py | 272 + .../pip/_vendor/pygments/__init__.py | 82 + .../pip/_vendor/pygments/__main__.py | 17 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 3488 bytes .../__pycache__/__main__.cpython-312.pyc | Bin 0 -> 734 bytes .../__pycache__/cmdline.cpython-312.pyc | Bin 0 -> 26668 bytes .../__pycache__/console.cpython-312.pyc | Bin 0 -> 2633 bytes .../__pycache__/filter.cpython-312.pyc | Bin 0 -> 3226 bytes .../__pycache__/formatter.cpython-312.pyc | Bin 0 -> 4720 bytes .../__pycache__/lexer.cpython-312.pyc | Bin 0 -> 38465 bytes .../__pycache__/modeline.cpython-312.pyc | Bin 0 -> 1569 bytes .../__pycache__/plugin.cpython-312.pyc | Bin 0 -> 2628 bytes .../__pycache__/regexopt.cpython-312.pyc | Bin 0 -> 4081 bytes .../__pycache__/scanner.cpython-312.pyc | Bin 0 -> 4756 bytes .../__pycache__/sphinxext.cpython-312.pyc | Bin 0 -> 12141 bytes .../__pycache__/style.cpython-312.pyc | Bin 0 -> 6717 bytes .../__pycache__/token.cpython-312.pyc | Bin 0 -> 8194 bytes .../__pycache__/unistring.cpython-312.pyc | Bin 0 -> 33011 bytes .../pygments/__pycache__/util.cpython-312.pyc | Bin 0 -> 14083 bytes .../pip/_vendor/pygments/cmdline.py | 668 ++ .../pip/_vendor/pygments/console.py | 70 + .../pip/_vendor/pygments/filter.py | 70 + .../pip/_vendor/pygments/filters/__init__.py | 940 ++ .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 37979 bytes .../pip/_vendor/pygments/formatter.py | 129 + .../_vendor/pygments/formatters/__init__.py | 157 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 6953 bytes .../__pycache__/_mapping.cpython-312.pyc | Bin 0 -> 4215 bytes .../__pycache__/bbcode.cpython-312.pyc | Bin 0 -> 4232 bytes .../__pycache__/groff.cpython-312.pyc | Bin 0 -> 7332 bytes .../__pycache__/html.cpython-312.pyc | Bin 0 -> 41097 bytes .../__pycache__/img.cpython-312.pyc | Bin 0 -> 28653 bytes .../__pycache__/irc.cpython-312.pyc | Bin 0 -> 6065 bytes .../__pycache__/latex.cpython-312.pyc | Bin 0 -> 20171 bytes .../__pycache__/other.cpython-312.pyc | Bin 0 -> 6899 bytes .../__pycache__/pangomarkup.cpython-312.pyc | Bin 0 -> 2968 bytes .../__pycache__/rtf.cpython-312.pyc | Bin 0 -> 13824 bytes .../__pycache__/svg.cpython-312.pyc | Bin 0 -> 9151 bytes .../__pycache__/terminal.cpython-312.pyc | Bin 0 -> 5829 bytes .../__pycache__/terminal256.cpython-312.pyc | Bin 0 -> 15157 bytes .../_vendor/pygments/formatters/_mapping.py | 23 + .../pip/_vendor/pygments/formatters/bbcode.py | 108 + .../pip/_vendor/pygments/formatters/groff.py | 170 + .../pip/_vendor/pygments/formatters/html.py | 987 ++ .../pip/_vendor/pygments/formatters/img.py | 685 ++ .../pip/_vendor/pygments/formatters/irc.py | 154 + .../pip/_vendor/pygments/formatters/latex.py | 518 + .../pip/_vendor/pygments/formatters/other.py | 160 + .../pygments/formatters/pangomarkup.py | 83 + .../pip/_vendor/pygments/formatters/rtf.py | 349 + .../pip/_vendor/pygments/formatters/svg.py | 185 + .../_vendor/pygments/formatters/terminal.py | 127 + .../pygments/formatters/terminal256.py | 338 + .../pip/_vendor/pygments/lexer.py | 963 ++ .../pip/_vendor/pygments/lexers/__init__.py | 362 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 14735 bytes .../__pycache__/_mapping.cpython-312.pyc | Bin 0 -> 68263 bytes .../lexers/__pycache__/python.cpython-312.pyc | Bin 0 -> 42969 bytes .../pip/_vendor/pygments/lexers/_mapping.py | 589 ++ .../pip/_vendor/pygments/lexers/python.py | 1198 +++ .../pip/_vendor/pygments/modeline.py | 43 + .../pip/_vendor/pygments/plugin.py | 72 + .../pip/_vendor/pygments/regexopt.py | 91 + .../pip/_vendor/pygments/scanner.py | 104 + .../pip/_vendor/pygments/sphinxext.py | 247 + .../pip/_vendor/pygments/style.py | 203 + .../pip/_vendor/pygments/styles/__init__.py | 61 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 2671 bytes .../__pycache__/_mapping.cpython-312.pyc | Bin 0 -> 3648 bytes .../pip/_vendor/pygments/styles/_mapping.py | 54 + .../pip/_vendor/pygments/token.py | 214 + .../pip/_vendor/pygments/unistring.py | 153 + .../pip/_vendor/pygments/util.py | 324 + .../pip/_vendor/pyproject_hooks/__init__.py | 23 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 613 bytes .../__pycache__/_compat.cpython-312.pyc | Bin 0 -> 374 bytes .../__pycache__/_impl.cpython-312.pyc | Bin 0 -> 14725 bytes .../pip/_vendor/pyproject_hooks/_compat.py | 8 + .../pip/_vendor/pyproject_hooks/_impl.py | 330 + .../pyproject_hooks/_in_process/__init__.py | 18 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 1080 bytes .../__pycache__/_in_process.cpython-312.pyc | Bin 0 -> 14397 bytes .../_in_process/_in_process.py | 353 + .../pip/_vendor/requests/__init__.py | 179 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 5253 bytes .../__pycache__/__version__.cpython-312.pyc | Bin 0 -> 584 bytes .../_internal_utils.cpython-312.pyc | Bin 0 -> 2024 bytes .../__pycache__/adapters.cpython-312.pyc | Bin 0 -> 28437 bytes .../requests/__pycache__/api.cpython-312.pyc | Bin 0 -> 7204 bytes .../requests/__pycache__/auth.cpython-312.pyc | Bin 0 -> 13923 bytes .../__pycache__/certs.cpython-312.pyc | Bin 0 -> 922 bytes .../__pycache__/compat.cpython-312.pyc | Bin 0 -> 1677 bytes .../__pycache__/cookies.cpython-312.pyc | Bin 0 -> 25276 bytes .../__pycache__/exceptions.cpython-312.pyc | Bin 0 -> 7598 bytes .../requests/__pycache__/help.cpython-312.pyc | Bin 0 -> 4228 bytes .../__pycache__/hooks.cpython-312.pyc | Bin 0 -> 1052 bytes .../__pycache__/models.cpython-312.pyc | Bin 0 -> 35478 bytes .../__pycache__/packages.cpython-312.pyc | Bin 0 -> 1287 bytes .../__pycache__/sessions.cpython-312.pyc | Bin 0 -> 27882 bytes .../__pycache__/status_codes.cpython-312.pyc | Bin 0 -> 6031 bytes .../__pycache__/structures.cpython-312.pyc | Bin 0 -> 5617 bytes .../__pycache__/utils.cpython-312.pyc | Bin 0 -> 36442 bytes .../pip/_vendor/requests/__version__.py | 14 + .../pip/_vendor/requests/_internal_utils.py | 50 + .../pip/_vendor/requests/adapters.py | 719 ++ .../site-packages/pip/_vendor/requests/api.py | 157 + .../pip/_vendor/requests/auth.py | 314 + .../pip/_vendor/requests/certs.py | 24 + .../pip/_vendor/requests/compat.py | 78 + .../pip/_vendor/requests/cookies.py | 561 ++ .../pip/_vendor/requests/exceptions.py | 151 + .../pip/_vendor/requests/help.py | 127 + .../pip/_vendor/requests/hooks.py | 33 + .../pip/_vendor/requests/models.py | 1037 ++ .../pip/_vendor/requests/packages.py | 25 + .../pip/_vendor/requests/sessions.py | 831 ++ .../pip/_vendor/requests/status_codes.py | 128 + .../pip/_vendor/requests/structures.py | 99 + .../pip/_vendor/requests/utils.py | 1096 +++ .../pip/_vendor/resolvelib/__init__.py | 26 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 634 bytes .../__pycache__/providers.cpython-312.pyc | Bin 0 -> 6851 bytes .../__pycache__/reporters.cpython-312.pyc | Bin 0 -> 2654 bytes .../__pycache__/resolvers.cpython-312.pyc | Bin 0 -> 25897 bytes .../__pycache__/structs.cpython-312.pyc | Bin 0 -> 10506 bytes .../pip/_vendor/resolvelib/compat/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 200 bytes .../collections_abc.cpython-312.pyc | Bin 0 -> 420 bytes .../resolvelib/compat/collections_abc.py | 6 + .../pip/_vendor/resolvelib/providers.py | 133 + .../pip/_vendor/resolvelib/py.typed | 0 .../pip/_vendor/resolvelib/reporters.py | 43 + .../pip/_vendor/resolvelib/resolvers.py | 547 ++ .../pip/_vendor/resolvelib/structs.py | 170 + .../pip/_vendor/rich/__init__.py | 177 + .../pip/_vendor/rich/__main__.py | 273 + .../rich/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 7015 bytes .../rich/__pycache__/__main__.cpython-312.pyc | Bin 0 -> 10304 bytes .../__pycache__/_cell_widths.cpython-312.pyc | Bin 0 -> 7872 bytes .../__pycache__/_emoji_codes.cpython-312.pyc | Bin 0 -> 205976 bytes .../_emoji_replace.cpython-312.pyc | Bin 0 -> 1729 bytes .../_export_format.cpython-312.pyc | Bin 0 -> 2349 bytes .../__pycache__/_extension.cpython-312.pyc | Bin 0 -> 537 bytes .../rich/__pycache__/_fileno.cpython-312.pyc | Bin 0 -> 855 bytes .../rich/__pycache__/_inspect.cpython-312.pyc | Bin 0 -> 12077 bytes .../__pycache__/_log_render.cpython-312.pyc | Bin 0 -> 4147 bytes .../rich/__pycache__/_loop.cpython-312.pyc | Bin 0 -> 1885 bytes .../__pycache__/_null_file.cpython-312.pyc | Bin 0 -> 3620 bytes .../__pycache__/_palettes.cpython-312.pyc | Bin 0 -> 5160 bytes .../rich/__pycache__/_pick.cpython-312.pyc | Bin 0 -> 726 bytes .../rich/__pycache__/_ratio.cpython-312.pyc | Bin 0 -> 6577 bytes .../__pycache__/_spinners.cpython-312.pyc | Bin 0 -> 13179 bytes .../rich/__pycache__/_stack.cpython-312.pyc | Bin 0 -> 965 bytes .../rich/__pycache__/_timer.cpython-312.pyc | Bin 0 -> 865 bytes .../_win32_console.cpython-312.pyc | Bin 0 -> 28976 bytes .../rich/__pycache__/_windows.cpython-312.pyc | Bin 0 -> 2490 bytes .../_windows_renderer.cpython-312.pyc | Bin 0 -> 3573 bytes .../rich/__pycache__/_wrap.cpython-312.pyc | Bin 0 -> 3336 bytes .../rich/__pycache__/abc.cpython-312.pyc | Bin 0 -> 1608 bytes .../rich/__pycache__/align.cpython-312.pyc | Bin 0 -> 12322 bytes .../rich/__pycache__/ansi.cpython-312.pyc | Bin 0 -> 9106 bytes .../rich/__pycache__/bar.cpython-312.pyc | Bin 0 -> 4272 bytes .../rich/__pycache__/box.cpython-312.pyc | Bin 0 -> 11858 bytes .../rich/__pycache__/cells.cpython-312.pyc | Bin 0 -> 5819 bytes .../rich/__pycache__/color.cpython-312.pyc | Bin 0 -> 26570 bytes .../__pycache__/color_triplet.cpython-312.pyc | Bin 0 -> 1701 bytes .../rich/__pycache__/columns.cpython-312.pyc | Bin 0 -> 8587 bytes .../rich/__pycache__/console.cpython-312.pyc | Bin 0 -> 113694 bytes .../__pycache__/constrain.cpython-312.pyc | Bin 0 -> 2258 bytes .../__pycache__/containers.cpython-312.pyc | Bin 0 -> 9231 bytes .../rich/__pycache__/control.cpython-312.pyc | Bin 0 -> 10929 bytes .../default_styles.cpython-312.pyc | Bin 0 -> 10373 bytes .../rich/__pycache__/diagnose.cpython-312.pyc | Bin 0 -> 1487 bytes .../rich/__pycache__/emoji.cpython-312.pyc | Bin 0 -> 4209 bytes .../rich/__pycache__/errors.cpython-312.pyc | Bin 0 -> 1845 bytes .../__pycache__/file_proxy.cpython-312.pyc | Bin 0 -> 3577 bytes .../rich/__pycache__/filesize.cpython-312.pyc | Bin 0 -> 3082 bytes .../__pycache__/highlighter.cpython-312.pyc | Bin 0 -> 9899 bytes .../rich/__pycache__/json.cpython-312.pyc | Bin 0 -> 6035 bytes .../rich/__pycache__/jupyter.cpython-312.pyc | Bin 0 -> 5209 bytes .../rich/__pycache__/layout.cpython-312.pyc | Bin 0 -> 20220 bytes .../rich/__pycache__/live.cpython-312.pyc | Bin 0 -> 19143 bytes .../__pycache__/live_render.cpython-312.pyc | Bin 0 -> 4894 bytes .../rich/__pycache__/logging.cpython-312.pyc | Bin 0 -> 13554 bytes .../rich/__pycache__/markup.cpython-312.pyc | Bin 0 -> 9590 bytes .../rich/__pycache__/measure.cpython-312.pyc | Bin 0 -> 6376 bytes .../rich/__pycache__/padding.cpython-312.pyc | Bin 0 -> 7134 bytes .../rich/__pycache__/pager.cpython-312.pyc | Bin 0 -> 1820 bytes .../rich/__pycache__/palette.cpython-312.pyc | Bin 0 -> 5314 bytes .../rich/__pycache__/panel.cpython-312.pyc | Bin 0 -> 12188 bytes .../rich/__pycache__/pretty.cpython-312.pyc | Bin 0 -> 40165 bytes .../rich/__pycache__/progress.cpython-312.pyc | Bin 0 -> 75119 bytes .../__pycache__/progress_bar.cpython-312.pyc | Bin 0 -> 10389 bytes .../rich/__pycache__/prompt.cpython-312.pyc | Bin 0 -> 14787 bytes .../rich/__pycache__/protocol.cpython-312.pyc | Bin 0 -> 1792 bytes .../rich/__pycache__/region.cpython-312.pyc | Bin 0 -> 567 bytes .../rich/__pycache__/repr.cpython-312.pyc | Bin 0 -> 6624 bytes .../rich/__pycache__/rule.cpython-312.pyc | Bin 0 -> 6568 bytes .../rich/__pycache__/scope.cpython-312.pyc | Bin 0 -> 3830 bytes .../rich/__pycache__/screen.cpython-312.pyc | Bin 0 -> 2484 bytes .../rich/__pycache__/segment.cpython-312.pyc | Bin 0 -> 28161 bytes .../rich/__pycache__/spinner.cpython-312.pyc | Bin 0 -> 6064 bytes .../rich/__pycache__/status.cpython-312.pyc | Bin 0 -> 6068 bytes .../rich/__pycache__/style.cpython-312.pyc | Bin 0 -> 33514 bytes .../rich/__pycache__/styled.cpython-312.pyc | Bin 0 -> 2139 bytes .../rich/__pycache__/syntax.cpython-312.pyc | Bin 0 -> 39975 bytes .../rich/__pycache__/table.cpython-312.pyc | Bin 0 -> 43584 bytes .../terminal_theme.cpython-312.pyc | Bin 0 -> 3348 bytes .../rich/__pycache__/text.cpython-312.pyc | Bin 0 -> 60893 bytes .../rich/__pycache__/theme.cpython-312.pyc | Bin 0 -> 6340 bytes .../rich/__pycache__/themes.cpython-312.pyc | Bin 0 -> 314 bytes .../__pycache__/traceback.cpython-312.pyc | Bin 0 -> 31548 bytes .../rich/__pycache__/tree.cpython-312.pyc | Bin 0 -> 11439 bytes .../pip/_vendor/rich/_cell_widths.py | 454 + .../pip/_vendor/rich/_emoji_codes.py | 3610 +++++++ .../pip/_vendor/rich/_emoji_replace.py | 32 + .../pip/_vendor/rich/_export_format.py | 76 + .../pip/_vendor/rich/_extension.py | 10 + .../site-packages/pip/_vendor/rich/_fileno.py | 24 + .../pip/_vendor/rich/_inspect.py | 270 + .../pip/_vendor/rich/_log_render.py | 94 + .../site-packages/pip/_vendor/rich/_loop.py | 43 + .../pip/_vendor/rich/_null_file.py | 69 + .../pip/_vendor/rich/_palettes.py | 309 + .../site-packages/pip/_vendor/rich/_pick.py | 17 + .../site-packages/pip/_vendor/rich/_ratio.py | 159 + .../pip/_vendor/rich/_spinners.py | 482 + .../site-packages/pip/_vendor/rich/_stack.py | 16 + .../site-packages/pip/_vendor/rich/_timer.py | 19 + .../pip/_vendor/rich/_win32_console.py | 662 ++ .../pip/_vendor/rich/_windows.py | 71 + .../pip/_vendor/rich/_windows_renderer.py | 56 + .../site-packages/pip/_vendor/rich/_wrap.py | 93 + .../site-packages/pip/_vendor/rich/abc.py | 33 + .../site-packages/pip/_vendor/rich/align.py | 311 + .../site-packages/pip/_vendor/rich/ansi.py | 240 + .../site-packages/pip/_vendor/rich/bar.py | 93 + .../site-packages/pip/_vendor/rich/box.py | 480 + .../site-packages/pip/_vendor/rich/cells.py | 167 + .../site-packages/pip/_vendor/rich/color.py | 621 ++ .../pip/_vendor/rich/color_triplet.py | 38 + .../site-packages/pip/_vendor/rich/columns.py | 187 + .../site-packages/pip/_vendor/rich/console.py | 2633 +++++ .../pip/_vendor/rich/constrain.py | 37 + .../pip/_vendor/rich/containers.py | 167 + .../site-packages/pip/_vendor/rich/control.py | 225 + .../pip/_vendor/rich/default_styles.py | 190 + .../pip/_vendor/rich/diagnose.py | 37 + .../site-packages/pip/_vendor/rich/emoji.py | 96 + .../site-packages/pip/_vendor/rich/errors.py | 34 + .../pip/_vendor/rich/file_proxy.py | 57 + .../pip/_vendor/rich/filesize.py | 89 + .../pip/_vendor/rich/highlighter.py | 232 + .../site-packages/pip/_vendor/rich/json.py | 139 + .../site-packages/pip/_vendor/rich/jupyter.py | 101 + .../site-packages/pip/_vendor/rich/layout.py | 442 + .../site-packages/pip/_vendor/rich/live.py | 375 + .../pip/_vendor/rich/live_render.py | 112 + .../site-packages/pip/_vendor/rich/logging.py | 289 + .../site-packages/pip/_vendor/rich/markup.py | 251 + .../site-packages/pip/_vendor/rich/measure.py | 151 + .../site-packages/pip/_vendor/rich/padding.py | 141 + .../site-packages/pip/_vendor/rich/pager.py | 34 + .../site-packages/pip/_vendor/rich/palette.py | 100 + .../site-packages/pip/_vendor/rich/panel.py | 312 + .../site-packages/pip/_vendor/rich/pretty.py | 995 ++ .../pip/_vendor/rich/progress.py | 1699 ++++ .../pip/_vendor/rich/progress_bar.py | 223 + .../site-packages/pip/_vendor/rich/prompt.py | 375 + .../pip/_vendor/rich/protocol.py | 42 + .../site-packages/pip/_vendor/rich/py.typed | 0 .../site-packages/pip/_vendor/rich/region.py | 10 + .../site-packages/pip/_vendor/rich/repr.py | 149 + .../site-packages/pip/_vendor/rich/rule.py | 130 + .../site-packages/pip/_vendor/rich/scope.py | 86 + .../site-packages/pip/_vendor/rich/screen.py | 54 + .../site-packages/pip/_vendor/rich/segment.py | 738 ++ .../site-packages/pip/_vendor/rich/spinner.py | 137 + .../site-packages/pip/_vendor/rich/status.py | 131 + .../site-packages/pip/_vendor/rich/style.py | 796 ++ .../site-packages/pip/_vendor/rich/styled.py | 42 + .../site-packages/pip/_vendor/rich/syntax.py | 958 ++ .../site-packages/pip/_vendor/rich/table.py | 1000 ++ .../pip/_vendor/rich/terminal_theme.py | 153 + .../site-packages/pip/_vendor/rich/text.py | 1357 +++ .../site-packages/pip/_vendor/rich/theme.py | 115 + .../site-packages/pip/_vendor/rich/themes.py | 5 + .../pip/_vendor/rich/traceback.py | 753 ++ .../site-packages/pip/_vendor/rich/tree.py | 249 + .../pip/_vendor/tomli/__init__.py | 11 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 384 bytes .../tomli/__pycache__/_parser.cpython-312.pyc | Bin 0 -> 26927 bytes .../tomli/__pycache__/_re.cpython-312.pyc | Bin 0 -> 3908 bytes .../tomli/__pycache__/_types.cpython-312.pyc | Bin 0 -> 366 bytes .../pip/_vendor/tomli/_parser.py | 691 ++ .../site-packages/pip/_vendor/tomli/_re.py | 107 + .../site-packages/pip/_vendor/tomli/_types.py | 10 + .../site-packages/pip/_vendor/tomli/py.typed | 1 + .../pip/_vendor/truststore/__init__.py | 13 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 618 bytes .../__pycache__/_api.cpython-312.pyc | Bin 0 -> 16541 bytes .../__pycache__/_macos.cpython-312.pyc | Bin 0 -> 16577 bytes .../__pycache__/_openssl.cpython-312.pyc | Bin 0 -> 2215 bytes .../_ssl_constants.cpython-312.pyc | Bin 0 -> 1099 bytes .../__pycache__/_windows.cpython-312.pyc | Bin 0 -> 15750 bytes .../pip/_vendor/truststore/_api.py | 313 + .../pip/_vendor/truststore/_macos.py | 499 + .../pip/_vendor/truststore/_openssl.py | 66 + .../pip/_vendor/truststore/_ssl_constants.py | 31 + .../pip/_vendor/truststore/_windows.py | 564 ++ .../pip/_vendor/truststore/py.typed | 0 .../pip/_vendor/typing_extensions.py | 3641 +++++++ .../pip/_vendor/urllib3/__init__.py | 102 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 3405 bytes .../__pycache__/_collections.cpython-312.pyc | Bin 0 -> 16488 bytes .../__pycache__/_version.cpython-312.pyc | Bin 0 -> 218 bytes .../__pycache__/connection.cpython-312.pyc | Bin 0 -> 20407 bytes .../connectionpool.cpython-312.pyc | Bin 0 -> 36442 bytes .../__pycache__/exceptions.cpython-312.pyc | Bin 0 -> 13493 bytes .../__pycache__/fields.cpython-312.pyc | Bin 0 -> 10413 bytes .../__pycache__/filepost.cpython-312.pyc | Bin 0 -> 4018 bytes .../__pycache__/poolmanager.cpython-312.pyc | Bin 0 -> 20472 bytes .../__pycache__/request.cpython-312.pyc | Bin 0 -> 7294 bytes .../__pycache__/response.cpython-312.pyc | Bin 0 -> 33968 bytes .../pip/_vendor/urllib3/_collections.py | 355 + .../pip/_vendor/urllib3/_version.py | 2 + .../pip/_vendor/urllib3/connection.py | 572 ++ .../pip/_vendor/urllib3/connectionpool.py | 1137 +++ .../pip/_vendor/urllib3/contrib/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 198 bytes .../_appengine_environ.cpython-312.pyc | Bin 0 -> 1848 bytes .../__pycache__/appengine.cpython-312.pyc | Bin 0 -> 11564 bytes .../__pycache__/ntlmpool.cpython-312.pyc | Bin 0 -> 5719 bytes .../__pycache__/pyopenssl.cpython-312.pyc | Bin 0 -> 24450 bytes .../securetransport.cpython-312.pyc | Bin 0 -> 35553 bytes .../contrib/__pycache__/socks.cpython-312.pyc | Bin 0 -> 7511 bytes .../urllib3/contrib/_appengine_environ.py | 36 + .../contrib/_securetransport/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 215 bytes .../__pycache__/bindings.cpython-312.pyc | Bin 0 -> 17427 bytes .../__pycache__/low_level.cpython-312.pyc | Bin 0 -> 14801 bytes .../contrib/_securetransport/bindings.py | 519 + .../contrib/_securetransport/low_level.py | 397 + .../pip/_vendor/urllib3/contrib/appengine.py | 314 + .../pip/_vendor/urllib3/contrib/ntlmpool.py | 130 + .../pip/_vendor/urllib3/contrib/pyopenssl.py | 518 + .../urllib3/contrib/securetransport.py | 920 ++ .../pip/_vendor/urllib3/contrib/socks.py | 216 + .../pip/_vendor/urllib3/exceptions.py | 323 + .../pip/_vendor/urllib3/fields.py | 274 + .../pip/_vendor/urllib3/filepost.py | 98 + .../pip/_vendor/urllib3/packages/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 199 bytes .../packages/__pycache__/six.cpython-312.pyc | Bin 0 -> 41319 bytes .../urllib3/packages/backports/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 209 bytes .../__pycache__/makefile.cpython-312.pyc | Bin 0 -> 1825 bytes .../weakref_finalize.cpython-312.pyc | Bin 0 -> 7331 bytes .../urllib3/packages/backports/makefile.py | 51 + .../packages/backports/weakref_finalize.py | 155 + .../pip/_vendor/urllib3/packages/six.py | 1076 +++ .../pip/_vendor/urllib3/poolmanager.py | 540 ++ .../pip/_vendor/urllib3/request.py | 191 + .../pip/_vendor/urllib3/response.py | 879 ++ .../pip/_vendor/urllib3/util/__init__.py | 49 + .../util/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 1146 bytes .../__pycache__/connection.cpython-312.pyc | Bin 0 -> 4756 bytes .../util/__pycache__/proxy.cpython-312.pyc | Bin 0 -> 1552 bytes .../util/__pycache__/queue.cpython-312.pyc | Bin 0 -> 1352 bytes .../util/__pycache__/request.cpython-312.pyc | Bin 0 -> 4183 bytes .../util/__pycache__/response.cpython-312.pyc | Bin 0 -> 2989 bytes .../util/__pycache__/retry.cpython-312.pyc | Bin 0 -> 21697 bytes .../util/__pycache__/ssl_.cpython-312.pyc | Bin 0 -> 15103 bytes .../ssl_match_hostname.cpython-312.pyc | Bin 0 -> 5071 bytes .../__pycache__/ssltransport.cpython-312.pyc | Bin 0 -> 10772 bytes .../util/__pycache__/timeout.cpython-312.pyc | Bin 0 -> 11139 bytes .../util/__pycache__/url.cpython-312.pyc | Bin 0 -> 15795 bytes .../util/__pycache__/wait.cpython-312.pyc | Bin 0 -> 4403 bytes .../pip/_vendor/urllib3/util/connection.py | 149 + .../pip/_vendor/urllib3/util/proxy.py | 57 + .../pip/_vendor/urllib3/util/queue.py | 22 + .../pip/_vendor/urllib3/util/request.py | 137 + .../pip/_vendor/urllib3/util/response.py | 107 + .../pip/_vendor/urllib3/util/retry.py | 620 ++ .../pip/_vendor/urllib3/util/ssl_.py | 495 + .../urllib3/util/ssl_match_hostname.py | 159 + .../pip/_vendor/urllib3/util/ssltransport.py | 221 + .../pip/_vendor/urllib3/util/timeout.py | 271 + .../pip/_vendor/urllib3/util/url.py | 435 + .../pip/_vendor/urllib3/util/wait.py | 152 + .../site-packages/pip/_vendor/vendor.txt | 18 + .../lib/python3.12/site-packages/pip/py.typed | 4 + .../requests-2.32.3.dist-info/INSTALLER | 1 + .../requests-2.32.3.dist-info/LICENSE | 175 + .../requests-2.32.3.dist-info/METADATA | 119 + .../requests-2.32.3.dist-info/RECORD | 43 + .../requests-2.32.3.dist-info/REQUESTED | 0 .../requests-2.32.3.dist-info/WHEEL | 5 + .../requests-2.32.3.dist-info/top_level.txt | 1 + .../site-packages/requests/__init__.py | 184 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 5408 bytes .../__pycache__/__version__.cpython-312.pyc | Bin 0 -> 572 bytes .../_internal_utils.cpython-312.pyc | Bin 0 -> 2012 bytes .../__pycache__/adapters.cpython-312.pyc | Bin 0 -> 28352 bytes .../requests/__pycache__/api.cpython-312.pyc | Bin 0 -> 7192 bytes .../requests/__pycache__/auth.cpython-312.pyc | Bin 0 -> 13911 bytes .../__pycache__/certs.cpython-312.pyc | Bin 0 -> 654 bytes .../__pycache__/compat.cpython-312.pyc | Bin 0 -> 2073 bytes .../__pycache__/cookies.cpython-312.pyc | Bin 0 -> 25264 bytes .../__pycache__/exceptions.cpython-312.pyc | Bin 0 -> 7573 bytes .../requests/__pycache__/help.cpython-312.pyc | Bin 0 -> 4315 bytes .../__pycache__/hooks.cpython-312.pyc | Bin 0 -> 1040 bytes .../__pycache__/models.cpython-312.pyc | Bin 0 -> 35394 bytes .../__pycache__/packages.cpython-312.pyc | Bin 0 -> 1127 bytes .../__pycache__/sessions.cpython-312.pyc | Bin 0 -> 27870 bytes .../__pycache__/status_codes.cpython-312.pyc | Bin 0 -> 6019 bytes .../__pycache__/structures.cpython-312.pyc | Bin 0 -> 5605 bytes .../__pycache__/utils.cpython-312.pyc | Bin 0 -> 36418 bytes .../site-packages/requests/__version__.py | 14 + .../site-packages/requests/_internal_utils.py | 50 + .../site-packages/requests/adapters.py | 719 ++ .../python3.12/site-packages/requests/api.py | 157 + .../python3.12/site-packages/requests/auth.py | 314 + .../site-packages/requests/certs.py | 17 + .../site-packages/requests/compat.py | 94 + .../site-packages/requests/cookies.py | 561 ++ .../site-packages/requests/exceptions.py | 151 + .../python3.12/site-packages/requests/help.py | 134 + .../site-packages/requests/hooks.py | 33 + .../site-packages/requests/models.py | 1037 ++ .../site-packages/requests/packages.py | 23 + .../site-packages/requests/sessions.py | 831 ++ .../site-packages/requests/status_codes.py | 128 + .../site-packages/requests/structures.py | 99 + .../site-packages/requests/utils.py | 1096 +++ .../urllib3-2.2.2.dist-info/INSTALLER | 1 + .../urllib3-2.2.2.dist-info/METADATA | 154 + .../urllib3-2.2.2.dist-info/RECORD | 75 + .../urllib3-2.2.2.dist-info/WHEEL | 4 + .../licenses/LICENSE.txt | 21 + .../site-packages/urllib3/__init__.py | 211 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 7303 bytes .../_base_connection.cpython-312.pyc | Bin 0 -> 6850 bytes .../__pycache__/_collections.cpython-312.pyc | Bin 0 -> 22702 bytes .../_request_methods.cpython-312.pyc | Bin 0 -> 10665 bytes .../__pycache__/_version.cpython-312.pyc | Bin 0 -> 256 bytes .../__pycache__/connection.cpython-312.pyc | Bin 0 -> 32253 bytes .../connectionpool.cpython-312.pyc | Bin 0 -> 39736 bytes .../__pycache__/exceptions.cpython-312.pyc | Bin 0 -> 15825 bytes .../__pycache__/fields.cpython-312.pyc | Bin 0 -> 12065 bytes .../__pycache__/filepost.cpython-312.pyc | Bin 0 -> 3506 bytes .../urllib3/__pycache__/http2.cpython-312.pyc | Bin 0 -> 11028 bytes .../__pycache__/poolmanager.cpython-312.pyc | Bin 0 -> 24067 bytes .../__pycache__/response.cpython-312.pyc | Bin 0 -> 50453 bytes .../site-packages/urllib3/_base_connection.py | 172 + .../site-packages/urllib3/_collections.py | 483 + .../site-packages/urllib3/_request_methods.py | 279 + .../site-packages/urllib3/_version.py | 4 + .../site-packages/urllib3/connection.py | 929 ++ .../site-packages/urllib3/connectionpool.py | 1182 +++ .../site-packages/urllib3/contrib/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 186 bytes .../__pycache__/pyopenssl.cpython-312.pyc | Bin 0 -> 26923 bytes .../contrib/__pycache__/socks.cpython-312.pyc | Bin 0 -> 8164 bytes .../urllib3/contrib/emscripten/__init__.py | 16 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 894 bytes .../__pycache__/connection.cpython-312.pyc | Bin 0 -> 10233 bytes .../__pycache__/fetch.cpython-312.pyc | Bin 0 -> 18366 bytes .../__pycache__/request.cpython-312.pyc | Bin 0 -> 1414 bytes .../__pycache__/response.cpython-312.pyc | Bin 0 -> 12699 bytes .../urllib3/contrib/emscripten/connection.py | 254 + .../emscripten/emscripten_fetch_worker.js | 110 + .../urllib3/contrib/emscripten/fetch.py | 418 + .../urllib3/contrib/emscripten/request.py | 22 + .../urllib3/contrib/emscripten/response.py | 285 + .../urllib3/contrib/pyopenssl.py | 548 ++ .../site-packages/urllib3/contrib/socks.py | 228 + .../site-packages/urllib3/exceptions.py | 321 + .../site-packages/urllib3/fields.py | 341 + .../site-packages/urllib3/filepost.py | 89 + .../python3.12/site-packages/urllib3/http2.py | 230 + .../site-packages/urllib3/poolmanager.py | 637 ++ .../python3.12/site-packages/urllib3/py.typed | 2 + .../site-packages/urllib3/response.py | 1265 +++ .../site-packages/urllib3/util/__init__.py | 42 + .../util/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 999 bytes .../__pycache__/connection.cpython-312.pyc | Bin 0 -> 4742 bytes .../util/__pycache__/proxy.cpython-312.pyc | Bin 0 -> 1211 bytes .../util/__pycache__/request.cpython-312.pyc | Bin 0 -> 8030 bytes .../util/__pycache__/response.cpython-312.pyc | Bin 0 -> 2867 bytes .../util/__pycache__/retry.cpython-312.pyc | Bin 0 -> 20280 bytes .../util/__pycache__/ssl_.cpython-312.pyc | Bin 0 -> 16568 bytes .../ssl_match_hostname.cpython-312.pyc | Bin 0 -> 5551 bytes .../__pycache__/ssltransport.cpython-312.pyc | Bin 0 -> 13545 bytes .../util/__pycache__/timeout.cpython-312.pyc | Bin 0 -> 11683 bytes .../util/__pycache__/url.cpython-312.pyc | Bin 0 -> 16223 bytes .../util/__pycache__/util.cpython-312.pyc | Bin 0 -> 1988 bytes .../util/__pycache__/wait.cpython-312.pyc | Bin 0 -> 3434 bytes .../site-packages/urllib3/util/connection.py | 137 + .../site-packages/urllib3/util/proxy.py | 43 + .../site-packages/urllib3/util/request.py | 256 + .../site-packages/urllib3/util/response.py | 101 + .../site-packages/urllib3/util/retry.py | 533 + .../site-packages/urllib3/util/ssl_.py | 509 + .../urllib3/util/ssl_match_hostname.py | 159 + .../urllib3/util/ssltransport.py | 279 + .../site-packages/urllib3/util/timeout.py | 275 + .../site-packages/urllib3/util/url.py | 471 + .../site-packages/urllib3/util/util.py | 42 + .../site-packages/urllib3/util/wait.py | 124 + .venv/lib64 | 1 + .venv/pyvenv.cfg | 5 + block_ips.sh | 160 + check_external_repos.py | 363 + cross_namespace_communication.py | 53 + filter_repos.py | 28 + iptables_rules_template.txt | 192 + merge_ips.py | 25 + nexus/artifactory_export.py | 31 + nexus/nexus_content.py | 154 + nexus/nexus_import.py | 189 + nexus/remote_artifactory.py | 60 + result.json | 2 + sonarqube.py | 37 + sonarqube.sh | 21 + test_payload.json | 32 + 1356 files changed, 210505 insertions(+) create mode 100644 .venv/bin/Activate.ps1 create mode 100644 .venv/bin/activate create mode 100644 .venv/bin/activate.csh create mode 100644 .venv/bin/activate.fish create mode 100755 .venv/bin/normalizer create mode 100755 .venv/bin/pip create mode 100755 .venv/bin/pip3 create mode 100755 .venv/bin/pip3.12 create mode 120000 .venv/bin/python create mode 120000 .venv/bin/python3 create mode 120000 .venv/bin/python3.12 create mode 100644 .venv/lib/python3.12/site-packages/certifi-2024.7.4.dist-info/INSTALLER create mode 100644 .venv/lib/python3.12/site-packages/certifi-2024.7.4.dist-info/LICENSE create mode 100644 .venv/lib/python3.12/site-packages/certifi-2024.7.4.dist-info/METADATA create mode 100644 .venv/lib/python3.12/site-packages/certifi-2024.7.4.dist-info/RECORD create mode 100644 .venv/lib/python3.12/site-packages/certifi-2024.7.4.dist-info/WHEEL create mode 100644 .venv/lib/python3.12/site-packages/certifi-2024.7.4.dist-info/top_level.txt create mode 100644 .venv/lib/python3.12/site-packages/certifi/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/certifi/__main__.py create mode 100644 .venv/lib/python3.12/site-packages/certifi/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/certifi/__pycache__/__main__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/certifi/__pycache__/core.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/certifi/cacert.pem create mode 100644 .venv/lib/python3.12/site-packages/certifi/core.py create mode 100644 .venv/lib/python3.12/site-packages/certifi/py.typed create mode 100644 .venv/lib/python3.12/site-packages/charset_normalizer-3.3.2.dist-info/INSTALLER create mode 100644 .venv/lib/python3.12/site-packages/charset_normalizer-3.3.2.dist-info/LICENSE create mode 100644 .venv/lib/python3.12/site-packages/charset_normalizer-3.3.2.dist-info/METADATA create mode 100644 .venv/lib/python3.12/site-packages/charset_normalizer-3.3.2.dist-info/RECORD create mode 100644 .venv/lib/python3.12/site-packages/charset_normalizer-3.3.2.dist-info/WHEEL create mode 100644 .venv/lib/python3.12/site-packages/charset_normalizer-3.3.2.dist-info/entry_points.txt create mode 100644 .venv/lib/python3.12/site-packages/charset_normalizer-3.3.2.dist-info/top_level.txt create mode 100644 .venv/lib/python3.12/site-packages/charset_normalizer/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/charset_normalizer/__main__.py create mode 100644 .venv/lib/python3.12/site-packages/charset_normalizer/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/charset_normalizer/__pycache__/__main__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/charset_normalizer/__pycache__/api.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/charset_normalizer/__pycache__/cd.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/charset_normalizer/__pycache__/constant.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/charset_normalizer/__pycache__/legacy.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/charset_normalizer/__pycache__/md.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/charset_normalizer/__pycache__/models.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/charset_normalizer/__pycache__/utils.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/charset_normalizer/__pycache__/version.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/charset_normalizer/api.py create mode 100644 .venv/lib/python3.12/site-packages/charset_normalizer/cd.py create mode 100644 .venv/lib/python3.12/site-packages/charset_normalizer/cli/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/charset_normalizer/cli/__main__.py create mode 100644 .venv/lib/python3.12/site-packages/charset_normalizer/cli/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/charset_normalizer/cli/__pycache__/__main__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/charset_normalizer/constant.py create mode 100644 .venv/lib/python3.12/site-packages/charset_normalizer/legacy.py create mode 100755 .venv/lib/python3.12/site-packages/charset_normalizer/md.cpython-312-x86_64-linux-gnu.so create mode 100644 .venv/lib/python3.12/site-packages/charset_normalizer/md.py create mode 100755 .venv/lib/python3.12/site-packages/charset_normalizer/md__mypyc.cpython-312-x86_64-linux-gnu.so create mode 100644 .venv/lib/python3.12/site-packages/charset_normalizer/models.py create mode 100644 .venv/lib/python3.12/site-packages/charset_normalizer/py.typed create mode 100644 .venv/lib/python3.12/site-packages/charset_normalizer/utils.py create mode 100644 .venv/lib/python3.12/site-packages/charset_normalizer/version.py create mode 100644 .venv/lib/python3.12/site-packages/dns/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/_asyncbackend.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/_asyncio_backend.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/_ddr.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/_features.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/_immutable_ctx.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/_trio_backend.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/asyncbackend.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/asyncquery.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/asyncresolver.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/dnssec.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/dnssectypes.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/e164.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/edns.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/entropy.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/enum.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/exception.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/flags.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/grange.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/immutable.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/inet.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/ipv4.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/ipv6.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/message.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/name.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/namedict.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/nameserver.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/node.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/opcode.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/query.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/rcode.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/rdata.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/rdataclass.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/rdataset.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/rdatatype.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/renderer.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/resolver.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/reversename.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/rrset.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/serial.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/set.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/tokenizer.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/transaction.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/tsig.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/tsigkeyring.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/ttl.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/update.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/version.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/versioned.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/win32util.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/wire.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/xfr.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/zone.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/zonefile.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/__pycache__/zonetypes.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/_asyncbackend.py create mode 100644 .venv/lib/python3.12/site-packages/dns/_asyncio_backend.py create mode 100644 .venv/lib/python3.12/site-packages/dns/_ddr.py create mode 100644 .venv/lib/python3.12/site-packages/dns/_features.py create mode 100644 .venv/lib/python3.12/site-packages/dns/_immutable_ctx.py create mode 100644 .venv/lib/python3.12/site-packages/dns/_trio_backend.py create mode 100644 .venv/lib/python3.12/site-packages/dns/asyncbackend.py create mode 100644 .venv/lib/python3.12/site-packages/dns/asyncquery.py create mode 100644 .venv/lib/python3.12/site-packages/dns/asyncresolver.py create mode 100644 .venv/lib/python3.12/site-packages/dns/dnssec.py create mode 100644 .venv/lib/python3.12/site-packages/dns/dnssecalgs/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/dns/dnssecalgs/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/dnssecalgs/__pycache__/base.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/dnssecalgs/__pycache__/cryptography.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/dnssecalgs/__pycache__/dsa.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/dnssecalgs/__pycache__/ecdsa.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/dnssecalgs/__pycache__/eddsa.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/dnssecalgs/__pycache__/rsa.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/dnssecalgs/base.py create mode 100644 .venv/lib/python3.12/site-packages/dns/dnssecalgs/cryptography.py create mode 100644 .venv/lib/python3.12/site-packages/dns/dnssecalgs/dsa.py create mode 100644 .venv/lib/python3.12/site-packages/dns/dnssecalgs/ecdsa.py create mode 100644 .venv/lib/python3.12/site-packages/dns/dnssecalgs/eddsa.py create mode 100644 .venv/lib/python3.12/site-packages/dns/dnssecalgs/rsa.py create mode 100644 .venv/lib/python3.12/site-packages/dns/dnssectypes.py create mode 100644 .venv/lib/python3.12/site-packages/dns/e164.py create mode 100644 .venv/lib/python3.12/site-packages/dns/edns.py create mode 100644 .venv/lib/python3.12/site-packages/dns/entropy.py create mode 100644 .venv/lib/python3.12/site-packages/dns/enum.py create mode 100644 .venv/lib/python3.12/site-packages/dns/exception.py create mode 100644 .venv/lib/python3.12/site-packages/dns/flags.py create mode 100644 .venv/lib/python3.12/site-packages/dns/grange.py create mode 100644 .venv/lib/python3.12/site-packages/dns/immutable.py create mode 100644 .venv/lib/python3.12/site-packages/dns/inet.py create mode 100644 .venv/lib/python3.12/site-packages/dns/ipv4.py create mode 100644 .venv/lib/python3.12/site-packages/dns/ipv6.py create mode 100644 .venv/lib/python3.12/site-packages/dns/message.py create mode 100644 .venv/lib/python3.12/site-packages/dns/name.py create mode 100644 .venv/lib/python3.12/site-packages/dns/namedict.py create mode 100644 .venv/lib/python3.12/site-packages/dns/nameserver.py create mode 100644 .venv/lib/python3.12/site-packages/dns/node.py create mode 100644 .venv/lib/python3.12/site-packages/dns/opcode.py create mode 100644 .venv/lib/python3.12/site-packages/dns/py.typed create mode 100644 .venv/lib/python3.12/site-packages/dns/query.py create mode 100644 .venv/lib/python3.12/site-packages/dns/quic/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/dns/quic/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/quic/__pycache__/_asyncio.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/quic/__pycache__/_common.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/quic/__pycache__/_sync.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/quic/__pycache__/_trio.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/quic/_asyncio.py create mode 100644 .venv/lib/python3.12/site-packages/dns/quic/_common.py create mode 100644 .venv/lib/python3.12/site-packages/dns/quic/_sync.py create mode 100644 .venv/lib/python3.12/site-packages/dns/quic/_trio.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rcode.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdata.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdataclass.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdataset.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdatatype.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/AFSDB.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/AMTRELAY.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/AVC.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/CAA.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/CDNSKEY.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/CDS.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/CERT.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/CNAME.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/CSYNC.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/DLV.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/DNAME.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/DNSKEY.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/DS.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/EUI48.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/EUI64.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/GPOS.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/HINFO.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/HIP.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/ISDN.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/L32.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/L64.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/LOC.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/LP.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/MX.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/NID.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/NINFO.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/NS.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/NSEC.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/NSEC3.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/NSEC3PARAM.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/OPENPGPKEY.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/OPT.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/PTR.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/RP.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/RRSIG.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/RT.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/SMIMEA.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/SOA.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/SPF.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/SSHFP.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/TKEY.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/TLSA.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/TSIG.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/TXT.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/URI.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/X25.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/ZONEMD.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/AFSDB.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/AMTRELAY.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/AVC.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/CAA.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/CDNSKEY.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/CDS.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/CERT.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/CNAME.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/CSYNC.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/DLV.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/DNAME.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/DNSKEY.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/DS.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/EUI48.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/EUI64.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/GPOS.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/HINFO.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/HIP.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/ISDN.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/L32.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/L64.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/LOC.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/LP.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/MX.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/NID.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/NINFO.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/NS.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/NSEC.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/NSEC3.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/NSEC3PARAM.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/OPENPGPKEY.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/OPT.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/PTR.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/RP.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/RRSIG.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/RT.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/SMIMEA.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/SOA.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/SPF.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/SSHFP.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/TKEY.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/TLSA.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/TSIG.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/TXT.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/URI.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/X25.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/ZONEMD.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/CH/A.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/CH/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/CH/__pycache__/A.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/CH/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/IN/A.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/IN/AAAA.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/IN/APL.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/IN/DHCID.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/IN/HTTPS.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/IN/IPSECKEY.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/IN/KX.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/IN/NAPTR.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/IN/NSAP.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/IN/NSAP_PTR.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/IN/PX.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/IN/SRV.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/IN/SVCB.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/IN/WKS.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/IN/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/IN/__pycache__/A.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/IN/__pycache__/AAAA.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/IN/__pycache__/APL.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/IN/__pycache__/DHCID.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/IN/__pycache__/HTTPS.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/IN/__pycache__/IPSECKEY.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/IN/__pycache__/KX.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/IN/__pycache__/NAPTR.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/IN/__pycache__/NSAP.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/IN/__pycache__/NSAP_PTR.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/IN/__pycache__/PX.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/IN/__pycache__/SRV.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/IN/__pycache__/SVCB.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/IN/__pycache__/WKS.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/IN/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/__pycache__/dnskeybase.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/__pycache__/dsbase.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/__pycache__/euibase.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/__pycache__/mxbase.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/__pycache__/nsbase.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/__pycache__/svcbbase.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/__pycache__/tlsabase.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/__pycache__/txtbase.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/__pycache__/util.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/dnskeybase.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/dsbase.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/euibase.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/mxbase.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/nsbase.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/svcbbase.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/tlsabase.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/txtbase.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rdtypes/util.py create mode 100644 .venv/lib/python3.12/site-packages/dns/renderer.py create mode 100644 .venv/lib/python3.12/site-packages/dns/resolver.py create mode 100644 .venv/lib/python3.12/site-packages/dns/reversename.py create mode 100644 .venv/lib/python3.12/site-packages/dns/rrset.py create mode 100644 .venv/lib/python3.12/site-packages/dns/serial.py create mode 100644 .venv/lib/python3.12/site-packages/dns/set.py create mode 100644 .venv/lib/python3.12/site-packages/dns/tokenizer.py create mode 100644 .venv/lib/python3.12/site-packages/dns/transaction.py create mode 100644 .venv/lib/python3.12/site-packages/dns/tsig.py create mode 100644 .venv/lib/python3.12/site-packages/dns/tsigkeyring.py create mode 100644 .venv/lib/python3.12/site-packages/dns/ttl.py create mode 100644 .venv/lib/python3.12/site-packages/dns/update.py create mode 100644 .venv/lib/python3.12/site-packages/dns/version.py create mode 100644 .venv/lib/python3.12/site-packages/dns/versioned.py create mode 100644 .venv/lib/python3.12/site-packages/dns/win32util.py create mode 100644 .venv/lib/python3.12/site-packages/dns/wire.py create mode 100644 .venv/lib/python3.12/site-packages/dns/xfr.py create mode 100644 .venv/lib/python3.12/site-packages/dns/zone.py create mode 100644 .venv/lib/python3.12/site-packages/dns/zonefile.py create mode 100644 .venv/lib/python3.12/site-packages/dns/zonetypes.py create mode 100644 .venv/lib/python3.12/site-packages/dnspython-2.6.1.dist-info/INSTALLER create mode 100644 .venv/lib/python3.12/site-packages/dnspython-2.6.1.dist-info/METADATA create mode 100644 .venv/lib/python3.12/site-packages/dnspython-2.6.1.dist-info/RECORD create mode 100644 .venv/lib/python3.12/site-packages/dnspython-2.6.1.dist-info/REQUESTED create mode 100644 .venv/lib/python3.12/site-packages/dnspython-2.6.1.dist-info/WHEEL create mode 100644 .venv/lib/python3.12/site-packages/dnspython-2.6.1.dist-info/licenses/LICENSE create mode 100644 .venv/lib/python3.12/site-packages/idna-3.7.dist-info/INSTALLER create mode 100644 .venv/lib/python3.12/site-packages/idna-3.7.dist-info/LICENSE.md create mode 100644 .venv/lib/python3.12/site-packages/idna-3.7.dist-info/METADATA create mode 100644 .venv/lib/python3.12/site-packages/idna-3.7.dist-info/RECORD create mode 100644 .venv/lib/python3.12/site-packages/idna-3.7.dist-info/WHEEL create mode 100644 .venv/lib/python3.12/site-packages/idna/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/idna/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/idna/__pycache__/codec.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/idna/__pycache__/compat.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/idna/__pycache__/core.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/idna/__pycache__/idnadata.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/idna/__pycache__/intranges.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/idna/__pycache__/package_data.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/idna/__pycache__/uts46data.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/idna/codec.py create mode 100644 .venv/lib/python3.12/site-packages/idna/compat.py create mode 100644 .venv/lib/python3.12/site-packages/idna/core.py create mode 100644 .venv/lib/python3.12/site-packages/idna/idnadata.py create mode 100644 .venv/lib/python3.12/site-packages/idna/intranges.py create mode 100644 .venv/lib/python3.12/site-packages/idna/package_data.py create mode 100644 .venv/lib/python3.12/site-packages/idna/py.typed create mode 100644 .venv/lib/python3.12/site-packages/idna/uts46data.py create mode 100644 .venv/lib/python3.12/site-packages/pip-24.2.dist-info/AUTHORS.txt create mode 100644 .venv/lib/python3.12/site-packages/pip-24.2.dist-info/INSTALLER create mode 100644 .venv/lib/python3.12/site-packages/pip-24.2.dist-info/LICENSE.txt create mode 100644 .venv/lib/python3.12/site-packages/pip-24.2.dist-info/METADATA create mode 100644 .venv/lib/python3.12/site-packages/pip-24.2.dist-info/RECORD create mode 100644 .venv/lib/python3.12/site-packages/pip-24.2.dist-info/REQUESTED create mode 100644 .venv/lib/python3.12/site-packages/pip-24.2.dist-info/WHEEL create mode 100644 .venv/lib/python3.12/site-packages/pip-24.2.dist-info/entry_points.txt create mode 100644 .venv/lib/python3.12/site-packages/pip-24.2.dist-info/top_level.txt create mode 100644 .venv/lib/python3.12/site-packages/pip/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/__main__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/__pip-runner__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/__pycache__/__main__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/__pycache__/__pip-runner__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/__pycache__/build_env.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/__pycache__/cache.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/__pycache__/configuration.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/__pycache__/exceptions.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/__pycache__/main.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/__pycache__/pyproject.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/__pycache__/self_outdated_check.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/__pycache__/wheel_builder.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/build_env.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/cache.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/cli/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/autocompletion.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/base_command.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/cmdoptions.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/command_context.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/index_command.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/main.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/main_parser.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/parser.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/progress_bars.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/req_command.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/spinners.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/status_codes.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/cli/autocompletion.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/cli/base_command.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/cli/cmdoptions.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/cli/command_context.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/cli/index_command.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/cli/main.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/cli/main_parser.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/cli/parser.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/cli/progress_bars.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/cli/req_command.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/cli/spinners.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/cli/status_codes.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/commands/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/cache.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/check.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/completion.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/configuration.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/debug.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/download.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/freeze.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/hash.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/help.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/index.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/inspect.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/install.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/list.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/search.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/show.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/uninstall.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/wheel.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/commands/cache.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/commands/check.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/commands/completion.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/commands/configuration.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/commands/debug.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/commands/download.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/commands/freeze.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/commands/hash.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/commands/help.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/commands/index.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/commands/inspect.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/commands/install.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/commands/list.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/commands/search.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/commands/show.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/commands/uninstall.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/commands/wheel.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/configuration.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/distributions/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/distributions/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/distributions/__pycache__/base.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/distributions/__pycache__/installed.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/distributions/__pycache__/sdist.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/distributions/__pycache__/wheel.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/distributions/base.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/distributions/installed.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/distributions/sdist.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/distributions/wheel.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/exceptions.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/index/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/index/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/index/__pycache__/collector.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/index/__pycache__/package_finder.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/index/__pycache__/sources.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/index/collector.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/index/package_finder.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/index/sources.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/locations/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/locations/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/locations/__pycache__/_distutils.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/locations/__pycache__/_sysconfig.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/locations/__pycache__/base.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/locations/_distutils.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/locations/_sysconfig.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/locations/base.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/main.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/metadata/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/metadata/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/metadata/__pycache__/_json.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/metadata/__pycache__/base.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/metadata/__pycache__/pkg_resources.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/metadata/_json.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/metadata/base.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/__pycache__/_compat.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/__pycache__/_dists.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/__pycache__/_envs.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/_compat.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/_dists.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/_envs.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/metadata/pkg_resources.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/models/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/candidate.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/direct_url.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/format_control.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/index.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/installation_report.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/link.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/scheme.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/search_scope.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/selection_prefs.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/target_python.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/wheel.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/models/candidate.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/models/direct_url.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/models/format_control.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/models/index.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/models/installation_report.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/models/link.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/models/scheme.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/models/search_scope.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/models/selection_prefs.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/models/target_python.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/models/wheel.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/network/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/auth.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/cache.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/download.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/lazy_wheel.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/session.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/utils.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/xmlrpc.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/network/auth.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/network/cache.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/network/download.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/network/lazy_wheel.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/network/session.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/network/utils.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/network/xmlrpc.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/operations/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/operations/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/operations/__pycache__/check.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/operations/__pycache__/freeze.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/operations/__pycache__/prepare.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/operations/build/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/build_tracker.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/metadata.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/metadata_editable.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/metadata_legacy.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/wheel.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/wheel_editable.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/wheel_legacy.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/operations/build/build_tracker.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/operations/build/metadata.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/operations/build/metadata_editable.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/operations/build/metadata_legacy.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/operations/build/wheel.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/operations/build/wheel_editable.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/operations/build/wheel_legacy.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/operations/check.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/operations/freeze.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/operations/install/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/operations/install/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/operations/install/__pycache__/editable_legacy.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/operations/install/__pycache__/wheel.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/operations/install/editable_legacy.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/operations/install/wheel.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/operations/prepare.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/pyproject.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/req/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/req/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/req/__pycache__/constructors.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/req/__pycache__/req_file.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/req/__pycache__/req_install.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/req/__pycache__/req_set.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/req/__pycache__/req_uninstall.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/req/constructors.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/req/req_file.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/req/req_install.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/req/req_set.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/req/req_uninstall.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/resolution/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/resolution/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/resolution/__pycache__/base.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/resolution/base.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/resolution/legacy/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/resolution/legacy/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/resolution/legacy/__pycache__/resolver.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/resolution/legacy/resolver.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/base.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/candidates.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/factory.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/found_candidates.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/provider.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/reporter.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/requirements.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/resolver.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/base.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/candidates.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/factory.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/found_candidates.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/provider.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/reporter.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/requirements.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/resolver.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/self_outdated_check.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/_jaraco_text.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/_log.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/appdirs.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/compat.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/compatibility_tags.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/datetime.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/deprecation.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/direct_url_helpers.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/egg_link.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/encoding.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/entrypoints.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/filesystem.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/filetypes.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/glibc.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/hashes.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/logging.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/misc.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/packaging.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/retry.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/setuptools_build.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/subprocess.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/temp_dir.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/unpacking.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/urls.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/virtualenv.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/wheel.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/_jaraco_text.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/_log.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/appdirs.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/compat.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/compatibility_tags.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/datetime.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/deprecation.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/direct_url_helpers.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/egg_link.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/encoding.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/entrypoints.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/filesystem.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/filetypes.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/glibc.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/hashes.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/logging.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/misc.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/packaging.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/retry.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/setuptools_build.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/subprocess.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/temp_dir.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/unpacking.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/urls.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/virtualenv.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/utils/wheel.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/vcs/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/vcs/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/vcs/__pycache__/bazaar.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/vcs/__pycache__/git.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/vcs/__pycache__/mercurial.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/vcs/__pycache__/subversion.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/vcs/__pycache__/versioncontrol.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/vcs/bazaar.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/vcs/git.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/vcs/mercurial.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/vcs/subversion.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/vcs/versioncontrol.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_internal/wheel_builder.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/__pycache__/typing_extensions.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/_cmd.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/adapter.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/cache.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/controller.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/filewrapper.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/heuristics.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/serialize.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/wrapper.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/_cmd.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/adapter.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/cache.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/__pycache__/file_cache.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/__pycache__/redis_cache.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/file_cache.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/redis_cache.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/controller.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/filewrapper.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/heuristics.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/py.typed create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/serialize.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/wrapper.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/certifi/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/certifi/__main__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/certifi/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/certifi/__pycache__/__main__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/certifi/__pycache__/core.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/certifi/cacert.pem create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/certifi/core.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/certifi/py.typed create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/distlib/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/compat.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/database.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/index.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/locators.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/manifest.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/markers.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/metadata.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/resources.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/scripts.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/util.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/version.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/wheel.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/distlib/compat.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/distlib/database.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/distlib/index.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/distlib/locators.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/distlib/manifest.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/distlib/markers.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/distlib/metadata.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/distlib/resources.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/distlib/scripts.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/distlib/t32.exe create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/distlib/t64-arm.exe create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/distlib/t64.exe create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/distlib/util.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/distlib/version.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/distlib/w32.exe create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/distlib/w64-arm.exe create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/distlib/w64.exe create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/distlib/wheel.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/distro/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/distro/__main__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/distro/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/distro/__pycache__/__main__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/distro/__pycache__/distro.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/distro/distro.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/distro/py.typed create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/idna/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/codec.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/compat.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/core.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/idnadata.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/intranges.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/package_data.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/uts46data.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/idna/codec.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/idna/compat.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/idna/core.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/idna/idnadata.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/idna/intranges.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/idna/package_data.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/idna/py.typed create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/idna/uts46data.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/msgpack/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/msgpack/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/msgpack/__pycache__/exceptions.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/msgpack/__pycache__/ext.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/msgpack/__pycache__/fallback.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/msgpack/exceptions.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/msgpack/ext.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/msgpack/fallback.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/packaging/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/_elffile.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/_manylinux.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/_musllinux.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/_parser.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/_structures.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/_tokenizer.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/markers.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/metadata.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/requirements.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/specifiers.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/tags.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/utils.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/version.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/packaging/_elffile.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/packaging/_manylinux.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/packaging/_musllinux.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/packaging/_parser.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/packaging/_structures.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/packaging/_tokenizer.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/packaging/markers.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/packaging/metadata.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/packaging/py.typed create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/packaging/requirements.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/packaging/specifiers.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/packaging/tags.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/packaging/utils.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/packaging/version.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pkg_resources/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pkg_resources/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__main__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/__main__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/android.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/api.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/macos.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/unix.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/version.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/windows.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/android.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/api.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/macos.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/py.typed create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/unix.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/version.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/windows.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/__main__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/__main__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/cmdline.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/console.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/filter.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/formatter.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/lexer.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/modeline.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/plugin.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/regexopt.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/scanner.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/sphinxext.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/style.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/token.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/unistring.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/util.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/cmdline.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/console.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/filter.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/filters/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/filters/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatter.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/_mapping.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/bbcode.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/groff.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/html.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/img.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/irc.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/latex.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/other.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/pangomarkup.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/rtf.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/svg.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/terminal.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/terminal256.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/_mapping.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/bbcode.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/groff.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/html.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/img.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/irc.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/latex.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/other.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/pangomarkup.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/rtf.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/svg.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/terminal.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/terminal256.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/lexer.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/lexers/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/lexers/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/lexers/__pycache__/_mapping.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/lexers/__pycache__/python.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/lexers/_mapping.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/lexers/python.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/modeline.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/plugin.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/regexopt.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/scanner.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/sphinxext.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/style.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/styles/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/styles/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/styles/__pycache__/_mapping.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/styles/_mapping.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/token.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/unistring.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pygments/util.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pyproject_hooks/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pyproject_hooks/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pyproject_hooks/__pycache__/_compat.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pyproject_hooks/__pycache__/_impl.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pyproject_hooks/_compat.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pyproject_hooks/_impl.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pyproject_hooks/_in_process/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pyproject_hooks/_in_process/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pyproject_hooks/_in_process/__pycache__/_in_process.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/pyproject_hooks/_in_process/_in_process.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/requests/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/requests/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/requests/__pycache__/__version__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/requests/__pycache__/_internal_utils.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/requests/__pycache__/adapters.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/requests/__pycache__/api.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/requests/__pycache__/auth.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/requests/__pycache__/certs.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/requests/__pycache__/compat.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/requests/__pycache__/cookies.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/requests/__pycache__/exceptions.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/requests/__pycache__/help.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/requests/__pycache__/hooks.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/requests/__pycache__/models.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/requests/__pycache__/packages.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/requests/__pycache__/sessions.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/requests/__pycache__/status_codes.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/requests/__pycache__/structures.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/requests/__pycache__/utils.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/requests/__version__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/requests/_internal_utils.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/requests/adapters.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/requests/api.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/requests/auth.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/requests/certs.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/requests/compat.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/requests/cookies.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/requests/exceptions.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/requests/help.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/requests/hooks.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/requests/models.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/requests/packages.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/requests/sessions.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/requests/status_codes.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/requests/structures.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/requests/utils.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/resolvelib/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/resolvelib/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/resolvelib/__pycache__/providers.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/resolvelib/__pycache__/reporters.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/resolvelib/__pycache__/resolvers.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/resolvelib/__pycache__/structs.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/resolvelib/compat/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/resolvelib/compat/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/resolvelib/compat/__pycache__/collections_abc.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/resolvelib/compat/collections_abc.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/resolvelib/providers.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/resolvelib/py.typed create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/resolvelib/reporters.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/resolvelib/resolvers.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/resolvelib/structs.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__main__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/__main__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/_cell_widths.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/_emoji_codes.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/_emoji_replace.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/_export_format.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/_extension.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/_fileno.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/_inspect.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/_log_render.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/_loop.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/_null_file.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/_palettes.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/_pick.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/_ratio.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/_spinners.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/_stack.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/_timer.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/_win32_console.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/_windows.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/_windows_renderer.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/_wrap.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/abc.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/align.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/ansi.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/bar.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/box.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/cells.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/color.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/color_triplet.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/columns.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/console.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/constrain.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/containers.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/control.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/default_styles.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/diagnose.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/emoji.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/errors.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/file_proxy.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/filesize.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/highlighter.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/json.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/jupyter.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/layout.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/live.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/live_render.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/logging.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/markup.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/measure.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/padding.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/pager.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/palette.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/panel.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/pretty.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/progress.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/progress_bar.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/prompt.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/protocol.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/region.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/repr.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/rule.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/scope.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/screen.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/segment.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/spinner.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/status.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/style.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/styled.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/syntax.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/table.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/terminal_theme.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/text.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/theme.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/themes.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/traceback.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/__pycache__/tree.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/_cell_widths.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/_emoji_codes.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/_emoji_replace.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/_export_format.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/_extension.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/_fileno.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/_inspect.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/_log_render.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/_loop.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/_null_file.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/_palettes.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/_pick.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/_ratio.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/_spinners.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/_stack.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/_timer.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/_win32_console.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/_windows.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/_windows_renderer.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/_wrap.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/abc.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/align.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/ansi.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/bar.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/box.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/cells.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/color.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/color_triplet.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/columns.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/console.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/constrain.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/containers.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/control.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/default_styles.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/diagnose.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/emoji.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/errors.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/file_proxy.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/filesize.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/highlighter.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/json.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/jupyter.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/layout.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/live.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/live_render.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/logging.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/markup.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/measure.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/padding.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/pager.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/palette.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/panel.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/pretty.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/progress.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/progress_bar.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/prompt.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/protocol.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/py.typed create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/region.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/repr.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/rule.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/scope.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/screen.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/segment.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/spinner.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/status.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/style.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/styled.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/syntax.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/table.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/terminal_theme.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/text.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/theme.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/themes.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/traceback.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/rich/tree.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/tomli/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/tomli/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/tomli/__pycache__/_parser.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/tomli/__pycache__/_re.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/tomli/__pycache__/_types.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/tomli/_parser.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/tomli/_re.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/tomli/_types.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/tomli/py.typed create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/truststore/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/truststore/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/truststore/__pycache__/_api.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/truststore/__pycache__/_macos.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/truststore/__pycache__/_openssl.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/truststore/__pycache__/_ssl_constants.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/truststore/__pycache__/_windows.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/truststore/_api.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/truststore/_macos.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/truststore/_openssl.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/truststore/_ssl_constants.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/truststore/_windows.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/truststore/py.typed create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/typing_extensions.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/_collections.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/_version.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/connection.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/connectionpool.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/exceptions.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/fields.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/filepost.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/poolmanager.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/request.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/response.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/_collections.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/_version.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/connection.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/connectionpool.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__pycache__/_appengine_environ.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__pycache__/appengine.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__pycache__/ntlmpool.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__pycache__/pyopenssl.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__pycache__/securetransport.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__pycache__/socks.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_appengine_environ.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/__pycache__/bindings.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/__pycache__/low_level.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/bindings.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/low_level.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/appengine.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/ntlmpool.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/pyopenssl.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/securetransport.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/socks.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/exceptions.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/fields.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/filepost.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/__pycache__/six.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/backports/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/backports/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/backports/__pycache__/makefile.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/backports/__pycache__/weakref_finalize.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/backports/makefile.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/backports/weakref_finalize.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/six.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/poolmanager.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/request.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/response.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/connection.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/proxy.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/queue.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/request.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/response.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/retry.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/ssl_.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/ssl_match_hostname.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/ssltransport.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/timeout.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/url.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/wait.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/connection.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/proxy.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/queue.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/request.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/response.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/retry.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/ssl_.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/ssl_match_hostname.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/ssltransport.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/timeout.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/url.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/wait.py create mode 100644 .venv/lib/python3.12/site-packages/pip/_vendor/vendor.txt create mode 100644 .venv/lib/python3.12/site-packages/pip/py.typed create mode 100644 .venv/lib/python3.12/site-packages/requests-2.32.3.dist-info/INSTALLER create mode 100644 .venv/lib/python3.12/site-packages/requests-2.32.3.dist-info/LICENSE create mode 100644 .venv/lib/python3.12/site-packages/requests-2.32.3.dist-info/METADATA create mode 100644 .venv/lib/python3.12/site-packages/requests-2.32.3.dist-info/RECORD create mode 100644 .venv/lib/python3.12/site-packages/requests-2.32.3.dist-info/REQUESTED create mode 100644 .venv/lib/python3.12/site-packages/requests-2.32.3.dist-info/WHEEL create mode 100644 .venv/lib/python3.12/site-packages/requests-2.32.3.dist-info/top_level.txt create mode 100644 .venv/lib/python3.12/site-packages/requests/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/requests/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/requests/__pycache__/__version__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/requests/__pycache__/_internal_utils.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/requests/__pycache__/adapters.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/requests/__pycache__/api.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/requests/__pycache__/auth.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/requests/__pycache__/certs.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/requests/__pycache__/compat.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/requests/__pycache__/cookies.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/requests/__pycache__/exceptions.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/requests/__pycache__/help.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/requests/__pycache__/hooks.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/requests/__pycache__/models.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/requests/__pycache__/packages.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/requests/__pycache__/sessions.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/requests/__pycache__/status_codes.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/requests/__pycache__/structures.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/requests/__pycache__/utils.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/requests/__version__.py create mode 100644 .venv/lib/python3.12/site-packages/requests/_internal_utils.py create mode 100644 .venv/lib/python3.12/site-packages/requests/adapters.py create mode 100644 .venv/lib/python3.12/site-packages/requests/api.py create mode 100644 .venv/lib/python3.12/site-packages/requests/auth.py create mode 100644 .venv/lib/python3.12/site-packages/requests/certs.py create mode 100644 .venv/lib/python3.12/site-packages/requests/compat.py create mode 100644 .venv/lib/python3.12/site-packages/requests/cookies.py create mode 100644 .venv/lib/python3.12/site-packages/requests/exceptions.py create mode 100644 .venv/lib/python3.12/site-packages/requests/help.py create mode 100644 .venv/lib/python3.12/site-packages/requests/hooks.py create mode 100644 .venv/lib/python3.12/site-packages/requests/models.py create mode 100644 .venv/lib/python3.12/site-packages/requests/packages.py create mode 100644 .venv/lib/python3.12/site-packages/requests/sessions.py create mode 100644 .venv/lib/python3.12/site-packages/requests/status_codes.py create mode 100644 .venv/lib/python3.12/site-packages/requests/structures.py create mode 100644 .venv/lib/python3.12/site-packages/requests/utils.py create mode 100644 .venv/lib/python3.12/site-packages/urllib3-2.2.2.dist-info/INSTALLER create mode 100644 .venv/lib/python3.12/site-packages/urllib3-2.2.2.dist-info/METADATA create mode 100644 .venv/lib/python3.12/site-packages/urllib3-2.2.2.dist-info/RECORD create mode 100644 .venv/lib/python3.12/site-packages/urllib3-2.2.2.dist-info/WHEEL create mode 100644 .venv/lib/python3.12/site-packages/urllib3-2.2.2.dist-info/licenses/LICENSE.txt create mode 100644 .venv/lib/python3.12/site-packages/urllib3/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/urllib3/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/urllib3/__pycache__/_base_connection.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/urllib3/__pycache__/_collections.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/urllib3/__pycache__/_request_methods.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/urllib3/__pycache__/_version.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/urllib3/__pycache__/connection.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/urllib3/__pycache__/connectionpool.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/urllib3/__pycache__/exceptions.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/urllib3/__pycache__/fields.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/urllib3/__pycache__/filepost.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/urllib3/__pycache__/http2.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/urllib3/__pycache__/poolmanager.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/urllib3/__pycache__/response.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/urllib3/_base_connection.py create mode 100644 .venv/lib/python3.12/site-packages/urllib3/_collections.py create mode 100644 .venv/lib/python3.12/site-packages/urllib3/_request_methods.py create mode 100644 .venv/lib/python3.12/site-packages/urllib3/_version.py create mode 100644 .venv/lib/python3.12/site-packages/urllib3/connection.py create mode 100644 .venv/lib/python3.12/site-packages/urllib3/connectionpool.py create mode 100644 .venv/lib/python3.12/site-packages/urllib3/contrib/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/urllib3/contrib/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/urllib3/contrib/__pycache__/pyopenssl.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/urllib3/contrib/__pycache__/socks.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/urllib3/contrib/emscripten/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/urllib3/contrib/emscripten/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/urllib3/contrib/emscripten/__pycache__/connection.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/urllib3/contrib/emscripten/__pycache__/fetch.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/urllib3/contrib/emscripten/__pycache__/request.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/urllib3/contrib/emscripten/__pycache__/response.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/urllib3/contrib/emscripten/connection.py create mode 100644 .venv/lib/python3.12/site-packages/urllib3/contrib/emscripten/emscripten_fetch_worker.js create mode 100644 .venv/lib/python3.12/site-packages/urllib3/contrib/emscripten/fetch.py create mode 100644 .venv/lib/python3.12/site-packages/urllib3/contrib/emscripten/request.py create mode 100644 .venv/lib/python3.12/site-packages/urllib3/contrib/emscripten/response.py create mode 100644 .venv/lib/python3.12/site-packages/urllib3/contrib/pyopenssl.py create mode 100644 .venv/lib/python3.12/site-packages/urllib3/contrib/socks.py create mode 100644 .venv/lib/python3.12/site-packages/urllib3/exceptions.py create mode 100644 .venv/lib/python3.12/site-packages/urllib3/fields.py create mode 100644 .venv/lib/python3.12/site-packages/urllib3/filepost.py create mode 100644 .venv/lib/python3.12/site-packages/urllib3/http2.py create mode 100644 .venv/lib/python3.12/site-packages/urllib3/poolmanager.py create mode 100644 .venv/lib/python3.12/site-packages/urllib3/py.typed create mode 100644 .venv/lib/python3.12/site-packages/urllib3/response.py create mode 100644 .venv/lib/python3.12/site-packages/urllib3/util/__init__.py create mode 100644 .venv/lib/python3.12/site-packages/urllib3/util/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/urllib3/util/__pycache__/connection.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/urllib3/util/__pycache__/proxy.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/urllib3/util/__pycache__/request.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/urllib3/util/__pycache__/response.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/urllib3/util/__pycache__/retry.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/urllib3/util/__pycache__/ssl_.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/urllib3/util/__pycache__/ssl_match_hostname.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/urllib3/util/__pycache__/ssltransport.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/urllib3/util/__pycache__/timeout.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/urllib3/util/__pycache__/url.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/urllib3/util/__pycache__/util.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/urllib3/util/__pycache__/wait.cpython-312.pyc create mode 100644 .venv/lib/python3.12/site-packages/urllib3/util/connection.py create mode 100644 .venv/lib/python3.12/site-packages/urllib3/util/proxy.py create mode 100644 .venv/lib/python3.12/site-packages/urllib3/util/request.py create mode 100644 .venv/lib/python3.12/site-packages/urllib3/util/response.py create mode 100644 .venv/lib/python3.12/site-packages/urllib3/util/retry.py create mode 100644 .venv/lib/python3.12/site-packages/urllib3/util/ssl_.py create mode 100644 .venv/lib/python3.12/site-packages/urllib3/util/ssl_match_hostname.py create mode 100644 .venv/lib/python3.12/site-packages/urllib3/util/ssltransport.py create mode 100644 .venv/lib/python3.12/site-packages/urllib3/util/timeout.py create mode 100644 .venv/lib/python3.12/site-packages/urllib3/util/url.py create mode 100644 .venv/lib/python3.12/site-packages/urllib3/util/util.py create mode 100644 .venv/lib/python3.12/site-packages/urllib3/util/wait.py create mode 120000 .venv/lib64 create mode 100644 .venv/pyvenv.cfg create mode 100644 block_ips.sh create mode 100644 check_external_repos.py create mode 100644 cross_namespace_communication.py create mode 100644 filter_repos.py create mode 100644 iptables_rules_template.txt create mode 100644 merge_ips.py create mode 100644 nexus/artifactory_export.py create mode 100644 nexus/nexus_content.py create mode 100644 nexus/nexus_import.py create mode 100644 nexus/remote_artifactory.py create mode 100644 result.json create mode 100644 sonarqube.py create mode 100644 sonarqube.sh create mode 100644 test_payload.json diff --git a/.venv/bin/Activate.ps1 b/.venv/bin/Activate.ps1 new file mode 100644 index 0000000..b49d77b --- /dev/null +++ b/.venv/bin/Activate.ps1 @@ -0,0 +1,247 @@ +<# +.Synopsis +Activate a Python virtual environment for the current PowerShell session. + +.Description +Pushes the python executable for a virtual environment to the front of the +$Env:PATH environment variable and sets the prompt to signify that you are +in a Python virtual environment. Makes use of the command line switches as +well as the `pyvenv.cfg` file values present in the virtual environment. + +.Parameter VenvDir +Path to the directory that contains the virtual environment to activate. The +default value for this is the parent of the directory that the Activate.ps1 +script is located within. + +.Parameter Prompt +The prompt prefix to display when this virtual environment is activated. By +default, this prompt is the name of the virtual environment folder (VenvDir) +surrounded by parentheses and followed by a single space (ie. '(.venv) '). + +.Example +Activate.ps1 +Activates the Python virtual environment that contains the Activate.ps1 script. + +.Example +Activate.ps1 -Verbose +Activates the Python virtual environment that contains the Activate.ps1 script, +and shows extra information about the activation as it executes. + +.Example +Activate.ps1 -VenvDir C:\Users\MyUser\Common\.venv +Activates the Python virtual environment located in the specified location. + +.Example +Activate.ps1 -Prompt "MyPython" +Activates the Python virtual environment that contains the Activate.ps1 script, +and prefixes the current prompt with the specified string (surrounded in +parentheses) while the virtual environment is active. + +.Notes +On Windows, it may be required to enable this Activate.ps1 script by setting the +execution policy for the user. You can do this by issuing the following PowerShell +command: + +PS C:\> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser + +For more information on Execution Policies: +https://go.microsoft.com/fwlink/?LinkID=135170 + +#> +Param( + [Parameter(Mandatory = $false)] + [String] + $VenvDir, + [Parameter(Mandatory = $false)] + [String] + $Prompt +) + +<# Function declarations --------------------------------------------------- #> + +<# +.Synopsis +Remove all shell session elements added by the Activate script, including the +addition of the virtual environment's Python executable from the beginning of +the PATH variable. + +.Parameter NonDestructive +If present, do not remove this function from the global namespace for the +session. + +#> +function global:deactivate ([switch]$NonDestructive) { + # Revert to original values + + # The prior prompt: + if (Test-Path -Path Function:_OLD_VIRTUAL_PROMPT) { + Copy-Item -Path Function:_OLD_VIRTUAL_PROMPT -Destination Function:prompt + Remove-Item -Path Function:_OLD_VIRTUAL_PROMPT + } + + # The prior PYTHONHOME: + if (Test-Path -Path Env:_OLD_VIRTUAL_PYTHONHOME) { + Copy-Item -Path Env:_OLD_VIRTUAL_PYTHONHOME -Destination Env:PYTHONHOME + Remove-Item -Path Env:_OLD_VIRTUAL_PYTHONHOME + } + + # The prior PATH: + if (Test-Path -Path Env:_OLD_VIRTUAL_PATH) { + Copy-Item -Path Env:_OLD_VIRTUAL_PATH -Destination Env:PATH + Remove-Item -Path Env:_OLD_VIRTUAL_PATH + } + + # Just remove the VIRTUAL_ENV altogether: + if (Test-Path -Path Env:VIRTUAL_ENV) { + Remove-Item -Path env:VIRTUAL_ENV + } + + # Just remove VIRTUAL_ENV_PROMPT altogether. + if (Test-Path -Path Env:VIRTUAL_ENV_PROMPT) { + Remove-Item -Path env:VIRTUAL_ENV_PROMPT + } + + # Just remove the _PYTHON_VENV_PROMPT_PREFIX altogether: + if (Get-Variable -Name "_PYTHON_VENV_PROMPT_PREFIX" -ErrorAction SilentlyContinue) { + Remove-Variable -Name _PYTHON_VENV_PROMPT_PREFIX -Scope Global -Force + } + + # Leave deactivate function in the global namespace if requested: + if (-not $NonDestructive) { + Remove-Item -Path function:deactivate + } +} + +<# +.Description +Get-PyVenvConfig parses the values from the pyvenv.cfg file located in the +given folder, and returns them in a map. + +For each line in the pyvenv.cfg file, if that line can be parsed into exactly +two strings separated by `=` (with any amount of whitespace surrounding the =) +then it is considered a `key = value` line. The left hand string is the key, +the right hand is the value. + +If the value starts with a `'` or a `"` then the first and last character is +stripped from the value before being captured. + +.Parameter ConfigDir +Path to the directory that contains the `pyvenv.cfg` file. +#> +function Get-PyVenvConfig( + [String] + $ConfigDir +) { + Write-Verbose "Given ConfigDir=$ConfigDir, obtain values in pyvenv.cfg" + + # Ensure the file exists, and issue a warning if it doesn't (but still allow the function to continue). + $pyvenvConfigPath = Join-Path -Resolve -Path $ConfigDir -ChildPath 'pyvenv.cfg' -ErrorAction Continue + + # An empty map will be returned if no config file is found. + $pyvenvConfig = @{ } + + if ($pyvenvConfigPath) { + + Write-Verbose "File exists, parse `key = value` lines" + $pyvenvConfigContent = Get-Content -Path $pyvenvConfigPath + + $pyvenvConfigContent | ForEach-Object { + $keyval = $PSItem -split "\s*=\s*", 2 + if ($keyval[0] -and $keyval[1]) { + $val = $keyval[1] + + # Remove extraneous quotations around a string value. + if ("'""".Contains($val.Substring(0, 1))) { + $val = $val.Substring(1, $val.Length - 2) + } + + $pyvenvConfig[$keyval[0]] = $val + Write-Verbose "Adding Key: '$($keyval[0])'='$val'" + } + } + } + return $pyvenvConfig +} + + +<# Begin Activate script --------------------------------------------------- #> + +# Determine the containing directory of this script +$VenvExecPath = Split-Path -Parent $MyInvocation.MyCommand.Definition +$VenvExecDir = Get-Item -Path $VenvExecPath + +Write-Verbose "Activation script is located in path: '$VenvExecPath'" +Write-Verbose "VenvExecDir Fullname: '$($VenvExecDir.FullName)" +Write-Verbose "VenvExecDir Name: '$($VenvExecDir.Name)" + +# Set values required in priority: CmdLine, ConfigFile, Default +# First, get the location of the virtual environment, it might not be +# VenvExecDir if specified on the command line. +if ($VenvDir) { + Write-Verbose "VenvDir given as parameter, using '$VenvDir' to determine values" +} +else { + Write-Verbose "VenvDir not given as a parameter, using parent directory name as VenvDir." + $VenvDir = $VenvExecDir.Parent.FullName.TrimEnd("\\/") + Write-Verbose "VenvDir=$VenvDir" +} + +# Next, read the `pyvenv.cfg` file to determine any required value such +# as `prompt`. +$pyvenvCfg = Get-PyVenvConfig -ConfigDir $VenvDir + +# Next, set the prompt from the command line, or the config file, or +# just use the name of the virtual environment folder. +if ($Prompt) { + Write-Verbose "Prompt specified as argument, using '$Prompt'" +} +else { + Write-Verbose "Prompt not specified as argument to script, checking pyvenv.cfg value" + if ($pyvenvCfg -and $pyvenvCfg['prompt']) { + Write-Verbose " Setting based on value in pyvenv.cfg='$($pyvenvCfg['prompt'])'" + $Prompt = $pyvenvCfg['prompt']; + } + else { + Write-Verbose " Setting prompt based on parent's directory's name. (Is the directory name passed to venv module when creating the virtual environment)" + Write-Verbose " Got leaf-name of $VenvDir='$(Split-Path -Path $venvDir -Leaf)'" + $Prompt = Split-Path -Path $venvDir -Leaf + } +} + +Write-Verbose "Prompt = '$Prompt'" +Write-Verbose "VenvDir='$VenvDir'" + +# Deactivate any currently active virtual environment, but leave the +# deactivate function in place. +deactivate -nondestructive + +# Now set the environment variable VIRTUAL_ENV, used by many tools to determine +# that there is an activated venv. +$env:VIRTUAL_ENV = $VenvDir + +if (-not $Env:VIRTUAL_ENV_DISABLE_PROMPT) { + + Write-Verbose "Setting prompt to '$Prompt'" + + # Set the prompt to include the env name + # Make sure _OLD_VIRTUAL_PROMPT is global + function global:_OLD_VIRTUAL_PROMPT { "" } + Copy-Item -Path function:prompt -Destination function:_OLD_VIRTUAL_PROMPT + New-Variable -Name _PYTHON_VENV_PROMPT_PREFIX -Description "Python virtual environment prompt prefix" -Scope Global -Option ReadOnly -Visibility Public -Value $Prompt + + function global:prompt { + Write-Host -NoNewline -ForegroundColor Green "($_PYTHON_VENV_PROMPT_PREFIX) " + _OLD_VIRTUAL_PROMPT + } + $env:VIRTUAL_ENV_PROMPT = $Prompt +} + +# Clear PYTHONHOME +if (Test-Path -Path Env:PYTHONHOME) { + Copy-Item -Path Env:PYTHONHOME -Destination Env:_OLD_VIRTUAL_PYTHONHOME + Remove-Item -Path Env:PYTHONHOME +} + +# Add the venv to the PATH +Copy-Item -Path Env:PATH -Destination Env:_OLD_VIRTUAL_PATH +$Env:PATH = "$VenvExecDir$([System.IO.Path]::PathSeparator)$Env:PATH" diff --git a/.venv/bin/activate b/.venv/bin/activate new file mode 100644 index 0000000..b8a3313 --- /dev/null +++ b/.venv/bin/activate @@ -0,0 +1,70 @@ +# This file must be used with "source bin/activate" *from bash* +# You cannot run it directly + +deactivate () { + # reset old environment variables + if [ -n "${_OLD_VIRTUAL_PATH:-}" ] ; then + PATH="${_OLD_VIRTUAL_PATH:-}" + export PATH + unset _OLD_VIRTUAL_PATH + fi + if [ -n "${_OLD_VIRTUAL_PYTHONHOME:-}" ] ; then + PYTHONHOME="${_OLD_VIRTUAL_PYTHONHOME:-}" + export PYTHONHOME + unset _OLD_VIRTUAL_PYTHONHOME + fi + + # Call hash to forget past commands. Without forgetting + # past commands the $PATH changes we made may not be respected + hash -r 2> /dev/null + + if [ -n "${_OLD_VIRTUAL_PS1:-}" ] ; then + PS1="${_OLD_VIRTUAL_PS1:-}" + export PS1 + unset _OLD_VIRTUAL_PS1 + fi + + unset VIRTUAL_ENV + unset VIRTUAL_ENV_PROMPT + if [ ! "${1:-}" = "nondestructive" ] ; then + # Self destruct! + unset -f deactivate + fi +} + +# unset irrelevant variables +deactivate nondestructive + +# on Windows, a path can contain colons and backslashes and has to be converted: +if [ "${OSTYPE:-}" = "cygwin" ] || [ "${OSTYPE:-}" = "msys" ] ; then + # transform D:\path\to\venv to /d/path/to/venv on MSYS + # and to /cygdrive/d/path/to/venv on Cygwin + export VIRTUAL_ENV=$(cygpath "/home/rpetrovich/code/Misc/.venv") +else + # use the path as-is + export VIRTUAL_ENV="/home/rpetrovich/code/Misc/.venv" +fi + +_OLD_VIRTUAL_PATH="$PATH" +PATH="$VIRTUAL_ENV/bin:$PATH" +export PATH + +# unset PYTHONHOME if set +# this will fail if PYTHONHOME is set to the empty string (which is bad anyway) +# could use `if (set -u; : $PYTHONHOME) ;` in bash +if [ -n "${PYTHONHOME:-}" ] ; then + _OLD_VIRTUAL_PYTHONHOME="${PYTHONHOME:-}" + unset PYTHONHOME +fi + +if [ -z "${VIRTUAL_ENV_DISABLE_PROMPT:-}" ] ; then + _OLD_VIRTUAL_PS1="${PS1:-}" + PS1="(.venv) ${PS1:-}" + export PS1 + VIRTUAL_ENV_PROMPT="(.venv) " + export VIRTUAL_ENV_PROMPT +fi + +# Call hash to forget past commands. Without forgetting +# past commands the $PATH changes we made may not be respected +hash -r 2> /dev/null diff --git a/.venv/bin/activate.csh b/.venv/bin/activate.csh new file mode 100644 index 0000000..36652e1 --- /dev/null +++ b/.venv/bin/activate.csh @@ -0,0 +1,27 @@ +# This file must be used with "source bin/activate.csh" *from csh*. +# You cannot run it directly. + +# Created by Davide Di Blasi . +# Ported to Python 3.3 venv by Andrew Svetlov + +alias deactivate 'test $?_OLD_VIRTUAL_PATH != 0 && setenv PATH "$_OLD_VIRTUAL_PATH" && unset _OLD_VIRTUAL_PATH; rehash; test $?_OLD_VIRTUAL_PROMPT != 0 && set prompt="$_OLD_VIRTUAL_PROMPT" && unset _OLD_VIRTUAL_PROMPT; unsetenv VIRTUAL_ENV; unsetenv VIRTUAL_ENV_PROMPT; test "\!:*" != "nondestructive" && unalias deactivate' + +# Unset irrelevant variables. +deactivate nondestructive + +setenv VIRTUAL_ENV "/home/rpetrovich/code/Misc/.venv" + +set _OLD_VIRTUAL_PATH="$PATH" +setenv PATH "$VIRTUAL_ENV/bin:$PATH" + + +set _OLD_VIRTUAL_PROMPT="$prompt" + +if (! "$?VIRTUAL_ENV_DISABLE_PROMPT") then + set prompt = "(.venv) $prompt" + setenv VIRTUAL_ENV_PROMPT "(.venv) " +endif + +alias pydoc python -m pydoc + +rehash diff --git a/.venv/bin/activate.fish b/.venv/bin/activate.fish new file mode 100644 index 0000000..6215454 --- /dev/null +++ b/.venv/bin/activate.fish @@ -0,0 +1,69 @@ +# This file must be used with "source /bin/activate.fish" *from fish* +# (https://fishshell.com/). You cannot run it directly. + +function deactivate -d "Exit virtual environment and return to normal shell environment" + # reset old environment variables + if test -n "$_OLD_VIRTUAL_PATH" + set -gx PATH $_OLD_VIRTUAL_PATH + set -e _OLD_VIRTUAL_PATH + end + if test -n "$_OLD_VIRTUAL_PYTHONHOME" + set -gx PYTHONHOME $_OLD_VIRTUAL_PYTHONHOME + set -e _OLD_VIRTUAL_PYTHONHOME + end + + if test -n "$_OLD_FISH_PROMPT_OVERRIDE" + set -e _OLD_FISH_PROMPT_OVERRIDE + # prevents error when using nested fish instances (Issue #93858) + if functions -q _old_fish_prompt + functions -e fish_prompt + functions -c _old_fish_prompt fish_prompt + functions -e _old_fish_prompt + end + end + + set -e VIRTUAL_ENV + set -e VIRTUAL_ENV_PROMPT + if test "$argv[1]" != "nondestructive" + # Self-destruct! + functions -e deactivate + end +end + +# Unset irrelevant variables. +deactivate nondestructive + +set -gx VIRTUAL_ENV "/home/rpetrovich/code/Misc/.venv" + +set -gx _OLD_VIRTUAL_PATH $PATH +set -gx PATH "$VIRTUAL_ENV/bin" $PATH + +# Unset PYTHONHOME if set. +if set -q PYTHONHOME + set -gx _OLD_VIRTUAL_PYTHONHOME $PYTHONHOME + set -e PYTHONHOME +end + +if test -z "$VIRTUAL_ENV_DISABLE_PROMPT" + # fish uses a function instead of an env var to generate the prompt. + + # Save the current fish_prompt function as the function _old_fish_prompt. + functions -c fish_prompt _old_fish_prompt + + # With the original prompt function renamed, we can override with our own. + function fish_prompt + # Save the return status of the last command. + set -l old_status $status + + # Output the venv prompt; color taken from the blue of the Python logo. + printf "%s%s%s" (set_color 4B8BBE) "(.venv) " (set_color normal) + + # Restore the return status of the previous command. + echo "exit $old_status" | . + # Output the original/"old" prompt. + _old_fish_prompt + end + + set -gx _OLD_FISH_PROMPT_OVERRIDE "$VIRTUAL_ENV" + set -gx VIRTUAL_ENV_PROMPT "(.venv) " +end diff --git a/.venv/bin/normalizer b/.venv/bin/normalizer new file mode 100755 index 0000000..d749250 --- /dev/null +++ b/.venv/bin/normalizer @@ -0,0 +1,8 @@ +#!/home/rpetrovich/code/Misc/.venv/bin/python +# -*- coding: utf-8 -*- +import re +import sys +from charset_normalizer.cli import cli_detect +if __name__ == '__main__': + sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0]) + sys.exit(cli_detect()) diff --git a/.venv/bin/pip b/.venv/bin/pip new file mode 100755 index 0000000..67bfcbe --- /dev/null +++ b/.venv/bin/pip @@ -0,0 +1,8 @@ +#!/home/rpetrovich/code/Misc/.venv/bin/python +# -*- coding: utf-8 -*- +import re +import sys +from pip._internal.cli.main import main +if __name__ == '__main__': + sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0]) + sys.exit(main()) diff --git a/.venv/bin/pip3 b/.venv/bin/pip3 new file mode 100755 index 0000000..67bfcbe --- /dev/null +++ b/.venv/bin/pip3 @@ -0,0 +1,8 @@ +#!/home/rpetrovich/code/Misc/.venv/bin/python +# -*- coding: utf-8 -*- +import re +import sys +from pip._internal.cli.main import main +if __name__ == '__main__': + sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0]) + sys.exit(main()) diff --git a/.venv/bin/pip3.12 b/.venv/bin/pip3.12 new file mode 100755 index 0000000..67bfcbe --- /dev/null +++ b/.venv/bin/pip3.12 @@ -0,0 +1,8 @@ +#!/home/rpetrovich/code/Misc/.venv/bin/python +# -*- coding: utf-8 -*- +import re +import sys +from pip._internal.cli.main import main +if __name__ == '__main__': + sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0]) + sys.exit(main()) diff --git a/.venv/bin/python b/.venv/bin/python new file mode 120000 index 0000000..f140426 --- /dev/null +++ b/.venv/bin/python @@ -0,0 +1 @@ +/bin/python \ No newline at end of file diff --git a/.venv/bin/python3 b/.venv/bin/python3 new file mode 120000 index 0000000..d8654aa --- /dev/null +++ b/.venv/bin/python3 @@ -0,0 +1 @@ +python \ No newline at end of file diff --git a/.venv/bin/python3.12 b/.venv/bin/python3.12 new file mode 120000 index 0000000..d8654aa --- /dev/null +++ b/.venv/bin/python3.12 @@ -0,0 +1 @@ +python \ No newline at end of file diff --git a/.venv/lib/python3.12/site-packages/certifi-2024.7.4.dist-info/INSTALLER b/.venv/lib/python3.12/site-packages/certifi-2024.7.4.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/.venv/lib/python3.12/site-packages/certifi-2024.7.4.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/.venv/lib/python3.12/site-packages/certifi-2024.7.4.dist-info/LICENSE b/.venv/lib/python3.12/site-packages/certifi-2024.7.4.dist-info/LICENSE new file mode 100644 index 0000000..62b076c --- /dev/null +++ b/.venv/lib/python3.12/site-packages/certifi-2024.7.4.dist-info/LICENSE @@ -0,0 +1,20 @@ +This package contains a modified version of ca-bundle.crt: + +ca-bundle.crt -- Bundle of CA Root Certificates + +This is a bundle of X.509 certificates of public Certificate Authorities +(CA). These were automatically extracted from Mozilla's root certificates +file (certdata.txt). This file can be found in the mozilla source tree: +https://hg.mozilla.org/mozilla-central/file/tip/security/nss/lib/ckfw/builtins/certdata.txt +It contains the certificates in PEM format and therefore +can be directly used with curl / libcurl / php_curl, or with +an Apache+mod_ssl webserver for SSL client authentication. +Just configure this file as the SSLCACertificateFile.# + +***** BEGIN LICENSE BLOCK ***** +This Source Code Form is subject to the terms of the Mozilla Public License, +v. 2.0. If a copy of the MPL was not distributed with this file, You can obtain +one at http://mozilla.org/MPL/2.0/. + +***** END LICENSE BLOCK ***** +@(#) $RCSfile: certdata.txt,v $ $Revision: 1.80 $ $Date: 2011/11/03 15:11:58 $ diff --git a/.venv/lib/python3.12/site-packages/certifi-2024.7.4.dist-info/METADATA b/.venv/lib/python3.12/site-packages/certifi-2024.7.4.dist-info/METADATA new file mode 100644 index 0000000..5b357f5 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/certifi-2024.7.4.dist-info/METADATA @@ -0,0 +1,67 @@ +Metadata-Version: 2.1 +Name: certifi +Version: 2024.7.4 +Summary: Python package for providing Mozilla's CA Bundle. +Home-page: https://github.com/certifi/python-certifi +Author: Kenneth Reitz +Author-email: me@kennethreitz.com +License: MPL-2.0 +Project-URL: Source, https://github.com/certifi/python-certifi +Classifier: Development Status :: 5 - Production/Stable +Classifier: Intended Audience :: Developers +Classifier: License :: OSI Approved :: Mozilla Public License 2.0 (MPL 2.0) +Classifier: Natural Language :: English +Classifier: Programming Language :: Python +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3 :: Only +Classifier: Programming Language :: Python :: 3.6 +Classifier: Programming Language :: Python :: 3.7 +Classifier: Programming Language :: Python :: 3.8 +Classifier: Programming Language :: Python :: 3.9 +Classifier: Programming Language :: Python :: 3.10 +Classifier: Programming Language :: Python :: 3.11 +Classifier: Programming Language :: Python :: 3.12 +Requires-Python: >=3.6 +License-File: LICENSE + +Certifi: Python SSL Certificates +================================ + +Certifi provides Mozilla's carefully curated collection of Root Certificates for +validating the trustworthiness of SSL certificates while verifying the identity +of TLS hosts. It has been extracted from the `Requests`_ project. + +Installation +------------ + +``certifi`` is available on PyPI. Simply install it with ``pip``:: + + $ pip install certifi + +Usage +----- + +To reference the installed certificate authority (CA) bundle, you can use the +built-in function:: + + >>> import certifi + + >>> certifi.where() + '/usr/local/lib/python3.7/site-packages/certifi/cacert.pem' + +Or from the command line:: + + $ python -m certifi + /usr/local/lib/python3.7/site-packages/certifi/cacert.pem + +Enjoy! + +.. _`Requests`: https://requests.readthedocs.io/en/master/ + +Addition/Removal of Certificates +-------------------------------- + +Certifi does not support any addition/removal or other modification of the +CA trust store content. This project is intended to provide a reliable and +highly portable root of trust to python deployments. Look to upstream projects +for methods to use alternate trust. diff --git a/.venv/lib/python3.12/site-packages/certifi-2024.7.4.dist-info/RECORD b/.venv/lib/python3.12/site-packages/certifi-2024.7.4.dist-info/RECORD new file mode 100644 index 0000000..fea659e --- /dev/null +++ b/.venv/lib/python3.12/site-packages/certifi-2024.7.4.dist-info/RECORD @@ -0,0 +1,14 @@ +certifi-2024.7.4.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +certifi-2024.7.4.dist-info/LICENSE,sha256=6TcW2mucDVpKHfYP5pWzcPBpVgPSH2-D8FPkLPwQyvc,989 +certifi-2024.7.4.dist-info/METADATA,sha256=L9_EuPoQQvHFzxu03_ctaEZxhEty7inz569jGWjlLGo,2221 +certifi-2024.7.4.dist-info/RECORD,, +certifi-2024.7.4.dist-info/WHEEL,sha256=y4mX-SOX4fYIkonsAGA5N0Oy-8_gI4FXw5HNI1xqvWg,91 +certifi-2024.7.4.dist-info/top_level.txt,sha256=KMu4vUCfsjLrkPbSNdgdekS-pVJzBAJFO__nI8NF6-U,8 +certifi/__init__.py,sha256=LHXz7E80YJYBzCBv6ZyidQ5-ciYSkSebpY2E5OM0l7o,94 +certifi/__main__.py,sha256=xBBoj905TUWBLRGANOcf7oi6e-3dMP4cEoG9OyMs11g,243 +certifi/__pycache__/__init__.cpython-312.pyc,, +certifi/__pycache__/__main__.cpython-312.pyc,, +certifi/__pycache__/core.cpython-312.pyc,, +certifi/cacert.pem,sha256=SIupYGAr8HzGP073rsEIaS_sQYIPwzKKjj894DgUmu4,291528 +certifi/core.py,sha256=qRDDFyXVJwTB_EmoGppaXU_R9qCZvhl-EzxPMuV3nTA,4426 +certifi/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 diff --git a/.venv/lib/python3.12/site-packages/certifi-2024.7.4.dist-info/WHEEL b/.venv/lib/python3.12/site-packages/certifi-2024.7.4.dist-info/WHEEL new file mode 100644 index 0000000..564c672 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/certifi-2024.7.4.dist-info/WHEEL @@ -0,0 +1,5 @@ +Wheel-Version: 1.0 +Generator: setuptools (70.2.0) +Root-Is-Purelib: true +Tag: py3-none-any + diff --git a/.venv/lib/python3.12/site-packages/certifi-2024.7.4.dist-info/top_level.txt b/.venv/lib/python3.12/site-packages/certifi-2024.7.4.dist-info/top_level.txt new file mode 100644 index 0000000..963eac5 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/certifi-2024.7.4.dist-info/top_level.txt @@ -0,0 +1 @@ +certifi diff --git a/.venv/lib/python3.12/site-packages/certifi/__init__.py b/.venv/lib/python3.12/site-packages/certifi/__init__.py new file mode 100644 index 0000000..d321f1b --- /dev/null +++ b/.venv/lib/python3.12/site-packages/certifi/__init__.py @@ -0,0 +1,4 @@ +from .core import contents, where + +__all__ = ["contents", "where"] +__version__ = "2024.07.04" diff --git a/.venv/lib/python3.12/site-packages/certifi/__main__.py b/.venv/lib/python3.12/site-packages/certifi/__main__.py new file mode 100644 index 0000000..8945b5d --- /dev/null +++ b/.venv/lib/python3.12/site-packages/certifi/__main__.py @@ -0,0 +1,12 @@ +import argparse + +from certifi import contents, where + +parser = argparse.ArgumentParser() +parser.add_argument("-c", "--contents", action="store_true") +args = parser.parse_args() + +if args.contents: + print(contents()) +else: + print(where()) diff --git a/.venv/lib/python3.12/site-packages/certifi/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/certifi/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b599de714cae88091b6869be8f650d291c3c1251 GIT binary patch literal 305 zcmYjLJx{|h5Vi9`OQNzNBo<)IKpa9P7Q{aQ3C0Xq!M-*Yi5=M{Rhi%)u<;uZKZS)6 zWdVta4XIlvTnQxJ@b2Bcce;BSjUwcbTs%)MUHx1&fAD_AV%LdB#1Y3eYH)!YukbM9 z9`~nS;q#yf=3%n-gG?|$F!R#cG;-LtlrI+6H zPf+52;>FNP>UgPm5N|?nJvozRn~MW8@0;)Y-kUcwUuv}g)CiwWwog_3r8m{E7vS_r zf%iawpaFDrGzKU&I!0=COaul{=zCStGENq-V^h0dTk;hmCb5Y9*_oK<3@fFp9uclEsC+J*5Fh&c_{GS%Of3$HcG^Cg0nV^{{rTwx;Io&Z@$xhH} zUC==(a!w<`hcraei4(!{EDWR<^KKFIl1ewBT(E7%^?kT*RIY6D?l4tlA8QAf&fLl6 zrI?UNCC)V&%vrrJr8Qseg0oC~0{ta$_5}Cxlww{`!SfMIdN|1m#gAB-;P!}SBRpWw zaWNLXJiFh%dk>dP&{h#AFXApO@uDppMQO~kC~6nuGjBc3$#6g)@GI&B{aocUwfr>^ zLO)>jH(WpQo9`Mkzd7}rhyJx)=NOzB)TdBCc=+MY$5&sWegx~sZf)i^rf%cVy}E0i gnC{z+*Bjq0fA7}*?QhoFPlaym-+Z&hFRSAJ072Q7fdBvi literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/certifi/__pycache__/core.cpython-312.pyc b/.venv/lib/python3.12/site-packages/certifi/__pycache__/core.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..0fdf9e97d52ce860660a013ac6133a8fb4df453e GIT binary patch literal 3190 zcmbVO&u<&W7oXW5_S$i>N$faoQ)(-;v@T6dL-|paA1#4z3r*8135Z%q*0Q^4*0sH6 zcG@&0pd2`~rv`y&4hZGIp;b6=o_KG)>o_4C;92wD z+u51%%;$aHoBdyRca(r+r`BfQ>LcW5d1CUaYmAx8L4;uV?%6ePFvw{pEN*PKg;e`-%rQcO7`Rw_Wg% zAAk{2qsMElWwTBkRF@~tqe_s)*J(Mi*V2_DPr$7F(B*)S@YjevOuzQ zGAp=Uh4GW)Z%oY;#%JDjl|sS1YVkth4r${2$7geMcG=9as>zvs#nR_;x^0-bvzDXh zMz5HaE4h;Oey+N}=j_U}qesSaj>XN9s-|DkE}Blx2M8uH6HszhZ}rx33p&5bkh9pF z1gIr)Us5-uR82~)Bv$z9%n#BbhHT6V4{_fQk;ky*u;vtIt&-`=s2v@8+tSA5|IpQm z$cel=cfWQ0%>ALgUw*ieK3Yp3t*4)_54~`G;(o0E=D8c^ zzC3p~cK8={Xk8id{%K1DF-q8)?|^~``tc!9vI1mwhl}wiJE%izX#UU6LocJU77NU&5%wH5py86~X!D9-d4KhvG5STlZVNAB~GlPAorl2*EPZ;^s%C6Ok?_Rj8j;|}@tsqlZe!BuS z|5}&rjGl*loUksLZrHDqn17CanL%#je%ufwqRkw=9XIF}gQ0WN2J-5bg|$S5R6|BAyyF=NV8C-WciW|9t;v2Ubtt z?H*|m8cBbfxECM1b?nn)pB?{0gy%o7^LJE_9W1QBhsD({Qjt;3h%he4q3H`waWj;X-Mozuh3*=SFjy649mM=!(tV!Y~qcJml%{| z39EIMx^&jTlINp^b=L#B1df9s1Ic1NH&5L-Aw7d{SJKFZ0=v7u^utHr&=X&NVsZ~(5KrPGamvMX~hx%an7SWe&T vOEpBW5BhgEWU#P>c(M^jPa%DY299Y&NwmA!g None: + _CACERT_CTX.__exit__(None, None, None) # type: ignore[union-attr] + + +if sys.version_info >= (3, 11): + + from importlib.resources import as_file, files + + _CACERT_CTX = None + _CACERT_PATH = None + + def where() -> str: + # This is slightly terrible, but we want to delay extracting the file + # in cases where we're inside of a zipimport situation until someone + # actually calls where(), but we don't want to re-extract the file + # on every call of where(), so we'll do it once then store it in a + # global variable. + global _CACERT_CTX + global _CACERT_PATH + if _CACERT_PATH is None: + # This is slightly janky, the importlib.resources API wants you to + # manage the cleanup of this file, so it doesn't actually return a + # path, it returns a context manager that will give you the path + # when you enter it and will do any cleanup when you leave it. In + # the common case of not needing a temporary file, it will just + # return the file system location and the __exit__() is a no-op. + # + # We also have to hold onto the actual context manager, because + # it will do the cleanup whenever it gets garbage collected, so + # 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 + + def contents() -> str: + return files("certifi").joinpath("cacert.pem").read_text(encoding="ascii") + +elif sys.version_info >= (3, 7): + + from importlib.resources import path as get_path, read_text + + _CACERT_CTX = None + _CACERT_PATH = None + + def where() -> str: + # This is slightly terrible, but we want to delay extracting the + # file in cases where we're inside of a zipimport situation until + # someone actually calls where(), but we don't want to re-extract + # the file on every call of where(), so we'll do it once then store + # it in a global variable. + global _CACERT_CTX + global _CACERT_PATH + if _CACERT_PATH is None: + # This is slightly janky, the importlib.resources API wants you + # to manage the cleanup of this file, so it doesn't actually + # return a path, it returns a context manager that will give + # you the path when you enter it and will do any cleanup when + # you leave it. In the common case of not needing a temporary + # file, it will just return the file system location and the + # __exit__() is a no-op. + # + # We also have to hold onto the actual context manager, because + # it will do the cleanup whenever it gets garbage collected, so + # 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 + + def contents() -> str: + return read_text("certifi", "cacert.pem", encoding="ascii") + +else: + import os + import types + from typing import Union + + Package = Union[types.ModuleType, str] + Resource = Union[str, "os.PathLike"] + + # This fallback will work for Python versions prior to 3.7 that lack the + # importlib.resources module but relies on the existing `where` function + # so won't address issues with environments like PyOxidizer that don't set + # __file__ on modules. + def read_text( + package: Package, + resource: Resource, + encoding: str = 'utf-8', + errors: str = 'strict' + ) -> str: + with open(where(), encoding=encoding) as data: + return data.read() + + # If we don't have importlib.resources, then we will just do the old logic + # of assuming we're on the filesystem and munge the path directly. + def where() -> str: + f = os.path.dirname(__file__) + + return os.path.join(f, "cacert.pem") + + def contents() -> str: + return read_text("certifi", "cacert.pem", encoding="ascii") diff --git a/.venv/lib/python3.12/site-packages/certifi/py.typed b/.venv/lib/python3.12/site-packages/certifi/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/.venv/lib/python3.12/site-packages/charset_normalizer-3.3.2.dist-info/INSTALLER b/.venv/lib/python3.12/site-packages/charset_normalizer-3.3.2.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/.venv/lib/python3.12/site-packages/charset_normalizer-3.3.2.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/.venv/lib/python3.12/site-packages/charset_normalizer-3.3.2.dist-info/LICENSE b/.venv/lib/python3.12/site-packages/charset_normalizer-3.3.2.dist-info/LICENSE new file mode 100644 index 0000000..ad82355 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/charset_normalizer-3.3.2.dist-info/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2019 TAHRI Ahmed R. + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. \ No newline at end of file diff --git a/.venv/lib/python3.12/site-packages/charset_normalizer-3.3.2.dist-info/METADATA b/.venv/lib/python3.12/site-packages/charset_normalizer-3.3.2.dist-info/METADATA new file mode 100644 index 0000000..822550e --- /dev/null +++ b/.venv/lib/python3.12/site-packages/charset_normalizer-3.3.2.dist-info/METADATA @@ -0,0 +1,683 @@ +Metadata-Version: 2.1 +Name: charset-normalizer +Version: 3.3.2 +Summary: The Real First Universal Charset Detector. Open, modern and actively maintained alternative to Chardet. +Home-page: https://github.com/Ousret/charset_normalizer +Author: Ahmed TAHRI +Author-email: ahmed.tahri@cloudnursery.dev +License: MIT +Project-URL: Bug Reports, https://github.com/Ousret/charset_normalizer/issues +Project-URL: Documentation, https://charset-normalizer.readthedocs.io/en/latest +Keywords: encoding,charset,charset-detector,detector,normalization,unicode,chardet,detect +Classifier: Development Status :: 5 - Production/Stable +Classifier: License :: OSI Approved :: MIT License +Classifier: Intended Audience :: Developers +Classifier: Topic :: Software Development :: Libraries :: Python Modules +Classifier: Operating System :: OS Independent +Classifier: Programming Language :: Python +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3.7 +Classifier: Programming Language :: Python :: 3.8 +Classifier: Programming Language :: Python :: 3.9 +Classifier: Programming Language :: Python :: 3.10 +Classifier: Programming Language :: Python :: 3.11 +Classifier: Programming Language :: Python :: 3.12 +Classifier: Programming Language :: Python :: Implementation :: PyPy +Classifier: Topic :: Text Processing :: Linguistic +Classifier: Topic :: Utilities +Classifier: Typing :: Typed +Requires-Python: >=3.7.0 +Description-Content-Type: text/markdown +License-File: LICENSE +Provides-Extra: unicode_backport + +

Charset Detection, for Everyone 👋

+ +

+ The Real First Universal Charset Detector
+ + + + + Download Count Total + + + + +

+

+ Featured Packages
+ + Static Badge + + + Static Badge + +

+

+ In other language (unofficial port - by the community)
+ + Static Badge + +

+ +> A library that helps you read text from an unknown charset encoding.
Motivated by `chardet`, +> I'm trying to resolve the issue by taking a new approach. +> All IANA character set names for which the Python core library provides codecs are supported. + +

+ >>>>> 👉 Try Me Online Now, Then Adopt Me 👈 <<<<< +

+ +This project offers you an alternative to **Universal Charset Encoding Detector**, also known as **Chardet**. + +| Feature | [Chardet](https://github.com/chardet/chardet) | Charset Normalizer | [cChardet](https://github.com/PyYoshi/cChardet) | +|--------------------------------------------------|:---------------------------------------------:|:--------------------------------------------------------------------------------------------------:|:-----------------------------------------------:| +| `Fast` | ❌ | ✅ | ✅ | +| `Universal**` | ❌ | ✅ | ❌ | +| `Reliable` **without** distinguishable standards | ❌ | ✅ | ✅ | +| `Reliable` **with** distinguishable standards | ✅ | ✅ | ✅ | +| `License` | LGPL-2.1
_restrictive_ | MIT | MPL-1.1
_restrictive_ | +| `Native Python` | ✅ | ✅ | ❌ | +| `Detect spoken language` | ❌ | ✅ | N/A | +| `UnicodeDecodeError Safety` | ❌ | ✅ | ❌ | +| `Whl Size (min)` | 193.6 kB | 42 kB | ~200 kB | +| `Supported Encoding` | 33 | 🎉 [99](https://charset-normalizer.readthedocs.io/en/latest/user/support.html#supported-encodings) | 40 | + +

+Reading Normalized TextCat Reading Text +

+ +*\*\* : They are clearly using specific code for a specific encoding even if covering most of used one*
+Did you got there because of the logs? See [https://charset-normalizer.readthedocs.io/en/latest/user/miscellaneous.html](https://charset-normalizer.readthedocs.io/en/latest/user/miscellaneous.html) + +## ⚡ Performance + +This package offer better performance than its counterpart Chardet. Here are some numbers. + +| Package | Accuracy | Mean per file (ms) | File per sec (est) | +|-----------------------------------------------|:--------:|:------------------:|:------------------:| +| [chardet](https://github.com/chardet/chardet) | 86 % | 200 ms | 5 file/sec | +| charset-normalizer | **98 %** | **10 ms** | 100 file/sec | + +| Package | 99th percentile | 95th percentile | 50th percentile | +|-----------------------------------------------|:---------------:|:---------------:|:---------------:| +| [chardet](https://github.com/chardet/chardet) | 1200 ms | 287 ms | 23 ms | +| charset-normalizer | 100 ms | 50 ms | 5 ms | + +Chardet's performance on larger file (1MB+) are very poor. Expect huge difference on large payload. + +> Stats are generated using 400+ files using default parameters. More details on used files, see GHA workflows. +> And yes, these results might change at any time. The dataset can be updated to include more files. +> The actual delays heavily depends on your CPU capabilities. The factors should remain the same. +> Keep in mind that the stats are generous and that Chardet accuracy vs our is measured using Chardet initial capability +> (eg. Supported Encoding) Challenge-them if you want. + +## ✨ Installation + +Using pip: + +```sh +pip install charset-normalizer -U +``` + +## 🚀 Basic Usage + +### CLI +This package comes with a CLI. + +``` +usage: normalizer [-h] [-v] [-a] [-n] [-m] [-r] [-f] [-t THRESHOLD] + file [file ...] + +The Real First Universal Charset Detector. Discover originating encoding used +on text file. Normalize text to unicode. + +positional arguments: + files File(s) to be analysed + +optional arguments: + -h, --help show this help message and exit + -v, --verbose Display complementary information about file if any. + Stdout will contain logs about the detection process. + -a, --with-alternative + Output complementary possibilities if any. Top-level + JSON WILL be a list. + -n, --normalize Permit to normalize input file. If not set, program + does not write anything. + -m, --minimal Only output the charset detected to STDOUT. Disabling + JSON output. + -r, --replace Replace file when trying to normalize it instead of + creating a new one. + -f, --force Replace file without asking if you are sure, use this + flag with caution. + -t THRESHOLD, --threshold THRESHOLD + Define a custom maximum amount of chaos allowed in + decoded content. 0. <= chaos <= 1. + --version Show version information and exit. +``` + +```bash +normalizer ./data/sample.1.fr.srt +``` + +or + +```bash +python -m charset_normalizer ./data/sample.1.fr.srt +``` + +🎉 Since version 1.4.0 the CLI produce easily usable stdout result in JSON format. + +```json +{ + "path": "/home/default/projects/charset_normalizer/data/sample.1.fr.srt", + "encoding": "cp1252", + "encoding_aliases": [ + "1252", + "windows_1252" + ], + "alternative_encodings": [ + "cp1254", + "cp1256", + "cp1258", + "iso8859_14", + "iso8859_15", + "iso8859_16", + "iso8859_3", + "iso8859_9", + "latin_1", + "mbcs" + ], + "language": "French", + "alphabets": [ + "Basic Latin", + "Latin-1 Supplement" + ], + "has_sig_or_bom": false, + "chaos": 0.149, + "coherence": 97.152, + "unicode_path": null, + "is_preferred": true +} +``` + +### Python +*Just print out normalized text* +```python +from charset_normalizer import from_path + +results = from_path('./my_subtitle.srt') + +print(str(results.best())) +``` + +*Upgrade your code without effort* +```python +from charset_normalizer import detect +``` + +The above code will behave the same as **chardet**. We ensure that we offer the best (reasonable) BC result possible. + +See the docs for advanced usage : [readthedocs.io](https://charset-normalizer.readthedocs.io/en/latest/) + +## 😇 Why + +When I started using Chardet, I noticed that it was not suited to my expectations, and I wanted to propose a +reliable alternative using a completely different method. Also! I never back down on a good challenge! + +I **don't care** about the **originating charset** encoding, because **two different tables** can +produce **two identical rendered string.** +What I want is to get readable text, the best I can. + +In a way, **I'm brute forcing text decoding.** How cool is that ? 😎 + +Don't confuse package **ftfy** with charset-normalizer or chardet. ftfy goal is to repair unicode string whereas charset-normalizer to convert raw file in unknown encoding to unicode. + +## 🍰 How + + - Discard all charset encoding table that could not fit the binary content. + - Measure noise, or the mess once opened (by chunks) with a corresponding charset encoding. + - Extract matches with the lowest mess detected. + - Additionally, we measure coherence / probe for a language. + +**Wait a minute**, what is noise/mess and coherence according to **YOU ?** + +*Noise :* I opened hundred of text files, **written by humans**, with the wrong encoding table. **I observed**, then +**I established** some ground rules about **what is obvious** when **it seems like** a mess. + I know that my interpretation of what is noise is probably incomplete, feel free to contribute in order to + improve or rewrite it. + +*Coherence :* For each language there is on earth, we have computed ranked letter appearance occurrences (the best we can). So I thought +that intel is worth something here. So I use those records against decoded text to check if I can detect intelligent design. + +## ⚡ Known limitations + + - Language detection is unreliable when text contains two or more languages sharing identical letters. (eg. HTML (english tags) + Turkish content (Sharing Latin characters)) + - Every charset detector heavily depends on sufficient content. In common cases, do not bother run detection on very tiny content. + +## ⚠️ About Python EOLs + +**If you are running:** + +- Python >=2.7,<3.5: Unsupported +- Python 3.5: charset-normalizer < 2.1 +- Python 3.6: charset-normalizer < 3.1 +- Python 3.7: charset-normalizer < 4.0 + +Upgrade your Python interpreter as soon as possible. + +## 👤 Contributing + +Contributions, issues and feature requests are very much welcome.
+Feel free to check [issues page](https://github.com/ousret/charset_normalizer/issues) if you want to contribute. + +## 📝 License + +Copyright © [Ahmed TAHRI @Ousret](https://github.com/Ousret).
+This project is [MIT](https://github.com/Ousret/charset_normalizer/blob/master/LICENSE) licensed. + +Characters frequencies used in this project © 2012 [Denny Vrandečić](http://simia.net/letters/) + +## 💼 For Enterprise + +Professional support for charset-normalizer is available as part of the [Tidelift +Subscription][1]. Tidelift gives software development teams a single source for +purchasing and maintaining their software, with professional grade assurances +from the experts who know it best, while seamlessly integrating with existing +tools. + +[1]: https://tidelift.com/subscription/pkg/pypi-charset-normalizer?utm_source=pypi-charset-normalizer&utm_medium=readme + +# Changelog +All notable changes to charset-normalizer will be documented in this file. This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). +The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). + +## [3.3.2](https://github.com/Ousret/charset_normalizer/compare/3.3.1...3.3.2) (2023-10-31) + +### Fixed +- Unintentional memory usage regression when using large payload that match several encoding (#376) +- Regression on some detection case showcased in the documentation (#371) + +### Added +- Noise (md) probe that identify malformed arabic representation due to the presence of letters in isolated form (credit to my wife) + +## [3.3.1](https://github.com/Ousret/charset_normalizer/compare/3.3.0...3.3.1) (2023-10-22) + +### Changed +- Optional mypyc compilation upgraded to version 1.6.1 for Python >= 3.8 +- Improved the general detection reliability based on reports from the community + +## [3.3.0](https://github.com/Ousret/charset_normalizer/compare/3.2.0...3.3.0) (2023-09-30) + +### Added +- Allow to execute the CLI (e.g. normalizer) through `python -m charset_normalizer.cli` or `python -m charset_normalizer` +- Support for 9 forgotten encoding that are supported by Python but unlisted in `encoding.aliases` as they have no alias (#323) + +### Removed +- (internal) Redundant utils.is_ascii function and unused function is_private_use_only +- (internal) charset_normalizer.assets is moved inside charset_normalizer.constant + +### Changed +- (internal) Unicode code blocks in constants are updated using the latest v15.0.0 definition to improve detection +- Optional mypyc compilation upgraded to version 1.5.1 for Python >= 3.8 + +### Fixed +- Unable to properly sort CharsetMatch when both chaos/noise and coherence were close due to an unreachable condition in \_\_lt\_\_ (#350) + +## [3.2.0](https://github.com/Ousret/charset_normalizer/compare/3.1.0...3.2.0) (2023-06-07) + +### Changed +- Typehint for function `from_path` no longer enforce `PathLike` as its first argument +- Minor improvement over the global detection reliability + +### Added +- Introduce function `is_binary` that relies on main capabilities, and optimized to detect binaries +- Propagate `enable_fallback` argument throughout `from_bytes`, `from_path`, and `from_fp` that allow a deeper control over the detection (default True) +- Explicit support for Python 3.12 + +### Fixed +- Edge case detection failure where a file would contain 'very-long' camel cased word (Issue #289) + +## [3.1.0](https://github.com/Ousret/charset_normalizer/compare/3.0.1...3.1.0) (2023-03-06) + +### Added +- Argument `should_rename_legacy` for legacy function `detect` and disregard any new arguments without errors (PR #262) + +### Removed +- Support for Python 3.6 (PR #260) + +### Changed +- Optional speedup provided by mypy/c 1.0.1 + +## [3.0.1](https://github.com/Ousret/charset_normalizer/compare/3.0.0...3.0.1) (2022-11-18) + +### Fixed +- Multi-bytes cutter/chunk generator did not always cut correctly (PR #233) + +### Changed +- Speedup provided by mypy/c 0.990 on Python >= 3.7 + +## [3.0.0](https://github.com/Ousret/charset_normalizer/compare/2.1.1...3.0.0) (2022-10-20) + +### Added +- Extend the capability of explain=True when cp_isolation contains at most two entries (min one), will log in details of the Mess-detector results +- Support for alternative language frequency set in charset_normalizer.assets.FREQUENCIES +- Add parameter `language_threshold` in `from_bytes`, `from_path` and `from_fp` to adjust the minimum expected coherence ratio +- `normalizer --version` now specify if current version provide extra speedup (meaning mypyc compilation whl) + +### Changed +- Build with static metadata using 'build' frontend +- Make the language detection stricter +- Optional: Module `md.py` can be compiled using Mypyc to provide an extra speedup up to 4x faster than v2.1 + +### Fixed +- CLI with opt --normalize fail when using full path for files +- TooManyAccentuatedPlugin induce false positive on the mess detection when too few alpha character have been fed to it +- Sphinx warnings when generating the documentation + +### Removed +- Coherence detector no longer return 'Simple English' instead return 'English' +- Coherence detector no longer return 'Classical Chinese' instead return 'Chinese' +- Breaking: Method `first()` and `best()` from CharsetMatch +- UTF-7 will no longer appear as "detected" without a recognized SIG/mark (is unreliable/conflict with ASCII) +- Breaking: Class aliases CharsetDetector, CharsetDoctor, CharsetNormalizerMatch and CharsetNormalizerMatches +- Breaking: Top-level function `normalize` +- Breaking: Properties `chaos_secondary_pass`, `coherence_non_latin` and `w_counter` from CharsetMatch +- Support for the backport `unicodedata2` + +## [3.0.0rc1](https://github.com/Ousret/charset_normalizer/compare/3.0.0b2...3.0.0rc1) (2022-10-18) + +### Added +- Extend the capability of explain=True when cp_isolation contains at most two entries (min one), will log in details of the Mess-detector results +- Support for alternative language frequency set in charset_normalizer.assets.FREQUENCIES +- Add parameter `language_threshold` in `from_bytes`, `from_path` and `from_fp` to adjust the minimum expected coherence ratio + +### Changed +- Build with static metadata using 'build' frontend +- Make the language detection stricter + +### Fixed +- CLI with opt --normalize fail when using full path for files +- TooManyAccentuatedPlugin induce false positive on the mess detection when too few alpha character have been fed to it + +### Removed +- Coherence detector no longer return 'Simple English' instead return 'English' +- Coherence detector no longer return 'Classical Chinese' instead return 'Chinese' + +## [3.0.0b2](https://github.com/Ousret/charset_normalizer/compare/3.0.0b1...3.0.0b2) (2022-08-21) + +### Added +- `normalizer --version` now specify if current version provide extra speedup (meaning mypyc compilation whl) + +### Removed +- Breaking: Method `first()` and `best()` from CharsetMatch +- UTF-7 will no longer appear as "detected" without a recognized SIG/mark (is unreliable/conflict with ASCII) + +### Fixed +- Sphinx warnings when generating the documentation + +## [3.0.0b1](https://github.com/Ousret/charset_normalizer/compare/2.1.0...3.0.0b1) (2022-08-15) + +### Changed +- Optional: Module `md.py` can be compiled using Mypyc to provide an extra speedup up to 4x faster than v2.1 + +### Removed +- Breaking: Class aliases CharsetDetector, CharsetDoctor, CharsetNormalizerMatch and CharsetNormalizerMatches +- Breaking: Top-level function `normalize` +- Breaking: Properties `chaos_secondary_pass`, `coherence_non_latin` and `w_counter` from CharsetMatch +- Support for the backport `unicodedata2` + +## [2.1.1](https://github.com/Ousret/charset_normalizer/compare/2.1.0...2.1.1) (2022-08-19) + +### Deprecated +- Function `normalize` scheduled for removal in 3.0 + +### Changed +- Removed useless call to decode in fn is_unprintable (#206) + +### Fixed +- Third-party library (i18n xgettext) crashing not recognizing utf_8 (PEP 263) with underscore from [@aleksandernovikov](https://github.com/aleksandernovikov) (#204) + +## [2.1.0](https://github.com/Ousret/charset_normalizer/compare/2.0.12...2.1.0) (2022-06-19) + +### Added +- Output the Unicode table version when running the CLI with `--version` (PR #194) + +### Changed +- Re-use decoded buffer for single byte character sets from [@nijel](https://github.com/nijel) (PR #175) +- Fixing some performance bottlenecks from [@deedy5](https://github.com/deedy5) (PR #183) + +### Fixed +- Workaround potential bug in cpython with Zero Width No-Break Space located in Arabic Presentation Forms-B, Unicode 1.1 not acknowledged as space (PR #175) +- CLI default threshold aligned with the API threshold from [@oleksandr-kuzmenko](https://github.com/oleksandr-kuzmenko) (PR #181) + +### Removed +- Support for Python 3.5 (PR #192) + +### Deprecated +- Use of backport unicodedata from `unicodedata2` as Python is quickly catching up, scheduled for removal in 3.0 (PR #194) + +## [2.0.12](https://github.com/Ousret/charset_normalizer/compare/2.0.11...2.0.12) (2022-02-12) + +### Fixed +- ASCII miss-detection on rare cases (PR #170) + +## [2.0.11](https://github.com/Ousret/charset_normalizer/compare/2.0.10...2.0.11) (2022-01-30) + +### Added +- Explicit support for Python 3.11 (PR #164) + +### Changed +- The logging behavior have been completely reviewed, now using only TRACE and DEBUG levels (PR #163 #165) + +## [2.0.10](https://github.com/Ousret/charset_normalizer/compare/2.0.9...2.0.10) (2022-01-04) + +### Fixed +- Fallback match entries might lead to UnicodeDecodeError for large bytes sequence (PR #154) + +### Changed +- Skipping the language-detection (CD) on ASCII (PR #155) + +## [2.0.9](https://github.com/Ousret/charset_normalizer/compare/2.0.8...2.0.9) (2021-12-03) + +### Changed +- Moderating the logging impact (since 2.0.8) for specific environments (PR #147) + +### Fixed +- Wrong logging level applied when setting kwarg `explain` to True (PR #146) + +## [2.0.8](https://github.com/Ousret/charset_normalizer/compare/2.0.7...2.0.8) (2021-11-24) +### Changed +- Improvement over Vietnamese detection (PR #126) +- MD improvement on trailing data and long foreign (non-pure latin) data (PR #124) +- Efficiency improvements in cd/alphabet_languages from [@adbar](https://github.com/adbar) (PR #122) +- call sum() without an intermediary list following PEP 289 recommendations from [@adbar](https://github.com/adbar) (PR #129) +- Code style as refactored by Sourcery-AI (PR #131) +- Minor adjustment on the MD around european words (PR #133) +- Remove and replace SRTs from assets / tests (PR #139) +- Initialize the library logger with a `NullHandler` by default from [@nmaynes](https://github.com/nmaynes) (PR #135) +- Setting kwarg `explain` to True will add provisionally (bounded to function lifespan) a specific stream handler (PR #135) + +### Fixed +- Fix large (misleading) sequence giving UnicodeDecodeError (PR #137) +- Avoid using too insignificant chunk (PR #137) + +### Added +- Add and expose function `set_logging_handler` to configure a specific StreamHandler from [@nmaynes](https://github.com/nmaynes) (PR #135) +- Add `CHANGELOG.md` entries, format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) (PR #141) + +## [2.0.7](https://github.com/Ousret/charset_normalizer/compare/2.0.6...2.0.7) (2021-10-11) +### Added +- Add support for Kazakh (Cyrillic) language detection (PR #109) + +### Changed +- Further, improve inferring the language from a given single-byte code page (PR #112) +- Vainly trying to leverage PEP263 when PEP3120 is not supported (PR #116) +- Refactoring for potential performance improvements in loops from [@adbar](https://github.com/adbar) (PR #113) +- Various detection improvement (MD+CD) (PR #117) + +### Removed +- Remove redundant logging entry about detected language(s) (PR #115) + +### Fixed +- Fix a minor inconsistency between Python 3.5 and other versions regarding language detection (PR #117 #102) + +## [2.0.6](https://github.com/Ousret/charset_normalizer/compare/2.0.5...2.0.6) (2021-09-18) +### Fixed +- Unforeseen regression with the loss of the backward-compatibility with some older minor of Python 3.5.x (PR #100) +- Fix CLI crash when using --minimal output in certain cases (PR #103) + +### Changed +- Minor improvement to the detection efficiency (less than 1%) (PR #106 #101) + +## [2.0.5](https://github.com/Ousret/charset_normalizer/compare/2.0.4...2.0.5) (2021-09-14) +### Changed +- The project now comply with: flake8, mypy, isort and black to ensure a better overall quality (PR #81) +- The BC-support with v1.x was improved, the old staticmethods are restored (PR #82) +- The Unicode detection is slightly improved (PR #93) +- Add syntax sugar \_\_bool\_\_ for results CharsetMatches list-container (PR #91) + +### Removed +- The project no longer raise warning on tiny content given for detection, will be simply logged as warning instead (PR #92) + +### Fixed +- In some rare case, the chunks extractor could cut in the middle of a multi-byte character and could mislead the mess detection (PR #95) +- Some rare 'space' characters could trip up the UnprintablePlugin/Mess detection (PR #96) +- The MANIFEST.in was not exhaustive (PR #78) + +## [2.0.4](https://github.com/Ousret/charset_normalizer/compare/2.0.3...2.0.4) (2021-07-30) +### Fixed +- The CLI no longer raise an unexpected exception when no encoding has been found (PR #70) +- Fix accessing the 'alphabets' property when the payload contains surrogate characters (PR #68) +- The logger could mislead (explain=True) on detected languages and the impact of one MBCS match (PR #72) +- Submatch factoring could be wrong in rare edge cases (PR #72) +- Multiple files given to the CLI were ignored when publishing results to STDOUT. (After the first path) (PR #72) +- Fix line endings from CRLF to LF for certain project files (PR #67) + +### Changed +- Adjust the MD to lower the sensitivity, thus improving the global detection reliability (PR #69 #76) +- Allow fallback on specified encoding if any (PR #71) + +## [2.0.3](https://github.com/Ousret/charset_normalizer/compare/2.0.2...2.0.3) (2021-07-16) +### Changed +- Part of the detection mechanism has been improved to be less sensitive, resulting in more accurate detection results. Especially ASCII. (PR #63) +- According to the community wishes, the detection will fall back on ASCII or UTF-8 in a last-resort case. (PR #64) + +## [2.0.2](https://github.com/Ousret/charset_normalizer/compare/2.0.1...2.0.2) (2021-07-15) +### Fixed +- Empty/Too small JSON payload miss-detection fixed. Report from [@tseaver](https://github.com/tseaver) (PR #59) + +### Changed +- Don't inject unicodedata2 into sys.modules from [@akx](https://github.com/akx) (PR #57) + +## [2.0.1](https://github.com/Ousret/charset_normalizer/compare/2.0.0...2.0.1) (2021-07-13) +### Fixed +- Make it work where there isn't a filesystem available, dropping assets frequencies.json. Report from [@sethmlarson](https://github.com/sethmlarson). (PR #55) +- Using explain=False permanently disable the verbose output in the current runtime (PR #47) +- One log entry (language target preemptive) was not show in logs when using explain=True (PR #47) +- Fix undesired exception (ValueError) on getitem of instance CharsetMatches (PR #52) + +### Changed +- Public function normalize default args values were not aligned with from_bytes (PR #53) + +### Added +- You may now use charset aliases in cp_isolation and cp_exclusion arguments (PR #47) + +## [2.0.0](https://github.com/Ousret/charset_normalizer/compare/1.4.1...2.0.0) (2021-07-02) +### Changed +- 4x to 5 times faster than the previous 1.4.0 release. At least 2x faster than Chardet. +- Accent has been made on UTF-8 detection, should perform rather instantaneous. +- The backward compatibility with Chardet has been greatly improved. The legacy detect function returns an identical charset name whenever possible. +- The detection mechanism has been slightly improved, now Turkish content is detected correctly (most of the time) +- The program has been rewritten to ease the readability and maintainability. (+Using static typing)+ +- utf_7 detection has been reinstated. + +### Removed +- This package no longer require anything when used with Python 3.5 (Dropped cached_property) +- Removed support for these languages: Catalan, Esperanto, Kazakh, Baque, Volapük, Azeri, Galician, Nynorsk, Macedonian, and Serbocroatian. +- The exception hook on UnicodeDecodeError has been removed. + +### Deprecated +- Methods coherence_non_latin, w_counter, chaos_secondary_pass of the class CharsetMatch are now deprecated and scheduled for removal in v3.0 + +### Fixed +- The CLI output used the relative path of the file(s). Should be absolute. + +## [1.4.1](https://github.com/Ousret/charset_normalizer/compare/1.4.0...1.4.1) (2021-05-28) +### Fixed +- Logger configuration/usage no longer conflict with others (PR #44) + +## [1.4.0](https://github.com/Ousret/charset_normalizer/compare/1.3.9...1.4.0) (2021-05-21) +### Removed +- Using standard logging instead of using the package loguru. +- Dropping nose test framework in favor of the maintained pytest. +- Choose to not use dragonmapper package to help with gibberish Chinese/CJK text. +- Require cached_property only for Python 3.5 due to constraint. Dropping for every other interpreter version. +- Stop support for UTF-7 that does not contain a SIG. +- Dropping PrettyTable, replaced with pure JSON output in CLI. + +### Fixed +- BOM marker in a CharsetNormalizerMatch instance could be False in rare cases even if obviously present. Due to the sub-match factoring process. +- Not searching properly for the BOM when trying utf32/16 parent codec. + +### Changed +- Improving the package final size by compressing frequencies.json. +- Huge improvement over the larges payload. + +### Added +- CLI now produces JSON consumable output. +- Return ASCII if given sequences fit. Given reasonable confidence. + +## [1.3.9](https://github.com/Ousret/charset_normalizer/compare/1.3.8...1.3.9) (2021-05-13) + +### Fixed +- In some very rare cases, you may end up getting encode/decode errors due to a bad bytes payload (PR #40) + +## [1.3.8](https://github.com/Ousret/charset_normalizer/compare/1.3.7...1.3.8) (2021-05-12) + +### Fixed +- Empty given payload for detection may cause an exception if trying to access the `alphabets` property. (PR #39) + +## [1.3.7](https://github.com/Ousret/charset_normalizer/compare/1.3.6...1.3.7) (2021-05-12) + +### Fixed +- The legacy detect function should return UTF-8-SIG if sig is present in the payload. (PR #38) + +## [1.3.6](https://github.com/Ousret/charset_normalizer/compare/1.3.5...1.3.6) (2021-02-09) + +### Changed +- Amend the previous release to allow prettytable 2.0 (PR #35) + +## [1.3.5](https://github.com/Ousret/charset_normalizer/compare/1.3.4...1.3.5) (2021-02-08) + +### Fixed +- Fix error while using the package with a python pre-release interpreter (PR #33) + +### Changed +- Dependencies refactoring, constraints revised. + +### Added +- Add python 3.9 and 3.10 to the supported interpreters + +MIT License + +Copyright (c) 2019 TAHRI Ahmed R. + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/.venv/lib/python3.12/site-packages/charset_normalizer-3.3.2.dist-info/RECORD b/.venv/lib/python3.12/site-packages/charset_normalizer-3.3.2.dist-info/RECORD new file mode 100644 index 0000000..134cd2f --- /dev/null +++ b/.venv/lib/python3.12/site-packages/charset_normalizer-3.3.2.dist-info/RECORD @@ -0,0 +1,35 @@ +../../../bin/normalizer,sha256=TGGzGCiTm-yLw6gQOEfPQonWoeOkPWp5W4b1RAbka20,260 +charset_normalizer-3.3.2.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +charset_normalizer-3.3.2.dist-info/LICENSE,sha256=6zGgxaT7Cbik4yBV0lweX5w1iidS_vPNcgIT0cz-4kE,1070 +charset_normalizer-3.3.2.dist-info/METADATA,sha256=cfLhl5A6SI-F0oclm8w8ux9wshL1nipdeCdVnYb4AaA,33550 +charset_normalizer-3.3.2.dist-info/RECORD,, +charset_normalizer-3.3.2.dist-info/WHEEL,sha256=4ZiCdXIWMxJyEClivrQv1QAHZpQh8kVYU92_ZAVwaok,152 +charset_normalizer-3.3.2.dist-info/entry_points.txt,sha256=ADSTKrkXZ3hhdOVFi6DcUEHQRS0xfxDIE_pEz4wLIXA,65 +charset_normalizer-3.3.2.dist-info/top_level.txt,sha256=7ASyzePr8_xuZWJsnqJjIBtyV8vhEo0wBCv1MPRRi3Q,19 +charset_normalizer/__init__.py,sha256=UzI3xC8PhmcLRMzSgPb6minTmRq0kWznnCBJ8ZCc2XI,1577 +charset_normalizer/__main__.py,sha256=JxY8bleaENOFlLRb9HfoeZCzAMnn2A1oGR5Xm2eyqg0,73 +charset_normalizer/__pycache__/__init__.cpython-312.pyc,, +charset_normalizer/__pycache__/__main__.cpython-312.pyc,, +charset_normalizer/__pycache__/api.cpython-312.pyc,, +charset_normalizer/__pycache__/cd.cpython-312.pyc,, +charset_normalizer/__pycache__/constant.cpython-312.pyc,, +charset_normalizer/__pycache__/legacy.cpython-312.pyc,, +charset_normalizer/__pycache__/md.cpython-312.pyc,, +charset_normalizer/__pycache__/models.cpython-312.pyc,, +charset_normalizer/__pycache__/utils.cpython-312.pyc,, +charset_normalizer/__pycache__/version.cpython-312.pyc,, +charset_normalizer/api.py,sha256=WOlWjy6wT8SeMYFpaGbXZFN1TMXa-s8vZYfkL4G29iQ,21097 +charset_normalizer/cd.py,sha256=xwZliZcTQFA3jU0c00PRiu9MNxXTFxQkFLWmMW24ZzI,12560 +charset_normalizer/cli/__init__.py,sha256=D5ERp8P62llm2FuoMzydZ7d9rs8cvvLXqE-1_6oViPc,100 +charset_normalizer/cli/__main__.py,sha256=2F-xURZJzo063Ye-2RLJ2wcmURpbKeAzKwpiws65dAs,9744 +charset_normalizer/cli/__pycache__/__init__.cpython-312.pyc,, +charset_normalizer/cli/__pycache__/__main__.cpython-312.pyc,, +charset_normalizer/constant.py,sha256=p0IsOVcEbPWYPOdWhnhRbjK1YVBy6fs05C5vKC-zoxU,40481 +charset_normalizer/legacy.py,sha256=T-QuVMsMeDiQEk8WSszMrzVJg_14AMeSkmHdRYhdl1k,2071 +charset_normalizer/md.cpython-312-x86_64-linux-gnu.so,sha256=W654QTU3QZI6eWJ0fanScAr0_O6sL0I61fyRSdC-39Y,16064 +charset_normalizer/md.py,sha256=NkSuVLK13_a8c7BxZ4cGIQ5vOtGIWOdh22WZEvjp-7U,19624 +charset_normalizer/md__mypyc.cpython-312-x86_64-linux-gnu.so,sha256=IlObIV4dmRhFV8V7H-zK4rTxPzTSi9JmrWZD26JQfxI,272640 +charset_normalizer/models.py,sha256=I5i0s4aKCCgLPY2tUY3pwkgFA-BUbbNxQ7hVkVTt62s,11624 +charset_normalizer/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +charset_normalizer/utils.py,sha256=teiosMqzKjXyAHXnGdjSBOgnBZwx-SkBbCLrx0UXy8M,11894 +charset_normalizer/version.py,sha256=iHKUfHD3kDRSyrh_BN2ojh43TA5-UZQjvbVIEFfpHDs,79 diff --git a/.venv/lib/python3.12/site-packages/charset_normalizer-3.3.2.dist-info/WHEEL b/.venv/lib/python3.12/site-packages/charset_normalizer-3.3.2.dist-info/WHEEL new file mode 100644 index 0000000..d1b3f1d --- /dev/null +++ b/.venv/lib/python3.12/site-packages/charset_normalizer-3.3.2.dist-info/WHEEL @@ -0,0 +1,6 @@ +Wheel-Version: 1.0 +Generator: bdist_wheel (0.41.2) +Root-Is-Purelib: false +Tag: cp312-cp312-manylinux_2_17_x86_64 +Tag: cp312-cp312-manylinux2014_x86_64 + diff --git a/.venv/lib/python3.12/site-packages/charset_normalizer-3.3.2.dist-info/entry_points.txt b/.venv/lib/python3.12/site-packages/charset_normalizer-3.3.2.dist-info/entry_points.txt new file mode 100644 index 0000000..65619e7 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/charset_normalizer-3.3.2.dist-info/entry_points.txt @@ -0,0 +1,2 @@ +[console_scripts] +normalizer = charset_normalizer.cli:cli_detect diff --git a/.venv/lib/python3.12/site-packages/charset_normalizer-3.3.2.dist-info/top_level.txt b/.venv/lib/python3.12/site-packages/charset_normalizer-3.3.2.dist-info/top_level.txt new file mode 100644 index 0000000..66958f0 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/charset_normalizer-3.3.2.dist-info/top_level.txt @@ -0,0 +1 @@ +charset_normalizer diff --git a/.venv/lib/python3.12/site-packages/charset_normalizer/__init__.py b/.venv/lib/python3.12/site-packages/charset_normalizer/__init__.py new file mode 100644 index 0000000..55991fc --- /dev/null +++ b/.venv/lib/python3.12/site-packages/charset_normalizer/__init__.py @@ -0,0 +1,46 @@ +# -*- coding: utf-8 -*- +""" +Charset-Normalizer +~~~~~~~~~~~~~~ +The Real First Universal Charset Detector. +A library that helps you read text from an unknown charset encoding. +Motivated by chardet, This package is trying to resolve the issue by taking a new approach. +All IANA character set names for which the Python core library provides codecs are supported. + +Basic usage: + >>> from charset_normalizer import from_bytes + >>> results = from_bytes('Bсеки човек има право на образование. Oбразованието!'.encode('utf_8')) + >>> best_guess = results.best() + >>> str(best_guess) + 'Bсеки човек има право на образование. Oбразованието!' + +Others methods and usages are available - see the full documentation +at . +:copyright: (c) 2021 by Ahmed TAHRI +:license: MIT, see LICENSE for more details. +""" +import logging + +from .api import from_bytes, from_fp, from_path, is_binary +from .legacy import detect +from .models import CharsetMatch, CharsetMatches +from .utils import set_logging_handler +from .version import VERSION, __version__ + +__all__ = ( + "from_fp", + "from_path", + "from_bytes", + "is_binary", + "detect", + "CharsetMatch", + "CharsetMatches", + "__version__", + "VERSION", + "set_logging_handler", +) + +# Attach a NullHandler to the top level logger by default +# https://docs.python.org/3.3/howto/logging.html#configuring-logging-for-a-library + +logging.getLogger("charset_normalizer").addHandler(logging.NullHandler()) diff --git a/.venv/lib/python3.12/site-packages/charset_normalizer/__main__.py b/.venv/lib/python3.12/site-packages/charset_normalizer/__main__.py new file mode 100644 index 0000000..beae2ef --- /dev/null +++ b/.venv/lib/python3.12/site-packages/charset_normalizer/__main__.py @@ -0,0 +1,4 @@ +from .cli import cli_detect + +if __name__ == "__main__": + cli_detect() diff --git a/.venv/lib/python3.12/site-packages/charset_normalizer/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/charset_normalizer/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a97259a42b55dae028622ded8027e4eceb7bc2c2 GIT binary patch literal 1724 zcmcIk&1)M+6rYu3$y(WQ?9fX~VG1RZAl^;vLyJfaPHJO8Y!}DvVJR%5-H~?V*$-xB z<*J9`=F&f*e?#%bErgoVx|iO1Sz(G{A>`0Q$;~CVobqNRSt-f2dwBcan|bg3-q-v& zKd&SBntR9HW*MQsl`#2AW9G#lz#x9FBwAt+kKpk$ST8EYmeTV)M_ zeuhs`jpT6%=yhjPc zn?4s3e;)dM$_2<{Q~W8F)R7T4^mWYq4kvtorAH+8D2oLiL<#1UxLDG!B<}Jkz$C;; zco0U1A$CUbF%6x_^~0W_Z%5Ma6G>g%8RW+vZyZEckBI7>UcsxtNi zWtJb?oq?ocVgUIhObYzTYiEu6z2Ud%lk}JL6c4{k&(fcifYa0T*YpIZzYmYn6VRRE z^fx7+r9bAHpYxk1pgc{V7>fz(`?1Q?I*Pk}(iR{`R*PG1=nhq7x?j=+xKx1fz zQZ}xx2+14MYq|RWhO6tl&~7epK%q-6bRu*|bssf_^oh?%hf%x?4Ia%#H-YB6k&^^8 zltlVbsKboj^`wkN%QSnw^pcL@M1i@R2u`K>X4BRTz2!vlfcrg9ws6B~;+5MgchtbG zdjU-B{`%HlTW>Mnp`oBHyxrcvl>>OtzQ3{aa3i0wK#dd(H9!=G{#-5R&U3Za%~GbT z{TR(dR>}EpoKNMe8FbQ(js&&rJUh%?B;WaR+%i-~EtY$lOVtx>GX z80sjz0-^#D#vo9&N96;^lk!X_uDdl#HLLAF^T)yu=mnUdmtUG*6i}1LRI0UhJX3A8 zx$O(bH2O5`oA8*KasCXf8h2Jq;Y+$aeuBhXro*&tKlG(-8}Z=f>|MwqVRVhZ55ZJ- z#U7B$qNZv8mTqXJ7Y(E>{DWHOsPz=R`wZQFif%qb&C61)Rye9$Vx%n{RW8ut5G|%l hH_uW10<8?uO1ipv^3lcW=5TfMe0A$D)aLJj+gBQ1Ov3;G literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/charset_normalizer/__pycache__/__main__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/charset_normalizer/__pycache__/__main__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..0b24403b26113e3b02d0c1ec9b31fdbdfe1b6378 GIT binary patch literal 294 zcmXv}Jxjzu5S_`U2q$On`3H>PEov+Ff?8OLu&leISuUFmn>CQ@1^jX2$nO?US26z%#SY1qtdApk2Mroauy~IMl;~u31mLp- z2p3x;LdQCmr+*k5Irbw}8lfqW3VkMom8KHnHfKGHf@je*v@2;zh!0o~Q#KF0aF)2Q zDR|c!RdD4r@f*`9K5eOLd1)Sb-G#zc=hM?O-k3lqwNx|tObu6s^bG}3Id5fY=H&Tq u@wDzX*@bobrKC$gygi)ROk!9uMErrnCEI(Of3bt_bpQ2w#UP#dEXw~ub5802 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/charset_normalizer/__pycache__/api.cpython-312.pyc b/.venv/lib/python3.12/site-packages/charset_normalizer/__pycache__/api.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4ccbcdb45eb5cae5901403c94fdd57a9e6df51d5 GIT binary patch literal 17327 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
{;Zv?yZ zz5DJ4_i4f2{NTYmp}T`8z6v&O?uF4GzHXsvw%udG_kxj4yT=CzH-6H!#Q&?vQh%P= zw#Ezsr*5Y1yqsqSSDDif>!{NRl};m zj^*i_m+~+CBp-gI5Paoc!{Gf6ps95!cQf%t=#KTy88DX4z+&}g6&38rckj7dyGM=e zEd;lzq0Z&$yP-ifyz`^6jn3_huiT@9_e-8#rC$L{0~fzIw0x`(=(%09O7A2-;9)hz zgxC9C{Nk;ZzE=u#%l-CUx8GW6KbEIkzVbGk_^ZqdYs{ena|n>Uu`}PZcctqEKn85W z0ZId!7peypKoed%dDq*eHi9BLeLEH%>z%`Duu%~GQ*pG=(iQ1T6WxytTev}n)VbTJJy(e1!f<}dO7t33U21Z>TA{Obc3OS z?S}rfKSm~R+1%i&8z^5>zHR&Mo-g+1TaOj!V`wa0cbV{ga5<;0ol=>@cLuj`(gttN z)UPvjYfN{6>An$LWp=~cFa00+^X%?bX3u(U$MW8r2Mb;M@}2uvY7g9{51<}pTuASLP!u5 zM>u&7d2|Mo|e8=BX)E^#-SS8E4RzMhXf>!`73K-JfS^-GqIPk^a_s{u#c zU1r?Bp@ZLU)5Rm?dp<2G% z{vY?&@)7&rc6s@z^>2rcGzsn2759-{(^l*1OLn+_X|v(o*FIyl-jDVPEsno$w&1

Cehrvu8Gb!x8i zuSiY+N>BcZ686Zsf zly;v=dt+vZ&f?~up2mbcO#)IMbFi$}cb4>>qGE0plGm7FC9p~28uz>6NwRYVd8YEN zdZUPyg#VfyJ4QU>&jG*ZT187pl)0u6KY&-wNl>4f6aNg}{t*)75*}QKr3DL13)SWM z(0R@I3%Ba>sjh(Ps!?4*^1nrO`Bhhw>Z*Sn^3qkCl-E)97&=m#eGYyu_JmY08-Uz@ zoQB(zQsFJe$%ow({Jy3nBgOOGGKs@!T>NMB#FJHB)G#GkF2Q+^H{f>-7HZzApT&sS z7XIaPOAph3Bu7p5!O0F$lsyB<7nD8bwNU_A)>HAiq=0DLO3^plAw$W-CMxn8H+w}c z0lPJ$XGm&AuZA`AyiGZ>o)TP6z^Y@}C9I2`dAYZU!MUp091t_-pL( z2yfp=E`ayv!G7B<$1bN9nwpD2+5tz@pJY$?2}LOV$m@SX$0rrx`+wvmHkd#1QmEfo zjn6EG!R9=QhX#cxJ7z=4h$p$^qFGav`2#Y5jS5PxXM~MOx#wsfv2qbGETRtjE*kDs zV=`G+phOxH_G~Ze(SWfp3z=x-B5v5s<> zC59b2lB`Cbm4YAUu`@zegq_z!9CEDFc!XglrSJa~Pl2$rmmqZyRmSNNa9sM3h=W zNfILN=Q4tbOWY6A5aIXPl!zXLD7^S0mJZ4%9N9S}Fa`^DSvY9~^ zO}BaRBLKY<&Fnuz0nDtEas~2%p3k~IyL_{K)wypy(5%uOYM@@N?@;U7)y6RX@7S#d zo7MJVwWWV6X?JUiFXpDv@g^mbRVVp%-0e+31*XvT95yD{_53;JxJlNW|C89 zCqKl)@I~{Dmml;Hk6|4R$@dfF_y)}An!8ji)3#IC&H*QeIGLy3*9zoYhkN$vgG?yy)NQ*is5 zrYvVIE7WVhp_=}V+WxiG1$7kM9^wtw8J^~=^=s~?g1af-JhbB8ex*tc^epzQ1$tl! zwi1Y3@vD@7jcO@SEvh|q<>Z<@RIrEgbw^h0M_~a1Fsi9Qtye3cz$U#9|{-z+cs@jwc)MabYKBii8aAZCn>rp$Thf0(L>cXFYQ{k z{c2w!5Z?5XI{Jw^AE~RRn%g)1q{vX!fz29H3{Z`2o3*4Er0SYB2^O%JuL?e{C$;Gk z(#@5SZnjjZE@smPPl6~si+Ey5M-xj=VTn~wA&FHwj#$!B#FCC7mUINMq~nLB!xn?5 z713+4cvO#n(FRO~)qi)v6W+8z9YGbIMO3k*ql%@cP{pdJP{k@8RV?YKVo668OFF7p z(ox0I(eFXE<6-EKrCx1jmm6;GyzTlTobNbPXg<7YgIaOk;RgZES7X+u>{C^w(6loEb0FM@95^) literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/charset_normalizer/__pycache__/cd.cpython-312.pyc b/.venv/lib/python3.12/site-packages/charset_normalizer/__pycache__/cd.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..19dd40585b67ee893ac9f0dc3bfd5e8b4ad48ee0 GIT binary patch literal 13487 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/charset_normalizer/__pycache__/constant.cpython-312.pyc b/.venv/lib/python3.12/site-packages/charset_normalizer/__pycache__/constant.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..90edd1693d95524116090caa695d0619db1776b2 GIT binary patch literal 38751 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 Dkx4`v literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/charset_normalizer/__pycache__/legacy.cpython-312.pyc b/.venv/lib/python3.12/site-packages/charset_normalizer/__pycache__/legacy.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d575cee79efb9c9ffe6bdd45dba72f53a709bb20 GIT binary patch literal 2495 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/charset_normalizer/__pycache__/models.cpython-312.pyc b/.venv/lib/python3.12/site-packages/charset_normalizer/__pycache__/models.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..bbf4542892d551579444dbfc898fd74788ec873c GIT binary patch literal 16599 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/charset_normalizer/__pycache__/utils.cpython-312.pyc b/.venv/lib/python3.12/site-packages/charset_normalizer/__pycache__/utils.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f28a8cabf4ec4a51212c18bcf8751fa40adb1398 GIT binary patch literal 14362 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/charset_normalizer/__pycache__/version.cpython-312.pyc b/.venv/lib/python3.12/site-packages/charset_normalizer/__pycache__/version.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5c92f3f287665079451ee59dac2210e7fefc2339 GIT binary patch literal 321 zcmX@j%ge<81e!ss)BJ(-V-N=hn4yf%dO*f>h7^Vf zp;qb@RQ}?y$<0qG%}KQ@0tE%g6UB-^;sY}yBjZOVCPtPI91Q$o4cs@lM6Yv6U*wXW P;e44(p^?3a1E>lBZ`D=K literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/charset_normalizer/api.py b/.venv/lib/python3.12/site-packages/charset_normalizer/api.py new file mode 100644 index 0000000..0ba08e3 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/charset_normalizer/api.py @@ -0,0 +1,626 @@ +import logging +from os import PathLike +from typing import BinaryIO, List, Optional, Set, Union + +from .cd import ( + coherence_ratio, + encoding_languages, + mb_encoding_languages, + merge_coherence_ratios, +) +from .constant import IANA_SUPPORTED, TOO_BIG_SEQUENCE, TOO_SMALL_SEQUENCE, TRACE +from .md import mess_ratio +from .models import CharsetMatch, CharsetMatches +from .utils import ( + any_specified_encoding, + cut_sequence_chunks, + iana_name, + identify_sig_or_bom, + is_cp_similar, + is_multi_byte_encoding, + should_strip_sig_or_bom, +) + +# Will most likely be controversial +# logging.addLevelName(TRACE, "TRACE") +logger = logging.getLogger("charset_normalizer") +explain_handler = logging.StreamHandler() +explain_handler.setFormatter( + logging.Formatter("%(asctime)s | %(levelname)s | %(message)s") +) + + +def from_bytes( + sequences: Union[bytes, bytearray], + steps: int = 5, + chunk_size: int = 512, + threshold: float = 0.2, + cp_isolation: Optional[List[str]] = None, + cp_exclusion: Optional[List[str]] = None, + preemptive_behaviour: bool = True, + explain: bool = False, + language_threshold: float = 0.1, + enable_fallback: bool = True, +) -> CharsetMatches: + """ + Given a raw bytes sequence, return the best possibles charset usable to render str objects. + If there is no results, it is a strong indicator that the source is binary/not text. + By default, the process will extract 5 blocks of 512o each to assess the mess and coherence of a given sequence. + And will give up a particular code page after 20% of measured mess. Those criteria are customizable at will. + + The preemptive behavior DOES NOT replace the traditional detection workflow, it prioritize a particular code page + but never take it for granted. Can improve the performance. + + You may want to focus your attention to some code page or/and not others, use cp_isolation and cp_exclusion for that + purpose. + + This function will strip the SIG in the payload/sequence every time except on UTF-16, UTF-32. + By default the library does not setup any handler other than the NullHandler, if you choose to set the 'explain' + toggle to True it will alter the logger configuration to add a StreamHandler that is suitable for debugging. + Custom logging format and handler can be set manually. + """ + + if not isinstance(sequences, (bytearray, bytes)): + raise TypeError( + "Expected object of type bytes or bytearray, got: {0}".format( + type(sequences) + ) + ) + + if explain: + previous_logger_level: int = logger.level + logger.addHandler(explain_handler) + logger.setLevel(TRACE) + + length: int = len(sequences) + + if length == 0: + logger.debug("Encoding detection on empty bytes, assuming utf_8 intention.") + if explain: + logger.removeHandler(explain_handler) + logger.setLevel(previous_logger_level or logging.WARNING) + return CharsetMatches([CharsetMatch(sequences, "utf_8", 0.0, False, [], "")]) + + if cp_isolation is not None: + logger.log( + TRACE, + "cp_isolation is set. use this flag for debugging purpose. " + "limited list of encoding allowed : %s.", + ", ".join(cp_isolation), + ) + cp_isolation = [iana_name(cp, False) for cp in cp_isolation] + else: + cp_isolation = [] + + if cp_exclusion is not None: + logger.log( + TRACE, + "cp_exclusion is set. use this flag for debugging purpose. " + "limited list of encoding excluded : %s.", + ", ".join(cp_exclusion), + ) + cp_exclusion = [iana_name(cp, False) for cp in cp_exclusion] + else: + cp_exclusion = [] + + if length <= (chunk_size * steps): + logger.log( + TRACE, + "override steps (%i) and chunk_size (%i) as content does not fit (%i byte(s) given) parameters.", + steps, + chunk_size, + length, + ) + steps = 1 + chunk_size = length + + if steps > 1 and length / steps < chunk_size: + chunk_size = int(length / steps) + + is_too_small_sequence: bool = len(sequences) < TOO_SMALL_SEQUENCE + is_too_large_sequence: bool = len(sequences) >= TOO_BIG_SEQUENCE + + if is_too_small_sequence: + logger.log( + TRACE, + "Trying to detect encoding from a tiny portion of ({}) byte(s).".format( + length + ), + ) + elif is_too_large_sequence: + logger.log( + TRACE, + "Using lazy str decoding because the payload is quite large, ({}) byte(s).".format( + length + ), + ) + + prioritized_encodings: List[str] = [] + + specified_encoding: Optional[str] = ( + any_specified_encoding(sequences) if preemptive_behaviour else None + ) + + if specified_encoding is not None: + prioritized_encodings.append(specified_encoding) + logger.log( + TRACE, + "Detected declarative mark in sequence. Priority +1 given for %s.", + specified_encoding, + ) + + tested: Set[str] = set() + tested_but_hard_failure: List[str] = [] + tested_but_soft_failure: List[str] = [] + + fallback_ascii: Optional[CharsetMatch] = None + fallback_u8: Optional[CharsetMatch] = None + fallback_specified: Optional[CharsetMatch] = None + + results: CharsetMatches = CharsetMatches() + + sig_encoding, sig_payload = identify_sig_or_bom(sequences) + + if sig_encoding is not None: + prioritized_encodings.append(sig_encoding) + logger.log( + TRACE, + "Detected a SIG or BOM mark on first %i byte(s). Priority +1 given for %s.", + len(sig_payload), + sig_encoding, + ) + + prioritized_encodings.append("ascii") + + if "utf_8" not in prioritized_encodings: + prioritized_encodings.append("utf_8") + + for encoding_iana in prioritized_encodings + IANA_SUPPORTED: + if cp_isolation and encoding_iana not in cp_isolation: + continue + + if cp_exclusion and encoding_iana in cp_exclusion: + continue + + if encoding_iana in tested: + continue + + tested.add(encoding_iana) + + decoded_payload: Optional[str] = None + bom_or_sig_available: bool = sig_encoding == encoding_iana + strip_sig_or_bom: bool = bom_or_sig_available and should_strip_sig_or_bom( + encoding_iana + ) + + if encoding_iana in {"utf_16", "utf_32"} and not bom_or_sig_available: + logger.log( + TRACE, + "Encoding %s won't be tested as-is because it require a BOM. Will try some sub-encoder LE/BE.", + encoding_iana, + ) + continue + if encoding_iana in {"utf_7"} and not bom_or_sig_available: + logger.log( + TRACE, + "Encoding %s won't be tested as-is because detection is unreliable without BOM/SIG.", + encoding_iana, + ) + continue + + try: + is_multi_byte_decoder: bool = is_multi_byte_encoding(encoding_iana) + except (ModuleNotFoundError, ImportError): + logger.log( + TRACE, + "Encoding %s does not provide an IncrementalDecoder", + encoding_iana, + ) + continue + + try: + if is_too_large_sequence and is_multi_byte_decoder is False: + str( + sequences[: int(50e4)] + if strip_sig_or_bom is False + else sequences[len(sig_payload) : int(50e4)], + encoding=encoding_iana, + ) + else: + decoded_payload = str( + sequences + if strip_sig_or_bom is False + else sequences[len(sig_payload) :], + encoding=encoding_iana, + ) + except (UnicodeDecodeError, LookupError) as e: + if not isinstance(e, LookupError): + logger.log( + TRACE, + "Code page %s does not fit given bytes sequence at ALL. %s", + encoding_iana, + str(e), + ) + tested_but_hard_failure.append(encoding_iana) + continue + + similar_soft_failure_test: bool = False + + for encoding_soft_failed in tested_but_soft_failure: + if is_cp_similar(encoding_iana, encoding_soft_failed): + similar_soft_failure_test = True + break + + if similar_soft_failure_test: + logger.log( + TRACE, + "%s is deemed too similar to code page %s and was consider unsuited already. Continuing!", + encoding_iana, + encoding_soft_failed, + ) + continue + + r_ = range( + 0 if not bom_or_sig_available else len(sig_payload), + length, + int(length / steps), + ) + + multi_byte_bonus: bool = ( + is_multi_byte_decoder + and decoded_payload is not None + and len(decoded_payload) < length + ) + + if multi_byte_bonus: + logger.log( + TRACE, + "Code page %s is a multi byte encoding table and it appear that at least one character " + "was encoded using n-bytes.", + encoding_iana, + ) + + max_chunk_gave_up: int = int(len(r_) / 4) + + max_chunk_gave_up = max(max_chunk_gave_up, 2) + early_stop_count: int = 0 + lazy_str_hard_failure = False + + md_chunks: List[str] = [] + md_ratios = [] + + try: + for chunk in cut_sequence_chunks( + sequences, + encoding_iana, + r_, + chunk_size, + bom_or_sig_available, + strip_sig_or_bom, + sig_payload, + is_multi_byte_decoder, + decoded_payload, + ): + md_chunks.append(chunk) + + md_ratios.append( + mess_ratio( + chunk, + threshold, + explain is True and 1 <= len(cp_isolation) <= 2, + ) + ) + + if md_ratios[-1] >= threshold: + early_stop_count += 1 + + if (early_stop_count >= max_chunk_gave_up) or ( + bom_or_sig_available and strip_sig_or_bom is False + ): + break + except ( + UnicodeDecodeError + ) as e: # Lazy str loading may have missed something there + logger.log( + TRACE, + "LazyStr Loading: After MD chunk decode, code page %s does not fit given bytes sequence at ALL. %s", + encoding_iana, + str(e), + ) + early_stop_count = max_chunk_gave_up + lazy_str_hard_failure = True + + # We might want to check the sequence again with the whole content + # Only if initial MD tests passes + if ( + not lazy_str_hard_failure + and is_too_large_sequence + and not is_multi_byte_decoder + ): + try: + sequences[int(50e3) :].decode(encoding_iana, errors="strict") + except UnicodeDecodeError as e: + logger.log( + TRACE, + "LazyStr Loading: After final lookup, code page %s does not fit given bytes sequence at ALL. %s", + encoding_iana, + str(e), + ) + tested_but_hard_failure.append(encoding_iana) + continue + + mean_mess_ratio: float = sum(md_ratios) / len(md_ratios) if md_ratios else 0.0 + if mean_mess_ratio >= threshold or early_stop_count >= max_chunk_gave_up: + tested_but_soft_failure.append(encoding_iana) + logger.log( + TRACE, + "%s was excluded because of initial chaos probing. Gave up %i time(s). " + "Computed mean chaos is %f %%.", + encoding_iana, + early_stop_count, + round(mean_mess_ratio * 100, ndigits=3), + ) + # Preparing those fallbacks in case we got nothing. + if ( + enable_fallback + and encoding_iana in ["ascii", "utf_8", specified_encoding] + and not lazy_str_hard_failure + ): + fallback_entry = CharsetMatch( + sequences, encoding_iana, threshold, False, [], decoded_payload + ) + if encoding_iana == specified_encoding: + fallback_specified = fallback_entry + elif encoding_iana == "ascii": + fallback_ascii = fallback_entry + else: + fallback_u8 = fallback_entry + continue + + logger.log( + TRACE, + "%s passed initial chaos probing. Mean measured chaos is %f %%", + encoding_iana, + round(mean_mess_ratio * 100, ndigits=3), + ) + + if not is_multi_byte_decoder: + target_languages: List[str] = encoding_languages(encoding_iana) + else: + target_languages = mb_encoding_languages(encoding_iana) + + if target_languages: + logger.log( + TRACE, + "{} should target any language(s) of {}".format( + encoding_iana, str(target_languages) + ), + ) + + cd_ratios = [] + + # We shall skip the CD when its about ASCII + # Most of the time its not relevant to run "language-detection" on it. + if encoding_iana != "ascii": + for chunk in md_chunks: + chunk_languages = coherence_ratio( + chunk, + language_threshold, + ",".join(target_languages) if target_languages else None, + ) + + cd_ratios.append(chunk_languages) + + cd_ratios_merged = merge_coherence_ratios(cd_ratios) + + if cd_ratios_merged: + logger.log( + TRACE, + "We detected language {} using {}".format( + cd_ratios_merged, encoding_iana + ), + ) + + results.append( + CharsetMatch( + sequences, + encoding_iana, + mean_mess_ratio, + bom_or_sig_available, + cd_ratios_merged, + decoded_payload, + ) + ) + + if ( + encoding_iana in [specified_encoding, "ascii", "utf_8"] + and mean_mess_ratio < 0.1 + ): + logger.debug( + "Encoding detection: %s is most likely the one.", encoding_iana + ) + if explain: + logger.removeHandler(explain_handler) + logger.setLevel(previous_logger_level) + return CharsetMatches([results[encoding_iana]]) + + if encoding_iana == sig_encoding: + logger.debug( + "Encoding detection: %s is most likely the one as we detected a BOM or SIG within " + "the beginning of the sequence.", + encoding_iana, + ) + if explain: + logger.removeHandler(explain_handler) + logger.setLevel(previous_logger_level) + return CharsetMatches([results[encoding_iana]]) + + if len(results) == 0: + if fallback_u8 or fallback_ascii or fallback_specified: + logger.log( + TRACE, + "Nothing got out of the detection process. Using ASCII/UTF-8/Specified fallback.", + ) + + if fallback_specified: + logger.debug( + "Encoding detection: %s will be used as a fallback match", + fallback_specified.encoding, + ) + results.append(fallback_specified) + elif ( + (fallback_u8 and fallback_ascii is None) + or ( + fallback_u8 + and fallback_ascii + and fallback_u8.fingerprint != fallback_ascii.fingerprint + ) + or (fallback_u8 is not None) + ): + logger.debug("Encoding detection: utf_8 will be used as a fallback match") + results.append(fallback_u8) + elif fallback_ascii: + logger.debug("Encoding detection: ascii will be used as a fallback match") + results.append(fallback_ascii) + + if results: + logger.debug( + "Encoding detection: Found %s as plausible (best-candidate) for content. With %i alternatives.", + results.best().encoding, # type: ignore + len(results) - 1, + ) + else: + logger.debug("Encoding detection: Unable to determine any suitable charset.") + + if explain: + logger.removeHandler(explain_handler) + logger.setLevel(previous_logger_level) + + return results + + +def from_fp( + fp: BinaryIO, + steps: int = 5, + chunk_size: int = 512, + threshold: float = 0.20, + cp_isolation: Optional[List[str]] = None, + cp_exclusion: Optional[List[str]] = None, + preemptive_behaviour: bool = True, + explain: bool = False, + language_threshold: float = 0.1, + enable_fallback: bool = True, +) -> CharsetMatches: + """ + Same thing than the function from_bytes but using a file pointer that is already ready. + Will not close the file pointer. + """ + return from_bytes( + fp.read(), + steps, + chunk_size, + threshold, + cp_isolation, + cp_exclusion, + preemptive_behaviour, + explain, + language_threshold, + enable_fallback, + ) + + +def from_path( + path: Union[str, bytes, PathLike], # type: ignore[type-arg] + steps: int = 5, + chunk_size: int = 512, + threshold: float = 0.20, + cp_isolation: Optional[List[str]] = None, + cp_exclusion: Optional[List[str]] = None, + preemptive_behaviour: bool = True, + explain: bool = False, + language_threshold: float = 0.1, + enable_fallback: bool = True, +) -> CharsetMatches: + """ + Same thing than the function from_bytes but with one extra step. Opening and reading given file path in binary mode. + Can raise IOError. + """ + with open(path, "rb") as fp: + return from_fp( + fp, + steps, + chunk_size, + threshold, + cp_isolation, + cp_exclusion, + preemptive_behaviour, + explain, + language_threshold, + enable_fallback, + ) + + +def is_binary( + fp_or_path_or_payload: Union[PathLike, str, BinaryIO, bytes], # type: ignore[type-arg] + steps: int = 5, + chunk_size: int = 512, + threshold: float = 0.20, + cp_isolation: Optional[List[str]] = None, + cp_exclusion: Optional[List[str]] = None, + preemptive_behaviour: bool = True, + explain: bool = False, + language_threshold: float = 0.1, + enable_fallback: bool = False, +) -> bool: + """ + Detect if the given input (file, bytes, or path) points to a binary file. aka. not a string. + Based on the same main heuristic algorithms and default kwargs at the sole exception that fallbacks match + are disabled to be stricter around ASCII-compatible but unlikely to be a string. + """ + if isinstance(fp_or_path_or_payload, (str, PathLike)): + guesses = from_path( + fp_or_path_or_payload, + steps=steps, + chunk_size=chunk_size, + threshold=threshold, + cp_isolation=cp_isolation, + cp_exclusion=cp_exclusion, + preemptive_behaviour=preemptive_behaviour, + explain=explain, + language_threshold=language_threshold, + enable_fallback=enable_fallback, + ) + elif isinstance( + fp_or_path_or_payload, + ( + bytes, + bytearray, + ), + ): + guesses = from_bytes( + fp_or_path_or_payload, + steps=steps, + chunk_size=chunk_size, + threshold=threshold, + cp_isolation=cp_isolation, + cp_exclusion=cp_exclusion, + preemptive_behaviour=preemptive_behaviour, + explain=explain, + language_threshold=language_threshold, + enable_fallback=enable_fallback, + ) + else: + guesses = from_fp( + fp_or_path_or_payload, + steps=steps, + chunk_size=chunk_size, + threshold=threshold, + cp_isolation=cp_isolation, + cp_exclusion=cp_exclusion, + preemptive_behaviour=preemptive_behaviour, + explain=explain, + language_threshold=language_threshold, + enable_fallback=enable_fallback, + ) + + return not guesses diff --git a/.venv/lib/python3.12/site-packages/charset_normalizer/cd.py b/.venv/lib/python3.12/site-packages/charset_normalizer/cd.py new file mode 100644 index 0000000..4ea6760 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/charset_normalizer/cd.py @@ -0,0 +1,395 @@ +import importlib +from codecs import IncrementalDecoder +from collections import Counter +from functools import lru_cache +from typing import Counter as TypeCounter, Dict, List, Optional, Tuple + +from .constant import ( + FREQUENCIES, + KO_NAMES, + LANGUAGE_SUPPORTED_COUNT, + TOO_SMALL_SEQUENCE, + ZH_NAMES, +) +from .md import is_suspiciously_successive_range +from .models import CoherenceMatches +from .utils import ( + is_accentuated, + is_latin, + is_multi_byte_encoding, + is_unicode_range_secondary, + unicode_range, +) + + +def encoding_unicode_range(iana_name: str) -> List[str]: + """ + Return associated unicode ranges in a single byte code page. + """ + if is_multi_byte_encoding(iana_name): + raise IOError("Function not supported on multi-byte code page") + + decoder = importlib.import_module( + "encodings.{}".format(iana_name) + ).IncrementalDecoder + + p: IncrementalDecoder = decoder(errors="ignore") + seen_ranges: Dict[str, int] = {} + character_count: int = 0 + + for i in range(0x40, 0xFF): + chunk: str = p.decode(bytes([i])) + + if chunk: + character_range: Optional[str] = unicode_range(chunk) + + if character_range is None: + continue + + if is_unicode_range_secondary(character_range) is False: + if character_range not in seen_ranges: + seen_ranges[character_range] = 0 + seen_ranges[character_range] += 1 + character_count += 1 + + return sorted( + [ + character_range + for character_range in seen_ranges + if seen_ranges[character_range] / character_count >= 0.15 + ] + ) + + +def unicode_range_languages(primary_range: str) -> List[str]: + """ + Return inferred languages used with a unicode range. + """ + languages: List[str] = [] + + for language, characters in FREQUENCIES.items(): + for character in characters: + if unicode_range(character) == primary_range: + languages.append(language) + break + + return languages + + +@lru_cache() +def encoding_languages(iana_name: str) -> List[str]: + """ + Single-byte encoding language association. Some code page are heavily linked to particular language(s). + This function does the correspondence. + """ + unicode_ranges: List[str] = encoding_unicode_range(iana_name) + primary_range: Optional[str] = None + + for specified_range in unicode_ranges: + if "Latin" not in specified_range: + primary_range = specified_range + break + + if primary_range is None: + return ["Latin Based"] + + return unicode_range_languages(primary_range) + + +@lru_cache() +def mb_encoding_languages(iana_name: str) -> List[str]: + """ + Multi-byte encoding language association. Some code page are heavily linked to particular language(s). + This function does the correspondence. + """ + if ( + iana_name.startswith("shift_") + or iana_name.startswith("iso2022_jp") + or iana_name.startswith("euc_j") + or iana_name == "cp932" + ): + return ["Japanese"] + if iana_name.startswith("gb") or iana_name in ZH_NAMES: + return ["Chinese"] + if iana_name.startswith("iso2022_kr") or iana_name in KO_NAMES: + return ["Korean"] + + return [] + + +@lru_cache(maxsize=LANGUAGE_SUPPORTED_COUNT) +def get_target_features(language: str) -> Tuple[bool, bool]: + """ + Determine main aspects from a supported language if it contains accents and if is pure Latin. + """ + target_have_accents: bool = False + target_pure_latin: bool = True + + for character in FREQUENCIES[language]: + if not target_have_accents and is_accentuated(character): + target_have_accents = True + if target_pure_latin and is_latin(character) is False: + target_pure_latin = False + + return target_have_accents, target_pure_latin + + +def alphabet_languages( + characters: List[str], ignore_non_latin: bool = False +) -> List[str]: + """ + Return associated languages associated to given characters. + """ + languages: List[Tuple[str, float]] = [] + + source_have_accents = any(is_accentuated(character) for character in characters) + + for language, language_characters in FREQUENCIES.items(): + target_have_accents, target_pure_latin = get_target_features(language) + + if ignore_non_latin and target_pure_latin is False: + continue + + if target_have_accents is False and source_have_accents: + continue + + character_count: int = len(language_characters) + + character_match_count: int = len( + [c for c in language_characters if c in characters] + ) + + ratio: float = character_match_count / character_count + + if ratio >= 0.2: + languages.append((language, ratio)) + + languages = sorted(languages, key=lambda x: x[1], reverse=True) + + return [compatible_language[0] for compatible_language in languages] + + +def characters_popularity_compare( + language: str, ordered_characters: List[str] +) -> float: + """ + Determine if a ordered characters list (by occurrence from most appearance to rarest) match a particular language. + The result is a ratio between 0. (absolutely no correspondence) and 1. (near perfect fit). + Beware that is function is not strict on the match in order to ease the detection. (Meaning close match is 1.) + """ + if language not in FREQUENCIES: + raise ValueError("{} not available".format(language)) + + character_approved_count: int = 0 + FREQUENCIES_language_set = set(FREQUENCIES[language]) + + ordered_characters_count: int = len(ordered_characters) + target_language_characters_count: int = len(FREQUENCIES[language]) + + large_alphabet: bool = target_language_characters_count > 26 + + for character, character_rank in zip( + ordered_characters, range(0, ordered_characters_count) + ): + if character not in FREQUENCIES_language_set: + continue + + character_rank_in_language: int = FREQUENCIES[language].index(character) + expected_projection_ratio: float = ( + target_language_characters_count / ordered_characters_count + ) + character_rank_projection: int = int(character_rank * expected_projection_ratio) + + if ( + large_alphabet is False + and abs(character_rank_projection - character_rank_in_language) > 4 + ): + continue + + if ( + large_alphabet is True + and abs(character_rank_projection - character_rank_in_language) + < target_language_characters_count / 3 + ): + character_approved_count += 1 + continue + + characters_before_source: List[str] = FREQUENCIES[language][ + 0:character_rank_in_language + ] + characters_after_source: List[str] = FREQUENCIES[language][ + character_rank_in_language: + ] + characters_before: List[str] = ordered_characters[0:character_rank] + characters_after: List[str] = ordered_characters[character_rank:] + + before_match_count: int = len( + set(characters_before) & set(characters_before_source) + ) + + after_match_count: int = len( + set(characters_after) & set(characters_after_source) + ) + + if len(characters_before_source) == 0 and before_match_count <= 4: + character_approved_count += 1 + continue + + if len(characters_after_source) == 0 and after_match_count <= 4: + character_approved_count += 1 + continue + + if ( + before_match_count / len(characters_before_source) >= 0.4 + or after_match_count / len(characters_after_source) >= 0.4 + ): + character_approved_count += 1 + continue + + return character_approved_count / len(ordered_characters) + + +def alpha_unicode_split(decoded_sequence: str) -> List[str]: + """ + Given a decoded text sequence, return a list of str. Unicode range / alphabet separation. + Ex. a text containing English/Latin with a bit a Hebrew will return two items in the resulting list; + One containing the latin letters and the other hebrew. + """ + layers: Dict[str, str] = {} + + for character in decoded_sequence: + if character.isalpha() is False: + continue + + character_range: Optional[str] = unicode_range(character) + + if character_range is None: + continue + + layer_target_range: Optional[str] = None + + for discovered_range in layers: + if ( + is_suspiciously_successive_range(discovered_range, character_range) + is False + ): + layer_target_range = discovered_range + break + + if layer_target_range is None: + layer_target_range = character_range + + if layer_target_range not in layers: + layers[layer_target_range] = character.lower() + continue + + layers[layer_target_range] += character.lower() + + return list(layers.values()) + + +def merge_coherence_ratios(results: List[CoherenceMatches]) -> CoherenceMatches: + """ + This function merge results previously given by the function coherence_ratio. + The return type is the same as coherence_ratio. + """ + per_language_ratios: Dict[str, List[float]] = {} + for result in results: + for sub_result in result: + language, ratio = sub_result + if language not in per_language_ratios: + per_language_ratios[language] = [ratio] + continue + per_language_ratios[language].append(ratio) + + merge = [ + ( + language, + round( + sum(per_language_ratios[language]) / len(per_language_ratios[language]), + 4, + ), + ) + for language in per_language_ratios + ] + + return sorted(merge, key=lambda x: x[1], reverse=True) + + +def filter_alt_coherence_matches(results: CoherenceMatches) -> CoherenceMatches: + """ + We shall NOT return "English—" in CoherenceMatches because it is an alternative + of "English". This function only keeps the best match and remove the em-dash in it. + """ + index_results: Dict[str, List[float]] = dict() + + for result in results: + language, ratio = result + no_em_name: str = language.replace("—", "") + + if no_em_name not in index_results: + index_results[no_em_name] = [] + + index_results[no_em_name].append(ratio) + + if any(len(index_results[e]) > 1 for e in index_results): + filtered_results: CoherenceMatches = [] + + for language in index_results: + filtered_results.append((language, max(index_results[language]))) + + return filtered_results + + return results + + +@lru_cache(maxsize=2048) +def coherence_ratio( + decoded_sequence: str, threshold: float = 0.1, lg_inclusion: Optional[str] = None +) -> CoherenceMatches: + """ + Detect ANY language that can be identified in given sequence. The sequence will be analysed by layers. + A layer = Character extraction by alphabets/ranges. + """ + + results: List[Tuple[str, float]] = [] + ignore_non_latin: bool = False + + sufficient_match_count: int = 0 + + lg_inclusion_list = lg_inclusion.split(",") if lg_inclusion is not None else [] + if "Latin Based" in lg_inclusion_list: + ignore_non_latin = True + lg_inclusion_list.remove("Latin Based") + + for layer in alpha_unicode_split(decoded_sequence): + sequence_frequencies: TypeCounter[str] = Counter(layer) + most_common = sequence_frequencies.most_common() + + character_count: int = sum(o for c, o in most_common) + + if character_count <= TOO_SMALL_SEQUENCE: + continue + + popular_character_ordered: List[str] = [c for c, o in most_common] + + for language in lg_inclusion_list or alphabet_languages( + popular_character_ordered, ignore_non_latin + ): + ratio: float = characters_popularity_compare( + language, popular_character_ordered + ) + + if ratio < threshold: + continue + elif ratio >= 0.8: + sufficient_match_count += 1 + + results.append((language, round(ratio, 4))) + + if sufficient_match_count >= 3: + break + + return sorted( + filter_alt_coherence_matches(results), key=lambda x: x[1], reverse=True + ) diff --git a/.venv/lib/python3.12/site-packages/charset_normalizer/cli/__init__.py b/.venv/lib/python3.12/site-packages/charset_normalizer/cli/__init__.py new file mode 100644 index 0000000..d95fedf --- /dev/null +++ b/.venv/lib/python3.12/site-packages/charset_normalizer/cli/__init__.py @@ -0,0 +1,6 @@ +from .__main__ import cli_detect, query_yes_no + +__all__ = ( + "cli_detect", + "query_yes_no", +) diff --git a/.venv/lib/python3.12/site-packages/charset_normalizer/cli/__main__.py b/.venv/lib/python3.12/site-packages/charset_normalizer/cli/__main__.py new file mode 100644 index 0000000..f4bcbaa --- /dev/null +++ b/.venv/lib/python3.12/site-packages/charset_normalizer/cli/__main__.py @@ -0,0 +1,296 @@ +import argparse +import sys +from json import dumps +from os.path import abspath, basename, dirname, join, realpath +from platform import python_version +from typing import List, Optional +from unicodedata import unidata_version + +import charset_normalizer.md as md_module +from charset_normalizer import from_fp +from charset_normalizer.models import CliDetectionResult +from charset_normalizer.version import __version__ + + +def query_yes_no(question: str, default: str = "yes") -> bool: + """Ask a yes/no question via input() and return their answer. + + "question" is a string that is presented to the user. + "default" is the presumed answer if the user just hits . + It must be "yes" (the default), "no" or None (meaning + an answer is required of the user). + + The "answer" return value is True for "yes" or False for "no". + + Credit goes to (c) https://stackoverflow.com/questions/3041986/apt-command-line-interface-like-yes-no-input + """ + valid = {"yes": True, "y": True, "ye": True, "no": False, "n": False} + if default is None: + prompt = " [y/n] " + elif default == "yes": + prompt = " [Y/n] " + elif default == "no": + prompt = " [y/N] " + else: + raise ValueError("invalid default answer: '%s'" % default) + + while True: + sys.stdout.write(question + prompt) + choice = input().lower() + if default is not None and choice == "": + return valid[default] + elif choice in valid: + return valid[choice] + else: + sys.stdout.write("Please respond with 'yes' or 'no' " "(or 'y' or 'n').\n") + + +def cli_detect(argv: Optional[List[str]] = None) -> int: + """ + CLI assistant using ARGV and ArgumentParser + :param argv: + :return: 0 if everything is fine, anything else equal trouble + """ + parser = argparse.ArgumentParser( + description="The Real First Universal Charset Detector. " + "Discover originating encoding used on text file. " + "Normalize text to unicode." + ) + + parser.add_argument( + "files", type=argparse.FileType("rb"), nargs="+", help="File(s) to be analysed" + ) + parser.add_argument( + "-v", + "--verbose", + action="store_true", + default=False, + dest="verbose", + help="Display complementary information about file if any. " + "Stdout will contain logs about the detection process.", + ) + parser.add_argument( + "-a", + "--with-alternative", + action="store_true", + default=False, + dest="alternatives", + help="Output complementary possibilities if any. Top-level JSON WILL be a list.", + ) + parser.add_argument( + "-n", + "--normalize", + action="store_true", + default=False, + dest="normalize", + help="Permit to normalize input file. If not set, program does not write anything.", + ) + parser.add_argument( + "-m", + "--minimal", + action="store_true", + default=False, + dest="minimal", + help="Only output the charset detected to STDOUT. Disabling JSON output.", + ) + parser.add_argument( + "-r", + "--replace", + action="store_true", + default=False, + dest="replace", + help="Replace file when trying to normalize it instead of creating a new one.", + ) + parser.add_argument( + "-f", + "--force", + action="store_true", + default=False, + dest="force", + help="Replace file without asking if you are sure, use this flag with caution.", + ) + parser.add_argument( + "-t", + "--threshold", + action="store", + default=0.2, + type=float, + dest="threshold", + help="Define a custom maximum amount of chaos allowed in decoded content. 0. <= chaos <= 1.", + ) + parser.add_argument( + "--version", + action="version", + version="Charset-Normalizer {} - Python {} - Unicode {} - SpeedUp {}".format( + __version__, + python_version(), + unidata_version, + "OFF" if md_module.__file__.lower().endswith(".py") else "ON", + ), + help="Show version information and exit.", + ) + + args = parser.parse_args(argv) + + if args.replace is True and args.normalize is False: + print("Use --replace in addition of --normalize only.", file=sys.stderr) + return 1 + + if args.force is True and args.replace is False: + print("Use --force in addition of --replace only.", file=sys.stderr) + return 1 + + if args.threshold < 0.0 or args.threshold > 1.0: + print("--threshold VALUE should be between 0. AND 1.", file=sys.stderr) + return 1 + + x_ = [] + + for my_file in args.files: + matches = from_fp(my_file, threshold=args.threshold, explain=args.verbose) + + best_guess = matches.best() + + if best_guess is None: + print( + 'Unable to identify originating encoding for "{}". {}'.format( + my_file.name, + "Maybe try increasing maximum amount of chaos." + if args.threshold < 1.0 + else "", + ), + file=sys.stderr, + ) + x_.append( + CliDetectionResult( + abspath(my_file.name), + None, + [], + [], + "Unknown", + [], + False, + 1.0, + 0.0, + None, + True, + ) + ) + else: + x_.append( + CliDetectionResult( + abspath(my_file.name), + best_guess.encoding, + best_guess.encoding_aliases, + [ + cp + for cp in best_guess.could_be_from_charset + if cp != best_guess.encoding + ], + best_guess.language, + best_guess.alphabets, + best_guess.bom, + best_guess.percent_chaos, + best_guess.percent_coherence, + None, + True, + ) + ) + + if len(matches) > 1 and args.alternatives: + for el in matches: + if el != best_guess: + x_.append( + CliDetectionResult( + abspath(my_file.name), + el.encoding, + el.encoding_aliases, + [ + cp + for cp in el.could_be_from_charset + if cp != el.encoding + ], + el.language, + el.alphabets, + el.bom, + el.percent_chaos, + el.percent_coherence, + None, + False, + ) + ) + + if args.normalize is True: + if best_guess.encoding.startswith("utf") is True: + print( + '"{}" file does not need to be normalized, as it already came from unicode.'.format( + my_file.name + ), + file=sys.stderr, + ) + if my_file.closed is False: + my_file.close() + continue + + dir_path = dirname(realpath(my_file.name)) + file_name = basename(realpath(my_file.name)) + + o_: List[str] = file_name.split(".") + + if args.replace is False: + o_.insert(-1, best_guess.encoding) + if my_file.closed is False: + my_file.close() + elif ( + args.force is False + and query_yes_no( + 'Are you sure to normalize "{}" by replacing it ?'.format( + my_file.name + ), + "no", + ) + is False + ): + if my_file.closed is False: + my_file.close() + continue + + try: + x_[0].unicode_path = join(dir_path, ".".join(o_)) + + with open(x_[0].unicode_path, "w", encoding="utf-8") as fp: + fp.write(str(best_guess)) + except IOError as e: + print(str(e), file=sys.stderr) + if my_file.closed is False: + my_file.close() + return 2 + + if my_file.closed is False: + my_file.close() + + if args.minimal is False: + print( + dumps( + [el.__dict__ for el in x_] if len(x_) > 1 else x_[0].__dict__, + ensure_ascii=True, + indent=4, + ) + ) + else: + for my_file in args.files: + print( + ", ".join( + [ + el.encoding or "undefined" + for el in x_ + if el.path == abspath(my_file.name) + ] + ) + ) + + return 0 + + +if __name__ == "__main__": + cli_detect() diff --git a/.venv/lib/python3.12/site-packages/charset_normalizer/cli/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/charset_normalizer/cli/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b391c4cff8ceebf3d2ce328e8f9f5c2abac2c72f GIT binary patch literal 282 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/charset_normalizer/constant.py b/.venv/lib/python3.12/site-packages/charset_normalizer/constant.py new file mode 100644 index 0000000..8634904 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/charset_normalizer/constant.py @@ -0,0 +1,1995 @@ +# -*- coding: utf-8 -*- +from codecs import BOM_UTF8, BOM_UTF16_BE, BOM_UTF16_LE, BOM_UTF32_BE, BOM_UTF32_LE +from encodings.aliases import aliases +from re import IGNORECASE, compile as re_compile +from typing import Dict, List, Set, Union + +# Contain for each eligible encoding a list of/item bytes SIG/BOM +ENCODING_MARKS: Dict[str, Union[bytes, List[bytes]]] = { + "utf_8": BOM_UTF8, + "utf_7": [ + b"\x2b\x2f\x76\x38", + b"\x2b\x2f\x76\x39", + b"\x2b\x2f\x76\x2b", + b"\x2b\x2f\x76\x2f", + b"\x2b\x2f\x76\x38\x2d", + ], + "gb18030": b"\x84\x31\x95\x33", + "utf_32": [BOM_UTF32_BE, BOM_UTF32_LE], + "utf_16": [BOM_UTF16_BE, BOM_UTF16_LE], +} + +TOO_SMALL_SEQUENCE: int = 32 +TOO_BIG_SEQUENCE: int = int(10e6) + +UTF8_MAXIMAL_ALLOCATION: int = 1_112_064 + +# Up-to-date Unicode ucd/15.0.0 +UNICODE_RANGES_COMBINED: Dict[str, range] = { + "Control character": range(32), + "Basic Latin": range(32, 128), + "Latin-1 Supplement": range(128, 256), + "Latin Extended-A": range(256, 384), + "Latin Extended-B": range(384, 592), + "IPA Extensions": range(592, 688), + "Spacing Modifier Letters": range(688, 768), + "Combining Diacritical Marks": range(768, 880), + "Greek and Coptic": range(880, 1024), + "Cyrillic": range(1024, 1280), + "Cyrillic Supplement": range(1280, 1328), + "Armenian": range(1328, 1424), + "Hebrew": range(1424, 1536), + "Arabic": range(1536, 1792), + "Syriac": range(1792, 1872), + "Arabic Supplement": range(1872, 1920), + "Thaana": range(1920, 1984), + "NKo": range(1984, 2048), + "Samaritan": range(2048, 2112), + "Mandaic": range(2112, 2144), + "Syriac Supplement": range(2144, 2160), + "Arabic Extended-B": range(2160, 2208), + "Arabic Extended-A": range(2208, 2304), + "Devanagari": range(2304, 2432), + "Bengali": range(2432, 2560), + "Gurmukhi": range(2560, 2688), + "Gujarati": range(2688, 2816), + "Oriya": range(2816, 2944), + "Tamil": range(2944, 3072), + "Telugu": range(3072, 3200), + "Kannada": range(3200, 3328), + "Malayalam": range(3328, 3456), + "Sinhala": range(3456, 3584), + "Thai": range(3584, 3712), + "Lao": range(3712, 3840), + "Tibetan": range(3840, 4096), + "Myanmar": range(4096, 4256), + "Georgian": range(4256, 4352), + "Hangul Jamo": range(4352, 4608), + "Ethiopic": range(4608, 4992), + "Ethiopic Supplement": range(4992, 5024), + "Cherokee": range(5024, 5120), + "Unified Canadian Aboriginal Syllabics": range(5120, 5760), + "Ogham": range(5760, 5792), + "Runic": range(5792, 5888), + "Tagalog": range(5888, 5920), + "Hanunoo": range(5920, 5952), + "Buhid": range(5952, 5984), + "Tagbanwa": range(5984, 6016), + "Khmer": range(6016, 6144), + "Mongolian": range(6144, 6320), + "Unified Canadian Aboriginal Syllabics Extended": range(6320, 6400), + "Limbu": range(6400, 6480), + "Tai Le": range(6480, 6528), + "New Tai Lue": range(6528, 6624), + "Khmer Symbols": range(6624, 6656), + "Buginese": range(6656, 6688), + "Tai Tham": range(6688, 6832), + "Combining Diacritical Marks Extended": range(6832, 6912), + "Balinese": range(6912, 7040), + "Sundanese": range(7040, 7104), + "Batak": range(7104, 7168), + "Lepcha": range(7168, 7248), + "Ol Chiki": range(7248, 7296), + "Cyrillic Extended-C": range(7296, 7312), + "Georgian Extended": range(7312, 7360), + "Sundanese Supplement": range(7360, 7376), + "Vedic Extensions": range(7376, 7424), + "Phonetic Extensions": range(7424, 7552), + "Phonetic Extensions Supplement": range(7552, 7616), + "Combining Diacritical Marks Supplement": range(7616, 7680), + "Latin Extended Additional": range(7680, 7936), + "Greek Extended": range(7936, 8192), + "General Punctuation": range(8192, 8304), + "Superscripts and Subscripts": range(8304, 8352), + "Currency Symbols": range(8352, 8400), + "Combining Diacritical Marks for Symbols": range(8400, 8448), + "Letterlike Symbols": range(8448, 8528), + "Number Forms": range(8528, 8592), + "Arrows": range(8592, 8704), + "Mathematical Operators": range(8704, 8960), + "Miscellaneous Technical": range(8960, 9216), + "Control Pictures": range(9216, 9280), + "Optical Character Recognition": range(9280, 9312), + "Enclosed Alphanumerics": range(9312, 9472), + "Box Drawing": range(9472, 9600), + "Block Elements": range(9600, 9632), + "Geometric Shapes": range(9632, 9728), + "Miscellaneous Symbols": range(9728, 9984), + "Dingbats": range(9984, 10176), + "Miscellaneous Mathematical Symbols-A": range(10176, 10224), + "Supplemental Arrows-A": range(10224, 10240), + "Braille Patterns": range(10240, 10496), + "Supplemental Arrows-B": range(10496, 10624), + "Miscellaneous Mathematical Symbols-B": range(10624, 10752), + "Supplemental Mathematical Operators": range(10752, 11008), + "Miscellaneous Symbols and Arrows": range(11008, 11264), + "Glagolitic": range(11264, 11360), + "Latin Extended-C": range(11360, 11392), + "Coptic": range(11392, 11520), + "Georgian Supplement": range(11520, 11568), + "Tifinagh": range(11568, 11648), + "Ethiopic Extended": range(11648, 11744), + "Cyrillic Extended-A": range(11744, 11776), + "Supplemental Punctuation": range(11776, 11904), + "CJK Radicals Supplement": range(11904, 12032), + "Kangxi Radicals": range(12032, 12256), + "Ideographic Description Characters": range(12272, 12288), + "CJK Symbols and Punctuation": range(12288, 12352), + "Hiragana": range(12352, 12448), + "Katakana": range(12448, 12544), + "Bopomofo": range(12544, 12592), + "Hangul Compatibility Jamo": range(12592, 12688), + "Kanbun": range(12688, 12704), + "Bopomofo Extended": range(12704, 12736), + "CJK Strokes": range(12736, 12784), + "Katakana Phonetic Extensions": range(12784, 12800), + "Enclosed CJK Letters and Months": range(12800, 13056), + "CJK Compatibility": range(13056, 13312), + "CJK Unified Ideographs Extension A": range(13312, 19904), + "Yijing Hexagram Symbols": range(19904, 19968), + "CJK Unified Ideographs": range(19968, 40960), + "Yi Syllables": range(40960, 42128), + "Yi Radicals": range(42128, 42192), + "Lisu": range(42192, 42240), + "Vai": range(42240, 42560), + "Cyrillic Extended-B": range(42560, 42656), + "Bamum": range(42656, 42752), + "Modifier Tone Letters": range(42752, 42784), + "Latin Extended-D": range(42784, 43008), + "Syloti Nagri": range(43008, 43056), + "Common Indic Number Forms": range(43056, 43072), + "Phags-pa": range(43072, 43136), + "Saurashtra": range(43136, 43232), + "Devanagari Extended": range(43232, 43264), + "Kayah Li": range(43264, 43312), + "Rejang": range(43312, 43360), + "Hangul Jamo Extended-A": range(43360, 43392), + "Javanese": range(43392, 43488), + "Myanmar Extended-B": range(43488, 43520), + "Cham": range(43520, 43616), + "Myanmar Extended-A": range(43616, 43648), + "Tai Viet": range(43648, 43744), + "Meetei Mayek Extensions": range(43744, 43776), + "Ethiopic Extended-A": range(43776, 43824), + "Latin Extended-E": range(43824, 43888), + "Cherokee Supplement": range(43888, 43968), + "Meetei Mayek": range(43968, 44032), + "Hangul Syllables": range(44032, 55216), + "Hangul Jamo Extended-B": range(55216, 55296), + "High Surrogates": range(55296, 56192), + "High Private Use Surrogates": range(56192, 56320), + "Low Surrogates": range(56320, 57344), + "Private Use Area": range(57344, 63744), + "CJK Compatibility Ideographs": range(63744, 64256), + "Alphabetic Presentation Forms": range(64256, 64336), + "Arabic Presentation Forms-A": range(64336, 65024), + "Variation Selectors": range(65024, 65040), + "Vertical Forms": range(65040, 65056), + "Combining Half Marks": range(65056, 65072), + "CJK Compatibility Forms": range(65072, 65104), + "Small Form Variants": range(65104, 65136), + "Arabic Presentation Forms-B": range(65136, 65280), + "Halfwidth and Fullwidth Forms": range(65280, 65520), + "Specials": range(65520, 65536), + "Linear B Syllabary": range(65536, 65664), + "Linear B Ideograms": range(65664, 65792), + "Aegean Numbers": range(65792, 65856), + "Ancient Greek Numbers": range(65856, 65936), + "Ancient Symbols": range(65936, 66000), + "Phaistos Disc": range(66000, 66048), + "Lycian": range(66176, 66208), + "Carian": range(66208, 66272), + "Coptic Epact Numbers": range(66272, 66304), + "Old Italic": range(66304, 66352), + "Gothic": range(66352, 66384), + "Old Permic": range(66384, 66432), + "Ugaritic": range(66432, 66464), + "Old Persian": range(66464, 66528), + "Deseret": range(66560, 66640), + "Shavian": range(66640, 66688), + "Osmanya": range(66688, 66736), + "Osage": range(66736, 66816), + "Elbasan": range(66816, 66864), + "Caucasian Albanian": range(66864, 66928), + "Vithkuqi": range(66928, 67008), + "Linear A": range(67072, 67456), + "Latin Extended-F": range(67456, 67520), + "Cypriot Syllabary": range(67584, 67648), + "Imperial Aramaic": range(67648, 67680), + "Palmyrene": range(67680, 67712), + "Nabataean": range(67712, 67760), + "Hatran": range(67808, 67840), + "Phoenician": range(67840, 67872), + "Lydian": range(67872, 67904), + "Meroitic Hieroglyphs": range(67968, 68000), + "Meroitic Cursive": range(68000, 68096), + "Kharoshthi": range(68096, 68192), + "Old South Arabian": range(68192, 68224), + "Old North Arabian": range(68224, 68256), + "Manichaean": range(68288, 68352), + "Avestan": range(68352, 68416), + "Inscriptional Parthian": range(68416, 68448), + "Inscriptional Pahlavi": range(68448, 68480), + "Psalter Pahlavi": range(68480, 68528), + "Old Turkic": range(68608, 68688), + "Old Hungarian": range(68736, 68864), + "Hanifi Rohingya": range(68864, 68928), + "Rumi Numeral Symbols": range(69216, 69248), + "Yezidi": range(69248, 69312), + "Arabic Extended-C": range(69312, 69376), + "Old Sogdian": range(69376, 69424), + "Sogdian": range(69424, 69488), + "Old Uyghur": range(69488, 69552), + "Chorasmian": range(69552, 69600), + "Elymaic": range(69600, 69632), + "Brahmi": range(69632, 69760), + "Kaithi": range(69760, 69840), + "Sora Sompeng": range(69840, 69888), + "Chakma": range(69888, 69968), + "Mahajani": range(69968, 70016), + "Sharada": range(70016, 70112), + "Sinhala Archaic Numbers": range(70112, 70144), + "Khojki": range(70144, 70224), + "Multani": range(70272, 70320), + "Khudawadi": range(70320, 70400), + "Grantha": range(70400, 70528), + "Newa": range(70656, 70784), + "Tirhuta": range(70784, 70880), + "Siddham": range(71040, 71168), + "Modi": range(71168, 71264), + "Mongolian Supplement": range(71264, 71296), + "Takri": range(71296, 71376), + "Ahom": range(71424, 71504), + "Dogra": range(71680, 71760), + "Warang Citi": range(71840, 71936), + "Dives Akuru": range(71936, 72032), + "Nandinagari": range(72096, 72192), + "Zanabazar Square": range(72192, 72272), + "Soyombo": range(72272, 72368), + "Unified Canadian Aboriginal Syllabics Extended-A": range(72368, 72384), + "Pau Cin Hau": range(72384, 72448), + "Devanagari Extended-A": range(72448, 72544), + "Bhaiksuki": range(72704, 72816), + "Marchen": range(72816, 72896), + "Masaram Gondi": range(72960, 73056), + "Gunjala Gondi": range(73056, 73136), + "Makasar": range(73440, 73472), + "Kawi": range(73472, 73568), + "Lisu Supplement": range(73648, 73664), + "Tamil Supplement": range(73664, 73728), + "Cuneiform": range(73728, 74752), + "Cuneiform Numbers and Punctuation": range(74752, 74880), + "Early Dynastic Cuneiform": range(74880, 75088), + "Cypro-Minoan": range(77712, 77824), + "Egyptian Hieroglyphs": range(77824, 78896), + "Egyptian Hieroglyph Format Controls": range(78896, 78944), + "Anatolian Hieroglyphs": range(82944, 83584), + "Bamum Supplement": range(92160, 92736), + "Mro": range(92736, 92784), + "Tangsa": range(92784, 92880), + "Bassa Vah": range(92880, 92928), + "Pahawh Hmong": range(92928, 93072), + "Medefaidrin": range(93760, 93856), + "Miao": range(93952, 94112), + "Ideographic Symbols and Punctuation": range(94176, 94208), + "Tangut": range(94208, 100352), + "Tangut Components": range(100352, 101120), + "Khitan Small Script": range(101120, 101632), + "Tangut Supplement": range(101632, 101760), + "Kana Extended-B": range(110576, 110592), + "Kana Supplement": range(110592, 110848), + "Kana Extended-A": range(110848, 110896), + "Small Kana Extension": range(110896, 110960), + "Nushu": range(110960, 111360), + "Duployan": range(113664, 113824), + "Shorthand Format Controls": range(113824, 113840), + "Znamenny Musical Notation": range(118528, 118736), + "Byzantine Musical Symbols": range(118784, 119040), + "Musical Symbols": range(119040, 119296), + "Ancient Greek Musical Notation": range(119296, 119376), + "Kaktovik Numerals": range(119488, 119520), + "Mayan Numerals": range(119520, 119552), + "Tai Xuan Jing Symbols": range(119552, 119648), + "Counting Rod Numerals": range(119648, 119680), + "Mathematical Alphanumeric Symbols": range(119808, 120832), + "Sutton SignWriting": range(120832, 121520), + "Latin Extended-G": range(122624, 122880), + "Glagolitic Supplement": range(122880, 122928), + "Cyrillic Extended-D": range(122928, 123024), + "Nyiakeng Puachue Hmong": range(123136, 123216), + "Toto": range(123536, 123584), + "Wancho": range(123584, 123648), + "Nag Mundari": range(124112, 124160), + "Ethiopic Extended-B": range(124896, 124928), + "Mende Kikakui": range(124928, 125152), + "Adlam": range(125184, 125280), + "Indic Siyaq Numbers": range(126064, 126144), + "Ottoman Siyaq Numbers": range(126208, 126288), + "Arabic Mathematical Alphabetic Symbols": range(126464, 126720), + "Mahjong Tiles": range(126976, 127024), + "Domino Tiles": range(127024, 127136), + "Playing Cards": range(127136, 127232), + "Enclosed Alphanumeric Supplement": range(127232, 127488), + "Enclosed Ideographic Supplement": range(127488, 127744), + "Miscellaneous Symbols and Pictographs": range(127744, 128512), + "Emoticons range(Emoji)": range(128512, 128592), + "Ornamental Dingbats": range(128592, 128640), + "Transport and Map Symbols": range(128640, 128768), + "Alchemical Symbols": range(128768, 128896), + "Geometric Shapes Extended": range(128896, 129024), + "Supplemental Arrows-C": range(129024, 129280), + "Supplemental Symbols and Pictographs": range(129280, 129536), + "Chess Symbols": range(129536, 129648), + "Symbols and Pictographs Extended-A": range(129648, 129792), + "Symbols for Legacy Computing": range(129792, 130048), + "CJK Unified Ideographs Extension B": range(131072, 173792), + "CJK Unified Ideographs Extension C": range(173824, 177984), + "CJK Unified Ideographs Extension D": range(177984, 178208), + "CJK Unified Ideographs Extension E": range(178208, 183984), + "CJK Unified Ideographs Extension F": range(183984, 191472), + "CJK Compatibility Ideographs Supplement": range(194560, 195104), + "CJK Unified Ideographs Extension G": range(196608, 201552), + "CJK Unified Ideographs Extension H": range(201552, 205744), + "Tags": range(917504, 917632), + "Variation Selectors Supplement": range(917760, 918000), + "Supplementary Private Use Area-A": range(983040, 1048576), + "Supplementary Private Use Area-B": range(1048576, 1114112), +} + + +UNICODE_SECONDARY_RANGE_KEYWORD: List[str] = [ + "Supplement", + "Extended", + "Extensions", + "Modifier", + "Marks", + "Punctuation", + "Symbols", + "Forms", + "Operators", + "Miscellaneous", + "Drawing", + "Block", + "Shapes", + "Supplemental", + "Tags", +] + +RE_POSSIBLE_ENCODING_INDICATION = re_compile( + r"(?:(?:encoding)|(?:charset)|(?:coding))(?:[\:= ]{1,10})(?:[\"\']?)([a-zA-Z0-9\-_]+)(?:[\"\']?)", + IGNORECASE, +) + +IANA_NO_ALIASES = [ + "cp720", + "cp737", + "cp856", + "cp874", + "cp875", + "cp1006", + "koi8_r", + "koi8_t", + "koi8_u", +] + +IANA_SUPPORTED: List[str] = sorted( + filter( + lambda x: x.endswith("_codec") is False + and x not in {"rot_13", "tactis", "mbcs"}, + list(set(aliases.values())) + IANA_NO_ALIASES, + ) +) + +IANA_SUPPORTED_COUNT: int = len(IANA_SUPPORTED) + +# pre-computed code page that are similar using the function cp_similarity. +IANA_SUPPORTED_SIMILAR: Dict[str, List[str]] = { + "cp037": ["cp1026", "cp1140", "cp273", "cp500"], + "cp1026": ["cp037", "cp1140", "cp273", "cp500"], + "cp1125": ["cp866"], + "cp1140": ["cp037", "cp1026", "cp273", "cp500"], + "cp1250": ["iso8859_2"], + "cp1251": ["kz1048", "ptcp154"], + "cp1252": ["iso8859_15", "iso8859_9", "latin_1"], + "cp1253": ["iso8859_7"], + "cp1254": ["iso8859_15", "iso8859_9", "latin_1"], + "cp1257": ["iso8859_13"], + "cp273": ["cp037", "cp1026", "cp1140", "cp500"], + "cp437": ["cp850", "cp858", "cp860", "cp861", "cp862", "cp863", "cp865"], + "cp500": ["cp037", "cp1026", "cp1140", "cp273"], + "cp850": ["cp437", "cp857", "cp858", "cp865"], + "cp857": ["cp850", "cp858", "cp865"], + "cp858": ["cp437", "cp850", "cp857", "cp865"], + "cp860": ["cp437", "cp861", "cp862", "cp863", "cp865"], + "cp861": ["cp437", "cp860", "cp862", "cp863", "cp865"], + "cp862": ["cp437", "cp860", "cp861", "cp863", "cp865"], + "cp863": ["cp437", "cp860", "cp861", "cp862", "cp865"], + "cp865": ["cp437", "cp850", "cp857", "cp858", "cp860", "cp861", "cp862", "cp863"], + "cp866": ["cp1125"], + "iso8859_10": ["iso8859_14", "iso8859_15", "iso8859_4", "iso8859_9", "latin_1"], + "iso8859_11": ["tis_620"], + "iso8859_13": ["cp1257"], + "iso8859_14": [ + "iso8859_10", + "iso8859_15", + "iso8859_16", + "iso8859_3", + "iso8859_9", + "latin_1", + ], + "iso8859_15": [ + "cp1252", + "cp1254", + "iso8859_10", + "iso8859_14", + "iso8859_16", + "iso8859_3", + "iso8859_9", + "latin_1", + ], + "iso8859_16": [ + "iso8859_14", + "iso8859_15", + "iso8859_2", + "iso8859_3", + "iso8859_9", + "latin_1", + ], + "iso8859_2": ["cp1250", "iso8859_16", "iso8859_4"], + "iso8859_3": ["iso8859_14", "iso8859_15", "iso8859_16", "iso8859_9", "latin_1"], + "iso8859_4": ["iso8859_10", "iso8859_2", "iso8859_9", "latin_1"], + "iso8859_7": ["cp1253"], + "iso8859_9": [ + "cp1252", + "cp1254", + "cp1258", + "iso8859_10", + "iso8859_14", + "iso8859_15", + "iso8859_16", + "iso8859_3", + "iso8859_4", + "latin_1", + ], + "kz1048": ["cp1251", "ptcp154"], + "latin_1": [ + "cp1252", + "cp1254", + "cp1258", + "iso8859_10", + "iso8859_14", + "iso8859_15", + "iso8859_16", + "iso8859_3", + "iso8859_4", + "iso8859_9", + ], + "mac_iceland": ["mac_roman", "mac_turkish"], + "mac_roman": ["mac_iceland", "mac_turkish"], + "mac_turkish": ["mac_iceland", "mac_roman"], + "ptcp154": ["cp1251", "kz1048"], + "tis_620": ["iso8859_11"], +} + + +CHARDET_CORRESPONDENCE: Dict[str, str] = { + "iso2022_kr": "ISO-2022-KR", + "iso2022_jp": "ISO-2022-JP", + "euc_kr": "EUC-KR", + "tis_620": "TIS-620", + "utf_32": "UTF-32", + "euc_jp": "EUC-JP", + "koi8_r": "KOI8-R", + "iso8859_1": "ISO-8859-1", + "iso8859_2": "ISO-8859-2", + "iso8859_5": "ISO-8859-5", + "iso8859_6": "ISO-8859-6", + "iso8859_7": "ISO-8859-7", + "iso8859_8": "ISO-8859-8", + "utf_16": "UTF-16", + "cp855": "IBM855", + "mac_cyrillic": "MacCyrillic", + "gb2312": "GB2312", + "gb18030": "GB18030", + "cp932": "CP932", + "cp866": "IBM866", + "utf_8": "utf-8", + "utf_8_sig": "UTF-8-SIG", + "shift_jis": "SHIFT_JIS", + "big5": "Big5", + "cp1250": "windows-1250", + "cp1251": "windows-1251", + "cp1252": "Windows-1252", + "cp1253": "windows-1253", + "cp1255": "windows-1255", + "cp1256": "windows-1256", + "cp1254": "Windows-1254", + "cp949": "CP949", +} + + +COMMON_SAFE_ASCII_CHARACTERS: Set[str] = { + "<", + ">", + "=", + ":", + "/", + "&", + ";", + "{", + "}", + "[", + "]", + ",", + "|", + '"', + "-", +} + + +KO_NAMES: Set[str] = {"johab", "cp949", "euc_kr"} +ZH_NAMES: Set[str] = {"big5", "cp950", "big5hkscs", "hz"} + +# Logging LEVEL below DEBUG +TRACE: int = 5 + + +# Language label that contain the em dash "—" +# character are to be considered alternative seq to origin +FREQUENCIES: Dict[str, List[str]] = { + "English": [ + "e", + "a", + "t", + "i", + "o", + "n", + "s", + "r", + "h", + "l", + "d", + "c", + "u", + "m", + "f", + "p", + "g", + "w", + "y", + "b", + "v", + "k", + "x", + "j", + "z", + "q", + ], + "English—": [ + "e", + "a", + "t", + "i", + "o", + "n", + "s", + "r", + "h", + "l", + "d", + "c", + "m", + "u", + "f", + "p", + "g", + "w", + "b", + "y", + "v", + "k", + "j", + "x", + "z", + "q", + ], + "German": [ + "e", + "n", + "i", + "r", + "s", + "t", + "a", + "d", + "h", + "u", + "l", + "g", + "o", + "c", + "m", + "b", + "f", + "k", + "w", + "z", + "p", + "v", + "ü", + "ä", + "ö", + "j", + ], + "French": [ + "e", + "a", + "s", + "n", + "i", + "t", + "r", + "l", + "u", + "o", + "d", + "c", + "p", + "m", + "é", + "v", + "g", + "f", + "b", + "h", + "q", + "à", + "x", + "è", + "y", + "j", + ], + "Dutch": [ + "e", + "n", + "a", + "i", + "r", + "t", + "o", + "d", + "s", + "l", + "g", + "h", + "v", + "m", + "u", + "k", + "c", + "p", + "b", + "w", + "j", + "z", + "f", + "y", + "x", + "ë", + ], + "Italian": [ + "e", + "i", + "a", + "o", + "n", + "l", + "t", + "r", + "s", + "c", + "d", + "u", + "p", + "m", + "g", + "v", + "f", + "b", + "z", + "h", + "q", + "è", + "à", + "k", + "y", + "ò", + ], + "Polish": [ + "a", + "i", + "o", + "e", + "n", + "r", + "z", + "w", + "s", + "c", + "t", + "k", + "y", + "d", + "p", + "m", + "u", + "l", + "j", + "ł", + "g", + "b", + "h", + "ą", + "ę", + "ó", + ], + "Spanish": [ + "e", + "a", + "o", + "n", + "s", + "r", + "i", + "l", + "d", + "t", + "c", + "u", + "m", + "p", + "b", + "g", + "v", + "f", + "y", + "ó", + "h", + "q", + "í", + "j", + "z", + "á", + ], + "Russian": [ + "о", + "а", + "е", + "и", + "н", + "с", + "т", + "р", + "в", + "л", + "к", + "м", + "д", + "п", + "у", + "г", + "я", + "ы", + "з", + "б", + "й", + "ь", + "ч", + "х", + "ж", + "ц", + ], + # Jap-Kanji + "Japanese": [ + "人", + "一", + "大", + "亅", + "丁", + "丨", + "竹", + "笑", + "口", + "日", + "今", + "二", + "彳", + "行", + "十", + "土", + "丶", + "寸", + "寺", + "時", + "乙", + "丿", + "乂", + "气", + "気", + "冂", + "巾", + "亠", + "市", + "目", + "儿", + "見", + "八", + "小", + "凵", + "県", + "月", + "彐", + "門", + "間", + "木", + "東", + "山", + "出", + "本", + "中", + "刀", + "分", + "耳", + "又", + "取", + "最", + "言", + "田", + "心", + "思", + "刂", + "前", + "京", + "尹", + "事", + "生", + "厶", + "云", + "会", + "未", + "来", + "白", + "冫", + "楽", + "灬", + "馬", + "尸", + "尺", + "駅", + "明", + "耂", + "者", + "了", + "阝", + "都", + "高", + "卜", + "占", + "厂", + "广", + "店", + "子", + "申", + "奄", + "亻", + "俺", + "上", + "方", + "冖", + "学", + "衣", + "艮", + "食", + "自", + ], + # Jap-Katakana + "Japanese—": [ + "ー", + "ン", + "ス", + "・", + "ル", + "ト", + "リ", + "イ", + "ア", + "ラ", + "ッ", + "ク", + "ド", + "シ", + "レ", + "ジ", + "タ", + "フ", + "ロ", + "カ", + "テ", + "マ", + "ィ", + "グ", + "バ", + "ム", + "プ", + "オ", + "コ", + "デ", + "ニ", + "ウ", + "メ", + "サ", + "ビ", + "ナ", + "ブ", + "ャ", + "エ", + "ュ", + "チ", + "キ", + "ズ", + "ダ", + "パ", + "ミ", + "ェ", + "ョ", + "ハ", + "セ", + "ベ", + "ガ", + "モ", + "ツ", + "ネ", + "ボ", + "ソ", + "ノ", + "ァ", + "ヴ", + "ワ", + "ポ", + "ペ", + "ピ", + "ケ", + "ゴ", + "ギ", + "ザ", + "ホ", + "ゲ", + "ォ", + "ヤ", + "ヒ", + "ユ", + "ヨ", + "ヘ", + "ゼ", + "ヌ", + "ゥ", + "ゾ", + "ヶ", + "ヂ", + "ヲ", + "ヅ", + "ヵ", + "ヱ", + "ヰ", + "ヮ", + "ヽ", + "゠", + "ヾ", + "ヷ", + "ヿ", + "ヸ", + "ヹ", + "ヺ", + ], + # Jap-Hiragana + "Japanese——": [ + "の", + "に", + "る", + "た", + "と", + "は", + "し", + "い", + "を", + "で", + "て", + "が", + "な", + "れ", + "か", + "ら", + "さ", + "っ", + "り", + "す", + "あ", + "も", + "こ", + "ま", + "う", + "く", + "よ", + "き", + "ん", + "め", + "お", + "け", + "そ", + "つ", + "だ", + "や", + "え", + "ど", + "わ", + "ち", + "み", + "せ", + "じ", + "ば", + "へ", + "び", + "ず", + "ろ", + "ほ", + "げ", + "む", + "べ", + "ひ", + "ょ", + "ゆ", + "ぶ", + "ご", + "ゃ", + "ね", + "ふ", + "ぐ", + "ぎ", + "ぼ", + "ゅ", + "づ", + "ざ", + "ぞ", + "ぬ", + "ぜ", + "ぱ", + "ぽ", + "ぷ", + "ぴ", + "ぃ", + "ぁ", + "ぇ", + "ぺ", + "ゞ", + "ぢ", + "ぉ", + "ぅ", + "ゐ", + "ゝ", + "ゑ", + "゛", + "゜", + "ゎ", + "ゔ", + "゚", + "ゟ", + "゙", + "ゕ", + "ゖ", + ], + "Portuguese": [ + "a", + "e", + "o", + "s", + "i", + "r", + "d", + "n", + "t", + "m", + "u", + "c", + "l", + "p", + "g", + "v", + "b", + "f", + "h", + "ã", + "q", + "é", + "ç", + "á", + "z", + "í", + ], + "Swedish": [ + "e", + "a", + "n", + "r", + "t", + "s", + "i", + "l", + "d", + "o", + "m", + "k", + "g", + "v", + "h", + "f", + "u", + "p", + "ä", + "c", + "b", + "ö", + "å", + "y", + "j", + "x", + ], + "Chinese": [ + "的", + "一", + "是", + "不", + "了", + "在", + "人", + "有", + "我", + "他", + "这", + "个", + "们", + "中", + "来", + "上", + "大", + "为", + "和", + "国", + "地", + "到", + "以", + "说", + "时", + "要", + "就", + "出", + "会", + "可", + "也", + "你", + "对", + "生", + "能", + "而", + "子", + "那", + "得", + "于", + "着", + "下", + "自", + "之", + "年", + "过", + "发", + "后", + "作", + "里", + "用", + "道", + "行", + "所", + "然", + "家", + "种", + "事", + "成", + "方", + "多", + "经", + "么", + "去", + "法", + "学", + "如", + "都", + "同", + "现", + "当", + "没", + "动", + "面", + "起", + "看", + "定", + "天", + "分", + "还", + "进", + "好", + "小", + "部", + "其", + "些", + "主", + "样", + "理", + "心", + "她", + "本", + "前", + "开", + "但", + "因", + "只", + "从", + "想", + "实", + ], + "Ukrainian": [ + "о", + "а", + "н", + "і", + "и", + "р", + "в", + "т", + "е", + "с", + "к", + "л", + "у", + "д", + "м", + "п", + "з", + "я", + "ь", + "б", + "г", + "й", + "ч", + "х", + "ц", + "ї", + ], + "Norwegian": [ + "e", + "r", + "n", + "t", + "a", + "s", + "i", + "o", + "l", + "d", + "g", + "k", + "m", + "v", + "f", + "p", + "u", + "b", + "h", + "å", + "y", + "j", + "ø", + "c", + "æ", + "w", + ], + "Finnish": [ + "a", + "i", + "n", + "t", + "e", + "s", + "l", + "o", + "u", + "k", + "ä", + "m", + "r", + "v", + "j", + "h", + "p", + "y", + "d", + "ö", + "g", + "c", + "b", + "f", + "w", + "z", + ], + "Vietnamese": [ + "n", + "h", + "t", + "i", + "c", + "g", + "a", + "o", + "u", + "m", + "l", + "r", + "à", + "đ", + "s", + "e", + "v", + "p", + "b", + "y", + "ư", + "d", + "á", + "k", + "ộ", + "ế", + ], + "Czech": [ + "o", + "e", + "a", + "n", + "t", + "s", + "i", + "l", + "v", + "r", + "k", + "d", + "u", + "m", + "p", + "í", + "c", + "h", + "z", + "á", + "y", + "j", + "b", + "ě", + "é", + "ř", + ], + "Hungarian": [ + "e", + "a", + "t", + "l", + "s", + "n", + "k", + "r", + "i", + "o", + "z", + "á", + "é", + "g", + "m", + "b", + "y", + "v", + "d", + "h", + "u", + "p", + "j", + "ö", + "f", + "c", + ], + "Korean": [ + "이", + "다", + "에", + "의", + "는", + "로", + "하", + "을", + "가", + "고", + "지", + "서", + "한", + "은", + "기", + "으", + "년", + "대", + "사", + "시", + "를", + "리", + "도", + "인", + "스", + "일", + ], + "Indonesian": [ + "a", + "n", + "e", + "i", + "r", + "t", + "u", + "s", + "d", + "k", + "m", + "l", + "g", + "p", + "b", + "o", + "h", + "y", + "j", + "c", + "w", + "f", + "v", + "z", + "x", + "q", + ], + "Turkish": [ + "a", + "e", + "i", + "n", + "r", + "l", + "ı", + "k", + "d", + "t", + "s", + "m", + "y", + "u", + "o", + "b", + "ü", + "ş", + "v", + "g", + "z", + "h", + "c", + "p", + "ç", + "ğ", + ], + "Romanian": [ + "e", + "i", + "a", + "r", + "n", + "t", + "u", + "l", + "o", + "c", + "s", + "d", + "p", + "m", + "ă", + "f", + "v", + "î", + "g", + "b", + "ș", + "ț", + "z", + "h", + "â", + "j", + ], + "Farsi": [ + "ا", + "ی", + "ر", + "د", + "ن", + "ه", + "و", + "م", + "ت", + "ب", + "س", + "ل", + "ک", + "ش", + "ز", + "ف", + "گ", + "ع", + "خ", + "ق", + "ج", + "آ", + "پ", + "ح", + "ط", + "ص", + ], + "Arabic": [ + "ا", + "ل", + "ي", + "م", + "و", + "ن", + "ر", + "ت", + "ب", + "ة", + "ع", + "د", + "س", + "ف", + "ه", + "ك", + "ق", + "أ", + "ح", + "ج", + "ش", + "ط", + "ص", + "ى", + "خ", + "إ", + ], + "Danish": [ + "e", + "r", + "n", + "t", + "a", + "i", + "s", + "d", + "l", + "o", + "g", + "m", + "k", + "f", + "v", + "u", + "b", + "h", + "p", + "å", + "y", + "ø", + "æ", + "c", + "j", + "w", + ], + "Serbian": [ + "а", + "и", + "о", + "е", + "н", + "р", + "с", + "у", + "т", + "к", + "ј", + "в", + "д", + "м", + "п", + "л", + "г", + "з", + "б", + "a", + "i", + "e", + "o", + "n", + "ц", + "ш", + ], + "Lithuanian": [ + "i", + "a", + "s", + "o", + "r", + "e", + "t", + "n", + "u", + "k", + "m", + "l", + "p", + "v", + "d", + "j", + "g", + "ė", + "b", + "y", + "ų", + "š", + "ž", + "c", + "ą", + "į", + ], + "Slovene": [ + "e", + "a", + "i", + "o", + "n", + "r", + "s", + "l", + "t", + "j", + "v", + "k", + "d", + "p", + "m", + "u", + "z", + "b", + "g", + "h", + "č", + "c", + "š", + "ž", + "f", + "y", + ], + "Slovak": [ + "o", + "a", + "e", + "n", + "i", + "r", + "v", + "t", + "s", + "l", + "k", + "d", + "m", + "p", + "u", + "c", + "h", + "j", + "b", + "z", + "á", + "y", + "ý", + "í", + "č", + "é", + ], + "Hebrew": [ + "י", + "ו", + "ה", + "ל", + "ר", + "ב", + "ת", + "מ", + "א", + "ש", + "נ", + "ע", + "ם", + "ד", + "ק", + "ח", + "פ", + "ס", + "כ", + "ג", + "ט", + "צ", + "ן", + "ז", + "ך", + ], + "Bulgarian": [ + "а", + "и", + "о", + "е", + "н", + "т", + "р", + "с", + "в", + "л", + "к", + "д", + "п", + "м", + "з", + "г", + "я", + "ъ", + "у", + "б", + "ч", + "ц", + "й", + "ж", + "щ", + "х", + ], + "Croatian": [ + "a", + "i", + "o", + "e", + "n", + "r", + "j", + "s", + "t", + "u", + "k", + "l", + "v", + "d", + "m", + "p", + "g", + "z", + "b", + "c", + "č", + "h", + "š", + "ž", + "ć", + "f", + ], + "Hindi": [ + "क", + "र", + "स", + "न", + "त", + "म", + "ह", + "प", + "य", + "ल", + "व", + "ज", + "द", + "ग", + "ब", + "श", + "ट", + "अ", + "ए", + "थ", + "भ", + "ड", + "च", + "ध", + "ष", + "इ", + ], + "Estonian": [ + "a", + "i", + "e", + "s", + "t", + "l", + "u", + "n", + "o", + "k", + "r", + "d", + "m", + "v", + "g", + "p", + "j", + "h", + "ä", + "b", + "õ", + "ü", + "f", + "c", + "ö", + "y", + ], + "Thai": [ + "า", + "น", + "ร", + "อ", + "ก", + "เ", + "ง", + "ม", + "ย", + "ล", + "ว", + "ด", + "ท", + "ส", + "ต", + "ะ", + "ป", + "บ", + "ค", + "ห", + "แ", + "จ", + "พ", + "ช", + "ข", + "ใ", + ], + "Greek": [ + "α", + "τ", + "ο", + "ι", + "ε", + "ν", + "ρ", + "σ", + "κ", + "η", + "π", + "ς", + "υ", + "μ", + "λ", + "ί", + "ό", + "ά", + "γ", + "έ", + "δ", + "ή", + "ω", + "χ", + "θ", + "ύ", + ], + "Tamil": [ + "க", + "த", + "ப", + "ட", + "ர", + "ம", + "ல", + "ன", + "வ", + "ற", + "ய", + "ள", + "ச", + "ந", + "இ", + "ண", + "அ", + "ஆ", + "ழ", + "ங", + "எ", + "உ", + "ஒ", + "ஸ", + ], + "Kazakh": [ + "а", + "ы", + "е", + "н", + "т", + "р", + "л", + "і", + "д", + "с", + "м", + "қ", + "к", + "о", + "б", + "и", + "у", + "ғ", + "ж", + "ң", + "з", + "ш", + "й", + "п", + "г", + "ө", + ], +} + +LANGUAGE_SUPPORTED_COUNT: int = len(FREQUENCIES) diff --git a/.venv/lib/python3.12/site-packages/charset_normalizer/legacy.py b/.venv/lib/python3.12/site-packages/charset_normalizer/legacy.py new file mode 100644 index 0000000..43aad21 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/charset_normalizer/legacy.py @@ -0,0 +1,54 @@ +from typing import Any, Dict, Optional, Union +from warnings import warn + +from .api import from_bytes +from .constant import CHARDET_CORRESPONDENCE + + +def detect( + byte_str: bytes, should_rename_legacy: bool = False, **kwargs: Any +) -> Dict[str, Optional[Union[str, float]]]: + """ + chardet legacy method + Detect the encoding of the given byte string. It should be mostly backward-compatible. + Encoding name will match Chardet own writing whenever possible. (Not on encoding name unsupported by it) + This function is deprecated and should be used to migrate your project easily, consult the documentation for + further information. Not planned for removal. + + :param byte_str: The byte sequence to examine. + :param should_rename_legacy: Should we rename legacy encodings + to their more modern equivalents? + """ + if len(kwargs): + warn( + f"charset-normalizer disregard arguments '{','.join(list(kwargs.keys()))}' in legacy function detect()" + ) + + if not isinstance(byte_str, (bytearray, bytes)): + raise TypeError( # pragma: nocover + "Expected object of type bytes or bytearray, got: " + "{0}".format(type(byte_str)) + ) + + if isinstance(byte_str, bytearray): + byte_str = bytes(byte_str) + + r = from_bytes(byte_str).best() + + encoding = r.encoding if r is not None else None + language = r.language if r is not None and r.language != "Unknown" else "" + confidence = 1.0 - r.chaos if r is not None else None + + # Note: CharsetNormalizer does not return 'UTF-8-SIG' as the sig get stripped in the detection/normalization process + # but chardet does return 'utf-8-sig' and it is a valid codec name. + if r is not None and encoding == "utf_8" and r.bom: + encoding += "_sig" + + if should_rename_legacy is False and encoding in CHARDET_CORRESPONDENCE: + encoding = CHARDET_CORRESPONDENCE[encoding] + + return { + "encoding": encoding, + "language": language, + "confidence": confidence, + } diff --git a/.venv/lib/python3.12/site-packages/charset_normalizer/md.cpython-312-x86_64-linux-gnu.so b/.venv/lib/python3.12/site-packages/charset_normalizer/md.cpython-312-x86_64-linux-gnu.so new file mode 100755 index 0000000000000000000000000000000000000000..3d0b46ae77baa966a03418d61fbd1da9d141366e GIT binary patch literal 16064 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/charset_normalizer/md.py b/.venv/lib/python3.12/site-packages/charset_normalizer/md.py new file mode 100644 index 0000000..77897aa --- /dev/null +++ b/.venv/lib/python3.12/site-packages/charset_normalizer/md.py @@ -0,0 +1,615 @@ +from functools import lru_cache +from logging import getLogger +from typing import List, Optional + +from .constant import ( + COMMON_SAFE_ASCII_CHARACTERS, + TRACE, + UNICODE_SECONDARY_RANGE_KEYWORD, +) +from .utils import ( + is_accentuated, + is_arabic, + is_arabic_isolated_form, + is_case_variable, + is_cjk, + is_emoticon, + is_hangul, + is_hiragana, + is_katakana, + is_latin, + is_punctuation, + is_separator, + is_symbol, + is_thai, + is_unprintable, + remove_accent, + unicode_range, +) + + +class MessDetectorPlugin: + """ + Base abstract class used for mess detection plugins. + All detectors MUST extend and implement given methods. + """ + + def eligible(self, character: str) -> bool: + """ + Determine if given character should be fed in. + """ + raise NotImplementedError # pragma: nocover + + def feed(self, character: str) -> None: + """ + The main routine to be executed upon character. + Insert the logic in witch the text would be considered chaotic. + """ + raise NotImplementedError # pragma: nocover + + def reset(self) -> None: # pragma: no cover + """ + Permit to reset the plugin to the initial state. + """ + raise NotImplementedError + + @property + def ratio(self) -> float: + """ + Compute the chaos ratio based on what your feed() has seen. + Must NOT be lower than 0.; No restriction gt 0. + """ + raise NotImplementedError # pragma: nocover + + +class TooManySymbolOrPunctuationPlugin(MessDetectorPlugin): + def __init__(self) -> None: + self._punctuation_count: int = 0 + self._symbol_count: int = 0 + self._character_count: int = 0 + + self._last_printable_char: Optional[str] = None + self._frenzy_symbol_in_word: bool = False + + def eligible(self, character: str) -> bool: + return character.isprintable() + + def feed(self, character: str) -> None: + self._character_count += 1 + + if ( + character != self._last_printable_char + and character not in COMMON_SAFE_ASCII_CHARACTERS + ): + if is_punctuation(character): + self._punctuation_count += 1 + elif ( + character.isdigit() is False + and is_symbol(character) + and is_emoticon(character) is False + ): + self._symbol_count += 2 + + self._last_printable_char = character + + def reset(self) -> None: # pragma: no cover + self._punctuation_count = 0 + self._character_count = 0 + self._symbol_count = 0 + + @property + def ratio(self) -> float: + if self._character_count == 0: + return 0.0 + + ratio_of_punctuation: float = ( + self._punctuation_count + self._symbol_count + ) / self._character_count + + return ratio_of_punctuation if ratio_of_punctuation >= 0.3 else 0.0 + + +class TooManyAccentuatedPlugin(MessDetectorPlugin): + def __init__(self) -> None: + self._character_count: int = 0 + self._accentuated_count: int = 0 + + def eligible(self, character: str) -> bool: + return character.isalpha() + + def feed(self, character: str) -> None: + self._character_count += 1 + + if is_accentuated(character): + self._accentuated_count += 1 + + def reset(self) -> None: # pragma: no cover + self._character_count = 0 + self._accentuated_count = 0 + + @property + def ratio(self) -> float: + if self._character_count < 8: + return 0.0 + + ratio_of_accentuation: float = self._accentuated_count / self._character_count + return ratio_of_accentuation if ratio_of_accentuation >= 0.35 else 0.0 + + +class UnprintablePlugin(MessDetectorPlugin): + def __init__(self) -> None: + self._unprintable_count: int = 0 + self._character_count: int = 0 + + def eligible(self, character: str) -> bool: + return True + + def feed(self, character: str) -> None: + if is_unprintable(character): + self._unprintable_count += 1 + self._character_count += 1 + + def reset(self) -> None: # pragma: no cover + self._unprintable_count = 0 + + @property + def ratio(self) -> float: + if self._character_count == 0: + return 0.0 + + return (self._unprintable_count * 8) / self._character_count + + +class SuspiciousDuplicateAccentPlugin(MessDetectorPlugin): + def __init__(self) -> None: + self._successive_count: int = 0 + self._character_count: int = 0 + + self._last_latin_character: Optional[str] = None + + def eligible(self, character: str) -> bool: + return character.isalpha() and is_latin(character) + + def feed(self, character: str) -> None: + self._character_count += 1 + if ( + self._last_latin_character is not None + and is_accentuated(character) + and is_accentuated(self._last_latin_character) + ): + if character.isupper() and self._last_latin_character.isupper(): + self._successive_count += 1 + # Worse if its the same char duplicated with different accent. + if remove_accent(character) == remove_accent(self._last_latin_character): + self._successive_count += 1 + self._last_latin_character = character + + def reset(self) -> None: # pragma: no cover + self._successive_count = 0 + self._character_count = 0 + self._last_latin_character = None + + @property + def ratio(self) -> float: + if self._character_count == 0: + return 0.0 + + return (self._successive_count * 2) / self._character_count + + +class SuspiciousRange(MessDetectorPlugin): + def __init__(self) -> None: + self._suspicious_successive_range_count: int = 0 + self._character_count: int = 0 + self._last_printable_seen: Optional[str] = None + + def eligible(self, character: str) -> bool: + return character.isprintable() + + def feed(self, character: str) -> None: + self._character_count += 1 + + if ( + character.isspace() + or is_punctuation(character) + or character in COMMON_SAFE_ASCII_CHARACTERS + ): + self._last_printable_seen = None + return + + if self._last_printable_seen is None: + self._last_printable_seen = character + return + + unicode_range_a: Optional[str] = unicode_range(self._last_printable_seen) + unicode_range_b: Optional[str] = unicode_range(character) + + if is_suspiciously_successive_range(unicode_range_a, unicode_range_b): + self._suspicious_successive_range_count += 1 + + self._last_printable_seen = character + + def reset(self) -> None: # pragma: no cover + self._character_count = 0 + self._suspicious_successive_range_count = 0 + self._last_printable_seen = None + + @property + def ratio(self) -> float: + if self._character_count <= 24: + return 0.0 + + ratio_of_suspicious_range_usage: float = ( + self._suspicious_successive_range_count * 2 + ) / self._character_count + + return ratio_of_suspicious_range_usage + + +class SuperWeirdWordPlugin(MessDetectorPlugin): + def __init__(self) -> None: + self._word_count: int = 0 + self._bad_word_count: int = 0 + self._foreign_long_count: int = 0 + + self._is_current_word_bad: bool = False + self._foreign_long_watch: bool = False + + self._character_count: int = 0 + self._bad_character_count: int = 0 + + self._buffer: str = "" + self._buffer_accent_count: int = 0 + + def eligible(self, character: str) -> bool: + return True + + def feed(self, character: str) -> None: + if character.isalpha(): + self._buffer += character + if is_accentuated(character): + self._buffer_accent_count += 1 + if ( + self._foreign_long_watch is False + and (is_latin(character) is False or is_accentuated(character)) + and is_cjk(character) is False + and is_hangul(character) is False + and is_katakana(character) is False + and is_hiragana(character) is False + and is_thai(character) is False + ): + self._foreign_long_watch = True + return + if not self._buffer: + return + if ( + character.isspace() or is_punctuation(character) or is_separator(character) + ) and self._buffer: + self._word_count += 1 + buffer_length: int = len(self._buffer) + + self._character_count += buffer_length + + if buffer_length >= 4: + if self._buffer_accent_count / buffer_length > 0.34: + self._is_current_word_bad = True + # Word/Buffer ending with an upper case accentuated letter are so rare, + # that we will consider them all as suspicious. Same weight as foreign_long suspicious. + if ( + is_accentuated(self._buffer[-1]) + and self._buffer[-1].isupper() + and all(_.isupper() for _ in self._buffer) is False + ): + self._foreign_long_count += 1 + self._is_current_word_bad = True + if buffer_length >= 24 and self._foreign_long_watch: + camel_case_dst = [ + i + for c, i in zip(self._buffer, range(0, buffer_length)) + if c.isupper() + ] + probable_camel_cased: bool = False + + if camel_case_dst and (len(camel_case_dst) / buffer_length <= 0.3): + probable_camel_cased = True + + if not probable_camel_cased: + self._foreign_long_count += 1 + self._is_current_word_bad = True + + if self._is_current_word_bad: + self._bad_word_count += 1 + self._bad_character_count += len(self._buffer) + self._is_current_word_bad = False + + self._foreign_long_watch = False + self._buffer = "" + self._buffer_accent_count = 0 + elif ( + character not in {"<", ">", "-", "=", "~", "|", "_"} + and character.isdigit() is False + and is_symbol(character) + ): + self._is_current_word_bad = True + self._buffer += character + + def reset(self) -> None: # pragma: no cover + self._buffer = "" + self._is_current_word_bad = False + self._foreign_long_watch = False + self._bad_word_count = 0 + self._word_count = 0 + self._character_count = 0 + self._bad_character_count = 0 + self._foreign_long_count = 0 + + @property + def ratio(self) -> float: + if self._word_count <= 10 and self._foreign_long_count == 0: + return 0.0 + + return self._bad_character_count / self._character_count + + +class CjkInvalidStopPlugin(MessDetectorPlugin): + """ + GB(Chinese) based encoding often render the stop incorrectly when the content does not fit and + can be easily detected. Searching for the overuse of '丅' and '丄'. + """ + + def __init__(self) -> None: + self._wrong_stop_count: int = 0 + self._cjk_character_count: int = 0 + + def eligible(self, character: str) -> bool: + return True + + def feed(self, character: str) -> None: + if character in {"丅", "丄"}: + self._wrong_stop_count += 1 + return + if is_cjk(character): + self._cjk_character_count += 1 + + def reset(self) -> None: # pragma: no cover + self._wrong_stop_count = 0 + self._cjk_character_count = 0 + + @property + def ratio(self) -> float: + if self._cjk_character_count < 16: + return 0.0 + return self._wrong_stop_count / self._cjk_character_count + + +class ArchaicUpperLowerPlugin(MessDetectorPlugin): + def __init__(self) -> None: + self._buf: bool = False + + self._character_count_since_last_sep: int = 0 + + self._successive_upper_lower_count: int = 0 + self._successive_upper_lower_count_final: int = 0 + + self._character_count: int = 0 + + self._last_alpha_seen: Optional[str] = None + self._current_ascii_only: bool = True + + def eligible(self, character: str) -> bool: + return True + + def feed(self, character: str) -> None: + is_concerned = character.isalpha() and is_case_variable(character) + chunk_sep = is_concerned is False + + if chunk_sep and self._character_count_since_last_sep > 0: + if ( + self._character_count_since_last_sep <= 64 + and character.isdigit() is False + and self._current_ascii_only is False + ): + self._successive_upper_lower_count_final += ( + self._successive_upper_lower_count + ) + + self._successive_upper_lower_count = 0 + self._character_count_since_last_sep = 0 + self._last_alpha_seen = None + self._buf = False + self._character_count += 1 + self._current_ascii_only = True + + return + + if self._current_ascii_only is True and character.isascii() is False: + self._current_ascii_only = False + + if self._last_alpha_seen is not None: + if (character.isupper() and self._last_alpha_seen.islower()) or ( + character.islower() and self._last_alpha_seen.isupper() + ): + if self._buf is True: + self._successive_upper_lower_count += 2 + self._buf = False + else: + self._buf = True + else: + self._buf = False + + self._character_count += 1 + self._character_count_since_last_sep += 1 + self._last_alpha_seen = character + + def reset(self) -> None: # pragma: no cover + self._character_count = 0 + self._character_count_since_last_sep = 0 + self._successive_upper_lower_count = 0 + self._successive_upper_lower_count_final = 0 + self._last_alpha_seen = None + self._buf = False + self._current_ascii_only = True + + @property + def ratio(self) -> float: + if self._character_count == 0: + return 0.0 + + return self._successive_upper_lower_count_final / self._character_count + + +class ArabicIsolatedFormPlugin(MessDetectorPlugin): + def __init__(self) -> None: + self._character_count: int = 0 + self._isolated_form_count: int = 0 + + def reset(self) -> None: # pragma: no cover + self._character_count = 0 + self._isolated_form_count = 0 + + def eligible(self, character: str) -> bool: + return is_arabic(character) + + def feed(self, character: str) -> None: + self._character_count += 1 + + if is_arabic_isolated_form(character): + self._isolated_form_count += 1 + + @property + def ratio(self) -> float: + if self._character_count < 8: + return 0.0 + + isolated_form_usage: float = self._isolated_form_count / self._character_count + + return isolated_form_usage + + +@lru_cache(maxsize=1024) +def is_suspiciously_successive_range( + unicode_range_a: Optional[str], unicode_range_b: Optional[str] +) -> bool: + """ + Determine if two Unicode range seen next to each other can be considered as suspicious. + """ + if unicode_range_a is None or unicode_range_b is None: + return True + + if unicode_range_a == unicode_range_b: + return False + + if "Latin" in unicode_range_a and "Latin" in unicode_range_b: + return False + + if "Emoticons" in unicode_range_a or "Emoticons" in unicode_range_b: + return False + + # Latin characters can be accompanied with a combining diacritical mark + # eg. Vietnamese. + if ("Latin" in unicode_range_a or "Latin" in unicode_range_b) and ( + "Combining" in unicode_range_a or "Combining" in unicode_range_b + ): + return False + + keywords_range_a, keywords_range_b = unicode_range_a.split( + " " + ), unicode_range_b.split(" ") + + for el in keywords_range_a: + if el in UNICODE_SECONDARY_RANGE_KEYWORD: + continue + if el in keywords_range_b: + return False + + # Japanese Exception + range_a_jp_chars, range_b_jp_chars = ( + unicode_range_a + in ( + "Hiragana", + "Katakana", + ), + unicode_range_b in ("Hiragana", "Katakana"), + ) + if (range_a_jp_chars or range_b_jp_chars) and ( + "CJK" in unicode_range_a or "CJK" in unicode_range_b + ): + return False + if range_a_jp_chars and range_b_jp_chars: + return False + + if "Hangul" in unicode_range_a or "Hangul" in unicode_range_b: + if "CJK" in unicode_range_a or "CJK" in unicode_range_b: + return False + if unicode_range_a == "Basic Latin" or unicode_range_b == "Basic Latin": + return False + + # Chinese/Japanese use dedicated range for punctuation and/or separators. + if ("CJK" in unicode_range_a or "CJK" in unicode_range_b) or ( + unicode_range_a in ["Katakana", "Hiragana"] + and unicode_range_b in ["Katakana", "Hiragana"] + ): + if "Punctuation" in unicode_range_a or "Punctuation" in unicode_range_b: + return False + if "Forms" in unicode_range_a or "Forms" in unicode_range_b: + return False + if unicode_range_a == "Basic Latin" or unicode_range_b == "Basic Latin": + return False + + return True + + +@lru_cache(maxsize=2048) +def mess_ratio( + decoded_sequence: str, maximum_threshold: float = 0.2, debug: bool = False +) -> float: + """ + Compute a mess ratio given a decoded bytes sequence. The maximum threshold does stop the computation earlier. + """ + + detectors: List[MessDetectorPlugin] = [ + md_class() for md_class in MessDetectorPlugin.__subclasses__() + ] + + length: int = len(decoded_sequence) + 1 + + mean_mess_ratio: float = 0.0 + + if length < 512: + intermediary_mean_mess_ratio_calc: int = 32 + elif length <= 1024: + intermediary_mean_mess_ratio_calc = 64 + else: + intermediary_mean_mess_ratio_calc = 128 + + for character, index in zip(decoded_sequence + "\n", range(length)): + for detector in detectors: + if detector.eligible(character): + detector.feed(character) + + if ( + index > 0 and index % intermediary_mean_mess_ratio_calc == 0 + ) or index == length - 1: + mean_mess_ratio = sum(dt.ratio for dt in detectors) + + if mean_mess_ratio >= maximum_threshold: + break + + if debug: + logger = getLogger("charset_normalizer") + + logger.log( + TRACE, + "Mess-detector extended-analysis start. " + f"intermediary_mean_mess_ratio_calc={intermediary_mean_mess_ratio_calc} mean_mess_ratio={mean_mess_ratio} " + f"maximum_threshold={maximum_threshold}", + ) + + if len(decoded_sequence) > 16: + logger.log(TRACE, f"Starting with: {decoded_sequence[:16]}") + logger.log(TRACE, f"Ending with: {decoded_sequence[-16::]}") + + for dt in detectors: # pragma: nocover + logger.log(TRACE, f"{dt.__class__}: {dt.ratio}") + + return round(mean_mess_ratio, 3) diff --git a/.venv/lib/python3.12/site-packages/charset_normalizer/md__mypyc.cpython-312-x86_64-linux-gnu.so b/.venv/lib/python3.12/site-packages/charset_normalizer/md__mypyc.cpython-312-x86_64-linux-gnu.so new file mode 100755 index 0000000000000000000000000000000000000000..e3044d9abd70dd87a4a1262fa53e3fb0b434d993 GIT binary patch literal 272640 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

Ude%8yZ^!Z|lc9jdo}U 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

GL>E3U8;wWJxulxD51)p=PryE4$P% zs%0}?ob3#fGjRy%k-xeJvTSh;3lozVly=?)q_TonL@g* ze2n|#N#`C9YD2hsvuy^cQJD1JXeTD%k|kwid`C9q{Z%UrPJG_Xl<`Q{lBSvQH+vHy zdzv(c34=Y~8e@g%oWohrO8CC7xI|@RpFX9um+Hz-(a*ut)w!e;PL^)%%P~%33u9S~ z{z6sacdSS6KFW3nWFWWcU}HJ7Ub-!_{xGAb|(*%V&V7?W*&Jr!iBkayi{#PnSt<)&VvkE&*PnX6}*e$J~O%<^aHupDPmdL74; zcKQjQxbT5%>4gvaFXMOST2Gb>xJ|!oR}rUG{w5_k^}duyXxGe~BQRfi$FbbW%`{Zg z?TxKT+Lr0zLPMgtO(Y~wUgovSsQS+pnPJ(jZ_#Z*&z#j%uMszDs{7SFg388N4=xGw zWK8)(U61T(aqzI)32Gzf{C;Vd@;ue27nm&mwhvidp{u)7jO7MiE5efq(}8K*7r9 z1lz2qMGRsQY$9TDC_*|tbB7nmUCvyD1RD#BU=?g^QwBQ=t%F$Dd8CjuLa?y1v9Yi) ze(&d-ot@lCaAEJw%+5D6JM-qv-@CU_&Wf}G>svWdIeKWLT4#9Oaf|{vANiq_He6;a zO}oxW7U70~3VP8cL}e&%nF3B(x22q7+r_>G@h=r6EiOWXv!g`x;UiAImB);TG9l<1r6lqdKS5xlYZ?nsLdI z%3|)fr7I>sE0XpUK0>8Qg<)QHWx6tli~Ib_+=!whhKlbBS7_R{$S=zxt>kB=3D4`4 zVPq>%ocq3_?h8w?4j*!2AkuPUGTK1J;V4BH)+#v;j}(%IH2#rCco`X}NZIaVPY!&j zg(~?@(nQHdv9Z2}^+)s~&P7mUV>FssflahzT!NB^R*NxJ_CB$fLlL&UlBu!) z!6}33BV`M{vf{7;i>lnA7_4_;Z4GpF#b}2voWZw?$GxY8tnyn^i>;u(j+|c=t@R#| zMlq7=6Pclkl3wb0fM+Z1rKSMf)yD+ASQJ@YtjbcW5Uoo*TZXBbW+>VnSFi81fThn6 zrjl<6x&On+m;O{@(7l1pC+s&y4|NKg% zm$G!-++_?c;QDoNuuQyvHXxAJPgv9mN6@}36Ts(t!b#l3Z=SLzq+77VDVO9cmJ5le zy~bIDN!rBAcO2v*{W4{K{+jhe`a*zN+;EVT|5(?ak10cZ+^4*q*vcnTZ}lS`Xa-Bd~G#J3d^gN z%bPQXy@X40VEuxtiU{N54qAAptjCw|}Y`;OoC>O>U1YEDT$!y&v! z{Kjo_ZCp1x^yX*1vE1Z?Jz&%P=kFM9{)W+QBg`)HKhyb|;X}g#vqo=a3`891_Y6<_ z=?~p5`u23pS{=2jH~fHK(qb`dv{U=sLORUIaW$tTKjDz~uQR~uq~kAV;a;7Jkw@as znn)2dj&IymZxA_f50P0M%3rA-mfd37@5Zi$K7$?E^kV)DI}67s{KQ3T@!yQ-G{^r1 DNR#cw literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/charset_normalizer/models.py b/.venv/lib/python3.12/site-packages/charset_normalizer/models.py new file mode 100644 index 0000000..a760b9c --- /dev/null +++ b/.venv/lib/python3.12/site-packages/charset_normalizer/models.py @@ -0,0 +1,340 @@ +from encodings.aliases import aliases +from hashlib import sha256 +from json import dumps +from typing import Any, Dict, Iterator, List, Optional, Tuple, Union + +from .constant import TOO_BIG_SEQUENCE +from .utils import iana_name, is_multi_byte_encoding, unicode_range + + +class CharsetMatch: + def __init__( + self, + payload: bytes, + guessed_encoding: str, + mean_mess_ratio: float, + has_sig_or_bom: bool, + languages: "CoherenceMatches", + decoded_payload: Optional[str] = None, + ): + self._payload: bytes = payload + + self._encoding: str = guessed_encoding + self._mean_mess_ratio: float = mean_mess_ratio + self._languages: CoherenceMatches = languages + self._has_sig_or_bom: bool = has_sig_or_bom + self._unicode_ranges: Optional[List[str]] = None + + self._leaves: List[CharsetMatch] = [] + self._mean_coherence_ratio: float = 0.0 + + self._output_payload: Optional[bytes] = None + self._output_encoding: Optional[str] = None + + self._string: Optional[str] = decoded_payload + + def __eq__(self, other: object) -> bool: + if not isinstance(other, CharsetMatch): + raise TypeError( + "__eq__ cannot be invoked on {} and {}.".format( + str(other.__class__), str(self.__class__) + ) + ) + return self.encoding == other.encoding and self.fingerprint == other.fingerprint + + def __lt__(self, other: object) -> bool: + """ + Implemented to make sorted available upon CharsetMatches items. + """ + if not isinstance(other, CharsetMatch): + raise ValueError + + chaos_difference: float = abs(self.chaos - other.chaos) + coherence_difference: float = abs(self.coherence - other.coherence) + + # Below 1% difference --> Use Coherence + if chaos_difference < 0.01 and coherence_difference > 0.02: + return self.coherence > other.coherence + elif chaos_difference < 0.01 and coherence_difference <= 0.02: + # When having a difficult decision, use the result that decoded as many multi-byte as possible. + # preserve RAM usage! + if len(self._payload) >= TOO_BIG_SEQUENCE: + return self.chaos < other.chaos + return self.multi_byte_usage > other.multi_byte_usage + + return self.chaos < other.chaos + + @property + def multi_byte_usage(self) -> float: + return 1.0 - (len(str(self)) / len(self.raw)) + + def __str__(self) -> str: + # Lazy Str Loading + if self._string is None: + self._string = str(self._payload, self._encoding, "strict") + return self._string + + def __repr__(self) -> str: + return "".format(self.encoding, self.fingerprint) + + def add_submatch(self, other: "CharsetMatch") -> None: + if not isinstance(other, CharsetMatch) or other == self: + raise ValueError( + "Unable to add instance <{}> as a submatch of a CharsetMatch".format( + other.__class__ + ) + ) + + other._string = None # Unload RAM usage; dirty trick. + self._leaves.append(other) + + @property + def encoding(self) -> str: + return self._encoding + + @property + def encoding_aliases(self) -> List[str]: + """ + Encoding name are known by many name, using this could help when searching for IBM855 when it's listed as CP855. + """ + also_known_as: List[str] = [] + for u, p in aliases.items(): + if self.encoding == u: + also_known_as.append(p) + elif self.encoding == p: + also_known_as.append(u) + return also_known_as + + @property + def bom(self) -> bool: + return self._has_sig_or_bom + + @property + def byte_order_mark(self) -> bool: + return self._has_sig_or_bom + + @property + def languages(self) -> List[str]: + """ + Return the complete list of possible languages found in decoded sequence. + Usually not really useful. Returned list may be empty even if 'language' property return something != 'Unknown'. + """ + return [e[0] for e in self._languages] + + @property + def language(self) -> str: + """ + Most probable language found in decoded sequence. If none were detected or inferred, the property will return + "Unknown". + """ + if not self._languages: + # Trying to infer the language based on the given encoding + # Its either English or we should not pronounce ourselves in certain cases. + if "ascii" in self.could_be_from_charset: + return "English" + + # doing it there to avoid circular import + from charset_normalizer.cd import encoding_languages, mb_encoding_languages + + languages = ( + mb_encoding_languages(self.encoding) + if is_multi_byte_encoding(self.encoding) + else encoding_languages(self.encoding) + ) + + if len(languages) == 0 or "Latin Based" in languages: + return "Unknown" + + return languages[0] + + return self._languages[0][0] + + @property + def chaos(self) -> float: + return self._mean_mess_ratio + + @property + def coherence(self) -> float: + if not self._languages: + return 0.0 + return self._languages[0][1] + + @property + def percent_chaos(self) -> float: + return round(self.chaos * 100, ndigits=3) + + @property + def percent_coherence(self) -> float: + return round(self.coherence * 100, ndigits=3) + + @property + def raw(self) -> bytes: + """ + Original untouched bytes. + """ + return self._payload + + @property + def submatch(self) -> List["CharsetMatch"]: + return self._leaves + + @property + def has_submatch(self) -> bool: + return len(self._leaves) > 0 + + @property + def alphabets(self) -> List[str]: + if self._unicode_ranges is not None: + return self._unicode_ranges + # list detected ranges + detected_ranges: List[Optional[str]] = [ + unicode_range(char) for char in str(self) + ] + # filter and sort + self._unicode_ranges = sorted(list({r for r in detected_ranges if r})) + return self._unicode_ranges + + @property + def could_be_from_charset(self) -> List[str]: + """ + The complete list of encoding that output the exact SAME str result and therefore could be the originating + encoding. + This list does include the encoding available in property 'encoding'. + """ + return [self._encoding] + [m.encoding for m in self._leaves] + + def output(self, encoding: str = "utf_8") -> bytes: + """ + Method to get re-encoded bytes payload using given target encoding. Default to UTF-8. + Any errors will be simply ignored by the encoder NOT replaced. + """ + if self._output_encoding is None or self._output_encoding != encoding: + self._output_encoding = encoding + self._output_payload = str(self).encode(encoding, "replace") + + return self._output_payload # type: ignore + + @property + def fingerprint(self) -> str: + """ + Retrieve the unique SHA256 computed using the transformed (re-encoded) payload. Not the original one. + """ + return sha256(self.output()).hexdigest() + + +class CharsetMatches: + """ + Container with every CharsetMatch items ordered by default from most probable to the less one. + Act like a list(iterable) but does not implements all related methods. + """ + + def __init__(self, results: Optional[List[CharsetMatch]] = None): + self._results: List[CharsetMatch] = sorted(results) if results else [] + + def __iter__(self) -> Iterator[CharsetMatch]: + yield from self._results + + def __getitem__(self, item: Union[int, str]) -> CharsetMatch: + """ + Retrieve a single item either by its position or encoding name (alias may be used here). + Raise KeyError upon invalid index or encoding not present in results. + """ + if isinstance(item, int): + return self._results[item] + if isinstance(item, str): + item = iana_name(item, False) + for result in self._results: + if item in result.could_be_from_charset: + return result + raise KeyError + + def __len__(self) -> int: + return len(self._results) + + def __bool__(self) -> bool: + return len(self._results) > 0 + + def append(self, item: CharsetMatch) -> None: + """ + Insert a single match. Will be inserted accordingly to preserve sort. + Can be inserted as a submatch. + """ + if not isinstance(item, CharsetMatch): + raise ValueError( + "Cannot append instance '{}' to CharsetMatches".format( + str(item.__class__) + ) + ) + # We should disable the submatch factoring when the input file is too heavy (conserve RAM usage) + if len(item.raw) <= TOO_BIG_SEQUENCE: + for match in self._results: + if match.fingerprint == item.fingerprint and match.chaos == item.chaos: + match.add_submatch(item) + return + self._results.append(item) + self._results = sorted(self._results) + + def best(self) -> Optional["CharsetMatch"]: + """ + Simply return the first match. Strict equivalent to matches[0]. + """ + if not self._results: + return None + return self._results[0] + + def first(self) -> Optional["CharsetMatch"]: + """ + Redundant method, call the method best(). Kept for BC reasons. + """ + return self.best() + + +CoherenceMatch = Tuple[str, float] +CoherenceMatches = List[CoherenceMatch] + + +class CliDetectionResult: + def __init__( + self, + path: str, + encoding: Optional[str], + encoding_aliases: List[str], + alternative_encodings: List[str], + language: str, + alphabets: List[str], + has_sig_or_bom: bool, + chaos: float, + coherence: float, + unicode_path: Optional[str], + is_preferred: bool, + ): + self.path: str = path + self.unicode_path: Optional[str] = unicode_path + self.encoding: Optional[str] = encoding + self.encoding_aliases: List[str] = encoding_aliases + self.alternative_encodings: List[str] = alternative_encodings + self.language: str = language + self.alphabets: List[str] = alphabets + self.has_sig_or_bom: bool = has_sig_or_bom + self.chaos: float = chaos + self.coherence: float = coherence + self.is_preferred: bool = is_preferred + + @property + def __dict__(self) -> Dict[str, Any]: # type: ignore + return { + "path": self.path, + "encoding": self.encoding, + "encoding_aliases": self.encoding_aliases, + "alternative_encodings": self.alternative_encodings, + "language": self.language, + "alphabets": self.alphabets, + "has_sig_or_bom": self.has_sig_or_bom, + "chaos": self.chaos, + "coherence": self.coherence, + "unicode_path": self.unicode_path, + "is_preferred": self.is_preferred, + } + + def to_json(self) -> str: + return dumps(self.__dict__, ensure_ascii=True, indent=4) diff --git a/.venv/lib/python3.12/site-packages/charset_normalizer/py.typed b/.venv/lib/python3.12/site-packages/charset_normalizer/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/.venv/lib/python3.12/site-packages/charset_normalizer/utils.py b/.venv/lib/python3.12/site-packages/charset_normalizer/utils.py new file mode 100644 index 0000000..e5cbbf4 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/charset_normalizer/utils.py @@ -0,0 +1,421 @@ +import importlib +import logging +import unicodedata +from codecs import IncrementalDecoder +from encodings.aliases import aliases +from functools import lru_cache +from re import findall +from typing import Generator, List, Optional, Set, Tuple, Union + +from _multibytecodec import MultibyteIncrementalDecoder + +from .constant import ( + ENCODING_MARKS, + IANA_SUPPORTED_SIMILAR, + RE_POSSIBLE_ENCODING_INDICATION, + UNICODE_RANGES_COMBINED, + UNICODE_SECONDARY_RANGE_KEYWORD, + UTF8_MAXIMAL_ALLOCATION, +) + + +@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION) +def is_accentuated(character: str) -> bool: + try: + description: str = unicodedata.name(character) + except ValueError: + return False + return ( + "WITH GRAVE" in description + or "WITH ACUTE" in description + or "WITH CEDILLA" in description + or "WITH DIAERESIS" in description + or "WITH CIRCUMFLEX" in description + or "WITH TILDE" in description + or "WITH MACRON" in description + or "WITH RING ABOVE" in description + ) + + +@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION) +def remove_accent(character: str) -> str: + decomposed: str = unicodedata.decomposition(character) + if not decomposed: + return character + + codes: List[str] = decomposed.split(" ") + + return chr(int(codes[0], 16)) + + +@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION) +def unicode_range(character: str) -> Optional[str]: + """ + Retrieve the Unicode range official name from a single character. + """ + character_ord: int = ord(character) + + for range_name, ord_range in UNICODE_RANGES_COMBINED.items(): + if character_ord in ord_range: + return range_name + + return None + + +@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION) +def is_latin(character: str) -> bool: + try: + description: str = unicodedata.name(character) + except ValueError: + return False + return "LATIN" in description + + +@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION) +def is_punctuation(character: str) -> bool: + character_category: str = unicodedata.category(character) + + if "P" in character_category: + return True + + character_range: Optional[str] = unicode_range(character) + + if character_range is None: + return False + + return "Punctuation" in character_range + + +@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION) +def is_symbol(character: str) -> bool: + character_category: str = unicodedata.category(character) + + if "S" in character_category or "N" in character_category: + return True + + character_range: Optional[str] = unicode_range(character) + + if character_range is None: + return False + + return "Forms" in character_range and character_category != "Lo" + + +@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION) +def is_emoticon(character: str) -> bool: + character_range: Optional[str] = unicode_range(character) + + if character_range is None: + return False + + return "Emoticons" in character_range or "Pictographs" in character_range + + +@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION) +def is_separator(character: str) -> bool: + if character.isspace() or character in {"|", "+", "<", ">"}: + return True + + character_category: str = unicodedata.category(character) + + return "Z" in character_category or character_category in {"Po", "Pd", "Pc"} + + +@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION) +def is_case_variable(character: str) -> bool: + return character.islower() != character.isupper() + + +@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION) +def is_cjk(character: str) -> bool: + try: + character_name = unicodedata.name(character) + except ValueError: + return False + + return "CJK" in character_name + + +@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION) +def is_hiragana(character: str) -> bool: + try: + character_name = unicodedata.name(character) + except ValueError: + return False + + return "HIRAGANA" in character_name + + +@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION) +def is_katakana(character: str) -> bool: + try: + character_name = unicodedata.name(character) + except ValueError: + return False + + return "KATAKANA" in character_name + + +@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION) +def is_hangul(character: str) -> bool: + try: + character_name = unicodedata.name(character) + except ValueError: + return False + + return "HANGUL" in character_name + + +@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION) +def is_thai(character: str) -> bool: + try: + character_name = unicodedata.name(character) + except ValueError: + return False + + return "THAI" in character_name + + +@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION) +def is_arabic(character: str) -> bool: + try: + character_name = unicodedata.name(character) + except ValueError: + return False + + return "ARABIC" in character_name + + +@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION) +def is_arabic_isolated_form(character: str) -> bool: + try: + character_name = unicodedata.name(character) + except ValueError: + return False + + return "ARABIC" in character_name and "ISOLATED FORM" in character_name + + +@lru_cache(maxsize=len(UNICODE_RANGES_COMBINED)) +def is_unicode_range_secondary(range_name: str) -> bool: + return any(keyword in range_name for keyword in UNICODE_SECONDARY_RANGE_KEYWORD) + + +@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION) +def is_unprintable(character: str) -> bool: + return ( + character.isspace() is False # includes \n \t \r \v + and character.isprintable() is False + and character != "\x1A" # Why? Its the ASCII substitute character. + and character != "\ufeff" # bug discovered in Python, + # Zero Width No-Break Space located in Arabic Presentation Forms-B, Unicode 1.1 not acknowledged as space. + ) + + +def any_specified_encoding(sequence: bytes, search_zone: int = 8192) -> Optional[str]: + """ + Extract using ASCII-only decoder any specified encoding in the first n-bytes. + """ + if not isinstance(sequence, bytes): + raise TypeError + + seq_len: int = len(sequence) + + results: List[str] = findall( + RE_POSSIBLE_ENCODING_INDICATION, + sequence[: min(seq_len, search_zone)].decode("ascii", errors="ignore"), + ) + + if len(results) == 0: + return None + + for specified_encoding in results: + specified_encoding = specified_encoding.lower().replace("-", "_") + + encoding_alias: str + encoding_iana: str + + for encoding_alias, encoding_iana in aliases.items(): + if encoding_alias == specified_encoding: + return encoding_iana + if encoding_iana == specified_encoding: + return encoding_iana + + return None + + +@lru_cache(maxsize=128) +def is_multi_byte_encoding(name: str) -> bool: + """ + Verify is a specific encoding is a multi byte one based on it IANA name + """ + return name in { + "utf_8", + "utf_8_sig", + "utf_16", + "utf_16_be", + "utf_16_le", + "utf_32", + "utf_32_le", + "utf_32_be", + "utf_7", + } or issubclass( + importlib.import_module("encodings.{}".format(name)).IncrementalDecoder, + MultibyteIncrementalDecoder, + ) + + +def identify_sig_or_bom(sequence: bytes) -> Tuple[Optional[str], bytes]: + """ + Identify and extract SIG/BOM in given sequence. + """ + + for iana_encoding in ENCODING_MARKS: + marks: Union[bytes, List[bytes]] = ENCODING_MARKS[iana_encoding] + + if isinstance(marks, bytes): + marks = [marks] + + for mark in marks: + if sequence.startswith(mark): + return iana_encoding, mark + + return None, b"" + + +def should_strip_sig_or_bom(iana_encoding: str) -> bool: + return iana_encoding not in {"utf_16", "utf_32"} + + +def iana_name(cp_name: str, strict: bool = True) -> str: + cp_name = cp_name.lower().replace("-", "_") + + encoding_alias: str + encoding_iana: str + + for encoding_alias, encoding_iana in aliases.items(): + if cp_name in [encoding_alias, encoding_iana]: + return encoding_iana + + if strict: + raise ValueError("Unable to retrieve IANA for '{}'".format(cp_name)) + + return cp_name + + +def range_scan(decoded_sequence: str) -> List[str]: + ranges: Set[str] = set() + + for character in decoded_sequence: + character_range: Optional[str] = unicode_range(character) + + if character_range is None: + continue + + ranges.add(character_range) + + return list(ranges) + + +def cp_similarity(iana_name_a: str, iana_name_b: str) -> float: + if is_multi_byte_encoding(iana_name_a) or is_multi_byte_encoding(iana_name_b): + return 0.0 + + decoder_a = importlib.import_module( + "encodings.{}".format(iana_name_a) + ).IncrementalDecoder + decoder_b = importlib.import_module( + "encodings.{}".format(iana_name_b) + ).IncrementalDecoder + + id_a: IncrementalDecoder = decoder_a(errors="ignore") + id_b: IncrementalDecoder = decoder_b(errors="ignore") + + character_match_count: int = 0 + + for i in range(255): + to_be_decoded: bytes = bytes([i]) + if id_a.decode(to_be_decoded) == id_b.decode(to_be_decoded): + character_match_count += 1 + + return character_match_count / 254 + + +def is_cp_similar(iana_name_a: str, iana_name_b: str) -> bool: + """ + Determine if two code page are at least 80% similar. IANA_SUPPORTED_SIMILAR dict was generated using + the function cp_similarity. + """ + return ( + iana_name_a in IANA_SUPPORTED_SIMILAR + and iana_name_b in IANA_SUPPORTED_SIMILAR[iana_name_a] + ) + + +def set_logging_handler( + name: str = "charset_normalizer", + level: int = logging.INFO, + format_string: str = "%(asctime)s | %(levelname)s | %(message)s", +) -> None: + logger = logging.getLogger(name) + logger.setLevel(level) + + handler = logging.StreamHandler() + handler.setFormatter(logging.Formatter(format_string)) + logger.addHandler(handler) + + +def cut_sequence_chunks( + sequences: bytes, + encoding_iana: str, + offsets: range, + chunk_size: int, + bom_or_sig_available: bool, + strip_sig_or_bom: bool, + sig_payload: bytes, + is_multi_byte_decoder: bool, + decoded_payload: Optional[str] = None, +) -> Generator[str, None, None]: + if decoded_payload and is_multi_byte_decoder is False: + for i in offsets: + chunk = decoded_payload[i : i + chunk_size] + if not chunk: + break + yield chunk + else: + for i in offsets: + chunk_end = i + chunk_size + if chunk_end > len(sequences) + 8: + continue + + cut_sequence = sequences[i : i + chunk_size] + + if bom_or_sig_available and strip_sig_or_bom is False: + cut_sequence = sig_payload + cut_sequence + + chunk = cut_sequence.decode( + encoding_iana, + errors="ignore" if is_multi_byte_decoder else "strict", + ) + + # multi-byte bad cutting detector and adjustment + # not the cleanest way to perform that fix but clever enough for now. + if is_multi_byte_decoder and i > 0: + chunk_partial_size_chk: int = min(chunk_size, 16) + + if ( + decoded_payload + and chunk[:chunk_partial_size_chk] not in decoded_payload + ): + for j in range(i, i - 4, -1): + cut_sequence = sequences[j:chunk_end] + + if bom_or_sig_available and strip_sig_or_bom is False: + cut_sequence = sig_payload + cut_sequence + + chunk = cut_sequence.decode(encoding_iana, errors="ignore") + + if chunk[:chunk_partial_size_chk] in decoded_payload: + break + + yield chunk diff --git a/.venv/lib/python3.12/site-packages/charset_normalizer/version.py b/.venv/lib/python3.12/site-packages/charset_normalizer/version.py new file mode 100644 index 0000000..5a4da4f --- /dev/null +++ b/.venv/lib/python3.12/site-packages/charset_normalizer/version.py @@ -0,0 +1,6 @@ +""" +Expose version +""" + +__version__ = "3.3.2" +VERSION = __version__.split(".") diff --git a/.venv/lib/python3.12/site-packages/dns/__init__.py b/.venv/lib/python3.12/site-packages/dns/__init__.py new file mode 100644 index 0000000..a4249b9 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/__init__.py @@ -0,0 +1,70 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2007, 2009, 2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""dnspython DNS toolkit""" + +__all__ = [ + "asyncbackend", + "asyncquery", + "asyncresolver", + "dnssec", + "dnssecalgs", + "dnssectypes", + "e164", + "edns", + "entropy", + "exception", + "flags", + "immutable", + "inet", + "ipv4", + "ipv6", + "message", + "name", + "namedict", + "node", + "opcode", + "query", + "quic", + "rcode", + "rdata", + "rdataclass", + "rdataset", + "rdatatype", + "renderer", + "resolver", + "reversename", + "rrset", + "serial", + "set", + "tokenizer", + "transaction", + "tsig", + "tsigkeyring", + "ttl", + "rdtypes", + "update", + "version", + "versioned", + "wire", + "xfr", + "zone", + "zonetypes", + "zonefile", +] + +from dns.version import version as __version__ # noqa diff --git a/.venv/lib/python3.12/site-packages/dns/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..dd1616cf9138d5aa85c49258f3c8bab1bb5db3ba GIT binary patch literal 716 zcmXw1y^a$x5MF0@v-#mlM03RzG(jTE9q14eqN2Skpi8rI>`7w9Ywy`kxJ?6ZK~INx z6y9K3DmvgKimMp!221|t^Vsw6?x{PB>52!|JUG1?oNq(PGqu3)`?_a z*n-J{O!c5n7a2?1Y?dD$O5>Y0Y^*tZd;R__SgW@x%u0N~eQU&$i!B(5lkRl01J~k7 z#~pa9_uz0y9y|z~^pfkf$7#<)+knRm&M#jOk`4&!&5pJP%%B(RBL1W=$-<095p|k*t=s$L0d?X+-`=A_Pdb@I%9jpNyN9^rJk*<`6 zpK-`D=AMwap5<6nm9(O&BH>ySi9?tly>`!VT2;q$ReeqFqKEsda${>KT>~_jy%L); zcCEZpUX)~Q_N7+Kvi~B_=jRutR{@?j^e<=}zN8psRVkxFRn43Be)PJwa;M>qdqv(E fZU2biSIQXs{WxK#f3j!O!KdP{WC<(XOS=09Rn-Hg literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/__pycache__/_asyncbackend.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/__pycache__/_asyncbackend.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e1203dc4239fd6e379b0543ecc2b5354da523242 GIT binary patch literal 4784 zcmbVP-H#j96~EV>vB$B!-efnMkKIJh6449-n}imMKr~9A5CMK52({ayVKQ?!>tsA* z?j3Jpmxm}_RjJylePa7BtfKxUeW6Gw(TF!*;4O()3goHh+&g2>%o<2?S9^Tt+^=(g z=kxxzUf)Nco%!JQ`mZa5e1jiJ)8o$g26VPbfxJyzvPE2ayP!ta6t4ih;)F-#JPmj{ zqqmFk%!1^WfLl&+i;`;qw=!9;N!~u-RVO@sSTpO6+Dg$_0y2IczPAY@Yt$uc1-I-L zw&+^XEpCxD%>^mebXNyja^dW?@{pQFRP78r?|k5g?0VR7lAUm0?4!iv139_?1MxV%To8ZMhCNk#Ox}}5_3R6lE%WFM)QA-<`+hjBj3@0q??omncHNj z&fOt9nmjZz*mcJWhkX`Ru(xS@1L%g_b{OI!a9I*)b?NUB&E0SU5(tDnX3e4`bZnW?!Zw$+DpVGwud@9WN z#pA%6SF`STfncMW+O8$Pj)6!VeT(DWW*@NxBg(!)=&5#-PIL+JWuX&<7kYh<_0Wvm zw>S^@9xJO}W?`Q(jv5#ph=oY;ny~X2twn0~>$wwO7$;)omMiqBMB^u6yP1LrfHW^i z!g~f6{Q}7;AbX;%^tqqGL>_DwR8%O3-5v`DVH|6f^CxIHjE8wNkoRm>h{T3~D?`2% z0_`_({EK<#%4uJk_-KC&`_$o0*h8SbCysrq8hdn6&w6wbCdp&ZLMJ))N?I`BW4o<> zV6sd81gkzTY#0Bc>ky%afWR{2}O_P6LF^0u5H+1RCSpMyS^QE1D{LfVl1C#$dZ6kA`C_cbK)uXFJW%VPZ5Zu zJ&{a1MdhcO=#H2Y1NWNdY0jL@bsqHgz?2NU0@J6Gbj)(j?4n}V4^_^QQ(wdRxlDsl zb0nB0#9<&?5P1DSvQ;Br@94P$>}TQkQHY>o=JrJEoq~ z5kHF)&LPQZ<_+W_LAA*sqr$*yN*g#lTN|n_pH%xY=?@ELF{)#w^&z)?(GPg&Bu^LE zXd2-k%cb<#d^Z9SMjCD=^%2#*z_C5cc3mj^g)Ak}wc_ft>IA;eoX`rL{^&?XmR4%$ zO%P|Qsg9}TVY`46a)`-ANY2B*z|u)oO|j|XNCvD)d_)-YrduJ?Ki7atiOzZ^xn(eO z1AwhW<#Xx{k|`NrWA%{G^E@MWTED&n(ZY})6%O*8>d;~@f!T2V; z=}_q?nT*m>y(tyIdy;sPTn)WU*4ps! zLG*q*8?_ZT&RZxd8W_ZOczJ$0=yK+cP9{?P)U4m5SnK$=y(Lx$=YE9bcS!z#~SGM&oE%`xQ2b8-SaGG13N#5XwJ5!EZ+ z0&=fNDSbFMN9*?qkcZFhr_1*Vklj-TUH#Wby99oAmvrdAyi4Hc;e3Iv-X}mF?pvm- K4+s#cwEqLT@vD~r literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/__pycache__/_asyncio_backend.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/__pycache__/_asyncio_backend.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..88cd29e1d0124d426f4295a74a0351129906c6d8 GIT binary patch literal 14121 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 D@E&?i literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/__pycache__/_ddr.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/__pycache__/_ddr.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..72f10456b5f3ad3a541580c0133ec06464fc867c GIT binary patch literal 7833 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 VYe)Ni-`4CwWaJe2Io|!Z{{TV8Bgg;% literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/__pycache__/_immutable_ctx.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/__pycache__/_immutable_ctx.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2eed9c0c971f468e558f8c2b8738599f646d94a6 GIT binary patch literal 3229 zcmb_eOKclO7@pZ(zv{K)JX-hRHio82Oj4UZplVf`0);9Rav%tVi&)&w_u|^V%ycIG=)4oBH z@R*yFe&=@+o84i2Bs-SP$JJbh^BY7J8~%ve;=DEt1r^Pb)u$hoDEenpNC>bX=gn@~k!kKfrYQ(jI&huSHoR^Bl0yE+n z!(iDnB}0#cu-UWu5j}5!V!;OMnc`X9FaxiR7xfnyD=^aohjj)#3fB$1Kv5EsDRDhF zWJ>wWh;DjDGr5v(1{B3I0x+WD@pydl!C-2*FrueeQ8!p&G^-A$)Pkm`UdeJbl^oUc zqp4i>OsY6;3>WeTlKb|jc-GMO7BlMk%vqhMv^-BW_*gZ@lErZrhTA8$Jak5~L9{Kf z$M*ucKS^!{w|v|;-M1Kw&7P9?Nw@F!9w4fo%RvxPTX+oZC5JM5pc~6 zAb4er64NoL+zAAgz)%FX2jxJ0--+9TH*FA_C17(may+1kDw?XE_< z=b9IzJ(JHZNo^~^&}6?AZ0q6-wZ2P*qtg`Iz*?q%ZZb(g&ixeXoi>#Fw!jxYV8zrAd?1pxcf`kY_ z8ye(>D>rZ;7H??4;d7RN17T`I0}j8lWaXDMfItGV$f3djtgOqnx!pGoz?|_ zivk#N77DoVV%27lyG$X&1v|r`GSdNwPYcfhOzp?Y4ao-c$KVczp=g65>Wl@{#zlOu zOvE1{7*s#|s$;;#Hv@raz7yFzI*qSQ>3{uxx;QSQt$a9B0A6aodvcU_n>n```$C{23sBOp)7Lw^#aahhjB>hW6J) z65hFrqq|-biO%q=14~Ukx0~az+k6CeTOM1pMm`ehwXOOTT$2b`rO1R5IKm20_gwkd z0ob->v-Gf3KxIJ6gSdsq*MU{QwH!MHd#EIT9|(e~ule%emD4k)tG@V}mu&5tjR#fFmE7FpG+sgKx*OH$lVWVj!*fe>{_K436 zs)f9vj~SyG##txGW^Q`kUU@yk>?aJuglz>>!pa}pT=-0R;6G}=A&xQh1ZEC@8px_h zDXoPGZT*RaZ-+Z7=a<7B)o{nco}=ICOW~I%gZI3xwDT?j@>}mF8m?`R(TH{LpB25T AcmMzZ literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/__pycache__/_trio_backend.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/__pycache__/_trio_backend.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2afe8656f0b0499d688fdeee93e97b13826a8f27 GIT binary patch literal 13172 zcmd^FYit|WmA=E_`zeYdC5n_p>P^{_EL*mf_>st#`qx+**;+Z@5HTQAuIo~<={>o-E69_wxy)p4*fRGRHMG3k>B>yc9A(u&v zjFT7>)5Mu^hCVgp8v0}lPwlvlzUvE5L*Z#0*KxY(YNgrYbJ|^uE3p{+1|!D>qlR#n zm{xgTWMaCDWZVjE)hnfo&uM=#uEfS28ghih^cP9Y0JQ>2dht2kT#PHRH&{6~?xeMi zP}{Uc?N+5u@u}9X{tRO_D`VuNbOv4HF8Zt~Jl*4N&NaQg_!T8KUJL0vl(*t@T3d`O zvFV*ktoR(ShwoV8z8U|xf2Lu)VWx4sks);4Rv5R9t5wI-L{sgM>fqedj~3fdVrt3Y ztY?e)8dAy@pW{K=ZWXla+@jVho!}$< z`M~q1IiSMnxw!-{{x?=0m9$uP-b-uDCd9x*;`D4Rkl+JiA`wW$W6=Wp(N7^O;4dEs za+xH_3vN-(pN4Hw9+E^^$}u9Ui!iM(FGt9<>A|!&3Q1$+CNmn+@%U-UHj_BRg%h*k z$b`u85*wQpBwLsc_CzFlikpo|meJGk_~FE?$ej~!GLk`@n&A?sMFG1S_~cmcWMYQv z<>xq&Pn?;GPWDCD$>WOo?3g9JC!d$qBvi zz1}cRSGe%Gp1JdqJvQSw}GK2(ETy99=16 z*N2YktRs+i1hS6pX~*`AqbFtT$wLhiMWO^{Uh{__QabwH?)U-s-G2`Yj5;98mp@K^Z1vvFI#v!KqB|e{4lmpaP0?dNujl#^n2YK}w7$`3xB&d&x_-7Scxq z=B$PxUxIHjWR^Y0euCr%}1CBt!f&xEwR2eY(iCnKU{iE)BBH5g=@UTyi!P1LcjZXN*7|G0m>$V_8?O7V`m)|_Y45fhL$|hNya%(c zgCDVwCl_!X{FuJ2WARTuv^y`&EYD=^Eopm8uEw{{5=U#EXdLEsqA{883;3-?>tGl2 zO5h;-eP+M@2kb%ihh|9lF>{dpcio`DaGULb*Qm;*P(x*c|A3bVm_VaU=4WLBrQZJo z3uww&fcL`CHm$#r=b~pO_{0q503LS^kI>;JTUd8tYMzsqTHb_(l@36e2R5P77Ha1F zmw-I5*8S>Qcc;DGH)0v@uB>Ypu5CZAbbrpZi>`D(u5|zAmA-K#WpByY`%}jL`}x8W zhnQEI4zS;2_UXUR9$^2)JQ!mBjXA*nL^r56+}3o!>n8n$yOHkmMIKA0(X<4vnDGVc}uiI?fIIrEkO(SL5_f%i_TKcXuV`v zwq%Xow9)&H(RZJ2twn$179%(a75~%`j6K+Y%Sle0<2ZgcGQ;s5*fXju5h?W=7|~r)P8_N`4EmW~zB<#VFKK1I`78`~Z+5yos3r+%SI}xH)eO znI-F($a5;FDOK?J1>Dkk#A5(l5uiX!4oQGDVPtn2k}SL_J%X(+Z*!Kffm{G8^a~Oz z#)X1vq#68v$mI_JDbt7)thh`2r9zcQur$sr;6nr^FIkj_%L6dQD8rOeLG+iVp>R?q zBjSf}Bpxr*P$5}E@eNSuK?Nlluo~2wuh}&Dh14Oe)PkfH$X_%Jpp$F`)y++TT_u2N zR5sB(#ni}$3eJNh3{d!>P@?Pv#vd9*Pg8FP}+4U;~Gj?hu&AR z+tRMKtgA2W>dUxxrL4Q|=W%?CgH40Mzr01^kHFaFb)eXwd>tr~dSD$C9Q8%4{1_6H z3Y%~g&MDop{{xXv+p_%AB5rRQlBzjdu)r#DwLvLed@8VA-QookoS_DIsR<4oUa3t} zu`MO0v2x{9wZ2h_(zc(M$(RC zGYGv&WUxqGJ_vkyBxv;rX!~6xc@3+py=SIKvj8_+?&-C<{(Dv+d8=O6F1LX7z)hH# z1ox6X98Jv3ofc(Jogn$c+_||ao;ozb6A3;nPEHBoh$wP1b0UCfo|}n)uWI&W6dF;3 zf(|KOt?ZC9k(dsga?H4v##o3I9COqSX8<>xUUGy-Iq__QKXpiUTt;>3CrbQq zS2i;$Xnr0_3+P|?82o!y=kk%X)&I7&G1nAY8hYF6&o#6y4ZSp)Yu}5nEjeFsY3Sw8 z$w(SMqy*g4R055Ie32#4NwT1?Bhbx1yA&AbE-si?2@VD`~}I32^m& z6XcI7O_Yuj@`8Vhx)n<+-X>^oRzw*?L(-_EFMxG3jsDNFuwY7R`KCWGMrTGfbv%9d@iO*+LCr~QWyAJoy&rrTc{FIVA7DRnnqDu7L*=E z!R$yUO%=(K+6S7%94dH{|pex9+{xhx=@V&0w#hD zLuC(jfk>u89w+dh$9hj=5ko=HN|qVWwP5Vv>4)sVvy44;_=)h?@nge-Pl8}RoZz|R zaL6O0Oj%KzhE?~taZ(iLqEJS%!a36{7Zs_8C*&-6O(zqAC}~lGQqxqj$xo{0*^~hqt0){YSjg8Rieq@6a_{m;C7{w zwUkf?j%10-y$*}fxp`l?ur0|v2W<#{2lf_473+H9^(`G;^LO3YoAK{jesXDWX@1R7 zed*ltxvZl(?Py-@f7{WStMX>60_m#2YRx-U?K!7A>+DQBJ5$d7lALUCARQcdr|O{( z>swdHGxa-G3}_?zuliT?@45nO4T0;=Tzw|n(4TJTzx8aU;qb~xF3|cN`)l@WU|%}0 zFIQ8y>bcbc&i~+kaQ+9YKO!1m^@;)d*wC8wcc=Z`8GrAJDd%gwM;x{W$kEuH4QpQi z^}4HdS?`XtcgL;TjQ63HL%G`4RPByiL)reJbpOyVnY;Z*bIrZCYO;NU>At~K@X%HL z`@yy=`dmxbjiJ@vl_%Ch!#|Dw^5IPA3#pp+wZ_g=XkVsr|H_fIVCO%1v%x*-;GSGv z{k4&-zbEbQxy9Vt^X9%^8uF~B*#o`wdsc=v^u)jIM*k1?-Q1V)?Y&#Gcijhl+z1et zFI(M_uI@-#JJv%mppV!6P~rZDk<=Czx@Ln**6f(GK{SU{opI+^I0g%&m+N4@}Q~+KLDiEQ9Fi-Nair36$o|I>P*e+Rb+&DoXNAzrq1=p z8Pc~q&$6cW-Mf#g+}NBi33ba z8Y(SxrPEnO|CKp7rfc`*wo_TQMqV{7Nik?OvU@Ywcd^dMH;_ccm-UzV}TJ2)}Li zrJ+lYFF*c{wSyw^kfEHf-S8#JG&mCe{OH)z!-r)vu_9x?03~@OuftCW0s+Qe2O;Ur zH8$tm-ki&ub+x2jEg#vOCi^`CM79R8&L*zL1;S8%_`txO3D!i4e=!5xuK+1Rf(Zbv*#y9zZ%LXe z?VRF%0btB1AXfpAswh?6EJ;lXK(BCn;S_*K{@EC_U@6&adZj(;>@iKNrcAN(CH>HS zNnQfu$14rNLqw|sG395u=mTuH13bGkko%yy%VwsGNELADBa5f9iOFW8YE51 z*v7zaFR8oL+zb}Y(n{C*itR0!VHT}P1Mh>eTEQ@4l&(x8R4fZgbJCDBepjomyjg5f ziU3cTlU5}M++3;&0d5U_QuA%{_Zn0^%1EeD@DUgVKYG9c_Cwhm0Am49&}aZ-p&EP^ zrcX2R7_vwdQ=+V{59*qyanF|pMW$08gk2}!w%JQ`q_j13#f1!`Bgf_2FpT67I364v zVFc}T6S_{%7B0zgv49NK1M@oZ{2Uhux#TTOC6)HX6x=p5hU0PZG#vHv6VM-ew?;A) z&`$YL$|ROR6HGEwdt>OxvB4+lfhZhaQfovuI3&~9*yjqi$1v7;7|9MGA)74q1#HBK zox^@fx;Z`p*LXxMhHEXG9Tq`|gU5?rgySz^4Mr%~GKCIuG5ORI_m`p==u=h>93;=X z6q!_FH2oAZgjaySWK`xMHs_@$mY>L48`IXtEBxxfjn8MSyOtOL|4VuR-lpnz9qyc` z_VUE56W5+uow#u#)6kdk?95i}OjYg7Icl%%$@;p}zV5q@?wmikVp?;ztRBg@xBr@G zoNc*!-}TVd(Cd%g`0|_0nbrfD`h(e;gQ=Q>U=gew{YVEzeys<9yjI_Ez58l+w!SxA z-)HTwUX;<<0O0t7-JC zjBHp*O<+~CI&$N1#T7QT*cYO>h%l!!W zS78LuMQ7XZHteLzdk^k0Rp+d>OGlQEymT~Yb*}3m;ddK;Y6NJU^||^04)oi-*_u$g zCX}o3LJ4R6?*)W{i>)Iy%y$CA4szST3_YT~ZEVH(_NHN${h5UsX7oR^>M>s31?fNA zKWK&WzcAGecavWP8!`R}0~vQ11`6F_b;DM}9istL9KPW$_D&ZIW$twQN1W_iCT7H{ zf6HvZxD(U=Y>=E!!cY|?Zkz%h=g&mq4?=O9!o3uN|1a`w5rV^c-1PGFmAc|t9RD{^ zVv`<6A&P1hTKUEy z)+k;vD;(g1r{-*AN{pNU0g70=aM?2;J1UHrhrXWqDrM%Bl;2?Cr-8`URLPCPmYlcw z@*{Y-+=7S8Ejd>+JzQ?V!{wIEhs%}j526}``-4@?EBaRU>rAu$8*D3k#S97m$h5Mr z>$(j$JKzPJ-Z(>}7ytm49dW!2Sv<;5**rsQg?|kRMSsXkvWSgg49Sn-C!mPGNbYGE zooC%n9921o3mhG}sv4wq{=BOjuGc)rFgiHvV04XnJzTeufh{%>Y6XvcIF^Wp!}7Tu z@{VM|+sZw%9+M4`P1mJm-5l@4KBGK34bx zqRC2^Zu4?}V%#s^yE@4K2x{Pd6x=|;Wy3I_qnK?U5ZedD@*b)FfYiN5YUsb?eS`UH z3ok5W4c@fDd!_wtL-1X*JLT!in0KbMJK>z`3TN5N16j+qv}M}`rS)o74B`;|DM+M zp0@ctZPoit9oeRR>85=ttv}~!%z8T0p3bbNJMHPtdIr*-feTOlr}kJ{du&6yQ`erV z-?>5HxiQI9>+DzDSubAe_zi)V^)BKmXwR&>Kke?nFuI{X$e5R+S$k93-jua>r0pHQ KA&^8F_x}Je$Swu| literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/__pycache__/asyncbackend.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/__pycache__/asyncbackend.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f574560b6c1fc272f64ee0eb64f8f8de0420f27f GIT binary patch literal 3412 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 Az5oCK literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/__pycache__/asyncquery.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/__pycache__/asyncquery.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5d98326f370ae11d658658d7f38346d0be74a49d GIT binary patch literal 31670 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/__pycache__/asyncresolver.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/__pycache__/asyncresolver.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b7689d5f80400ad93c77bab0c01e10b6a6f8a5ed GIT binary patch literal 21326 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/__pycache__/dnssectypes.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/__pycache__/dnssectypes.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4337d418f3ae70f16ecf1117ef0882a175200b6b GIT binary patch literal 1970 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 fg-J)wS)}XjERj literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/__pycache__/entropy.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/__pycache__/entropy.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d44be4c5649bb46e8f14dffe01edde0860e74d28 GIT binary patch literal 5965 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 utbv8_Q*3>ot0J~?NcnMr&7Yh=9;%df8` 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 Dz%dnJ literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/__pycache__/exception.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/__pycache__/exception.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c9fbefd9342974a3dfbe8758806c5d2a12001538 GIT binary patch literal 7222 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/__pycache__/flags.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/__pycache__/flags.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..68e199082713b4f81a6219670c89d4e9d58abb22 GIT binary patch literal 3072 zcmb_e?Mqu%7(eH}Brz|VsI{$I*PEhQGg>oi*&Hh!R@<&+bxa3^+m4v#9&KWBliquk zDG?$Rs}K z&dKkAfS16yFtt7V8)z@laE7a{9F!>`n?xfj(WoY5s7hfLGeTBWMM?y6ooLcSqREV= zJh79y{2#_s2`EN0}HW#kr9$@{TnPGhlKDKi-xT4efS zER(ty%P(2?bNa~8@P(L}ve@~2A~_F4m@!Q^W3!x%{E{KVf?V{2Vh)0MNM3Yw6|cNa ztX?ttobSDvL_~a)M5u^pd#*xBkT3(!&}39He7KGuMF4~?Onhq`LyNC}9JP~<7y`v~ zgWx-K_JCnqve=K7?PdBxHlEBROw)E5%vvz?Bvhj@5G$U!0}TY6Te>0?NZKiUBaM*l zy1pV7#0m1l2|`w+f>59ZDP2FaEy;~++{tn;KF_n2YAk&>a|v(N+yU|ZL0DV^ur$2>MVUUnT=Dlk_n+GJpDHK*@GDgra;h%k@7fq$A1&S7^PS$2 zPV-VE>)7EZ2wo$#Dx3jjlUR*dfmn@x-mYuF16`gQ&*_WIu#|*i!Z~N>O_om>35#h; zCS_VmZdO683ZhmP6PX2ODk?&H{X4MUNkbE|*^U_? zo0c&%Gvr{#7H}|Q54B=;JAHBy0=F>OMBH1t`pd;VpRyw+H13S_H#~(dzyW?>!mxMb?!q*C}{iS?L zpEK~*wcR&#>l(g}ct7%o&laH*Z4pjj?cniF#It2!yBSEifxl~XqUb__Pp^SJXmq3K zK>@E4G4O?Ndt6_8F4g{qTsFRfC_*#;1_2KRrGE_&dh#Xl{Ym-`y`40;c5&m<`lUkx z>fu=dY-^*iUN|J6R=qL}m8Po%rmZBOo+b~_ss?4Ml*ZAeZ1Du;=`==^YS2y3U<9V} z_yJDUUN;SwM$i>5kDx1zu1L8DU6HLGbVblLSQgPWxFw=%uzG^HypL|L-YyCix#NE* RRX=fcKDx7dXI0>Z`UjihilYDk literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/__pycache__/grange.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/__pycache__/grange.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..1bc04e2a1391a4dbb21e49f306a48f8e52db18b6 GIT binary patch literal 1772 zcmbVM%}*Og6rcU@+V~4_O%tLNHcBFJ0^SCCAW@n^j0c@|OFOeQBtcORyw%Rmn|<&1e(%kj z`8^T|0wQDcyIC~=z$>bph`%#=GeIWLfeIFZ%BXCCDYAuf#`QfanFToK z@))jRS3nS#kghQFZ%2IO%aQlZJ=P<{R2h}2vMO8URIbXaeAQM#Ik z5O>@GSRsCAWrd=i5mngj#NA|UFb#gl15g!gp@Z0G`&8b;?!hNT0ycl*Ls(HZY}L2* z3Gwm&k0t9_28iXDEv$5%p+VH$&Jq%A-WDnm!h_$MJx4}e#9JVEr+M+h|8DEJnM z;ILkf;SW}W)nmjWKrJlxE3nCY(2BD;g7W=|jm?k>zoXgg>hwAHGV~5p#%66U%PoLJ zxN?y4dJu~^4@KH@V%9)K(a4H&r%5%POf#8lC%v1=h!&PHEJB@l8KSHQMIxGxVGg2X z(9>>Es2d}mr-e}_GjbZBBp2QyzmH2pcL3(S#4;iaVkx6kP(^BI%E*G^b*pkgH@r~)5fCjCDq2>9YNgNPAr?!PhkEyO&n)3{ zIaRmZF1V&Z6O*Ivh8EU!EU%>zGLXxWY+S!)saj6M2|wZ~S)T{x@-!tnLeu4x67tqD zbQ#5>2aZ;q$ngUyZxo?~Oo)+D)|9-Y7%G&$)+|LzmZ4sj3fi({uH(F+k0)=9NtTA; zs3|L}at>M&VJGFh`zUFyyIomi6qo4kA$ohz*P0|1+yLzuh;(nHTcOCtbSo4lLomFN zYK0>k>DK`e2s^y<%~SvO_|MUUXz!C^z4$UZv=<#}4nNqBK5Paa9!7fq0%6}QQ)7s` z!!;(heLKCs1P|gDwz+4swR9^Muccb?zIwV9i8@ys-yVGQv12`(s7=53=gH&x(a!xYOkO zYIj=xa1C$TXOO?xk4`oNlZWA6=dUUsHFnDhX#pC8`?^eq0KQ2^ZFWKuKx)xz5>Cv eATfhZstw3zJH2yt$NDw3GrD*A)4%D8hxad?Yq^gA literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/__pycache__/immutable.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/__pycache__/immutable.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..da37deeb66a3bbcfc4037d2a18e2932cdaf5a538 GIT binary patch literal 3782 zcmcInO>7j&6|U;;`5!a>#Ri0F1FDlTw zc#JJskq>r4ge}n8Q6jB#%3989_nc#LOD^`>lC74dY?O_Z+zi8Ems8&BnQjkWHm9Vd zdG)$}UcKM1YW`YR7bVcn{ctt&_Yfifzz?qlt4w(sm_?!!of>3_LN6FXUK|qh(vU=P zTr>jt;82hf78J-$qDwPG4=|cL;ECGnbMHGl8L~9-JXVF+Bt{4w{moIz0mPKq;DxIZ|&{ zv)^{2I&@jHpz@LvDwv997E4YnuNIYzs@WzlX;RHG$fG;Te*v;cCIx=prr!J{wFQsQ z)$Xbe=Dd)3i=bbv?%;_@I!P3NmyTcl`Vtk$r04~pcHJb&g=@rlC&j)#Hc3~jnnF_S zlb#e*3X}cnD3jHK><3KVbB>(hW?r^Om~0i9md#|DUNf7DM&)X|osqk$e(aL7mi*ow zKE~cVjav(H*Pg&G`C-;DGBYwn0}e{b^1B72BwNe|F(5OW zkxS;7ta8w13<$^u>d7mZG8?xUFQ|qui?a+YDQL`+ZPPVlPm`3tY9JYMqFD7W2b$M0Hqm4)j-2xgS){7VbMi#Y90)aIC1SHgf{Xh-!@_B}cNDk>MB{j+xG} zkSz=^y6M$Gdc@4LG%qrnn-8+uNLn*>mhR75S~~TB6&|FG>~OkRvPaCq`PA8SX)9~9 zGeuP!Rqrz^trx7cAEXo{Y*$dS(9oWZf}c>R;UxxTG<`+B^6X<{?p zwcTh#lE(emV;!40)TLYASb3M_n8ew=M@FU zns7`UWhDy_m1W)x9miUqsIMCAFK>rYs};yJ*-kV)c{KNEE77^0=v=lo5~tR}r}#mb z)BLK1j{y8!<=24uCgrE!)#((qeG|Y$zgl5iwdDY&_cyO@SF30Cl6zp|lmK|)fgm7> zH#-4VP0`1V60u$IM`^jb{W1x-SO*CnIMZ)%`5;M(100>k5iXMNO<%=RGVts9Q-d<{7*;tVUS^=3m}Qz7+~h%#+uBle0Jc#1c;~ z&RtxK9o?>Pn7y{sdUQ$uaP-%sTkWa!_S8mu_eSg47lhUwn-^ihvpY*Cp59$Jut0Z3 z82cjLSj|6s`NtoroAK_?A*d5`6Kml^UymfJ=0@@~FpH!Hn@O%VU11iR=kr0r+u### zFM}0audGnlXbWRjH8rFtFbkH(t10Jxb-@Cw0mwAjNi@#)EM8i;w2?Tr7C!cWP)~x2 z;I4lBTX=4bb_fA5SrdrL=b2jln&x{K`xg2(67pJDcJ&)bCNPEtHO~~qi7HCo)W;0u zSNSBrQm=D*16Fok)^ER)~96rE0N4I1)^L zYY@l`*^QDz?c2S#o<|x2hd*y_-3>s$8zhYfcSFblIJGYgFQ58-`giHA<5$;@UtMdz zy54fFjO$-?(!l8#!4PnbG$5CQG|*8w4^MHZ=>$2m$9Un*MgIXf@%2>MyT<+NIc6hB zxNWi~ZE6$D_OEMy*MSJBDRF-v7VF?^$!W(u>HgkE+lLZen1LO=WIvGXli|PTd>NN* z42#>my;E@Y=P+IOHE$lk3BdMeP%KlzlxQRHx(%Kmm~7DCp(0#{{&5RH6h_=_lT;VI za|d1fPSgO{NyrUKYAm8}wn!81f@dC*aq%vBNR!gU`6wWbeBCTOVBD6g??~A$6)P9H ze+gEGDmVFSVa7B)55Mv`Abo_o_g`+zP|N**^zq(nXzA5s?=R;Ux! z;0a)7Go=;55mMcb$PByoE_xNYe4iEAc#&V3IO45MT{cWjHLNQse-a&M;pO!&^5r!7 ztgYvx^S^CdKJnqv^|qd`%BbwmTUzP=+ydSMlKFS=aD+kc0{tHF|5e>9xMNS<=I&+d z*-w_V#e3_`-CyyGFncE%xsbCvsz4V?}&OIg*jJ zY>u$x1n`2l_yyoyL`X`!+a1>sZ5%r4&6LY<@*Jj_}X+5?~pFWzsG2iivTX0WB zPJEGQn!mBsQ$g14SbX}{moJ-0{UO|RVW+7L;`?dGW?RojQ_pAd9^7)_m3wV`9RGe7 z`BT@C>tXTFAqo`!n4LBezfL1O1XGG%1d3*lbHphZlATcX zk?Oj(;^Z_=;`_&S=Bx1K3ff=cw_yy+!9oVKqqH0(wDoU9{wMi10I?8zDV(GovzMN{ mHTTw5?D%@@c$vUJS%j%woZ20rO|))a+$GR0i7&BpkNOYrDjsJ5 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/__pycache__/inet.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/__pycache__/inet.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..9a2fac4cd87478595abae24297be8f117730b939 GIT binary patch literal 6695 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 CKW*~> literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/__pycache__/ipv6.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/__pycache__/ipv6.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ddb00182122916689bca642fc0fb7acc58eaf4bb GIT binary patch literal 6858 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 TixgV>P}{l9Ti>G0u=;-itGxv4 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/__pycache__/message.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/__pycache__/message.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..044c59ff941597730ff5da9f27065aefd26baa34 GIT binary patch literal 83663 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 E1)c7MB>(^b literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/__pycache__/namedict.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/__pycache__/namedict.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5265982ea0084439887c4a252fefb84aae945a98 GIT binary patch literal 4356 zcmb_f-ESMm5#PNJ>LijP_2ER4zfPtcg|bb;PEZH6>&7je!a&RxR$CZEiqnaAl1@62 z%-u=01j-N!1Em``CXp1B(E=8NKGg6Z&_4Aa=!@hJm^kPmK%VkuOHNVbsWW@z=_D}- z0`ve5_hxtIW_Mbx#%M&2=s1=U*m8doH#+kI`pQ729P znp!Fuh3RbGlk_OpeA&st;1BR|o#ZGOz-ctcPZN#%g64z@nF15;NI4Ndp9^Us&<-sG zRMI+tc4`vPF0B)2SnC2B(ZWEZ6>^K_y2nW};!0UCF9X&s|KoDNO8MqY(bnZTeaV(p z3+yl0Dcnd3m&?V;Sv~LAsje;=o~s2})ieY5Cp$%XQituxrZK0>s%+`g3#Mwxzglu; zV0!l$PRq`WVKez%rkqznmuVN}Y2ASZ@LgRm>9!-!t4@AKo+?_PbJ|$c3us!3i6?ot zb6&lrXnM(+abx~aF&ur~b~_Zsc8Zpsr-1|RfHAn6>{NmLnbwKpPu}IrW`18!#$VPv1{jJUZne*{AIH6Y-E zaCgQ2zg@fiBz&@w7=4jAznM7y&*9C)g-YgmMBa+Vt9_r`SQ8$0Kj?lEeQWEe zyx#Yh8{O`x6xD0kTROvA+A|yXCc?Z^q;eN%qY0^Awh#rW0+?%q47)Mg#DQIJBHqdK z3jl?ah^v@zfDc`UZ4_)rE#!5VheUJ*oNxs^DYxsls=1(Fv8pv7 zS?Cj2TtrD5&k7L2i#2eC-PRR8_kCE-G902SHn^7ftNrlSgIf<*9;`fzo!RO=vT^js zPkS$HL@qRr3|EBvk-L%V_@*=nnf^jLz9}7F=buX>2ZPD?ngGf1UBNUP^fTCjPw+H@ znA^fy@If2DGF<3~Imy!!q<{qa614_@LB5(Sm#|5Ajy|=w^KM@AP?m>=h48fR)HeFA{vb1RK!D_}e)RWKaIKMfldqjT7q#2qZaI zfUSDD0EmN-YNPsQfa4_#(*QJkE-%LVC9d^QW-HcL&D1}vefTssyde$$|E=`A$nY?= z&qSzY;9>v^;{hmSoa;dYd#mr(FV-$T4ZxreZ?F!>>==*101^rcn0A4=2-wUH&N>R~ z4q|i1jA|=@N&#b2w`+@3`b=F z;d6@1Lwhg|*G-vx&o?4$8+!<9SP_4?Tv?prprYqhH0}eVptY%=p*kPK3t~(*pj5~5 z+HXsmwLHMR{ObdCw_&r@X0ZSTpW}5j2Q)y-0JWpsEb38_DzoxcE6%I1x;WMRcuJPD zMMnpfsw0mDmY`XAb3xN>uil3~q6_ul)3V#aqBdZx$3G3)~(_9jEM zUCbL$l56r!!^Cf2~8S?IF!ztFNow^1m)#QYvogrS-j0zGoM8RT9rB73L}@!h zdM>VBeJyl|r?z`V@#J=>^uXw51GLV-%rS#Q%gbsZZBJ|W( TB=$OVmC{7z_BRConTG!XPLZ)} literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/__pycache__/nameserver.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/__pycache__/nameserver.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..3ac1d766c271848c595278ce187df5b976a9c394 GIT binary patch literal 14133 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 BC@ug1 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/__pycache__/node.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/__pycache__/node.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..02cd8f9565df513daaea9c1a6b83c2309ee47643 GIT binary patch literal 16639 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 N(idAF5P)s;{{<^0Q0o8y literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/__pycache__/opcode.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/__pycache__/opcode.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c79686169ae180c3240743c9a39f868f35c476ac GIT binary patch literal 3130 zcmb_e&2Jk;6rc63H~x%MH%&i7H*E@aNY=E79smWRHbGHU7xEz$3u(RaP8z57u9;nj z#OlFFIgnG$Ddq+e2ul7FxFpJm)u-Ar=ECkcAePyxFGg0^WK~H#&3S__h$TO zJRTwN-JaQ6{2ioMsI~Ei7KMVGoC)oSJK5~Nn9N0%sun(*S zQhn9fz09ogu$;FHYO8zbmdSTI2YjXVDF~Z{lB@vrfI4JFBaoF0F&i|btZW3cJv3y< z>txFh$c91h>Chu~Tp#3G1FmTjz&GYvJ-HSrbx$%w7WI=j6HI zius~#qr39vetO9&(KIVlhgmCy{8AbZlzvdK^J#U3nk(sIVIf^!bCxXgef8Guv|VuM zSXs|M(H~PgZJ2i2;uxsqH8-S{^wmPCQmQ7rWYx9-%VcAgHS#iXrUgQGzL*Tp7df>_ z9CYB{EJ+EOl;Fna%_pYyjp>6BgGKKI3?tkNTE$z}=xUypoq}a*`J!&y)vN7HPH{j& z*w_a(@=xN*cIXO23TIMLIE`lNC8}v|MAJ%^Q7NJv)3mQEdeL7Aelb5e^Q9|K`}6GF z#N7O>D`y_gO;3S+{_}eibCYhA=Tf48qQS5X>?{sZ9PsD(AsE(*4;MhNCtz47FJtlA zy4Mk}dyKNSW$ycP(>;GDpGPm4fM5if;NxQ6murz7bp+ z8C7&8m$My~%Z)0|66FC$q% zPcEnOEK&hpayPultdfQ)r37{r4%b0%b`5ks+`$xp8kdIV-axBe5343Q6SMkQFk!F&_ll7U6`;9w0hn(p`22tV2{D-#t zhoG}<`0D8Y-*oL3@9w!CKnZhW?;=1*e#N_qRS+2t^SIz4$NTNs_{MnS#%@&EmK08{ zlac!n!n)h6-C7Rvj(^KY@gv_8;55I!O4D{HECti+AjNx6KJhOwUg1;dbW)2R@Co2p zu&m<29VGH*@*beekP~|ch7Lg7aKY9pWkYu;dk>ZtaQU$92I_P-dgW*N*Z5EIo#@!M zG{&(>oo8=>qZ`6olbV&1D}v<4x!QiFU5T&sOqk{DGk-~35pHXK z8@eJ~q+aUCRbDYy!jthV*?BZ#n(QJDmvG?6>wb9Ogg*A3_i^?SxF8SgKVWEzf*`ye zCc@cQB=I-t-N?poSK(H!bm;eBrr7=TR1fb!r(R4BrrAX7Ea9z5n-r)2Lp#1c?=xFK(#)L ifofw81J&jw5>7meZNzH9zd#t=7_7;s3g61S9RC7nn!t$w literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/__pycache__/query.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/__pycache__/query.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..21c66e206e13f3693a9be3067f9f1676f21769e1 GIT binary patch literal 59067 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/__pycache__/rcode.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/__pycache__/rcode.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..aed870c14f100b44b535e84791b901758f4dd307 GIT binary patch literal 4427 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 p8K@7`+LvgH literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/__pycache__/rdata.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/__pycache__/rdata.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4d8b274f7f545d288866491b979842c7834f74e6 GIT binary patch literal 37461 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 BF?9d{ literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/__pycache__/rdataset.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/__pycache__/rdataset.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..30679f65b0a09e510cc66338f479bf57e8ab2ebc GIT binary patch literal 22964 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/__pycache__/rdatatype.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/__pycache__/rdatatype.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..7ee1c10ef9ec80ebc607a566545b9e0c23084905 GIT binary patch literal 10114 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 J<0xfQ|39{(ftCOO literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/__pycache__/resolver.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/__pycache__/resolver.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..54a32ddeaa12dfd1495ce12f361ef11b74587064 GIT binary patch literal 88375 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 Ul@<`c+Ix#`i|aiiw=44h0sh%Nh5!Hn literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/__pycache__/reversename.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/__pycache__/reversename.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..084a125ee4b0227ee098769f2875bdb44b4c30be GIT binary patch literal 4724 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 JQ_o} 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 UNxOduVIF+`!=WeiPBrO20j(;4c>n+a literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/__pycache__/serial.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/__pycache__/serial.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d0cb00c9be500f48a1961df262ec5ad0ccc45fd9 GIT binary patch literal 5182 zcmeHLT})F~96#r_x0HTRks?&l)q#fc)xdNc&gh)tg3cz&)C3>8(tDLcY4O}!vevSg zjR%@-5uYfT3z#gC#s~08_cR|hdl;Y(O~Zr9_Trn;hb2Dk|39}a6spr~Sr+vq{hiOA z^FROZbAPp3O$18Eshj7wR1oqzcJf7^Yh>%7F-auSO9b*Mk?0tagqwmk+e@Q5mp-<; zM`i(E(CLW`^~ub6h^hU7Az2Oho#$D2$a(7MVP|{ihaLX>-dKydPWB6EOcI&&QaD49 zHc3?0NrJ39ua|UVVy|A(kC9$c5&;d80kBLe12jrTz;dY^&?K1v&5{|=B3S^fk`=H* zssOY_ZLZ3UL8CDvj`)HRIiv3jsES{gBLXXI<1gC+FiGN6qH!T+BqU}aBu>0As+G6^ zJ(}-DiA(T2Mt-COhD>94GnX!-SLERN)e!~vb~>HUj=THAL$aF<%PI?x1pNJOe^`>; zCjyG!-8LeJM%=+bpL;l}_J>37wY7J+m4GU@4*UFrz6-MAmO_eK;p}c3j%JKrZy*#< zz22BjyI)&=pbU;vY5^{jboJKc$r=6B*{j}h{dcCcy>?vxeR&qm?KV0?NEB( z!4E)l3@WmQmmW~L0dAf75v_(jONTq!dZ zp0L_IG#r$NZ?5b>@;!uA0!P_qge?H;+`LVqa36Hcy$C%=NS4oH=Elmu?T- z8dz-n_-^|>`)`i>j)l`_?r&c_e0HhvY`Ur@ZLPf0o9IpMnr@zIUb60*ZJ29HHO)tE zU%GW^vFVe$C)1WqSGp73Nt!tER3{vzrWGPIo1Pemz4lR6?MBr`|HK{oR%k$!21kv~ z?@OwPRO`WtoH?aR+fuODmayA|{6T|)0As6~h$KdrY%MeTnaFj^g0W>I75Y3CZw(AM zv8KG5QvWXuENARdJ=+c!dA?a)C^jqXw&EY02pe4R-|HzDcHZs3i(8a(`xlB;6}und z+J=&67PPXByM5p;EL&ej1r_aw7f6EeKfDyu7ArWo{NS2;R2Om-{j=ag3;)!`DXdzP z#C%OvOx<{i>u%XywFcmy9=n;s< zi(!K`BeVgm6FNT4G^ww7n(=|pU~%>FO=~323VtH@`sQueAdKQ~mcH$cuFW z9Dow(D{=t5e-3r017Sk|c{8lE6$H_d^gkg`%~oZxS}{`b;EF*MT`LtF zEHG9_#nu(W+E&9#omI52?68OpS#0qe@-sXxAp=S%h5hi61!_7#H2_x%fsPDFwL literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/__pycache__/set.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/__pycache__/set.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..eddd8df54388cb6775e8362bb920d9d9bf8f67c6 GIT binary patch literal 12157 zcmd5?du$xXdEdPkmv=|r@hOVpV5CJnMzAvKT!MUa1NGH43{ zE&BUrcK4nlc1%r2h;#ym0ATTsS;qdS`8RfpHYK1eZwI&gjQG$1JLIU(-$&57UNKPR3Q-fR$r>z+Ab!tadE|Ic~u+v7#yR+CSd zB{BA7l$TSwr7KB2LwjTUx7kB1I>InJLfZtTG=ugGM#&>1L+O+@GSbiH=zIyrU{IgU z;aj6MhGO2FPt_BaL0ILyimFnNsU^pFkB?2D&0_S!^Mm8*No~-W(kvr=RZol$Ceo@l z_^NIu1_!QcsjGuYeRPns^y>p({o0_3=|`uO#1-YTW)6bggW%!7)ND?Q#|g7|JQKc% z9;YSaMdmSp8^W){LUZf;uh08#1-C-cwNTquOZ&Fqt?69!eI5|%nwF&{X{GVcYrm*M z-{)Q-+`fZ(Lc%3H8ddl)Mvb5XyCLRTWl=vXV2NX2oG$!N(A<*Zu-9Rh^PdR_!bKtG z8OlVk#R1wPHr3Z-#$vvl&(NlfoR1{cCg~Mz)?5{hYOHP&wz3fdB$Ck3JV|)#C=ELV za6{ON$Ui#vm%a}#eKfo}{84;0zJBz@^}dtqU8k~G6GS4AVLKH}M&_&kQ&61nfR3RPqBHc49QNaYarLlU&=VcRmul$)e7GT)pbp`NKC zRzt+TLQlH@ZU|syIJ#&pXO=SA(7~(nc=$x{{pMSlwu*{S@pr7ckgjnILVL*MEn`^a0SGz18ho(Z=QAQgG#1HY)$; zgUG&ZL9A|nP~Wyj`$qMlNhEu>CMqmOWp5EvT>=nez|@K?ogfmGlsQoq9ZxBOIM{aY zF58xMSZf1@H)RbB#XOt>-l_Cd`G%`hm;l94Ga=fs-FOkNH;Fck&DAxxgA2jiwF|Y2 z*2<+%C7ZK_>PjRml-9@In4_5A#R}I&SXmM3C}s}lH>Vh*x@9N^>_6s!TzzyLu*rV2^*3G)EY+cuSUC%;bzHa{X zRwOzvaRDyerpvz^<`%k-Ianx%KSmAs>WVG~+U2^K3gZc_QBtmpb7Cc{H77cD>bl3G zjj`g8Y|ayR9nzdg9;;^_lUxrhwP#9b8P!n`KBQ-2 z@bXi$6bLxV#RCqI7(s^yFAfK-$i0aqoEXF}ZKV_GWG_Z5mTXRsvLHockp#JR9-{roL<>4kLiYqCCp)-VabMOO&ci$9|(%5JEhGa;xH{lI_#C>8jpMk8TN8}+q7%lK^ye2EJH^G zgdSBJ(`i8jB8(#T77H9bi^UvD$c&06wn+AO#(==`c?jT?JB+Z-`gf7y#T!6oU8&h6Ck0s1Y z00b{-v6YUEP~TR4^JaZlw!UlO%xCq@%L7XT^Jlhd>uz6JxU$lyxx%`3=@4GY3~r%1qmPQCP#1+& zF>`QFsfWWnf>}mAKuHup(wdI~cWowID%SsmPn=Z z`lBQbO;O=GY!wAPT%~x}#%E4W!?ui)r31NKlQ0zX=Yl%4iCYMR=w$3CKonq6(W>oj z{A?W_IeGDr^p?eiVWy*Tt}B@+aig$j9AnLI06-UlLbP?I=SK}2ksb;q+E1+4Kfe}! zek&ANe0Jf5t#JKTwZa37roRsGIK2IJKxo>} zP1$;5_qO1v?g5J<4J*&yJ#pv6Cy~QjjV;R;mM*MV*~acK{CK32J3eb^zZ<#}f`-?0E&Aw`5nc)- z-i{uEiq~}Q!t$Tvb^k{!7bYq()pZRlZBi);bw?oL6ec3rKuIYS3}z6XFBb|+K_&t| zA)P`_$aM-Zv2XKCR9^9I&P$azZ=ArZbKycIHl9P5L5DOu!ZGL&n5)7u(?}{)#dhI< zIXj8C)6f&~GHJ+kl922&U=iz@ZvsGE0(SzRWz6f9T_PIo%uR^mZ?l?%sE@LQ}EN&iS@8}-k{?o z$bvFrob8tx&x{y4iuvVdNMx#sGpzan4WR%L5n5P?G*Hy}-sHR&k)|DGHf>0q1ra7i zl}`EJBIFNuCuE_tmeSLWaGoMve-HaLC{`(=r9p`T9@rEj^cOVFCTMLbK|8Zj=RN<1 zbojSS(A7r})Rn}ec{%Kt^#L3TNn$Cjz|+ul9z!(YjxUNhae_0`{P9zhWwJlzG|vU| zRwh$RLY!~^WH-XMXC<-?MQ5eoh9v*$5rpq^DOo`Im^>%rflWhKl4%4Pj2Jkh9nUj{ zD6Zk$j01qX8cU?x3vlb>E<;xhI3BR;3iuB9?5-PFC?DKCxfwcDnRShoJVB;~m{{ov zg>sG_MN9RlH!H#PZ%6}s=}|XUd6b3EXPD^lOS#}P7`*l>I{BXTw(-)mZr^sY(0PYWaC6|7$wAGHu4YWyP&9U@S6^mbjxmn8?K&nvzj zd7eBuSR;#}W}ZFoEWEQay&maVlPVk`eq($nhNy_oH6|@Kdst(G@F`$VUpCVBA=opx zCJpXFp*~F8TZSo?yeKfCfh4mSu9DE`g;=r1CYIl60)P-p;Z13OR@%SPvmwb4>G{yp z#0$dATxl6zbgjmv*|}C@t$!wZ6<{W3C5ZEe)ce#iGw4dRoQn)ECelY=&>BveQE7KcN&r>H3Fgrz?t%w_}Yl@7J+)wgk z2nC=lPU2q`@W2Q;?&*>g9(&*}HmS_Av>Ot7n9MK1DZtMM^+O=L1cH>G$BkZeb2r3a z@+-7WWS*eGpGSqJ)?M>tg%l0s4x?Q|I$+F@N?fDWM9WMu)HzR1?Li3o1C&{ z-K#ft!Ys|vvQB;qVVQ@2$9g8^lyN5|h3UqPA3i>nTFZ6J#oCsaiuY~Ez?E(U?JH1A z+ejK@SjuG@US4}U@8zlf5Ca`EWPAB<-Tls;@4$MmNqyz`xvu0eChl#x!wyDZ_}HUx zN@;nVsQzDsQzHP3cEi5q6H6!H+8TP+3cOn(qg|Bx8A|!@36Os%41@8M%6)sTO{$nD z=S^xUo*OL9{38&-v%KeJ4FL<7lux`NJc!gU9$P-Xbo{+{)}#(jt*43_ed}RV#*OSZ z9s)VXK(UsWu;X#TgGj^TSxPUiM>^M}&T?jw3NjU`#iYIROvcOkD}sE|xKb(@bPp1x ziwlG{T--w~^ww7FB?6a}`##>0=b%La2P?lBMs)k0!TkF~1^Ty{$G#l-B{gC}mRZXA zO?-u<8H81?n&@t&)3_Q7=)9jN8gZjwSol=ON>35g08`pE3n>gru;xU)D9R1RDb>Ye?RtjW9u!it~U&=g@^vNeC)^K$ESblUvGJFz2W3q_++^}5Pg|E{1BBr z<>6pn9_X5gu23BM;j#dkKb9j5pu427>wr332T+Ev(sO$?d@RCazL<}v_uj@rj0H?1 zoDAMI^ya);(kjYeJ1@O|opQC^i(V%^Z!Y~I zrE0tRS5E93k$d8u=d#h=lDBhMelH?E`rfS)VL(<`C`#HvZ7L9s-@#DE9>n#=e3^4E z=TmC3LU;A#!{F3ye}6K6(eI??6r8t5A={L*qr?ammSjD5Y1L)}iAlkYS$R%f!Y7C9 zRopZ=tp+0cX-0H>Nmlt?}&hbwoJ^znMjeGf9 z^?3mwvL$mD3gN@2i8OLR4uzcdQKHaECX5dvI1`rN&^q_B4t@A1ai2sEmeYr)Gd%Q> z8GVbw?j2*#(C33GWVrFAMKB(pOsmsLs)yt8x2Kh){RAO~nogh_-({G|v}NLR4Dyo( zxi%gow^EH=U$s$2&3K= literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/__pycache__/tokenizer.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/__pycache__/tokenizer.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b5f268c3fa1f50687b0fc136c6cff04f00133227 GIT binary patch literal 26544 zcmeHwdvH|Ondj}NT2f2hl3EWWfv#Sl1|jh<7z4o(NEl%wVk2Tlq-I~PwiIiwK@0nx#yhwopZkLJKyVE{g0B8A`aKKSMCfqyv}jIq95wz zP%?`dWUg`oH^2!N!5Xp*SlHb_4;&xCO^4%Rq@>87LK;10JDZz$>^0%7ns!a-nFTLMR^aS-BTD!TlB|l!%2R z8�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 TrT-MOzgb}E_zg!XV`={f8OX;V literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/__pycache__/transaction.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/__pycache__/transaction.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c1042b4d45a4488ea2f79e731fee5a65eea5ea96 GIT binary patch literal 29402 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/__pycache__/tsig.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/__pycache__/tsig.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..61eb53568a5b949f615f48424e7241346badd2c3 GIT binary patch literal 16756 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 CLzu$= literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/__pycache__/ttl.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/__pycache__/ttl.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4db99ca6a55dcf38adcbc3db1717ce20cf3c4fc4 GIT binary patch literal 2443 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/__pycache__/versioned.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/__pycache__/versioned.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2f73cd0f94acc8230b9ad3f9b4fbf4e2b38add3d GIT binary patch literal 14685 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ᄝcS9~gDsz@u#AF1^-zsOo#pX!z^jZ?ZcC8@HlMAS%G q^<>3@icPT9VPqAK-xk9}RL-ZI0p|1%%B}`Rm*rL!6CNOJ7b8w zrb3911Qn5JrM1}~!WW59RaRPQ`Rww$KM7umbU@ll{aOAD{#aD?W6!xW;KNP);i<|fF9(Q_jljQI&ZDU1k7 zaYRhoMr@q%%|6n^c%_jhp8S%?!VMye4|rp>5l5B_*mZrLNc2Y~E zQ?Uu%c0MyXp~MY-1KP|%CCK4X6oT82@bU(kQv{h;#8DBpfg{Kw;Jj?RA&%H(yCT9^ zfNxDOZjv|3QkCKWZi#*639RTsI}Avrg(-@C8foMnhg=hUu7CVf#kV7iB><$I06wHO|!&K z@?_j1*7OfdPMA~OA_DbvZJTxDc7lY8TU~ec?TOBWglZ`X*!XOR+IUjmRlAf}#sgW_2kVO{5Z9G@5f8 zQVm-K7i^}!1K=822?VFbFB~f!*twqj+h?^xb}sveK^RKkIDIQF&+Va^q1my2xH?yY zTc*WZEfttZbURhF3{AzW!UiHrfT^Y*5Kv7+p##-)C19$y9Juj0vd9gGc-jI~Cc#CH zdH`2(k1py3s5_{VjKQ^1V>yp`t12acylnvBT5kXCshO!_&)wcTz0236UY{~@`~p>>VdUJ;nFSq6UTI2?7OR$Xr#S6kD@?P~}y zgq6uSTFRORR2I+b$#0-?IbhpJu7WL2aSi8jIgn+XU$s;XWy>0@*=pgdedC?1*atS> zWbx+tbA&>~B_W9hq08*9#T6C@b;pS`O@2UWny#9;E+k`9)Qz(Qrdo>8Mz^Ok z+GIwvoWRudn4(25WHm*tYPw44fLW>vfN6U6vzyr^DL9>7ak^)F3gNkM$@lgX=iASH zZH2zMzNfy>vM;pc3axnC3LEA&6#MTUx^rlu=d0eu-baDuU5A&vgVXjE$#vUx(^V9g zrOmfo&x4za$M2rGb7rCct3!*2O2Gl}hn5w0+jNUzM^5nVG3{b>ojGApVCIwpq(C%) zMjJ=!ng-&o29ecIdCm$nGG~b%mE4fG8kEkF5I?L77ZPKOf-WRdn%+E0(@8^wv|b-nxO zlalus2o>D$^O?_!qb2vYC21QIU0uXLcVW_c9}pHX8aNx=yn*a27qnyr=GYF4K>X-} zj@cw-c7iLK(W3=#QH>Y5K+WB%)E;10(V~qgg2$KdrtYLlo#B!@vLr>;-vS++-Qr_F zKUYXq8e#Zu4>ZKxh$Y}fL_Jn9N&HP1uo073@F&HYBUqqbbBU+!QZ&^+Uq*- zx*0HqfjSprlpU~Gr5gaK&)s(W>de*R`T73)gZBm>c9*vHm)!3>j4itdmZX87>Aojl zU{q!IrG1F4y`WMbfwG}n5uhKuS?2u%>ki#Nup6eRn*pFr`IzT3 z*ID?e)ERl$R&pO$k`6F^==M>_4l%7R6JtJPZbSk3Z*IggbA#Yn<9rSB?rLbY1h9I2 zBYcQ747<|^f-V5M6pu~BG0a0`!D@uQ3qVDob(v9x8KU8jbwV*n`;dJbfK^BP_5At! zpWgfQFDL$b_RnX(K2hpFRoZsCkGZX!Lz)z0=sLwbOIx((NEmAGQe&p>1U>Flrb5Gqnm)$!T0ws5N zTKvZ8UGaAm-kW=Get*foYx+3knrWwDT(&D06Nj9UbMX^zI5&9Mad?#3T^#S0uc15v1%Q?-+hA)Ui$bpgJ8Y$a}%R9U0 z=E0&3(ynw*dJ^2ZuHNa`4E4Ip2!ORlfrr})zshNd0;dRvnfGTcd#~~id@VF8eOZxP zD^QvIkuPxY1Z&LSu&lmx0A&4>%5*pvKJ{wUxpfWY3YijqORjKV3RgIzAhsLD#~M{* z zPR^a2c9eOCqkE-eQz1W>pO=?Az=ggz`OM`lOT-hnouA1UwYyVyrk=QWJa6AnNX{jn zw)ZW!_bqw)$^!B11Op6qPanT^^7U*MyC2joaGL8!xT8JX-^3%%qe1f6Bf;Qt&~da| zc-$=jUYCZeRw%dnz;GA(B&5O+nRpJieb z<`)}#8&S+G)Q13TR-+Ewi5M$@FeB4`1mFRL{sMq5fMHS0oOBQYs(~Iyfbm9ej;Epe zpVHuO2EEn9ld%;1yFe)hP&$O*6o5sev|_I{ikX7}d=jcHprsq+C2zNN6+bBx=oZdZ zuq%5w+m7PC3W2U{Z?d%)<7EQfyi&pLrH{95UpQAL&^>CaU{{tn+wNipXY4N9Iom;F z_CW(bhV*s#K#|c0kY|{i_m_cbm|K7av43e7ZGqy{f_r((K$!sk_1Ow`WtYwNR&i^Y zKsVo0!LHm&?4GB#&ShI?nQygq&kJP&-GcNAyNW>UTNu6ERl_IRLi0Oc!HOZq@RA3N z#b73%P&54qWrbCSZr8Gt@K=T*Sf&Wni_Wrs^(AejTFI&e3{juMHT(#?0KS(F8CEh# se*;7G5ms`P1&-q?cEb6dk(Pgw-euDJ9SJ-m?tj~dIWF{yAY{w@2X}A?=Kufz literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/__pycache__/xfr.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/__pycache__/xfr.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..74c8164d234e6f396bd3f184e874c14f65e771f3 GIT binary patch literal 14488 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/__pycache__/zone.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/__pycache__/zone.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..3891ae027edc367c30e0bfbf7004ef35866b6c0e GIT binary patch literal 67615 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 0: + infos.append(_SVCBInfo(bootstrap_address, port, host, nameservers)) + return infos + + +def _get_nameservers_sync(answer, lifetime): + """Return a list of TLS-validated resolver nameservers extracted from an SVCB + answer.""" + nameservers = [] + infos = _extract_nameservers_from_svcb(answer) + for info in infos: + try: + if info.ddr_tls_check_sync(lifetime): + nameservers.extend(info.nameservers) + except Exception: + pass + return nameservers + + +async def _get_nameservers_async(answer, lifetime): + """Return a list of TLS-validated resolver nameservers extracted from an SVCB + answer.""" + nameservers = [] + infos = _extract_nameservers_from_svcb(answer) + for info in infos: + try: + if await info.ddr_tls_check_async(lifetime): + nameservers.extend(info.nameservers) + except Exception: + pass + return nameservers diff --git a/.venv/lib/python3.12/site-packages/dns/_features.py b/.venv/lib/python3.12/site-packages/dns/_features.py new file mode 100644 index 0000000..03ccaa7 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/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/.venv/lib/python3.12/site-packages/dns/_immutable_ctx.py b/.venv/lib/python3.12/site-packages/dns/_immutable_ctx.py new file mode 100644 index 0000000..ae7a33b --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/_immutable_ctx.py @@ -0,0 +1,76 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# This implementation of the immutable decorator requires python >= +# 3.7, and is significantly more storage efficient when making classes +# with slots immutable. It's also faster. + +import contextvars +import inspect + +_in__init__ = contextvars.ContextVar("_immutable_in__init__", default=False) + + +class _Immutable: + """Immutable mixin class""" + + # We set slots to the empty list to say "we don't have any attributes". + # We do this so that if we're mixed in with a class with __slots__, we + # don't cause a __dict__ to be added which would waste space. + + __slots__ = () + + def __setattr__(self, name, value): + if _in__init__.get() is not self: + raise TypeError("object doesn't support attribute assignment") + else: + super().__setattr__(name, value) + + def __delattr__(self, name): + if _in__init__.get() is not self: + raise TypeError("object doesn't support attribute assignment") + else: + super().__delattr__(name) + + +def _immutable_init(f): + def nf(*args, **kwargs): + previous = _in__init__.set(args[0]) + try: + # call the actual __init__ + f(*args, **kwargs) + finally: + _in__init__.reset(previous) + + nf.__signature__ = inspect.signature(f) + return nf + + +def immutable(cls): + if _Immutable in cls.__mro__: + # Some ancestor already has the mixin, so just make sure we keep + # following the __init__ protocol. + cls.__init__ = _immutable_init(cls.__init__) + if hasattr(cls, "__setstate__"): + cls.__setstate__ = _immutable_init(cls.__setstate__) + ncls = cls + else: + # Mixin the Immutable class and follow the __init__ protocol. + class ncls(_Immutable, cls): + # We have to do the __slots__ declaration here too! + __slots__ = () + + @_immutable_init + def __init__(self, *args, **kwargs): + super().__init__(*args, **kwargs) + + if hasattr(cls, "__setstate__"): + + @_immutable_init + def __setstate__(self, *args, **kwargs): + super().__setstate__(*args, **kwargs) + + # make ncls have the same name and module as cls + ncls.__name__ = cls.__name__ + ncls.__qualname__ = cls.__qualname__ + ncls.__module__ = cls.__module__ + return ncls diff --git a/.venv/lib/python3.12/site-packages/dns/_trio_backend.py b/.venv/lib/python3.12/site-packages/dns/_trio_backend.py new file mode 100644 index 0000000..398e327 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/_trio_backend.py @@ -0,0 +1,250 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +"""trio async I/O library query support""" + +import socket + +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: + return trio.move_on_after(timeout) + else: + return dns._asyncbackend.NullContext() + + +# for brevity +_lltuple = dns.inet.low_level_address_tuple + +# pylint: disable=redefined-outer-name + + +class DatagramSocket(dns._asyncbackend.DatagramSocket): + def __init__(self, socket): + super().__init__(socket.family) + self.socket = socket + + async def sendto(self, what, destination, timeout): + with _maybe_timeout(timeout): + return await self.socket.sendto(what, destination) + raise dns.exception.Timeout( + timeout=timeout + ) # pragma: no cover lgtm[py/unreachable-statement] + + async def recvfrom(self, size, timeout): + with _maybe_timeout(timeout): + return await self.socket.recvfrom(size) + raise dns.exception.Timeout(timeout=timeout) # lgtm[py/unreachable-statement] + + async def close(self): + self.socket.close() + + async def getpeername(self): + return self.socket.getpeername() + + async def getsockname(self): + return self.socket.getsockname() + + async def getpeercert(self, timeout): + raise NotImplementedError + + +class StreamSocket(dns._asyncbackend.StreamSocket): + def __init__(self, family, stream, tls=False): + self.family = family + self.stream = stream + self.tls = tls + + async def sendall(self, what, timeout): + with _maybe_timeout(timeout): + return await self.stream.send_all(what) + raise dns.exception.Timeout(timeout=timeout) # lgtm[py/unreachable-statement] + + async def recv(self, size, timeout): + with _maybe_timeout(timeout): + return await self.stream.receive_some(size) + raise dns.exception.Timeout(timeout=timeout) # lgtm[py/unreachable-statement] + + async def close(self): + await self.stream.aclose() + + async def getpeername(self): + if self.tls: + return self.stream.transport_stream.socket.getpeername() + else: + return self.stream.socket.getpeername() + + async def getsockname(self): + if self.tls: + return self.stream.transport_stream.socket.getsockname() + else: + return self.stream.socket.getsockname() + + async def getpeercert(self, timeout): + if self.tls: + with _maybe_timeout(timeout): + await self.stream.do_handshake() + return self.stream.getpeercert() + else: + raise NotImplementedError + + +if dns._features.have("doh"): + import httpcore + import httpcore._backends.trio + import httpx + + _CoreAsyncNetworkBackend = httpcore.AsyncNetworkBackend + _CoreTrioStream = httpcore._backends.trio.TrioStream + + from dns.query import _compute_times, _expiration_for_this_attempt, _remaining + + class _NetworkBackend(_CoreAsyncNetworkBackend): + def __init__(self, resolver, local_port, bootstrap_address, family): + super().__init__() + self._local_port = local_port + self._resolver = resolver + self._bootstrap_address = bootstrap_address + self._family = family + + async def connect_tcp( + self, host, port, timeout, local_address, socket_options=None + ): # pylint: disable=signature-differs + addresses = [] + _, expiration = _compute_times(timeout) + if dns.inet.is_address(host): + addresses.append(host) + elif self._bootstrap_address is not None: + addresses.append(self._bootstrap_address) + else: + timeout = _remaining(expiration) + family = self._family + if local_address: + family = dns.inet.af_for_address(local_address) + answers = await self._resolver.resolve_name( + host, family=family, lifetime=timeout + ) + addresses = answers.addresses() + for address in addresses: + try: + af = dns.inet.af_for_address(address) + if local_address is not None or self._local_port != 0: + source = (local_address, self._local_port) + else: + source = None + destination = (address, port) + attempt_expiration = _expiration_for_this_attempt(2.0, expiration) + timeout = _remaining(attempt_expiration) + sock = await Backend().make_socket( + af, socket.SOCK_STREAM, 0, source, destination, timeout + ) + return _CoreTrioStream(sock.stream) + except Exception: + continue + raise httpcore.ConnectError + + async def connect_unix_socket( + self, path, timeout, socket_options=None + ): # pylint: disable=signature-differs + raise NotImplementedError + + async def sleep(self, seconds): # pylint: disable=signature-differs + await trio.sleep(seconds) + + class _HTTPTransport(httpx.AsyncHTTPTransport): + def __init__( + self, + *args, + local_port=0, + bootstrap_address=None, + resolver=None, + family=socket.AF_UNSPEC, + **kwargs, + ): + if resolver is None: + # pylint: disable=import-outside-toplevel,redefined-outer-name + import dns.asyncresolver + + resolver = dns.asyncresolver.Resolver() + super().__init__(*args, **kwargs) + self._pool._network_backend = _NetworkBackend( + resolver, local_port, bootstrap_address, family + ) + +else: + _HTTPTransport = dns._asyncbackend.NullTransport # type: ignore + + +class Backend(dns._asyncbackend.Backend): + def name(self): + return "trio" + + async def make_socket( + self, + af, + socktype, + proto=0, + source=None, + destination=None, + timeout=None, + ssl_context=None, + server_hostname=None, + ): + s = trio.socket.socket(af, socktype, proto) + stream = None + try: + if source: + await s.bind(_lltuple(source, af)) + if socktype == socket.SOCK_STREAM: + connected = False + with _maybe_timeout(timeout): + await s.connect(_lltuple(destination, af)) + connected = True + if not connected: + raise dns.exception.Timeout( + timeout=timeout + ) # lgtm[py/unreachable-statement] + except Exception: # pragma: no cover + s.close() + raise + if socktype == socket.SOCK_DGRAM: + return DatagramSocket(s) + elif socktype == socket.SOCK_STREAM: + stream = trio.SocketStream(s) + tls = False + if ssl_context: + tls = True + try: + stream = trio.SSLStream( + stream, ssl_context, server_hostname=server_hostname + ) + except Exception: # pragma: no cover + await stream.aclose() + raise + return StreamSocket(af, stream, tls) + raise NotImplementedError( + "unsupported socket " + f"type {socktype}" + ) # pragma: no cover + + async def sleep(self, interval): + await trio.sleep(interval) + + def get_transport_class(self): + return _HTTPTransport + + async def wait_for(self, awaitable, timeout): + with _maybe_timeout(timeout): + return await awaitable + raise dns.exception.Timeout( + timeout=timeout + ) # pragma: no cover lgtm[py/unreachable-statement] diff --git a/.venv/lib/python3.12/site-packages/dns/asyncbackend.py b/.venv/lib/python3.12/site-packages/dns/asyncbackend.py new file mode 100644 index 0000000..0ec58b0 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/asyncbackend.py @@ -0,0 +1,101 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +from typing import Dict + +import dns.exception + +# pylint: disable=unused-import +from dns._asyncbackend import ( # noqa: F401 lgtm[py/unused-import] + Backend, + DatagramSocket, + Socket, + StreamSocket, +) + +# pylint: enable=unused-import + +_default_backend = None + +_backends: Dict[str, Backend] = {} + +# Allow sniffio import to be disabled for testing purposes +_no_sniffio = False + + +class AsyncLibraryNotFoundError(dns.exception.DNSException): + pass + + +def get_backend(name: str) -> Backend: + """Get the specified asynchronous backend. + + *name*, a ``str``, the name of the backend. Currently the "trio" + and "asyncio" backends are available. + + Raises NotImplementedError if an unknown backend name is specified. + """ + # pylint: disable=import-outside-toplevel,redefined-outer-name + backend = _backends.get(name) + if backend: + return backend + if name == "trio": + import dns._trio_backend + + backend = dns._trio_backend.Backend() + elif name == "asyncio": + import dns._asyncio_backend + + backend = dns._asyncio_backend.Backend() + else: + raise NotImplementedError(f"unimplemented async backend {name}") + _backends[name] = backend + return backend + + +def sniff() -> str: + """Attempt to determine the in-use asynchronous I/O library by using + the ``sniffio`` module if it is available. + + Returns the name of the library, or raises AsyncLibraryNotFoundError + if the library cannot be determined. + """ + # pylint: disable=import-outside-toplevel + try: + if _no_sniffio: + raise ImportError + import sniffio + + try: + return sniffio.current_async_library() + except sniffio.AsyncLibraryNotFoundError: + raise AsyncLibraryNotFoundError("sniffio cannot determine async library") + except ImportError: + import asyncio + + try: + asyncio.get_running_loop() + return "asyncio" + except RuntimeError: + raise AsyncLibraryNotFoundError("no async library detected") + + +def get_default_backend() -> Backend: + """Get the default backend, initializing it if necessary.""" + if _default_backend: + return _default_backend + + return set_default_backend(sniff()) + + +def set_default_backend(name: str) -> Backend: + """Set the default backend. + + It's not normally necessary to call this method, as + ``get_default_backend()`` will initialize the backend + appropriately in many cases. If ``sniffio`` is not installed, or + in testing situations, this function allows the backend to be set + explicitly. + """ + global _default_backend + _default_backend = get_backend(name) + return _default_backend diff --git a/.venv/lib/python3.12/site-packages/dns/asyncquery.py b/.venv/lib/python3.12/site-packages/dns/asyncquery.py new file mode 100644 index 0000000..4d9ab9a --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/asyncquery.py @@ -0,0 +1,780 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2017 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""Talk to a DNS server.""" + +import base64 +import contextlib +import socket +import struct +import time +from typing import Any, Dict, Optional, Tuple, Union + +import dns.asyncbackend +import dns.exception +import dns.inet +import dns.message +import dns.name +import dns.quic +import dns.rcode +import dns.rdataclass +import dns.rdatatype +import dns.transaction +from dns._asyncbackend import NullContext +from dns.query import ( + BadResponse, + NoDOH, + NoDOQ, + UDPMode, + _compute_times, + _make_dot_ssl_context, + _matches_destination, + _remaining, + have_doh, + ssl, +) + +if have_doh: + import httpx + +# for brevity +_lltuple = dns.inet.low_level_address_tuple + + +def _source_tuple(af, address, port): + # Make a high level source tuple, or return None if address and port + # are both None + if address or port: + if address is None: + if af == socket.AF_INET: + address = "0.0.0.0" + elif af == socket.AF_INET6: + address = "::" + else: + raise NotImplementedError(f"unknown address family {af}") + return (address, port) + else: + return None + + +def _timeout(expiration, now=None): + if expiration is not None: + if not now: + now = time.time() + return max(expiration - now, 0) + else: + return None + + +async def send_udp( + sock: dns.asyncbackend.DatagramSocket, + what: Union[dns.message.Message, bytes], + destination: Any, + expiration: Optional[float] = None, +) -> Tuple[int, float]: + """Send a DNS message to the specified UDP socket. + + *sock*, a ``dns.asyncbackend.DatagramSocket``. + + *what*, a ``bytes`` or ``dns.message.Message``, the message to send. + + *destination*, a destination tuple appropriate for the address family + of the socket, specifying where to send the query. + + *expiration*, a ``float`` or ``None``, the absolute time at which + a timeout exception should be raised. If ``None``, no timeout will + occur. The expiration value is meaningless for the asyncio backend, as + asyncio's transport sendto() never blocks. + + Returns an ``(int, float)`` tuple of bytes sent and the sent time. + """ + + if isinstance(what, dns.message.Message): + what = what.to_wire() + sent_time = time.time() + n = await sock.sendto(what, destination, _timeout(expiration, sent_time)) + return (n, sent_time) + + +async def receive_udp( + sock: dns.asyncbackend.DatagramSocket, + destination: Optional[Any] = None, + expiration: Optional[float] = None, + ignore_unexpected: bool = False, + one_rr_per_rrset: bool = False, + keyring: Optional[Dict[dns.name.Name, dns.tsig.Key]] = None, + 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. + + *sock*, a ``dns.asyncbackend.DatagramSocket``. + + See :py:func:`dns.query.receive_udp()` for the documentation of the other + parameters, and exceptions. + + Returns a ``(dns.message.Message, float, tuple)`` tuple of the received message, the + received time, and the address where the message arrived from. + """ + + wire = b"" + while True: + (wire, from_address) = await sock.recvfrom(65535, _timeout(expiration)) + if not _matches_destination( + sock.family, from_address, destination, ignore_unexpected + ): + 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( + q: dns.message.Message, + where: str, + timeout: Optional[float] = None, + port: int = 53, + source: Optional[str] = None, + source_port: int = 0, + ignore_unexpected: bool = False, + one_rr_per_rrset: bool = False, + ignore_trailing: bool = False, + 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. + + *sock*, a ``dns.asyncbackend.DatagramSocket``, or ``None``, + the socket to use for the query. If ``None``, the default, a + socket is created. Note that if a socket is provided, the + *source*, *source_port*, and *backend* are ignored. + + *backend*, a ``dns.asyncbackend.Backend``, or ``None``. If ``None``, + the default, then dnspython will use the default backend. + + See :py:func:`dns.query.udp()` for the documentation of the other + parameters, exceptions, and return type of this method. + """ + wire = q.to_wire() + (begin_time, expiration) = _compute_times(timeout) + af = dns.inet.af_for_address(where) + destination = _lltuple((where, port), af) + if sock: + cm: contextlib.AbstractAsyncContextManager = NullContext(sock) + else: + if not backend: + backend = dns.asyncbackend.get_default_backend() + stuple = _source_tuple(af, source, source_port) + if backend.datagram_connection_required(): + dtuple = (where, port) + else: + dtuple = None + cm = await backend.make_socket(af, socket.SOCK_DGRAM, 0, stuple, dtuple) + async with cm as s: + await send_udp(s, wire, destination, expiration) + (r, received_time, _) = await receive_udp( + s, + destination, + expiration, + ignore_unexpected, + one_rr_per_rrset, + q.keyring, + q.mac, + ignore_trailing, + raise_on_truncation, + ignore_errors, + q, + ) + r.time = received_time - begin_time + # 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 + + +async def udp_with_fallback( + q: dns.message.Message, + where: str, + timeout: Optional[float] = None, + port: int = 53, + source: Optional[str] = None, + source_port: int = 0, + ignore_unexpected: bool = False, + one_rr_per_rrset: bool = False, + ignore_trailing: bool = False, + 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. + + *udp_sock*, a ``dns.asyncbackend.DatagramSocket``, 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 the *source*, + *source_port*, and *backend* are ignored for the UDP query. + + *tcp_sock*, a ``dns.asyncbackend.StreamSocket``, or ``None``, the + socket to use for the TCP query. If ``None``, the default, a + socket is created. Note that if a socket is provided *where*, + *source*, *source_port*, and *backend* are ignored for the TCP query. + + *backend*, a ``dns.asyncbackend.Backend``, or ``None``. If ``None``, + the default, then dnspython will use the default backend. + + See :py:func:`dns.query.udp_with_fallback()` for the documentation + of the other parameters, exceptions, and return type of this + method. + """ + try: + response = await udp( + q, + where, + timeout, + port, + source, + source_port, + ignore_unexpected, + one_rr_per_rrset, + ignore_trailing, + True, + udp_sock, + backend, + ignore_errors, + ) + return (response, False) + except dns.message.Truncated: + response = await tcp( + q, + where, + timeout, + port, + source, + source_port, + one_rr_per_rrset, + ignore_trailing, + tcp_sock, + backend, + ) + return (response, True) + + +async def send_tcp( + sock: dns.asyncbackend.StreamSocket, + what: Union[dns.message.Message, bytes], + expiration: Optional[float] = None, +) -> Tuple[int, float]: + """Send a DNS message to the specified TCP socket. + + *sock*, a ``dns.asyncbackend.StreamSocket``. + + See :py:func:`dns.query.send_tcp()` for the documentation of the other + parameters, exceptions, and return type of this method. + """ + + if isinstance(what, dns.message.Message): + tcpmsg = what.to_wire(prepend_length=True) + else: + # 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) + + +async def _read_exactly(sock, count, expiration): + """Read the specified number of bytes from stream. Keep trying until we + either get the desired amount, or we hit EOF. + """ + s = b"" + while count > 0: + n = await sock.recv(count, _timeout(expiration)) + if n == b"": + raise EOFError + count = count - len(n) + s = s + n + return s + + +async def receive_tcp( + sock: dns.asyncbackend.StreamSocket, + expiration: Optional[float] = None, + one_rr_per_rrset: bool = False, + keyring: Optional[Dict[dns.name.Name, dns.tsig.Key]] = None, + request_mac: Optional[bytes] = b"", + ignore_trailing: bool = False, +) -> Tuple[dns.message.Message, float]: + """Read a DNS message from a TCP socket. + + *sock*, a ``dns.asyncbackend.StreamSocket``. + + See :py:func:`dns.query.receive_tcp()` for the documentation of the other + parameters, exceptions, and return type of this method. + """ + + ldata = await _read_exactly(sock, 2, expiration) + (l,) = struct.unpack("!H", ldata) + wire = await _read_exactly(sock, l, expiration) + 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, + ) + return (r, received_time) + + +async def tcp( + q: dns.message.Message, + where: str, + timeout: Optional[float] = None, + port: int = 53, + source: Optional[str] = None, + source_port: int = 0, + one_rr_per_rrset: bool = False, + ignore_trailing: bool = False, + sock: Optional[dns.asyncbackend.StreamSocket] = None, + backend: Optional[dns.asyncbackend.Backend] = None, +) -> dns.message.Message: + """Return the response obtained after sending a query via TCP. + + *sock*, a ``dns.asyncbacket.StreamSocket``, or ``None``, the + socket to use for the query. If ``None``, the default, a socket + is created. Note that if a socket is provided + *where*, *port*, *source*, *source_port*, and *backend* are ignored. + + *backend*, a ``dns.asyncbackend.Backend``, or ``None``. If ``None``, + the default, then dnspython will use the default backend. + + See :py:func:`dns.query.tcp()` for the documentation of the other + parameters, exceptions, and return type of this method. + """ + + wire = q.to_wire() + (begin_time, expiration) = _compute_times(timeout) + if sock: + # Verify that the socket is connected, as if it's not connected, + # it's not writable, and the polling in send_tcp() will time out or + # hang forever. + await sock.getpeername() + cm: contextlib.AbstractAsyncContextManager = NullContext(sock) + else: + # These are simple (address, port) pairs, not family-dependent tuples + # you pass to low-level socket code. + af = dns.inet.af_for_address(where) + stuple = _source_tuple(af, source, source_port) + dtuple = (where, port) + if not backend: + backend = dns.asyncbackend.get_default_backend() + cm = await backend.make_socket( + af, socket.SOCK_STREAM, 0, stuple, dtuple, timeout + ) + async with cm as s: + await send_tcp(s, wire, expiration) + (r, received_time) = await receive_tcp( + s, expiration, one_rr_per_rrset, q.keyring, q.mac, ignore_trailing + ) + r.time = received_time - begin_time + if not q.is_response(r): + raise BadResponse + return r + + +async def tls( + q: dns.message.Message, + where: str, + timeout: Optional[float] = None, + port: int = 853, + source: Optional[str] = None, + source_port: int = 0, + one_rr_per_rrset: bool = False, + ignore_trailing: bool = False, + sock: Optional[dns.asyncbackend.StreamSocket] = None, + 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. + + *sock*, an ``asyncbackend.StreamSocket``, or ``None``, the socket + to use for the query. If ``None``, the default, a socket is + created. Note that if a socket is provided, it must be a + connected SSL stream socket, and *where*, *port*, + *source*, *source_port*, *backend*, *ssl_context*, and *server_hostname* + are ignored. + + *backend*, a ``dns.asyncbackend.Backend``, or ``None``. If ``None``, + the default, then dnspython will use the default backend. + + See :py:func:`dns.query.tls()` for the documentation of the other + parameters, exceptions, and return type of this method. + """ + (begin_time, expiration) = _compute_times(timeout) + if sock: + cm: contextlib.AbstractAsyncContextManager = NullContext(sock) + else: + if ssl_context is None: + 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) + if not backend: + backend = dns.asyncbackend.get_default_backend() + cm = await backend.make_socket( + af, + socket.SOCK_STREAM, + 0, + stuple, + dtuple, + timeout, + ssl_context, + server_hostname, + ) + async with cm as s: + timeout = _timeout(expiration) + response = await tcp( + q, + where, + timeout, + port, + source, + source_port, + one_rr_per_rrset, + ignore_trailing, + s, + backend, + ) + end_time = time.time() + response.time = end_time - begin_time + return response + + +async def https( + q: dns.message.Message, + where: str, + timeout: Optional[float] = None, + port: int = 443, + source: Optional[str] = None, + source_port: int = 0, # pylint: disable=W0613 + one_rr_per_rrset: bool = False, + ignore_trailing: bool = False, + client: Optional["httpx.AsyncClient"] = None, + path: str = "/dns-query", + post: bool = True, + verify: Union[bool, str] = True, + bootstrap_address: Optional[str] = None, + resolver: Optional["dns.asyncresolver.Resolver"] = None, + family: Optional[int] = socket.AF_UNSPEC, +) -> dns.message.Message: + """Return the response obtained after sending a query via DNS-over-HTTPS. + + *client*, a ``httpx.AsyncClient``. If provided, the client to use for + the query. + + Unlike the other dnspython async functions, a backend cannot be provided + in this function because httpx always auto-detects the async backend. + + See :py:func:`dns.query.https()` for the documentation of the other + parameters, exceptions, and return type of this method. + """ + + if not have_doh: + raise NoDOH # pragma: no cover + if client and not isinstance(client, httpx.AsyncClient): + raise ValueError("session parameter must be an httpx.AsyncClient") + + wire = q.to_wire() + try: + af = dns.inet.af_for_address(where) + except ValueError: + af = None + transport = None + headers = {"accept": "application/dns-message"} + if af is not None and dns.inet.is_address(where): + if af == socket.AF_INET: + url = "https://{}:{}{}".format(where, port, path) + elif af == socket.AF_INET6: + url = "https://[{}]:{}{}".format(where, port, path) + else: + url = where + + backend = dns.asyncbackend.get_default_backend() + + if source is None: + local_address = None + local_port = 0 + else: + local_address = source + local_port = source_port + transport = backend.get_transport_class()( + local_address=local_address, + http1=True, + http2=True, + verify=verify, + local_port=local_port, + bootstrap_address=bootstrap_address, + resolver=resolver, + family=family, + ) + + if client: + cm: contextlib.AbstractAsyncContextManager = NullContext(client) + else: + cm = httpx.AsyncClient( + http1=True, http2=True, verify=verify, transport=transport + ) + + async with cm as the_client: + # see https://tools.ietf.org/html/rfc8484#section-4.1.1 for DoH + # GET and POST examples + if post: + headers.update( + { + "content-type": "application/dns-message", + "content-length": str(len(wire)), + } + ) + response = await backend.wait_for( + the_client.post(url, headers=headers, content=wire), timeout + ) + else: + wire = base64.urlsafe_b64encode(wire).rstrip(b"=") + twire = wire.decode() # httpx does a repr() if we give it bytes + response = await backend.wait_for( + the_client.get(url, headers=headers, params={"dns": twire}), timeout + ) + + # see https://tools.ietf.org/html/rfc8484#section-4.2.1 for info about DoH + # status codes + if response.status_code < 200 or response.status_code > 299: + raise ValueError( + "{} responded with status code {}" + "\nResponse body: {!r}".format( + where, response.status_code, response.content + ) + ) + r = dns.message.from_wire( + response.content, + keyring=q.keyring, + request_mac=q.request_mac, + one_rr_per_rrset=one_rr_per_rrset, + ignore_trailing=ignore_trailing, + ) + r.time = response.elapsed.total_seconds() + if not q.is_response(r): + raise BadResponse + return r + + +async def inbound_xfr( + where: str, + txn_manager: dns.transaction.TransactionManager, + query: Optional[dns.message.Message] = None, + port: int = 53, + timeout: Optional[float] = None, + lifetime: Optional[float] = None, + source: Optional[str] = None, + source_port: int = 0, + udp_mode: UDPMode = UDPMode.NEVER, + backend: Optional[dns.asyncbackend.Backend] = None, +) -> None: + """Conduct an inbound transfer and apply it via a transaction from the + txn_manager. + + *backend*, a ``dns.asyncbackend.Backend``, or ``None``. If ``None``, + the default, then dnspython will use the default backend. + + See :py:func:`dns.query.inbound_xfr()` for the documentation of + the other parameters, exceptions, and return type of this method. + """ + if query is None: + (query, serial) = dns.xfr.make_query(txn_manager) + else: + serial = dns.xfr.extract_serial_from_query(query) + rdtype = query.question[0].rdtype + is_ixfr = rdtype == dns.rdatatype.IXFR + origin = txn_manager.from_wire_origin() + wire = query.to_wire() + af = dns.inet.af_for_address(where) + stuple = _source_tuple(af, source, source_port) + dtuple = (where, port) + (_, expiration) = _compute_times(lifetime) + retry = True + while retry: + retry = False + if is_ixfr and udp_mode != UDPMode.NEVER: + sock_type = socket.SOCK_DGRAM + is_udp = True + else: + sock_type = socket.SOCK_STREAM + is_udp = False + if not backend: + backend = dns.asyncbackend.get_default_backend() + s = await backend.make_socket( + af, sock_type, 0, stuple, dtuple, _timeout(expiration) + ) + async with s: + if is_udp: + await s.sendto(wire, dtuple, _timeout(expiration)) + else: + tcpmsg = struct.pack("!H", len(wire)) + wire + await s.sendall(tcpmsg, expiration) + with dns.xfr.Inbound(txn_manager, rdtype, serial, is_udp) as inbound: + done = False + tsig_ctx = None + while not done: + (_, mexpiration) = _compute_times(timeout) + if mexpiration is None or ( + expiration is not None and mexpiration > expiration + ): + mexpiration = expiration + if is_udp: + destination = _lltuple((where, port), af) + while True: + timeout = _timeout(mexpiration) + (rwire, from_address) = await s.recvfrom(65535, timeout) + if _matches_destination( + af, from_address, destination, True + ): + break + else: + ldata = await _read_exactly(s, 2, mexpiration) + (l,) = struct.unpack("!H", ldata) + rwire = await _read_exactly(s, l, mexpiration) + is_ixfr = rdtype == dns.rdatatype.IXFR + r = dns.message.from_wire( + rwire, + keyring=query.keyring, + request_mac=query.mac, + xfr=True, + origin=origin, + tsig_ctx=tsig_ctx, + multi=(not is_udp), + one_rr_per_rrset=is_ixfr, + ) + try: + done = inbound.process_message(r) + except dns.xfr.UseTCP: + assert is_udp # should not happen if we used TCP! + if udp_mode == UDPMode.ONLY: + raise + done = True + retry = True + udp_mode = UDPMode.NEVER + continue + tsig_ctx = r.tsig_ctx + if not retry and query.keyring and not r.had_tsig: + raise dns.exception.FormError("missing TSIG") + + +async def quic( + q: dns.message.Message, + where: str, + timeout: Optional[float] = None, + port: int = 853, + source: Optional[str] = None, + source_port: int = 0, + one_rr_per_rrset: bool = False, + ignore_trailing: bool = False, + connection: Optional[dns.quic.AsyncQuicConnection] = None, + verify: Union[bool, str] = True, + backend: Optional[dns.asyncbackend.Backend] = None, + server_hostname: Optional[str] = None, +) -> dns.message.Message: + """Return the response obtained after sending an asynchronous query via + DNS-over-QUIC. + + *backend*, a ``dns.asyncbackend.Backend``, or ``None``. If ``None``, + the default, then dnspython will use the default backend. + + See :py:func:`dns.query.quic()` for the documentation of the other + parameters, exceptions, and return type of this method. + """ + + if not dns.quic.have_quic: + raise NoDOQ("DNS-over-QUIC is not available.") # pragma: no cover + + q.id = 0 + wire = q.to_wire() + the_connection: dns.quic.AsyncQuicConnection + if connection: + cfactory = dns.quic.null_factory + mfactory = dns.quic.null_factory + the_connection = connection + else: + (cfactory, mfactory) = dns.quic.factories_for_backend(backend) + + async with cfactory() as context: + async with mfactory( + context, verify_mode=verify, server_name=server_hostname + ) as the_manager: + if not connection: + the_connection = the_manager.connect(where, port, source, source_port) + (start, expiration) = _compute_times(timeout) + stream = await the_connection.make_stream(timeout) + async with stream: + await stream.send(wire, True) + wire = await stream.receive(_remaining(expiration)) + finish = time.time() + r = dns.message.from_wire( + wire, + keyring=q.keyring, + request_mac=q.request_mac, + one_rr_per_rrset=one_rr_per_rrset, + ignore_trailing=ignore_trailing, + ) + r.time = max(finish - start, 0.0) + if not q.is_response(r): + raise BadResponse + return r diff --git a/.venv/lib/python3.12/site-packages/dns/asyncresolver.py b/.venv/lib/python3.12/site-packages/dns/asyncresolver.py new file mode 100644 index 0000000..8f5e062 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/asyncresolver.py @@ -0,0 +1,475 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2017 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""Asynchronous DNS stub resolver.""" + +import socket +import time +from typing import Any, Dict, List, Optional, Union + +import dns._ddr +import dns.asyncbackend +import dns.asyncquery +import dns.exception +import dns.name +import dns.query +import dns.rdataclass +import dns.rdatatype +import dns.resolver # lgtm[py/import-and-import-from] + +# import some resolver symbols for brevity +from dns.resolver import NXDOMAIN, NoAnswer, NoRootSOA, NotAbsolute + +# for indentation purposes below +_udp = dns.asyncquery.udp +_tcp = dns.asyncquery.tcp + + +class Resolver(dns.resolver.BaseResolver): + """Asynchronous DNS stub resolver.""" + + async def resolve( + self, + qname: Union[dns.name.Name, str], + rdtype: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.A, + rdclass: Union[dns.rdataclass.RdataClass, str] = dns.rdataclass.IN, + tcp: bool = False, + source: Optional[str] = None, + raise_on_no_answer: bool = True, + source_port: int = 0, + lifetime: Optional[float] = None, + search: Optional[bool] = None, + backend: Optional[dns.asyncbackend.Backend] = None, + ) -> dns.resolver.Answer: + """Query nameservers asynchronously to find the answer to the question. + + *backend*, a ``dns.asyncbackend.Backend``, or ``None``. If ``None``, + the default, then dnspython will use the default backend. + + See :py:func:`dns.resolver.Resolver.resolve()` for the + documentation of the other parameters, exceptions, and return + type of this method. + """ + + resolution = dns.resolver._Resolution( + self, qname, rdtype, rdclass, tcp, raise_on_no_answer, search + ) + if not backend: + backend = dns.asyncbackend.get_default_backend() + start = time.time() + while True: + (request, answer) = resolution.next_request() + # Note we need to say "if answer is not None" and not just + # "if answer" because answer implements __len__, and python + # will call that. We want to return if we have an answer + # object, including in cases where its length is 0. + if answer is not None: + # cache hit! + return answer + assert request is not None # needed for type checking + done = False + while not done: + (nameserver, tcp, backoff) = resolution.next_nameserver() + if backoff: + await backend.sleep(backoff) + timeout = self._compute_timeout(start, lifetime, resolution.errors) + try: + response = await nameserver.async_query( + request, + timeout=timeout, + source=source, + source_port=source_port, + max_size=tcp, + backend=backend, + ) + except Exception as ex: + (_, done) = resolution.query_result(None, ex) + continue + (answer, done) = resolution.query_result(response, None) + # Note we need to say "if answer is not None" and not just + # "if answer" because answer implements __len__, and python + # will call that. We want to return if we have an answer + # object, including in cases where its length is 0. + if answer is not None: + return answer + + async def resolve_address( + self, ipaddr: str, *args: Any, **kwargs: Any + ) -> dns.resolver.Answer: + """Use an asynchronous resolver to run a reverse query for PTR + records. + + This utilizes the resolve() method to perform a PTR lookup on the + specified IP address. + + *ipaddr*, a ``str``, the IPv4 or IPv6 address you want to get + the PTR record for. + + All other arguments that can be passed to the resolve() function + except for rdtype and rdclass are also supported by this + function. + + """ + # We make a modified kwargs for type checking happiness, as otherwise + # we get a legit warning about possibly having rdtype and rdclass + # in the kwargs more than once. + modified_kwargs: Dict[str, Any] = {} + modified_kwargs.update(kwargs) + modified_kwargs["rdtype"] = dns.rdatatype.PTR + modified_kwargs["rdclass"] = dns.rdataclass.IN + return await self.resolve( + dns.reversename.from_address(ipaddr), *args, **modified_kwargs + ) + + async def resolve_name( + self, + name: Union[dns.name.Name, str], + family: int = socket.AF_UNSPEC, + **kwargs: Any, + ) -> dns.resolver.HostAnswers: + """Use an asynchronous resolver to query for address records. + + This utilizes the resolve() method to perform A and/or AAAA lookups on + the specified name. + + *qname*, a ``dns.name.Name`` or ``str``, the name to resolve. + + *family*, an ``int``, the address family. If socket.AF_UNSPEC + (the default), both A and AAAA records will be retrieved. + + All other arguments that can be passed to the resolve() function + except for rdtype and rdclass are also supported by this + function. + """ + # We make a modified kwargs for type checking happiness, as otherwise + # we get a legit warning about possibly having rdtype and rdclass + # in the kwargs more than once. + modified_kwargs: Dict[str, Any] = {} + modified_kwargs.update(kwargs) + modified_kwargs.pop("rdtype", None) + modified_kwargs["rdclass"] = dns.rdataclass.IN + + if family == socket.AF_INET: + v4 = await self.resolve(name, dns.rdatatype.A, **modified_kwargs) + return dns.resolver.HostAnswers.make(v4=v4) + elif family == socket.AF_INET6: + v6 = await self.resolve(name, dns.rdatatype.AAAA, **modified_kwargs) + return dns.resolver.HostAnswers.make(v6=v6) + elif family != socket.AF_UNSPEC: + raise NotImplementedError(f"unknown address family {family}") + + raise_on_no_answer = modified_kwargs.pop("raise_on_no_answer", True) + lifetime = modified_kwargs.pop("lifetime", None) + start = time.time() + v6 = await self.resolve( + name, + dns.rdatatype.AAAA, + raise_on_no_answer=False, + lifetime=self._compute_timeout(start, lifetime), + **modified_kwargs, + ) + # Note that setting name ensures we query the same name + # for A as we did for AAAA. (This is just in case search lists + # are active by default in the resolver configuration and + # we might be talking to a server that says NXDOMAIN when it + # wants to say NOERROR no data. + name = v6.qname + v4 = await self.resolve( + name, + dns.rdatatype.A, + raise_on_no_answer=False, + lifetime=self._compute_timeout(start, lifetime), + **modified_kwargs, + ) + answers = dns.resolver.HostAnswers.make( + v6=v6, v4=v4, add_empty=not raise_on_no_answer + ) + if not answers: + raise NoAnswer(response=v6.response) + return answers + + # pylint: disable=redefined-outer-name + + async def canonical_name(self, name: Union[dns.name.Name, str]) -> dns.name.Name: + """Determine the canonical name of *name*. + + The canonical name is the name the resolver uses for queries + after all CNAME and DNAME renamings have been applied. + + *name*, a ``dns.name.Name`` or ``str``, the query name. + + This method can raise any exception that ``resolve()`` can + raise, other than ``dns.resolver.NoAnswer`` and + ``dns.resolver.NXDOMAIN``. + + Returns a ``dns.name.Name``. + """ + try: + answer = await self.resolve(name, raise_on_no_answer=False) + canonical_name = answer.canonical_name + except dns.resolver.NXDOMAIN as e: + canonical_name = e.canonical_name + return canonical_name + + async def try_ddr(self, lifetime: float = 5.0) -> None: + """Try to update the resolver's nameservers using Discovery of Designated + Resolvers (DDR). If successful, the resolver will subsequently use + DNS-over-HTTPS or DNS-over-TLS for future queries. + + *lifetime*, a float, is the maximum time to spend attempting DDR. The default + is 5 seconds. + + If the SVCB query is successful and results in a non-empty list of nameservers, + then the resolver's nameservers are set to the returned servers in priority + order. + + The current implementation does not use any address hints from the SVCB record, + nor does it resolve addresses for the SCVB target name, rather it assumes that + the bootstrap nameserver will always be one of the addresses and uses it. + A future revision to the code may offer fuller support. The code verifies that + the bootstrap nameserver is in the Subject Alternative Name field of the + TLS certficate. + """ + try: + expiration = time.time() + lifetime + answer = await self.resolve( + dns._ddr._local_resolver_name, "svcb", lifetime=lifetime + ) + timeout = dns.query._remaining(expiration) + nameservers = await dns._ddr._get_nameservers_async(answer, timeout) + if len(nameservers) > 0: + self.nameservers = nameservers + except Exception: + pass + + +default_resolver = None + + +def get_default_resolver() -> Resolver: + """Get the default asynchronous resolver, initializing it if necessary.""" + if default_resolver is None: + reset_default_resolver() + assert default_resolver is not None + return default_resolver + + +def reset_default_resolver() -> None: + """Re-initialize default asynchronous resolver. + + Note that the resolver configuration (i.e. /etc/resolv.conf on UNIX + systems) will be re-read immediately. + """ + + global default_resolver + default_resolver = Resolver() + + +async def resolve( + qname: Union[dns.name.Name, str], + rdtype: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.A, + rdclass: Union[dns.rdataclass.RdataClass, str] = dns.rdataclass.IN, + tcp: bool = False, + source: Optional[str] = None, + raise_on_no_answer: bool = True, + source_port: int = 0, + lifetime: Optional[float] = None, + search: Optional[bool] = None, + backend: Optional[dns.asyncbackend.Backend] = None, +) -> dns.resolver.Answer: + """Query nameservers asynchronously to find the answer to the question. + + This is a convenience function that uses the default resolver + object to make the query. + + See :py:func:`dns.asyncresolver.Resolver.resolve` for more + information on the parameters. + """ + + return await get_default_resolver().resolve( + qname, + rdtype, + rdclass, + tcp, + source, + raise_on_no_answer, + source_port, + lifetime, + search, + backend, + ) + + +async def resolve_address( + ipaddr: str, *args: Any, **kwargs: Any +) -> dns.resolver.Answer: + """Use a resolver to run a reverse query for PTR records. + + See :py:func:`dns.asyncresolver.Resolver.resolve_address` for more + information on the parameters. + """ + + return await get_default_resolver().resolve_address(ipaddr, *args, **kwargs) + + +async def resolve_name( + name: Union[dns.name.Name, str], family: int = socket.AF_UNSPEC, **kwargs: Any +) -> dns.resolver.HostAnswers: + """Use a resolver to asynchronously query for address records. + + See :py:func:`dns.asyncresolver.Resolver.resolve_name` for more + information on the parameters. + """ + + return await get_default_resolver().resolve_name(name, family, **kwargs) + + +async def canonical_name(name: Union[dns.name.Name, str]) -> dns.name.Name: + """Determine the canonical name of *name*. + + See :py:func:`dns.resolver.Resolver.canonical_name` for more + information on the parameters and possible exceptions. + """ + + return await get_default_resolver().canonical_name(name) + + +async def try_ddr(timeout: float = 5.0) -> None: + """Try to update the default resolver's nameservers using Discovery of Designated + Resolvers (DDR). If successful, the resolver will subsequently use + DNS-over-HTTPS or DNS-over-TLS for future queries. + + See :py:func:`dns.resolver.Resolver.try_ddr` for more information. + """ + return await get_default_resolver().try_ddr(timeout) + + +async def zone_for_name( + name: Union[dns.name.Name, str], + rdclass: dns.rdataclass.RdataClass = dns.rdataclass.IN, + tcp: bool = False, + resolver: Optional[Resolver] = None, + backend: Optional[dns.asyncbackend.Backend] = None, +) -> dns.name.Name: + """Find the name of the zone which contains the specified name. + + See :py:func:`dns.resolver.Resolver.zone_for_name` for more + information on the parameters and possible exceptions. + """ + + if isinstance(name, str): + name = dns.name.from_text(name, dns.name.root) + if resolver is None: + resolver = get_default_resolver() + if not name.is_absolute(): + raise NotAbsolute(name) + while True: + try: + answer = await resolver.resolve( + name, dns.rdatatype.SOA, rdclass, tcp, backend=backend + ) + assert answer.rrset is not None + if answer.rrset.name == name: + return name + # otherwise we were CNAMEd or DNAMEd and need to look higher + except (NXDOMAIN, NoAnswer): + pass + try: + name = name.parent() + except dns.name.NoParent: # pragma: no cover + raise NoRootSOA + + +async def make_resolver_at( + where: Union[dns.name.Name, str], + port: int = 53, + family: int = socket.AF_UNSPEC, + resolver: Optional[Resolver] = None, +) -> Resolver: + """Make a stub resolver using the specified destination as the full resolver. + + *where*, a ``dns.name.Name`` or ``str`` the domain name or IP address of the + full resolver. + + *port*, an ``int``, the port to use. If not specified, the default is 53. + + *family*, an ``int``, the address family to use. This parameter is used if + *where* is not an address. The default is ``socket.AF_UNSPEC`` in which case + the first address returned by ``resolve_name()`` will be used, otherwise the + first address of the specified family will be used. + + *resolver*, a ``dns.asyncresolver.Resolver`` or ``None``, the resolver to use for + resolution of hostnames. If not specified, the default resolver will be used. + + Returns a ``dns.resolver.Resolver`` or raises an exception. + """ + if resolver is None: + resolver = get_default_resolver() + nameservers: List[Union[str, dns.nameserver.Nameserver]] = [] + if isinstance(where, str) and dns.inet.is_address(where): + nameservers.append(dns.nameserver.Do53Nameserver(where, port)) + else: + answers = await resolver.resolve_name(where, family) + for address in answers.addresses(): + nameservers.append(dns.nameserver.Do53Nameserver(address, port)) + res = dns.asyncresolver.Resolver(configure=False) + res.nameservers = nameservers + return res + + +async def resolve_at( + where: Union[dns.name.Name, str], + qname: Union[dns.name.Name, str], + rdtype: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.A, + rdclass: Union[dns.rdataclass.RdataClass, str] = dns.rdataclass.IN, + tcp: bool = False, + source: Optional[str] = None, + raise_on_no_answer: bool = True, + source_port: int = 0, + lifetime: Optional[float] = None, + search: Optional[bool] = None, + backend: Optional[dns.asyncbackend.Backend] = None, + port: int = 53, + family: int = socket.AF_UNSPEC, + resolver: Optional[Resolver] = None, +) -> dns.resolver.Answer: + """Query nameservers to find the answer to the question. + + This is a convenience function that calls ``dns.asyncresolver.make_resolver_at()`` + to make a resolver, and then uses it to resolve the query. + + See ``dns.asyncresolver.Resolver.resolve`` for more information on the resolution + parameters, and ``dns.asyncresolver.make_resolver_at`` for information about the + resolver parameters *where*, *port*, *family*, and *resolver*. + + If making more than one query, it is more efficient to call + ``dns.asyncresolver.make_resolver_at()`` and then use that resolver for the queries + instead of calling ``resolve_at()`` multiple times. + """ + res = await make_resolver_at(where, port, family, resolver) + return await res.resolve( + qname, + rdtype, + rdclass, + tcp, + source, + raise_on_no_answer, + source_port, + lifetime, + search, + backend, + ) diff --git a/.venv/lib/python3.12/site-packages/dns/dnssec.py b/.venv/lib/python3.12/site-packages/dns/dnssec.py new file mode 100644 index 0000000..e49c3b7 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/dnssec.py @@ -0,0 +1,1223 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2017 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""Common DNSSEC-related functions and constants.""" + + +import base64 +import contextlib +import functools +import hashlib +import struct +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 +import dns.rdata +import dns.rdataclass +import dns.rdataset +import dns.rdatatype +import dns.rrset +import dns.transaction +import dns.zone +from dns.dnssectypes import Algorithm, DSDigest, NSEC3Hash +from dns.exception import ( # pylint: disable=W0611 + AlgorithmKeyMismatch, + DeniedByPolicy, + UnsupportedAlgorithm, + ValidationFailure, +) +from dns.rdtypes.ANY.CDNSKEY import CDNSKEY +from dns.rdtypes.ANY.CDS import CDS +from dns.rdtypes.ANY.DNSKEY import DNSKEY +from dns.rdtypes.ANY.DS import DS +from dns.rdtypes.ANY.NSEC import NSEC, Bitmap +from dns.rdtypes.ANY.NSEC3PARAM import NSEC3PARAM +from dns.rdtypes.ANY.RRSIG import RRSIG, sigtime_to_posixtime +from dns.rdtypes.dnskeybase import Flag + +PublicKey = Union[ + "GenericPublicKey", + "rsa.RSAPublicKey", + "ec.EllipticCurvePublicKey", + "ed25519.Ed25519PublicKey", + "ed448.Ed448PublicKey", +] + +PrivateKey = Union[ + "GenericPrivateKey", + "rsa.RSAPrivateKey", + "ec.EllipticCurvePrivateKey", + "ed25519.Ed25519PrivateKey", + "ed448.Ed448PrivateKey", +] + +RRsetSigner = Callable[[dns.transaction.Transaction, dns.rrset.RRset], None] + + +def algorithm_from_text(text: str) -> Algorithm: + """Convert text into a DNSSEC algorithm value. + + *text*, a ``str``, the text to convert to into an algorithm value. + + Returns an ``int``. + """ + + return Algorithm.from_text(text) + + +def algorithm_to_text(value: Union[Algorithm, int]) -> str: + """Convert a DNSSEC algorithm value to text + + *value*, a ``dns.dnssec.Algorithm``. + + Returns a ``str``, the name of a DNSSEC algorithm. + """ + + return Algorithm.to_text(value) + + +def to_timestamp(value: Union[datetime, str, float, int]) -> int: + """Convert various format to a timestamp""" + if isinstance(value, datetime): + return int(value.timestamp()) + elif isinstance(value, str): + return sigtime_to_posixtime(value) + elif isinstance(value, float): + return int(value) + elif isinstance(value, int): + return value + else: + raise TypeError("Unsupported timestamp type") + + +def key_id(key: Union[DNSKEY, CDNSKEY]) -> int: + """Return the key id (a 16-bit number) for the specified key. + + *key*, a ``dns.rdtypes.ANY.DNSKEY.DNSKEY`` + + Returns an ``int`` between 0 and 65535 + """ + + rdata = key.to_wire() + if key.algorithm == Algorithm.RSAMD5: + return (rdata[-3] << 8) + rdata[-2] + else: + total = 0 + for i in range(len(rdata) // 2): + total += (rdata[2 * i] << 8) + rdata[2 * i + 1] + if len(rdata) % 2 != 0: + total += rdata[len(rdata) - 1] << 8 + total += (total >> 16) & 0xFFFF + return total & 0xFFFF + + +class Policy: + def __init__(self): + pass + + def ok_to_sign(self, _: DNSKEY) -> bool: # pragma: no cover + return False + + def ok_to_validate(self, _: DNSKEY) -> bool: # pragma: no cover + return False + + def ok_to_create_ds(self, _: DSDigest) -> bool: # pragma: no cover + return False + + def ok_to_validate_ds(self, _: DSDigest) -> bool: # pragma: no cover + return False + + +class SimpleDeny(Policy): + def __init__(self, deny_sign, deny_validate, deny_create_ds, deny_validate_ds): + super().__init__() + self._deny_sign = deny_sign + self._deny_validate = deny_validate + self._deny_create_ds = deny_create_ds + self._deny_validate_ds = deny_validate_ds + + def ok_to_sign(self, key: DNSKEY) -> bool: + return key.algorithm not in self._deny_sign + + def ok_to_validate(self, key: DNSKEY) -> bool: + return key.algorithm not in self._deny_validate + + def ok_to_create_ds(self, algorithm: DSDigest) -> bool: + return algorithm not in self._deny_create_ds + + def ok_to_validate_ds(self, algorithm: DSDigest) -> bool: + return algorithm not in self._deny_validate_ds + + +rfc_8624_policy = SimpleDeny( + {Algorithm.RSAMD5, Algorithm.DSA, Algorithm.DSANSEC3SHA1, Algorithm.ECCGOST}, + {Algorithm.RSAMD5, Algorithm.DSA, Algorithm.DSANSEC3SHA1}, + {DSDigest.NULL, DSDigest.SHA1, DSDigest.GOST}, + {DSDigest.NULL}, +) + +allow_all_policy = SimpleDeny(set(), set(), set(), set()) + + +default_policy = rfc_8624_policy + + +def make_ds( + name: Union[dns.name.Name, str], + key: dns.rdata.Rdata, + algorithm: Union[DSDigest, str], + origin: Optional[dns.name.Name] = None, + policy: Optional[Policy] = None, + validating: bool = False, +) -> DS: + """Create a DS record for a DNSSEC key. + + *name*, a ``dns.name.Name`` or ``str``, the owner name of the DS record. + + *key*, a ``dns.rdtypes.ANY.DNSKEY.DNSKEY`` or ``dns.rdtypes.ANY.DNSKEY.CDNSKEY``, + the key the DS is about. + + *algorithm*, a ``str`` or ``int`` specifying the hash algorithm. + The currently supported hashes are "SHA1", "SHA256", and "SHA384". Case + does not matter for these strings. + + *origin*, a ``dns.name.Name`` or ``None``. If *key* is a relative name, + then it will be made absolute using the specified origin. + + *policy*, a ``dns.dnssec.Policy`` or ``None``. If ``None``, the default policy, + ``dns.dnssec.default_policy`` is used; this policy defaults to that of RFC 8624. + + *validating*, a ``bool``. If ``True``, then policy is checked in + validating mode, i.e. "Is it ok to validate using this digest algorithm?". + Otherwise the policy is checked in creating mode, i.e. "Is it ok to create a DS with + this digest algorithm?". + + Raises ``UnsupportedAlgorithm`` if the algorithm is unknown. + + Raises ``DeniedByPolicy`` if the algorithm is denied by policy. + + Returns a ``dns.rdtypes.ANY.DS.DS`` + """ + + if policy is None: + policy = default_policy + try: + if isinstance(algorithm, str): + algorithm = DSDigest[algorithm.upper()] + except Exception: + raise UnsupportedAlgorithm('unsupported algorithm "%s"' % algorithm) + if validating: + check = policy.ok_to_validate_ds + else: + check = policy.ok_to_create_ds + if not check(algorithm): + raise DeniedByPolicy + if not isinstance(key, (DNSKEY, CDNSKEY)): + raise ValueError("key is not a DNSKEY/CDNSKEY") + if algorithm == DSDigest.SHA1: + dshash = hashlib.sha1() + elif algorithm == DSDigest.SHA256: + dshash = hashlib.sha256() + elif algorithm == DSDigest.SHA384: + dshash = hashlib.sha384() + else: + raise UnsupportedAlgorithm('unsupported algorithm "%s"' % algorithm) + + if isinstance(name, str): + name = dns.name.from_text(name, origin) + wire = name.canonicalize().to_wire() + assert wire is not None + dshash.update(wire) + dshash.update(key.to_wire(origin=origin)) + digest = dshash.digest() + + dsrdata = struct.pack("!HBB", key_id(key), key.algorithm, algorithm) + digest + ds = dns.rdata.from_wire( + dns.rdataclass.IN, dns.rdatatype.DS, dsrdata, 0, len(dsrdata) + ) + return cast(DS, ds) + + +def make_cds( + name: Union[dns.name.Name, str], + key: dns.rdata.Rdata, + algorithm: Union[DSDigest, str], + origin: Optional[dns.name.Name] = None, +) -> CDS: + """Create a CDS record for a DNSSEC key. + + *name*, a ``dns.name.Name`` or ``str``, the owner name of the DS record. + + *key*, a ``dns.rdtypes.ANY.DNSKEY.DNSKEY`` or ``dns.rdtypes.ANY.DNSKEY.CDNSKEY``, + the key the DS is about. + + *algorithm*, a ``str`` or ``int`` specifying the hash algorithm. + The currently supported hashes are "SHA1", "SHA256", and "SHA384". Case + does not matter for these strings. + + *origin*, a ``dns.name.Name`` or ``None``. If *key* is a relative name, + then it will be made absolute using the specified origin. + + Raises ``UnsupportedAlgorithm`` if the algorithm is unknown. + + Returns a ``dns.rdtypes.ANY.DS.CDS`` + """ + + ds = make_ds(name, key, algorithm, origin) + return CDS( + rdclass=ds.rdclass, + rdtype=dns.rdatatype.CDS, + key_tag=ds.key_tag, + algorithm=ds.algorithm, + digest_type=ds.digest_type, + digest=ds.digest, + ) + + +def _find_candidate_keys( + keys: Dict[dns.name.Name, Union[dns.rdataset.Rdataset, dns.node.Node]], rrsig: RRSIG +) -> Optional[List[DNSKEY]]: + value = keys.get(rrsig.signer) + if isinstance(value, dns.node.Node): + rdataset = value.get_rdataset(dns.rdataclass.IN, dns.rdatatype.DNSKEY) + else: + rdataset = value + if rdataset is None: + return None + return [ + cast(DNSKEY, rd) + for rd in rdataset + if rd.algorithm == rrsig.algorithm + and key_id(rd) == rrsig.key_tag + and (rd.flags & Flag.ZONE) == Flag.ZONE # RFC 4034 2.1.1 + and rd.protocol == 3 # RFC 4034 2.1.2 + ] + + +def _get_rrname_rdataset( + rrset: Union[dns.rrset.RRset, Tuple[dns.name.Name, dns.rdataset.Rdataset]], +) -> Tuple[dns.name.Name, dns.rdataset.Rdataset]: + if isinstance(rrset, tuple): + return rrset[0], rrset[1] + else: + return rrset.name, rrset + + +def _validate_signature(sig: bytes, data: bytes, key: DNSKEY) -> None: + public_cls = get_algorithm_cls_from_dnskey(key).public_cls + try: + public_key = public_cls.from_dnskey(key) + except ValueError: + raise ValidationFailure("invalid public key") + public_key.verify(sig, data) + + +def _validate_rrsig( + rrset: Union[dns.rrset.RRset, Tuple[dns.name.Name, dns.rdataset.Rdataset]], + rrsig: RRSIG, + keys: Dict[dns.name.Name, Union[dns.node.Node, dns.rdataset.Rdataset]], + origin: Optional[dns.name.Name] = None, + now: Optional[float] = None, + policy: Optional[Policy] = None, +) -> None: + """Validate an RRset against a single signature rdata, throwing an + exception if validation is not successful. + + *rrset*, the RRset to validate. This can be a + ``dns.rrset.RRset`` or a (``dns.name.Name``, ``dns.rdataset.Rdataset``) + tuple. + + *rrsig*, a ``dns.rdata.Rdata``, the signature to validate. + + *keys*, the key dictionary, used to find the DNSKEY associated + with a given name. The dictionary is keyed by a + ``dns.name.Name``, and has ``dns.node.Node`` or + ``dns.rdataset.Rdataset`` values. + + *origin*, a ``dns.name.Name`` or ``None``, the origin to use for relative + names. + + *now*, a ``float`` or ``None``, the time, in seconds since the epoch, to + use as the current time when validating. If ``None``, the actual current + time is used. + + *policy*, a ``dns.dnssec.Policy`` or ``None``. If ``None``, the default policy, + ``dns.dnssec.default_policy`` is used; this policy defaults to that of RFC 8624. + + Raises ``ValidationFailure`` if the signature is expired, not yet valid, + the public key is invalid, the algorithm is unknown, the verification + fails, etc. + + Raises ``UnsupportedAlgorithm`` if the algorithm is recognized by + dnspython but not implemented. + """ + + if policy is None: + policy = default_policy + + candidate_keys = _find_candidate_keys(keys, rrsig) + if candidate_keys is None: + raise ValidationFailure("unknown key") + + if now is None: + now = time.time() + if rrsig.expiration < now: + raise ValidationFailure("expired") + if rrsig.inception > now: + raise ValidationFailure("not yet valid") + + data = _make_rrsig_signature_data(rrset, rrsig, origin) + + for candidate_key in candidate_keys: + if not policy.ok_to_validate(candidate_key): + continue + try: + _validate_signature(rrsig.signature, data, candidate_key) + return + except (InvalidSignature, ValidationFailure): + # this happens on an individual validation failure + continue + # nothing verified -- raise failure: + raise ValidationFailure("verify failure") + + +def _validate( + rrset: Union[dns.rrset.RRset, Tuple[dns.name.Name, dns.rdataset.Rdataset]], + rrsigset: Union[dns.rrset.RRset, Tuple[dns.name.Name, dns.rdataset.Rdataset]], + keys: Dict[dns.name.Name, Union[dns.node.Node, dns.rdataset.Rdataset]], + origin: Optional[dns.name.Name] = None, + now: Optional[float] = None, + policy: Optional[Policy] = None, +) -> None: + """Validate an RRset against a signature RRset, throwing an exception + if none of the signatures validate. + + *rrset*, the RRset to validate. This can be a + ``dns.rrset.RRset`` or a (``dns.name.Name``, ``dns.rdataset.Rdataset``) + tuple. + + *rrsigset*, the signature RRset. This can be a + ``dns.rrset.RRset`` or a (``dns.name.Name``, ``dns.rdataset.Rdataset``) + tuple. + + *keys*, the key dictionary, used to find the DNSKEY associated + with a given name. The dictionary is keyed by a + ``dns.name.Name``, and has ``dns.node.Node`` or + ``dns.rdataset.Rdataset`` values. + + *origin*, a ``dns.name.Name``, the origin to use for relative names; + defaults to None. + + *now*, an ``int`` or ``None``, the time, in seconds since the epoch, to + use as the current time when validating. If ``None``, the actual current + time is used. + + *policy*, a ``dns.dnssec.Policy`` or ``None``. If ``None``, the default policy, + ``dns.dnssec.default_policy`` is used; this policy defaults to that of RFC 8624. + + Raises ``ValidationFailure`` if the signature is expired, not yet valid, + the public key is invalid, the algorithm is unknown, the verification + fails, etc. + """ + + if policy is None: + policy = default_policy + + if isinstance(origin, str): + origin = dns.name.from_text(origin, dns.name.root) + + if isinstance(rrset, tuple): + rrname = rrset[0] + else: + rrname = rrset.name + + if isinstance(rrsigset, tuple): + rrsigname = rrsigset[0] + rrsigrdataset = rrsigset[1] + else: + rrsigname = rrsigset.name + rrsigrdataset = rrsigset + + rrname = rrname.choose_relativity(origin) + rrsigname = rrsigname.choose_relativity(origin) + if rrname != rrsigname: + raise ValidationFailure("owner names do not match") + + for rrsig in rrsigrdataset: + if not isinstance(rrsig, RRSIG): + raise ValidationFailure("expected an RRSIG") + try: + _validate_rrsig(rrset, rrsig, keys, origin, now, policy) + return + except (ValidationFailure, UnsupportedAlgorithm): + pass + raise ValidationFailure("no RRSIGs validated") + + +def _sign( + rrset: Union[dns.rrset.RRset, Tuple[dns.name.Name, dns.rdataset.Rdataset]], + private_key: PrivateKey, + signer: dns.name.Name, + dnskey: DNSKEY, + inception: Optional[Union[datetime, str, int, float]] = None, + expiration: Optional[Union[datetime, str, int, float]] = None, + lifetime: Optional[int] = None, + verify: bool = False, + policy: Optional[Policy] = None, + origin: Optional[dns.name.Name] = None, +) -> RRSIG: + """Sign RRset using private key. + + *rrset*, the RRset to validate. This can be a + ``dns.rrset.RRset`` or a (``dns.name.Name``, ``dns.rdataset.Rdataset``) + tuple. + + *private_key*, the private key to use for signing, a + ``cryptography.hazmat.primitives.asymmetric`` private key class applicable + for DNSSEC. + + *signer*, a ``dns.name.Name``, the Signer's name. + + *dnskey*, a ``DNSKEY`` matching ``private_key``. + + *inception*, a ``datetime``, ``str``, ``int``, ``float`` or ``None``, the + signature inception time. If ``None``, the current time is used. If a ``str``, the + format is "YYYYMMDDHHMMSS" or alternatively the number of seconds since the UNIX + epoch in text form; this is the same the RRSIG rdata's text form. + Values of type `int` or `float` are interpreted as seconds since the UNIX epoch. + + *expiration*, a ``datetime``, ``str``, ``int``, ``float`` or ``None``, the signature + expiration time. If ``None``, the expiration time will be the inception time plus + the value of the *lifetime* parameter. See the description of *inception* above + for how the various parameter types are interpreted. + + *lifetime*, an ``int`` or ``None``, the signature lifetime in seconds. This + parameter is only meaningful if *expiration* is ``None``. + + *verify*, a ``bool``. If set to ``True``, the signer will verify signatures + after they are created; the default is ``False``. + + *policy*, a ``dns.dnssec.Policy`` or ``None``. If ``None``, the default policy, + ``dns.dnssec.default_policy`` is used; this policy defaults to that of RFC 8624. + + *origin*, a ``dns.name.Name`` or ``None``. If ``None``, the default, then all + names in the rrset (including its owner name) must be absolute; otherwise the + specified origin will be used to make names absolute when signing. + + Raises ``DeniedByPolicy`` if the signature is denied by policy. + """ + + if policy is None: + policy = default_policy + if not policy.ok_to_sign(dnskey): + raise DeniedByPolicy + + if isinstance(rrset, tuple): + rdclass = rrset[1].rdclass + rdtype = rrset[1].rdtype + rrname = rrset[0] + original_ttl = rrset[1].ttl + else: + rdclass = rrset.rdclass + rdtype = rrset.rdtype + rrname = rrset.name + original_ttl = rrset.ttl + + if inception is not None: + rrsig_inception = to_timestamp(inception) + else: + rrsig_inception = int(time.time()) + + if expiration is not None: + rrsig_expiration = to_timestamp(expiration) + elif lifetime is not None: + rrsig_expiration = rrsig_inception + lifetime + else: + raise ValueError("expiration or lifetime must be specified") + + # Derelativize now because we need a correct labels length for the + # rrsig_template. + if origin is not None: + rrname = rrname.derelativize(origin) + labels = len(rrname) - 1 + + # Adjust labels appropriately for wildcards. + if rrname.is_wild(): + labels -= 1 + + rrsig_template = RRSIG( + rdclass=rdclass, + rdtype=dns.rdatatype.RRSIG, + type_covered=rdtype, + algorithm=dnskey.algorithm, + labels=labels, + original_ttl=original_ttl, + expiration=rrsig_expiration, + inception=rrsig_inception, + key_tag=key_id(dnskey), + signer=signer, + signature=b"", + ) + + data = dns.dnssec._make_rrsig_signature_data(rrset, rrsig_template, origin) + + if isinstance(private_key, GenericPrivateKey): + signing_key = private_key + else: + try: + private_cls = get_algorithm_cls_from_dnskey(dnskey) + signing_key = private_cls(key=private_key) + except UnsupportedAlgorithm: + raise TypeError("Unsupported key algorithm") + + signature = signing_key.sign(data, verify) + + return cast(RRSIG, rrsig_template.replace(signature=signature)) + + +def _make_rrsig_signature_data( + rrset: Union[dns.rrset.RRset, Tuple[dns.name.Name, dns.rdataset.Rdataset]], + rrsig: RRSIG, + origin: Optional[dns.name.Name] = None, +) -> bytes: + """Create signature rdata. + + *rrset*, the RRset to sign/validate. This can be a + ``dns.rrset.RRset`` or a (``dns.name.Name``, ``dns.rdataset.Rdataset``) + tuple. + + *rrsig*, a ``dns.rdata.Rdata``, the signature to validate, or the + signature template used when signing. + + *origin*, a ``dns.name.Name`` or ``None``, the origin to use for relative + names. + + Raises ``UnsupportedAlgorithm`` if the algorithm is recognized by + dnspython but not implemented. + """ + + if isinstance(origin, str): + origin = dns.name.from_text(origin, dns.name.root) + + signer = rrsig.signer + if not signer.is_absolute(): + if origin is None: + raise ValidationFailure("relative RR name without an origin specified") + signer = signer.derelativize(origin) + + # For convenience, allow the rrset to be specified as a (name, + # rdataset) tuple as well as a proper rrset + rrname, rdataset = _get_rrname_rdataset(rrset) + + data = b"" + data += rrsig.to_wire(origin=signer)[:18] + data += rrsig.signer.to_digestable(signer) + + # Derelativize the name before considering labels. + if not rrname.is_absolute(): + if origin is None: + raise ValidationFailure("relative RR name without an origin specified") + rrname = rrname.derelativize(origin) + + name_len = len(rrname) + if rrname.is_wild() and rrsig.labels != name_len - 2: + raise ValidationFailure("wild owner name has wrong label length") + if name_len - 1 < rrsig.labels: + raise ValidationFailure("owner name longer than RRSIG labels") + elif rrsig.labels < name_len - 1: + suffix = rrname.split(rrsig.labels + 1)[1] + rrname = dns.name.from_text("*", suffix) + rrnamebuf = rrname.to_digestable() + rrfixed = struct.pack("!HHI", rdataset.rdtype, rdataset.rdclass, rrsig.original_ttl) + rdatas = [rdata.to_digestable(origin) for rdata in rdataset] + for rdata in sorted(rdatas): + data += rrnamebuf + data += rrfixed + rrlen = struct.pack("!H", len(rdata)) + data += rrlen + data += rdata + + return data + + +def _make_dnskey( + public_key: PublicKey, + algorithm: Union[int, str], + flags: int = Flag.ZONE, + protocol: int = 3, +) -> DNSKEY: + """Convert a public key to DNSKEY Rdata + + *public_key*, a ``PublicKey`` (``GenericPublicKey`` or + ``cryptography.hazmat.primitives.asymmetric``) to convert. + + *algorithm*, a ``str`` or ``int`` specifying the DNSKEY algorithm. + + *flags*: DNSKEY flags field as an integer. + + *protocol*: DNSKEY protocol field as an integer. + + Raises ``ValueError`` if the specified key algorithm parameters are not + unsupported, ``TypeError`` if the key type is unsupported, + `UnsupportedAlgorithm` if the algorithm is unknown and + `AlgorithmKeyMismatch` if the algorithm does not match the key type. + + Return DNSKEY ``Rdata``. + """ + + algorithm = Algorithm.make(algorithm) + + if isinstance(public_key, GenericPublicKey): + return public_key.to_dnskey(flags=flags, protocol=protocol) + else: + public_cls = get_algorithm_cls(algorithm).public_cls + return public_cls(key=public_key).to_dnskey(flags=flags, protocol=protocol) + + +def _make_cdnskey( + public_key: PublicKey, + algorithm: Union[int, str], + flags: int = Flag.ZONE, + protocol: int = 3, +) -> CDNSKEY: + """Convert a public key to CDNSKEY Rdata + + *public_key*, the public key to convert, a + ``cryptography.hazmat.primitives.asymmetric`` public key class applicable + for DNSSEC. + + *algorithm*, a ``str`` or ``int`` specifying the DNSKEY algorithm. + + *flags*: DNSKEY flags field as an integer. + + *protocol*: DNSKEY protocol field as an integer. + + Raises ``ValueError`` if the specified key algorithm parameters are not + unsupported, ``TypeError`` if the key type is unsupported, + `UnsupportedAlgorithm` if the algorithm is unknown and + `AlgorithmKeyMismatch` if the algorithm does not match the key type. + + Return CDNSKEY ``Rdata``. + """ + + dnskey = _make_dnskey(public_key, algorithm, flags, protocol) + + return CDNSKEY( + rdclass=dnskey.rdclass, + rdtype=dns.rdatatype.CDNSKEY, + flags=dnskey.flags, + protocol=dnskey.protocol, + algorithm=dnskey.algorithm, + key=dnskey.key, + ) + + +def nsec3_hash( + domain: Union[dns.name.Name, str], + salt: Optional[Union[str, bytes]], + iterations: int, + algorithm: Union[int, str], +) -> str: + """ + Calculate the NSEC3 hash, according to + https://tools.ietf.org/html/rfc5155#section-5 + + *domain*, a ``dns.name.Name`` or ``str``, the name to hash. + + *salt*, a ``str``, ``bytes``, or ``None``, the hash salt. If a + string, it is decoded as a hex string. + + *iterations*, an ``int``, the number of iterations. + + *algorithm*, a ``str`` or ``int``, the hash algorithm. + The only defined algorithm is SHA1. + + Returns a ``str``, the encoded NSEC3 hash. + """ + + b32_conversion = str.maketrans( + "ABCDEFGHIJKLMNOPQRSTUVWXYZ234567", "0123456789ABCDEFGHIJKLMNOPQRSTUV" + ) + + try: + if isinstance(algorithm, str): + algorithm = NSEC3Hash[algorithm.upper()] + except Exception: + raise ValueError("Wrong hash algorithm (only SHA1 is supported)") + + if algorithm != NSEC3Hash.SHA1: + raise ValueError("Wrong hash algorithm (only SHA1 is supported)") + + if salt is None: + salt_encoded = b"" + elif isinstance(salt, str): + if len(salt) % 2 == 0: + salt_encoded = bytes.fromhex(salt) + else: + raise ValueError("Invalid salt length") + else: + salt_encoded = salt + + if not isinstance(domain, dns.name.Name): + domain = dns.name.from_text(domain) + domain_encoded = domain.canonicalize().to_wire() + assert domain_encoded is not None + + digest = hashlib.sha1(domain_encoded + salt_encoded).digest() + for _ in range(iterations): + digest = hashlib.sha1(digest + salt_encoded).digest() + + output = base64.b32encode(digest).decode("utf-8") + output = output.translate(b32_conversion) + + return output + + +def make_ds_rdataset( + rrset: Union[dns.rrset.RRset, Tuple[dns.name.Name, dns.rdataset.Rdataset]], + algorithms: Set[Union[DSDigest, str]], + origin: Optional[dns.name.Name] = None, +) -> dns.rdataset.Rdataset: + """Create a DS record from DNSKEY/CDNSKEY/CDS. + + *rrset*, the RRset to create DS Rdataset for. This can be a + ``dns.rrset.RRset`` or a (``dns.name.Name``, ``dns.rdataset.Rdataset``) + tuple. + + *algorithms*, a set of ``str`` or ``int`` specifying the hash algorithms. + The currently supported hashes are "SHA1", "SHA256", and "SHA384". Case + does not matter for these strings. If the RRset is a CDS, only digest + algorithms matching algorithms are accepted. + + *origin*, a ``dns.name.Name`` or ``None``. If `key` is a relative name, + then it will be made absolute using the specified origin. + + Raises ``UnsupportedAlgorithm`` if any of the algorithms are unknown and + ``ValueError`` if the given RRset is not usable. + + Returns a ``dns.rdataset.Rdataset`` + """ + + rrname, rdataset = _get_rrname_rdataset(rrset) + + if rdataset.rdtype not in ( + dns.rdatatype.DNSKEY, + dns.rdatatype.CDNSKEY, + dns.rdatatype.CDS, + ): + raise ValueError("rrset not a DNSKEY/CDNSKEY/CDS") + + _algorithms = set() + for algorithm in algorithms: + try: + if isinstance(algorithm, str): + algorithm = DSDigest[algorithm.upper()] + except Exception: + raise UnsupportedAlgorithm('unsupported algorithm "%s"' % algorithm) + _algorithms.add(algorithm) + + if rdataset.rdtype == dns.rdatatype.CDS: + res = [] + for rdata in cds_rdataset_to_ds_rdataset(rdataset): + if rdata.digest_type in _algorithms: + res.append(rdata) + if len(res) == 0: + raise ValueError("no acceptable CDS rdata found") + return dns.rdataset.from_rdata_list(rdataset.ttl, res) + + res = [] + for algorithm in _algorithms: + res.extend(dnskey_rdataset_to_cds_rdataset(rrname, rdataset, algorithm, origin)) + return dns.rdataset.from_rdata_list(rdataset.ttl, res) + + +def cds_rdataset_to_ds_rdataset( + rdataset: dns.rdataset.Rdataset, +) -> dns.rdataset.Rdataset: + """Create a CDS record from DS. + + *rdataset*, a ``dns.rdataset.Rdataset``, to create DS Rdataset for. + + Raises ``ValueError`` if the rdataset is not CDS. + + Returns a ``dns.rdataset.Rdataset`` + """ + + if rdataset.rdtype != dns.rdatatype.CDS: + raise ValueError("rdataset not a CDS") + res = [] + for rdata in rdataset: + res.append( + CDS( + rdclass=rdata.rdclass, + rdtype=dns.rdatatype.DS, + key_tag=rdata.key_tag, + algorithm=rdata.algorithm, + digest_type=rdata.digest_type, + digest=rdata.digest, + ) + ) + return dns.rdataset.from_rdata_list(rdataset.ttl, res) + + +def dnskey_rdataset_to_cds_rdataset( + name: Union[dns.name.Name, str], + rdataset: dns.rdataset.Rdataset, + algorithm: Union[DSDigest, str], + origin: Optional[dns.name.Name] = None, +) -> dns.rdataset.Rdataset: + """Create a CDS record from DNSKEY/CDNSKEY. + + *name*, a ``dns.name.Name`` or ``str``, the owner name of the CDS record. + + *rdataset*, a ``dns.rdataset.Rdataset``, to create DS Rdataset for. + + *algorithm*, a ``str`` or ``int`` specifying the hash algorithm. + The currently supported hashes are "SHA1", "SHA256", and "SHA384". Case + does not matter for these strings. + + *origin*, a ``dns.name.Name`` or ``None``. If `key` is a relative name, + then it will be made absolute using the specified origin. + + Raises ``UnsupportedAlgorithm`` if the algorithm is unknown or + ``ValueError`` if the rdataset is not DNSKEY/CDNSKEY. + + Returns a ``dns.rdataset.Rdataset`` + """ + + if rdataset.rdtype not in (dns.rdatatype.DNSKEY, dns.rdatatype.CDNSKEY): + raise ValueError("rdataset not a DNSKEY/CDNSKEY") + res = [] + for rdata in rdataset: + res.append(make_cds(name, rdata, algorithm, origin)) + return dns.rdataset.from_rdata_list(rdataset.ttl, res) + + +def dnskey_rdataset_to_cdnskey_rdataset( + rdataset: dns.rdataset.Rdataset, +) -> dns.rdataset.Rdataset: + """Create a CDNSKEY record from DNSKEY. + + *rdataset*, a ``dns.rdataset.Rdataset``, to create CDNSKEY Rdataset for. + + Returns a ``dns.rdataset.Rdataset`` + """ + + if rdataset.rdtype != dns.rdatatype.DNSKEY: + raise ValueError("rdataset not a DNSKEY") + res = [] + for rdata in rdataset: + res.append( + CDNSKEY( + rdclass=rdataset.rdclass, + rdtype=rdataset.rdtype, + flags=rdata.flags, + protocol=rdata.protocol, + algorithm=rdata.algorithm, + key=rdata.key, + ) + ) + return dns.rdataset.from_rdata_list(rdataset.ttl, res) + + +def default_rrset_signer( + txn: dns.transaction.Transaction, + rrset: dns.rrset.RRset, + signer: dns.name.Name, + ksks: List[Tuple[PrivateKey, DNSKEY]], + zsks: List[Tuple[PrivateKey, DNSKEY]], + inception: Optional[Union[datetime, str, int, float]] = None, + expiration: Optional[Union[datetime, str, int, float]] = None, + lifetime: Optional[int] = None, + policy: Optional[Policy] = None, + origin: Optional[dns.name.Name] = None, +) -> None: + """Default RRset signer""" + + if rrset.rdtype in set( + [ + dns.rdatatype.RdataType.DNSKEY, + dns.rdatatype.RdataType.CDS, + dns.rdatatype.RdataType.CDNSKEY, + ] + ): + keys = ksks + else: + keys = zsks + + for private_key, dnskey in keys: + rrsig = dns.dnssec.sign( + rrset=rrset, + private_key=private_key, + dnskey=dnskey, + inception=inception, + expiration=expiration, + lifetime=lifetime, + signer=signer, + policy=policy, + origin=origin, + ) + txn.add(rrset.name, rrset.ttl, rrsig) + + +def sign_zone( + zone: dns.zone.Zone, + txn: Optional[dns.transaction.Transaction] = None, + keys: Optional[List[Tuple[PrivateKey, DNSKEY]]] = None, + add_dnskey: bool = True, + dnskey_ttl: Optional[int] = None, + inception: Optional[Union[datetime, str, int, float]] = None, + expiration: Optional[Union[datetime, str, int, float]] = None, + lifetime: Optional[int] = None, + nsec3: Optional[NSEC3PARAM] = None, + rrset_signer: Optional[RRsetSigner] = None, + policy: Optional[Policy] = None, +) -> None: + """Sign zone. + + *zone*, a ``dns.zone.Zone``, the zone to sign. + + *txn*, a ``dns.transaction.Transaction``, an optional transaction to use for + signing. + + *keys*, a list of (``PrivateKey``, ``DNSKEY``) tuples, to use for signing. KSK/ZSK + roles are assigned automatically if the SEP flag is used, otherwise all RRsets are + signed by all keys. + + *add_dnskey*, a ``bool``. If ``True``, the default, all specified DNSKEYs are + automatically added to the zone on signing. + + *dnskey_ttl*, a``int``, specifies the TTL for DNSKEY RRs. If not specified the TTL + of the existing DNSKEY RRset used or the TTL of the SOA RRset. + + *inception*, a ``datetime``, ``str``, ``int``, ``float`` or ``None``, the signature + inception time. If ``None``, the current time is used. If a ``str``, the format is + "YYYYMMDDHHMMSS" or alternatively the number of seconds since the UNIX epoch in text + form; this is the same the RRSIG rdata's text form. Values of type `int` or `float` + are interpreted as seconds since the UNIX epoch. + + *expiration*, a ``datetime``, ``str``, ``int``, ``float`` or ``None``, the signature + expiration time. If ``None``, the expiration time will be the inception time plus + the value of the *lifetime* parameter. See the description of *inception* above for + how the various parameter types are interpreted. + + *lifetime*, an ``int`` or ``None``, the signature lifetime in seconds. This + parameter is only meaningful if *expiration* is ``None``. + + *nsec3*, a ``NSEC3PARAM`` Rdata, configures signing using NSEC3. Not yet + implemented. + + *rrset_signer*, a ``Callable``, an optional function for signing RRsets. The + function requires two arguments: transaction and RRset. If the not specified, + ``dns.dnssec.default_rrset_signer`` will be used. + + Returns ``None``. + """ + + ksks = [] + zsks = [] + + # if we have both KSKs and ZSKs, split by SEP flag. if not, sign all + # records with all keys + if keys: + for key in keys: + if key[1].flags & Flag.SEP: + ksks.append(key) + else: + zsks.append(key) + if not ksks: + ksks = keys + if not zsks: + zsks = keys + else: + keys = [] + + if txn: + cm: contextlib.AbstractContextManager = contextlib.nullcontext(txn) + else: + cm = zone.writer() + + with cm as _txn: + if add_dnskey: + if dnskey_ttl is None: + dnskey = _txn.get(zone.origin, dns.rdatatype.DNSKEY) + if dnskey: + dnskey_ttl = dnskey.ttl + else: + soa = _txn.get(zone.origin, dns.rdatatype.SOA) + dnskey_ttl = soa.ttl + for _, dnskey in keys: + _txn.add(zone.origin, dnskey_ttl, dnskey) + + if nsec3: + raise NotImplementedError("Signing with NSEC3 not yet implemented") + else: + _rrset_signer = rrset_signer or functools.partial( + default_rrset_signer, + signer=zone.origin, + ksks=ksks, + zsks=zsks, + inception=inception, + expiration=expiration, + lifetime=lifetime, + policy=policy, + origin=zone.origin, + ) + return _sign_zone_nsec(zone, _txn, _rrset_signer) + + +def _sign_zone_nsec( + zone: dns.zone.Zone, + txn: dns.transaction.Transaction, + rrset_signer: Optional[RRsetSigner] = None, +) -> None: + """NSEC zone signer""" + + def _txn_add_nsec( + txn: dns.transaction.Transaction, + name: dns.name.Name, + next_secure: Optional[dns.name.Name], + rdclass: dns.rdataclass.RdataClass, + ttl: int, + rrset_signer: Optional[RRsetSigner] = None, + ) -> None: + """NSEC zone signer helper""" + mandatory_types = set( + [dns.rdatatype.RdataType.RRSIG, dns.rdatatype.RdataType.NSEC] + ) + node = txn.get_node(name) + if node and next_secure: + types = ( + set([rdataset.rdtype for rdataset in node.rdatasets]) | mandatory_types + ) + windows = Bitmap.from_rdtypes(list(types)) + rrset = dns.rrset.from_rdata( + name, + ttl, + NSEC( + rdclass=rdclass, + rdtype=dns.rdatatype.RdataType.NSEC, + next=next_secure, + windows=windows, + ), + ) + txn.add(rrset) + if rrset_signer: + rrset_signer(txn, rrset) + + rrsig_ttl = zone.get_soa().minimum + delegation = None + last_secure = None + + for name in sorted(txn.iterate_names()): + if delegation and name.is_subdomain(delegation): + # names below delegations are not secure + continue + elif txn.get(name, dns.rdatatype.NS) and name != zone.origin: + # inside delegation + delegation = name + else: + # outside delegation + delegation = None + + if rrset_signer: + node = txn.get_node(name) + if node: + for rdataset in node.rdatasets: + if rdataset.rdtype == dns.rdatatype.RRSIG: + # do not sign RRSIGs + continue + elif delegation and rdataset.rdtype != dns.rdatatype.DS: + # do not sign delegations except DS records + continue + else: + rrset = dns.rrset.from_rdata(name, rdataset.ttl, *rdataset) + rrset_signer(txn, rrset) + + # We need "is not None" as the empty name is False because its length is 0. + if last_secure is not None: + _txn_add_nsec(txn, last_secure, name, zone.rdclass, rrsig_ttl, rrset_signer) + last_secure = name + + if last_secure: + _txn_add_nsec( + txn, last_secure, zone.origin, zone.rdclass, rrsig_ttl, rrset_signer + ) + + +def _need_pyca(*args, **kwargs): + raise ImportError( + "DNSSEC validation requires python cryptography" + ) # pragma: no cover + + +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 + from cryptography.hazmat.primitives.asymmetric import ed448 # pylint: disable=W0611 + from cryptography.hazmat.primitives.asymmetric import rsa # pylint: disable=W0611 + from cryptography.hazmat.primitives.asymmetric import ( # pylint: disable=W0611 + ed25519, + ) + + from dns.dnssecalgs import ( # pylint: disable=C0412 + get_algorithm_cls, + get_algorithm_cls_from_dnskey, + ) + from dns.dnssecalgs.base import GenericPrivateKey, GenericPublicKey + + 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 + +RSAMD5 = Algorithm.RSAMD5 +DH = Algorithm.DH +DSA = Algorithm.DSA +ECC = Algorithm.ECC +RSASHA1 = Algorithm.RSASHA1 +DSANSEC3SHA1 = Algorithm.DSANSEC3SHA1 +RSASHA1NSEC3SHA1 = Algorithm.RSASHA1NSEC3SHA1 +RSASHA256 = Algorithm.RSASHA256 +RSASHA512 = Algorithm.RSASHA512 +ECCGOST = Algorithm.ECCGOST +ECDSAP256SHA256 = Algorithm.ECDSAP256SHA256 +ECDSAP384SHA384 = Algorithm.ECDSAP384SHA384 +ED25519 = Algorithm.ED25519 +ED448 = Algorithm.ED448 +INDIRECT = Algorithm.INDIRECT +PRIVATEDNS = Algorithm.PRIVATEDNS +PRIVATEOID = Algorithm.PRIVATEOID + +### END generated Algorithm constants diff --git a/.venv/lib/python3.12/site-packages/dns/dnssecalgs/__init__.py b/.venv/lib/python3.12/site-packages/dns/dnssecalgs/__init__.py new file mode 100644 index 0000000..3d9181a --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/dnssecalgs/__init__.py @@ -0,0 +1,120 @@ +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 + +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 + from dns.dnssecalgs.rsa import ( + PrivateRSAMD5, + PrivateRSASHA1, + PrivateRSASHA1NSEC3SHA1, + PrivateRSASHA256, + PrivateRSASHA512, + ) + + _have_cryptography = True +else: + _have_cryptography = False + +AlgorithmPrefix = Optional[Union[bytes, dns.name.Name]] + +algorithms: Dict[Tuple[Algorithm, AlgorithmPrefix], Type[GenericPrivateKey]] = {} +if _have_cryptography: + algorithms.update( + { + (Algorithm.RSAMD5, None): PrivateRSAMD5, + (Algorithm.DSA, None): PrivateDSA, + (Algorithm.RSASHA1, None): PrivateRSASHA1, + (Algorithm.DSANSEC3SHA1, None): PrivateDSANSEC3SHA1, + (Algorithm.RSASHA1NSEC3SHA1, None): PrivateRSASHA1NSEC3SHA1, + (Algorithm.RSASHA256, None): PrivateRSASHA256, + (Algorithm.RSASHA512, None): PrivateRSASHA512, + (Algorithm.ECDSAP256SHA256, None): PrivateECDSAP256SHA256, + (Algorithm.ECDSAP384SHA384, None): PrivateECDSAP384SHA384, + (Algorithm.ED25519, None): PrivateED25519, + (Algorithm.ED448, None): PrivateED448, + } + ) + + +def get_algorithm_cls( + algorithm: Union[int, str], prefix: AlgorithmPrefix = None +) -> Type[GenericPrivateKey]: + """Get Private Key class from Algorithm. + + *algorithm*, a ``str`` or ``int`` specifying the DNSKEY algorithm. + + Raises ``UnsupportedAlgorithm`` if the algorithm is unknown. + + Returns a ``dns.dnssecalgs.GenericPrivateKey`` + """ + algorithm = Algorithm.make(algorithm) + cls = algorithms.get((algorithm, prefix)) + if cls: + return cls + raise UnsupportedAlgorithm( + 'algorithm "%s" not supported by dnspython' % Algorithm.to_text(algorithm) + ) + + +def get_algorithm_cls_from_dnskey(dnskey: DNSKEY) -> Type[GenericPrivateKey]: + """Get Private Key class from DNSKEY. + + *dnskey*, a ``DNSKEY`` to get Algorithm class for. + + Raises ``UnsupportedAlgorithm`` if the algorithm is unknown. + + Returns a ``dns.dnssecalgs.GenericPrivateKey`` + """ + prefix: AlgorithmPrefix = None + if dnskey.algorithm == Algorithm.PRIVATEDNS: + prefix, _ = dns.name.from_wire(dnskey.key, 0) + elif dnskey.algorithm == Algorithm.PRIVATEOID: + length = int(dnskey.key[0]) + prefix = dnskey.key[0 : length + 1] + return get_algorithm_cls(dnskey.algorithm, prefix) + + +def register_algorithm_cls( + algorithm: Union[int, str], + algorithm_cls: Type[GenericPrivateKey], + name: Optional[Union[dns.name.Name, str]] = None, + oid: Optional[bytes] = None, +) -> None: + """Register Algorithm Private Key class. + + *algorithm*, a ``str`` or ``int`` specifying the DNSKEY algorithm. + + *algorithm_cls*: A `GenericPrivateKey` class. + + *name*, an optional ``dns.name.Name`` or ``str``, for for PRIVATEDNS algorithms. + + *oid*: an optional BER-encoded `bytes` for PRIVATEOID algorithms. + + Raises ``ValueError`` if a name or oid is specified incorrectly. + """ + if not issubclass(algorithm_cls, GenericPrivateKey): + raise TypeError("Invalid algorithm class") + algorithm = Algorithm.make(algorithm) + prefix: AlgorithmPrefix = None + if algorithm == Algorithm.PRIVATEDNS: + if name is None: + raise ValueError("Name required for PRIVATEDNS algorithms") + if isinstance(name, str): + name = dns.name.from_text(name) + prefix = name + elif algorithm == Algorithm.PRIVATEOID: + if oid is None: + raise ValueError("OID required for PRIVATEOID algorithms") + prefix = bytes([len(oid)]) + oid + elif name: + raise ValueError("Name only supported for PRIVATEDNS algorithm") + elif oid: + raise ValueError("OID only supported for PRIVATEOID algorithm") + algorithms[(algorithm, prefix)] = algorithm_cls diff --git a/.venv/lib/python3.12/site-packages/dns/dnssecalgs/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/dnssecalgs/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d1aa1e88998b154cbb0e82b05daf81bf2f62e133 GIT binary patch literal 5516 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/dnssecalgs/__pycache__/base.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/dnssecalgs/__pycache__/base.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..6e73eb8712d07ae1db6d6454cdf68a803ff8492a GIT binary patch literal 4560 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 CXAHmq literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/dnssecalgs/__pycache__/ecdsa.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/dnssecalgs/__pycache__/ecdsa.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..af6ac052401980001de1f601fbf32950eff92af2 GIT binary patch literal 5977 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 vJzEU4TNl`N=38XrJ*#N|fJCdmI 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/dnssecalgs/base.py b/.venv/lib/python3.12/site-packages/dns/dnssecalgs/base.py new file mode 100644 index 0000000..e990575 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/dnssecalgs/base.py @@ -0,0 +1,84 @@ +from abc import ABC, abstractmethod # pylint: disable=no-name-in-module +from typing import Any, Optional, Type + +import dns.rdataclass +import dns.rdatatype +from dns.dnssectypes import Algorithm +from dns.exception import AlgorithmKeyMismatch +from dns.rdtypes.ANY.DNSKEY import DNSKEY +from dns.rdtypes.dnskeybase import Flag + + +class GenericPublicKey(ABC): + algorithm: Algorithm + + @abstractmethod + def __init__(self, key: Any) -> None: + pass + + @abstractmethod + def verify(self, signature: bytes, data: bytes) -> None: + """Verify signed DNSSEC data""" + + @abstractmethod + def encode_key_bytes(self) -> bytes: + """Encode key as bytes for DNSKEY""" + + @classmethod + def _ensure_algorithm_key_combination(cls, key: DNSKEY) -> None: + if key.algorithm != cls.algorithm: + raise AlgorithmKeyMismatch + + def to_dnskey(self, flags: int = Flag.ZONE, protocol: int = 3) -> DNSKEY: + """Return public key as DNSKEY""" + return DNSKEY( + rdclass=dns.rdataclass.IN, + rdtype=dns.rdatatype.DNSKEY, + flags=flags, + protocol=protocol, + algorithm=self.algorithm, + key=self.encode_key_bytes(), + ) + + @classmethod + @abstractmethod + def from_dnskey(cls, key: DNSKEY) -> "GenericPublicKey": + """Create public key from DNSKEY""" + + @classmethod + @abstractmethod + def from_pem(cls, public_pem: bytes) -> "GenericPublicKey": + """Create public key from PEM-encoded SubjectPublicKeyInfo as specified + in RFC 5280""" + + @abstractmethod + def to_pem(self) -> bytes: + """Return public-key as PEM-encoded SubjectPublicKeyInfo as specified + in RFC 5280""" + + +class GenericPrivateKey(ABC): + public_cls: Type[GenericPublicKey] + + @abstractmethod + def __init__(self, key: Any) -> None: + pass + + @abstractmethod + def sign(self, data: bytes, verify: bool = False) -> bytes: + """Sign DNSSEC data""" + + @abstractmethod + def public_key(self) -> "GenericPublicKey": + """Return public key instance""" + + @classmethod + @abstractmethod + def from_pem( + cls, private_pem: bytes, password: Optional[bytes] = None + ) -> "GenericPrivateKey": + """Create private key from PEM-encoded PKCS#8""" + + @abstractmethod + def to_pem(self, password: Optional[bytes] = None) -> bytes: + """Return private key as PEM-encoded PKCS#8""" diff --git a/.venv/lib/python3.12/site-packages/dns/dnssecalgs/cryptography.py b/.venv/lib/python3.12/site-packages/dns/dnssecalgs/cryptography.py new file mode 100644 index 0000000..5a31a81 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/dnssecalgs/cryptography.py @@ -0,0 +1,68 @@ +from typing import Any, Optional, Type + +from cryptography.hazmat.primitives import serialization + +from dns.dnssecalgs.base import GenericPrivateKey, GenericPublicKey +from dns.exception import AlgorithmKeyMismatch + + +class CryptographyPublicKey(GenericPublicKey): + key: Any = None + key_cls: Any = None + + def __init__(self, key: Any) -> None: # pylint: disable=super-init-not-called + if self.key_cls is None: + raise TypeError("Undefined private key class") + if not isinstance( # pylint: disable=isinstance-second-argument-not-valid-type + key, self.key_cls + ): + raise AlgorithmKeyMismatch + self.key = key + + @classmethod + def from_pem(cls, public_pem: bytes) -> "GenericPublicKey": + key = serialization.load_pem_public_key(public_pem) + return cls(key=key) + + def to_pem(self) -> bytes: + return self.key.public_bytes( + encoding=serialization.Encoding.PEM, + format=serialization.PublicFormat.SubjectPublicKeyInfo, + ) + + +class CryptographyPrivateKey(GenericPrivateKey): + key: Any = None + key_cls: Any = None + public_cls: Type[CryptographyPublicKey] + + def __init__(self, key: Any) -> None: # pylint: disable=super-init-not-called + if self.key_cls is None: + raise TypeError("Undefined private key class") + if not isinstance( # pylint: disable=isinstance-second-argument-not-valid-type + key, self.key_cls + ): + raise AlgorithmKeyMismatch + self.key = key + + def public_key(self) -> "CryptographyPublicKey": + return self.public_cls(key=self.key.public_key()) + + @classmethod + def from_pem( + cls, private_pem: bytes, password: Optional[bytes] = None + ) -> "GenericPrivateKey": + key = serialization.load_pem_private_key(private_pem, password=password) + return cls(key=key) + + def to_pem(self, password: Optional[bytes] = None) -> bytes: + encryption_algorithm: serialization.KeySerializationEncryption + if password: + encryption_algorithm = serialization.BestAvailableEncryption(password) + else: + encryption_algorithm = serialization.NoEncryption() + return self.key.private_bytes( + encoding=serialization.Encoding.PEM, + format=serialization.PrivateFormat.PKCS8, + encryption_algorithm=encryption_algorithm, + ) diff --git a/.venv/lib/python3.12/site-packages/dns/dnssecalgs/dsa.py b/.venv/lib/python3.12/site-packages/dns/dnssecalgs/dsa.py new file mode 100644 index 0000000..0fe4690 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/dnssecalgs/dsa.py @@ -0,0 +1,101 @@ +import struct + +from cryptography.hazmat.backends import default_backend +from cryptography.hazmat.primitives import hashes +from cryptography.hazmat.primitives.asymmetric import dsa, utils + +from dns.dnssecalgs.cryptography import CryptographyPrivateKey, CryptographyPublicKey +from dns.dnssectypes import Algorithm +from dns.rdtypes.ANY.DNSKEY import DNSKEY + + +class PublicDSA(CryptographyPublicKey): + key: dsa.DSAPublicKey + key_cls = dsa.DSAPublicKey + algorithm = Algorithm.DSA + chosen_hash = hashes.SHA1() + + def verify(self, signature: bytes, data: bytes) -> None: + sig_r = signature[1:21] + sig_s = signature[21:] + sig = utils.encode_dss_signature( + int.from_bytes(sig_r, "big"), int.from_bytes(sig_s, "big") + ) + self.key.verify(sig, data, self.chosen_hash) + + def encode_key_bytes(self) -> bytes: + """Encode a public key per RFC 2536, section 2.""" + pn = self.key.public_numbers() + dsa_t = (self.key.key_size // 8 - 64) // 8 + if dsa_t > 8: + raise ValueError("unsupported DSA key size") + octets = 64 + dsa_t * 8 + res = struct.pack("!B", dsa_t) + res += pn.parameter_numbers.q.to_bytes(20, "big") + res += pn.parameter_numbers.p.to_bytes(octets, "big") + res += pn.parameter_numbers.g.to_bytes(octets, "big") + res += pn.y.to_bytes(octets, "big") + return res + + @classmethod + def from_dnskey(cls, key: DNSKEY) -> "PublicDSA": + cls._ensure_algorithm_key_combination(key) + keyptr = key.key + (t,) = struct.unpack("!B", keyptr[0:1]) + keyptr = keyptr[1:] + octets = 64 + t * 8 + dsa_q = keyptr[0:20] + keyptr = keyptr[20:] + dsa_p = keyptr[0:octets] + keyptr = keyptr[octets:] + dsa_g = keyptr[0:octets] + keyptr = keyptr[octets:] + dsa_y = keyptr[0:octets] + return cls( + key=dsa.DSAPublicNumbers( # type: ignore + int.from_bytes(dsa_y, "big"), + dsa.DSAParameterNumbers( + int.from_bytes(dsa_p, "big"), + int.from_bytes(dsa_q, "big"), + int.from_bytes(dsa_g, "big"), + ), + ).public_key(default_backend()), + ) + + +class PrivateDSA(CryptographyPrivateKey): + key: dsa.DSAPrivateKey + key_cls = dsa.DSAPrivateKey + public_cls = PublicDSA + + def sign(self, data: bytes, verify: bool = False) -> bytes: + """Sign using a private key per RFC 2536, section 3.""" + public_dsa_key = self.key.public_key() + if public_dsa_key.key_size > 1024: + raise ValueError("DSA key size overflow") + der_signature = self.key.sign(data, self.public_cls.chosen_hash) + dsa_r, dsa_s = utils.decode_dss_signature(der_signature) + dsa_t = (public_dsa_key.key_size // 8 - 64) // 8 + octets = 20 + signature = ( + struct.pack("!B", dsa_t) + + int.to_bytes(dsa_r, length=octets, byteorder="big") + + int.to_bytes(dsa_s, length=octets, byteorder="big") + ) + if verify: + self.public_key().verify(signature, data) + return signature + + @classmethod + def generate(cls, key_size: int) -> "PrivateDSA": + return cls( + key=dsa.generate_private_key(key_size=key_size), + ) + + +class PublicDSANSEC3SHA1(PublicDSA): + algorithm = Algorithm.DSANSEC3SHA1 + + +class PrivateDSANSEC3SHA1(PrivateDSA): + public_cls = PublicDSANSEC3SHA1 diff --git a/.venv/lib/python3.12/site-packages/dns/dnssecalgs/ecdsa.py b/.venv/lib/python3.12/site-packages/dns/dnssecalgs/ecdsa.py new file mode 100644 index 0000000..a31d79f --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/dnssecalgs/ecdsa.py @@ -0,0 +1,89 @@ +from cryptography.hazmat.backends import default_backend +from cryptography.hazmat.primitives import hashes +from cryptography.hazmat.primitives.asymmetric import ec, utils + +from dns.dnssecalgs.cryptography import CryptographyPrivateKey, CryptographyPublicKey +from dns.dnssectypes import Algorithm +from dns.rdtypes.ANY.DNSKEY import DNSKEY + + +class PublicECDSA(CryptographyPublicKey): + key: ec.EllipticCurvePublicKey + key_cls = ec.EllipticCurvePublicKey + algorithm: Algorithm + chosen_hash: hashes.HashAlgorithm + curve: ec.EllipticCurve + octets: int + + def verify(self, signature: bytes, data: bytes) -> None: + sig_r = signature[0 : self.octets] + sig_s = signature[self.octets :] + sig = utils.encode_dss_signature( + int.from_bytes(sig_r, "big"), int.from_bytes(sig_s, "big") + ) + self.key.verify(sig, data, ec.ECDSA(self.chosen_hash)) + + def encode_key_bytes(self) -> bytes: + """Encode a public key per RFC 6605, section 4.""" + pn = self.key.public_numbers() + return pn.x.to_bytes(self.octets, "big") + pn.y.to_bytes(self.octets, "big") + + @classmethod + def from_dnskey(cls, key: DNSKEY) -> "PublicECDSA": + cls._ensure_algorithm_key_combination(key) + ecdsa_x = key.key[0 : cls.octets] + ecdsa_y = key.key[cls.octets : cls.octets * 2] + return cls( + key=ec.EllipticCurvePublicNumbers( + curve=cls.curve, + x=int.from_bytes(ecdsa_x, "big"), + y=int.from_bytes(ecdsa_y, "big"), + ).public_key(default_backend()), + ) + + +class PrivateECDSA(CryptographyPrivateKey): + key: ec.EllipticCurvePrivateKey + key_cls = ec.EllipticCurvePrivateKey + public_cls = PublicECDSA + + def sign(self, data: bytes, verify: bool = False) -> bytes: + """Sign using a private key per RFC 6605, section 4.""" + der_signature = self.key.sign(data, ec.ECDSA(self.public_cls.chosen_hash)) + dsa_r, dsa_s = utils.decode_dss_signature(der_signature) + signature = int.to_bytes( + dsa_r, length=self.public_cls.octets, byteorder="big" + ) + int.to_bytes(dsa_s, length=self.public_cls.octets, byteorder="big") + if verify: + self.public_key().verify(signature, data) + return signature + + @classmethod + def generate(cls) -> "PrivateECDSA": + return cls( + key=ec.generate_private_key( + curve=cls.public_cls.curve, backend=default_backend() + ), + ) + + +class PublicECDSAP256SHA256(PublicECDSA): + algorithm = Algorithm.ECDSAP256SHA256 + chosen_hash = hashes.SHA256() + curve = ec.SECP256R1() + octets = 32 + + +class PrivateECDSAP256SHA256(PrivateECDSA): + public_cls = PublicECDSAP256SHA256 + + +class PublicECDSAP384SHA384(PublicECDSA): + algorithm = Algorithm.ECDSAP384SHA384 + chosen_hash = hashes.SHA384() + curve = ec.SECP384R1() + octets = 48 + + +class PrivateECDSAP384SHA384(PrivateECDSA): + public_cls = PublicECDSAP384SHA384 diff --git a/.venv/lib/python3.12/site-packages/dns/dnssecalgs/eddsa.py b/.venv/lib/python3.12/site-packages/dns/dnssecalgs/eddsa.py new file mode 100644 index 0000000..7050534 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/dnssecalgs/eddsa.py @@ -0,0 +1,65 @@ +from typing import Type + +from cryptography.hazmat.primitives import serialization +from cryptography.hazmat.primitives.asymmetric import ed448, ed25519 + +from dns.dnssecalgs.cryptography import CryptographyPrivateKey, CryptographyPublicKey +from dns.dnssectypes import Algorithm +from dns.rdtypes.ANY.DNSKEY import DNSKEY + + +class PublicEDDSA(CryptographyPublicKey): + def verify(self, signature: bytes, data: bytes) -> None: + self.key.verify(signature, data) + + def encode_key_bytes(self) -> bytes: + """Encode a public key per RFC 8080, section 3.""" + return self.key.public_bytes( + encoding=serialization.Encoding.Raw, format=serialization.PublicFormat.Raw + ) + + @classmethod + def from_dnskey(cls, key: DNSKEY) -> "PublicEDDSA": + cls._ensure_algorithm_key_combination(key) + return cls( + key=cls.key_cls.from_public_bytes(key.key), + ) + + +class PrivateEDDSA(CryptographyPrivateKey): + public_cls: Type[PublicEDDSA] + + def sign(self, data: bytes, verify: bool = False) -> bytes: + """Sign using a private key per RFC 8080, section 4.""" + signature = self.key.sign(data) + if verify: + self.public_key().verify(signature, data) + return signature + + @classmethod + def generate(cls) -> "PrivateEDDSA": + return cls(key=cls.key_cls.generate()) + + +class PublicED25519(PublicEDDSA): + key: ed25519.Ed25519PublicKey + key_cls = ed25519.Ed25519PublicKey + algorithm = Algorithm.ED25519 + + +class PrivateED25519(PrivateEDDSA): + key: ed25519.Ed25519PrivateKey + key_cls = ed25519.Ed25519PrivateKey + public_cls = PublicED25519 + + +class PublicED448(PublicEDDSA): + key: ed448.Ed448PublicKey + key_cls = ed448.Ed448PublicKey + algorithm = Algorithm.ED448 + + +class PrivateED448(PrivateEDDSA): + key: ed448.Ed448PrivateKey + key_cls = ed448.Ed448PrivateKey + public_cls = PublicED448 diff --git a/.venv/lib/python3.12/site-packages/dns/dnssecalgs/rsa.py b/.venv/lib/python3.12/site-packages/dns/dnssecalgs/rsa.py new file mode 100644 index 0000000..e95dcf1 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/dnssecalgs/rsa.py @@ -0,0 +1,119 @@ +import math +import struct + +from cryptography.hazmat.backends import default_backend +from cryptography.hazmat.primitives import hashes +from cryptography.hazmat.primitives.asymmetric import padding, rsa + +from dns.dnssecalgs.cryptography import CryptographyPrivateKey, CryptographyPublicKey +from dns.dnssectypes import Algorithm +from dns.rdtypes.ANY.DNSKEY import DNSKEY + + +class PublicRSA(CryptographyPublicKey): + key: rsa.RSAPublicKey + key_cls = rsa.RSAPublicKey + algorithm: Algorithm + chosen_hash: hashes.HashAlgorithm + + def verify(self, signature: bytes, data: bytes) -> None: + self.key.verify(signature, data, padding.PKCS1v15(), self.chosen_hash) + + def encode_key_bytes(self) -> bytes: + """Encode a public key per RFC 3110, section 2.""" + pn = self.key.public_numbers() + _exp_len = math.ceil(int.bit_length(pn.e) / 8) + exp = int.to_bytes(pn.e, length=_exp_len, byteorder="big") + if _exp_len > 255: + exp_header = b"\0" + struct.pack("!H", _exp_len) + else: + exp_header = struct.pack("!B", _exp_len) + if pn.n.bit_length() < 512 or pn.n.bit_length() > 4096: + raise ValueError("unsupported RSA key length") + return exp_header + exp + pn.n.to_bytes((pn.n.bit_length() + 7) // 8, "big") + + @classmethod + def from_dnskey(cls, key: DNSKEY) -> "PublicRSA": + cls._ensure_algorithm_key_combination(key) + keyptr = key.key + (bytes_,) = struct.unpack("!B", keyptr[0:1]) + keyptr = keyptr[1:] + if bytes_ == 0: + (bytes_,) = struct.unpack("!H", keyptr[0:2]) + keyptr = keyptr[2:] + rsa_e = keyptr[0:bytes_] + rsa_n = keyptr[bytes_:] + return cls( + key=rsa.RSAPublicNumbers( + int.from_bytes(rsa_e, "big"), int.from_bytes(rsa_n, "big") + ).public_key(default_backend()) + ) + + +class PrivateRSA(CryptographyPrivateKey): + key: rsa.RSAPrivateKey + key_cls = rsa.RSAPrivateKey + public_cls = PublicRSA + default_public_exponent = 65537 + + def sign(self, data: bytes, verify: bool = False) -> bytes: + """Sign using a private key per RFC 3110, section 3.""" + signature = self.key.sign(data, padding.PKCS1v15(), self.public_cls.chosen_hash) + if verify: + self.public_key().verify(signature, data) + return signature + + @classmethod + def generate(cls, key_size: int) -> "PrivateRSA": + return cls( + key=rsa.generate_private_key( + public_exponent=cls.default_public_exponent, + key_size=key_size, + backend=default_backend(), + ) + ) + + +class PublicRSAMD5(PublicRSA): + algorithm = Algorithm.RSAMD5 + chosen_hash = hashes.MD5() + + +class PrivateRSAMD5(PrivateRSA): + public_cls = PublicRSAMD5 + + +class PublicRSASHA1(PublicRSA): + algorithm = Algorithm.RSASHA1 + chosen_hash = hashes.SHA1() + + +class PrivateRSASHA1(PrivateRSA): + public_cls = PublicRSASHA1 + + +class PublicRSASHA1NSEC3SHA1(PublicRSA): + algorithm = Algorithm.RSASHA1NSEC3SHA1 + chosen_hash = hashes.SHA1() + + +class PrivateRSASHA1NSEC3SHA1(PrivateRSA): + public_cls = PublicRSASHA1NSEC3SHA1 + + +class PublicRSASHA256(PublicRSA): + algorithm = Algorithm.RSASHA256 + chosen_hash = hashes.SHA256() + + +class PrivateRSASHA256(PrivateRSA): + public_cls = PublicRSASHA256 + + +class PublicRSASHA512(PublicRSA): + algorithm = Algorithm.RSASHA512 + chosen_hash = hashes.SHA512() + + +class PrivateRSASHA512(PrivateRSA): + public_cls = PublicRSASHA512 diff --git a/.venv/lib/python3.12/site-packages/dns/dnssectypes.py b/.venv/lib/python3.12/site-packages/dns/dnssectypes.py new file mode 100644 index 0000000..02131e0 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/dnssectypes.py @@ -0,0 +1,71 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2017 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""Common DNSSEC-related types.""" + +# This is a separate file to avoid import circularity between dns.dnssec and +# the implementations of the DS and DNSKEY types. + +import dns.enum + + +class Algorithm(dns.enum.IntEnum): + RSAMD5 = 1 + DH = 2 + DSA = 3 + ECC = 4 + RSASHA1 = 5 + DSANSEC3SHA1 = 6 + RSASHA1NSEC3SHA1 = 7 + RSASHA256 = 8 + RSASHA512 = 10 + ECCGOST = 12 + ECDSAP256SHA256 = 13 + ECDSAP384SHA384 = 14 + ED25519 = 15 + ED448 = 16 + INDIRECT = 252 + PRIVATEDNS = 253 + PRIVATEOID = 254 + + @classmethod + def _maximum(cls): + return 255 + + +class DSDigest(dns.enum.IntEnum): + """DNSSEC Delegation Signer Digest Algorithm""" + + NULL = 0 + SHA1 = 1 + SHA256 = 2 + GOST = 3 + SHA384 = 4 + + @classmethod + def _maximum(cls): + return 255 + + +class NSEC3Hash(dns.enum.IntEnum): + """NSEC3 hash algorithm""" + + SHA1 = 1 + + @classmethod + def _maximum(cls): + return 255 diff --git a/.venv/lib/python3.12/site-packages/dns/e164.py b/.venv/lib/python3.12/site-packages/dns/e164.py new file mode 100644 index 0000000..453736d --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/e164.py @@ -0,0 +1,116 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2006-2017 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""DNS E.164 helpers.""" + +from typing import Iterable, Optional, Union + +import dns.exception +import dns.name +import dns.resolver + +#: The public E.164 domain. +public_enum_domain = dns.name.from_text("e164.arpa.") + + +def from_e164( + text: str, origin: Optional[dns.name.Name] = public_enum_domain +) -> dns.name.Name: + """Convert an E.164 number in textual form into a Name object whose + value is the ENUM domain name for that number. + + Non-digits in the text are ignored, i.e. "16505551212", + "+1.650.555.1212" and "1 (650) 555-1212" are all the same. + + *text*, a ``str``, is an E.164 number in textual form. + + *origin*, a ``dns.name.Name``, the domain in which the number + should be constructed. The default is ``e164.arpa.``. + + Returns a ``dns.name.Name``. + """ + + parts = [d for d in text if d.isdigit()] + parts.reverse() + return dns.name.from_text(".".join(parts), origin=origin) + + +def to_e164( + name: dns.name.Name, + origin: Optional[dns.name.Name] = public_enum_domain, + want_plus_prefix: bool = True, +) -> str: + """Convert an ENUM domain name into an E.164 number. + + Note that dnspython does not have any information about preferred + number formats within national numbering plans, so all numbers are + emitted as a simple string of digits, prefixed by a '+' (unless + *want_plus_prefix* is ``False``). + + *name* is a ``dns.name.Name``, the ENUM domain name. + + *origin* is a ``dns.name.Name``, a domain containing the ENUM + domain name. The name is relativized to this domain before being + converted to text. If ``None``, no relativization is done. + + *want_plus_prefix* is a ``bool``. If True, add a '+' to the beginning of + the returned number. + + Returns a ``str``. + + """ + if origin is not None: + name = name.relativize(origin) + dlabels = [d for d in name.labels if d.isdigit() and len(d) == 1] + if len(dlabels) != len(name.labels): + raise dns.exception.SyntaxError("non-digit labels in ENUM domain name") + dlabels.reverse() + text = b"".join(dlabels) + if want_plus_prefix: + text = b"+" + text + return text.decode() + + +def query( + number: str, + domains: Iterable[Union[dns.name.Name, str]], + resolver: Optional[dns.resolver.Resolver] = None, +) -> dns.resolver.Answer: + """Look for NAPTR RRs for the specified number in the specified domains. + + e.g. lookup('16505551212', ['e164.dnspython.org.', 'e164.arpa.']) + + *number*, a ``str`` is the number to look for. + + *domains* is an iterable containing ``dns.name.Name`` values. + + *resolver*, a ``dns.resolver.Resolver``, is the resolver to use. If + ``None``, the default resolver is used. + """ + + if resolver is None: + resolver = dns.resolver.get_default_resolver() + e_nx = dns.resolver.NXDOMAIN() + for domain in domains: + if isinstance(domain, str): + domain = dns.name.from_text(domain) + qname = dns.e164.from_e164(number, domain) + try: + return resolver.resolve(qname, "NAPTR") + except dns.resolver.NXDOMAIN as e: + e_nx += e + raise e_nx diff --git a/.venv/lib/python3.12/site-packages/dns/edns.py b/.venv/lib/python3.12/site-packages/dns/edns.py new file mode 100644 index 0000000..776e5ee --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/edns.py @@ -0,0 +1,516 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2009-2017 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""EDNS Options""" + +import binascii +import math +import socket +import struct +from typing import Any, Dict, Optional, Union + +import dns.enum +import dns.inet +import dns.rdata +import dns.wire + + +class OptionType(dns.enum.IntEnum): + #: NSID + NSID = 3 + #: DAU + DAU = 5 + #: DHU + DHU = 6 + #: N3U + N3U = 7 + #: ECS (client-subnet) + ECS = 8 + #: EXPIRE + EXPIRE = 9 + #: COOKIE + COOKIE = 10 + #: KEEPALIVE + KEEPALIVE = 11 + #: PADDING + PADDING = 12 + #: CHAIN + CHAIN = 13 + #: EDE (extended-dns-error) + EDE = 15 + + @classmethod + def _maximum(cls): + return 65535 + + +class Option: + """Base class for all EDNS option types.""" + + def __init__(self, otype: Union[OptionType, str]): + """Initialize an option. + + *otype*, a ``dns.edns.OptionType``, is the option type. + """ + self.otype = OptionType.make(otype) + + def to_wire(self, file: Optional[Any] = None) -> Optional[bytes]: + """Convert an option to wire format. + + Returns a ``bytes`` or ``None``. + + """ + 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. + + *otype*, a ``dns.edns.OptionType``, is the option type. + + *parser*, a ``dns.wire.Parser``, the parser, which should be + restructed to the option length. + + Returns a ``dns.edns.Option``. + """ + raise NotImplementedError # pragma: no cover + + def _cmp(self, other): + """Compare an EDNS option with another option of the same type. + + Returns < 0 if < *other*, 0 if == *other*, and > 0 if > *other*. + """ + wire = self.to_wire() + owire = other.to_wire() + if wire == owire: + return 0 + if wire > owire: + return 1 + return -1 + + def __eq__(self, other): + if not isinstance(other, Option): + return False + if self.otype != other.otype: + return False + return self._cmp(other) == 0 + + def __ne__(self, other): + if not isinstance(other, Option): + return True + if self.otype != other.otype: + return True + return self._cmp(other) != 0 + + def __lt__(self, other): + if not isinstance(other, Option) or self.otype != other.otype: + return NotImplemented + return self._cmp(other) < 0 + + def __le__(self, other): + if not isinstance(other, Option) or self.otype != other.otype: + return NotImplemented + return self._cmp(other) <= 0 + + def __ge__(self, other): + if not isinstance(other, Option) or self.otype != other.otype: + return NotImplemented + return self._cmp(other) >= 0 + + def __gt__(self, other): + if not isinstance(other, Option) or self.otype != other.otype: + return NotImplemented + return self._cmp(other) > 0 + + def __str__(self): + return self.to_text() + + +class GenericOption(Option): # lgtm[py/missing-equals] + """Generic Option Class + + This class is used for EDNS option types for which we have no better + implementation. + """ + + def __init__(self, otype: Union[OptionType, str], data: Union[bytes, str]): + super().__init__(otype) + self.data = dns.rdata.Rdata._as_bytes(data, True) + + def to_wire(self, file: Optional[Any] = None) -> Optional[bytes]: + if file: + file.write(self.data) + return None + else: + return self.data + + def to_text(self) -> str: + return "Generic %d" % self.otype + + @classmethod + def from_wire_parser( + cls, otype: Union[OptionType, str], parser: "dns.wire.Parser" + ) -> Option: + return cls(otype, parser.get_remaining()) + + +class ECSOption(Option): # lgtm[py/missing-equals] + """EDNS Client Subnet (ECS, RFC7871)""" + + def __init__(self, address: str, srclen: Optional[int] = None, scopelen: int = 0): + """*address*, a ``str``, is the client address information. + + *srclen*, an ``int``, the source prefix length, which is the + leftmost number of bits of the address to be used for the + lookup. The default is 24 for IPv4 and 56 for IPv6. + + *scopelen*, an ``int``, the scope prefix length. This value + must be 0 in queries, and should be set in responses. + """ + + super().__init__(OptionType.ECS) + af = dns.inet.af_for_address(address) + + if af == socket.AF_INET6: + self.family = 2 + if srclen is None: + srclen = 56 + address = dns.rdata.Rdata._as_ipv6_address(address) + srclen = dns.rdata.Rdata._as_int(srclen, 0, 128) + scopelen = dns.rdata.Rdata._as_int(scopelen, 0, 128) + elif af == socket.AF_INET: + self.family = 1 + if srclen is None: + srclen = 24 + address = dns.rdata.Rdata._as_ipv4_address(address) + srclen = dns.rdata.Rdata._as_int(srclen, 0, 32) + scopelen = dns.rdata.Rdata._as_int(scopelen, 0, 32) + else: # pragma: no cover (this will never happen) + raise ValueError("Bad address family") + + assert srclen is not None + self.address = address + self.srclen = srclen + self.scopelen = scopelen + + addrdata = dns.inet.inet_pton(af, address) + nbytes = int(math.ceil(srclen / 8.0)) + + # Truncate to srclen and pad to the end of the last octet needed + # See RFC section 6 + self.addrdata = addrdata[:nbytes] + nbits = srclen % 8 + if nbits != 0: + last = struct.pack("B", ord(self.addrdata[-1:]) & (0xFF << (8 - nbits))) + self.addrdata = self.addrdata[:-1] + last + + def to_text(self) -> str: + return "ECS {}/{} scope/{}".format(self.address, self.srclen, self.scopelen) + + @staticmethod + def from_text(text: str) -> Option: + """Convert a string into a `dns.edns.ECSOption` + + *text*, a `str`, the text form of the option. + + Returns a `dns.edns.ECSOption`. + + Examples: + + >>> import dns.edns + >>> + >>> # basic example + >>> dns.edns.ECSOption.from_text('1.2.3.4/24') + >>> + >>> # also understands scope + >>> dns.edns.ECSOption.from_text('1.2.3.4/24/32') + >>> + >>> # IPv6 + >>> dns.edns.ECSOption.from_text('2001:4b98::1/64/64') + >>> + >>> # it understands results from `dns.edns.ECSOption.to_text()` + >>> dns.edns.ECSOption.from_text('ECS 1.2.3.4/24/32') + """ + optional_prefix = "ECS" + tokens = text.split() + ecs_text = None + if len(tokens) == 1: + ecs_text = tokens[0] + elif len(tokens) == 2: + if tokens[0] != optional_prefix: + raise ValueError('could not parse ECS from "{}"'.format(text)) + ecs_text = tokens[1] + else: + raise ValueError('could not parse ECS from "{}"'.format(text)) + n_slashes = ecs_text.count("/") + if n_slashes == 1: + address, tsrclen = ecs_text.split("/") + tscope = "0" + elif n_slashes == 2: + address, tsrclen, tscope = ecs_text.split("/") + else: + raise ValueError('could not parse ECS from "{}"'.format(text)) + try: + scope = int(tscope) + except ValueError: + raise ValueError( + "invalid scope " + '"{}": scope must be an integer'.format(tscope) + ) + try: + srclen = int(tsrclen) + except ValueError: + raise ValueError( + "invalid srclen " + '"{}": srclen must be an integer'.format(tsrclen) + ) + return ECSOption(address, srclen, scope) + + def to_wire(self, file: Optional[Any] = None) -> Optional[bytes]: + value = ( + struct.pack("!HBB", self.family, self.srclen, self.scopelen) + self.addrdata + ) + if file: + file.write(value) + return None + else: + return value + + @classmethod + def from_wire_parser( + cls, otype: Union[OptionType, str], parser: "dns.wire.Parser" + ) -> Option: + family, src, scope = parser.get_struct("!HBB") + addrlen = int(math.ceil(src / 8.0)) + prefix = parser.get_bytes(addrlen) + if family == 1: + pad = 4 - addrlen + addr = dns.ipv4.inet_ntoa(prefix + b"\x00" * pad) + elif family == 2: + pad = 16 - addrlen + addr = dns.ipv6.inet_ntoa(prefix + b"\x00" * pad) + else: + raise ValueError("unsupported family") + + return cls(addr, src, scope) + + +class EDECode(dns.enum.IntEnum): + OTHER = 0 + UNSUPPORTED_DNSKEY_ALGORITHM = 1 + UNSUPPORTED_DS_DIGEST_TYPE = 2 + STALE_ANSWER = 3 + FORGED_ANSWER = 4 + DNSSEC_INDETERMINATE = 5 + DNSSEC_BOGUS = 6 + SIGNATURE_EXPIRED = 7 + SIGNATURE_NOT_YET_VALID = 8 + DNSKEY_MISSING = 9 + RRSIGS_MISSING = 10 + NO_ZONE_KEY_BIT_SET = 11 + NSEC_MISSING = 12 + CACHED_ERROR = 13 + NOT_READY = 14 + BLOCKED = 15 + CENSORED = 16 + FILTERED = 17 + PROHIBITED = 18 + STALE_NXDOMAIN_ANSWER = 19 + NOT_AUTHORITATIVE = 20 + NOT_SUPPORTED = 21 + NO_REACHABLE_AUTHORITY = 22 + NETWORK_ERROR = 23 + INVALID_DATA = 24 + + @classmethod + def _maximum(cls): + return 65535 + + +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. + + *text*, a ``str`` or ``None``, specifying additional information about + the error. + """ + + super().__init__(OptionType.EDE) + + self.code = EDECode.make(code) + if text is not None and not isinstance(text, str): + raise ValueError("text must be string or None") + self.text = text + + 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 + + def to_wire(self, file: Optional[Any] = None) -> Optional[bytes]: + value = struct.pack("!H", self.code) + if self.text is not None: + value += self.text.encode("utf8") + + if file: + file.write(value) + return None + else: + return value + + @classmethod + def from_wire_parser( + cls, otype: Union[OptionType, str], parser: "dns.wire.Parser" + ) -> Option: + code = EDECode.make(parser.get_uint16()) + text = parser.get_remaining() + + if text: + if text[-1] == 0: # text MAY be null-terminated + text = text[:-1] + btext = text.decode("utf8") + else: + btext = None + + 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, +} + + +def get_option_class(otype: OptionType) -> Any: + """Return the class for the specified option type. + + The GenericOption class is used if a more specific class is not + known. + """ + + cls = _type_to_class.get(otype) + if cls is None: + cls = GenericOption + return cls + + +def option_from_wire_parser( + otype: Union[OptionType, str], parser: "dns.wire.Parser" +) -> Option: + """Build an EDNS option object from wire format. + + *otype*, an ``int``, is the option type. + + *parser*, a ``dns.wire.Parser``, the parser, which should be + restricted to the option length. + + Returns an instance of a subclass of ``dns.edns.Option``. + """ + otype = OptionType.make(otype) + cls = get_option_class(otype) + return cls.from_wire_parser(otype, parser) + + +def option_from_wire( + otype: Union[OptionType, str], wire: bytes, current: int, olen: int +) -> Option: + """Build an EDNS option object from wire format. + + *otype*, an ``int``, is the option type. + + *wire*, a ``bytes``, is the wire-format message. + + *current*, an ``int``, is the offset in *wire* of the beginning + of the rdata. + + *olen*, an ``int``, is the length of the wire-format option data + + Returns an instance of a subclass of ``dns.edns.Option``. + """ + parser = dns.wire.Parser(wire, current) + with parser.restrict_to(olen): + return option_from_wire_parser(otype, parser) + + +def register_type(implementation: Any, otype: OptionType) -> None: + """Register the implementation of an option type. + + *implementation*, a ``class``, is a subclass of ``dns.edns.Option``. + + *otype*, an ``int``, is the option type. + """ + + _type_to_class[otype] = implementation + + +### BEGIN generated OptionType constants + +NSID = OptionType.NSID +DAU = OptionType.DAU +DHU = OptionType.DHU +N3U = OptionType.N3U +ECS = OptionType.ECS +EXPIRE = OptionType.EXPIRE +COOKIE = OptionType.COOKIE +KEEPALIVE = OptionType.KEEPALIVE +PADDING = OptionType.PADDING +CHAIN = OptionType.CHAIN +EDE = OptionType.EDE + +### END generated OptionType constants diff --git a/.venv/lib/python3.12/site-packages/dns/entropy.py b/.venv/lib/python3.12/site-packages/dns/entropy.py new file mode 100644 index 0000000..4dcdc62 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/entropy.py @@ -0,0 +1,130 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2009-2017 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 hashlib +import os +import random +import threading +import time +from typing import Any, Optional + + +class EntropyPool: + # This is an entropy pool for Python implementations that do not + # have a working SystemRandom. I'm not sure there are any, but + # leaving this code doesn't hurt anything as the library code + # is used if present. + + def __init__(self, seed: Optional[bytes] = None): + self.pool_index = 0 + self.digest: Optional[bytearray] = None + self.next_byte = 0 + self.lock = threading.Lock() + self.hash = hashlib.sha1() + self.hash_len = 20 + self.pool = bytearray(b"\0" * self.hash_len) + if seed is not None: + self._stir(seed) + self.seeded = True + self.seed_pid = os.getpid() + else: + self.seeded = False + self.seed_pid = 0 + + def _stir(self, entropy: bytes) -> None: + for c in entropy: + if self.pool_index == self.hash_len: + self.pool_index = 0 + b = c & 0xFF + self.pool[self.pool_index] ^= b + self.pool_index += 1 + + def stir(self, entropy: bytes) -> None: + with self.lock: + self._stir(entropy) + + def _maybe_seed(self) -> None: + if not self.seeded or self.seed_pid != os.getpid(): + try: + seed = os.urandom(16) + except Exception: # pragma: no cover + try: + with open("/dev/urandom", "rb", 0) as r: + seed = r.read(16) + except Exception: + seed = str(time.time()).encode() + self.seeded = True + self.seed_pid = os.getpid() + self.digest = None + seed = bytearray(seed) + self._stir(seed) + + def random_8(self) -> int: + with self.lock: + self._maybe_seed() + if self.digest is None or self.next_byte == self.hash_len: + self.hash.update(bytes(self.pool)) + self.digest = bytearray(self.hash.digest()) + self._stir(self.digest) + self.next_byte = 0 + value = self.digest[self.next_byte] + self.next_byte += 1 + return value + + def random_16(self) -> int: + return self.random_8() * 256 + self.random_8() + + def random_32(self) -> int: + return self.random_16() * 65536 + self.random_16() + + def random_between(self, first: int, last: int) -> int: + size = last - first + 1 + if size > 4294967296: + raise ValueError("too big") + if size > 65536: + rand = self.random_32 + max = 4294967295 + elif size > 256: + rand = self.random_16 + max = 65535 + else: + rand = self.random_8 + max = 255 + return first + size * rand() // (max + 1) + + +pool = EntropyPool() + +system_random: Optional[Any] +try: + system_random = random.SystemRandom() +except Exception: # pragma: no cover + system_random = None + + +def random_16() -> int: + if system_random is not None: + return system_random.randrange(0, 65536) + else: + return pool.random_16() + + +def between(first: int, last: int) -> int: + if system_random is not None: + return system_random.randrange(first, last + 1) + else: + return pool.random_between(first, last) diff --git a/.venv/lib/python3.12/site-packages/dns/enum.py b/.venv/lib/python3.12/site-packages/dns/enum.py new file mode 100644 index 0000000..71461f1 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/enum.py @@ -0,0 +1,116 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2017 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 enum +from typing import Type, TypeVar, Union + +TIntEnum = TypeVar("TIntEnum", bound="IntEnum") + + +class IntEnum(enum.IntEnum): + @classmethod + def _missing_(cls, value): + cls._check_value(value) + val = int.__new__(cls, value) + val._name_ = cls._extra_to_text(value, None) or f"{cls._prefix()}{value}" + val._value_ = value + return val + + @classmethod + def _check_value(cls, value): + max = cls._maximum() + if not isinstance(value, int): + raise TypeError + if value < 0 or value > max: + name = cls._short_name() + raise ValueError(f"{name} must be an int between >= 0 and <= {max}") + + @classmethod + def from_text(cls: Type[TIntEnum], text: str) -> TIntEnum: + text = text.upper() + try: + return cls[text] + except KeyError: + pass + value = cls._extra_from_text(text) + if value: + return value + prefix = cls._prefix() + if text.startswith(prefix) and text[len(prefix) :].isdigit(): + value = int(text[len(prefix) :]) + cls._check_value(value) + try: + return cls(value) + except ValueError: + return value + raise cls._unknown_exception_class() + + @classmethod + def to_text(cls: Type[TIntEnum], value: int) -> str: + cls._check_value(value) + try: + text = cls(value).name + except ValueError: + text = None + text = cls._extra_to_text(value, text) + if text is None: + text = f"{cls._prefix()}{value}" + return text + + @classmethod + def make(cls: Type[TIntEnum], value: Union[int, str]) -> TIntEnum: + """Convert text or a value into an enumerated type, if possible. + + *value*, the ``int`` or ``str`` to convert. + + Raises a class-specific exception if a ``str`` is provided that + cannot be converted. + + Raises ``ValueError`` if the value is out of range. + + Returns an enumeration from the calling class corresponding to the + value, if one is defined, or an ``int`` otherwise. + """ + + if isinstance(value, str): + return cls.from_text(value) + cls._check_value(value) + return cls(value) + + @classmethod + def _maximum(cls): + raise NotImplementedError # pragma: no cover + + @classmethod + def _short_name(cls): + return cls.__name__.lower() + + @classmethod + def _prefix(cls): + return "" + + @classmethod + def _extra_from_text(cls, text): # pylint: disable=W0613 + return None + + @classmethod + def _extra_to_text(cls, value, current_text): # pylint: disable=W0613 + return current_text + + @classmethod + def _unknown_exception_class(cls): + return ValueError diff --git a/.venv/lib/python3.12/site-packages/dns/exception.py b/.venv/lib/python3.12/site-packages/dns/exception.py new file mode 100644 index 0000000..6982373 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/exception.py @@ -0,0 +1,169 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2017 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""Common DNS Exceptions. + +Dnspython modules may also define their own exceptions, which will +always be subclasses of ``DNSException``. +""" + + +from typing import Optional, Set + + +class DNSException(Exception): + """Abstract base class shared by all dnspython exceptions. + + It supports two basic modes of operation: + + a) Old/compatible mode is used if ``__init__`` was called with + empty *kwargs*. In compatible mode all *args* are passed + to the standard Python Exception class as before and all *args* are + printed by the standard ``__str__`` implementation. Class variable + ``msg`` (or doc string if ``msg`` is ``None``) is returned from ``str()`` + if *args* is empty. + + b) New/parametrized mode is used if ``__init__`` was called with + non-empty *kwargs*. + In the new mode *args* must be empty and all kwargs must match + those set in class variable ``supp_kwargs``. All kwargs are stored inside + ``self.kwargs`` and used in a new ``__str__`` implementation to construct + a formatted message based on the ``fmt`` class variable, a ``string``. + + In the simplest case it is enough to override the ``supp_kwargs`` + and ``fmt`` class variables to get nice parametrized messages. + """ + + msg: Optional[str] = None # non-parametrized message + supp_kwargs: Set[str] = set() # accepted parameters for _fmt_kwargs (sanity check) + fmt: Optional[str] = None # message parametrized with results from _fmt_kwargs + + def __init__(self, *args, **kwargs): + self._check_params(*args, **kwargs) + if kwargs: + # This call to a virtual method from __init__ is ok in our usage + self.kwargs = self._check_kwargs(**kwargs) # lgtm[py/init-calls-subclass] + self.msg = str(self) + else: + self.kwargs = dict() # defined but empty for old mode exceptions + if self.msg is None: + # doc string is better implicit message than empty string + self.msg = self.__doc__ + if args: + super().__init__(*args) + else: + super().__init__(self.msg) + + def _check_params(self, *args, **kwargs): + """Old exceptions supported only args and not kwargs. + + For sanity we do not allow to mix old and new behavior.""" + if args or kwargs: + assert bool(args) != bool( + kwargs + ), "keyword arguments are mutually exclusive with positional args" + + def _check_kwargs(self, **kwargs): + if kwargs: + assert ( + set(kwargs.keys()) == self.supp_kwargs + ), "following set of keyword args is required: %s" % (self.supp_kwargs) + return kwargs + + def _fmt_kwargs(self, **kwargs): + """Format kwargs before printing them. + + Resulting dictionary has to have keys necessary for str.format call + on fmt class variable. + """ + fmtargs = {} + for kw, data in kwargs.items(): + if isinstance(data, (list, set)): + # convert list of to list of str() + fmtargs[kw] = list(map(str, data)) + if len(fmtargs[kw]) == 1: + # remove list brackets [] from single-item lists + fmtargs[kw] = fmtargs[kw].pop() + else: + fmtargs[kw] = data + return fmtargs + + def __str__(self): + if self.kwargs and self.fmt: + # provide custom message constructed from keyword arguments + fmtargs = self._fmt_kwargs(**self.kwargs) + return self.fmt.format(**fmtargs) + else: + # print *args directly in the same way as old DNSException + return super().__str__() + + +class FormError(DNSException): + """DNS message is malformed.""" + + +class SyntaxError(DNSException): + """Text input is malformed.""" + + +class UnexpectedEnd(SyntaxError): + """Text input ended unexpectedly.""" + + +class TooBig(DNSException): + """The DNS message is too big.""" + + +class Timeout(DNSException): + """The DNS operation timed out.""" + + supp_kwargs = {"timeout"} + fmt = "The DNS operation timed out after {timeout:.3f} seconds" + + # We do this as otherwise mypy complains about unexpected keyword argument + # idna_exception + def __init__(self, *args, **kwargs): + super().__init__(*args, **kwargs) + + +class UnsupportedAlgorithm(DNSException): + """The DNSSEC algorithm is not supported.""" + + +class AlgorithmKeyMismatch(UnsupportedAlgorithm): + """The DNSSEC algorithm is not supported for the given key type.""" + + +class ValidationFailure(DNSException): + """The DNSSEC signature is invalid.""" + + +class DeniedByPolicy(DNSException): + """Denied by DNSSEC policy.""" + + +class ExceptionWrapper: + def __init__(self, exception_class): + self.exception_class = exception_class + + def __enter__(self): + return self + + def __exit__(self, exc_type, exc_val, exc_tb): + if exc_type is not None and not isinstance(exc_val, self.exception_class): + raise self.exception_class(str(exc_val)) from exc_val + return False diff --git a/.venv/lib/python3.12/site-packages/dns/flags.py b/.venv/lib/python3.12/site-packages/dns/flags.py new file mode 100644 index 0000000..4c60be1 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/flags.py @@ -0,0 +1,123 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2001-2017 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""DNS Message Flags.""" + +import enum +from typing import Any + +# Standard DNS flags + + +class Flag(enum.IntFlag): + #: Query Response + QR = 0x8000 + #: Authoritative Answer + AA = 0x0400 + #: Truncated Response + TC = 0x0200 + #: Recursion Desired + RD = 0x0100 + #: Recursion Available + RA = 0x0080 + #: Authentic Data + AD = 0x0020 + #: Checking Disabled + CD = 0x0010 + + +# EDNS flags + + +class EDNSFlag(enum.IntFlag): + #: DNSSEC answer OK + DO = 0x8000 + + +def _from_text(text: str, enum_class: Any) -> int: + flags = 0 + tokens = text.split() + for t in tokens: + flags |= enum_class[t.upper()] + return flags + + +def _to_text(flags: int, enum_class: Any) -> str: + text_flags = [] + for k, v in enum_class.__members__.items(): + if flags & v != 0: + text_flags.append(k) + return " ".join(text_flags) + + +def from_text(text: str) -> int: + """Convert a space-separated list of flag text values into a flags + value. + + Returns an ``int`` + """ + + return _from_text(text, Flag) + + +def to_text(flags: int) -> str: + """Convert a flags value into a space-separated list of flag text + values. + + Returns a ``str``. + """ + + return _to_text(flags, Flag) + + +def edns_from_text(text: str) -> int: + """Convert a space-separated list of EDNS flag text values into a EDNS + flags value. + + Returns an ``int`` + """ + + return _from_text(text, EDNSFlag) + + +def edns_to_text(flags: int) -> str: + """Convert an EDNS flags value into a space-separated list of EDNS flag + text values. + + Returns a ``str``. + """ + + return _to_text(flags, EDNSFlag) + + +### BEGIN generated Flag constants + +QR = Flag.QR +AA = Flag.AA +TC = Flag.TC +RD = Flag.RD +RA = Flag.RA +AD = Flag.AD +CD = Flag.CD + +### END generated Flag constants + +### BEGIN generated EDNSFlag constants + +DO = EDNSFlag.DO + +### END generated EDNSFlag constants diff --git a/.venv/lib/python3.12/site-packages/dns/grange.py b/.venv/lib/python3.12/site-packages/dns/grange.py new file mode 100644 index 0000000..3a52278 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/grange.py @@ -0,0 +1,72 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2012-2017 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""DNS GENERATE range conversion.""" + +from typing import Tuple + +import dns + + +def from_text(text: str) -> Tuple[int, int, int]: + """Convert the text form of a range in a ``$GENERATE`` statement to an + integer. + + *text*, a ``str``, the textual range in ``$GENERATE`` form. + + Returns a tuple of three ``int`` values ``(start, stop, step)``. + """ + + start = -1 + stop = -1 + step = 1 + cur = "" + state = 0 + # state 0 1 2 + # x - y / z + + if text and text[0] == "-": + raise dns.exception.SyntaxError("Start cannot be a negative number") + + for c in text: + if c == "-" and state == 0: + start = int(cur) + cur = "" + state = 1 + elif c == "/": + stop = int(cur) + cur = "" + state = 2 + elif c.isdigit(): + cur += c + else: + raise dns.exception.SyntaxError("Could not parse %s" % (c)) + + if state == 0: + raise dns.exception.SyntaxError("no stop value specified") + elif state == 1: + stop = int(cur) + else: + assert state == 2 + step = int(cur) + + assert step >= 1 + assert start >= 0 + if start > stop: + raise dns.exception.SyntaxError("start must be <= stop") + + return (start, stop, step) diff --git a/.venv/lib/python3.12/site-packages/dns/immutable.py b/.venv/lib/python3.12/site-packages/dns/immutable.py new file mode 100644 index 0000000..36b0362 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/immutable.py @@ -0,0 +1,68 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +import collections.abc +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, + 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, collections.abc.MutableMapping): + self._odict = dictionary + else: + self._odict = map_factory() + self._odict.update(dictionary) + self._hash = None + + def __getitem__(self, key): + return self._odict.__getitem__(key) + + def __hash__(self): # pylint: disable=invalid-hash-returned + if self._hash is None: + h = 0 + for key in sorted(self._odict.keys()): + h ^= hash(key) + object.__setattr__(self, "_hash", h) + # this does return an int, but pylint doesn't figure that out + return self._hash + + def __len__(self): + return len(self._odict) + + def __iter__(self): + return iter(self._odict) + + +def constify(o: Any) -> Any: + """ + Convert mutable types to immutable types. + """ + if isinstance(o, bytearray): + return bytes(o) + if isinstance(o, tuple): + try: + hash(o) + return o + except Exception: + return tuple(constify(elt) for elt in o) + if isinstance(o, list): + return tuple(constify(elt) for elt in o) + if isinstance(o, dict): + cdict = dict() + for k, v in o.items(): + cdict[k] = constify(v) + return Dict(cdict, True) + return o diff --git a/.venv/lib/python3.12/site-packages/dns/inet.py b/.venv/lib/python3.12/site-packages/dns/inet.py new file mode 100644 index 0000000..4a03f99 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/inet.py @@ -0,0 +1,197 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2017 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""Generic Internet address helper functions.""" + +import socket +from typing import Any, Optional, Tuple + +import dns.ipv4 +import dns.ipv6 + +# We assume that AF_INET and AF_INET6 are always defined. We keep +# these here for the benefit of any old code (unlikely though that +# is!). +AF_INET = socket.AF_INET +AF_INET6 = socket.AF_INET6 + + +def inet_pton(family: int, text: str) -> bytes: + """Convert the textual form of a network address into its binary form. + + *family* is an ``int``, the address family. + + *text* is a ``str``, the textual address. + + Raises ``NotImplementedError`` if the address family specified is not + implemented. + + Returns a ``bytes``. + """ + + if family == AF_INET: + return dns.ipv4.inet_aton(text) + elif family == AF_INET6: + return dns.ipv6.inet_aton(text, True) + else: + raise NotImplementedError + + +def inet_ntop(family: int, address: bytes) -> str: + """Convert the binary form of a network address into its textual form. + + *family* is an ``int``, the address family. + + *address* is a ``bytes``, the network address in binary form. + + Raises ``NotImplementedError`` if the address family specified is not + implemented. + + Returns a ``str``. + """ + + if family == AF_INET: + return dns.ipv4.inet_ntoa(address) + elif family == AF_INET6: + return dns.ipv6.inet_ntoa(address) + else: + raise NotImplementedError + + +def af_for_address(text: str) -> int: + """Determine the address family of a textual-form network address. + + *text*, a ``str``, the textual address. + + Raises ``ValueError`` if the address family cannot be determined + from the input. + + Returns an ``int``. + """ + + try: + dns.ipv4.inet_aton(text) + return AF_INET + except Exception: + try: + dns.ipv6.inet_aton(text, True) + return AF_INET6 + except Exception: + raise ValueError + + +def is_multicast(text: str) -> bool: + """Is the textual-form network address a multicast address? + + *text*, a ``str``, the textual address. + + Raises ``ValueError`` if the address family cannot be determined + from the input. + + Returns a ``bool``. + """ + + try: + first = dns.ipv4.inet_aton(text)[0] + return first >= 224 and first <= 239 + except Exception: + try: + first = dns.ipv6.inet_aton(text, True)[0] + return first == 255 + except Exception: + raise ValueError + + +def is_address(text: str) -> bool: + """Is the specified string an IPv4 or IPv6 address? + + *text*, a ``str``, the textual address. + + Returns a ``bool``. + """ + + try: + dns.ipv4.inet_aton(text) + return True + except Exception: + try: + dns.ipv6.inet_aton(text, True) + return True + except Exception: + return False + + +def low_level_address_tuple( + high_tuple: Tuple[str, int], af: Optional[int] = None +) -> Any: + """Given a "high-level" address tuple, i.e. + an (address, port) return the appropriate "low-level" address tuple + suitable for use in socket calls. + + If an *af* other than ``None`` is provided, it is assumed the + address in the high-level tuple is valid and has that af. If af + is ``None``, then af_for_address will be called. + """ + address, port = high_tuple + if af is None: + af = af_for_address(address) + if af == AF_INET: + return (address, port) + elif af == AF_INET6: + i = address.find("%") + if i < 0: + # no scope, shortcut! + return (address, port, 0, 0) + # try to avoid getaddrinfo() + addrpart = address[:i] + scope = address[i + 1 :] + if scope.isdigit(): + return (addrpart, port, 0, int(scope)) + try: + return (addrpart, port, 0, socket.if_nametoindex(scope)) + except AttributeError: # pragma: no cover (we can't really test this) + ai_flags = socket.AI_NUMERICHOST + ((*_, tup), *_) = socket.getaddrinfo(address, port, flags=ai_flags) + return tup + else: + raise NotImplementedError(f"unknown address family {af}") + + +def any_for_af(af): + """Return the 'any' address for the specified address family.""" + if af == socket.AF_INET: + return "0.0.0.0" + 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/.venv/lib/python3.12/site-packages/dns/ipv4.py b/.venv/lib/python3.12/site-packages/dns/ipv4.py new file mode 100644 index 0000000..65ee69c --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/ipv4.py @@ -0,0 +1,77 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2017 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""IPv4 helper functions.""" + +import struct +from typing import Union + +import dns.exception + + +def inet_ntoa(address: bytes) -> str: + """Convert an IPv4 address in binary form to text form. + + *address*, a ``bytes``, the IPv4 address in binary form. + + Returns a ``str``. + """ + + if len(address) != 4: + raise dns.exception.SyntaxError + return "%u.%u.%u.%u" % (address[0], address[1], address[2], address[3]) + + +def inet_aton(text: Union[str, bytes]) -> bytes: + """Convert an IPv4 address in text form to binary form. + + *text*, a ``str`` or ``bytes``, the IPv4 address in textual form. + + Returns a ``bytes``. + """ + + if not isinstance(text, bytes): + btext = text.encode() + else: + btext = text + parts = btext.split(b".") + if len(parts) != 4: + raise dns.exception.SyntaxError + for part in parts: + if not part.isdigit(): + raise dns.exception.SyntaxError + if len(part) > 1 and part[0] == ord("0"): + # No leading zeros + raise dns.exception.SyntaxError + try: + b = [int(part) for part in parts] + 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/.venv/lib/python3.12/site-packages/dns/ipv6.py b/.venv/lib/python3.12/site-packages/dns/ipv6.py new file mode 100644 index 0000000..44a1063 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/ipv6.py @@ -0,0 +1,219 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2017 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""IPv6 helper functions.""" + +import binascii +import re +from typing import List, Union + +import dns.exception +import dns.ipv4 + +_leading_zero = re.compile(r"0+([0-9a-f]+)") + + +def inet_ntoa(address: bytes) -> str: + """Convert an IPv6 address in binary form to text form. + + *address*, a ``bytes``, the IPv6 address in binary form. + + Raises ``ValueError`` if the address isn't 16 bytes long. + Returns a ``str``. + """ + + if len(address) != 16: + raise ValueError("IPv6 addresses are 16 bytes long") + hex = binascii.hexlify(address) + chunks = [] + i = 0 + l = len(hex) + while i < l: + chunk = hex[i : i + 4].decode() + # strip leading zeros. we do this with an re instead of + # with lstrip() because lstrip() didn't support chars until + # python 2.2.2 + m = _leading_zero.match(chunk) + if m is not None: + chunk = m.group(1) + chunks.append(chunk) + i += 4 + # + # Compress the longest subsequence of 0-value chunks to :: + # + best_start = 0 + best_len = 0 + start = -1 + last_was_zero = False + for i in range(8): + if chunks[i] != "0": + if last_was_zero: + end = i + current_len = end - start + if current_len > best_len: + best_start = start + best_len = current_len + last_was_zero = False + elif not last_was_zero: + start = i + last_was_zero = True + if last_was_zero: + end = 8 + current_len = end - start + if current_len > best_len: + best_start = start + best_len = current_len + if best_len > 1: + if best_start == 0 and (best_len == 6 or best_len == 5 and chunks[5] == "ffff"): + # We have an embedded IPv4 address + if best_len == 6: + prefix = "::" + else: + prefix = "::ffff:" + thex = prefix + dns.ipv4.inet_ntoa(address[12:]) + else: + thex = ( + ":".join(chunks[:best_start]) + + "::" + + ":".join(chunks[best_start + best_len :]) + ) + else: + thex = ":".join(chunks) + return thex + + +_v4_ending = re.compile(rb"(.*):(\d+\.\d+\.\d+\.\d+)$") +_colon_colon_start = re.compile(rb"::.*") +_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`` 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. + + Returns a ``bytes``. + """ + + # + # Our aim here is not something fast; we just want something that works. + # + if not isinstance(text, bytes): + btext = text.encode() + else: + btext = text + + if ignore_scope: + parts = btext.split(b"%") + l = len(parts) + if l == 2: + btext = parts[0] + elif l > 2: + raise dns.exception.SyntaxError + + if btext == b"": + raise dns.exception.SyntaxError + elif btext.endswith(b":") and not btext.endswith(b"::"): + raise dns.exception.SyntaxError + elif btext.startswith(b":") and not btext.startswith(b"::"): + raise dns.exception.SyntaxError + elif btext == b"::": + btext = b"0::" + # + # Get rid of the icky dot-quad syntax if we have it. + # + m = _v4_ending.match(btext) + if m is not None: + b = dns.ipv4.inet_aton(m.group(2)) + btext = ( + "{}:{:02x}{:02x}:{:02x}{:02x}".format( + m.group(1).decode(), b[0], b[1], b[2], b[3] + ) + ).encode() + # + # Try to turn '::' into ':'; if no match try to + # turn '::' into ':' + # + m = _colon_colon_start.match(btext) + if m is not None: + btext = btext[1:] + else: + m = _colon_colon_end.match(btext) + if m is not None: + btext = btext[:-1] + # + # Now canonicalize into 8 chunks of 4 hex digits each + # + chunks = btext.split(b":") + l = len(chunks) + if l > 8: + raise dns.exception.SyntaxError + seen_empty = False + canonical: List[bytes] = [] + for c in chunks: + if c == b"": + if seen_empty: + raise dns.exception.SyntaxError + seen_empty = True + for _ in range(0, 8 - l + 1): + canonical.append(b"0000") + else: + lc = len(c) + if lc > 4: + raise dns.exception.SyntaxError + if lc != 4: + c = (b"0" * (4 - lc)) + c + canonical.append(c) + if l < 8 and not seen_empty: + raise dns.exception.SyntaxError + btext = b"".join(canonical) + + # + # Finally we can go to binary. + # + try: + return binascii.unhexlify(btext) + except (binascii.Error, TypeError): + raise dns.exception.SyntaxError + + +_mapped_prefix = b"\x00" * 10 + b"\xff\xff" + + +def is_mapped(address: bytes) -> bool: + """Is the specified address a mapped IPv4 address? + + *address*, a ``bytes`` is an IPv6 address in binary form. + + Returns a ``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/.venv/lib/python3.12/site-packages/dns/message.py b/.venv/lib/python3.12/site-packages/dns/message.py new file mode 100644 index 0000000..44cacbd --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/message.py @@ -0,0 +1,1888 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2001-2017 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""DNS Messages""" + +import contextlib +import io +import time +from typing import Any, Dict, List, Optional, Tuple, Union + +import dns.edns +import dns.entropy +import dns.enum +import dns.exception +import dns.flags +import dns.name +import dns.opcode +import dns.rcode +import dns.rdata +import dns.rdataclass +import dns.rdatatype +import dns.rdtypes.ANY.OPT +import dns.rdtypes.ANY.TSIG +import dns.renderer +import dns.rrset +import dns.tsig +import dns.ttl +import dns.wire + + +class ShortHeader(dns.exception.FormError): + """The DNS packet passed to from_wire() is too short.""" + + +class TrailingJunk(dns.exception.FormError): + """The DNS packet passed to from_wire() has extra junk at the end of it.""" + + +class UnknownHeaderField(dns.exception.DNSException): + """The header field name was not recognized when converting from text + into a message.""" + + +class BadEDNS(dns.exception.FormError): + """An OPT record occurred somewhere other than + the additional data section.""" + + +class BadTSIG(dns.exception.FormError): + """A TSIG record occurred somewhere other than the end of + the additional data section.""" + + +class UnknownTSIGKey(dns.exception.DNSException): + """A TSIG with an unknown key was received.""" + + +class Truncated(dns.exception.DNSException): + """The truncated flag is set.""" + + supp_kwargs = {"message"} + + # We do this as otherwise mypy complains about unexpected keyword argument + # idna_exception + def __init__(self, *args, **kwargs): + super().__init__(*args, **kwargs) + + def message(self): + """As much of the message as could be processed. + + Returns a ``dns.message.Message``. + """ + return self.kwargs["message"] + + +class NotQueryResponse(dns.exception.DNSException): + """Message is not a response to a query.""" + + +class ChainTooLong(dns.exception.DNSException): + """The CNAME chain is too long.""" + + +class AnswerForNXDOMAIN(dns.exception.DNSException): + """The rcode is NXDOMAIN but an answer was found.""" + + +class NoPreviousName(dns.exception.SyntaxError): + """No previous name was known.""" + + +class MessageSection(dns.enum.IntEnum): + """Message sections""" + + QUESTION = 0 + ANSWER = 1 + AUTHORITY = 2 + ADDITIONAL = 3 + + @classmethod + def _maximum(cls): + return 3 + + +class MessageError: + def __init__(self, exception: Exception, offset: int): + self.exception = exception + self.offset = offset + + +DEFAULT_EDNS_PAYLOAD = 1232 +MAX_CHAIN = 16 + +IndexKeyType = Tuple[ + int, + dns.name.Name, + dns.rdataclass.RdataClass, + dns.rdatatype.RdataType, + Optional[dns.rdatatype.RdataType], + Optional[dns.rdataclass.RdataClass], +] +IndexType = Dict[IndexKeyType, dns.rrset.RRset] +SectionType = Union[int, str, List[dns.rrset.RRset]] + + +class Message: + """A DNS message.""" + + _section_enum = MessageSection + + def __init__(self, id: Optional[int] = None): + if id is None: + self.id = dns.entropy.random_16() + else: + self.id = id + self.flags = 0 + self.sections: List[List[dns.rrset.RRset]] = [[], [], [], []] + self.opt: Optional[dns.rrset.RRset] = None + self.request_payload = 0 + self.pad = 0 + self.keyring: Any = None + self.tsig: Optional[dns.rrset.RRset] = None + self.request_mac = b"" + self.xfr = False + self.origin: Optional[dns.name.Name] = None + self.tsig_ctx: Optional[Any] = None + self.index: IndexType = {} + self.errors: List[MessageError] = [] + self.time = 0.0 + + @property + def question(self) -> List[dns.rrset.RRset]: + """The question section.""" + return self.sections[0] + + @question.setter + def question(self, v): + self.sections[0] = v + + @property + def answer(self) -> List[dns.rrset.RRset]: + """The answer section.""" + return self.sections[1] + + @answer.setter + def answer(self, v): + self.sections[1] = v + + @property + def authority(self) -> List[dns.rrset.RRset]: + """The authority section.""" + return self.sections[2] + + @authority.setter + def authority(self, v): + self.sections[2] = v + + @property + def additional(self) -> List[dns.rrset.RRset]: + """The additional data section.""" + return self.sections[3] + + @additional.setter + def additional(self, v): + self.sections[3] = v + + def __repr__(self): + return "" + + def __str__(self): + return self.to_text() + + def to_text( + self, + origin: Optional[dns.name.Name] = None, + relativize: bool = True, + **kw: Dict[str, Any], + ) -> str: + """Convert the message to text. + + The *origin*, *relativize*, and any other keyword + arguments are passed to the RRset ``to_wire()`` method. + + Returns a ``str``. + """ + + s = io.StringIO() + s.write("id %d\n" % self.id) + s.write("opcode %s\n" % dns.opcode.to_text(self.opcode())) + s.write("rcode %s\n" % dns.rcode.to_text(self.rcode())) + s.write("flags %s\n" % dns.flags.to_text(self.flags)) + if self.edns >= 0: + s.write("edns %s\n" % self.edns) + if self.ednsflags != 0: + s.write("eflags %s\n" % dns.flags.edns_to_text(self.ednsflags)) + s.write("payload %d\n" % self.payload) + for opt in self.options: + s.write("option %s\n" % opt.to_text()) + for name, which in self._section_enum.__members__.items(): + s.write(f";{name}\n") + for rrset in self.section_from_number(which): + s.write(rrset.to_text(origin, relativize, **kw)) + s.write("\n") + # + # We strip off the final \n so the caller can print the result without + # doing weird things to get around eccentricities in Python print + # formatting + # + return s.getvalue()[:-1] + + def __eq__(self, other): + """Two messages are equal if they have the same content in the + header, question, answer, and authority sections. + + Returns a ``bool``. + """ + + if not isinstance(other, Message): + return False + if self.id != other.id: + return False + if self.flags != other.flags: + return False + for i, section in enumerate(self.sections): + other_section = other.sections[i] + for n in section: + if n not in other_section: + return False + for n in other_section: + if n not in section: + return False + return True + + def __ne__(self, other): + return not self.__eq__(other) + + def is_response(self, other: "Message") -> bool: + """Is *other*, also a ``dns.message.Message``, a response to this + message? + + Returns a ``bool``. + """ + + if ( + other.flags & dns.flags.QR == 0 + or self.id != other.id + or dns.opcode.from_flags(self.flags) != dns.opcode.from_flags(other.flags) + ): + return False + if other.rcode() in { + dns.rcode.FORMERR, + dns.rcode.SERVFAIL, + dns.rcode.NOTIMP, + dns.rcode.REFUSED, + }: + # We don't check the question section in these cases if + # the other question section is empty, even though they + # still really ought to have a question section. + if len(other.question) == 0: + return True + if dns.opcode.is_update(self.flags): + # This is assuming the "sender doesn't include anything + # from the update", but we don't care to check the other + # case, which is that all the sections are returned and + # identical. + return True + for n in self.question: + if n not in other.question: + return False + for n in other.question: + if n not in self.question: + return False + return True + + def section_number(self, section: List[dns.rrset.RRset]) -> int: + """Return the "section number" of the specified section for use + in indexing. + + *section* is one of the section attributes of this message. + + Raises ``ValueError`` if the section isn't known. + + Returns an ``int``. + """ + + for i, our_section in enumerate(self.sections): + if section is our_section: + return self._section_enum(i) + raise ValueError("unknown section") + + def section_from_number(self, number: int) -> List[dns.rrset.RRset]: + """Return the section list associated with the specified section + number. + + *number* is a section number `int` or the text form of a section + name. + + Raises ``ValueError`` if the section isn't known. + + Returns a ``list``. + """ + + section = self._section_enum.make(number) + return self.sections[section] + + def find_rrset( + self, + section: SectionType, + name: dns.name.Name, + rdclass: dns.rdataclass.RdataClass, + rdtype: dns.rdatatype.RdataType, + covers: dns.rdatatype.RdataType = dns.rdatatype.NONE, + deleting: Optional[dns.rdataclass.RdataClass] = None, + create: bool = False, + force_unique: bool = False, + idna_codec: Optional[dns.name.IDNACodec] = None, + ) -> dns.rrset.RRset: + """Find the RRset with the given attributes 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 search. For example:: + + my_message.find_rrset(my_message.answer, name, rdclass, rdtype) + my_message.find_rrset(dns.message.ANSWER, name, rdclass, rdtype) + my_message.find_rrset("ANSWER", name, rdclass, rdtype) + + *name*, a ``dns.name.Name`` or ``str``, the name of the RRset. + + *rdclass*, an ``int`` or ``str``, the class of the RRset. + + *rdtype*, an ``int`` or ``str``, the type of the RRset. + + *covers*, an ``int`` or ``str``, the covers value of the RRset. + The default is ``dns.rdatatype.NONE``. + + *deleting*, an ``int``, ``str``, or ``None``, the deleting value of the + RRset. The default is ``None``. + + *create*, a ``bool``. If ``True``, create the RRset if it is not found. + The created RRset is appended to *section*. + + *force_unique*, a ``bool``. If ``True`` and *create* is also ``True``, + create a new RRset regardless of whether a matching RRset exists + already. The default is ``False``. This is useful when creating + DDNS Update messages, as order matters for them. + + *idna_codec*, a ``dns.name.IDNACodec``, specifies the IDNA + encoder/decoder. If ``None``, the default IDNA 2003 encoder/decoder + is used. + + Raises ``KeyError`` if the RRset was not found and create was + ``False``. + + Returns a ``dns.rrset.RRset object``. + """ + + 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) + if isinstance(name, str): + name = dns.name.from_text(name, idna_codec=idna_codec) + rdtype = dns.rdatatype.RdataType.make(rdtype) + rdclass = dns.rdataclass.RdataClass.make(rdclass) + covers = dns.rdatatype.RdataType.make(covers) + if deleting is not None: + deleting = dns.rdataclass.RdataClass.make(deleting) + key = (section_number, name, rdclass, rdtype, covers, deleting) + if not force_unique: + if self.index is not None: + rrset = self.index.get(key) + if rrset is not None: + return rrset + else: + for rrset in section: + if rrset.full_match(name, rdclass, rdtype, covers, deleting): + return rrset + if not create: + raise KeyError + rrset = dns.rrset.RRset(name, rdclass, rdtype, covers, deleting) + section.append(rrset) + if self.index is not None: + self.index[key] = rrset + return rrset + + def get_rrset( + self, + section: SectionType, + name: dns.name.Name, + rdclass: dns.rdataclass.RdataClass, + rdtype: dns.rdatatype.RdataType, + covers: dns.rdatatype.RdataType = dns.rdatatype.NONE, + deleting: Optional[dns.rdataclass.RdataClass] = None, + create: bool = False, + force_unique: bool = False, + idna_codec: Optional[dns.name.IDNACodec] = None, + ) -> Optional[dns.rrset.RRset]: + """Get the RRset with the given attributes in the specified section. + + If the RRset is not found, None is returned. + + *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 search. For example:: + + my_message.get_rrset(my_message.answer, name, rdclass, rdtype) + my_message.get_rrset(dns.message.ANSWER, name, rdclass, rdtype) + my_message.get_rrset("ANSWER", name, rdclass, rdtype) + + *name*, a ``dns.name.Name`` or ``str``, the name of the RRset. + + *rdclass*, an ``int`` or ``str``, the class of the RRset. + + *rdtype*, an ``int`` or ``str``, the type of the RRset. + + *covers*, an ``int`` or ``str``, the covers value of the RRset. + The default is ``dns.rdatatype.NONE``. + + *deleting*, an ``int``, ``str``, or ``None``, the deleting value of the + RRset. The default is ``None``. + + *create*, a ``bool``. If ``True``, create the RRset if it is not found. + The created RRset is appended to *section*. + + *force_unique*, a ``bool``. If ``True`` and *create* is also ``True``, + create a new RRset regardless of whether a matching RRset exists + already. The default is ``False``. This is useful when creating + DDNS Update messages, as order matters for them. + + *idna_codec*, a ``dns.name.IDNACodec``, specifies the IDNA + encoder/decoder. If ``None``, the default IDNA 2003 encoder/decoder + is used. + + Returns a ``dns.rrset.RRset object`` or ``None``. + """ + + try: + rrset = self.find_rrset( + section, + name, + rdclass, + rdtype, + covers, + deleting, + create, + force_unique, + idna_codec, + ) + except KeyError: + 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: + return 0 + # 1 byte for the root name, 10 for the standard RR fields + size = 11 + # This would be more efficient if options had a size() method, but we won't + # worry about that for now. We also don't worry if there is an existing padding + # option, as it is unlikely and probably harmless, as the worst case is that we + # may add another, and this seems to be legal. + for option in self.opt[0].options: + wire = option.to_wire() + # We add 4 here to account for the option type and length + size += len(wire) + 4 + if self.pad: + # Padding will be added, so again add the option type and length. + size += 4 + return size + + def _compute_tsig_reserve(self) -> int: + """Compute the size required for the TSIG RR""" + # This would be more efficient if TSIGs had a size method, but we won't + # worry about for now. Also, we can't really cope with the potential + # compressibility of the TSIG owner name, so we estimate with the uncompressed + # size. We will disable compression when TSIG and padding are both is active + # so that the padding comes out right. + if not self.tsig: + return 0 + f = io.BytesIO() + self.tsig.to_wire(f) + return len(f.getvalue()) + + def to_wire( + self, + origin: Optional[dns.name.Name] = None, + 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 + format. + + Additional keyword arguments are passed to the RRset ``to_wire()`` + method. + + *origin*, a ``dns.name.Name`` or ``None``, the origin to be appended + to any relative names. If ``None``, and the message has an origin + attribute that is not ``None``, then it will be used. + + *max_size*, an ``int``, the maximum size of the wire format + output; default is 0, which means "the message's request + payload, if nonzero, or 65535". + + *multi*, a ``bool``, should be set to ``True`` if this message is + part of a multiple message sequence. + + *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``. + """ + + if origin is None and self.origin is not None: + origin = self.origin + if max_size == 0: + if self.request_payload != 0: + max_size = self.request_payload + else: + max_size = 65535 + if max_size < 512: + max_size = 512 + elif max_size > 65535: + max_size = 65535 + r = dns.renderer.Renderer(self.id, self.flags, max_size, origin) + opt_reserve = self._compute_opt_reserve() + r.reserve(opt_reserve) + tsig_reserve = self._compute_tsig_reserve() + r.reserve(tsig_reserve) + 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) + r.write_header() + if self.tsig is not None: + (new_tsig, ctx) = dns.tsig.sign( + r.get_wire(), + self.keyring, + self.tsig[0], + int(time.time()), + self.request_mac, + tsig_ctx, + multi, + ) + self.tsig.clear() + self.tsig.add(new_tsig) + r.add_rrset(dns.renderer.ADDITIONAL, self.tsig) + r.write_header() + if multi: + self.tsig_ctx = ctx + wire = r.get_wire() + if prepend_length: + wire = len(wire).to_bytes(2, "big") + wire + return wire + + @staticmethod + def _make_tsig( + keyname, algorithm, time_signed, fudge, mac, original_id, error, other + ): + tsig = dns.rdtypes.ANY.TSIG.TSIG( + dns.rdataclass.ANY, + dns.rdatatype.TSIG, + algorithm, + time_signed, + fudge, + mac, + original_id, + error, + other, + ) + return dns.rrset.from_rdata(keyname, 0, tsig) + + def use_tsig( + self, + keyring: Any, + keyname: Optional[Union[dns.name.Name, str]] = None, + fudge: int = 300, + original_id: Optional[int] = None, + tsig_error: int = 0, + other_data: bytes = b"", + algorithm: Union[dns.name.Name, str] = dns.tsig.default_algorithm, + ) -> None: + """When sending, a TSIG signature using the specified key + should be added. + + *key*, a ``dns.tsig.Key`` is the key to use. If a key is specified, + the *keyring* and *algorithm* fields are not used. + + *keyring*, a ``dict``, ``callable`` or ``dns.tsig.Key``, is either + the TSIG keyring or key to use. + + The format of a keyring dict is a mapping from TSIG key name, as + ``dns.name.Name`` to ``dns.tsig.Key`` or a TSIG secret, a ``bytes``. + If a ``dict`` *keyring* is specified but a *keyname* is not, the key + used will be the first key in the *keyring*. Note that the order of + keys in a dictionary is not defined, so applications should supply a + keyname when a ``dict`` keyring is used, unless they know the keyring + contains only one key. If a ``callable`` keyring is specified, the + callable will be called with the message and the keyname, and is + expected to return a key. + + *keyname*, a ``dns.name.Name``, ``str`` or ``None``, the name of + this TSIG key to use; defaults to ``None``. If *keyring* is a + ``dict``, the key must be defined in it. If *keyring* is a + ``dns.tsig.Key``, this is ignored. + + *fudge*, an ``int``, the TSIG time fudge. + + *original_id*, an ``int``, the TSIG original id. If ``None``, + the message's id is used. + + *tsig_error*, an ``int``, the TSIG error code. + + *other_data*, a ``bytes``, the TSIG other data. + + *algorithm*, a ``dns.name.Name`` or ``str``, the TSIG algorithm to use. This is + only used if *keyring* is a ``dict``, and the key entry is a ``bytes``. + """ + + if isinstance(keyring, dns.tsig.Key): + key = keyring + keyname = key.name + elif callable(keyring): + key = keyring(self, keyname) + else: + if isinstance(keyname, str): + keyname = dns.name.from_text(keyname) + if keyname is None: + keyname = next(iter(keyring)) + key = keyring[keyname] + if isinstance(key, bytes): + key = dns.tsig.Key(keyname, key, algorithm) + self.keyring = key + if original_id is None: + original_id = self.id + self.tsig = self._make_tsig( + keyname, + self.keyring.algorithm, + 0, + fudge, + b"\x00" * dns.tsig.mac_sizes[self.keyring.algorithm], + original_id, + tsig_error, + other_data, + ) + + @property + def keyname(self) -> Optional[dns.name.Name]: + if self.tsig: + return self.tsig.name + else: + return None + + @property + def keyalgorithm(self) -> Optional[dns.name.Name]: + if self.tsig: + return self.tsig[0].algorithm + else: + return None + + @property + def mac(self) -> Optional[bytes]: + if self.tsig: + return self.tsig[0].mac + else: + return None + + @property + def tsig_error(self) -> Optional[int]: + if self.tsig: + return self.tsig[0].error + else: + return None + + @property + def had_tsig(self) -> bool: + return bool(self.tsig) + + @staticmethod + def _make_opt(flags=0, payload=DEFAULT_EDNS_PAYLOAD, options=None): + opt = dns.rdtypes.ANY.OPT.OPT(payload, dns.rdatatype.OPT, options or ()) + return dns.rrset.from_rdata(dns.name.root, int(flags), opt) + + def use_edns( + self, + edns: Optional[Union[int, bool]] = 0, + ednsflags: int = 0, + payload: int = DEFAULT_EDNS_PAYLOAD, + request_payload: Optional[int] = None, + options: Optional[List[dns.edns.Option]] = None, + pad: int = 0, + ) -> None: + """Configure EDNS behavior. + + *edns*, an ``int``, is the EDNS level to use. Specifying ``None``, ``False``, + or ``-1`` means "do not use EDNS", and in this case the other parameters are + ignored. Specifying ``True`` is equivalent to specifying 0, i.e. "use EDNS0". + + *ednsflags*, an ``int``, the EDNS flag values. + + *payload*, an ``int``, is the EDNS sender's payload field, which is the maximum + size of UDP datagram the sender can handle. I.e. how big a response to this + message can be. + + *request_payload*, an ``int``, is the EDNS payload size to use when sending this + message. If not specified, defaults to the value of *payload*. + + *options*, a list of ``dns.edns.Option`` objects or ``None``, the EDNS options. + + *pad*, a non-negative ``int``. If 0, the default, do not pad; otherwise 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 edns is None or edns is False: + edns = -1 + elif edns is True: + edns = 0 + if edns < 0: + self.opt = None + self.request_payload = 0 + else: + # make sure the EDNS version in ednsflags agrees with edns + ednsflags &= 0xFF00FFFF + ednsflags |= edns << 16 + if options is None: + options = [] + self.opt = self._make_opt(ednsflags, payload, options) + 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 + def edns(self) -> int: + if self.opt: + return (self.ednsflags & 0xFF0000) >> 16 + else: + return -1 + + @property + def ednsflags(self) -> int: + if self.opt: + return self.opt.ttl + else: + return 0 + + @ednsflags.setter + def ednsflags(self, v): + if self.opt: + self.opt.ttl = v + elif v: + self.opt = self._make_opt(v) + + @property + def payload(self) -> int: + if self.opt: + return self.opt[0].payload + else: + return 0 + + @property + def options(self) -> Tuple: + if self.opt: + return self.opt[0].options + else: + return () + + def want_dnssec(self, wanted: bool = True) -> None: + """Enable or disable 'DNSSEC desired' flag in requests. + + *wanted*, a ``bool``. If ``True``, then DNSSEC data is + desired in the response, EDNS is enabled if required, and then + the DO bit is set. If ``False``, the DO bit is cleared if + EDNS is enabled. + """ + + if wanted: + self.ednsflags |= dns.flags.DO + elif self.opt: + self.ednsflags &= ~int(dns.flags.DO) + + def rcode(self) -> dns.rcode.Rcode: + """Return the rcode. + + Returns a ``dns.rcode.Rcode``. + """ + return dns.rcode.from_flags(int(self.flags), int(self.ednsflags)) + + def set_rcode(self, rcode: dns.rcode.Rcode) -> None: + """Set the rcode. + + *rcode*, a ``dns.rcode.Rcode``, is the rcode to set. + """ + (value, evalue) = dns.rcode.to_flags(rcode) + self.flags &= 0xFFF0 + self.flags |= value + self.ednsflags &= 0x00FFFFFF + self.ednsflags |= evalue + + def opcode(self) -> dns.opcode.Opcode: + """Return the opcode. + + Returns a ``dns.opcode.Opcode``. + """ + return dns.opcode.from_flags(int(self.flags)) + + def set_opcode(self, opcode: dns.opcode.Opcode) -> None: + """Set the opcode. + + *opcode*, a ``dns.opcode.Opcode``, is the opcode to set. + """ + self.flags &= 0x87FF + self.flags |= dns.opcode.to_flags(opcode) + + def _get_one_rr_per_rrset(self, value): + # What the caller picked is fine. + return value + + # pylint: disable=unused-argument + + def _parse_rr_header(self, section, name, rdclass, rdtype): + return (rdclass, rdtype, None, False) + + # pylint: enable=unused-argument + + def _parse_special_rr_header(self, section, count, position, name, rdclass, rdtype): + if rdtype == dns.rdatatype.OPT: + if ( + section != MessageSection.ADDITIONAL + or self.opt + or name != dns.name.root + ): + raise BadEDNS + elif rdtype == dns.rdatatype.TSIG: + if ( + section != MessageSection.ADDITIONAL + or rdclass != dns.rdatatype.ANY + or position != count - 1 + ): + raise BadTSIG + return (rdclass, rdtype, None, False) + + +class ChainingResult: + """The result of a call to dns.message.QueryMessage.resolve_chaining(). + + The ``answer`` attribute is the answer RRSet, or ``None`` if it doesn't + exist. + + The ``canonical_name`` attribute is the canonical name after all + chaining has been applied (this is the same name as ``rrset.name`` in cases + where rrset is not ``None``). + + The ``minimum_ttl`` attribute is the minimum TTL, i.e. the TTL to + use if caching the data. It is the smallest of all the CNAME TTLs + and either the answer TTL if it exists or the SOA TTL and SOA + minimum values for negative answers. + + The ``cnames`` attribute is a list of all the CNAME RRSets followed to + get to the canonical name. + """ + + def __init__( + self, + canonical_name: dns.name.Name, + answer: Optional[dns.rrset.RRset], + minimum_ttl: int, + cnames: List[dns.rrset.RRset], + ): + self.canonical_name = canonical_name + self.answer = answer + self.minimum_ttl = minimum_ttl + self.cnames = cnames + + +class QueryMessage(Message): + def resolve_chaining(self) -> ChainingResult: + """Follow the CNAME chain in the response to determine the answer + RRset. + + Raises ``dns.message.NotQueryResponse`` if the message is not + a response. + + Raises ``dns.message.ChainTooLong`` if the CNAME chain is too long. + + Raises ``dns.message.AnswerForNXDOMAIN`` if the rcode is NXDOMAIN + but an answer was found. + + Raises ``dns.exception.FormError`` if the question count is not 1. + + Returns a ChainingResult object. + """ + if self.flags & dns.flags.QR == 0: + raise NotQueryResponse + if len(self.question) != 1: + raise dns.exception.FormError + question = self.question[0] + qname = question.name + min_ttl = dns.ttl.MAX_TTL + answer = None + count = 0 + cnames = [] + while count < MAX_CHAIN: + try: + answer = self.find_rrset( + self.answer, qname, question.rdclass, question.rdtype + ) + min_ttl = min(min_ttl, answer.ttl) + break + except KeyError: + if question.rdtype != dns.rdatatype.CNAME: + try: + crrset = self.find_rrset( + self.answer, qname, question.rdclass, dns.rdatatype.CNAME + ) + cnames.append(crrset) + min_ttl = min(min_ttl, crrset.ttl) + for rd in crrset: + qname = rd.target + break + count += 1 + continue + except KeyError: + # Exit the chaining loop + break + else: + # Exit the chaining loop + break + if count >= MAX_CHAIN: + raise ChainTooLong + if self.rcode() == dns.rcode.NXDOMAIN and answer is not None: + raise AnswerForNXDOMAIN + if answer is None: + # Further minimize the TTL with NCACHE. + auname = qname + while True: + # Look for an SOA RR whose owner name is a superdomain + # of qname. + try: + srrset = self.find_rrset( + self.authority, auname, question.rdclass, dns.rdatatype.SOA + ) + min_ttl = min(min_ttl, srrset.ttl, srrset[0].minimum) + break + except KeyError: + try: + auname = auname.parent() + except dns.name.NoParent: + break + return ChainingResult(qname, answer, min_ttl, cnames) + + def canonical_name(self) -> dns.name.Name: + """Return the canonical name of the first name in the question + section. + + Raises ``dns.message.NotQueryResponse`` if the message is not + a response. + + Raises ``dns.message.ChainTooLong`` if the CNAME chain is too long. + + Raises ``dns.message.AnswerForNXDOMAIN`` if the rcode is NXDOMAIN + but an answer was found. + + Raises ``dns.exception.FormError`` if the question count is not 1. + """ + return self.resolve_chaining().canonical_name + + +def _maybe_import_update(): + # We avoid circular imports by doing this here. We do it in another + # function as doing it in _message_factory_from_opcode() makes "dns" + # a local symbol, and the first line fails :) + + # pylint: disable=redefined-outer-name,import-outside-toplevel,unused-import + import dns.update # noqa: F401 + + +def _message_factory_from_opcode(opcode): + if opcode == dns.opcode.QUERY: + return QueryMessage + elif opcode == dns.opcode.UPDATE: + _maybe_import_update() + return dns.update.UpdateMessage + else: + return Message + + +class _WireReader: + """Wire format reader. + + parser: the binary parser + message: The message object being built + initialize_message: Callback to set message parsing options + question_only: Are we only reading the question? + one_rr_per_rrset: Put each RR into its own RRset? + keyring: TSIG keyring + ignore_trailing: Ignore trailing junk at end of request? + multi: Is this message part of a multi-message sequence? + DNS dynamic updates. + continue_on_error: try to extract as much information as possible from + the message, accumulating MessageErrors in the *errors* attribute instead of + raising them. + """ + + def __init__( + self, + wire, + initialize_message, + question_only=False, + one_rr_per_rrset=False, + ignore_trailing=False, + keyring=None, + multi=False, + continue_on_error=False, + ): + self.parser = dns.wire.Parser(wire) + self.message = None + self.initialize_message = initialize_message + self.question_only = question_only + self.one_rr_per_rrset = one_rr_per_rrset + self.ignore_trailing = ignore_trailing + self.keyring = keyring + self.multi = multi + self.continue_on_error = continue_on_error + self.errors = [] + + def _get_question(self, section_number, qcount): + """Read the next *qcount* records from the wire data and add them to + the question section. + """ + assert self.message is not None + section = self.message.sections[section_number] + for _ in range(qcount): + qname = self.parser.get_name(self.message.origin) + (rdtype, rdclass) = self.parser.get_struct("!HH") + (rdclass, rdtype, _, _) = self.message._parse_rr_header( + section_number, qname, rdclass, rdtype + ) + self.message.find_rrset( + section, qname, rdclass, rdtype, create=True, force_unique=True + ) + + def _add_error(self, e): + self.errors.append(MessageError(e, self.parser.current)) + + def _get_section(self, section_number, count): + """Read the next I{count} records from the wire data and add them to + the specified section. + + section_number: the section of the message to which to add records + count: the number of records to read + """ + assert self.message is not None + section = self.message.sections[section_number] + force_unique = self.one_rr_per_rrset + for i in range(count): + rr_start = self.parser.current + absolute_name = self.parser.get_name() + if self.message.origin is not None: + name = absolute_name.relativize(self.message.origin) + else: + name = absolute_name + (rdtype, rdclass, ttl, rdlen) = self.parser.get_struct("!HHIH") + if rdtype in (dns.rdatatype.OPT, dns.rdatatype.TSIG): + ( + rdclass, + rdtype, + deleting, + empty, + ) = self.message._parse_special_rr_header( + section_number, count, i, name, rdclass, rdtype + ) + else: + (rdclass, rdtype, deleting, empty) = self.message._parse_rr_header( + section_number, name, rdclass, rdtype + ) + rdata_start = self.parser.current + try: + if empty: + if rdlen > 0: + raise dns.exception.FormError + rd = None + covers = dns.rdatatype.NONE + else: + with self.parser.restrict_to(rdlen): + rd = dns.rdata.from_wire_parser( + rdclass, rdtype, self.parser, self.message.origin + ) + covers = rd.covers() + if self.message.xfr and rdtype == dns.rdatatype.SOA: + force_unique = True + if rdtype == dns.rdatatype.OPT: + self.message.opt = dns.rrset.from_rdata(name, ttl, rd) + elif rdtype == dns.rdatatype.TSIG: + if self.keyring is None: + raise UnknownTSIGKey("got signed message without keyring") + if isinstance(self.keyring, dict): + key = self.keyring.get(absolute_name) + if isinstance(key, bytes): + key = dns.tsig.Key(absolute_name, key, rd.algorithm) + elif callable(self.keyring): + key = self.keyring(self.message, absolute_name) + else: + key = self.keyring + if key is None: + raise UnknownTSIGKey("key '%s' unknown" % name) + self.message.keyring = key + self.message.tsig_ctx = dns.tsig.validate( + self.parser.wire, + key, + absolute_name, + rd, + int(time.time()), + self.message.request_mac, + rr_start, + self.message.tsig_ctx, + self.multi, + ) + self.message.tsig = dns.rrset.from_rdata(absolute_name, 0, rd) + else: + rrset = self.message.find_rrset( + section, + name, + rdclass, + rdtype, + covers, + deleting, + True, + force_unique, + ) + if rd is not None: + if ttl > 0x7FFFFFFF: + ttl = 0 + rrset.add(rd, ttl) + except Exception as e: + if self.continue_on_error: + self._add_error(e) + self.parser.seek(rdata_start + rdlen) + else: + raise + + def read(self): + """Read a wire format DNS message and build a dns.message.Message + object.""" + + if self.parser.remaining() < 12: + raise ShortHeader + (id, flags, qcount, ancount, aucount, adcount) = self.parser.get_struct( + "!HHHHHH" + ) + factory = _message_factory_from_opcode(dns.opcode.from_flags(flags)) + self.message = factory(id=id) + self.message.flags = dns.flags.Flag(flags) + self.initialize_message(self.message) + self.one_rr_per_rrset = self.message._get_one_rr_per_rrset( + self.one_rr_per_rrset + ) + try: + self._get_question(MessageSection.QUESTION, qcount) + if self.question_only: + return self.message + self._get_section(MessageSection.ANSWER, ancount) + self._get_section(MessageSection.AUTHORITY, aucount) + self._get_section(MessageSection.ADDITIONAL, adcount) + if not self.ignore_trailing and self.parser.remaining() != 0: + raise TrailingJunk + if self.multi and self.message.tsig_ctx and not self.message.had_tsig: + self.message.tsig_ctx.update(self.parser.wire) + except Exception as e: + if self.continue_on_error: + self._add_error(e) + else: + raise + return self.message + + +def from_wire( + wire: bytes, + keyring: Optional[Any] = None, + request_mac: Optional[bytes] = b"", + xfr: bool = False, + origin: Optional[dns.name.Name] = None, + tsig_ctx: Optional[Union[dns.tsig.HMACTSig, dns.tsig.GSSTSig]] = None, + multi: bool = False, + question_only: bool = False, + one_rr_per_rrset: bool = False, + ignore_trailing: bool = False, + raise_on_truncation: bool = False, + continue_on_error: bool = False, +) -> Message: + """Convert a DNS wire format message into a message object. + + *keyring*, a ``dns.tsig.Key`` or ``dict``, the key or keyring to use if the message + is signed. + + *request_mac*, a ``bytes`` or ``None``. If the message is a response to a + TSIG-signed request, *request_mac* should be set to the MAC of that request. + + *xfr*, a ``bool``, should be set to ``True`` if this message is part of a zone + transfer. + + *origin*, a ``dns.name.Name`` or ``None``. If the message is part of a zone + transfer, *origin* should be the origin name of the zone. If not ``None``, names + will be relativized to the origin. + + *tsig_ctx*, a ``dns.tsig.HMACTSig`` or ``dns.tsig.GSSTSig`` object, the ongoing TSIG + context, used when validating zone transfers. + + *multi*, a ``bool``, should be set to ``True`` if this message is part of a multiple + message sequence. + + *question_only*, a ``bool``. If ``True``, read only up to the end of the question + section. + + *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 + message. + + *raise_on_truncation*, a ``bool``. If ``True``, raise an exception if the TC bit is + set. + + *continue_on_error*, a ``bool``. If ``True``, try to continue parsing even if + errors occur. Erroneous rdata will be ignored. Errors will be accumulated as a + list of MessageError objects in the message's ``errors`` attribute. This option is + recommended only for DNS analysis tools, or for use in a server as part of an error + handling path. The default is ``False``. + + Raises ``dns.message.ShortHeader`` if the message is less than 12 octets long. + + Raises ``dns.message.TrailingJunk`` if there were octets in the message past the end + of the proper DNS message, and *ignore_trailing* is ``False``. + + Raises ``dns.message.BadEDNS`` if an OPT record was in the wrong section, or + occurred more than once. + + Raises ``dns.message.BadTSIG`` if a TSIG record was not the last record of the + additional data section. + + Raises ``dns.message.Truncated`` if the TC flag is set and *raise_on_truncation* is + ``True``. + + Returns a ``dns.message.Message``. + """ + + # We permit None for request_mac solely for backwards compatibility + if request_mac is None: + request_mac = b"" + + def initialize_message(message): + message.request_mac = request_mac + message.xfr = xfr + message.origin = origin + message.tsig_ctx = tsig_ctx + + reader = _WireReader( + wire, + initialize_message, + question_only, + one_rr_per_rrset, + ignore_trailing, + keyring, + multi, + continue_on_error, + ) + try: + m = reader.read() + except dns.exception.FormError: + if ( + reader.message + and (reader.message.flags & dns.flags.TC) + and raise_on_truncation + ): + raise Truncated(message=reader.message) + else: + raise + # Reading a truncated message might not have any errors, so we + # have to do this check here too. + if m.flags & dns.flags.TC and raise_on_truncation: + raise Truncated(message=m) + if continue_on_error: + m.errors = reader.errors + + return m + + +class _TextReader: + """Text format reader. + + tok: the tokenizer. + message: The message object being built. + DNS dynamic updates. + last_name: The most recently read name when building a message object. + one_rr_per_rrset: Put each RR into its own RRset? + origin: The origin for relative names + relativize: relativize names? + relativize_to: the origin to relativize to. + """ + + def __init__( + self, + text, + idna_codec, + one_rr_per_rrset=False, + origin=None, + relativize=True, + relativize_to=None, + ): + self.message = None + self.tok = dns.tokenizer.Tokenizer(text, idna_codec=idna_codec) + self.last_name = None + self.one_rr_per_rrset = one_rr_per_rrset + self.origin = origin + self.relativize = relativize + self.relativize_to = relativize_to + self.id = None + self.edns = -1 + self.ednsflags = 0 + self.payload = DEFAULT_EDNS_PAYLOAD + self.rcode = None + self.opcode = dns.opcode.QUERY + self.flags = 0 + + def _header_line(self, _): + """Process one line from the text format header section.""" + + token = self.tok.get() + what = token.value + if what == "id": + self.id = self.tok.get_int() + elif what == "flags": + while True: + token = self.tok.get() + if not token.is_identifier(): + self.tok.unget(token) + break + self.flags = self.flags | dns.flags.from_text(token.value) + elif what == "edns": + self.edns = self.tok.get_int() + self.ednsflags = self.ednsflags | (self.edns << 16) + elif what == "eflags": + if self.edns < 0: + self.edns = 0 + while True: + token = self.tok.get() + if not token.is_identifier(): + self.tok.unget(token) + break + self.ednsflags = self.ednsflags | dns.flags.edns_from_text(token.value) + elif what == "payload": + self.payload = self.tok.get_int() + if self.edns < 0: + self.edns = 0 + elif what == "opcode": + text = self.tok.get_string() + self.opcode = dns.opcode.from_text(text) + self.flags = self.flags | dns.opcode.to_flags(self.opcode) + elif what == "rcode": + text = self.tok.get_string() + self.rcode = dns.rcode.from_text(text) + else: + raise UnknownHeaderField + self.tok.get_eol() + + def _question_line(self, section_number): + """Process one line from the text format question section.""" + + section = self.message.sections[section_number] + token = self.tok.get(want_leading=True) + if not token.is_whitespace(): + self.last_name = self.tok.as_name( + token, self.message.origin, self.relativize, self.relativize_to + ) + name = self.last_name + if name is None: + raise NoPreviousName + token = self.tok.get() + if not token.is_identifier(): + raise dns.exception.SyntaxError + # Class + try: + rdclass = dns.rdataclass.from_text(token.value) + token = self.tok.get() + if not token.is_identifier(): + raise dns.exception.SyntaxError + except dns.exception.SyntaxError: + raise dns.exception.SyntaxError + except Exception: + rdclass = dns.rdataclass.IN + # Type + rdtype = dns.rdatatype.from_text(token.value) + (rdclass, rdtype, _, _) = self.message._parse_rr_header( + section_number, name, rdclass, rdtype + ) + self.message.find_rrset( + section, name, rdclass, rdtype, create=True, force_unique=True + ) + self.tok.get_eol() + + def _rr_line(self, section_number): + """Process one line from the text format answer, authority, or + additional data sections. + """ + + section = self.message.sections[section_number] + # Name + token = self.tok.get(want_leading=True) + if not token.is_whitespace(): + self.last_name = self.tok.as_name( + token, self.message.origin, self.relativize, self.relativize_to + ) + name = self.last_name + if name is None: + raise NoPreviousName + token = self.tok.get() + if not token.is_identifier(): + raise dns.exception.SyntaxError + # TTL + try: + ttl = int(token.value, 0) + token = self.tok.get() + if not token.is_identifier(): + raise dns.exception.SyntaxError + except dns.exception.SyntaxError: + raise dns.exception.SyntaxError + except Exception: + ttl = 0 + # Class + try: + rdclass = dns.rdataclass.from_text(token.value) + token = self.tok.get() + if not token.is_identifier(): + raise dns.exception.SyntaxError + except dns.exception.SyntaxError: + raise dns.exception.SyntaxError + except Exception: + rdclass = dns.rdataclass.IN + # Type + rdtype = dns.rdatatype.from_text(token.value) + (rdclass, rdtype, deleting, empty) = self.message._parse_rr_header( + section_number, name, rdclass, rdtype + ) + token = self.tok.get() + if empty and not token.is_eol_or_eof(): + raise dns.exception.SyntaxError + if not empty and token.is_eol_or_eof(): + raise dns.exception.UnexpectedEnd + if not token.is_eol_or_eof(): + self.tok.unget(token) + rd = dns.rdata.from_text( + rdclass, + rdtype, + self.tok, + self.message.origin, + self.relativize, + self.relativize_to, + ) + covers = rd.covers() + else: + rd = None + covers = dns.rdatatype.NONE + rrset = self.message.find_rrset( + section, + name, + rdclass, + rdtype, + covers, + deleting, + True, + self.one_rr_per_rrset, + ) + if rd is not None: + rrset.add(rd, ttl) + + def _make_message(self): + factory = _message_factory_from_opcode(self.opcode) + message = factory(id=self.id) + message.flags = self.flags + if self.edns >= 0: + message.use_edns(self.edns, self.ednsflags, self.payload) + if self.rcode: + message.set_rcode(self.rcode) + if self.origin: + message.origin = self.origin + return message + + def read(self): + """Read a text format DNS message and build a dns.message.Message + object.""" + + line_method = self._header_line + section_number = None + while 1: + token = self.tok.get(True, True) + if token.is_eol_or_eof(): + break + if token.is_comment(): + u = token.value.upper() + if u == "HEADER": + line_method = self._header_line + + if self.message: + message = self.message + else: + # If we don't have a message, create one with the current + # opcode, so that we know which section names to parse. + message = self._make_message() + try: + section_number = message._section_enum.from_text(u) + # We found a section name. If we don't have a message, + # use the one we just created. + if not self.message: + self.message = message + self.one_rr_per_rrset = message._get_one_rr_per_rrset( + self.one_rr_per_rrset + ) + if section_number == MessageSection.QUESTION: + line_method = self._question_line + else: + line_method = self._rr_line + except Exception: + # It's just a comment. + pass + self.tok.get_eol() + continue + self.tok.unget(token) + line_method(section_number) + if not self.message: + self.message = self._make_message() + return self.message + + +def from_text( + text: str, + idna_codec: Optional[dns.name.IDNACodec] = None, + one_rr_per_rrset: bool = False, + origin: Optional[dns.name.Name] = None, + relativize: bool = True, + relativize_to: Optional[dns.name.Name] = None, +) -> Message: + """Convert the text format message into a message object. + + The reader stops after reading the first blank line in the input to + facilitate reading multiple messages from a single file with + ``dns.message.from_file()``. + + *text*, a ``str``, the text format message. + + *idna_codec*, a ``dns.name.IDNACodec``, specifies the IDNA + encoder/decoder. If ``None``, the default IDNA 2003 encoder/decoder + is used. + + *one_rr_per_rrset*, a ``bool``. If ``True``, then each RR is put + into its own rrset. The default is ``False``. + + *origin*, a ``dns.name.Name`` (or ``None``), the + origin to use for relative names. + + *relativize*, a ``bool``. If true, name will be relativized. + + *relativize_to*, a ``dns.name.Name`` (or ``None``), the origin to use + when relativizing names. If not set, the *origin* value will be used. + + Raises ``dns.message.UnknownHeaderField`` if a header is unknown. + + Raises ``dns.exception.SyntaxError`` if the text is badly formed. + + Returns a ``dns.message.Message object`` + """ + + # '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(). + + reader = _TextReader( + text, idna_codec, one_rr_per_rrset, origin, relativize, relativize_to + ) + return reader.read() + + +def from_file( + f: Any, + idna_codec: Optional[dns.name.IDNACodec] = None, + one_rr_per_rrset: bool = False, +) -> Message: + """Read the next text format message from the specified file. + + Message blocks are separated by a single blank line. + + *f*, a ``file`` or ``str``. If *f* is text, it is treated as the + pathname of a file to open. + + *idna_codec*, a ``dns.name.IDNACodec``, specifies the IDNA + encoder/decoder. If ``None``, the default IDNA 2003 encoder/decoder + is used. + + *one_rr_per_rrset*, a ``bool``. If ``True``, then each RR is put + into its own rrset. The default is ``False``. + + Raises ``dns.message.UnknownHeaderField`` if a header is unknown. + + Raises ``dns.exception.SyntaxError`` if the text is badly formed. + + Returns a ``dns.message.Message object`` + """ + + if isinstance(f, str): + cm: contextlib.AbstractContextManager = open(f) + else: + cm = contextlib.nullcontext(f) + with cm as f: + return from_text(f, idna_codec, one_rr_per_rrset) + assert False # for mypy lgtm[py/unreachable-statement] + + +def make_query( + qname: Union[dns.name.Name, str], + rdtype: Union[dns.rdatatype.RdataType, str], + rdclass: Union[dns.rdataclass.RdataClass, str] = dns.rdataclass.IN, + use_edns: Optional[Union[int, bool]] = None, + want_dnssec: bool = False, + ednsflags: Optional[int] = None, + payload: Optional[int] = None, + request_payload: Optional[int] = None, + options: Optional[List[dns.edns.Option]] = None, + idna_codec: Optional[dns.name.IDNACodec] = None, + id: Optional[int] = None, + flags: int = dns.flags.RD, + pad: int = 0, +) -> QueryMessage: + """Make a query message. + + The query name, type, and class may all be specified either + as objects of the appropriate type, or as strings. + + The query will have a randomly chosen query id, and its DNS flags + will be set to dns.flags.RD. + + qname, a ``dns.name.Name`` or ``str``, the query name. + + *rdtype*, an ``int`` or ``str``, the desired rdata type. + + *rdclass*, an ``int`` or ``str``, the desired rdata class; the default + is class IN. + + *use_edns*, an ``int``, ``bool`` or ``None``. The EDNS level to use; the + default is ``None``. If ``None``, EDNS will be enabled only if other + parameters (*ednsflags*, *payload*, *request_payload*, or *options*) are + set. + See the description of dns.message.Message.use_edns() for the possible + values for use_edns and their meanings. + + *want_dnssec*, a ``bool``. If ``True``, DNSSEC data is desired. + + *ednsflags*, an ``int``, the EDNS flag values. + + *payload*, an ``int``, is the EDNS sender's payload field, which is the + maximum size of UDP datagram the sender can handle. I.e. how big + a response to this message can be. + + *request_payload*, an ``int``, is the EDNS payload size to use when + sending this message. If not specified, defaults to the value of + *payload*. + + *options*, a list of ``dns.edns.Option`` objects or ``None``, the EDNS + options. + + *idna_codec*, a ``dns.name.IDNACodec``, specifies the IDNA + encoder/decoder. If ``None``, the default IDNA 2003 encoder/decoder + is used. + + *id*, an ``int`` or ``None``, the desired query id. The default is + ``None``, which generates a random query id. + + *flags*, an ``int``, the desired query flags. The default is + ``dns.flags.RD``. + + *pad*, a non-negative ``int``. If 0, the default, do not pad; otherwise 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. + + Returns a ``dns.message.QueryMessage`` + """ + + if isinstance(qname, str): + qname = dns.name.from_text(qname, idna_codec=idna_codec) + rdtype = dns.rdatatype.RdataType.make(rdtype) + rdclass = dns.rdataclass.RdataClass.make(rdclass) + m = QueryMessage(id=id) + m.flags = dns.flags.Flag(flags) + m.find_rrset(m.question, qname, rdclass, rdtype, create=True, force_unique=True) + # only pass keywords on to use_edns if they have been set to a + # non-None value. Setting a field will turn EDNS on if it hasn't + # been configured. + kwargs: Dict[str, Any] = {} + if ednsflags is not None: + kwargs["ednsflags"] = ednsflags + if payload is not None: + kwargs["payload"] = payload + if request_payload is not None: + kwargs["request_payload"] = request_payload + if options is not None: + kwargs["options"] = options + if kwargs and use_edns is None: + use_edns = 0 + kwargs["edns"] = use_edns + kwargs["pad"] = pad + m.use_edns(**kwargs) + m.want_dnssec(want_dnssec) + return m + + +def make_response( + query: Message, + recursion_available: bool = False, + 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 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. + + *fudge*, an ``int``, the TSIG time fudge. + + *tsig_error*, an ``int``, the TSIG error. + + *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: + raise dns.exception.FormError("specified query message is not a query") + factory = _message_factory_from_opcode(query.opcode()) + response = factory(id=query.id) + response.flags = dns.flags.QR | (query.flags & dns.flags.RD) + if recursion_available: + response.flags |= dns.flags.RA + response.set_opcode(query.opcode()) + response.question = list(query.question) + if query.edns >= 0: + 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, + query.keyname, + fudge, + None, + tsig_error, + b"", + query.keyalgorithm, + ) + response.request_mac = query.mac + return response + + +### BEGIN generated MessageSection constants + +QUESTION = MessageSection.QUESTION +ANSWER = MessageSection.ANSWER +AUTHORITY = MessageSection.AUTHORITY +ADDITIONAL = MessageSection.ADDITIONAL + +### END generated MessageSection constants diff --git a/.venv/lib/python3.12/site-packages/dns/name.py b/.venv/lib/python3.12/site-packages/dns/name.py new file mode 100644 index 0000000..22ccb39 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/name.py @@ -0,0 +1,1283 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2001-2017 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""DNS Names. +""" + +import copy +import encodings.idna # type: ignore +import functools +import struct +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] + + +class NameRelation(dns.enum.IntEnum): + """Name relation result from fullcompare().""" + + # This is an IntEnum for backwards compatibility in case anyone + # has hardwired the constants. + + #: The compared names have no relationship to each other. + NONE = 0 + #: the first name is a superdomain of the second. + SUPERDOMAIN = 1 + #: The first name is a subdomain of the second. + SUBDOMAIN = 2 + #: The compared names are equal. + EQUAL = 3 + #: The compared names have a common ancestor. + COMMONANCESTOR = 4 + + @classmethod + def _maximum(cls): + return cls.COMMONANCESTOR + + @classmethod + def _short_name(cls): + return cls.__name__ + + +# Backwards compatibility +NAMERELN_NONE = NameRelation.NONE +NAMERELN_SUPERDOMAIN = NameRelation.SUPERDOMAIN +NAMERELN_SUBDOMAIN = NameRelation.SUBDOMAIN +NAMERELN_EQUAL = NameRelation.EQUAL +NAMERELN_COMMONANCESTOR = NameRelation.COMMONANCESTOR + + +class EmptyLabel(dns.exception.SyntaxError): + """A DNS label is empty.""" + + +class BadEscape(dns.exception.SyntaxError): + """An escaped code in a text format of DNS name is invalid.""" + + +class BadPointer(dns.exception.FormError): + """A DNS compression pointer points forward instead of backward.""" + + +class BadLabelType(dns.exception.FormError): + """The label type in DNS name wire format is unknown.""" + + +class NeedAbsoluteNameOrOrigin(dns.exception.DNSException): + """An attempt was made to convert a non-absolute name to + wire when there was also a non-absolute (or missing) origin.""" + + +class NameTooLong(dns.exception.FormError): + """A DNS name is > 255 octets long.""" + + +class LabelTooLong(dns.exception.SyntaxError): + """A DNS label is > 63 octets long.""" + + +class AbsoluteConcatenation(dns.exception.DNSException): + """An attempt was made to append anything other than the + empty name to an absolute DNS name.""" + + +class NoParent(dns.exception.DNSException): + """An attempt was made to get the parent of the root name + or the empty name.""" + + +class NoIDNA2008(dns.exception.DNSException): + """IDNA 2008 processing was requested but the idna module is not + available.""" + + +class IDNAException(dns.exception.DNSException): + """IDNA processing raised an exception.""" + + supp_kwargs = {"idna_exception"} + fmt = "IDNA processing exception: {idna_exception}" + + # We do this as otherwise mypy complains about unexpected keyword argument + # idna_exception + def __init__(self, *args, **kwargs): + 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 = '"().;\\@$' + + +def _escapify(label: Union[bytes, str]) -> str: + """Escape the characters in label which need it. + @returns: the escaped string + @rtype: string""" + if isinstance(label, bytes): + # Ordinary DNS label mode. Escape special characters and values + # < 0x20 or > 0x7f. + text = "" + for c in label: + if c in _escaped: + text += "\\" + chr(c) + elif c > 0x20 and c < 0x7F: + text += chr(c) + else: + text += "\\%03d" % c + return text + + # Unicode label mode. Escape only special characters and values < 0x20 + text = "" + for uc in label: + if uc in _escaped_text: + text += "\\" + uc + elif uc <= "\x20": + text += "\\%03d" % ord(uc) + else: + text += uc + return text + + +class IDNACodec: + """Abstract base class for IDNA encoder/decoders.""" + + def __init__(self): + pass + + def is_idna(self, label: bytes) -> bool: + return label.lower().startswith(b"xn--") + + def encode(self, label: str) -> bytes: + raise NotImplementedError # pragma: no cover + + def decode(self, label: bytes) -> str: + # We do not apply any IDNA policy on decode. + if self.is_idna(label): + try: + slabel = label[4:].decode("punycode") + return _escapify(slabel) + except Exception as e: + raise IDNAException(idna_exception=e) + else: + return _escapify(label) + + +class IDNA2003Codec(IDNACodec): + """IDNA 2003 encoder/decoder.""" + + def __init__(self, strict_decode: bool = False): + """Initialize the IDNA 2003 encoder/decoder. + + *strict_decode* is a ``bool``. If `True`, then IDNA2003 checking + is done when decoding. This can cause failures if the name + was encoded with IDNA2008. The default is `False`. + """ + + super().__init__() + self.strict_decode = strict_decode + + def encode(self, label: str) -> bytes: + """Encode *label*.""" + + if label == "": + return b"" + try: + return encodings.idna.ToASCII(label) + except UnicodeError: + raise LabelTooLong + + def decode(self, label: bytes) -> str: + """Decode *label*.""" + if not self.strict_decode: + return super().decode(label) + if label == b"": + return "" + try: + return _escapify(encodings.idna.ToUnicode(label)) + except Exception as e: + raise IDNAException(idna_exception=e) + + +class IDNA2008Codec(IDNACodec): + """IDNA 2008 encoder/decoder.""" + + def __init__( + self, + uts_46: bool = False, + transitional: bool = False, + allow_pure_ascii: bool = False, + strict_decode: bool = False, + ): + """Initialize the IDNA 2008 encoder/decoder. + + *uts_46* is a ``bool``. If True, apply Unicode IDNA + compatibility processing as described in Unicode Technical + Standard #46 (https://unicode.org/reports/tr46/). + If False, do not apply the mapping. The default is False. + + *transitional* is a ``bool``: If True, use the + "transitional" mode described in Unicode Technical Standard + #46. The default is False. + + *allow_pure_ascii* is a ``bool``. If True, then a label which + consists of only ASCII characters is allowed. This is less + strict than regular IDNA 2008, but is also necessary for mixed + names, e.g. a name with starting with "_sip._tcp." and ending + in an IDN suffix which would otherwise be disallowed. The + default is False. + + *strict_decode* is a ``bool``: If True, then IDNA2008 checking + is done when decoding. This can cause failures if the name + was encoded with IDNA2003. The default is False. + """ + super().__init__() + self.uts_46 = uts_46 + self.transitional = transitional + self.allow_pure_ascii = allow_pure_ascii + self.strict_decode = strict_decode + + def encode(self, label: str) -> bytes: + if label == "": + return b"" + if self.allow_pure_ascii and is_all_ascii(label): + encoded = label.encode("ascii") + if len(encoded) > 63: + raise LabelTooLong + return encoded + if not have_idna_2008: + raise NoIDNA2008 + try: + if self.uts_46: + label = idna.uts46_remap(label, False, self.transitional) + return idna.alabel(label) + except idna.IDNAError as e: + if e.args[0] == "Label too long": + raise LabelTooLong + else: + raise IDNAException(idna_exception=e) + + def decode(self, label: bytes) -> str: + if not self.strict_decode: + return super().decode(label) + if label == b"": + return "" + if not have_idna_2008: + raise NoIDNA2008 + try: + ulabel = idna.ulabel(label) + if self.uts_46: + ulabel = idna.uts46_remap(ulabel, False, self.transitional) + return _escapify(ulabel) + except (idna.IDNAError, UnicodeError) as e: + raise IDNAException(idna_exception=e) + + +IDNA_2003_Practical = IDNA2003Codec(False) +IDNA_2003_Strict = IDNA2003Codec(True) +IDNA_2003 = IDNA_2003_Practical +IDNA_2008_Practical = IDNA2008Codec(True, False, True, False) +IDNA_2008_UTS_46 = IDNA2008Codec(True, False, False, False) +IDNA_2008_Strict = IDNA2008Codec(False, False, False, True) +IDNA_2008_Transitional = IDNA2008Codec(True, True, False, False) +IDNA_2008 = IDNA_2008_Practical + + +def _validate_labels(labels: Tuple[bytes, ...]) -> None: + """Check for empty labels in the middle of a label sequence, + labels that are too long, and for too many labels. + + Raises ``dns.name.NameTooLong`` if the name as a whole is too long. + + Raises ``dns.name.EmptyLabel`` if a label is empty (i.e. the root + label) and appears in a position other than the end of the label + sequence + + """ + + l = len(labels) + total = 0 + i = -1 + j = 0 + for label in labels: + ll = len(label) + total += ll + 1 + if ll > 63: + raise LabelTooLong + if i < 0 and label == b"": + i = j + j += 1 + if total > 255: + raise NameTooLong + if i >= 0 and i != l - 1: + raise EmptyLabel + + +def _maybe_convert_to_binary(label: Union[bytes, str]) -> bytes: + """If label is ``str``, convert it to ``bytes``. If it is already + ``bytes`` just return it. + + """ + + if isinstance(label, bytes): + return label + if isinstance(label, str): + return label.encode() + raise ValueError # pragma: no cover + + +@dns.immutable.immutable +class Name: + """A DNS name. + + The dns.name.Name class represents a DNS name as a tuple of + labels. Each label is a ``bytes`` in DNS wire format. Instances + of the class are immutable. + """ + + __slots__ = ["labels"] + + def __init__(self, labels: Iterable[Union[bytes, str]]): + """*labels* is any iterable whose values are ``str`` or ``bytes``.""" + + blabels = [_maybe_convert_to_binary(x) for x in labels] + self.labels = tuple(blabels) + _validate_labels(self.labels) + + def __copy__(self): + return Name(self.labels) + + def __deepcopy__(self, memo): + return Name(copy.deepcopy(self.labels, memo)) + + def __getstate__(self): + # Names can be pickled + return {"labels": self.labels} + + def __setstate__(self, state): + super().__setattr__("labels", state["labels"]) + _validate_labels(self.labels) + + def is_absolute(self) -> bool: + """Is the most significant label of this name the root label? + + Returns a ``bool``. + """ + + return len(self.labels) > 0 and self.labels[-1] == b"" + + def is_wild(self) -> bool: + """Is this name wild? (I.e. Is the least significant label '*'?) + + Returns a ``bool``. + """ + + return len(self.labels) > 0 and self.labels[0] == b"*" + + def __hash__(self) -> int: + """Return a case-insensitive hash of the name. + + Returns an ``int``. + """ + + h = 0 + for label in self.labels: + for c in label.lower(): + h += (h << 3) + c + return h + + def fullcompare(self, other: "Name") -> Tuple[NameRelation, int, int]: + """Compare two names, returning a 3-tuple + ``(relation, order, nlabels)``. + + *relation* describes the relation ship between the names, + and is one of: ``dns.name.NameRelation.NONE``, + ``dns.name.NameRelation.SUPERDOMAIN``, ``dns.name.NameRelation.SUBDOMAIN``, + ``dns.name.NameRelation.EQUAL``, or ``dns.name.NameRelation.COMMONANCESTOR``. + + *order* is < 0 if *self* < *other*, > 0 if *self* > *other*, and == + 0 if *self* == *other*. A relative name is always less than an + absolute name. If both names have the same relativity, then + the DNSSEC order relation is used to order them. + + *nlabels* is the number of significant labels that the two names + have in common. + + Here are some examples. Names ending in "." are absolute names, + those not ending in "." are relative names. + + ============= ============= =========== ===== ======= + self other relation order nlabels + ============= ============= =========== ===== ======= + www.example. www.example. equal 0 3 + www.example. example. subdomain > 0 2 + example. www.example. superdomain < 0 2 + example1.com. example2.com. common anc. < 0 2 + example1 example2. none < 0 0 + example1. example2 none > 0 0 + ============= ============= =========== ===== ======= + """ + + sabs = self.is_absolute() + oabs = other.is_absolute() + if sabs != oabs: + if sabs: + return (NameRelation.NONE, 1, 0) + else: + return (NameRelation.NONE, -1, 0) + l1 = len(self.labels) + l2 = len(other.labels) + ldiff = l1 - l2 + if ldiff < 0: + l = l1 + else: + l = l2 + + order = 0 + nlabels = 0 + namereln = NameRelation.NONE + while l > 0: + l -= 1 + l1 -= 1 + l2 -= 1 + label1 = self.labels[l1].lower() + label2 = other.labels[l2].lower() + if label1 < label2: + order = -1 + if nlabels > 0: + namereln = NameRelation.COMMONANCESTOR + return (namereln, order, nlabels) + elif label1 > label2: + order = 1 + if nlabels > 0: + namereln = NameRelation.COMMONANCESTOR + return (namereln, order, nlabels) + nlabels += 1 + order = ldiff + if ldiff < 0: + namereln = NameRelation.SUPERDOMAIN + elif ldiff > 0: + namereln = NameRelation.SUBDOMAIN + else: + namereln = NameRelation.EQUAL + return (namereln, order, nlabels) + + def is_subdomain(self, other: "Name") -> bool: + """Is self a subdomain of other? + + Note that the notion of subdomain includes equality, e.g. + "dnspython.org" is a subdomain of itself. + + Returns a ``bool``. + """ + + (nr, _, _) = self.fullcompare(other) + if nr == NameRelation.SUBDOMAIN or nr == NameRelation.EQUAL: + return True + return False + + def is_superdomain(self, other: "Name") -> bool: + """Is self a superdomain of other? + + Note that the notion of superdomain includes equality, e.g. + "dnspython.org" is a superdomain of itself. + + Returns a ``bool``. + """ + + (nr, _, _) = self.fullcompare(other) + if nr == NameRelation.SUPERDOMAIN or nr == NameRelation.EQUAL: + return True + return False + + def canonicalize(self) -> "Name": + """Return a name which is equal to the current name, but is in + DNSSEC canonical form. + """ + + return Name([x.lower() for x in self.labels]) + + def __eq__(self, other): + if isinstance(other, Name): + return self.fullcompare(other)[1] == 0 + else: + return False + + def __ne__(self, other): + if isinstance(other, Name): + return self.fullcompare(other)[1] != 0 + else: + return True + + def __lt__(self, other): + if isinstance(other, Name): + return self.fullcompare(other)[1] < 0 + else: + return NotImplemented + + def __le__(self, other): + if isinstance(other, Name): + return self.fullcompare(other)[1] <= 0 + else: + return NotImplemented + + def __ge__(self, other): + if isinstance(other, Name): + return self.fullcompare(other)[1] >= 0 + else: + return NotImplemented + + def __gt__(self, other): + if isinstance(other, Name): + return self.fullcompare(other)[1] > 0 + else: + return NotImplemented + + def __repr__(self): + return "" + + def __str__(self): + return self.to_text(False) + + def to_text(self, omit_final_dot: bool = False) -> str: + """Convert name to DNS text format. + + *omit_final_dot* is a ``bool``. If True, don't emit the final + dot (denoting the root label) for absolute names. The default + is False. + + Returns a ``str``. + """ + + if len(self.labels) == 0: + return "@" + if len(self.labels) == 1 and self.labels[0] == b"": + return "." + if omit_final_dot and self.is_absolute(): + l = self.labels[:-1] + else: + l = self.labels + s = ".".join(map(_escapify, l)) + return s + + def to_unicode( + self, omit_final_dot: bool = False, idna_codec: Optional[IDNACodec] = None + ) -> str: + """Convert name to Unicode text format. + + IDN ACE labels are converted to Unicode. + + *omit_final_dot* is a ``bool``. If True, don't emit the final + dot (denoting the root label) for absolute names. The default + is False. + *idna_codec* specifies the IDNA encoder/decoder. If None, the + dns.name.IDNA_2003_Practical encoder/decoder is used. + The IDNA_2003_Practical decoder does + not impose any policy, it just decodes punycode, so if you + don't want checking for compliance, you can use this decoder + for IDNA2008 as well. + + Returns a ``str``. + """ + + if len(self.labels) == 0: + return "@" + if len(self.labels) == 1 and self.labels[0] == b"": + return "." + if omit_final_dot and self.is_absolute(): + l = self.labels[:-1] + else: + l = self.labels + if idna_codec is None: + idna_codec = IDNA_2003_Practical + return ".".join([idna_codec.decode(x) for x in l]) + + def to_digestable(self, origin: Optional["Name"] = None) -> bytes: + """Convert name to a format suitable for digesting in hashes. + + The name is canonicalized and converted to uncompressed wire + format. All names in wire format are absolute. If the name + is a relative name, then an origin must be supplied. + + *origin* is a ``dns.name.Name`` or ``None``. If the name is + relative and origin is not ``None``, then origin will be appended + to the name. + + Raises ``dns.name.NeedAbsoluteNameOrOrigin`` if the name is + relative and no origin was provided. + + Returns a ``bytes``. + """ + + digest = self.to_wire(origin=origin, canonicalize=True) + assert digest is not None + return digest + + def to_wire( + self, + file: Optional[Any] = None, + compress: Optional[CompressType] = None, + origin: Optional["Name"] = None, + canonicalize: bool = False, + ) -> Optional[bytes]: + """Convert name to wire format, possibly compressing it. + + *file* is the file where the name is emitted (typically an + io.BytesIO file). If ``None`` (the default), a ``bytes`` + containing the wire name will be returned. + + *compress*, a ``dict``, is the compression table to use. If + ``None`` (the default), names will not be compressed. Note that + the compression code assumes that compression offset 0 is the + start of *file*, and thus compression will not be correct + if this is not the case. + + *origin* is a ``dns.name.Name`` or ``None``. If the name is + relative and origin is not ``None``, then *origin* will be appended + to it. + + *canonicalize*, a ``bool``, indicates whether the name should + be canonicalized; that is, converted to a format suitable for + digesting in hashes. + + Raises ``dns.name.NeedAbsoluteNameOrOrigin`` if the name is + relative and no origin was provided. + + Returns a ``bytes`` or ``None``. + """ + + if file is None: + out = bytearray() + for label in self.labels: + out.append(len(label)) + if canonicalize: + out += label.lower() + else: + out += label + if not self.is_absolute(): + if origin is None or not origin.is_absolute(): + raise NeedAbsoluteNameOrOrigin + for label in origin.labels: + out.append(len(label)) + if canonicalize: + out += label.lower() + else: + out += label + return bytes(out) + + labels: Iterable[bytes] + if not self.is_absolute(): + if origin is None or not origin.is_absolute(): + raise NeedAbsoluteNameOrOrigin + labels = list(self.labels) + labels.extend(list(origin.labels)) + else: + labels = self.labels + i = 0 + for label in labels: + n = Name(labels[i:]) + i += 1 + if compress is not None: + pos = compress.get(n) + else: + pos = None + if pos is not None: + value = 0xC000 + pos + s = struct.pack("!H", value) + file.write(s) + break + else: + if compress is not None and len(n) > 1: + pos = file.tell() + if pos <= 0x3FFF: + compress[n] = pos + l = len(label) + file.write(struct.pack("!B", l)) + if l > 0: + if canonicalize: + file.write(label.lower()) + else: + file.write(label) + return None + + def __len__(self) -> int: + """The length of the name (in labels). + + Returns an ``int``. + """ + + return len(self.labels) + + def __getitem__(self, index): + return self.labels[index] + + def __add__(self, other): + return self.concatenate(other) + + def __sub__(self, other): + return self.relativize(other) + + def split(self, depth: int) -> Tuple["Name", "Name"]: + """Split a name into a prefix and suffix names at the specified depth. + + *depth* is an ``int`` specifying the number of labels in the suffix + + Raises ``ValueError`` if *depth* was not >= 0 and <= the length of the + name. + + Returns the tuple ``(prefix, suffix)``. + """ + + l = len(self.labels) + if depth == 0: + return (self, dns.name.empty) + elif depth == l: + return (dns.name.empty, self) + elif depth < 0 or depth > l: + raise ValueError("depth must be >= 0 and <= the length of the name") + return (Name(self[:-depth]), Name(self[-depth:])) + + def concatenate(self, other: "Name") -> "Name": + """Return a new name which is the concatenation of self and other. + + Raises ``dns.name.AbsoluteConcatenation`` if the name is + absolute and *other* is not the empty name. + + Returns a ``dns.name.Name``. + """ + + if self.is_absolute() and len(other) > 0: + raise AbsoluteConcatenation + labels = list(self.labels) + labels.extend(list(other.labels)) + return Name(labels) + + def relativize(self, origin: "Name") -> "Name": + """If the name is a subdomain of *origin*, return a new name which is + the name relative to origin. Otherwise return the name. + + For example, relativizing ``www.dnspython.org.`` to origin + ``dnspython.org.`` returns the name ``www``. Relativizing ``example.`` + to origin ``dnspython.org.`` returns ``example.``. + + Returns a ``dns.name.Name``. + """ + + if origin is not None and self.is_subdomain(origin): + return Name(self[: -len(origin)]) + else: + return self + + def derelativize(self, origin: "Name") -> "Name": + """If the name is a relative name, return a new name which is the + concatenation of the name and origin. Otherwise return the name. + + For example, derelativizing ``www`` to origin ``dnspython.org.`` + returns the name ``www.dnspython.org.``. Derelativizing ``example.`` + to origin ``dnspython.org.`` returns ``example.``. + + Returns a ``dns.name.Name``. + """ + + if not self.is_absolute(): + return self.concatenate(origin) + else: + return self + + def choose_relativity( + self, origin: Optional["Name"] = None, relativize: bool = True + ) -> "Name": + """Return a name with the relativity desired by the caller. + + If *origin* is ``None``, then the name is returned. + Otherwise, if *relativize* is ``True`` the name is + relativized, and if *relativize* is ``False`` the name is + derelativized. + + Returns a ``dns.name.Name``. + """ + + if origin: + if relativize: + return self.relativize(origin) + else: + return self.derelativize(origin) + else: + return self + + def parent(self) -> "Name": + """Return the parent of the name. + + For example, the parent of ``www.dnspython.org.`` is ``dnspython.org``. + + Raises ``dns.name.NoParent`` if the name is either the root name or the + empty name, and thus has no parent. + + Returns a ``dns.name.Name``. + """ + + if self == root or self == empty: + 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""]) + +#: The empty name. +empty = Name([]) + + +def from_unicode( + text: str, origin: Optional[Name] = root, idna_codec: Optional[IDNACodec] = None +) -> Name: + """Convert unicode text into a Name object. + + Labels are encoded in IDN ACE form according to rules specified by + the IDNA codec. + + *text*, a ``str``, is the text to convert into a name. + + *origin*, a ``dns.name.Name``, specifies the origin to + append to non-absolute names. The default is the root name. + + *idna_codec*, a ``dns.name.IDNACodec``, specifies the IDNA + encoder/decoder. If ``None``, the default IDNA 2003 encoder/decoder + is used. + + Returns a ``dns.name.Name``. + """ + + if not isinstance(text, str): + raise ValueError("input to from_unicode() must be a unicode string") + if not (origin is None or isinstance(origin, Name)): + raise ValueError("origin must be a Name or None") + labels = [] + label = "" + escaping = False + edigits = 0 + total = 0 + if idna_codec is None: + idna_codec = IDNA_2003 + if text == "@": + text = "" + if text: + if text in [".", "\u3002", "\uff0e", "\uff61"]: + return Name([b""]) # no Unicode "u" on this constant! + for c in text: + if escaping: + if edigits == 0: + if c.isdigit(): + total = int(c) + edigits += 1 + else: + label += c + escaping = False + else: + if not c.isdigit(): + raise BadEscape + total *= 10 + total += int(c) + edigits += 1 + if edigits == 3: + escaping = False + label += chr(total) + elif c in [".", "\u3002", "\uff0e", "\uff61"]: + if len(label) == 0: + raise EmptyLabel + labels.append(idna_codec.encode(label)) + label = "" + elif c == "\\": + escaping = True + edigits = 0 + total = 0 + else: + label += c + if escaping: + raise BadEscape + if len(label) > 0: + labels.append(idna_codec.encode(label)) + else: + labels.append(b"") + + if (len(labels) == 0 or labels[-1] != b"") and origin is not None: + labels.extend(list(origin.labels)) + return Name(labels) + + +def is_all_ascii(text: str) -> bool: + for c in text: + if ord(c) > 0x7F: + return False + return True + + +def from_text( + text: Union[bytes, str], + origin: Optional[Name] = root, + idna_codec: Optional[IDNACodec] = None, +) -> Name: + """Convert text into a Name object. + + *text*, a ``bytes`` or ``str``, is the text to convert into a name. + + *origin*, a ``dns.name.Name``, specifies the origin to + append to non-absolute names. The default is the root name. + + *idna_codec*, a ``dns.name.IDNACodec``, specifies the IDNA + encoder/decoder. If ``None``, the default IDNA 2003 encoder/decoder + is used. + + Returns a ``dns.name.Name``. + """ + + if isinstance(text, str): + if not is_all_ascii(text): + # Some codepoint in the input text is > 127, so IDNA applies. + return from_unicode(text, origin, idna_codec) + # The input is all ASCII, so treat this like an ordinary non-IDNA + # domain name. Note that "all ASCII" is about the input text, + # not the codepoints in the domain name. E.g. if text has value + # + # r'\150\151\152\153\154\155\156\157\158\159' + # + # then it's still "all ASCII" even though the domain name has + # codepoints > 127. + text = text.encode("ascii") + if not isinstance(text, bytes): + raise ValueError("input to from_text() must be a string") + if not (origin is None or isinstance(origin, Name)): + raise ValueError("origin must be a Name or None") + labels = [] + label = b"" + escaping = False + edigits = 0 + total = 0 + if text == b"@": + text = b"" + if text: + if text == b".": + return Name([b""]) + for c in text: + byte_ = struct.pack("!B", c) + if escaping: + if edigits == 0: + if byte_.isdigit(): + total = int(byte_) + edigits += 1 + else: + label += byte_ + escaping = False + else: + if not byte_.isdigit(): + raise BadEscape + total *= 10 + total += int(byte_) + edigits += 1 + if edigits == 3: + escaping = False + label += struct.pack("!B", total) + elif byte_ == b".": + if len(label) == 0: + raise EmptyLabel + labels.append(label) + label = b"" + elif byte_ == b"\\": + escaping = True + edigits = 0 + total = 0 + else: + label += byte_ + if escaping: + raise BadEscape + if len(label) > 0: + labels.append(label) + else: + labels.append(b"") + if (len(labels) == 0 or labels[-1] != b"") and origin is not None: + labels.extend(list(origin.labels)) + return Name(labels) + + +# we need 'dns.wire.Parser' quoted as dns.name and dns.wire depend on each other. + + +def from_wire_parser(parser: "dns.wire.Parser") -> Name: + """Convert possibly compressed wire format into a Name. + + *parser* is a dns.wire.Parser. + + Raises ``dns.name.BadPointer`` if a compression pointer did not + point backwards in the message. + + Raises ``dns.name.BadLabelType`` if an invalid label type was encountered. + + Returns a ``dns.name.Name`` + """ + + labels = [] + biggest_pointer = parser.current + with parser.restore_furthest(): + count = parser.get_uint8() + while count != 0: + if count < 64: + labels.append(parser.get_bytes(count)) + elif count >= 192: + current = (count & 0x3F) * 256 + parser.get_uint8() + if current >= biggest_pointer: + raise BadPointer + biggest_pointer = current + parser.seek(current) + else: + raise BadLabelType + count = parser.get_uint8() + labels.append(b"") + return Name(labels) + + +def from_wire(message: bytes, current: int) -> Tuple[Name, int]: + """Convert possibly compressed wire format into a Name. + + *message* is a ``bytes`` containing an entire DNS message in DNS + wire form. + + *current*, an ``int``, is the offset of the beginning of the name + from the start of the message + + Raises ``dns.name.BadPointer`` if a compression pointer did not + point backwards in the message. + + Raises ``dns.name.BadLabelType`` if an invalid label type was encountered. + + Returns a ``(dns.name.Name, int)`` tuple consisting of the name + that was read and the number of bytes of the wire format message + which were consumed reading it. + """ + + if not isinstance(message, bytes): + raise ValueError("input to from_wire() must be a byte string") + 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/.venv/lib/python3.12/site-packages/dns/namedict.py b/.venv/lib/python3.12/site-packages/dns/namedict.py new file mode 100644 index 0000000..ca8b197 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/namedict.py @@ -0,0 +1,109 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2017 Nominum, Inc. +# Copyright (C) 2016 Coresec Systems AB +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND CORESEC SYSTEMS AB DISCLAIMS ALL +# WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED +# WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL CORESEC +# SYSTEMS AB BE LIABLE FOR ANY SPECIAL, DIRECT, 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. + +"""DNS name dictionary""" + +# pylint seems to be confused about this one! +from collections.abc import MutableMapping # pylint: disable=no-name-in-module + +import dns.name + + +class NameDict(MutableMapping): + """A dictionary whose keys are dns.name.Name objects. + + In addition to being like a regular Python dictionary, this + dictionary can also get the deepest match for a given key. + """ + + __slots__ = ["max_depth", "max_depth_items", "__store"] + + def __init__(self, *args, **kwargs): + super().__init__() + self.__store = dict() + #: the maximum depth of the keys that have ever been added + self.max_depth = 0 + #: the number of items of maximum depth + self.max_depth_items = 0 + self.update(dict(*args, **kwargs)) + + def __update_max_depth(self, key): + if len(key) == self.max_depth: + self.max_depth_items = self.max_depth_items + 1 + elif len(key) > self.max_depth: + self.max_depth = len(key) + self.max_depth_items = 1 + + def __getitem__(self, key): + return self.__store[key] + + def __setitem__(self, key, value): + if not isinstance(key, dns.name.Name): + raise ValueError("NameDict key must be a name") + self.__store[key] = value + self.__update_max_depth(key) + + def __delitem__(self, key): + self.__store.pop(key) + if len(key) == self.max_depth: + self.max_depth_items = self.max_depth_items - 1 + if self.max_depth_items == 0: + self.max_depth = 0 + for k in self.__store: + self.__update_max_depth(k) + + def __iter__(self): + return iter(self.__store) + + def __len__(self): + return len(self.__store) + + def has_key(self, key): + return key in self.__store + + def get_deepest_match(self, name): + """Find the deepest match to *name* in the dictionary. + + The deepest match is the longest name in the dictionary which is + a superdomain of *name*. Note that *superdomain* includes matching + *name* itself. + + *name*, a ``dns.name.Name``, the name to find. + + Returns a ``(key, value)`` where *key* is the deepest + ``dns.name.Name``, and *value* is the value associated with *key*. + """ + + depth = len(name) + if depth > self.max_depth: + depth = self.max_depth + for i in range(-depth, 0): + n = dns.name.Name(name[i:]) + if n in self: + return (n, self[n]) + v = self[dns.name.empty] + return (dns.name.empty, v) diff --git a/.venv/lib/python3.12/site-packages/dns/nameserver.py b/.venv/lib/python3.12/site-packages/dns/nameserver.py new file mode 100644 index 0000000..5dbb4e8 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/nameserver.py @@ -0,0 +1,359 @@ +from typing import Optional, Union +from urllib.parse import urlparse + +import dns.asyncbackend +import dns.asyncquery +import dns.inet +import dns.message +import dns.query + + +class Nameserver: + def __init__(self): + pass + + def __str__(self): + raise NotImplementedError + + def kind(self) -> str: + raise NotImplementedError + + def is_always_max_size(self) -> bool: + raise NotImplementedError + + def answer_nameserver(self) -> str: + raise NotImplementedError + + def answer_port(self) -> int: + raise NotImplementedError + + def query( + self, + request: dns.message.QueryMessage, + timeout: float, + source: Optional[str], + source_port: int, + max_size: bool, + one_rr_per_rrset: bool = False, + ignore_trailing: bool = False, + ) -> dns.message.Message: + raise NotImplementedError + + async def async_query( + self, + request: dns.message.QueryMessage, + timeout: float, + source: Optional[str], + source_port: int, + max_size: bool, + backend: dns.asyncbackend.Backend, + one_rr_per_rrset: bool = False, + ignore_trailing: bool = False, + ) -> dns.message.Message: + raise NotImplementedError + + +class AddressAndPortNameserver(Nameserver): + def __init__(self, address: str, port: int): + super().__init__() + self.address = address + self.port = port + + def kind(self) -> str: + raise NotImplementedError + + def is_always_max_size(self) -> bool: + return False + + def __str__(self): + ns_kind = self.kind() + return f"{ns_kind}:{self.address}@{self.port}" + + def answer_nameserver(self) -> str: + return self.address + + def answer_port(self) -> int: + return self.port + + +class Do53Nameserver(AddressAndPortNameserver): + def __init__(self, address: str, port: int = 53): + super().__init__(address, port) + + def kind(self): + return "Do53" + + def query( + self, + request: dns.message.QueryMessage, + timeout: float, + source: Optional[str], + source_port: int, + max_size: bool, + one_rr_per_rrset: bool = False, + ignore_trailing: bool = False, + ) -> dns.message.Message: + if max_size: + response = dns.query.tcp( + request, + self.address, + timeout=timeout, + port=self.port, + source=source, + source_port=source_port, + one_rr_per_rrset=one_rr_per_rrset, + ignore_trailing=ignore_trailing, + ) + else: + response = dns.query.udp( + request, + self.address, + timeout=timeout, + port=self.port, + source=source, + source_port=source_port, + raise_on_truncation=True, + one_rr_per_rrset=one_rr_per_rrset, + ignore_trailing=ignore_trailing, + ignore_errors=True, + ignore_unexpected=True, + ) + return response + + async def async_query( + self, + request: dns.message.QueryMessage, + timeout: float, + source: Optional[str], + source_port: int, + max_size: bool, + backend: dns.asyncbackend.Backend, + one_rr_per_rrset: bool = False, + ignore_trailing: bool = False, + ) -> dns.message.Message: + if max_size: + response = await dns.asyncquery.tcp( + request, + self.address, + timeout=timeout, + port=self.port, + source=source, + source_port=source_port, + backend=backend, + one_rr_per_rrset=one_rr_per_rrset, + ignore_trailing=ignore_trailing, + ) + else: + response = await dns.asyncquery.udp( + request, + self.address, + timeout=timeout, + port=self.port, + source=source, + source_port=source_port, + raise_on_truncation=True, + 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, + 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" + + def is_always_max_size(self) -> bool: + return True + + def __str__(self): + return self.url + + def answer_nameserver(self) -> str: + return self.url + + def answer_port(self) -> int: + port = urlparse(self.url).port + if port is None: + port = 443 + return port + + def query( + self, + request: dns.message.QueryMessage, + timeout: float, + source: Optional[str], + source_port: int, + max_size: bool = False, + one_rr_per_rrset: bool = False, + ignore_trailing: bool = False, + ) -> dns.message.Message: + return dns.query.https( + 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( + self, + request: dns.message.QueryMessage, + timeout: float, + source: Optional[str], + source_port: int, + max_size: bool, + backend: dns.asyncbackend.Backend, + one_rr_per_rrset: bool = False, + ignore_trailing: bool = False, + ) -> dns.message.Message: + return await dns.asyncquery.https( + 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, + verify: Union[bool, str] = True, + ): + super().__init__(address, port) + self.hostname = hostname + self.verify = verify + + def kind(self): + return "DoT" + + def query( + self, + request: dns.message.QueryMessage, + timeout: float, + source: Optional[str], + source_port: int, + max_size: bool = False, + one_rr_per_rrset: bool = False, + ignore_trailing: bool = False, + ) -> dns.message.Message: + return dns.query.tls( + request, + self.address, + port=self.port, + timeout=timeout, + one_rr_per_rrset=one_rr_per_rrset, + ignore_trailing=ignore_trailing, + server_hostname=self.hostname, + verify=self.verify, + ) + + async def async_query( + self, + request: dns.message.QueryMessage, + timeout: float, + source: Optional[str], + source_port: int, + max_size: bool, + backend: dns.asyncbackend.Backend, + one_rr_per_rrset: bool = False, + ignore_trailing: bool = False, + ) -> dns.message.Message: + return await dns.asyncquery.tls( + request, + self.address, + port=self.port, + timeout=timeout, + one_rr_per_rrset=one_rr_per_rrset, + ignore_trailing=ignore_trailing, + server_hostname=self.hostname, + verify=self.verify, + ) + + +class DoQNameserver(AddressAndPortNameserver): + def __init__( + self, + address: str, + port: int = 853, + verify: Union[bool, str] = True, + server_hostname: Optional[str] = None, + ): + super().__init__(address, port) + self.verify = verify + self.server_hostname = server_hostname + + def kind(self): + return "DoQ" + + def query( + self, + request: dns.message.QueryMessage, + timeout: float, + source: Optional[str], + source_port: int, + max_size: bool = False, + one_rr_per_rrset: bool = False, + ignore_trailing: bool = False, + ) -> dns.message.Message: + return dns.query.quic( + request, + self.address, + port=self.port, + timeout=timeout, + one_rr_per_rrset=one_rr_per_rrset, + ignore_trailing=ignore_trailing, + verify=self.verify, + server_hostname=self.server_hostname, + ) + + async def async_query( + self, + request: dns.message.QueryMessage, + timeout: float, + source: Optional[str], + source_port: int, + max_size: bool, + backend: dns.asyncbackend.Backend, + one_rr_per_rrset: bool = False, + ignore_trailing: bool = False, + ) -> dns.message.Message: + return await dns.asyncquery.quic( + request, + self.address, + port=self.port, + timeout=timeout, + one_rr_per_rrset=one_rr_per_rrset, + ignore_trailing=ignore_trailing, + verify=self.verify, + server_hostname=self.server_hostname, + ) diff --git a/.venv/lib/python3.12/site-packages/dns/node.py b/.venv/lib/python3.12/site-packages/dns/node.py new file mode 100644 index 0000000..de85a82 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/node.py @@ -0,0 +1,359 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2001-2017 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""DNS nodes. A node is a set of rdatasets.""" + +import enum +import io +from typing import Any, Dict, Optional + +import dns.immutable +import dns.name +import dns.rdataclass +import dns.rdataset +import dns.rdatatype +import dns.renderer +import dns.rrset + +_cname_types = { + dns.rdatatype.CNAME, +} + +# "neutral" types can coexist with a CNAME and thus are not "other data" +_neutral_types = { + dns.rdatatype.NSEC, # RFC 4035 section 2.5 + dns.rdatatype.NSEC3, # This is not likely to happen, but not impossible! + dns.rdatatype.KEY, # RFC 4035 section 2.5, RFC 3007 +} + + +def _matches_type_or_its_signature(rdtypes, rdtype, covers): + return rdtype in rdtypes or (rdtype == dns.rdatatype.RRSIG and covers in rdtypes) + + +@enum.unique +class NodeKind(enum.Enum): + """Rdatasets in nodes""" + + REGULAR = 0 # a.k.a "other data" + NEUTRAL = 1 + CNAME = 2 + + @classmethod + def classify( + cls, rdtype: dns.rdatatype.RdataType, covers: dns.rdatatype.RdataType + ) -> "NodeKind": + if _matches_type_or_its_signature(_cname_types, rdtype, covers): + return NodeKind.CNAME + elif _matches_type_or_its_signature(_neutral_types, rdtype, covers): + return NodeKind.NEUTRAL + else: + return NodeKind.REGULAR + + @classmethod + def classify_rdataset(cls, rdataset: dns.rdataset.Rdataset) -> "NodeKind": + return cls.classify(rdataset.rdtype, rdataset.covers) + + +class Node: + """A Node is a set of rdatasets. + + A node is either a CNAME node or an "other data" node. A CNAME + node contains only CNAME, KEY, NSEC, and NSEC3 rdatasets along with their + covering RRSIG rdatasets. An "other data" node contains any + rdataset other than a CNAME or RRSIG(CNAME) rdataset. When + changes are made to a node, the CNAME or "other data" state is + always consistent with the update, i.e. the most recent change + wins. For example, if you have a node which contains a CNAME + rdataset, and then add an MX rdataset to it, then the CNAME + rdataset will be deleted. Likewise if you have a node containing + an MX rdataset and add a CNAME rdataset, the MX rdataset will be + deleted. + """ + + __slots__ = ["rdatasets"] + + def __init__(self): + # the set of rdatasets, represented as a list. + self.rdatasets = [] + + def to_text(self, name: dns.name.Name, **kw: Dict[str, Any]) -> str: + """Convert a node to text format. + + Each rdataset at the node is printed. Any keyword arguments + to this method are passed on to the rdataset's to_text() method. + + *name*, a ``dns.name.Name``, the owner name of the + rdatasets. + + Returns a ``str``. + + """ + + s = io.StringIO() + for rds in self.rdatasets: + if len(rds) > 0: + s.write(rds.to_text(name, **kw)) # type: ignore[arg-type] + s.write("\n") + return s.getvalue()[:-1] + + def __repr__(self): + return "" + + def __eq__(self, other): + # + # This is inefficient. Good thing we don't need to do it much. + # + for rd in self.rdatasets: + if rd not in other.rdatasets: + return False + for rd in other.rdatasets: + if rd not in self.rdatasets: + return False + return True + + def __ne__(self, other): + return not self.__eq__(other) + + def __len__(self): + return len(self.rdatasets) + + def __iter__(self): + return iter(self.rdatasets) + + def _append_rdataset(self, rdataset): + """Append rdataset to the node with special handling for CNAME and + other data conditions. + + Specifically, if the rdataset being appended has ``NodeKind.CNAME``, + then all rdatasets other than KEY, NSEC, NSEC3, and their covering + RRSIGs are deleted. If the rdataset being appended has + ``NodeKind.REGULAR`` then CNAME and RRSIG(CNAME) are deleted. + """ + # Make having just one rdataset at the node fast. + if len(self.rdatasets) > 0: + kind = NodeKind.classify_rdataset(rdataset) + if kind == NodeKind.CNAME: + self.rdatasets = [ + rds + for rds in self.rdatasets + if NodeKind.classify_rdataset(rds) != NodeKind.REGULAR + ] + elif kind == NodeKind.REGULAR: + self.rdatasets = [ + rds + for rds in self.rdatasets + if NodeKind.classify_rdataset(rds) != NodeKind.CNAME + ] + # Otherwise the rdataset is NodeKind.NEUTRAL and we do not need to + # edit self.rdatasets. + self.rdatasets.append(rdataset) + + def find_rdataset( + self, + rdclass: dns.rdataclass.RdataClass, + rdtype: dns.rdatatype.RdataType, + covers: dns.rdatatype.RdataType = dns.rdatatype.NONE, + create: bool = False, + ) -> dns.rdataset.Rdataset: + """Find an rdataset matching the specified properties in the + current node. + + *rdclass*, a ``dns.rdataclass.RdataClass``, the class of the rdataset. + + *rdtype*, a ``dns.rdatatype.RdataType``, the type of the rdataset. + + *covers*, a ``dns.rdatatype.RdataType``, the covered type. + Usually this value is ``dns.rdatatype.NONE``, but if the + rdtype is ``dns.rdatatype.SIG`` or ``dns.rdatatype.RRSIG``, + then the covers value will be the rdata type the SIG/RRSIG + covers. The library treats the SIG and RRSIG types as if they + were a family of types, e.g. RRSIG(A), RRSIG(NS), RRSIG(SOA). + This makes RRSIGs much easier to work with than if RRSIGs + covering different rdata types were aggregated into a single + RRSIG rdataset. + + *create*, a ``bool``. If True, create the rdataset if it is not found. + + Raises ``KeyError`` if an rdataset of the desired type and class does + not exist and *create* is not ``True``. + + Returns a ``dns.rdataset.Rdataset``. + """ + + for rds in self.rdatasets: + if rds.match(rdclass, rdtype, covers): + return rds + if not create: + raise KeyError + rds = dns.rdataset.Rdataset(rdclass, rdtype, covers) + self._append_rdataset(rds) + return rds + + def get_rdataset( + self, + rdclass: dns.rdataclass.RdataClass, + rdtype: dns.rdatatype.RdataType, + covers: dns.rdatatype.RdataType = dns.rdatatype.NONE, + create: bool = False, + ) -> Optional[dns.rdataset.Rdataset]: + """Get an rdataset matching the specified properties in the + current node. + + None is returned if an rdataset of the specified type and + class does not exist and *create* is not ``True``. + + *rdclass*, an ``int``, the class of the rdataset. + + *rdtype*, an ``int``, the type of the rdataset. + + *covers*, an ``int``, the covered type. Usually this value is + dns.rdatatype.NONE, but if the rdtype is dns.rdatatype.SIG or + dns.rdatatype.RRSIG, then the covers value will be the rdata + type the SIG/RRSIG covers. The library treats the SIG and RRSIG + types as if they were a family of + types, e.g. RRSIG(A), RRSIG(NS), RRSIG(SOA). This makes RRSIGs much + easier to work with than if RRSIGs covering different rdata + types were aggregated into a single RRSIG rdataset. + + *create*, a ``bool``. If True, create the rdataset if it is not found. + + Returns a ``dns.rdataset.Rdataset`` or ``None``. + """ + + try: + rds = self.find_rdataset(rdclass, rdtype, covers, create) + except KeyError: + rds = None + return rds + + def delete_rdataset( + self, + rdclass: dns.rdataclass.RdataClass, + rdtype: dns.rdatatype.RdataType, + covers: dns.rdatatype.RdataType = dns.rdatatype.NONE, + ) -> None: + """Delete the rdataset matching the specified properties in the + current node. + + If a matching rdataset does not exist, it is not an error. + + *rdclass*, an ``int``, the class of the rdataset. + + *rdtype*, an ``int``, the type of the rdataset. + + *covers*, an ``int``, the covered type. + """ + + rds = self.get_rdataset(rdclass, rdtype, covers) + if rds is not None: + self.rdatasets.remove(rds) + + def replace_rdataset(self, replacement: dns.rdataset.Rdataset) -> None: + """Replace an rdataset. + + It is not an error if there is no rdataset matching *replacement*. + + Ownership of the *replacement* object is transferred to the node; + in other words, this method does not store a copy of *replacement* + at the node, it stores *replacement* itself. + + *replacement*, a ``dns.rdataset.Rdataset``. + + Raises ``ValueError`` if *replacement* is not a + ``dns.rdataset.Rdataset``. + """ + + if not isinstance(replacement, dns.rdataset.Rdataset): + raise ValueError("replacement is not an rdataset") + if isinstance(replacement, dns.rrset.RRset): + # RRsets are not good replacements as the match() method + # is not compatible. + replacement = replacement.to_rdataset() + self.delete_rdataset( + replacement.rdclass, replacement.rdtype, replacement.covers + ) + self._append_rdataset(replacement) + + def classify(self) -> NodeKind: + """Classify a node. + + A node which contains a CNAME or RRSIG(CNAME) is a + ``NodeKind.CNAME`` node. + + A node which contains only "neutral" types, i.e. types allowed to + co-exist with a CNAME, is a ``NodeKind.NEUTRAL`` node. The neutral + types are NSEC, NSEC3, KEY, and their associated RRSIGS. An empty node + is also considered neutral. + + A node which contains some rdataset which is not a CNAME, RRSIG(CNAME), + or a neutral type is a a ``NodeKind.REGULAR`` node. Regular nodes are + also commonly referred to as "other data". + """ + for rdataset in self.rdatasets: + kind = NodeKind.classify(rdataset.rdtype, rdataset.covers) + if kind != NodeKind.NEUTRAL: + return kind + return NodeKind.NEUTRAL + + def is_immutable(self) -> bool: + return False + + +@dns.immutable.immutable +class ImmutableNode(Node): + def __init__(self, node): + super().__init__() + self.rdatasets = tuple( + [dns.rdataset.ImmutableRdataset(rds) for rds in node.rdatasets] + ) + + def find_rdataset( + self, + rdclass: dns.rdataclass.RdataClass, + rdtype: dns.rdatatype.RdataType, + covers: dns.rdatatype.RdataType = dns.rdatatype.NONE, + create: bool = False, + ) -> dns.rdataset.Rdataset: + if create: + raise TypeError("immutable") + return super().find_rdataset(rdclass, rdtype, covers, False) + + def get_rdataset( + self, + rdclass: dns.rdataclass.RdataClass, + rdtype: dns.rdatatype.RdataType, + covers: dns.rdatatype.RdataType = dns.rdatatype.NONE, + create: bool = False, + ) -> Optional[dns.rdataset.Rdataset]: + if create: + raise TypeError("immutable") + return super().get_rdataset(rdclass, rdtype, covers, False) + + def delete_rdataset( + self, + rdclass: dns.rdataclass.RdataClass, + rdtype: dns.rdatatype.RdataType, + covers: dns.rdatatype.RdataType = dns.rdatatype.NONE, + ) -> None: + raise TypeError("immutable") + + def replace_rdataset(self, replacement: dns.rdataset.Rdataset) -> None: + raise TypeError("immutable") + + def is_immutable(self) -> bool: + return True diff --git a/.venv/lib/python3.12/site-packages/dns/opcode.py b/.venv/lib/python3.12/site-packages/dns/opcode.py new file mode 100644 index 0000000..78b43d2 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/opcode.py @@ -0,0 +1,117 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2001-2017 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""DNS Opcodes.""" + +import dns.enum +import dns.exception + + +class Opcode(dns.enum.IntEnum): + #: Query + QUERY = 0 + #: Inverse Query (historical) + IQUERY = 1 + #: Server Status (unspecified and unimplemented anywhere) + STATUS = 2 + #: Notify + NOTIFY = 4 + #: Dynamic Update + UPDATE = 5 + + @classmethod + def _maximum(cls): + return 15 + + @classmethod + def _unknown_exception_class(cls): + return UnknownOpcode + + +class UnknownOpcode(dns.exception.DNSException): + """An DNS opcode is unknown.""" + + +def from_text(text: str) -> Opcode: + """Convert text into an opcode. + + *text*, a ``str``, the textual opcode + + Raises ``dns.opcode.UnknownOpcode`` if the opcode is unknown. + + Returns an ``int``. + """ + + return Opcode.from_text(text) + + +def from_flags(flags: int) -> Opcode: + """Extract an opcode from DNS message flags. + + *flags*, an ``int``, the DNS flags. + + Returns an ``int``. + """ + + return Opcode((flags & 0x7800) >> 11) + + +def to_flags(value: Opcode) -> int: + """Convert an opcode to a value suitable for ORing into DNS message + flags. + + *value*, an ``int``, the DNS opcode value. + + Returns an ``int``. + """ + + return (value << 11) & 0x7800 + + +def to_text(value: Opcode) -> str: + """Convert an opcode to text. + + *value*, an ``int`` the opcode value, + + Raises ``dns.opcode.UnknownOpcode`` if the opcode is unknown. + + Returns a ``str``. + """ + + return Opcode.to_text(value) + + +def is_update(flags: int) -> bool: + """Is the opcode in flags UPDATE? + + *flags*, an ``int``, the DNS message flags. + + Returns a ``bool``. + """ + + return from_flags(flags) == Opcode.UPDATE + + +### BEGIN generated Opcode constants + +QUERY = Opcode.QUERY +IQUERY = Opcode.IQUERY +STATUS = Opcode.STATUS +NOTIFY = Opcode.NOTIFY +UPDATE = Opcode.UPDATE + +### END generated Opcode constants diff --git a/.venv/lib/python3.12/site-packages/dns/py.typed b/.venv/lib/python3.12/site-packages/dns/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/.venv/lib/python3.12/site-packages/dns/query.py b/.venv/lib/python3.12/site-packages/dns/query.py new file mode 100644 index 0000000..f0ee916 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/query.py @@ -0,0 +1,1578 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2017 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""Talk to a DNS server.""" + +import base64 +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 +import dns.name +import dns.quic +import dns.rcode +import dns.rdataclass +import dns.rdatatype +import dns.serial +import dns.transaction +import dns.tsig +import dns.xfr + + +def _remaining(expiration): + if expiration is None: + return None + timeout = expiration - time.time() + if timeout <= 0.0: + raise dns.exception.Timeout + return timeout + + +def _expiration_for_this_attempt(timeout, expiration): + if expiration is None: + return None + return min(time.time() + timeout, expiration) + + +_have_httpx = dns._features.have("doh") +if _have_httpx: + import httpcore._backends.sync + import httpx + + _CoreNetworkBackend = httpcore.NetworkBackend + _CoreSyncStream = httpcore._backends.sync.SyncStream + + class _NetworkBackend(_CoreNetworkBackend): + def __init__(self, resolver, local_port, bootstrap_address, family): + super().__init__() + self._local_port = local_port + self._resolver = resolver + self._bootstrap_address = bootstrap_address + self._family = family + + def connect_tcp( + self, host, port, timeout, local_address, socket_options=None + ): # pylint: disable=signature-differs + addresses = [] + _, expiration = _compute_times(timeout) + if dns.inet.is_address(host): + addresses.append(host) + elif self._bootstrap_address is not None: + addresses.append(self._bootstrap_address) + else: + timeout = _remaining(expiration) + family = self._family + if local_address: + family = dns.inet.af_for_address(local_address) + answers = self._resolver.resolve_name( + host, family=family, lifetime=timeout + ) + addresses = answers.addresses() + for address in addresses: + af = dns.inet.af_for_address(address) + if local_address is not None or self._local_port != 0: + source = dns.inet.low_level_address_tuple( + (local_address, self._local_port), af + ) + else: + source = None + sock = _make_socket(af, socket.SOCK_STREAM, source) + attempt_expiration = _expiration_for_this_attempt(2.0, expiration) + try: + _connect( + sock, + dns.inet.low_level_address_tuple((address, port), af), + attempt_expiration, + ) + return _CoreSyncStream(sock) + except Exception: + pass + raise httpcore.ConnectError + + def connect_unix_socket( + self, path, timeout, socket_options=None + ): # pylint: disable=signature-differs + raise NotImplementedError + + class _HTTPTransport(httpx.HTTPTransport): + def __init__( + self, + *args, + local_port=0, + bootstrap_address=None, + resolver=None, + family=socket.AF_UNSPEC, + **kwargs, + ): + if resolver is None: + # pylint: disable=import-outside-toplevel,redefined-outer-name + import dns.resolver + + resolver = dns.resolver.Resolver() + super().__init__(*args, **kwargs) + self._pool._network_backend = _NetworkBackend( + resolver, local_port, bootstrap_address, family + ) + +else: + + class _HTTPTransport: # type: ignore + def connect_tcp(self, host, port, timeout, local_address): + raise NotImplementedError + + +have_doh = _have_httpx + +try: + import ssl +except ImportError: # pragma: no cover + + class ssl: # type: ignore + CERT_NONE = 0 + + class WantReadException(Exception): + pass + + class WantWriteException(Exception): + pass + + class SSLContext: + pass + + class SSLSocket: + pass + + @classmethod + def create_default_context(cls, *args, **kwargs): + raise Exception("no ssl support") # pylint: disable=broad-exception-raised + + +# Function used to create a socket. Can be overridden if needed in special +# situations. +socket_factory = socket.socket + + +class UnexpectedSource(dns.exception.DNSException): + """A DNS query response came from an unexpected address or port.""" + + +class BadResponse(dns.exception.FormError): + """A DNS query response does not respond to the question asked.""" + + +class NoDOH(dns.exception.DNSException): + """DNS over HTTPS (DOH) was requested but the httpx module is not + available.""" + + +class NoDOQ(dns.exception.DNSException): + """DNS over QUIC (DOQ) was requested but the aioquic module is not + available.""" + + +# for backwards compatibility +TransferError = dns.xfr.TransferError + + +def _compute_times(timeout): + now = time.time() + if timeout is None: + return (now, None) + else: + return (now, now + timeout) + + +def _wait_for(fd, readable, writable, _, expiration): + # Use the selected selector class to wait for any of the specified + # events. An "expiration" absolute time is converted into a relative + # timeout. + # + # The unused parameter is 'error', which is always set when + # selecting for read or write, and we have no error-only selects. + + if readable and isinstance(fd, ssl.SSLSocket) and fd.pending() > 0: + return True + sel = _selector_class() + events = 0 + if readable: + events |= selectors.EVENT_READ + if writable: + events |= selectors.EVENT_WRITE + if events: + sel.register(fd, events) + if expiration is None: + timeout = None + else: + timeout = expiration - time.time() + if timeout <= 0.0: + raise dns.exception.Timeout + if not sel.select(timeout): + raise dns.exception.Timeout + + +def _set_selector_class(selector_class): + # Internal API. Do not use. + + global _selector_class + + _selector_class = selector_class + + +if hasattr(selectors, "PollSelector"): + # Prefer poll() on platforms that support it because it has no + # limits on the maximum value of a file descriptor (plus it will + # be more efficient for high values). + # + # We ignore typing here as we can't say _selector_class is Any + # on python < 3.8 due to a bug. + _selector_class = selectors.PollSelector # type: ignore +else: + _selector_class = selectors.SelectSelector # type: ignore + + +def _wait_for_readable(s, expiration): + _wait_for(s, True, False, True, expiration) + + +def _wait_for_writable(s, expiration): + _wait_for(s, False, True, True, expiration) + + +def _addresses_equal(af, a1, a2): + # Convert the first value of the tuple, which is a textual format + # address into binary form, so that we are not confused by different + # textual representations of the same address + try: + n1 = dns.inet.inet_pton(af, a1[0]) + n2 = dns.inet.inet_pton(af, a2[0]) + except dns.exception.SyntaxError: + return False + return n1 == n2 and a1[1:] == a2[1:] + + +def _matches_destination(af, from_address, destination, ignore_unexpected): + # Check that from_address is appropriate for a response to a query + # sent to destination. + if not destination: + return True + if _addresses_equal(af, from_address, destination) or ( + dns.inet.is_multicast(destination[0]) and from_address[1:] == destination[1:] + ): + return True + elif ignore_unexpected: + return False + raise UnexpectedSource( + f"got a response from {from_address} instead of " f"{destination}" + ) + + +def _destination_and_source( + where, port, source, source_port, where_must_be_address=True +): + # Apply defaults and compute destination and source tuples + # suitable for use in connect(), sendto(), or bind(). + af = None + destination = None + try: + af = dns.inet.af_for_address(where) + destination = where + except Exception: + if where_must_be_address: + raise + # URLs are ok so eat the exception + if source: + saf = dns.inet.af_for_address(source) + if af: + # We know the destination af, so source had better agree! + if saf != af: + raise ValueError( + "different address families for source and destination" + ) + else: + # We didn't know the destination af, but we know the source, + # so that's our af. + af = saf + if source_port and not source: + # Caller has specified a source_port but not an address, so we + # need to return a source, and we need to use the appropriate + # wildcard address as the address. + try: + source = dns.inet.any_for_af(af) + except Exception: + # we catch this and raise ValueError for backwards compatibility + raise ValueError("source_port specified but address family is unknown") + # Convert high-level (address, port) tuples into low-level address + # tuples. + if destination: + destination = dns.inet.low_level_address_tuple((destination, port), af) + if source: + source = dns.inet.low_level_address_tuple((source, source_port), af) + return (af, destination, source) + + +def _make_socket(af, type, source, ssl_context=None, server_hostname=None): + s = socket_factory(af, type) + try: + s.setblocking(False) + if source is not None: + s.bind(source) + if ssl_context: + # LGTM gets a false positive here, as our default context is OK + return ssl_context.wrap_socket( + s, + do_handshake_on_connect=False, # lgtm[py/insecure-protocol] + server_hostname=server_hostname, + ) + else: + return s + except Exception: + s.close() + raise + + +def https( + q: dns.message.Message, + where: str, + timeout: Optional[float] = None, + port: int = 443, + source: Optional[str] = None, + source_port: int = 0, + one_rr_per_rrset: bool = False, + ignore_trailing: bool = False, + session: Optional[Any] = None, + path: str = "/dns-query", + post: bool = True, + bootstrap_address: Optional[str] = None, + verify: Union[bool, str] = True, + resolver: Optional["dns.resolver.Resolver"] = None, + family: Optional[int] = socket.AF_UNSPEC, +) -> dns.message.Message: + """Return the response obtained after sending a query via DNS-over-HTTPS. + + *q*, a ``dns.message.Message``, the query to send. + + *where*, a ``str``, the nameserver IP address or the full URL. If an IP address is + given, the URL will be constructed using the following schema: + https://:/. + + *timeout*, a ``float`` or ``None``, the number of seconds to wait before the query + times out. If ``None``, the default, wait forever. + + *port*, a ``int``, the port to send the query to. The default is 443. + + *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. + + *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. + + *session*, an ``httpx.Client``. If provided, the client session to use to send the + queries. + + *path*, a ``str``. If *where* is an IP address, then *path* will be used to + construct the URL to send the DNS query to. + + *post*, a ``bool``. If ``True``, the default, POST method will be used. + + *bootstrap_address*, a ``str``, the IP address to use to bypass resolution. + + *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. + + *resolver*, a ``dns.resolver.Resolver`` or ``None``, the resolver to use for + resolution of hostnames in URLs. If not specified, a new resolver with a default + configuration will be used; note this is *not* the default resolver as that resolver + might have been configured to use DoH causing a chicken-and-egg problem. This + parameter only has an effect if the HTTP library is httpx. + + *family*, an ``int``, the address family. If socket.AF_UNSPEC (the default), both A + and AAAA records will be retrieved. + + Returns a ``dns.message.Message``. + """ + + if not have_doh: + raise NoDOH # pragma: no cover + if session and not isinstance(session, httpx.Client): + raise ValueError("session parameter must be an httpx.Client") + + wire = q.to_wire() + (af, _, the_source) = _destination_and_source( + where, port, source, source_port, False + ) + transport = None + headers = {"accept": "application/dns-message"} + if af is not None and dns.inet.is_address(where): + if af == socket.AF_INET: + url = "https://{}:{}{}".format(where, port, path) + elif af == socket.AF_INET6: + url = "https://[{}]:{}{}".format(where, port, path) + else: + url = where + + # set source port and source address + + if the_source is None: + local_address = None + local_port = 0 + else: + local_address = the_source[0] + local_port = the_source[1] + transport = _HTTPTransport( + local_address=local_address, + http1=True, + http2=True, + verify=verify, + local_port=local_port, + bootstrap_address=bootstrap_address, + resolver=resolver, + family=family, + ) + + if session: + cm: contextlib.AbstractContextManager = contextlib.nullcontext(session) + else: + 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 + if post: + headers.update( + { + "content-type": "application/dns-message", + "content-length": str(len(wire)), + } + ) + response = session.post(url, headers=headers, content=wire, timeout=timeout) + else: + wire = base64.urlsafe_b64encode(wire).rstrip(b"=") + twire = wire.decode() # httpx does a repr() if we give it bytes + response = session.get( + url, headers=headers, timeout=timeout, params={"dns": twire} + ) + + # see https://tools.ietf.org/html/rfc8484#section-4.2.1 for info about DoH + # status codes + if response.status_code < 200 or response.status_code > 299: + raise ValueError( + "{} responded with status code {}" + "\nResponse body: {}".format(where, response.status_code, response.content) + ) + r = dns.message.from_wire( + response.content, + keyring=q.keyring, + request_mac=q.request_mac, + one_rr_per_rrset=one_rr_per_rrset, + ignore_trailing=ignore_trailing, + ) + r.time = response.elapsed.total_seconds() + if not q.is_response(r): + raise BadResponse + return r + + +def _udp_recv(sock, max_size, expiration): + """Reads a datagram from the socket. + A Timeout exception will be raised if the operation is not completed + by the expiration time. + """ + while True: + try: + return sock.recvfrom(max_size) + except BlockingIOError: + _wait_for_readable(sock, expiration) + + +def _udp_send(sock, data, destination, expiration): + """Sends the specified datagram to destination over the socket. + A Timeout exception will be raised if the operation is not completed + by the expiration time. + """ + while True: + try: + if destination: + return sock.sendto(data, destination) + else: + return sock.send(data) + except BlockingIOError: # pragma: no cover + _wait_for_writable(sock, expiration) + + +def send_udp( + sock: Any, + what: Union[dns.message.Message, bytes], + destination: Any, + expiration: Optional[float] = None, +) -> Tuple[int, float]: + """Send a DNS message to the specified UDP socket. + + *sock*, a ``socket``. + + *what*, a ``bytes`` or ``dns.message.Message``, the message to send. + + *destination*, a destination tuple appropriate for the address family + of the socket, specifying where to send the query. + + *expiration*, a ``float`` or ``None``, the absolute time at which + a timeout exception should be raised. If ``None``, no timeout will + occur. + + Returns an ``(int, float)`` tuple of bytes sent and the sent time. + """ + + if isinstance(what, dns.message.Message): + what = what.to_wire() + sent_time = time.time() + n = _udp_send(sock, what, destination, expiration) + return (n, sent_time) + + +def receive_udp( + sock: Any, + destination: Optional[Any] = None, + expiration: Optional[float] = None, + ignore_unexpected: bool = False, + one_rr_per_rrset: bool = False, + keyring: Optional[Dict[dns.name.Name, dns.tsig.Key]] = None, + 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. + + *sock*, a ``socket``. + + *destination*, a destination tuple appropriate for the address family + of the socket, specifying where the message is expected to arrive from. + When receiving a response, this would be where the associated query was + sent. + + *expiration*, a ``float`` or ``None``, the absolute time at which + a timeout exception should be raised. If ``None``, no timeout will + occur. + + *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. + + *keyring*, a ``dict``, the keyring to use for TSIG. + + *request_mac*, a ``bytes`` or ``None``, the MAC of the request (for TSIG). + + *ignore_trailing*, a ``bool``. If ``True``, ignore trailing + junk at end of the received message. + + *raise_on_truncation*, a ``bool``. If ``True``, raise an exception if + the TC bit is set. + + Raises if the message is malformed, if network errors occur, of if + there is a timeout. + + If *destination* is not ``None``, returns a ``(dns.message.Message, float)`` + tuple of the received message and the received time. + + If *destination* is ``None``, returns a + ``(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 not _matches_destination( + sock.family, from_address, destination, ignore_unexpected + ): + 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( + q: dns.message.Message, + where: str, + timeout: Optional[float] = None, + port: int = 53, + source: Optional[str] = None, + source_port: int = 0, + ignore_unexpected: bool = False, + one_rr_per_rrset: bool = False, + 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. + + *q*, a ``dns.message.Message``, the query to send + + *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. + + *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_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. + + *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. + + *raise_on_truncation*, a ``bool``. If ``True``, raise an exception if + the TC bit is set. + + *sock*, a ``socket.socket``, or ``None``, the socket to use for the + 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. + + *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``. + """ + + wire = q.to_wire() + (af, destination, source) = _destination_and_source( + where, port, source, source_port + ) + (begin_time, expiration) = _compute_times(timeout) + if sock: + cm: contextlib.AbstractContextManager = contextlib.nullcontext(sock) + else: + cm = _make_socket(af, socket.SOCK_DGRAM, source) + with cm as s: + send_udp(s, wire, destination, expiration) + (r, received_time) = receive_udp( + s, + destination, + expiration, + ignore_unexpected, + one_rr_per_rrset, + q.keyring, + q.mac, + ignore_trailing, + raise_on_truncation, + ignore_errors, + q, + ) + r.time = received_time - begin_time + # 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 ( + False # help mypy figure out we can't get here lgtm[py/unreachable-statement] + ) + + +def udp_with_fallback( + q: dns.message.Message, + where: str, + timeout: Optional[float] = None, + port: int = 53, + source: Optional[str] = None, + source_port: int = 0, + ignore_unexpected: bool = False, + one_rr_per_rrset: bool = False, + 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. + + *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_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. + + *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. + + *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. + + *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( + q, + where, + timeout, + port, + source, + source_port, + ignore_unexpected, + one_rr_per_rrset, + ignore_trailing, + True, + udp_sock, + ignore_errors, + ) + return (response, False) + except dns.message.Truncated: + response = tcp( + q, + where, + timeout, + port, + source, + source_port, + one_rr_per_rrset, + ignore_trailing, + tcp_sock, + ) + return (response, True) + + +def _net_read(sock, count, expiration): + """Read the specified number of bytes from sock. Keep trying until we + either get the desired amount, or we hit EOF. + A Timeout exception will be raised if the operation is not completed + by the expiration time. + """ + s = b"" + while count > 0: + try: + n = sock.recv(count) + if n == b"": + raise EOFError + count -= len(n) + s += n + except (BlockingIOError, ssl.SSLWantReadError): + _wait_for_readable(sock, expiration) + except ssl.SSLWantWriteError: # pragma: no cover + _wait_for_writable(sock, expiration) + return s + + +def _net_write(sock, data, expiration): + """Write the specified data to the socket. + A Timeout exception will be raised if the operation is not completed + by the expiration time. + """ + current = 0 + l = len(data) + while current < l: + try: + current += sock.send(data[current:]) + except (BlockingIOError, ssl.SSLWantWriteError): + _wait_for_writable(sock, expiration) + except ssl.SSLWantReadError: # pragma: no cover + _wait_for_readable(sock, expiration) + + +def send_tcp( + sock: Any, + what: Union[dns.message.Message, bytes], + expiration: Optional[float] = None, +) -> Tuple[int, float]: + """Send a DNS message to the specified TCP socket. + + *sock*, a ``socket``. + + *what*, a ``bytes`` or ``dns.message.Message``, the message to send. + + *expiration*, a ``float`` or ``None``, the absolute time at which + a timeout exception should be raised. If ``None``, no timeout will + occur. + + Returns an ``(int, float)`` tuple of bytes sent and the sent time. + """ + + if isinstance(what, dns.message.Message): + tcpmsg = what.to_wire(prepend_length=True) + else: + # 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) + + +def receive_tcp( + sock: Any, + expiration: Optional[float] = None, + one_rr_per_rrset: bool = False, + keyring: Optional[Dict[dns.name.Name, dns.tsig.Key]] = None, + request_mac: Optional[bytes] = b"", + ignore_trailing: bool = False, +) -> Tuple[dns.message.Message, float]: + """Read a DNS message from a TCP socket. + + *sock*, a ``socket``. + + *expiration*, a ``float`` or ``None``, the absolute time at which + a timeout exception should be raised. If ``None``, no timeout will + occur. + + *one_rr_per_rrset*, a ``bool``. If ``True``, put each RR into its own + RRset. + + *keyring*, a ``dict``, the keyring to use for TSIG. + + *request_mac*, a ``bytes`` or ``None``, the MAC of the request (for TSIG). + + *ignore_trailing*, a ``bool``. If ``True``, ignore trailing + junk at end of the received message. + + Raises if the message is malformed, if network errors occur, of if + there is a timeout. + + Returns a ``(dns.message.Message, float)`` tuple of the received message + and the received time. + """ + + ldata = _net_read(sock, 2, expiration) + (l,) = struct.unpack("!H", ldata) + wire = _net_read(sock, l, expiration) + 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, + ) + return (r, received_time) + + +def _connect(s, address, expiration): + err = s.connect_ex(address) + if err == 0: + return + if err in (errno.EINPROGRESS, errno.EWOULDBLOCK, errno.EALREADY): + _wait_for_writable(s, expiration) + err = s.getsockopt(socket.SOL_SOCKET, socket.SO_ERROR) + if err != 0: + raise OSError(err, os.strerror(err)) + + +def tcp( + q: dns.message.Message, + where: str, + timeout: Optional[float] = None, + port: int = 53, + source: Optional[str] = None, + source_port: int = 0, + one_rr_per_rrset: bool = False, + ignore_trailing: bool = False, + sock: Optional[Any] = None, +) -> dns.message.Message: + """Return the response obtained after sending a query via TCP. + + *q*, a ``dns.message.Message``, the query to send + + *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. + + *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_port*, an ``int``, the port from which to send the message. + The default is 0. + + *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. + + *sock*, a ``socket.socket``, or ``None``, the connected socket to use for the + 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*, *port*, *source* and *source_port* are ignored. + + Returns a ``dns.message.Message``. + """ + + wire = q.to_wire() + (begin_time, expiration) = _compute_times(timeout) + if sock: + cm: contextlib.AbstractContextManager = contextlib.nullcontext(sock) + else: + (af, destination, source) = _destination_and_source( + where, port, source, source_port + ) + cm = _make_socket(af, socket.SOCK_STREAM, source) + with cm as s: + if not sock: + _connect(s, destination, expiration) + send_tcp(s, wire, expiration) + (r, received_time) = receive_tcp( + s, expiration, one_rr_per_rrset, q.keyring, q.mac, ignore_trailing + ) + r.time = received_time - begin_time + if not q.is_response(r): + raise BadResponse + return r + assert ( + False # help mypy figure out we can't get here lgtm[py/unreachable-statement] + ) + + +def _tls_handshake(s, expiration): + while True: + try: + s.do_handshake() + return + except ssl.SSLWantReadError: + _wait_for_readable(s, expiration) + except ssl.SSLWantWriteError: # pragma: no cover + _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, + timeout: Optional[float] = None, + port: int = 853, + source: Optional[str] = None, + source_port: int = 0, + one_rr_per_rrset: bool = False, + ignore_trailing: bool = False, + 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. + + *q*, a ``dns.message.Message``, the query to send + + *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. + + *port*, an ``int``, the port send the message to. The default is 853. + + *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. + + *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. + + *sock*, an ``ssl.SSLSocket``, or ``None``, the socket to use for + the query. If ``None``, the default, a socket is created. Note + that if a socket is provided, it must be a nonblocking connected + SSL stream socket, and *where*, *port*, *source*, *source_port*, + and *ssl_context* are ignored. + + *ssl_context*, an ``ssl.SSLContext``, the context to use when establishing + a TLS connection. If ``None``, the default, creates one with the default + configuration. + + *server_hostname*, a ``str`` containing the server's hostname. The + 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``. + + """ + + if sock: + # + # If a socket was provided, there's no special TLS handling needed. + # + return tcp( + q, + where, + timeout, + port, + source, + source_port, + one_rr_per_rrset, + ignore_trailing, + sock, + ) + + wire = q.to_wire() + (begin_time, expiration) = _compute_times(timeout) + (af, destination, source) = _destination_and_source( + where, port, source, source_port + ) + if ssl_context is None and not sock: + ssl_context = _make_dot_ssl_context(server_hostname, verify) + + with _make_socket( + af, + socket.SOCK_STREAM, + source, + ssl_context=ssl_context, + server_hostname=server_hostname, + ) as s: + _connect(s, destination, expiration) + _tls_handshake(s, expiration) + send_tcp(s, wire, expiration) + (r, received_time) = receive_tcp( + s, expiration, one_rr_per_rrset, q.keyring, q.mac, ignore_trailing + ) + r.time = received_time - begin_time + if not q.is_response(r): + raise BadResponse + return r + assert ( + False # help mypy figure out we can't get here lgtm[py/unreachable-statement] + ) + + +def quic( + q: dns.message.Message, + where: str, + timeout: Optional[float] = None, + port: int = 853, + source: Optional[str] = None, + source_port: int = 0, + one_rr_per_rrset: bool = False, + ignore_trailing: bool = False, + connection: Optional[dns.quic.SyncQuicConnection] = None, + verify: Union[bool, str] = True, + server_hostname: Optional[str] = None, +) -> dns.message.Message: + """Return the response obtained after sending a query via DNS-over-QUIC. + + *q*, a ``dns.message.Message``, the query to send. + + *where*, a ``str``, the nameserver IP address. + + *timeout*, a ``float`` or ``None``, the number of seconds to wait before the query + times out. If ``None``, the default, wait forever. + + *port*, a ``int``, the port to send the query to. The default is 853. + + *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. + + *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. + + *connection*, a ``dns.quic.SyncQuicConnection``. If provided, the + connection to use to send the query. + + *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. + + *server_hostname*, a ``str`` containing the server's hostname. The + default is ``None``, which means that no hostname is known, and if an + SSL context is created, hostname checking will be disabled. + + Returns a ``dns.message.Message``. + """ + + if not dns.quic.have_quic: + raise NoDOQ("DNS-over-QUIC is not available.") # pragma: no cover + + q.id = 0 + wire = q.to_wire() + the_connection: dns.quic.SyncQuicConnection + the_manager: dns.quic.SyncQuicManager + if connection: + manager: contextlib.AbstractContextManager = contextlib.nullcontext(None) + the_connection = connection + else: + manager = dns.quic.SyncQuicManager( + verify_mode=verify, server_name=server_hostname + ) + the_manager = manager # for type checking happiness + + with manager: + if not connection: + the_connection = the_manager.connect(where, port, source, source_port) + (start, expiration) = _compute_times(timeout) + with the_connection.make_stream(timeout) as stream: + stream.send(wire, True) + wire = stream.receive(_remaining(expiration)) + finish = time.time() + r = dns.message.from_wire( + wire, + keyring=q.keyring, + request_mac=q.request_mac, + one_rr_per_rrset=one_rr_per_rrset, + ignore_trailing=ignore_trailing, + ) + r.time = max(finish - start, 0.0) + if not q.is_response(r): + raise BadResponse + return r + + +def xfr( + where: str, + zone: Union[dns.name.Name, str], + rdtype: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.AXFR, + rdclass: Union[dns.rdataclass.RdataClass, str] = dns.rdataclass.IN, + timeout: Optional[float] = None, + port: int = 53, + keyring: Optional[Dict[dns.name.Name, dns.tsig.Key]] = None, + keyname: Optional[Union[dns.name.Name, str]] = None, + relativize: bool = True, + lifetime: Optional[float] = None, + source: Optional[str] = None, + source_port: int = 0, + serial: int = 0, + use_udp: bool = False, + keyalgorithm: Union[dns.name.Name, str] = dns.tsig.default_algorithm, +) -> Any: + """Return a generator for the responses to a zone transfer. + + *where*, a ``str`` containing an IPv4 or IPv6 address, where + to send the message. + + *zone*, a ``dns.name.Name`` or ``str``, the name of the zone to transfer. + + *rdtype*, an ``int`` or ``str``, the type of zone transfer. The + default is ``dns.rdatatype.AXFR``. ``dns.rdatatype.IXFR`` can be + used to do an incremental transfer instead. + + *rdclass*, an ``int`` or ``str``, the class of the zone transfer. + The default is ``dns.rdataclass.IN``. + + *timeout*, a ``float``, the number of seconds to wait for each + response message. If None, the default, wait forever. + + *port*, an ``int``, the port send the message to. The default is 53. + + *keyring*, a ``dict``, the keyring to use for TSIG. + + *keyname*, a ``dns.name.Name`` or ``str``, the name of the TSIG + key to use. + + *relativize*, a ``bool``. If ``True``, all names in the zone will be + relativized to the zone origin. It is essential that the + relativize setting matches the one specified to + ``dns.zone.from_xfr()`` if using this generator to make a zone. + + *lifetime*, a ``float``, the total number of seconds to spend + doing the transfer. If ``None``, the default, then there is no + limit on the time the transfer may take. + + *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. + + *serial*, an ``int``, the SOA serial number to use as the base for + an IXFR diff sequence (only meaningful if *rdtype* is + ``dns.rdatatype.IXFR``). + + *use_udp*, a ``bool``. If ``True``, use UDP (only meaningful for IXFR). + + *keyalgorithm*, a ``dns.name.Name`` or ``str``, the TSIG algorithm to use. + + Raises on errors, and so does the generator. + + Returns a generator of ``dns.message.Message`` objects. + """ + + if isinstance(zone, str): + zone = dns.name.from_text(zone) + rdtype = dns.rdatatype.RdataType.make(rdtype) + q = dns.message.make_query(zone, rdtype, rdclass) + if rdtype == dns.rdatatype.IXFR: + rrset = dns.rrset.from_text(zone, 0, "IN", "SOA", ". . %u 0 0 0 0" % serial) + q.authority.append(rrset) + if keyring is not None: + q.use_tsig(keyring, keyname, algorithm=keyalgorithm) + wire = q.to_wire() + (af, destination, source) = _destination_and_source( + where, port, source, source_port + ) + if use_udp and rdtype != dns.rdatatype.IXFR: + raise ValueError("cannot do a UDP AXFR") + sock_type = socket.SOCK_DGRAM if use_udp else socket.SOCK_STREAM + with _make_socket(af, sock_type, source) as s: + (_, expiration) = _compute_times(lifetime) + _connect(s, destination, expiration) + l = len(wire) + if use_udp: + _udp_send(s, wire, None, expiration) + else: + tcpmsg = struct.pack("!H", l) + wire + _net_write(s, tcpmsg, expiration) + done = False + delete_mode = True + expecting_SOA = False + soa_rrset = None + if relativize: + origin = zone + oname = dns.name.empty + else: + origin = None + oname = zone + tsig_ctx = None + while not done: + (_, mexpiration) = _compute_times(timeout) + if mexpiration is None or ( + expiration is not None and mexpiration > expiration + ): + mexpiration = expiration + if use_udp: + (wire, _) = _udp_recv(s, 65535, mexpiration) + else: + ldata = _net_read(s, 2, mexpiration) + (l,) = struct.unpack("!H", ldata) + wire = _net_read(s, l, mexpiration) + is_ixfr = rdtype == dns.rdatatype.IXFR + r = dns.message.from_wire( + wire, + keyring=q.keyring, + request_mac=q.mac, + xfr=True, + origin=origin, + tsig_ctx=tsig_ctx, + multi=True, + one_rr_per_rrset=is_ixfr, + ) + rcode = r.rcode() + if rcode != dns.rcode.NOERROR: + raise TransferError(rcode) + tsig_ctx = r.tsig_ctx + answer_index = 0 + if soa_rrset is None: + if not r.answer or r.answer[0].name != oname: + raise dns.exception.FormError("No answer or RRset not for qname") + rrset = r.answer[0] + if rrset.rdtype != dns.rdatatype.SOA: + raise dns.exception.FormError("first RRset is not an SOA") + answer_index = 1 + soa_rrset = rrset.copy() + if rdtype == dns.rdatatype.IXFR: + if dns.serial.Serial(soa_rrset[0].serial) <= serial: + # + # We're already up-to-date. + # + done = True + else: + expecting_SOA = True + # + # Process SOAs in the answer section (other than the initial + # SOA in the first message). + # + for rrset in r.answer[answer_index:]: + if done: + raise dns.exception.FormError("answers after final SOA") + if rrset.rdtype == dns.rdatatype.SOA and rrset.name == oname: + if expecting_SOA: + if rrset[0].serial != serial: + raise dns.exception.FormError("IXFR base serial mismatch") + expecting_SOA = False + elif rdtype == dns.rdatatype.IXFR: + delete_mode = not delete_mode + # + # If this SOA RRset is equal to the first we saw then we're + # finished. If this is an IXFR we also check that we're + # seeing the record in the expected part of the response. + # + if rrset == soa_rrset and ( + rdtype == dns.rdatatype.AXFR + or (rdtype == dns.rdatatype.IXFR and delete_mode) + ): + done = True + elif expecting_SOA: + # + # We made an IXFR request and are expecting another + # SOA RR, but saw something else, so this must be an + # AXFR response. + # + rdtype = dns.rdatatype.AXFR + expecting_SOA = False + if done and q.keyring and not r.had_tsig: + raise dns.exception.FormError("missing TSIG") + yield r + + +class UDPMode(enum.IntEnum): + """How should UDP be used in an IXFR from :py:func:`inbound_xfr()`? + + NEVER means "never use UDP; always use TCP" + TRY_FIRST means "try to use UDP but fall back to TCP if needed" + ONLY means "raise ``dns.xfr.UseTCP`` if trying UDP does not succeed" + """ + + NEVER = 0 + TRY_FIRST = 1 + ONLY = 2 + + +def inbound_xfr( + where: str, + txn_manager: dns.transaction.TransactionManager, + query: Optional[dns.message.Message] = None, + port: int = 53, + timeout: Optional[float] = None, + lifetime: Optional[float] = None, + source: Optional[str] = None, + source_port: int = 0, + udp_mode: UDPMode = UDPMode.NEVER, +) -> None: + """Conduct an inbound transfer and apply it via a transaction from the + txn_manager. + + *where*, a ``str`` containing an IPv4 or IPv6 address, where + to send the message. + + *txn_manager*, a ``dns.transaction.TransactionManager``, the txn_manager + for this transfer (typically a ``dns.zone.Zone``). + + *query*, the query to send. If not supplied, a default query is + constructed using information from the *txn_manager*. + + *port*, an ``int``, the port send the message to. The default is 53. + + *timeout*, a ``float``, the number of seconds to wait for each + response message. If None, the default, wait forever. + + *lifetime*, a ``float``, the total number of seconds to spend + doing the transfer. If ``None``, the default, then there is no + limit on the time the transfer may take. + + *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. + + *udp_mode*, a ``dns.query.UDPMode``, determines how UDP is used + for IXFRs. The default is ``dns.UDPMode.NEVER``, i.e. only use + TCP. Other possibilities are ``dns.UDPMode.TRY_FIRST``, which + means "try UDP but fallback to TCP if needed", and + ``dns.UDPMode.ONLY``, which means "try UDP and raise + ``dns.xfr.UseTCP`` if it does not succeed. + + Raises on errors. + """ + if query is None: + (query, serial) = dns.xfr.make_query(txn_manager) + else: + serial = dns.xfr.extract_serial_from_query(query) + rdtype = query.question[0].rdtype + is_ixfr = rdtype == dns.rdatatype.IXFR + origin = txn_manager.from_wire_origin() + wire = query.to_wire() + (af, destination, source) = _destination_and_source( + where, port, source, source_port + ) + (_, expiration) = _compute_times(lifetime) + retry = True + while retry: + retry = False + if is_ixfr and udp_mode != UDPMode.NEVER: + sock_type = socket.SOCK_DGRAM + is_udp = True + else: + sock_type = socket.SOCK_STREAM + is_udp = False + with _make_socket(af, sock_type, source) as s: + _connect(s, destination, expiration) + if is_udp: + _udp_send(s, wire, None, expiration) + else: + tcpmsg = struct.pack("!H", len(wire)) + wire + _net_write(s, tcpmsg, expiration) + with dns.xfr.Inbound(txn_manager, rdtype, serial, is_udp) as inbound: + done = False + tsig_ctx = None + while not done: + (_, mexpiration) = _compute_times(timeout) + if mexpiration is None or ( + expiration is not None and mexpiration > expiration + ): + mexpiration = expiration + if is_udp: + (rwire, _) = _udp_recv(s, 65535, mexpiration) + else: + ldata = _net_read(s, 2, mexpiration) + (l,) = struct.unpack("!H", ldata) + rwire = _net_read(s, l, mexpiration) + r = dns.message.from_wire( + rwire, + keyring=query.keyring, + request_mac=query.mac, + xfr=True, + origin=origin, + tsig_ctx=tsig_ctx, + multi=(not is_udp), + one_rr_per_rrset=is_ixfr, + ) + try: + done = inbound.process_message(r) + except dns.xfr.UseTCP: + assert is_udp # should not happen if we used TCP! + if udp_mode == UDPMode.ONLY: + raise + done = True + retry = True + udp_mode = UDPMode.NEVER + continue + tsig_ctx = r.tsig_ctx + if not retry and query.keyring and not r.had_tsig: + raise dns.exception.FormError("missing TSIG") diff --git a/.venv/lib/python3.12/site-packages/dns/quic/__init__.py b/.venv/lib/python3.12/site-packages/dns/quic/__init__.py new file mode 100644 index 0000000..20aff34 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/quic/__init__.py @@ -0,0 +1,75 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +import dns._features +import dns.asyncbackend + +if dns._features.have("doq"): + import aioquic.quic.configuration # type: ignore + + from dns._asyncbackend import NullContext + from dns.quic._asyncio import ( + AsyncioQuicConnection, + AsyncioQuicManager, + AsyncioQuicStream, + ) + from dns.quic._common import AsyncQuicConnection, AsyncQuicManager + from dns.quic._sync import SyncQuicConnection, SyncQuicManager, SyncQuicStream + + have_quic = True + + def null_factory( + *args, # pylint: disable=unused-argument + **kwargs, # pylint: disable=unused-argument + ): + return NullContext(None) + + def _asyncio_manager_factory( + context, *args, **kwargs # pylint: disable=unused-argument + ): + return AsyncioQuicManager(*args, **kwargs) + + # We have a context factory and a manager factory as for trio we need to have + # a nursery. + + _async_factories = {"asyncio": (null_factory, _asyncio_manager_factory)} + + if dns._features.have("trio"): + import trio + + from dns.quic._trio import ( # pylint: disable=ungrouped-imports + TrioQuicConnection, + TrioQuicManager, + TrioQuicStream, + ) + + def _trio_context_factory(): + return trio.open_nursery() + + def _trio_manager_factory(context, *args, **kwargs): + return TrioQuicManager(context, *args, **kwargs) + + _async_factories["trio"] = (_trio_context_factory, _trio_manager_factory) + + def factories_for_backend(backend=None): + if backend is None: + backend = dns.asyncbackend.get_default_backend() + return _async_factories[backend.name()] + +else: # pragma: no cover + have_quic = False + + from typing import Any + + class AsyncQuicStream: # type: ignore + pass + + class AsyncQuicConnection: # type: ignore + async def make_stream(self) -> Any: + raise NotImplementedError + + class SyncQuicStream: # type: ignore + pass + + class SyncQuicConnection: # type: ignore + def make_stream(self) -> Any: + raise NotImplementedError diff --git a/.venv/lib/python3.12/site-packages/dns/quic/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/quic/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..0ba94868e9e112b9c22ac002a3bbd48ecae33867 GIT binary patch literal 3086 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 J;7$|Nj$Qxi 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 P%k(Y0{$EgGu>XGm1;s)O literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/quic/__pycache__/_sync.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/quic/__pycache__/_sync.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c0d1694a9def7144f7e09ede727378503562190b GIT binary patch literal 15787 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 10: + # yield + count = 0 + await asyncio.sleep(0) + + async def write(self, stream, data, is_end=False): + self._connection.send_stream_data(stream, data, is_end) + async with self._wake_timer: + self._wake_timer.notify_all() + + def run(self): + if self._closed: + return + self._receiver_task = asyncio.Task(self._receiver()) + self._sender_task = asyncio.Task(self._sender()) + + async def make_stream(self, timeout=None): + try: + await asyncio.wait_for(self._handshake_complete.wait(), timeout) + except TimeoutError: + raise dns.exception.Timeout + if self._done: + raise UnexpectedEOF + stream_id = self._connection.get_next_available_stream_id(False) + stream = AsyncioQuicStream(self, stream_id) + self._streams[stream_id] = stream + return stream + + async def close(self): + if not self._closed: + self._manager.closed(self._peer[0], self._peer[1]) + self._closed = True + self._connection.close() + # sender might be blocked on this, so set it + self._socket_created.set() + async with self._wake_timer: + self._wake_timer.notify_all() + try: + await self._receiver_task + except asyncio.CancelledError: + pass + try: + 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, want_session_ticket=True + ): + (connection, start) = self._connect( + address, port, source, source_port, want_session_ticket + ) + if start: + connection.run() + return connection + + async def __aenter__(self): + return self + + async def __aexit__(self, exc_type, exc_val, exc_tb): + # Copy the iterator into a list as exiting things will mutate the connections + # table. + connections = list(self._connections.values()) + for connection in connections: + await connection.close() + return False diff --git a/.venv/lib/python3.12/site-packages/dns/quic/_common.py b/.venv/lib/python3.12/site-packages/dns/quic/_common.py new file mode 100644 index 0000000..0eacc69 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/quic/_common.py @@ -0,0 +1,224 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +import copy +import functools +import socket +import struct +import time +from typing import Any, Optional + +import aioquic.quic.configuration # type: ignore +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): + pass + + +class Buffer: + def __init__(self): + self._buffer = b"" + self._seen_end = False + + def put(self, data, is_end): + if self._seen_end: + return + self._buffer += data + if is_end: + self._seen_end = True + + def have(self, amount): + if len(self._buffer) >= amount: + return True + if self._seen_end: + raise UnexpectedEOF + return False + + def seen_end(self): + return self._seen_end + + def get(self, amount): + assert self.have(amount) + data = self._buffer[:amount] + self._buffer = self._buffer[amount:] + return data + + +class BaseQuicStream: + def __init__(self, connection, stream_id): + self._connection = connection + self._stream_id = stream_id + self._buffer = Buffer() + self._expecting = 0 + + def id(self): + return self._stream_id + + def _expiration_from_timeout(self, timeout): + if timeout is not None: + expiration = time.time() + timeout + else: + expiration = None + return expiration + + def _timeout_from_expiration(self, expiration): + if expiration is not None: + timeout = max(expiration - time.time(), 0.0) + else: + timeout = None + return timeout + + # Subclass must implement receive() as sync / async and which returns a message + # or raises UnexpectedEOF. + + def _encapsulate(self, datagram): + l = len(datagram) + return struct.pack("!H", l) + datagram + + def _common_add_input(self, data, is_end): + self._buffer.put(data, is_end) + 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) + self._buffer.put(b"", True) # send EOF in case we haven't seen it. + + +class BaseQuicConnection: + def __init__( + self, connection, address, port, source=None, source_port=0, manager=None + ): + self._done = False + self._connection = connection + self._address = address + self._port = port + self._closed = False + self._manager = manager + self._streams = {} + self._af = dns.inet.af_for_address(address) + self._peer = dns.inet.low_level_address_tuple((address, port)) + if source is None and source_port != 0: + if self._af == socket.AF_INET: + source = "0.0.0.0" + elif self._af == socket.AF_INET6: + source = "::" + else: + raise NotImplementedError + if source: + self._source = (source, source_port) + else: + self._source = None + + def close_stream(self, stream_id): + del self._streams[stream_id] + + def _get_timer_values(self, closed_is_special=True): + now = time.time() + expiration = self._connection.get_timer() + if expiration is None: + expiration = now + 3600 # arbitrary "big" value + interval = max(expiration - now, 0) + if self._closed and closed_is_special: + # lower sleep interval to avoid a race in the closing process + # which can lead to higher latency closing due to sleeping when + # we have events. + interval = min(interval, 0.05) + return (expiration, interval) + + def _handle_timer(self, expiration): + now = time.time() + if expiration <= now: + self._connection.handle_timer(now) + + +class AsyncQuicConnection(BaseQuicConnection): + async def make_stream(self, timeout: Optional[float] = None) -> Any: + pass + + +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): + verify_path = verify_mode + verify_mode = True + conf = aioquic.quic.configuration.QuicConfiguration( + alpn_protocols=["doq", "doq-i03"], + verify_mode=verify_mode, + server_name=server_name, + ) + if verify_path is not None: + conf.load_verify_locations(verify_path) + self._conf = conf + + 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) + 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 + ) + self._connections[(address, port)] = connection + return (connection, True) + + def closed(self, address, port): + try: + del self._connections[(address, port)] + 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): + raise NotImplementedError diff --git a/.venv/lib/python3.12/site-packages/dns/quic/_sync.py b/.venv/lib/python3.12/site-packages/dns/quic/_sync.py new file mode 100644 index 0000000..120cb5f --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/quic/_sync.py @@ -0,0 +1,238 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +import selectors +import socket +import ssl +import struct +import threading +import time + +import aioquic.quic.configuration # type: ignore +import aioquic.quic.connection # type: ignore +import aioquic.quic.events # type: ignore + +import dns.exception +import dns.inet +from dns.quic._common import ( + QUIC_MAX_DATAGRAM, + BaseQuicConnection, + BaseQuicManager, + BaseQuicStream, + UnexpectedEOF, +) + +# Avoid circularity with dns.query +if hasattr(selectors, "PollSelector"): + _selector_class = selectors.PollSelector # type: ignore +else: + _selector_class = selectors.SelectSelector # type: ignore + + +class SyncQuicStream(BaseQuicStream): + def __init__(self, connection, stream_id): + super().__init__(connection, stream_id) + self._wake_up = threading.Condition() + self._lock = threading.Lock() + + def wait_for(self, amount, expiration): + while True: + timeout = self._timeout_from_expiration(expiration) + with self._lock: + if self._buffer.have(amount): + return + self._expecting = amount + with self._wake_up: + if not self._wake_up.wait(timeout): + raise dns.exception.Timeout + self._expecting = 0 + + def receive(self, timeout=None): + expiration = self._expiration_from_timeout(timeout) + self.wait_for(2, expiration) + with self._lock: + (size,) = struct.unpack("!H", self._buffer.get(2)) + self.wait_for(size, expiration) + with self._lock: + return self._buffer.get(size) + + def send(self, datagram, is_end=False): + data = self._encapsulate(datagram) + self._connection.write(self._stream_id, data, is_end) + + def _add_input(self, data, is_end): + if self._common_add_input(data, is_end): + with self._wake_up: + self._wake_up.notify() + + def close(self): + with self._lock: + self._close() + + def __enter__(self): + return self + + def __exit__(self, exc_type, exc_val, exc_tb): + self.close() + with self._wake_up: + self._wake_up.notify() + return False + + +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) + if self._source is not None: + try: + self._socket.bind( + dns.inet.low_level_address_tuple(self._source, self._af) + ) + 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() + + def _read(self): + count = 0 + while count < 10: + count += 1 + try: + datagram = self._socket.recv(QUIC_MAX_DATAGRAM) + except BlockingIOError: + return + with self._lock: + self._connection.receive_datagram(datagram, self._peer, time.time()) + + def _drain_wakeup(self): + while True: + try: + self._receive_wakeup.recv(32) + except BlockingIOError: + return + + def _worker(self): + try: + sel = _selector_class() + sel.register(self._socket, selectors.EVENT_READ, self._read) + sel.register(self._receive_wakeup, selectors.EVENT_READ, self._drain_wakeup) + while not self._done: + (expiration, interval) = self._get_timer_values(False) + items = sel.select(interval) + for key, _ in items: + 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: + self._socket.send(datagram) + except BlockingIOError: + # we let QUIC handle any lossage + pass + finally: + with self._lock: + self._done = True + # Ensure anyone waiting for this gets woken up. + self._handshake_complete.set() + + def _handle_events(self): + while True: + with self._lock: + event = self._connection.next_event() + if event is None: + return + if isinstance(event, aioquic.quic.events.StreamDataReceived): + with self._lock: + stream = self._streams.get(event.stream_id) + if stream: + 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): + 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: + self._connection.send_stream_data(stream, data, is_end) + self._send_wakeup.send(b"\x01") + + def run(self): + if self._closed: + return + self._worker_thread = threading.Thread(target=self._worker) + self._worker_thread.start() + + def make_stream(self, timeout=None): + if not self._handshake_complete.wait(timeout): + raise dns.exception.Timeout + with self._lock: + if self._done: + raise UnexpectedEOF + stream_id = self._connection.get_next_available_stream_id(False) + stream = SyncQuicStream(self, stream_id) + self._streams[stream_id] = stream + return stream + + def close_stream(self, stream_id): + with self._lock: + super().close_stream(stream_id) + + def close(self): + with self._lock: + if self._closed: + return + self._manager.closed(self._peer[0], self._peer[1]) + self._closed = True + self._connection.close() + self._send_wakeup.send(b"\x01") + self._worker_thread.join() + + +class SyncQuicManager(BaseQuicManager): + def __init__(self, conf=None, verify_mode=ssl.CERT_REQUIRED, server_name=None): + super().__init__(conf, verify_mode, SyncQuicConnection, server_name) + self._lock = threading.Lock() + + 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, want_session_ticket + ) + if start: + connection.run() + return connection + + def closed(self, address, port): + 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 + + def __exit__(self, exc_type, exc_val, exc_tb): + # Copy the iterator into a list as exiting things will mutate the connections + # table. + connections = list(self._connections.values()) + for connection in connections: + connection.close() + return False diff --git a/.venv/lib/python3.12/site-packages/dns/quic/_trio.py b/.venv/lib/python3.12/site-packages/dns/quic/_trio.py new file mode 100644 index 0000000..35e36b9 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/quic/_trio.py @@ -0,0 +1,210 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +import socket +import ssl +import struct +import time + +import aioquic.quic.configuration # type: ignore +import aioquic.quic.connection # type: ignore +import aioquic.quic.events # type: ignore +import trio + +import dns.exception +import dns.inet +from dns._asyncbackend import NullContext +from dns.quic._common import ( + QUIC_MAX_DATAGRAM, + AsyncQuicConnection, + AsyncQuicManager, + BaseQuicStream, + UnexpectedEOF, +) + + +class TrioQuicStream(BaseQuicStream): + def __init__(self, connection, stream_id): + super().__init__(connection, stream_id) + self._wake_up = trio.Condition() + + async def wait_for(self, amount): + while True: + if self._buffer.have(amount): + return + self._expecting = amount + async with self._wake_up: + await self._wake_up.wait() + self._expecting = 0 + + async def receive(self, timeout=None): + if timeout is None: + context = NullContext(None) + else: + context = trio.move_on_after(timeout) + with context: + await self.wait_for(2) + (size,) = struct.unpack("!H", self._buffer.get(2)) + await self.wait_for(size) + return self._buffer.get(size) + raise dns.exception.Timeout + + async def send(self, datagram, is_end=False): + data = self._encapsulate(datagram) + await self._connection.write(self._stream_id, data, is_end) + + async def _add_input(self, data, is_end): + if self._common_add_input(data, is_end): + async with self._wake_up: + self._wake_up.notify() + + async def close(self): + self._close() + + # Streams are async context managers + + async def __aenter__(self): + return self + + async def __aexit__(self, exc_type, exc_val, exc_tb): + await self.close() + async with self._wake_up: + self._wake_up.notify() + return False + + +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) + 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, 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) + finally: + self._done = True + self._handshake_complete.set() + + async def _handle_events(self): + count = 0 + while True: + event = self._connection.next_event() + if event is None: + return + if isinstance(event, aioquic.quic.events.StreamDataReceived): + stream = self._streams.get(event.stream_id) + if stream: + 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): + 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 + count = 0 + await trio.sleep(0) + + 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() + + async def run(self): + if self._closed: + return + async with trio.open_nursery() as nursery: + nursery.start_soon(self._worker) + self._run_done.set() + + async def make_stream(self, timeout=None): + if timeout is None: + context = NullContext(None) + else: + context = trio.move_on_after(timeout) + with context: + await self._handshake_complete.wait() + if self._done: + raise UnexpectedEOF + stream_id = self._connection.get_next_available_stream_id(False) + stream = TrioQuicStream(self, stream_id) + self._streams[stream_id] = stream + return stream + raise dns.exception.Timeout + + async def close(self): + if not self._closed: + 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() + + +class TrioQuicManager(AsyncQuicManager): + def __init__( + self, nursery, conf=None, verify_mode=ssl.CERT_REQUIRED, server_name=None + ): + super().__init__(conf, verify_mode, TrioQuicConnection, server_name) + self._nursery = nursery + + 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 + + async def __aenter__(self): + return self + + async def __aexit__(self, exc_type, exc_val, exc_tb): + # Copy the iterator into a list as exiting things will mutate the connections + # table. + connections = list(self._connections.values()) + for connection in connections: + await connection.close() + return False diff --git a/.venv/lib/python3.12/site-packages/dns/rcode.py b/.venv/lib/python3.12/site-packages/dns/rcode.py new file mode 100644 index 0000000..8e6386f --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rcode.py @@ -0,0 +1,168 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2001-2017 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""DNS Result Codes.""" + +from typing import Tuple + +import dns.enum +import dns.exception + + +class Rcode(dns.enum.IntEnum): + #: No error + NOERROR = 0 + #: Format error + FORMERR = 1 + #: Server failure + SERVFAIL = 2 + #: Name does not exist ("Name Error" in RFC 1025 terminology). + NXDOMAIN = 3 + #: Not implemented + NOTIMP = 4 + #: Refused + REFUSED = 5 + #: Name exists. + YXDOMAIN = 6 + #: RRset exists. + YXRRSET = 7 + #: RRset does not exist. + NXRRSET = 8 + #: Not authoritative. + NOTAUTH = 9 + #: Name not in zone. + NOTZONE = 10 + #: DSO-TYPE Not Implemented + DSOTYPENI = 11 + #: Bad EDNS version. + BADVERS = 16 + #: TSIG Signature Failure + BADSIG = 16 + #: Key not recognized. + BADKEY = 17 + #: Signature out of time window. + BADTIME = 18 + #: Bad TKEY Mode. + BADMODE = 19 + #: Duplicate key name. + BADNAME = 20 + #: Algorithm not supported. + BADALG = 21 + #: Bad Truncation + BADTRUNC = 22 + #: Bad/missing Server Cookie + BADCOOKIE = 23 + + @classmethod + def _maximum(cls): + return 4095 + + @classmethod + def _unknown_exception_class(cls): + return UnknownRcode + + +class UnknownRcode(dns.exception.DNSException): + """A DNS rcode is unknown.""" + + +def from_text(text: str) -> Rcode: + """Convert text into an rcode. + + *text*, a ``str``, the textual rcode or an integer in textual form. + + Raises ``dns.rcode.UnknownRcode`` if the rcode mnemonic is unknown. + + Returns a ``dns.rcode.Rcode``. + """ + + return Rcode.from_text(text) + + +def from_flags(flags: int, ednsflags: int) -> Rcode: + """Return the rcode value encoded by flags and ednsflags. + + *flags*, an ``int``, the DNS flags field. + + *ednsflags*, an ``int``, the EDNS flags field. + + Raises ``ValueError`` if rcode is < 0 or > 4095 + + Returns a ``dns.rcode.Rcode``. + """ + + value = (flags & 0x000F) | ((ednsflags >> 20) & 0xFF0) + return Rcode.make(value) + + +def to_flags(value: Rcode) -> Tuple[int, int]: + """Return a (flags, ednsflags) tuple which encodes the rcode. + + *value*, a ``dns.rcode.Rcode``, the rcode. + + Raises ``ValueError`` if rcode is < 0 or > 4095. + + Returns an ``(int, int)`` tuple. + """ + + if value < 0 or value > 4095: + raise ValueError("rcode must be >= 0 and <= 4095") + v = value & 0xF + ev = (value & 0xFF0) << 20 + return (v, ev) + + +def to_text(value: Rcode, tsig: bool = False) -> str: + """Convert rcode into text. + + *value*, a ``dns.rcode.Rcode``, the rcode. + + Raises ``ValueError`` if rcode is < 0 or > 4095. + + Returns a ``str``. + """ + + if tsig and value == Rcode.BADVERS: + return "BADSIG" + return Rcode.to_text(value) + + +### BEGIN generated Rcode constants + +NOERROR = Rcode.NOERROR +FORMERR = Rcode.FORMERR +SERVFAIL = Rcode.SERVFAIL +NXDOMAIN = Rcode.NXDOMAIN +NOTIMP = Rcode.NOTIMP +REFUSED = Rcode.REFUSED +YXDOMAIN = Rcode.YXDOMAIN +YXRRSET = Rcode.YXRRSET +NXRRSET = Rcode.NXRRSET +NOTAUTH = Rcode.NOTAUTH +NOTZONE = Rcode.NOTZONE +DSOTYPENI = Rcode.DSOTYPENI +BADVERS = Rcode.BADVERS +BADSIG = Rcode.BADSIG +BADKEY = Rcode.BADKEY +BADTIME = Rcode.BADTIME +BADMODE = Rcode.BADMODE +BADNAME = Rcode.BADNAME +BADALG = Rcode.BADALG +BADTRUNC = Rcode.BADTRUNC +BADCOOKIE = Rcode.BADCOOKIE + +### END generated Rcode constants diff --git a/.venv/lib/python3.12/site-packages/dns/rdata.py b/.venv/lib/python3.12/site-packages/dns/rdata.py new file mode 100644 index 0000000..024fd8f --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdata.py @@ -0,0 +1,884 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2001-2017 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""DNS rdata.""" + +import base64 +import binascii +import inspect +import io +import itertools +import random +from importlib import import_module +from typing import Any, Dict, Optional, Tuple, Union + +import dns.exception +import dns.immutable +import dns.ipv4 +import dns.ipv6 +import dns.name +import dns.rdataclass +import dns.rdatatype +import dns.tokenizer +import dns.ttl +import dns.wire + +_chunksize = 32 + +# We currently allow comparisons for rdata with relative names for backwards +# compatibility, but in the future we will not, as these kinds of comparisons +# can lead to subtle bugs if code is not carefully written. +# +# This switch allows the future behavior to be turned on so code can be +# tested with it. +_allow_relative_comparisons = True + + +class NoRelativeRdataOrdering(dns.exception.DNSException): + """An attempt was made to do an ordered comparison of one or more + rdata with relative names. The only reliable way of sorting rdata + is to use non-relativized rdata. + + """ + + +def _wordbreak(data, chunksize=_chunksize, separator=b" "): + """Break a binary string into chunks of chunksize characters separated by + a space. + """ + + if not chunksize: + return data.decode() + return separator.join( + [data[i : i + chunksize] for i in range(0, len(data), chunksize)] + ).decode() + + +# pylint: disable=unused-argument + + +def _hexify(data, chunksize=_chunksize, separator=b" ", **kw): + """Convert a binary string into its hex encoding, broken up into chunks + of chunksize characters separated by a separator. + """ + + return _wordbreak(binascii.hexlify(data), chunksize, separator) + + +def _base64ify(data, chunksize=_chunksize, separator=b" ", **kw): + """Convert a binary string into its base64 encoding, broken up into chunks + of chunksize characters separated by a separator. + """ + + return _wordbreak(base64.b64encode(data), chunksize, separator) + + +# pylint: enable=unused-argument + +__escaped = b'"\\' + + +def _escapify(qstring): + """Escape the characters in a quoted string which need it.""" + + if isinstance(qstring, str): + qstring = qstring.encode() + if not isinstance(qstring, bytearray): + qstring = bytearray(qstring) + + text = "" + for c in qstring: + if c in __escaped: + text += "\\" + chr(c) + elif c >= 0x20 and c < 0x7F: + text += chr(c) + else: + text += "\\%03d" % c + return text + + +def _truncate_bitmap(what): + """Determine the index of greatest byte that isn't all zeros, and + return the bitmap that contains all the bytes less than that index. + """ + + for i in range(len(what) - 1, -1, -1): + if what[i] != 0: + return what[0 : i + 1] + return what[0:1] + + +# So we don't have to edit all the rdata classes... +_constify = dns.immutable.constify + + +@dns.immutable.immutable +class Rdata: + """Base class for all DNS rdata types.""" + + __slots__ = ["rdclass", "rdtype", "rdcomment"] + + def __init__(self, rdclass, rdtype): + """Initialize an rdata. + + *rdclass*, an ``int`` is the rdataclass of the Rdata. + + *rdtype*, an ``int`` is the rdatatype of the Rdata. + """ + + self.rdclass = self._as_rdataclass(rdclass) + self.rdtype = self._as_rdatatype(rdtype) + self.rdcomment = None + + def _get_all_slots(self): + return itertools.chain.from_iterable( + getattr(cls, "__slots__", []) for cls in self.__class__.__mro__ + ) + + def __getstate__(self): + # We used to try to do a tuple of all slots here, but it + # doesn't work as self._all_slots isn't available at + # __setstate__() time. Before that we tried to store a tuple + # of __slots__, but that didn't work as it didn't store the + # slots defined by ancestors. This older way didn't fail + # outright, but ended up with partially broken objects, e.g. + # if you unpickled an A RR it wouldn't have rdclass and rdtype + # attributes, and would compare badly. + state = {} + for slot in self._get_all_slots(): + state[slot] = getattr(self, slot) + return state + + def __setstate__(self, state): + for slot, val in state.items(): + object.__setattr__(self, slot, val) + if not hasattr(self, "rdcomment"): + # Pickled rdata from 2.0.x might not have a rdcomment, so add + # it if needed. + object.__setattr__(self, "rdcomment", None) + + def covers(self) -> dns.rdatatype.RdataType: + """Return the type a Rdata covers. + + DNS SIG/RRSIG rdatas apply to a specific type; this type is + returned by the covers() function. If the rdata type is not + SIG or RRSIG, dns.rdatatype.NONE is returned. This is useful when + creating rdatasets, allowing the rdataset to contain only RRSIGs + of a particular type, e.g. RRSIG(NS). + + Returns a ``dns.rdatatype.RdataType``. + """ + + return dns.rdatatype.NONE + + def extended_rdatatype(self) -> int: + """Return a 32-bit type value, the least significant 16 bits of + which are the ordinary DNS type, and the upper 16 bits of which are + the "covered" type, if any. + + Returns an ``int``. + """ + + return self.covers() << 16 | self.rdtype + + def to_text( + self, + origin: Optional[dns.name.Name] = None, + relativize: bool = True, + **kw: Dict[str, Any], + ) -> str: + """Convert an rdata to text format. + + Returns a ``str``. + """ + + raise NotImplementedError # pragma: no cover + + def _to_wire( + self, + file: Optional[Any], + compress: Optional[dns.name.CompressType] = None, + origin: Optional[dns.name.Name] = None, + canonicalize: bool = False, + ) -> bytes: + raise NotImplementedError # pragma: no cover + + def to_wire( + self, + file: Optional[Any] = None, + compress: Optional[dns.name.CompressType] = None, + origin: Optional[dns.name.Name] = None, + canonicalize: bool = False, + ) -> bytes: + """Convert an rdata to wire format. + + Returns a ``bytes`` or ``None``. + """ + + if file: + return self._to_wire(file, compress, origin, canonicalize) + else: + f = io.BytesIO() + self._to_wire(f, compress, origin, canonicalize) + return f.getvalue() + + def to_generic( + self, origin: Optional[dns.name.Name] = None + ) -> "dns.rdata.GenericRdata": + """Creates a dns.rdata.GenericRdata equivalent of this rdata. + + Returns a ``dns.rdata.GenericRdata``. + """ + return dns.rdata.GenericRdata( + self.rdclass, self.rdtype, self.to_wire(origin=origin) + ) + + def to_digestable(self, origin: Optional[dns.name.Name] = None) -> bytes: + """Convert rdata to a format suitable for digesting in hashes. This + is also the DNSSEC canonical form. + + Returns a ``bytes``. + """ + + return self.to_wire(origin=origin, canonicalize=True) + + def __repr__(self): + covers = self.covers() + if covers == dns.rdatatype.NONE: + ctext = "" + else: + ctext = "(" + dns.rdatatype.to_text(covers) + ")" + return ( + "" + ) + + def __str__(self): + return self.to_text() + + def _cmp(self, other): + """Compare an rdata with another rdata of the same rdtype and + rdclass. + + For rdata with only absolute names: + Return < 0 if self < other in the DNSSEC ordering, 0 if self + == other, and > 0 if self > other. + For rdata with at least one relative names: + The rdata sorts before any rdata with only absolute names. + When compared with another relative rdata, all names are + made absolute as if they were relative to the root, as the + proper origin is not available. While this creates a stable + ordering, it is NOT guaranteed to be the DNSSEC ordering. + In the future, all ordering comparisons for rdata with + relative names will be disallowed. + """ + try: + our = self.to_digestable() + our_relative = False + except dns.name.NeedAbsoluteNameOrOrigin: + if _allow_relative_comparisons: + our = self.to_digestable(dns.name.root) + our_relative = True + try: + their = other.to_digestable() + their_relative = False + except dns.name.NeedAbsoluteNameOrOrigin: + if _allow_relative_comparisons: + their = other.to_digestable(dns.name.root) + their_relative = True + if _allow_relative_comparisons: + if our_relative != their_relative: + # For the purpose of comparison, all rdata with at least one + # relative name is less than an rdata with only absolute names. + if our_relative: + return -1 + else: + return 1 + elif our_relative or their_relative: + raise NoRelativeRdataOrdering + if our == their: + return 0 + elif our > their: + return 1 + else: + return -1 + + def __eq__(self, other): + if not isinstance(other, Rdata): + return False + if self.rdclass != other.rdclass or self.rdtype != other.rdtype: + return False + our_relative = False + their_relative = False + try: + our = self.to_digestable() + except dns.name.NeedAbsoluteNameOrOrigin: + our = self.to_digestable(dns.name.root) + our_relative = True + try: + their = other.to_digestable() + except dns.name.NeedAbsoluteNameOrOrigin: + their = other.to_digestable(dns.name.root) + their_relative = True + if our_relative != their_relative: + return False + return our == their + + def __ne__(self, other): + if not isinstance(other, Rdata): + return True + if self.rdclass != other.rdclass or self.rdtype != other.rdtype: + return True + return not self.__eq__(other) + + def __lt__(self, other): + if ( + not isinstance(other, Rdata) + or self.rdclass != other.rdclass + or self.rdtype != other.rdtype + ): + return NotImplemented + return self._cmp(other) < 0 + + def __le__(self, other): + if ( + not isinstance(other, Rdata) + or self.rdclass != other.rdclass + or self.rdtype != other.rdtype + ): + return NotImplemented + return self._cmp(other) <= 0 + + def __ge__(self, other): + if ( + not isinstance(other, Rdata) + or self.rdclass != other.rdclass + or self.rdtype != other.rdtype + ): + return NotImplemented + return self._cmp(other) >= 0 + + def __gt__(self, other): + if ( + not isinstance(other, Rdata) + or self.rdclass != other.rdclass + or self.rdtype != other.rdtype + ): + return NotImplemented + return self._cmp(other) > 0 + + def __hash__(self): + return hash(self.to_digestable(dns.name.root)) + + @classmethod + def from_text( + cls, + rdclass: dns.rdataclass.RdataClass, + rdtype: dns.rdatatype.RdataType, + tok: dns.tokenizer.Tokenizer, + origin: Optional[dns.name.Name] = None, + relativize: bool = True, + relativize_to: Optional[dns.name.Name] = None, + ) -> "Rdata": + raise NotImplementedError # pragma: no cover + + @classmethod + def from_wire_parser( + cls, + rdclass: dns.rdataclass.RdataClass, + rdtype: dns.rdatatype.RdataType, + parser: dns.wire.Parser, + origin: Optional[dns.name.Name] = None, + ) -> "Rdata": + raise NotImplementedError # pragma: no cover + + def replace(self, **kwargs: Any) -> "Rdata": + """ + Create a new Rdata instance based on the instance replace was + invoked on. It is possible to pass different parameters to + override the corresponding properties of the base Rdata. + + Any field specific to the Rdata type can be replaced, but the + *rdtype* and *rdclass* fields cannot. + + Returns an instance of the same Rdata subclass as *self*. + """ + + # Get the constructor parameters. + parameters = inspect.signature(self.__init__).parameters # type: ignore + + # Ensure that all of the arguments correspond to valid fields. + # Don't allow rdclass or rdtype to be changed, though. + for key in kwargs: + if key == "rdcomment": + continue + if key not in parameters: + raise AttributeError( + "'{}' object has no attribute '{}'".format( + self.__class__.__name__, key + ) + ) + if key in ("rdclass", "rdtype"): + raise AttributeError( + "Cannot overwrite '{}' attribute '{}'".format( + self.__class__.__name__, key + ) + ) + + # Construct the parameter list. For each field, use the value in + # kwargs if present, and the current value otherwise. + args = (kwargs.get(key, getattr(self, key)) for key in parameters) + + # Create, validate, and return the new object. + rd = self.__class__(*args) + # The comment is not set in the constructor, so give it special + # handling. + rdcomment = kwargs.get("rdcomment", self.rdcomment) + if rdcomment is not None: + object.__setattr__(rd, "rdcomment", rdcomment) + return rd + + # Type checking and conversion helpers. These are class methods as + # they don't touch object state and may be useful to others. + + @classmethod + def _as_rdataclass(cls, value): + return dns.rdataclass.RdataClass.make(value) + + @classmethod + def _as_rdatatype(cls, value): + return dns.rdatatype.RdataType.make(value) + + @classmethod + def _as_bytes( + cls, + value: Any, + encode: bool = False, + max_length: Optional[int] = None, + empty_ok: bool = True, + ) -> bytes: + if encode and isinstance(value, str): + bvalue = value.encode() + elif isinstance(value, bytearray): + bvalue = bytes(value) + elif isinstance(value, bytes): + bvalue = value + else: + raise ValueError("not bytes") + if max_length is not None and len(bvalue) > max_length: + raise ValueError("too long") + if not empty_ok and len(bvalue) == 0: + raise ValueError("empty bytes not allowed") + return bvalue + + @classmethod + def _as_name(cls, value): + # Note that proper name conversion (e.g. with origin and IDNA + # awareness) is expected to be done via from_text. This is just + # a simple thing for people invoking the constructor directly. + if isinstance(value, str): + return dns.name.from_text(value) + elif not isinstance(value, dns.name.Name): + raise ValueError("not a name") + return value + + @classmethod + def _as_uint8(cls, value): + if not isinstance(value, int): + raise ValueError("not an integer") + if value < 0 or value > 255: + raise ValueError("not a uint8") + return value + + @classmethod + def _as_uint16(cls, value): + if not isinstance(value, int): + raise ValueError("not an integer") + if value < 0 or value > 65535: + raise ValueError("not a uint16") + return value + + @classmethod + def _as_uint32(cls, value): + if not isinstance(value, int): + raise ValueError("not an integer") + if value < 0 or value > 4294967295: + raise ValueError("not a uint32") + return value + + @classmethod + def _as_uint48(cls, value): + if not isinstance(value, int): + raise ValueError("not an integer") + if value < 0 or value > 281474976710655: + raise ValueError("not a uint48") + return value + + @classmethod + def _as_int(cls, value, low=None, high=None): + if not isinstance(value, int): + raise ValueError("not an integer") + if low is not None and value < low: + raise ValueError("value too small") + if high is not None and value > high: + raise ValueError("value too large") + return value + + @classmethod + def _as_ipv4_address(cls, value): + if isinstance(value, str): + return dns.ipv4.canonicalize(value) + elif isinstance(value, bytes): + return dns.ipv4.inet_ntoa(value) + else: + raise ValueError("not an IPv4 address") + + @classmethod + def _as_ipv6_address(cls, value): + if isinstance(value, str): + return dns.ipv6.canonicalize(value) + elif isinstance(value, bytes): + return dns.ipv6.inet_ntoa(value) + else: + raise ValueError("not an IPv6 address") + + @classmethod + def _as_bool(cls, value): + if isinstance(value, bool): + return value + else: + raise ValueError("not a boolean") + + @classmethod + def _as_ttl(cls, value): + if isinstance(value, int): + return cls._as_int(value, 0, dns.ttl.MAX_TTL) + elif isinstance(value, str): + return dns.ttl.from_text(value) + else: + raise ValueError("not a TTL") + + @classmethod + def _as_tuple(cls, value, as_value): + try: + # For user convenience, if value is a singleton of the list + # element type, wrap it in a tuple. + return (as_value(value),) + except Exception: + # Otherwise, check each element of the iterable *value* + # against *as_value*. + return tuple(as_value(v) for v in value) + + # Processing order + + @classmethod + def _processing_order(cls, iterable): + items = list(iterable) + random.shuffle(items) + return items + + +@dns.immutable.immutable +class GenericRdata(Rdata): + """Generic Rdata Class + + This class is used for rdata types for which we have no better + implementation. It implements the DNS "unknown RRs" scheme. + """ + + __slots__ = ["data"] + + def __init__(self, rdclass, rdtype, data): + super().__init__(rdclass, rdtype) + self.data = data + + def to_text( + self, + origin: Optional[dns.name.Name] = None, + relativize: bool = True, + **kw: Dict[str, Any], + ) -> str: + return r"\# %d " % len(self.data) + _hexify(self.data, **kw) + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + token = tok.get() + if not token.is_identifier() or token.value != r"\#": + raise dns.exception.SyntaxError(r"generic rdata does not start with \#") + length = tok.get_int() + hex = tok.concatenate_remaining_identifiers(True).encode() + data = binascii.unhexlify(hex) + if len(data) != length: + raise dns.exception.SyntaxError("generic rdata hex data has wrong length") + return cls(rdclass, rdtype, data) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + file.write(self.data) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + return cls(rdclass, rdtype, parser.get_remaining()) + + +_rdata_classes: Dict[Tuple[dns.rdataclass.RdataClass, dns.rdatatype.RdataType], Any] = ( + {} +) +_module_prefix = "dns.rdtypes" + + +def get_rdata_class(rdclass, rdtype): + cls = _rdata_classes.get((rdclass, rdtype)) + if not cls: + cls = _rdata_classes.get((dns.rdatatype.ANY, rdtype)) + if not cls: + rdclass_text = dns.rdataclass.to_text(rdclass) + rdtype_text = dns.rdatatype.to_text(rdtype) + rdtype_text = rdtype_text.replace("-", "_") + try: + mod = import_module( + ".".join([_module_prefix, rdclass_text, rdtype_text]) + ) + cls = getattr(mod, rdtype_text) + _rdata_classes[(rdclass, rdtype)] = cls + except ImportError: + try: + mod = import_module(".".join([_module_prefix, "ANY", rdtype_text])) + cls = getattr(mod, rdtype_text) + _rdata_classes[(dns.rdataclass.ANY, rdtype)] = cls + _rdata_classes[(rdclass, rdtype)] = cls + except ImportError: + pass + if not cls: + cls = GenericRdata + _rdata_classes[(rdclass, rdtype)] = cls + return cls + + +def from_text( + rdclass: Union[dns.rdataclass.RdataClass, str], + rdtype: Union[dns.rdatatype.RdataType, str], + tok: Union[dns.tokenizer.Tokenizer, str], + origin: Optional[dns.name.Name] = None, + relativize: bool = True, + relativize_to: Optional[dns.name.Name] = None, + idna_codec: Optional[dns.name.IDNACodec] = None, +) -> Rdata: + """Build an rdata object from text format. + + This function attempts to dynamically load a class which + implements the specified rdata class and type. If there is no + class-and-type-specific implementation, the GenericRdata class + is used. + + Once a class is chosen, its from_text() class method is called + with the parameters to this function. + + If *tok* is a ``str``, then a tokenizer is created and the string + is used as its input. + + *rdclass*, a ``dns.rdataclass.RdataClass`` or ``str``, the rdataclass. + + *rdtype*, a ``dns.rdatatype.RdataType`` or ``str``, the rdatatype. + + *tok*, a ``dns.tokenizer.Tokenizer`` or a ``str``. + + *origin*, a ``dns.name.Name`` (or ``None``), the + origin to use for relative names. + + *relativize*, a ``bool``. If true, name will be relativized. + + *relativize_to*, a ``dns.name.Name`` (or ``None``), the origin to use + when relativizing names. If not set, the *origin* value will be used. + + *idna_codec*, a ``dns.name.IDNACodec``, specifies the IDNA + encoder/decoder to use if a tokenizer needs to be created. If + ``None``, the default IDNA 2003 encoder/decoder is used. If a + tokenizer is not created, then the codec associated with the tokenizer + is the one that is used. + + Returns an instance of the chosen Rdata subclass. + + """ + if isinstance(tok, str): + tok = dns.tokenizer.Tokenizer(tok, idna_codec=idna_codec) + rdclass = dns.rdataclass.RdataClass.make(rdclass) + rdtype = dns.rdatatype.RdataType.make(rdtype) + cls = get_rdata_class(rdclass, rdtype) + with dns.exception.ExceptionWrapper(dns.exception.SyntaxError): + rdata = None + if cls != GenericRdata: + # peek at first token + token = tok.get() + tok.unget(token) + if token.is_identifier() and token.value == r"\#": + # + # Known type using the generic syntax. Extract the + # wire form from the generic syntax, and then run + # from_wire on it. + # + grdata = GenericRdata.from_text( + rdclass, rdtype, tok, origin, relativize, relativize_to + ) + rdata = from_wire( + rdclass, rdtype, grdata.data, 0, len(grdata.data), origin + ) + # + # If this comparison isn't equal, then there must have been + # compressed names in the wire format, which is an error, + # there being no reasonable context to decompress with. + # + rwire = rdata.to_wire() + if rwire != grdata.data: + raise dns.exception.SyntaxError( + "compressed data in " + "generic syntax form " + "of known rdatatype" + ) + if rdata is None: + rdata = cls.from_text( + rdclass, rdtype, tok, origin, relativize, relativize_to + ) + token = tok.get_eol_as_token() + if token.comment is not None: + object.__setattr__(rdata, "rdcomment", token.comment) + return rdata + + +def from_wire_parser( + rdclass: Union[dns.rdataclass.RdataClass, str], + rdtype: Union[dns.rdatatype.RdataType, str], + parser: dns.wire.Parser, + origin: Optional[dns.name.Name] = None, +) -> Rdata: + """Build an rdata object from wire format + + This function attempts to dynamically load a class which + implements the specified rdata class and type. If there is no + class-and-type-specific implementation, the GenericRdata class + is used. + + Once a class is chosen, its from_wire() class method is called + with the parameters to this function. + + *rdclass*, a ``dns.rdataclass.RdataClass`` or ``str``, the rdataclass. + + *rdtype*, a ``dns.rdatatype.RdataType`` or ``str``, the rdatatype. + + *parser*, a ``dns.wire.Parser``, the parser, which should be + restricted to the rdata length. + + *origin*, a ``dns.name.Name`` (or ``None``). If not ``None``, + then names will be relativized to this origin. + + Returns an instance of the chosen Rdata subclass. + """ + + rdclass = dns.rdataclass.RdataClass.make(rdclass) + rdtype = dns.rdatatype.RdataType.make(rdtype) + cls = get_rdata_class(rdclass, rdtype) + with dns.exception.ExceptionWrapper(dns.exception.FormError): + return cls.from_wire_parser(rdclass, rdtype, parser, origin) + + +def from_wire( + rdclass: Union[dns.rdataclass.RdataClass, str], + rdtype: Union[dns.rdatatype.RdataType, str], + wire: bytes, + current: int, + rdlen: int, + origin: Optional[dns.name.Name] = None, +) -> Rdata: + """Build an rdata object from wire format + + This function attempts to dynamically load a class which + implements the specified rdata class and type. If there is no + class-and-type-specific implementation, the GenericRdata class + is used. + + Once a class is chosen, its from_wire() class method is called + with the parameters to this function. + + *rdclass*, an ``int``, the rdataclass. + + *rdtype*, an ``int``, the rdatatype. + + *wire*, a ``bytes``, the wire-format message. + + *current*, an ``int``, the offset in wire of the beginning of + the rdata. + + *rdlen*, an ``int``, the length of the wire-format rdata + + *origin*, a ``dns.name.Name`` (or ``None``). If not ``None``, + then names will be relativized to this origin. + + Returns an instance of the chosen Rdata subclass. + """ + parser = dns.wire.Parser(wire, current) + with parser.restrict_to(rdlen): + return from_wire_parser(rdclass, rdtype, parser, origin) + + +class RdatatypeExists(dns.exception.DNSException): + """DNS rdatatype already exists.""" + + supp_kwargs = {"rdclass", "rdtype"} + fmt = ( + "The rdata type with class {rdclass:d} and rdtype {rdtype:d} " + + "already exists." + ) + + +def register_type( + implementation: Any, + rdtype: int, + rdtype_text: str, + is_singleton: bool = False, + rdclass: dns.rdataclass.RdataClass = dns.rdataclass.IN, +) -> None: + """Dynamically register a module to handle an rdatatype. + + *implementation*, a module implementing the type in the usual dnspython + way. + + *rdtype*, an ``int``, the rdatatype to register. + + *rdtype_text*, a ``str``, the textual form of the rdatatype. + + *is_singleton*, a ``bool``, indicating if the type is a singleton (i.e. + RRsets of the type can have only one member.) + + *rdclass*, the rdataclass of the type, or ``dns.rdataclass.ANY`` if + it applies to all classes. + """ + + rdtype = dns.rdatatype.RdataType.make(rdtype) + existing_cls = get_rdata_class(rdclass, rdtype) + if existing_cls != GenericRdata or dns.rdatatype.is_metatype(rdtype): + raise RdatatypeExists(rdclass=rdclass, rdtype=rdtype) + _rdata_classes[(rdclass, rdtype)] = getattr( + implementation, rdtype_text.replace("-", "_") + ) + dns.rdatatype.register_type(rdtype, rdtype_text, is_singleton) diff --git a/.venv/lib/python3.12/site-packages/dns/rdataclass.py b/.venv/lib/python3.12/site-packages/dns/rdataclass.py new file mode 100644 index 0000000..89b85a7 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdataclass.py @@ -0,0 +1,118 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2001-2017 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""DNS Rdata Classes.""" + +import dns.enum +import dns.exception + + +class RdataClass(dns.enum.IntEnum): + """DNS Rdata Class""" + + RESERVED0 = 0 + IN = 1 + INTERNET = IN + CH = 3 + CHAOS = CH + HS = 4 + HESIOD = HS + NONE = 254 + ANY = 255 + + @classmethod + def _maximum(cls): + return 65535 + + @classmethod + def _short_name(cls): + return "class" + + @classmethod + def _prefix(cls): + return "CLASS" + + @classmethod + def _unknown_exception_class(cls): + return UnknownRdataclass + + +_metaclasses = {RdataClass.NONE, RdataClass.ANY} + + +class UnknownRdataclass(dns.exception.DNSException): + """A DNS class is unknown.""" + + +def from_text(text: str) -> RdataClass: + """Convert text into a DNS rdata class value. + + The input text can be a defined DNS RR class mnemonic or + instance of the DNS generic class syntax. + + For example, "IN" and "CLASS1" will both result in a value of 1. + + Raises ``dns.rdatatype.UnknownRdataclass`` if the class is unknown. + + Raises ``ValueError`` if the rdata class value is not >= 0 and <= 65535. + + Returns a ``dns.rdataclass.RdataClass``. + """ + + return RdataClass.from_text(text) + + +def to_text(value: RdataClass) -> str: + """Convert a DNS rdata class value to text. + + If the value has a known mnemonic, it will be used, otherwise the + DNS generic class syntax will be used. + + Raises ``ValueError`` if the rdata class value is not >= 0 and <= 65535. + + Returns a ``str``. + """ + + return RdataClass.to_text(value) + + +def is_metaclass(rdclass: RdataClass) -> bool: + """True if the specified class is a metaclass. + + The currently defined metaclasses are ANY and NONE. + + *rdclass* is a ``dns.rdataclass.RdataClass``. + """ + + if rdclass in _metaclasses: + return True + return False + + +### BEGIN generated RdataClass constants + +RESERVED0 = RdataClass.RESERVED0 +IN = RdataClass.IN +INTERNET = RdataClass.INTERNET +CH = RdataClass.CH +CHAOS = RdataClass.CHAOS +HS = RdataClass.HS +HESIOD = RdataClass.HESIOD +NONE = RdataClass.NONE +ANY = RdataClass.ANY + +### END generated RdataClass constants diff --git a/.venv/lib/python3.12/site-packages/dns/rdataset.py b/.venv/lib/python3.12/site-packages/dns/rdataset.py new file mode 100644 index 0000000..8bff58d --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdataset.py @@ -0,0 +1,516 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2001-2017 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""DNS rdatasets (an rdataset is a set of rdatas of a given type and class)""" + +import io +import random +import struct +from typing import Any, Collection, Dict, List, Optional, Union, cast + +import dns.exception +import dns.immutable +import dns.name +import dns.rdata +import dns.rdataclass +import dns.rdatatype +import dns.renderer +import dns.set +import dns.ttl + +# define SimpleSet here for backwards compatibility +SimpleSet = dns.set.Set + + +class DifferingCovers(dns.exception.DNSException): + """An attempt was made to add a DNS SIG/RRSIG whose covered type + is not the same as that of the other rdatas in the rdataset.""" + + +class IncompatibleTypes(dns.exception.DNSException): + """An attempt was made to add DNS RR data of an incompatible type.""" + + +class Rdataset(dns.set.Set): + """A DNS rdataset.""" + + __slots__ = ["rdclass", "rdtype", "covers", "ttl"] + + def __init__( + self, + rdclass: dns.rdataclass.RdataClass, + rdtype: dns.rdatatype.RdataType, + covers: dns.rdatatype.RdataType = dns.rdatatype.NONE, + ttl: int = 0, + ): + """Create a new rdataset of the specified class and type. + + *rdclass*, a ``dns.rdataclass.RdataClass``, the rdataclass. + + *rdtype*, an ``dns.rdatatype.RdataType``, the rdatatype. + + *covers*, an ``dns.rdatatype.RdataType``, the covered rdatatype. + + *ttl*, an ``int``, the TTL. + """ + + super().__init__() + self.rdclass = rdclass + self.rdtype: dns.rdatatype.RdataType = rdtype + self.covers: dns.rdatatype.RdataType = covers + self.ttl = ttl + + def _clone(self): + obj = super()._clone() + obj.rdclass = self.rdclass + obj.rdtype = self.rdtype + obj.covers = self.covers + obj.ttl = self.ttl + return obj + + def update_ttl(self, ttl: int) -> None: + """Perform TTL minimization. + + Set the TTL of the rdataset to be the lesser of the set's current + TTL or the specified TTL. If the set contains no rdatas, set the TTL + to the specified TTL. + + *ttl*, an ``int`` or ``str``. + """ + ttl = dns.ttl.make(ttl) + if len(self) == 0: + self.ttl = ttl + elif ttl < self.ttl: + self.ttl = ttl + + def add( # pylint: disable=arguments-differ,arguments-renamed + self, rd: dns.rdata.Rdata, ttl: Optional[int] = None + ) -> None: + """Add the specified rdata to the rdataset. + + If the optional *ttl* parameter is supplied, then + ``self.update_ttl(ttl)`` will be called prior to adding the rdata. + + *rd*, a ``dns.rdata.Rdata``, the rdata + + *ttl*, an ``int``, the TTL. + + Raises ``dns.rdataset.IncompatibleTypes`` if the type and class + do not match the type and class of the rdataset. + + Raises ``dns.rdataset.DifferingCovers`` if the type is a signature + type and the covered type does not match that of the rdataset. + """ + + # + # If we're adding a signature, do some special handling to + # check that the signature covers the same type as the + # other rdatas in this rdataset. If this is the first rdata + # in the set, initialize the covers field. + # + if self.rdclass != rd.rdclass or self.rdtype != rd.rdtype: + raise IncompatibleTypes + if ttl is not None: + self.update_ttl(ttl) + if self.rdtype == dns.rdatatype.RRSIG or self.rdtype == dns.rdatatype.SIG: + covers = rd.covers() + if len(self) == 0 and self.covers == dns.rdatatype.NONE: + self.covers = covers + elif self.covers != covers: + raise DifferingCovers + if dns.rdatatype.is_singleton(rd.rdtype) and len(self) > 0: + self.clear() + super().add(rd) + + def union_update(self, other): + self.update_ttl(other.ttl) + super().union_update(other) + + def intersection_update(self, other): + self.update_ttl(other.ttl) + super().intersection_update(other) + + def update(self, other): + """Add all rdatas in other to self. + + *other*, a ``dns.rdataset.Rdataset``, the rdataset from which + to update. + """ + + self.update_ttl(other.ttl) + super().update(other) + + def _rdata_repr(self): + def maybe_truncate(s): + if len(s) > 100: + return s[:100] + "..." + return s + + return "[%s]" % ", ".join("<%s>" % maybe_truncate(str(rr)) for rr in self) + + def __repr__(self): + if self.covers == 0: + ctext = "" + else: + ctext = "(" + dns.rdatatype.to_text(self.covers) + ")" + return ( + "" + ) + + def __str__(self): + return self.to_text() + + def __eq__(self, other): + if not isinstance(other, Rdataset): + return False + if ( + self.rdclass != other.rdclass + or self.rdtype != other.rdtype + or self.covers != other.covers + ): + return False + return super().__eq__(other) + + def __ne__(self, other): + return not self.__eq__(other) + + def to_text( + self, + name: Optional[dns.name.Name] = None, + origin: Optional[dns.name.Name] = None, + relativize: bool = True, + override_rdclass: Optional[dns.rdataclass.RdataClass] = None, + want_comments: bool = False, + **kw: Dict[str, Any], + ) -> str: + """Convert the rdataset into DNS zone file format. + + See ``dns.name.Name.choose_relativity`` for more information + on how *origin* and *relativize* determine the way names + are emitted. + + Any additional keyword arguments are passed on to the rdata + ``to_text()`` method. + + *name*, a ``dns.name.Name``. If name is not ``None``, emit RRs with + *name* as the owner name. + + *origin*, a ``dns.name.Name`` or ``None``, the origin for relative + names. + + *relativize*, a ``bool``. If ``True``, names will be relativized + to *origin*. + + *override_rdclass*, a ``dns.rdataclass.RdataClass`` or ``None``. + If not ``None``, use this class instead of the Rdataset's class. + + *want_comments*, a ``bool``. If ``True``, emit comments for rdata + which have them. The default is ``False``. + """ + + if name is not None: + name = name.choose_relativity(origin, relativize) + ntext = str(name) + pad = " " + else: + ntext = "" + pad = "" + s = io.StringIO() + if override_rdclass is not None: + rdclass = override_rdclass + else: + rdclass = self.rdclass + if len(self) == 0: + # + # Empty rdatasets are used for the question section, and in + # some dynamic updates, so we don't need to print out the TTL + # (which is meaningless anyway). + # + s.write( + "{}{}{} {}\n".format( + ntext, + pad, + dns.rdataclass.to_text(rdclass), + dns.rdatatype.to_text(self.rdtype), + ) + ) + else: + for rd in self: + extra = "" + if want_comments: + if rd.rdcomment: + extra = f" ;{rd.rdcomment}" + s.write( + "%s%s%d %s %s %s%s\n" + % ( + ntext, + pad, + self.ttl, + dns.rdataclass.to_text(rdclass), + dns.rdatatype.to_text(self.rdtype), + rd.to_text(origin=origin, relativize=relativize, **kw), + extra, + ) + ) + # + # We strip off the final \n for the caller's convenience in printing + # + return s.getvalue()[:-1] + + def to_wire( + self, + name: dns.name.Name, + file: Any, + compress: Optional[dns.name.CompressType] = None, + origin: Optional[dns.name.Name] = None, + override_rdclass: Optional[dns.rdataclass.RdataClass] = None, + want_shuffle: bool = True, + ) -> int: + """Convert the rdataset to wire format. + + *name*, a ``dns.name.Name`` is the owner name to use. + + *file* is the file where the name is emitted (typically a + BytesIO file). + + *compress*, a ``dict``, is the compression table to use. If + ``None`` (the default), names will not be compressed. + + *origin* is a ``dns.name.Name`` or ``None``. If the name is + relative and origin is not ``None``, then *origin* will be appended + to it. + + *override_rdclass*, an ``int``, is used as the class instead of the + class of the rdataset. This is useful when rendering rdatasets + associated with dynamic updates. + + *want_shuffle*, a ``bool``. If ``True``, then the order of the + Rdatas within the Rdataset will be shuffled before rendering. + + Returns an ``int``, the number of records emitted. + """ + + if override_rdclass is not None: + rdclass = override_rdclass + want_shuffle = False + else: + rdclass = self.rdclass + if len(self) == 0: + name.to_wire(file, compress, origin) + file.write(struct.pack("!HHIH", self.rdtype, rdclass, 0, 0)) + return 1 + else: + l: Union[Rdataset, List[dns.rdata.Rdata]] + if want_shuffle: + l = list(self) + random.shuffle(l) + else: + l = self + for rd in l: + name.to_wire(file, compress, origin) + 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( + self, + rdclass: dns.rdataclass.RdataClass, + rdtype: dns.rdatatype.RdataType, + covers: dns.rdatatype.RdataType, + ) -> bool: + """Returns ``True`` if this rdataset matches the specified class, + type, and covers. + """ + if self.rdclass == rdclass and self.rdtype == rdtype and self.covers == covers: + return True + return False + + def processing_order(self) -> List[dns.rdata.Rdata]: + """Return rdatas in a valid processing order according to the type's + specification. For example, MX records are in preference order from + lowest to highest preferences, with items of the same preference + shuffled. + + For types that do not define a processing order, the rdatas are + simply shuffled. + """ + if len(self) == 0: + return [] + else: + return self[0]._processing_order(iter(self)) + + +@dns.immutable.immutable +class ImmutableRdataset(Rdataset): # lgtm[py/missing-equals] + """An immutable DNS rdataset.""" + + _clone_class = Rdataset + + def __init__(self, rdataset: Rdataset): + """Create an immutable rdataset from the specified rdataset.""" + + super().__init__( + rdataset.rdclass, rdataset.rdtype, rdataset.covers, rdataset.ttl + ) + self.items = dns.immutable.Dict(rdataset.items) + + def update_ttl(self, ttl): + raise TypeError("immutable") + + def add(self, rd, ttl=None): + raise TypeError("immutable") + + def union_update(self, other): + raise TypeError("immutable") + + def intersection_update(self, other): + raise TypeError("immutable") + + def update(self, other): + raise TypeError("immutable") + + def __delitem__(self, i): + raise TypeError("immutable") + + # lgtm complains about these not raising ArithmeticError, but there is + # precedent for overrides of these methods in other classes to raise + # TypeError, and it seems like the better exception. + + def __ior__(self, other): # lgtm[py/unexpected-raise-in-special-method] + raise TypeError("immutable") + + def __iand__(self, other): # lgtm[py/unexpected-raise-in-special-method] + raise TypeError("immutable") + + def __iadd__(self, other): # lgtm[py/unexpected-raise-in-special-method] + raise TypeError("immutable") + + def __isub__(self, other): # lgtm[py/unexpected-raise-in-special-method] + raise TypeError("immutable") + + def clear(self): + raise TypeError("immutable") + + def __copy__(self): + return ImmutableRdataset(super().copy()) + + def copy(self): + return ImmutableRdataset(super().copy()) + + def union(self, other): + return ImmutableRdataset(super().union(other)) + + def intersection(self, other): + return ImmutableRdataset(super().intersection(other)) + + def difference(self, other): + return ImmutableRdataset(super().difference(other)) + + def symmetric_difference(self, other): + return ImmutableRdataset(super().symmetric_difference(other)) + + +def from_text_list( + rdclass: Union[dns.rdataclass.RdataClass, str], + rdtype: Union[dns.rdatatype.RdataType, str], + ttl: int, + text_rdatas: Collection[str], + idna_codec: Optional[dns.name.IDNACodec] = None, + origin: Optional[dns.name.Name] = None, + relativize: bool = True, + relativize_to: Optional[dns.name.Name] = None, +) -> Rdataset: + """Create an rdataset with the specified class, type, and TTL, and with + the specified list of rdatas in text format. + + *idna_codec*, a ``dns.name.IDNACodec``, specifies the IDNA + encoder/decoder to use; if ``None``, the default IDNA 2003 + encoder/decoder is used. + + *origin*, a ``dns.name.Name`` (or ``None``), the + origin to use for relative names. + + *relativize*, a ``bool``. If true, name will be relativized. + + *relativize_to*, a ``dns.name.Name`` (or ``None``), the origin to use + when relativizing names. If not set, the *origin* value will be used. + + Returns a ``dns.rdataset.Rdataset`` object. + """ + + rdclass = dns.rdataclass.RdataClass.make(rdclass) + rdtype = dns.rdatatype.RdataType.make(rdtype) + r = Rdataset(rdclass, rdtype) + r.update_ttl(ttl) + for t in text_rdatas: + rd = dns.rdata.from_text( + r.rdclass, r.rdtype, t, origin, relativize, relativize_to, idna_codec + ) + r.add(rd) + return r + + +def from_text( + rdclass: Union[dns.rdataclass.RdataClass, str], + rdtype: Union[dns.rdatatype.RdataType, str], + ttl: int, + *text_rdatas: Any, +) -> Rdataset: + """Create an rdataset with the specified class, type, and TTL, and with + the specified rdatas in text format. + + Returns a ``dns.rdataset.Rdataset`` object. + """ + + return from_text_list(rdclass, rdtype, ttl, cast(Collection[str], text_rdatas)) + + +def from_rdata_list(ttl: int, rdatas: Collection[dns.rdata.Rdata]) -> Rdataset: + """Create an rdataset with the specified TTL, and with + the specified list of rdata objects. + + Returns a ``dns.rdataset.Rdataset`` object. + """ + + if len(rdatas) == 0: + raise ValueError("rdata list must not be empty") + r = None + for rd in rdatas: + if r is None: + r = Rdataset(rd.rdclass, rd.rdtype) + r.update_ttl(ttl) + r.add(rd) + assert r is not None + return r + + +def from_rdata(ttl: int, *rdatas: Any) -> Rdataset: + """Create an rdataset with the specified TTL, and with + the specified rdata objects. + + Returns a ``dns.rdataset.Rdataset`` object. + """ + + return from_rdata_list(ttl, cast(Collection[dns.rdata.Rdata], rdatas)) diff --git a/.venv/lib/python3.12/site-packages/dns/rdatatype.py b/.venv/lib/python3.12/site-packages/dns/rdatatype.py new file mode 100644 index 0000000..e6c5818 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdatatype.py @@ -0,0 +1,332 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2001-2017 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""DNS Rdata Types.""" + +from typing import Dict + +import dns.enum +import dns.exception + + +class RdataType(dns.enum.IntEnum): + """DNS Rdata Type""" + + TYPE0 = 0 + NONE = 0 + A = 1 + NS = 2 + MD = 3 + MF = 4 + CNAME = 5 + SOA = 6 + MB = 7 + MG = 8 + MR = 9 + NULL = 10 + WKS = 11 + PTR = 12 + HINFO = 13 + MINFO = 14 + MX = 15 + TXT = 16 + RP = 17 + AFSDB = 18 + X25 = 19 + ISDN = 20 + RT = 21 + NSAP = 22 + NSAP_PTR = 23 + SIG = 24 + KEY = 25 + PX = 26 + GPOS = 27 + AAAA = 28 + LOC = 29 + NXT = 30 + SRV = 33 + NAPTR = 35 + KX = 36 + CERT = 37 + A6 = 38 + DNAME = 39 + OPT = 41 + APL = 42 + DS = 43 + SSHFP = 44 + IPSECKEY = 45 + RRSIG = 46 + NSEC = 47 + DNSKEY = 48 + DHCID = 49 + NSEC3 = 50 + NSEC3PARAM = 51 + TLSA = 52 + SMIMEA = 53 + HIP = 55 + NINFO = 56 + CDS = 59 + CDNSKEY = 60 + OPENPGPKEY = 61 + CSYNC = 62 + ZONEMD = 63 + SVCB = 64 + HTTPS = 65 + SPF = 99 + UNSPEC = 103 + NID = 104 + L32 = 105 + L64 = 106 + LP = 107 + EUI48 = 108 + EUI64 = 109 + TKEY = 249 + TSIG = 250 + IXFR = 251 + AXFR = 252 + MAILB = 253 + MAILA = 254 + ANY = 255 + URI = 256 + CAA = 257 + AVC = 258 + AMTRELAY = 260 + TA = 32768 + DLV = 32769 + + @classmethod + def _maximum(cls): + return 65535 + + @classmethod + def _short_name(cls): + return "type" + + @classmethod + def _prefix(cls): + return "TYPE" + + @classmethod + def _extra_from_text(cls, text): + if text.find("-") >= 0: + try: + return cls[text.replace("-", "_")] + except KeyError: + pass + return _registered_by_text.get(text) + + @classmethod + def _extra_to_text(cls, value, current_text): + if current_text is None: + return _registered_by_value.get(value) + if current_text.find("_") >= 0: + return current_text.replace("_", "-") + return current_text + + @classmethod + def _unknown_exception_class(cls): + return UnknownRdatatype + + +_registered_by_text: Dict[str, RdataType] = {} +_registered_by_value: Dict[RdataType, str] = {} + +_metatypes = {RdataType.OPT} + +_singletons = { + RdataType.SOA, + RdataType.NXT, + RdataType.DNAME, + RdataType.NSEC, + RdataType.CNAME, +} + + +class UnknownRdatatype(dns.exception.DNSException): + """DNS resource record type is unknown.""" + + +def from_text(text: str) -> RdataType: + """Convert text into a DNS rdata type value. + + The input text can be a defined DNS RR type mnemonic or + instance of the DNS generic type syntax. + + For example, "NS" and "TYPE2" will both result in a value of 2. + + Raises ``dns.rdatatype.UnknownRdatatype`` if the type is unknown. + + Raises ``ValueError`` if the rdata type value is not >= 0 and <= 65535. + + Returns a ``dns.rdatatype.RdataType``. + """ + + return RdataType.from_text(text) + + +def to_text(value: RdataType) -> str: + """Convert a DNS rdata type value to text. + + If the value has a known mnemonic, it will be used, otherwise the + DNS generic type syntax will be used. + + Raises ``ValueError`` if the rdata type value is not >= 0 and <= 65535. + + Returns a ``str``. + """ + + return RdataType.to_text(value) + + +def is_metatype(rdtype: RdataType) -> bool: + """True if the specified type is a metatype. + + *rdtype* is a ``dns.rdatatype.RdataType``. + + The currently defined metatypes are TKEY, TSIG, IXFR, AXFR, MAILA, + MAILB, ANY, and OPT. + + Returns a ``bool``. + """ + + return (256 > rdtype >= 128) or rdtype in _metatypes + + +def is_singleton(rdtype: RdataType) -> bool: + """Is the specified type a singleton type? + + Singleton types can only have a single rdata in an rdataset, or a single + RR in an RRset. + + The currently defined singleton types are CNAME, DNAME, NSEC, NXT, and + SOA. + + *rdtype* is an ``int``. + + Returns a ``bool``. + """ + + if rdtype in _singletons: + return True + return False + + +# pylint: disable=redefined-outer-name +def register_type( + rdtype: RdataType, rdtype_text: str, is_singleton: bool = False +) -> None: + """Dynamically register an rdatatype. + + *rdtype*, a ``dns.rdatatype.RdataType``, the rdatatype to register. + + *rdtype_text*, a ``str``, the textual form of the rdatatype. + + *is_singleton*, a ``bool``, indicating if the type is a singleton (i.e. + RRsets of the type can have only one member.) + """ + + _registered_by_text[rdtype_text] = rdtype + _registered_by_value[rdtype] = rdtype_text + if is_singleton: + _singletons.add(rdtype) + + +### BEGIN generated RdataType constants + +TYPE0 = RdataType.TYPE0 +NONE = RdataType.NONE +A = RdataType.A +NS = RdataType.NS +MD = RdataType.MD +MF = RdataType.MF +CNAME = RdataType.CNAME +SOA = RdataType.SOA +MB = RdataType.MB +MG = RdataType.MG +MR = RdataType.MR +NULL = RdataType.NULL +WKS = RdataType.WKS +PTR = RdataType.PTR +HINFO = RdataType.HINFO +MINFO = RdataType.MINFO +MX = RdataType.MX +TXT = RdataType.TXT +RP = RdataType.RP +AFSDB = RdataType.AFSDB +X25 = RdataType.X25 +ISDN = RdataType.ISDN +RT = RdataType.RT +NSAP = RdataType.NSAP +NSAP_PTR = RdataType.NSAP_PTR +SIG = RdataType.SIG +KEY = RdataType.KEY +PX = RdataType.PX +GPOS = RdataType.GPOS +AAAA = RdataType.AAAA +LOC = RdataType.LOC +NXT = RdataType.NXT +SRV = RdataType.SRV +NAPTR = RdataType.NAPTR +KX = RdataType.KX +CERT = RdataType.CERT +A6 = RdataType.A6 +DNAME = RdataType.DNAME +OPT = RdataType.OPT +APL = RdataType.APL +DS = RdataType.DS +SSHFP = RdataType.SSHFP +IPSECKEY = RdataType.IPSECKEY +RRSIG = RdataType.RRSIG +NSEC = RdataType.NSEC +DNSKEY = RdataType.DNSKEY +DHCID = RdataType.DHCID +NSEC3 = RdataType.NSEC3 +NSEC3PARAM = RdataType.NSEC3PARAM +TLSA = RdataType.TLSA +SMIMEA = RdataType.SMIMEA +HIP = RdataType.HIP +NINFO = RdataType.NINFO +CDS = RdataType.CDS +CDNSKEY = RdataType.CDNSKEY +OPENPGPKEY = RdataType.OPENPGPKEY +CSYNC = RdataType.CSYNC +ZONEMD = RdataType.ZONEMD +SVCB = RdataType.SVCB +HTTPS = RdataType.HTTPS +SPF = RdataType.SPF +UNSPEC = RdataType.UNSPEC +NID = RdataType.NID +L32 = RdataType.L32 +L64 = RdataType.L64 +LP = RdataType.LP +EUI48 = RdataType.EUI48 +EUI64 = RdataType.EUI64 +TKEY = RdataType.TKEY +TSIG = RdataType.TSIG +IXFR = RdataType.IXFR +AXFR = RdataType.AXFR +MAILB = RdataType.MAILB +MAILA = RdataType.MAILA +ANY = RdataType.ANY +URI = RdataType.URI +CAA = RdataType.CAA +AVC = RdataType.AVC +AMTRELAY = RdataType.AMTRELAY +TA = RdataType.TA +DLV = RdataType.DLV + +### END generated RdataType constants diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/AFSDB.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/AFSDB.py new file mode 100644 index 0000000..06a3b97 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/AFSDB.py @@ -0,0 +1,45 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 dns.immutable +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 + # "preference" attribute, and "hostname" an alias for the "exchange" + # attribute. + # + # This lets us inherit the UncompressedMX implementation but lets + # the caller use appropriate attribute names for the rdata type. + # + # We probably lose some performance vs. a cut-and-paste + # implementation, but this way we don't copy code, and that's + # good. + + @property + def subtype(self): + "the AFSDB subtype" + return self.preference + + @property + def hostname(self): + "the AFSDB hostname" + return self.exchange diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/AMTRELAY.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/AMTRELAY.py new file mode 100644 index 0000000..ed2b072 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/AMTRELAY.py @@ -0,0 +1,91 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2006, 2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 struct + +import dns.exception +import dns.immutable +import dns.rdtypes.util + + +class Relay(dns.rdtypes.util.Gateway): + name = "AMTRELAY relay" + + @property + def relay(self): + return self.gateway + + +@dns.immutable.immutable +class AMTRELAY(dns.rdata.Rdata): + """AMTRELAY record""" + + # see: RFC 8777 + + __slots__ = ["precedence", "discovery_optional", "relay_type", "relay"] + + def __init__( + self, rdclass, rdtype, precedence, discovery_optional, relay_type, relay + ): + super().__init__(rdclass, rdtype) + relay = Relay(relay_type, relay) + self.precedence = self._as_uint8(precedence) + self.discovery_optional = self._as_bool(discovery_optional) + self.relay_type = relay.type + self.relay = relay.relay + + def to_text(self, origin=None, relativize=True, **kw): + relay = Relay(self.relay_type, self.relay).to_text(origin, relativize) + return "%d %d %d %s" % ( + self.precedence, + self.discovery_optional, + self.relay_type, + relay, + ) + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + precedence = tok.get_uint8() + discovery_optional = tok.get_uint8() + if discovery_optional > 1: + raise dns.exception.SyntaxError("expecting 0 or 1") + discovery_optional = bool(discovery_optional) + relay_type = tok.get_uint8() + if relay_type > 0x7F: + raise dns.exception.SyntaxError("expecting an integer <= 127") + relay = Relay.from_text(relay_type, tok, origin, relativize, relativize_to) + return cls( + rdclass, rdtype, precedence, discovery_optional, relay_type, relay.relay + ) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + relay_type = self.relay_type | (self.discovery_optional << 7) + header = struct.pack("!BB", self.precedence, relay_type) + file.write(header) + Relay(self.relay_type, self.relay).to_wire(file, compress, origin, canonicalize) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + (precedence, relay_type) = parser.get_struct("!BB") + discovery_optional = bool(relay_type >> 7) + relay_type &= 0x7F + relay = Relay.from_wire_parser(relay_type, parser, origin) + return cls( + rdclass, rdtype, precedence, discovery_optional, relay_type, relay.relay + ) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/AVC.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/AVC.py new file mode 100644 index 0000000..a27ae2d --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/AVC.py @@ -0,0 +1,26 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2016 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 dns.immutable +import dns.rdtypes.txtbase + + +@dns.immutable.immutable +class AVC(dns.rdtypes.txtbase.TXTBase): + """AVC record""" + + # See: IANA dns parameters for AVC diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/CAA.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/CAA.py new file mode 100644 index 0000000..2e6a7e7 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/CAA.py @@ -0,0 +1,71 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 struct + +import dns.exception +import dns.immutable +import dns.rdata +import dns.tokenizer + + +@dns.immutable.immutable +class CAA(dns.rdata.Rdata): + """CAA (Certification Authority Authorization) record""" + + # see: RFC 6844 + + __slots__ = ["flags", "tag", "value"] + + def __init__(self, rdclass, rdtype, flags, tag, value): + super().__init__(rdclass, rdtype) + self.flags = self._as_uint8(flags) + self.tag = self._as_bytes(tag, True, 255) + if not tag.isalnum(): + raise ValueError("tag is not alphanumeric") + self.value = self._as_bytes(value) + + def to_text(self, origin=None, relativize=True, **kw): + return '%u %s "%s"' % ( + self.flags, + dns.rdata._escapify(self.tag), + dns.rdata._escapify(self.value), + ) + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + flags = tok.get_uint8() + tag = tok.get_string().encode() + value = tok.get_string().encode() + return cls(rdclass, rdtype, flags, tag, value) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + file.write(struct.pack("!B", self.flags)) + l = len(self.tag) + assert l < 256 + file.write(struct.pack("!B", l)) + file.write(self.tag) + file.write(self.value) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + flags = parser.get_uint8() + tag = parser.get_counted_bytes() + value = parser.get_remaining() + return cls(rdclass, rdtype, flags, tag, value) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/CDNSKEY.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/CDNSKEY.py new file mode 100644 index 0000000..b613409 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/CDNSKEY.py @@ -0,0 +1,33 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2004-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 dns.immutable +import dns.rdtypes.dnskeybase # lgtm[py/import-and-import-from] + +# pylint: disable=unused-import +from dns.rdtypes.dnskeybase import ( # noqa: F401 lgtm[py/unused-import] + REVOKE, + SEP, + ZONE, +) + +# pylint: enable=unused-import + + +@dns.immutable.immutable +class CDNSKEY(dns.rdtypes.dnskeybase.DNSKEYBase): + """CDNSKEY record""" diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/CDS.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/CDS.py new file mode 100644 index 0000000..8312b97 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/CDS.py @@ -0,0 +1,29 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 dns.immutable +import dns.rdtypes.dsbase + + +@dns.immutable.immutable +class CDS(dns.rdtypes.dsbase.DSBase): + """CDS record""" + + _digest_length_by_type = { + **dns.rdtypes.dsbase.DSBase._digest_length_by_type, + 0: 1, # delete, RFC 8078 Sec. 4 (including Errata ID 5049) + } diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/CERT.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/CERT.py new file mode 100644 index 0000000..f369cc8 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/CERT.py @@ -0,0 +1,116 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 base64 +import struct + +import dns.dnssectypes +import dns.exception +import dns.immutable +import dns.rdata +import dns.tokenizer + +_ctype_by_value = { + 1: "PKIX", + 2: "SPKI", + 3: "PGP", + 4: "IPKIX", + 5: "ISPKI", + 6: "IPGP", + 7: "ACPKIX", + 8: "IACPKIX", + 253: "URI", + 254: "OID", +} + +_ctype_by_name = { + "PKIX": 1, + "SPKI": 2, + "PGP": 3, + "IPKIX": 4, + "ISPKI": 5, + "IPGP": 6, + "ACPKIX": 7, + "IACPKIX": 8, + "URI": 253, + "OID": 254, +} + + +def _ctype_from_text(what): + v = _ctype_by_name.get(what) + if v is not None: + return v + return int(what) + + +def _ctype_to_text(what): + v = _ctype_by_value.get(what) + if v is not None: + return v + return str(what) + + +@dns.immutable.immutable +class CERT(dns.rdata.Rdata): + """CERT record""" + + # see RFC 4398 + + __slots__ = ["certificate_type", "key_tag", "algorithm", "certificate"] + + def __init__( + self, rdclass, rdtype, certificate_type, key_tag, algorithm, certificate + ): + super().__init__(rdclass, rdtype) + self.certificate_type = self._as_uint16(certificate_type) + self.key_tag = self._as_uint16(key_tag) + self.algorithm = self._as_uint8(algorithm) + self.certificate = self._as_bytes(certificate) + + def to_text(self, origin=None, relativize=True, **kw): + certificate_type = _ctype_to_text(self.certificate_type) + return "%s %d %s %s" % ( + certificate_type, + self.key_tag, + dns.dnssectypes.Algorithm.to_text(self.algorithm), + dns.rdata._base64ify(self.certificate, **kw), + ) + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + certificate_type = _ctype_from_text(tok.get_string()) + key_tag = tok.get_uint16() + algorithm = dns.dnssectypes.Algorithm.from_text(tok.get_string()) + b64 = tok.concatenate_remaining_identifiers().encode() + certificate = base64.b64decode(b64) + return cls(rdclass, rdtype, certificate_type, key_tag, algorithm, certificate) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + prefix = struct.pack( + "!HHB", self.certificate_type, self.key_tag, self.algorithm + ) + file.write(prefix) + file.write(self.certificate) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + (certificate_type, key_tag, algorithm) = parser.get_struct("!HHB") + certificate = parser.get_remaining() + return cls(rdclass, rdtype, certificate_type, key_tag, algorithm, certificate) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/CNAME.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/CNAME.py new file mode 100644 index 0000000..665e407 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/CNAME.py @@ -0,0 +1,28 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 dns.immutable +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 + non-singleton CNAME rdatasets because such sets have been commonly + used by BIND and other nameservers for load balancing.""" diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/CSYNC.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/CSYNC.py new file mode 100644 index 0000000..2f972f6 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/CSYNC.py @@ -0,0 +1,68 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2004-2007, 2009-2011, 2016 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 struct + +import dns.exception +import dns.immutable +import dns.name +import dns.rdata +import dns.rdatatype +import dns.rdtypes.util + + +@dns.immutable.immutable +class Bitmap(dns.rdtypes.util.Bitmap): + type_name = "CSYNC" + + +@dns.immutable.immutable +class CSYNC(dns.rdata.Rdata): + """CSYNC record""" + + __slots__ = ["serial", "flags", "windows"] + + def __init__(self, rdclass, rdtype, serial, flags, windows): + super().__init__(rdclass, rdtype) + self.serial = self._as_uint32(serial) + self.flags = self._as_uint16(flags) + if not isinstance(windows, Bitmap): + windows = Bitmap(windows) + self.windows = tuple(windows.windows) + + def to_text(self, origin=None, relativize=True, **kw): + text = Bitmap(self.windows).to_text() + return "%d %d%s" % (self.serial, self.flags, text) + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + serial = tok.get_uint32() + flags = tok.get_uint16() + bitmap = Bitmap.from_text(tok) + return cls(rdclass, rdtype, serial, flags, bitmap) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + file.write(struct.pack("!IH", self.serial, self.flags)) + Bitmap(self.windows).to_wire(file) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + (serial, flags) = parser.get_struct("!IH") + bitmap = Bitmap.from_wire_parser(parser) + return cls(rdclass, rdtype, serial, flags, bitmap) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/DLV.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/DLV.py new file mode 100644 index 0000000..6c134f1 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/DLV.py @@ -0,0 +1,24 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 dns.immutable +import dns.rdtypes.dsbase + + +@dns.immutable.immutable +class DLV(dns.rdtypes.dsbase.DSBase): + """DLV record""" diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/DNAME.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/DNAME.py new file mode 100644 index 0000000..bbf9186 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/DNAME.py @@ -0,0 +1,27 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 dns.immutable +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): + self.target.to_wire(file, None, origin, canonicalize) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/DNSKEY.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/DNSKEY.py new file mode 100644 index 0000000..6d961a9 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/DNSKEY.py @@ -0,0 +1,33 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2004-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 dns.immutable +import dns.rdtypes.dnskeybase # lgtm[py/import-and-import-from] + +# pylint: disable=unused-import +from dns.rdtypes.dnskeybase import ( # noqa: F401 lgtm[py/unused-import] + REVOKE, + SEP, + ZONE, +) + +# pylint: enable=unused-import + + +@dns.immutable.immutable +class DNSKEY(dns.rdtypes.dnskeybase.DNSKEYBase): + """DNSKEY record""" diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/DS.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/DS.py new file mode 100644 index 0000000..58b3108 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/DS.py @@ -0,0 +1,24 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 dns.immutable +import dns.rdtypes.dsbase + + +@dns.immutable.immutable +class DS(dns.rdtypes.dsbase.DSBase): + """DS record""" diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/EUI48.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/EUI48.py new file mode 100644 index 0000000..c843be5 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/EUI48.py @@ -0,0 +1,30 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2015 Red Hat, Inc. +# Author: Petr Spacek +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED 'AS IS' AND RED HAT DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 dns.immutable +import dns.rdtypes.euibase + + +@dns.immutable.immutable +class EUI48(dns.rdtypes.euibase.EUIBase): + """EUI48 record""" + + # see: rfc7043.txt + + byte_len = 6 # 0123456789ab (in hex) + text_len = byte_len * 3 - 1 # 01-23-45-67-89-ab diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/EUI64.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/EUI64.py new file mode 100644 index 0000000..f6d7e25 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/EUI64.py @@ -0,0 +1,30 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2015 Red Hat, Inc. +# Author: Petr Spacek +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED 'AS IS' AND RED HAT DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 dns.immutable +import dns.rdtypes.euibase + + +@dns.immutable.immutable +class EUI64(dns.rdtypes.euibase.EUIBase): + """EUI64 record""" + + # see: rfc7043.txt + + byte_len = 8 # 0123456789abcdef (in hex) + text_len = byte_len * 3 - 1 # 01-23-45-67-89-ab-cd-ef diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/GPOS.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/GPOS.py new file mode 100644 index 0000000..312338f --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/GPOS.py @@ -0,0 +1,125 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 struct + +import dns.exception +import dns.immutable +import dns.rdata +import dns.tokenizer + + +def _validate_float_string(what): + if len(what) == 0: + raise dns.exception.FormError + if what[0] == b"-"[0] or what[0] == b"+"[0]: + what = what[1:] + if what.isdigit(): + return + try: + (left, right) = what.split(b".") + except ValueError: + raise dns.exception.FormError + if left == b"" and right == b"": + raise dns.exception.FormError + if not left == b"" and not left.decode().isdigit(): + raise dns.exception.FormError + if not right == b"" and not right.decode().isdigit(): + raise dns.exception.FormError + + +@dns.immutable.immutable +class GPOS(dns.rdata.Rdata): + """GPOS record""" + + # see: RFC 1712 + + __slots__ = ["latitude", "longitude", "altitude"] + + def __init__(self, rdclass, rdtype, latitude, longitude, altitude): + super().__init__(rdclass, rdtype) + if isinstance(latitude, float) or isinstance(latitude, int): + latitude = str(latitude) + if isinstance(longitude, float) or isinstance(longitude, int): + longitude = str(longitude) + if isinstance(altitude, float) or isinstance(altitude, int): + altitude = str(altitude) + latitude = self._as_bytes(latitude, True, 255) + longitude = self._as_bytes(longitude, True, 255) + altitude = self._as_bytes(altitude, True, 255) + _validate_float_string(latitude) + _validate_float_string(longitude) + _validate_float_string(altitude) + self.latitude = latitude + self.longitude = longitude + self.altitude = altitude + flat = self.float_latitude + if flat < -90.0 or flat > 90.0: + raise dns.exception.FormError("bad latitude") + flong = self.float_longitude + if flong < -180.0 or flong > 180.0: + raise dns.exception.FormError("bad longitude") + + def to_text(self, origin=None, relativize=True, **kw): + return "{} {} {}".format( + self.latitude.decode(), self.longitude.decode(), self.altitude.decode() + ) + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + latitude = tok.get_string() + longitude = tok.get_string() + altitude = tok.get_string() + return cls(rdclass, rdtype, latitude, longitude, altitude) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + l = len(self.latitude) + assert l < 256 + file.write(struct.pack("!B", l)) + file.write(self.latitude) + l = len(self.longitude) + assert l < 256 + file.write(struct.pack("!B", l)) + file.write(self.longitude) + l = len(self.altitude) + assert l < 256 + file.write(struct.pack("!B", l)) + file.write(self.altitude) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + latitude = parser.get_counted_bytes() + longitude = parser.get_counted_bytes() + altitude = parser.get_counted_bytes() + return cls(rdclass, rdtype, latitude, longitude, altitude) + + @property + def float_latitude(self): + "latitude as a floating point value" + return float(self.latitude) + + @property + def float_longitude(self): + "longitude as a floating point value" + return float(self.longitude) + + @property + def float_altitude(self): + "altitude as a floating point value" + return float(self.altitude) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/HINFO.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/HINFO.py new file mode 100644 index 0000000..c2c45de --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/HINFO.py @@ -0,0 +1,66 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 struct + +import dns.exception +import dns.immutable +import dns.rdata +import dns.tokenizer + + +@dns.immutable.immutable +class HINFO(dns.rdata.Rdata): + """HINFO record""" + + # see: RFC 1035 + + __slots__ = ["cpu", "os"] + + def __init__(self, rdclass, rdtype, cpu, os): + super().__init__(rdclass, rdtype) + self.cpu = self._as_bytes(cpu, True, 255) + self.os = self._as_bytes(os, True, 255) + + def to_text(self, origin=None, relativize=True, **kw): + return '"{}" "{}"'.format( + dns.rdata._escapify(self.cpu), dns.rdata._escapify(self.os) + ) + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + cpu = tok.get_string(max_length=255) + os = tok.get_string(max_length=255) + return cls(rdclass, rdtype, cpu, os) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + l = len(self.cpu) + assert l < 256 + file.write(struct.pack("!B", l)) + file.write(self.cpu) + l = len(self.os) + assert l < 256 + file.write(struct.pack("!B", l)) + file.write(self.os) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + cpu = parser.get_counted_bytes() + os = parser.get_counted_bytes() + return cls(rdclass, rdtype, cpu, os) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/HIP.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/HIP.py new file mode 100644 index 0000000..9166913 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/HIP.py @@ -0,0 +1,85 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2010, 2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 base64 +import binascii +import struct + +import dns.exception +import dns.immutable +import dns.rdata +import dns.rdatatype + + +@dns.immutable.immutable +class HIP(dns.rdata.Rdata): + """HIP record""" + + # see: RFC 5205 + + __slots__ = ["hit", "algorithm", "key", "servers"] + + def __init__(self, rdclass, rdtype, hit, algorithm, key, servers): + super().__init__(rdclass, rdtype) + self.hit = self._as_bytes(hit, True, 255) + self.algorithm = self._as_uint8(algorithm) + self.key = self._as_bytes(key, True) + self.servers = self._as_tuple(servers, self._as_name) + + def to_text(self, origin=None, relativize=True, **kw): + hit = binascii.hexlify(self.hit).decode() + key = base64.b64encode(self.key).replace(b"\n", b"").decode() + text = "" + servers = [] + for server in self.servers: + servers.append(server.choose_relativity(origin, relativize)) + if len(servers) > 0: + text += " " + " ".join((x.to_unicode() for x in servers)) + return "%u %s %s%s" % (self.algorithm, hit, key, text) + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + algorithm = tok.get_uint8() + hit = binascii.unhexlify(tok.get_string().encode()) + key = base64.b64decode(tok.get_string().encode()) + servers = [] + for token in tok.get_remaining(): + server = tok.as_name(token, origin, relativize, relativize_to) + servers.append(server) + return cls(rdclass, rdtype, hit, algorithm, key, servers) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + lh = len(self.hit) + lk = len(self.key) + file.write(struct.pack("!BBH", lh, self.algorithm, lk)) + file.write(self.hit) + file.write(self.key) + for server in self.servers: + server.to_wire(file, None, origin, False) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + (lh, algorithm, lk) = parser.get_struct("!BBH") + hit = parser.get_bytes(lh) + key = parser.get_bytes(lk) + servers = [] + while parser.remaining() > 0: + server = parser.get_name(origin) + servers.append(server) + return cls(rdclass, rdtype, hit, algorithm, key, servers) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/ISDN.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/ISDN.py new file mode 100644 index 0000000..fb01eab --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/ISDN.py @@ -0,0 +1,77 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 struct + +import dns.exception +import dns.immutable +import dns.rdata +import dns.tokenizer + + +@dns.immutable.immutable +class ISDN(dns.rdata.Rdata): + """ISDN record""" + + # see: RFC 1183 + + __slots__ = ["address", "subaddress"] + + def __init__(self, rdclass, rdtype, address, subaddress): + super().__init__(rdclass, rdtype) + self.address = self._as_bytes(address, True, 255) + self.subaddress = self._as_bytes(subaddress, True, 255) + + def to_text(self, origin=None, relativize=True, **kw): + if self.subaddress: + return '"{}" "{}"'.format( + dns.rdata._escapify(self.address), dns.rdata._escapify(self.subaddress) + ) + else: + return '"%s"' % dns.rdata._escapify(self.address) + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + address = tok.get_string() + tokens = tok.get_remaining(max_tokens=1) + if len(tokens) >= 1: + subaddress = tokens[0].unescape().value + else: + subaddress = "" + return cls(rdclass, rdtype, address, subaddress) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + l = len(self.address) + assert l < 256 + file.write(struct.pack("!B", l)) + file.write(self.address) + l = len(self.subaddress) + if l > 0: + assert l < 256 + file.write(struct.pack("!B", l)) + file.write(self.subaddress) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + address = parser.get_counted_bytes() + if parser.remaining() > 0: + subaddress = parser.get_counted_bytes() + else: + subaddress = b"" + return cls(rdclass, rdtype, address, subaddress) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/L32.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/L32.py new file mode 100644 index 0000000..09804c2 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/L32.py @@ -0,0 +1,41 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +import struct + +import dns.immutable +import dns.rdata + + +@dns.immutable.immutable +class L32(dns.rdata.Rdata): + """L32 record""" + + # see: rfc6742.txt + + __slots__ = ["preference", "locator32"] + + def __init__(self, rdclass, rdtype, preference, locator32): + super().__init__(rdclass, rdtype) + self.preference = self._as_uint16(preference) + self.locator32 = self._as_ipv4_address(locator32) + + def to_text(self, origin=None, relativize=True, **kw): + return f"{self.preference} {self.locator32}" + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + preference = tok.get_uint16() + nodeid = tok.get_identifier() + return cls(rdclass, rdtype, preference, nodeid) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + file.write(struct.pack("!H", self.preference)) + file.write(dns.ipv4.inet_aton(self.locator32)) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + preference = parser.get_uint16() + locator32 = parser.get_remaining() + return cls(rdclass, rdtype, preference, locator32) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/L64.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/L64.py new file mode 100644 index 0000000..fb76808 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/L64.py @@ -0,0 +1,47 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +import struct + +import dns.immutable +import dns.rdtypes.util + + +@dns.immutable.immutable +class L64(dns.rdata.Rdata): + """L64 record""" + + # see: rfc6742.txt + + __slots__ = ["preference", "locator64"] + + def __init__(self, rdclass, rdtype, preference, locator64): + super().__init__(rdclass, rdtype) + self.preference = self._as_uint16(preference) + if isinstance(locator64, bytes): + if len(locator64) != 8: + raise ValueError("invalid locator64") + self.locator64 = dns.rdata._hexify(locator64, 4, b":") + else: + dns.rdtypes.util.parse_formatted_hex(locator64, 4, 4, ":") + self.locator64 = locator64 + + def to_text(self, origin=None, relativize=True, **kw): + return f"{self.preference} {self.locator64}" + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + preference = tok.get_uint16() + locator64 = tok.get_identifier() + return cls(rdclass, rdtype, preference, locator64) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + file.write(struct.pack("!H", self.preference)) + file.write(dns.rdtypes.util.parse_formatted_hex(self.locator64, 4, 4, ":")) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + preference = parser.get_uint16() + locator64 = parser.get_remaining() + return cls(rdclass, rdtype, preference, locator64) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/LOC.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/LOC.py new file mode 100644 index 0000000..a36a2c1 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/LOC.py @@ -0,0 +1,354 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 struct + +import dns.exception +import dns.immutable +import dns.rdata + +_pows = tuple(10**i for i in range(0, 11)) + +# default values are in centimeters +_default_size = 100.0 +_default_hprec = 1000000.0 +_default_vprec = 1000.0 + +# for use by from_wire() +_MAX_LATITUDE = 0x80000000 + 90 * 3600000 +_MIN_LATITUDE = 0x80000000 - 90 * 3600000 +_MAX_LONGITUDE = 0x80000000 + 180 * 3600000 +_MIN_LONGITUDE = 0x80000000 - 180 * 3600000 + + +def _exponent_of(what, desc): + if what == 0: + return 0 + exp = None + for i, pow in enumerate(_pows): + if what < pow: + exp = i - 1 + break + if exp is None or exp < 0: + raise dns.exception.SyntaxError("%s value out of bounds" % desc) + return exp + + +def _float_to_tuple(what): + if what < 0: + sign = -1 + what *= -1 + else: + sign = 1 + what = round(what * 3600000) + degrees = int(what // 3600000) + what -= degrees * 3600000 + minutes = int(what // 60000) + what -= minutes * 60000 + seconds = int(what // 1000) + what -= int(seconds * 1000) + what = int(what) + return (degrees, minutes, seconds, what, sign) + + +def _tuple_to_float(what): + value = float(what[0]) + value += float(what[1]) / 60.0 + value += float(what[2]) / 3600.0 + value += float(what[3]) / 3600000.0 + return float(what[4]) * value + + +def _encode_size(what, desc): + what = int(what) + exponent = _exponent_of(what, desc) & 0xF + base = what // pow(10, exponent) & 0xF + return base * 16 + exponent + + +def _decode_size(what, desc): + exponent = what & 0x0F + if exponent > 9: + raise dns.exception.FormError("bad %s exponent" % desc) + base = (what & 0xF0) >> 4 + if base > 9: + raise dns.exception.FormError("bad %s base" % desc) + return base * pow(10, exponent) + + +def _check_coordinate_list(value, low, high): + if value[0] < low or value[0] > high: + raise ValueError(f"not in range [{low}, {high}]") + if value[1] < 0 or value[1] > 59: + raise ValueError("bad minutes value") + if value[2] < 0 or value[2] > 59: + raise ValueError("bad seconds value") + if value[3] < 0 or value[3] > 999: + raise ValueError("bad milliseconds value") + if value[4] != 1 and value[4] != -1: + raise ValueError("bad hemisphere value") + + +@dns.immutable.immutable +class LOC(dns.rdata.Rdata): + """LOC record""" + + # see: RFC 1876 + + __slots__ = [ + "latitude", + "longitude", + "altitude", + "size", + "horizontal_precision", + "vertical_precision", + ] + + def __init__( + self, + rdclass, + rdtype, + latitude, + longitude, + altitude, + size=_default_size, + hprec=_default_hprec, + vprec=_default_vprec, + ): + """Initialize a LOC record instance. + + The parameters I{latitude} and I{longitude} may be either a 4-tuple + of integers specifying (degrees, minutes, seconds, milliseconds), + or they may be floating point values specifying the number of + degrees. The other parameters are floats. Size, horizontal precision, + and vertical precision are specified in centimeters.""" + + super().__init__(rdclass, rdtype) + if isinstance(latitude, int): + latitude = float(latitude) + if isinstance(latitude, float): + latitude = _float_to_tuple(latitude) + _check_coordinate_list(latitude, -90, 90) + self.latitude = tuple(latitude) + if isinstance(longitude, int): + longitude = float(longitude) + if isinstance(longitude, float): + longitude = _float_to_tuple(longitude) + _check_coordinate_list(longitude, -180, 180) + self.longitude = tuple(longitude) + self.altitude = float(altitude) + self.size = float(size) + self.horizontal_precision = float(hprec) + self.vertical_precision = float(vprec) + + def to_text(self, origin=None, relativize=True, **kw): + if self.latitude[4] > 0: + lat_hemisphere = "N" + else: + lat_hemisphere = "S" + if self.longitude[4] > 0: + long_hemisphere = "E" + else: + long_hemisphere = "W" + text = "%d %d %d.%03d %s %d %d %d.%03d %s %0.2fm" % ( + self.latitude[0], + self.latitude[1], + self.latitude[2], + self.latitude[3], + lat_hemisphere, + self.longitude[0], + self.longitude[1], + self.longitude[2], + self.longitude[3], + long_hemisphere, + self.altitude / 100.0, + ) + + # do not print default values + if ( + self.size != _default_size + or self.horizontal_precision != _default_hprec + or self.vertical_precision != _default_vprec + ): + text += " {:0.2f}m {:0.2f}m {:0.2f}m".format( + self.size / 100.0, + self.horizontal_precision / 100.0, + self.vertical_precision / 100.0, + ) + return text + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + latitude = [0, 0, 0, 0, 1] + longitude = [0, 0, 0, 0, 1] + size = _default_size + hprec = _default_hprec + vprec = _default_vprec + + latitude[0] = tok.get_int() + t = tok.get_string() + if t.isdigit(): + latitude[1] = int(t) + t = tok.get_string() + if "." in t: + (seconds, milliseconds) = t.split(".") + if not seconds.isdigit(): + raise dns.exception.SyntaxError("bad latitude seconds value") + latitude[2] = int(seconds) + l = len(milliseconds) + if l == 0 or l > 3 or not milliseconds.isdigit(): + raise dns.exception.SyntaxError("bad latitude milliseconds value") + if l == 1: + m = 100 + elif l == 2: + m = 10 + else: + m = 1 + latitude[3] = m * int(milliseconds) + t = tok.get_string() + elif t.isdigit(): + latitude[2] = int(t) + t = tok.get_string() + if t == "S": + latitude[4] = -1 + elif t != "N": + raise dns.exception.SyntaxError("bad latitude hemisphere value") + + longitude[0] = tok.get_int() + t = tok.get_string() + if t.isdigit(): + longitude[1] = int(t) + t = tok.get_string() + if "." in t: + (seconds, milliseconds) = t.split(".") + if not seconds.isdigit(): + raise dns.exception.SyntaxError("bad longitude seconds value") + longitude[2] = int(seconds) + l = len(milliseconds) + if l == 0 or l > 3 or not milliseconds.isdigit(): + raise dns.exception.SyntaxError("bad longitude milliseconds value") + if l == 1: + m = 100 + elif l == 2: + m = 10 + else: + m = 1 + longitude[3] = m * int(milliseconds) + t = tok.get_string() + elif t.isdigit(): + longitude[2] = int(t) + t = tok.get_string() + if t == "W": + longitude[4] = -1 + elif t != "E": + raise dns.exception.SyntaxError("bad longitude hemisphere value") + + t = tok.get_string() + if t[-1] == "m": + t = t[0:-1] + altitude = float(t) * 100.0 # m -> cm + + tokens = tok.get_remaining(max_tokens=3) + if len(tokens) >= 1: + value = tokens[0].unescape().value + if value[-1] == "m": + value = value[0:-1] + size = float(value) * 100.0 # m -> cm + if len(tokens) >= 2: + value = tokens[1].unescape().value + if value[-1] == "m": + value = value[0:-1] + hprec = float(value) * 100.0 # m -> cm + if len(tokens) >= 3: + value = tokens[2].unescape().value + if value[-1] == "m": + value = value[0:-1] + vprec = float(value) * 100.0 # m -> cm + + # Try encoding these now so we raise if they are bad + _encode_size(size, "size") + _encode_size(hprec, "horizontal precision") + _encode_size(vprec, "vertical precision") + + return cls(rdclass, rdtype, latitude, longitude, altitude, size, hprec, vprec) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + milliseconds = ( + self.latitude[0] * 3600000 + + self.latitude[1] * 60000 + + self.latitude[2] * 1000 + + self.latitude[3] + ) * self.latitude[4] + latitude = 0x80000000 + milliseconds + milliseconds = ( + self.longitude[0] * 3600000 + + self.longitude[1] * 60000 + + self.longitude[2] * 1000 + + self.longitude[3] + ) * self.longitude[4] + longitude = 0x80000000 + milliseconds + altitude = int(self.altitude) + 10000000 + size = _encode_size(self.size, "size") + hprec = _encode_size(self.horizontal_precision, "horizontal precision") + vprec = _encode_size(self.vertical_precision, "vertical precision") + wire = struct.pack( + "!BBBBIII", 0, size, hprec, vprec, latitude, longitude, altitude + ) + file.write(wire) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + ( + version, + size, + hprec, + vprec, + latitude, + longitude, + altitude, + ) = parser.get_struct("!BBBBIII") + if version != 0: + raise dns.exception.FormError("LOC version not zero") + if latitude < _MIN_LATITUDE or latitude > _MAX_LATITUDE: + raise dns.exception.FormError("bad latitude") + if latitude > 0x80000000: + latitude = (latitude - 0x80000000) / 3600000 + else: + latitude = -1 * (0x80000000 - latitude) / 3600000 + if longitude < _MIN_LONGITUDE or longitude > _MAX_LONGITUDE: + raise dns.exception.FormError("bad longitude") + if longitude > 0x80000000: + longitude = (longitude - 0x80000000) / 3600000 + else: + longitude = -1 * (0x80000000 - longitude) / 3600000 + altitude = float(altitude) - 10000000.0 + size = _decode_size(size, "size") + hprec = _decode_size(hprec, "horizontal precision") + vprec = _decode_size(vprec, "vertical precision") + return cls(rdclass, rdtype, latitude, longitude, altitude, size, hprec, vprec) + + @property + def float_latitude(self): + "latitude as a floating point value" + return _tuple_to_float(self.latitude) + + @property + def float_longitude(self): + "longitude as a floating point value" + return _tuple_to_float(self.longitude) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/LP.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/LP.py new file mode 100644 index 0000000..312663f --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/LP.py @@ -0,0 +1,42 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +import struct + +import dns.immutable +import dns.rdata + + +@dns.immutable.immutable +class LP(dns.rdata.Rdata): + """LP record""" + + # see: rfc6742.txt + + __slots__ = ["preference", "fqdn"] + + def __init__(self, rdclass, rdtype, preference, fqdn): + super().__init__(rdclass, rdtype) + self.preference = self._as_uint16(preference) + self.fqdn = self._as_name(fqdn) + + def to_text(self, origin=None, relativize=True, **kw): + fqdn = self.fqdn.choose_relativity(origin, relativize) + return "%d %s" % (self.preference, fqdn) + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + preference = tok.get_uint16() + fqdn = tok.get_name(origin, relativize, relativize_to) + return cls(rdclass, rdtype, preference, fqdn) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + file.write(struct.pack("!H", self.preference)) + self.fqdn.to_wire(file, compress, origin, canonicalize) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + preference = parser.get_uint16() + fqdn = parser.get_name(origin) + return cls(rdclass, rdtype, preference, fqdn) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/MX.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/MX.py new file mode 100644 index 0000000..0c300c5 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/MX.py @@ -0,0 +1,24 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 dns.immutable +import dns.rdtypes.mxbase + + +@dns.immutable.immutable +class MX(dns.rdtypes.mxbase.MXBase): + """MX record""" diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/NID.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/NID.py new file mode 100644 index 0000000..2f64917 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/NID.py @@ -0,0 +1,47 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +import struct + +import dns.immutable +import dns.rdtypes.util + + +@dns.immutable.immutable +class NID(dns.rdata.Rdata): + """NID record""" + + # see: rfc6742.txt + + __slots__ = ["preference", "nodeid"] + + def __init__(self, rdclass, rdtype, preference, nodeid): + super().__init__(rdclass, rdtype) + self.preference = self._as_uint16(preference) + if isinstance(nodeid, bytes): + if len(nodeid) != 8: + raise ValueError("invalid nodeid") + self.nodeid = dns.rdata._hexify(nodeid, 4, b":") + else: + dns.rdtypes.util.parse_formatted_hex(nodeid, 4, 4, ":") + self.nodeid = nodeid + + def to_text(self, origin=None, relativize=True, **kw): + return f"{self.preference} {self.nodeid}" + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + preference = tok.get_uint16() + nodeid = tok.get_identifier() + return cls(rdclass, rdtype, preference, nodeid) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + file.write(struct.pack("!H", self.preference)) + file.write(dns.rdtypes.util.parse_formatted_hex(self.nodeid, 4, 4, ":")) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + preference = parser.get_uint16() + nodeid = parser.get_remaining() + return cls(rdclass, rdtype, preference, nodeid) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/NINFO.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/NINFO.py new file mode 100644 index 0000000..b177bdd --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/NINFO.py @@ -0,0 +1,26 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2006, 2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 dns.immutable +import dns.rdtypes.txtbase + + +@dns.immutable.immutable +class NINFO(dns.rdtypes.txtbase.TXTBase): + """NINFO record""" + + # see: draft-reid-dnsext-zs-01 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/NS.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/NS.py new file mode 100644 index 0000000..c3f34ce --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/NS.py @@ -0,0 +1,24 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 dns.immutable +import dns.rdtypes.nsbase + + +@dns.immutable.immutable +class NS(dns.rdtypes.nsbase.NSBase): + """NS record""" diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/NSEC.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/NSEC.py new file mode 100644 index 0000000..340525a --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/NSEC.py @@ -0,0 +1,67 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2004-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 dns.exception +import dns.immutable +import dns.name +import dns.rdata +import dns.rdatatype +import dns.rdtypes.util + + +@dns.immutable.immutable +class Bitmap(dns.rdtypes.util.Bitmap): + type_name = "NSEC" + + +@dns.immutable.immutable +class NSEC(dns.rdata.Rdata): + """NSEC record""" + + __slots__ = ["next", "windows"] + + def __init__(self, rdclass, rdtype, next, windows): + super().__init__(rdclass, rdtype) + self.next = self._as_name(next) + if not isinstance(windows, Bitmap): + windows = Bitmap(windows) + self.windows = tuple(windows.windows) + + def to_text(self, origin=None, relativize=True, **kw): + next = self.next.choose_relativity(origin, relativize) + text = Bitmap(self.windows).to_text() + return "{}{}".format(next, text) + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + next = tok.get_name(origin, relativize, relativize_to) + windows = Bitmap.from_text(tok) + return cls(rdclass, rdtype, next, windows) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + # Note that NSEC downcasing, originally mandated by RFC 4034 + # section 6.2 was removed by RFC 6840 section 5.1. + self.next.to_wire(file, None, origin, False) + Bitmap(self.windows).to_wire(file) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + next = parser.get_name(origin) + bitmap = Bitmap.from_wire_parser(parser) + return cls(rdclass, rdtype, next, bitmap) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/NSEC3.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/NSEC3.py new file mode 100644 index 0000000..d71302b --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/NSEC3.py @@ -0,0 +1,126 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2004-2017 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 base64 +import binascii +import struct + +import dns.exception +import dns.immutable +import dns.rdata +import dns.rdatatype +import dns.rdtypes.util + +b32_hex_to_normal = bytes.maketrans( + b"0123456789ABCDEFGHIJKLMNOPQRSTUV", b"ABCDEFGHIJKLMNOPQRSTUVWXYZ234567" +) +b32_normal_to_hex = bytes.maketrans( + b"ABCDEFGHIJKLMNOPQRSTUVWXYZ234567", b"0123456789ABCDEFGHIJKLMNOPQRSTUV" +) + +# hash algorithm constants +SHA1 = 1 + +# flag constants +OPTOUT = 1 + + +@dns.immutable.immutable +class Bitmap(dns.rdtypes.util.Bitmap): + type_name = "NSEC3" + + +@dns.immutable.immutable +class NSEC3(dns.rdata.Rdata): + """NSEC3 record""" + + __slots__ = ["algorithm", "flags", "iterations", "salt", "next", "windows"] + + def __init__( + self, rdclass, rdtype, algorithm, flags, iterations, salt, next, windows + ): + super().__init__(rdclass, rdtype) + self.algorithm = self._as_uint8(algorithm) + self.flags = self._as_uint8(flags) + self.iterations = self._as_uint16(iterations) + self.salt = self._as_bytes(salt, True, 255) + self.next = self._as_bytes(next, True, 255) + if not isinstance(windows, Bitmap): + windows = Bitmap(windows) + self.windows = tuple(windows.windows) + + 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: + salt = binascii.hexlify(self.salt).decode() + text = Bitmap(self.windows).to_text() + return "%u %u %u %s %s%s" % ( + self.algorithm, + self.flags, + self.iterations, + salt, + next, + text, + ) + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + algorithm = tok.get_uint8() + flags = tok.get_uint8() + iterations = tok.get_uint16() + salt = tok.get_string() + if salt == "-": + salt = b"" + else: + salt = binascii.unhexlify(salt.encode("ascii")) + next = tok.get_string().encode("ascii").upper().translate(b32_hex_to_normal) + if next.endswith(b"="): + raise binascii.Error("Incorrect padding") + if len(next) % 8 != 0: + next += b"=" * (8 - len(next) % 8) + next = base64.b32decode(next) + bitmap = Bitmap.from_text(tok) + return cls(rdclass, rdtype, algorithm, flags, iterations, salt, next, bitmap) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + l = len(self.salt) + file.write(struct.pack("!BBHB", self.algorithm, self.flags, self.iterations, l)) + file.write(self.salt) + l = len(self.next) + file.write(struct.pack("!B", l)) + file.write(self.next) + Bitmap(self.windows).to_wire(file) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + (algorithm, flags, iterations) = parser.get_struct("!BBH") + salt = parser.get_counted_bytes() + 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/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/NSEC3PARAM.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/NSEC3PARAM.py new file mode 100644 index 0000000..d1e62eb --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/NSEC3PARAM.py @@ -0,0 +1,69 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2004-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 binascii +import struct + +import dns.exception +import dns.immutable +import dns.rdata + + +@dns.immutable.immutable +class NSEC3PARAM(dns.rdata.Rdata): + """NSEC3PARAM record""" + + __slots__ = ["algorithm", "flags", "iterations", "salt"] + + def __init__(self, rdclass, rdtype, algorithm, flags, iterations, salt): + super().__init__(rdclass, rdtype) + self.algorithm = self._as_uint8(algorithm) + self.flags = self._as_uint8(flags) + self.iterations = self._as_uint16(iterations) + self.salt = self._as_bytes(salt, True, 255) + + def to_text(self, origin=None, relativize=True, **kw): + if self.salt == b"": + salt = "-" + else: + salt = binascii.hexlify(self.salt).decode() + return "%u %u %u %s" % (self.algorithm, self.flags, self.iterations, salt) + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + algorithm = tok.get_uint8() + flags = tok.get_uint8() + iterations = tok.get_uint16() + salt = tok.get_string() + if salt == "-": + salt = "" + else: + salt = binascii.unhexlify(salt.encode()) + return cls(rdclass, rdtype, algorithm, flags, iterations, salt) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + l = len(self.salt) + file.write(struct.pack("!BBHB", self.algorithm, self.flags, self.iterations, l)) + file.write(self.salt) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + (algorithm, flags, iterations) = parser.get_struct("!BBH") + salt = parser.get_counted_bytes() + return cls(rdclass, rdtype, algorithm, flags, iterations, salt) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/OPENPGPKEY.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/OPENPGPKEY.py new file mode 100644 index 0000000..4d7a4b6 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/OPENPGPKEY.py @@ -0,0 +1,53 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2016 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 base64 + +import dns.exception +import dns.immutable +import dns.rdata +import dns.tokenizer + + +@dns.immutable.immutable +class OPENPGPKEY(dns.rdata.Rdata): + """OPENPGPKEY record""" + + # see: RFC 7929 + + def __init__(self, rdclass, rdtype, key): + super().__init__(rdclass, rdtype) + self.key = self._as_bytes(key) + + def to_text(self, origin=None, relativize=True, **kw): + return dns.rdata._base64ify(self.key, chunksize=None, **kw) + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + b64 = tok.concatenate_remaining_identifiers().encode() + key = base64.b64decode(b64) + return cls(rdclass, rdtype, key) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + file.write(self.key) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + key = parser.get_remaining() + return cls(rdclass, rdtype, key) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/OPT.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/OPT.py new file mode 100644 index 0000000..d343dfa --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/OPT.py @@ -0,0 +1,77 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2001-2017 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 struct + +import dns.edns +import dns.exception +import dns.immutable +import dns.rdata + +# We don't implement from_text, and that's ok. +# pylint: disable=abstract-method + + +@dns.immutable.immutable +class OPT(dns.rdata.Rdata): + """OPT record""" + + __slots__ = ["options"] + + def __init__(self, rdclass, rdtype, options): + """Initialize an OPT rdata. + + *rdclass*, an ``int`` is the rdataclass of the Rdata, + which is also the payload size. + + *rdtype*, an ``int`` is the rdatatype of the Rdata. + + *options*, a tuple of ``bytes`` + """ + + super().__init__(rdclass, rdtype) + + def as_option(option): + if not isinstance(option, dns.edns.Option): + raise ValueError("option is not a dns.edns.option") + return option + + self.options = self._as_tuple(options, as_option) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + for opt in self.options: + owire = opt.to_wire() + file.write(struct.pack("!HH", opt.otype, len(owire))) + file.write(owire) + + def to_text(self, origin=None, relativize=True, **kw): + return " ".join(opt.to_text() for opt in self.options) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + options = [] + while parser.remaining() > 0: + (otype, olen) = parser.get_struct("!HH") + with parser.restrict_to(olen): + opt = dns.edns.option_from_wire_parser(otype, parser) + options.append(opt) + return cls(rdclass, rdtype, options) + + @property + def payload(self): + "payload size" + return self.rdclass diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/PTR.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/PTR.py new file mode 100644 index 0000000..98c3616 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/PTR.py @@ -0,0 +1,24 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 dns.immutable +import dns.rdtypes.nsbase + + +@dns.immutable.immutable +class PTR(dns.rdtypes.nsbase.NSBase): + """PTR record""" diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/RP.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/RP.py new file mode 100644 index 0000000..9b74549 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/RP.py @@ -0,0 +1,58 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 dns.exception +import dns.immutable +import dns.name +import dns.rdata + + +@dns.immutable.immutable +class RP(dns.rdata.Rdata): + """RP record""" + + # see: RFC 1183 + + __slots__ = ["mbox", "txt"] + + def __init__(self, rdclass, rdtype, mbox, txt): + super().__init__(rdclass, rdtype) + self.mbox = self._as_name(mbox) + self.txt = self._as_name(txt) + + def to_text(self, origin=None, relativize=True, **kw): + mbox = self.mbox.choose_relativity(origin, relativize) + txt = self.txt.choose_relativity(origin, relativize) + return "{} {}".format(str(mbox), str(txt)) + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + mbox = tok.get_name(origin, relativize, relativize_to) + txt = tok.get_name(origin, relativize, relativize_to) + return cls(rdclass, rdtype, mbox, txt) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + self.mbox.to_wire(file, None, origin, canonicalize) + self.txt.to_wire(file, None, origin, canonicalize) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + mbox = parser.get_name(origin) + txt = parser.get_name(origin) + return cls(rdclass, rdtype, mbox, txt) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/RRSIG.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/RRSIG.py new file mode 100644 index 0000000..8beb423 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/RRSIG.py @@ -0,0 +1,157 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2004-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 base64 +import calendar +import struct +import time + +import dns.dnssectypes +import dns.exception +import dns.immutable +import dns.rdata +import dns.rdatatype + + +class BadSigTime(dns.exception.DNSException): + """Time in DNS SIG or RRSIG resource record cannot be parsed.""" + + +def sigtime_to_posixtime(what): + if len(what) <= 10 and what.isdigit(): + return int(what) + if len(what) != 14: + raise BadSigTime + year = int(what[0:4]) + month = int(what[4:6]) + day = int(what[6:8]) + hour = int(what[8:10]) + minute = int(what[10:12]) + second = int(what[12:14]) + return calendar.timegm((year, month, day, hour, minute, second, 0, 0, 0)) + + +def posixtime_to_sigtime(what): + return time.strftime("%Y%m%d%H%M%S", time.gmtime(what)) + + +@dns.immutable.immutable +class RRSIG(dns.rdata.Rdata): + """RRSIG record""" + + __slots__ = [ + "type_covered", + "algorithm", + "labels", + "original_ttl", + "expiration", + "inception", + "key_tag", + "signer", + "signature", + ] + + def __init__( + self, + rdclass, + rdtype, + type_covered, + algorithm, + labels, + original_ttl, + expiration, + inception, + key_tag, + signer, + signature, + ): + super().__init__(rdclass, rdtype) + self.type_covered = self._as_rdatatype(type_covered) + self.algorithm = dns.dnssectypes.Algorithm.make(algorithm) + self.labels = self._as_uint8(labels) + self.original_ttl = self._as_ttl(original_ttl) + self.expiration = self._as_uint32(expiration) + self.inception = self._as_uint32(inception) + self.key_tag = self._as_uint16(key_tag) + self.signer = self._as_name(signer) + self.signature = self._as_bytes(signature) + + def covers(self): + return self.type_covered + + def to_text(self, origin=None, relativize=True, **kw): + return "%s %d %d %d %s %s %d %s %s" % ( + dns.rdatatype.to_text(self.type_covered), + self.algorithm, + self.labels, + self.original_ttl, + posixtime_to_sigtime(self.expiration), + posixtime_to_sigtime(self.inception), + self.key_tag, + self.signer.choose_relativity(origin, relativize), + dns.rdata._base64ify(self.signature, **kw), + ) + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + type_covered = dns.rdatatype.from_text(tok.get_string()) + algorithm = dns.dnssectypes.Algorithm.from_text(tok.get_string()) + labels = tok.get_int() + original_ttl = tok.get_ttl() + expiration = sigtime_to_posixtime(tok.get_string()) + inception = sigtime_to_posixtime(tok.get_string()) + key_tag = tok.get_int() + signer = tok.get_name(origin, relativize, relativize_to) + b64 = tok.concatenate_remaining_identifiers().encode() + signature = base64.b64decode(b64) + return cls( + rdclass, + rdtype, + type_covered, + algorithm, + labels, + original_ttl, + expiration, + inception, + key_tag, + signer, + signature, + ) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + header = struct.pack( + "!HBBIIIH", + self.type_covered, + self.algorithm, + self.labels, + self.original_ttl, + self.expiration, + self.inception, + self.key_tag, + ) + file.write(header) + self.signer.to_wire(file, None, origin, canonicalize) + file.write(self.signature) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + header = parser.get_struct("!HBBIIIH") + signer = parser.get_name(origin) + signature = parser.get_remaining() + return cls(rdclass, rdtype, *header, signer, signature) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/RT.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/RT.py new file mode 100644 index 0000000..5a4d45c --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/RT.py @@ -0,0 +1,24 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 dns.immutable +import dns.rdtypes.mxbase + + +@dns.immutable.immutable +class RT(dns.rdtypes.mxbase.UncompressedDowncasingMX): + """RT record""" diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/SMIMEA.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/SMIMEA.py new file mode 100644 index 0000000..55d87bf --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/SMIMEA.py @@ -0,0 +1,9 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +import dns.immutable +import dns.rdtypes.tlsabase + + +@dns.immutable.immutable +class SMIMEA(dns.rdtypes.tlsabase.TLSABase): + """SMIMEA record""" diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/SOA.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/SOA.py new file mode 100644 index 0000000..09aa832 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/SOA.py @@ -0,0 +1,86 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 struct + +import dns.exception +import dns.immutable +import dns.name +import dns.rdata + + +@dns.immutable.immutable +class SOA(dns.rdata.Rdata): + """SOA record""" + + # see: RFC 1035 + + __slots__ = ["mname", "rname", "serial", "refresh", "retry", "expire", "minimum"] + + def __init__( + self, rdclass, rdtype, mname, rname, serial, refresh, retry, expire, minimum + ): + super().__init__(rdclass, rdtype) + self.mname = self._as_name(mname) + self.rname = self._as_name(rname) + self.serial = self._as_uint32(serial) + self.refresh = self._as_ttl(refresh) + self.retry = self._as_ttl(retry) + self.expire = self._as_ttl(expire) + self.minimum = self._as_ttl(minimum) + + def to_text(self, origin=None, relativize=True, **kw): + mname = self.mname.choose_relativity(origin, relativize) + rname = self.rname.choose_relativity(origin, relativize) + return "%s %s %d %d %d %d %d" % ( + mname, + rname, + self.serial, + self.refresh, + self.retry, + self.expire, + self.minimum, + ) + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + mname = tok.get_name(origin, relativize, relativize_to) + rname = tok.get_name(origin, relativize, relativize_to) + serial = tok.get_uint32() + refresh = tok.get_ttl() + retry = tok.get_ttl() + expire = tok.get_ttl() + minimum = tok.get_ttl() + return cls( + rdclass, rdtype, mname, rname, serial, refresh, retry, expire, minimum + ) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + self.mname.to_wire(file, compress, origin, canonicalize) + self.rname.to_wire(file, compress, origin, canonicalize) + five_ints = struct.pack( + "!IIIII", self.serial, self.refresh, self.retry, self.expire, self.minimum + ) + file.write(five_ints) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + mname = parser.get_name(origin) + rname = parser.get_name(origin) + return cls(rdclass, rdtype, mname, rname, *parser.get_struct("!IIIII")) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/SPF.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/SPF.py new file mode 100644 index 0000000..1df3b70 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/SPF.py @@ -0,0 +1,26 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2006, 2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 dns.immutable +import dns.rdtypes.txtbase + + +@dns.immutable.immutable +class SPF(dns.rdtypes.txtbase.TXTBase): + """SPF record""" + + # see: RFC 4408 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/SSHFP.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/SSHFP.py new file mode 100644 index 0000000..d2c4b07 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/SSHFP.py @@ -0,0 +1,68 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2005-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 binascii +import struct + +import dns.immutable +import dns.rdata +import dns.rdatatype + + +@dns.immutable.immutable +class SSHFP(dns.rdata.Rdata): + """SSHFP record""" + + # See RFC 4255 + + __slots__ = ["algorithm", "fp_type", "fingerprint"] + + def __init__(self, rdclass, rdtype, algorithm, fp_type, fingerprint): + super().__init__(rdclass, rdtype) + self.algorithm = self._as_uint8(algorithm) + self.fp_type = self._as_uint8(fp_type) + self.fingerprint = self._as_bytes(fingerprint, True) + + def to_text(self, origin=None, relativize=True, **kw): + kw = kw.copy() + chunksize = kw.pop("chunksize", 128) + return "%d %d %s" % ( + self.algorithm, + self.fp_type, + dns.rdata._hexify(self.fingerprint, chunksize=chunksize, **kw), + ) + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + algorithm = tok.get_uint8() + fp_type = tok.get_uint8() + fingerprint = tok.concatenate_remaining_identifiers().encode() + fingerprint = binascii.unhexlify(fingerprint) + return cls(rdclass, rdtype, algorithm, fp_type, fingerprint) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + header = struct.pack("!BB", self.algorithm, self.fp_type) + file.write(header) + file.write(self.fingerprint) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + header = parser.get_struct("BB") + fingerprint = parser.get_remaining() + return cls(rdclass, rdtype, header[0], header[1], fingerprint) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/TKEY.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/TKEY.py new file mode 100644 index 0000000..5b490b8 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/TKEY.py @@ -0,0 +1,142 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2004-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 base64 +import struct + +import dns.exception +import dns.immutable +import dns.rdata + + +@dns.immutable.immutable +class TKEY(dns.rdata.Rdata): + """TKEY Record""" + + __slots__ = [ + "algorithm", + "inception", + "expiration", + "mode", + "error", + "key", + "other", + ] + + def __init__( + self, + rdclass, + rdtype, + algorithm, + inception, + expiration, + mode, + error, + key, + other=b"", + ): + super().__init__(rdclass, rdtype) + self.algorithm = self._as_name(algorithm) + self.inception = self._as_uint32(inception) + self.expiration = self._as_uint32(expiration) + self.mode = self._as_uint16(mode) + self.error = self._as_uint16(error) + self.key = self._as_bytes(key) + self.other = self._as_bytes(other) + + def to_text(self, origin=None, relativize=True, **kw): + _algorithm = self.algorithm.choose_relativity(origin, relativize) + text = "%s %u %u %u %u %s" % ( + str(_algorithm), + self.inception, + self.expiration, + self.mode, + self.error, + dns.rdata._base64ify(self.key, 0), + ) + if len(self.other) > 0: + text += " %s" % (dns.rdata._base64ify(self.other, 0)) + + return text + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + algorithm = tok.get_name(relativize=False) + inception = tok.get_uint32() + expiration = tok.get_uint32() + mode = tok.get_uint16() + error = tok.get_uint16() + key_b64 = tok.get_string().encode() + key = base64.b64decode(key_b64) + other_b64 = tok.concatenate_remaining_identifiers(True).encode() + other = base64.b64decode(other_b64) + + return cls( + rdclass, rdtype, algorithm, inception, expiration, mode, error, key, other + ) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + self.algorithm.to_wire(file, compress, origin) + file.write( + struct.pack("!IIHH", self.inception, self.expiration, self.mode, self.error) + ) + file.write(struct.pack("!H", len(self.key))) + file.write(self.key) + file.write(struct.pack("!H", len(self.other))) + if len(self.other) > 0: + file.write(self.other) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + algorithm = parser.get_name(origin) + inception, expiration, mode, error = parser.get_struct("!IIHH") + key = parser.get_counted_bytes(2) + other = parser.get_counted_bytes(2) + + return cls( + rdclass, rdtype, algorithm, inception, expiration, mode, error, key, other + ) + + # Constants for the mode field - from RFC 2930: + # 2.5 The Mode Field + # + # The mode field specifies the general scheme for key agreement or + # the purpose of the TKEY DNS message. Servers and resolvers + # supporting this specification MUST implement the Diffie-Hellman key + # agreement mode and the key deletion mode for queries. All other + # modes are OPTIONAL. A server supporting TKEY that receives a TKEY + # request with a mode it does not support returns the BADMODE error. + # The following values of the Mode octet are defined, available, or + # reserved: + # + # Value Description + # ----- ----------- + # 0 - reserved, see section 7 + # 1 server assignment + # 2 Diffie-Hellman exchange + # 3 GSS-API negotiation + # 4 resolver assignment + # 5 key deletion + # 6-65534 - available, see section 7 + # 65535 - reserved, see section 7 + SERVER_ASSIGNMENT = 1 + DIFFIE_HELLMAN_EXCHANGE = 2 + GSSAPI_NEGOTIATION = 3 + RESOLVER_ASSIGNMENT = 4 + KEY_DELETION = 5 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/TLSA.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/TLSA.py new file mode 100644 index 0000000..4dffc55 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/TLSA.py @@ -0,0 +1,9 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +import dns.immutable +import dns.rdtypes.tlsabase + + +@dns.immutable.immutable +class TLSA(dns.rdtypes.tlsabase.TLSABase): + """TLSA record""" diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/TSIG.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/TSIG.py new file mode 100644 index 0000000..7942382 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/TSIG.py @@ -0,0 +1,160 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2001-2017 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 base64 +import struct + +import dns.exception +import dns.immutable +import dns.rcode +import dns.rdata + + +@dns.immutable.immutable +class TSIG(dns.rdata.Rdata): + """TSIG record""" + + __slots__ = [ + "algorithm", + "time_signed", + "fudge", + "mac", + "original_id", + "error", + "other", + ] + + def __init__( + self, + rdclass, + rdtype, + algorithm, + time_signed, + fudge, + mac, + original_id, + error, + other, + ): + """Initialize a TSIG rdata. + + *rdclass*, an ``int`` is the rdataclass of the Rdata. + + *rdtype*, an ``int`` is the rdatatype of the Rdata. + + *algorithm*, a ``dns.name.Name``. + + *time_signed*, an ``int``. + + *fudge*, an ``int`. + + *mac*, a ``bytes`` + + *original_id*, an ``int`` + + *error*, an ``int`` + + *other*, a ``bytes`` + """ + + super().__init__(rdclass, rdtype) + self.algorithm = self._as_name(algorithm) + self.time_signed = self._as_uint48(time_signed) + self.fudge = self._as_uint16(fudge) + self.mac = self._as_bytes(mac) + self.original_id = self._as_uint16(original_id) + self.error = dns.rcode.Rcode.make(error) + self.other = self._as_bytes(other) + + def to_text(self, origin=None, relativize=True, **kw): + algorithm = self.algorithm.choose_relativity(origin, relativize) + error = dns.rcode.to_text(self.error, True) + text = ( + f"{algorithm} {self.time_signed} {self.fudge} " + + f"{len(self.mac)} {dns.rdata._base64ify(self.mac, 0)} " + + f"{self.original_id} {error} {len(self.other)}" + ) + if self.other: + text += f" {dns.rdata._base64ify(self.other, 0)}" + return text + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + algorithm = tok.get_name(relativize=False) + time_signed = tok.get_uint48() + fudge = tok.get_uint16() + mac_len = tok.get_uint16() + mac = base64.b64decode(tok.get_string()) + if len(mac) != mac_len: + raise SyntaxError("invalid MAC") + original_id = tok.get_uint16() + error = dns.rcode.from_text(tok.get_string()) + other_len = tok.get_uint16() + if other_len > 0: + other = base64.b64decode(tok.get_string()) + if len(other) != other_len: + raise SyntaxError("invalid other data") + else: + other = b"" + return cls( + rdclass, + rdtype, + algorithm, + time_signed, + fudge, + mac, + original_id, + error, + other, + ) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + self.algorithm.to_wire(file, None, origin, False) + file.write( + struct.pack( + "!HIHH", + (self.time_signed >> 32) & 0xFFFF, + self.time_signed & 0xFFFFFFFF, + self.fudge, + len(self.mac), + ) + ) + file.write(self.mac) + file.write(struct.pack("!HHH", self.original_id, self.error, len(self.other))) + file.write(self.other) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + algorithm = parser.get_name() + time_signed = parser.get_uint48() + fudge = parser.get_uint16() + mac = parser.get_counted_bytes(2) + (original_id, error) = parser.get_struct("!HH") + other = parser.get_counted_bytes(2) + return cls( + rdclass, + rdtype, + algorithm, + time_signed, + fudge, + mac, + original_id, + error, + other, + ) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/TXT.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/TXT.py new file mode 100644 index 0000000..6d4dae2 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/TXT.py @@ -0,0 +1,24 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 dns.immutable +import dns.rdtypes.txtbase + + +@dns.immutable.immutable +class TXT(dns.rdtypes.txtbase.TXTBase): + """TXT record""" diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/URI.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/URI.py new file mode 100644 index 0000000..2efbb30 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/URI.py @@ -0,0 +1,79 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2007, 2009-2011 Nominum, Inc. +# Copyright (C) 2015 Red Hat, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 struct + +import dns.exception +import dns.immutable +import dns.name +import dns.rdata +import dns.rdtypes.util + + +@dns.immutable.immutable +class URI(dns.rdata.Rdata): + """URI record""" + + # see RFC 7553 + + __slots__ = ["priority", "weight", "target"] + + def __init__(self, rdclass, rdtype, priority, weight, target): + super().__init__(rdclass, rdtype) + self.priority = self._as_uint16(priority) + self.weight = self._as_uint16(weight) + self.target = self._as_bytes(target, True) + if len(self.target) == 0: + raise dns.exception.SyntaxError("URI target cannot be empty") + + def to_text(self, origin=None, relativize=True, **kw): + return '%d %d "%s"' % (self.priority, self.weight, self.target.decode()) + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + priority = tok.get_uint16() + weight = tok.get_uint16() + target = tok.get().unescape() + if not (target.is_quoted_string() or target.is_identifier()): + raise dns.exception.SyntaxError("URI target must be a string") + return cls(rdclass, rdtype, priority, weight, target.value) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + two_ints = struct.pack("!HH", self.priority, self.weight) + file.write(two_ints) + file.write(self.target) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + (priority, weight) = parser.get_struct("!HH") + target = parser.get_remaining() + if len(target) == 0: + raise dns.exception.FormError("URI target may not be empty") + return cls(rdclass, rdtype, priority, weight, target) + + def _processing_priority(self): + return self.priority + + def _processing_weight(self): + return self.weight + + @classmethod + def _processing_order(cls, iterable): + return dns.rdtypes.util.weighted_processing_order(iterable) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/X25.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/X25.py new file mode 100644 index 0000000..8375611 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/X25.py @@ -0,0 +1,57 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 struct + +import dns.exception +import dns.immutable +import dns.rdata +import dns.tokenizer + + +@dns.immutable.immutable +class X25(dns.rdata.Rdata): + """X25 record""" + + # see RFC 1183 + + __slots__ = ["address"] + + def __init__(self, rdclass, rdtype, address): + super().__init__(rdclass, rdtype) + self.address = self._as_bytes(address, True, 255) + + def to_text(self, origin=None, relativize=True, **kw): + return '"%s"' % dns.rdata._escapify(self.address) + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + address = tok.get_string() + return cls(rdclass, rdtype, address) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + l = len(self.address) + assert l < 256 + file.write(struct.pack("!B", l)) + file.write(self.address) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + address = parser.get_counted_bytes() + return cls(rdclass, rdtype, address) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/ZONEMD.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/ZONEMD.py new file mode 100644 index 0000000..c90e3ee --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/ZONEMD.py @@ -0,0 +1,66 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +import binascii +import struct + +import dns.immutable +import dns.rdata +import dns.rdatatype +import dns.zonetypes + + +@dns.immutable.immutable +class ZONEMD(dns.rdata.Rdata): + """ZONEMD record""" + + # See RFC 8976 + + __slots__ = ["serial", "scheme", "hash_algorithm", "digest"] + + def __init__(self, rdclass, rdtype, serial, scheme, hash_algorithm, digest): + super().__init__(rdclass, rdtype) + self.serial = self._as_uint32(serial) + self.scheme = dns.zonetypes.DigestScheme.make(scheme) + self.hash_algorithm = dns.zonetypes.DigestHashAlgorithm.make(hash_algorithm) + self.digest = self._as_bytes(digest) + + if self.scheme == 0: # reserved, RFC 8976 Sec. 5.2 + raise ValueError("scheme 0 is reserved") + if self.hash_algorithm == 0: # reserved, RFC 8976 Sec. 5.3 + raise ValueError("hash_algorithm 0 is reserved") + + hasher = dns.zonetypes._digest_hashers.get(self.hash_algorithm) + if hasher and hasher().digest_size != len(self.digest): + raise ValueError("digest length inconsistent with hash algorithm") + + def to_text(self, origin=None, relativize=True, **kw): + kw = kw.copy() + chunksize = kw.pop("chunksize", 128) + return "%d %d %d %s" % ( + self.serial, + self.scheme, + self.hash_algorithm, + dns.rdata._hexify(self.digest, chunksize=chunksize, **kw), + ) + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + serial = tok.get_uint32() + scheme = tok.get_uint8() + hash_algorithm = tok.get_uint8() + digest = tok.concatenate_remaining_identifiers().encode() + digest = binascii.unhexlify(digest) + return cls(rdclass, rdtype, serial, scheme, hash_algorithm, digest) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + header = struct.pack("!IBB", self.serial, self.scheme, self.hash_algorithm) + file.write(header) + file.write(self.digest) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + header = parser.get_struct("!IBB") + digest = parser.get_remaining() + return cls(rdclass, rdtype, header[0], header[1], header[2], digest) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__init__.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__init__.py new file mode 100644 index 0000000..3824a0a --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__init__.py @@ -0,0 +1,68 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""Class ANY (generic) rdata type classes.""" + +__all__ = [ + "AFSDB", + "AMTRELAY", + "AVC", + "CAA", + "CDNSKEY", + "CDS", + "CERT", + "CNAME", + "CSYNC", + "DLV", + "DNAME", + "DNSKEY", + "DS", + "EUI48", + "EUI64", + "GPOS", + "HINFO", + "HIP", + "ISDN", + "L32", + "L64", + "LOC", + "LP", + "MX", + "NID", + "NINFO", + "NS", + "NSEC", + "NSEC3", + "NSEC3PARAM", + "OPENPGPKEY", + "OPT", + "PTR", + "RP", + "RRSIG", + "RT", + "SMIMEA", + "SOA", + "SPF", + "SSHFP", + "TKEY", + "TLSA", + "TSIG", + "TXT", + "URI", + "X25", + "ZONEMD", +] diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/AFSDB.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/AFSDB.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..79beeefb762b093fb3a18e5feb131df7c23954e4 GIT binary patch literal 1061 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 QZU!i4DkwX@WkNpVFBu7q2><{9 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/CAA.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/CAA.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..7857b5eafea366830dd0bd251b6f151e7db94397 GIT binary patch literal 3361 zcmbtW&2JmW6`%d&az#?B57$l;N33nhUZ*u{yO0bgaO)UOV53pnSSU~y$acLulviHv zvNKD`Vkkf@1cYi6$U<7shaTi!l0cWDe?qT4)B;^d-TIIsz4)e>J_Nb6Z+5vP!zeD0 z4#?SgAM@tpz2AHD*KAfr(9XTNUHV%Zp-&i*G`TZq{{aR~WFwn%Q8E5gNgbOY&`P`GmWa_t;+`BPUg37nE+nStYb`ODSdmQS2uIT_U=zMd!8 z@`px?Du7ZcK1L7|_)~$l&+qm$CL#@J@MeHpWT<2z? zvJ7G1oj-H-T!A_P{!YcTZkzL%7Hp3e;`M0Z^6bwF5JG1v%VY>vsAU+DobVWM=+B}1 zY!y9Hvg@fG<;cCmTT>4eeeck7&9^q++Pd00bh;tFtL}{*ZeH5Fv~_$d`0z$+>@4t< zz2VV~x7Xi(cjeLO3lEM?w?=0kWM;lN@jbN-=8@Hn4j|awvAwka0v%)l=1Uk2wxAPz z2rY<%GT^cM8fajr>+_x{iHNUdFUn;-TWplrD+x6?2_Ti9t*MjM{3OjEo218dISv*9 zybwynHUksfjHzW-oYHd7_qs?}G74ot^1S1PD#0$mc+sihkiWe|*_l~5ka4D!3Vb8L zcY@jw^IwNJ4HEh~bgO7@`1!qzwsC#^`lHP7#rd4tXY+3ym%f?Zn_%jTes4gsY01srhB~V>SfxO?*9gReOPzp(8 zE6V>dH_b!RVF|0Asw?&Mb|gub`3f zW_C0C{%}Lu%Z+S!>s~AO;%;toCpX#3ooonu+E_EUnQLkJUG3zKcCw}E4e1}lqjzWS zy|#7r!}EWVTEo*1lLGX$|$?OcYq$DID;84&_ z_5iwu?5@3c@#gxMPZtydo- zxLe5c(h?M69Lf+>RVxTZmV`SAz{Or4+~pYVV##rFs91ivLNKLKoP`<7^n4G>yUWne zxs=^}e?%z|dB&1Ma3_CvsEeRRUFaYID47j)UH#p3^X1K#?*&_P9~AEwTVvmSsGJ4t z-xZt6rt;f28rt#mxRjNFA4J)Xh)k7rEM-RJ=(9ESFY%Qpkl{|R zUVAFa(o1bklGObil1D!N(Tyj9EX}k9Aoh7S(qw63Ujy<9FLne^*(eIM$g-{yR_nqn z)YLQhj)g1i9ZU{)c}}@p4a}Q>tTa=Jt8SzXxg2|dDiWr)rB|Ta7dVbmk}?$bM#k7cex`w+>xjJx4D_d Y@eO@l-zcmX+6YKEDgWH3Ob{*dU)u1d=Kufz literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/CDNSKEY.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/CDNSKEY.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..373c9ded33e233d3140a81f71817dc0b4abde658 GIT binary patch literal 721 zcmZvaF>ljA6vyw*PEt%`p-NQg5W$co13pn!ghY$QP;gNzA?oGi_zvR4j?LMLWHzKq zz{J?kfWj9+Oqn7b8%%7ijD*yQJI9t6Zg}tap5Oo8-Sd6#b`2oc{>k$7HywaqDyUbx zg5s-$3qS#dA#h>oQRz{LBF)tz-PNO(+k$|>$#yMo{Qq(YJOxxc2UM3Dv#G6Va;v7s zPj(uvX{l{!StVQ}hr`xy6*)sqv`_4p$49o%PVE;$caI(0uL?^CtDsQbE&wa9=OPMS zEk{z`Ieg-r9@%H_%nI&u=Es~mLtShUGV>xvh%g9=Vmc2MZxix%?uFHt4k0x53HbsF z)#>^b9>)>GJYgA+7lA*a8G(=9xDNnb2e?c2%z0 z(~>-8`N&HdS7YV!MF6h$5;q!Ir>Yi4Q!b3noDP(8I)19IVX2+Qcgp Q7eJ;94WPX%RZw>O2dX!t?f?J) literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/CDS.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/CDS.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..6ec3ab3ca921e07c2bd4d1a1281b8fa641b0bbfd GIT binary patch literal 829 zcma)4y>HV%6u+|_$1x3GqE(ApgcO#j!lxFoR0xSuiHQu91urMZcQkgL*qoh6W<#n( z5d&lS2RfkqDNLS%%mQNSmdZ?>c;`5x1qN<-@ArQ9zV$vgnaY0RHq zf#M^8Bg7EH0kUza6&rKx&pqZ5p#Q}w=m}!V0b(k|80VZT=$AcQ>Yg=L1Rz1YE|E=d=KA&`k{i}a-$CxQh_3$yajZ|yb za`o}f?rRgoZNc48Frh%u2?o(=H*$m0fz#)d<|d{6kPQQg7btx-bb{)qPALmrpj9@A z^SWS38u2*SS=@DEp6ffi+fpx4=I!w~p#dN4B|X|rsdW5=3fbk^bJ7d@oQQ}gA{=>c zkGLV@N&zZs3gjnf*SOuH%M zCd)i+BX2@2%j@@tiPH_ZkOz@pmt0lfss?ZT_PHd(<&}u$JdwB}QJMD|pflsaY`qV~ zBA9aj@ivI5iZL$kAiVe$txR>K)ZVVWS)1VH3@`swbgUn?{v4t}Ko=@fR!*fuS>qS0 C>8=X^ literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/CERT.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/CERT.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..471424a44a764a9564ad62f9a2483ef141a0d917 GIT binary patch literal 4449 zcmcgvU2Gf25#Hn7@s58-Nv8fR*`aI84gDilwj$ZB{O{UU>PUuV$1PFxO7Tw8(G;of zon%X(5Csqr3TbQmp^yU=Sa17Cz*#_Cd%$*qIAJCyKA~mFWv3*YV8JV_cyAdM0lQw zbw9_^h{;|1(eRH=ZVVcey>|JU$q!o+e%KOm!zlBfyI={0;cADyc^%Y8hcCwb&ly=YIx`YuO-W7}^E0YEJ}+mJ)2hi%s)osGS!3N}a(AYZhRMw7ctO$VH#g%`xoI^{ zXHwB1hzz;iEU+ZcTwE^u)icm zm(EoLacQvOC`y)*h6 zN}WqKa`yZ6fbbM5Iq%nA7Q2dK*Tah?ao^7GNB4n#3jQuR#^3%qh~5LoPzeTo!lN(= zc9JNb-!loWKqeT4T^18Ogf_R#B)qENBM{{LGUJAn2qEu%-SKzpLChyrm2LxhBo}^u8wq?lktmE`~B0Kl;pLDr8UEJRy zSl5A5M+9x2uhYe-wFq=E^cyJet<%N0wrHN%{^B!veRf8rrYOr=Rx@PT^vg+Io`p#3 z8=$X)GK~Q-tZ=M7b-hhZEOO-@%c6Q)3wR3@qGrq>Rs+7i}tmNG0RTS~I5 zs?lNACFhD4Ifcn{pyL|QRUw9JsI+T_+HBg& zr?oNm(unB|1ZyM6H;}Wx;W}{|6F>u{F%>irtcPi#fhHIYocAN<*USXB0Oy84^NcJ6 zdh}?I5=E}Z0u<4rW?qv895n;Lbk%}x-SnMvBTaB1#&RB>DoG;=o;IG;)q#F(V%~Nl zo*siWO)rG!q?R@PRLvv}ZBAQIP0#H+)?PY>ndL9Gw|pOl3qi|Us$1Lyi9Q7k0J?sG27K2CEl*ifiY$hP>%g{reANGf@J;?L!u$NT_qaC?JEMIq_&DF_J?u`o z(E&Wiii<*?-3d+{y+!eV+9e~9-O&Y6=26E;W{RUPZ7VYF`dB6M40S^Ep zf@)sKi+Nu@uu+Ydu_{yrtn_R8p%9QEn`zleyI+N>LD+2tHTxi6K=Vjjq1 zE}-gk5`Zo{DQk+F#T21Z04p_%C4=d;9n$oT5A-XLOB59n44ca6^f<2Ek1MlA?l#3N zNl)W2RC7|<$kpP(hDjC{vV2>|^2x?Io7?Vt0i+9(<-YELe+Dvr2^fH#NV<=#U3fgQ zK2ka|RO&i~KHSo}+WVll)bgEz@GR24I{IL=964Hy94$u%i;=-6?5ENvQt8B%Qe?Q` zt4Pgd>3C5(UXtD@OG8Czs3e^(u+Q4M%WVgXZ3iFerMAO`z+b~H_Xi(d+C0$z@#K^F z&kmQuZ*Pik+m2nI*U%)EV}AyndRW{E6afl%1VWIyPzcLZ38Xu~;zkun7x_H%?U@jA z@Xi_}jaT15j@vP0o~#43ar>@ZIUf^DFL>5$$}l;s4jYZh-+{70wV}#uLlrlnWmHp4 z<)&w-s_T|tn88#so6AD&kwN70!pwwrSI2j*Gd*Nn0IWM2Rh?v49crMbUj_#F)!e?? z^`NT~Y`K529ElYpv9rPNGDmSYTk1Ee~d@vIFj-$hkq7jXg$ zsIQmF-?-M7B5A(LEDgWn1b%S4Md1BgEyUaW<>=T;R^)Fn+boQ>JXSZt^F3PWrb~vi4A$o}M+5;}APOoVDu# zOA*jj%|hHzx*yl=L>5Jc<%a2VAEZCPF@GH^3F{>5#6A^%*?c1o*;js=reTQpqJIQz zi)9#Q`v762FG%Ps()I<3SidIV5J#d^5keIqSP`IO_rn#Tsp6C1_o6kh%d-^T>Lwwn z5)4%W!3uQjz7&SfzDhuXAE>o>mZX>69Mk$z0tPqe;osZy?w&H!QDiz^dE(41rf~e; Y$(57$&a9l-COC#`_jJCnrmVO47jH|SQ~&?~ literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/CNAME.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/CNAME.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..71bc66f7e8e52427f313e3e2d691585248f493e6 GIT binary patch literal 844 zcmZuvzi-qq6tafipk=feZ|ww#EQbI9V&!8Or{TGr$u-j8i~NmDBo1T)~Mx!&QD_UG+cmr;#9|iuf#VB8o#RmYjy?4RHg^O0(!fxfNZMm6#TB$>b4!zfAAuR3yc7&-6`tMYE|-)jl8*Ib#df7ewnM8C6FYDaDM-?~b}9s=fyhY^rofioUCApg zx$NxHvV>Kj00K+_4P+rLsGOn(0ct~sx~E=y?2 zyjHRER70(H{+ES!^6WMf)g>AO<*YjigdK-&jXcT>zCTTSLe3BVH}C^#{~p+P4*l^Q z`1%vB7^{<6P7~JTqNvGQY>g{QdOSh2geI~=y9z_i+6F7b#j|4_RNr6 zFBRdKe)zGN6PK}c3iL+*D&i3MqMn$t0Z8Z#U*hBEg@Urc1p!+k|AP$Uv zTbEq&0VsAkm*3(2HIBGs9uGUzTwy10u}hTj=TR1*b-1~)F4;(zlM3Zr(di56@Lapc zNr!8$817#Yoor|IDBy&WaI5GhOXNOR$R$0|u2pr4fo4<;hXq>6R%%AYxp;x%4IuJ@ zh376&Jl;zhwo$R2QbpBSGaVBdo2`UeG}i=gWP5*oF5x2W$45(0#W`_T|)iyeSWD4Q`)(DChPDh8xzVwLRM! zc%~lvW6xgyiH5SNY`@v+ABTBzKYe2B+^3fwrqAyWoZNc*L#zJU{vZ$^D<3JXLD=#^ zFAHEbav2k&afsIT;*O;_`faCUU0|O;j$~0|&Zu}vs+%RpxMeKs9>1{Y z#ZcVFfMXW-4SpJ?%PHUBfyO*6*%zS$bEo_7Y7KMKY^9&tO^-LzCw*&Teh3@V3}99wANA?Uw2#M?z2Y$CN0+EO> zJLnzO=DSY`);cg;N$}t=gsvNRWjC=C0Bwd)tS^vYlXJQgM0GSllyDw~A-M)J7 z%7aU-E+<5p1r$b3_$N%j3EWXma3aIcM@9zmp#8J}jtXPoY>qexDb^t55$lIq1fwX= zbp%{4_{+yOCT^{^?R-zQs7y!=ppWnb>AI~(r0+mcW2%41D=Z2S7ZT4a{r zL0(!BS0pFOPe)~=E_B2rbcn9x#=Fq*3pfyJCqsvCRv!@=7N%$brCOp;S#vTy2eMtj zkbH)Z4J;sj(mxNBjY%#9fuDI^fR*KeE(mn#eigU82;C}qG(569Jl-50zjviId|^FZ zAGq7kFz|FU`}DnmR`%H+#{eYH>p7uty#QU|st^2LidmQwH&7ef#bOL z7~%T9Cda?PFZ~6{Fk0g&D2<% oz%m$%KXHHpV5c8$`Z+gMzq~QMKD}{m{aTyAlnMWr2a4VAf5O40Bme*a literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/DLV.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/DLV.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a86c23966ea75349ac374c0f4343c52a9a9320db GIT binary patch literal 631 zcmZutziZn-6n-Z;wxh;S+NLCsK*3o|h>o~xD8v}Lv>w_LsFp+4U1GVCrAo3v*#d#2 zQ%Cn-DE?DAc`{tLcIuX*PMPxVEYk-1hWEbjdp~*K8Vw83+HYp3(ggUa$jYiED83+= z0tZe4aEOkELj)PFDpnmB|EC%761Z^*+{B*xKgA^+>KpFs!;Sk~u^C>d<1&C#%So&9 zOR=6;YC4dT6b}(hLFlU;gA>Qhjg~3R?yHk?3*ECscu~T8t%|HOHgZG3n6wxRBR&ok z-eBzG*bT}|jWHg1jD3YdZMc0$2T>?!5{oQ}CcZbIUc?1`?WZ2KCt@_Af#0Wbo(-bW zbNjGOQ$G_2vFm+s&qPZ3D5VL{@)+@P?>)tX>^M&2+}olm++(VBvD_|daEuQ z*lYV?IL_RDAf$;@K2lma&*o|0O@&ljA6uz^a#I#N-A*fPHs}5Zu@$*fC+-{vQpA(;-uJ%uF7JC!{+!P*0bx6j#)q#o0Dj11 zZrK#XCjyKB1{nIlhDlUxNMLi`F@GWA|2PFa1XvjYtco}KLURh6iH3`O)3}(+Y^=_> zaayu-Jy_Cy%FJ?8E(uDS#6m0+ z%`E(t+)z%9?+7;n1JD%lUu&ki7Wsj=(?A_)V{uh!5cEI^S|x>NBZt;W#B))IUV4-W z9U3G4A=eH)pK#p`TWv}hjYuoxsLDk36tu!q@6!C8)1u>v`r!!c0IRY zx*;a!fyZ34(j`IH^u3zd?nR9-xLLWeV=^xy<+kHKcj|}6%lA&I(fLntqQ>8Co%-zwbe5XW~#F` z*-_GYUTjkFTCGmx)WiW*k@CxuOSh{8tmZJnFa7Pwr6rzCYlSDl{O$x>k7vWLNCkfc zo$I$|J5=d)QGnvd?h1FRLI~q+0Iz-nYo}SDWZrJP*_guO1QyQ}4OZXXJKjIqpBkGJ WV{>YhCq_92f{s<7to@P=$&BB4?#)&J literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/DNSKEY.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/DNSKEY.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..311aaf994d092522157e72c3848d7e6cd88464e9 GIT binary patch literal 718 zcmZuvzi-n(6uvv#Nij7-l_+6|Kq^ZHd}>({5{QVQ;G#wX)g4Zb?;uX?*qoh6W<#n3 zOpN^-Q20L>m@-8=HkjC2840Nqcm5$S-0;5dJ-_e0chC3TvP>Y)-r@4~Hywaq%4trg zCdF4t&Hx1zhQNg-q7qSvBF)tz-PI$*H6UPcy4lEE{9g=#r+{jwfa+3nt<7!N^m@Zu zoNl$eVN0!I%R1niIUE?jmFEmJ(K#HxJlG!!Z8Ur#boam+`gLLnuyzX7?F_K;dM={S z)pDfdPn^;I@aUaY;T_KWm{VtT^ z#hhk&BKafd2v;-NNzS{ndTDM;k{Z&Sf}i?LZZ+}2RbffF9YoPQ^Tr_)nsmjsiq$1; z$xm25_EN^xPPu#zfU8>KN-OKu*}`nog;`DVSV_xK)ElUpt3P|W@t|7JL%uCtwe$3u zH0K(Gu(%80jUS-@x1&RJ0i-$K0?7E#f8Srj-U{~qAP9RON1u;B9j~pOm9?|B?3HB~ PK!ytqpj#Izq3re#&bgxG literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/DS.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/DS.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ee69788146ef0c3b3bfc71c43b33f21b4d0afed9 GIT binary patch literal 628 zcmZutzfaph6n=LONlb}U5kQ~_sX|>c)ThE)A%P+>HA6ks%gOOw8>e>c+D;^QLqckq z7~x+){3)F>A(^dAY#?`H;@!m&Md};g`@Zk})cf6PEd$!_r>ifw2EeT%3#(V4yg+ac z0t5-bAv#irNHSVfEIKg$Por=If}Vgdu&4P?aRo>EhL`$i8hjq+7dF ztnXEt4x}RGYXs*Y_0A+28VLsP1s#H<0a`m2lh&A(lrW&p{yh8NY{4oE(e$qy& zo|zt^yEh0Sp>Oh9Z#M7i(UW# literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/EUI48.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/EUI48.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a651c82e431949c5276af954838bd514991f250b GIT binary patch literal 716 zcmZuu&x_MQ6n>K*ZCp~jBD!^9=?db~gB@Hwco4xAab>XwLBU*xG&9=Nw5ds2Oc8Wp zLHFcw`!7iU6i+=>;z>O9R*9!Q`6f-!1?TYI_kHi1_g*GnE0s0Cv-@=V^1TM|QUCAcm!NI03(J zfpGkQFXRU<2W6ujM}m2xpBRyN z8%gv9QtSk$&uPc+2^tJU6!;_8=}^b#fw zRqKcQLA5Y9jHH4sn{KZ+jO?~25*2B3QEK^^rWm?yI~2*ezov3tOUgyDjEn4{YqiID z**_byj_B05yLzyDK@F*V(QpsLQYD0>*MVI64x7soDEh~(!>u`~%}DLHQX<=*9(+DH bKA4;JnOUEkJ2P`91(Z`2lqMWZCp~jBD!^9=?db~gBf-ePa?P?t}ON-D45HTW@c?_+H{k&nBu{O z1?|b>_Af|(il?3`@g$yltHjfue3Pc=f^&H9`@Z+hdyko~EVaBYZ_twLO=7n8!1m(T9s8yZ>K z4usjLKZd4+q~W8{?a!_hWln zshu1Im6f@!CuMADx}8oxvYVbrRHVsOspVr#(RZ76D3VKmO{Kh+lvc$OF0zlVo(X=}c$(GkNQa6}cmI>xXpm#G8Y8Nb}O3yQ^KvKfwvj zG+LwbbJ&t-D5}o#26V<<~(P;Dv5}9!%vM?rCm$h2yCaYEd-et`8-5ROKJxs;8 z2c(xsQ8gm@u<%c07hj{v9#osBp}V!VNcDFhgg2=mVU{!*wXCGA(`cYyqck{^jX)7; zGKa$3ea4uRgFY*wO=uKpDD7$(T5DSRV`><=h>T~YjL2D<{tPr6rABFu5*^0;TQ$1Y zdNS>6^C){YDjit4vZdYQG*_N%<(l3~w?_YeR~|;gXggB9)^4K+KSiM@x%(k>nRy)z zQ88x%6VrLHi&Q&FMJ#KPRGo`Zp%||-87ZqXVph>z(&dztSLIw*cOA>&ftNAPVcjV! zqTDB|I;Z3_@NvJE%nV8<&ml^woG8T@ogKQERCP8Z^@1Rl`!1>qG44nt^2Mw1i@5cw1kcjt4@#}!$XcIA_){$!t|#6hz- z7S-WAv=1d-kH7MxQ)fH#!}@yRQZgfpNmUYhGr6QHC@Pk-eYhEx-30&2zo8mK^G


;2R%GN!lt$XIScCC~P7LVN6Kf`_Ceb@VYeVi!v4=6`H*-0Lqu`yDFnxd-?@>K$0rgUVetZundPH`d0_1eMkmwb;amw<)9$xf`4&b>Yr|1`*4IH=R z5&3asOM0R2YUul*?{4V(3+OV{6F7@v0i7k6JmMjB1cQlT5loEFBvn}*6eZo2$z{PJ zNs~`zOk%1L1v%K3fvq~2|L-V3S9|LdfP}vSzD8;E-5Rcfmyr=h(HPa9$>J-)C4AnJ zwfNYhdMuj8SeQ7l@`n3Yu@KPzj`$~Mf(tuZUN#;i7ek3u|1`>Z|GzZxS_B5lRA zQRYje*d9-q&U^a_4=8?P1LFOo|jN*rd{-Y3Wx2i1`KTU9CSxIkRMu2WT4wAT=-m+3+)Tuck9-1pT zMduT*#9MZ74dQall{oj{Kd@S#vEtZkf3_Mgjd(94#farGHFB@T?|o^+XYegQiUk4Q z2lEovc|nk~vMLC=TUO+(q9(H`N#_iR)fqXf>I?v_?h=xUaA8=L6a#QEIWtW14NT5V z_nVMxt&hn?VB#Z~;F2DwvF+tuI;%*TUfqesR3@n?y2FJ0<@2(=Fr}eQwhwd=3}Hb~ z$hAYPG0GSYlZD7FjQEUbVQuNVKvFs&`h5;@f%i=~OMJ`phMD#`J~r=ZE?#_}oAb1P z_{_bZ{85>E=E(epP1AdSGg>%Kc=G$rbDkX^zHm?eC^Wb8<@uJUrcb=>FPwPXxN2y_ z)WOMvGaa{&-rHUdbrtw(xMeCanV9LmE#5m)4(~0vR?5utTc$71@g3wlOf;+Yt1XcN z`%7PSV=H|8Rxc2$1X@c0pj9E#wB6W0y=Nx+*1q|s=BZtiyDCkwQd8`9XSu0+*4teT zhAY8nDHttqRZpralt23{@b$+REyxjD{toH>7G+TCJ;#?^!T0k2SY$W%%cpoar zys308SB0)!zz1r`YLlRmwlTI&wW0%zuu-?pU1Nmp`Cn~>g<=q4=)?$rWi(>^#W>y3 z3)xOmHI0qr`E^T`Qu0R1-qx9;A0*yQRHEIbXm>ff@BXzo0H9?$33;JawR zQW85gr^aipyR|z#i|$Z~7^S=WBr6e%xpgL$QSc5>3wJ=JGit6McamlVRUFH-zDFqdOpk4yNF}L|!=!VB;{s zhV7LzklLnl19>bdis3W5H^l`i`A(2rXK-5hK1oi_SGzNk6t=!bX1`2zl} zBlwrf4Q5qIG}EIPk4f6m0E3Qv5-Somk#K3=q!1)9@6-w@K?CE+wF>6Ak>)z|HIQW( zsk{i)82Ti%u@c%@3hgY1b`b>JR0%&@3O`#8cM=S2e*t{9YvDy=1k+q&h};d>-fE6{8Ltc7w^m;~x@+ul80*Ntuiw#3;NIsKy<=WIh)* z5K&T*-^!HhP<=j*{>3&w-hVP>T%o7HFdx z^m45WPecD9&DL3@x!^?(|7SGKMTtE8lmsovQ%qW$O>47hrraYUXPl*>SB1 zeiG}nf2%XzRwhjz7#LKO7a(@HhzN!s$C4%oGA}6$aRVE#HQiO0bu{{wMhhLjBMYq}mtS5zSrSe06h$YAI1I hkLXhr6)o((**(#H^Tml57ZK^hmg$Y387yOe{{HH literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/HINFO.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/HINFO.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..1fc418db7454a1323616d689281adac677c22cfd GIT binary patch literal 2991 zcmcguO>7%Q6rR~1d+qoqO+yn(OPfNIT1jKt6xvc06)Lp^s3Y16fe+nocQ?rIL5HuGeXmM!Ca-5Bww{be9RW5%8GmSHP5zhBTZ(X?MnH&XIX<7Q9(Zb2>L1 zshOzHo2_x^4AQt6r15YjR@bd@!;LkrJ}>hwzw9lgLz6fm++$Ko_12up(?iuuAYO&{ z>nM#i1nMoNoXNE2spI-mzbNDFI$8SLL6X$@Ks_Ck74i)hk@ zop2FN;B>=zl!)5mn|-O%{ZkQV+DmlRB$~~u`B9rQsVZ)G8spjPs-FV+5|@zWZ_bJZ zbRG5!xWFxQ?lMLNG`#V=r(NJRtZ_Ae6p&o|;-~2gPv{G^YbQ~HPhGh87sv_G7U^hS zC$=QZM$WKg*$&AHl`l_PIwkBGgylsdU<*{w4A?=UsTqY*J3usR5)S$*a87o%WSO!f zd)b(N^j>nv%<4&!*DYd>8R}3{H8nkX)}U&#drZ%bB{Rn5WPZ{bGIKrMhYlyHVd)3+ ziaMeU>NKh4XwtojCSOl|kaXPLou4EukEdd;SbO?DSfj53c{q)3OVQcjiqyK;Qf|K` zCDyjLlzJC>%P*9zrSp~Thl;}I(puAwQuji4xv6|%si)GEEDG0yRXB}Q-?bpHZ)t%4 z>W@GG7I+u~^Te>c;2|{ZySc719IW#-4uT8-d~z&%w*Qko2ilKYtl6t27o;winhNdv z=*qsmj6hri118BTmd%5!ZINh-r9dcksw#P7V6qF+wi0i<9f{BN&GxNE_N+wq zl!b4kucb;PakJ;!<2R14cJ{7x_I_vmF#i2`rSnXc=NiN7hzo_uHZY=Y^ec;#1G7uO zlu&`+EKVA}$<=&vCHN0?Bo5%k;8_S3q-8I*;6*+~Sojjy4ri4KIiu$Wtsy22>Xu9` zV&n!BA*cr#N}`}gSh=%#%N!vsOl)OhwC+LKGV7kEA=qWEbcXBC&;T*Bu1DjpNBxB^ z(55c~nMUgpiZ{*WW^+q?F;|Io75TMjYV^G6p?mrpGpcgK$|9Q{>#Zi^&+AD;I#wAWfXgm}|x;O_@~l#7Kx9pyK0 z3Lw3WL0UCObC#~TeK8Rv&%?DFkR8Y?gzCfvx8D*eOZLZL+~}Z|`C4{QOzqf!<_+t; zaFQm0Ortxo=G9pHO02ySJHP9k}g*svR%{+`vLS8JpVRtT#- z((b! zJ#QIijx_sgMm9TYDVG5!A*SLsJVzUT5j{O_Ry^D3ZN78Gq zAA8A35ZTAlQ$W^vjB)ivgkyJ6^Y84h5$JjVapKk8AMakptt+_o0oQ>K7EiI(H`hPg RUqv9omvYbk$u^uz{sz9lUswPD literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/HIP.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/HIP.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e1b9853916e3dd3c974f222ed9d0159a5e9dd35b GIT binary patch literal 4827 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 UcVqLh3c@rTfM@RuGDNif7iqfL7XSbN literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/ISDN.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/ISDN.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..380f1bfef3c9195be1b73160d430e3b6a05b707c GIT binary patch literal 3451 zcmcguO>7&-6`uX&l3a?UBwM0nyD}5k-q;aqF|DK8j?%_eYQbUA$VE}2#b&*`l1cF| zvrEaMsaP$9hH{%qEK*Pg0z^Gkg?ey+0?DyG_0WqMx*)st!9`BKsi6-+F72D;E+rd^ z0_4z<_;%i#_ujmj_vV}Vdm!LL(8gZhp1A|PPYB~S-s!a8gH8=;NTV_++4)jQ+U6PO z%Q{~!N$Yf4bY1Lz_mk1+Rix1?NMpdJXIIzlr9*CS_q)w>`rD2u>0P8G_7UL{sw1;M zjvi{i0qollzmAfWh9FKV$!N63%+g7=f@Ua`DESE;!Md8qn&nY64eN$s`HbQ}B*f+T$s zXZx2xen-`i*&STv%IF;!FH>cDo9>7yR7UB&_KtR$(I|~}cczSFckN%K&pxHky3;Nq ziAh|2^k3j5&f<(>LC2OL%c)$-lx52+D~5b+(bNr0!oZ|LB;H~TJu_o@u%>1dSS^n= za}f-?DqttuL$YiTlM&LEKmSqedOoYia6vb5emRt)XM@kKP&G8oGP+qj+Oz zqQbrtY=bpYyBiA(S&1Kh?JW875KkMsF@fM+hmg(Gx~g;_Z^M_?bM; zDyGFijx7#rim5;i>4vHlQZtKoVM#0|C}Z(?oSIGLEFac0ikX^Em2``qTQJD}k}|^t zLoAP(mrebKSrYBKaJZ8&WXu9tMlFAEZQ}MstM6E|??k=t#Dh>@&0F<0L(kMh&um`$ z!Jd$Yy>{&l#A2mPKI1H>;bnVd7M7)(Vh5*0TyA3b0H@&sjn- zXQx)TxOpX0)Fq$As2KwXzyT)Lg2jMKJV4k%!UlG84U^gBVDZkZWJe8Bd?fju)+qt+ z49;geMbKjxL6?salb-=uMv%e2!?n@sXrnh;@wCGI&2Y3Hj&3RU!qGppr_C;s4}(RonUrTyk9~!y3Dyp z-1Q5$%f6ltj)p={#C^cAx8r8!E0dY}i5&k4L@d!Z%O7!vX+NBFvbR71+ zQ(fEwhP%h&p^A&DX|d!Ia&Es446!q*jBW{PK3gC+zFn-As4BU9E~P3Nf=X0o_wsXK zNr3W|7gAVv?<R7+hy-VpVL2M=Mk-7+R0tUa0g`7FvS1=3Di>`>opf z>iG?G^M{STllO&Fj(Gir+J)+c`@%@aK3EMl#1XLfiRRXJVtKppBYE(%B*nWx!xt26 z=(vM5-S>+@&e9WL60*UAWKQl_ln(7;${z6~7#iOLvWy<~4mNwAtM@+F=sg3_;tx0d z!*%~~!+&&>`q+OQz@!;DTaTP=bRgu&7eR0LKtp-mVfpL=3st$@{|g|3|1k5ZSBxT)5EL z$(Jz6B3Z8S3XmO!qNw(>i0b(S_5X|fhk)+zi00lt`tzerYOqcXKBmX0@k)Gce06+n TVs)a8fQ6OPk^hhZdy@YF`t-lP literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/L32.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/L32.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..80a0f8f4cd1af386d9814790907aba4aa158b324 GIT binary patch literal 2496 zcma)7-%lJx9G~62-P=1j;OJ2SrBVq^w~cHH6tGmIiK#zQ&!pu+@1g5#qh8O=2U%;yYM;~hXs(x%?J5-^bRul zWn>DlCivgIe5TE|{@rHQh7kHTqEI2Zz$uA8n3XpoUob^^sQw9YIk|#h z@}@Au7ZMdT&6$a1xgeS;Q(Wc>5>BR&nKq?mF8&AEY%!A%OW~y1YRXNKbOl}K3N06r zlA*%+k>SNOh<<_%mzXqNB6u1T>=>A)Y}e3zmy8S>fNDGvps{n-zX0(KS4DmtS`o|W z7UY(>GQYuxZVr{vZ1egkyDV&Qp;|^-k?S-mF7n^-82dIJi=%JOA{Wpr)iRyhOK)Zm5Avtz+P-o zkU~?M7KAj-V@vwkSb9FCUU7?9B_-?=ciu9tsD^7|^#jW@)S-Fo%&WF_SuHL2S6pXg z=+v<4Sw4QXq#IZD8SJU1hqR(5)ie6N11-ak?6JzYuMY~ShW+wK|K>KVGfQ0sZElDO4Yhjqw^kp+Y4 zE%2*PfT%L8VctLPK!rdgdcEf89rT?5tl{&|xqgM;14&7c4CGPCCDx4P&@{oe?pyQL zBBuP+YaSyE!;P@((4_BbKECcRwy>K<#$kwfeIS<5PUqpOx~gtwUs*r8{`S56-Tdaj z$Y%TKraVeIA;U<5Xbkoy0T(|41#TqFMx1ISu(?qapC=*Sj7O9d$7LQcVcabz%kl<0 zHjImiu+E_HG(Cg;h*q?X>6VEd-%`-CTRyj1>e0&x|qrCMl*YuXi!oC zDeqJkBkxIq;y+?VPYRh#{pD)0T~?Y`8_}i_kXMgVI(*cU;FZbQ>7%F-)6Y zPKM{zu2}>}l^j_|AD`>r?l%yISqg>4)-IBQ#Q-Se@8D zG`MwWaNWG;+;t%Qvpn`MkNCg%Fa8JrrI`O>S^5Y6NiVy6h7q6Oq7J>*nNgDDCGa-! zUMlIt!z84B+($iDv;j(uHqa4JngOMSD;9Gx(VM)3urA{JqplaXyN+#j9jkR62fpWe zw{yq0a>r}A6P45+-&3{rGn?|604m_Xlp^G(@*wi(!ZL1U-w8)A;@~@>6lX{^m`%)<=lB>?X%5}lS}VCO$g$ddYThY?@CC@KKk(D z6G0Rw>H-+MJk#2EaU51i*(bapP6mOeObhNEY_G^<05+!?Ao-A0EYA7*Wg8O)C`~aR zF?C-D;x|H63_aon76|rufWrM)<9;rm4Z(VYybdP2k;jx>f#bNkgt)fHDEBMsfD`lL njlM7Ywz=*tuKOwfGB;TnxUH-xx78K3j=+TD@;!gDK(PH^|4t2` literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/L64.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/L64.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b8db10387076e5ef5ff58a351d4145ccea7cb917 GIT binary patch literal 2953 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

MJbt-T(S63Cza`hFs27DKc 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/MX.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/MX.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b04fd41191d6d9df3bf76447243c551fc9461f51 GIT binary patch literal 628 zcmZutzfaph6n=LONeo0n4OE~A385|-@Tss?NU$(DL%XD2PLA)|IJIMAI}z@Ngan;B z!oPs{Q#xfrap}Dl8hD=iw=zc(}mc}T)~mP;kiCqea;oT!wYqs2XGoW>DGQK z*7GV&2U3x84Z$@?eYHacag3aHje^?!&!*kqNu(DgqSvhzP0q(|C^;{dIS(T-2^3!C z{B+_5Ri?qYh&;}3p;Ysq-mzg6N|wYjOQNao4Vf1S$!tIMm^GE-DGU4oi}P$4jSsBX z`z-Y{xfi?MC-p~WfbfCoDeM_ekRh7_<^3W*Ti2d0ymv(9X0cib~$ zCpKHjZ7pG|pb)9ZMo?j%0Qn`4;i-K@>WjCVYQx|M5WGa{L(1j><*ENam)#{z)%HC6 z=lqv*`~KTs^Z5*cG5zXxS&<3(7MWxKACC6hFl`WvSe!#j(ae?jkQYik|5|&N=lqX z;GJAauy{+D<4fWiDRY*%s+1%vZAq(KNv5eZu`-st%5`o~tgMv+U7Dt>oTc<=GHc`# zSIV9tYCaH(FPvJ=02yV}beR=o<{2$hMr$SwBZ0lT|-{vDRN9v@~yFa$B3)`?CN1f=&r-`4AWFQs&4z$Tx>{&nG)hGKc?!pWq zEbI3rI*U(qzvKM=L|WOKth#e$sJl*9bx5YE}LkUNY82e6KQv@jC9w@s&Xh< zb?5K~!IHMcNCp^*KfXtmi#IVEm-pDUMZ>YJ(Z~}waYq}0d-4wVq}mrq-oiX(fuien z&GvOY$moWrFW5DI>NrE#gN*IjHP1KDpVGM{pL&7d&{~jr&2SdzbBwtx5UiRPNX#;P zBS`7z=_R|o#L&?}idp{BJnRt{eA@{I<_+diz3j58;rrA=TU8E3k2+mD9Eieu%@S?#=Ar5c;3K64js^Sow4ylF4lo~cbP(%Pct*yptQCI7rz zJ2p8rt$DUjADuVM3&tGvGRnf)%;cX@Vwwv{{B$Q^9u z9&6+tyE=TWaP8zZ?|SZMH%3O$s145`W+&i*!8L|h`vi~;Oc$8%9v?u}0!^G$z1k1R zp9IKczIcZlRrxOFs>lw2T_C&6p0mNyIFWSpA;4fVCFp|&>3EJqkE1=x;5@8Bh)g&lc+zF&RwID&2vCQ;A8b7h$O^fo zkl_OxZ(Mn!IW)1BxltHw6~-Hd@n&ISP5u&sX=d~E){9r=X5Y+?G83WJTNg3i5r_6a zfB#C7F(qB@4E*1&jUV7xUj(-@e!CjL45dG;@_e8GKjtU2)V z-<4ndyUYK-M3MeWqR5>@k?L{+^cljAz#pJ6;D3TV<_M!z1G+_RPE9ctq&+DjhxMIB zS%Nr)*m{`VA!13n=noSBLDQoh%Y&V?=#d_UeQ|btJ#=4d=tyJeNOS06%#MAn!bGDm z(JValpRxl=+F4a7o-G0?o{qke!%kN-sx<6$deyZS99-vg{nrbI6KhhsZn-9iq3w8% z>wCH$b_MnzyeG(pov2Eot61z2{Nv+Du=)o1xKEkXadchfSXctFd_5Z$0)|-^5{y>w zB_Kbnl5fO8NdCQtH!tn^A!^Fpk-jjJ$5!t+&yVOa_C(B&rWYIVUk&N-A}_y_$ci#y+B*q75?i$S!IUd3J> z9`qTB4#hHmM|nDe?5FHGVDVqxGeB+$9LKd~!tME%41PuS!Ml0stwX;()Z+Fxxc#^J c3GT$&_+@ony{xTkZ2~O(hClF6RD{R>3r`1U5dZ)H literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/NINFO.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/NINFO.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..6205b079f70545a1d773a88f831216d98ddd7b24 GIT binary patch literal 640 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 QZBe*Q*uQq*D%szE0Zhlx-T(jq literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/NSEC3PARAM.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/NSEC3PARAM.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..1dec1ae3a828c3166777a5e09a783a7fb49354d5 GIT binary patch literal 3382 zcma)8O>7&-6`tYllDkV$luap-tXOv8*v=ZT2wS!j|DdQ{`A02G1+tT-Opz_UyOdU1 zF4ftkZ3$GM0s=y{4J;xpr~m~bw+AcGq3Nm4Dd{Nz0u*MLK?7*v{ z8U~r5MbxMoX_JU0bQ7neSCG`@h^Z^*e>n2u*@?54=XbQ|y+l*;M3q=a$QYA(qT5qB zhszq7Ny`y+TO%1;&zqLRS{cJuB5i-b0Zo6R;XwC0TtRjqT#gjcn;56{V-=C?JLPe@Y@06Y8v?sgpKgssu1(j63bh+=>G)JJtYS6fhYrrc`;s{% zF{!KH{0HWe;BZ!9RwE8C%etxCvg`_|uMxVBBl^rECkSMjplNLnt@N7nz$xLciQZ=olx2u&roBC<8 zg^1zVIYJX;KGDYW|9CG5te2ttb`gEa$Ce{izJK-UwF95=Qhi|eJ40^|tqZk*qb2q? z-SxhK%4_A<*3Q@Z4#8Zk?;3h1`F3*sP;J+7n8)kA{gqTXwRUX1cipP>j+EFpg$7tg zN`L~GP?yl?HvR@(g~kuY?M=lq&w=+DHMGE*hwWhfbbyi8ip~~%tW38fyt&9vv;|gW zV0D0vM{K%fs>Puc=yoVHMK;UM15O|**%avmy@&Yld~|z+Mc19k zly=k5vvW>Zg=|%~14ZHptwc^3(sxof9g%1Tr0sQmUUNb-H(YBLb)<_O(o1zCc3!r% zoA&(9wkS7w2SLGl5xPZGkH&AETt2zVd>S3BC!Sg!{a0deGqJCl*ta%%XYBS^Eit^A zI9^R0uO*%@jn?DOtg&~xZ+E}P{zd$=cz5)J@%P6+zIt!ZL^VEfkDqXV_mLt(o#_^l z`#?Z=ndxRRfN9Wz07U+WoCkRj{9ri>)(aq~e%RImxmXn2pd_06>;MiO!!C9zJiav_ zQVU`Tpg>DuF;e7-1kr#fRrLC>o#Z7314B%kwe(%XiU zfIAF}EFHQtU@<+sL5LcJ$ZiIrn-#Y&vg#;(JOg zAZumhSEuWVz9y*lR}=f!)H^e`Xa1P0C61Lw{~q7D^8D(BwXyZWd($62TZ>=3$6xdy z)E-0uws#@41q9qe0e~R?ns*Nff)<2@E893|9aDTt}Ur4RA9x&+nfF?#7O1 zdGa4%1h-QtHP3zT+__8V;8tM_&GbqKcLOeR%?Sf+3X1KpwCrz-x)k<`2AkCl&Eb`N zZkA}4<$}iPQZi=V)Rl}uYX~+hidYXFUishwM)D1vXpi0!P39TUw#J}?OQI{j!d8T` z@at3w*ZHnn;E&ADC!g`JG&NU_ zRZf;qe$MayZrFp$k%fI8S2MBQghPJ;)DN+jTr5!$^#WwGWXN6`#JmL*IQz_n;5|G;$xVW}$Zc2U8P zp!;?S{evC+XV00%u?H;29cy%R+!egljlw&=8ozR%iE@{4gMryr$R&3%+|ZT?^ZOyj z7d>!E7hA4zNpveLISlrl7(9`NwVR4IOJBea15=Nu=W+!*a}BaapejVo*cnG?aXF8} zO;CYr_g&=eL2urN{29-E-zS$~O8?Qi0NoaYF>XAIaL*Sg_BHDLf_^<)VHD!t*!|1h lo4CJ<`yYf3;Y)ZWQ5h%?RQ8njG!UJ`Z-xf`?TXxe{tL$hzrFwf literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/OPENPGPKEY.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/OPENPGPKEY.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5a30d623051ed1086a348c036efb262883fba8ac GIT binary patch literal 2306 zcmaJ?&2JM&6rb4-d+o$)NTNcZ0ZJ&a2VxZ{MFmAg0g6=BAmC8k!)UWRPS&w^-I-0m zk&#j<63Kx=4wX6dkV=&*lz*Vd-h07HtI#b6Do(wnm;>U}H@oY#OQVkBH*em1J0HLI zdoRD_a#;l9&A23mYdM~kcvedil`4bXEqe1# zHVJ)-Y-t(UGJK==V!K*pS6A!J8*-#?#HLcFfeqy^u_{`zEu7*w)cFFI_u&2%m9UNA zp135hpfZM&wUT0|ZFw1&RGP{lTeFpAoa~&oGqwsoji&6Zo$B*sR?r<>%HBZ6K#;w9 z?NagDr`JBabZc>UPd~({(YM{rsXefco=j)UO8X=DB_=E%*VsbLw@F@@EIodGPK;g7n4$^SD zs>ykfVz%FaZv+z{nuJzDxH$R{jHNeU7G}K~EwDQEnYZ9rvjxkuY2kB+TZM@Q>Mj(j z&UB&P@Mk^u)WioT3*7PPiMnacnKP6ZY?l|JGkD=b@m8US(nP(%G&p8)xX;$T`5|!d z!ysNSp=VldHQm^jFPzI=rVfxi+~zzBzn!MY*qaAPQLt7O)VPAAnz{1Okwb z5ksgFqYLI_RQj_NTLJrS0VHuq&<054;HLZo{ssd9q+*bP@LBM?sdbC^24VtZfbBiY zb1l=SF8m0iH516|&Jf3@uJ4o`%7CWS6|4(V5vW0C`pjt?ip-`)CXlTvXQJ(}9Ed>n zy*c)dSnd(aTn}jCdw~pJh6&*r@CwAk5y74*Gp`l_Khg($Vm$_*@Q*<(p=}N2hqm-n zZT-}y{^6E>zOA3%)F)TuXZpyNexR)%c*HmL@fG>^{LsUX9$j9a+RPt+q8*R&k>Cb< z353IZh>am1c&B^-BX{6#7hen=AVO0L)Y}XSFyfpVaZV{aRT^lPSF1D1c?eE0Xqm3( zI+j@l3MTa)^G^e)$Zdzwe-~$LEWkzi5Qru8R2zJdUCll`-8#E=_BZX_|2{9F+nMNj z|4X;KYC;tCZKB{HH$(j%L5vhT2wV1LK2ZfktlX?|J!-) zbDk7ih%=VZbCK1m1cFh`vR-7fI=GpUAp$`)B z)x24aJ!wL0&mtu3hHMnh3kJeIT%*ubZ8i=TW(aXY_;PWVwrI6Vh=G~-@5x0Ce-g5o zDI!#eeZp}8#Or1Br?UT*CaK3d8dfjj?G#Gwetz}FOIcNojtq-!NoYD&$3ovrNs1k> zgchbX+|$UiG1xK4L9d&jcPv`>9nWRMiOs3i=6!P-2$vBdQ8x^up)RQlWMe@l31TDS zL-o4onc@DAQFNAQgKxC+5oD9>94y5X`4ot48Drczg0TJqjr<}0c7cR@OX|I`ugA9V i-ZtL*O4^5whr_MWwb9nWwSyf5OL(a?`nPa|hx`KtulkPw literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/OPT.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/OPT.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..05e7b1ce5a47c903c9733e34e1a09627a89b2b72 GIT binary patch literal 3520 zcma)8Z%iD=6`$EZ_n!j{=4|J{=io*?*Kl#%IBi6!V`C?=1*u}Ul21vO_3i?DK5nnG zi}{lyr4dprmmC@E8T;)sqr2?O&q$x{6YO!FsKrp=(I@kUQhD^pNoDk z`MsPM455$+j@a#=#1qKNL>Cr`F2bJVu52(Wv<0Kx{DamqNyn8mWx4f$V=iZVNw za}(C2kz-}UVb*o9d``1;BR6c?TCV@PQM#Thnpbn>S!cp3o$NpHT+TKfqpz%L*VJ*t z&Via7)6vj&?xm3{IeuXKShNE=lhv7$zC5ImR#} zVno$lAXNep2>sqRMBaRZka@Wx7f^Oj3-ZK#s6w92Mh-Cn0~D$mQiJRCVK z!MqX*P}sktb=~-9gEFKbFWWB6mkT^2#gOFgLgxb}VJuWQHqGGeD3VvK=<1 zIj)3Ia%Br4XwTBw&CXQy;@ZUzhL_H5CfZgm zEMNHf_3B$|Z>>Lnv-h{zTiHKc`fUI2^R?9JyNQ>4fz_$MCc3x7u-)@?v$rr0#Nk&z z4+JV4Ej024F#LuU3NX;f9s!?_p+-FjyaD+@9ND3n$8r*CJPE)00FaA>a!kDmCY-0> zt0!m-(DO@LrQoeD^ww|0X?lx}Kz2YsImV2W6l88c-z zIM;*W;fwDEc4K`Iw{`*f2Zqe&sll7QH^h(PAI3jw*+>ok+eY)eb0|$glT@(Gk{7lT z_da_X7Tp*#imGE?M@I|SruhzZuot4=0+G3R(;dDC4Ere{;MdlDD>KV8py$)hKc;_| zzMC4XwGQ5i4E}dKV&wC990Xfc$v8%x_`mF?(`!SJA#9Lp_BI@YO&0=hy#Z#M56y=` zt~vfaF;WQ!a?gX$oJM_kQp6SzMSEH$R1t#;G9Q8068r^oh*G)Gi00jmKaB)BLE``U zM*1H3zQSJ)6*2 z$_;q}94ua1??JX?K^pOpi>D)Ec=M7%+url%IuS#Axu;>L{UMMA@?c-*Qg}1jc`w}zd3wL= zV0B_`;$GLOjjmIlPJK33>pHh8ektPGgG9&5$nwaIlXnw`x1ywVf0K$@^5}Mqv~{e$ zaO3>?%eB_ycOu8X4CAgXe(sKqsQA;7GacfeJLEIz@MBp4;VMWm`4cJhc?V{z_io#1Vdj`&681ZhLm+VOc z9wa(@5jl}Ev*0b@%rZ=YZi`>lHKSNm6!?@BaQUa4_7aB#bB3fF7lwd*wMhOhbv|f6 zv>IP{^^vqsezE>dN$#m9sQi8Suu%I$AuRXRMHp@2Xlow{CAS4ZP9rb*2uJ**`LWp; zOT(dV1m9@*5aS?sTljQFGrUI`pPG}CQ;vES3SAUe`Ph V&aUK^b9Dk!_!{BhHZE`_{{h7$4kQ2o literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/PTR.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/PTR.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f2e38265170cd9cacfa7576214347920bc37c883 GIT binary patch literal 631 zcmZutJxe1|6uoaICUG<%?z$)_2(by`Jak(TwAsoau8q??Ci9+V;(R$X35=Z}tXpmA z{sr-;Y?Uf7cDrn0r;L@A_q|MTg}ueS=bZb={ncm~fVOpbck)*U_#?^0swF6XBDet# zoOoan6*Y?p(wkIFIxzlE)8Gqm?FzV#J@tQzOW0F4yw`iP@3~}mc%h2p09Gv{t;&OB zZKu>!ASEg05Zr)JS6dnF@HuHb0pJ|Re^&|Sgr%EwrKN$IV6-oRed z_5FTocRZ2nNb`BAmGjIX>DY^=+5i9m literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/RP.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/RP.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b1eb282d0dd7829a505617209a4f2351d4c74cec GIT binary patch literal 2560 zcmb7F+i%lW7(c$oNpopQfpin1(@KYtR%=CKTDgcx6KI>rP>UulLh_95v@TAZ9lNCo zE_6~Q5@{$PZEB?LA&)`jf#>}Td!Y(bJF^F-J?*U{JRqL-9oxCU=q^X{Ip6i1U6f_v-!opZECw74b=Xkt~gLgj|$keKl3 z*^8Cv?8R}cs}|Ngws6H-@fc^tQMrL@u|SiXb#B1)9kqd+p0dWd=r-88luK{YftW%r zS{(EbtzBl53P=~p-9O#SmL0Gq=li3K?onBh^Ei8{q+?HzWus^~vJ8}B%SEN2V{$Gg z$rpK#wRJP^MX;utifwy5)|@i<^-R2|Ec+^1wu#F)8EY@*qy?*>OSq&v*jhH!1xd9u zUAkb{sx-B%7ndc|xFVIx&Vp4uKK0(TWE+nDZb?zED)YK6X+>KKPO_yBvtLNF7pF>P zOwd&s0=j$WaS+(kFg;&GzY2+3WJ}024mKwr3F6LZX5+%$3(bl4=sQ*Ro9IsZ;Ku2@ zr<>_^`bd?%Ep)&Osl5mSLvB9=U*|`dHb_iieRV7jdW6csysfg}*Nb)E`(OPyjarQK z?Yoo{?NV+pn*%bgo8c~Q0FiXI!d+h-zrHGReww@yb-}W1UBOv-eBQzZ z#qk*1!6J`I9eTWljd`Q!#k$57-J`Ew>*u?l`roDeWA9nojkggJlZ<&;Ei_jRF&CD9jM=^-S|Om zPJD0NPq*eaGwsy$Ltz?^z+UQLcu2DRa?*f+WHF0jSpeG`F6(kG-)$VLk^f{R(2#nP zQa9oXn_(*F5QgRmmE#HXy5m=g81)#{v~dFDnDi^CdFv`ZK-hzXP4q)3JJvu1NlN`P zAyW{0Ns0K;=mKllhY|^_ z9C%dHU3?7)Pk@^(!L){+r1sZu)^0YI+o?%Xr=xYNW;OEdqLx`cZIwq@UFyUxnOBaCZXf9{MC|ThMI^hYnBRPctdQ{a%@@ldpsV4t9V2Hvr^FE ziO}#kNbn??M50TCkB+LFrYwsTPJz@WE#Rz=15ASGPZ^^46sG6v=r=YERkSbD*ncOr z_VF{8;U+sVhC99+L;T2-&*q*o94B=cV0LLjC28&?IPfD+X(m)WBb1K`e|KmC33#if z^c7VvIfhmA7+?dLQ79}q$`t}&VnY7eixLWJilcbZzMcyt+$>S}``$yr8KlF$5Kaa0 zJA-F{B|mAOg=v?eD5^7osQr)8=wp<6jD~l4M02+eeSK(~%4|`YXY^Z?R87~%YGd`o SwZk0*Ec_ll_9s#JC;SB&&>LO= literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/RRSIG.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/RRSIG.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..8526334a4c2e2c3ac4c84e4e597c95cb2a6bb5a4 GIT binary patch literal 6559 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 F{sU8A7@PnA literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/RT.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/RT.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..1f3320322c779033d008bdbcaf367f9c13c03bb8 GIT binary patch literal 646 zcmZutzi-n(6nHyYoPoC?W?gGSjVBn=ZzNV!Q!BG^1O zc#Du%^DwS6Ekc-}gnWj|%)fYory}84W;~Z-5z#58f^mEhDT@6CPZv0jCO9kdsYvhn zcXzRha(*WZ>C5ntE6h@bCCiIU;|Ig%cr^C2LN@ed>uzeGHncm2Z;h@rFS7ceU3PS< zA0^2=4<|7%T}{htMytp9$?Hj|cNcPoUt#;a3C_m5owqw@sJBGDUk*ao-*-Ru bKlIPM{?gNaZ|Ut-pykR1XZxoqusi+$>-Cd| literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/SMIMEA.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/SMIMEA.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..374314f401a34a6de9549619366518ac23b955c2 GIT binary patch literal 646 zcmZut&r9P#6rM?H8-E0ZRje$69xIqZy^2slMA-IV7nV&ALz)?FYSLtrv=DDXK|Oiw z{tMDS#Zym(EbL+Tv^SS{>d7}rx~t$E-uu4qeQ)05J*w&gg12`zI{yjzw;;1u%t7)U zzz{LSu#I$_W=Y2!cV>=R2jurO37sG&4G@!|M|ow=VJF?;t=?IB%LN=aH7hWQ*5}ceulow;=Usd`1sZl)wUp94Kj7aA! z0-7oZ*)0zJ4?x9vgCht}GR8P5BE0$oeS9h+Y3^p@dSimiV_bfgFfQLV?wfbbiMlmb WwL6X4u529(jT;9;gEa-(6iGU}NU~s4TW~5#*|a6m zd!(J%U;qy=P#ak12tgqqcF=lR3t@nFT6bEH9d=kfb%@9A(4nVY1~-;(seL>P?T>x9$ z5cPyEc3I>Na*N3)t`Q~aao1*EUX`IbNe#`Sx*~dfxl$+_9#8#7unlS!N}foKA~oze z&>Ie2@dV@6qDc);ESnXxyj0fw6A70RgBDlP$}@z#&(w$$8VK2xUGg4Jh|9QagALRS zamhUB4i=YdKs*+gsO_EU=Ns$t#qawC#!a;Qoz~^MeA{@zanl{2cFz^Me5FX++gI%J zjUVDGb@@hn*Jlp#F5hT9E94_)8jg^+mlh4`NvaAb;ixL~3bu-eM{!RnF3^)vw`5kF z$um?$g@_8rDN$S##mQ2f1;yc&gcq}oQV|Ya*GdK3_5`XsEAW+QK!1>4v0hwN{TNlX zajcV3S^M^SZq6zjIl2f4vX)J4E~i<#k^7NpYq^PKqq3YUneXHlSDZPkGCA@5nVfAp z#_7d^wosTg?3`Y)bHP09+{@EH%>imB7FQ@9+G-Mo_6~dxH1;}F->i`b0*Mc7io4Rt z_ObfYpG(T#&||f?t8drOHiwjr*e~TrbO4V4kRW889969}D9m;j4yLbXQrGTEA3mG5Q7cQfN3-q^`EGZ!}aKHBuDz2u<( z%WPfQyt0?fY`wnuIyRR#FJseD?x!V1{+dV`d7nsenU28MG`y1Sg3$2Ea{$N>;K9v@ zB-nPq);~g_{jA&;|0gdAyn4W@5e|Gi4)z{29NFbV?1@9{$wTZZ7A^yV+!bBPjk~g& zaFcGT5mMo@fp}u_5do8LB;3eeUk*4G|p^)x_Nt#DK@~>hZf{4>|lJePl0r^v;d# zAJ<>~aBAn=$FF`e_3615$0EMiHom$~6)(7tuc-iE--&))&W$xf+VP+5??6Eh$2t+_ zdr=OM6q)}&Ne4#gk&1!#2<*Ut(g?}$Ht#a?h?xVWlQJ*_9$ug^;fYIFlte&WNGCTT zAqt*b!FK49=6ErDy!yh*<8M-U;o2M)E1D(4lQgTm2$`1c1J+Awg^E=%wL-}RN{biG zWdq)M$9{y*B!IF%gYYd3rOU7o+ky%hO-gRboANzrbXOYPexW`Bcsc*MbfKUApV`sc zl`4=~_Ksd#s4moB`0e@MoZrd*Vf6Q-A7B5|n}2-s)2IGA{^xN3+mO5w--nkrg&(-{ zgTG5-0k3uA4tLncoeQ1*yw*;2;3WDmU*sV~e8IcIYz+K+u$#`b{XbxSC;SQ?A^HqV zKw;@gXaWKWPD>H#lc4J24PmiBA^#1iBg%bjL~h6i0S#pQdymJj1`(^-hz+{5S0T=R z392>nWoEdRuBPikGxL3T6*QcSHz8ElL60<TMCtzw`!q48y1|(rReHt|Md92Q&EfwZ=no%mLs>0A=(AxMsUGO)8A{+SCC>juZ z->j2=#j^K-18*>Emmb7q{&Z_3!OQ!jL>T;X=GuKO$;&Mcgnbr!j|=>X{S1irS&n~$ z@huPhuD@!3a7Cui!q8p{GQtVtmS!wErd9Dc5CffAE-yKSckni$i~mO^jyyqp~0l{nb3YdaC{Rtc%? z#7O@I#GleBQzWy�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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/TLSA.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/TLSA.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..1eb3a5fa9678281ac9e61f94155d8d93443dece0 GIT binary patch literal 640 zcmZutF;Ck-6uz@fVla^^(I8M2(UA=JR2YMh!omU>Xgk!)$?+Y;!H$jXL~=KzNWjDh ze*xvEFlCB#Y-M6gdp58;HvV`DmACFE1?$1NS$e;qGXj*T-Tl@ zYdM9MCtQ&11Atq^^Q|p~VM|Swx+=79hhLjN4H-X2+zBGqs%t{0v}gOAQn5s-AF#eB z@iL|7ecLN4WlCA#PGATNbON7~DC9{L3|yx}oPcq1-@qbsjC<^^wRhOpw&^L2kloq*<0q8~Fon2xt zS^+8#8}CDysu<&}gmCo{eVUe#vT#|us7>(N7_a?NFkZddxoKQCCdS6t*q9ibV`DQz OAZIF4)_==}+~Y6429MCB{U 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 N3mvrOCt09&yaL|fj$!}+ literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/URI.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/URI.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..132981be3d911a8e2a1f6810ae092274acda6cfc GIT binary patch literal 4147 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 Qi$H`(rRV+@3jZVj0@HB!OaK4? literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/ZONEMD.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/ANY/__pycache__/ZONEMD.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c7f97a818611f0d2cb2e72607ad15d236dd77c0b GIT binary patch literal 4164 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 GFa5v5uo`Lr literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/CH/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/CH/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..dd9f2b23309c3bf7fe77cbdfb00b2b9f0baf0a52 GIT binary patch literal 260 zcmX@j%ge<81V%xt(`GX>FgylvV1N_zW`iSA>2> zer~FMQ9)`+QGQuwa)y3#eoCsoZ)S0_zFt{sUYUMQW|DqEWl2VUp0S>xk$!PzNvdu^ zVsdt3dTOzLN?x&kQ3}Y$Vtr>1{rLFIyv&mLc)fzkUmP~M`6;D2sdhyiK#M?LC>8?} fAD9^#89%BpFe-mwV_@a@z|6$W)W}}M29yE-X{Jc3 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/A.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/A.py new file mode 100644 index 0000000..e09d611 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/A.py @@ -0,0 +1,51 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 dns.exception +import dns.immutable +import dns.ipv4 +import dns.rdata +import dns.tokenizer + + +@dns.immutable.immutable +class A(dns.rdata.Rdata): + """A record.""" + + __slots__ = ["address"] + + def __init__(self, rdclass, rdtype, address): + super().__init__(rdclass, rdtype) + self.address = self._as_ipv4_address(address) + + def to_text(self, origin=None, relativize=True, **kw): + return self.address + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + address = tok.get_identifier() + return cls(rdclass, rdtype, address) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + file.write(dns.ipv4.inet_aton(self.address)) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + address = parser.get_remaining() + return cls(rdclass, rdtype, address) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/AAAA.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/AAAA.py new file mode 100644 index 0000000..0cd139e --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/AAAA.py @@ -0,0 +1,51 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 dns.exception +import dns.immutable +import dns.ipv6 +import dns.rdata +import dns.tokenizer + + +@dns.immutable.immutable +class AAAA(dns.rdata.Rdata): + """AAAA record.""" + + __slots__ = ["address"] + + def __init__(self, rdclass, rdtype, address): + super().__init__(rdclass, rdtype) + self.address = self._as_ipv6_address(address) + + def to_text(self, origin=None, relativize=True, **kw): + return self.address + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + address = tok.get_identifier() + return cls(rdclass, rdtype, address) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + file.write(dns.ipv6.inet_aton(self.address)) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + address = parser.get_remaining() + return cls(rdclass, rdtype, address) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/APL.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/APL.py new file mode 100644 index 0000000..44cb3fe --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/APL.py @@ -0,0 +1,150 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2017 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 binascii +import codecs +import struct + +import dns.exception +import dns.immutable +import dns.ipv4 +import dns.ipv6 +import dns.rdata +import dns.tokenizer + + +@dns.immutable.immutable +class APLItem: + """An APL list item.""" + + __slots__ = ["family", "negation", "address", "prefix"] + + def __init__(self, family, negation, address, prefix): + self.family = dns.rdata.Rdata._as_uint16(family) + self.negation = dns.rdata.Rdata._as_bool(negation) + if self.family == 1: + self.address = dns.rdata.Rdata._as_ipv4_address(address) + self.prefix = dns.rdata.Rdata._as_int(prefix, 0, 32) + elif self.family == 2: + self.address = dns.rdata.Rdata._as_ipv6_address(address) + self.prefix = dns.rdata.Rdata._as_int(prefix, 0, 128) + else: + self.address = dns.rdata.Rdata._as_bytes(address, max_length=127) + self.prefix = dns.rdata.Rdata._as_uint8(prefix) + + def __str__(self): + if self.negation: + return "!%d:%s/%s" % (self.family, self.address, self.prefix) + else: + return "%d:%s/%s" % (self.family, self.address, self.prefix) + + def to_wire(self, file): + if self.family == 1: + address = dns.ipv4.inet_aton(self.address) + elif self.family == 2: + address = dns.ipv6.inet_aton(self.address) + else: + address = binascii.unhexlify(self.address) + # + # Truncate least significant zero bytes. + # + last = 0 + for i in range(len(address) - 1, -1, -1): + if address[i] != 0: + last = i + 1 + break + address = address[0:last] + l = len(address) + assert l < 128 + if self.negation: + l |= 0x80 + header = struct.pack("!HBB", self.family, self.prefix, l) + file.write(header) + file.write(address) + + +@dns.immutable.immutable +class APL(dns.rdata.Rdata): + """APL record.""" + + # see: RFC 3123 + + __slots__ = ["items"] + + def __init__(self, rdclass, rdtype, items): + super().__init__(rdclass, rdtype) + for item in items: + if not isinstance(item, APLItem): + raise ValueError("item not an APLItem") + self.items = tuple(items) + + def to_text(self, origin=None, relativize=True, **kw): + return " ".join(map(str, self.items)) + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + items = [] + for token in tok.get_remaining(): + item = token.unescape().value + if item[0] == "!": + negation = True + item = item[1:] + else: + negation = False + (family, rest) = item.split(":", 1) + family = int(family) + (address, prefix) = rest.split("/", 1) + prefix = int(prefix) + item = APLItem(family, negation, address, prefix) + items.append(item) + + return cls(rdclass, rdtype, items) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + for item in self.items: + item.to_wire(file) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + items = [] + while parser.remaining() > 0: + header = parser.get_struct("!HBB") + afdlen = header[2] + if afdlen > 127: + negation = True + afdlen -= 128 + else: + negation = False + address = parser.get_bytes(afdlen) + l = len(address) + if header[0] == 1: + if l < 4: + address += b"\x00" * (4 - l) + elif header[0] == 2: + if l < 16: + address += b"\x00" * (16 - l) + else: + # + # This isn't really right according to the RFC, but it + # seems better than throwing an exception + # + address = codecs.encode(address, "hex_codec") + item = APLItem(header[0], negation, address, header[1]) + items.append(item) + return cls(rdclass, rdtype, items) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/DHCID.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/DHCID.py new file mode 100644 index 0000000..723492f --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/DHCID.py @@ -0,0 +1,54 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2006, 2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 base64 + +import dns.exception +import dns.immutable +import dns.rdata + + +@dns.immutable.immutable +class DHCID(dns.rdata.Rdata): + """DHCID record""" + + # see: RFC 4701 + + __slots__ = ["data"] + + def __init__(self, rdclass, rdtype, data): + super().__init__(rdclass, rdtype) + self.data = self._as_bytes(data) + + def to_text(self, origin=None, relativize=True, **kw): + return dns.rdata._base64ify(self.data, **kw) + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + b64 = tok.concatenate_remaining_identifiers().encode() + data = base64.b64decode(b64) + return cls(rdclass, rdtype, data) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + file.write(self.data) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + data = parser.get_remaining() + return cls(rdclass, rdtype, data) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/HTTPS.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/HTTPS.py new file mode 100644 index 0000000..15464cb --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/HTTPS.py @@ -0,0 +1,9 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +import dns.immutable +import dns.rdtypes.svcbbase + + +@dns.immutable.immutable +class HTTPS(dns.rdtypes.svcbbase.SVCBBase): + """HTTPS record""" diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/IPSECKEY.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/IPSECKEY.py new file mode 100644 index 0000000..e3a6615 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/IPSECKEY.py @@ -0,0 +1,91 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2006, 2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 base64 +import struct + +import dns.exception +import dns.immutable +import dns.rdtypes.util + + +class Gateway(dns.rdtypes.util.Gateway): + name = "IPSECKEY gateway" + + +@dns.immutable.immutable +class IPSECKEY(dns.rdata.Rdata): + """IPSECKEY record""" + + # see: RFC 4025 + + __slots__ = ["precedence", "gateway_type", "algorithm", "gateway", "key"] + + def __init__( + self, rdclass, rdtype, precedence, gateway_type, algorithm, gateway, key + ): + super().__init__(rdclass, rdtype) + gateway = Gateway(gateway_type, gateway) + self.precedence = self._as_uint8(precedence) + self.gateway_type = gateway.type + self.algorithm = self._as_uint8(algorithm) + self.gateway = gateway.gateway + self.key = self._as_bytes(key) + + def to_text(self, origin=None, relativize=True, **kw): + gateway = Gateway(self.gateway_type, self.gateway).to_text(origin, relativize) + return "%d %d %d %s %s" % ( + self.precedence, + self.gateway_type, + self.algorithm, + gateway, + dns.rdata._base64ify(self.key, **kw), + ) + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + precedence = tok.get_uint8() + gateway_type = tok.get_uint8() + algorithm = tok.get_uint8() + gateway = Gateway.from_text( + gateway_type, tok, origin, relativize, relativize_to + ) + b64 = tok.concatenate_remaining_identifiers().encode() + key = base64.b64decode(b64) + return cls( + rdclass, rdtype, precedence, gateway_type, algorithm, gateway.gateway, key + ) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + header = struct.pack("!BBB", self.precedence, self.gateway_type, self.algorithm) + file.write(header) + Gateway(self.gateway_type, self.gateway).to_wire( + file, compress, origin, canonicalize + ) + file.write(self.key) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + header = parser.get_struct("!BBB") + gateway_type = header[1] + gateway = Gateway.from_wire_parser(gateway_type, parser, origin) + key = parser.get_remaining() + return cls( + rdclass, rdtype, header[0], gateway_type, header[2], gateway.gateway, key + ) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/KX.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/KX.py new file mode 100644 index 0000000..6073df4 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/KX.py @@ -0,0 +1,24 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 dns.immutable +import dns.rdtypes.mxbase + + +@dns.immutable.immutable +class KX(dns.rdtypes.mxbase.UncompressedDowncasingMX): + """KX record""" diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/NAPTR.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/NAPTR.py new file mode 100644 index 0000000..195d1cb --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/NAPTR.py @@ -0,0 +1,110 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 struct + +import dns.exception +import dns.immutable +import dns.name +import dns.rdata +import dns.rdtypes.util + + +def _write_string(file, s): + l = len(s) + assert l < 256 + file.write(struct.pack("!B", l)) + file.write(s) + + +@dns.immutable.immutable +class NAPTR(dns.rdata.Rdata): + """NAPTR record""" + + # see: RFC 3403 + + __slots__ = ["order", "preference", "flags", "service", "regexp", "replacement"] + + def __init__( + self, rdclass, rdtype, order, preference, flags, service, regexp, replacement + ): + super().__init__(rdclass, rdtype) + self.flags = self._as_bytes(flags, True, 255) + self.service = self._as_bytes(service, True, 255) + self.regexp = self._as_bytes(regexp, True, 255) + self.order = self._as_uint16(order) + self.preference = self._as_uint16(preference) + self.replacement = self._as_name(replacement) + + def to_text(self, origin=None, relativize=True, **kw): + replacement = self.replacement.choose_relativity(origin, relativize) + return '%d %d "%s" "%s" "%s" %s' % ( + self.order, + self.preference, + dns.rdata._escapify(self.flags), + dns.rdata._escapify(self.service), + dns.rdata._escapify(self.regexp), + replacement, + ) + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + order = tok.get_uint16() + preference = tok.get_uint16() + flags = tok.get_string() + service = tok.get_string() + regexp = tok.get_string() + replacement = tok.get_name(origin, relativize, relativize_to) + return cls( + rdclass, rdtype, order, preference, flags, service, regexp, replacement + ) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + two_ints = struct.pack("!HH", self.order, self.preference) + file.write(two_ints) + _write_string(file, self.flags) + _write_string(file, self.service) + _write_string(file, self.regexp) + self.replacement.to_wire(file, compress, origin, canonicalize) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + (order, preference) = parser.get_struct("!HH") + strings = [] + for _ in range(3): + s = parser.get_counted_bytes() + strings.append(s) + replacement = parser.get_name(origin) + return cls( + rdclass, + rdtype, + order, + preference, + strings[0], + strings[1], + strings[2], + replacement, + ) + + def _processing_priority(self): + return (self.order, self.preference) + + @classmethod + def _processing_order(cls, iterable): + return dns.rdtypes.util.priority_processing_order(iterable) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/NSAP.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/NSAP.py new file mode 100644 index 0000000..a4854b3 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/NSAP.py @@ -0,0 +1,60 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 binascii + +import dns.exception +import dns.immutable +import dns.rdata +import dns.tokenizer + + +@dns.immutable.immutable +class NSAP(dns.rdata.Rdata): + """NSAP record.""" + + # see: RFC 1706 + + __slots__ = ["address"] + + def __init__(self, rdclass, rdtype, address): + super().__init__(rdclass, rdtype) + self.address = self._as_bytes(address) + + def to_text(self, origin=None, relativize=True, **kw): + return "0x%s" % binascii.hexlify(self.address).decode() + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + address = tok.get_string() + if address[0:2] != "0x": + raise dns.exception.SyntaxError("string does not start with 0x") + address = address[2:].replace(".", "") + if len(address) % 2 != 0: + raise dns.exception.SyntaxError("hexstring has odd length") + address = binascii.unhexlify(address.encode()) + return cls(rdclass, rdtype, address) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + file.write(self.address) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + address = parser.get_remaining() + return cls(rdclass, rdtype, address) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/NSAP_PTR.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/NSAP_PTR.py new file mode 100644 index 0000000..ce1c663 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/NSAP_PTR.py @@ -0,0 +1,24 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 dns.immutable +import dns.rdtypes.nsbase + + +@dns.immutable.immutable +class NSAP_PTR(dns.rdtypes.nsbase.UncompressedNS): + """NSAP-PTR record""" diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/PX.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/PX.py new file mode 100644 index 0000000..cdca153 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/PX.py @@ -0,0 +1,73 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 struct + +import dns.exception +import dns.immutable +import dns.name +import dns.rdata +import dns.rdtypes.util + + +@dns.immutable.immutable +class PX(dns.rdata.Rdata): + """PX record.""" + + # see: RFC 2163 + + __slots__ = ["preference", "map822", "mapx400"] + + def __init__(self, rdclass, rdtype, preference, map822, mapx400): + super().__init__(rdclass, rdtype) + self.preference = self._as_uint16(preference) + self.map822 = self._as_name(map822) + self.mapx400 = self._as_name(mapx400) + + def to_text(self, origin=None, relativize=True, **kw): + map822 = self.map822.choose_relativity(origin, relativize) + mapx400 = self.mapx400.choose_relativity(origin, relativize) + return "%d %s %s" % (self.preference, map822, mapx400) + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + preference = tok.get_uint16() + map822 = tok.get_name(origin, relativize, relativize_to) + mapx400 = tok.get_name(origin, relativize, relativize_to) + return cls(rdclass, rdtype, preference, map822, mapx400) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + pref = struct.pack("!H", self.preference) + file.write(pref) + self.map822.to_wire(file, None, origin, canonicalize) + self.mapx400.to_wire(file, None, origin, canonicalize) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + preference = parser.get_uint16() + map822 = parser.get_name(origin) + mapx400 = parser.get_name(origin) + return cls(rdclass, rdtype, preference, map822, mapx400) + + def _processing_priority(self): + return self.preference + + @classmethod + def _processing_order(cls, iterable): + return dns.rdtypes.util.priority_processing_order(iterable) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/SRV.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/SRV.py new file mode 100644 index 0000000..5adef98 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/SRV.py @@ -0,0 +1,75 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 struct + +import dns.exception +import dns.immutable +import dns.name +import dns.rdata +import dns.rdtypes.util + + +@dns.immutable.immutable +class SRV(dns.rdata.Rdata): + """SRV record""" + + # see: RFC 2782 + + __slots__ = ["priority", "weight", "port", "target"] + + def __init__(self, rdclass, rdtype, priority, weight, port, target): + super().__init__(rdclass, rdtype) + self.priority = self._as_uint16(priority) + self.weight = self._as_uint16(weight) + self.port = self._as_uint16(port) + self.target = self._as_name(target) + + def to_text(self, origin=None, relativize=True, **kw): + target = self.target.choose_relativity(origin, relativize) + return "%d %d %d %s" % (self.priority, self.weight, self.port, target) + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + priority = tok.get_uint16() + weight = tok.get_uint16() + port = tok.get_uint16() + target = tok.get_name(origin, relativize, relativize_to) + return cls(rdclass, rdtype, priority, weight, port, target) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + three_ints = struct.pack("!HHH", self.priority, self.weight, self.port) + file.write(three_ints) + self.target.to_wire(file, compress, origin, canonicalize) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + (priority, weight, port) = parser.get_struct("!HHH") + target = parser.get_name(origin) + return cls(rdclass, rdtype, priority, weight, port, target) + + def _processing_priority(self): + return self.priority + + def _processing_weight(self): + return self.weight + + @classmethod + def _processing_order(cls, iterable): + return dns.rdtypes.util.weighted_processing_order(iterable) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/SVCB.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/SVCB.py new file mode 100644 index 0000000..ff3e932 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/SVCB.py @@ -0,0 +1,9 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +import dns.immutable +import dns.rdtypes.svcbbase + + +@dns.immutable.immutable +class SVCB(dns.rdtypes.svcbbase.SVCBBase): + """SVCB record""" diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/WKS.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/WKS.py new file mode 100644 index 0000000..881a784 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/WKS.py @@ -0,0 +1,100 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 socket +import struct + +import dns.immutable +import dns.ipv4 +import dns.rdata + +try: + _proto_tcp = socket.getprotobyname("tcp") + _proto_udp = socket.getprotobyname("udp") +except OSError: + # Fall back to defaults in case /etc/protocols is unavailable. + _proto_tcp = 6 + _proto_udp = 17 + + +@dns.immutable.immutable +class WKS(dns.rdata.Rdata): + """WKS record""" + + # see: RFC 1035 + + __slots__ = ["address", "protocol", "bitmap"] + + def __init__(self, rdclass, rdtype, address, protocol, bitmap): + super().__init__(rdclass, rdtype) + self.address = self._as_ipv4_address(address) + self.protocol = self._as_uint8(protocol) + self.bitmap = self._as_bytes(bitmap) + + def to_text(self, origin=None, relativize=True, **kw): + bits = [] + for i, byte in enumerate(self.bitmap): + for j in range(0, 8): + if byte & (0x80 >> j): + bits.append(str(i * 8 + j)) + text = " ".join(bits) + return "%s %d %s" % (self.address, self.protocol, text) + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + address = tok.get_string() + protocol = tok.get_string() + if protocol.isdigit(): + protocol = int(protocol) + else: + protocol = socket.getprotobyname(protocol) + bitmap = bytearray() + for token in tok.get_remaining(): + value = token.unescape().value + if value.isdigit(): + serv = int(value) + else: + if protocol != _proto_udp and protocol != _proto_tcp: + raise NotImplementedError("protocol must be TCP or UDP") + if protocol == _proto_udp: + protocol_text = "udp" + else: + protocol_text = "tcp" + serv = socket.getservbyname(value, protocol_text) + i = serv // 8 + l = len(bitmap) + if l < i + 1: + for _ in range(l, i + 1): + bitmap.append(0) + bitmap[i] = bitmap[i] | (0x80 >> (serv % 8)) + bitmap = dns.rdata._truncate_bitmap(bitmap) + return cls(rdclass, rdtype, address, protocol, bitmap) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + file.write(dns.ipv4.inet_aton(self.address)) + protocol = struct.pack("!B", self.protocol) + file.write(protocol) + file.write(self.bitmap) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + address = parser.get_bytes(4) + protocol = parser.get_uint8() + bitmap = parser.get_remaining() + return cls(rdclass, rdtype, address, protocol, bitmap) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/__init__.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/__init__.py new file mode 100644 index 0000000..dcec4dd --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/__init__.py @@ -0,0 +1,35 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""Class IN rdata type classes.""" + +__all__ = [ + "A", + "AAAA", + "APL", + "DHCID", + "HTTPS", + "IPSECKEY", + "KX", + "NAPTR", + "NSAP", + "NSAP_PTR", + "PX", + "SRV", + "SVCB", + "WKS", +] diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/__pycache__/A.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/__pycache__/A.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..939d842cddea035ff796811757d4c6498b30c412 GIT binary patch literal 2108 zcma)7&2Jk;6rb4-d+peDYSSidDHM@LwUpSQcI85f+G1;}9oA!)QP425^vWIG3ZZ)SG-33{I#TScHjjY-?!B%6yUM!K{t@3Jq z(;B@$@?iWItNwW8*!IZ8=E%fPpKpzvTQTmI`jAJQ!34m-xeURte-zj{&JW~%x=JJf zoz!VE2t(o*Q7(|~jO#~5DLgxL=iNmSX*X{vJTz=yRxm3c1}qe}LpbY3s=f_=g?L{g zk1Msc-fHiWbxa~~9o!}(9AkX==Rtwe^x5bH7E;n$VOj>Aq`9G~#=sbd zMD-T1C9-3Y+Trc$*k*NXt2(}t|E*HJ_ul=B4=!z0CLUQ6Nzd44MuVOa=+HBLRnK7x zcS2@y*86C7?+nuz94nT;kFraVNeWjYIcPI7Z%Ke+qyq#a1MfmqaD5n}9R_}S9TF56 z)2=5X%LzJNyuR@eqmpC$f$uuD2cQ_-hjeTfjFjDSrHEmi>XT4gI<&`DX|1?g{PxWH zg>Now*G_KMPCnp2dOvtuwKKn3Xa8ep{|hMQ04V0afl@}GNYSz3De!0NIXMb-?ZHW| zYfB|$0u?+gg)e@LiL|@n7zfxMOL7;hDK_@_-oY>N<}Q(^)zR(h_-1u{t9t6y0I6%O zYjwSKtp%)gF*%?TK3Bfo5%63U8S4am&O^P#*q3v*mqzl8@xTE$JWk3BLd978e#k?x zbu<*eR~-S550}TlBgc@P!dN+d%^cx*jKRgnzZ!-2@1q#|5`h=9BN(^@?8P$q!>Bzy zc=X=T(&gudW}fd`)O>v>M{)C&>+ax}>)0qqH>xeu|NdStPZSETGRhC-`(R?f>SJI#I;FHfM(Cj@d+=_S|}ooYAK1Kp{11&1tGQS0VB1QkbGdY-I=7Du6NDM zCT$`k1u0UKLzN^-kJB_{AT=1 zxm+Yb=Wnb}p2`#QCmI>$Ql;|)D651MPCe3~vD8wjr_xBJ*`R_>m$D`Hx)*yb#4Irp01Lx8(cQpy<$(9IZFzY&ZYEHmK?K4+7weeZu&(=KmcC9rR z-UmZ_HTZa7ZRA(0x;-$oH88p{F#7Wsn*$e?jEAKT$koZNE3#2>c`cY8|&ko&LcV0x=-Fpg;4u>FnF)JSiEEM;{m3Lw zg#QBB?(JV`FSnmsLlSZ9;7%FgJYy7G1O=+or_RFk{5r2e{fLToK7)U^^61Ev z2${=;AG(vSkX0+v9ZyNDL6(6u6lN7E;a@=NQ-je{!NC!AZ2HuOP;QBB}I}H5v zY9v@NCS6ZNmJ>8vc$MQhMkUAg1K)LQ51`S#8|maMm@2#HN|E6?HOHX5bZ*;LX{ESa z{BC0P(zlnk`p<6kpIzfWc|Ura{S(iu_y1#V{|hc=7cS<%;ZjDpNYS+6W$>q}IXMV* z9Y9O2WlJSw0vJ3mg?|GvGSUY7VklsTEXkcewvUhl?sxHHyu}M-w=%d@8QG|eY*x;_ z9wt?-eygh2Z`Fa-uO`P-!UxQ^n*tuNB4f>f&v>Yp82f6*_R>h6F&;SJhUZFoL8usu zpA&fuwvKw@7py7ZIpT5%JaQP>IgFLl_stQW#~3^U_!p$`B7PiS0*Ua8*$E6>1NL%} z{9zp5J$mv{&%*T=hGt&uSkyeVmm|5OyPw~Dt{di9M+ak1L#;&33vukZrlo-wsKqB7 zuUsugWdPy0xbKKo=mPrQgl!U^+icE+_HD!;rX(;$O>#T5lN`9)!Uq&e0B|?mOcKl+ zm=|yJgd|(y%k|3oFd5}X@-mp%ulf|&o=z$43=?{6hrF>vdUr@4C{Vs;J~;i&=`A|A hK?h%GC+OJH#LDI6%PUuwuXG5Q(6DymZw$nn`~wnO(fI%X literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/__pycache__/APL.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/__pycache__/APL.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..731259ca4aa590c4e2262bf5df1157758869ffcd GIT binary patch literal 6902 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/__pycache__/DHCID.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/__pycache__/DHCID.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4e054defc08be0ad028b99d3dc0a9d364a463a93 GIT binary patch literal 2252 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 OF6@l2_eWG%4*VBZ@;rY4 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/__pycache__/KX.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/__pycache__/KX.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..459a745f38f5674b59e2d1aff0a7f3b04d2371aa GIT binary patch literal 645 zcmZutzi-n(6n=M3lejbzB7jmwl^9qu;1i`I>VS|CikhJkQsm|2+#QXB?Q`#(P_rRb z0w%`tFQEP@OqnW~4JNiC!_tX6#}QQG4ex#5_kQYq>2x;1*zV!^%ij*bcT3jRtU>w7 zfHUC0Q3O7!BKDC$vvtL~!^Hn-7@h&gr@$T4)BdNphO_F1>-uc#I=AfHTv)|b0Kb)^ zLF0#IBUWowKs70E8gK@py4uGa`A&`pPJxHxH|}tJPYEU!9}OBso6;nR1*OF%rLpAm z$l@(ZkLN*DXIhkU$te8{rJa9uNTxCtM5Q8AauKpAVUi1S5Nbxeg-8}83MVAZv#CrT zc@KAq4m0r}4cM#TNNBtR39SWxDqklo&|z|PFkW5Y z+I7{=8wOpqAFp1rueyfX@9HPUT{;M%@;;zDUt#;Q33%h(&fA>})LWw7FO1Ob_uY^E a5B&?bzjTe?Te^EC7`b!+Z~wFf)s8h&*74DH{q|s<>N&b~wQlQTX$W>JW$%wI zfKmk;3)OjTyBuk5sWvl5CP>5`drDv>lder4MR?Pl)-tAWl_m|%^ymg1PZ%bjizhBc z+$KMgOlu~mn_ODQ754S@y*L}am>tuiG^ZIfdnK8;7)@kVE&6FvPecc=XqhX~bn-$p zH(^}NW_Azm+!fWq@(wf@AJz1zn$e?FH70UUKNgF|4*uxOslnWY*`lx|D6oQLW|X$T zZ0q4q-v`+=c_R7?2Y>0AK3MU~1^vst)3L(d3NPLm`eNwjm0O?9e0JxZQm7nw^C90~ z6&Ei5;?p%4OA?sb$=>F*D#ZrD8voBBI$m@kkK4&WgU3#z2@*STSj z=JgTPuL{>W=lDfcRz1+?)4Xbn>aFXMR1x6l2f6P$arET^xyB8*oFpS|;Dmq60sfrM8DF0K3i|V04LJ-k4$d4^k{47?b=jED6UE**L|8L@PlG;h z+j@n*w?W^r3Ho^U4Jq%oF%E0-+MTb^|;K1=IOtn8u6Qg zKAwYP5fvqwNg9e``joh?T$nI4ouWyKY(YCAGbQX9PiBmrduRxyNG>oEq?!1bM#IpI zNG7jq=@HXQ)kHe3>u{*dA8I2S%(7uHtHRV3MaPALD_Uuq$~aRGWRtCyJJ~DU1~UB% z$iAN@&ppJ~I^$guyYF@~T-YR9+ zxh(H!l=|=a%kuV$+_lo;-7Y;N-k`KXygtc7u0uJnAVdzM*ndI=kn2tXf*X^~`%~W6 z^o!76?-x}=&UoKz`lZ+O`=Q?<*V-!cd|t?VY=WPXUEqP}S$S_>%=_|E-k+Bjs@`&% ze9grm8jwacqsnep-MXty5#`8lkrvaPNb7VX%tQMiGu=k^5`7DsTd~?p^jqfY->5#R}drrxIRQOwXoEd*%-;PL;zS7yN$>v{mHx+vo0_ zEe$OSi&ww#{MoN%-e*bQg~rDBnCito?oaEI*V3a zu@~-5M~_DQ6rGSFChLHM`^5V=WDusduPeSc``(@LlKNHZUTU%b zPtiX{%k3W(#EK~2l4hja`yPsKJP|u@t9K6H9hw_@D86O4PRyNvTiI?MpF93g+zO+X z#csH>m&Lv%v9Huoy0#d;|HdQnh($~Fh;wM^@353t(UR)CL4E?~GbK!UM#+@da0m!u zzABj=CO>@>G?1R^X93%o>gdUvswYRQo8*1A9gf@_;E^PoA=Qc0rX+`efR^%J)x8cZ zLCIH3ft6B?k|LfM#XI6DuAL&-p5n@%Vl5&#{DiL=fyOhVni)cxN@T|~hNfEKo9T(? za#}{EQ5@u_KY*f+yga!$g}~e5uUa_gwP+6>MGD1Dx7Z3Dt;$naSeOYiYC_N`maWNf z9c9(Y&%tQ@OUS0lx4r$#z0sxK=%P^W-LoXFFLd6PDs3GF?~_pY_T^u9uL9%r77kW| z;pO1grQp_ba2vGb_FJ);*qxn^NrPr!#b24 z%_hJ%;SC7YB*YQM#AHu3tZmYlgt0nO34{s3j-oUxfn%MVJNY26{eigM@{;=X;QHA& zoPkRH>!{hPn+29l(e8Ma{gpiJ2m2V}vzM;Pj~mIfxz7Hg`mbb59u2qnBf&;#)h+ZPB4 z&%plz&cM|kiyg5}rxl+$c$LF5M^cortU8{?x~wRd$K&a0k5^IDY=XUn6g{0abVXtB z54sJ%!Oxy4V;cMeK&87uLJwee1hb=dBVFx&fC-lt435Pj0<~ggfong~PWOm`0EfDw)YS$84&PZl6*10lSa%^ne zz_T(%RKdM5eOR-Cz-MiY|4KF0EFef literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/__pycache__/NSAP.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/__pycache__/NSAP.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e03d675309e19c78bac080fab7e47d00403bfb76 GIT binary patch literal 2697 zcmbVO&2JM&6rWk|de>isZVR}42!ja1g4h&VDyp=hs!Bvl-4>84`M_$kGf6hsyY9?} ze8^O36{(IYL^xDQB@XGSpd9*#^b+G%p<51AoO+{}1LD*-`(Z~kQl*ZPx9`n+^YxqG zd*fenxio@y>eBl7w1&`QVZ<#NDcw7utRR92uAyr9#Z@V=6VX?WzDiZ1(o{B{qW|5l zPeP-JNQ;OhV9btwY^+V~jJ5uEJrU~bQCBrJhl}!G!m3zNU+{_IQ1>dB-@^VWs$zm* zpSYSJ(gd!`Ei{fvVo|FqL?iMdt|qCPLL^0$MckWTBWaQZUy7r&W_ zQ4>u;-^;C;SjS;s6B+SQ(Hy#mD@EB?_;iCZUo#Bbu|31^Q-;Znu{n=&CMGK?zRYQD z+*cW~Y9{A?k`ZqX#t1J&8$qvOaA6mqExfo=o^9B0(z+BmejVEU){5I^jEF;V9&mluWo;}HqqHrYRNaVU5G+f@AzN{cr);OI2~ckAUu{V}vtYA>*-#Jre??0}n>D)aKm*+CAVYh$)!a?7@Tb&}53 z?D4q}%_IRn5L%R(*qEPmnLS}Uewxvm>DkxqdFo5oX1LggK$;DRDAjWfkIs4_rAm=? z6kL1|!~%LSu;uGFbn<~LX+6(!4?QMkEL9d74cBpNK7Lj8tzripY)Qr7oO5FKN zjVL4;Q~rkP37~@3RO9hP5{MK0zjxA`=^O0j;`z6$I!$%zmDu0^#;C;mxuHssnj%$U zj}Zfb4_bu@kp2?Fmrl;kAK)IdorwZ*DK9v#SKyw>yuys_O%_hhzQ83P&F6tHQP`x( z3oapr8g(YT$zsY+Pf*VYoqht6$WPH(i#9ylb^OfbIma_+KV-~hkjk`CGcD>TU@X(c z`l)FrVxpg-|FaRTI%lu`tsYW=hsF%11C1L6Jb_}Oo*Gf zy&x;z0R^%GZ814Yn=8Y&hkw%w|2|kR z-NmT?On0S6Xr)i+@KD^un5H{n5XCW=WWO3@Y?B^xH=l!Z(Z>vG7}h&5qF+Zk{~ z9LWe{=Xdp~v!(m27<>@K0(zw9H}#`!{b)x&w*5Uq{k>95RIXG&RL+N+&5C!=G3ylG zy|iJ}T{2x0de$($oHlEbM>P!MTEWw3@S5v!!w4QDmWQSNOz{5IDLiI`2~M-J5T}JN z7rl-atz> z5+z@G^y%fNiL^4*O@Q%45?UTBhXUVINs1iLgce+KFnKW@CV38uLaA31m_W`C`s{jr z+B3(1cqtLWi0PT32U4CoKsx59`awzFlkMrI9WI6V58V{s| z8Xc}~ruD8>w&lDN#_=%sdl4&5Ny}xW)qgsP==p+`^M89dt+j6jqR-pq+FR`bZ%6G_V@!*43+Bu literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/__pycache__/PX.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/__pycache__/PX.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..dec701f1daefab350bfc45c196b76c1ca2b7ae02 GIT binary patch literal 3445 zcma)8&2JmW6`%d&@szwvAhBUKF)6ER(*U*OB!UwcsA|{(YVeQ+v%8d+Cb{hF zO12oPQ30VLfd+~WEtON)qCn;9qND$S-g*&17gE-=9qFus z_%ZB5BN;{|@SRMCTZVQ2z-0Iu$uTOoDP;sTr1G0gM$`g9qJ~vrlj*J?sS#C#v7i=E zhtxpdNJy17NhS>X;3nzXM{48&lNq{AlBaC;=ABCD=ACm?Qw*x6lAIkXQ!S@at)ytS zSj?7xG&g4lpnotwJFEDi#~twS$4zwp4CJ>=gILhJtu9u{Cjuc=rpoTIu8tv9k_X*j zt8#mctE&>(4+`1_2Q6VfzR$Kh*K=%zKHKhhuaSq$VlrS0=1N(kwj|4XNw;L#4#`&NKi7{CHC<=dl|t4uZIPjYi3$4nQ3=DGks$*ee+JLyhg(?ekaY`X{a7(NfSHc%?ppE zbL5^ahjp^;_!&s^nOYN@iSK6_+YvNIStnu3R zYlrdKR(y7U?9o&^zEBGsMJIQbK9@g}cXRv82Qyb&(W?j2ReBmGQt$}*4S5W2=hr|W z0bJe#k8gmzkM#8bjGvSY2v=3~E7iL6oveZ^q#M&%4OFFSaLUqQ5@<;Tege=AendxxDiL{Mm?CLM$wIX1mfP6 zQebPo3uJ>FOJr=a@&5Mv?a}kK&{1rpF|$3hlWXSpFSTRWFbAWUgPql8W&cV${#GsU z_h|gn*LSWrf3hz=3bdow4y0>t@Viw8CdT|b!T%>PQ17~-&wDiv)ZONs)e}y+Uk}%X zDwFR|t>;vJeCJb*i}q(t{G8(+ip{DMk@46Vr6kZAX-B$tdYcwx9#Dc)Vu5 zg(wNmfHR$2(mdgH_;B+U5U6O;(X9{bAMVUINB)%feWD$`T;q?V$X2Kx`gH!WG=Y4$ z9zK+&ThjE-Li3efaX<1{x`O&hJ#r|`w4|AxrRMzZ*#6Ale1!EUxr?x0!h$bEnD9L8 z_?OSR_(F?77g>PHYG43abQ-=RDbcgg^}$FiXQ`=C7fJtn{g`-WeAKv@8Fo;Dd6Hef z%4r`ueab7~XTAw!gM2YMeK>ldHF}{vdJz#c-bidGnq%$QMMTd;BfXt&UTDXY{|7l; zbijnjJII*==6UyqS4xtMTb3E8ESu=+A%8?JQ$v9RrI(h0)uCWpYn5@l{7x8H07nxc z0F^j;dh4V5M+eeb7u5Z5#m{m+Z3&qEN6bl}KJnT*3B-(_e}7ZF&B6VRF9&=um^Qy+ z=>>bz-$nlh;31~bB=!!U=C4hlm*a;%B#? za-#4S)8RlmW*v5zhtUYgPg%YC3RJJp_47 zX%7^wZ0Sac&UJNqvAAMks%!~OFgkV+IjUx@tUc_qPWn?$_JchS!L<=?p{cXnL*g!t zFO6@cAG@)?O5Xz!Az|JCa?CLd(|Lt3r@ka3Pw*FgLWZA^ao7the0=6tXAYT(7BlgT ey~HdqwbNUZ^~tS7J<%a3Lu}Z|ubd%gss94f-OsH6 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/__pycache__/SRV.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/__pycache__/SRV.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f0844207002f4f86a7addf25f636d4d6b11a95d4 GIT binary patch literal 3694 zcmb_fO>7&-6`o!0l1ow)O_`P$OR{VzDaM3kcpb~V5j?O8`sfPlE2&R#`&LKg1=}i%R2y*Is`$IB} z+#K2g_2#{KZ)SGhd*7SU-$J1Pfp+EgZl(p?S17p6>oA=^1JfWfk(nGx**%kDE!pGr zoYV78?@h4^n;mwS>h&j$vE#_M=XDAg|W8&PuQA$eA znAJIUq*Dg*9XN+VQjARCJDHSc3HE)TNpV$@VPwySkmBW_%xy3!uj2C)c}V6rnC=dO z9Fo1D^D91iSoZa40v!=`8P_Uokpkn>cLG%CkA zQz%kZqpGoHdhaRf(z0Q4MU5J!*GSVP#gKe`XW@Xy<8(d)@&~3tjIOfgE0cG5Ldr~; z-DT}zhLlMb#s*v2v&-0HWg@!nd73TPXN&t=?J4W>eYV|w!8YX1>-A-CpKbSyYh;H> z#s!ntSBeTX1yNKBsv(MIKuqi6idrx(zesUqin&Q~9vFeDkj^Vq01+m0x{}M7J}OJO zw62?8DjRFC+IOc}#-?8sEhACXaq@Y)t$(|iSl04Nf)*8nYOAWWoRBnGNxY`&QetLR zDXb=P>RXB8nz5`EUYNOjC84W^a;cb>?xvR%Js}tLguSbtm`^4k-ZRBDIs`kEhEQ;i zH4P*BZ6M#Qlh1`v&DRoQTVu^1eJaEcV-xR%{}|pD+Of-3?)Ra?(X$P$t~E35(Muo) z52LZhLVck*+m6OT_M<*u&o}4Vqd%!~?*==tDv`Ru1p&_=guhM|NCU$S{b0-X&v2Ce zDOKTQ24;2>p*J5!-Fnd*#9h#_1Fg(uxDr?cCfH;t_?&#+`RQ@q4opN^)-+uasgg?@ z>MFovAbwyNhE+{3U}s4!m;u+aq?qj8d)6vC9@z>hJ&m?LLlX_}1_M`a^=RaQEpGvmE z$$cS7qcHh9FvSz2A3N^@0Z)6f4%|TOHn%=hd_SNUen9UB{Yg>d$~=I~(NqE~!~!E( z_LYUQzZ}?gqP0jU-T-md3_!VYFlGwKBdFp*(<9|{idC6LfS4XbyGzGVjG-9nIbJlh zfhgHwz^t>8)fWtZhH7~`93c!xSDXQBeF4ZiITA>8tZ}1$qkVe1DjY_ljdS&L?Z^cT z%E;#1wYS^hsVax#6ZMI$Of$Q8sU3N_>iuVUywN_hPz@XkLz{tG;NdSm70w|atOXB*@s=>YHQT(n zJ-7GjKZIX>KdfE&EyE^HgP+W}_s?%21uA^SYXR{@Ai0(mp$j5_76PdcMANXD3nJU$ zbP|XB^c-}3`0*CgR9C1Cp%X48-4FJ*AA#DgJY}H+eJR?rOVKW7`bK{VGxh60*2x#s z@q_8Bt?8?KueYbKw}kW6*uxjMt{z6l8dLSD=4d-|@xS7viv?H>c?&0JfqB}^;noqx z%CH^AN+BJmI%kNAMXE`VM`~dSSo_gaidpyJ37VTQQ%3|qT@Ih#tkf#|!h{{{|KZy( zN9h$@y6?+I`oGM6gq21IzsnxSyzTp{2ek+L!dd&P`fCPy%ktPAVEUhFCsme{Zqsb{ zNdyZxt=vsn*Vmlsfu{yOb?}9wo7{?_=FDg8PgUgpW5Hunp>ftqMpHn@r{BscI)1d9 zWRdULm(C1&!CGb>Ch3^m>*QZhhrtO4;i*=5>L7fr6~6Z9Vqd+5`~6Pblf07zlAN<| znlQfW@NTi*bz)wVS8~V?iQ;cp(m6-t6Gd5*U>M$LdQLNRQM6uA6qC>lTF&4KkRTMykn_fqlw3{};|#@rCamzkY=Mh%Xo_SU6?q`vY>+Rx=&?W| z*VgBsa6JEfXPD&|7`TtTkuMe&k3Bwqmg#svI$|w$#KXVB90g$DnDz8@$Q}n6e)8DM z@Z(2b(0|P`uKtO|TG?am9}m)JVRthGL7h?VOG?pDwE}&qJErFID+b2R6wm}cW%`k$ za@t6nr)<{Bg&8Xq{Jj~xZNuM2Q){~&VsDLaqi==lb{uZd*FZ#Y=oscB55q8>X9+X> z6^TB^U-&UO^_YyoSy=v^$=^*LFtHXBd%`A|S*AL@8L!1R6SYK#pbQ>jpZVHSSzG-F D_yGo{ literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/__pycache__/SVCB.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/__pycache__/SVCB.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..9ce4ca1743dc1633934bcc24e287998621d2a9ab GIT binary patch literal 639 zcmZutF;Ck-6uz@fVla`AXb`B1U?c-R0b>wD7!X4A^{U) z_zNgMrBkLz*NslysN5-2-#JbJi5uSgzVE$v-_!e1sjMJ)2cO610`f0O7Ozx*>;b?C zF~qQkESzV>!W?%O9g7Lb?`aA;MNAnYroxQ=s=0vOe22Gscl9loY^=_;aZ$3$DXwe3 zC2Ki_mM2`0Yz@E&@qBAbVc1errLGF?%eRx}cSFXVh&w^VT6In6l=f_&Qz}*{^#j)T zBwnTTs&9KmrA#Rc97-QiCOu|fNhk0*i9()4!N7Go#0eNDpWN6X=79GG#B>yK>6J^ldzzK?GJ literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/__pycache__/WKS.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/__pycache__/WKS.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..50b7f79c8e1c91bc27ddd7cfe9abfb15d04de72d GIT binary patch literal 4604 zcma)9O>7&-6`tiTxw|4MiXvs|Cyr@LR6{!!t;kLsB$2|_cH%f@e(WYOn_#=7^)oF+&Gp*E+aJFS;p`4}nj8v&$tJ zg$X*q&d$tx^JeDFd*6HWFSol3L3!%UI~R_1BlIQdSjEw3Y%>%>%Sb{Jl}2&%PsJ&t zZ;R8$pK1K!|>9m^2 z>-3D2-yk~L@IsX!6st5OqwSx<$cLai84-QOZ4woyr;%j)0~KdV=mI6tSGl-d;w0uO z6?e!ik0f5QU!|IR;-oG(7ZvAaR&q*g8>Op+u26C385DNu^xLP-6uO`aVmXn+Qkd3R zQIfE%C_0zNIW?EarFF;oq?!@)3F}_TZW;K1b0$z6qUV9raYtiS>Z7LS#bh|Q>m$A+X zLNc3F1wro-L`6vEXAcXF(_^x}&XeJpWL7b0C_`Hl`SSFi$Y(f}oJS1dTHP=uG5dE+a>9URH5#Hkr5>N#rCsayqFbB4e|1 zb~chuo{!|`)Qh?7#Mt;#5hbb02lHa$k~l3Z5h<%g%=MJW$yfw#aV$TFJ+MH*MLO2$ z_QQyB463i^(K_c|V5?mJN}w`&j|wCYl$b?Vz5lU~yKi<^uGIPu zLEl~9HMpEDXDe^jc0E~QK5}k@9F%C@6m&TFh&Hyn4R4=DMMiCSE8H1MH7o!)n#H=C zW9Yppgx&>?qP^%)n|CTv;PH)lz;giTtmcqtjV*v?3m{#g7F`;XYTj&9G*X+EquC`} zf!HBi0J62F^{3F{K?W^G8SvN?+5e8xvbG{8+2I@=a0x~M`*s$MyFeGfSHQy@F-(rJ zL3Fe+57i?oSl~iRFeC*-3Rog9XJ;}p7FF4_6gw8P)3WXm^LaTd>9nF^ok``A*_KI# zdF%s8x+8~^)5)yfh2^xUCTEicS+`xftTW)PicTe=0hX#$DV+JsO|dV{x_qlEab;DA30sjn}#dfGn}b z9>8}EoPirAl;?r6_)i9@K}$kvpVeypQ=wMdYPId2w*eNCh^Vm|2jdN_1B~Eeg&`}{ z1~W5?8ayut&;IE3U=9a=eC%~hA}uB+iU*p3LOaaz@UovUD8d95#e0GM;TLL#O2|ew=KVT!BtQywdGh z5>*l6t%_%|34lGp%q_xRolc|`Obib98SHBA5+-`a!=&qOp`4)RT4>mSO<;z_ju1`= z$#_=kE2u;L6b(#f6vu8`#~5uUiS|y$I7vqe`L+Szv|x)BOd?t;zDup=S13(8-+6S zz&G^!!sov5>czk9|9tG&`ryI4W2b6^uio{)T5pi*BjNJt2P5I7)9YmE1J%HR)#IPO zPzywtn0k+Yg(~x<=z5QD>BJ3ZDO&gRER8R{Up{heZhheKmG>)qE8?xt@AhmV${SjW z*8PLar^}}+d%y6HY|=3FpdXlS@|Clz(x-3SzE}-CQ|&)mIg`(| zC=aZ84^+JeR!`Kt6D7yLJ-tiMtemL4wEE7cvo+7;U2f9E^@bOKb`c_N1J_-kXTWu; z6RxY^`DRHGzt~Ya4L#iF@4Pb>G19bLHn&)XLdU-n;c441&Ly zQFheu-=Dnm1JShHBm) ze78S>rJW7av9mF#Vka=kP~edW&m^6byB@WXzs?_C?TiQf)J)Kd4($^%DrgV9wy2$ zDiREom!bOlD*6xO-{O$>sri!+8ODBa+r`>nq&9nz!~5X1Gh6g-`_wiKolP5QO)~c2 zrVF}THl{&%NLq%G8KT48n54b<6jZt!0@YYDlbKP)^XZ1SamJY8ainELF+5JDK&piB z(_|j|+8Hwr@~z1vchK!`lAvcSbQ_tAl0@ne_q?giNi0K`99g*r6#y+oZI2+T`#y4i ziTwAG=RWG$WE_;g?j2p)wdNhIdPgfWHSfXsSH3;6*^O-W4|o4!_Zrn-rTQP*q7*e% z8onN02w#sZM79y>gLZ5KUm2vYH$8~+KxR+*A9#C-MBfLmY_iaOWW>tfjzlNWXA^vM KivDbpg8F|t%hq)O literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/IN/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..8468c7821f59d68286d9bd799e928043987a5628 GIT binary patch literal 341 zcmXw!%}T>S6oqG!loqA_AnsfQbkl_ytV>0RX`!JSLQ`t(W{8=w4W>!R#6aBn6z<)L zkK!BLtuLT<*OfD%2kzlJXLIlUXty_zRCn}#e`X-`slvasKUnQZctH%!&>S)Rif6di zI{MRrlY~N;u4fi3EJL%bb8bee`MF6F~;9V2p|3!+nd^Rv)GgEFPR-=e*gdg literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/__init__.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/__init__.py new file mode 100644 index 0000000..3997f84 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/__init__.py @@ -0,0 +1,33 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""DNS rdata type classes""" + +__all__ = [ + "ANY", + "IN", + "CH", + "dnskeybase", + "dsbase", + "euibase", + "mxbase", + "nsbase", + "svcbbase", + "tlsabase", + "txtbase", + "util", +] diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d4fd5a1da4cffc3e14ed35ccc955035a3728e477 GIT binary patch literal 340 zcmXv}u};G<5VeztMukWqBsQcBEE$N^vLYk|0}NyUG0??wY|~hE<0$7w4I5v<&W89D z{vazq0Cej_(!fb~@7=qT?%hWa3{e~7+xN$jhtOx&{D<>LR=X{EK>|(C6bbx_C%ASZ z_vzp=xeH6dEDLR2$dGFWAR*dm-1Fq2ajuibxwvYEB8Qo*QwFlx60pI6T&P}{FMG`U zfe#f=H;QjHuzuMt?S^;@t8@}M&45y2IHet7T2uOlR-M`PJ;}^mlCqGtG?n5R;YLVu zqkxmRl6gh6N=Z@M%;YEWXiPv^d0a3)V^ayFbxKOnJp+VNl`BhWT-0m-bZ*2#%d>L7 by@K0>y|#S07~}6Fgb#nbVB2{fl%4tuLUL-g literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/__pycache__/dnskeybase.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/__pycache__/dnskeybase.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..0f162fabe290039c5e6c1abec9c41574a6a7ce43 GIT binary patch literal 3864 zcmaJ^O>7&-6`tk(aQU|qE!h@rD`srj3Def}Uu>sQoW`--%7N*^G7^NB?Rs}8Ek$zK z*_CYyG(Z6cOaV=8p(tpdEEff0Ll^hd^yZ#gpqCI#A$ILUnw)%7Egu4(`ev3((uCRp z`R2`gZ)SGi``(+`f5c*81nuahwcOhggubT(zeyct^B{*%0~yHR3MlLKT$W?wKsLa7 zJ}a-{x=9>(_XX&xWy(-_eu%+*UHSrU+|F zFlWrS?DhFwJ>KX1ebzdHtb)V&H+*fc&klh+*&F*@b{ORQ{86vZ#w%PZ_?!wdDc|w_{o$jWG`l>^qwt3;8NB$=~FilM%1C;OfJhC0dO9l6)QqYbcJ&TZT2~} zeqN)5PRyhvS60=MR>Z36hE=s_84Cr1=H5khpyt%)pWtUk}g-AIjeN+(2=8Q+jQ_x%9=i}&0;%klgI=W$X?diF_zb&D7&!4-25 z72B1|#Bwa%D!3u7Fl!OhnJc$M361rEz8r=0GM7wyMx)>t{A{6yGjC>~p<-t1QiL@9BN6 zD)z12-5Z`G;al|js?=v2^W_!vh|8oDSF{((m{4$=CDTz=1}8wcW~&Qk$vJX@jKCB( z_61dGdZ>#Y|3MIcdj1% zMovB3p13=4KYcI#@IY(V;nwyeb>TPR_Sl~L$~|TEdTZ=3jAPFdd+zVOw|6~pw3#@% zo;cY|oct=(N}K_m(jM8_IK6Uub$@H*U|sk^X4$3t$pm|%5d3LCHdlc_3FjavzzsH# zcEH!K0cjUhJ-O2bWS+WVpykE-G5XtEhi zu8w{=_F$|TJ^b(zkd2U-4F3m-!{H4ihQeMPi5;KDcJ>XJ7H$01-P7=EzpFib^ZHJhpS@%udD(RYoOYm0-E^1H&O0%kI;F4qJ zOiXN7!X^{N@2Blp|KrgUo0jWV+Iy!Yr2OHMAk4_-I2}QCh>vy4W7s(fDBHgWr8v zm)oN|8<~|%YjmO>YAf+|7VGS0&hEV<&C>`OW9xN|24Gj z&dIyyR;M1Gdi?nlzBP3AYuP(R_5P?+Z!=8&9T+%Zx`^5;uUQqK=`heBPrC<0PX*E~ z@_el`|AtuQwmfdSM*;`9*wSLls^BAvLls&NUI}mh;>;O9j|31|&>dHx_mIKZiPzxd z#aztTt7Ph0fffa64r>NrioUZKYcJ9=phLZ868w5S z?+B;B+CB{g%6WWeWB1DLyPvLJ{xbU@`*`%v<9`}|BK%GHtI~>JtV?Y z5;Np|up#sqAoNk5Q!W+g<|lQ2jHYcjFQGiYORakeCzUl~W8&r98LFeFtWC>LCz(7C z53{VHE>^u6i@OI?s!w^IuJI9&8u~WAb3MMV8Q-^hq7{D!JWR7?UsKuFQYL!2a_-@g z2h$I)KGq&pzB>3M{+HB~nby$s*YY%TI-u%uiqBkzJ9;K_&Z|yQLJJ+CnNR4Q#0{#d zVd-$8hC|;jSdI->5qiXvA5(3F-2;jkZpa3CkBUF0WSZ(?om+yA3k6k8apV9#EnWXFxT#pX*U6BYoOk-4vuj{z%m{!SU zL$g?1aI`CsKOw61j$81EM&HN{PL~||P2ye6LS19>7Tra>M6b`@OVWbW`}`pEs_8u; zy)nI#C%vzh)8sQ4QU}>fKsI=e<2EM{r#wZGrzrM4+VK>PvfuCv2}LGq!Iu)xZL1%@ zJ-Iyj5&^prMFH{F_|o_~H`e6FUIyOg&U1H08i|!eWADn|O+?4w!9ZezsW!443Px_t aEzQ;Vb|`jx_ww$V)CNgqsj?)nNBl23LLbfm literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/__pycache__/dsbase.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/__pycache__/dsbase.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..8f45bd47fed55612947f2d91542122202811bee1 GIT binary patch literal 4163 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/__pycache__/euibase.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/__pycache__/euibase.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ad19cf7d87b090db21f076f5532972ac97af8ffe GIT binary patch literal 3523 zcmbVOO>7&-6`tMYlDiZoQlcWuKXPbWcC)r5x~`EQw>F$gaq6O?Ys+m>q3vS5JCar+ zxy;PUB8iou1_mO*PGuho$!H2INPr~J#X02~)HxW)p`_VD?$(DCIr*lTJ{az$Z+5wq zoU%P+fSrBw-prdfGvE7WzHD!gA}Gf$tWTT)>1);qO1L4^uY<6H3}kRwH17Yoao%eS z<2>f4rC`X`zm<+hZz6-giVOk9c=K-cXVP@+`8I2<3%+i>VH%H=I3@ImwK94`=lvS} zQ2lq%dB&{b|cj3Y8KWJA2lHT_FQ)Chx3 z#u1~B!$>lQIw0neIxXj@njkXdB)1c%Tc zxfNtLjY}a1y(=Q*a1OuD`)Uq3Xc~0iE{?Dc<5_W#8mtuAvae&>>EN^i75ulxwA$^N zR}dm6?dG0OcWfKl5T`r;TW4@ETZ_{(_%cNPC)nZEcCdv0ECw;X&6SWMW?TXG?-9dK zIhi7cW^1V_jizi1ewT5o98O&-*_bM_E7I8lCa$EaX5O?_)sLM)<)ZiwRSgc~7-p4BLI!^E&l;N9~htE#6}Rm$2a zC=1Unrl+hNPLl$*iFMi3r_#D*;Pj|T_4LqXoWGpTnwQdrl09YRe=zj@V`*yIc(9=9 zGukAkX^185&q31wkxPJ_p+bqUT`VUWP#OwWwjZ=~5~`;Q=%LiU6sbzRt2@>X{Y_FH zBzLTwx_N5tKrMM_F?3ye*w(RVFBg}J*G{gE+#bC(dcRG1*!9B7;LX8}F6Dlg^5EqY zpXENyeXiABe)C@UU;Do7t0aC^7x-kyCgR&WHU$(rT!*QU-b58N7?#@LtN#Wnz-$A1 zkf9Bng1T9zx8uE`ZH-6BKF;6`;XU3FKIHzuK_-PVkC@9kn_*DlU0I)+&CgJ?j9r=H zf<`nO4lG0%HeJyJh#OI-aM7G7dB+7dhEX?c5p&YayHSF(nr&WY9{8C#%7SA@NM2yQ zBDSU4xM-K-!KOD9hrvp}2Ni62ylc6%RN9EAs`1oX_eZ_&_g3Pgcg}y_UyYC6+YePm z8YMl@S7+HBlxC)%fd#D~N0@HzTF?bDvLVh#?B;$uksv2v*IMkQm!|`EGrwCg>ohy9 zZxt_3Tlg!3r(njnIlDa=X7Dh73l1;@me)q83}`ikfR9JeZwC;Xmz;Y{SbPjE41z@257`NMFc}UkR+i$J`- zD8RHzn=9y9O1i)sVTbDqwlzccvgV7d*}j$Es%^O;7M;tPZiw9-E{}_pr2@=7#Mq|Dx^IS2qI=m{a#n}e zx@z(M#n2`%$Uo;ECU0*Nl&5-kPWOD{tyr7KpxiPd8Xz0%WLjCc)e8)`sRZ#7G&q7SIDJ zwj5oG-Z;MU>djaGF75Ftef!Fo?5*r)Ap9>%|NkqS7n|fFZjlT5Avk2W9ZNR<3B%Gy z36o>++XntH+<+9))5AXthq7zHN45{_gok3bSk>=a?tKp5+bqLu{6VM|&{rMZ8y$PA z9eY>lZReI#>lj!R{t@r;fHPc+zf_T4^0q_aGZz&hb1?%|=8PY9jJ?6~S`Nb-EUKzG z%b3kFIi{*_&1%_(C8DZ^rF+jbm1ZrQs;c+gA^RWzx6OND_FlMKW*-m>)CLz|9RgB!}Poa8x75yvJ1Gx*S7g;#_BpMbw;KeOwSoVZF zzdASeSV)M6>jE@3c_#I9VxMPw%=4n+8J;l7Teat0kqBIH5DvWEhRj@U*48d%vHuW} zna+QV$Xlj8th;!D5s~NN6XbhiFOO%^kNk}~Mb1N$t%jb23bKvk>iZFw_!@Qp6D1%f oUVNwT_k9~&ZdLBW z=1oUc-Kd(e)oC;DoIOub8kS%ppP4i$J_pz$+D0zxhN;dR>4vE8%z+LRW+HAxRoRlN z+PFo*w(!GfYTTMMQgq62s5N71<0;M3jnuGdYpLXnk)KKB%sZ*6IcMC;pG%(YOWCGl zoSDjKcQa##oznAm$~(zUP2NKwC8y>nzTHCH^H(ys!;fLo?gR4u0{NR9TMlo_oogNI zz2C}--D7WkmHIOE@Kov8J4@mp;=7%1eii#Nwmx3!Of89D#LBRXXcddX06o?K|K(4B ztfGyfKiDQ}cle97ew-I|4tAoh1Fa}#`2tu8fX9y%q!YSw!cGXD9b2?<%d!oX8o7*P z&X~>|Gjc+rG0@_MENYIKc{duY7YvubJInUk=nZCg+JdrS$5I{Ro>OS@ZRL+o!lHc| z$O74I?O1*9!FxNcecP>lkIsKHSZcktB=5$Lt{rD4yRg;Oza8)2lKUw}CoK#lXy|4% zLHRZiFp@Cg!!r=TK6q>MVOXzcFtI2VLqRB-mw7NY8nGBI%A3CFMhTTc)dufI#|+2E zsVgIo5KTl}LCe{+31ny-h$}eOUD}Srqd1IJZKXO^6|*)z9A+;hp3NdzYE61pYxb>H znL(4;=YTAbJ((QsTD|??cB%cuQgpZV=<1~hm)1iMqmPD5tyh-hzs8T;e|PQL`mY|z zrTD;>Jm8tH@)AKw#e9E;0mOug@h1E@0MnIr7?OgRF)tOliCX9QJBv~f2Ut`=GahIY zi1P!DIY59I;yZvNa}25c+aE$G2-yyu)*M&FXX=FuX_msf^#F{hn>DGC2ziJVvt|w= zqh?J)ptNn~7q?N%VdSGK@yFudOHdo zwOFlL7=W#I3djO^+Wy8)d+&C8Z>jwxLbhx5@`KCk=S!`p4uxw4lAr*2_S*5&4-1L@ zOHFWI%;FdVY~1Smv`w9&mIg2|^JBo85Y3#q!W%&>ud{d=Hrr66!3}oftt+1`f3_vR z<$166o#3aj&$|IkZHBG)n(D>my03=|yct|fbOp#sm>(>dfDRrR;inVi28R#n~7U>dTy zowFQURav&Bop7+*z!LnV0m)jY3e3<`NX{TZjM4Kz+?ZboXhtrlsv8`|QkY@jXAHd* zp8_Lz8#@c+`$h71ao}l7_gZ1A`P9NMUx5`iC%+iM z5)_I>339gRHhq*2;+dfj-zt3ldPU=D<<7LD%#K5zSJ3iNeBDr8<}F95>IDHK599od zK^;R^97`D*8CCFgV`Vy-aZW3lyzc2?Ds&TyCI?~01Ok=1HJjIs%1N{6uhVgQu7~ng2JuI8S?V;wMO0=EWkzb3LAe7gQEJ|Ko9mj+ZT%3}XE- zEZUg0Ys=KpUC+LK*u^V8zKMJ5`}mW`@?h1+^cQ&4K}VwhD3afxo{A$mY4E!cCtXBGUi5UJ zP@>5L#*ct^V-UQP@EgsTa!e~v&sOHl$;oN27M$ict83S>{!1-8)?8HrM%r@8yQLrO}m-mp@)nm(?=CF~m5&YmY7MUFQyL2yy-Q eZ?eoB~5C0dQt;90` literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/__pycache__/nsbase.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/__pycache__/nsbase.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d4851f76b1ff84569201cf418f0f81e007d1bafa GIT binary patch literal 2825 zcmb_e&2JM|5P$pWwVjZd5)u+9tBNAFNo*BVXe)#$LTM|tZiQ(jeCTSk`;u&8@49a{ z32}{-N|8uZA;_Uhj=5AK$|e6tFGMMVE*w&E>Mh_L5U0-UhvNo%Kk05MP5de}L(22n{7=4#ERrDGL@q&XvVQGRA>>N?EcLOI+Z} zGEJq4mA0e>u62FI%2+b!(lljdtyG&Pvq)}oQ5NHYI|yUal=uIC6!UrWmZ0reS?it-xS;Kjyzt!c@4;~+zRnq$|bQu?ns0*xCXz$ zM`DgN$Rx-Pehp!Ri)0O=C*dG-WSuK&Vjy|bHOc}-*KNo4bsadv(;cHq8SbS?f#}i7 zSdd~?80A1_mOlqeP#dImJ(TLYhjSIa`B$aFgj=NrR--<1XKZt#V7eA9d~JJXAwNT% znL@=LE!5`x3D-H7|L|TGt4PtoO%Vz@e0uyUcvDY-+XP3LBf-IR}|iSa#09kxJN<{EJwDpMQeCdDjcgwsTomtQn_xxEmisWl@Mht^`7MwY z3?7UJzsdF$v9dkrw?w}c@`jiMxsvHiI~@O-9849^c_ zm)YaC6J!#7od*2WY`C@+R+V+3ZOV6bpWgKAhvHDg^HZP{w5 z{h7`BcJ9ie{Iu)vz4O2P^g!un_*zZ8U-F>`VWM3G1|lI$#tD-c;MfowQbSIj;JZ`o2u^!&+PUwu?z@r83Mep>@Qb`o zk1@9z`Q07+-IAOEYwvv^^JG^chkI6zFCSkWTbtY*-p*ZKl>Y?3FRYG09&`;pPzEFC zTadvrtem0qmw|cPG-wC_Iwlf)9K5Lz_H{mj9kH6V8C{QY7RT%g4HVO@))@7?FbYA3 zX*jN9n?}X1(}QR$5R-6={mhRA1vt>_2LgC29e1-!*+vTSu#iDf%jkO5 zwWce`cj)?$(?%uMq;%bKO%OvV^D3_I>3UdeST7tMWW(xKrBJFY_AW@+X(SrzI^)`B z(n>|wHI89t^zh|e4zreFUW5d3^1cA_a)JCMezKE0b}uvk<(|k(LrsO31|Vh1->3{(?ta)a)S_LK|*v!mh0^ZUm&+2ciR=PJ|8zy$+hE6dd}_ zNs^FS#ZvvZx9e6z>gcqu&Q3r{Q!$De1Q^13amTuhDm-HrqDdaSNY!?-~pB^xlxeNEcZxR?n Lqvt$u;Z6Pl`DJkt literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/__pycache__/svcbbase.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/__pycache__/svcbbase.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..bc9f3256b62872370d574b8d5d5700b0ede6eb1e GIT binary patch literal 28482 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 V0@_t9!6Je+;}h&pLYN`@{|7q42I~L- literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/__pycache__/tlsabase.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/__pycache__/tlsabase.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..59e9f406637a53a4aa748834fba5f6191c9463c5 GIT binary patch literal 3361 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/__pycache__/util.cpython-312.pyc b/.venv/lib/python3.12/site-packages/dns/rdtypes/__pycache__/util.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..29b293a904afdd3987ac64b2bb993021be28d152 GIT binary patch literal 12831 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 Sj#sRh1GIm&)lPfKEc`F!={Fky literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/dnskeybase.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/dnskeybase.py new file mode 100644 index 0000000..db300f8 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/dnskeybase.py @@ -0,0 +1,87 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2004-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 base64 +import enum +import struct + +import dns.dnssectypes +import dns.exception +import dns.immutable +import dns.rdata + +# wildcard import +__all__ = ["SEP", "REVOKE", "ZONE"] # noqa: F822 + + +class Flag(enum.IntFlag): + SEP = 0x0001 + REVOKE = 0x0080 + ZONE = 0x0100 + + +@dns.immutable.immutable +class DNSKEYBase(dns.rdata.Rdata): + """Base class for rdata that is like a DNSKEY record""" + + __slots__ = ["flags", "protocol", "algorithm", "key"] + + def __init__(self, rdclass, rdtype, flags, protocol, algorithm, key): + super().__init__(rdclass, rdtype) + self.flags = Flag(self._as_uint16(flags)) + self.protocol = self._as_uint8(protocol) + self.algorithm = dns.dnssectypes.Algorithm.make(algorithm) + self.key = self._as_bytes(key) + + def to_text(self, origin=None, relativize=True, **kw): + return "%d %d %d %s" % ( + self.flags, + self.protocol, + self.algorithm, + dns.rdata._base64ify(self.key, **kw), + ) + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + flags = tok.get_uint16() + protocol = tok.get_uint8() + algorithm = tok.get_string() + b64 = tok.concatenate_remaining_identifiers().encode() + key = base64.b64decode(b64) + return cls(rdclass, rdtype, flags, protocol, algorithm, key) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + header = struct.pack("!HBB", self.flags, self.protocol, self.algorithm) + file.write(header) + file.write(self.key) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + header = parser.get_struct("!HBB") + key = parser.get_remaining() + return cls(rdclass, rdtype, header[0], header[1], header[2], key) + + +### BEGIN generated Flag constants + +SEP = Flag.SEP +REVOKE = Flag.REVOKE +ZONE = Flag.ZONE + +### END generated Flag constants diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/dsbase.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/dsbase.py new file mode 100644 index 0000000..cd21f02 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/dsbase.py @@ -0,0 +1,85 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2010, 2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 binascii +import struct + +import dns.dnssectypes +import dns.immutable +import dns.rdata +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"] + + # Digest types registry: + # https://www.iana.org/assignments/ds-rr-types/ds-rr-types.xhtml + _digest_length_by_type = { + 1: 20, # SHA-1, RFC 3658 Sec. 2.4 + 2: 32, # SHA-256, RFC 4509 Sec. 2.2 + 3: 32, # GOST R 34.11-94, RFC 5933 Sec. 4 in conjunction with RFC 4490 Sec. 2.1 + 4: 48, # SHA-384, RFC 6605 Sec. 2 + } + + def __init__(self, rdclass, rdtype, key_tag, algorithm, digest_type, digest): + super().__init__(rdclass, rdtype) + self.key_tag = self._as_uint16(key_tag) + self.algorithm = dns.dnssectypes.Algorithm.make(algorithm) + self.digest_type = dns.dnssectypes.DSDigest.make(self._as_uint8(digest_type)) + self.digest = self._as_bytes(digest) + try: + if len(self.digest) != self._digest_length_by_type[self.digest_type]: + raise ValueError("digest length inconsistent with digest type") + except KeyError: + if self.digest_type == 0: # reserved, RFC 3658 Sec. 2.4 + raise ValueError("digest type 0 is reserved") + + def to_text(self, origin=None, relativize=True, **kw): + kw = kw.copy() + chunksize = kw.pop("chunksize", 128) + return "%d %d %d %s" % ( + self.key_tag, + self.algorithm, + self.digest_type, + dns.rdata._hexify(self.digest, chunksize=chunksize, **kw), + ) + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + key_tag = tok.get_uint16() + algorithm = tok.get_string() + digest_type = tok.get_uint8() + digest = tok.concatenate_remaining_identifiers().encode() + digest = binascii.unhexlify(digest) + return cls(rdclass, rdtype, key_tag, algorithm, digest_type, digest) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + header = struct.pack("!HBB", self.key_tag, self.algorithm, self.digest_type) + file.write(header) + file.write(self.digest) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + header = parser.get_struct("!HBB") + digest = parser.get_remaining() + return cls(rdclass, rdtype, header[0], header[1], header[2], digest) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/euibase.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/euibase.py new file mode 100644 index 0000000..751087b --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/euibase.py @@ -0,0 +1,70 @@ +# Copyright (C) 2015 Red Hat, Inc. +# Author: Petr Spacek +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED 'AS IS' AND RED HAT DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 binascii + +import dns.immutable +import dns.rdata + + +@dns.immutable.immutable +class EUIBase(dns.rdata.Rdata): + """EUIxx record""" + + # see: rfc7043.txt + + __slots__ = ["eui"] + # define these in subclasses + # byte_len = 6 # 0123456789ab (in hex) + # text_len = byte_len * 3 - 1 # 01-23-45-67-89-ab + + def __init__(self, rdclass, rdtype, eui): + super().__init__(rdclass, rdtype) + self.eui = self._as_bytes(eui) + if len(self.eui) != self.byte_len: + raise dns.exception.FormError( + "EUI%s rdata has to have %s bytes" % (self.byte_len * 8, self.byte_len) + ) + + def to_text(self, origin=None, relativize=True, **kw): + return dns.rdata._hexify(self.eui, chunksize=2, separator=b"-", **kw) + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + text = tok.get_string() + if len(text) != cls.text_len: + raise dns.exception.SyntaxError( + "Input text must have %s characters" % cls.text_len + ) + for i in range(2, cls.byte_len * 3 - 1, 3): + if text[i] != "-": + raise dns.exception.SyntaxError("Dash expected at position %s" % i) + text = text.replace("-", "") + try: + data = binascii.unhexlify(text.encode()) + except (ValueError, TypeError) as ex: + raise dns.exception.SyntaxError("Hex decoding error: %s" % str(ex)) + return cls(rdclass, rdtype, data) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + file.write(self.eui) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + eui = parser.get_bytes(cls.byte_len) + return cls(rdclass, rdtype, eui) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/mxbase.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/mxbase.py new file mode 100644 index 0000000..6d5e3d8 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/mxbase.py @@ -0,0 +1,87 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""MX-like base classes.""" + +import struct + +import dns.exception +import dns.immutable +import dns.name +import dns.rdata +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"] + + def __init__(self, rdclass, rdtype, preference, exchange): + super().__init__(rdclass, rdtype) + self.preference = self._as_uint16(preference) + self.exchange = self._as_name(exchange) + + def to_text(self, origin=None, relativize=True, **kw): + exchange = self.exchange.choose_relativity(origin, relativize) + return "%d %s" % (self.preference, exchange) + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + preference = tok.get_uint16() + exchange = tok.get_name(origin, relativize, relativize_to) + return cls(rdclass, rdtype, preference, exchange) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + pref = struct.pack("!H", self.preference) + file.write(pref) + self.exchange.to_wire(file, compress, origin, canonicalize) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + preference = parser.get_uint16() + exchange = parser.get_name(origin) + return cls(rdclass, rdtype, preference, exchange) + + def _processing_priority(self): + return self.preference + + @classmethod + def _processing_order(cls, iterable): + return dns.rdtypes.util.priority_processing_order(iterable) + + +@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.""" + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + super()._to_wire(file, None, origin, False) + + +@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.""" + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + super()._to_wire(file, None, origin, canonicalize) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/nsbase.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/nsbase.py new file mode 100644 index 0000000..904224f --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/nsbase.py @@ -0,0 +1,63 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""NS-like base classes.""" + +import dns.exception +import dns.immutable +import dns.name +import dns.rdata + + +@dns.immutable.immutable +class NSBase(dns.rdata.Rdata): + """Base class for rdata that is like an NS record.""" + + __slots__ = ["target"] + + def __init__(self, rdclass, rdtype, target): + super().__init__(rdclass, rdtype) + self.target = self._as_name(target) + + def to_text(self, origin=None, relativize=True, **kw): + target = self.target.choose_relativity(origin, relativize) + return str(target) + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + target = tok.get_name(origin, relativize, relativize_to) + return cls(rdclass, rdtype, target) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + self.target.to_wire(file, compress, origin, canonicalize) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + target = parser.get_name(origin) + return cls(rdclass, rdtype, target) + + +@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.""" + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + self.target.to_wire(file, None, origin, False) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/svcbbase.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/svcbbase.py new file mode 100644 index 0000000..0565241 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/svcbbase.py @@ -0,0 +1,553 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +import base64 +import enum +import struct + +import dns.enum +import dns.exception +import dns.immutable +import dns.ipv4 +import dns.ipv6 +import dns.name +import dns.rdata +import dns.rdtypes.util +import dns.renderer +import dns.tokenizer +import dns.wire + +# Until there is an RFC, this module is experimental and may be changed in +# incompatible ways. + + +class UnknownParamKey(dns.exception.DNSException): + """Unknown SVCB ParamKey""" + + +class ParamKey(dns.enum.IntEnum): + """SVCB ParamKey""" + + MANDATORY = 0 + ALPN = 1 + NO_DEFAULT_ALPN = 2 + PORT = 3 + IPV4HINT = 4 + ECH = 5 + IPV6HINT = 6 + DOHPATH = 7 + + @classmethod + def _maximum(cls): + return 65535 + + @classmethod + def _short_name(cls): + return "SVCBParamKey" + + @classmethod + def _prefix(cls): + return "KEY" + + @classmethod + def _unknown_exception_class(cls): + return UnknownParamKey + + +class Emptiness(enum.IntEnum): + NEVER = 0 + ALWAYS = 1 + ALLOWED = 2 + + +def _validate_key(key): + force_generic = False + if isinstance(key, bytes): + # We decode to latin-1 so we get 0-255 as valid and do NOT interpret + # UTF-8 sequences + key = key.decode("latin-1") + if isinstance(key, str): + if key.lower().startswith("key"): + force_generic = True + if key[3:].startswith("0") and len(key) != 4: + # key has leading zeros + raise ValueError("leading zeros in key") + key = key.replace("-", "_") + return (ParamKey.make(key), force_generic) + + +def key_to_text(key): + return ParamKey.to_text(key).replace("_", "-").lower() + + +# Like rdata escapify, but escapes ',' too. + +_escaped = b'",\\' + + +def _escapify(qstring): + text = "" + for c in qstring: + if c in _escaped: + text += "\\" + chr(c) + elif c >= 0x20 and c < 0x7F: + text += chr(c) + else: + text += "\\%03d" % c + return text + + +def _unescape(value): + if value == "": + return value + unescaped = b"" + l = len(value) + i = 0 + while i < l: + c = value[i] + i += 1 + if c == "\\": + if i >= l: # pragma: no cover (can't happen via tokenizer get()) + raise dns.exception.UnexpectedEnd + c = value[i] + i += 1 + if c.isdigit(): + if i >= l: + raise dns.exception.UnexpectedEnd + c2 = value[i] + i += 1 + if i >= l: + raise dns.exception.UnexpectedEnd + c3 = value[i] + i += 1 + if not (c2.isdigit() and c3.isdigit()): + raise dns.exception.SyntaxError + codepoint = int(c) * 100 + int(c2) * 10 + int(c3) + if codepoint > 255: + raise dns.exception.SyntaxError + unescaped += b"%c" % (codepoint) + continue + unescaped += c.encode() + return unescaped + + +def _split(value): + l = len(value) + i = 0 + items = [] + unescaped = b"" + while i < l: + c = value[i] + i += 1 + if c == ord("\\"): + if i >= l: # pragma: no cover (can't happen via tokenizer get()) + raise dns.exception.UnexpectedEnd + c = value[i] + i += 1 + unescaped += b"%c" % (c) + elif c == ord(","): + items.append(unescaped) + unescaped = b"" + else: + unescaped += b"%c" % (c) + items.append(unescaped) + return items + + +@dns.immutable.immutable +class Param: + """Abstract base class for SVCB parameters""" + + @classmethod + def emptiness(cls): + return Emptiness.NEVER + + +@dns.immutable.immutable +class GenericParam(Param): + """Generic SVCB parameter""" + + def __init__(self, value): + self.value = dns.rdata.Rdata._as_bytes(value, True) + + @classmethod + def emptiness(cls): + return Emptiness.ALLOWED + + @classmethod + def from_value(cls, value): + if value is None or len(value) == 0: + return None + else: + return cls(_unescape(value)) + + def to_text(self): + return '"' + dns.rdata._escapify(self.value) + '"' + + @classmethod + def from_wire_parser(cls, parser, origin=None): # pylint: disable=W0613 + value = parser.get_bytes(parser.remaining()) + if len(value) == 0: + return None + else: + return cls(value) + + def to_wire(self, file, origin=None): # pylint: disable=W0613 + file.write(self.value) + + +@dns.immutable.immutable +class MandatoryParam(Param): + def __init__(self, keys): + # check for duplicates + keys = sorted([_validate_key(key)[0] for key in keys]) + prior_k = None + for k in keys: + if k == prior_k: + raise ValueError(f"duplicate key {k:d}") + prior_k = k + if k == ParamKey.MANDATORY: + raise ValueError("listed the mandatory key as mandatory") + self.keys = tuple(keys) + + @classmethod + def from_value(cls, value): + keys = [k.encode() for k in value.split(",")] + return cls(keys) + + def to_text(self): + return '"' + ",".join([key_to_text(key) for key in self.keys]) + '"' + + @classmethod + def from_wire_parser(cls, parser, origin=None): # pylint: disable=W0613 + keys = [] + last_key = -1 + while parser.remaining() > 0: + key = parser.get_uint16() + if key < last_key: + raise dns.exception.FormError("manadatory keys not ascending") + last_key = key + keys.append(key) + return cls(keys) + + def to_wire(self, file, origin=None): # pylint: disable=W0613 + for key in self.keys: + file.write(struct.pack("!H", key)) + + +@dns.immutable.immutable +class ALPNParam(Param): + def __init__(self, ids): + self.ids = dns.rdata.Rdata._as_tuple( + ids, lambda x: dns.rdata.Rdata._as_bytes(x, True, 255, False) + ) + + @classmethod + def from_value(cls, value): + return cls(_split(_unescape(value))) + + def to_text(self): + value = ",".join([_escapify(id) for id in self.ids]) + return '"' + dns.rdata._escapify(value.encode()) + '"' + + @classmethod + def from_wire_parser(cls, parser, origin=None): # pylint: disable=W0613 + ids = [] + while parser.remaining() > 0: + id = parser.get_counted_bytes() + ids.append(id) + return cls(ids) + + def to_wire(self, file, origin=None): # pylint: disable=W0613 + for id in self.ids: + file.write(struct.pack("!B", len(id))) + file.write(id) + + +@dns.immutable.immutable +class NoDefaultALPNParam(Param): + # We don't ever expect to instantiate this class, but we need + # a from_value() and a from_wire_parser(), so we just return None + # from the class methods when things are OK. + + @classmethod + def emptiness(cls): + return Emptiness.ALWAYS + + @classmethod + def from_value(cls, value): + if value is None or value == "": + return None + else: + raise ValueError("no-default-alpn with non-empty value") + + def to_text(self): + raise NotImplementedError # pragma: no cover + + @classmethod + def from_wire_parser(cls, parser, origin=None): # pylint: disable=W0613 + if parser.remaining() != 0: + raise dns.exception.FormError + return None + + def to_wire(self, file, origin=None): # pylint: disable=W0613 + raise NotImplementedError # pragma: no cover + + +@dns.immutable.immutable +class PortParam(Param): + def __init__(self, port): + self.port = dns.rdata.Rdata._as_uint16(port) + + @classmethod + def from_value(cls, value): + value = int(value) + return cls(value) + + def to_text(self): + return f'"{self.port}"' + + @classmethod + def from_wire_parser(cls, parser, origin=None): # pylint: disable=W0613 + port = parser.get_uint16() + return cls(port) + + def to_wire(self, file, origin=None): # pylint: disable=W0613 + file.write(struct.pack("!H", self.port)) + + +@dns.immutable.immutable +class IPv4HintParam(Param): + def __init__(self, addresses): + self.addresses = dns.rdata.Rdata._as_tuple( + addresses, dns.rdata.Rdata._as_ipv4_address + ) + + @classmethod + def from_value(cls, value): + addresses = value.split(",") + return cls(addresses) + + def to_text(self): + return '"' + ",".join(self.addresses) + '"' + + @classmethod + def from_wire_parser(cls, parser, origin=None): # pylint: disable=W0613 + addresses = [] + while parser.remaining() > 0: + ip = parser.get_bytes(4) + addresses.append(dns.ipv4.inet_ntoa(ip)) + return cls(addresses) + + def to_wire(self, file, origin=None): # pylint: disable=W0613 + for address in self.addresses: + file.write(dns.ipv4.inet_aton(address)) + + +@dns.immutable.immutable +class IPv6HintParam(Param): + def __init__(self, addresses): + self.addresses = dns.rdata.Rdata._as_tuple( + addresses, dns.rdata.Rdata._as_ipv6_address + ) + + @classmethod + def from_value(cls, value): + addresses = value.split(",") + return cls(addresses) + + def to_text(self): + return '"' + ",".join(self.addresses) + '"' + + @classmethod + def from_wire_parser(cls, parser, origin=None): # pylint: disable=W0613 + addresses = [] + while parser.remaining() > 0: + ip = parser.get_bytes(16) + addresses.append(dns.ipv6.inet_ntoa(ip)) + return cls(addresses) + + def to_wire(self, file, origin=None): # pylint: disable=W0613 + for address in self.addresses: + file.write(dns.ipv6.inet_aton(address)) + + +@dns.immutable.immutable +class ECHParam(Param): + def __init__(self, ech): + self.ech = dns.rdata.Rdata._as_bytes(ech, True) + + @classmethod + def from_value(cls, value): + if "\\" in value: + raise ValueError("escape in ECH value") + value = base64.b64decode(value.encode()) + return cls(value) + + def to_text(self): + b64 = base64.b64encode(self.ech).decode("ascii") + return f'"{b64}"' + + @classmethod + def from_wire_parser(cls, parser, origin=None): # pylint: disable=W0613 + value = parser.get_bytes(parser.remaining()) + return cls(value) + + def to_wire(self, file, origin=None): # pylint: disable=W0613 + file.write(self.ech) + + +_class_for_key = { + ParamKey.MANDATORY: MandatoryParam, + ParamKey.ALPN: ALPNParam, + ParamKey.NO_DEFAULT_ALPN: NoDefaultALPNParam, + ParamKey.PORT: PortParam, + ParamKey.IPV4HINT: IPv4HintParam, + ParamKey.ECH: ECHParam, + ParamKey.IPV6HINT: IPv6HintParam, +} + + +def _validate_and_define(params, key, value): + (key, force_generic) = _validate_key(_unescape(key)) + if key in params: + raise SyntaxError(f'duplicate key "{key:d}"') + cls = _class_for_key.get(key, GenericParam) + emptiness = cls.emptiness() + if value is None: + if emptiness == Emptiness.NEVER: + raise SyntaxError("value cannot be empty") + value = cls.from_value(value) + else: + if force_generic: + value = cls.from_wire_parser(dns.wire.Parser(_unescape(value))) + else: + value = cls.from_value(value) + params[key] = value + + +@dns.immutable.immutable +class SVCBBase(dns.rdata.Rdata): + """Base class for SVCB-like records""" + + # see: draft-ietf-dnsop-svcb-https-11 + + __slots__ = ["priority", "target", "params"] + + def __init__(self, rdclass, rdtype, priority, target, params): + super().__init__(rdclass, rdtype) + self.priority = self._as_uint16(priority) + self.target = self._as_name(target) + for k, v in params.items(): + k = ParamKey.make(k) + if not isinstance(v, Param) and v is not None: + raise ValueError(f"{k:d} not a Param") + self.params = dns.immutable.Dict(params) + # Make sure any parameter listed as mandatory is present in the + # record. + mandatory = params.get(ParamKey.MANDATORY) + if mandatory: + for key in mandatory.keys: + # Note we have to say "not in" as we have None as a value + # so a get() and a not None test would be wrong. + if key not in params: + raise ValueError(f"key {key:d} declared mandatory but not present") + # The no-default-alpn parameter requires the alpn parameter. + if ParamKey.NO_DEFAULT_ALPN in params: + if ParamKey.ALPN not in params: + raise ValueError("no-default-alpn present, but alpn missing") + + def to_text(self, origin=None, relativize=True, **kw): + target = self.target.choose_relativity(origin, relativize) + params = [] + for key in sorted(self.params.keys()): + value = self.params[key] + if value is None: + params.append(key_to_text(key)) + else: + kv = key_to_text(key) + "=" + value.to_text() + params.append(kv) + if len(params) > 0: + space = " " + else: + space = "" + return "%d %s%s%s" % (self.priority, target, space, " ".join(params)) + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + priority = tok.get_uint16() + target = tok.get_name(origin, relativize, relativize_to) + if priority == 0: + token = tok.get() + if not token.is_eol_or_eof(): + raise SyntaxError("parameters in AliasMode") + tok.unget(token) + params = {} + while True: + token = tok.get() + if token.is_eol_or_eof(): + tok.unget(token) + break + if token.ttype != dns.tokenizer.IDENTIFIER: + raise SyntaxError("parameter is not an identifier") + equals = token.value.find("=") + if equals == len(token.value) - 1: + # 'key=', so next token should be a quoted string without + # any intervening whitespace. + key = token.value[:-1] + token = tok.get(want_leading=True) + if token.ttype != dns.tokenizer.QUOTED_STRING: + raise SyntaxError("whitespace after =") + value = token.value + elif equals > 0: + # key=value + key = token.value[:equals] + value = token.value[equals + 1 :] + elif equals == 0: + # =key + raise SyntaxError('parameter cannot start with "="') + else: + # key + key = token.value + value = None + _validate_and_define(params, key, value) + return cls(rdclass, rdtype, priority, target, params) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + file.write(struct.pack("!H", self.priority)) + self.target.to_wire(file, None, origin, False) + for key in sorted(self.params): + file.write(struct.pack("!H", key)) + value = self.params[key] + 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): + priority = parser.get_uint16() + target = parser.get_name(origin) + if priority == 0 and parser.remaining() != 0: + raise dns.exception.FormError("parameters in AliasMode") + params = {} + prior_key = -1 + while parser.remaining() > 0: + key = parser.get_uint16() + if key < prior_key: + raise dns.exception.FormError("keys not in order") + prior_key = key + vlen = parser.get_uint16() + pcls = _class_for_key.get(key, GenericParam) + with parser.restrict_to(vlen): + value = pcls.from_wire_parser(parser, origin) + params[key] = value + return cls(rdclass, rdtype, priority, target, params) + + def _processing_priority(self): + return self.priority + + @classmethod + def _processing_order(cls, iterable): + return dns.rdtypes.util.priority_processing_order(iterable) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/tlsabase.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/tlsabase.py new file mode 100644 index 0000000..a059d2c --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/tlsabase.py @@ -0,0 +1,71 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2005-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 binascii +import struct + +import dns.immutable +import dns.rdata +import dns.rdatatype + + +@dns.immutable.immutable +class TLSABase(dns.rdata.Rdata): + """Base class for TLSA and SMIMEA records""" + + # see: RFC 6698 + + __slots__ = ["usage", "selector", "mtype", "cert"] + + def __init__(self, rdclass, rdtype, usage, selector, mtype, cert): + super().__init__(rdclass, rdtype) + self.usage = self._as_uint8(usage) + self.selector = self._as_uint8(selector) + self.mtype = self._as_uint8(mtype) + self.cert = self._as_bytes(cert) + + def to_text(self, origin=None, relativize=True, **kw): + kw = kw.copy() + chunksize = kw.pop("chunksize", 128) + return "%d %d %d %s" % ( + self.usage, + self.selector, + self.mtype, + dns.rdata._hexify(self.cert, chunksize=chunksize, **kw), + ) + + @classmethod + def from_text( + cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None + ): + usage = tok.get_uint8() + selector = tok.get_uint8() + mtype = tok.get_uint8() + cert = tok.concatenate_remaining_identifiers().encode() + cert = binascii.unhexlify(cert) + return cls(rdclass, rdtype, usage, selector, mtype, cert) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + header = struct.pack("!BBB", self.usage, self.selector, self.mtype) + file.write(header) + file.write(self.cert) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + header = parser.get_struct("BBB") + cert = parser.get_remaining() + return cls(rdclass, rdtype, header[0], header[1], header[2], cert) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/txtbase.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/txtbase.py new file mode 100644 index 0000000..44d6df5 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/txtbase.py @@ -0,0 +1,104 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2006-2017 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""TXT-like base class.""" + +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"] + + def __init__( + self, + rdclass: dns.rdataclass.RdataClass, + rdtype: dns.rdatatype.RdataType, + strings: Iterable[Union[bytes, str]], + ): + """Initialize a TXT-like rdata. + + *rdclass*, an ``int`` is the rdataclass of the Rdata. + + *rdtype*, an ``int`` is the rdatatype of the Rdata. + + *strings*, a tuple of ``bytes`` + """ + super().__init__(rdclass, rdtype) + self.strings: Tuple[bytes] = self._as_tuple( + strings, lambda x: self._as_bytes(x, True, 255) + ) + + def to_text( + self, + origin: Optional[dns.name.Name] = None, + relativize: bool = True, + **kw: Dict[str, Any], + ) -> str: + txt = "" + prefix = "" + for s in self.strings: + txt += '{}"{}"'.format(prefix, dns.rdata._escapify(s)) + prefix = " " + return txt + + @classmethod + def from_text( + cls, + rdclass: dns.rdataclass.RdataClass, + rdtype: dns.rdatatype.RdataType, + tok: dns.tokenizer.Tokenizer, + origin: Optional[dns.name.Name] = None, + relativize: bool = True, + relativize_to: Optional[dns.name.Name] = None, + ) -> dns.rdata.Rdata: + strings = [] + for token in tok.get_remaining(): + token = token.unescape_to_bytes() + # The 'if' below is always true in the current code, but we + # are leaving this check in in case things change some day. + if not ( + token.is_quoted_string() or token.is_identifier() + ): # pragma: no cover + raise dns.exception.SyntaxError("expected a string") + if len(token.value) > 255: + raise dns.exception.SyntaxError("string too long") + strings.append(token.value) + if len(strings) == 0: + raise dns.exception.UnexpectedEnd + return cls(rdclass, rdtype, strings) + + def _to_wire(self, file, compress=None, origin=None, canonicalize=False): + for s in self.strings: + with dns.renderer.prefixed_length(file, 1): + file.write(s) + + @classmethod + def from_wire_parser(cls, rdclass, rdtype, parser, origin=None): + strings = [] + while parser.remaining() > 0: + s = parser.get_counted_bytes() + strings.append(s) + return cls(rdclass, rdtype, strings) diff --git a/.venv/lib/python3.12/site-packages/dns/rdtypes/util.py b/.venv/lib/python3.12/site-packages/dns/rdtypes/util.py new file mode 100644 index 0000000..54908fd --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rdtypes/util.py @@ -0,0 +1,257 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2006, 2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 collections +import random +import struct +from typing import Any, List + +import dns.exception +import dns.ipv4 +import dns.ipv6 +import dns.name +import dns.rdata + + +class Gateway: + """A helper class for the IPSECKEY gateway and AMTRELAY relay fields""" + + name = "" + + def __init__(self, type, gateway=None): + self.type = dns.rdata.Rdata._as_uint8(type) + self.gateway = gateway + self._check() + + @classmethod + def _invalid_type(cls, gateway_type): + return f"invalid {cls.name} type: {gateway_type}" + + def _check(self): + if self.type == 0: + if self.gateway not in (".", None): + raise SyntaxError(f"invalid {self.name} for type 0") + self.gateway = None + elif self.type == 1: + # check that it's OK + dns.ipv4.inet_aton(self.gateway) + elif self.type == 2: + # check that it's OK + dns.ipv6.inet_aton(self.gateway) + elif self.type == 3: + if not isinstance(self.gateway, dns.name.Name): + raise SyntaxError(f"invalid {self.name}; not a name") + else: + raise SyntaxError(self._invalid_type(self.type)) + + def to_text(self, origin=None, relativize=True): + if self.type == 0: + return "." + elif self.type in (1, 2): + return self.gateway + elif self.type == 3: + return str(self.gateway.choose_relativity(origin, relativize)) + else: + raise ValueError(self._invalid_type(self.type)) # pragma: no cover + + @classmethod + def from_text( + cls, gateway_type, tok, origin=None, relativize=True, relativize_to=None + ): + if gateway_type in (0, 1, 2): + gateway = tok.get_string() + elif gateway_type == 3: + gateway = tok.get_name(origin, relativize, relativize_to) + else: + raise dns.exception.SyntaxError( + cls._invalid_type(gateway_type) + ) # pragma: no cover + return cls(gateway_type, gateway) + + # pylint: disable=unused-argument + def to_wire(self, file, compress=None, origin=None, canonicalize=False): + if self.type == 0: + pass + elif self.type == 1: + file.write(dns.ipv4.inet_aton(self.gateway)) + elif self.type == 2: + file.write(dns.ipv6.inet_aton(self.gateway)) + elif self.type == 3: + self.gateway.to_wire(file, None, origin, False) + else: + raise ValueError(self._invalid_type(self.type)) # pragma: no cover + + # pylint: enable=unused-argument + + @classmethod + def from_wire_parser(cls, gateway_type, parser, origin=None): + if gateway_type == 0: + gateway = None + elif gateway_type == 1: + gateway = dns.ipv4.inet_ntoa(parser.get_bytes(4)) + elif gateway_type == 2: + gateway = dns.ipv6.inet_ntoa(parser.get_bytes(16)) + elif gateway_type == 3: + gateway = parser.get_name(origin) + else: + raise dns.exception.FormError(cls._invalid_type(gateway_type)) + return cls(gateway_type, gateway) + + +class Bitmap: + """A helper class for the NSEC/NSEC3/CSYNC type bitmaps""" + + type_name = "" + + def __init__(self, windows=None): + last_window = -1 + self.windows = windows + for window, bitmap in self.windows: + if not isinstance(window, int): + raise ValueError(f"bad {self.type_name} window type") + if window <= last_window: + raise ValueError(f"bad {self.type_name} window order") + if window > 256: + raise ValueError(f"bad {self.type_name} window number") + last_window = window + if not isinstance(bitmap, bytes): + raise ValueError(f"bad {self.type_name} octets type") + if len(bitmap) == 0 or len(bitmap) > 32: + raise ValueError(f"bad {self.type_name} octets") + + def to_text(self) -> str: + text = "" + for window, bitmap in self.windows: + bits = [] + for i, byte in enumerate(bitmap): + for j in range(0, 8): + if byte & (0x80 >> j): + rdtype = window * 256 + i * 8 + j + bits.append(dns.rdatatype.to_text(rdtype)) + text += " " + " ".join(bits) + return text + + @classmethod + def from_text(cls, tok: "dns.tokenizer.Tokenizer") -> "Bitmap": + rdtypes = [] + for token in tok.get_remaining(): + rdtype = dns.rdatatype.from_text(token.unescape().value) + if rdtype == 0: + raise dns.exception.SyntaxError(f"{cls.type_name} with bit 0") + rdtypes.append(rdtype) + return cls.from_rdtypes(rdtypes) + + @classmethod + def from_rdtypes(cls, rdtypes: List[dns.rdatatype.RdataType]) -> "Bitmap": + rdtypes = sorted(rdtypes) + window = 0 + octets = 0 + prior_rdtype = 0 + bitmap = bytearray(b"\0" * 32) + windows = [] + for rdtype in rdtypes: + if rdtype == prior_rdtype: + continue + prior_rdtype = rdtype + new_window = rdtype // 256 + if new_window != window: + if octets != 0: + windows.append((window, bytes(bitmap[0:octets]))) + bitmap = bytearray(b"\0" * 32) + window = new_window + offset = rdtype % 256 + byte = offset // 8 + bit = offset % 8 + octets = byte + 1 + bitmap[byte] = bitmap[byte] | (0x80 >> bit) + if octets != 0: + windows.append((window, bytes(bitmap[0:octets]))) + return cls(windows) + + def to_wire(self, file: Any) -> None: + for window, bitmap in self.windows: + file.write(struct.pack("!BB", window, len(bitmap))) + file.write(bitmap) + + @classmethod + def from_wire_parser(cls, parser: "dns.wire.Parser") -> "Bitmap": + windows = [] + while parser.remaining() > 0: + window = parser.get_uint8() + bitmap = parser.get_counted_bytes() + windows.append((window, bitmap)) + return cls(windows) + + +def _priority_table(items): + by_priority = collections.defaultdict(list) + for rdata in items: + by_priority[rdata._processing_priority()].append(rdata) + return by_priority + + +def priority_processing_order(iterable): + items = list(iterable) + if len(items) == 1: + return items + by_priority = _priority_table(items) + ordered = [] + for k in sorted(by_priority.keys()): + rdatas = by_priority[k] + random.shuffle(rdatas) + ordered.extend(rdatas) + return ordered + + +_no_weight = 0.1 + + +def weighted_processing_order(iterable): + items = list(iterable) + if len(items) == 1: + return items + by_priority = _priority_table(items) + ordered = [] + for k in sorted(by_priority.keys()): + rdatas = by_priority[k] + total = sum(rdata._processing_weight() or _no_weight for rdata in rdatas) + while len(rdatas) > 1: + r = random.uniform(0, total) + for n, rdata in enumerate(rdatas): + weight = rdata._processing_weight() or _no_weight + if weight > r: + break + r -= weight + total -= weight + ordered.append(rdata) # pylint: disable=undefined-loop-variable + del rdatas[n] # pylint: disable=undefined-loop-variable + ordered.append(rdatas[0]) + return ordered + + +def parse_formatted_hex(formatted, num_chunks, chunk_size, separator): + if len(formatted) != num_chunks * (chunk_size + 1) - 1: + raise ValueError("invalid formatted hex string") + value = b"" + for _ in range(num_chunks): + chunk = formatted[0:chunk_size] + value += int(chunk, 16).to_bytes(chunk_size // 2, "big") + formatted = formatted[chunk_size:] + if len(formatted) > 0 and formatted[0] != separator: + raise ValueError("invalid formatted hex string") + formatted = formatted[1:] + return value diff --git a/.venv/lib/python3.12/site-packages/dns/renderer.py b/.venv/lib/python3.12/site-packages/dns/renderer.py new file mode 100644 index 0000000..a77481f --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/renderer.py @@ -0,0 +1,346 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2001-2017 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""Help for building DNS wire format messages""" + +import contextlib +import io +import random +import struct +import time + +import dns.exception +import dns.tsig + +QUESTION = 0 +ANSWER = 1 +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. + + Most applications can use the higher-level L{dns.message.Message} + class and its to_wire() method to generate wire-format messages. + This class is for those applications which need finer control + over the generation of messages. + + Typical use:: + + r = dns.renderer.Renderer(id=1, flags=0x80, max_size=512) + r.add_question(qname, qtype, qclass) + r.add_rrset(dns.renderer.ANSWER, rrset_1) + r.add_rrset(dns.renderer.ANSWER, rrset_2) + r.add_rrset(dns.renderer.AUTHORITY, ns_rrset) + r.add_rrset(dns.renderer.ADDITIONAL, ad_rrset_1) + r.add_rrset(dns.renderer.ADDITIONAL, ad_rrset_2) + r.add_edns(0, 0, 4096) + r.write_header() + r.add_tsig(keyname, secret, 300, 1, 0, '', request_mac) + wire = r.get_wire() + + If padding is going to be used, then the OPT record MUST be + written after everything else in the additional section except for + the TSIG (if any). + + output, an io.BytesIO, where rendering is written + + id: the message id + + flags: the message flags + + max_size: the maximum size of the message + + origin: the origin to use when rendering relative names + + compress: the compression table + + section: an int, the section currently being rendered + + counts: list of the number of RRs in each section + + mac: the MAC of the rendered message (if TSIG was used) + """ + + def __init__(self, id=None, flags=0, max_size=65535, origin=None): + """Initialize a new renderer.""" + + self.output = io.BytesIO() + if id is None: + self.id = random.randint(0, 65535) + else: + self.id = id + self.flags = flags + self.max_size = max_size + self.origin = origin + self.compress = {} + self.section = QUESTION + self.counts = [0, 0, 0, 0] + self.output.write(b"\x00" * 12) + self.mac = "" + self.reserved = 0 + self.was_padded = False + + def _rollback(self, where): + """Truncate the output buffer at offset *where*, and remove any + compression table entries that pointed beyond the truncation + point. + """ + + self.output.seek(where) + self.output.truncate() + keys_to_delete = [] + for k, v in self.compress.items(): + if v >= where: + keys_to_delete.append(k) + for k in keys_to_delete: + del self.compress[k] + + def _set_section(self, section): + """Set the renderer's current section. + + Sections must be rendered order: QUESTION, ANSWER, AUTHORITY, + ADDITIONAL. Sections may be empty. + + Raises dns.exception.FormError if an attempt was made to set + a section value less than the current section. + """ + + if self.section != section: + if self.section > section: + raise dns.exception.FormError + self.section = section + + @contextlib.contextmanager + def _track_size(self): + start = self.output.tell() + yield start + if self.output.tell() > self.max_size: + 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.""" + + self._set_section(QUESTION) + with self._track_size(): + qname.to_wire(self.output, self.compress, self.origin) + self.output.write(struct.pack("!HH", rdtype, rdclass)) + self.counts[QUESTION] += 1 + + def add_rrset(self, section, rrset, **kw): + """Add the rrset to the specified section. + + Any keyword arguments are passed on to the rdataset's to_wire() + routine. + """ + + self._set_section(section) + with self._track_size(): + n = rrset.to_wire(self.output, self.compress, self.origin, **kw) + self.counts[section] += n + + def add_rdataset(self, section, name, rdataset, **kw): + """Add the rdataset to the specified section, using the specified + name as the owner name. + + Any keyword arguments are passed on to the rdataset's to_wire() + routine. + """ + + self._set_section(section) + with self._track_size(): + n = rdataset.to_wire(name, self.output, self.compress, self.origin, **kw) + self.counts[section] += n + + def add_opt(self, opt, pad=0, opt_size=0, tsig_size=0): + """Add *opt* to the additional section, applying padding if desired. The + padding will take the specified precomputed OPT size and TSIG size into + account. + + Note that we don't have reliable way of knowing how big a GSS-TSIG digest + might be, so we we might not get an even multiple of the pad in that case.""" + if pad: + ttl = opt.ttl + assert opt_size >= 11 + opt_rdata = opt[0] + size_without_padding = self.output.tell() + opt_size + tsig_size + remainder = size_without_padding % pad + if remainder: + pad = b"\x00" * (pad - remainder) + else: + pad = b"" + options = list(opt_rdata.options) + options.append(dns.edns.GenericOption(dns.edns.OptionType.PADDING, pad)) + opt = dns.message.Message._make_opt(ttl, opt_rdata.rdclass, options) + self.was_padded = True + self.add_rrset(ADDITIONAL, opt) + + def add_edns(self, edns, ednsflags, payload, options=None): + """Add an EDNS OPT record to the message.""" + + # make sure the EDNS version in ednsflags agrees with edns + ednsflags &= 0xFF00FFFF + ednsflags |= edns << 16 + opt = dns.message.Message._make_opt(ednsflags, payload, options) + self.add_opt(opt) + + def add_tsig( + self, + keyname, + secret, + fudge, + id, + tsig_error, + other_data, + request_mac, + algorithm=dns.tsig.default_algorithm, + ): + """Add a TSIG signature to the message.""" + + s = self.output.getvalue() + + if isinstance(secret, dns.tsig.Key): + key = secret + else: + key = dns.tsig.Key(keyname, secret, algorithm) + tsig = dns.message.Message._make_tsig( + keyname, algorithm, 0, fudge, b"", id, tsig_error, other_data + ) + (tsig, _) = dns.tsig.sign(s, key, tsig[0], int(time.time()), request_mac) + self._write_tsig(tsig, keyname) + + def add_multi_tsig( + self, + ctx, + keyname, + secret, + fudge, + id, + tsig_error, + other_data, + request_mac, + algorithm=dns.tsig.default_algorithm, + ): + """Add a TSIG signature to the message. Unlike add_tsig(), this can be + used for a series of consecutive DNS envelopes, e.g. for a zone + transfer over TCP [RFC2845, 4.4]. + + For the first message in the sequence, give ctx=None. For each + subsequent message, give the ctx that was returned from the + add_multi_tsig() call for the previous message.""" + + s = self.output.getvalue() + + if isinstance(secret, dns.tsig.Key): + key = secret + else: + key = dns.tsig.Key(keyname, secret, algorithm) + tsig = dns.message.Message._make_tsig( + keyname, algorithm, 0, fudge, b"", id, tsig_error, other_data + ) + (tsig, ctx) = dns.tsig.sign( + s, key, tsig[0], int(time.time()), request_mac, ctx, True + ) + self._write_tsig(tsig, keyname) + return ctx + + def _write_tsig(self, tsig, keyname): + if self.was_padded: + compress = None + else: + compress = self.compress + self._set_section(ADDITIONAL) + with self._track_size(): + keyname.to_wire(self.output, compress, self.origin) + self.output.write( + struct.pack("!HHI", dns.rdatatype.TSIG, dns.rdataclass.ANY, 0) + ) + with prefixed_length(self.output, 2): + tsig.to_wire(self.output) + + self.counts[ADDITIONAL] += 1 + with self._temporarily_seek_to(10): + self.output.write(struct.pack("!H", self.counts[ADDITIONAL])) + + def write_header(self): + """Write the DNS message header. + + Writing the DNS message header is done after all sections + have been rendered, but before the optional TSIG signature + is added. + """ + + 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], + ) + ) + + def get_wire(self): + """Return the wire format message.""" + + return self.output.getvalue() + + def reserve(self, size: int) -> None: + """Reserve *size* bytes.""" + if size < 0: + raise ValueError("reserved amount must be non-negative") + if size > self.max_size: + raise ValueError("cannot reserve more than the maximum size") + self.reserved += size + self.max_size -= size + + def release_reserved(self) -> None: + """Release the reserved bytes.""" + self.max_size += self.reserved + self.reserved = 0 diff --git a/.venv/lib/python3.12/site-packages/dns/resolver.py b/.venv/lib/python3.12/site-packages/dns/resolver.py new file mode 100644 index 0000000..f08f824 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/resolver.py @@ -0,0 +1,2054 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2017 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""DNS stub resolver.""" + +import contextlib +import random +import socket +import sys +import threading +import time +import warnings +from typing import Any, Dict, Iterator, List, Optional, Sequence, Tuple, Union +from urllib.parse import urlparse + +import dns._ddr +import dns.edns +import dns.exception +import dns.flags +import dns.inet +import dns.ipv4 +import dns.ipv6 +import dns.message +import dns.name +import dns.nameserver +import dns.query +import dns.rcode +import dns.rdataclass +import dns.rdatatype +import dns.rdtypes.svcbbase +import dns.reversename +import dns.tsig + +if sys.platform == "win32": + import dns.win32util + + +class NXDOMAIN(dns.exception.DNSException): + """The DNS query name does not exist.""" + + supp_kwargs = {"qnames", "responses"} + fmt = None # we have our own __str__ implementation + + # pylint: disable=arguments-differ + + # We do this as otherwise mypy complains about unexpected keyword argument + # idna_exception + def __init__(self, *args, **kwargs): + super().__init__(*args, **kwargs) + + def _check_kwargs(self, qnames, responses=None): + if not isinstance(qnames, (list, tuple, set)): + raise AttributeError("qnames must be a list, tuple or set") + if len(qnames) == 0: + raise AttributeError("qnames must contain at least one element") + if responses is None: + responses = {} + elif not isinstance(responses, dict): + raise AttributeError("responses must be a dict(qname=response)") + kwargs = dict(qnames=qnames, responses=responses) + return kwargs + + def __str__(self) -> str: + if "qnames" not in self.kwargs: + return super().__str__() + qnames = self.kwargs["qnames"] + if len(qnames) > 1: + msg = "None of DNS query names exist" + else: + msg = "The DNS query name does not exist" + qnames = ", ".join(map(str, qnames)) + return "{}: {}".format(msg, qnames) + + @property + def canonical_name(self): + """Return the unresolved canonical name.""" + if "qnames" not in self.kwargs: + raise TypeError("parametrized exception required") + for qname in self.kwargs["qnames"]: + response = self.kwargs["responses"][qname] + try: + cname = response.canonical_name() + if cname != qname: + return cname + except Exception: + # We can just eat this exception as it means there was + # something wrong with the response. + pass + return self.kwargs["qnames"][0] + + def __add__(self, e_nx): + """Augment by results from another NXDOMAIN exception.""" + qnames0 = list(self.kwargs.get("qnames", [])) + responses0 = dict(self.kwargs.get("responses", {})) + responses1 = e_nx.kwargs.get("responses", {}) + for qname1 in e_nx.kwargs.get("qnames", []): + if qname1 not in qnames0: + qnames0.append(qname1) + if qname1 in responses1: + responses0[qname1] = responses1[qname1] + return NXDOMAIN(qnames=qnames0, responses=responses0) + + def qnames(self): + """All of the names that were tried. + + Returns a list of ``dns.name.Name``. + """ + return self.kwargs["qnames"] + + def responses(self): + """A map from queried names to their NXDOMAIN responses. + + Returns a dict mapping a ``dns.name.Name`` to a + ``dns.message.Message``. + """ + return self.kwargs["responses"] + + def response(self, qname): + """The response for query *qname*. + + Returns a ``dns.message.Message``. + """ + return self.kwargs["responses"][qname] + + +class YXDOMAIN(dns.exception.DNSException): + """The DNS query name is too long after DNAME substitution.""" + + +ErrorTuple = Tuple[ + Optional[str], + bool, + int, + Union[Exception, str], + Optional[dns.message.Message], +] + + +def _errors_to_text(errors: List[ErrorTuple]) -> List[str]: + """Turn a resolution errors trace into a list of text.""" + texts = [] + for err in errors: + texts.append("Server {} answered {}".format(err[0], err[3])) + return texts + + +class LifetimeTimeout(dns.exception.Timeout): + """The resolution lifetime expired.""" + + msg = "The resolution lifetime expired." + fmt = "%s after {timeout:.3f} seconds: {errors}" % msg[:-1] + supp_kwargs = {"timeout", "errors"} + + # We do this as otherwise mypy complains about unexpected keyword argument + # idna_exception + def __init__(self, *args, **kwargs): + super().__init__(*args, **kwargs) + + def _fmt_kwargs(self, **kwargs): + srv_msgs = _errors_to_text(kwargs["errors"]) + return super()._fmt_kwargs( + timeout=kwargs["timeout"], errors="; ".join(srv_msgs) + ) + + +# We added more detail to resolution timeouts, but they are still +# subclasses of dns.exception.Timeout for backwards compatibility. We also +# keep dns.resolver.Timeout defined for backwards compatibility. +Timeout = LifetimeTimeout + + +class NoAnswer(dns.exception.DNSException): + """The DNS response does not contain an answer to the question.""" + + fmt = "The DNS response does not contain an answer to the question: {query}" + supp_kwargs = {"response"} + + # We do this as otherwise mypy complains about unexpected keyword argument + # idna_exception + def __init__(self, *args, **kwargs): + super().__init__(*args, **kwargs) + + def _fmt_kwargs(self, **kwargs): + return super()._fmt_kwargs(query=kwargs["response"].question) + + def response(self): + return self.kwargs["response"] + + +class NoNameservers(dns.exception.DNSException): + """All nameservers failed to answer the query. + + errors: list of servers and respective errors + The type of errors is + [(server IP address, any object convertible to string)]. + Non-empty errors list will add explanatory message () + """ + + msg = "All nameservers failed to answer the query." + fmt = "%s {query}: {errors}" % msg[:-1] + supp_kwargs = {"request", "errors"} + + # We do this as otherwise mypy complains about unexpected keyword argument + # idna_exception + def __init__(self, *args, **kwargs): + super().__init__(*args, **kwargs) + + def _fmt_kwargs(self, **kwargs): + srv_msgs = _errors_to_text(kwargs["errors"]) + return super()._fmt_kwargs( + query=kwargs["request"].question, errors="; ".join(srv_msgs) + ) + + +class NotAbsolute(dns.exception.DNSException): + """An absolute domain name is required but a relative name was provided.""" + + +class NoRootSOA(dns.exception.DNSException): + """There is no SOA RR at the DNS root name. This should never happen!""" + + +class NoMetaqueries(dns.exception.DNSException): + """DNS metaqueries are not allowed.""" + + +class NoResolverConfiguration(dns.exception.DNSException): + """Resolver configuration could not be read or specified no nameservers.""" + + +class Answer: + """DNS stub resolver answer. + + Instances of this class bundle up the result of a successful DNS + resolution. + + For convenience, the answer object implements much of the sequence + protocol, forwarding to its ``rrset`` attribute. E.g. + ``for a in answer`` is equivalent to ``for a in answer.rrset``. + ``answer[i]`` is equivalent to ``answer.rrset[i]``, and + ``answer[i:j]`` is equivalent to ``answer.rrset[i:j]``. + + Note that CNAMEs or DNAMEs in the response may mean that answer + RRset's name might not be the query name. + """ + + def __init__( + self, + qname: dns.name.Name, + rdtype: dns.rdatatype.RdataType, + rdclass: dns.rdataclass.RdataClass, + response: dns.message.QueryMessage, + nameserver: Optional[str] = None, + port: Optional[int] = None, + ) -> None: + self.qname = qname + self.rdtype = rdtype + self.rdclass = rdclass + self.response = response + self.nameserver = nameserver + self.port = port + self.chaining_result = response.resolve_chaining() + # Copy some attributes out of chaining_result for backwards + # compatibility and convenience. + self.canonical_name = self.chaining_result.canonical_name + self.rrset = self.chaining_result.answer + self.expiration = time.time() + self.chaining_result.minimum_ttl + + def __getattr__(self, attr): # pragma: no cover + if attr == "name": + return self.rrset.name + elif attr == "ttl": + return self.rrset.ttl + elif attr == "covers": + return self.rrset.covers + elif attr == "rdclass": + return self.rrset.rdclass + elif attr == "rdtype": + return self.rrset.rdtype + else: + raise AttributeError(attr) + + def __len__(self) -> int: + return self.rrset and len(self.rrset) or 0 + + def __iter__(self): + return self.rrset and iter(self.rrset) or iter(tuple()) + + def __getitem__(self, i): + if self.rrset is None: + raise IndexError + return self.rrset[i] + + def __delitem__(self, i): + if self.rrset is None: + raise IndexError + del self.rrset[i] + + +class Answers(dict): + """A dict of DNS stub resolver answers, indexed by type.""" + + +class HostAnswers(Answers): + """A dict of DNS stub resolver answers to a host name lookup, indexed by + type. + """ + + @classmethod + def make( + cls, + v6: Optional[Answer] = None, + v4: Optional[Answer] = None, + add_empty: bool = True, + ) -> "HostAnswers": + answers = HostAnswers() + if v6 is not None and (add_empty or v6.rrset): + answers[dns.rdatatype.AAAA] = v6 + if v4 is not None and (add_empty or v4.rrset): + answers[dns.rdatatype.A] = v4 + return answers + + # Returns pairs of (address, family) from this result, potentiallys + # filtering by address family. + def addresses_and_families( + self, family: int = socket.AF_UNSPEC + ) -> Iterator[Tuple[str, int]]: + if family == socket.AF_UNSPEC: + yield from self.addresses_and_families(socket.AF_INET6) + yield from self.addresses_and_families(socket.AF_INET) + return + elif family == socket.AF_INET6: + answer = self.get(dns.rdatatype.AAAA) + elif family == socket.AF_INET: + answer = self.get(dns.rdatatype.A) + else: + raise NotImplementedError(f"unknown address family {family}") + if answer: + for rdata in answer: + yield (rdata.address, family) + + # Returns addresses from this result, potentially filtering by + # address family. + def addresses(self, family: int = socket.AF_UNSPEC) -> Iterator[str]: + return (pair[0] for pair in self.addresses_and_families(family)) + + # Returns the canonical name from this result. + def canonical_name(self) -> dns.name.Name: + answer = self.get(dns.rdatatype.AAAA, self.get(dns.rdatatype.A)) + return answer.canonical_name + + +class CacheStatistics: + """Cache Statistics""" + + def __init__(self, hits: int = 0, misses: int = 0) -> None: + self.hits = hits + self.misses = misses + + def reset(self) -> None: + self.hits = 0 + self.misses = 0 + + def clone(self) -> "CacheStatistics": + return CacheStatistics(self.hits, self.misses) + + +class CacheBase: + def __init__(self) -> None: + self.lock = threading.Lock() + self.statistics = CacheStatistics() + + def reset_statistics(self) -> None: + """Reset all statistics to zero.""" + with self.lock: + self.statistics.reset() + + def hits(self) -> int: + """How many hits has the cache had?""" + with self.lock: + return self.statistics.hits + + def misses(self) -> int: + """How many misses has the cache had?""" + with self.lock: + return self.statistics.misses + + def get_statistics_snapshot(self) -> CacheStatistics: + """Return a consistent snapshot of all the statistics. + + If running with multiple threads, it's better to take a + snapshot than to call statistics methods such as hits() and + misses() individually. + """ + with self.lock: + return self.statistics.clone() + + +CacheKey = Tuple[dns.name.Name, dns.rdatatype.RdataType, dns.rdataclass.RdataClass] + + +class Cache(CacheBase): + """Simple thread-safe DNS answer cache.""" + + def __init__(self, cleaning_interval: float = 300.0) -> None: + """*cleaning_interval*, a ``float`` is the number of seconds between + periodic cleanings. + """ + + super().__init__() + self.data: Dict[CacheKey, Answer] = {} + self.cleaning_interval = cleaning_interval + self.next_cleaning: float = time.time() + self.cleaning_interval + + def _maybe_clean(self) -> None: + """Clean the cache if it's time to do so.""" + + now = time.time() + if self.next_cleaning <= now: + keys_to_delete = [] + for k, v in self.data.items(): + if v.expiration <= now: + keys_to_delete.append(k) + for k in keys_to_delete: + del self.data[k] + now = time.time() + self.next_cleaning = now + self.cleaning_interval + + def get(self, key: CacheKey) -> Optional[Answer]: + """Get the answer associated with *key*. + + Returns None if no answer is cached for the key. + + *key*, a ``(dns.name.Name, dns.rdatatype.RdataType, dns.rdataclass.RdataClass)`` + tuple whose values are the query name, rdtype, and rdclass respectively. + + Returns a ``dns.resolver.Answer`` or ``None``. + """ + + with self.lock: + self._maybe_clean() + v = self.data.get(key) + if v is None or v.expiration <= time.time(): + self.statistics.misses += 1 + return None + self.statistics.hits += 1 + return v + + def put(self, key: CacheKey, value: Answer) -> None: + """Associate key and value in the cache. + + *key*, a ``(dns.name.Name, dns.rdatatype.RdataType, dns.rdataclass.RdataClass)`` + tuple whose values are the query name, rdtype, and rdclass respectively. + + *value*, a ``dns.resolver.Answer``, the answer. + """ + + with self.lock: + self._maybe_clean() + self.data[key] = value + + def flush(self, key: Optional[CacheKey] = None) -> None: + """Flush the cache. + + If *key* is not ``None``, only that item is flushed. Otherwise the entire cache + is flushed. + + *key*, a ``(dns.name.Name, dns.rdatatype.RdataType, dns.rdataclass.RdataClass)`` + tuple whose values are the query name, rdtype, and rdclass respectively. + """ + + with self.lock: + if key is not None: + if key in self.data: + del self.data[key] + else: + self.data = {} + self.next_cleaning = time.time() + self.cleaning_interval + + +class LRUCacheNode: + """LRUCache node.""" + + def __init__(self, key, value): + self.key = key + self.value = value + self.hits = 0 + self.prev = self + self.next = self + + def link_after(self, node: "LRUCacheNode") -> None: + self.prev = node + self.next = node.next + node.next.prev = self + node.next = self + + def unlink(self) -> None: + self.next.prev = self.prev + self.prev.next = self.next + + +class LRUCache(CacheBase): + """Thread-safe, bounded, least-recently-used DNS answer cache. + + This cache is better than the simple cache (above) if you're + running a web crawler or other process that does a lot of + resolutions. The LRUCache has a maximum number of nodes, and when + it is full, the least-recently used node is removed to make space + for a new one. + """ + + def __init__(self, max_size: int = 100000) -> None: + """*max_size*, an ``int``, is the maximum number of nodes to cache; + it must be greater than 0. + """ + + super().__init__() + self.data: Dict[CacheKey, LRUCacheNode] = {} + self.set_max_size(max_size) + self.sentinel: LRUCacheNode = LRUCacheNode(None, None) + self.sentinel.prev = self.sentinel + self.sentinel.next = self.sentinel + + def set_max_size(self, max_size: int) -> None: + if max_size < 1: + max_size = 1 + self.max_size = max_size + + def get(self, key: CacheKey) -> Optional[Answer]: + """Get the answer associated with *key*. + + Returns None if no answer is cached for the key. + + *key*, a ``(dns.name.Name, dns.rdatatype.RdataType, dns.rdataclass.RdataClass)`` + tuple whose values are the query name, rdtype, and rdclass respectively. + + Returns a ``dns.resolver.Answer`` or ``None``. + """ + + with self.lock: + node = self.data.get(key) + if node is None: + self.statistics.misses += 1 + return None + # Unlink because we're either going to move the node to the front + # of the LRU list or we're going to free it. + node.unlink() + if node.value.expiration <= time.time(): + del self.data[node.key] + self.statistics.misses += 1 + return None + node.link_after(self.sentinel) + self.statistics.hits += 1 + node.hits += 1 + return node.value + + def get_hits_for_key(self, key: CacheKey) -> int: + """Return the number of cache hits associated with the specified key.""" + with self.lock: + node = self.data.get(key) + if node is None or node.value.expiration <= time.time(): + return 0 + else: + return node.hits + + def put(self, key: CacheKey, value: Answer) -> None: + """Associate key and value in the cache. + + *key*, a ``(dns.name.Name, dns.rdatatype.RdataType, dns.rdataclass.RdataClass)`` + tuple whose values are the query name, rdtype, and rdclass respectively. + + *value*, a ``dns.resolver.Answer``, the answer. + """ + + with self.lock: + node = self.data.get(key) + if node is not None: + node.unlink() + del self.data[node.key] + while len(self.data) >= self.max_size: + gnode = self.sentinel.prev + gnode.unlink() + del self.data[gnode.key] + node = LRUCacheNode(key, value) + node.link_after(self.sentinel) + self.data[key] = node + + def flush(self, key: Optional[CacheKey] = None) -> None: + """Flush the cache. + + If *key* is not ``None``, only that item is flushed. Otherwise the entire cache + is flushed. + + *key*, a ``(dns.name.Name, dns.rdatatype.RdataType, dns.rdataclass.RdataClass)`` + tuple whose values are the query name, rdtype, and rdclass respectively. + """ + + with self.lock: + if key is not None: + node = self.data.get(key) + if node is not None: + node.unlink() + del self.data[node.key] + else: + gnode = self.sentinel.next + while gnode != self.sentinel: + next = gnode.next + gnode.unlink() + gnode = next + self.data = {} + + +class _Resolution: + """Helper class for dns.resolver.Resolver.resolve(). + + All of the "business logic" of resolution is encapsulated in this + class, allowing us to have multiple resolve() implementations + using different I/O schemes without copying all of the + complicated logic. + + This class is a "friend" to dns.resolver.Resolver and manipulates + resolver data structures directly. + """ + + def __init__( + self, + resolver: "BaseResolver", + qname: Union[dns.name.Name, str], + rdtype: Union[dns.rdatatype.RdataType, str], + rdclass: Union[dns.rdataclass.RdataClass, str], + tcp: bool, + raise_on_no_answer: bool, + search: Optional[bool], + ) -> None: + if isinstance(qname, str): + qname = dns.name.from_text(qname, None) + rdtype = dns.rdatatype.RdataType.make(rdtype) + if dns.rdatatype.is_metatype(rdtype): + raise NoMetaqueries + rdclass = dns.rdataclass.RdataClass.make(rdclass) + if dns.rdataclass.is_metaclass(rdclass): + raise NoMetaqueries + self.resolver = resolver + self.qnames_to_try = resolver._get_qnames_to_try(qname, search) + self.qnames = self.qnames_to_try[:] + self.rdtype = rdtype + self.rdclass = rdclass + self.tcp = tcp + self.raise_on_no_answer = raise_on_no_answer + self.nxdomain_responses: Dict[dns.name.Name, dns.message.QueryMessage] = {} + # Initialize other things to help analysis tools + self.qname = dns.name.empty + self.nameservers: List[dns.nameserver.Nameserver] = [] + self.current_nameservers: List[dns.nameserver.Nameserver] = [] + self.errors: List[ErrorTuple] = [] + self.nameserver: Optional[dns.nameserver.Nameserver] = None + self.tcp_attempt = False + self.retry_with_tcp = False + self.request: Optional[dns.message.QueryMessage] = None + self.backoff = 0.0 + + def next_request( + self, + ) -> Tuple[Optional[dns.message.QueryMessage], Optional[Answer]]: + """Get the next request to send, and check the cache. + + Returns a (request, answer) tuple. At most one of request or + answer will not be None. + """ + + # We return a tuple instead of Union[Message,Answer] as it lets + # the caller avoid isinstance(). + + while len(self.qnames) > 0: + self.qname = self.qnames.pop(0) + + # Do we know the answer? + if self.resolver.cache: + answer = self.resolver.cache.get( + (self.qname, self.rdtype, self.rdclass) + ) + if answer is not None: + if answer.rrset is None and self.raise_on_no_answer: + raise NoAnswer(response=answer.response) + else: + return (None, answer) + answer = self.resolver.cache.get( + (self.qname, dns.rdatatype.ANY, self.rdclass) + ) + if answer is not None and answer.response.rcode() == dns.rcode.NXDOMAIN: + # cached NXDOMAIN; record it and continue to next + # name. + self.nxdomain_responses[self.qname] = answer.response + continue + + # Build the request + request = dns.message.make_query(self.qname, self.rdtype, self.rdclass) + if self.resolver.keyname is not None: + request.use_tsig( + self.resolver.keyring, + self.resolver.keyname, + algorithm=self.resolver.keyalgorithm, + ) + request.use_edns( + self.resolver.edns, + self.resolver.ednsflags, + self.resolver.payload, + options=self.resolver.ednsoptions, + ) + if self.resolver.flags is not None: + request.flags = self.resolver.flags + + self.nameservers = self.resolver._enrich_nameservers( + self.resolver._nameservers, + self.resolver.nameserver_ports, + self.resolver.port, + ) + if self.resolver.rotate: + random.shuffle(self.nameservers) + self.current_nameservers = self.nameservers[:] + self.errors = [] + self.nameserver = None + self.tcp_attempt = False + self.retry_with_tcp = False + self.request = request + self.backoff = 0.10 + + return (request, None) + + # + # We've tried everything and only gotten NXDOMAINs. (We know + # it's only NXDOMAINs as anything else would have returned + # before now.) + # + raise NXDOMAIN(qnames=self.qnames_to_try, responses=self.nxdomain_responses) + + def next_nameserver(self) -> Tuple[dns.nameserver.Nameserver, bool, float]: + if self.retry_with_tcp: + assert self.nameserver is not None + assert not self.nameserver.is_always_max_size() + self.tcp_attempt = True + self.retry_with_tcp = False + return (self.nameserver, True, 0) + + backoff = 0.0 + if not self.current_nameservers: + if len(self.nameservers) == 0: + # Out of things to try! + raise NoNameservers(request=self.request, errors=self.errors) + self.current_nameservers = self.nameservers[:] + backoff = self.backoff + self.backoff = min(self.backoff * 2, 2) + + self.nameserver = self.current_nameservers.pop(0) + self.tcp_attempt = self.tcp or self.nameserver.is_always_max_size() + return (self.nameserver, self.tcp_attempt, backoff) + + def query_result( + self, response: Optional[dns.message.Message], ex: Optional[Exception] + ) -> Tuple[Optional[Answer], bool]: + # + # returns an (answer: Answer, end_loop: bool) tuple. + # + assert self.nameserver is not None + if ex: + # Exception during I/O or from_wire() + assert response is None + self.errors.append( + ( + str(self.nameserver), + self.tcp_attempt, + self.nameserver.answer_port(), + ex, + response, + ) + ) + if ( + isinstance(ex, dns.exception.FormError) + or isinstance(ex, EOFError) + or isinstance(ex, OSError) + or isinstance(ex, NotImplementedError) + ): + # This nameserver is no good, take it out of the mix. + self.nameservers.remove(self.nameserver) + elif isinstance(ex, dns.message.Truncated): + if self.tcp_attempt: + # Truncation with TCP is no good! + self.nameservers.remove(self.nameserver) + else: + self.retry_with_tcp = True + return (None, False) + # We got an answer! + assert response is not None + assert isinstance(response, dns.message.QueryMessage) + rcode = response.rcode() + if rcode == dns.rcode.NOERROR: + try: + answer = Answer( + self.qname, + self.rdtype, + self.rdclass, + response, + self.nameserver.answer_nameserver(), + self.nameserver.answer_port(), + ) + except Exception as e: + self.errors.append( + ( + str(self.nameserver), + self.tcp_attempt, + self.nameserver.answer_port(), + e, + response, + ) + ) + # The nameserver is no good, take it out of the mix. + self.nameservers.remove(self.nameserver) + return (None, False) + if self.resolver.cache: + self.resolver.cache.put((self.qname, self.rdtype, self.rdclass), answer) + if answer.rrset is None and self.raise_on_no_answer: + raise NoAnswer(response=answer.response) + return (answer, True) + elif rcode == dns.rcode.NXDOMAIN: + # Further validate the response by making an Answer, even + # if we aren't going to cache it. + try: + answer = Answer( + self.qname, dns.rdatatype.ANY, dns.rdataclass.IN, response + ) + except Exception as e: + self.errors.append( + ( + str(self.nameserver), + self.tcp_attempt, + self.nameserver.answer_port(), + e, + response, + ) + ) + # The nameserver is no good, take it out of the mix. + self.nameservers.remove(self.nameserver) + return (None, False) + self.nxdomain_responses[self.qname] = response + if self.resolver.cache: + self.resolver.cache.put( + (self.qname, dns.rdatatype.ANY, self.rdclass), answer + ) + # Make next_nameserver() return None, so caller breaks its + # inner loop and calls next_request(). + return (None, True) + elif rcode == dns.rcode.YXDOMAIN: + yex = YXDOMAIN() + self.errors.append( + ( + str(self.nameserver), + self.tcp_attempt, + self.nameserver.answer_port(), + yex, + response, + ) + ) + raise yex + else: + # + # We got a response, but we're not happy with the + # rcode in it. + # + if rcode != dns.rcode.SERVFAIL or not self.resolver.retry_servfail: + self.nameservers.remove(self.nameserver) + self.errors.append( + ( + str(self.nameserver), + self.tcp_attempt, + self.nameserver.answer_port(), + dns.rcode.to_text(rcode), + response, + ) + ) + return (None, False) + + +class BaseResolver: + """DNS stub resolver.""" + + # We initialize in reset() + # + # pylint: disable=attribute-defined-outside-init + + domain: dns.name.Name + nameserver_ports: Dict[str, int] + port: int + search: List[dns.name.Name] + use_search_by_default: bool + timeout: float + lifetime: float + keyring: Optional[Any] + keyname: Optional[Union[dns.name.Name, str]] + keyalgorithm: Union[dns.name.Name, str] + edns: int + ednsflags: int + ednsoptions: Optional[List[dns.edns.Option]] + payload: int + cache: Any + flags: Optional[int] + retry_servfail: bool + rotate: bool + ndots: Optional[int] + _nameservers: Sequence[Union[str, dns.nameserver.Nameserver]] + + def __init__( + self, filename: str = "/etc/resolv.conf", configure: bool = True + ) -> None: + """*filename*, a ``str`` or file object, specifying a file + in standard /etc/resolv.conf format. This parameter is meaningful + only when *configure* is true and the platform is POSIX. + + *configure*, a ``bool``. If True (the default), the resolver + instance is configured in the normal fashion for the operating + system the resolver is running on. (I.e. by reading a + /etc/resolv.conf file on POSIX systems and from the registry + on Windows systems.) + """ + + self.reset() + if configure: + if sys.platform == "win32": + self.read_registry() + elif filename: + self.read_resolv_conf(filename) + + def reset(self) -> None: + """Reset all resolver configuration to the defaults.""" + + self.domain = dns.name.Name(dns.name.from_text(socket.gethostname())[1:]) + if len(self.domain) == 0: + self.domain = dns.name.root + self._nameservers = [] + self.nameserver_ports = {} + self.port = 53 + self.search = [] + self.use_search_by_default = False + self.timeout = 2.0 + self.lifetime = 5.0 + self.keyring = None + self.keyname = None + self.keyalgorithm = dns.tsig.default_algorithm + self.edns = -1 + self.ednsflags = 0 + self.ednsoptions = None + self.payload = 0 + self.cache = None + self.flags = None + self.retry_servfail = False + self.rotate = False + self.ndots = None + + def read_resolv_conf(self, f: Any) -> None: + """Process *f* as a file in the /etc/resolv.conf format. If f is + a ``str``, it is used as the name of the file to open; otherwise it + is treated as the file itself. + + Interprets the following items: + + - nameserver - name server IP address + + - domain - local domain name + + - search - search list for host-name lookup + + - options - supported options are rotate, timeout, edns0, and ndots + + """ + + nameservers = [] + if isinstance(f, str): + try: + cm: contextlib.AbstractContextManager = open(f) + except OSError: + # /etc/resolv.conf doesn't exist, can't be read, etc. + raise NoResolverConfiguration(f"cannot open {f}") + else: + cm = contextlib.nullcontext(f) + with cm as f: + for l in f: + if len(l) == 0 or l[0] == "#" or l[0] == ";": + continue + tokens = l.split() + + # Any line containing less than 2 tokens is malformed + if len(tokens) < 2: + continue + + if tokens[0] == "nameserver": + nameservers.append(tokens[1]) + elif tokens[0] == "domain": + self.domain = dns.name.from_text(tokens[1]) + # domain and search are exclusive + self.search = [] + elif tokens[0] == "search": + # the last search wins + self.search = [] + for suffix in tokens[1:]: + self.search.append(dns.name.from_text(suffix)) + # We don't set domain as it is not used if + # len(self.search) > 0 + elif tokens[0] == "options": + for opt in tokens[1:]: + if opt == "rotate": + self.rotate = True + elif opt == "edns0": + self.use_edns() + elif "timeout" in opt: + try: + self.timeout = int(opt.split(":")[1]) + except (ValueError, IndexError): + pass + elif "ndots" in opt: + try: + self.ndots = int(opt.split(":")[1]) + except (ValueError, IndexError): + pass + if len(nameservers) == 0: + raise NoResolverConfiguration("no nameservers") + # Assigning directly instead of appending means we invoke the + # setter logic, with additonal checking and enrichment. + self.nameservers = nameservers + + def read_registry(self) -> None: + """Extract resolver configuration from the Windows registry.""" + try: + info = dns.win32util.get_dns_info() # type: ignore + if info.domain is not None: + self.domain = info.domain + self.nameservers = info.nameservers + self.search = info.search + except AttributeError: + raise NotImplementedError + + def _compute_timeout( + self, + start: float, + lifetime: Optional[float] = None, + errors: Optional[List[ErrorTuple]] = None, + ) -> float: + lifetime = self.lifetime if lifetime is None else lifetime + now = time.time() + duration = now - start + if errors is None: + errors = [] + if duration < 0: + if duration < -1: + # Time going backwards is bad. Just give up. + raise LifetimeTimeout(timeout=duration, errors=errors) + else: + # Time went backwards, but only a little. This can + # happen, e.g. under vmware with older linux kernels. + # Pretend it didn't happen. + duration = 0 + if duration >= lifetime: + raise LifetimeTimeout(timeout=duration, errors=errors) + return min(lifetime - duration, self.timeout) + + def _get_qnames_to_try( + self, qname: dns.name.Name, search: Optional[bool] + ) -> List[dns.name.Name]: + # This is a separate method so we can unit test the search + # rules without requiring the Internet. + if search is None: + search = self.use_search_by_default + qnames_to_try = [] + if qname.is_absolute(): + qnames_to_try.append(qname) + else: + abs_qname = qname.concatenate(dns.name.root) + if search: + if len(self.search) > 0: + # There is a search list, so use it exclusively + search_list = self.search[:] + elif self.domain != dns.name.root and self.domain is not None: + # We have some notion of a domain that isn't the root, so + # use it as the search list. + search_list = [self.domain] + else: + search_list = [] + # Figure out the effective ndots (default is 1) + if self.ndots is None: + ndots = 1 + else: + ndots = self.ndots + for suffix in search_list: + qnames_to_try.append(qname + suffix) + if len(qname) > ndots: + # The name has at least ndots dots, so we should try an + # absolute query first. + qnames_to_try.insert(0, abs_qname) + else: + # The name has less than ndots dots, so we should search + # first, then try the absolute name. + qnames_to_try.append(abs_qname) + else: + qnames_to_try.append(abs_qname) + return qnames_to_try + + def use_tsig( + self, + keyring: Any, + keyname: Optional[Union[dns.name.Name, str]] = None, + algorithm: Union[dns.name.Name, str] = dns.tsig.default_algorithm, + ) -> None: + """Add a TSIG signature to each query. + + The parameters are passed to ``dns.message.Message.use_tsig()``; + see its documentation for details. + """ + + self.keyring = keyring + self.keyname = keyname + self.keyalgorithm = algorithm + + def use_edns( + self, + edns: Optional[Union[int, bool]] = 0, + ednsflags: int = 0, + payload: int = dns.message.DEFAULT_EDNS_PAYLOAD, + options: Optional[List[dns.edns.Option]] = None, + ) -> None: + """Configure EDNS behavior. + + *edns*, an ``int``, is the EDNS level to use. Specifying + ``None``, ``False``, or ``-1`` means "do not use EDNS", and in this case + the other parameters are ignored. Specifying ``True`` is + equivalent to specifying 0, i.e. "use EDNS0". + + *ednsflags*, an ``int``, the EDNS flag values. + + *payload*, an ``int``, is the EDNS sender's payload field, which is the + maximum size of UDP datagram the sender can handle. I.e. how big + a response to this message can be. + + *options*, a list of ``dns.edns.Option`` objects or ``None``, the EDNS + options. + """ + + if edns is None or edns is False: + edns = -1 + elif edns is True: + edns = 0 + self.edns = edns + self.ednsflags = ednsflags + self.payload = payload + self.ednsoptions = options + + def set_flags(self, flags: int) -> None: + """Overrides the default flags with your own. + + *flags*, an ``int``, the message flags to use. + """ + + self.flags = flags + + @classmethod + def _enrich_nameservers( + cls, + nameservers: Sequence[Union[str, dns.nameserver.Nameserver]], + nameserver_ports: Dict[str, int], + default_port: int, + ) -> List[dns.nameserver.Nameserver]: + enriched_nameservers = [] + if isinstance(nameservers, list): + for nameserver in nameservers: + enriched_nameserver: dns.nameserver.Nameserver + if isinstance(nameserver, dns.nameserver.Nameserver): + enriched_nameserver = nameserver + elif dns.inet.is_address(nameserver): + port = nameserver_ports.get(nameserver, default_port) + enriched_nameserver = dns.nameserver.Do53Nameserver( + nameserver, port + ) + else: + try: + if urlparse(nameserver).scheme != "https": + raise NotImplementedError + except Exception: + raise ValueError( + f"nameserver {nameserver} is not a " + "dns.nameserver.Nameserver instance or text form, " + "IP address, nor a valid https URL" + ) + enriched_nameserver = dns.nameserver.DoHNameserver(nameserver) + enriched_nameservers.append(enriched_nameserver) + else: + raise ValueError( + "nameservers must be a list or tuple (not a {})".format( + type(nameservers) + ) + ) + return enriched_nameservers + + @property + def nameservers( + self, + ) -> Sequence[Union[str, dns.nameserver.Nameserver]]: + return self._nameservers + + @nameservers.setter + def nameservers( + self, nameservers: Sequence[Union[str, dns.nameserver.Nameserver]] + ) -> None: + """ + *nameservers*, a ``list`` of nameservers, where a nameserver is either + a string interpretable as a nameserver, or a ``dns.nameserver.Nameserver`` + instance. + + Raises ``ValueError`` if *nameservers* is not a list of nameservers. + """ + # We just call _enrich_nameservers() for checking + self._enrich_nameservers(nameservers, self.nameserver_ports, self.port) + self._nameservers = nameservers + + +class Resolver(BaseResolver): + """DNS stub resolver.""" + + def resolve( + self, + qname: Union[dns.name.Name, str], + rdtype: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.A, + rdclass: Union[dns.rdataclass.RdataClass, str] = dns.rdataclass.IN, + tcp: bool = False, + source: Optional[str] = None, + raise_on_no_answer: bool = True, + source_port: int = 0, + lifetime: Optional[float] = None, + search: Optional[bool] = None, + ) -> Answer: # pylint: disable=arguments-differ + """Query nameservers to find the answer to the question. + + The *qname*, *rdtype*, and *rdclass* parameters may be objects + of the appropriate type, or strings that can be converted into objects + of the appropriate type. + + *qname*, a ``dns.name.Name`` or ``str``, the query name. + + *rdtype*, an ``int`` or ``str``, the query type. + + *rdclass*, an ``int`` or ``str``, the query class. + + *tcp*, a ``bool``. If ``True``, use TCP to make the query. + + *source*, a ``str`` or ``None``. If not ``None``, bind to this IP + address when making queries. + + *raise_on_no_answer*, a ``bool``. If ``True``, raise + ``dns.resolver.NoAnswer`` if there's no answer to the question. + + *source_port*, an ``int``, the port from which to send the message. + + *lifetime*, a ``float``, how many seconds a query should run + before timing out. + + *search*, a ``bool`` or ``None``, determines whether the + search list configured in the system's resolver configuration + are used for relative names, and whether the resolver's domain + may be added to relative names. The default is ``None``, + which causes the value of the resolver's + ``use_search_by_default`` attribute to be used. + + Raises ``dns.resolver.LifetimeTimeout`` if no answers could be found + in the specified lifetime. + + Raises ``dns.resolver.NXDOMAIN`` if the query name does not exist. + + Raises ``dns.resolver.YXDOMAIN`` if the query name is too long after + DNAME substitution. + + Raises ``dns.resolver.NoAnswer`` if *raise_on_no_answer* is + ``True`` and the query name exists but has no RRset of the + desired type and class. + + Raises ``dns.resolver.NoNameservers`` if no non-broken + nameservers are available to answer the question. + + Returns a ``dns.resolver.Answer`` instance. + + """ + + resolution = _Resolution( + self, qname, rdtype, rdclass, tcp, raise_on_no_answer, search + ) + start = time.time() + while True: + (request, answer) = resolution.next_request() + # Note we need to say "if answer is not None" and not just + # "if answer" because answer implements __len__, and python + # will call that. We want to return if we have an answer + # object, including in cases where its length is 0. + if answer is not None: + # cache hit! + return answer + assert request is not None # needed for type checking + done = False + while not done: + (nameserver, tcp, backoff) = resolution.next_nameserver() + if backoff: + time.sleep(backoff) + timeout = self._compute_timeout(start, lifetime, resolution.errors) + try: + response = nameserver.query( + request, + timeout=timeout, + source=source, + source_port=source_port, + max_size=tcp, + ) + except Exception as ex: + (_, done) = resolution.query_result(None, ex) + continue + (answer, done) = resolution.query_result(response, None) + # Note we need to say "if answer is not None" and not just + # "if answer" because answer implements __len__, and python + # will call that. We want to return if we have an answer + # object, including in cases where its length is 0. + if answer is not None: + return answer + + def query( + self, + qname: Union[dns.name.Name, str], + rdtype: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.A, + rdclass: Union[dns.rdataclass.RdataClass, str] = dns.rdataclass.IN, + tcp: bool = False, + source: Optional[str] = None, + raise_on_no_answer: bool = True, + source_port: int = 0, + lifetime: Optional[float] = None, + ) -> Answer: # pragma: no cover + """Query nameservers to find the answer to the question. + + This method calls resolve() with ``search=True``, and is + provided for backwards compatibility with prior versions of + dnspython. See the documentation for the resolve() method for + further details. + """ + warnings.warn( + "please use dns.resolver.Resolver.resolve() instead", + DeprecationWarning, + stacklevel=2, + ) + return self.resolve( + qname, + rdtype, + rdclass, + tcp, + source, + raise_on_no_answer, + source_port, + lifetime, + True, + ) + + def resolve_address(self, ipaddr: str, *args: Any, **kwargs: Any) -> Answer: + """Use a resolver to run a reverse query for PTR records. + + This utilizes the resolve() method to perform a PTR lookup on the + specified IP address. + + *ipaddr*, a ``str``, the IPv4 or IPv6 address you want to get + the PTR record for. + + All other arguments that can be passed to the resolve() function + except for rdtype and rdclass are also supported by this + function. + """ + # We make a modified kwargs for type checking happiness, as otherwise + # we get a legit warning about possibly having rdtype and rdclass + # in the kwargs more than once. + modified_kwargs: Dict[str, Any] = {} + modified_kwargs.update(kwargs) + modified_kwargs["rdtype"] = dns.rdatatype.PTR + modified_kwargs["rdclass"] = dns.rdataclass.IN + return self.resolve( + dns.reversename.from_address(ipaddr), *args, **modified_kwargs + ) + + def resolve_name( + self, + name: Union[dns.name.Name, str], + family: int = socket.AF_UNSPEC, + **kwargs: Any, + ) -> HostAnswers: + """Use a resolver to query for address records. + + This utilizes the resolve() method to perform A and/or AAAA lookups on + the specified name. + + *qname*, a ``dns.name.Name`` or ``str``, the name to resolve. + + *family*, an ``int``, the address family. If socket.AF_UNSPEC + (the default), both A and AAAA records will be retrieved. + + All other arguments that can be passed to the resolve() function + except for rdtype and rdclass are also supported by this + function. + """ + # We make a modified kwargs for type checking happiness, as otherwise + # we get a legit warning about possibly having rdtype and rdclass + # in the kwargs more than once. + modified_kwargs: Dict[str, Any] = {} + modified_kwargs.update(kwargs) + modified_kwargs.pop("rdtype", None) + modified_kwargs["rdclass"] = dns.rdataclass.IN + + if family == socket.AF_INET: + v4 = self.resolve(name, dns.rdatatype.A, **modified_kwargs) + return HostAnswers.make(v4=v4) + elif family == socket.AF_INET6: + v6 = self.resolve(name, dns.rdatatype.AAAA, **modified_kwargs) + return HostAnswers.make(v6=v6) + elif family != socket.AF_UNSPEC: + raise NotImplementedError(f"unknown address family {family}") + + raise_on_no_answer = modified_kwargs.pop("raise_on_no_answer", True) + lifetime = modified_kwargs.pop("lifetime", None) + start = time.time() + v6 = self.resolve( + name, + dns.rdatatype.AAAA, + raise_on_no_answer=False, + lifetime=self._compute_timeout(start, lifetime), + **modified_kwargs, + ) + # Note that setting name ensures we query the same name + # for A as we did for AAAA. (This is just in case search lists + # are active by default in the resolver configuration and + # we might be talking to a server that says NXDOMAIN when it + # wants to say NOERROR no data. + name = v6.qname + v4 = self.resolve( + name, + dns.rdatatype.A, + raise_on_no_answer=False, + lifetime=self._compute_timeout(start, lifetime), + **modified_kwargs, + ) + answers = HostAnswers.make(v6=v6, v4=v4, add_empty=not raise_on_no_answer) + if not answers: + raise NoAnswer(response=v6.response) + return answers + + # pylint: disable=redefined-outer-name + + def canonical_name(self, name: Union[dns.name.Name, str]) -> dns.name.Name: + """Determine the canonical name of *name*. + + The canonical name is the name the resolver uses for queries + after all CNAME and DNAME renamings have been applied. + + *name*, a ``dns.name.Name`` or ``str``, the query name. + + This method can raise any exception that ``resolve()`` can + raise, other than ``dns.resolver.NoAnswer`` and + ``dns.resolver.NXDOMAIN``. + + Returns a ``dns.name.Name``. + """ + try: + answer = self.resolve(name, raise_on_no_answer=False) + canonical_name = answer.canonical_name + except dns.resolver.NXDOMAIN as e: + canonical_name = e.canonical_name + return canonical_name + + # pylint: enable=redefined-outer-name + + def try_ddr(self, lifetime: float = 5.0) -> None: + """Try to update the resolver's nameservers using Discovery of Designated + Resolvers (DDR). If successful, the resolver will subsequently use + DNS-over-HTTPS or DNS-over-TLS for future queries. + + *lifetime*, a float, is the maximum time to spend attempting DDR. The default + is 5 seconds. + + If the SVCB query is successful and results in a non-empty list of nameservers, + then the resolver's nameservers are set to the returned servers in priority + order. + + The current implementation does not use any address hints from the SVCB record, + nor does it resolve addresses for the SCVB target name, rather it assumes that + the bootstrap nameserver will always be one of the addresses and uses it. + A future revision to the code may offer fuller support. The code verifies that + the bootstrap nameserver is in the Subject Alternative Name field of the + TLS certficate. + """ + try: + expiration = time.time() + lifetime + answer = self.resolve( + dns._ddr._local_resolver_name, "SVCB", lifetime=lifetime + ) + timeout = dns.query._remaining(expiration) + nameservers = dns._ddr._get_nameservers_sync(answer, timeout) + if len(nameservers) > 0: + self.nameservers = nameservers + except Exception: + pass + + +#: The default resolver. +default_resolver: Optional[Resolver] = None + + +def get_default_resolver() -> Resolver: + """Get the default resolver, initializing it if necessary.""" + if default_resolver is None: + reset_default_resolver() + assert default_resolver is not None + return default_resolver + + +def reset_default_resolver() -> None: + """Re-initialize default resolver. + + Note that the resolver configuration (i.e. /etc/resolv.conf on UNIX + systems) will be re-read immediately. + """ + + global default_resolver + default_resolver = Resolver() + + +def resolve( + qname: Union[dns.name.Name, str], + rdtype: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.A, + rdclass: Union[dns.rdataclass.RdataClass, str] = dns.rdataclass.IN, + tcp: bool = False, + source: Optional[str] = None, + raise_on_no_answer: bool = True, + source_port: int = 0, + lifetime: Optional[float] = None, + search: Optional[bool] = None, +) -> Answer: # pragma: no cover + """Query nameservers to find the answer to the question. + + This is a convenience function that uses the default resolver + object to make the query. + + See ``dns.resolver.Resolver.resolve`` for more information on the + parameters. + """ + + return get_default_resolver().resolve( + qname, + rdtype, + rdclass, + tcp, + source, + raise_on_no_answer, + source_port, + lifetime, + search, + ) + + +def query( + qname: Union[dns.name.Name, str], + rdtype: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.A, + rdclass: Union[dns.rdataclass.RdataClass, str] = dns.rdataclass.IN, + tcp: bool = False, + source: Optional[str] = None, + raise_on_no_answer: bool = True, + source_port: int = 0, + lifetime: Optional[float] = None, +) -> Answer: # pragma: no cover + """Query nameservers to find the answer to the question. + + This method calls resolve() with ``search=True``, and is + provided for backwards compatibility with prior versions of + dnspython. See the documentation for the resolve() method for + further details. + """ + warnings.warn( + "please use dns.resolver.resolve() instead", DeprecationWarning, stacklevel=2 + ) + return resolve( + qname, + rdtype, + rdclass, + tcp, + source, + raise_on_no_answer, + source_port, + lifetime, + True, + ) + + +def resolve_address(ipaddr: str, *args: Any, **kwargs: Any) -> Answer: + """Use a resolver to run a reverse query for PTR records. + + See ``dns.resolver.Resolver.resolve_address`` for more information on the + parameters. + """ + + return get_default_resolver().resolve_address(ipaddr, *args, **kwargs) + + +def resolve_name( + name: Union[dns.name.Name, str], family: int = socket.AF_UNSPEC, **kwargs: Any +) -> HostAnswers: + """Use a resolver to query for address records. + + See ``dns.resolver.Resolver.resolve_name`` for more information on the + parameters. + """ + + return get_default_resolver().resolve_name(name, family, **kwargs) + + +def canonical_name(name: Union[dns.name.Name, str]) -> dns.name.Name: + """Determine the canonical name of *name*. + + See ``dns.resolver.Resolver.canonical_name`` for more information on the + parameters and possible exceptions. + """ + + return get_default_resolver().canonical_name(name) + + +def try_ddr(lifetime: float = 5.0) -> None: + """Try to update the default resolver's nameservers using Discovery of Designated + Resolvers (DDR). If successful, the resolver will subsequently use + DNS-over-HTTPS or DNS-over-TLS for future queries. + + See :py:func:`dns.resolver.Resolver.try_ddr` for more information. + """ + return get_default_resolver().try_ddr(lifetime) + + +def zone_for_name( + name: Union[dns.name.Name, str], + rdclass: dns.rdataclass.RdataClass = dns.rdataclass.IN, + tcp: bool = False, + resolver: Optional[Resolver] = None, + lifetime: Optional[float] = None, +) -> dns.name.Name: + """Find the name of the zone which contains the specified name. + + *name*, an absolute ``dns.name.Name`` or ``str``, the query name. + + *rdclass*, an ``int``, the query class. + + *tcp*, a ``bool``. If ``True``, use TCP to make the query. + + *resolver*, a ``dns.resolver.Resolver`` or ``None``, the resolver to use. + If ``None``, the default, then the default resolver is used. + + *lifetime*, a ``float``, the total time to allow for the queries needed + to determine the zone. If ``None``, the default, then only the individual + query limits of the resolver apply. + + Raises ``dns.resolver.NoRootSOA`` if there is no SOA RR at the DNS + root. (This is only likely to happen if you're using non-default + root servers in your network and they are misconfigured.) + + Raises ``dns.resolver.LifetimeTimeout`` if the answer could not be + found in the allotted lifetime. + + Returns a ``dns.name.Name``. + """ + + if isinstance(name, str): + name = dns.name.from_text(name, dns.name.root) + if resolver is None: + resolver = get_default_resolver() + if not name.is_absolute(): + raise NotAbsolute(name) + start = time.time() + expiration: Optional[float] + if lifetime is not None: + expiration = start + lifetime + else: + expiration = None + while 1: + try: + rlifetime: Optional[float] + if expiration is not None: + rlifetime = expiration - time.time() + if rlifetime <= 0: + rlifetime = 0 + else: + rlifetime = None + answer = resolver.resolve( + name, dns.rdatatype.SOA, rdclass, tcp, lifetime=rlifetime + ) + assert answer.rrset is not None + if answer.rrset.name == name: + return name + # otherwise we were CNAMEd or DNAMEd and need to look higher + except (dns.resolver.NXDOMAIN, dns.resolver.NoAnswer) as e: + if isinstance(e, dns.resolver.NXDOMAIN): + response = e.responses().get(name) + else: + response = e.response() # pylint: disable=no-value-for-parameter + if response: + for rrs in response.authority: + if rrs.rdtype == dns.rdatatype.SOA and rrs.rdclass == rdclass: + (nr, _, _) = rrs.name.fullcompare(name) + if nr == dns.name.NAMERELN_SUPERDOMAIN: + # We're doing a proper superdomain check as + # if the name were equal we ought to have gotten + # it in the answer section! We are ignoring the + # possibility that the authority is insane and + # is including multiple SOA RRs for different + # authorities. + return rrs.name + # we couldn't extract anything useful from the response (e.g. it's + # a type 3 NXDOMAIN) + try: + name = name.parent() + except dns.name.NoParent: + raise NoRootSOA + + +def make_resolver_at( + where: Union[dns.name.Name, str], + port: int = 53, + family: int = socket.AF_UNSPEC, + resolver: Optional[Resolver] = None, +) -> Resolver: + """Make a stub resolver using the specified destination as the full resolver. + + *where*, a ``dns.name.Name`` or ``str`` the domain name or IP address of the + full resolver. + + *port*, an ``int``, the port to use. If not specified, the default is 53. + + *family*, an ``int``, the address family to use. This parameter is used if + *where* is not an address. The default is ``socket.AF_UNSPEC`` in which case + the first address returned by ``resolve_name()`` will be used, otherwise the + first address of the specified family will be used. + + *resolver*, a ``dns.resolver.Resolver`` or ``None``, the resolver to use for + resolution of hostnames. If not specified, the default resolver will be used. + + Returns a ``dns.resolver.Resolver`` or raises an exception. + """ + if resolver is None: + resolver = get_default_resolver() + nameservers: List[Union[str, dns.nameserver.Nameserver]] = [] + if isinstance(where, str) and dns.inet.is_address(where): + nameservers.append(dns.nameserver.Do53Nameserver(where, port)) + else: + for address in resolver.resolve_name(where, family).addresses(): + nameservers.append(dns.nameserver.Do53Nameserver(address, port)) + res = dns.resolver.Resolver(configure=False) + res.nameservers = nameservers + return res + + +def resolve_at( + where: Union[dns.name.Name, str], + qname: Union[dns.name.Name, str], + rdtype: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.A, + rdclass: Union[dns.rdataclass.RdataClass, str] = dns.rdataclass.IN, + tcp: bool = False, + source: Optional[str] = None, + raise_on_no_answer: bool = True, + source_port: int = 0, + lifetime: Optional[float] = None, + search: Optional[bool] = None, + port: int = 53, + family: int = socket.AF_UNSPEC, + resolver: Optional[Resolver] = None, +) -> Answer: + """Query nameservers to find the answer to the question. + + This is a convenience function that calls ``dns.resolver.make_resolver_at()`` to + make a resolver, and then uses it to resolve the query. + + See ``dns.resolver.Resolver.resolve`` for more information on the resolution + parameters, and ``dns.resolver.make_resolver_at`` for information about the resolver + parameters *where*, *port*, *family*, and *resolver*. + + If making more than one query, it is more efficient to call + ``dns.resolver.make_resolver_at()`` and then use that resolver for the queries + instead of calling ``resolve_at()`` multiple times. + """ + return make_resolver_at(where, port, family, resolver).resolve( + qname, + rdtype, + rdclass, + tcp, + source, + raise_on_no_answer, + source_port, + lifetime, + search, + ) + + +# +# Support for overriding the system resolver for all python code in the +# running process. +# + +_protocols_for_socktype = { + socket.SOCK_DGRAM: [socket.SOL_UDP], + socket.SOCK_STREAM: [socket.SOL_TCP], +} + +_resolver = None +_original_getaddrinfo = socket.getaddrinfo +_original_getnameinfo = socket.getnameinfo +_original_getfqdn = socket.getfqdn +_original_gethostbyname = socket.gethostbyname +_original_gethostbyname_ex = socket.gethostbyname_ex +_original_gethostbyaddr = socket.gethostbyaddr + + +def _getaddrinfo( + host=None, service=None, family=socket.AF_UNSPEC, socktype=0, proto=0, flags=0 +): + if flags & socket.AI_NUMERICHOST != 0: + # Short circuit directly into the system's getaddrinfo(). We're + # not adding any value in this case, and this avoids infinite loops + # because dns.query.* needs to call getaddrinfo() for IPv6 scoping + # reasons. We will also do this short circuit below if we + # discover that the host is an address literal. + return _original_getaddrinfo(host, service, family, socktype, proto, flags) + if flags & (socket.AI_ADDRCONFIG | socket.AI_V4MAPPED) != 0: + # Not implemented. We raise a gaierror as opposed to a + # NotImplementedError as it helps callers handle errors more + # appropriately. [Issue #316] + # + # We raise EAI_FAIL as opposed to EAI_SYSTEM because there is + # no EAI_SYSTEM on Windows [Issue #416]. We didn't go for + # EAI_BADFLAGS as the flags aren't bad, we just don't + # implement them. + raise socket.gaierror( + socket.EAI_FAIL, "Non-recoverable failure in name resolution" + ) + if host is None and service is None: + raise socket.gaierror(socket.EAI_NONAME, "Name or service not known") + addrs = [] + canonical_name = None # pylint: disable=redefined-outer-name + # Is host None or an address literal? If so, use the system's + # getaddrinfo(). + if host is None: + return _original_getaddrinfo(host, service, family, socktype, proto, flags) + try: + # We don't care about the result of af_for_address(), we're just + # calling it so it raises an exception if host is not an IPv4 or + # IPv6 address. + dns.inet.af_for_address(host) + return _original_getaddrinfo(host, service, family, socktype, proto, flags) + except Exception: + pass + # Something needs resolution! + try: + answers = _resolver.resolve_name(host, family) + addrs = answers.addresses_and_families() + canonical_name = answers.canonical_name().to_text(True) + except dns.resolver.NXDOMAIN: + raise socket.gaierror(socket.EAI_NONAME, "Name or service not known") + except Exception: + # We raise EAI_AGAIN here as the failure may be temporary + # (e.g. a timeout) and EAI_SYSTEM isn't defined on Windows. + # [Issue #416] + raise socket.gaierror(socket.EAI_AGAIN, "Temporary failure in name resolution") + port = None + try: + # Is it a port literal? + if service is None: + port = 0 + else: + port = int(service) + except Exception: + if flags & socket.AI_NUMERICSERV == 0: + try: + port = socket.getservbyname(service) + except Exception: + pass + if port is None: + raise socket.gaierror(socket.EAI_NONAME, "Name or service not known") + tuples = [] + if socktype == 0: + socktypes = [socket.SOCK_DGRAM, socket.SOCK_STREAM] + else: + socktypes = [socktype] + if flags & socket.AI_CANONNAME != 0: + cname = canonical_name + else: + cname = "" + for addr, af in addrs: + for socktype in socktypes: + for proto in _protocols_for_socktype[socktype]: + addr_tuple = dns.inet.low_level_address_tuple((addr, port), af) + tuples.append((af, socktype, proto, cname, addr_tuple)) + if len(tuples) == 0: + raise socket.gaierror(socket.EAI_NONAME, "Name or service not known") + return tuples + + +def _getnameinfo(sockaddr, flags=0): + host = sockaddr[0] + port = sockaddr[1] + if len(sockaddr) == 4: + scope = sockaddr[3] + family = socket.AF_INET6 + else: + scope = None + family = socket.AF_INET + tuples = _getaddrinfo(host, port, family, socket.SOCK_STREAM, socket.SOL_TCP, 0) + if len(tuples) > 1: + raise socket.error("sockaddr resolved to multiple addresses") + addr = tuples[0][4][0] + if flags & socket.NI_DGRAM: + pname = "udp" + else: + pname = "tcp" + qname = dns.reversename.from_address(addr) + if flags & socket.NI_NUMERICHOST == 0: + try: + answer = _resolver.resolve(qname, "PTR") + hostname = answer.rrset[0].target.to_text(True) + except (dns.resolver.NXDOMAIN, dns.resolver.NoAnswer): + if flags & socket.NI_NAMEREQD: + raise socket.gaierror(socket.EAI_NONAME, "Name or service not known") + hostname = addr + if scope is not None: + hostname += "%" + str(scope) + else: + hostname = addr + if scope is not None: + hostname += "%" + str(scope) + if flags & socket.NI_NUMERICSERV: + service = str(port) + else: + service = socket.getservbyport(port, pname) + return (hostname, service) + + +def _getfqdn(name=None): + if name is None: + name = socket.gethostname() + try: + (name, _, _) = _gethostbyaddr(name) + # Python's version checks aliases too, but our gethostbyname + # ignores them, so we do so here as well. + except Exception: + pass + return name + + +def _gethostbyname(name): + return _gethostbyname_ex(name)[2][0] + + +def _gethostbyname_ex(name): + aliases = [] + addresses = [] + tuples = _getaddrinfo( + name, 0, socket.AF_INET, socket.SOCK_STREAM, socket.SOL_TCP, socket.AI_CANONNAME + ) + canonical = tuples[0][3] + for item in tuples: + addresses.append(item[4][0]) + # XXX we just ignore aliases + return (canonical, aliases, addresses) + + +def _gethostbyaddr(ip): + try: + dns.ipv6.inet_aton(ip) + sockaddr = (ip, 80, 0, 0) + family = socket.AF_INET6 + except Exception: + try: + dns.ipv4.inet_aton(ip) + except Exception: + raise socket.gaierror(socket.EAI_NONAME, "Name or service not known") + sockaddr = (ip, 80) + family = socket.AF_INET + (name, _) = _getnameinfo(sockaddr, socket.NI_NAMEREQD) + aliases = [] + addresses = [] + tuples = _getaddrinfo( + name, 0, family, socket.SOCK_STREAM, socket.SOL_TCP, socket.AI_CANONNAME + ) + canonical = tuples[0][3] + # We only want to include an address from the tuples if it's the + # same as the one we asked about. We do this comparison in binary + # to avoid any differences in text representations. + bin_ip = dns.inet.inet_pton(family, ip) + for item in tuples: + addr = item[4][0] + bin_addr = dns.inet.inet_pton(family, addr) + if bin_ip == bin_addr: + addresses.append(addr) + # XXX we just ignore aliases + return (canonical, aliases, addresses) + + +def override_system_resolver(resolver: Optional[Resolver] = None) -> None: + """Override the system resolver routines in the socket module with + versions which use dnspython's resolver. + + This can be useful in testing situations where you want to control + the resolution behavior of python code without having to change + the system's resolver settings (e.g. /etc/resolv.conf). + + The resolver to use may be specified; if it's not, the default + resolver will be used. + + resolver, a ``dns.resolver.Resolver`` or ``None``, the resolver to use. + """ + + if resolver is None: + resolver = get_default_resolver() + global _resolver + _resolver = resolver + socket.getaddrinfo = _getaddrinfo + socket.getnameinfo = _getnameinfo + socket.getfqdn = _getfqdn + socket.gethostbyname = _gethostbyname + socket.gethostbyname_ex = _gethostbyname_ex + socket.gethostbyaddr = _gethostbyaddr + + +def restore_system_resolver() -> None: + """Undo the effects of prior override_system_resolver().""" + + global _resolver + _resolver = None + socket.getaddrinfo = _original_getaddrinfo + socket.getnameinfo = _original_getnameinfo + socket.getfqdn = _original_getfqdn + socket.gethostbyname = _original_gethostbyname + socket.gethostbyname_ex = _original_gethostbyname_ex + socket.gethostbyaddr = _original_gethostbyaddr diff --git a/.venv/lib/python3.12/site-packages/dns/reversename.py b/.venv/lib/python3.12/site-packages/dns/reversename.py new file mode 100644 index 0000000..8236c71 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/reversename.py @@ -0,0 +1,105 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2006-2017 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""DNS Reverse Map Names.""" + +import binascii + +import dns.ipv4 +import dns.ipv6 +import dns.name + +ipv4_reverse_domain = dns.name.from_text("in-addr.arpa.") +ipv6_reverse_domain = dns.name.from_text("ip6.arpa.") + + +def from_address( + text: str, + v4_origin: dns.name.Name = ipv4_reverse_domain, + v6_origin: dns.name.Name = ipv6_reverse_domain, +) -> dns.name.Name: + """Convert an IPv4 or IPv6 address in textual form into a Name object whose + value is the reverse-map domain name of the address. + + *text*, a ``str``, is an IPv4 or IPv6 address in textual form + (e.g. '127.0.0.1', '::1') + + *v4_origin*, a ``dns.name.Name`` to append to the labels corresponding to + the address if the address is an IPv4 address, instead of the default + (in-addr.arpa.) + + *v6_origin*, a ``dns.name.Name`` to append to the labels corresponding to + the address if the address is an IPv6 address, instead of the default + (ip6.arpa.) + + Raises ``dns.exception.SyntaxError`` if the address is badly formed. + + Returns a ``dns.name.Name``. + """ + + try: + v6 = dns.ipv6.inet_aton(text) + if dns.ipv6.is_mapped(v6): + parts = ["%d" % byte for byte in v6[12:]] + origin = v4_origin + else: + parts = [x for x in str(binascii.hexlify(v6).decode())] + origin = v6_origin + except Exception: + parts = ["%d" % byte for byte in dns.ipv4.inet_aton(text)] + origin = v4_origin + return dns.name.from_text(".".join(reversed(parts)), origin=origin) + + +def to_address( + name: dns.name.Name, + v4_origin: dns.name.Name = ipv4_reverse_domain, + v6_origin: dns.name.Name = ipv6_reverse_domain, +) -> str: + """Convert a reverse map domain name into textual address form. + + *name*, a ``dns.name.Name``, an IPv4 or IPv6 address in reverse-map name + form. + + *v4_origin*, a ``dns.name.Name`` representing the top-level domain for + IPv4 addresses, instead of the default (in-addr.arpa.) + + *v6_origin*, a ``dns.name.Name`` representing the top-level domain for + IPv4 addresses, instead of the default (ip6.arpa.) + + Raises ``dns.exception.SyntaxError`` if the name does not have a + reverse-map form. + + Returns a ``str``. + """ + + if name.is_subdomain(v4_origin): + name = name.relativize(v4_origin) + text = b".".join(reversed(name.labels)) + # run through inet_ntoa() to check syntax and make pretty. + return dns.ipv4.inet_ntoa(dns.ipv4.inet_aton(text)) + elif name.is_subdomain(v6_origin): + name = name.relativize(v6_origin) + labels = list(reversed(name.labels)) + parts = [] + for i in range(0, len(labels), 4): + parts.append(b"".join(labels[i : i + 4])) + text = b":".join(parts) + # run through inet_ntoa() to check syntax and make pretty. + return dns.ipv6.inet_ntoa(dns.ipv6.inet_aton(text)) + else: + raise dns.exception.SyntaxError("unknown reverse-map address family") diff --git a/.venv/lib/python3.12/site-packages/dns/rrset.py b/.venv/lib/python3.12/site-packages/dns/rrset.py new file mode 100644 index 0000000..6f39b10 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/rrset.py @@ -0,0 +1,285 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2017 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""DNS RRsets (an RRset is a named rdataset)""" + +from typing import Any, Collection, Dict, Optional, Union, cast + +import dns.name +import dns.rdataclass +import dns.rdataset +import dns.renderer + + +class RRset(dns.rdataset.Rdataset): + """A DNS RRset (named rdataset). + + RRset inherits from Rdataset, and RRsets can be treated as + Rdatasets in most cases. There are, however, a few notable + exceptions. RRsets have different to_wire() and to_text() method + arguments, reflecting the fact that RRsets always have an owner + name. + """ + + __slots__ = ["name", "deleting"] + + def __init__( + self, + name: dns.name.Name, + rdclass: dns.rdataclass.RdataClass, + rdtype: dns.rdatatype.RdataType, + covers: dns.rdatatype.RdataType = dns.rdatatype.NONE, + deleting: Optional[dns.rdataclass.RdataClass] = None, + ): + """Create a new RRset.""" + + super().__init__(rdclass, rdtype, covers) + self.name = name + self.deleting = deleting + + def _clone(self): + obj = super()._clone() + obj.name = self.name + obj.deleting = self.deleting + return obj + + def __repr__(self): + if self.covers == 0: + ctext = "" + else: + ctext = "(" + dns.rdatatype.to_text(self.covers) + ")" + if self.deleting is not None: + dtext = " delete=" + dns.rdataclass.to_text(self.deleting) + else: + dtext = "" + return ( + "" + ) + + def __str__(self): + return self.to_text() + + def __eq__(self, other): + if isinstance(other, RRset): + if self.name != other.name: + return False + elif not isinstance(other, dns.rdataset.Rdataset): + return False + return super().__eq__(other) + + def match(self, *args: Any, **kwargs: Any) -> bool: # type: ignore[override] + """Does this rrset match the specified attributes? + + Behaves as :py:func:`full_match()` if the first argument is a + ``dns.name.Name``, and as :py:func:`dns.rdataset.Rdataset.match()` + otherwise. + + (This behavior fixes a design mistake where the signature of this + method became incompatible with that of its superclass. The fix + makes RRsets matchable as Rdatasets while preserving backwards + compatibility.) + """ + if isinstance(args[0], dns.name.Name): + return self.full_match(*args, **kwargs) # type: ignore[arg-type] + else: + return super().match(*args, **kwargs) # type: ignore[arg-type] + + def full_match( + self, + name: dns.name.Name, + rdclass: dns.rdataclass.RdataClass, + rdtype: dns.rdatatype.RdataType, + covers: dns.rdatatype.RdataType, + deleting: Optional[dns.rdataclass.RdataClass] = None, + ) -> bool: + """Returns ``True`` if this rrset matches the specified name, class, + type, covers, and deletion state. + """ + if not super().match(rdclass, rdtype, covers): + return False + if self.name != name or self.deleting != deleting: + return False + return True + + # pylint: disable=arguments-differ + + def to_text( # type: ignore[override] + self, + origin: Optional[dns.name.Name] = None, + relativize: bool = True, + **kw: Dict[str, Any], + ) -> str: + """Convert the RRset into DNS zone file format. + + See ``dns.name.Name.choose_relativity`` for more information + on how *origin* and *relativize* determine the way names + are emitted. + + Any additional keyword arguments are passed on to the rdata + ``to_text()`` method. + + *origin*, a ``dns.name.Name`` or ``None``, the origin for relative + names. + + *relativize*, a ``bool``. If ``True``, names will be relativized + to *origin*. + """ + + return super().to_text( + self.name, origin, relativize, self.deleting, **kw # type: ignore + ) + + def to_wire( # type: ignore[override] + self, + file: Any, + compress: Optional[dns.name.CompressType] = None, # type: ignore + origin: Optional[dns.name.Name] = None, + **kw: Dict[str, Any], + ) -> int: + """Convert the RRset to wire format. + + All keyword arguments are passed to ``dns.rdataset.to_wire()``; see + that function for details. + + Returns an ``int``, the number of records emitted. + """ + + return super().to_wire( + self.name, file, compress, origin, self.deleting, **kw # type:ignore + ) + + # pylint: enable=arguments-differ + + def to_rdataset(self) -> dns.rdataset.Rdataset: + """Convert an RRset into an Rdataset. + + Returns a ``dns.rdataset.Rdataset``. + """ + return dns.rdataset.from_rdata_list(self.ttl, list(self)) + + +def from_text_list( + name: Union[dns.name.Name, str], + ttl: int, + rdclass: Union[dns.rdataclass.RdataClass, str], + rdtype: Union[dns.rdatatype.RdataType, str], + text_rdatas: Collection[str], + idna_codec: Optional[dns.name.IDNACodec] = None, + origin: Optional[dns.name.Name] = None, + relativize: bool = True, + relativize_to: Optional[dns.name.Name] = None, +) -> RRset: + """Create an RRset with the specified name, TTL, class, and type, and with + the specified list of rdatas in text format. + + *idna_codec*, a ``dns.name.IDNACodec``, specifies the IDNA + encoder/decoder to use; if ``None``, the default IDNA 2003 + encoder/decoder is used. + + *origin*, a ``dns.name.Name`` (or ``None``), the + origin to use for relative names. + + *relativize*, a ``bool``. If true, name will be relativized. + + *relativize_to*, a ``dns.name.Name`` (or ``None``), the origin to use + when relativizing names. If not set, the *origin* value will be used. + + Returns a ``dns.rrset.RRset`` object. + """ + + if isinstance(name, str): + name = dns.name.from_text(name, None, idna_codec=idna_codec) + rdclass = dns.rdataclass.RdataClass.make(rdclass) + rdtype = dns.rdatatype.RdataType.make(rdtype) + r = RRset(name, rdclass, rdtype) + r.update_ttl(ttl) + for t in text_rdatas: + rd = dns.rdata.from_text( + r.rdclass, r.rdtype, t, origin, relativize, relativize_to, idna_codec + ) + r.add(rd) + return r + + +def from_text( + name: Union[dns.name.Name, str], + ttl: int, + rdclass: Union[dns.rdataclass.RdataClass, str], + rdtype: Union[dns.rdatatype.RdataType, str], + *text_rdatas: Any, +) -> RRset: + """Create an RRset with the specified name, TTL, class, and type and with + the specified rdatas in text format. + + Returns a ``dns.rrset.RRset`` object. + """ + + return from_text_list( + name, ttl, rdclass, rdtype, cast(Collection[str], text_rdatas) + ) + + +def from_rdata_list( + name: Union[dns.name.Name, str], + ttl: int, + rdatas: Collection[dns.rdata.Rdata], + idna_codec: Optional[dns.name.IDNACodec] = None, +) -> RRset: + """Create an RRset with the specified name and TTL, and with + the specified list of rdata objects. + + *idna_codec*, a ``dns.name.IDNACodec``, specifies the IDNA + encoder/decoder to use; if ``None``, the default IDNA 2003 + encoder/decoder is used. + + Returns a ``dns.rrset.RRset`` object. + + """ + + if isinstance(name, str): + name = dns.name.from_text(name, None, idna_codec=idna_codec) + + if len(rdatas) == 0: + raise ValueError("rdata list must not be empty") + r = None + for rd in rdatas: + if r is None: + r = RRset(name, rd.rdclass, rd.rdtype) + r.update_ttl(ttl) + r.add(rd) + assert r is not None + return r + + +def from_rdata(name: Union[dns.name.Name, str], ttl: int, *rdatas: Any) -> RRset: + """Create an RRset with the specified name and TTL, and with + the specified rdata objects. + + Returns a ``dns.rrset.RRset`` object. + """ + + return from_rdata_list(name, ttl, cast(Collection[dns.rdata.Rdata], rdatas)) diff --git a/.venv/lib/python3.12/site-packages/dns/serial.py b/.venv/lib/python3.12/site-packages/dns/serial.py new file mode 100644 index 0000000..3417299 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/serial.py @@ -0,0 +1,118 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +"""Serial Number Arthimetic from RFC 1982""" + + +class Serial: + def __init__(self, value: int, bits: int = 32): + self.value = value % 2**bits + self.bits = bits + + def __repr__(self): + return f"dns.serial.Serial({self.value}, {self.bits})" + + def __eq__(self, other): + if isinstance(other, int): + other = Serial(other, self.bits) + elif not isinstance(other, Serial) or other.bits != self.bits: + return NotImplemented + return self.value == other.value + + def __ne__(self, other): + if isinstance(other, int): + other = Serial(other, self.bits) + elif not isinstance(other, Serial) or other.bits != self.bits: + return NotImplemented + return self.value != other.value + + def __lt__(self, other): + if isinstance(other, int): + other = Serial(other, self.bits) + elif not isinstance(other, Serial) or other.bits != self.bits: + return NotImplemented + if self.value < other.value and other.value - self.value < 2 ** (self.bits - 1): + return True + elif self.value > other.value and self.value - other.value > 2 ** ( + self.bits - 1 + ): + return True + else: + return False + + def __le__(self, other): + return self == other or self < other + + def __gt__(self, other): + if isinstance(other, int): + other = Serial(other, self.bits) + elif not isinstance(other, Serial) or other.bits != self.bits: + return NotImplemented + if self.value < other.value and other.value - self.value > 2 ** (self.bits - 1): + return True + elif self.value > other.value and self.value - other.value < 2 ** ( + self.bits - 1 + ): + return True + else: + return False + + def __ge__(self, other): + return self == other or self > other + + def __add__(self, other): + v = self.value + if isinstance(other, Serial): + delta = other.value + elif isinstance(other, int): + delta = other + else: + raise ValueError + if abs(delta) > (2 ** (self.bits - 1) - 1): + raise ValueError + v += delta + v = v % 2**self.bits + return Serial(v, self.bits) + + def __iadd__(self, other): + v = self.value + if isinstance(other, Serial): + delta = other.value + elif isinstance(other, int): + delta = other + else: + raise ValueError + if abs(delta) > (2 ** (self.bits - 1) - 1): + raise ValueError + v += delta + v = v % 2**self.bits + self.value = v + return self + + def __sub__(self, other): + v = self.value + if isinstance(other, Serial): + delta = other.value + elif isinstance(other, int): + delta = other + else: + raise ValueError + if abs(delta) > (2 ** (self.bits - 1) - 1): + raise ValueError + v -= delta + v = v % 2**self.bits + return Serial(v, self.bits) + + def __isub__(self, other): + v = self.value + if isinstance(other, Serial): + delta = other.value + elif isinstance(other, int): + delta = other + else: + raise ValueError + if abs(delta) > (2 ** (self.bits - 1) - 1): + raise ValueError + v -= delta + v = v % 2**self.bits + self.value = v + return self diff --git a/.venv/lib/python3.12/site-packages/dns/set.py b/.venv/lib/python3.12/site-packages/dns/set.py new file mode 100644 index 0000000..f0fb0d5 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/set.py @@ -0,0 +1,307 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2017 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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 itertools + + +class Set: + """A simple set class. + + This class was originally used to deal with sets being missing in + ancient versions of python, but dnspython will continue to use it + as these sets are based on lists and are thus indexable, and this + ability is widely used in dnspython applications. + """ + + __slots__ = ["items"] + + def __init__(self, items=None): + """Initialize the set. + + *items*, an iterable or ``None``, the initial set of items. + """ + + self.items = dict() + if items is not None: + for item in items: + # This is safe for how we use set, but if other code + # subclasses it could be a legitimate issue. + self.add(item) # lgtm[py/init-calls-subclass] + + def __repr__(self): + return "dns.set.Set(%s)" % repr(list(self.items.keys())) + + def add(self, item): + """Add an item to the set.""" + + if item not in self.items: + self.items[item] = None + + def remove(self, item): + """Remove an item from the set.""" + + try: + del self.items[item] + except KeyError: + raise ValueError + + def discard(self, item): + """Remove an item from the set if present.""" + + self.items.pop(item, None) + + def pop(self): + """Remove an arbitrary item from the set.""" + (k, _) = self.items.popitem() + return k + + def _clone(self) -> "Set": + """Make a (shallow) copy of the set. + + There is a 'clone protocol' that subclasses of this class + should use. To make a copy, first call your super's _clone() + method, and use the object returned as the new instance. Then + make shallow copies of the attributes defined in the subclass. + + This protocol allows us to write the set algorithms that + return new instances (e.g. union) once, and keep using them in + subclasses. + """ + + if hasattr(self, "_clone_class"): + cls = self._clone_class # type: ignore + else: + cls = self.__class__ + obj = cls.__new__(cls) + obj.items = dict() + obj.items.update(self.items) + return obj + + def __copy__(self): + """Make a (shallow) copy of the set.""" + + return self._clone() + + def copy(self): + """Make a (shallow) copy of the set.""" + + return self._clone() + + def union_update(self, other): + """Update the set, adding any elements from other which are not + already in the set. + """ + + if not isinstance(other, Set): + raise ValueError("other must be a Set instance") + if self is other: # lgtm[py/comparison-using-is] + return + for item in other.items: + self.add(item) + + def intersection_update(self, other): + """Update the set, removing any elements from other which are not + in both sets. + """ + + if not isinstance(other, Set): + raise ValueError("other must be a Set instance") + if self is other: # lgtm[py/comparison-using-is] + return + # we make a copy of the list so that we can remove items from + # the list without breaking the iterator. + for item in list(self.items): + if item not in other.items: + del self.items[item] + + def difference_update(self, other): + """Update the set, removing any elements from other which are in + the set. + """ + + if not isinstance(other, Set): + raise ValueError("other must be a Set instance") + if self is other: # lgtm[py/comparison-using-is] + self.items.clear() + else: + for item in other.items: + self.discard(item) + + def symmetric_difference_update(self, other): + """Update the set, retaining only elements unique to both sets.""" + + if not isinstance(other, Set): + raise ValueError("other must be a Set instance") + if self is other: # lgtm[py/comparison-using-is] + self.items.clear() + else: + overlap = self.intersection(other) + self.union_update(other) + self.difference_update(overlap) + + def union(self, other): + """Return a new set which is the union of ``self`` and ``other``. + + Returns the same Set type as this set. + """ + + obj = self._clone() + obj.union_update(other) + return obj + + def intersection(self, other): + """Return a new set which is the intersection of ``self`` and + ``other``. + + Returns the same Set type as this set. + """ + + obj = self._clone() + obj.intersection_update(other) + return obj + + def difference(self, other): + """Return a new set which ``self`` - ``other``, i.e. the items + in ``self`` which are not also in ``other``. + + Returns the same Set type as this set. + """ + + obj = self._clone() + obj.difference_update(other) + return obj + + def symmetric_difference(self, other): + """Return a new set which (``self`` - ``other``) | (``other`` + - ``self), ie: the items in either ``self`` or ``other`` which + are not contained in their intersection. + + Returns the same Set type as this set. + """ + + obj = self._clone() + obj.symmetric_difference_update(other) + return obj + + def __or__(self, other): + return self.union(other) + + def __and__(self, other): + return self.intersection(other) + + def __add__(self, other): + return self.union(other) + + def __sub__(self, other): + return self.difference(other) + + def __xor__(self, other): + return self.symmetric_difference(other) + + def __ior__(self, other): + self.union_update(other) + return self + + def __iand__(self, other): + self.intersection_update(other) + return self + + def __iadd__(self, other): + self.union_update(other) + return self + + def __isub__(self, other): + self.difference_update(other) + return self + + def __ixor__(self, other): + self.symmetric_difference_update(other) + return self + + def update(self, other): + """Update the set, adding any elements from other which are not + already in the set. + + *other*, the collection of items with which to update the set, which + may be any iterable type. + """ + + for item in other: + self.add(item) + + def clear(self): + """Make the set empty.""" + self.items.clear() + + def __eq__(self, other): + return self.items == other.items + + def __ne__(self, other): + return not self.__eq__(other) + + def __len__(self): + return len(self.items) + + def __iter__(self): + return iter(self.items) + + def __getitem__(self, i): + if isinstance(i, slice): + return list(itertools.islice(self.items, i.start, i.stop, i.step)) + else: + return next(itertools.islice(self.items, i, i + 1)) + + def __delitem__(self, i): + if isinstance(i, slice): + for elt in list(self[i]): + del self.items[elt] + else: + del self.items[self[i]] + + def issubset(self, other): + """Is this set a subset of *other*? + + Returns a ``bool``. + """ + + if not isinstance(other, Set): + raise ValueError("other must be a Set instance") + for item in self.items: + if item not in other.items: + return False + return True + + def issuperset(self, other): + """Is this set a superset of *other*? + + Returns a ``bool``. + """ + + if not isinstance(other, Set): + raise ValueError("other must be a Set instance") + for item in other.items: + if item not in self.items: + return False + return True + + def isdisjoint(self, other): + if not isinstance(other, Set): + raise ValueError("other must be a Set instance") + for item in other.items: + if item in self.items: + return False + return True diff --git a/.venv/lib/python3.12/site-packages/dns/tokenizer.py b/.venv/lib/python3.12/site-packages/dns/tokenizer.py new file mode 100644 index 0000000..454cac4 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/tokenizer.py @@ -0,0 +1,708 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2017 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""Tokenize DNS zone file format""" + +import io +import sys +from typing import Any, List, Optional, Tuple + +import dns.exception +import dns.name +import dns.ttl + +_DELIMITERS = {" ", "\t", "\n", ";", "(", ")", '"'} +_QUOTING_DELIMITERS = {'"'} + +EOF = 0 +EOL = 1 +WHITESPACE = 2 +IDENTIFIER = 3 +QUOTED_STRING = 4 +COMMENT = 5 +DELIMITER = 6 + + +class UngetBufferFull(dns.exception.DNSException): + """An attempt was made to unget a token when the unget buffer was full.""" + + +class Token: + """A DNS zone file format token. + + ttype: The token type + value: The token value + has_escape: Does the token value contain escapes? + """ + + def __init__( + self, + ttype: int, + value: Any = "", + has_escape: bool = False, + comment: Optional[str] = None, + ): + """Initialize a token instance.""" + + self.ttype = ttype + self.value = value + self.has_escape = has_escape + self.comment = comment + + def is_eof(self) -> bool: + return self.ttype == EOF + + def is_eol(self) -> bool: + return self.ttype == EOL + + def is_whitespace(self) -> bool: + return self.ttype == WHITESPACE + + def is_identifier(self) -> bool: + return self.ttype == IDENTIFIER + + def is_quoted_string(self) -> bool: + return self.ttype == QUOTED_STRING + + def is_comment(self) -> bool: + return self.ttype == COMMENT + + def is_delimiter(self) -> bool: # pragma: no cover (we don't return delimiters yet) + return self.ttype == DELIMITER + + def is_eol_or_eof(self) -> bool: + return self.ttype == EOL or self.ttype == EOF + + def __eq__(self, other): + if not isinstance(other, Token): + return False + return self.ttype == other.ttype and self.value == other.value + + def __ne__(self, other): + if not isinstance(other, Token): + return True + return self.ttype != other.ttype or self.value != other.value + + def __str__(self): + return '%d "%s"' % (self.ttype, self.value) + + def unescape(self) -> "Token": + if not self.has_escape: + return self + unescaped = "" + l = len(self.value) + i = 0 + while i < l: + c = self.value[i] + i += 1 + if c == "\\": + if i >= l: # pragma: no cover (can't happen via get()) + raise dns.exception.UnexpectedEnd + c = self.value[i] + i += 1 + if c.isdigit(): + if i >= l: + raise dns.exception.UnexpectedEnd + c2 = self.value[i] + i += 1 + if i >= l: + raise dns.exception.UnexpectedEnd + c3 = self.value[i] + i += 1 + if not (c2.isdigit() and c3.isdigit()): + raise dns.exception.SyntaxError + codepoint = int(c) * 100 + int(c2) * 10 + int(c3) + if codepoint > 255: + raise dns.exception.SyntaxError + c = chr(codepoint) + unescaped += c + return Token(self.ttype, unescaped) + + def unescape_to_bytes(self) -> "Token": + # We used to use unescape() for TXT-like records, but this + # caused problems as we'd process DNS escapes into Unicode code + # points instead of byte values, and then a to_text() of the + # processed data would not equal the original input. For + # example, \226 in the TXT record would have a to_text() of + # \195\162 because we applied UTF-8 encoding to Unicode code + # point 226. + # + # We now apply escapes while converting directly to bytes, + # avoiding this double encoding. + # + # This code also handles cases where the unicode input has + # non-ASCII code-points in it by converting it to UTF-8. TXT + # records aren't defined for Unicode, but this is the best we + # can do to preserve meaning. For example, + # + # foo\u200bbar + # + # (where \u200b is Unicode code point 0x200b) will be treated + # as if the input had been the UTF-8 encoding of that string, + # namely: + # + # foo\226\128\139bar + # + unescaped = b"" + l = len(self.value) + i = 0 + while i < l: + c = self.value[i] + i += 1 + if c == "\\": + if i >= l: # pragma: no cover (can't happen via get()) + raise dns.exception.UnexpectedEnd + c = self.value[i] + i += 1 + if c.isdigit(): + if i >= l: + raise dns.exception.UnexpectedEnd + c2 = self.value[i] + i += 1 + if i >= l: + raise dns.exception.UnexpectedEnd + c3 = self.value[i] + i += 1 + if not (c2.isdigit() and c3.isdigit()): + raise dns.exception.SyntaxError + codepoint = int(c) * 100 + int(c2) * 10 + int(c3) + if codepoint > 255: + raise dns.exception.SyntaxError + unescaped += b"%c" % (codepoint) + else: + # Note that as mentioned above, if c is a Unicode + # code point outside of the ASCII range, then this + # += is converting that code point to its UTF-8 + # encoding and appending multiple bytes to + # unescaped. + unescaped += c.encode() + else: + unescaped += c.encode() + return Token(self.ttype, bytes(unescaped)) + + +class Tokenizer: + """A DNS zone file format tokenizer. + + A token object is basically a (type, value) tuple. The valid + types are EOF, EOL, WHITESPACE, IDENTIFIER, QUOTED_STRING, + COMMENT, and DELIMITER. + + file: The file to tokenize + + ungotten_char: The most recently ungotten character, or None. + + ungotten_token: The most recently ungotten token, or None. + + multiline: The current multiline level. This value is increased + by one every time a '(' delimiter is read, and decreased by one every time + a ')' delimiter is read. + + quoting: This variable is true if the tokenizer is currently + reading a quoted string. + + eof: This variable is true if the tokenizer has encountered EOF. + + delimiters: The current delimiter dictionary. + + line_number: The current line number + + filename: A filename that will be returned by the where() method. + + idna_codec: A dns.name.IDNACodec, specifies the IDNA + encoder/decoder. If None, the default IDNA 2003 + encoder/decoder is used. + """ + + def __init__( + self, + f: Any = sys.stdin, + filename: Optional[str] = None, + idna_codec: Optional[dns.name.IDNACodec] = None, + ): + """Initialize a tokenizer instance. + + f: The file to tokenize. The default is sys.stdin. + This parameter may also be a string, in which case the tokenizer + will take its input from the contents of the string. + + filename: the name of the filename that the where() method + will return. + + idna_codec: A dns.name.IDNACodec, specifies the IDNA + encoder/decoder. If None, the default IDNA 2003 + encoder/decoder is used. + """ + + if isinstance(f, str): + f = io.StringIO(f) + if filename is None: + filename = "" + elif isinstance(f, bytes): + f = io.StringIO(f.decode()) + if filename is None: + filename = "" + else: + if filename is None: + if f is sys.stdin: + filename = "" + else: + filename = "" + self.file = f + self.ungotten_char: Optional[str] = None + self.ungotten_token: Optional[Token] = None + self.multiline = 0 + self.quoting = False + self.eof = False + self.delimiters = _DELIMITERS + self.line_number = 1 + assert filename is not None + self.filename = filename + if idna_codec is None: + self.idna_codec: dns.name.IDNACodec = dns.name.IDNA_2003 + else: + self.idna_codec = idna_codec + + def _get_char(self) -> str: + """Read a character from input.""" + + if self.ungotten_char is None: + if self.eof: + c = "" + else: + c = self.file.read(1) + if c == "": + self.eof = True + elif c == "\n": + self.line_number += 1 + else: + c = self.ungotten_char + self.ungotten_char = None + return c + + def where(self) -> Tuple[str, int]: + """Return the current location in the input. + + Returns a (string, int) tuple. The first item is the filename of + the input, the second is the current line number. + """ + + return (self.filename, self.line_number) + + def _unget_char(self, c: str) -> None: + """Unget a character. + + The unget buffer for characters is only one character large; it is + an error to try to unget a character when the unget buffer is not + empty. + + c: the character to unget + raises UngetBufferFull: there is already an ungotten char + """ + + if self.ungotten_char is not None: + # this should never happen! + raise UngetBufferFull # pragma: no cover + self.ungotten_char = c + + def skip_whitespace(self) -> int: + """Consume input until a non-whitespace character is encountered. + + The non-whitespace character is then ungotten, and the number of + whitespace characters consumed is returned. + + If the tokenizer is in multiline mode, then newlines are whitespace. + + Returns the number of characters skipped. + """ + + skipped = 0 + while True: + c = self._get_char() + if c != " " and c != "\t": + if (c != "\n") or not self.multiline: + self._unget_char(c) + return skipped + skipped += 1 + + def get(self, want_leading: bool = False, want_comment: bool = False) -> Token: + """Get the next token. + + want_leading: If True, return a WHITESPACE token if the + first character read is whitespace. The default is False. + + want_comment: If True, return a COMMENT token if the + first token read is a comment. The default is False. + + Raises dns.exception.UnexpectedEnd: input ended prematurely + + Raises dns.exception.SyntaxError: input was badly formed + + Returns a Token. + """ + + if self.ungotten_token is not None: + utoken = self.ungotten_token + self.ungotten_token = None + if utoken.is_whitespace(): + if want_leading: + return utoken + elif utoken.is_comment(): + if want_comment: + return utoken + else: + return utoken + skipped = self.skip_whitespace() + if want_leading and skipped > 0: + return Token(WHITESPACE, " ") + token = "" + ttype = IDENTIFIER + has_escape = False + while True: + c = self._get_char() + if c == "" or c in self.delimiters: + if c == "" and self.quoting: + raise dns.exception.UnexpectedEnd + if token == "" and ttype != QUOTED_STRING: + if c == "(": + self.multiline += 1 + self.skip_whitespace() + continue + elif c == ")": + if self.multiline <= 0: + raise dns.exception.SyntaxError + self.multiline -= 1 + self.skip_whitespace() + continue + elif c == '"': + if not self.quoting: + self.quoting = True + self.delimiters = _QUOTING_DELIMITERS + ttype = QUOTED_STRING + continue + else: + self.quoting = False + self.delimiters = _DELIMITERS + self.skip_whitespace() + continue + elif c == "\n": + return Token(EOL, "\n") + elif c == ";": + while 1: + c = self._get_char() + if c == "\n" or c == "": + break + token += c + if want_comment: + self._unget_char(c) + return Token(COMMENT, token) + elif c == "": + if self.multiline: + raise dns.exception.SyntaxError( + "unbalanced parentheses" + ) + return Token(EOF, comment=token) + elif self.multiline: + self.skip_whitespace() + token = "" + continue + else: + return Token(EOL, "\n", comment=token) + else: + # This code exists in case we ever want a + # delimiter to be returned. It never produces + # a token currently. + token = c + ttype = DELIMITER + else: + self._unget_char(c) + break + elif self.quoting and c == "\n": + raise dns.exception.SyntaxError("newline in quoted string") + elif c == "\\": + # + # It's an escape. Put it and the next character into + # the token; it will be checked later for goodness. + # + token += c + has_escape = True + c = self._get_char() + if c == "" or (c == "\n" and not self.quoting): + raise dns.exception.UnexpectedEnd + token += c + if token == "" and ttype != QUOTED_STRING: + if self.multiline: + raise dns.exception.SyntaxError("unbalanced parentheses") + ttype = EOF + return Token(ttype, token, has_escape) + + def unget(self, token: Token) -> None: + """Unget a token. + + The unget buffer for tokens is only one token large; it is + an error to try to unget a token when the unget buffer is not + empty. + + token: the token to unget + + Raises UngetBufferFull: there is already an ungotten token + """ + + if self.ungotten_token is not None: + raise UngetBufferFull + self.ungotten_token = token + + def next(self): + """Return the next item in an iteration. + + Returns a Token. + """ + + token = self.get() + if token.is_eof(): + raise StopIteration + return token + + __next__ = next + + def __iter__(self): + return self + + # Helpers + + def get_int(self, base: int = 10) -> int: + """Read the next token and interpret it as an unsigned integer. + + Raises dns.exception.SyntaxError if not an unsigned integer. + + Returns an int. + """ + + token = self.get().unescape() + if not token.is_identifier(): + raise dns.exception.SyntaxError("expecting an identifier") + if not token.value.isdigit(): + raise dns.exception.SyntaxError("expecting an integer") + return int(token.value, base) + + def get_uint8(self) -> int: + """Read the next token and interpret it as an 8-bit unsigned + integer. + + Raises dns.exception.SyntaxError if not an 8-bit unsigned integer. + + Returns an int. + """ + + value = self.get_int() + if value < 0 or value > 255: + raise dns.exception.SyntaxError( + "%d is not an unsigned 8-bit integer" % value + ) + return value + + def get_uint16(self, base: int = 10) -> int: + """Read the next token and interpret it as a 16-bit unsigned + integer. + + Raises dns.exception.SyntaxError if not a 16-bit unsigned integer. + + Returns an int. + """ + + value = self.get_int(base=base) + if value < 0 or value > 65535: + if base == 8: + raise dns.exception.SyntaxError( + "%o is not an octal unsigned 16-bit integer" % value + ) + else: + raise dns.exception.SyntaxError( + "%d is not an unsigned 16-bit integer" % value + ) + return value + + def get_uint32(self, base: int = 10) -> int: + """Read the next token and interpret it as a 32-bit unsigned + integer. + + Raises dns.exception.SyntaxError if not a 32-bit unsigned integer. + + Returns an int. + """ + + value = self.get_int(base=base) + if value < 0 or value > 4294967295: + raise dns.exception.SyntaxError( + "%d is not an unsigned 32-bit integer" % value + ) + return value + + def get_uint48(self, base: int = 10) -> int: + """Read the next token and interpret it as a 48-bit unsigned + integer. + + Raises dns.exception.SyntaxError if not a 48-bit unsigned integer. + + Returns an int. + """ + + value = self.get_int(base=base) + if value < 0 or value > 281474976710655: + raise dns.exception.SyntaxError( + "%d is not an unsigned 48-bit integer" % value + ) + return value + + def get_string(self, max_length: Optional[int] = None) -> str: + """Read the next token and interpret it as a string. + + Raises dns.exception.SyntaxError if not a string. + Raises dns.exception.SyntaxError if token value length + exceeds max_length (if specified). + + Returns a string. + """ + + token = self.get().unescape() + if not (token.is_identifier() or token.is_quoted_string()): + raise dns.exception.SyntaxError("expecting a string") + if max_length and len(token.value) > max_length: + raise dns.exception.SyntaxError("string too long") + return token.value + + def get_identifier(self) -> str: + """Read the next token, which should be an identifier. + + Raises dns.exception.SyntaxError if not an identifier. + + Returns a string. + """ + + token = self.get().unescape() + if not token.is_identifier(): + raise dns.exception.SyntaxError("expecting an identifier") + return token.value + + def get_remaining(self, max_tokens: Optional[int] = None) -> List[Token]: + """Return the remaining tokens on the line, until an EOL or EOF is seen. + + max_tokens: If not None, stop after this number of tokens. + + Returns a list of tokens. + """ + + tokens = [] + while True: + token = self.get() + if token.is_eol_or_eof(): + self.unget(token) + break + tokens.append(token) + if len(tokens) == max_tokens: + break + return tokens + + def concatenate_remaining_identifiers(self, allow_empty: bool = False) -> str: + """Read the remaining tokens on the line, which should be identifiers. + + Raises dns.exception.SyntaxError if there are no remaining tokens, + unless `allow_empty=True` is given. + + Raises dns.exception.SyntaxError if a token is seen that is not an + identifier. + + Returns a string containing a concatenation of the remaining + identifiers. + """ + s = "" + while True: + token = self.get().unescape() + if token.is_eol_or_eof(): + self.unget(token) + break + if not token.is_identifier(): + raise dns.exception.SyntaxError + s += token.value + if not (allow_empty or s): + raise dns.exception.SyntaxError("expecting another identifier") + return s + + def as_name( + self, + token: Token, + origin: Optional[dns.name.Name] = None, + relativize: bool = False, + relativize_to: Optional[dns.name.Name] = None, + ) -> dns.name.Name: + """Try to interpret the token as a DNS name. + + Raises dns.exception.SyntaxError if not a name. + + Returns a dns.name.Name. + """ + if not token.is_identifier(): + raise dns.exception.SyntaxError("expecting an identifier") + name = dns.name.from_text(token.value, origin, self.idna_codec) + return name.choose_relativity(relativize_to or origin, relativize) + + def get_name( + self, + origin: Optional[dns.name.Name] = None, + relativize: bool = False, + relativize_to: Optional[dns.name.Name] = None, + ) -> dns.name.Name: + """Read the next token and interpret it as a DNS name. + + Raises dns.exception.SyntaxError if not a name. + + Returns a dns.name.Name. + """ + + token = self.get() + return self.as_name(token, origin, relativize, relativize_to) + + def get_eol_as_token(self) -> Token: + """Read the next token and raise an exception if it isn't EOL or + EOF. + + Returns a string. + """ + + token = self.get() + if not token.is_eol_or_eof(): + raise dns.exception.SyntaxError( + 'expected EOL or EOF, got %d "%s"' % (token.ttype, token.value) + ) + return token + + def get_eol(self) -> str: + return self.get_eol_as_token().value + + def get_ttl(self) -> int: + """Read the next token and interpret it as a DNS TTL. + + Raises dns.exception.SyntaxError or dns.ttl.BadTTL if not an + identifier or badly formed. + + Returns an int. + """ + + token = self.get().unescape() + if not token.is_identifier(): + raise dns.exception.SyntaxError("expecting an identifier") + return dns.ttl.from_text(token.value) diff --git a/.venv/lib/python3.12/site-packages/dns/transaction.py b/.venv/lib/python3.12/site-packages/dns/transaction.py new file mode 100644 index 0000000..84e54f7 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/transaction.py @@ -0,0 +1,651 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +import collections +from typing import Any, Callable, Iterator, List, Optional, Tuple, Union + +import dns.exception +import dns.name +import dns.node +import dns.rdataclass +import dns.rdataset +import dns.rdatatype +import dns.rrset +import dns.serial +import dns.ttl + + +class TransactionManager: + def reader(self) -> "Transaction": + """Begin a read-only transaction.""" + raise NotImplementedError # pragma: no cover + + def writer(self, replacement: bool = False) -> "Transaction": + """Begin a writable transaction. + + *replacement*, a ``bool``. If `True`, the content of the + transaction completely replaces any prior content. If False, + the default, then the content of the transaction updates the + existing content. + """ + raise NotImplementedError # pragma: no cover + + def origin_information( + self, + ) -> Tuple[Optional[dns.name.Name], bool, Optional[dns.name.Name]]: + """Returns a tuple + + (absolute_origin, relativize, effective_origin) + + giving the absolute name of the default origin for any + relative domain names, the "effective origin", and whether + names should be relativized. The "effective origin" is the + absolute origin if relativize is False, and the empty name if + relativize is true. (The effective origin is provided even + though it can be computed from the absolute_origin and + relativize setting because it avoids a lot of code + duplication.) + + If the returned names are `None`, then no origin information is + available. + + This information is used by code working with transactions to + allow it to coordinate relativization. The transaction code + itself takes what it gets (i.e. does not change name + relativity). + + """ + raise NotImplementedError # pragma: no cover + + def get_class(self) -> dns.rdataclass.RdataClass: + """The class of the transaction manager.""" + raise NotImplementedError # pragma: no cover + + def from_wire_origin(self) -> Optional[dns.name.Name]: + """Origin to use in from_wire() calls.""" + (absolute_origin, relativize, _) = self.origin_information() + if relativize: + return absolute_origin + else: + return None + + +class DeleteNotExact(dns.exception.DNSException): + """Existing data did not match data specified by an exact delete.""" + + +class ReadOnly(dns.exception.DNSException): + """Tried to write to a read-only transaction.""" + + +class AlreadyEnded(dns.exception.DNSException): + """Tried to use an already-ended transaction.""" + + +def _ensure_immutable_rdataset(rdataset): + if rdataset is None or isinstance(rdataset, dns.rdataset.ImmutableRdataset): + return rdataset + return dns.rdataset.ImmutableRdataset(rdataset) + + +def _ensure_immutable_node(node): + if node is None or node.is_immutable(): + return node + return dns.node.ImmutableNode(node) + + +CheckPutRdatasetType = Callable[ + ["Transaction", dns.name.Name, dns.rdataset.Rdataset], None +] +CheckDeleteRdatasetType = Callable[ + ["Transaction", dns.name.Name, dns.rdatatype.RdataType, dns.rdatatype.RdataType], + None, +] +CheckDeleteNameType = Callable[["Transaction", dns.name.Name], None] + + +class Transaction: + def __init__( + self, + manager: TransactionManager, + replacement: bool = False, + read_only: bool = False, + ): + self.manager = manager + self.replacement = replacement + self.read_only = read_only + self._ended = False + self._check_put_rdataset: List[CheckPutRdatasetType] = [] + self._check_delete_rdataset: List[CheckDeleteRdatasetType] = [] + self._check_delete_name: List[CheckDeleteNameType] = [] + + # + # This is the high level API + # + # Note that we currently use non-immutable types in the return type signature to + # avoid covariance problems, e.g. if the caller has a List[Rdataset], mypy will be + # unhappy if we return an ImmutableRdataset. + + def get( + self, + name: Optional[Union[dns.name.Name, str]], + rdtype: Union[dns.rdatatype.RdataType, str], + covers: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.NONE, + ) -> dns.rdataset.Rdataset: + """Return the rdataset associated with *name*, *rdtype*, and *covers*, + or `None` if not found. + + Note that the returned rdataset is immutable. + """ + self._check_ended() + if isinstance(name, str): + name = dns.name.from_text(name, None) + rdtype = dns.rdatatype.RdataType.make(rdtype) + covers = dns.rdatatype.RdataType.make(covers) + rdataset = self._get_rdataset(name, rdtype, covers) + return _ensure_immutable_rdataset(rdataset) + + def get_node(self, name: dns.name.Name) -> Optional[dns.node.Node]: + """Return the node at *name*, if any. + + Returns an immutable node or ``None``. + """ + return _ensure_immutable_node(self._get_node(name)) + + def _check_read_only(self) -> None: + if self.read_only: + raise ReadOnly + + def add(self, *args: Any) -> None: + """Add records. + + The arguments may be: + + - rrset + + - name, rdataset... + + - name, ttl, rdata... + """ + self._check_ended() + self._check_read_only() + self._add(False, args) + + def replace(self, *args: Any) -> None: + """Replace the existing rdataset at the name with the specified + rdataset, or add the specified rdataset if there was no existing + rdataset. + + The arguments may be: + + - rrset + + - name, rdataset... + + - name, ttl, rdata... + + Note that if you want to replace the entire node, you should do + a delete of the name followed by one or more calls to add() or + replace(). + """ + self._check_ended() + self._check_read_only() + self._add(True, args) + + def delete(self, *args: Any) -> None: + """Delete records. + + It is not an error if some of the records are not in the existing + set. + + The arguments may be: + + - rrset + + - name + + - name, rdatatype, [covers] + + - name, rdataset... + + - name, rdata... + """ + self._check_ended() + self._check_read_only() + self._delete(False, args) + + def delete_exact(self, *args: Any) -> None: + """Delete records. + + The arguments may be: + + - rrset + + - name + + - name, rdatatype, [covers] + + - name, rdataset... + + - name, rdata... + + Raises dns.transaction.DeleteNotExact if some of the records + are not in the existing set. + + """ + self._check_ended() + self._check_read_only() + self._delete(True, args) + + def name_exists(self, name: Union[dns.name.Name, str]) -> bool: + """Does the specified name exist?""" + self._check_ended() + if isinstance(name, str): + name = dns.name.from_text(name, None) + return self._name_exists(name) + + def update_serial( + self, + value: int = 1, + relative: bool = True, + name: dns.name.Name = dns.name.empty, + ) -> None: + """Update the serial number. + + *value*, an `int`, is an increment if *relative* is `True`, or the + actual value to set if *relative* is `False`. + + Raises `KeyError` if there is no SOA rdataset at *name*. + + Raises `ValueError` if *value* is negative or if the increment is + so large that it would cause the new serial to be less than the + prior value. + """ + self._check_ended() + if value < 0: + raise ValueError("negative update_serial() value") + if isinstance(name, str): + name = dns.name.from_text(name, None) + rdataset = self._get_rdataset(name, dns.rdatatype.SOA, dns.rdatatype.NONE) + if rdataset is None or len(rdataset) == 0: + raise KeyError + if relative: + serial = dns.serial.Serial(rdataset[0].serial) + value + else: + serial = dns.serial.Serial(value) + serial = serial.value # convert back to int + if serial == 0: + serial = 1 + rdata = rdataset[0].replace(serial=serial) + new_rdataset = dns.rdataset.from_rdata(rdataset.ttl, rdata) + self.replace(name, new_rdataset) + + def __iter__(self): + self._check_ended() + return self._iterate_rdatasets() + + def changed(self) -> bool: + """Has this transaction changed anything? + + For read-only transactions, the result is always `False`. + + For writable transactions, the result is `True` if at some time + during the life of the transaction, the content was changed. + """ + self._check_ended() + return self._changed() + + def commit(self) -> None: + """Commit the transaction. + + Normally transactions are used as context managers and commit + or rollback automatically, but it may be done explicitly if needed. + A ``dns.transaction.Ended`` exception will be raised if you try + to use a transaction after it has been committed or rolled back. + + Raises an exception if the commit fails (in which case the transaction + is also rolled back. + """ + self._end(True) + + def rollback(self) -> None: + """Rollback the transaction. + + Normally transactions are used as context managers and commit + or rollback automatically, but it may be done explicitly if needed. + A ``dns.transaction.AlreadyEnded`` exception will be raised if you try + to use a transaction after it has been committed or rolled back. + + Rollback cannot otherwise fail. + """ + self._end(False) + + def check_put_rdataset(self, check: CheckPutRdatasetType) -> None: + """Call *check* before putting (storing) an rdataset. + + The function is called with the transaction, the name, and the rdataset. + + The check function may safely make non-mutating transaction method + calls, but behavior is undefined if mutating transaction methods are + called. The check function should raise an exception if it objects to + the put, and otherwise should return ``None``. + """ + self._check_put_rdataset.append(check) + + def check_delete_rdataset(self, check: CheckDeleteRdatasetType) -> None: + """Call *check* before deleting an rdataset. + + The function is called with the transaction, the name, the rdatatype, + and the covered rdatatype. + + The check function may safely make non-mutating transaction method + calls, but behavior is undefined if mutating transaction methods are + called. The check function should raise an exception if it objects to + the put, and otherwise should return ``None``. + """ + self._check_delete_rdataset.append(check) + + def check_delete_name(self, check: CheckDeleteNameType) -> None: + """Call *check* before putting (storing) an rdataset. + + The function is called with the transaction and the name. + + The check function may safely make non-mutating transaction method + calls, but behavior is undefined if mutating transaction methods are + called. The check function should raise an exception if it objects to + the put, and otherwise should return ``None``. + """ + self._check_delete_name.append(check) + + def iterate_rdatasets( + self, + ) -> Iterator[Tuple[dns.name.Name, dns.rdataset.Rdataset]]: + """Iterate all the rdatasets in the transaction, returning + (`dns.name.Name`, `dns.rdataset.Rdataset`) tuples. + + Note that as is usual with python iterators, adding or removing items + while iterating will invalidate the iterator and may raise `RuntimeError` + or fail to iterate over all entries.""" + self._check_ended() + return self._iterate_rdatasets() + + def iterate_names(self) -> Iterator[dns.name.Name]: + """Iterate all the names in the transaction. + + Note that as is usual with python iterators, adding or removing names + while iterating will invalidate the iterator and may raise `RuntimeError` + or fail to iterate over all entries.""" + self._check_ended() + return self._iterate_names() + + # + # Helper methods + # + + def _raise_if_not_empty(self, method, args): + if len(args) != 0: + raise TypeError(f"extra parameters to {method}") + + def _rdataset_from_args(self, method, deleting, args): + try: + arg = args.popleft() + if isinstance(arg, dns.rrset.RRset): + rdataset = arg.to_rdataset() + elif isinstance(arg, dns.rdataset.Rdataset): + rdataset = arg + else: + if deleting: + ttl = 0 + else: + if isinstance(arg, int): + ttl = arg + if ttl > dns.ttl.MAX_TTL: + raise ValueError(f"{method}: TTL value too big") + else: + raise TypeError(f"{method}: expected a TTL") + arg = args.popleft() + if isinstance(arg, dns.rdata.Rdata): + rdataset = dns.rdataset.from_rdata(ttl, arg) + else: + raise TypeError(f"{method}: expected an Rdata") + return rdataset + except IndexError: + if deleting: + return None + else: + # reraise + raise TypeError(f"{method}: expected more arguments") + + def _add(self, replace, args): + try: + args = collections.deque(args) + if replace: + method = "replace()" + else: + method = "add()" + arg = args.popleft() + if isinstance(arg, str): + arg = dns.name.from_text(arg, None) + if isinstance(arg, dns.name.Name): + name = arg + rdataset = self._rdataset_from_args(method, False, args) + elif isinstance(arg, dns.rrset.RRset): + rrset = arg + name = rrset.name + # rrsets are also rdatasets, but they don't print the + # same and can't be stored in nodes, so convert. + rdataset = rrset.to_rdataset() + else: + raise TypeError( + f"{method} requires a name or RRset as the first argument" + ) + if rdataset.rdclass != self.manager.get_class(): + raise ValueError(f"{method} has objects of wrong RdataClass") + if rdataset.rdtype == dns.rdatatype.SOA: + (_, _, origin) = self._origin_information() + if name != origin: + raise ValueError(f"{method} has non-origin SOA") + self._raise_if_not_empty(method, args) + if not replace: + existing = self._get_rdataset(name, rdataset.rdtype, rdataset.covers) + if existing is not None: + if isinstance(existing, dns.rdataset.ImmutableRdataset): + trds = dns.rdataset.Rdataset( + existing.rdclass, existing.rdtype, existing.covers + ) + trds.update(existing) + existing = trds + rdataset = existing.union(rdataset) + self._checked_put_rdataset(name, rdataset) + except IndexError: + raise TypeError(f"not enough parameters to {method}") + + def _delete(self, exact, args): + try: + args = collections.deque(args) + if exact: + method = "delete_exact()" + else: + method = "delete()" + arg = args.popleft() + if isinstance(arg, str): + arg = dns.name.from_text(arg, None) + if isinstance(arg, dns.name.Name): + name = arg + if len(args) > 0 and ( + isinstance(args[0], int) or isinstance(args[0], str) + ): + # deleting by type and (optionally) covers + rdtype = dns.rdatatype.RdataType.make(args.popleft()) + if len(args) > 0: + covers = dns.rdatatype.RdataType.make(args.popleft()) + else: + covers = dns.rdatatype.NONE + self._raise_if_not_empty(method, args) + existing = self._get_rdataset(name, rdtype, covers) + if existing is None: + if exact: + raise DeleteNotExact(f"{method}: missing rdataset") + else: + self._delete_rdataset(name, rdtype, covers) + return + else: + rdataset = self._rdataset_from_args(method, True, args) + elif isinstance(arg, dns.rrset.RRset): + rdataset = arg # rrsets are also rdatasets + name = rdataset.name + else: + raise TypeError( + f"{method} requires a name or RRset as the first argument" + ) + self._raise_if_not_empty(method, args) + if rdataset: + if rdataset.rdclass != self.manager.get_class(): + raise ValueError(f"{method} has objects of wrong RdataClass") + existing = self._get_rdataset(name, rdataset.rdtype, rdataset.covers) + if existing is not None: + if exact: + intersection = existing.intersection(rdataset) + if intersection != rdataset: + raise DeleteNotExact(f"{method}: missing rdatas") + rdataset = existing.difference(rdataset) + if len(rdataset) == 0: + self._checked_delete_rdataset( + name, rdataset.rdtype, rdataset.covers + ) + else: + self._checked_put_rdataset(name, rdataset) + elif exact: + raise DeleteNotExact(f"{method}: missing rdataset") + else: + if exact and not self._name_exists(name): + raise DeleteNotExact(f"{method}: name not known") + self._checked_delete_name(name) + except IndexError: + raise TypeError(f"not enough parameters to {method}") + + def _check_ended(self): + if self._ended: + raise AlreadyEnded + + def _end(self, commit): + self._check_ended() + if self._ended: + raise AlreadyEnded + try: + self._end_transaction(commit) + finally: + self._ended = True + + def _checked_put_rdataset(self, name, rdataset): + for check in self._check_put_rdataset: + check(self, name, rdataset) + self._put_rdataset(name, rdataset) + + def _checked_delete_rdataset(self, name, rdtype, covers): + for check in self._check_delete_rdataset: + check(self, name, rdtype, covers) + self._delete_rdataset(name, rdtype, covers) + + def _checked_delete_name(self, name): + for check in self._check_delete_name: + check(self, name) + self._delete_name(name) + + # + # Transactions are context managers. + # + + def __enter__(self): + return self + + def __exit__(self, exc_type, exc_val, exc_tb): + if not self._ended: + if exc_type is None: + self.commit() + else: + self.rollback() + return False + + # + # This is the low level API, which must be implemented by subclasses + # of Transaction. + # + + def _get_rdataset(self, name, rdtype, covers): + """Return the rdataset associated with *name*, *rdtype*, and *covers*, + or `None` if not found. + """ + raise NotImplementedError # pragma: no cover + + def _put_rdataset(self, name, rdataset): + """Store the rdataset.""" + raise NotImplementedError # pragma: no cover + + def _delete_name(self, name): + """Delete all data associated with *name*. + + It is not an error if the name does not exist. + """ + raise NotImplementedError # pragma: no cover + + def _delete_rdataset(self, name, rdtype, covers): + """Delete all data associated with *name*, *rdtype*, and *covers*. + + It is not an error if the rdataset does not exist. + """ + raise NotImplementedError # pragma: no cover + + def _name_exists(self, name): + """Does name exist? + + Returns a bool. + """ + raise NotImplementedError # pragma: no cover + + def _changed(self): + """Has this transaction changed anything?""" + raise NotImplementedError # pragma: no cover + + def _end_transaction(self, commit): + """End the transaction. + + *commit*, a bool. If ``True``, commit the transaction, otherwise + roll it back. + + If committing and the commit fails, then roll back and raise an + exception. + """ + raise NotImplementedError # pragma: no cover + + def _set_origin(self, origin): + """Set the origin. + + This method is called when reading a possibly relativized + source, and an origin setting operation occurs (e.g. $ORIGIN + in a zone file). + """ + raise NotImplementedError # pragma: no cover + + def _iterate_rdatasets(self): + """Return an iterator that yields (name, rdataset) tuples.""" + raise NotImplementedError # pragma: no cover + + def _iterate_names(self): + """Return an iterator that yields a name.""" + raise NotImplementedError # pragma: no cover + + def _get_node(self, name): + """Return the node at *name*, if any. + + Returns a node or ``None``. + """ + raise NotImplementedError # pragma: no cover + + # + # Low-level API with a default implementation, in case a subclass needs + # to override. + # + + def _origin_information(self): + # This is only used by _add() + return self.manager.origin_information() diff --git a/.venv/lib/python3.12/site-packages/dns/tsig.py b/.venv/lib/python3.12/site-packages/dns/tsig.py new file mode 100644 index 0000000..780852e --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/tsig.py @@ -0,0 +1,352 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2001-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""DNS TSIG support.""" + +import base64 +import hashlib +import hmac +import struct + +import dns.exception +import dns.name +import dns.rcode +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""" + + +# TSIG Algorithms + +HMAC_MD5 = dns.name.from_text("HMAC-MD5.SIG-ALG.REG.INT") +HMAC_SHA1 = dns.name.from_text("hmac-sha1") +HMAC_SHA224 = dns.name.from_text("hmac-sha224") +HMAC_SHA256 = dns.name.from_text("hmac-sha256") +HMAC_SHA256_128 = dns.name.from_text("hmac-sha256-128") +HMAC_SHA384 = dns.name.from_text("hmac-sha384") +HMAC_SHA384_192 = dns.name.from_text("hmac-sha384-192") +HMAC_SHA512 = dns.name.from_text("hmac-sha512") +HMAC_SHA512_256 = dns.name.from_text("hmac-sha512-256") +GSS_TSIG = dns.name.from_text("gss-tsig") + +default_algorithm = HMAC_SHA256 + +mac_sizes = { + HMAC_SHA1: 20, + HMAC_SHA224: 28, + HMAC_SHA256: 32, + HMAC_SHA256_128: 16, + HMAC_SHA384: 48, + HMAC_SHA384_192: 24, + HMAC_SHA512: 64, + HMAC_SHA512_256: 32, + HMAC_MD5: 16, + GSS_TSIG: 128, # This is what we assume to be the worst case! +} + + +class GSSTSig: + """ + GSS-TSIG TSIG implementation. This uses the GSS-API context established + in the TKEY message handshake to sign messages using GSS-API message + integrity codes, per the RFC. + + In order to avoid a direct GSSAPI dependency, the keyring holds a ref + to the GSSAPI object required, rather than the key itself. + """ + + def __init__(self, gssapi_context): + self.gssapi_context = gssapi_context + self.data = b"" + self.name = "gss-tsig" + + def update(self, data): + self.data += data + + def sign(self): + # defer to the GSSAPI function to sign + return self.gssapi_context.get_signature(self.data) + + def verify(self, expected): + try: + # defer to the GSSAPI function to verify + return self.gssapi_context.verify_signature(self.data, expected) + except Exception: + # note the usage of a bare exception + raise BadSignature + + +class GSSTSigAdapter: + def __init__(self, keyring): + self.keyring = keyring + + def __call__(self, message, keyname): + if keyname in self.keyring: + key = self.keyring[keyname] + if isinstance(key, Key) and key.algorithm == GSS_TSIG: + if message: + GSSTSigAdapter.parse_tkey_and_step(key, message, keyname) + return key + else: + return None + + @classmethod + def parse_tkey_and_step(cls, key, message, keyname): + # if the message is a TKEY type, absorb the key material + # into the context using step(); this is used to allow the + # client to complete the GSSAPI negotiation before attempting + # to verify the signed response to a TKEY message exchange + try: + rrset = message.find_rrset( + message.answer, keyname, dns.rdataclass.ANY, dns.rdatatype.TKEY + ) + if rrset: + token = rrset[0].key + gssapi_context = key.secret + return gssapi_context.step(token) + except KeyError: + pass + + +class HMACTSig: + """ + HMAC TSIG implementation. This uses the HMAC python module to handle the + sign/verify operations. + """ + + _hashes = { + HMAC_SHA1: hashlib.sha1, + HMAC_SHA224: hashlib.sha224, + HMAC_SHA256: hashlib.sha256, + HMAC_SHA256_128: (hashlib.sha256, 128), + HMAC_SHA384: hashlib.sha384, + HMAC_SHA384_192: (hashlib.sha384, 192), + HMAC_SHA512: hashlib.sha512, + HMAC_SHA512_256: (hashlib.sha512, 256), + HMAC_MD5: hashlib.md5, + } + + def __init__(self, key, algorithm): + try: + hashinfo = self._hashes[algorithm] + except KeyError: + raise NotImplementedError(f"TSIG algorithm {algorithm} is not supported") + + # create the HMAC context + if isinstance(hashinfo, tuple): + self.hmac_context = hmac.new(key, digestmod=hashinfo[0]) + self.size = hashinfo[1] + else: + self.hmac_context = hmac.new(key, digestmod=hashinfo) + self.size = None + self.name = self.hmac_context.name + if self.size: + self.name += f"-{self.size}" + + def update(self, data): + return self.hmac_context.update(data) + + def sign(self): + # defer to the HMAC digest() function for that digestmod + digest = self.hmac_context.digest() + if self.size: + digest = digest[: (self.size // 8)] + return digest + + def verify(self, expected): + # re-digest and compare the results + mac = self.sign() + if not hmac.compare_digest(mac, expected): + raise BadSignature + + +def _digest(wire, key, rdata, time=None, request_mac=None, ctx=None, multi=None): + """Return a context containing the TSIG rdata for the input parameters + @rtype: dns.tsig.HMACTSig or dns.tsig.GSSTSig object + @raises ValueError: I{other_data} is too long + @raises NotImplementedError: I{algorithm} is not supported + """ + + first = not (ctx and multi) + if first: + ctx = get_context(key) + if request_mac: + ctx.update(struct.pack("!H", len(request_mac))) + ctx.update(request_mac) + ctx.update(struct.pack("!H", rdata.original_id)) + ctx.update(wire[2:]) + if first: + ctx.update(key.name.to_digestable()) + ctx.update(struct.pack("!H", dns.rdataclass.ANY)) + ctx.update(struct.pack("!I", 0)) + if time is None: + time = rdata.time_signed + upper_time = (time >> 32) & 0xFFFF + lower_time = time & 0xFFFFFFFF + time_encoded = struct.pack("!HIH", upper_time, lower_time, rdata.fudge) + other_len = len(rdata.other) + if other_len > 65535: + raise ValueError("TSIG Other Data is > 65535 bytes") + if first: + ctx.update(key.algorithm.to_digestable() + time_encoded) + ctx.update(struct.pack("!HH", rdata.error, other_len) + rdata.other) + else: + ctx.update(time_encoded) + return ctx + + +def _maybe_start_digest(key, mac, multi): + """If this is the first message in a multi-message sequence, + start a new context. + @rtype: dns.tsig.HMACTSig or dns.tsig.GSSTSig object + """ + if multi: + ctx = get_context(key) + ctx.update(struct.pack("!H", len(mac))) + ctx.update(mac) + return ctx + else: + return None + + +def sign(wire, key, rdata, time=None, request_mac=None, ctx=None, multi=False): + """Return a (tsig_rdata, mac, ctx) tuple containing the HMAC TSIG rdata + for the input parameters, the HMAC MAC calculated by applying the + TSIG signature algorithm, and the TSIG digest context. + @rtype: (string, dns.tsig.HMACTSig or dns.tsig.GSSTSig object) + @raises ValueError: I{other_data} is too long + @raises NotImplementedError: I{algorithm} is not supported + """ + + ctx = _digest(wire, key, rdata, time, request_mac, ctx, multi) + mac = ctx.sign() + tsig = rdata.replace(time_signed=time, mac=mac) + + return (tsig, _maybe_start_digest(key, mac, multi)) + + +def validate( + wire, key, owner, rdata, now, request_mac, tsig_start, ctx=None, multi=False +): + """Validate the specified TSIG rdata against the other input parameters. + + @raises FormError: The TSIG is badly formed. + @raises BadTime: There is too much time skew between the client and the + server. + @raises BadSignature: The TSIG signature did not validate + @rtype: dns.tsig.HMACTSig or dns.tsig.GSSTSig object""" + + (adcount,) = struct.unpack("!H", wire[10:12]) + if adcount == 0: + raise dns.exception.FormError + adcount -= 1 + new_wire = wire[0:10] + struct.pack("!H", adcount) + wire[12:tsig_start] + if rdata.error != 0: + if rdata.error == dns.rcode.BADSIG: + raise PeerBadSignature + elif rdata.error == dns.rcode.BADKEY: + raise PeerBadKey + elif rdata.error == dns.rcode.BADTIME: + raise PeerBadTime + elif rdata.error == dns.rcode.BADTRUNC: + raise PeerBadTruncation + else: + raise PeerError("unknown TSIG error code %d" % rdata.error) + if abs(rdata.time_signed - now) > rdata.fudge: + raise BadTime + if key.name != owner: + raise BadKey + if key.algorithm != rdata.algorithm: + raise BadAlgorithm + ctx = _digest(new_wire, key, rdata, None, request_mac, ctx, multi) + ctx.verify(rdata.mac) + return _maybe_start_digest(key, rdata.mac, multi) + + +def get_context(key): + """Returns an HMAC context for the specified key. + + @rtype: HMAC context + @raises NotImplementedError: I{algorithm} is not supported + """ + + if key.algorithm == GSS_TSIG: + return GSSTSig(key.secret) + else: + return HMACTSig(key.secret, key.algorithm) + + +class Key: + def __init__(self, name, secret, algorithm=default_algorithm): + if isinstance(name, str): + name = dns.name.from_text(name) + self.name = name + if isinstance(secret, str): + secret = base64.decodebytes(secret.encode()) + self.secret = secret + if isinstance(algorithm, str): + algorithm = dns.name.from_text(algorithm) + self.algorithm = algorithm + + def __eq__(self, other): + return ( + isinstance(other, Key) + and self.name == other.name + and self.secret == other.secret + and self.algorithm == other.algorithm + ) + + def __repr__(self): + r = f" Dict[dns.name.Name, dns.tsig.Key]: + """Convert a dictionary containing (textual DNS name, base64 secret) + pairs into a binary keyring which has (dns.name.Name, bytes) pairs, or + a dictionary containing (textual DNS name, (algorithm, base64 secret)) + pairs into a binary keyring which has (dns.name.Name, dns.tsig.Key) pairs. + @rtype: dict""" + + keyring = {} + for name, value in textring.items(): + kname = dns.name.from_text(name) + if isinstance(value, str): + keyring[kname] = dns.tsig.Key(kname, value).secret + else: + (algorithm, secret) = value + keyring[kname] = dns.tsig.Key(kname, secret, algorithm) + return keyring + + +def to_text(keyring: Dict[dns.name.Name, Any]) -> Dict[str, Any]: + """Convert a dictionary containing (dns.name.Name, dns.tsig.Key) pairs + into a text keyring which has (textual DNS name, (textual algorithm, + base64 secret)) pairs, or a dictionary containing (dns.name.Name, bytes) + pairs into a text keyring which has (textual DNS name, base64 secret) pairs. + @rtype: dict""" + + textring = {} + + def b64encode(secret): + return base64.encodebytes(secret).decode().rstrip() + + for name, key in keyring.items(): + tname = name.to_text() + if isinstance(key, bytes): + textring[tname] = b64encode(key) + else: + if isinstance(key.secret, bytes): + text_secret = b64encode(key.secret) + else: + text_secret = str(key.secret) + + textring[tname] = (key.algorithm.to_text(), text_secret) + return textring diff --git a/.venv/lib/python3.12/site-packages/dns/ttl.py b/.venv/lib/python3.12/site-packages/dns/ttl.py new file mode 100644 index 0000000..264b033 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/ttl.py @@ -0,0 +1,92 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2017 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""DNS TTL conversion.""" + +from typing import Union + +import dns.exception + +# Technically TTLs are supposed to be between 0 and 2**31 - 1, with values +# greater than that interpreted as 0, but we do not impose this policy here +# as values > 2**31 - 1 occur in real world data. +# +# We leave it to applications to impose tighter bounds if desired. +MAX_TTL = 2**32 - 1 + + +class BadTTL(dns.exception.SyntaxError): + """DNS TTL value is not well-formed.""" + + +def from_text(text: str) -> int: + """Convert the text form of a TTL to an integer. + + The BIND 8 units syntax for TTLs (e.g. '1w6d4h3m10s') is supported. + + *text*, a ``str``, the textual TTL. + + Raises ``dns.ttl.BadTTL`` if the TTL is not well-formed. + + Returns an ``int``. + """ + + if text.isdigit(): + total = int(text) + elif len(text) == 0: + raise BadTTL + else: + total = 0 + current = 0 + need_digit = True + for c in text: + if c.isdigit(): + current *= 10 + current += int(c) + need_digit = False + else: + if need_digit: + raise BadTTL + c = c.lower() + if c == "w": + total += current * 604800 + elif c == "d": + total += current * 86400 + elif c == "h": + total += current * 3600 + elif c == "m": + total += current * 60 + elif c == "s": + total += current + else: + raise BadTTL("unknown unit '%s'" % c) + current = 0 + need_digit = True + if not current == 0: + raise BadTTL("trailing integer") + if total < 0 or total > MAX_TTL: + raise BadTTL("TTL should be between 0 and 2**32 - 1 (inclusive)") + return total + + +def make(value: Union[int, str]) -> int: + if isinstance(value, int): + return value + elif isinstance(value, str): + return dns.ttl.from_text(value) + else: + raise ValueError("cannot convert value to TTL") diff --git a/.venv/lib/python3.12/site-packages/dns/update.py b/.venv/lib/python3.12/site-packages/dns/update.py new file mode 100644 index 0000000..bf1157a --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/update.py @@ -0,0 +1,386 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""DNS Dynamic Update Support""" + +from typing import Any, List, Optional, Union + +import dns.message +import dns.name +import dns.opcode +import dns.rdata +import dns.rdataclass +import dns.rdataset +import dns.rdatatype +import dns.tsig + + +class UpdateSection(dns.enum.IntEnum): + """Update sections""" + + ZONE = 0 + PREREQ = 1 + UPDATE = 2 + ADDITIONAL = 3 + + @classmethod + def _maximum(cls): + return 3 + + +class UpdateMessage(dns.message.Message): # lgtm[py/missing-equals] + # ignore the mypy error here as we mean to use a different enum + _section_enum = UpdateSection # type: ignore + + def __init__( + self, + zone: Optional[Union[dns.name.Name, str]] = None, + rdclass: dns.rdataclass.RdataClass = dns.rdataclass.IN, + keyring: Optional[Any] = None, + keyname: Optional[dns.name.Name] = None, + keyalgorithm: Union[dns.name.Name, str] = dns.tsig.default_algorithm, + id: Optional[int] = None, + ): + """Initialize a new DNS Update object. + + See the documentation of the Message class for a complete + description of the keyring dictionary. + + *zone*, a ``dns.name.Name``, ``str``, or ``None``, the zone + which is being updated. ``None`` should only be used by dnspython's + message constructors, as a zone is required for the convenience + methods like ``add()``, ``replace()``, etc. + + *rdclass*, an ``int`` or ``str``, the class of the zone. + + The *keyring*, *keyname*, and *keyalgorithm* parameters are passed to + ``use_tsig()``; see its documentation for details. + """ + super().__init__(id=id) + self.flags |= dns.opcode.to_flags(dns.opcode.UPDATE) + if isinstance(zone, str): + zone = dns.name.from_text(zone) + self.origin = zone + rdclass = dns.rdataclass.RdataClass.make(rdclass) + self.zone_rdclass = rdclass + if self.origin: + self.find_rrset( + self.zone, + self.origin, + rdclass, + dns.rdatatype.SOA, + create=True, + force_unique=True, + ) + if keyring is not None: + self.use_tsig(keyring, keyname, algorithm=keyalgorithm) + + @property + def zone(self) -> List[dns.rrset.RRset]: + """The zone section.""" + return self.sections[0] + + @zone.setter + def zone(self, v): + self.sections[0] = v + + @property + def prerequisite(self) -> List[dns.rrset.RRset]: + """The prerequisite section.""" + return self.sections[1] + + @prerequisite.setter + def prerequisite(self, v): + self.sections[1] = v + + @property + def update(self) -> List[dns.rrset.RRset]: + """The update section.""" + return self.sections[2] + + @update.setter + def update(self, v): + self.sections[2] = v + + def _add_rr(self, name, ttl, rd, deleting=None, section=None): + """Add a single RR to the update section.""" + + if section is None: + section = self.update + covers = rd.covers() + rrset = self.find_rrset( + section, name, self.zone_rdclass, rd.rdtype, covers, deleting, True, True + ) + rrset.add(rd, ttl) + + def _add(self, replace, section, name, *args): + """Add records. + + *replace* is the replacement mode. If ``False``, + RRs are added to an existing RRset; if ``True``, the RRset + is replaced with the specified contents. The second + argument is the section to add to. The third argument + is always a name. The other arguments can be: + + - rdataset... + + - ttl, rdata... + + - ttl, rdtype, string... + """ + + if isinstance(name, str): + name = dns.name.from_text(name, None) + if isinstance(args[0], dns.rdataset.Rdataset): + for rds in args: + if replace: + self.delete(name, rds.rdtype) + for rd in rds: + self._add_rr(name, rds.ttl, rd, section=section) + else: + args = list(args) + ttl = int(args.pop(0)) + if isinstance(args[0], dns.rdata.Rdata): + if replace: + self.delete(name, args[0].rdtype) + for rd in args: + self._add_rr(name, ttl, rd, section=section) + else: + rdtype = dns.rdatatype.RdataType.make(args.pop(0)) + if replace: + self.delete(name, rdtype) + for s in args: + rd = dns.rdata.from_text(self.zone_rdclass, rdtype, s, self.origin) + self._add_rr(name, ttl, rd, section=section) + + def add(self, name: Union[dns.name.Name, str], *args: Any) -> None: + """Add records. + + The first argument is always a name. The other + arguments can be: + + - rdataset... + + - ttl, rdata... + + - ttl, rdtype, string... + """ + + self._add(False, self.update, name, *args) + + def delete(self, name: Union[dns.name.Name, str], *args: Any) -> None: + """Delete records. + + The first argument is always a name. The other + arguments can be: + + - *empty* + + - rdataset... + + - rdata... + + - rdtype, [string...] + """ + + if isinstance(name, str): + name = dns.name.from_text(name, None) + if len(args) == 0: + self.find_rrset( + self.update, + name, + dns.rdataclass.ANY, + dns.rdatatype.ANY, + dns.rdatatype.NONE, + dns.rdataclass.ANY, + True, + True, + ) + elif isinstance(args[0], dns.rdataset.Rdataset): + for rds in args: + for rd in rds: + self._add_rr(name, 0, rd, dns.rdataclass.NONE) + else: + largs = list(args) + if isinstance(largs[0], dns.rdata.Rdata): + for rd in largs: + self._add_rr(name, 0, rd, dns.rdataclass.NONE) + else: + rdtype = dns.rdatatype.RdataType.make(largs.pop(0)) + if len(largs) == 0: + self.find_rrset( + self.update, + name, + self.zone_rdclass, + rdtype, + dns.rdatatype.NONE, + dns.rdataclass.ANY, + True, + True, + ) + else: + for s in largs: + rd = dns.rdata.from_text( + self.zone_rdclass, + rdtype, + s, # type: ignore[arg-type] + self.origin, + ) + self._add_rr(name, 0, rd, dns.rdataclass.NONE) + + def replace(self, name: Union[dns.name.Name, str], *args: Any) -> None: + """Replace records. + + The first argument is always a name. The other + arguments can be: + + - rdataset... + + - ttl, rdata... + + - ttl, rdtype, string... + + Note that if you want to replace the entire node, you should do + a delete of the name followed by one or more calls to add. + """ + + self._add(True, self.update, name, *args) + + def present(self, name: Union[dns.name.Name, str], *args: Any) -> None: + """Require that an owner name (and optionally an rdata type, + or specific rdataset) exists as a prerequisite to the + execution of the update. + + The first argument is always a name. + The other arguments can be: + + - rdataset... + + - rdata... + + - rdtype, string... + """ + + if isinstance(name, str): + name = dns.name.from_text(name, None) + if len(args) == 0: + self.find_rrset( + self.prerequisite, + name, + dns.rdataclass.ANY, + dns.rdatatype.ANY, + dns.rdatatype.NONE, + None, + True, + True, + ) + elif ( + isinstance(args[0], dns.rdataset.Rdataset) + or isinstance(args[0], dns.rdata.Rdata) + or len(args) > 1 + ): + if not isinstance(args[0], dns.rdataset.Rdataset): + # Add a 0 TTL + largs = list(args) + largs.insert(0, 0) # type: ignore[arg-type] + self._add(False, self.prerequisite, name, *largs) + else: + self._add(False, self.prerequisite, name, *args) + else: + rdtype = dns.rdatatype.RdataType.make(args[0]) + self.find_rrset( + self.prerequisite, + name, + dns.rdataclass.ANY, + rdtype, + dns.rdatatype.NONE, + None, + True, + True, + ) + + def absent( + self, + name: Union[dns.name.Name, str], + rdtype: Optional[Union[dns.rdatatype.RdataType, str]] = None, + ) -> None: + """Require that an owner name (and optionally an rdata type) does + not exist as a prerequisite to the execution of the update.""" + + if isinstance(name, str): + name = dns.name.from_text(name, None) + if rdtype is None: + self.find_rrset( + self.prerequisite, + name, + dns.rdataclass.NONE, + dns.rdatatype.ANY, + dns.rdatatype.NONE, + None, + True, + True, + ) + else: + rdtype = dns.rdatatype.RdataType.make(rdtype) + self.find_rrset( + self.prerequisite, + name, + dns.rdataclass.NONE, + rdtype, + dns.rdatatype.NONE, + None, + True, + True, + ) + + def _get_one_rr_per_rrset(self, value): + # Updates are always one_rr_per_rrset + return True + + def _parse_rr_header(self, section, name, rdclass, rdtype): + deleting = None + empty = False + if section == UpdateSection.ZONE: + if ( + dns.rdataclass.is_metaclass(rdclass) + or rdtype != dns.rdatatype.SOA + or self.zone + ): + raise dns.exception.FormError + else: + if not self.zone: + raise dns.exception.FormError + if rdclass in (dns.rdataclass.ANY, dns.rdataclass.NONE): + deleting = rdclass + rdclass = self.zone[0].rdclass + empty = ( + deleting == dns.rdataclass.ANY or section == UpdateSection.PREREQ + ) + return (rdclass, rdtype, deleting, empty) + + +# backwards compatibility +Update = UpdateMessage + +### BEGIN generated UpdateSection constants + +ZONE = UpdateSection.ZONE +PREREQ = UpdateSection.PREREQ +UPDATE = UpdateSection.UPDATE +ADDITIONAL = UpdateSection.ADDITIONAL + +### END generated UpdateSection constants diff --git a/.venv/lib/python3.12/site-packages/dns/version.py b/.venv/lib/python3.12/site-packages/dns/version.py new file mode 100644 index 0000000..251f258 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/version.py @@ -0,0 +1,58 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2017 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""dnspython release version information.""" + +#: MAJOR +MAJOR = 2 +#: MINOR +MINOR = 6 +#: MICRO +MICRO = 1 +#: RELEASELEVEL +RELEASELEVEL = 0x0F +#: SERIAL +SERIAL = 0 + +if RELEASELEVEL == 0x0F: # pragma: no cover lgtm[py/unreachable-statement] + #: version + version = "%d.%d.%d" % (MAJOR, MINOR, MICRO) # lgtm[py/unreachable-statement] +elif RELEASELEVEL == 0x00: # pragma: no cover lgtm[py/unreachable-statement] + version = "%d.%d.%ddev%d" % ( + MAJOR, + MINOR, + MICRO, + SERIAL, + ) # lgtm[py/unreachable-statement] +elif RELEASELEVEL == 0x0C: # pragma: no cover lgtm[py/unreachable-statement] + version = "%d.%d.%drc%d" % ( + MAJOR, + MINOR, + MICRO, + SERIAL, + ) # lgtm[py/unreachable-statement] +else: # pragma: no cover lgtm[py/unreachable-statement] + version = "%d.%d.%d%x%d" % ( + MAJOR, + MINOR, + MICRO, + RELEASELEVEL, + SERIAL, + ) # lgtm[py/unreachable-statement] + +#: hexversion +hexversion = MAJOR << 24 | MINOR << 16 | MICRO << 8 | RELEASELEVEL << 4 | SERIAL diff --git a/.venv/lib/python3.12/site-packages/dns/versioned.py b/.venv/lib/python3.12/site-packages/dns/versioned.py new file mode 100644 index 0000000..fd78e67 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/versioned.py @@ -0,0 +1,318 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +"""DNS Versioned Zones.""" + +import collections +import threading +from typing import Callable, Deque, Optional, Set, Union + +import dns.exception +import dns.immutable +import dns.name +import dns.node +import dns.rdataclass +import dns.rdataset +import dns.rdatatype +import dns.rdtypes.ANY.SOA +import dns.zone + + +class UseTransaction(dns.exception.DNSException): + """To alter a versioned zone, use a transaction.""" + + +# Backwards compatibility +Node = dns.zone.VersionedNode +ImmutableNode = dns.zone.ImmutableVersionedNode +Version = dns.zone.Version +WritableVersion = dns.zone.WritableVersion +ImmutableVersion = dns.zone.ImmutableVersion +Transaction = dns.zone.Transaction + + +class Zone(dns.zone.Zone): # lgtm[py/missing-equals] + __slots__ = [ + "_versions", + "_versions_lock", + "_write_txn", + "_write_waiters", + "_write_event", + "_pruning_policy", + "_readers", + ] + + node_factory = Node + + def __init__( + self, + origin: Optional[Union[dns.name.Name, str]], + rdclass: dns.rdataclass.RdataClass = dns.rdataclass.IN, + relativize: bool = True, + pruning_policy: Optional[Callable[["Zone", Version], Optional[bool]]] = None, + ): + """Initialize a versioned zone object. + + *origin* is the origin of the zone. It may be a ``dns.name.Name``, + a ``str``, or ``None``. If ``None``, then the zone's origin will + be set by the first ``$ORIGIN`` line in a zone file. + + *rdclass*, an ``int``, the zone's rdata class; the default is class IN. + + *relativize*, a ``bool``, determine's whether domain names are + relativized to the zone's origin. The default is ``True``. + + *pruning policy*, a function taking a ``Zone`` and a ``Version`` and returning + a ``bool``, or ``None``. Should the version be pruned? If ``None``, + the default policy, which retains one version is used. + """ + super().__init__(origin, rdclass, relativize) + self._versions: Deque[Version] = collections.deque() + self._version_lock = threading.Lock() + if pruning_policy is None: + self._pruning_policy = self._default_pruning_policy + else: + self._pruning_policy = pruning_policy + self._write_txn: Optional[Transaction] = None + self._write_event: Optional[threading.Event] = None + self._write_waiters: Deque[threading.Event] = collections.deque() + self._readers: Set[Transaction] = set() + self._commit_version_unlocked( + None, WritableVersion(self, replacement=True), origin + ) + + def reader( + self, id: Optional[int] = None, serial: Optional[int] = None + ) -> Transaction: # pylint: disable=arguments-differ + if id is not None and serial is not None: + raise ValueError("cannot specify both id and serial") + with self._version_lock: + if id is not None: + version = None + for v in reversed(self._versions): + if v.id == id: + version = v + break + if version is None: + raise KeyError("version not found") + elif serial is not None: + if self.relativize: + oname = dns.name.empty + else: + assert self.origin is not None + oname = self.origin + version = None + for v in reversed(self._versions): + n = v.nodes.get(oname) + if n: + rds = n.get_rdataset(self.rdclass, dns.rdatatype.SOA) + if rds and rds[0].serial == serial: + version = v + break + if version is None: + raise KeyError("serial not found") + else: + version = self._versions[-1] + txn = Transaction(self, False, version) + self._readers.add(txn) + return txn + + def writer(self, replacement: bool = False) -> Transaction: + event = None + while True: + with self._version_lock: + # Checking event == self._write_event ensures that either + # no one was waiting before we got lucky and found no write + # txn, or we were the one who was waiting and got woken up. + # This prevents "taking cuts" when creating a write txn. + if self._write_txn is None and event == self._write_event: + # Creating the transaction defers version setup + # (i.e. copying the nodes dictionary) until we + # give up the lock, so that we hold the lock as + # short a time as possible. This is why we call + # _setup_version() below. + self._write_txn = Transaction( + self, replacement, make_immutable=True + ) + # give up our exclusive right to make a Transaction + self._write_event = None + break + # Someone else is writing already, so we will have to + # wait, but we want to do the actual wait outside the + # lock. + event = threading.Event() + self._write_waiters.append(event) + # wait (note we gave up the lock!) + # + # We only wake one sleeper at a time, so it's important + # that no event waiter can exit this method (e.g. via + # cancellation) without returning a transaction or waking + # someone else up. + # + # This is not a problem with Threading module threads as + # they cannot be canceled, but could be an issue with trio + # tasks when we do the async version of writer(). + # I.e. we'd need to do something like: + # + # try: + # event.wait() + # except trio.Cancelled: + # with self._version_lock: + # self._maybe_wakeup_one_waiter_unlocked() + # raise + # + event.wait() + # Do the deferred version setup. + self._write_txn._setup_version() + return self._write_txn + + def _maybe_wakeup_one_waiter_unlocked(self): + if len(self._write_waiters) > 0: + self._write_event = self._write_waiters.popleft() + self._write_event.set() + + # pylint: disable=unused-argument + def _default_pruning_policy(self, zone, version): + return True + + # pylint: enable=unused-argument + + def _prune_versions_unlocked(self): + assert len(self._versions) > 0 + # Don't ever prune a version greater than or equal to one that + # a reader has open. This pins versions in memory while the + # reader is open, and importantly lets the reader open a txn on + # a successor version (e.g. if generating an IXFR). + # + # Note our definition of least_kept also ensures we do not try to + # delete the greatest version. + if len(self._readers) > 0: + least_kept = min(txn.version.id for txn in self._readers) + else: + least_kept = self._versions[-1].id + while self._versions[0].id < least_kept and self._pruning_policy( + self, self._versions[0] + ): + self._versions.popleft() + + def set_max_versions(self, max_versions: Optional[int]) -> None: + """Set a pruning policy that retains up to the specified number + of versions + """ + if max_versions is not None and max_versions < 1: + raise ValueError("max versions must be at least 1") + if max_versions is None: + + def policy(zone, _): # pylint: disable=unused-argument + return False + + else: + + def policy(zone, _): + return len(zone._versions) > max_versions + + self.set_pruning_policy(policy) + + def set_pruning_policy( + self, policy: Optional[Callable[["Zone", Version], Optional[bool]]] + ) -> None: + """Set the pruning policy for the zone. + + The *policy* function takes a `Version` and returns `True` if + the version should be pruned, and `False` otherwise. `None` + may also be specified for policy, in which case the default policy + is used. + + Pruning checking proceeds from the least version and the first + time the function returns `False`, the checking stops. I.e. the + retained versions are always a consecutive sequence. + """ + if policy is None: + policy = self._default_pruning_policy + with self._version_lock: + self._pruning_policy = policy + self._prune_versions_unlocked() + + def _end_read(self, txn): + with self._version_lock: + self._readers.remove(txn) + self._prune_versions_unlocked() + + def _end_write_unlocked(self, txn): + assert self._write_txn == txn + self._write_txn = None + self._maybe_wakeup_one_waiter_unlocked() + + def _end_write(self, txn): + with self._version_lock: + self._end_write_unlocked(txn) + + def _commit_version_unlocked(self, txn, version, origin): + self._versions.append(version) + self._prune_versions_unlocked() + self.nodes = version.nodes + if self.origin is None: + self.origin = origin + # txn can be None in __init__ when we make the empty version. + if txn is not None: + self._end_write_unlocked(txn) + + def _commit_version(self, txn, version, origin): + with self._version_lock: + self._commit_version_unlocked(txn, version, origin) + + def _get_next_version_id(self): + if len(self._versions) > 0: + id = self._versions[-1].id + 1 + else: + id = 1 + return id + + def find_node( + self, name: Union[dns.name.Name, str], create: bool = False + ) -> dns.node.Node: + if create: + raise UseTransaction + return super().find_node(name) + + def delete_node(self, name: Union[dns.name.Name, str]) -> None: + raise UseTransaction + + def find_rdataset( + self, + name: Union[dns.name.Name, str], + rdtype: Union[dns.rdatatype.RdataType, str], + covers: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.NONE, + create: bool = False, + ) -> dns.rdataset.Rdataset: + if create: + raise UseTransaction + rdataset = super().find_rdataset(name, rdtype, covers) + return dns.rdataset.ImmutableRdataset(rdataset) + + def get_rdataset( + self, + name: Union[dns.name.Name, str], + rdtype: Union[dns.rdatatype.RdataType, str], + covers: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.NONE, + create: bool = False, + ) -> Optional[dns.rdataset.Rdataset]: + if create: + raise UseTransaction + rdataset = super().get_rdataset(name, rdtype, covers) + if rdataset is not None: + return dns.rdataset.ImmutableRdataset(rdataset) + else: + return None + + def delete_rdataset( + self, + name: Union[dns.name.Name, str], + rdtype: Union[dns.rdatatype.RdataType, str], + covers: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.NONE, + ) -> None: + raise UseTransaction + + def replace_rdataset( + self, name: Union[dns.name.Name, str], replacement: dns.rdataset.Rdataset + ) -> None: + raise UseTransaction diff --git a/.venv/lib/python3.12/site-packages/dns/win32util.py b/.venv/lib/python3.12/site-packages/dns/win32util.py new file mode 100644 index 0000000..aaa7e93 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/win32util.py @@ -0,0 +1,252 @@ +import sys + +import dns._features + +if sys.platform == "win32": + from typing import Any + + import dns.name + + _prefer_wmi = True + + import winreg # pylint: disable=import-error + + # Keep pylint quiet on non-windows. + try: + WindowsError is None # pylint: disable=used-before-assignment + except KeyError: + WindowsError = Exception + + if dns._features.have("wmi"): + import threading + + import pythoncom # pylint: disable=import-error + import wmi # pylint: disable=import-error + + _have_wmi = True + else: + _have_wmi = False + + def _config_domain(domain): + # Sometimes DHCP servers add a '.' prefix to the default domain, and + # Windows just stores such values in the registry (see #687). + # Check for this and fix it. + if domain.startswith("."): + domain = domain[1:] + return dns.name.from_text(domain) + + class DnsInfo: + def __init__(self): + self.domain = None + self.nameservers = [] + self.search = [] + + if _have_wmi: + + class _WMIGetter(threading.Thread): + def __init__(self): + super().__init__() + self.info = DnsInfo() + + def run(self): + pythoncom.CoInitialize() + try: + system = wmi.WMI() + for interface in system.Win32_NetworkAdapterConfiguration(): + 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) + for x in interface.DNSDomainSuffixSearchOrder + ] + break + finally: + pythoncom.CoUninitialize() + + def get(self): + # We always run in a separate thread to avoid any issues with + # the COM threading model. + self.start() + self.join() + return self.info + + else: + + class _WMIGetter: # type: ignore + pass + + class _RegistryGetter: + def __init__(self): + self.info = DnsInfo() + + def _determine_split_char(self, entry): + # + # The windows registry irritatingly changes the list element + # delimiter in between ' ' and ',' (and vice-versa) in various + # versions of windows. + # + if entry.find(" ") >= 0: + split_char = " " + elif entry.find(",") >= 0: + split_char = "," + else: + # probably a singleton; treat as a space-separated list. + split_char = " " + return split_char + + def _config_nameservers(self, nameservers): + split_char = self._determine_split_char(nameservers) + ns_list = nameservers.split(split_char) + for ns in ns_list: + if ns not in self.info.nameservers: + self.info.nameservers.append(ns) + + def _config_search(self, search): + split_char = self._determine_split_char(search) + search_list = search.split(split_char) + for s in search_list: + s = _config_domain(s) + if s not in self.info.search: + self.info.search.append(s) + + def _config_fromkey(self, key, always_try_domain): + try: + servers, _ = winreg.QueryValueEx(key, "NameServer") + except WindowsError: + servers = None + if servers: + self._config_nameservers(servers) + if servers or always_try_domain: + try: + dom, _ = winreg.QueryValueEx(key, "Domain") + if dom: + self.info.domain = _config_domain(dom) + except WindowsError: + pass + else: + try: + servers, _ = winreg.QueryValueEx(key, "DhcpNameServer") + except WindowsError: + servers = None + if servers: + self._config_nameservers(servers) + try: + dom, _ = winreg.QueryValueEx(key, "DhcpDomain") + if dom: + self.info.domain = _config_domain(dom) + except WindowsError: + pass + try: + search, _ = winreg.QueryValueEx(key, "SearchList") + except WindowsError: + search = None + if search is None: + try: + search, _ = winreg.QueryValueEx(key, "DhcpSearchList") + except WindowsError: + search = None + if search: + self._config_search(search) + + def _is_nic_enabled(self, lm, guid): + # Look in the Windows Registry to determine whether the network + # interface corresponding to the given guid is enabled. + # + # (Code contributed by Paul Marks, thanks!) + # + try: + # This hard-coded location seems to be consistent, at least + # from Windows 2000 through Vista. + connection_key = winreg.OpenKey( + lm, + r"SYSTEM\CurrentControlSet\Control\Network" + r"\{4D36E972-E325-11CE-BFC1-08002BE10318}" + r"\%s\Connection" % guid, + ) + + try: + # The PnpInstanceID points to a key inside Enum + (pnp_id, ttype) = winreg.QueryValueEx( + connection_key, "PnpInstanceID" + ) + + if ttype != winreg.REG_SZ: + raise ValueError # pragma: no cover + + device_key = winreg.OpenKey( + lm, r"SYSTEM\CurrentControlSet\Enum\%s" % pnp_id + ) + + try: + # Get ConfigFlags for this device + (flags, ttype) = winreg.QueryValueEx(device_key, "ConfigFlags") + + if ttype != winreg.REG_DWORD: + raise ValueError # pragma: no cover + + # Based on experimentation, bit 0x1 indicates that the + # device is disabled. + # + # XXXRTH I suspect we really want to & with 0x03 so + # that CONFIGFLAGS_REMOVED devices are also ignored, + # but we're shifting to WMI as ConfigFlags is not + # supposed to be used. + return not flags & 0x1 + + finally: + device_key.Close() + finally: + connection_key.Close() + except Exception: # pragma: no cover + return False + + def get(self): + """Extract resolver configuration from the Windows registry.""" + + lm = winreg.ConnectRegistry(None, winreg.HKEY_LOCAL_MACHINE) + try: + tcp_params = winreg.OpenKey( + lm, r"SYSTEM\CurrentControlSet\Services\Tcpip\Parameters" + ) + try: + self._config_fromkey(tcp_params, True) + finally: + tcp_params.Close() + interfaces = winreg.OpenKey( + lm, + r"SYSTEM\CurrentControlSet\Services\Tcpip\Parameters\Interfaces", + ) + try: + i = 0 + while True: + try: + guid = winreg.EnumKey(interfaces, i) + i += 1 + key = winreg.OpenKey(interfaces, guid) + try: + if not self._is_nic_enabled(lm, guid): + continue + self._config_fromkey(key, False) + finally: + key.Close() + except EnvironmentError: + break + finally: + interfaces.Close() + finally: + lm.Close() + return self.info + + _getter_class: Any + if _have_wmi and _prefer_wmi: + _getter_class = _WMIGetter + else: + _getter_class = _RegistryGetter + + def get_dns_info(): + """Extract resolver configuration.""" + getter = _getter_class() + return getter.get() diff --git a/.venv/lib/python3.12/site-packages/dns/wire.py b/.venv/lib/python3.12/site-packages/dns/wire.py new file mode 100644 index 0000000..9f9b157 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/wire.py @@ -0,0 +1,89 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +import contextlib +import struct +from typing import Iterator, Optional, Tuple + +import dns.exception +import dns.name + + +class Parser: + def __init__(self, wire: bytes, current: int = 0): + self.wire = wire + self.current = 0 + self.end = len(self.wire) + if current: + self.seek(current) + self.furthest = current + + def remaining(self) -> int: + return self.end - self.current + + def get_bytes(self, size: int) -> bytes: + assert size >= 0 + if size > self.remaining(): + raise dns.exception.FormError + output = self.wire[self.current : self.current + size] + self.current += size + self.furthest = max(self.furthest, self.current) + return output + + def get_counted_bytes(self, length_size: int = 1) -> bytes: + length = int.from_bytes(self.get_bytes(length_size), "big") + return self.get_bytes(length) + + def get_remaining(self) -> bytes: + return self.get_bytes(self.remaining()) + + def get_uint8(self) -> int: + return struct.unpack("!B", self.get_bytes(1))[0] + + def get_uint16(self) -> int: + return struct.unpack("!H", self.get_bytes(2))[0] + + def get_uint32(self) -> int: + return struct.unpack("!I", self.get_bytes(4))[0] + + def get_uint48(self) -> int: + return int.from_bytes(self.get_bytes(6), "big") + + def get_struct(self, format: str) -> Tuple: + return struct.unpack(format, self.get_bytes(struct.calcsize(format))) + + def get_name(self, origin: Optional["dns.name.Name"] = None) -> "dns.name.Name": + name = dns.name.from_wire_parser(self) + if origin: + name = name.relativize(origin) + return name + + def seek(self, where: int) -> None: + # Note that seeking to the end is OK! (If you try to read + # after such a seek, you'll get an exception as expected.) + if where < 0 or where > self.end: + raise dns.exception.FormError + self.current = where + + @contextlib.contextmanager + def restrict_to(self, size: int) -> Iterator: + assert size >= 0 + if size > self.remaining(): + raise dns.exception.FormError + saved_end = self.end + try: + self.end = self.current + size + yield + # We make this check here and not in the finally as we + # don't want to raise if we're already raising for some + # other reason. + if self.current != self.end: + raise dns.exception.FormError + finally: + self.end = saved_end + + @contextlib.contextmanager + def restore_furthest(self) -> Iterator: + try: + yield None + finally: + self.current = self.furthest diff --git a/.venv/lib/python3.12/site-packages/dns/xfr.py b/.venv/lib/python3.12/site-packages/dns/xfr.py new file mode 100644 index 0000000..dd247d3 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/xfr.py @@ -0,0 +1,343 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2017 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +from typing import Any, List, Optional, Tuple, Union + +import dns.exception +import dns.message +import dns.name +import dns.rcode +import dns.rdataset +import dns.rdatatype +import dns.serial +import dns.transaction +import dns.tsig +import dns.zone + + +class TransferError(dns.exception.DNSException): + """A zone transfer response got a non-zero rcode.""" + + def __init__(self, rcode): + message = "Zone transfer error: %s" % dns.rcode.to_text(rcode) + super().__init__(message) + self.rcode = rcode + + +class SerialWentBackwards(dns.exception.FormError): + """The current serial number is less than the serial we know.""" + + +class UseTCP(dns.exception.DNSException): + """This IXFR cannot be completed with UDP.""" + + +class Inbound: + """ + State machine for zone transfers. + """ + + def __init__( + self, + txn_manager: dns.transaction.TransactionManager, + rdtype: dns.rdatatype.RdataType = dns.rdatatype.AXFR, + serial: Optional[int] = None, + is_udp: bool = False, + ): + """Initialize an inbound zone transfer. + + *txn_manager* is a :py:class:`dns.transaction.TransactionManager`. + + *rdtype* can be `dns.rdatatype.AXFR` or `dns.rdatatype.IXFR` + + *serial* is the base serial number for IXFRs, and is required in + that case. + + *is_udp*, a ``bool`` indidicates if UDP is being used for this + XFR. + """ + self.txn_manager = txn_manager + self.txn: Optional[dns.transaction.Transaction] = None + self.rdtype = rdtype + if rdtype == dns.rdatatype.IXFR: + if serial is None: + raise ValueError("a starting serial must be supplied for IXFRs") + elif is_udp: + raise ValueError("is_udp specified for AXFR") + self.serial = serial + self.is_udp = is_udp + (_, _, self.origin) = txn_manager.origin_information() + self.soa_rdataset: Optional[dns.rdataset.Rdataset] = None + self.done = False + self.expecting_SOA = False + self.delete_mode = False + + def process_message(self, message: dns.message.Message) -> bool: + """Process one message in the transfer. + + The message should have the same relativization as was specified when + the `dns.xfr.Inbound` was created. The message should also have been + created with `one_rr_per_rrset=True` because order matters. + + Returns `True` if the transfer is complete, and `False` otherwise. + """ + if self.txn is None: + replacement = self.rdtype == dns.rdatatype.AXFR + self.txn = self.txn_manager.writer(replacement) + rcode = message.rcode() + if rcode != dns.rcode.NOERROR: + raise TransferError(rcode) + # + # We don't require a question section, but if it is present is + # should be correct. + # + if len(message.question) > 0: + if message.question[0].name != self.origin: + raise dns.exception.FormError("wrong question name") + if message.question[0].rdtype != self.rdtype: + raise dns.exception.FormError("wrong question rdatatype") + answer_index = 0 + if self.soa_rdataset is None: + # + # This is the first message. We're expecting an SOA at + # the origin. + # + if not message.answer or message.answer[0].name != self.origin: + raise dns.exception.FormError("No answer or RRset not for zone origin") + rrset = message.answer[0] + rdataset = rrset + if rdataset.rdtype != dns.rdatatype.SOA: + raise dns.exception.FormError("first RRset is not an SOA") + answer_index = 1 + self.soa_rdataset = rdataset.copy() + if self.rdtype == dns.rdatatype.IXFR: + if self.soa_rdataset[0].serial == self.serial: + # + # We're already up-to-date. + # + self.done = True + elif dns.serial.Serial(self.soa_rdataset[0].serial) < self.serial: + # It went backwards! + raise SerialWentBackwards + else: + if self.is_udp and len(message.answer[answer_index:]) == 0: + # + # There are no more records, so this is the + # "truncated" response. Say to use TCP + # + raise UseTCP + # + # Note we're expecting another SOA so we can detect + # if this IXFR response is an AXFR-style response. + # + self.expecting_SOA = True + # + # Process the answer section (other than the initial SOA in + # the first message). + # + for rrset in message.answer[answer_index:]: + name = rrset.name + rdataset = rrset + if self.done: + raise dns.exception.FormError("answers after final SOA") + assert self.txn is not None # for mypy + if rdataset.rdtype == dns.rdatatype.SOA and name == self.origin: + # + # Every time we see an origin SOA delete_mode inverts + # + if self.rdtype == dns.rdatatype.IXFR: + self.delete_mode = not self.delete_mode + # + # If this SOA Rdataset is equal to the first we saw + # then we're finished. If this is an IXFR we also + # check that we're seeing the record in the expected + # part of the response. + # + if rdataset == self.soa_rdataset and ( + self.rdtype == dns.rdatatype.AXFR + or (self.rdtype == dns.rdatatype.IXFR and self.delete_mode) + ): + # + # This is the final SOA + # + if self.expecting_SOA: + # We got an empty IXFR sequence! + raise dns.exception.FormError("empty IXFR sequence") + if ( + self.rdtype == dns.rdatatype.IXFR + and self.serial != rdataset[0].serial + ): + raise dns.exception.FormError("unexpected end of IXFR sequence") + self.txn.replace(name, rdataset) + self.txn.commit() + self.txn = None + self.done = True + else: + # + # This is not the final SOA + # + self.expecting_SOA = False + if self.rdtype == dns.rdatatype.IXFR: + if self.delete_mode: + # This is the start of an IXFR deletion set + if rdataset[0].serial != self.serial: + raise dns.exception.FormError( + "IXFR base serial mismatch" + ) + else: + # This is the start of an IXFR addition set + self.serial = rdataset[0].serial + self.txn.replace(name, rdataset) + else: + # We saw a non-final SOA for the origin in an AXFR. + raise dns.exception.FormError("unexpected origin SOA in AXFR") + continue + if self.expecting_SOA: + # + # We made an IXFR request and are expecting another + # SOA RR, but saw something else, so this must be an + # AXFR response. + # + self.rdtype = dns.rdatatype.AXFR + self.expecting_SOA = False + self.delete_mode = False + self.txn.rollback() + self.txn = self.txn_manager.writer(True) + # + # Note we are falling through into the code below + # so whatever rdataset this was gets written. + # + # Add or remove the data + if self.delete_mode: + self.txn.delete_exact(name, rdataset) + else: + self.txn.add(name, rdataset) + if self.is_udp and not self.done: + # + # This is a UDP IXFR and we didn't get to done, and we didn't + # get the proper "truncated" response + # + raise dns.exception.FormError("unexpected end of UDP IXFR") + return self.done + + # + # Inbounds are context managers. + # + + def __enter__(self): + return self + + def __exit__(self, exc_type, exc_val, exc_tb): + if self.txn: + self.txn.rollback() + return False + + +def make_query( + txn_manager: dns.transaction.TransactionManager, + serial: Optional[int] = 0, + use_edns: Optional[Union[int, bool]] = None, + ednsflags: Optional[int] = None, + payload: Optional[int] = None, + request_payload: Optional[int] = None, + options: Optional[List[dns.edns.Option]] = None, + keyring: Any = None, + keyname: Optional[dns.name.Name] = None, + keyalgorithm: Union[dns.name.Name, str] = dns.tsig.default_algorithm, +) -> Tuple[dns.message.QueryMessage, Optional[int]]: + """Make an AXFR or IXFR query. + + *txn_manager* is a ``dns.transaction.TransactionManager``, typically a + ``dns.zone.Zone``. + + *serial* is an ``int`` or ``None``. If 0, then IXFR will be + attempted using the most recent serial number from the + *txn_manager*; it is the caller's responsibility to ensure there + are no write transactions active that could invalidate the + retrieved serial. If a serial cannot be determined, AXFR will be + forced. Other integer values are the starting serial to use. + ``None`` forces an AXFR. + + Please see the documentation for :py:func:`dns.message.make_query` and + :py:func:`dns.message.Message.use_tsig` for details on the other parameters + to this function. + + Returns a `(query, serial)` tuple. + """ + (zone_origin, _, origin) = txn_manager.origin_information() + if zone_origin is None: + raise ValueError("no zone origin") + if serial is None: + rdtype = dns.rdatatype.AXFR + elif not isinstance(serial, int): + raise ValueError("serial is not an integer") + elif serial == 0: + with txn_manager.reader() as txn: + rdataset = txn.get(origin, "SOA") + if rdataset: + serial = rdataset[0].serial + rdtype = dns.rdatatype.IXFR + else: + serial = None + rdtype = dns.rdatatype.AXFR + elif serial > 0 and serial < 4294967296: + rdtype = dns.rdatatype.IXFR + else: + raise ValueError("serial out-of-range") + rdclass = txn_manager.get_class() + q = dns.message.make_query( + zone_origin, + rdtype, + rdclass, + use_edns, + False, + ednsflags, + payload, + request_payload, + options, + ) + if serial is not None: + rdata = dns.rdata.from_text(rdclass, "SOA", f". . {serial} 0 0 0 0") + rrset = q.find_rrset( + q.authority, zone_origin, rdclass, dns.rdatatype.SOA, create=True + ) + rrset.add(rdata, 0) + if keyring is not None: + q.use_tsig(keyring, keyname, algorithm=keyalgorithm) + return (q, serial) + + +def extract_serial_from_query(query: dns.message.Message) -> Optional[int]: + """Extract the SOA serial number from query if it is an IXFR and return + it, otherwise return None. + + *query* is a dns.message.QueryMessage that is an IXFR or AXFR request. + + Raises if the query is not an IXFR or AXFR, or if an IXFR doesn't have + an appropriate SOA RRset in the authority section. + """ + if not isinstance(query, dns.message.QueryMessage): + raise ValueError("query not a QueryMessage") + question = query.question[0] + if question.rdtype == dns.rdatatype.AXFR: + return None + elif question.rdtype != dns.rdatatype.IXFR: + raise ValueError("query is not an AXFR or IXFR") + soa = query.find_rrset( + query.authority, question.name, question.rdclass, dns.rdatatype.SOA + ) + return soa[0].serial diff --git a/.venv/lib/python3.12/site-packages/dns/zone.py b/.venv/lib/python3.12/site-packages/dns/zone.py new file mode 100644 index 0000000..844919e --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/zone.py @@ -0,0 +1,1434 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""DNS Zones.""" + +import contextlib +import io +import os +import struct +from typing import ( + Any, + Callable, + Iterable, + Iterator, + List, + MutableMapping, + Optional, + Set, + Tuple, + Union, +) + +import dns.exception +import dns.grange +import dns.immutable +import dns.name +import dns.node +import dns.rdata +import dns.rdataclass +import dns.rdataset +import dns.rdatatype +import dns.rdtypes.ANY.SOA +import dns.rdtypes.ANY.ZONEMD +import dns.rrset +import dns.tokenizer +import dns.transaction +import dns.ttl +import dns.zonefile +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.""" + + +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 + treated like a Python dictionary, e.g. ``zone[name]`` will retrieve + the node associated with that name. The *name* may be a + ``dns.name.Name object``, or it may be a string. In either case, + if the name is relative it is treated as relative to the origin of + the zone. + """ + + 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"] + + def __init__( + self, + origin: Optional[Union[dns.name.Name, str]], + rdclass: dns.rdataclass.RdataClass = dns.rdataclass.IN, + relativize: bool = True, + ): + """Initialize a zone object. + + *origin* is the origin of the zone. It may be a ``dns.name.Name``, + a ``str``, or ``None``. If ``None``, then the zone's origin will + be set by the first ``$ORIGIN`` line in a zone file. + + *rdclass*, an ``int``, the zone's rdata class; the default is class IN. + + *relativize*, a ``bool``, determine's whether domain names are + relativized to the zone's origin. The default is ``True``. + """ + + if origin is not None: + if isinstance(origin, str): + origin = dns.name.from_text(origin) + elif not isinstance(origin, dns.name.Name): + raise ValueError("origin parameter must be convertible to a DNS name") + if not origin.is_absolute(): + raise ValueError("origin parameter must be an absolute name") + self.origin = origin + self.rdclass = rdclass + self.nodes: MutableMapping[dns.name.Name, dns.node.Node] = self.map_factory() + self.relativize = relativize + + def __eq__(self, other): + """Two zones are equal if they have the same origin, class, and + nodes. + + Returns a ``bool``. + """ + + if not isinstance(other, Zone): + return False + if ( + self.rdclass != other.rdclass + or self.origin != other.origin + or self.nodes != other.nodes + ): + return False + return True + + def __ne__(self, other): + """Are two zones not equal? + + Returns a ``bool``. + """ + + 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") + return _validate_name(name, self.origin, self.relativize) + + def __getitem__(self, key): + key = self._validate_name(key) + return self.nodes[key] + + def __setitem__(self, key, value): + key = self._validate_name(key) + self.nodes[key] = value + + def __delitem__(self, key): + key = self._validate_name(key) + del self.nodes[key] + + def __iter__(self): + return self.nodes.__iter__() + + def keys(self): + return self.nodes.keys() + + def values(self): + return self.nodes.values() + + def items(self): + return self.nodes.items() + + def get(self, key): + key = self._validate_name(key) + return self.nodes.get(key) + + def __contains__(self, key): + key = self._validate_name(key) + return key in self.nodes + + def find_node( + self, name: Union[dns.name.Name, str], create: bool = False + ) -> dns.node.Node: + """Find a node in the zone, possibly creating it. + + *name*: the name of the node to find. + The value may be a ``dns.name.Name`` or a ``str``. If absolute, the + name must be a subdomain of the zone's origin. If ``zone.relativize`` + is ``True``, then the name will be relativized. + + *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``. + """ + + name = self._validate_name(name) + node = self.nodes.get(name) + if node is None: + if not create: + raise KeyError + node = self.node_factory() + self.nodes[name] = node + return node + + def get_node( + self, name: Union[dns.name.Name, str], create: bool = False + ) -> Optional[dns.node.Node]: + """Get a node in the zone, possibly creating it. + + This method is like ``find_node()``, except it returns None instead + of raising an exception if the node does not exist and creation + has not been requested. + + *name*: the name of the node to find. + The value may be a ``dns.name.Name`` or a ``str``. If absolute, the + name must be a subdomain of the zone's origin. If ``zone.relativize`` + is ``True``, then the name will be relativized. + + *create*, a ``bool``. If true, the node will be created if it does + not exist. + + Returns a ``dns.node.Node`` or ``None``. + """ + + try: + node = self.find_node(name, create) + except KeyError: + node = None + return node + + def delete_node(self, name: Union[dns.name.Name, str]) -> None: + """Delete the specified node if it exists. + + *name*: the name of the node to find. + The value may be a ``dns.name.Name`` or a ``str``. If absolute, the + name must be a subdomain of the zone's origin. If ``zone.relativize`` + is ``True``, then the name will be relativized. + + It is not an error if the node does not exist. + """ + + name = self._validate_name(name) + if name in self.nodes: + del self.nodes[name] + + def find_rdataset( + self, + name: Union[dns.name.Name, str], + rdtype: Union[dns.rdatatype.RdataType, str], + covers: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.NONE, + create: bool = False, + ) -> dns.rdataset.Rdataset: + """Look for an rdataset with the specified name and type in the zone, + and return an rdataset encapsulating it. + + The rdataset returned is not a copy; changes to it will change + the zone. + + KeyError is raised if the name or type are not found. + + *name*: the name of the node to find. + The value may be a ``dns.name.Name`` or a ``str``. If absolute, the + name must be a subdomain of the zone's origin. If ``zone.relativize`` + is ``True``, then the name will be relativized. + + *rdtype*, a ``dns.rdatatype.RdataType`` or ``str``, the rdata type desired. + + *covers*, a ``dns.rdatatype.RdataType`` or ``str`` the covered type. + Usually this value is ``dns.rdatatype.NONE``, but if the + rdtype is ``dns.rdatatype.SIG`` or ``dns.rdatatype.RRSIG``, + then the covers value will be the rdata type the SIG/RRSIG + covers. The library treats the SIG and RRSIG types as if they + were a family of types, e.g. RRSIG(A), RRSIG(NS), RRSIG(SOA). + This makes RRSIGs much easier to work with than if RRSIGs + covering different rdata types were aggregated into a single + RRSIG rdataset. + + *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.rdataset.Rdataset``. + """ + + name = self._validate_name(name) + rdtype = dns.rdatatype.RdataType.make(rdtype) + covers = dns.rdatatype.RdataType.make(covers) + node = self.find_node(name, create) + return node.find_rdataset(self.rdclass, rdtype, covers, create) + + def get_rdataset( + self, + name: Union[dns.name.Name, str], + rdtype: Union[dns.rdatatype.RdataType, str], + covers: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.NONE, + create: bool = False, + ) -> Optional[dns.rdataset.Rdataset]: + """Look for an rdataset with the specified name and type in the zone. + + This method is like ``find_rdataset()``, except it returns None instead + of raising an exception if the rdataset does not exist and creation + has not been requested. + + The rdataset returned is not a copy; changes to it will change + the zone. + + *name*: the name of the node to find. + The value may be a ``dns.name.Name`` or a ``str``. If absolute, the + name must be a subdomain of the zone's origin. If ``zone.relativize`` + is ``True``, then the name will be relativized. + + *rdtype*, a ``dns.rdatatype.RdataType`` or ``str``, the rdata type desired. + + *covers*, a ``dns.rdatatype.RdataType`` or ``str``, the covered type. + Usually this value is ``dns.rdatatype.NONE``, but if the + rdtype is ``dns.rdatatype.SIG`` or ``dns.rdatatype.RRSIG``, + then the covers value will be the rdata type the SIG/RRSIG + covers. The library treats the SIG and RRSIG types as if they + were a family of types, e.g. RRSIG(A), RRSIG(NS), RRSIG(SOA). + This makes RRSIGs much easier to work with than if RRSIGs + covering different rdata types were aggregated into a single + RRSIG rdataset. + + *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.rdataset.Rdataset`` or ``None``. + """ + + try: + rdataset = self.find_rdataset(name, rdtype, covers, create) + except KeyError: + rdataset = None + return rdataset + + def delete_rdataset( + self, + name: Union[dns.name.Name, str], + rdtype: Union[dns.rdatatype.RdataType, str], + covers: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.NONE, + ) -> None: + """Delete the rdataset matching *rdtype* and *covers*, if it + exists at the node specified by *name*. + + It is not an error if the node does not exist, or if there is no matching + rdataset at the node. + + If the node has no rdatasets after the deletion, it will itself be deleted. + + *name*: the name of the node to find. The value may be a ``dns.name.Name`` or a + ``str``. If absolute, the name must be a subdomain of the zone's origin. If + ``zone.relativize`` is ``True``, then the name will be relativized. + + *rdtype*, a ``dns.rdatatype.RdataType`` or ``str``, the rdata type desired. + + *covers*, a ``dns.rdatatype.RdataType`` or ``str`` or ``None``, the covered + type. Usually this value is ``dns.rdatatype.NONE``, but if the rdtype is + ``dns.rdatatype.SIG`` or ``dns.rdatatype.RRSIG``, then the covers value will be + the rdata type the SIG/RRSIG covers. The library treats the SIG and RRSIG types + as if they were a family of types, e.g. RRSIG(A), RRSIG(NS), RRSIG(SOA). This + makes RRSIGs much easier to work with than if RRSIGs covering different rdata + types were aggregated into a single RRSIG rdataset. + """ + + name = self._validate_name(name) + rdtype = dns.rdatatype.RdataType.make(rdtype) + covers = dns.rdatatype.RdataType.make(covers) + node = self.get_node(name) + if node is not None: + node.delete_rdataset(self.rdclass, rdtype, covers) + if len(node) == 0: + self.delete_node(name) + + def replace_rdataset( + self, name: Union[dns.name.Name, str], replacement: dns.rdataset.Rdataset + ) -> None: + """Replace an rdataset at name. + + It is not an error if there is no rdataset matching I{replacement}. + + Ownership of the *replacement* object is transferred to the zone; + in other words, this method does not store a copy of *replacement* + at the node, it stores *replacement* itself. + + If the node does not exist, it is created. + + *name*: the name of the node to find. + The value may be a ``dns.name.Name`` or a ``str``. If absolute, the + name must be a subdomain of the zone's origin. If ``zone.relativize`` + is ``True``, then the name will be relativized. + + *replacement*, a ``dns.rdataset.Rdataset``, the replacement rdataset. + """ + + if replacement.rdclass != self.rdclass: + raise ValueError("replacement.rdclass != zone.rdclass") + node = self.find_node(name, True) + node.replace_rdataset(replacement) + + def find_rrset( + self, + name: Union[dns.name.Name, str], + rdtype: Union[dns.rdatatype.RdataType, str], + covers: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.NONE, + ) -> dns.rrset.RRset: + """Look for an rdataset with the specified name and type in the zone, + and return an RRset encapsulating it. + + This method is less efficient than the similar + ``find_rdataset()`` because it creates an RRset instead of + returning the matching rdataset. It may be more convenient + for some uses since it returns an object which binds the owner + name to the rdataset. + + This method may not be used to create new nodes or rdatasets; + use ``find_rdataset`` instead. + + *name*: the name of the node to find. + The value may be a ``dns.name.Name`` or a ``str``. If absolute, the + name must be a subdomain of the zone's origin. If ``zone.relativize`` + is ``True``, then the name will be relativized. + + *rdtype*, a ``dns.rdatatype.RdataType`` or ``str``, the rdata type desired. + + *covers*, a ``dns.rdatatype.RdataType`` or ``str``, the covered type. + Usually this value is ``dns.rdatatype.NONE``, but if the + rdtype is ``dns.rdatatype.SIG`` or ``dns.rdatatype.RRSIG``, + then the covers value will be the rdata type the SIG/RRSIG + covers. The library treats the SIG and RRSIG types as if they + were a family of types, e.g. RRSIG(A), RRSIG(NS), RRSIG(SOA). + This makes RRSIGs much easier to work with than if RRSIGs + covering different rdata types were aggregated into a single + RRSIG rdataset. + + *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``. + """ + + vname = self._validate_name(name) + rdtype = dns.rdatatype.RdataType.make(rdtype) + covers = dns.rdatatype.RdataType.make(covers) + rdataset = self.nodes[vname].find_rdataset(self.rdclass, rdtype, covers) + rrset = dns.rrset.RRset(vname, self.rdclass, rdtype, covers) + rrset.update(rdataset) + return rrset + + def get_rrset( + self, + name: Union[dns.name.Name, str], + rdtype: Union[dns.rdatatype.RdataType, str], + covers: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.NONE, + ) -> Optional[dns.rrset.RRset]: + """Look for an rdataset with the specified name and type in the zone, + and return an RRset encapsulating it. + + This method is less efficient than the similar ``get_rdataset()`` + because it creates an RRset instead of returning the matching + rdataset. It may be more convenient for some uses since it + returns an object which binds the owner name to the rdataset. + + This method may not be used to create new nodes or rdatasets; + use ``get_rdataset()`` instead. + + *name*: the name of the node to find. + The value may be a ``dns.name.Name`` or a ``str``. If absolute, the + name must be a subdomain of the zone's origin. If ``zone.relativize`` + is ``True``, then the name will be relativized. + + *rdtype*, a ``dns.rdataset.Rdataset`` or ``str``, the rdata type desired. + + *covers*, a ``dns.rdataset.Rdataset`` or ``str``, the covered type. + Usually this value is ``dns.rdatatype.NONE``, but if the + rdtype is ``dns.rdatatype.SIG`` or ``dns.rdatatype.RRSIG``, + then the covers value will be the rdata type the SIG/RRSIG + covers. The library treats the SIG and RRSIG types as if they + were a family of types, e.g. RRSIG(A), RRSIG(NS), RRSIG(SOA). + This makes RRSIGs much easier to work with than if RRSIGs + covering different rdata types were aggregated into a single + RRSIG rdataset. + + *create*, a ``bool``. If true, the node will be created if it does + not exist. + + Returns a ``dns.rrset.RRset`` or ``None``. + """ + + try: + rrset = self.find_rrset(name, rdtype, covers) + except KeyError: + rrset = None + return rrset + + def iterate_rdatasets( + self, + rdtype: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.ANY, + covers: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.NONE, + ) -> Iterator[Tuple[dns.name.Name, dns.rdataset.Rdataset]]: + """Return a generator which yields (name, rdataset) tuples for + all rdatasets in the zone which have the specified *rdtype* + and *covers*. If *rdtype* is ``dns.rdatatype.ANY``, the default, + then all rdatasets will be matched. + + *rdtype*, a ``dns.rdataset.Rdataset`` or ``str``, the rdata type desired. + + *covers*, a ``dns.rdataset.Rdataset`` or ``str``, the covered type. + Usually this value is ``dns.rdatatype.NONE``, but if the + rdtype is ``dns.rdatatype.SIG`` or ``dns.rdatatype.RRSIG``, + then the covers value will be the rdata type the SIG/RRSIG + covers. The library treats the SIG and RRSIG types as if they + were a family of types, e.g. RRSIG(A), RRSIG(NS), RRSIG(SOA). + This makes RRSIGs much easier to work with than if RRSIGs + covering different rdata types were aggregated into a single + RRSIG rdataset. + """ + + rdtype = dns.rdatatype.RdataType.make(rdtype) + covers = dns.rdatatype.RdataType.make(covers) + for name, node in self.items(): + for rds in node: + if rdtype == dns.rdatatype.ANY or ( + rds.rdtype == rdtype and rds.covers == covers + ): + yield (name, rds) + + def iterate_rdatas( + self, + rdtype: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.ANY, + covers: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.NONE, + ) -> Iterator[Tuple[dns.name.Name, int, dns.rdata.Rdata]]: + """Return a generator which yields (name, ttl, rdata) tuples for + all rdatas in the zone which have the specified *rdtype* + and *covers*. If *rdtype* is ``dns.rdatatype.ANY``, the default, + then all rdatas will be matched. + + *rdtype*, a ``dns.rdataset.Rdataset`` or ``str``, the rdata type desired. + + *covers*, a ``dns.rdataset.Rdataset`` or ``str``, the covered type. + Usually this value is ``dns.rdatatype.NONE``, but if the + rdtype is ``dns.rdatatype.SIG`` or ``dns.rdatatype.RRSIG``, + then the covers value will be the rdata type the SIG/RRSIG + covers. The library treats the SIG and RRSIG types as if they + were a family of types, e.g. RRSIG(A), RRSIG(NS), RRSIG(SOA). + This makes RRSIGs much easier to work with than if RRSIGs + covering different rdata types were aggregated into a single + RRSIG rdataset. + """ + + rdtype = dns.rdatatype.RdataType.make(rdtype) + covers = dns.rdatatype.RdataType.make(covers) + for name, node in self.items(): + for rds in node: + if rdtype == dns.rdatatype.ANY or ( + rds.rdtype == rdtype and rds.covers == covers + ): + for rdata in rds: + yield (name, rds.ttl, rdata) + + def to_file( + self, + f: Any, + sorted: bool = True, + relativize: bool = True, + nl: Optional[str] = None, + want_comments: bool = False, + want_origin: bool = False, + ) -> None: + """Write a zone to a file. + + *f*, a file or `str`. If *f* is a string, it is treated + as the name of a file to open. + + *sorted*, a ``bool``. If True, the default, then the file + will be written with the names sorted in DNSSEC order from + least to greatest. Otherwise the names will be written in + whatever order they happen to have in the zone's dictionary. + + *relativize*, a ``bool``. If True, the default, then domain + names in the output will be relativized to the zone's origin + if possible. + + *nl*, a ``str`` or None. The end of line string. If not + ``None``, the output will use the platform's native + end-of-line marker (i.e. LF on POSIX, CRLF on Windows). + + *want_comments*, a ``bool``. If ``True``, emit end-of-line comments + as part of writing the file. If ``False``, the default, do not + emit them. + + *want_origin*, a ``bool``. If ``True``, emit a $ORIGIN line at + the start of the file. If ``False``, the default, do not emit + one. + """ + + if isinstance(f, str): + cm: contextlib.AbstractContextManager = open(f, "wb") + else: + cm = contextlib.nullcontext(f) + with cm as f: + # must be in this way, f.encoding may contain None, or even + # attribute may not be there + file_enc = getattr(f, "encoding", None) + if file_enc is None: + file_enc = "utf-8" + + if nl is None: + # binary mode, '\n' is not enough + nl_b = os.linesep.encode(file_enc) + nl = "\n" + elif isinstance(nl, str): + nl_b = nl.encode(file_enc) + else: + nl_b = nl + nl = nl.decode() + + if want_origin: + assert self.origin is not None + l = "$ORIGIN " + self.origin.to_text() + l_b = l.encode(file_enc) + try: + f.write(l_b) + f.write(nl_b) + except TypeError: # textual mode + f.write(l) + f.write(nl) + + if sorted: + names = list(self.keys()) + names.sort() + else: + names = self.keys() + for n in names: + l = self[n].to_text( + n, + origin=self.origin, + relativize=relativize, + want_comments=want_comments, + ) + l_b = l.encode(file_enc) + + try: + f.write(l_b) + f.write(nl_b) + except TypeError: # textual mode + f.write(l) + f.write(nl) + + def to_text( + self, + sorted: bool = True, + relativize: bool = True, + nl: Optional[str] = None, + want_comments: bool = False, + want_origin: bool = False, + ) -> str: + """Return a zone's text as though it were written to a file. + + *sorted*, a ``bool``. If True, the default, then the file + will be written with the names sorted in DNSSEC order from + least to greatest. Otherwise the names will be written in + whatever order they happen to have in the zone's dictionary. + + *relativize*, a ``bool``. If True, the default, then domain + names in the output will be relativized to the zone's origin + if possible. + + *nl*, a ``str`` or None. The end of line string. If not + ``None``, the output will use the platform's native + end-of-line marker (i.e. LF on POSIX, CRLF on Windows). + + *want_comments*, a ``bool``. If ``True``, emit end-of-line comments + as part of writing the file. If ``False``, the default, do not + emit them. + + *want_origin*, a ``bool``. If ``True``, emit a $ORIGIN line at + the start of the output. If ``False``, the default, do not emit + one. + + Returns a ``str``. + """ + temp_buffer = io.StringIO() + self.to_file(temp_buffer, sorted, relativize, nl, want_comments, want_origin) + return_value = temp_buffer.getvalue() + temp_buffer.close() + return return_value + + def check_origin(self) -> None: + """Do some simple checking of the zone's origin. + + Raises ``dns.zone.NoSOA`` if there is no SOA RRset. + + Raises ``dns.zone.NoNS`` if there is no NS RRset. + + Raises ``KeyError`` if there is no origin node. + """ + if self.relativize: + name = dns.name.empty + else: + assert self.origin is not None + name = self.origin + if self.get_rdataset(name, dns.rdatatype.SOA) is None: + raise NoSOA + if self.get_rdataset(name, dns.rdatatype.NS) is None: + raise NoNS + + def get_soa( + self, txn: Optional[dns.transaction.Transaction] = None + ) -> dns.rdtypes.ANY.SOA.SOA: + """Get the zone SOA rdata. + + Raises ``dns.zone.NoSOA`` if there is no SOA RRset. + + Returns a ``dns.rdtypes.ANY.SOA.SOA`` Rdata. + """ + if self.relativize: + origin_name = dns.name.empty + else: + if self.origin is None: + # get_soa() has been called very early, and there must not be + # an SOA if there is no origin. + raise NoSOA + origin_name = self.origin + soa: Optional[dns.rdataset.Rdataset] + if txn: + soa = txn.get(origin_name, dns.rdatatype.SOA) + else: + soa = self.get_rdataset(origin_name, dns.rdatatype.SOA) + if soa is None: + raise NoSOA + return soa[0] + + def _compute_digest( + self, + hash_algorithm: DigestHashAlgorithm, + scheme: DigestScheme = DigestScheme.SIMPLE, + ) -> bytes: + hashinfo = _digest_hashers.get(hash_algorithm) + if not hashinfo: + raise UnsupportedDigestHashAlgorithm + if scheme != DigestScheme.SIMPLE: + raise UnsupportedDigestScheme + + if self.relativize: + origin_name = dns.name.empty + else: + assert self.origin is not None + origin_name = self.origin + hasher = hashinfo() + for name, node in sorted(self.items()): + rrnamebuf = name.to_digestable(self.origin) + for rdataset in sorted(node, key=lambda rds: (rds.rdtype, rds.covers)): + if name == origin_name and dns.rdatatype.ZONEMD in ( + rdataset.rdtype, + rdataset.covers, + ): + continue + rrfixed = struct.pack( + "!HHI", rdataset.rdtype, rdataset.rdclass, rdataset.ttl + ) + rdatas = [rdata.to_digestable(self.origin) for rdata in rdataset] + for rdata in sorted(rdatas): + rrlen = struct.pack("!H", len(rdata)) + hasher.update(rrnamebuf + rrfixed + rrlen + rdata) + return hasher.digest() + + def compute_digest( + self, + hash_algorithm: DigestHashAlgorithm, + scheme: DigestScheme = DigestScheme.SIMPLE, + ) -> dns.rdtypes.ANY.ZONEMD.ZONEMD: + serial = self.get_soa().serial + digest = self._compute_digest(hash_algorithm, scheme) + return dns.rdtypes.ANY.ZONEMD.ZONEMD( + self.rdclass, dns.rdatatype.ZONEMD, serial, scheme, hash_algorithm, digest + ) + + def verify_digest( + self, zonemd: Optional[dns.rdtypes.ANY.ZONEMD.ZONEMD] = None + ) -> None: + digests: Union[dns.rdataset.Rdataset, List[dns.rdtypes.ANY.ZONEMD.ZONEMD]] + if zonemd: + digests = [zonemd] + else: + assert self.origin is not None + rds = self.get_rdataset(self.origin, dns.rdatatype.ZONEMD) + if rds is None: + raise NoDigest + digests = rds + for digest in digests: + try: + computed = self._compute_digest(digest.hash_algorithm, digest.scheme) + if computed == digest.digest: + return + except Exception: + pass + raise DigestVerificationFailure + + # TransactionManager methods + + def reader(self) -> "Transaction": + return Transaction(self, False, Version(self, 1, self.nodes, self.origin)) + + def writer(self, replacement: bool = False) -> "Transaction": + txn = Transaction(self, replacement) + txn._setup_version() + return txn + + def origin_information( + self, + ) -> Tuple[Optional[dns.name.Name], bool, Optional[dns.name.Name]]: + effective: Optional[dns.name.Name] + if self.relativize: + effective = dns.name.empty + else: + effective = self.origin + return (self.origin, self.relativize, effective) + + def get_class(self): + return self.rdclass + + # Transaction methods + + def _end_read(self, txn): + pass + + def _end_write(self, txn): + pass + + def _commit_version(self, _, version, origin): + self.nodes = version.nodes + if self.origin is None: + self.origin = origin + + def _get_next_version_id(self): + # Versions are ephemeral and all have id 1 + return 1 + + +# These classes used to be in dns.versioned, but have moved here so we can use +# the copy-on-write transaction mechanism for both kinds of zones. In a +# regular zone, the version only exists during the transaction, and the nodes +# are regular dns.node.Nodes. + +# A node with a version id. + + +class VersionedNode(dns.node.Node): # lgtm[py/missing-equals] + __slots__ = ["id"] + + def __init__(self): + super().__init__() + # A proper id will get set by the Version + self.id = 0 + + +@dns.immutable.immutable +class ImmutableVersionedNode(VersionedNode): + def __init__(self, node): + super().__init__() + self.id = node.id + self.rdatasets = tuple( + [dns.rdataset.ImmutableRdataset(rds) for rds in node.rdatasets] + ) + + def find_rdataset( + self, + rdclass: dns.rdataclass.RdataClass, + rdtype: dns.rdatatype.RdataType, + covers: dns.rdatatype.RdataType = dns.rdatatype.NONE, + create: bool = False, + ) -> dns.rdataset.Rdataset: + if create: + raise TypeError("immutable") + return super().find_rdataset(rdclass, rdtype, covers, False) + + def get_rdataset( + self, + rdclass: dns.rdataclass.RdataClass, + rdtype: dns.rdatatype.RdataType, + covers: dns.rdatatype.RdataType = dns.rdatatype.NONE, + create: bool = False, + ) -> Optional[dns.rdataset.Rdataset]: + if create: + raise TypeError("immutable") + return super().get_rdataset(rdclass, rdtype, covers, False) + + def delete_rdataset( + self, + rdclass: dns.rdataclass.RdataClass, + rdtype: dns.rdatatype.RdataType, + covers: dns.rdatatype.RdataType = dns.rdatatype.NONE, + ) -> None: + raise TypeError("immutable") + + def replace_rdataset(self, replacement: dns.rdataset.Rdataset) -> None: + raise TypeError("immutable") + + def is_immutable(self) -> bool: + return True + + +class Version: + def __init__( + self, + zone: Zone, + id: int, + nodes: Optional[MutableMapping[dns.name.Name, dns.node.Node]] = None, + origin: Optional[dns.name.Name] = None, + ): + self.zone = zone + self.id = id + if nodes is not None: + self.nodes = nodes + else: + self.nodes = zone.map_factory() + self.origin = origin + + def _validate_name(self, name: dns.name.Name) -> dns.name.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) + return self.nodes.get(name) + + def get_rdataset( + self, + name: dns.name.Name, + rdtype: dns.rdatatype.RdataType, + covers: dns.rdatatype.RdataType, + ) -> Optional[dns.rdataset.Rdataset]: + node = self.get_node(name) + if node is None: + return None + return node.get_rdataset(self.zone.rdclass, rdtype, covers) + + def keys(self): + return self.nodes.keys() + + def items(self): + return self.nodes.items() + + +class WritableVersion(Version): + def __init__(self, zone: Zone, replacement: bool = False): + # The zone._versions_lock must be held by our caller in a versioned + # zone. + id = zone._get_next_version_id() + super().__init__(zone, id) + if not replacement: + # We copy the map, because that gives us a simple and thread-safe + # way of doing versions, and we have a garbage collector to help + # us. We only make new node objects if we actually change the + # node. + self.nodes.update(zone.nodes) + # We have to copy the zone origin as it may be None in the first + # version, and we don't want to mutate the zone until we commit. + self.origin = zone.origin + self.changed: Set[dns.name.Name] = set() + + def _maybe_cow(self, name: dns.name.Name) -> dns.node.Node: + name = self._validate_name(name) + node = self.nodes.get(name) + if node is None or name not in self.changed: + new_node = self.zone.node_factory() + if hasattr(new_node, "id"): + # We keep doing this for backwards compatibility, as earlier + # code used new_node.id != self.id for the "do we need to CoW?" + # test. Now we use the changed set as this works with both + # regular zones and versioned zones. + # + # We ignore the mypy error as this is safe but it doesn't see it. + new_node.id = self.id # type: ignore + if node is not None: + # moo! copy on write! + new_node.rdatasets.extend(node.rdatasets) + self.nodes[name] = new_node + self.changed.add(name) + return new_node + else: + return node + + def delete_node(self, name: dns.name.Name) -> None: + name = self._validate_name(name) + if name in self.nodes: + del self.nodes[name] + self.changed.add(name) + + def put_rdataset( + self, name: dns.name.Name, rdataset: dns.rdataset.Rdataset + ) -> None: + node = self._maybe_cow(name) + node.replace_rdataset(rdataset) + + def delete_rdataset( + self, + name: dns.name.Name, + rdtype: dns.rdatatype.RdataType, + covers: dns.rdatatype.RdataType, + ) -> None: + node = self._maybe_cow(name) + node.delete_rdataset(self.zone.rdclass, rdtype, covers) + if len(node) == 0: + del self.nodes[name] + + +@dns.immutable.immutable +class ImmutableVersion(Version): + def __init__(self, version: WritableVersion): + # We tell super() that it's a replacement as we don't want it + # to copy the nodes, as we're about to do that with an + # immutable Dict. + super().__init__(version.zone, True) + # set the right id! + self.id = version.id + # keep the origin + self.origin = version.origin + # Make changed nodes immutable + for name in version.changed: + node = version.nodes.get(name) + # it might not exist if we deleted it in the version + if node: + 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, self.zone.map_factory + ) # type: ignore + + +class Transaction(dns.transaction.Transaction): + def __init__(self, zone, replacement, version=None, make_immutable=False): + read_only = version is not None + super().__init__(zone, replacement, read_only) + self.version = version + self.make_immutable = make_immutable + + @property + def zone(self): + return self.manager + + def _setup_version(self): + assert self.version is None + 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) + + def _put_rdataset(self, name, rdataset): + assert not self.read_only + self.version.put_rdataset(name, rdataset) + + def _delete_name(self, name): + assert not self.read_only + self.version.delete_node(name) + + def _delete_rdataset(self, name, rdtype, covers): + assert not self.read_only + self.version.delete_rdataset(name, rdtype, covers) + + def _name_exists(self, name): + return self.version.get_node(name) is not None + + def _changed(self): + if self.read_only: + return False + else: + return len(self.version.changed) > 0 + + def _end_transaction(self, commit): + if self.read_only: + self.zone._end_read(self) + elif commit and len(self.version.changed) > 0: + if self.make_immutable: + 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) + else: + # rollback + self.zone._end_write(self) + + def _set_origin(self, origin): + if self.version.origin is None: + self.version.origin = origin + + def _iterate_rdatasets(self): + for name, node in self.version.items(): + for rdataset in node: + yield (name, rdataset) + + def _iterate_names(self): + return self.version.keys() + + def _get_node(self, name): + return self.version.get_node(name) + + def _origin_information(self): + (absolute, relativize, effective) = self.manager.origin_information() + if absolute is None and self.version.origin is not None: + # No origin has been committed yet, but we've learned one as part of + # this txn. Use it. + absolute = self.version.origin + if relativize: + effective = dns.name.empty + else: + effective = absolute + 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, + 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: + """Build a zone object from a zone file format string. + + *text*, a ``str``, the zone file format input. + + *origin*, a ``dns.name.Name``, a ``str``, or ``None``. The origin + of the zone; if not specified, the first ``$ORIGIN`` statement in the + zone file will determine the origin of the zone. + + *rdclass*, a ``dns.rdataclass.RdataClass``, the zone's rdata class; the default is + class IN. + + *relativize*, a ``bool``, determine's whether domain names are + relativized to the zone's origin. The default is ``True``. + + *zone_factory*, the zone factory to use or ``None``. If ``None``, then + ``dns.zone.Zone`` will be used. The value may be any class or callable + that returns a subclass of ``dns.zone.Zone``. + + *filename*, a ``str`` or ``None``, the filename to emit when + describing where an error occurred; the default is ``''``. + + *allow_include*, a ``bool``. If ``True``, the default, then ``$INCLUDE`` + directives are permitted. If ``False``, then encoutering a ``$INCLUDE`` + will raise a ``SyntaxError`` exception. + + *check_origin*, a ``bool``. If ``True``, the default, then sanity + checks of the origin node will be made by calling the zone's + ``check_origin()`` method. + + *idna_codec*, a ``dns.name.IDNACodec``, specifies the IDNA + encoder/decoder. If ``None``, the default IDNA 2003 encoder/decoder + is used. + + *allow_directives*, a ``bool`` or an iterable of `str`. If ``True``, the default, + then directives are permitted, and the *allow_include* parameter controls whether + ``$INCLUDE`` is permitted. If ``False`` or an empty iterable, then no directive + processing is done and any directive-like text will be treated as a regular owner + name. If a non-empty iterable, then only the listed directives (including the + ``$``) are allowed. + + Raises ``dns.zone.NoSOA`` if there is no SOA RRset. + + Raises ``dns.zone.NoNS`` if there is no NS RRset. + + Raises ``KeyError`` if there is no origin node. + + Returns a subclass of ``dns.zone.Zone``. + """ + return _from_text( + text, + origin, + rdclass, + relativize, + zone_factory, + filename, + allow_include, + check_origin, + idna_codec, + allow_directives, + ) + + +def from_file( + f: 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 = True, + check_origin: bool = True, + idna_codec: Optional[dns.name.IDNACodec] = None, + allow_directives: Union[bool, Iterable[str]] = True, +) -> Zone: + """Read a zone file and build a zone object. + + *f*, a file or ``str``. If *f* is a string, it is treated + as the name of a file to open. + + *origin*, a ``dns.name.Name``, a ``str``, or ``None``. The origin + of the zone; if not specified, the first ``$ORIGIN`` statement in the + zone file will determine the origin of the zone. + + *rdclass*, an ``int``, the zone's rdata class; the default is class IN. + + *relativize*, a ``bool``, determine's whether domain names are + relativized to the zone's origin. The default is ``True``. + + *zone_factory*, the zone factory to use or ``None``. If ``None``, then + ``dns.zone.Zone`` will be used. The value may be any class or callable + that returns a subclass of ``dns.zone.Zone``. + + *filename*, a ``str`` or ``None``, the filename to emit when + describing where an error occurred; the default is ``''``. + + *allow_include*, a ``bool``. If ``True``, the default, then ``$INCLUDE`` + directives are permitted. If ``False``, then encoutering a ``$INCLUDE`` + will raise a ``SyntaxError`` exception. + + *check_origin*, a ``bool``. If ``True``, the default, then sanity + checks of the origin node will be made by calling the zone's + ``check_origin()`` method. + + *idna_codec*, a ``dns.name.IDNACodec``, specifies the IDNA + encoder/decoder. If ``None``, the default IDNA 2003 encoder/decoder + is used. + + *allow_directives*, a ``bool`` or an iterable of `str`. If ``True``, the default, + then directives are permitted, and the *allow_include* parameter controls whether + ``$INCLUDE`` is permitted. If ``False`` or an empty iterable, then no directive + processing is done and any directive-like text will be treated as a regular owner + name. If a non-empty iterable, then only the listed directives (including the + ``$``) are allowed. + + Raises ``dns.zone.NoSOA`` if there is no SOA RRset. + + Raises ``dns.zone.NoNS`` if there is no NS RRset. + + Raises ``KeyError`` if there is no origin node. + + Returns a subclass of ``dns.zone.Zone``. + """ + + if isinstance(f, str): + if filename is None: + filename = f + cm: contextlib.AbstractContextManager = open(f) + else: + cm = contextlib.nullcontext(f) + with cm as f: + return _from_text( + f, + origin, + rdclass, + relativize, + zone_factory, + filename, + allow_include, + check_origin, + idna_codec, + allow_directives, + ) + assert False # make mypy happy lgtm[py/unreachable-statement] + + +def from_xfr( + xfr: Any, + zone_factory: Any = Zone, + relativize: bool = True, + check_origin: bool = True, +) -> Zone: + """Convert the output of a zone transfer generator into a zone object. + + *xfr*, a generator of ``dns.message.Message`` objects, typically + ``dns.query.xfr()``. + + *relativize*, a ``bool``, determine's whether domain names are + relativized to the zone's origin. The default is ``True``. + It is essential that the relativize setting matches the one specified + to the generator. + + *check_origin*, a ``bool``. If ``True``, the default, then sanity + checks of the origin node will be made by calling the zone's + ``check_origin()`` method. + + Raises ``dns.zone.NoSOA`` if there is no SOA RRset. + + Raises ``dns.zone.NoNS`` if there is no NS RRset. + + Raises ``KeyError`` if there is no origin node. + + Raises ``ValueError`` if no messages are yielded by the generator. + + Returns a subclass of ``dns.zone.Zone``. + """ + + z = None + for r in xfr: + if z is None: + if relativize: + origin = r.origin + else: + origin = r.answer[0].name + rdclass = r.answer[0].rdclass + z = zone_factory(origin, rdclass, relativize=relativize) + for rrset in r.answer: + znode = z.nodes.get(rrset.name) + if not znode: + znode = z.node_factory() + z.nodes[rrset.name] = znode + zrds = znode.find_rdataset(rrset.rdclass, rrset.rdtype, rrset.covers, True) + zrds.update_ttl(rrset.ttl) + for rd in rrset: + zrds.add(rd) + if z is None: + raise ValueError("empty transfer") + if check_origin: + z.check_origin() + return z diff --git a/.venv/lib/python3.12/site-packages/dns/zonefile.py b/.venv/lib/python3.12/site-packages/dns/zonefile.py new file mode 100644 index 0000000..af064e7 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/zonefile.py @@ -0,0 +1,746 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +# Copyright (C) 2003-2007, 2009-2011 Nominum, Inc. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose with or without fee is hereby granted, +# provided that the above copyright notice and this permission notice +# appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +# ANY SPECIAL, DIRECT, 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. + +"""DNS Zones.""" + +import re +import sys +from typing import Any, Iterable, List, Optional, Set, Tuple, Union + +import dns.exception +import dns.grange +import dns.name +import dns.node +import dns.rdata +import dns.rdataclass +import dns.rdatatype +import dns.rdtypes.ANY.SOA +import dns.rrset +import dns.tokenizer +import dns.transaction +import dns.ttl + + +class UnknownOrigin(dns.exception.DNSException): + """Unknown origin""" + + +class CNAMEAndOtherData(dns.exception.DNSException): + """A node has a CNAME and other data""" + + +def _check_cname_and_other_data(txn, name, rdataset): + rdataset_kind = dns.node.NodeKind.classify_rdataset(rdataset) + node = txn.get_node(name) + if node is None: + # empty nodes are neutral. + return + node_kind = node.classify() + if ( + node_kind == dns.node.NodeKind.CNAME + and rdataset_kind == dns.node.NodeKind.REGULAR + ): + raise CNAMEAndOtherData("rdataset type is not compatible with a CNAME node") + elif ( + node_kind == dns.node.NodeKind.REGULAR + and rdataset_kind == dns.node.NodeKind.CNAME + ): + raise CNAMEAndOtherData( + "CNAME rdataset is not compatible with a regular data node" + ) + # Otherwise at least one of the node and the rdataset is neutral, so + # adding the rdataset is ok + + +SavedStateType = Tuple[ + dns.tokenizer.Tokenizer, + Optional[dns.name.Name], # current_origin + Optional[dns.name.Name], # last_name + Optional[Any], # current_file + int, # last_ttl + bool, # last_ttl_known + int, # default_ttl + bool, +] # default_ttl_known + + +def _upper_dollarize(s): + s = s.upper() + if not s.startswith("$"): + s = "$" + s + return s + + +class Reader: + """Read a DNS zone file into a transaction.""" + + def __init__( + self, + tok: dns.tokenizer.Tokenizer, + rdclass: dns.rdataclass.RdataClass, + txn: dns.transaction.Transaction, + allow_include: bool = False, + allow_directives: Union[bool, Iterable[str]] = True, + force_name: Optional[dns.name.Name] = None, + force_ttl: Optional[int] = None, + force_rdclass: Optional[dns.rdataclass.RdataClass] = None, + force_rdtype: Optional[dns.rdatatype.RdataType] = None, + default_ttl: Optional[int] = None, + ): + self.tok = tok + (self.zone_origin, self.relativize, _) = txn.manager.origin_information() + self.current_origin = self.zone_origin + self.last_ttl = 0 + self.last_ttl_known = False + if force_ttl is not None: + default_ttl = force_ttl + if default_ttl is None: + self.default_ttl = 0 + self.default_ttl_known = False + else: + self.default_ttl = default_ttl + self.default_ttl_known = True + self.last_name = self.current_origin + self.zone_rdclass = rdclass + self.txn = txn + self.saved_state: List[SavedStateType] = [] + self.current_file: Optional[Any] = None + self.allowed_directives: Set[str] + if allow_directives is True: + self.allowed_directives = {"$GENERATE", "$ORIGIN", "$TTL"} + if allow_include: + self.allowed_directives.add("$INCLUDE") + elif allow_directives is False: + # allow_include was ignored in earlier releases if allow_directives was + # False, so we continue that. + self.allowed_directives = set() + else: + # Note that if directives are explicitly specified, then allow_include + # is ignored. + self.allowed_directives = set(_upper_dollarize(d) for d in allow_directives) + self.force_name = force_name + self.force_ttl = force_ttl + self.force_rdclass = force_rdclass + self.force_rdtype = force_rdtype + self.txn.check_put_rdataset(_check_cname_and_other_data) + + def _eat_line(self): + while 1: + token = self.tok.get() + if token.is_eol_or_eof(): + break + + def _get_identifier(self): + token = self.tok.get() + if not token.is_identifier(): + raise dns.exception.SyntaxError + return token + + def _rr_line(self): + """Process one line from a DNS zone file.""" + token = None + # Name + if self.force_name is not None: + name = self.force_name + else: + if self.current_origin is None: + raise UnknownOrigin + token = self.tok.get(want_leading=True) + if not token.is_whitespace(): + self.last_name = self.tok.as_name(token, self.current_origin) + else: + token = self.tok.get() + if token.is_eol_or_eof(): + # treat leading WS followed by EOL/EOF as if they were EOL/EOF. + return + self.tok.unget(token) + name = self.last_name + if not name.is_subdomain(self.zone_origin): + self._eat_line() + return + if self.relativize: + name = name.relativize(self.zone_origin) + + # TTL + if self.force_ttl is not None: + ttl = self.force_ttl + self.last_ttl = ttl + self.last_ttl_known = True + else: + token = self._get_identifier() + ttl = None + try: + ttl = dns.ttl.from_text(token.value) + self.last_ttl = ttl + self.last_ttl_known = True + token = None + except dns.ttl.BadTTL: + self.tok.unget(token) + + # Class + if self.force_rdclass is not None: + rdclass = self.force_rdclass + else: + token = self._get_identifier() + try: + rdclass = dns.rdataclass.from_text(token.value) + except dns.exception.SyntaxError: + raise + except Exception: + rdclass = self.zone_rdclass + self.tok.unget(token) + if rdclass != self.zone_rdclass: + raise dns.exception.SyntaxError("RR class is not zone's class") + + if ttl is None: + # support for syntax + token = self._get_identifier() + ttl = None + try: + ttl = dns.ttl.from_text(token.value) + self.last_ttl = ttl + self.last_ttl_known = True + token = None + except dns.ttl.BadTTL: + if self.default_ttl_known: + ttl = self.default_ttl + elif self.last_ttl_known: + ttl = self.last_ttl + self.tok.unget(token) + + # Type + if self.force_rdtype is not None: + rdtype = self.force_rdtype + else: + token = self._get_identifier() + try: + rdtype = dns.rdatatype.from_text(token.value) + except Exception: + raise dns.exception.SyntaxError("unknown rdatatype '%s'" % token.value) + + try: + rd = dns.rdata.from_text( + rdclass, + rdtype, + self.tok, + self.current_origin, + self.relativize, + self.zone_origin, + ) + except dns.exception.SyntaxError: + # Catch and reraise. + raise + except Exception: + # All exceptions that occur in the processing of rdata + # are treated as syntax errors. This is not strictly + # correct, but it is correct almost all of the time. + # We convert them to syntax errors so that we can emit + # helpful filename:line info. + (ty, va) = sys.exc_info()[:2] + raise dns.exception.SyntaxError( + "caught exception {}: {}".format(str(ty), str(va)) + ) + + if not self.default_ttl_known and rdtype == dns.rdatatype.SOA: + # The pre-RFC2308 and pre-BIND9 behavior inherits the zone default + # TTL from the SOA minttl if no $TTL statement is present before the + # SOA is parsed. + self.default_ttl = rd.minimum + self.default_ttl_known = True + if ttl is None: + # if we didn't have a TTL on the SOA, set it! + ttl = rd.minimum + + # TTL check. We had to wait until now to do this as the SOA RR's + # own TTL can be inferred from its minimum. + if ttl is None: + raise dns.exception.SyntaxError("Missing default TTL value") + + self.txn.add(name, ttl, rd) + + def _parse_modify(self, side: str) -> Tuple[str, str, int, int, str]: + # Here we catch everything in '{' '}' in a group so we can replace it + # with ''. + is_generate1 = re.compile(r"^.*\$({(\+|-?)(\d+),(\d+),(.)}).*$") + is_generate2 = re.compile(r"^.*\$({(\+|-?)(\d+)}).*$") + is_generate3 = re.compile(r"^.*\$({(\+|-?)(\d+),(\d+)}).*$") + # Sometimes there are modifiers in the hostname. These come after + # the dollar sign. They are in the form: ${offset[,width[,base]]}. + # Make names + g1 = is_generate1.match(side) + if g1: + mod, sign, offset, width, base = g1.groups() + if sign == "": + sign = "+" + g2 = is_generate2.match(side) + if g2: + mod, sign, offset = g2.groups() + if sign == "": + sign = "+" + width = 0 + base = "d" + g3 = is_generate3.match(side) + if g3: + mod, sign, offset, width = g3.groups() + if sign == "": + sign = "+" + base = "d" + + if not (g1 or g2 or g3): + mod = "" + sign = "+" + offset = 0 + width = 0 + base = "d" + + offset = int(offset) + width = int(width) + + if sign not in ["+", "-"]: + raise dns.exception.SyntaxError("invalid offset sign %s" % sign) + if base not in ["d", "o", "x", "X", "n", "N"]: + raise dns.exception.SyntaxError("invalid type %s" % base) + + return mod, sign, offset, width, base + + def _generate_line(self): + # range lhs [ttl] [class] type rhs [ comment ] + """Process one line containing the GENERATE statement from a DNS + zone file.""" + if self.current_origin is None: + raise UnknownOrigin + + token = self.tok.get() + # Range (required) + try: + start, stop, step = dns.grange.from_text(token.value) + token = self.tok.get() + if not token.is_identifier(): + raise dns.exception.SyntaxError + except Exception: + raise dns.exception.SyntaxError + + # lhs (required) + try: + lhs = token.value + token = self.tok.get() + if not token.is_identifier(): + raise dns.exception.SyntaxError + except Exception: + raise dns.exception.SyntaxError + + # TTL + try: + ttl = dns.ttl.from_text(token.value) + self.last_ttl = ttl + self.last_ttl_known = True + token = self.tok.get() + if not token.is_identifier(): + raise dns.exception.SyntaxError + except dns.ttl.BadTTL: + if not (self.last_ttl_known or self.default_ttl_known): + raise dns.exception.SyntaxError("Missing default TTL value") + if self.default_ttl_known: + ttl = self.default_ttl + elif self.last_ttl_known: + ttl = self.last_ttl + # Class + try: + rdclass = dns.rdataclass.from_text(token.value) + token = self.tok.get() + if not token.is_identifier(): + raise dns.exception.SyntaxError + except dns.exception.SyntaxError: + raise dns.exception.SyntaxError + except Exception: + rdclass = self.zone_rdclass + if rdclass != self.zone_rdclass: + raise dns.exception.SyntaxError("RR class is not zone's class") + # Type + try: + rdtype = dns.rdatatype.from_text(token.value) + token = self.tok.get() + if not token.is_identifier(): + raise dns.exception.SyntaxError + except Exception: + raise dns.exception.SyntaxError("unknown rdatatype '%s'" % token.value) + + # rhs (required) + rhs = token.value + + def _calculate_index(counter: int, offset_sign: str, offset: int) -> int: + """Calculate the index from the counter and offset.""" + if offset_sign == "-": + offset *= -1 + return counter + offset + + def _format_index(index: int, base: str, width: int) -> str: + """Format the index with the given base, and zero-fill it + to the given width.""" + if base in ["d", "o", "x", "X"]: + return format(index, base).zfill(width) + + # base can only be n or N here + hexa = _format_index(index, "x", width) + nibbles = ".".join(hexa[::-1])[:width] + if base == "N": + nibbles = nibbles.upper() + return nibbles + + lmod, lsign, loffset, lwidth, lbase = self._parse_modify(lhs) + rmod, rsign, roffset, rwidth, rbase = self._parse_modify(rhs) + for i in range(start, stop + 1, step): + # +1 because bind is inclusive and python is exclusive + + lindex = _calculate_index(i, lsign, loffset) + rindex = _calculate_index(i, rsign, roffset) + + lzfindex = _format_index(lindex, lbase, lwidth) + rzfindex = _format_index(rindex, rbase, rwidth) + + name = lhs.replace("$%s" % (lmod), lzfindex) + rdata = rhs.replace("$%s" % (rmod), rzfindex) + + self.last_name = dns.name.from_text( + name, self.current_origin, self.tok.idna_codec + ) + name = self.last_name + if not name.is_subdomain(self.zone_origin): + self._eat_line() + return + if self.relativize: + name = name.relativize(self.zone_origin) + + try: + rd = dns.rdata.from_text( + rdclass, + rdtype, + rdata, + self.current_origin, + self.relativize, + self.zone_origin, + ) + except dns.exception.SyntaxError: + # Catch and reraise. + raise + except Exception: + # All exceptions that occur in the processing of rdata + # are treated as syntax errors. This is not strictly + # correct, but it is correct almost all of the time. + # We convert them to syntax errors so that we can emit + # helpful filename:line info. + (ty, va) = sys.exc_info()[:2] + raise dns.exception.SyntaxError( + "caught exception %s: %s" % (str(ty), str(va)) + ) + + self.txn.add(name, ttl, rd) + + def read(self) -> None: + """Read a DNS zone file and build a zone object. + + @raises dns.zone.NoSOA: No SOA RR was found at the zone origin + @raises dns.zone.NoNS: No NS RRset was found at the zone origin + """ + + try: + while 1: + token = self.tok.get(True, True) + if token.is_eof(): + if self.current_file is not None: + self.current_file.close() + if len(self.saved_state) > 0: + ( + self.tok, + self.current_origin, + self.last_name, + self.current_file, + self.last_ttl, + self.last_ttl_known, + self.default_ttl, + self.default_ttl_known, + ) = self.saved_state.pop(-1) + continue + break + elif token.is_eol(): + continue + elif token.is_comment(): + self.tok.get_eol() + continue + elif token.value[0] == "$" and len(self.allowed_directives) > 0: + # Note that we only run directive processing code if at least + # one directive is allowed in order to be backwards compatible + c = token.value.upper() + if c not in self.allowed_directives: + raise dns.exception.SyntaxError( + f"zone file directive '{c}' is not allowed" + ) + if c == "$TTL": + token = self.tok.get() + if not token.is_identifier(): + raise dns.exception.SyntaxError("bad $TTL") + self.default_ttl = dns.ttl.from_text(token.value) + self.default_ttl_known = True + self.tok.get_eol() + elif c == "$ORIGIN": + self.current_origin = self.tok.get_name() + self.tok.get_eol() + if self.zone_origin is None: + self.zone_origin = self.current_origin + self.txn._set_origin(self.current_origin) + elif c == "$INCLUDE": + token = self.tok.get() + filename = token.value + token = self.tok.get() + new_origin: Optional[dns.name.Name] + if token.is_identifier(): + new_origin = dns.name.from_text( + token.value, self.current_origin, self.tok.idna_codec + ) + self.tok.get_eol() + elif not token.is_eol_or_eof(): + raise dns.exception.SyntaxError("bad origin in $INCLUDE") + else: + new_origin = self.current_origin + self.saved_state.append( + ( + self.tok, + self.current_origin, + self.last_name, + self.current_file, + self.last_ttl, + self.last_ttl_known, + self.default_ttl, + self.default_ttl_known, + ) + ) + self.current_file = open(filename, "r") + self.tok = dns.tokenizer.Tokenizer(self.current_file, filename) + self.current_origin = new_origin + elif c == "$GENERATE": + self._generate_line() + else: + raise dns.exception.SyntaxError( + f"Unknown zone file directive '{c}'" + ) + continue + self.tok.unget(token) + self._rr_line() + except dns.exception.SyntaxError as detail: + (filename, line_number) = self.tok.where() + if detail is None: + detail = "syntax error" + ex = dns.exception.SyntaxError( + "%s:%d: %s" % (filename, line_number, detail) + ) + tb = sys.exc_info()[2] + raise ex.with_traceback(tb) from None + + +class RRsetsReaderTransaction(dns.transaction.Transaction): + def __init__(self, manager, replacement, read_only): + assert not read_only + super().__init__(manager, replacement, read_only) + self.rdatasets = {} + + def _get_rdataset(self, name, rdtype, covers): + return self.rdatasets.get((name, rdtype, covers)) + + def _get_node(self, name): + rdatasets = [] + for (rdataset_name, _, _), rdataset in self.rdatasets.items(): + if name == rdataset_name: + rdatasets.append(rdataset) + if len(rdatasets) == 0: + return None + node = dns.node.Node() + node.rdatasets = rdatasets + return node + + def _put_rdataset(self, name, rdataset): + self.rdatasets[(name, rdataset.rdtype, rdataset.covers)] = rdataset + + def _delete_name(self, name): + # First remove any changes involving the name + remove = [] + for key in self.rdatasets: + if key[0] == name: + remove.append(key) + if len(remove) > 0: + for key in remove: + del self.rdatasets[key] + + def _delete_rdataset(self, name, rdtype, covers): + try: + del self.rdatasets[(name, rdtype, covers)] + except KeyError: + pass + + def _name_exists(self, name): + for n, _, _ in self.rdatasets: + if n == name: + return True + return False + + def _changed(self): + return len(self.rdatasets) > 0 + + def _end_transaction(self, commit): + if commit and self._changed(): + rrsets = [] + for (name, _, _), rdataset in self.rdatasets.items(): + rrset = dns.rrset.RRset( + name, rdataset.rdclass, rdataset.rdtype, rdataset.covers + ) + rrset.update(rdataset) + rrsets.append(rrset) + self.manager.set_rrsets(rrsets) + + def _set_origin(self, origin): + pass + + def _iterate_rdatasets(self): + raise NotImplementedError # pragma: no cover + + def _iterate_names(self): + raise NotImplementedError # pragma: no cover + + +class RRSetsReaderManager(dns.transaction.TransactionManager): + def __init__( + self, origin=dns.name.root, relativize=False, rdclass=dns.rdataclass.IN + ): + self.origin = origin + self.relativize = relativize + self.rdclass = rdclass + self.rrsets = [] + + def reader(self): # pragma: no cover + raise NotImplementedError + + def writer(self, replacement=False): + assert replacement is True + return RRsetsReaderTransaction(self, True, False) + + def get_class(self): + return self.rdclass + + def origin_information(self): + if self.relativize: + effective = dns.name.empty + else: + effective = self.origin + return (self.origin, self.relativize, effective) + + def set_rrsets(self, rrsets): + self.rrsets = rrsets + + +def read_rrsets( + text: Any, + name: Optional[Union[dns.name.Name, str]] = None, + ttl: Optional[int] = None, + rdclass: Optional[Union[dns.rdataclass.RdataClass, str]] = dns.rdataclass.IN, + default_rdclass: Union[dns.rdataclass.RdataClass, str] = dns.rdataclass.IN, + rdtype: Optional[Union[dns.rdatatype.RdataType, str]] = None, + default_ttl: Optional[Union[int, str]] = None, + idna_codec: Optional[dns.name.IDNACodec] = None, + origin: Optional[Union[dns.name.Name, str]] = dns.name.root, + relativize: bool = False, +) -> List[dns.rrset.RRset]: + """Read one or more rrsets from the specified text, possibly subject + to restrictions. + + *text*, a file object or a string, is the input to process. + + *name*, a string, ``dns.name.Name``, or ``None``, is the owner name of + the rrset. If not ``None``, then the owner name is "forced", and the + input must not specify an owner name. If ``None``, then any owner names + are allowed and must be present in the input. + + *ttl*, an ``int``, string, or None. If not ``None``, the the TTL is + forced to be the specified value and the input must not specify a TTL. + If ``None``, then a TTL may be specified in the input. If it is not + specified, then the *default_ttl* will be used. + + *rdclass*, a ``dns.rdataclass.RdataClass``, string, or ``None``. If + not ``None``, then the class is forced to the specified value, and the + input must not specify a class. If ``None``, then the input may specify + a class that matches *default_rdclass*. Note that it is not possible to + return rrsets with differing classes; specifying ``None`` for the class + simply allows the user to optionally type a class as that may be convenient + when cutting and pasting. + + *default_rdclass*, a ``dns.rdataclass.RdataClass`` or string. The class + of the returned rrsets. + + *rdtype*, a ``dns.rdatatype.RdataType``, string, or ``None``. If not + ``None``, then the type is forced to the specified value, and the + input must not specify a type. If ``None``, then a type must be present + for each RR. + + *default_ttl*, an ``int``, string, or ``None``. If not ``None``, then if + the TTL is not forced and is not specified, then this value will be used. + if ``None``, then if the TTL is not forced an error will occur if the TTL + is not specified. + + *idna_codec*, a ``dns.name.IDNACodec``, specifies the IDNA + encoder/decoder. If ``None``, the default IDNA 2003 encoder/decoder + is used. Note that codecs only apply to the owner name; dnspython does + not do IDNA for names in rdata, as there is no IDNA zonefile format. + + *origin*, a string, ``dns.name.Name``, or ``None``, is the origin for any + relative names in the input, and also the origin to relativize to if + *relativize* is ``True``. + + *relativize*, a bool. If ``True``, names are relativized to the *origin*; + if ``False`` then any relative names in the input are made absolute by + appending the *origin*. + """ + if isinstance(origin, str): + origin = dns.name.from_text(origin, dns.name.root, idna_codec) + if isinstance(name, str): + name = dns.name.from_text(name, origin, idna_codec) + if isinstance(ttl, str): + ttl = dns.ttl.from_text(ttl) + if isinstance(default_ttl, str): + default_ttl = dns.ttl.from_text(default_ttl) + if rdclass is not None: + rdclass = dns.rdataclass.RdataClass.make(rdclass) + else: + rdclass = None + default_rdclass = dns.rdataclass.RdataClass.make(default_rdclass) + if rdtype is not None: + rdtype = dns.rdatatype.RdataType.make(rdtype) + else: + rdtype = None + manager = RRSetsReaderManager(origin, relativize, default_rdclass) + with manager.writer(True) as txn: + tok = dns.tokenizer.Tokenizer(text, "", idna_codec=idna_codec) + reader = Reader( + tok, + default_rdclass, + txn, + allow_directives=False, + force_name=name, + force_ttl=ttl, + force_rdclass=rdclass, + force_rdtype=rdtype, + default_ttl=default_ttl, + ) + reader.read() + return manager.rrsets diff --git a/.venv/lib/python3.12/site-packages/dns/zonetypes.py b/.venv/lib/python3.12/site-packages/dns/zonetypes.py new file mode 100644 index 0000000..195ee2e --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dns/zonetypes.py @@ -0,0 +1,37 @@ +# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license + +"""Common zone-related types.""" + +# This is a separate file to avoid import circularity between dns.zone and +# the implementation of the ZONEMD type. + +import hashlib + +import dns.enum + + +class DigestScheme(dns.enum.IntEnum): + """ZONEMD Scheme""" + + SIMPLE = 1 + + @classmethod + def _maximum(cls): + return 255 + + +class DigestHashAlgorithm(dns.enum.IntEnum): + """ZONEMD Hash Algorithm""" + + SHA384 = 1 + SHA512 = 2 + + @classmethod + def _maximum(cls): + return 255 + + +_digest_hashers = { + DigestHashAlgorithm.SHA384: hashlib.sha384, + DigestHashAlgorithm.SHA512: hashlib.sha512, +} diff --git a/.venv/lib/python3.12/site-packages/dnspython-2.6.1.dist-info/INSTALLER b/.venv/lib/python3.12/site-packages/dnspython-2.6.1.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dnspython-2.6.1.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/.venv/lib/python3.12/site-packages/dnspython-2.6.1.dist-info/METADATA b/.venv/lib/python3.12/site-packages/dnspython-2.6.1.dist-info/METADATA new file mode 100644 index 0000000..129184e --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dnspython-2.6.1.dist-info/METADATA @@ -0,0 +1,147 @@ +Metadata-Version: 2.1 +Name: dnspython +Version: 2.6.1 +Summary: DNS toolkit +Project-URL: homepage, https://www.dnspython.org +Project-URL: repository, https://github.com/rthalley/dnspython.git +Project-URL: documentation, https://dnspython.readthedocs.io/en/stable/ +Project-URL: issues, https://github.com/rthalley/dnspython/issues +Author-email: Bob Halley +License-Expression: ISC +License-File: LICENSE +Classifier: Development Status :: 5 - Production/Stable +Classifier: Intended Audience :: Developers +Classifier: Intended Audience :: System Administrators +Classifier: License :: OSI Approved :: ISC License (ISCL) +Classifier: Operating System :: Microsoft :: Windows +Classifier: Operating System :: POSIX +Classifier: Programming Language :: Python +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3.8 +Classifier: Programming Language :: Python :: 3.9 +Classifier: Programming Language :: Python :: 3.10 +Classifier: Programming Language :: Python :: 3.11 +Classifier: Programming Language :: Python :: 3.12 +Classifier: Topic :: Internet :: Name Service (DNS) +Classifier: Topic :: Software Development :: Libraries :: Python Modules +Requires-Python: >=3.8 +Provides-Extra: dev +Requires-Dist: black>=23.1.0; extra == 'dev' +Requires-Dist: coverage>=7.0; extra == 'dev' +Requires-Dist: flake8>=7; extra == 'dev' +Requires-Dist: mypy>=1.8; extra == 'dev' +Requires-Dist: pylint>=3; extra == 'dev' +Requires-Dist: pytest-cov>=4.1.0; extra == 'dev' +Requires-Dist: pytest>=7.4; extra == 'dev' +Requires-Dist: sphinx>=7.2.0; extra == 'dev' +Requires-Dist: twine>=4.0.0; extra == 'dev' +Requires-Dist: wheel>=0.42.0; extra == 'dev' +Provides-Extra: dnssec +Requires-Dist: cryptography>=41; extra == 'dnssec' +Provides-Extra: doh +Requires-Dist: h2>=4.1.0; extra == 'doh' +Requires-Dist: httpcore>=1.0.0; extra == 'doh' +Requires-Dist: httpx>=0.26.0; extra == 'doh' +Provides-Extra: doq +Requires-Dist: aioquic>=0.9.25; extra == 'doq' +Provides-Extra: idna +Requires-Dist: idna>=3.6; extra == 'idna' +Provides-Extra: trio +Requires-Dist: trio>=0.23; extra == 'trio' +Provides-Extra: wmi +Requires-Dist: wmi>=1.5.1; extra == 'wmi' +Description-Content-Type: text/markdown + +# dnspython + +[![Build Status](https://github.com/rthalley/dnspython/actions/workflows/python-package.yml/badge.svg)](https://github.com/rthalley/dnspython/actions/) +[![Documentation Status](https://readthedocs.org/projects/dnspython/badge/?version=latest)](https://dnspython.readthedocs.io/en/latest/?badge=latest) +[![PyPI version](https://badge.fury.io/py/dnspython.svg)](https://badge.fury.io/py/dnspython) +[![License: ISC](https://img.shields.io/badge/License-ISC-brightgreen.svg)](https://opensource.org/licenses/ISC) +[![Coverage](https://codecov.io/github/rthalley/dnspython/coverage.svg?branch=master)](https://codecov.io/github/rthalley/dnspython) +[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black) + +## INTRODUCTION + +dnspython is a DNS toolkit for Python. It supports almost all record types. It +can be used for queries, zone transfers, and dynamic updates. It supports TSIG +authenticated messages and EDNS0. + +dnspython provides both high and low level access to DNS. The high level classes +perform queries for data of a given name, type, and class, and return an answer +set. The low level classes allow direct manipulation of DNS zones, messages, +names, and records. + +To see a few of the ways dnspython can be used, look in the `examples/` +directory. + +dnspython is a utility to work with DNS, `/etc/hosts` is thus not used. For +simple forward DNS lookups, it's better to use `socket.getaddrinfo()` or +`socket.gethostbyname()`. + +dnspython originated at Nominum where it was developed +to facilitate the testing of DNS software. + +## ABOUT THIS RELEASE + +This is dnspython 2.6.1. +Please read +[What's New](https://dnspython.readthedocs.io/en/stable/whatsnew.html) for +information about the changes in this release. + +## INSTALLATION + +* Many distributions have dnspython packaged for you, so you should + check there first. +* To use a wheel downloaded from PyPi, run: + + pip install dnspython + +* To install from the source code, go into the top-level of the source code + and run: + +``` + pip install --upgrade pip build + python -m build + pip install dist/*.whl +``` + +* To install the latest from the master branch, run `pip install git+https://github.com/rthalley/dnspython.git` + +Dnspython's default installation does not depend on any modules other than +those in the Python standard library. To use some features, additional modules +must be installed. For convenience, pip options are defined for the +requirements. + +If you want to use DNS-over-HTTPS, run +`pip install dnspython[doh]`. + +If you want to use DNSSEC functionality, run +`pip install dnspython[dnssec]`. + +If you want to use internationalized domain names (IDNA) +functionality, you must run +`pip install dnspython[idna]` + +If you want to use the Trio asynchronous I/O package, run +`pip install dnspython[trio]`. + +If you want to use WMI on Windows to determine the active DNS settings +instead of the default registry scanning method, run +`pip install dnspython[wmi]`. + +If you want to try the experimental DNS-over-QUIC code, run +`pip install dnspython[doq]`. + +Note that you can install any combination of the above, e.g.: +`pip install dnspython[doh,dnssec,idna]` + +### Notices + +Python 2.x support ended with the release of 1.16.0. Dnspython 2.0.0 through +2.2.x support Python 3.6 and later. For dnspython 2.3.x, the minimum +supported Python version is 3.7, and for 2.4.x the minimum supported verison is 3.8. +We plan to align future support with the lifetime of the Python 3 versions. + +Documentation has moved to +[dnspython.readthedocs.io](https://dnspython.readthedocs.io). diff --git a/.venv/lib/python3.12/site-packages/dnspython-2.6.1.dist-info/RECORD b/.venv/lib/python3.12/site-packages/dnspython-2.6.1.dist-info/RECORD new file mode 100644 index 0000000..ec1dbb9 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dnspython-2.6.1.dist-info/RECORD @@ -0,0 +1,291 @@ +dns/__init__.py,sha256=YJZtDG14Idw5ui3h1nWooSwPM9gsxQgB8M0GBZ3aly0,1663 +dns/__pycache__/__init__.cpython-312.pyc,, +dns/__pycache__/_asyncbackend.cpython-312.pyc,, +dns/__pycache__/_asyncio_backend.cpython-312.pyc,, +dns/__pycache__/_ddr.cpython-312.pyc,, +dns/__pycache__/_features.cpython-312.pyc,, +dns/__pycache__/_immutable_ctx.cpython-312.pyc,, +dns/__pycache__/_trio_backend.cpython-312.pyc,, +dns/__pycache__/asyncbackend.cpython-312.pyc,, +dns/__pycache__/asyncquery.cpython-312.pyc,, +dns/__pycache__/asyncresolver.cpython-312.pyc,, +dns/__pycache__/dnssec.cpython-312.pyc,, +dns/__pycache__/dnssectypes.cpython-312.pyc,, +dns/__pycache__/e164.cpython-312.pyc,, +dns/__pycache__/edns.cpython-312.pyc,, +dns/__pycache__/entropy.cpython-312.pyc,, +dns/__pycache__/enum.cpython-312.pyc,, +dns/__pycache__/exception.cpython-312.pyc,, +dns/__pycache__/flags.cpython-312.pyc,, +dns/__pycache__/grange.cpython-312.pyc,, +dns/__pycache__/immutable.cpython-312.pyc,, +dns/__pycache__/inet.cpython-312.pyc,, +dns/__pycache__/ipv4.cpython-312.pyc,, +dns/__pycache__/ipv6.cpython-312.pyc,, +dns/__pycache__/message.cpython-312.pyc,, +dns/__pycache__/name.cpython-312.pyc,, +dns/__pycache__/namedict.cpython-312.pyc,, +dns/__pycache__/nameserver.cpython-312.pyc,, +dns/__pycache__/node.cpython-312.pyc,, +dns/__pycache__/opcode.cpython-312.pyc,, +dns/__pycache__/query.cpython-312.pyc,, +dns/__pycache__/rcode.cpython-312.pyc,, +dns/__pycache__/rdata.cpython-312.pyc,, +dns/__pycache__/rdataclass.cpython-312.pyc,, +dns/__pycache__/rdataset.cpython-312.pyc,, +dns/__pycache__/rdatatype.cpython-312.pyc,, +dns/__pycache__/renderer.cpython-312.pyc,, +dns/__pycache__/resolver.cpython-312.pyc,, +dns/__pycache__/reversename.cpython-312.pyc,, +dns/__pycache__/rrset.cpython-312.pyc,, +dns/__pycache__/serial.cpython-312.pyc,, +dns/__pycache__/set.cpython-312.pyc,, +dns/__pycache__/tokenizer.cpython-312.pyc,, +dns/__pycache__/transaction.cpython-312.pyc,, +dns/__pycache__/tsig.cpython-312.pyc,, +dns/__pycache__/tsigkeyring.cpython-312.pyc,, +dns/__pycache__/ttl.cpython-312.pyc,, +dns/__pycache__/update.cpython-312.pyc,, +dns/__pycache__/version.cpython-312.pyc,, +dns/__pycache__/versioned.cpython-312.pyc,, +dns/__pycache__/win32util.cpython-312.pyc,, +dns/__pycache__/wire.cpython-312.pyc,, +dns/__pycache__/xfr.cpython-312.pyc,, +dns/__pycache__/zone.cpython-312.pyc,, +dns/__pycache__/zonefile.cpython-312.pyc,, +dns/__pycache__/zonetypes.cpython-312.pyc,, +dns/_asyncbackend.py,sha256=Ny0kGesm9wbLBnt-0u-tANOKsxcYt2jbMuRoRz_JZUA,2360 +dns/_asyncio_backend.py,sha256=q58xPdqAOLmOYOux8GFRyiH-fSZ7jiwZF-Jg2vHjYSU,8971 +dns/_ddr.py,sha256=rHXKC8kncCTT9N4KBh1flicl79nyDjQ-DDvq30MJ3B8,5247 +dns/_features.py,sha256=MUeyfM_nMYAYkasGfbY7I_15JmwftaZjseuP1L43MT0,2384 +dns/_immutable_ctx.py,sha256=gtoCLMmdHXI23zt5lRSIS3A4Ca3jZJngebdoFFOtiwU,2459 +dns/_trio_backend.py,sha256=Vab_wR2CxDgy2Jz3iM_64FZmP_kMUN9j8LS4eNl-Oig,8269 +dns/asyncbackend.py,sha256=82fXTFls_m7F_ekQbgUGOkoBbs4BI-GBLDZAWNGUvJ0,2796 +dns/asyncquery.py,sha256=Q7u04mbbqCoe9VxsqRcsWTPxgH2Cx49eWWgi2wUyZHU,26850 +dns/asyncresolver.py,sha256=GD86dCyW9YGKs6SggWXwBKEXifW7Qdx4cEAGFKY6fA4,17852 +dns/dnssec.py,sha256=xyYW1cf6eeFNXROrEs1pyY4TgC8jlmUiiootaPbVjjY,40693 +dns/dnssecalgs/__init__.py,sha256=DcnGIbL6m-USPSiLWHSw511awB7dytlljvCOOmzchS0,4279 +dns/dnssecalgs/__pycache__/__init__.cpython-312.pyc,, +dns/dnssecalgs/__pycache__/base.cpython-312.pyc,, +dns/dnssecalgs/__pycache__/cryptography.cpython-312.pyc,, +dns/dnssecalgs/__pycache__/dsa.cpython-312.pyc,, +dns/dnssecalgs/__pycache__/ecdsa.cpython-312.pyc,, +dns/dnssecalgs/__pycache__/eddsa.cpython-312.pyc,, +dns/dnssecalgs/__pycache__/rsa.cpython-312.pyc,, +dns/dnssecalgs/base.py,sha256=hsFHFr_eCYeDcI0eU6_WiLlOYL0GR4QJ__sXoMrIAfE,2446 +dns/dnssecalgs/cryptography.py,sha256=3uqMfRm-zCkJPOrxUqlu9CmdxIMy71dVor9eAHi0wZM,2425 +dns/dnssecalgs/dsa.py,sha256=hklh_HkT_ZffQBHQ7t6pKUStTH4x5nXlz8R9RUP72aY,3497 +dns/dnssecalgs/ecdsa.py,sha256=GWrJgEXAK08MCdbLk7LQcD2ajKqW_dbONWXh3wieLzw,3016 +dns/dnssecalgs/eddsa.py,sha256=9lQQZ92f2PiIhhylieInO-19aSTDQiyoY8X2kTkGlcs,1914 +dns/dnssecalgs/rsa.py,sha256=jWkhWKByylIo7Y9gAiiO8t8bowF8IZ0siVjgZpdhLSE,3555 +dns/dnssectypes.py,sha256=CyeuGTS_rM3zXr8wD9qMT9jkzvVfTY2JWckUcogG83E,1799 +dns/e164.py,sha256=EsK8cnOtOx7kQ0DmSwibcwkzp6efMWjbRiTyHZO8Q-M,3978 +dns/edns.py,sha256=d8QWhmRd6qlaGfO-tY6iDQZt9XUiyfJfKdjoGjvwOU4,15263 +dns/entropy.py,sha256=qkG8hXDLzrJS6R5My26iA59c0RhPwJNzuOhOCAZU5Bw,4242 +dns/enum.py,sha256=EepaunPKixTSrascy7iAe9UQEXXxP_MB5Gx4jUpHIhg,3691 +dns/exception.py,sha256=FphWy-JLRG06UUUq2VmUGwdPA1xWja_8YfrcffRFlQs,5957 +dns/flags.py,sha256=cQ3kTFyvcKiWHAxI5AwchNqxVOrsIrgJ6brgrH42Wq8,2750 +dns/grange.py,sha256=HA623Mv2mZDmOK_BZNDDakT0L6EHsMQU9lFFkE8dKr0,2148 +dns/immutable.py,sha256=InrtpKvPxl-74oYbzsyneZwAuX78hUqeG22f2aniZbk,2017 +dns/inet.py,sha256=j6jQs3K_ehVhDv-i4jwCKePr5HpEiSzvOXQ4uhgn1sU,5772 +dns/ipv4.py,sha256=qEUXtlqWDH_blicj6VMvyQhfX7-BF0gB_lWJliV-2FI,2552 +dns/ipv6.py,sha256=EyiF5T8t2oww9-W4ZA5Zk2GGnOjTy_uZ50CI7maed_8,6600 +dns/message.py,sha256=DyUtBHArPX-WGj_AtcngyIXZNpLppLZX-6q9TryL_wI,65993 +dns/name.py,sha256=eaR1wVR0rErnD3EPANquCuyqpbxy5VfFVhMenWlBPDE,42672 +dns/namedict.py,sha256=hJRYpKeQv6Bd2LaUOPV0L_a0eXEIuqgggPXaH4c3Tow,4000 +dns/nameserver.py,sha256=VkYRnX5wQ7RihAD6kYqidI_hb9NgKJSAE0GaYulNpHY,9909 +dns/node.py,sha256=NGZa0AUMq-CNledJ6wn1Rx6TFYc703cH2OraLysoNWM,12663 +dns/opcode.py,sha256=I6JyuFUL0msja_BYm6bzXHfbbfqUod_69Ss4xcv8xWQ,2730 +dns/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +dns/query.py,sha256=vB8C5u6HyjPWrEx9kUdTSg3kxrOoWbPGu7brC0eetIM,54832 +dns/quic/__init__.py,sha256=F6BybmRKnMGc4W8nX7K98PeyXiSwy1FHb_bJeA2lQSw,2202 +dns/quic/__pycache__/__init__.cpython-312.pyc,, +dns/quic/__pycache__/_asyncio.cpython-312.pyc,, +dns/quic/__pycache__/_common.cpython-312.pyc,, +dns/quic/__pycache__/_sync.cpython-312.pyc,, +dns/quic/__pycache__/_trio.cpython-312.pyc,, +dns/quic/_asyncio.py,sha256=vv4RR3Ol0Y1ZOj7rPAzXxy1UcWjPvhTGQvVkMidPs-o,8159 +dns/quic/_common.py,sha256=06TfauL2VciPYSfrL4gif1eR1rm-TRkQhS2Puuk5URU,7282 +dns/quic/_sync.py,sha256=kE0PRavzd27GPQ9UgYApXZ6SGSW2LwCt8k6XWUvrbVE,8133 +dns/quic/_trio.py,sha256=9zCCBtDs6GAtY_b8ck-A17QMiLZ0njjhVtfFT5qMP7s,7670 +dns/rcode.py,sha256=N6JjrIQjCdJy0boKIp8Hcky5tm__LSDscpDz3rE_sgU,4156 +dns/rdata.py,sha256=9cXM9Y9MK2hy9w5mYqmP-r7_aKjHosigfNn_SfqfGGw,29456 +dns/rdataclass.py,sha256=TK4W4ywB1L_X7EZqk2Gmwnu7vdQpolQF5DtQWyNk5xo,2984 +dns/rdataset.py,sha256=96gTaEIcYEL348VKtTOMAazXBVNtk7m0Xez0mF1eg4I,16756 +dns/rdatatype.py,sha256=gIdYZ0iHRlgiTEO-ftobUANmaAmjTnNc4JljMaP1OnQ,7339 +dns/rdtypes/ANY/AFSDB.py,sha256=k75wMwreF1DAfDymu4lHh16BUx7ulVP3PLeQBZnkurY,1661 +dns/rdtypes/ANY/AMTRELAY.py,sha256=19jfS61mT1CQT-8vf67ZylhDS9JVRVp4WCbFE-7l0jM,3381 +dns/rdtypes/ANY/AVC.py,sha256=SpsXYzlBirRWN0mGnQe0MdN6H8fvlgXPJX5PjOHnEak,1024 +dns/rdtypes/ANY/CAA.py,sha256=AHh59Is-4WiVWd26yovnPM3hXqKS-yx7IWfXSS0NZhE,2511 +dns/rdtypes/ANY/CDNSKEY.py,sha256=bJAdrBMsFHIJz8TF1AxZoNbdxVWBCRTG-bR_uR_r_G4,1225 +dns/rdtypes/ANY/CDS.py,sha256=Y9nIRUCAabztVLbxm2SXAdYapFemCOUuGh5JqroCDUs,1163 +dns/rdtypes/ANY/CERT.py,sha256=2Cu2LQM6-K4darqhHv1EM_blmpYpnrBIIX1GnL_rxKE,3533 +dns/rdtypes/ANY/CNAME.py,sha256=IHGGq2BDpeKUahTr1pvyBQgm0NGBI_vQ3Vs5mKTXO4w,1206 +dns/rdtypes/ANY/CSYNC.py,sha256=KkZ_rG6PfeL14il97nmJGWWmUGGS5o9nd2EqbJqOuYo,2439 +dns/rdtypes/ANY/DLV.py,sha256=J-pOrw5xXsDoaB9G0r6znlYXJtqtcqhsl1OXs6CPRU4,986 +dns/rdtypes/ANY/DNAME.py,sha256=yqXRtx4dAWwB4YCCv-qW6uaxeGhg2LPQ2uyKwWaMdXs,1150 +dns/rdtypes/ANY/DNSKEY.py,sha256=MD8HUVH5XXeAGOnFWg5aVz_w-2tXYwCeVXmzExhiIeQ,1223 +dns/rdtypes/ANY/DS.py,sha256=_gf8vk1O_uY8QXFjsfUw-bny-fm6e-QpCk3PT0JCyoM,995 +dns/rdtypes/ANY/EUI48.py,sha256=x0BkK0sY_tgzuCwfDYpw6tyuChHjjtbRpAgYhO0Y44o,1151 +dns/rdtypes/ANY/EUI64.py,sha256=1jCff2-SXHJLDnNDnMW8Cd_o-ok0P3x6zKy_bcCU5h4,1161 +dns/rdtypes/ANY/GPOS.py,sha256=pM3i6Tn4qwHWOGOuIuW9FENPlSXT_R4xsNJeGrrABc8,4433 +dns/rdtypes/ANY/HINFO.py,sha256=vYGCHGZmYOhtmxHlvPqrK7m4pBg3MSY5herBsKJTbKQ,2249 +dns/rdtypes/ANY/HIP.py,sha256=Ucrnndu3xDyHFB93AVUA3xW-r61GR50kpRHLyLacvZY,3228 +dns/rdtypes/ANY/ISDN.py,sha256=uymYB-ayZSBob6jQgXe4EefNB8-JMLW6VfxXn7ncwPg,2713 +dns/rdtypes/ANY/L32.py,sha256=TMz2kdGCd0siiQZyiocVDCSnvkOdjhUuYRFyf8o622M,1286 +dns/rdtypes/ANY/L64.py,sha256=sb2BjuPA0PQt67nEyT9rBt759C9e6lH71d3EJHGGnww,1592 +dns/rdtypes/ANY/LOC.py,sha256=hLkzgCxqEhg6fn5Uf-DJigKEIE6oavQ8rLpajp3HDLs,12024 +dns/rdtypes/ANY/LP.py,sha256=wTsKIjtK6vh66qZRLSsiE0k54GO8ieVBGZH8dzVvFnE,1338 +dns/rdtypes/ANY/MX.py,sha256=qQk83idY0-SbRMDmB15JOpJi7cSyiheF-ALUD0Ev19E,995 +dns/rdtypes/ANY/NID.py,sha256=N7Xx4kXf3yVAocTlCXQeJ3BtiQNPFPQVdL1iMuyl5W4,1544 +dns/rdtypes/ANY/NINFO.py,sha256=bdL_-6Bejb2EH-xwR1rfSr_9E3SDXLTAnov7x2924FI,1041 +dns/rdtypes/ANY/NS.py,sha256=ThfaPalUlhbyZyNyvBM3k-7onl3eJKq5wCORrOGtkMM,995 +dns/rdtypes/ANY/NSEC.py,sha256=6uRn1SxNuLRNumeoc76BkpECF8ztuqyaYviLjFe7FkQ,2475 +dns/rdtypes/ANY/NSEC3.py,sha256=696h-Zz30bmcT0n1rqoEtS5wqE6jIgsVGzaw5TfdGJo,4331 +dns/rdtypes/ANY/NSEC3PARAM.py,sha256=08p6NWS4DiLav1wOuPbxUxB9MtY2IPjfOMCtJwzzMuA,2635 +dns/rdtypes/ANY/OPENPGPKEY.py,sha256=Va0FGo_8vm1OeX62N5iDTWukAdLwrjTXIZeQ6oanE78,1851 +dns/rdtypes/ANY/OPT.py,sha256=W36RslT_Psp95OPUC70knumOYjKpaRHvGT27I-NV2qc,2561 +dns/rdtypes/ANY/PTR.py,sha256=5HcR1D77Otyk91vVY4tmqrfZfSxSXWyWvwIW-rIH5gc,997 +dns/rdtypes/ANY/RP.py,sha256=5Dgaava9mbLKr87XgbfKZPrunYPBaN8ejNzpmbW6r4s,2184 +dns/rdtypes/ANY/RRSIG.py,sha256=O8vwzS7ldfaj_x8DypvEGFsDSb7al-D7OEnprA3QQoo,4922 +dns/rdtypes/ANY/RT.py,sha256=2t9q3FZQ28iEyceeU25KU2Ur0T5JxELAu8BTwfOUgVw,1013 +dns/rdtypes/ANY/SMIMEA.py,sha256=6yjHuVDfIEodBU9wxbCGCDZ5cWYwyY6FCk-aq2VNU0s,222 +dns/rdtypes/ANY/SOA.py,sha256=Cn8yrag1YvrvwivQgWg-KXmOCaVQVdFHSkFF77w-CE0,3145 +dns/rdtypes/ANY/SPF.py,sha256=rA3Srs9ECQx-37lqm7Zf7aYmMpp_asv4tGS8_fSQ-CU,1022 +dns/rdtypes/ANY/SSHFP.py,sha256=l6TZH2R0kytiZGWez_g-Lq94o5a2xMuwLKwUwsPMx5w,2530 +dns/rdtypes/ANY/TKEY.py,sha256=HjJMIMl4Qb1Nt1JXS6iAymzd2nv_zdLWTt887PJU_5w,4931 +dns/rdtypes/ANY/TLSA.py,sha256=cytzebS3W7FFr9qeJ9gFSHq_bOwUk9aRVlXWHfnVrRs,218 +dns/rdtypes/ANY/TSIG.py,sha256=4fNQJSNWZXUKZejCciwQuUJtTw2g-YbPmqHrEj_pitg,4750 +dns/rdtypes/ANY/TXT.py,sha256=F1U9gIAhwXIV4UVT7CwOCEn_su6G1nJIdgWJsLktk20,1000 +dns/rdtypes/ANY/URI.py,sha256=dpcS8KwcJ2WJ7BkOp4CZYaUyRuw7U2S9GzvVwKUihQg,2921 +dns/rdtypes/ANY/X25.py,sha256=PxjYTKIuoq44LT2S2JHWOV8BOFD0ASqjq0S5VBeGkFM,1944 +dns/rdtypes/ANY/ZONEMD.py,sha256=JQicv69EvUxh4FCT7eZSLzzU5L5brw_dSM65Um2t5lQ,2393 +dns/rdtypes/ANY/__init__.py,sha256=Pox71HfsEnGGB1PGU44pwrrmjxPLQlA-IbX6nQRoA2M,1497 +dns/rdtypes/ANY/__pycache__/AFSDB.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/AMTRELAY.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/AVC.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/CAA.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/CDNSKEY.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/CDS.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/CERT.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/CNAME.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/CSYNC.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/DLV.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/DNAME.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/DNSKEY.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/DS.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/EUI48.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/EUI64.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/GPOS.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/HINFO.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/HIP.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/ISDN.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/L32.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/L64.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/LOC.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/LP.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/MX.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/NID.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/NINFO.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/NS.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/NSEC.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/NSEC3.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/NSEC3PARAM.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/OPENPGPKEY.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/OPT.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/PTR.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/RP.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/RRSIG.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/RT.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/SMIMEA.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/SOA.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/SPF.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/SSHFP.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/TKEY.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/TLSA.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/TSIG.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/TXT.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/URI.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/X25.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/ZONEMD.cpython-312.pyc,, +dns/rdtypes/ANY/__pycache__/__init__.cpython-312.pyc,, +dns/rdtypes/CH/A.py,sha256=3S3OhOkSc7_ZsZBVB4GhTS19LPrrZ-yQ8sAp957qEgI,2216 +dns/rdtypes/CH/__init__.py,sha256=GD9YeDKb9VBDo-J5rrChX1MWEGyQXuR9Htnbhg_iYLc,923 +dns/rdtypes/CH/__pycache__/A.cpython-312.pyc,, +dns/rdtypes/CH/__pycache__/__init__.cpython-312.pyc,, +dns/rdtypes/IN/A.py,sha256=FfFn3SqbpneL9Ky63COP50V2ZFxqS1ldCKJh39Enwug,1814 +dns/rdtypes/IN/AAAA.py,sha256=AxrOlYy-1TTTWeQypDKeXrDCrdHGor0EKCE4fxzSQGo,1820 +dns/rdtypes/IN/APL.py,sha256=ppyFwn0KYMdyDzphxd0BUhgTmZv0QnDMRLjzQQM793U,5097 +dns/rdtypes/IN/DHCID.py,sha256=zRUh_EOxUPVpJjWY5m7taX8q4Oz5K70785ZtKv5OTCU,1856 +dns/rdtypes/IN/HTTPS.py,sha256=P-IjwcvDQMmtoBgsDHglXF7KgLX73G6jEDqCKsnaGpQ,220 +dns/rdtypes/IN/IPSECKEY.py,sha256=RyIy9K0Yt0uJRjdr6cj5S95ELHHbl--0xV-Qq9O3QQk,3290 +dns/rdtypes/IN/KX.py,sha256=K1JwItL0n5G-YGFCjWeh0C9DyDD8G8VzicsBeQiNAv0,1013 +dns/rdtypes/IN/NAPTR.py,sha256=SaOK-0hIYImwLtb5Hqewi-e49ykJaQiLNvk8ZzNoG7Q,3750 +dns/rdtypes/IN/NSAP.py,sha256=3OUpPOSOxU8fcdi0Oe6Ex2ERXcQ-U3iNf6FftZMtNOw,2165 +dns/rdtypes/IN/NSAP_PTR.py,sha256=iTxlV6fr_Y9lqivLLncSHxEhmFqz5UEElDW3HMBtuCU,1015 +dns/rdtypes/IN/PX.py,sha256=vHDNN2rfLObuUKwpYDIvpPB482BqXlHA-ZQpQn9Sb_E,2756 +dns/rdtypes/IN/SRV.py,sha256=a0zGaUwzvih_a4Q9BViUTFs7NZaCqgl7mls3-KRVHm8,2769 +dns/rdtypes/IN/SVCB.py,sha256=HeFmi2v01F00Hott8FlvQ4R7aPxFmT7RF-gt45R5K_M,218 +dns/rdtypes/IN/WKS.py,sha256=kErSG5AO2qIuot_hkMHnQuZB1_uUzUirNdqBoCp97rk,3652 +dns/rdtypes/IN/__init__.py,sha256=HbI8aw9HWroI6SgEvl8Sx6FdkDswCCXMbSRuJy5o8LQ,1083 +dns/rdtypes/IN/__pycache__/A.cpython-312.pyc,, +dns/rdtypes/IN/__pycache__/AAAA.cpython-312.pyc,, +dns/rdtypes/IN/__pycache__/APL.cpython-312.pyc,, +dns/rdtypes/IN/__pycache__/DHCID.cpython-312.pyc,, +dns/rdtypes/IN/__pycache__/HTTPS.cpython-312.pyc,, +dns/rdtypes/IN/__pycache__/IPSECKEY.cpython-312.pyc,, +dns/rdtypes/IN/__pycache__/KX.cpython-312.pyc,, +dns/rdtypes/IN/__pycache__/NAPTR.cpython-312.pyc,, +dns/rdtypes/IN/__pycache__/NSAP.cpython-312.pyc,, +dns/rdtypes/IN/__pycache__/NSAP_PTR.cpython-312.pyc,, +dns/rdtypes/IN/__pycache__/PX.cpython-312.pyc,, +dns/rdtypes/IN/__pycache__/SRV.cpython-312.pyc,, +dns/rdtypes/IN/__pycache__/SVCB.cpython-312.pyc,, +dns/rdtypes/IN/__pycache__/WKS.cpython-312.pyc,, +dns/rdtypes/IN/__pycache__/__init__.cpython-312.pyc,, +dns/rdtypes/__init__.py,sha256=NYizfGglJfhqt_GMtSSXf7YQXIEHHCiJ_Y_qaLVeiOI,1073 +dns/rdtypes/__pycache__/__init__.cpython-312.pyc,, +dns/rdtypes/__pycache__/dnskeybase.cpython-312.pyc,, +dns/rdtypes/__pycache__/dsbase.cpython-312.pyc,, +dns/rdtypes/__pycache__/euibase.cpython-312.pyc,, +dns/rdtypes/__pycache__/mxbase.cpython-312.pyc,, +dns/rdtypes/__pycache__/nsbase.cpython-312.pyc,, +dns/rdtypes/__pycache__/svcbbase.cpython-312.pyc,, +dns/rdtypes/__pycache__/tlsabase.cpython-312.pyc,, +dns/rdtypes/__pycache__/txtbase.cpython-312.pyc,, +dns/rdtypes/__pycache__/util.cpython-312.pyc,, +dns/rdtypes/dnskeybase.py,sha256=FoDllfa9Pz2j2rf45VyUUYUsIt3kjjrwDy6LxrlPb5s,2856 +dns/rdtypes/dsbase.py,sha256=I85Aps1lBsiItdqGpsNY1O8icosfPtkWjiUn1J1lLUQ,3427 +dns/rdtypes/euibase.py,sha256=umN9A3VNw1TziAVtePvUses2jWPcynxINvjgyndPCdQ,2630 +dns/rdtypes/mxbase.py,sha256=DzjbiKoAAgpqbhwMBIFGA081jR5_doqGAq-kLvy2mns,3196 +dns/rdtypes/nsbase.py,sha256=tueXVV6E8lelebOmrmoOPq47eeRvOpsxHVXH4cOFxcs,2323 +dns/rdtypes/svcbbase.py,sha256=TQRT52m8F2NpSJsHUkTFS-hrkyhcIoAodW6bBHED4CY,16674 +dns/rdtypes/tlsabase.py,sha256=pIiWem6sF4IwyyKmyqx5xg55IG0w3K9r502Yx8PdziA,2596 +dns/rdtypes/txtbase.py,sha256=K4v2ulFu0DxPjxyf_Ul7YRjfBpUO-Ay_ChnR_Wx-ywA,3601 +dns/rdtypes/util.py,sha256=6AGQ-k3mLNlx4Ep_FiDABj1WVumUUGs3zQ6X-2iISec,9003 +dns/renderer.py,sha256=5THf1iKql2JPL2sKZt2-b4zqHKfk_vlx0FEfPtMJysY,11254 +dns/resolver.py,sha256=wagpUIu8Oh12O-zk48U30A6VQQOspjfibU4Ls2So-kM,73552 +dns/reversename.py,sha256=zoqXEbMZXm6R13nXbJHgTsf6L2C6uReODj6mqSHrTiE,3828 +dns/rrset.py,sha256=J-oQPEPJuKueLLiz1FN08P-ys9fjHhPWuwpDdrL4UTQ,9170 +dns/serial.py,sha256=-t5rPW-TcJwzBMfIJo7Tl-uDtaYtpqOfCVYx9dMaDCY,3606 +dns/set.py,sha256=Lr1qhyqywoobNkj9sAfdovoFy9vBfkz2eHdTCc7sZRs,9088 +dns/tokenizer.py,sha256=Dcc3lQgEIHCVZBuO6FaKWEojtPSd3EuaUC4vQA-spnk,23583 +dns/transaction.py,sha256=ZlnDT-V4W01J3cS501GaRLVhE9t1jZdnEZxPyZ0Cvg4,22636 +dns/tsig.py,sha256=I-Y-c3WMBX11bVioy5puFly2BhlpptUz82ikahxuh1c,11413 +dns/tsigkeyring.py,sha256=Z0xZemcU3XjZ9HlxBYv2E2PSuIhaFreqLDlD7HcmZDA,2633 +dns/ttl.py,sha256=fWFkw8qfk6saTp7lAPxZOuD3U3TRxVRvIpljQnG-01I,2979 +dns/update.py,sha256=y9d6LOO8xrUaH2UrZhy3ssnx8bJEsxqTArw5V8XqBRs,12243 +dns/version.py,sha256=sRMqE5tzPhXEzz-SEvdN82pP77xF_i1iELxaJN0roDE,1926 +dns/versioned.py,sha256=3YQj8mzGmZEsjnuVJJjcWopVmDKYLhEj4hEGTLEwzco,11765 +dns/win32util.py,sha256=NEjd5RXQU2aV1WsBMoIGZmXyqqKCxS4WYq9HqFQoVig,9107 +dns/wire.py,sha256=vy0SolgECbO1UXB4dnhXhDeFKOJT29nQxXvSfKOgA5s,2830 +dns/xfr.py,sha256=FKkKO-kSpyE1vHU5mnoPIP4YxiCl5gG7E5wOgY_4GO8,13273 +dns/zone.py,sha256=lLAarSxPtpx4Sw29OQ0ifPshD4QauGu8RnPh2dEropA,52086 +dns/zonefile.py,sha256=9pgkO0pV8Js53Oq9ZKOSbpFkGS5r_orU-25tmufGP9M,27929 +dns/zonetypes.py,sha256=HrQNZxZ_gWLWI9dskix71msi9wkYK5pgrBBbPb1T74Y,690 +dnspython-2.6.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +dnspython-2.6.1.dist-info/METADATA,sha256=2GJFv-NqkwIytog5VQe0wPtZKoS016uyYfG76lqftto,5808 +dnspython-2.6.1.dist-info/RECORD,, +dnspython-2.6.1.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +dnspython-2.6.1.dist-info/WHEEL,sha256=TJPnKdtrSue7xZ_AVGkp9YXcvDrobsjBds1du3Nx6dc,87 +dnspython-2.6.1.dist-info/licenses/LICENSE,sha256=w-o_9WVLMpwZ07xfdIGvYjw93tSmFFWFSZ-EOtPXQc0,1526 diff --git a/.venv/lib/python3.12/site-packages/dnspython-2.6.1.dist-info/REQUESTED b/.venv/lib/python3.12/site-packages/dnspython-2.6.1.dist-info/REQUESTED new file mode 100644 index 0000000..e69de29 diff --git a/.venv/lib/python3.12/site-packages/dnspython-2.6.1.dist-info/WHEEL b/.venv/lib/python3.12/site-packages/dnspython-2.6.1.dist-info/WHEEL new file mode 100644 index 0000000..5998f3a --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dnspython-2.6.1.dist-info/WHEEL @@ -0,0 +1,4 @@ +Wheel-Version: 1.0 +Generator: hatchling 1.21.1 +Root-Is-Purelib: true +Tag: py3-none-any diff --git a/.venv/lib/python3.12/site-packages/dnspython-2.6.1.dist-info/licenses/LICENSE b/.venv/lib/python3.12/site-packages/dnspython-2.6.1.dist-info/licenses/LICENSE new file mode 100644 index 0000000..390a726 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/dnspython-2.6.1.dist-info/licenses/LICENSE @@ -0,0 +1,35 @@ +ISC License + +Copyright (C) Dnspython Contributors + +Permission to use, copy, modify, and/or distribute this software for +any purpose with or without fee is hereby granted, provided that the +above copyright notice and this permission notice appear in all +copies. + +THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL +WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED +WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE +AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, 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. + + + +Copyright (C) 2001-2017 Nominum, Inc. +Copyright (C) Google Inc. + +Permission to use, copy, modify, and distribute this software and its +documentation for any purpose with or without fee is hereby granted, +provided that the above copyright notice and this permission notice +appear in all copies. + +THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES +WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR +ANY SPECIAL, DIRECT, 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. diff --git a/.venv/lib/python3.12/site-packages/idna-3.7.dist-info/INSTALLER b/.venv/lib/python3.12/site-packages/idna-3.7.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/.venv/lib/python3.12/site-packages/idna-3.7.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/.venv/lib/python3.12/site-packages/idna-3.7.dist-info/LICENSE.md b/.venv/lib/python3.12/site-packages/idna-3.7.dist-info/LICENSE.md new file mode 100644 index 0000000..19b6b45 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/idna-3.7.dist-info/LICENSE.md @@ -0,0 +1,31 @@ +BSD 3-Clause License + +Copyright (c) 2013-2024, Kim Davies and contributors. +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. + +2. 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. + +3. Neither the name of the copyright holder nor the names of its + 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 COPYRIGHT +HOLDER 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/.venv/lib/python3.12/site-packages/idna-3.7.dist-info/METADATA b/.venv/lib/python3.12/site-packages/idna-3.7.dist-info/METADATA new file mode 100644 index 0000000..b28f6ec --- /dev/null +++ b/.venv/lib/python3.12/site-packages/idna-3.7.dist-info/METADATA @@ -0,0 +1,243 @@ +Metadata-Version: 2.1 +Name: idna +Version: 3.7 +Summary: Internationalized Domain Names in Applications (IDNA) +Author-email: Kim Davies +Requires-Python: >=3.5 +Description-Content-Type: text/x-rst +Classifier: Development Status :: 5 - Production/Stable +Classifier: Intended Audience :: Developers +Classifier: Intended Audience :: System Administrators +Classifier: License :: OSI Approved :: BSD License +Classifier: Operating System :: OS Independent +Classifier: Programming Language :: Python +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3 :: Only +Classifier: Programming Language :: Python :: 3.5 +Classifier: Programming Language :: Python :: 3.6 +Classifier: Programming Language :: Python :: 3.7 +Classifier: Programming Language :: Python :: 3.8 +Classifier: Programming Language :: Python :: 3.9 +Classifier: Programming Language :: Python :: 3.10 +Classifier: Programming Language :: Python :: 3.11 +Classifier: Programming Language :: Python :: 3.12 +Classifier: Programming Language :: Python :: Implementation :: CPython +Classifier: Programming Language :: Python :: Implementation :: PyPy +Classifier: Topic :: Internet :: Name Service (DNS) +Classifier: Topic :: Software Development :: Libraries :: Python Modules +Classifier: Topic :: Utilities +Project-URL: Changelog, https://github.com/kjd/idna/blob/master/HISTORY.rst +Project-URL: Issue tracker, https://github.com/kjd/idna/issues +Project-URL: Source, https://github.com/kjd/idna + +Internationalized Domain Names in Applications (IDNA) +===================================================== + +Support for the Internationalized Domain Names in +Applications (IDNA) protocol as specified in `RFC 5891 +`_. This is the latest version of +the protocol and is sometimes referred to as “IDNA 2008”. + +This library also provides support for Unicode Technical +Standard 46, `Unicode IDNA Compatibility Processing +`_. + +This acts as a suitable replacement for the “encodings.idna” +module that comes with the Python standard library, but which +only supports the older superseded IDNA specification (`RFC 3490 +`_). + +Basic functions are simply executed: + +.. code-block:: pycon + + >>> import idna + >>> idna.encode('ドメイン.テスト') + b'xn--eckwd4c7c.xn--zckzah' + >>> print(idna.decode('xn--eckwd4c7c.xn--zckzah')) + ドメイン.テスト + + +Installation +------------ + +This package is available for installation from PyPI: + +.. code-block:: bash + + $ python3 -m pip install idna + + +Usage +----- + +For typical usage, the ``encode`` and ``decode`` functions will take a +domain name argument and perform a conversion to A-labels or U-labels +respectively. + +.. code-block:: pycon + + >>> import idna + >>> idna.encode('ドメイン.テスト') + b'xn--eckwd4c7c.xn--zckzah' + >>> print(idna.decode('xn--eckwd4c7c.xn--zckzah')) + ドメイン.テスト + +You may use the codec encoding and decoding methods using the +``idna.codec`` module: + +.. code-block:: pycon + + >>> import idna.codec + >>> print('домен.испытание'.encode('idna2008')) + b'xn--d1acufc.xn--80akhbyknj4f' + >>> print(b'xn--d1acufc.xn--80akhbyknj4f'.decode('idna2008')) + домен.испытание + +Conversions can be applied at a per-label basis using the ``ulabel`` or +``alabel`` functions if necessary: + +.. code-block:: pycon + + >>> idna.alabel('测试') + b'xn--0zwm56d' + +Compatibility Mapping (UTS #46) ++++++++++++++++++++++++++++++++ + +As described in `RFC 5895 `_, the +IDNA specification does not normalize input from different potential +ways a user may input a domain name. This functionality, known as +a “mapping”, is considered by the specification to be a local +user-interface issue distinct from IDNA conversion functionality. + +This library provides one such mapping that was developed by the +Unicode Consortium. Known as `Unicode IDNA Compatibility Processing +`_, it provides for both a regular +mapping for typical applications, as well as a transitional mapping to +help migrate from older IDNA 2003 applications. + +For example, “Königsgäßchen” is not a permissible label as *LATIN +CAPITAL LETTER K* is not allowed (nor are capital letters in general). +UTS 46 will convert this into lower case prior to applying the IDNA +conversion. + +.. code-block:: pycon + + >>> import idna + >>> idna.encode('Königsgäßchen') + ... + idna.core.InvalidCodepoint: Codepoint U+004B at position 1 of 'Königsgäßchen' not allowed + >>> idna.encode('Königsgäßchen', uts46=True) + b'xn--knigsgchen-b4a3dun' + >>> print(idna.decode('xn--knigsgchen-b4a3dun')) + königsgäßchen + +Transitional processing provides conversions to help transition from +the older 2003 standard to the current standard. For example, in the +original IDNA specification, the *LATIN SMALL LETTER SHARP S* (ß) was +converted into two *LATIN SMALL LETTER S* (ss), whereas in the current +IDNA specification this conversion is not performed. + +.. code-block:: pycon + + >>> idna.encode('Königsgäßchen', uts46=True, transitional=True) + 'xn--knigsgsschen-lcb0w' + +Implementers should use transitional processing with caution, only in +rare cases where conversion from legacy labels to current labels must be +performed (i.e. IDNA implementations that pre-date 2008). For typical +applications that just need to convert labels, transitional processing +is unlikely to be beneficial and could produce unexpected incompatible +results. + +``encodings.idna`` Compatibility +++++++++++++++++++++++++++++++++ + +Function calls from the Python built-in ``encodings.idna`` module are +mapped to their IDNA 2008 equivalents using the ``idna.compat`` module. +Simply substitute the ``import`` clause in your code to refer to the new +module name. + +Exceptions +---------- + +All errors raised during the conversion following the specification +should raise an exception derived from the ``idna.IDNAError`` base +class. + +More specific exceptions that may be generated as ``idna.IDNABidiError`` +when the error reflects an illegal combination of left-to-right and +right-to-left characters in a label; ``idna.InvalidCodepoint`` when +a specific codepoint is an illegal character in an IDN label (i.e. +INVALID); and ``idna.InvalidCodepointContext`` when the codepoint is +illegal based on its positional context (i.e. it is CONTEXTO or CONTEXTJ +but the contextual requirements are not satisfied.) + +Building and Diagnostics +------------------------ + +The IDNA and UTS 46 functionality relies upon pre-calculated lookup +tables for performance. These tables are derived from computing against +eligibility criteria in the respective standards. These tables are +computed using the command-line script ``tools/idna-data``. + +This tool will fetch relevant codepoint data from the Unicode repository +and perform the required calculations to identify eligibility. There are +three main modes: + +* ``idna-data make-libdata``. Generates ``idnadata.py`` and + ``uts46data.py``, the pre-calculated lookup tables used for IDNA and + UTS 46 conversions. Implementers who wish to track this library against + a different Unicode version may use this tool to manually generate a + different version of the ``idnadata.py`` and ``uts46data.py`` files. + +* ``idna-data make-table``. Generate a table of the IDNA disposition + (e.g. PVALID, CONTEXTJ, CONTEXTO) in the format found in Appendix + B.1 of RFC 5892 and the pre-computed tables published by `IANA + `_. + +* ``idna-data U+0061``. Prints debugging output on the various + properties associated with an individual Unicode codepoint (in this + case, U+0061), that are used to assess the IDNA and UTS 46 status of a + codepoint. This is helpful in debugging or analysis. + +The tool accepts a number of arguments, described using ``idna-data +-h``. Most notably, the ``--version`` argument allows the specification +of the version of Unicode to be used in computing the table data. For +example, ``idna-data --version 9.0.0 make-libdata`` will generate +library data against Unicode 9.0.0. + + +Additional Notes +---------------- + +* **Packages**. The latest tagged release version is published in the + `Python Package Index `_. + +* **Version support**. This library supports Python 3.5 and higher. + As this library serves as a low-level toolkit for a variety of + applications, many of which strive for broad compatibility with older + Python versions, there is no rush to remove older interpreter support. + Removing support for older versions should be well justified in that the + maintenance burden has become too high. + +* **Python 2**. Python 2 is supported by version 2.x of this library. + While active development of the version 2.x series has ended, notable + issues being corrected may be backported to 2.x. Use "idna<3" in your + requirements file if you need this library for a Python 2 application. + +* **Testing**. The library has a test suite based on each rule of the + IDNA specification, as well as tests that are provided as part of the + Unicode Technical Standard 46, `Unicode IDNA Compatibility Processing + `_. + +* **Emoji**. It is an occasional request to support emoji domains in + this library. Encoding of symbols like emoji is expressly prohibited by + the technical standard IDNA 2008 and emoji domains are broadly phased + out across the domain industry due to associated security risks. For + now, applications that need to support these non-compliant labels + may wish to consider trying the encode/decode operation in this library + first, and then falling back to using `encodings.idna`. See `the Github + project `_ for more discussion. + diff --git a/.venv/lib/python3.12/site-packages/idna-3.7.dist-info/RECORD b/.venv/lib/python3.12/site-packages/idna-3.7.dist-info/RECORD new file mode 100644 index 0000000..16e596b --- /dev/null +++ b/.venv/lib/python3.12/site-packages/idna-3.7.dist-info/RECORD @@ -0,0 +1,22 @@ +idna-3.7.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +idna-3.7.dist-info/LICENSE.md,sha256=pZ8LDvNjWHQQmkRhykT_enDVBpboFHZ7-vch1Mmw2w8,1541 +idna-3.7.dist-info/METADATA,sha256=OixCk-dKLZkPy-MfviOmiPvwJ1O2K_8rqCrFjC_uxy4,9888 +idna-3.7.dist-info/RECORD,, +idna-3.7.dist-info/WHEEL,sha256=EZbGkh7Ie4PoZfRQ8I0ZuP9VklN_TvcZ6DSE5Uar4z4,81 +idna/__init__.py,sha256=KJQN1eQBr8iIK5SKrJ47lXvxG0BJ7Lm38W4zT0v_8lk,849 +idna/__pycache__/__init__.cpython-312.pyc,, +idna/__pycache__/codec.cpython-312.pyc,, +idna/__pycache__/compat.cpython-312.pyc,, +idna/__pycache__/core.cpython-312.pyc,, +idna/__pycache__/idnadata.cpython-312.pyc,, +idna/__pycache__/intranges.cpython-312.pyc,, +idna/__pycache__/package_data.cpython-312.pyc,, +idna/__pycache__/uts46data.cpython-312.pyc,, +idna/codec.py,sha256=PS6m-XmdST7Wj7J7ulRMakPDt5EBJyYrT3CPtjh-7t4,3426 +idna/compat.py,sha256=0_sOEUMT4CVw9doD3vyRhX80X19PwqFoUBs7gWsFME4,321 +idna/core.py,sha256=lyhpoe2vulEaB_65xhXmoKgO-xUqFDvcwxu5hpNNO4E,12663 +idna/idnadata.py,sha256=dqRwytzkjIHMBa2R1lYvHDwACenZPt8eGVu1Y8UBE-E,78320 +idna/intranges.py,sha256=YBr4fRYuWH7kTKS2tXlFjM24ZF1Pdvcir-aywniInqg,1881 +idna/package_data.py,sha256=Tkt0KnIeyIlnHddOaz9WSkkislNgokJAuE-p5GorMqo,21 +idna/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +idna/uts46data.py,sha256=1KuksWqLuccPXm2uyRVkhfiFLNIhM_H2m4azCcnOqEU,206503 diff --git a/.venv/lib/python3.12/site-packages/idna-3.7.dist-info/WHEEL b/.venv/lib/python3.12/site-packages/idna-3.7.dist-info/WHEEL new file mode 100644 index 0000000..3b5e64b --- /dev/null +++ b/.venv/lib/python3.12/site-packages/idna-3.7.dist-info/WHEEL @@ -0,0 +1,4 @@ +Wheel-Version: 1.0 +Generator: flit 3.9.0 +Root-Is-Purelib: true +Tag: py3-none-any diff --git a/.venv/lib/python3.12/site-packages/idna/__init__.py b/.venv/lib/python3.12/site-packages/idna/__init__.py new file mode 100644 index 0000000..a40eeaf --- /dev/null +++ b/.venv/lib/python3.12/site-packages/idna/__init__.py @@ -0,0 +1,44 @@ +from .package_data import __version__ +from .core import ( + IDNABidiError, + IDNAError, + InvalidCodepoint, + InvalidCodepointContext, + alabel, + check_bidi, + check_hyphen_ok, + check_initial_combiner, + check_label, + check_nfc, + decode, + encode, + ulabel, + uts46_remap, + valid_contextj, + valid_contexto, + valid_label_length, + valid_string_length, +) +from .intranges import intranges_contain + +__all__ = [ + "IDNABidiError", + "IDNAError", + "InvalidCodepoint", + "InvalidCodepointContext", + "alabel", + "check_bidi", + "check_hyphen_ok", + "check_initial_combiner", + "check_label", + "check_nfc", + "decode", + "encode", + "intranges_contain", + "ulabel", + "uts46_remap", + "valid_contextj", + "valid_contexto", + "valid_label_length", + "valid_string_length", +] diff --git a/.venv/lib/python3.12/site-packages/idna/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/idna/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e9388612c999d2b36eca97247212e86d5861f540 GIT binary patch literal 868 zcmbu7zmL-}6vyo}O`E2_)9W!HHY74!qXWc*kl7-w@{0_$mMO+<{t8R2X%NCb-9mx-a|bepn&&LpAXQ057Cg1(1?%G zm`~7zPtlZzDC9FVtMyv>5uc+u1Z$AGA0Rs3wJvfDNRgj?NQNux6PJdTa^zVVMRG9^sp|` zh}DI>x#3GaZT{CMaZbg$%5>Po%1SY@J_OChOiYW4h&3&1Il@E~D%V_^YFl^~9gD7o zZ(#?n0*k)Iz+z}IvY1btu2FX|CV7tWM{sGzDul literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/idna/__pycache__/codec.cpython-312.pyc b/.venv/lib/python3.12/site-packages/idna/__pycache__/codec.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2a6e9843fda40f8cf3688f78223c1b70445c30b8 GIT binary patch literal 4973 zcmd6qUu;v?8Nko={p0IDiS0Nc#0iiDnqYNFC>bpZv>P%-Zra7%B9*DUAWdpI`-zwB`_A>h zB*2Qq!;b9l{QJ(I`<-)s=R1FIYjYC_;WNvLnKnYc!c09#wM69uj*umy5QR&TG#BC0 zj))`8NBFc55z=Br_>>fpSnP~AAr?|{+7)r7-4S=%6Y+4wK~!gQd%g2!tcc6d zKZZz~gSe%Uqrk`oLLDK`8gHO=xV47ag zY*X7ocjytif?XB~GTnC2^)cPOPtfgD{A!mHP;vb4Y}M<5qJ*GyEC`Wqu#uG9w^c{& zuG@$sIX)bGfEEjjmZa+OjG|hSqS|pR6`N60mNaX}t`n2fM~+dNp%1Xr=`e5cNA#Q} zzCN2xsg`^?Yib!imYVfK?N3I(y8PbPfBDtdfBo%Saa6AdS1nPQg2WP0NrY2K#GyD9 zPURH`{CQPSMO8{T*vCkUupq)FzCv)K$aRi&Rzx&LBJS5lgOp?~n_^Mf}X73_q{ zAi@I09xW-6q3M`Oae@|~QuUj>B^YWdLEBN)2g1O*{{H@lKODQ5NvmTttC}=(NsC_` z!^Istr5W+D(Mzg+X)LA9jAe7?#f&~a`ojJ(Lo?NpY%KnE?1E~HX^I|WE#jlu92;=X z%d9+V?-o4q#srAVr0fY4&VTCJakry)rSE%deaB0E$8TL)?VDchIKARM{ZC)89PGL8 z>nbSk=RZDsz4N0VulR;mNI;jyUvl-)tk2T`?aT{`h+s1$MZywAe3|I3Ja0JdH0U_6<^q|Q6z4pYPLj7?AY@+7 zOUXJsn?n%OQ_tk(I(O2MYjwIZa#$7Mj|2-3Q|W+?GjX$EJ{%>iy-# zIjEa=ZRn?Qki zm`0SUmS|*CnrTU~Y*y73ilAj@&k~XuO%J;%+OxU-bQrRh#4atv@|rZJAx*J6ybO%l zlnJ!d=AdKyV)NRCQFcfS+?fE*T41NcYLCv$CK4)*+R&RD*t-8lH>&J_UW|W$__kaO z46Fr)OM&4V!fIe-Q7U(b7QJ^o0YGMP@YfUNUAqh3a%ZTx|JunrU7>rJDxAC%>?!Xa zE==7E1fhk`zbKTudjCxX*RI85WpBsTQ&&!XJaoP5qmj?Nd+z{#{hdYbnyVm`z5Wkh zEsDQ6S@Q0@GP&-82J7u)d*4#-TJHL`)$YAF4wt%LTJ)A>?}vP0YSlkbk_Vu3UvKgC z72m*$Jiyj+I_#q8Ezw;l`cVvku!NaRCdI%*(M6)WQ5-i+Xq(8oVz_yI`&2t%k7@9{ZpVt0RKV+v`FA({4caj zGDoNdEo^H&0W8I52bLCh!bEVfu#Be#g5hm-Efk?%KF^uRZx)gbFw{%HeQCHR03@*i zB&h}@Cj*ky0whQ?AVCcSlDr8>4V*N`FdGPIBBlbigTYTZ$`W z`vZ8NJsL@L43*F!r@(VU_oEmGVYzDng8TZ(__5uI4fv_;(FT5Ol~pUNU6pY?jWC`eI+Ayqt9~2X` zHV^;GA3!XTJiPST+ltGP=Ibh10~x3^LY_3=P|LN_WCMK-wMS_+px2^R_b`cxMrXmq z=aHR4=a7ZpJCA(?h^Voal>-4XVeKD-f~FM<~Zy|WLuD}GqXQ9{x}%}4c%}1BtAop z(fGw^Vpfmi!<$Y+orX%dl5p;wp2fLOojqk=@UADY=IJeYddqEryS~o%-?{qkm3Nzo z-jTcT>l%Px)hBzUbs~!rTj+3)CB!pSZJ8YII2(6pHaZ2ua)6U2nYk=@S(F_%cEs@h zv7GTtI;*8r8<_Z^R_G}6rBr3B6U9FLkqR};Z8D2}s!!oW@arv^suwf^&e5ig{7^n@ zzmZ;{Z-5?J(fAXHb)Mt6FUg_L$)PVu+ZV+3B^fS};d{Xyh5btt*CtkWPOJtGtq^}z z=-`GIk6)d-GF2sztnS^#4Hmbp^-Pp{CaMH7)uY@%YY}9sKY-p{g#*Q*wa`c@G*Tsy yt;$==)@2VT72){=(e=GIUR-E1pfHQZRWUcghFZU}h&7P0 zkf|b5XEiXG#p;+hFmDufw|Ryg5SJ>te5RjvE6Ql6g|c?jh^NYmgC4}n79a;A4fWZX z83^>6E}%Oi@``&$PA>5_8Brf=+mMEw!H9|~p3ODuoNsvtJONK+AO#;r;en^mc-<%u zz11P4LobecURKBho^Gr@Uib1y!lNt*-vs-Rdl5?mypd#qT+Iqq-Qn%+7oCo{j>Rop z(`)G7lhfv{!v~+9jm?EA=H&k;5c*r`85rpPgf4qAftW+6>N^~zDybIcHC*C`b~iOk zbN}C-WOOFl2kKV*w=12Oe%o1JTYKU#4!M(Z=?r8PM>#lYkU%CNb27mt4|$C3wR|o+ zNftu_sRZ^)2rgVI=CO&tyRFUciaW?OHLC?fof=Eyds{ym-Lcs%TX&nv47mVh>DfYM z%OZ=?eWA4#HacbGQYfoeNXSdoRbAsih@cQ!it>rkg%G7y=e4H^XM-4?i~Gpy-yq*X zH!&!sr=)dC=6{lFj literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/idna/__pycache__/core.cpython-312.pyc b/.venv/lib/python3.12/site-packages/idna/__pycache__/core.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e5b0af2e40ca43942d8158c03572652260bfc8b6 GIT binary patch literal 15835 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 Df|SU) literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/idna/__pycache__/idnadata.cpython-312.pyc b/.venv/lib/python3.12/site-packages/idna/__pycache__/idnadata.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..1ba232045cb79bccd7f158c86155e0185c970767 GIT binary patch literal 99463 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/idna/__pycache__/intranges.cpython-312.pyc b/.venv/lib/python3.12/site-packages/idna/__pycache__/intranges.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..6df38b4add41851e3e02d97b5cb95b2ee7456307 GIT binary patch literal 2625 zcmZuyO>7fK6rTNaf*t42$`3y!6GGc81e?TwP!(FKpdbMOK>}(+t7Y+ylO^k2XLb!Z zbxK_RwB(a~n=v=$lzPA&8N7=e>D9^XAR> z-uxboh7k<)%G31c4G8_snED9Sh|T*zJVXYXK!#w5mM|f}ELmbknvgQ`ge)LKCK6G0 zgPx%fnJ7jmEix`G8x7yd6CtA!)^@?C5G5Tl!m!q0L^u!HuvXV@0!gD01xfRpe!y-Q z*tLK(oEOzreV2ex_^f%G*jUGw>3Y~nW7GD?B%$sA&gcfgxhz}kpK`J!owKaG3aV~K zw=8VuGB*ijQp>R?G0oX-7?_k}yCjwK!0j8pQcfnD^9UGIlBL8Ywx@fhV>5Gair}U?8a*dWqB+qJ<|L14^5H3Usvy+$>hl@&XraTcIB-47bV{SQDU1+u!%9yF&E#9IK;w}-c@ zzEV&OiF;NIq2?1rPhnR!>X8blAkRtnKa-Ic2_z7USeK3=Ro3@H60X#58*ct>gkiWY z026@=v{Qs3f$H`oaX$)U7&S0xNBQk*N4Mah1^CbyKo}whu$xOw!CmX#jtl2r>S)F~ zC79gRQ=XLvEypE*lx;hXJI%zyr(k)Q!4DX~Bz7HuiWv`cXIFT5fh#-Z7{p*la7}yC z+Qxbfw0L+JCx>u>`GOE_$78x41C<-+-Zoyt*kC}REVpXN54jHYh~X5pJ*gqez~n~)Lyct^u*$>q!;eZa>q{)n z7{9udn1WL#XqI@?xoxJV5^STysOhE>acB;=6P9^1k|}g!DB*(3BUwE)t;204 zOvBa_kmq3AcsB3Hwm28rI^-&*wGe<-AMEeMrJ)57J&8UNk|#jXZXhVDC6`%YOgq>@bNz>baNFQFk1DYHmBsVL z(EN%@QQpm2ug-a)+md5M_L#j zd2oLMv9l=}LcNL1iQDb)mJEt-4QO2AmaYU%Oqf0c3G4N?8dt5gL9=6Neag-Q;|oad zoD3~aEjQfL$CsSOmv#MADFcn{EgDeJht%oL$>n3GeUFK8~y6sv9+9BqEvc2U9;?dhgX zRnYkmKKC2=&7*&!dy2mT8LtKogcYo%*z;eq+n)evfoEL{Hf&U$BG zX{4Nl+B^Pubggq}F|r^pkV>Rw>DY@%Px1Zdk)BGdt16);%x&(EK|Ni6-q5|?-ct&d z+{cl%_JPF)Fw(iv_rsuGiL`Q9sS&?H(+nr2Y4iX@1&7RMp}|syDaxSYOY9&Fok0OH z!20q{$FcZ%ILx^#e(YC`!x_iOS>$6H2StVxcL9D?Nf3m8MMaP|n~~7`7usKyW5VvD zS33PDUqwKcuP!H_Ny{gnXq$|!9ukC}Vyuc_Dkb?;PHr-;8WMzor7^ZNP`p}7mZj3k kM_>eOwXsELE1s?*n93bxclmVr?vozQJ{y0@R(YiV1AI=MU;qFB literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/idna/__pycache__/package_data.cpython-312.pyc b/.venv/lib/python3.12/site-packages/idna/__pycache__/package_data.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..673ad48eb6a2ad92fc3921ae734d454201f58e05 GIT binary patch literal 203 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

I1 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⩓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 NXO&9#EM}h(|33%7PkR6W literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/idna/codec.py b/.venv/lib/python3.12/site-packages/idna/codec.py new file mode 100644 index 0000000..c855a4d --- /dev/null +++ b/.venv/lib/python3.12/site-packages/idna/codec.py @@ -0,0 +1,118 @@ +from .core import encode, decode, alabel, ulabel, IDNAError +import codecs +import re +from typing import Any, Tuple, Optional + +_unicode_dots_re = re.compile('[\u002e\u3002\uff0e\uff61]') + +class Codec(codecs.Codec): + + def encode(self, data: str, errors: str = 'strict') -> Tuple[bytes, int]: + if errors != 'strict': + raise IDNAError('Unsupported error handling \"{}\"'.format(errors)) + + if not data: + return b"", 0 + + return encode(data), len(data) + + def decode(self, data: bytes, errors: str = 'strict') -> Tuple[str, int]: + if errors != 'strict': + raise IDNAError('Unsupported error handling \"{}\"'.format(errors)) + + if not data: + return '', 0 + + return decode(data), len(data) + +class IncrementalEncoder(codecs.BufferedIncrementalEncoder): + def _buffer_encode(self, data: str, errors: str, final: bool) -> Tuple[bytes, int]: + if errors != 'strict': + raise IDNAError('Unsupported error handling \"{}\"'.format(errors)) + + if not data: + return b'', 0 + + labels = _unicode_dots_re.split(data) + trailing_dot = b'' + if labels: + if not labels[-1]: + trailing_dot = b'.' + del labels[-1] + elif not final: + # Keep potentially unfinished label until the next call + del labels[-1] + if labels: + trailing_dot = b'.' + + result = [] + size = 0 + for label in labels: + result.append(alabel(label)) + if size: + size += 1 + size += len(label) + + # Join with U+002E + result_bytes = b'.'.join(result) + trailing_dot + size += len(trailing_dot) + return result_bytes, size + +class IncrementalDecoder(codecs.BufferedIncrementalDecoder): + def _buffer_decode(self, data: Any, errors: str, final: bool) -> Tuple[str, int]: + if errors != 'strict': + raise IDNAError('Unsupported error handling \"{}\"'.format(errors)) + + if not data: + return ('', 0) + + if not isinstance(data, str): + data = str(data, 'ascii') + + labels = _unicode_dots_re.split(data) + trailing_dot = '' + if labels: + if not labels[-1]: + trailing_dot = '.' + del labels[-1] + elif not final: + # Keep potentially unfinished label until the next call + del labels[-1] + if labels: + trailing_dot = '.' + + result = [] + size = 0 + for label in labels: + result.append(ulabel(label)) + if size: + size += 1 + size += len(label) + + result_str = '.'.join(result) + trailing_dot + size += len(trailing_dot) + return (result_str, size) + + +class StreamWriter(Codec, codecs.StreamWriter): + pass + + +class StreamReader(Codec, codecs.StreamReader): + pass + + +def search_function(name: str) -> Optional[codecs.CodecInfo]: + if name != 'idna2008': + return None + return codecs.CodecInfo( + name=name, + encode=Codec().encode, + decode=Codec().decode, + incrementalencoder=IncrementalEncoder, + incrementaldecoder=IncrementalDecoder, + streamwriter=StreamWriter, + streamreader=StreamReader, + ) + +codecs.register(search_function) diff --git a/.venv/lib/python3.12/site-packages/idna/compat.py b/.venv/lib/python3.12/site-packages/idna/compat.py new file mode 100644 index 0000000..786e6bd --- /dev/null +++ b/.venv/lib/python3.12/site-packages/idna/compat.py @@ -0,0 +1,13 @@ +from .core import * +from .codec import * +from typing import Any, Union + +def ToASCII(label: str) -> bytes: + return encode(label) + +def ToUnicode(label: Union[bytes, bytearray]) -> str: + return decode(label) + +def nameprep(s: Any) -> None: + raise NotImplementedError('IDNA 2008 does not utilise nameprep protocol') + diff --git a/.venv/lib/python3.12/site-packages/idna/core.py b/.venv/lib/python3.12/site-packages/idna/core.py new file mode 100644 index 0000000..0dae61a --- /dev/null +++ b/.venv/lib/python3.12/site-packages/idna/core.py @@ -0,0 +1,395 @@ +from . import idnadata +import bisect +import unicodedata +import re +from typing import Union, Optional +from .intranges import intranges_contain + +_virama_combining_class = 9 +_alabel_prefix = b'xn--' +_unicode_dots_re = re.compile('[\u002e\u3002\uff0e\uff61]') + +class IDNAError(UnicodeError): + """ Base exception for all IDNA-encoding related problems """ + pass + + +class IDNABidiError(IDNAError): + """ Exception when bidirectional requirements are not satisfied """ + pass + + +class InvalidCodepoint(IDNAError): + """ Exception when a disallowed or unallocated codepoint is used """ + pass + + +class InvalidCodepointContext(IDNAError): + """ Exception when the codepoint is not valid in the context it is used """ + pass + + +def _combining_class(cp: int) -> int: + v = unicodedata.combining(chr(cp)) + if v == 0: + if not unicodedata.name(chr(cp)): + raise ValueError('Unknown character in unicodedata') + return v + +def _is_script(cp: str, script: str) -> bool: + return intranges_contain(ord(cp), idnadata.scripts[script]) + +def _punycode(s: str) -> bytes: + return s.encode('punycode') + +def _unot(s: int) -> str: + return 'U+{:04X}'.format(s) + + +def valid_label_length(label: Union[bytes, str]) -> bool: + if len(label) > 63: + return False + return True + + +def valid_string_length(label: Union[bytes, str], trailing_dot: bool) -> bool: + if len(label) > (254 if trailing_dot else 253): + return False + return True + + +def check_bidi(label: str, check_ltr: bool = False) -> bool: + # Bidi rules should only be applied if string contains RTL characters + bidi_label = False + for (idx, cp) in enumerate(label, 1): + direction = unicodedata.bidirectional(cp) + if direction == '': + # String likely comes from a newer version of Unicode + raise IDNABidiError('Unknown directionality in label {} at position {}'.format(repr(label), idx)) + if direction in ['R', 'AL', 'AN']: + bidi_label = True + if not bidi_label and not check_ltr: + return True + + # Bidi rule 1 + direction = unicodedata.bidirectional(label[0]) + if direction in ['R', 'AL']: + rtl = True + elif direction == 'L': + rtl = False + else: + raise IDNABidiError('First codepoint in label {} must be directionality L, R or AL'.format(repr(label))) + + valid_ending = False + number_type = None # type: Optional[str] + for (idx, cp) in enumerate(label, 1): + direction = unicodedata.bidirectional(cp) + + if rtl: + # Bidi rule 2 + if not direction in ['R', 'AL', 'AN', 'EN', 'ES', 'CS', 'ET', 'ON', 'BN', 'NSM']: + raise IDNABidiError('Invalid direction for codepoint at position {} in a right-to-left label'.format(idx)) + # Bidi rule 3 + if direction in ['R', 'AL', 'EN', 'AN']: + valid_ending = True + elif direction != 'NSM': + valid_ending = False + # Bidi rule 4 + if direction in ['AN', 'EN']: + if not number_type: + number_type = direction + else: + if number_type != direction: + raise IDNABidiError('Can not mix numeral types in a right-to-left label') + else: + # Bidi rule 5 + if not direction in ['L', 'EN', 'ES', 'CS', 'ET', 'ON', 'BN', 'NSM']: + raise IDNABidiError('Invalid direction for codepoint at position {} in a left-to-right label'.format(idx)) + # Bidi rule 6 + if direction in ['L', 'EN']: + valid_ending = True + elif direction != 'NSM': + valid_ending = False + + if not valid_ending: + raise IDNABidiError('Label ends with illegal codepoint directionality') + + return True + + +def check_initial_combiner(label: str) -> bool: + if unicodedata.category(label[0])[0] == 'M': + raise IDNAError('Label begins with an illegal combining character') + return True + + +def check_hyphen_ok(label: str) -> bool: + if label[2:4] == '--': + raise IDNAError('Label has disallowed hyphens in 3rd and 4th position') + if label[0] == '-' or label[-1] == '-': + raise IDNAError('Label must not start or end with a hyphen') + return True + + +def check_nfc(label: str) -> None: + if unicodedata.normalize('NFC', label) != label: + raise IDNAError('Label must be in Normalization Form C') + + +def valid_contextj(label: str, pos: int) -> bool: + cp_value = ord(label[pos]) + + if cp_value == 0x200c: + + if pos > 0: + if _combining_class(ord(label[pos - 1])) == _virama_combining_class: + return True + + ok = False + for i in range(pos-1, -1, -1): + joining_type = idnadata.joining_types.get(ord(label[i])) + if joining_type == ord('T'): + continue + elif joining_type in [ord('L'), ord('D')]: + ok = True + break + else: + break + + if not ok: + return False + + ok = False + for i in range(pos+1, len(label)): + joining_type = idnadata.joining_types.get(ord(label[i])) + if joining_type == ord('T'): + continue + elif joining_type in [ord('R'), ord('D')]: + ok = True + break + else: + break + return ok + + if cp_value == 0x200d: + + if pos > 0: + if _combining_class(ord(label[pos - 1])) == _virama_combining_class: + return True + return False + + else: + + return False + + +def valid_contexto(label: str, pos: int, exception: bool = False) -> bool: + cp_value = ord(label[pos]) + + if cp_value == 0x00b7: + if 0 < pos < len(label)-1: + if ord(label[pos - 1]) == 0x006c and ord(label[pos + 1]) == 0x006c: + return True + return False + + elif cp_value == 0x0375: + if pos < len(label)-1 and len(label) > 1: + return _is_script(label[pos + 1], 'Greek') + return False + + elif cp_value == 0x05f3 or cp_value == 0x05f4: + if pos > 0: + return _is_script(label[pos - 1], 'Hebrew') + return False + + elif cp_value == 0x30fb: + for cp in label: + if cp == '\u30fb': + continue + if _is_script(cp, 'Hiragana') or _is_script(cp, 'Katakana') or _is_script(cp, 'Han'): + return True + return False + + elif 0x660 <= cp_value <= 0x669: + for cp in label: + if 0x6f0 <= ord(cp) <= 0x06f9: + return False + return True + + elif 0x6f0 <= cp_value <= 0x6f9: + for cp in label: + if 0x660 <= ord(cp) <= 0x0669: + return False + return True + + return False + + +def check_label(label: Union[str, bytes, bytearray]) -> None: + if isinstance(label, (bytes, bytearray)): + label = label.decode('utf-8') + if len(label) == 0: + raise IDNAError('Empty Label') + + check_nfc(label) + check_hyphen_ok(label) + check_initial_combiner(label) + + for (pos, cp) in enumerate(label): + cp_value = ord(cp) + if intranges_contain(cp_value, idnadata.codepoint_classes['PVALID']): + continue + elif intranges_contain(cp_value, idnadata.codepoint_classes['CONTEXTJ']): + if not valid_contextj(label, pos): + raise InvalidCodepointContext('Joiner {} not allowed at position {} in {}'.format( + _unot(cp_value), pos+1, repr(label))) + elif intranges_contain(cp_value, idnadata.codepoint_classes['CONTEXTO']): + if not valid_contexto(label, pos): + raise InvalidCodepointContext('Codepoint {} not allowed at position {} in {}'.format(_unot(cp_value), pos+1, repr(label))) + else: + raise InvalidCodepoint('Codepoint {} at position {} of {} not allowed'.format(_unot(cp_value), pos+1, repr(label))) + + check_bidi(label) + + +def alabel(label: str) -> bytes: + try: + label_bytes = label.encode('ascii') + ulabel(label_bytes) + if not valid_label_length(label_bytes): + raise IDNAError('Label too long') + return label_bytes + except UnicodeEncodeError: + pass + + check_label(label) + label_bytes = _alabel_prefix + _punycode(label) + + if not valid_label_length(label_bytes): + raise IDNAError('Label too long') + + return label_bytes + + +def ulabel(label: Union[str, bytes, bytearray]) -> str: + if not isinstance(label, (bytes, bytearray)): + try: + label_bytes = label.encode('ascii') + except UnicodeEncodeError: + check_label(label) + return label + else: + label_bytes = label + + label_bytes = label_bytes.lower() + if label_bytes.startswith(_alabel_prefix): + label_bytes = label_bytes[len(_alabel_prefix):] + if not label_bytes: + raise IDNAError('Malformed A-label, no Punycode eligible content found') + if label_bytes.decode('ascii')[-1] == '-': + raise IDNAError('A-label must not end with a hyphen') + else: + check_label(label_bytes) + return label_bytes.decode('ascii') + + try: + label = label_bytes.decode('punycode') + except UnicodeError: + raise IDNAError('Invalid A-label') + check_label(label) + return label + + +def uts46_remap(domain: str, std3_rules: bool = True, transitional: bool = False) -> str: + """Re-map the characters in the string according to UTS46 processing.""" + from .uts46data import uts46data + output = '' + + for pos, char in enumerate(domain): + code_point = ord(char) + try: + uts46row = uts46data[code_point if code_point < 256 else + bisect.bisect_left(uts46data, (code_point, 'Z')) - 1] + status = uts46row[1] + replacement = None # type: Optional[str] + if len(uts46row) == 3: + replacement = uts46row[2] + if (status == 'V' or + (status == 'D' and not transitional) or + (status == '3' and not std3_rules and replacement is None)): + output += char + elif replacement is not None and (status == 'M' or + (status == '3' and not std3_rules) or + (status == 'D' and transitional)): + output += replacement + elif status != 'I': + raise IndexError() + except IndexError: + raise InvalidCodepoint( + 'Codepoint {} not allowed at position {} in {}'.format( + _unot(code_point), pos + 1, repr(domain))) + + return unicodedata.normalize('NFC', output) + + +def encode(s: Union[str, bytes, bytearray], strict: bool = False, uts46: bool = False, std3_rules: bool = False, transitional: bool = False) -> bytes: + if not isinstance(s, str): + try: + s = str(s, 'ascii') + except UnicodeDecodeError: + raise IDNAError('should pass a unicode string to the function rather than a byte string.') + if uts46: + s = uts46_remap(s, std3_rules, transitional) + trailing_dot = False + result = [] + if strict: + labels = s.split('.') + else: + labels = _unicode_dots_re.split(s) + if not labels or labels == ['']: + raise IDNAError('Empty domain') + if labels[-1] == '': + del labels[-1] + trailing_dot = True + for label in labels: + s = alabel(label) + if s: + result.append(s) + else: + raise IDNAError('Empty label') + if trailing_dot: + result.append(b'') + s = b'.'.join(result) + if not valid_string_length(s, trailing_dot): + raise IDNAError('Domain too long') + return s + + +def decode(s: Union[str, bytes, bytearray], strict: bool = False, uts46: bool = False, std3_rules: bool = False) -> str: + try: + if not isinstance(s, str): + s = str(s, 'ascii') + except UnicodeDecodeError: + raise IDNAError('Invalid ASCII in A-label') + if uts46: + s = uts46_remap(s, std3_rules, False) + trailing_dot = False + result = [] + if not strict: + labels = _unicode_dots_re.split(s) + else: + labels = s.split('.') + if not labels or labels == ['']: + raise IDNAError('Empty domain') + if not labels[-1]: + del labels[-1] + trailing_dot = True + for label in labels: + s = ulabel(label) + if s: + result.append(s) + else: + raise IDNAError('Empty label') + if trailing_dot: + result.append('') + return '.'.join(result) diff --git a/.venv/lib/python3.12/site-packages/idna/idnadata.py b/.venv/lib/python3.12/site-packages/idna/idnadata.py new file mode 100644 index 0000000..c61dcf9 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/idna/idnadata.py @@ -0,0 +1,4245 @@ +# This file is automatically generated by tools/idna-data + +__version__ = '15.1.0' +scripts = { + 'Greek': ( + 0x37000000374, + 0x37500000378, + 0x37a0000037e, + 0x37f00000380, + 0x38400000385, + 0x38600000387, + 0x3880000038b, + 0x38c0000038d, + 0x38e000003a2, + 0x3a3000003e2, + 0x3f000000400, + 0x1d2600001d2b, + 0x1d5d00001d62, + 0x1d6600001d6b, + 0x1dbf00001dc0, + 0x1f0000001f16, + 0x1f1800001f1e, + 0x1f2000001f46, + 0x1f4800001f4e, + 0x1f5000001f58, + 0x1f5900001f5a, + 0x1f5b00001f5c, + 0x1f5d00001f5e, + 0x1f5f00001f7e, + 0x1f8000001fb5, + 0x1fb600001fc5, + 0x1fc600001fd4, + 0x1fd600001fdc, + 0x1fdd00001ff0, + 0x1ff200001ff5, + 0x1ff600001fff, + 0x212600002127, + 0xab650000ab66, + 0x101400001018f, + 0x101a0000101a1, + 0x1d2000001d246, + ), + 'Han': ( + 0x2e8000002e9a, + 0x2e9b00002ef4, + 0x2f0000002fd6, + 0x300500003006, + 0x300700003008, + 0x30210000302a, + 0x30380000303c, + 0x340000004dc0, + 0x4e000000a000, + 0xf9000000fa6e, + 0xfa700000fada, + 0x16fe200016fe4, + 0x16ff000016ff2, + 0x200000002a6e0, + 0x2a7000002b73a, + 0x2b7400002b81e, + 0x2b8200002cea2, + 0x2ceb00002ebe1, + 0x2ebf00002ee5e, + 0x2f8000002fa1e, + 0x300000003134b, + 0x31350000323b0, + ), + 'Hebrew': ( + 0x591000005c8, + 0x5d0000005eb, + 0x5ef000005f5, + 0xfb1d0000fb37, + 0xfb380000fb3d, + 0xfb3e0000fb3f, + 0xfb400000fb42, + 0xfb430000fb45, + 0xfb460000fb50, + ), + 'Hiragana': ( + 0x304100003097, + 0x309d000030a0, + 0x1b0010001b120, + 0x1b1320001b133, + 0x1b1500001b153, + 0x1f2000001f201, + ), + 'Katakana': ( + 0x30a1000030fb, + 0x30fd00003100, + 0x31f000003200, + 0x32d0000032ff, + 0x330000003358, + 0xff660000ff70, + 0xff710000ff9e, + 0x1aff00001aff4, + 0x1aff50001affc, + 0x1affd0001afff, + 0x1b0000001b001, + 0x1b1200001b123, + 0x1b1550001b156, + 0x1b1640001b168, + ), +} +joining_types = { + 0xad: 84, + 0x300: 84, + 0x301: 84, + 0x302: 84, + 0x303: 84, + 0x304: 84, + 0x305: 84, + 0x306: 84, + 0x307: 84, + 0x308: 84, + 0x309: 84, + 0x30a: 84, + 0x30b: 84, + 0x30c: 84, + 0x30d: 84, + 0x30e: 84, + 0x30f: 84, + 0x310: 84, + 0x311: 84, + 0x312: 84, + 0x313: 84, + 0x314: 84, + 0x315: 84, + 0x316: 84, + 0x317: 84, + 0x318: 84, + 0x319: 84, + 0x31a: 84, + 0x31b: 84, + 0x31c: 84, + 0x31d: 84, + 0x31e: 84, + 0x31f: 84, + 0x320: 84, + 0x321: 84, + 0x322: 84, + 0x323: 84, + 0x324: 84, + 0x325: 84, + 0x326: 84, + 0x327: 84, + 0x328: 84, + 0x329: 84, + 0x32a: 84, + 0x32b: 84, + 0x32c: 84, + 0x32d: 84, + 0x32e: 84, + 0x32f: 84, + 0x330: 84, + 0x331: 84, + 0x332: 84, + 0x333: 84, + 0x334: 84, + 0x335: 84, + 0x336: 84, + 0x337: 84, + 0x338: 84, + 0x339: 84, + 0x33a: 84, + 0x33b: 84, + 0x33c: 84, + 0x33d: 84, + 0x33e: 84, + 0x33f: 84, + 0x340: 84, + 0x341: 84, + 0x342: 84, + 0x343: 84, + 0x344: 84, + 0x345: 84, + 0x346: 84, + 0x347: 84, + 0x348: 84, + 0x349: 84, + 0x34a: 84, + 0x34b: 84, + 0x34c: 84, + 0x34d: 84, + 0x34e: 84, + 0x34f: 84, + 0x350: 84, + 0x351: 84, + 0x352: 84, + 0x353: 84, + 0x354: 84, + 0x355: 84, + 0x356: 84, + 0x357: 84, + 0x358: 84, + 0x359: 84, + 0x35a: 84, + 0x35b: 84, + 0x35c: 84, + 0x35d: 84, + 0x35e: 84, + 0x35f: 84, + 0x360: 84, + 0x361: 84, + 0x362: 84, + 0x363: 84, + 0x364: 84, + 0x365: 84, + 0x366: 84, + 0x367: 84, + 0x368: 84, + 0x369: 84, + 0x36a: 84, + 0x36b: 84, + 0x36c: 84, + 0x36d: 84, + 0x36e: 84, + 0x36f: 84, + 0x483: 84, + 0x484: 84, + 0x485: 84, + 0x486: 84, + 0x487: 84, + 0x488: 84, + 0x489: 84, + 0x591: 84, + 0x592: 84, + 0x593: 84, + 0x594: 84, + 0x595: 84, + 0x596: 84, + 0x597: 84, + 0x598: 84, + 0x599: 84, + 0x59a: 84, + 0x59b: 84, + 0x59c: 84, + 0x59d: 84, + 0x59e: 84, + 0x59f: 84, + 0x5a0: 84, + 0x5a1: 84, + 0x5a2: 84, + 0x5a3: 84, + 0x5a4: 84, + 0x5a5: 84, + 0x5a6: 84, + 0x5a7: 84, + 0x5a8: 84, + 0x5a9: 84, + 0x5aa: 84, + 0x5ab: 84, + 0x5ac: 84, + 0x5ad: 84, + 0x5ae: 84, + 0x5af: 84, + 0x5b0: 84, + 0x5b1: 84, + 0x5b2: 84, + 0x5b3: 84, + 0x5b4: 84, + 0x5b5: 84, + 0x5b6: 84, + 0x5b7: 84, + 0x5b8: 84, + 0x5b9: 84, + 0x5ba: 84, + 0x5bb: 84, + 0x5bc: 84, + 0x5bd: 84, + 0x5bf: 84, + 0x5c1: 84, + 0x5c2: 84, + 0x5c4: 84, + 0x5c5: 84, + 0x5c7: 84, + 0x610: 84, + 0x611: 84, + 0x612: 84, + 0x613: 84, + 0x614: 84, + 0x615: 84, + 0x616: 84, + 0x617: 84, + 0x618: 84, + 0x619: 84, + 0x61a: 84, + 0x61c: 84, + 0x620: 68, + 0x622: 82, + 0x623: 82, + 0x624: 82, + 0x625: 82, + 0x626: 68, + 0x627: 82, + 0x628: 68, + 0x629: 82, + 0x62a: 68, + 0x62b: 68, + 0x62c: 68, + 0x62d: 68, + 0x62e: 68, + 0x62f: 82, + 0x630: 82, + 0x631: 82, + 0x632: 82, + 0x633: 68, + 0x634: 68, + 0x635: 68, + 0x636: 68, + 0x637: 68, + 0x638: 68, + 0x639: 68, + 0x63a: 68, + 0x63b: 68, + 0x63c: 68, + 0x63d: 68, + 0x63e: 68, + 0x63f: 68, + 0x640: 67, + 0x641: 68, + 0x642: 68, + 0x643: 68, + 0x644: 68, + 0x645: 68, + 0x646: 68, + 0x647: 68, + 0x648: 82, + 0x649: 68, + 0x64a: 68, + 0x64b: 84, + 0x64c: 84, + 0x64d: 84, + 0x64e: 84, + 0x64f: 84, + 0x650: 84, + 0x651: 84, + 0x652: 84, + 0x653: 84, + 0x654: 84, + 0x655: 84, + 0x656: 84, + 0x657: 84, + 0x658: 84, + 0x659: 84, + 0x65a: 84, + 0x65b: 84, + 0x65c: 84, + 0x65d: 84, + 0x65e: 84, + 0x65f: 84, + 0x66e: 68, + 0x66f: 68, + 0x670: 84, + 0x671: 82, + 0x672: 82, + 0x673: 82, + 0x675: 82, + 0x676: 82, + 0x677: 82, + 0x678: 68, + 0x679: 68, + 0x67a: 68, + 0x67b: 68, + 0x67c: 68, + 0x67d: 68, + 0x67e: 68, + 0x67f: 68, + 0x680: 68, + 0x681: 68, + 0x682: 68, + 0x683: 68, + 0x684: 68, + 0x685: 68, + 0x686: 68, + 0x687: 68, + 0x688: 82, + 0x689: 82, + 0x68a: 82, + 0x68b: 82, + 0x68c: 82, + 0x68d: 82, + 0x68e: 82, + 0x68f: 82, + 0x690: 82, + 0x691: 82, + 0x692: 82, + 0x693: 82, + 0x694: 82, + 0x695: 82, + 0x696: 82, + 0x697: 82, + 0x698: 82, + 0x699: 82, + 0x69a: 68, + 0x69b: 68, + 0x69c: 68, + 0x69d: 68, + 0x69e: 68, + 0x69f: 68, + 0x6a0: 68, + 0x6a1: 68, + 0x6a2: 68, + 0x6a3: 68, + 0x6a4: 68, + 0x6a5: 68, + 0x6a6: 68, + 0x6a7: 68, + 0x6a8: 68, + 0x6a9: 68, + 0x6aa: 68, + 0x6ab: 68, + 0x6ac: 68, + 0x6ad: 68, + 0x6ae: 68, + 0x6af: 68, + 0x6b0: 68, + 0x6b1: 68, + 0x6b2: 68, + 0x6b3: 68, + 0x6b4: 68, + 0x6b5: 68, + 0x6b6: 68, + 0x6b7: 68, + 0x6b8: 68, + 0x6b9: 68, + 0x6ba: 68, + 0x6bb: 68, + 0x6bc: 68, + 0x6bd: 68, + 0x6be: 68, + 0x6bf: 68, + 0x6c0: 82, + 0x6c1: 68, + 0x6c2: 68, + 0x6c3: 82, + 0x6c4: 82, + 0x6c5: 82, + 0x6c6: 82, + 0x6c7: 82, + 0x6c8: 82, + 0x6c9: 82, + 0x6ca: 82, + 0x6cb: 82, + 0x6cc: 68, + 0x6cd: 82, + 0x6ce: 68, + 0x6cf: 82, + 0x6d0: 68, + 0x6d1: 68, + 0x6d2: 82, + 0x6d3: 82, + 0x6d5: 82, + 0x6d6: 84, + 0x6d7: 84, + 0x6d8: 84, + 0x6d9: 84, + 0x6da: 84, + 0x6db: 84, + 0x6dc: 84, + 0x6df: 84, + 0x6e0: 84, + 0x6e1: 84, + 0x6e2: 84, + 0x6e3: 84, + 0x6e4: 84, + 0x6e7: 84, + 0x6e8: 84, + 0x6ea: 84, + 0x6eb: 84, + 0x6ec: 84, + 0x6ed: 84, + 0x6ee: 82, + 0x6ef: 82, + 0x6fa: 68, + 0x6fb: 68, + 0x6fc: 68, + 0x6ff: 68, + 0x70f: 84, + 0x710: 82, + 0x711: 84, + 0x712: 68, + 0x713: 68, + 0x714: 68, + 0x715: 82, + 0x716: 82, + 0x717: 82, + 0x718: 82, + 0x719: 82, + 0x71a: 68, + 0x71b: 68, + 0x71c: 68, + 0x71d: 68, + 0x71e: 82, + 0x71f: 68, + 0x720: 68, + 0x721: 68, + 0x722: 68, + 0x723: 68, + 0x724: 68, + 0x725: 68, + 0x726: 68, + 0x727: 68, + 0x728: 82, + 0x729: 68, + 0x72a: 82, + 0x72b: 68, + 0x72c: 82, + 0x72d: 68, + 0x72e: 68, + 0x72f: 82, + 0x730: 84, + 0x731: 84, + 0x732: 84, + 0x733: 84, + 0x734: 84, + 0x735: 84, + 0x736: 84, + 0x737: 84, + 0x738: 84, + 0x739: 84, + 0x73a: 84, + 0x73b: 84, + 0x73c: 84, + 0x73d: 84, + 0x73e: 84, + 0x73f: 84, + 0x740: 84, + 0x741: 84, + 0x742: 84, + 0x743: 84, + 0x744: 84, + 0x745: 84, + 0x746: 84, + 0x747: 84, + 0x748: 84, + 0x749: 84, + 0x74a: 84, + 0x74d: 82, + 0x74e: 68, + 0x74f: 68, + 0x750: 68, + 0x751: 68, + 0x752: 68, + 0x753: 68, + 0x754: 68, + 0x755: 68, + 0x756: 68, + 0x757: 68, + 0x758: 68, + 0x759: 82, + 0x75a: 82, + 0x75b: 82, + 0x75c: 68, + 0x75d: 68, + 0x75e: 68, + 0x75f: 68, + 0x760: 68, + 0x761: 68, + 0x762: 68, + 0x763: 68, + 0x764: 68, + 0x765: 68, + 0x766: 68, + 0x767: 68, + 0x768: 68, + 0x769: 68, + 0x76a: 68, + 0x76b: 82, + 0x76c: 82, + 0x76d: 68, + 0x76e: 68, + 0x76f: 68, + 0x770: 68, + 0x771: 82, + 0x772: 68, + 0x773: 82, + 0x774: 82, + 0x775: 68, + 0x776: 68, + 0x777: 68, + 0x778: 82, + 0x779: 82, + 0x77a: 68, + 0x77b: 68, + 0x77c: 68, + 0x77d: 68, + 0x77e: 68, + 0x77f: 68, + 0x7a6: 84, + 0x7a7: 84, + 0x7a8: 84, + 0x7a9: 84, + 0x7aa: 84, + 0x7ab: 84, + 0x7ac: 84, + 0x7ad: 84, + 0x7ae: 84, + 0x7af: 84, + 0x7b0: 84, + 0x7ca: 68, + 0x7cb: 68, + 0x7cc: 68, + 0x7cd: 68, + 0x7ce: 68, + 0x7cf: 68, + 0x7d0: 68, + 0x7d1: 68, + 0x7d2: 68, + 0x7d3: 68, + 0x7d4: 68, + 0x7d5: 68, + 0x7d6: 68, + 0x7d7: 68, + 0x7d8: 68, + 0x7d9: 68, + 0x7da: 68, + 0x7db: 68, + 0x7dc: 68, + 0x7dd: 68, + 0x7de: 68, + 0x7df: 68, + 0x7e0: 68, + 0x7e1: 68, + 0x7e2: 68, + 0x7e3: 68, + 0x7e4: 68, + 0x7e5: 68, + 0x7e6: 68, + 0x7e7: 68, + 0x7e8: 68, + 0x7e9: 68, + 0x7ea: 68, + 0x7eb: 84, + 0x7ec: 84, + 0x7ed: 84, + 0x7ee: 84, + 0x7ef: 84, + 0x7f0: 84, + 0x7f1: 84, + 0x7f2: 84, + 0x7f3: 84, + 0x7fa: 67, + 0x7fd: 84, + 0x816: 84, + 0x817: 84, + 0x818: 84, + 0x819: 84, + 0x81b: 84, + 0x81c: 84, + 0x81d: 84, + 0x81e: 84, + 0x81f: 84, + 0x820: 84, + 0x821: 84, + 0x822: 84, + 0x823: 84, + 0x825: 84, + 0x826: 84, + 0x827: 84, + 0x829: 84, + 0x82a: 84, + 0x82b: 84, + 0x82c: 84, + 0x82d: 84, + 0x840: 82, + 0x841: 68, + 0x842: 68, + 0x843: 68, + 0x844: 68, + 0x845: 68, + 0x846: 82, + 0x847: 82, + 0x848: 68, + 0x849: 82, + 0x84a: 68, + 0x84b: 68, + 0x84c: 68, + 0x84d: 68, + 0x84e: 68, + 0x84f: 68, + 0x850: 68, + 0x851: 68, + 0x852: 68, + 0x853: 68, + 0x854: 82, + 0x855: 68, + 0x856: 82, + 0x857: 82, + 0x858: 82, + 0x859: 84, + 0x85a: 84, + 0x85b: 84, + 0x860: 68, + 0x862: 68, + 0x863: 68, + 0x864: 68, + 0x865: 68, + 0x867: 82, + 0x868: 68, + 0x869: 82, + 0x86a: 82, + 0x870: 82, + 0x871: 82, + 0x872: 82, + 0x873: 82, + 0x874: 82, + 0x875: 82, + 0x876: 82, + 0x877: 82, + 0x878: 82, + 0x879: 82, + 0x87a: 82, + 0x87b: 82, + 0x87c: 82, + 0x87d: 82, + 0x87e: 82, + 0x87f: 82, + 0x880: 82, + 0x881: 82, + 0x882: 82, + 0x883: 67, + 0x884: 67, + 0x885: 67, + 0x886: 68, + 0x889: 68, + 0x88a: 68, + 0x88b: 68, + 0x88c: 68, + 0x88d: 68, + 0x88e: 82, + 0x898: 84, + 0x899: 84, + 0x89a: 84, + 0x89b: 84, + 0x89c: 84, + 0x89d: 84, + 0x89e: 84, + 0x89f: 84, + 0x8a0: 68, + 0x8a1: 68, + 0x8a2: 68, + 0x8a3: 68, + 0x8a4: 68, + 0x8a5: 68, + 0x8a6: 68, + 0x8a7: 68, + 0x8a8: 68, + 0x8a9: 68, + 0x8aa: 82, + 0x8ab: 82, + 0x8ac: 82, + 0x8ae: 82, + 0x8af: 68, + 0x8b0: 68, + 0x8b1: 82, + 0x8b2: 82, + 0x8b3: 68, + 0x8b4: 68, + 0x8b5: 68, + 0x8b6: 68, + 0x8b7: 68, + 0x8b8: 68, + 0x8b9: 82, + 0x8ba: 68, + 0x8bb: 68, + 0x8bc: 68, + 0x8bd: 68, + 0x8be: 68, + 0x8bf: 68, + 0x8c0: 68, + 0x8c1: 68, + 0x8c2: 68, + 0x8c3: 68, + 0x8c4: 68, + 0x8c5: 68, + 0x8c6: 68, + 0x8c7: 68, + 0x8c8: 68, + 0x8ca: 84, + 0x8cb: 84, + 0x8cc: 84, + 0x8cd: 84, + 0x8ce: 84, + 0x8cf: 84, + 0x8d0: 84, + 0x8d1: 84, + 0x8d2: 84, + 0x8d3: 84, + 0x8d4: 84, + 0x8d5: 84, + 0x8d6: 84, + 0x8d7: 84, + 0x8d8: 84, + 0x8d9: 84, + 0x8da: 84, + 0x8db: 84, + 0x8dc: 84, + 0x8dd: 84, + 0x8de: 84, + 0x8df: 84, + 0x8e0: 84, + 0x8e1: 84, + 0x8e3: 84, + 0x8e4: 84, + 0x8e5: 84, + 0x8e6: 84, + 0x8e7: 84, + 0x8e8: 84, + 0x8e9: 84, + 0x8ea: 84, + 0x8eb: 84, + 0x8ec: 84, + 0x8ed: 84, + 0x8ee: 84, + 0x8ef: 84, + 0x8f0: 84, + 0x8f1: 84, + 0x8f2: 84, + 0x8f3: 84, + 0x8f4: 84, + 0x8f5: 84, + 0x8f6: 84, + 0x8f7: 84, + 0x8f8: 84, + 0x8f9: 84, + 0x8fa: 84, + 0x8fb: 84, + 0x8fc: 84, + 0x8fd: 84, + 0x8fe: 84, + 0x8ff: 84, + 0x900: 84, + 0x901: 84, + 0x902: 84, + 0x93a: 84, + 0x93c: 84, + 0x941: 84, + 0x942: 84, + 0x943: 84, + 0x944: 84, + 0x945: 84, + 0x946: 84, + 0x947: 84, + 0x948: 84, + 0x94d: 84, + 0x951: 84, + 0x952: 84, + 0x953: 84, + 0x954: 84, + 0x955: 84, + 0x956: 84, + 0x957: 84, + 0x962: 84, + 0x963: 84, + 0x981: 84, + 0x9bc: 84, + 0x9c1: 84, + 0x9c2: 84, + 0x9c3: 84, + 0x9c4: 84, + 0x9cd: 84, + 0x9e2: 84, + 0x9e3: 84, + 0x9fe: 84, + 0xa01: 84, + 0xa02: 84, + 0xa3c: 84, + 0xa41: 84, + 0xa42: 84, + 0xa47: 84, + 0xa48: 84, + 0xa4b: 84, + 0xa4c: 84, + 0xa4d: 84, + 0xa51: 84, + 0xa70: 84, + 0xa71: 84, + 0xa75: 84, + 0xa81: 84, + 0xa82: 84, + 0xabc: 84, + 0xac1: 84, + 0xac2: 84, + 0xac3: 84, + 0xac4: 84, + 0xac5: 84, + 0xac7: 84, + 0xac8: 84, + 0xacd: 84, + 0xae2: 84, + 0xae3: 84, + 0xafa: 84, + 0xafb: 84, + 0xafc: 84, + 0xafd: 84, + 0xafe: 84, + 0xaff: 84, + 0xb01: 84, + 0xb3c: 84, + 0xb3f: 84, + 0xb41: 84, + 0xb42: 84, + 0xb43: 84, + 0xb44: 84, + 0xb4d: 84, + 0xb55: 84, + 0xb56: 84, + 0xb62: 84, + 0xb63: 84, + 0xb82: 84, + 0xbc0: 84, + 0xbcd: 84, + 0xc00: 84, + 0xc04: 84, + 0xc3c: 84, + 0xc3e: 84, + 0xc3f: 84, + 0xc40: 84, + 0xc46: 84, + 0xc47: 84, + 0xc48: 84, + 0xc4a: 84, + 0xc4b: 84, + 0xc4c: 84, + 0xc4d: 84, + 0xc55: 84, + 0xc56: 84, + 0xc62: 84, + 0xc63: 84, + 0xc81: 84, + 0xcbc: 84, + 0xcbf: 84, + 0xcc6: 84, + 0xccc: 84, + 0xccd: 84, + 0xce2: 84, + 0xce3: 84, + 0xd00: 84, + 0xd01: 84, + 0xd3b: 84, + 0xd3c: 84, + 0xd41: 84, + 0xd42: 84, + 0xd43: 84, + 0xd44: 84, + 0xd4d: 84, + 0xd62: 84, + 0xd63: 84, + 0xd81: 84, + 0xdca: 84, + 0xdd2: 84, + 0xdd3: 84, + 0xdd4: 84, + 0xdd6: 84, + 0xe31: 84, + 0xe34: 84, + 0xe35: 84, + 0xe36: 84, + 0xe37: 84, + 0xe38: 84, + 0xe39: 84, + 0xe3a: 84, + 0xe47: 84, + 0xe48: 84, + 0xe49: 84, + 0xe4a: 84, + 0xe4b: 84, + 0xe4c: 84, + 0xe4d: 84, + 0xe4e: 84, + 0xeb1: 84, + 0xeb4: 84, + 0xeb5: 84, + 0xeb6: 84, + 0xeb7: 84, + 0xeb8: 84, + 0xeb9: 84, + 0xeba: 84, + 0xebb: 84, + 0xebc: 84, + 0xec8: 84, + 0xec9: 84, + 0xeca: 84, + 0xecb: 84, + 0xecc: 84, + 0xecd: 84, + 0xece: 84, + 0xf18: 84, + 0xf19: 84, + 0xf35: 84, + 0xf37: 84, + 0xf39: 84, + 0xf71: 84, + 0xf72: 84, + 0xf73: 84, + 0xf74: 84, + 0xf75: 84, + 0xf76: 84, + 0xf77: 84, + 0xf78: 84, + 0xf79: 84, + 0xf7a: 84, + 0xf7b: 84, + 0xf7c: 84, + 0xf7d: 84, + 0xf7e: 84, + 0xf80: 84, + 0xf81: 84, + 0xf82: 84, + 0xf83: 84, + 0xf84: 84, + 0xf86: 84, + 0xf87: 84, + 0xf8d: 84, + 0xf8e: 84, + 0xf8f: 84, + 0xf90: 84, + 0xf91: 84, + 0xf92: 84, + 0xf93: 84, + 0xf94: 84, + 0xf95: 84, + 0xf96: 84, + 0xf97: 84, + 0xf99: 84, + 0xf9a: 84, + 0xf9b: 84, + 0xf9c: 84, + 0xf9d: 84, + 0xf9e: 84, + 0xf9f: 84, + 0xfa0: 84, + 0xfa1: 84, + 0xfa2: 84, + 0xfa3: 84, + 0xfa4: 84, + 0xfa5: 84, + 0xfa6: 84, + 0xfa7: 84, + 0xfa8: 84, + 0xfa9: 84, + 0xfaa: 84, + 0xfab: 84, + 0xfac: 84, + 0xfad: 84, + 0xfae: 84, + 0xfaf: 84, + 0xfb0: 84, + 0xfb1: 84, + 0xfb2: 84, + 0xfb3: 84, + 0xfb4: 84, + 0xfb5: 84, + 0xfb6: 84, + 0xfb7: 84, + 0xfb8: 84, + 0xfb9: 84, + 0xfba: 84, + 0xfbb: 84, + 0xfbc: 84, + 0xfc6: 84, + 0x102d: 84, + 0x102e: 84, + 0x102f: 84, + 0x1030: 84, + 0x1032: 84, + 0x1033: 84, + 0x1034: 84, + 0x1035: 84, + 0x1036: 84, + 0x1037: 84, + 0x1039: 84, + 0x103a: 84, + 0x103d: 84, + 0x103e: 84, + 0x1058: 84, + 0x1059: 84, + 0x105e: 84, + 0x105f: 84, + 0x1060: 84, + 0x1071: 84, + 0x1072: 84, + 0x1073: 84, + 0x1074: 84, + 0x1082: 84, + 0x1085: 84, + 0x1086: 84, + 0x108d: 84, + 0x109d: 84, + 0x135d: 84, + 0x135e: 84, + 0x135f: 84, + 0x1712: 84, + 0x1713: 84, + 0x1714: 84, + 0x1732: 84, + 0x1733: 84, + 0x1752: 84, + 0x1753: 84, + 0x1772: 84, + 0x1773: 84, + 0x17b4: 84, + 0x17b5: 84, + 0x17b7: 84, + 0x17b8: 84, + 0x17b9: 84, + 0x17ba: 84, + 0x17bb: 84, + 0x17bc: 84, + 0x17bd: 84, + 0x17c6: 84, + 0x17c9: 84, + 0x17ca: 84, + 0x17cb: 84, + 0x17cc: 84, + 0x17cd: 84, + 0x17ce: 84, + 0x17cf: 84, + 0x17d0: 84, + 0x17d1: 84, + 0x17d2: 84, + 0x17d3: 84, + 0x17dd: 84, + 0x1807: 68, + 0x180a: 67, + 0x180b: 84, + 0x180c: 84, + 0x180d: 84, + 0x180f: 84, + 0x1820: 68, + 0x1821: 68, + 0x1822: 68, + 0x1823: 68, + 0x1824: 68, + 0x1825: 68, + 0x1826: 68, + 0x1827: 68, + 0x1828: 68, + 0x1829: 68, + 0x182a: 68, + 0x182b: 68, + 0x182c: 68, + 0x182d: 68, + 0x182e: 68, + 0x182f: 68, + 0x1830: 68, + 0x1831: 68, + 0x1832: 68, + 0x1833: 68, + 0x1834: 68, + 0x1835: 68, + 0x1836: 68, + 0x1837: 68, + 0x1838: 68, + 0x1839: 68, + 0x183a: 68, + 0x183b: 68, + 0x183c: 68, + 0x183d: 68, + 0x183e: 68, + 0x183f: 68, + 0x1840: 68, + 0x1841: 68, + 0x1842: 68, + 0x1843: 68, + 0x1844: 68, + 0x1845: 68, + 0x1846: 68, + 0x1847: 68, + 0x1848: 68, + 0x1849: 68, + 0x184a: 68, + 0x184b: 68, + 0x184c: 68, + 0x184d: 68, + 0x184e: 68, + 0x184f: 68, + 0x1850: 68, + 0x1851: 68, + 0x1852: 68, + 0x1853: 68, + 0x1854: 68, + 0x1855: 68, + 0x1856: 68, + 0x1857: 68, + 0x1858: 68, + 0x1859: 68, + 0x185a: 68, + 0x185b: 68, + 0x185c: 68, + 0x185d: 68, + 0x185e: 68, + 0x185f: 68, + 0x1860: 68, + 0x1861: 68, + 0x1862: 68, + 0x1863: 68, + 0x1864: 68, + 0x1865: 68, + 0x1866: 68, + 0x1867: 68, + 0x1868: 68, + 0x1869: 68, + 0x186a: 68, + 0x186b: 68, + 0x186c: 68, + 0x186d: 68, + 0x186e: 68, + 0x186f: 68, + 0x1870: 68, + 0x1871: 68, + 0x1872: 68, + 0x1873: 68, + 0x1874: 68, + 0x1875: 68, + 0x1876: 68, + 0x1877: 68, + 0x1878: 68, + 0x1885: 84, + 0x1886: 84, + 0x1887: 68, + 0x1888: 68, + 0x1889: 68, + 0x188a: 68, + 0x188b: 68, + 0x188c: 68, + 0x188d: 68, + 0x188e: 68, + 0x188f: 68, + 0x1890: 68, + 0x1891: 68, + 0x1892: 68, + 0x1893: 68, + 0x1894: 68, + 0x1895: 68, + 0x1896: 68, + 0x1897: 68, + 0x1898: 68, + 0x1899: 68, + 0x189a: 68, + 0x189b: 68, + 0x189c: 68, + 0x189d: 68, + 0x189e: 68, + 0x189f: 68, + 0x18a0: 68, + 0x18a1: 68, + 0x18a2: 68, + 0x18a3: 68, + 0x18a4: 68, + 0x18a5: 68, + 0x18a6: 68, + 0x18a7: 68, + 0x18a8: 68, + 0x18a9: 84, + 0x18aa: 68, + 0x1920: 84, + 0x1921: 84, + 0x1922: 84, + 0x1927: 84, + 0x1928: 84, + 0x1932: 84, + 0x1939: 84, + 0x193a: 84, + 0x193b: 84, + 0x1a17: 84, + 0x1a18: 84, + 0x1a1b: 84, + 0x1a56: 84, + 0x1a58: 84, + 0x1a59: 84, + 0x1a5a: 84, + 0x1a5b: 84, + 0x1a5c: 84, + 0x1a5d: 84, + 0x1a5e: 84, + 0x1a60: 84, + 0x1a62: 84, + 0x1a65: 84, + 0x1a66: 84, + 0x1a67: 84, + 0x1a68: 84, + 0x1a69: 84, + 0x1a6a: 84, + 0x1a6b: 84, + 0x1a6c: 84, + 0x1a73: 84, + 0x1a74: 84, + 0x1a75: 84, + 0x1a76: 84, + 0x1a77: 84, + 0x1a78: 84, + 0x1a79: 84, + 0x1a7a: 84, + 0x1a7b: 84, + 0x1a7c: 84, + 0x1a7f: 84, + 0x1ab0: 84, + 0x1ab1: 84, + 0x1ab2: 84, + 0x1ab3: 84, + 0x1ab4: 84, + 0x1ab5: 84, + 0x1ab6: 84, + 0x1ab7: 84, + 0x1ab8: 84, + 0x1ab9: 84, + 0x1aba: 84, + 0x1abb: 84, + 0x1abc: 84, + 0x1abd: 84, + 0x1abe: 84, + 0x1abf: 84, + 0x1ac0: 84, + 0x1ac1: 84, + 0x1ac2: 84, + 0x1ac3: 84, + 0x1ac4: 84, + 0x1ac5: 84, + 0x1ac6: 84, + 0x1ac7: 84, + 0x1ac8: 84, + 0x1ac9: 84, + 0x1aca: 84, + 0x1acb: 84, + 0x1acc: 84, + 0x1acd: 84, + 0x1ace: 84, + 0x1b00: 84, + 0x1b01: 84, + 0x1b02: 84, + 0x1b03: 84, + 0x1b34: 84, + 0x1b36: 84, + 0x1b37: 84, + 0x1b38: 84, + 0x1b39: 84, + 0x1b3a: 84, + 0x1b3c: 84, + 0x1b42: 84, + 0x1b6b: 84, + 0x1b6c: 84, + 0x1b6d: 84, + 0x1b6e: 84, + 0x1b6f: 84, + 0x1b70: 84, + 0x1b71: 84, + 0x1b72: 84, + 0x1b73: 84, + 0x1b80: 84, + 0x1b81: 84, + 0x1ba2: 84, + 0x1ba3: 84, + 0x1ba4: 84, + 0x1ba5: 84, + 0x1ba8: 84, + 0x1ba9: 84, + 0x1bab: 84, + 0x1bac: 84, + 0x1bad: 84, + 0x1be6: 84, + 0x1be8: 84, + 0x1be9: 84, + 0x1bed: 84, + 0x1bef: 84, + 0x1bf0: 84, + 0x1bf1: 84, + 0x1c2c: 84, + 0x1c2d: 84, + 0x1c2e: 84, + 0x1c2f: 84, + 0x1c30: 84, + 0x1c31: 84, + 0x1c32: 84, + 0x1c33: 84, + 0x1c36: 84, + 0x1c37: 84, + 0x1cd0: 84, + 0x1cd1: 84, + 0x1cd2: 84, + 0x1cd4: 84, + 0x1cd5: 84, + 0x1cd6: 84, + 0x1cd7: 84, + 0x1cd8: 84, + 0x1cd9: 84, + 0x1cda: 84, + 0x1cdb: 84, + 0x1cdc: 84, + 0x1cdd: 84, + 0x1cde: 84, + 0x1cdf: 84, + 0x1ce0: 84, + 0x1ce2: 84, + 0x1ce3: 84, + 0x1ce4: 84, + 0x1ce5: 84, + 0x1ce6: 84, + 0x1ce7: 84, + 0x1ce8: 84, + 0x1ced: 84, + 0x1cf4: 84, + 0x1cf8: 84, + 0x1cf9: 84, + 0x1dc0: 84, + 0x1dc1: 84, + 0x1dc2: 84, + 0x1dc3: 84, + 0x1dc4: 84, + 0x1dc5: 84, + 0x1dc6: 84, + 0x1dc7: 84, + 0x1dc8: 84, + 0x1dc9: 84, + 0x1dca: 84, + 0x1dcb: 84, + 0x1dcc: 84, + 0x1dcd: 84, + 0x1dce: 84, + 0x1dcf: 84, + 0x1dd0: 84, + 0x1dd1: 84, + 0x1dd2: 84, + 0x1dd3: 84, + 0x1dd4: 84, + 0x1dd5: 84, + 0x1dd6: 84, + 0x1dd7: 84, + 0x1dd8: 84, + 0x1dd9: 84, + 0x1dda: 84, + 0x1ddb: 84, + 0x1ddc: 84, + 0x1ddd: 84, + 0x1dde: 84, + 0x1ddf: 84, + 0x1de0: 84, + 0x1de1: 84, + 0x1de2: 84, + 0x1de3: 84, + 0x1de4: 84, + 0x1de5: 84, + 0x1de6: 84, + 0x1de7: 84, + 0x1de8: 84, + 0x1de9: 84, + 0x1dea: 84, + 0x1deb: 84, + 0x1dec: 84, + 0x1ded: 84, + 0x1dee: 84, + 0x1def: 84, + 0x1df0: 84, + 0x1df1: 84, + 0x1df2: 84, + 0x1df3: 84, + 0x1df4: 84, + 0x1df5: 84, + 0x1df6: 84, + 0x1df7: 84, + 0x1df8: 84, + 0x1df9: 84, + 0x1dfa: 84, + 0x1dfb: 84, + 0x1dfc: 84, + 0x1dfd: 84, + 0x1dfe: 84, + 0x1dff: 84, + 0x200b: 84, + 0x200d: 67, + 0x200e: 84, + 0x200f: 84, + 0x202a: 84, + 0x202b: 84, + 0x202c: 84, + 0x202d: 84, + 0x202e: 84, + 0x2060: 84, + 0x2061: 84, + 0x2062: 84, + 0x2063: 84, + 0x2064: 84, + 0x206a: 84, + 0x206b: 84, + 0x206c: 84, + 0x206d: 84, + 0x206e: 84, + 0x206f: 84, + 0x20d0: 84, + 0x20d1: 84, + 0x20d2: 84, + 0x20d3: 84, + 0x20d4: 84, + 0x20d5: 84, + 0x20d6: 84, + 0x20d7: 84, + 0x20d8: 84, + 0x20d9: 84, + 0x20da: 84, + 0x20db: 84, + 0x20dc: 84, + 0x20dd: 84, + 0x20de: 84, + 0x20df: 84, + 0x20e0: 84, + 0x20e1: 84, + 0x20e2: 84, + 0x20e3: 84, + 0x20e4: 84, + 0x20e5: 84, + 0x20e6: 84, + 0x20e7: 84, + 0x20e8: 84, + 0x20e9: 84, + 0x20ea: 84, + 0x20eb: 84, + 0x20ec: 84, + 0x20ed: 84, + 0x20ee: 84, + 0x20ef: 84, + 0x20f0: 84, + 0x2cef: 84, + 0x2cf0: 84, + 0x2cf1: 84, + 0x2d7f: 84, + 0x2de0: 84, + 0x2de1: 84, + 0x2de2: 84, + 0x2de3: 84, + 0x2de4: 84, + 0x2de5: 84, + 0x2de6: 84, + 0x2de7: 84, + 0x2de8: 84, + 0x2de9: 84, + 0x2dea: 84, + 0x2deb: 84, + 0x2dec: 84, + 0x2ded: 84, + 0x2dee: 84, + 0x2def: 84, + 0x2df0: 84, + 0x2df1: 84, + 0x2df2: 84, + 0x2df3: 84, + 0x2df4: 84, + 0x2df5: 84, + 0x2df6: 84, + 0x2df7: 84, + 0x2df8: 84, + 0x2df9: 84, + 0x2dfa: 84, + 0x2dfb: 84, + 0x2dfc: 84, + 0x2dfd: 84, + 0x2dfe: 84, + 0x2dff: 84, + 0x302a: 84, + 0x302b: 84, + 0x302c: 84, + 0x302d: 84, + 0x3099: 84, + 0x309a: 84, + 0xa66f: 84, + 0xa670: 84, + 0xa671: 84, + 0xa672: 84, + 0xa674: 84, + 0xa675: 84, + 0xa676: 84, + 0xa677: 84, + 0xa678: 84, + 0xa679: 84, + 0xa67a: 84, + 0xa67b: 84, + 0xa67c: 84, + 0xa67d: 84, + 0xa69e: 84, + 0xa69f: 84, + 0xa6f0: 84, + 0xa6f1: 84, + 0xa802: 84, + 0xa806: 84, + 0xa80b: 84, + 0xa825: 84, + 0xa826: 84, + 0xa82c: 84, + 0xa840: 68, + 0xa841: 68, + 0xa842: 68, + 0xa843: 68, + 0xa844: 68, + 0xa845: 68, + 0xa846: 68, + 0xa847: 68, + 0xa848: 68, + 0xa849: 68, + 0xa84a: 68, + 0xa84b: 68, + 0xa84c: 68, + 0xa84d: 68, + 0xa84e: 68, + 0xa84f: 68, + 0xa850: 68, + 0xa851: 68, + 0xa852: 68, + 0xa853: 68, + 0xa854: 68, + 0xa855: 68, + 0xa856: 68, + 0xa857: 68, + 0xa858: 68, + 0xa859: 68, + 0xa85a: 68, + 0xa85b: 68, + 0xa85c: 68, + 0xa85d: 68, + 0xa85e: 68, + 0xa85f: 68, + 0xa860: 68, + 0xa861: 68, + 0xa862: 68, + 0xa863: 68, + 0xa864: 68, + 0xa865: 68, + 0xa866: 68, + 0xa867: 68, + 0xa868: 68, + 0xa869: 68, + 0xa86a: 68, + 0xa86b: 68, + 0xa86c: 68, + 0xa86d: 68, + 0xa86e: 68, + 0xa86f: 68, + 0xa870: 68, + 0xa871: 68, + 0xa872: 76, + 0xa8c4: 84, + 0xa8c5: 84, + 0xa8e0: 84, + 0xa8e1: 84, + 0xa8e2: 84, + 0xa8e3: 84, + 0xa8e4: 84, + 0xa8e5: 84, + 0xa8e6: 84, + 0xa8e7: 84, + 0xa8e8: 84, + 0xa8e9: 84, + 0xa8ea: 84, + 0xa8eb: 84, + 0xa8ec: 84, + 0xa8ed: 84, + 0xa8ee: 84, + 0xa8ef: 84, + 0xa8f0: 84, + 0xa8f1: 84, + 0xa8ff: 84, + 0xa926: 84, + 0xa927: 84, + 0xa928: 84, + 0xa929: 84, + 0xa92a: 84, + 0xa92b: 84, + 0xa92c: 84, + 0xa92d: 84, + 0xa947: 84, + 0xa948: 84, + 0xa949: 84, + 0xa94a: 84, + 0xa94b: 84, + 0xa94c: 84, + 0xa94d: 84, + 0xa94e: 84, + 0xa94f: 84, + 0xa950: 84, + 0xa951: 84, + 0xa980: 84, + 0xa981: 84, + 0xa982: 84, + 0xa9b3: 84, + 0xa9b6: 84, + 0xa9b7: 84, + 0xa9b8: 84, + 0xa9b9: 84, + 0xa9bc: 84, + 0xa9bd: 84, + 0xa9e5: 84, + 0xaa29: 84, + 0xaa2a: 84, + 0xaa2b: 84, + 0xaa2c: 84, + 0xaa2d: 84, + 0xaa2e: 84, + 0xaa31: 84, + 0xaa32: 84, + 0xaa35: 84, + 0xaa36: 84, + 0xaa43: 84, + 0xaa4c: 84, + 0xaa7c: 84, + 0xaab0: 84, + 0xaab2: 84, + 0xaab3: 84, + 0xaab4: 84, + 0xaab7: 84, + 0xaab8: 84, + 0xaabe: 84, + 0xaabf: 84, + 0xaac1: 84, + 0xaaec: 84, + 0xaaed: 84, + 0xaaf6: 84, + 0xabe5: 84, + 0xabe8: 84, + 0xabed: 84, + 0xfb1e: 84, + 0xfe00: 84, + 0xfe01: 84, + 0xfe02: 84, + 0xfe03: 84, + 0xfe04: 84, + 0xfe05: 84, + 0xfe06: 84, + 0xfe07: 84, + 0xfe08: 84, + 0xfe09: 84, + 0xfe0a: 84, + 0xfe0b: 84, + 0xfe0c: 84, + 0xfe0d: 84, + 0xfe0e: 84, + 0xfe0f: 84, + 0xfe20: 84, + 0xfe21: 84, + 0xfe22: 84, + 0xfe23: 84, + 0xfe24: 84, + 0xfe25: 84, + 0xfe26: 84, + 0xfe27: 84, + 0xfe28: 84, + 0xfe29: 84, + 0xfe2a: 84, + 0xfe2b: 84, + 0xfe2c: 84, + 0xfe2d: 84, + 0xfe2e: 84, + 0xfe2f: 84, + 0xfeff: 84, + 0xfff9: 84, + 0xfffa: 84, + 0xfffb: 84, + 0x101fd: 84, + 0x102e0: 84, + 0x10376: 84, + 0x10377: 84, + 0x10378: 84, + 0x10379: 84, + 0x1037a: 84, + 0x10a01: 84, + 0x10a02: 84, + 0x10a03: 84, + 0x10a05: 84, + 0x10a06: 84, + 0x10a0c: 84, + 0x10a0d: 84, + 0x10a0e: 84, + 0x10a0f: 84, + 0x10a38: 84, + 0x10a39: 84, + 0x10a3a: 84, + 0x10a3f: 84, + 0x10ac0: 68, + 0x10ac1: 68, + 0x10ac2: 68, + 0x10ac3: 68, + 0x10ac4: 68, + 0x10ac5: 82, + 0x10ac7: 82, + 0x10ac9: 82, + 0x10aca: 82, + 0x10acd: 76, + 0x10ace: 82, + 0x10acf: 82, + 0x10ad0: 82, + 0x10ad1: 82, + 0x10ad2: 82, + 0x10ad3: 68, + 0x10ad4: 68, + 0x10ad5: 68, + 0x10ad6: 68, + 0x10ad7: 76, + 0x10ad8: 68, + 0x10ad9: 68, + 0x10ada: 68, + 0x10adb: 68, + 0x10adc: 68, + 0x10add: 82, + 0x10ade: 68, + 0x10adf: 68, + 0x10ae0: 68, + 0x10ae1: 82, + 0x10ae4: 82, + 0x10ae5: 84, + 0x10ae6: 84, + 0x10aeb: 68, + 0x10aec: 68, + 0x10aed: 68, + 0x10aee: 68, + 0x10aef: 82, + 0x10b80: 68, + 0x10b81: 82, + 0x10b82: 68, + 0x10b83: 82, + 0x10b84: 82, + 0x10b85: 82, + 0x10b86: 68, + 0x10b87: 68, + 0x10b88: 68, + 0x10b89: 82, + 0x10b8a: 68, + 0x10b8b: 68, + 0x10b8c: 82, + 0x10b8d: 68, + 0x10b8e: 82, + 0x10b8f: 82, + 0x10b90: 68, + 0x10b91: 82, + 0x10ba9: 82, + 0x10baa: 82, + 0x10bab: 82, + 0x10bac: 82, + 0x10bad: 68, + 0x10bae: 68, + 0x10d00: 76, + 0x10d01: 68, + 0x10d02: 68, + 0x10d03: 68, + 0x10d04: 68, + 0x10d05: 68, + 0x10d06: 68, + 0x10d07: 68, + 0x10d08: 68, + 0x10d09: 68, + 0x10d0a: 68, + 0x10d0b: 68, + 0x10d0c: 68, + 0x10d0d: 68, + 0x10d0e: 68, + 0x10d0f: 68, + 0x10d10: 68, + 0x10d11: 68, + 0x10d12: 68, + 0x10d13: 68, + 0x10d14: 68, + 0x10d15: 68, + 0x10d16: 68, + 0x10d17: 68, + 0x10d18: 68, + 0x10d19: 68, + 0x10d1a: 68, + 0x10d1b: 68, + 0x10d1c: 68, + 0x10d1d: 68, + 0x10d1e: 68, + 0x10d1f: 68, + 0x10d20: 68, + 0x10d21: 68, + 0x10d22: 82, + 0x10d23: 68, + 0x10d24: 84, + 0x10d25: 84, + 0x10d26: 84, + 0x10d27: 84, + 0x10eab: 84, + 0x10eac: 84, + 0x10efd: 84, + 0x10efe: 84, + 0x10eff: 84, + 0x10f30: 68, + 0x10f31: 68, + 0x10f32: 68, + 0x10f33: 82, + 0x10f34: 68, + 0x10f35: 68, + 0x10f36: 68, + 0x10f37: 68, + 0x10f38: 68, + 0x10f39: 68, + 0x10f3a: 68, + 0x10f3b: 68, + 0x10f3c: 68, + 0x10f3d: 68, + 0x10f3e: 68, + 0x10f3f: 68, + 0x10f40: 68, + 0x10f41: 68, + 0x10f42: 68, + 0x10f43: 68, + 0x10f44: 68, + 0x10f46: 84, + 0x10f47: 84, + 0x10f48: 84, + 0x10f49: 84, + 0x10f4a: 84, + 0x10f4b: 84, + 0x10f4c: 84, + 0x10f4d: 84, + 0x10f4e: 84, + 0x10f4f: 84, + 0x10f50: 84, + 0x10f51: 68, + 0x10f52: 68, + 0x10f53: 68, + 0x10f54: 82, + 0x10f70: 68, + 0x10f71: 68, + 0x10f72: 68, + 0x10f73: 68, + 0x10f74: 82, + 0x10f75: 82, + 0x10f76: 68, + 0x10f77: 68, + 0x10f78: 68, + 0x10f79: 68, + 0x10f7a: 68, + 0x10f7b: 68, + 0x10f7c: 68, + 0x10f7d: 68, + 0x10f7e: 68, + 0x10f7f: 68, + 0x10f80: 68, + 0x10f81: 68, + 0x10f82: 84, + 0x10f83: 84, + 0x10f84: 84, + 0x10f85: 84, + 0x10fb0: 68, + 0x10fb2: 68, + 0x10fb3: 68, + 0x10fb4: 82, + 0x10fb5: 82, + 0x10fb6: 82, + 0x10fb8: 68, + 0x10fb9: 82, + 0x10fba: 82, + 0x10fbb: 68, + 0x10fbc: 68, + 0x10fbd: 82, + 0x10fbe: 68, + 0x10fbf: 68, + 0x10fc1: 68, + 0x10fc2: 82, + 0x10fc3: 82, + 0x10fc4: 68, + 0x10fc9: 82, + 0x10fca: 68, + 0x10fcb: 76, + 0x11001: 84, + 0x11038: 84, + 0x11039: 84, + 0x1103a: 84, + 0x1103b: 84, + 0x1103c: 84, + 0x1103d: 84, + 0x1103e: 84, + 0x1103f: 84, + 0x11040: 84, + 0x11041: 84, + 0x11042: 84, + 0x11043: 84, + 0x11044: 84, + 0x11045: 84, + 0x11046: 84, + 0x11070: 84, + 0x11073: 84, + 0x11074: 84, + 0x1107f: 84, + 0x11080: 84, + 0x11081: 84, + 0x110b3: 84, + 0x110b4: 84, + 0x110b5: 84, + 0x110b6: 84, + 0x110b9: 84, + 0x110ba: 84, + 0x110c2: 84, + 0x11100: 84, + 0x11101: 84, + 0x11102: 84, + 0x11127: 84, + 0x11128: 84, + 0x11129: 84, + 0x1112a: 84, + 0x1112b: 84, + 0x1112d: 84, + 0x1112e: 84, + 0x1112f: 84, + 0x11130: 84, + 0x11131: 84, + 0x11132: 84, + 0x11133: 84, + 0x11134: 84, + 0x11173: 84, + 0x11180: 84, + 0x11181: 84, + 0x111b6: 84, + 0x111b7: 84, + 0x111b8: 84, + 0x111b9: 84, + 0x111ba: 84, + 0x111bb: 84, + 0x111bc: 84, + 0x111bd: 84, + 0x111be: 84, + 0x111c9: 84, + 0x111ca: 84, + 0x111cb: 84, + 0x111cc: 84, + 0x111cf: 84, + 0x1122f: 84, + 0x11230: 84, + 0x11231: 84, + 0x11234: 84, + 0x11236: 84, + 0x11237: 84, + 0x1123e: 84, + 0x11241: 84, + 0x112df: 84, + 0x112e3: 84, + 0x112e4: 84, + 0x112e5: 84, + 0x112e6: 84, + 0x112e7: 84, + 0x112e8: 84, + 0x112e9: 84, + 0x112ea: 84, + 0x11300: 84, + 0x11301: 84, + 0x1133b: 84, + 0x1133c: 84, + 0x11340: 84, + 0x11366: 84, + 0x11367: 84, + 0x11368: 84, + 0x11369: 84, + 0x1136a: 84, + 0x1136b: 84, + 0x1136c: 84, + 0x11370: 84, + 0x11371: 84, + 0x11372: 84, + 0x11373: 84, + 0x11374: 84, + 0x11438: 84, + 0x11439: 84, + 0x1143a: 84, + 0x1143b: 84, + 0x1143c: 84, + 0x1143d: 84, + 0x1143e: 84, + 0x1143f: 84, + 0x11442: 84, + 0x11443: 84, + 0x11444: 84, + 0x11446: 84, + 0x1145e: 84, + 0x114b3: 84, + 0x114b4: 84, + 0x114b5: 84, + 0x114b6: 84, + 0x114b7: 84, + 0x114b8: 84, + 0x114ba: 84, + 0x114bf: 84, + 0x114c0: 84, + 0x114c2: 84, + 0x114c3: 84, + 0x115b2: 84, + 0x115b3: 84, + 0x115b4: 84, + 0x115b5: 84, + 0x115bc: 84, + 0x115bd: 84, + 0x115bf: 84, + 0x115c0: 84, + 0x115dc: 84, + 0x115dd: 84, + 0x11633: 84, + 0x11634: 84, + 0x11635: 84, + 0x11636: 84, + 0x11637: 84, + 0x11638: 84, + 0x11639: 84, + 0x1163a: 84, + 0x1163d: 84, + 0x1163f: 84, + 0x11640: 84, + 0x116ab: 84, + 0x116ad: 84, + 0x116b0: 84, + 0x116b1: 84, + 0x116b2: 84, + 0x116b3: 84, + 0x116b4: 84, + 0x116b5: 84, + 0x116b7: 84, + 0x1171d: 84, + 0x1171e: 84, + 0x1171f: 84, + 0x11722: 84, + 0x11723: 84, + 0x11724: 84, + 0x11725: 84, + 0x11727: 84, + 0x11728: 84, + 0x11729: 84, + 0x1172a: 84, + 0x1172b: 84, + 0x1182f: 84, + 0x11830: 84, + 0x11831: 84, + 0x11832: 84, + 0x11833: 84, + 0x11834: 84, + 0x11835: 84, + 0x11836: 84, + 0x11837: 84, + 0x11839: 84, + 0x1183a: 84, + 0x1193b: 84, + 0x1193c: 84, + 0x1193e: 84, + 0x11943: 84, + 0x119d4: 84, + 0x119d5: 84, + 0x119d6: 84, + 0x119d7: 84, + 0x119da: 84, + 0x119db: 84, + 0x119e0: 84, + 0x11a01: 84, + 0x11a02: 84, + 0x11a03: 84, + 0x11a04: 84, + 0x11a05: 84, + 0x11a06: 84, + 0x11a07: 84, + 0x11a08: 84, + 0x11a09: 84, + 0x11a0a: 84, + 0x11a33: 84, + 0x11a34: 84, + 0x11a35: 84, + 0x11a36: 84, + 0x11a37: 84, + 0x11a38: 84, + 0x11a3b: 84, + 0x11a3c: 84, + 0x11a3d: 84, + 0x11a3e: 84, + 0x11a47: 84, + 0x11a51: 84, + 0x11a52: 84, + 0x11a53: 84, + 0x11a54: 84, + 0x11a55: 84, + 0x11a56: 84, + 0x11a59: 84, + 0x11a5a: 84, + 0x11a5b: 84, + 0x11a8a: 84, + 0x11a8b: 84, + 0x11a8c: 84, + 0x11a8d: 84, + 0x11a8e: 84, + 0x11a8f: 84, + 0x11a90: 84, + 0x11a91: 84, + 0x11a92: 84, + 0x11a93: 84, + 0x11a94: 84, + 0x11a95: 84, + 0x11a96: 84, + 0x11a98: 84, + 0x11a99: 84, + 0x11c30: 84, + 0x11c31: 84, + 0x11c32: 84, + 0x11c33: 84, + 0x11c34: 84, + 0x11c35: 84, + 0x11c36: 84, + 0x11c38: 84, + 0x11c39: 84, + 0x11c3a: 84, + 0x11c3b: 84, + 0x11c3c: 84, + 0x11c3d: 84, + 0x11c3f: 84, + 0x11c92: 84, + 0x11c93: 84, + 0x11c94: 84, + 0x11c95: 84, + 0x11c96: 84, + 0x11c97: 84, + 0x11c98: 84, + 0x11c99: 84, + 0x11c9a: 84, + 0x11c9b: 84, + 0x11c9c: 84, + 0x11c9d: 84, + 0x11c9e: 84, + 0x11c9f: 84, + 0x11ca0: 84, + 0x11ca1: 84, + 0x11ca2: 84, + 0x11ca3: 84, + 0x11ca4: 84, + 0x11ca5: 84, + 0x11ca6: 84, + 0x11ca7: 84, + 0x11caa: 84, + 0x11cab: 84, + 0x11cac: 84, + 0x11cad: 84, + 0x11cae: 84, + 0x11caf: 84, + 0x11cb0: 84, + 0x11cb2: 84, + 0x11cb3: 84, + 0x11cb5: 84, + 0x11cb6: 84, + 0x11d31: 84, + 0x11d32: 84, + 0x11d33: 84, + 0x11d34: 84, + 0x11d35: 84, + 0x11d36: 84, + 0x11d3a: 84, + 0x11d3c: 84, + 0x11d3d: 84, + 0x11d3f: 84, + 0x11d40: 84, + 0x11d41: 84, + 0x11d42: 84, + 0x11d43: 84, + 0x11d44: 84, + 0x11d45: 84, + 0x11d47: 84, + 0x11d90: 84, + 0x11d91: 84, + 0x11d95: 84, + 0x11d97: 84, + 0x11ef3: 84, + 0x11ef4: 84, + 0x11f00: 84, + 0x11f01: 84, + 0x11f36: 84, + 0x11f37: 84, + 0x11f38: 84, + 0x11f39: 84, + 0x11f3a: 84, + 0x11f40: 84, + 0x11f42: 84, + 0x13430: 84, + 0x13431: 84, + 0x13432: 84, + 0x13433: 84, + 0x13434: 84, + 0x13435: 84, + 0x13436: 84, + 0x13437: 84, + 0x13438: 84, + 0x13439: 84, + 0x1343a: 84, + 0x1343b: 84, + 0x1343c: 84, + 0x1343d: 84, + 0x1343e: 84, + 0x1343f: 84, + 0x13440: 84, + 0x13447: 84, + 0x13448: 84, + 0x13449: 84, + 0x1344a: 84, + 0x1344b: 84, + 0x1344c: 84, + 0x1344d: 84, + 0x1344e: 84, + 0x1344f: 84, + 0x13450: 84, + 0x13451: 84, + 0x13452: 84, + 0x13453: 84, + 0x13454: 84, + 0x13455: 84, + 0x16af0: 84, + 0x16af1: 84, + 0x16af2: 84, + 0x16af3: 84, + 0x16af4: 84, + 0x16b30: 84, + 0x16b31: 84, + 0x16b32: 84, + 0x16b33: 84, + 0x16b34: 84, + 0x16b35: 84, + 0x16b36: 84, + 0x16f4f: 84, + 0x16f8f: 84, + 0x16f90: 84, + 0x16f91: 84, + 0x16f92: 84, + 0x16fe4: 84, + 0x1bc9d: 84, + 0x1bc9e: 84, + 0x1bca0: 84, + 0x1bca1: 84, + 0x1bca2: 84, + 0x1bca3: 84, + 0x1cf00: 84, + 0x1cf01: 84, + 0x1cf02: 84, + 0x1cf03: 84, + 0x1cf04: 84, + 0x1cf05: 84, + 0x1cf06: 84, + 0x1cf07: 84, + 0x1cf08: 84, + 0x1cf09: 84, + 0x1cf0a: 84, + 0x1cf0b: 84, + 0x1cf0c: 84, + 0x1cf0d: 84, + 0x1cf0e: 84, + 0x1cf0f: 84, + 0x1cf10: 84, + 0x1cf11: 84, + 0x1cf12: 84, + 0x1cf13: 84, + 0x1cf14: 84, + 0x1cf15: 84, + 0x1cf16: 84, + 0x1cf17: 84, + 0x1cf18: 84, + 0x1cf19: 84, + 0x1cf1a: 84, + 0x1cf1b: 84, + 0x1cf1c: 84, + 0x1cf1d: 84, + 0x1cf1e: 84, + 0x1cf1f: 84, + 0x1cf20: 84, + 0x1cf21: 84, + 0x1cf22: 84, + 0x1cf23: 84, + 0x1cf24: 84, + 0x1cf25: 84, + 0x1cf26: 84, + 0x1cf27: 84, + 0x1cf28: 84, + 0x1cf29: 84, + 0x1cf2a: 84, + 0x1cf2b: 84, + 0x1cf2c: 84, + 0x1cf2d: 84, + 0x1cf30: 84, + 0x1cf31: 84, + 0x1cf32: 84, + 0x1cf33: 84, + 0x1cf34: 84, + 0x1cf35: 84, + 0x1cf36: 84, + 0x1cf37: 84, + 0x1cf38: 84, + 0x1cf39: 84, + 0x1cf3a: 84, + 0x1cf3b: 84, + 0x1cf3c: 84, + 0x1cf3d: 84, + 0x1cf3e: 84, + 0x1cf3f: 84, + 0x1cf40: 84, + 0x1cf41: 84, + 0x1cf42: 84, + 0x1cf43: 84, + 0x1cf44: 84, + 0x1cf45: 84, + 0x1cf46: 84, + 0x1d167: 84, + 0x1d168: 84, + 0x1d169: 84, + 0x1d173: 84, + 0x1d174: 84, + 0x1d175: 84, + 0x1d176: 84, + 0x1d177: 84, + 0x1d178: 84, + 0x1d179: 84, + 0x1d17a: 84, + 0x1d17b: 84, + 0x1d17c: 84, + 0x1d17d: 84, + 0x1d17e: 84, + 0x1d17f: 84, + 0x1d180: 84, + 0x1d181: 84, + 0x1d182: 84, + 0x1d185: 84, + 0x1d186: 84, + 0x1d187: 84, + 0x1d188: 84, + 0x1d189: 84, + 0x1d18a: 84, + 0x1d18b: 84, + 0x1d1aa: 84, + 0x1d1ab: 84, + 0x1d1ac: 84, + 0x1d1ad: 84, + 0x1d242: 84, + 0x1d243: 84, + 0x1d244: 84, + 0x1da00: 84, + 0x1da01: 84, + 0x1da02: 84, + 0x1da03: 84, + 0x1da04: 84, + 0x1da05: 84, + 0x1da06: 84, + 0x1da07: 84, + 0x1da08: 84, + 0x1da09: 84, + 0x1da0a: 84, + 0x1da0b: 84, + 0x1da0c: 84, + 0x1da0d: 84, + 0x1da0e: 84, + 0x1da0f: 84, + 0x1da10: 84, + 0x1da11: 84, + 0x1da12: 84, + 0x1da13: 84, + 0x1da14: 84, + 0x1da15: 84, + 0x1da16: 84, + 0x1da17: 84, + 0x1da18: 84, + 0x1da19: 84, + 0x1da1a: 84, + 0x1da1b: 84, + 0x1da1c: 84, + 0x1da1d: 84, + 0x1da1e: 84, + 0x1da1f: 84, + 0x1da20: 84, + 0x1da21: 84, + 0x1da22: 84, + 0x1da23: 84, + 0x1da24: 84, + 0x1da25: 84, + 0x1da26: 84, + 0x1da27: 84, + 0x1da28: 84, + 0x1da29: 84, + 0x1da2a: 84, + 0x1da2b: 84, + 0x1da2c: 84, + 0x1da2d: 84, + 0x1da2e: 84, + 0x1da2f: 84, + 0x1da30: 84, + 0x1da31: 84, + 0x1da32: 84, + 0x1da33: 84, + 0x1da34: 84, + 0x1da35: 84, + 0x1da36: 84, + 0x1da3b: 84, + 0x1da3c: 84, + 0x1da3d: 84, + 0x1da3e: 84, + 0x1da3f: 84, + 0x1da40: 84, + 0x1da41: 84, + 0x1da42: 84, + 0x1da43: 84, + 0x1da44: 84, + 0x1da45: 84, + 0x1da46: 84, + 0x1da47: 84, + 0x1da48: 84, + 0x1da49: 84, + 0x1da4a: 84, + 0x1da4b: 84, + 0x1da4c: 84, + 0x1da4d: 84, + 0x1da4e: 84, + 0x1da4f: 84, + 0x1da50: 84, + 0x1da51: 84, + 0x1da52: 84, + 0x1da53: 84, + 0x1da54: 84, + 0x1da55: 84, + 0x1da56: 84, + 0x1da57: 84, + 0x1da58: 84, + 0x1da59: 84, + 0x1da5a: 84, + 0x1da5b: 84, + 0x1da5c: 84, + 0x1da5d: 84, + 0x1da5e: 84, + 0x1da5f: 84, + 0x1da60: 84, + 0x1da61: 84, + 0x1da62: 84, + 0x1da63: 84, + 0x1da64: 84, + 0x1da65: 84, + 0x1da66: 84, + 0x1da67: 84, + 0x1da68: 84, + 0x1da69: 84, + 0x1da6a: 84, + 0x1da6b: 84, + 0x1da6c: 84, + 0x1da75: 84, + 0x1da84: 84, + 0x1da9b: 84, + 0x1da9c: 84, + 0x1da9d: 84, + 0x1da9e: 84, + 0x1da9f: 84, + 0x1daa1: 84, + 0x1daa2: 84, + 0x1daa3: 84, + 0x1daa4: 84, + 0x1daa5: 84, + 0x1daa6: 84, + 0x1daa7: 84, + 0x1daa8: 84, + 0x1daa9: 84, + 0x1daaa: 84, + 0x1daab: 84, + 0x1daac: 84, + 0x1daad: 84, + 0x1daae: 84, + 0x1daaf: 84, + 0x1e000: 84, + 0x1e001: 84, + 0x1e002: 84, + 0x1e003: 84, + 0x1e004: 84, + 0x1e005: 84, + 0x1e006: 84, + 0x1e008: 84, + 0x1e009: 84, + 0x1e00a: 84, + 0x1e00b: 84, + 0x1e00c: 84, + 0x1e00d: 84, + 0x1e00e: 84, + 0x1e00f: 84, + 0x1e010: 84, + 0x1e011: 84, + 0x1e012: 84, + 0x1e013: 84, + 0x1e014: 84, + 0x1e015: 84, + 0x1e016: 84, + 0x1e017: 84, + 0x1e018: 84, + 0x1e01b: 84, + 0x1e01c: 84, + 0x1e01d: 84, + 0x1e01e: 84, + 0x1e01f: 84, + 0x1e020: 84, + 0x1e021: 84, + 0x1e023: 84, + 0x1e024: 84, + 0x1e026: 84, + 0x1e027: 84, + 0x1e028: 84, + 0x1e029: 84, + 0x1e02a: 84, + 0x1e08f: 84, + 0x1e130: 84, + 0x1e131: 84, + 0x1e132: 84, + 0x1e133: 84, + 0x1e134: 84, + 0x1e135: 84, + 0x1e136: 84, + 0x1e2ae: 84, + 0x1e2ec: 84, + 0x1e2ed: 84, + 0x1e2ee: 84, + 0x1e2ef: 84, + 0x1e4ec: 84, + 0x1e4ed: 84, + 0x1e4ee: 84, + 0x1e4ef: 84, + 0x1e8d0: 84, + 0x1e8d1: 84, + 0x1e8d2: 84, + 0x1e8d3: 84, + 0x1e8d4: 84, + 0x1e8d5: 84, + 0x1e8d6: 84, + 0x1e900: 68, + 0x1e901: 68, + 0x1e902: 68, + 0x1e903: 68, + 0x1e904: 68, + 0x1e905: 68, + 0x1e906: 68, + 0x1e907: 68, + 0x1e908: 68, + 0x1e909: 68, + 0x1e90a: 68, + 0x1e90b: 68, + 0x1e90c: 68, + 0x1e90d: 68, + 0x1e90e: 68, + 0x1e90f: 68, + 0x1e910: 68, + 0x1e911: 68, + 0x1e912: 68, + 0x1e913: 68, + 0x1e914: 68, + 0x1e915: 68, + 0x1e916: 68, + 0x1e917: 68, + 0x1e918: 68, + 0x1e919: 68, + 0x1e91a: 68, + 0x1e91b: 68, + 0x1e91c: 68, + 0x1e91d: 68, + 0x1e91e: 68, + 0x1e91f: 68, + 0x1e920: 68, + 0x1e921: 68, + 0x1e922: 68, + 0x1e923: 68, + 0x1e924: 68, + 0x1e925: 68, + 0x1e926: 68, + 0x1e927: 68, + 0x1e928: 68, + 0x1e929: 68, + 0x1e92a: 68, + 0x1e92b: 68, + 0x1e92c: 68, + 0x1e92d: 68, + 0x1e92e: 68, + 0x1e92f: 68, + 0x1e930: 68, + 0x1e931: 68, + 0x1e932: 68, + 0x1e933: 68, + 0x1e934: 68, + 0x1e935: 68, + 0x1e936: 68, + 0x1e937: 68, + 0x1e938: 68, + 0x1e939: 68, + 0x1e93a: 68, + 0x1e93b: 68, + 0x1e93c: 68, + 0x1e93d: 68, + 0x1e93e: 68, + 0x1e93f: 68, + 0x1e940: 68, + 0x1e941: 68, + 0x1e942: 68, + 0x1e943: 68, + 0x1e944: 84, + 0x1e945: 84, + 0x1e946: 84, + 0x1e947: 84, + 0x1e948: 84, + 0x1e949: 84, + 0x1e94a: 84, + 0x1e94b: 84, + 0xe0001: 84, + 0xe0020: 84, + 0xe0021: 84, + 0xe0022: 84, + 0xe0023: 84, + 0xe0024: 84, + 0xe0025: 84, + 0xe0026: 84, + 0xe0027: 84, + 0xe0028: 84, + 0xe0029: 84, + 0xe002a: 84, + 0xe002b: 84, + 0xe002c: 84, + 0xe002d: 84, + 0xe002e: 84, + 0xe002f: 84, + 0xe0030: 84, + 0xe0031: 84, + 0xe0032: 84, + 0xe0033: 84, + 0xe0034: 84, + 0xe0035: 84, + 0xe0036: 84, + 0xe0037: 84, + 0xe0038: 84, + 0xe0039: 84, + 0xe003a: 84, + 0xe003b: 84, + 0xe003c: 84, + 0xe003d: 84, + 0xe003e: 84, + 0xe003f: 84, + 0xe0040: 84, + 0xe0041: 84, + 0xe0042: 84, + 0xe0043: 84, + 0xe0044: 84, + 0xe0045: 84, + 0xe0046: 84, + 0xe0047: 84, + 0xe0048: 84, + 0xe0049: 84, + 0xe004a: 84, + 0xe004b: 84, + 0xe004c: 84, + 0xe004d: 84, + 0xe004e: 84, + 0xe004f: 84, + 0xe0050: 84, + 0xe0051: 84, + 0xe0052: 84, + 0xe0053: 84, + 0xe0054: 84, + 0xe0055: 84, + 0xe0056: 84, + 0xe0057: 84, + 0xe0058: 84, + 0xe0059: 84, + 0xe005a: 84, + 0xe005b: 84, + 0xe005c: 84, + 0xe005d: 84, + 0xe005e: 84, + 0xe005f: 84, + 0xe0060: 84, + 0xe0061: 84, + 0xe0062: 84, + 0xe0063: 84, + 0xe0064: 84, + 0xe0065: 84, + 0xe0066: 84, + 0xe0067: 84, + 0xe0068: 84, + 0xe0069: 84, + 0xe006a: 84, + 0xe006b: 84, + 0xe006c: 84, + 0xe006d: 84, + 0xe006e: 84, + 0xe006f: 84, + 0xe0070: 84, + 0xe0071: 84, + 0xe0072: 84, + 0xe0073: 84, + 0xe0074: 84, + 0xe0075: 84, + 0xe0076: 84, + 0xe0077: 84, + 0xe0078: 84, + 0xe0079: 84, + 0xe007a: 84, + 0xe007b: 84, + 0xe007c: 84, + 0xe007d: 84, + 0xe007e: 84, + 0xe007f: 84, + 0xe0100: 84, + 0xe0101: 84, + 0xe0102: 84, + 0xe0103: 84, + 0xe0104: 84, + 0xe0105: 84, + 0xe0106: 84, + 0xe0107: 84, + 0xe0108: 84, + 0xe0109: 84, + 0xe010a: 84, + 0xe010b: 84, + 0xe010c: 84, + 0xe010d: 84, + 0xe010e: 84, + 0xe010f: 84, + 0xe0110: 84, + 0xe0111: 84, + 0xe0112: 84, + 0xe0113: 84, + 0xe0114: 84, + 0xe0115: 84, + 0xe0116: 84, + 0xe0117: 84, + 0xe0118: 84, + 0xe0119: 84, + 0xe011a: 84, + 0xe011b: 84, + 0xe011c: 84, + 0xe011d: 84, + 0xe011e: 84, + 0xe011f: 84, + 0xe0120: 84, + 0xe0121: 84, + 0xe0122: 84, + 0xe0123: 84, + 0xe0124: 84, + 0xe0125: 84, + 0xe0126: 84, + 0xe0127: 84, + 0xe0128: 84, + 0xe0129: 84, + 0xe012a: 84, + 0xe012b: 84, + 0xe012c: 84, + 0xe012d: 84, + 0xe012e: 84, + 0xe012f: 84, + 0xe0130: 84, + 0xe0131: 84, + 0xe0132: 84, + 0xe0133: 84, + 0xe0134: 84, + 0xe0135: 84, + 0xe0136: 84, + 0xe0137: 84, + 0xe0138: 84, + 0xe0139: 84, + 0xe013a: 84, + 0xe013b: 84, + 0xe013c: 84, + 0xe013d: 84, + 0xe013e: 84, + 0xe013f: 84, + 0xe0140: 84, + 0xe0141: 84, + 0xe0142: 84, + 0xe0143: 84, + 0xe0144: 84, + 0xe0145: 84, + 0xe0146: 84, + 0xe0147: 84, + 0xe0148: 84, + 0xe0149: 84, + 0xe014a: 84, + 0xe014b: 84, + 0xe014c: 84, + 0xe014d: 84, + 0xe014e: 84, + 0xe014f: 84, + 0xe0150: 84, + 0xe0151: 84, + 0xe0152: 84, + 0xe0153: 84, + 0xe0154: 84, + 0xe0155: 84, + 0xe0156: 84, + 0xe0157: 84, + 0xe0158: 84, + 0xe0159: 84, + 0xe015a: 84, + 0xe015b: 84, + 0xe015c: 84, + 0xe015d: 84, + 0xe015e: 84, + 0xe015f: 84, + 0xe0160: 84, + 0xe0161: 84, + 0xe0162: 84, + 0xe0163: 84, + 0xe0164: 84, + 0xe0165: 84, + 0xe0166: 84, + 0xe0167: 84, + 0xe0168: 84, + 0xe0169: 84, + 0xe016a: 84, + 0xe016b: 84, + 0xe016c: 84, + 0xe016d: 84, + 0xe016e: 84, + 0xe016f: 84, + 0xe0170: 84, + 0xe0171: 84, + 0xe0172: 84, + 0xe0173: 84, + 0xe0174: 84, + 0xe0175: 84, + 0xe0176: 84, + 0xe0177: 84, + 0xe0178: 84, + 0xe0179: 84, + 0xe017a: 84, + 0xe017b: 84, + 0xe017c: 84, + 0xe017d: 84, + 0xe017e: 84, + 0xe017f: 84, + 0xe0180: 84, + 0xe0181: 84, + 0xe0182: 84, + 0xe0183: 84, + 0xe0184: 84, + 0xe0185: 84, + 0xe0186: 84, + 0xe0187: 84, + 0xe0188: 84, + 0xe0189: 84, + 0xe018a: 84, + 0xe018b: 84, + 0xe018c: 84, + 0xe018d: 84, + 0xe018e: 84, + 0xe018f: 84, + 0xe0190: 84, + 0xe0191: 84, + 0xe0192: 84, + 0xe0193: 84, + 0xe0194: 84, + 0xe0195: 84, + 0xe0196: 84, + 0xe0197: 84, + 0xe0198: 84, + 0xe0199: 84, + 0xe019a: 84, + 0xe019b: 84, + 0xe019c: 84, + 0xe019d: 84, + 0xe019e: 84, + 0xe019f: 84, + 0xe01a0: 84, + 0xe01a1: 84, + 0xe01a2: 84, + 0xe01a3: 84, + 0xe01a4: 84, + 0xe01a5: 84, + 0xe01a6: 84, + 0xe01a7: 84, + 0xe01a8: 84, + 0xe01a9: 84, + 0xe01aa: 84, + 0xe01ab: 84, + 0xe01ac: 84, + 0xe01ad: 84, + 0xe01ae: 84, + 0xe01af: 84, + 0xe01b0: 84, + 0xe01b1: 84, + 0xe01b2: 84, + 0xe01b3: 84, + 0xe01b4: 84, + 0xe01b5: 84, + 0xe01b6: 84, + 0xe01b7: 84, + 0xe01b8: 84, + 0xe01b9: 84, + 0xe01ba: 84, + 0xe01bb: 84, + 0xe01bc: 84, + 0xe01bd: 84, + 0xe01be: 84, + 0xe01bf: 84, + 0xe01c0: 84, + 0xe01c1: 84, + 0xe01c2: 84, + 0xe01c3: 84, + 0xe01c4: 84, + 0xe01c5: 84, + 0xe01c6: 84, + 0xe01c7: 84, + 0xe01c8: 84, + 0xe01c9: 84, + 0xe01ca: 84, + 0xe01cb: 84, + 0xe01cc: 84, + 0xe01cd: 84, + 0xe01ce: 84, + 0xe01cf: 84, + 0xe01d0: 84, + 0xe01d1: 84, + 0xe01d2: 84, + 0xe01d3: 84, + 0xe01d4: 84, + 0xe01d5: 84, + 0xe01d6: 84, + 0xe01d7: 84, + 0xe01d8: 84, + 0xe01d9: 84, + 0xe01da: 84, + 0xe01db: 84, + 0xe01dc: 84, + 0xe01dd: 84, + 0xe01de: 84, + 0xe01df: 84, + 0xe01e0: 84, + 0xe01e1: 84, + 0xe01e2: 84, + 0xe01e3: 84, + 0xe01e4: 84, + 0xe01e5: 84, + 0xe01e6: 84, + 0xe01e7: 84, + 0xe01e8: 84, + 0xe01e9: 84, + 0xe01ea: 84, + 0xe01eb: 84, + 0xe01ec: 84, + 0xe01ed: 84, + 0xe01ee: 84, + 0xe01ef: 84, +} +codepoint_classes = { + 'PVALID': ( + 0x2d0000002e, + 0x300000003a, + 0x610000007b, + 0xdf000000f7, + 0xf800000100, + 0x10100000102, + 0x10300000104, + 0x10500000106, + 0x10700000108, + 0x1090000010a, + 0x10b0000010c, + 0x10d0000010e, + 0x10f00000110, + 0x11100000112, + 0x11300000114, + 0x11500000116, + 0x11700000118, + 0x1190000011a, + 0x11b0000011c, + 0x11d0000011e, + 0x11f00000120, + 0x12100000122, + 0x12300000124, + 0x12500000126, + 0x12700000128, + 0x1290000012a, + 0x12b0000012c, + 0x12d0000012e, + 0x12f00000130, + 0x13100000132, + 0x13500000136, + 0x13700000139, + 0x13a0000013b, + 0x13c0000013d, + 0x13e0000013f, + 0x14200000143, + 0x14400000145, + 0x14600000147, + 0x14800000149, + 0x14b0000014c, + 0x14d0000014e, + 0x14f00000150, + 0x15100000152, + 0x15300000154, + 0x15500000156, + 0x15700000158, + 0x1590000015a, + 0x15b0000015c, + 0x15d0000015e, + 0x15f00000160, + 0x16100000162, + 0x16300000164, + 0x16500000166, + 0x16700000168, + 0x1690000016a, + 0x16b0000016c, + 0x16d0000016e, + 0x16f00000170, + 0x17100000172, + 0x17300000174, + 0x17500000176, + 0x17700000178, + 0x17a0000017b, + 0x17c0000017d, + 0x17e0000017f, + 0x18000000181, + 0x18300000184, + 0x18500000186, + 0x18800000189, + 0x18c0000018e, + 0x19200000193, + 0x19500000196, + 0x1990000019c, + 0x19e0000019f, + 0x1a1000001a2, + 0x1a3000001a4, + 0x1a5000001a6, + 0x1a8000001a9, + 0x1aa000001ac, + 0x1ad000001ae, + 0x1b0000001b1, + 0x1b4000001b5, + 0x1b6000001b7, + 0x1b9000001bc, + 0x1bd000001c4, + 0x1ce000001cf, + 0x1d0000001d1, + 0x1d2000001d3, + 0x1d4000001d5, + 0x1d6000001d7, + 0x1d8000001d9, + 0x1da000001db, + 0x1dc000001de, + 0x1df000001e0, + 0x1e1000001e2, + 0x1e3000001e4, + 0x1e5000001e6, + 0x1e7000001e8, + 0x1e9000001ea, + 0x1eb000001ec, + 0x1ed000001ee, + 0x1ef000001f1, + 0x1f5000001f6, + 0x1f9000001fa, + 0x1fb000001fc, + 0x1fd000001fe, + 0x1ff00000200, + 0x20100000202, + 0x20300000204, + 0x20500000206, + 0x20700000208, + 0x2090000020a, + 0x20b0000020c, + 0x20d0000020e, + 0x20f00000210, + 0x21100000212, + 0x21300000214, + 0x21500000216, + 0x21700000218, + 0x2190000021a, + 0x21b0000021c, + 0x21d0000021e, + 0x21f00000220, + 0x22100000222, + 0x22300000224, + 0x22500000226, + 0x22700000228, + 0x2290000022a, + 0x22b0000022c, + 0x22d0000022e, + 0x22f00000230, + 0x23100000232, + 0x2330000023a, + 0x23c0000023d, + 0x23f00000241, + 0x24200000243, + 0x24700000248, + 0x2490000024a, + 0x24b0000024c, + 0x24d0000024e, + 0x24f000002b0, + 0x2b9000002c2, + 0x2c6000002d2, + 0x2ec000002ed, + 0x2ee000002ef, + 0x30000000340, + 0x34200000343, + 0x3460000034f, + 0x35000000370, + 0x37100000372, + 0x37300000374, + 0x37700000378, + 0x37b0000037e, + 0x39000000391, + 0x3ac000003cf, + 0x3d7000003d8, + 0x3d9000003da, + 0x3db000003dc, + 0x3dd000003de, + 0x3df000003e0, + 0x3e1000003e2, + 0x3e3000003e4, + 0x3e5000003e6, + 0x3e7000003e8, + 0x3e9000003ea, + 0x3eb000003ec, + 0x3ed000003ee, + 0x3ef000003f0, + 0x3f3000003f4, + 0x3f8000003f9, + 0x3fb000003fd, + 0x43000000460, + 0x46100000462, + 0x46300000464, + 0x46500000466, + 0x46700000468, + 0x4690000046a, + 0x46b0000046c, + 0x46d0000046e, + 0x46f00000470, + 0x47100000472, + 0x47300000474, + 0x47500000476, + 0x47700000478, + 0x4790000047a, + 0x47b0000047c, + 0x47d0000047e, + 0x47f00000480, + 0x48100000482, + 0x48300000488, + 0x48b0000048c, + 0x48d0000048e, + 0x48f00000490, + 0x49100000492, + 0x49300000494, + 0x49500000496, + 0x49700000498, + 0x4990000049a, + 0x49b0000049c, + 0x49d0000049e, + 0x49f000004a0, + 0x4a1000004a2, + 0x4a3000004a4, + 0x4a5000004a6, + 0x4a7000004a8, + 0x4a9000004aa, + 0x4ab000004ac, + 0x4ad000004ae, + 0x4af000004b0, + 0x4b1000004b2, + 0x4b3000004b4, + 0x4b5000004b6, + 0x4b7000004b8, + 0x4b9000004ba, + 0x4bb000004bc, + 0x4bd000004be, + 0x4bf000004c0, + 0x4c2000004c3, + 0x4c4000004c5, + 0x4c6000004c7, + 0x4c8000004c9, + 0x4ca000004cb, + 0x4cc000004cd, + 0x4ce000004d0, + 0x4d1000004d2, + 0x4d3000004d4, + 0x4d5000004d6, + 0x4d7000004d8, + 0x4d9000004da, + 0x4db000004dc, + 0x4dd000004de, + 0x4df000004e0, + 0x4e1000004e2, + 0x4e3000004e4, + 0x4e5000004e6, + 0x4e7000004e8, + 0x4e9000004ea, + 0x4eb000004ec, + 0x4ed000004ee, + 0x4ef000004f0, + 0x4f1000004f2, + 0x4f3000004f4, + 0x4f5000004f6, + 0x4f7000004f8, + 0x4f9000004fa, + 0x4fb000004fc, + 0x4fd000004fe, + 0x4ff00000500, + 0x50100000502, + 0x50300000504, + 0x50500000506, + 0x50700000508, + 0x5090000050a, + 0x50b0000050c, + 0x50d0000050e, + 0x50f00000510, + 0x51100000512, + 0x51300000514, + 0x51500000516, + 0x51700000518, + 0x5190000051a, + 0x51b0000051c, + 0x51d0000051e, + 0x51f00000520, + 0x52100000522, + 0x52300000524, + 0x52500000526, + 0x52700000528, + 0x5290000052a, + 0x52b0000052c, + 0x52d0000052e, + 0x52f00000530, + 0x5590000055a, + 0x56000000587, + 0x58800000589, + 0x591000005be, + 0x5bf000005c0, + 0x5c1000005c3, + 0x5c4000005c6, + 0x5c7000005c8, + 0x5d0000005eb, + 0x5ef000005f3, + 0x6100000061b, + 0x62000000640, + 0x64100000660, + 0x66e00000675, + 0x679000006d4, + 0x6d5000006dd, + 0x6df000006e9, + 0x6ea000006f0, + 0x6fa00000700, + 0x7100000074b, + 0x74d000007b2, + 0x7c0000007f6, + 0x7fd000007fe, + 0x8000000082e, + 0x8400000085c, + 0x8600000086b, + 0x87000000888, + 0x8890000088f, + 0x898000008e2, + 0x8e300000958, + 0x96000000964, + 0x96600000970, + 0x97100000984, + 0x9850000098d, + 0x98f00000991, + 0x993000009a9, + 0x9aa000009b1, + 0x9b2000009b3, + 0x9b6000009ba, + 0x9bc000009c5, + 0x9c7000009c9, + 0x9cb000009cf, + 0x9d7000009d8, + 0x9e0000009e4, + 0x9e6000009f2, + 0x9fc000009fd, + 0x9fe000009ff, + 0xa0100000a04, + 0xa0500000a0b, + 0xa0f00000a11, + 0xa1300000a29, + 0xa2a00000a31, + 0xa3200000a33, + 0xa3500000a36, + 0xa3800000a3a, + 0xa3c00000a3d, + 0xa3e00000a43, + 0xa4700000a49, + 0xa4b00000a4e, + 0xa5100000a52, + 0xa5c00000a5d, + 0xa6600000a76, + 0xa8100000a84, + 0xa8500000a8e, + 0xa8f00000a92, + 0xa9300000aa9, + 0xaaa00000ab1, + 0xab200000ab4, + 0xab500000aba, + 0xabc00000ac6, + 0xac700000aca, + 0xacb00000ace, + 0xad000000ad1, + 0xae000000ae4, + 0xae600000af0, + 0xaf900000b00, + 0xb0100000b04, + 0xb0500000b0d, + 0xb0f00000b11, + 0xb1300000b29, + 0xb2a00000b31, + 0xb3200000b34, + 0xb3500000b3a, + 0xb3c00000b45, + 0xb4700000b49, + 0xb4b00000b4e, + 0xb5500000b58, + 0xb5f00000b64, + 0xb6600000b70, + 0xb7100000b72, + 0xb8200000b84, + 0xb8500000b8b, + 0xb8e00000b91, + 0xb9200000b96, + 0xb9900000b9b, + 0xb9c00000b9d, + 0xb9e00000ba0, + 0xba300000ba5, + 0xba800000bab, + 0xbae00000bba, + 0xbbe00000bc3, + 0xbc600000bc9, + 0xbca00000bce, + 0xbd000000bd1, + 0xbd700000bd8, + 0xbe600000bf0, + 0xc0000000c0d, + 0xc0e00000c11, + 0xc1200000c29, + 0xc2a00000c3a, + 0xc3c00000c45, + 0xc4600000c49, + 0xc4a00000c4e, + 0xc5500000c57, + 0xc5800000c5b, + 0xc5d00000c5e, + 0xc6000000c64, + 0xc6600000c70, + 0xc8000000c84, + 0xc8500000c8d, + 0xc8e00000c91, + 0xc9200000ca9, + 0xcaa00000cb4, + 0xcb500000cba, + 0xcbc00000cc5, + 0xcc600000cc9, + 0xcca00000cce, + 0xcd500000cd7, + 0xcdd00000cdf, + 0xce000000ce4, + 0xce600000cf0, + 0xcf100000cf4, + 0xd0000000d0d, + 0xd0e00000d11, + 0xd1200000d45, + 0xd4600000d49, + 0xd4a00000d4f, + 0xd5400000d58, + 0xd5f00000d64, + 0xd6600000d70, + 0xd7a00000d80, + 0xd8100000d84, + 0xd8500000d97, + 0xd9a00000db2, + 0xdb300000dbc, + 0xdbd00000dbe, + 0xdc000000dc7, + 0xdca00000dcb, + 0xdcf00000dd5, + 0xdd600000dd7, + 0xdd800000de0, + 0xde600000df0, + 0xdf200000df4, + 0xe0100000e33, + 0xe3400000e3b, + 0xe4000000e4f, + 0xe5000000e5a, + 0xe8100000e83, + 0xe8400000e85, + 0xe8600000e8b, + 0xe8c00000ea4, + 0xea500000ea6, + 0xea700000eb3, + 0xeb400000ebe, + 0xec000000ec5, + 0xec600000ec7, + 0xec800000ecf, + 0xed000000eda, + 0xede00000ee0, + 0xf0000000f01, + 0xf0b00000f0c, + 0xf1800000f1a, + 0xf2000000f2a, + 0xf3500000f36, + 0xf3700000f38, + 0xf3900000f3a, + 0xf3e00000f43, + 0xf4400000f48, + 0xf4900000f4d, + 0xf4e00000f52, + 0xf5300000f57, + 0xf5800000f5c, + 0xf5d00000f69, + 0xf6a00000f6d, + 0xf7100000f73, + 0xf7400000f75, + 0xf7a00000f81, + 0xf8200000f85, + 0xf8600000f93, + 0xf9400000f98, + 0xf9900000f9d, + 0xf9e00000fa2, + 0xfa300000fa7, + 0xfa800000fac, + 0xfad00000fb9, + 0xfba00000fbd, + 0xfc600000fc7, + 0x10000000104a, + 0x10500000109e, + 0x10d0000010fb, + 0x10fd00001100, + 0x120000001249, + 0x124a0000124e, + 0x125000001257, + 0x125800001259, + 0x125a0000125e, + 0x126000001289, + 0x128a0000128e, + 0x1290000012b1, + 0x12b2000012b6, + 0x12b8000012bf, + 0x12c0000012c1, + 0x12c2000012c6, + 0x12c8000012d7, + 0x12d800001311, + 0x131200001316, + 0x13180000135b, + 0x135d00001360, + 0x138000001390, + 0x13a0000013f6, + 0x14010000166d, + 0x166f00001680, + 0x16810000169b, + 0x16a0000016eb, + 0x16f1000016f9, + 0x170000001716, + 0x171f00001735, + 0x174000001754, + 0x17600000176d, + 0x176e00001771, + 0x177200001774, + 0x1780000017b4, + 0x17b6000017d4, + 0x17d7000017d8, + 0x17dc000017de, + 0x17e0000017ea, + 0x18100000181a, + 0x182000001879, + 0x1880000018ab, + 0x18b0000018f6, + 0x19000000191f, + 0x19200000192c, + 0x19300000193c, + 0x19460000196e, + 0x197000001975, + 0x1980000019ac, + 0x19b0000019ca, + 0x19d0000019da, + 0x1a0000001a1c, + 0x1a2000001a5f, + 0x1a6000001a7d, + 0x1a7f00001a8a, + 0x1a9000001a9a, + 0x1aa700001aa8, + 0x1ab000001abe, + 0x1abf00001acf, + 0x1b0000001b4d, + 0x1b5000001b5a, + 0x1b6b00001b74, + 0x1b8000001bf4, + 0x1c0000001c38, + 0x1c4000001c4a, + 0x1c4d00001c7e, + 0x1cd000001cd3, + 0x1cd400001cfb, + 0x1d0000001d2c, + 0x1d2f00001d30, + 0x1d3b00001d3c, + 0x1d4e00001d4f, + 0x1d6b00001d78, + 0x1d7900001d9b, + 0x1dc000001e00, + 0x1e0100001e02, + 0x1e0300001e04, + 0x1e0500001e06, + 0x1e0700001e08, + 0x1e0900001e0a, + 0x1e0b00001e0c, + 0x1e0d00001e0e, + 0x1e0f00001e10, + 0x1e1100001e12, + 0x1e1300001e14, + 0x1e1500001e16, + 0x1e1700001e18, + 0x1e1900001e1a, + 0x1e1b00001e1c, + 0x1e1d00001e1e, + 0x1e1f00001e20, + 0x1e2100001e22, + 0x1e2300001e24, + 0x1e2500001e26, + 0x1e2700001e28, + 0x1e2900001e2a, + 0x1e2b00001e2c, + 0x1e2d00001e2e, + 0x1e2f00001e30, + 0x1e3100001e32, + 0x1e3300001e34, + 0x1e3500001e36, + 0x1e3700001e38, + 0x1e3900001e3a, + 0x1e3b00001e3c, + 0x1e3d00001e3e, + 0x1e3f00001e40, + 0x1e4100001e42, + 0x1e4300001e44, + 0x1e4500001e46, + 0x1e4700001e48, + 0x1e4900001e4a, + 0x1e4b00001e4c, + 0x1e4d00001e4e, + 0x1e4f00001e50, + 0x1e5100001e52, + 0x1e5300001e54, + 0x1e5500001e56, + 0x1e5700001e58, + 0x1e5900001e5a, + 0x1e5b00001e5c, + 0x1e5d00001e5e, + 0x1e5f00001e60, + 0x1e6100001e62, + 0x1e6300001e64, + 0x1e6500001e66, + 0x1e6700001e68, + 0x1e6900001e6a, + 0x1e6b00001e6c, + 0x1e6d00001e6e, + 0x1e6f00001e70, + 0x1e7100001e72, + 0x1e7300001e74, + 0x1e7500001e76, + 0x1e7700001e78, + 0x1e7900001e7a, + 0x1e7b00001e7c, + 0x1e7d00001e7e, + 0x1e7f00001e80, + 0x1e8100001e82, + 0x1e8300001e84, + 0x1e8500001e86, + 0x1e8700001e88, + 0x1e8900001e8a, + 0x1e8b00001e8c, + 0x1e8d00001e8e, + 0x1e8f00001e90, + 0x1e9100001e92, + 0x1e9300001e94, + 0x1e9500001e9a, + 0x1e9c00001e9e, + 0x1e9f00001ea0, + 0x1ea100001ea2, + 0x1ea300001ea4, + 0x1ea500001ea6, + 0x1ea700001ea8, + 0x1ea900001eaa, + 0x1eab00001eac, + 0x1ead00001eae, + 0x1eaf00001eb0, + 0x1eb100001eb2, + 0x1eb300001eb4, + 0x1eb500001eb6, + 0x1eb700001eb8, + 0x1eb900001eba, + 0x1ebb00001ebc, + 0x1ebd00001ebe, + 0x1ebf00001ec0, + 0x1ec100001ec2, + 0x1ec300001ec4, + 0x1ec500001ec6, + 0x1ec700001ec8, + 0x1ec900001eca, + 0x1ecb00001ecc, + 0x1ecd00001ece, + 0x1ecf00001ed0, + 0x1ed100001ed2, + 0x1ed300001ed4, + 0x1ed500001ed6, + 0x1ed700001ed8, + 0x1ed900001eda, + 0x1edb00001edc, + 0x1edd00001ede, + 0x1edf00001ee0, + 0x1ee100001ee2, + 0x1ee300001ee4, + 0x1ee500001ee6, + 0x1ee700001ee8, + 0x1ee900001eea, + 0x1eeb00001eec, + 0x1eed00001eee, + 0x1eef00001ef0, + 0x1ef100001ef2, + 0x1ef300001ef4, + 0x1ef500001ef6, + 0x1ef700001ef8, + 0x1ef900001efa, + 0x1efb00001efc, + 0x1efd00001efe, + 0x1eff00001f08, + 0x1f1000001f16, + 0x1f2000001f28, + 0x1f3000001f38, + 0x1f4000001f46, + 0x1f5000001f58, + 0x1f6000001f68, + 0x1f7000001f71, + 0x1f7200001f73, + 0x1f7400001f75, + 0x1f7600001f77, + 0x1f7800001f79, + 0x1f7a00001f7b, + 0x1f7c00001f7d, + 0x1fb000001fb2, + 0x1fb600001fb7, + 0x1fc600001fc7, + 0x1fd000001fd3, + 0x1fd600001fd8, + 0x1fe000001fe3, + 0x1fe400001fe8, + 0x1ff600001ff7, + 0x214e0000214f, + 0x218400002185, + 0x2c3000002c60, + 0x2c6100002c62, + 0x2c6500002c67, + 0x2c6800002c69, + 0x2c6a00002c6b, + 0x2c6c00002c6d, + 0x2c7100002c72, + 0x2c7300002c75, + 0x2c7600002c7c, + 0x2c8100002c82, + 0x2c8300002c84, + 0x2c8500002c86, + 0x2c8700002c88, + 0x2c8900002c8a, + 0x2c8b00002c8c, + 0x2c8d00002c8e, + 0x2c8f00002c90, + 0x2c9100002c92, + 0x2c9300002c94, + 0x2c9500002c96, + 0x2c9700002c98, + 0x2c9900002c9a, + 0x2c9b00002c9c, + 0x2c9d00002c9e, + 0x2c9f00002ca0, + 0x2ca100002ca2, + 0x2ca300002ca4, + 0x2ca500002ca6, + 0x2ca700002ca8, + 0x2ca900002caa, + 0x2cab00002cac, + 0x2cad00002cae, + 0x2caf00002cb0, + 0x2cb100002cb2, + 0x2cb300002cb4, + 0x2cb500002cb6, + 0x2cb700002cb8, + 0x2cb900002cba, + 0x2cbb00002cbc, + 0x2cbd00002cbe, + 0x2cbf00002cc0, + 0x2cc100002cc2, + 0x2cc300002cc4, + 0x2cc500002cc6, + 0x2cc700002cc8, + 0x2cc900002cca, + 0x2ccb00002ccc, + 0x2ccd00002cce, + 0x2ccf00002cd0, + 0x2cd100002cd2, + 0x2cd300002cd4, + 0x2cd500002cd6, + 0x2cd700002cd8, + 0x2cd900002cda, + 0x2cdb00002cdc, + 0x2cdd00002cde, + 0x2cdf00002ce0, + 0x2ce100002ce2, + 0x2ce300002ce5, + 0x2cec00002ced, + 0x2cee00002cf2, + 0x2cf300002cf4, + 0x2d0000002d26, + 0x2d2700002d28, + 0x2d2d00002d2e, + 0x2d3000002d68, + 0x2d7f00002d97, + 0x2da000002da7, + 0x2da800002daf, + 0x2db000002db7, + 0x2db800002dbf, + 0x2dc000002dc7, + 0x2dc800002dcf, + 0x2dd000002dd7, + 0x2dd800002ddf, + 0x2de000002e00, + 0x2e2f00002e30, + 0x300500003008, + 0x302a0000302e, + 0x303c0000303d, + 0x304100003097, + 0x30990000309b, + 0x309d0000309f, + 0x30a1000030fb, + 0x30fc000030ff, + 0x310500003130, + 0x31a0000031c0, + 0x31f000003200, + 0x340000004dc0, + 0x4e000000a48d, + 0xa4d00000a4fe, + 0xa5000000a60d, + 0xa6100000a62c, + 0xa6410000a642, + 0xa6430000a644, + 0xa6450000a646, + 0xa6470000a648, + 0xa6490000a64a, + 0xa64b0000a64c, + 0xa64d0000a64e, + 0xa64f0000a650, + 0xa6510000a652, + 0xa6530000a654, + 0xa6550000a656, + 0xa6570000a658, + 0xa6590000a65a, + 0xa65b0000a65c, + 0xa65d0000a65e, + 0xa65f0000a660, + 0xa6610000a662, + 0xa6630000a664, + 0xa6650000a666, + 0xa6670000a668, + 0xa6690000a66a, + 0xa66b0000a66c, + 0xa66d0000a670, + 0xa6740000a67e, + 0xa67f0000a680, + 0xa6810000a682, + 0xa6830000a684, + 0xa6850000a686, + 0xa6870000a688, + 0xa6890000a68a, + 0xa68b0000a68c, + 0xa68d0000a68e, + 0xa68f0000a690, + 0xa6910000a692, + 0xa6930000a694, + 0xa6950000a696, + 0xa6970000a698, + 0xa6990000a69a, + 0xa69b0000a69c, + 0xa69e0000a6e6, + 0xa6f00000a6f2, + 0xa7170000a720, + 0xa7230000a724, + 0xa7250000a726, + 0xa7270000a728, + 0xa7290000a72a, + 0xa72b0000a72c, + 0xa72d0000a72e, + 0xa72f0000a732, + 0xa7330000a734, + 0xa7350000a736, + 0xa7370000a738, + 0xa7390000a73a, + 0xa73b0000a73c, + 0xa73d0000a73e, + 0xa73f0000a740, + 0xa7410000a742, + 0xa7430000a744, + 0xa7450000a746, + 0xa7470000a748, + 0xa7490000a74a, + 0xa74b0000a74c, + 0xa74d0000a74e, + 0xa74f0000a750, + 0xa7510000a752, + 0xa7530000a754, + 0xa7550000a756, + 0xa7570000a758, + 0xa7590000a75a, + 0xa75b0000a75c, + 0xa75d0000a75e, + 0xa75f0000a760, + 0xa7610000a762, + 0xa7630000a764, + 0xa7650000a766, + 0xa7670000a768, + 0xa7690000a76a, + 0xa76b0000a76c, + 0xa76d0000a76e, + 0xa76f0000a770, + 0xa7710000a779, + 0xa77a0000a77b, + 0xa77c0000a77d, + 0xa77f0000a780, + 0xa7810000a782, + 0xa7830000a784, + 0xa7850000a786, + 0xa7870000a789, + 0xa78c0000a78d, + 0xa78e0000a790, + 0xa7910000a792, + 0xa7930000a796, + 0xa7970000a798, + 0xa7990000a79a, + 0xa79b0000a79c, + 0xa79d0000a79e, + 0xa79f0000a7a0, + 0xa7a10000a7a2, + 0xa7a30000a7a4, + 0xa7a50000a7a6, + 0xa7a70000a7a8, + 0xa7a90000a7aa, + 0xa7af0000a7b0, + 0xa7b50000a7b6, + 0xa7b70000a7b8, + 0xa7b90000a7ba, + 0xa7bb0000a7bc, + 0xa7bd0000a7be, + 0xa7bf0000a7c0, + 0xa7c10000a7c2, + 0xa7c30000a7c4, + 0xa7c80000a7c9, + 0xa7ca0000a7cb, + 0xa7d10000a7d2, + 0xa7d30000a7d4, + 0xa7d50000a7d6, + 0xa7d70000a7d8, + 0xa7d90000a7da, + 0xa7f60000a7f8, + 0xa7fa0000a828, + 0xa82c0000a82d, + 0xa8400000a874, + 0xa8800000a8c6, + 0xa8d00000a8da, + 0xa8e00000a8f8, + 0xa8fb0000a8fc, + 0xa8fd0000a92e, + 0xa9300000a954, + 0xa9800000a9c1, + 0xa9cf0000a9da, + 0xa9e00000a9ff, + 0xaa000000aa37, + 0xaa400000aa4e, + 0xaa500000aa5a, + 0xaa600000aa77, + 0xaa7a0000aac3, + 0xaadb0000aade, + 0xaae00000aaf0, + 0xaaf20000aaf7, + 0xab010000ab07, + 0xab090000ab0f, + 0xab110000ab17, + 0xab200000ab27, + 0xab280000ab2f, + 0xab300000ab5b, + 0xab600000ab69, + 0xabc00000abeb, + 0xabec0000abee, + 0xabf00000abfa, + 0xac000000d7a4, + 0xfa0e0000fa10, + 0xfa110000fa12, + 0xfa130000fa15, + 0xfa1f0000fa20, + 0xfa210000fa22, + 0xfa230000fa25, + 0xfa270000fa2a, + 0xfb1e0000fb1f, + 0xfe200000fe30, + 0xfe730000fe74, + 0x100000001000c, + 0x1000d00010027, + 0x100280001003b, + 0x1003c0001003e, + 0x1003f0001004e, + 0x100500001005e, + 0x10080000100fb, + 0x101fd000101fe, + 0x102800001029d, + 0x102a0000102d1, + 0x102e0000102e1, + 0x1030000010320, + 0x1032d00010341, + 0x103420001034a, + 0x103500001037b, + 0x103800001039e, + 0x103a0000103c4, + 0x103c8000103d0, + 0x104280001049e, + 0x104a0000104aa, + 0x104d8000104fc, + 0x1050000010528, + 0x1053000010564, + 0x10597000105a2, + 0x105a3000105b2, + 0x105b3000105ba, + 0x105bb000105bd, + 0x1060000010737, + 0x1074000010756, + 0x1076000010768, + 0x1078000010781, + 0x1080000010806, + 0x1080800010809, + 0x1080a00010836, + 0x1083700010839, + 0x1083c0001083d, + 0x1083f00010856, + 0x1086000010877, + 0x108800001089f, + 0x108e0000108f3, + 0x108f4000108f6, + 0x1090000010916, + 0x109200001093a, + 0x10980000109b8, + 0x109be000109c0, + 0x10a0000010a04, + 0x10a0500010a07, + 0x10a0c00010a14, + 0x10a1500010a18, + 0x10a1900010a36, + 0x10a3800010a3b, + 0x10a3f00010a40, + 0x10a6000010a7d, + 0x10a8000010a9d, + 0x10ac000010ac8, + 0x10ac900010ae7, + 0x10b0000010b36, + 0x10b4000010b56, + 0x10b6000010b73, + 0x10b8000010b92, + 0x10c0000010c49, + 0x10cc000010cf3, + 0x10d0000010d28, + 0x10d3000010d3a, + 0x10e8000010eaa, + 0x10eab00010ead, + 0x10eb000010eb2, + 0x10efd00010f1d, + 0x10f2700010f28, + 0x10f3000010f51, + 0x10f7000010f86, + 0x10fb000010fc5, + 0x10fe000010ff7, + 0x1100000011047, + 0x1106600011076, + 0x1107f000110bb, + 0x110c2000110c3, + 0x110d0000110e9, + 0x110f0000110fa, + 0x1110000011135, + 0x1113600011140, + 0x1114400011148, + 0x1115000011174, + 0x1117600011177, + 0x11180000111c5, + 0x111c9000111cd, + 0x111ce000111db, + 0x111dc000111dd, + 0x1120000011212, + 0x1121300011238, + 0x1123e00011242, + 0x1128000011287, + 0x1128800011289, + 0x1128a0001128e, + 0x1128f0001129e, + 0x1129f000112a9, + 0x112b0000112eb, + 0x112f0000112fa, + 0x1130000011304, + 0x113050001130d, + 0x1130f00011311, + 0x1131300011329, + 0x1132a00011331, + 0x1133200011334, + 0x113350001133a, + 0x1133b00011345, + 0x1134700011349, + 0x1134b0001134e, + 0x1135000011351, + 0x1135700011358, + 0x1135d00011364, + 0x113660001136d, + 0x1137000011375, + 0x114000001144b, + 0x114500001145a, + 0x1145e00011462, + 0x11480000114c6, + 0x114c7000114c8, + 0x114d0000114da, + 0x11580000115b6, + 0x115b8000115c1, + 0x115d8000115de, + 0x1160000011641, + 0x1164400011645, + 0x116500001165a, + 0x11680000116b9, + 0x116c0000116ca, + 0x117000001171b, + 0x1171d0001172c, + 0x117300001173a, + 0x1174000011747, + 0x118000001183b, + 0x118c0000118ea, + 0x118ff00011907, + 0x119090001190a, + 0x1190c00011914, + 0x1191500011917, + 0x1191800011936, + 0x1193700011939, + 0x1193b00011944, + 0x119500001195a, + 0x119a0000119a8, + 0x119aa000119d8, + 0x119da000119e2, + 0x119e3000119e5, + 0x11a0000011a3f, + 0x11a4700011a48, + 0x11a5000011a9a, + 0x11a9d00011a9e, + 0x11ab000011af9, + 0x11c0000011c09, + 0x11c0a00011c37, + 0x11c3800011c41, + 0x11c5000011c5a, + 0x11c7200011c90, + 0x11c9200011ca8, + 0x11ca900011cb7, + 0x11d0000011d07, + 0x11d0800011d0a, + 0x11d0b00011d37, + 0x11d3a00011d3b, + 0x11d3c00011d3e, + 0x11d3f00011d48, + 0x11d5000011d5a, + 0x11d6000011d66, + 0x11d6700011d69, + 0x11d6a00011d8f, + 0x11d9000011d92, + 0x11d9300011d99, + 0x11da000011daa, + 0x11ee000011ef7, + 0x11f0000011f11, + 0x11f1200011f3b, + 0x11f3e00011f43, + 0x11f5000011f5a, + 0x11fb000011fb1, + 0x120000001239a, + 0x1248000012544, + 0x12f9000012ff1, + 0x1300000013430, + 0x1344000013456, + 0x1440000014647, + 0x1680000016a39, + 0x16a4000016a5f, + 0x16a6000016a6a, + 0x16a7000016abf, + 0x16ac000016aca, + 0x16ad000016aee, + 0x16af000016af5, + 0x16b0000016b37, + 0x16b4000016b44, + 0x16b5000016b5a, + 0x16b6300016b78, + 0x16b7d00016b90, + 0x16e6000016e80, + 0x16f0000016f4b, + 0x16f4f00016f88, + 0x16f8f00016fa0, + 0x16fe000016fe2, + 0x16fe300016fe5, + 0x16ff000016ff2, + 0x17000000187f8, + 0x1880000018cd6, + 0x18d0000018d09, + 0x1aff00001aff4, + 0x1aff50001affc, + 0x1affd0001afff, + 0x1b0000001b123, + 0x1b1320001b133, + 0x1b1500001b153, + 0x1b1550001b156, + 0x1b1640001b168, + 0x1b1700001b2fc, + 0x1bc000001bc6b, + 0x1bc700001bc7d, + 0x1bc800001bc89, + 0x1bc900001bc9a, + 0x1bc9d0001bc9f, + 0x1cf000001cf2e, + 0x1cf300001cf47, + 0x1da000001da37, + 0x1da3b0001da6d, + 0x1da750001da76, + 0x1da840001da85, + 0x1da9b0001daa0, + 0x1daa10001dab0, + 0x1df000001df1f, + 0x1df250001df2b, + 0x1e0000001e007, + 0x1e0080001e019, + 0x1e01b0001e022, + 0x1e0230001e025, + 0x1e0260001e02b, + 0x1e08f0001e090, + 0x1e1000001e12d, + 0x1e1300001e13e, + 0x1e1400001e14a, + 0x1e14e0001e14f, + 0x1e2900001e2af, + 0x1e2c00001e2fa, + 0x1e4d00001e4fa, + 0x1e7e00001e7e7, + 0x1e7e80001e7ec, + 0x1e7ed0001e7ef, + 0x1e7f00001e7ff, + 0x1e8000001e8c5, + 0x1e8d00001e8d7, + 0x1e9220001e94c, + 0x1e9500001e95a, + 0x200000002a6e0, + 0x2a7000002b73a, + 0x2b7400002b81e, + 0x2b8200002cea2, + 0x2ceb00002ebe1, + 0x2ebf00002ee5e, + 0x300000003134b, + 0x31350000323b0, + ), + 'CONTEXTJ': ( + 0x200c0000200e, + ), + 'CONTEXTO': ( + 0xb7000000b8, + 0x37500000376, + 0x5f3000005f5, + 0x6600000066a, + 0x6f0000006fa, + 0x30fb000030fc, + ), +} diff --git a/.venv/lib/python3.12/site-packages/idna/intranges.py b/.venv/lib/python3.12/site-packages/idna/intranges.py new file mode 100644 index 0000000..6a43b04 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/idna/intranges.py @@ -0,0 +1,54 @@ +""" +Given a list of integers, made up of (hopefully) a small number of long runs +of consecutive integers, compute a representation of the form +((start1, end1), (start2, end2) ...). Then answer the question "was x present +in the original list?" in time O(log(# runs)). +""" + +import bisect +from typing import List, Tuple + +def intranges_from_list(list_: List[int]) -> Tuple[int, ...]: + """Represent a list of integers as a sequence of ranges: + ((start_0, end_0), (start_1, end_1), ...), such that the original + integers are exactly those x such that start_i <= x < end_i for some i. + + Ranges are encoded as single integers (start << 32 | end), not as tuples. + """ + + sorted_list = sorted(list_) + ranges = [] + last_write = -1 + for i in range(len(sorted_list)): + if i+1 < len(sorted_list): + if sorted_list[i] == sorted_list[i+1]-1: + continue + current_range = sorted_list[last_write+1:i+1] + ranges.append(_encode_range(current_range[0], current_range[-1] + 1)) + last_write = i + + return tuple(ranges) + +def _encode_range(start: int, end: int) -> int: + return (start << 32) | end + +def _decode_range(r: int) -> Tuple[int, int]: + return (r >> 32), (r & ((1 << 32) - 1)) + + +def intranges_contain(int_: int, ranges: Tuple[int, ...]) -> bool: + """Determine if `int_` falls into one of the ranges in `ranges`.""" + tuple_ = _encode_range(int_, 0) + pos = bisect.bisect_left(ranges, tuple_) + # we could be immediately ahead of a tuple (start, end) + # with start < int_ <= end + if pos > 0: + left, right = _decode_range(ranges[pos-1]) + if left <= int_ < right: + return True + # or we could be immediately behind a tuple (int_, end) + if pos < len(ranges): + left, _ = _decode_range(ranges[pos]) + if left == int_: + return True + return False diff --git a/.venv/lib/python3.12/site-packages/idna/package_data.py b/.venv/lib/python3.12/site-packages/idna/package_data.py new file mode 100644 index 0000000..ed81113 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/idna/package_data.py @@ -0,0 +1,2 @@ +__version__ = '3.7' + diff --git a/.venv/lib/python3.12/site-packages/idna/py.typed b/.venv/lib/python3.12/site-packages/idna/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/.venv/lib/python3.12/site-packages/idna/uts46data.py b/.venv/lib/python3.12/site-packages/idna/uts46data.py new file mode 100644 index 0000000..6a1eddb --- /dev/null +++ b/.venv/lib/python3.12/site-packages/idna/uts46data.py @@ -0,0 +1,8598 @@ +# This file is automatically generated by tools/idna-data +# vim: set fileencoding=utf-8 : + +from typing import List, Tuple, Union + + +"""IDNA Mapping Table from UTS46.""" + + +__version__ = '15.1.0' +def _seg_0() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x0, '3'), + (0x1, '3'), + (0x2, '3'), + (0x3, '3'), + (0x4, '3'), + (0x5, '3'), + (0x6, '3'), + (0x7, '3'), + (0x8, '3'), + (0x9, '3'), + (0xA, '3'), + (0xB, '3'), + (0xC, '3'), + (0xD, '3'), + (0xE, '3'), + (0xF, '3'), + (0x10, '3'), + (0x11, '3'), + (0x12, '3'), + (0x13, '3'), + (0x14, '3'), + (0x15, '3'), + (0x16, '3'), + (0x17, '3'), + (0x18, '3'), + (0x19, '3'), + (0x1A, '3'), + (0x1B, '3'), + (0x1C, '3'), + (0x1D, '3'), + (0x1E, '3'), + (0x1F, '3'), + (0x20, '3'), + (0x21, '3'), + (0x22, '3'), + (0x23, '3'), + (0x24, '3'), + (0x25, '3'), + (0x26, '3'), + (0x27, '3'), + (0x28, '3'), + (0x29, '3'), + (0x2A, '3'), + (0x2B, '3'), + (0x2C, '3'), + (0x2D, 'V'), + (0x2E, 'V'), + (0x2F, '3'), + (0x30, 'V'), + (0x31, 'V'), + (0x32, 'V'), + (0x33, 'V'), + (0x34, 'V'), + (0x35, 'V'), + (0x36, 'V'), + (0x37, 'V'), + (0x38, 'V'), + (0x39, 'V'), + (0x3A, '3'), + (0x3B, '3'), + (0x3C, '3'), + (0x3D, '3'), + (0x3E, '3'), + (0x3F, '3'), + (0x40, '3'), + (0x41, 'M', 'a'), + (0x42, 'M', 'b'), + (0x43, 'M', 'c'), + (0x44, 'M', 'd'), + (0x45, 'M', 'e'), + (0x46, 'M', 'f'), + (0x47, 'M', 'g'), + (0x48, 'M', 'h'), + (0x49, 'M', 'i'), + (0x4A, 'M', 'j'), + (0x4B, 'M', 'k'), + (0x4C, 'M', 'l'), + (0x4D, 'M', 'm'), + (0x4E, 'M', 'n'), + (0x4F, 'M', 'o'), + (0x50, 'M', 'p'), + (0x51, 'M', 'q'), + (0x52, 'M', 'r'), + (0x53, 'M', 's'), + (0x54, 'M', 't'), + (0x55, 'M', 'u'), + (0x56, 'M', 'v'), + (0x57, 'M', 'w'), + (0x58, 'M', 'x'), + (0x59, 'M', 'y'), + (0x5A, 'M', 'z'), + (0x5B, '3'), + (0x5C, '3'), + (0x5D, '3'), + (0x5E, '3'), + (0x5F, '3'), + (0x60, '3'), + (0x61, 'V'), + (0x62, 'V'), + (0x63, 'V'), + ] + +def _seg_1() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x64, 'V'), + (0x65, 'V'), + (0x66, 'V'), + (0x67, 'V'), + (0x68, 'V'), + (0x69, 'V'), + (0x6A, 'V'), + (0x6B, 'V'), + (0x6C, 'V'), + (0x6D, 'V'), + (0x6E, 'V'), + (0x6F, 'V'), + (0x70, 'V'), + (0x71, 'V'), + (0x72, 'V'), + (0x73, 'V'), + (0x74, 'V'), + (0x75, 'V'), + (0x76, 'V'), + (0x77, 'V'), + (0x78, 'V'), + (0x79, 'V'), + (0x7A, 'V'), + (0x7B, '3'), + (0x7C, '3'), + (0x7D, '3'), + (0x7E, '3'), + (0x7F, '3'), + (0x80, 'X'), + (0x81, 'X'), + (0x82, 'X'), + (0x83, 'X'), + (0x84, 'X'), + (0x85, 'X'), + (0x86, 'X'), + (0x87, 'X'), + (0x88, 'X'), + (0x89, 'X'), + (0x8A, 'X'), + (0x8B, 'X'), + (0x8C, 'X'), + (0x8D, 'X'), + (0x8E, 'X'), + (0x8F, 'X'), + (0x90, 'X'), + (0x91, 'X'), + (0x92, 'X'), + (0x93, 'X'), + (0x94, 'X'), + (0x95, 'X'), + (0x96, 'X'), + (0x97, 'X'), + (0x98, 'X'), + (0x99, 'X'), + (0x9A, 'X'), + (0x9B, 'X'), + (0x9C, 'X'), + (0x9D, 'X'), + (0x9E, 'X'), + (0x9F, 'X'), + (0xA0, '3', ' '), + (0xA1, 'V'), + (0xA2, 'V'), + (0xA3, 'V'), + (0xA4, 'V'), + (0xA5, 'V'), + (0xA6, 'V'), + (0xA7, 'V'), + (0xA8, '3', ' ̈'), + (0xA9, 'V'), + (0xAA, 'M', 'a'), + (0xAB, 'V'), + (0xAC, 'V'), + (0xAD, 'I'), + (0xAE, 'V'), + (0xAF, '3', ' ̄'), + (0xB0, 'V'), + (0xB1, 'V'), + (0xB2, 'M', '2'), + (0xB3, 'M', '3'), + (0xB4, '3', ' ́'), + (0xB5, 'M', 'μ'), + (0xB6, 'V'), + (0xB7, 'V'), + (0xB8, '3', ' ̧'), + (0xB9, 'M', '1'), + (0xBA, 'M', 'o'), + (0xBB, 'V'), + (0xBC, 'M', '1⁄4'), + (0xBD, 'M', '1⁄2'), + (0xBE, 'M', '3⁄4'), + (0xBF, 'V'), + (0xC0, 'M', 'à'), + (0xC1, 'M', 'á'), + (0xC2, 'M', 'â'), + (0xC3, 'M', 'ã'), + (0xC4, 'M', 'ä'), + (0xC5, 'M', 'å'), + (0xC6, 'M', 'æ'), + (0xC7, 'M', 'ç'), + ] + +def _seg_2() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xC8, 'M', 'è'), + (0xC9, 'M', 'é'), + (0xCA, 'M', 'ê'), + (0xCB, 'M', 'ë'), + (0xCC, 'M', 'ì'), + (0xCD, 'M', 'í'), + (0xCE, 'M', 'î'), + (0xCF, 'M', 'ï'), + (0xD0, 'M', 'ð'), + (0xD1, 'M', 'ñ'), + (0xD2, 'M', 'ò'), + (0xD3, 'M', 'ó'), + (0xD4, 'M', 'ô'), + (0xD5, 'M', 'õ'), + (0xD6, 'M', 'ö'), + (0xD7, 'V'), + (0xD8, 'M', 'ø'), + (0xD9, 'M', 'ù'), + (0xDA, 'M', 'ú'), + (0xDB, 'M', 'û'), + (0xDC, 'M', 'ü'), + (0xDD, 'M', 'ý'), + (0xDE, 'M', 'þ'), + (0xDF, 'D', 'ss'), + (0xE0, 'V'), + (0xE1, 'V'), + (0xE2, 'V'), + (0xE3, 'V'), + (0xE4, 'V'), + (0xE5, 'V'), + (0xE6, 'V'), + (0xE7, 'V'), + (0xE8, 'V'), + (0xE9, 'V'), + (0xEA, 'V'), + (0xEB, 'V'), + (0xEC, 'V'), + (0xED, 'V'), + (0xEE, 'V'), + (0xEF, 'V'), + (0xF0, 'V'), + (0xF1, 'V'), + (0xF2, 'V'), + (0xF3, 'V'), + (0xF4, 'V'), + (0xF5, 'V'), + (0xF6, 'V'), + (0xF7, 'V'), + (0xF8, 'V'), + (0xF9, 'V'), + (0xFA, 'V'), + (0xFB, 'V'), + (0xFC, 'V'), + (0xFD, 'V'), + (0xFE, 'V'), + (0xFF, 'V'), + (0x100, 'M', 'ā'), + (0x101, 'V'), + (0x102, 'M', 'ă'), + (0x103, 'V'), + (0x104, 'M', 'ą'), + (0x105, 'V'), + (0x106, 'M', 'ć'), + (0x107, 'V'), + (0x108, 'M', 'ĉ'), + (0x109, 'V'), + (0x10A, 'M', 'ċ'), + (0x10B, 'V'), + (0x10C, 'M', 'č'), + (0x10D, 'V'), + (0x10E, 'M', 'ď'), + (0x10F, 'V'), + (0x110, 'M', 'đ'), + (0x111, 'V'), + (0x112, 'M', 'ē'), + (0x113, 'V'), + (0x114, 'M', 'ĕ'), + (0x115, 'V'), + (0x116, 'M', 'ė'), + (0x117, 'V'), + (0x118, 'M', 'ę'), + (0x119, 'V'), + (0x11A, 'M', 'ě'), + (0x11B, 'V'), + (0x11C, 'M', 'ĝ'), + (0x11D, 'V'), + (0x11E, 'M', 'ğ'), + (0x11F, 'V'), + (0x120, 'M', 'ġ'), + (0x121, 'V'), + (0x122, 'M', 'ģ'), + (0x123, 'V'), + (0x124, 'M', 'ĥ'), + (0x125, 'V'), + (0x126, 'M', 'ħ'), + (0x127, 'V'), + (0x128, 'M', 'ĩ'), + (0x129, 'V'), + (0x12A, 'M', 'ī'), + (0x12B, 'V'), + ] + +def _seg_3() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x12C, 'M', 'ĭ'), + (0x12D, 'V'), + (0x12E, 'M', 'į'), + (0x12F, 'V'), + (0x130, 'M', 'i̇'), + (0x131, 'V'), + (0x132, 'M', 'ij'), + (0x134, 'M', 'ĵ'), + (0x135, 'V'), + (0x136, 'M', 'ķ'), + (0x137, 'V'), + (0x139, 'M', 'ĺ'), + (0x13A, 'V'), + (0x13B, 'M', 'ļ'), + (0x13C, 'V'), + (0x13D, 'M', 'ľ'), + (0x13E, 'V'), + (0x13F, 'M', 'l·'), + (0x141, 'M', 'ł'), + (0x142, 'V'), + (0x143, 'M', 'ń'), + (0x144, 'V'), + (0x145, 'M', 'ņ'), + (0x146, 'V'), + (0x147, 'M', 'ň'), + (0x148, 'V'), + (0x149, 'M', 'ʼn'), + (0x14A, 'M', 'ŋ'), + (0x14B, 'V'), + (0x14C, 'M', 'ō'), + (0x14D, 'V'), + (0x14E, 'M', 'ŏ'), + (0x14F, 'V'), + (0x150, 'M', 'ő'), + (0x151, 'V'), + (0x152, 'M', 'œ'), + (0x153, 'V'), + (0x154, 'M', 'ŕ'), + (0x155, 'V'), + (0x156, 'M', 'ŗ'), + (0x157, 'V'), + (0x158, 'M', 'ř'), + (0x159, 'V'), + (0x15A, 'M', 'ś'), + (0x15B, 'V'), + (0x15C, 'M', 'ŝ'), + (0x15D, 'V'), + (0x15E, 'M', 'ş'), + (0x15F, 'V'), + (0x160, 'M', 'š'), + (0x161, 'V'), + (0x162, 'M', 'ţ'), + (0x163, 'V'), + (0x164, 'M', 'ť'), + (0x165, 'V'), + (0x166, 'M', 'ŧ'), + (0x167, 'V'), + (0x168, 'M', 'ũ'), + (0x169, 'V'), + (0x16A, 'M', 'ū'), + (0x16B, 'V'), + (0x16C, 'M', 'ŭ'), + (0x16D, 'V'), + (0x16E, 'M', 'ů'), + (0x16F, 'V'), + (0x170, 'M', 'ű'), + (0x171, 'V'), + (0x172, 'M', 'ų'), + (0x173, 'V'), + (0x174, 'M', 'ŵ'), + (0x175, 'V'), + (0x176, 'M', 'ŷ'), + (0x177, 'V'), + (0x178, 'M', 'ÿ'), + (0x179, 'M', 'ź'), + (0x17A, 'V'), + (0x17B, 'M', 'ż'), + (0x17C, 'V'), + (0x17D, 'M', 'ž'), + (0x17E, 'V'), + (0x17F, 'M', 's'), + (0x180, 'V'), + (0x181, 'M', 'ɓ'), + (0x182, 'M', 'ƃ'), + (0x183, 'V'), + (0x184, 'M', 'ƅ'), + (0x185, 'V'), + (0x186, 'M', 'ɔ'), + (0x187, 'M', 'ƈ'), + (0x188, 'V'), + (0x189, 'M', 'ɖ'), + (0x18A, 'M', 'ɗ'), + (0x18B, 'M', 'ƌ'), + (0x18C, 'V'), + (0x18E, 'M', 'ǝ'), + (0x18F, 'M', 'ə'), + (0x190, 'M', 'ɛ'), + (0x191, 'M', 'ƒ'), + (0x192, 'V'), + (0x193, 'M', 'ɠ'), + ] + +def _seg_4() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x194, 'M', 'ɣ'), + (0x195, 'V'), + (0x196, 'M', 'ɩ'), + (0x197, 'M', 'ɨ'), + (0x198, 'M', 'ƙ'), + (0x199, 'V'), + (0x19C, 'M', 'ɯ'), + (0x19D, 'M', 'ɲ'), + (0x19E, 'V'), + (0x19F, 'M', 'ɵ'), + (0x1A0, 'M', 'ơ'), + (0x1A1, 'V'), + (0x1A2, 'M', 'ƣ'), + (0x1A3, 'V'), + (0x1A4, 'M', 'ƥ'), + (0x1A5, 'V'), + (0x1A6, 'M', 'ʀ'), + (0x1A7, 'M', 'ƨ'), + (0x1A8, 'V'), + (0x1A9, 'M', 'ʃ'), + (0x1AA, 'V'), + (0x1AC, 'M', 'ƭ'), + (0x1AD, 'V'), + (0x1AE, 'M', 'ʈ'), + (0x1AF, 'M', 'ư'), + (0x1B0, 'V'), + (0x1B1, 'M', 'ʊ'), + (0x1B2, 'M', 'ʋ'), + (0x1B3, 'M', 'ƴ'), + (0x1B4, 'V'), + (0x1B5, 'M', 'ƶ'), + (0x1B6, 'V'), + (0x1B7, 'M', 'ʒ'), + (0x1B8, 'M', 'ƹ'), + (0x1B9, 'V'), + (0x1BC, 'M', 'ƽ'), + (0x1BD, 'V'), + (0x1C4, 'M', 'dž'), + (0x1C7, 'M', 'lj'), + (0x1CA, 'M', 'nj'), + (0x1CD, 'M', 'ǎ'), + (0x1CE, 'V'), + (0x1CF, 'M', 'ǐ'), + (0x1D0, 'V'), + (0x1D1, 'M', 'ǒ'), + (0x1D2, 'V'), + (0x1D3, 'M', 'ǔ'), + (0x1D4, 'V'), + (0x1D5, 'M', 'ǖ'), + (0x1D6, 'V'), + (0x1D7, 'M', 'ǘ'), + (0x1D8, 'V'), + (0x1D9, 'M', 'ǚ'), + (0x1DA, 'V'), + (0x1DB, 'M', 'ǜ'), + (0x1DC, 'V'), + (0x1DE, 'M', 'ǟ'), + (0x1DF, 'V'), + (0x1E0, 'M', 'ǡ'), + (0x1E1, 'V'), + (0x1E2, 'M', 'ǣ'), + (0x1E3, 'V'), + (0x1E4, 'M', 'ǥ'), + (0x1E5, 'V'), + (0x1E6, 'M', 'ǧ'), + (0x1E7, 'V'), + (0x1E8, 'M', 'ǩ'), + (0x1E9, 'V'), + (0x1EA, 'M', 'ǫ'), + (0x1EB, 'V'), + (0x1EC, 'M', 'ǭ'), + (0x1ED, 'V'), + (0x1EE, 'M', 'ǯ'), + (0x1EF, 'V'), + (0x1F1, 'M', 'dz'), + (0x1F4, 'M', 'ǵ'), + (0x1F5, 'V'), + (0x1F6, 'M', 'ƕ'), + (0x1F7, 'M', 'ƿ'), + (0x1F8, 'M', 'ǹ'), + (0x1F9, 'V'), + (0x1FA, 'M', 'ǻ'), + (0x1FB, 'V'), + (0x1FC, 'M', 'ǽ'), + (0x1FD, 'V'), + (0x1FE, 'M', 'ǿ'), + (0x1FF, 'V'), + (0x200, 'M', 'ȁ'), + (0x201, 'V'), + (0x202, 'M', 'ȃ'), + (0x203, 'V'), + (0x204, 'M', 'ȅ'), + (0x205, 'V'), + (0x206, 'M', 'ȇ'), + (0x207, 'V'), + (0x208, 'M', 'ȉ'), + (0x209, 'V'), + (0x20A, 'M', 'ȋ'), + (0x20B, 'V'), + (0x20C, 'M', 'ȍ'), + ] + +def _seg_5() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x20D, 'V'), + (0x20E, 'M', 'ȏ'), + (0x20F, 'V'), + (0x210, 'M', 'ȑ'), + (0x211, 'V'), + (0x212, 'M', 'ȓ'), + (0x213, 'V'), + (0x214, 'M', 'ȕ'), + (0x215, 'V'), + (0x216, 'M', 'ȗ'), + (0x217, 'V'), + (0x218, 'M', 'ș'), + (0x219, 'V'), + (0x21A, 'M', 'ț'), + (0x21B, 'V'), + (0x21C, 'M', 'ȝ'), + (0x21D, 'V'), + (0x21E, 'M', 'ȟ'), + (0x21F, 'V'), + (0x220, 'M', 'ƞ'), + (0x221, 'V'), + (0x222, 'M', 'ȣ'), + (0x223, 'V'), + (0x224, 'M', 'ȥ'), + (0x225, 'V'), + (0x226, 'M', 'ȧ'), + (0x227, 'V'), + (0x228, 'M', 'ȩ'), + (0x229, 'V'), + (0x22A, 'M', 'ȫ'), + (0x22B, 'V'), + (0x22C, 'M', 'ȭ'), + (0x22D, 'V'), + (0x22E, 'M', 'ȯ'), + (0x22F, 'V'), + (0x230, 'M', 'ȱ'), + (0x231, 'V'), + (0x232, 'M', 'ȳ'), + (0x233, 'V'), + (0x23A, 'M', 'ⱥ'), + (0x23B, 'M', 'ȼ'), + (0x23C, 'V'), + (0x23D, 'M', 'ƚ'), + (0x23E, 'M', 'ⱦ'), + (0x23F, 'V'), + (0x241, 'M', 'ɂ'), + (0x242, 'V'), + (0x243, 'M', 'ƀ'), + (0x244, 'M', 'ʉ'), + (0x245, 'M', 'ʌ'), + (0x246, 'M', 'ɇ'), + (0x247, 'V'), + (0x248, 'M', 'ɉ'), + (0x249, 'V'), + (0x24A, 'M', 'ɋ'), + (0x24B, 'V'), + (0x24C, 'M', 'ɍ'), + (0x24D, 'V'), + (0x24E, 'M', 'ɏ'), + (0x24F, 'V'), + (0x2B0, 'M', 'h'), + (0x2B1, 'M', 'ɦ'), + (0x2B2, 'M', 'j'), + (0x2B3, 'M', 'r'), + (0x2B4, 'M', 'ɹ'), + (0x2B5, 'M', 'ɻ'), + (0x2B6, 'M', 'ʁ'), + (0x2B7, 'M', 'w'), + (0x2B8, 'M', 'y'), + (0x2B9, 'V'), + (0x2D8, '3', ' ̆'), + (0x2D9, '3', ' ̇'), + (0x2DA, '3', ' ̊'), + (0x2DB, '3', ' ̨'), + (0x2DC, '3', ' ̃'), + (0x2DD, '3', ' ̋'), + (0x2DE, 'V'), + (0x2E0, 'M', 'ɣ'), + (0x2E1, 'M', 'l'), + (0x2E2, 'M', 's'), + (0x2E3, 'M', 'x'), + (0x2E4, 'M', 'ʕ'), + (0x2E5, 'V'), + (0x340, 'M', '̀'), + (0x341, 'M', '́'), + (0x342, 'V'), + (0x343, 'M', '̓'), + (0x344, 'M', '̈́'), + (0x345, 'M', 'ι'), + (0x346, 'V'), + (0x34F, 'I'), + (0x350, 'V'), + (0x370, 'M', 'ͱ'), + (0x371, 'V'), + (0x372, 'M', 'ͳ'), + (0x373, 'V'), + (0x374, 'M', 'ʹ'), + (0x375, 'V'), + (0x376, 'M', 'ͷ'), + (0x377, 'V'), + ] + +def _seg_6() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x378, 'X'), + (0x37A, '3', ' ι'), + (0x37B, 'V'), + (0x37E, '3', ';'), + (0x37F, 'M', 'ϳ'), + (0x380, 'X'), + (0x384, '3', ' ́'), + (0x385, '3', ' ̈́'), + (0x386, 'M', 'ά'), + (0x387, 'M', '·'), + (0x388, 'M', 'έ'), + (0x389, 'M', 'ή'), + (0x38A, 'M', 'ί'), + (0x38B, 'X'), + (0x38C, 'M', 'ό'), + (0x38D, 'X'), + (0x38E, 'M', 'ύ'), + (0x38F, 'M', 'ώ'), + (0x390, 'V'), + (0x391, 'M', 'α'), + (0x392, 'M', 'β'), + (0x393, 'M', 'γ'), + (0x394, 'M', 'δ'), + (0x395, 'M', 'ε'), + (0x396, 'M', 'ζ'), + (0x397, 'M', 'η'), + (0x398, 'M', 'θ'), + (0x399, 'M', 'ι'), + (0x39A, 'M', 'κ'), + (0x39B, 'M', 'λ'), + (0x39C, 'M', 'μ'), + (0x39D, 'M', 'ν'), + (0x39E, 'M', 'ξ'), + (0x39F, 'M', 'ο'), + (0x3A0, 'M', 'π'), + (0x3A1, 'M', 'ρ'), + (0x3A2, 'X'), + (0x3A3, 'M', 'σ'), + (0x3A4, 'M', 'τ'), + (0x3A5, 'M', 'υ'), + (0x3A6, 'M', 'φ'), + (0x3A7, 'M', 'χ'), + (0x3A8, 'M', 'ψ'), + (0x3A9, 'M', 'ω'), + (0x3AA, 'M', 'ϊ'), + (0x3AB, 'M', 'ϋ'), + (0x3AC, 'V'), + (0x3C2, 'D', 'σ'), + (0x3C3, 'V'), + (0x3CF, 'M', 'ϗ'), + (0x3D0, 'M', 'β'), + (0x3D1, 'M', 'θ'), + (0x3D2, 'M', 'υ'), + (0x3D3, 'M', 'ύ'), + (0x3D4, 'M', 'ϋ'), + (0x3D5, 'M', 'φ'), + (0x3D6, 'M', 'π'), + (0x3D7, 'V'), + (0x3D8, 'M', 'ϙ'), + (0x3D9, 'V'), + (0x3DA, 'M', 'ϛ'), + (0x3DB, 'V'), + (0x3DC, 'M', 'ϝ'), + (0x3DD, 'V'), + (0x3DE, 'M', 'ϟ'), + (0x3DF, 'V'), + (0x3E0, 'M', 'ϡ'), + (0x3E1, 'V'), + (0x3E2, 'M', 'ϣ'), + (0x3E3, 'V'), + (0x3E4, 'M', 'ϥ'), + (0x3E5, 'V'), + (0x3E6, 'M', 'ϧ'), + (0x3E7, 'V'), + (0x3E8, 'M', 'ϩ'), + (0x3E9, 'V'), + (0x3EA, 'M', 'ϫ'), + (0x3EB, 'V'), + (0x3EC, 'M', 'ϭ'), + (0x3ED, 'V'), + (0x3EE, 'M', 'ϯ'), + (0x3EF, 'V'), + (0x3F0, 'M', 'κ'), + (0x3F1, 'M', 'ρ'), + (0x3F2, 'M', 'σ'), + (0x3F3, 'V'), + (0x3F4, 'M', 'θ'), + (0x3F5, 'M', 'ε'), + (0x3F6, 'V'), + (0x3F7, 'M', 'ϸ'), + (0x3F8, 'V'), + (0x3F9, 'M', 'σ'), + (0x3FA, 'M', 'ϻ'), + (0x3FB, 'V'), + (0x3FD, 'M', 'ͻ'), + (0x3FE, 'M', 'ͼ'), + (0x3FF, 'M', 'ͽ'), + (0x400, 'M', 'ѐ'), + (0x401, 'M', 'ё'), + (0x402, 'M', 'ђ'), + ] + +def _seg_7() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x403, 'M', 'ѓ'), + (0x404, 'M', 'є'), + (0x405, 'M', 'ѕ'), + (0x406, 'M', 'і'), + (0x407, 'M', 'ї'), + (0x408, 'M', 'ј'), + (0x409, 'M', 'љ'), + (0x40A, 'M', 'њ'), + (0x40B, 'M', 'ћ'), + (0x40C, 'M', 'ќ'), + (0x40D, 'M', 'ѝ'), + (0x40E, 'M', 'ў'), + (0x40F, 'M', 'џ'), + (0x410, 'M', 'а'), + (0x411, 'M', 'б'), + (0x412, 'M', 'в'), + (0x413, 'M', 'г'), + (0x414, 'M', 'д'), + (0x415, 'M', 'е'), + (0x416, 'M', 'ж'), + (0x417, 'M', 'з'), + (0x418, 'M', 'и'), + (0x419, 'M', 'й'), + (0x41A, 'M', 'к'), + (0x41B, 'M', 'л'), + (0x41C, 'M', 'м'), + (0x41D, 'M', 'н'), + (0x41E, 'M', 'о'), + (0x41F, 'M', 'п'), + (0x420, 'M', 'р'), + (0x421, 'M', 'с'), + (0x422, 'M', 'т'), + (0x423, 'M', 'у'), + (0x424, 'M', 'ф'), + (0x425, 'M', 'х'), + (0x426, 'M', 'ц'), + (0x427, 'M', 'ч'), + (0x428, 'M', 'ш'), + (0x429, 'M', 'щ'), + (0x42A, 'M', 'ъ'), + (0x42B, 'M', 'ы'), + (0x42C, 'M', 'ь'), + (0x42D, 'M', 'э'), + (0x42E, 'M', 'ю'), + (0x42F, 'M', 'я'), + (0x430, 'V'), + (0x460, 'M', 'ѡ'), + (0x461, 'V'), + (0x462, 'M', 'ѣ'), + (0x463, 'V'), + (0x464, 'M', 'ѥ'), + (0x465, 'V'), + (0x466, 'M', 'ѧ'), + (0x467, 'V'), + (0x468, 'M', 'ѩ'), + (0x469, 'V'), + (0x46A, 'M', 'ѫ'), + (0x46B, 'V'), + (0x46C, 'M', 'ѭ'), + (0x46D, 'V'), + (0x46E, 'M', 'ѯ'), + (0x46F, 'V'), + (0x470, 'M', 'ѱ'), + (0x471, 'V'), + (0x472, 'M', 'ѳ'), + (0x473, 'V'), + (0x474, 'M', 'ѵ'), + (0x475, 'V'), + (0x476, 'M', 'ѷ'), + (0x477, 'V'), + (0x478, 'M', 'ѹ'), + (0x479, 'V'), + (0x47A, 'M', 'ѻ'), + (0x47B, 'V'), + (0x47C, 'M', 'ѽ'), + (0x47D, 'V'), + (0x47E, 'M', 'ѿ'), + (0x47F, 'V'), + (0x480, 'M', 'ҁ'), + (0x481, 'V'), + (0x48A, 'M', 'ҋ'), + (0x48B, 'V'), + (0x48C, 'M', 'ҍ'), + (0x48D, 'V'), + (0x48E, 'M', 'ҏ'), + (0x48F, 'V'), + (0x490, 'M', 'ґ'), + (0x491, 'V'), + (0x492, 'M', 'ғ'), + (0x493, 'V'), + (0x494, 'M', 'ҕ'), + (0x495, 'V'), + (0x496, 'M', 'җ'), + (0x497, 'V'), + (0x498, 'M', 'ҙ'), + (0x499, 'V'), + (0x49A, 'M', 'қ'), + (0x49B, 'V'), + (0x49C, 'M', 'ҝ'), + (0x49D, 'V'), + ] + +def _seg_8() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x49E, 'M', 'ҟ'), + (0x49F, 'V'), + (0x4A0, 'M', 'ҡ'), + (0x4A1, 'V'), + (0x4A2, 'M', 'ң'), + (0x4A3, 'V'), + (0x4A4, 'M', 'ҥ'), + (0x4A5, 'V'), + (0x4A6, 'M', 'ҧ'), + (0x4A7, 'V'), + (0x4A8, 'M', 'ҩ'), + (0x4A9, 'V'), + (0x4AA, 'M', 'ҫ'), + (0x4AB, 'V'), + (0x4AC, 'M', 'ҭ'), + (0x4AD, 'V'), + (0x4AE, 'M', 'ү'), + (0x4AF, 'V'), + (0x4B0, 'M', 'ұ'), + (0x4B1, 'V'), + (0x4B2, 'M', 'ҳ'), + (0x4B3, 'V'), + (0x4B4, 'M', 'ҵ'), + (0x4B5, 'V'), + (0x4B6, 'M', 'ҷ'), + (0x4B7, 'V'), + (0x4B8, 'M', 'ҹ'), + (0x4B9, 'V'), + (0x4BA, 'M', 'һ'), + (0x4BB, 'V'), + (0x4BC, 'M', 'ҽ'), + (0x4BD, 'V'), + (0x4BE, 'M', 'ҿ'), + (0x4BF, 'V'), + (0x4C0, 'X'), + (0x4C1, 'M', 'ӂ'), + (0x4C2, 'V'), + (0x4C3, 'M', 'ӄ'), + (0x4C4, 'V'), + (0x4C5, 'M', 'ӆ'), + (0x4C6, 'V'), + (0x4C7, 'M', 'ӈ'), + (0x4C8, 'V'), + (0x4C9, 'M', 'ӊ'), + (0x4CA, 'V'), + (0x4CB, 'M', 'ӌ'), + (0x4CC, 'V'), + (0x4CD, 'M', 'ӎ'), + (0x4CE, 'V'), + (0x4D0, 'M', 'ӑ'), + (0x4D1, 'V'), + (0x4D2, 'M', 'ӓ'), + (0x4D3, 'V'), + (0x4D4, 'M', 'ӕ'), + (0x4D5, 'V'), + (0x4D6, 'M', 'ӗ'), + (0x4D7, 'V'), + (0x4D8, 'M', 'ә'), + (0x4D9, 'V'), + (0x4DA, 'M', 'ӛ'), + (0x4DB, 'V'), + (0x4DC, 'M', 'ӝ'), + (0x4DD, 'V'), + (0x4DE, 'M', 'ӟ'), + (0x4DF, 'V'), + (0x4E0, 'M', 'ӡ'), + (0x4E1, 'V'), + (0x4E2, 'M', 'ӣ'), + (0x4E3, 'V'), + (0x4E4, 'M', 'ӥ'), + (0x4E5, 'V'), + (0x4E6, 'M', 'ӧ'), + (0x4E7, 'V'), + (0x4E8, 'M', 'ө'), + (0x4E9, 'V'), + (0x4EA, 'M', 'ӫ'), + (0x4EB, 'V'), + (0x4EC, 'M', 'ӭ'), + (0x4ED, 'V'), + (0x4EE, 'M', 'ӯ'), + (0x4EF, 'V'), + (0x4F0, 'M', 'ӱ'), + (0x4F1, 'V'), + (0x4F2, 'M', 'ӳ'), + (0x4F3, 'V'), + (0x4F4, 'M', 'ӵ'), + (0x4F5, 'V'), + (0x4F6, 'M', 'ӷ'), + (0x4F7, 'V'), + (0x4F8, 'M', 'ӹ'), + (0x4F9, 'V'), + (0x4FA, 'M', 'ӻ'), + (0x4FB, 'V'), + (0x4FC, 'M', 'ӽ'), + (0x4FD, 'V'), + (0x4FE, 'M', 'ӿ'), + (0x4FF, 'V'), + (0x500, 'M', 'ԁ'), + (0x501, 'V'), + (0x502, 'M', 'ԃ'), + ] + +def _seg_9() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x503, 'V'), + (0x504, 'M', 'ԅ'), + (0x505, 'V'), + (0x506, 'M', 'ԇ'), + (0x507, 'V'), + (0x508, 'M', 'ԉ'), + (0x509, 'V'), + (0x50A, 'M', 'ԋ'), + (0x50B, 'V'), + (0x50C, 'M', 'ԍ'), + (0x50D, 'V'), + (0x50E, 'M', 'ԏ'), + (0x50F, 'V'), + (0x510, 'M', 'ԑ'), + (0x511, 'V'), + (0x512, 'M', 'ԓ'), + (0x513, 'V'), + (0x514, 'M', 'ԕ'), + (0x515, 'V'), + (0x516, 'M', 'ԗ'), + (0x517, 'V'), + (0x518, 'M', 'ԙ'), + (0x519, 'V'), + (0x51A, 'M', 'ԛ'), + (0x51B, 'V'), + (0x51C, 'M', 'ԝ'), + (0x51D, 'V'), + (0x51E, 'M', 'ԟ'), + (0x51F, 'V'), + (0x520, 'M', 'ԡ'), + (0x521, 'V'), + (0x522, 'M', 'ԣ'), + (0x523, 'V'), + (0x524, 'M', 'ԥ'), + (0x525, 'V'), + (0x526, 'M', 'ԧ'), + (0x527, 'V'), + (0x528, 'M', 'ԩ'), + (0x529, 'V'), + (0x52A, 'M', 'ԫ'), + (0x52B, 'V'), + (0x52C, 'M', 'ԭ'), + (0x52D, 'V'), + (0x52E, 'M', 'ԯ'), + (0x52F, 'V'), + (0x530, 'X'), + (0x531, 'M', 'ա'), + (0x532, 'M', 'բ'), + (0x533, 'M', 'գ'), + (0x534, 'M', 'դ'), + (0x535, 'M', 'ե'), + (0x536, 'M', 'զ'), + (0x537, 'M', 'է'), + (0x538, 'M', 'ը'), + (0x539, 'M', 'թ'), + (0x53A, 'M', 'ժ'), + (0x53B, 'M', 'ի'), + (0x53C, 'M', 'լ'), + (0x53D, 'M', 'խ'), + (0x53E, 'M', 'ծ'), + (0x53F, 'M', 'կ'), + (0x540, 'M', 'հ'), + (0x541, 'M', 'ձ'), + (0x542, 'M', 'ղ'), + (0x543, 'M', 'ճ'), + (0x544, 'M', 'մ'), + (0x545, 'M', 'յ'), + (0x546, 'M', 'ն'), + (0x547, 'M', 'շ'), + (0x548, 'M', 'ո'), + (0x549, 'M', 'չ'), + (0x54A, 'M', 'պ'), + (0x54B, 'M', 'ջ'), + (0x54C, 'M', 'ռ'), + (0x54D, 'M', 'ս'), + (0x54E, 'M', 'վ'), + (0x54F, 'M', 'տ'), + (0x550, 'M', 'ր'), + (0x551, 'M', 'ց'), + (0x552, 'M', 'ւ'), + (0x553, 'M', 'փ'), + (0x554, 'M', 'ք'), + (0x555, 'M', 'օ'), + (0x556, 'M', 'ֆ'), + (0x557, 'X'), + (0x559, 'V'), + (0x587, 'M', 'եւ'), + (0x588, 'V'), + (0x58B, 'X'), + (0x58D, 'V'), + (0x590, 'X'), + (0x591, 'V'), + (0x5C8, 'X'), + (0x5D0, 'V'), + (0x5EB, 'X'), + (0x5EF, 'V'), + (0x5F5, 'X'), + (0x606, 'V'), + (0x61C, 'X'), + (0x61D, 'V'), + ] + +def _seg_10() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x675, 'M', 'اٴ'), + (0x676, 'M', 'وٴ'), + (0x677, 'M', 'ۇٴ'), + (0x678, 'M', 'يٴ'), + (0x679, 'V'), + (0x6DD, 'X'), + (0x6DE, 'V'), + (0x70E, 'X'), + (0x710, 'V'), + (0x74B, 'X'), + (0x74D, 'V'), + (0x7B2, 'X'), + (0x7C0, 'V'), + (0x7FB, 'X'), + (0x7FD, 'V'), + (0x82E, 'X'), + (0x830, 'V'), + (0x83F, 'X'), + (0x840, 'V'), + (0x85C, 'X'), + (0x85E, 'V'), + (0x85F, 'X'), + (0x860, 'V'), + (0x86B, 'X'), + (0x870, 'V'), + (0x88F, 'X'), + (0x898, 'V'), + (0x8E2, 'X'), + (0x8E3, 'V'), + (0x958, 'M', 'क़'), + (0x959, 'M', 'ख़'), + (0x95A, 'M', 'ग़'), + (0x95B, 'M', 'ज़'), + (0x95C, 'M', 'ड़'), + (0x95D, 'M', 'ढ़'), + (0x95E, 'M', 'फ़'), + (0x95F, 'M', 'य़'), + (0x960, 'V'), + (0x984, 'X'), + (0x985, 'V'), + (0x98D, 'X'), + (0x98F, 'V'), + (0x991, 'X'), + (0x993, 'V'), + (0x9A9, 'X'), + (0x9AA, 'V'), + (0x9B1, 'X'), + (0x9B2, 'V'), + (0x9B3, 'X'), + (0x9B6, 'V'), + (0x9BA, 'X'), + (0x9BC, 'V'), + (0x9C5, 'X'), + (0x9C7, 'V'), + (0x9C9, 'X'), + (0x9CB, 'V'), + (0x9CF, 'X'), + (0x9D7, 'V'), + (0x9D8, 'X'), + (0x9DC, 'M', 'ড়'), + (0x9DD, 'M', 'ঢ়'), + (0x9DE, 'X'), + (0x9DF, 'M', 'য়'), + (0x9E0, 'V'), + (0x9E4, 'X'), + (0x9E6, 'V'), + (0x9FF, 'X'), + (0xA01, 'V'), + (0xA04, 'X'), + (0xA05, 'V'), + (0xA0B, 'X'), + (0xA0F, 'V'), + (0xA11, 'X'), + (0xA13, 'V'), + (0xA29, 'X'), + (0xA2A, 'V'), + (0xA31, 'X'), + (0xA32, 'V'), + (0xA33, 'M', 'ਲ਼'), + (0xA34, 'X'), + (0xA35, 'V'), + (0xA36, 'M', 'ਸ਼'), + (0xA37, 'X'), + (0xA38, 'V'), + (0xA3A, 'X'), + (0xA3C, 'V'), + (0xA3D, 'X'), + (0xA3E, 'V'), + (0xA43, 'X'), + (0xA47, 'V'), + (0xA49, 'X'), + (0xA4B, 'V'), + (0xA4E, 'X'), + (0xA51, 'V'), + (0xA52, 'X'), + (0xA59, 'M', 'ਖ਼'), + (0xA5A, 'M', 'ਗ਼'), + (0xA5B, 'M', 'ਜ਼'), + (0xA5C, 'V'), + (0xA5D, 'X'), + ] + +def _seg_11() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xA5E, 'M', 'ਫ਼'), + (0xA5F, 'X'), + (0xA66, 'V'), + (0xA77, 'X'), + (0xA81, 'V'), + (0xA84, 'X'), + (0xA85, 'V'), + (0xA8E, 'X'), + (0xA8F, 'V'), + (0xA92, 'X'), + (0xA93, 'V'), + (0xAA9, 'X'), + (0xAAA, 'V'), + (0xAB1, 'X'), + (0xAB2, 'V'), + (0xAB4, 'X'), + (0xAB5, 'V'), + (0xABA, 'X'), + (0xABC, 'V'), + (0xAC6, 'X'), + (0xAC7, 'V'), + (0xACA, 'X'), + (0xACB, 'V'), + (0xACE, 'X'), + (0xAD0, 'V'), + (0xAD1, 'X'), + (0xAE0, 'V'), + (0xAE4, 'X'), + (0xAE6, 'V'), + (0xAF2, 'X'), + (0xAF9, 'V'), + (0xB00, 'X'), + (0xB01, 'V'), + (0xB04, 'X'), + (0xB05, 'V'), + (0xB0D, 'X'), + (0xB0F, 'V'), + (0xB11, 'X'), + (0xB13, 'V'), + (0xB29, 'X'), + (0xB2A, 'V'), + (0xB31, 'X'), + (0xB32, 'V'), + (0xB34, 'X'), + (0xB35, 'V'), + (0xB3A, 'X'), + (0xB3C, 'V'), + (0xB45, 'X'), + (0xB47, 'V'), + (0xB49, 'X'), + (0xB4B, 'V'), + (0xB4E, 'X'), + (0xB55, 'V'), + (0xB58, 'X'), + (0xB5C, 'M', 'ଡ଼'), + (0xB5D, 'M', 'ଢ଼'), + (0xB5E, 'X'), + (0xB5F, 'V'), + (0xB64, 'X'), + (0xB66, 'V'), + (0xB78, 'X'), + (0xB82, 'V'), + (0xB84, 'X'), + (0xB85, 'V'), + (0xB8B, 'X'), + (0xB8E, 'V'), + (0xB91, 'X'), + (0xB92, 'V'), + (0xB96, 'X'), + (0xB99, 'V'), + (0xB9B, 'X'), + (0xB9C, 'V'), + (0xB9D, 'X'), + (0xB9E, 'V'), + (0xBA0, 'X'), + (0xBA3, 'V'), + (0xBA5, 'X'), + (0xBA8, 'V'), + (0xBAB, 'X'), + (0xBAE, 'V'), + (0xBBA, 'X'), + (0xBBE, 'V'), + (0xBC3, 'X'), + (0xBC6, 'V'), + (0xBC9, 'X'), + (0xBCA, 'V'), + (0xBCE, 'X'), + (0xBD0, 'V'), + (0xBD1, 'X'), + (0xBD7, 'V'), + (0xBD8, 'X'), + (0xBE6, 'V'), + (0xBFB, 'X'), + (0xC00, 'V'), + (0xC0D, 'X'), + (0xC0E, 'V'), + (0xC11, 'X'), + (0xC12, 'V'), + (0xC29, 'X'), + (0xC2A, 'V'), + ] + +def _seg_12() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xC3A, 'X'), + (0xC3C, 'V'), + (0xC45, 'X'), + (0xC46, 'V'), + (0xC49, 'X'), + (0xC4A, 'V'), + (0xC4E, 'X'), + (0xC55, 'V'), + (0xC57, 'X'), + (0xC58, 'V'), + (0xC5B, 'X'), + (0xC5D, 'V'), + (0xC5E, 'X'), + (0xC60, 'V'), + (0xC64, 'X'), + (0xC66, 'V'), + (0xC70, 'X'), + (0xC77, 'V'), + (0xC8D, 'X'), + (0xC8E, 'V'), + (0xC91, 'X'), + (0xC92, 'V'), + (0xCA9, 'X'), + (0xCAA, 'V'), + (0xCB4, 'X'), + (0xCB5, 'V'), + (0xCBA, 'X'), + (0xCBC, 'V'), + (0xCC5, 'X'), + (0xCC6, 'V'), + (0xCC9, 'X'), + (0xCCA, 'V'), + (0xCCE, 'X'), + (0xCD5, 'V'), + (0xCD7, 'X'), + (0xCDD, 'V'), + (0xCDF, 'X'), + (0xCE0, 'V'), + (0xCE4, 'X'), + (0xCE6, 'V'), + (0xCF0, 'X'), + (0xCF1, 'V'), + (0xCF4, 'X'), + (0xD00, 'V'), + (0xD0D, 'X'), + (0xD0E, 'V'), + (0xD11, 'X'), + (0xD12, 'V'), + (0xD45, 'X'), + (0xD46, 'V'), + (0xD49, 'X'), + (0xD4A, 'V'), + (0xD50, 'X'), + (0xD54, 'V'), + (0xD64, 'X'), + (0xD66, 'V'), + (0xD80, 'X'), + (0xD81, 'V'), + (0xD84, 'X'), + (0xD85, 'V'), + (0xD97, 'X'), + (0xD9A, 'V'), + (0xDB2, 'X'), + (0xDB3, 'V'), + (0xDBC, 'X'), + (0xDBD, 'V'), + (0xDBE, 'X'), + (0xDC0, 'V'), + (0xDC7, 'X'), + (0xDCA, 'V'), + (0xDCB, 'X'), + (0xDCF, 'V'), + (0xDD5, 'X'), + (0xDD6, 'V'), + (0xDD7, 'X'), + (0xDD8, 'V'), + (0xDE0, 'X'), + (0xDE6, 'V'), + (0xDF0, 'X'), + (0xDF2, 'V'), + (0xDF5, 'X'), + (0xE01, 'V'), + (0xE33, 'M', 'ํา'), + (0xE34, 'V'), + (0xE3B, 'X'), + (0xE3F, 'V'), + (0xE5C, 'X'), + (0xE81, 'V'), + (0xE83, 'X'), + (0xE84, 'V'), + (0xE85, 'X'), + (0xE86, 'V'), + (0xE8B, 'X'), + (0xE8C, 'V'), + (0xEA4, 'X'), + (0xEA5, 'V'), + (0xEA6, 'X'), + (0xEA7, 'V'), + (0xEB3, 'M', 'ໍາ'), + (0xEB4, 'V'), + ] + +def _seg_13() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xEBE, 'X'), + (0xEC0, 'V'), + (0xEC5, 'X'), + (0xEC6, 'V'), + (0xEC7, 'X'), + (0xEC8, 'V'), + (0xECF, 'X'), + (0xED0, 'V'), + (0xEDA, 'X'), + (0xEDC, 'M', 'ຫນ'), + (0xEDD, 'M', 'ຫມ'), + (0xEDE, 'V'), + (0xEE0, 'X'), + (0xF00, 'V'), + (0xF0C, 'M', '་'), + (0xF0D, 'V'), + (0xF43, 'M', 'གྷ'), + (0xF44, 'V'), + (0xF48, 'X'), + (0xF49, 'V'), + (0xF4D, 'M', 'ཌྷ'), + (0xF4E, 'V'), + (0xF52, 'M', 'དྷ'), + (0xF53, 'V'), + (0xF57, 'M', 'བྷ'), + (0xF58, 'V'), + (0xF5C, 'M', 'ཛྷ'), + (0xF5D, 'V'), + (0xF69, 'M', 'ཀྵ'), + (0xF6A, 'V'), + (0xF6D, 'X'), + (0xF71, 'V'), + (0xF73, 'M', 'ཱི'), + (0xF74, 'V'), + (0xF75, 'M', 'ཱུ'), + (0xF76, 'M', 'ྲྀ'), + (0xF77, 'M', 'ྲཱྀ'), + (0xF78, 'M', 'ླྀ'), + (0xF79, 'M', 'ླཱྀ'), + (0xF7A, 'V'), + (0xF81, 'M', 'ཱྀ'), + (0xF82, 'V'), + (0xF93, 'M', 'ྒྷ'), + (0xF94, 'V'), + (0xF98, 'X'), + (0xF99, 'V'), + (0xF9D, 'M', 'ྜྷ'), + (0xF9E, 'V'), + (0xFA2, 'M', 'ྡྷ'), + (0xFA3, 'V'), + (0xFA7, 'M', 'ྦྷ'), + (0xFA8, 'V'), + (0xFAC, 'M', 'ྫྷ'), + (0xFAD, 'V'), + (0xFB9, 'M', 'ྐྵ'), + (0xFBA, 'V'), + (0xFBD, 'X'), + (0xFBE, 'V'), + (0xFCD, 'X'), + (0xFCE, 'V'), + (0xFDB, 'X'), + (0x1000, 'V'), + (0x10A0, 'X'), + (0x10C7, 'M', 'ⴧ'), + (0x10C8, 'X'), + (0x10CD, 'M', 'ⴭ'), + (0x10CE, 'X'), + (0x10D0, 'V'), + (0x10FC, 'M', 'ნ'), + (0x10FD, 'V'), + (0x115F, 'X'), + (0x1161, 'V'), + (0x1249, 'X'), + (0x124A, 'V'), + (0x124E, 'X'), + (0x1250, 'V'), + (0x1257, 'X'), + (0x1258, 'V'), + (0x1259, 'X'), + (0x125A, 'V'), + (0x125E, 'X'), + (0x1260, 'V'), + (0x1289, 'X'), + (0x128A, 'V'), + (0x128E, 'X'), + (0x1290, 'V'), + (0x12B1, 'X'), + (0x12B2, 'V'), + (0x12B6, 'X'), + (0x12B8, 'V'), + (0x12BF, 'X'), + (0x12C0, 'V'), + (0x12C1, 'X'), + (0x12C2, 'V'), + (0x12C6, 'X'), + (0x12C8, 'V'), + (0x12D7, 'X'), + (0x12D8, 'V'), + (0x1311, 'X'), + (0x1312, 'V'), + ] + +def _seg_14() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1316, 'X'), + (0x1318, 'V'), + (0x135B, 'X'), + (0x135D, 'V'), + (0x137D, 'X'), + (0x1380, 'V'), + (0x139A, 'X'), + (0x13A0, 'V'), + (0x13F6, 'X'), + (0x13F8, 'M', 'Ᏸ'), + (0x13F9, 'M', 'Ᏹ'), + (0x13FA, 'M', 'Ᏺ'), + (0x13FB, 'M', 'Ᏻ'), + (0x13FC, 'M', 'Ᏼ'), + (0x13FD, 'M', 'Ᏽ'), + (0x13FE, 'X'), + (0x1400, 'V'), + (0x1680, 'X'), + (0x1681, 'V'), + (0x169D, 'X'), + (0x16A0, 'V'), + (0x16F9, 'X'), + (0x1700, 'V'), + (0x1716, 'X'), + (0x171F, 'V'), + (0x1737, 'X'), + (0x1740, 'V'), + (0x1754, 'X'), + (0x1760, 'V'), + (0x176D, 'X'), + (0x176E, 'V'), + (0x1771, 'X'), + (0x1772, 'V'), + (0x1774, 'X'), + (0x1780, 'V'), + (0x17B4, 'X'), + (0x17B6, 'V'), + (0x17DE, 'X'), + (0x17E0, 'V'), + (0x17EA, 'X'), + (0x17F0, 'V'), + (0x17FA, 'X'), + (0x1800, 'V'), + (0x1806, 'X'), + (0x1807, 'V'), + (0x180B, 'I'), + (0x180E, 'X'), + (0x180F, 'I'), + (0x1810, 'V'), + (0x181A, 'X'), + (0x1820, 'V'), + (0x1879, 'X'), + (0x1880, 'V'), + (0x18AB, 'X'), + (0x18B0, 'V'), + (0x18F6, 'X'), + (0x1900, 'V'), + (0x191F, 'X'), + (0x1920, 'V'), + (0x192C, 'X'), + (0x1930, 'V'), + (0x193C, 'X'), + (0x1940, 'V'), + (0x1941, 'X'), + (0x1944, 'V'), + (0x196E, 'X'), + (0x1970, 'V'), + (0x1975, 'X'), + (0x1980, 'V'), + (0x19AC, 'X'), + (0x19B0, 'V'), + (0x19CA, 'X'), + (0x19D0, 'V'), + (0x19DB, 'X'), + (0x19DE, 'V'), + (0x1A1C, 'X'), + (0x1A1E, 'V'), + (0x1A5F, 'X'), + (0x1A60, 'V'), + (0x1A7D, 'X'), + (0x1A7F, 'V'), + (0x1A8A, 'X'), + (0x1A90, 'V'), + (0x1A9A, 'X'), + (0x1AA0, 'V'), + (0x1AAE, 'X'), + (0x1AB0, 'V'), + (0x1ACF, 'X'), + (0x1B00, 'V'), + (0x1B4D, 'X'), + (0x1B50, 'V'), + (0x1B7F, 'X'), + (0x1B80, 'V'), + (0x1BF4, 'X'), + (0x1BFC, 'V'), + (0x1C38, 'X'), + (0x1C3B, 'V'), + (0x1C4A, 'X'), + (0x1C4D, 'V'), + (0x1C80, 'M', 'в'), + ] + +def _seg_15() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1C81, 'M', 'д'), + (0x1C82, 'M', 'о'), + (0x1C83, 'M', 'с'), + (0x1C84, 'M', 'т'), + (0x1C86, 'M', 'ъ'), + (0x1C87, 'M', 'ѣ'), + (0x1C88, 'M', 'ꙋ'), + (0x1C89, 'X'), + (0x1C90, 'M', 'ა'), + (0x1C91, 'M', 'ბ'), + (0x1C92, 'M', 'გ'), + (0x1C93, 'M', 'დ'), + (0x1C94, 'M', 'ე'), + (0x1C95, 'M', 'ვ'), + (0x1C96, 'M', 'ზ'), + (0x1C97, 'M', 'თ'), + (0x1C98, 'M', 'ი'), + (0x1C99, 'M', 'კ'), + (0x1C9A, 'M', 'ლ'), + (0x1C9B, 'M', 'მ'), + (0x1C9C, 'M', 'ნ'), + (0x1C9D, 'M', 'ო'), + (0x1C9E, 'M', 'პ'), + (0x1C9F, 'M', 'ჟ'), + (0x1CA0, 'M', 'რ'), + (0x1CA1, 'M', 'ს'), + (0x1CA2, 'M', 'ტ'), + (0x1CA3, 'M', 'უ'), + (0x1CA4, 'M', 'ფ'), + (0x1CA5, 'M', 'ქ'), + (0x1CA6, 'M', 'ღ'), + (0x1CA7, 'M', 'ყ'), + (0x1CA8, 'M', 'შ'), + (0x1CA9, 'M', 'ჩ'), + (0x1CAA, 'M', 'ც'), + (0x1CAB, 'M', 'ძ'), + (0x1CAC, 'M', 'წ'), + (0x1CAD, 'M', 'ჭ'), + (0x1CAE, 'M', 'ხ'), + (0x1CAF, 'M', 'ჯ'), + (0x1CB0, 'M', 'ჰ'), + (0x1CB1, 'M', 'ჱ'), + (0x1CB2, 'M', 'ჲ'), + (0x1CB3, 'M', 'ჳ'), + (0x1CB4, 'M', 'ჴ'), + (0x1CB5, 'M', 'ჵ'), + (0x1CB6, 'M', 'ჶ'), + (0x1CB7, 'M', 'ჷ'), + (0x1CB8, 'M', 'ჸ'), + (0x1CB9, 'M', 'ჹ'), + (0x1CBA, 'M', 'ჺ'), + (0x1CBB, 'X'), + (0x1CBD, 'M', 'ჽ'), + (0x1CBE, 'M', 'ჾ'), + (0x1CBF, 'M', 'ჿ'), + (0x1CC0, 'V'), + (0x1CC8, 'X'), + (0x1CD0, 'V'), + (0x1CFB, 'X'), + (0x1D00, 'V'), + (0x1D2C, 'M', 'a'), + (0x1D2D, 'M', 'æ'), + (0x1D2E, 'M', 'b'), + (0x1D2F, 'V'), + (0x1D30, 'M', 'd'), + (0x1D31, 'M', 'e'), + (0x1D32, 'M', 'ǝ'), + (0x1D33, 'M', 'g'), + (0x1D34, 'M', 'h'), + (0x1D35, 'M', 'i'), + (0x1D36, 'M', 'j'), + (0x1D37, 'M', 'k'), + (0x1D38, 'M', 'l'), + (0x1D39, 'M', 'm'), + (0x1D3A, 'M', 'n'), + (0x1D3B, 'V'), + (0x1D3C, 'M', 'o'), + (0x1D3D, 'M', 'ȣ'), + (0x1D3E, 'M', 'p'), + (0x1D3F, 'M', 'r'), + (0x1D40, 'M', 't'), + (0x1D41, 'M', 'u'), + (0x1D42, 'M', 'w'), + (0x1D43, 'M', 'a'), + (0x1D44, 'M', 'ɐ'), + (0x1D45, 'M', 'ɑ'), + (0x1D46, 'M', 'ᴂ'), + (0x1D47, 'M', 'b'), + (0x1D48, 'M', 'd'), + (0x1D49, 'M', 'e'), + (0x1D4A, 'M', 'ə'), + (0x1D4B, 'M', 'ɛ'), + (0x1D4C, 'M', 'ɜ'), + (0x1D4D, 'M', 'g'), + (0x1D4E, 'V'), + (0x1D4F, 'M', 'k'), + (0x1D50, 'M', 'm'), + (0x1D51, 'M', 'ŋ'), + (0x1D52, 'M', 'o'), + (0x1D53, 'M', 'ɔ'), + ] + +def _seg_16() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1D54, 'M', 'ᴖ'), + (0x1D55, 'M', 'ᴗ'), + (0x1D56, 'M', 'p'), + (0x1D57, 'M', 't'), + (0x1D58, 'M', 'u'), + (0x1D59, 'M', 'ᴝ'), + (0x1D5A, 'M', 'ɯ'), + (0x1D5B, 'M', 'v'), + (0x1D5C, 'M', 'ᴥ'), + (0x1D5D, 'M', 'β'), + (0x1D5E, 'M', 'γ'), + (0x1D5F, 'M', 'δ'), + (0x1D60, 'M', 'φ'), + (0x1D61, 'M', 'χ'), + (0x1D62, 'M', 'i'), + (0x1D63, 'M', 'r'), + (0x1D64, 'M', 'u'), + (0x1D65, 'M', 'v'), + (0x1D66, 'M', 'β'), + (0x1D67, 'M', 'γ'), + (0x1D68, 'M', 'ρ'), + (0x1D69, 'M', 'φ'), + (0x1D6A, 'M', 'χ'), + (0x1D6B, 'V'), + (0x1D78, 'M', 'н'), + (0x1D79, 'V'), + (0x1D9B, 'M', 'ɒ'), + (0x1D9C, 'M', 'c'), + (0x1D9D, 'M', 'ɕ'), + (0x1D9E, 'M', 'ð'), + (0x1D9F, 'M', 'ɜ'), + (0x1DA0, 'M', 'f'), + (0x1DA1, 'M', 'ɟ'), + (0x1DA2, 'M', 'ɡ'), + (0x1DA3, 'M', 'ɥ'), + (0x1DA4, 'M', 'ɨ'), + (0x1DA5, 'M', 'ɩ'), + (0x1DA6, 'M', 'ɪ'), + (0x1DA7, 'M', 'ᵻ'), + (0x1DA8, 'M', 'ʝ'), + (0x1DA9, 'M', 'ɭ'), + (0x1DAA, 'M', 'ᶅ'), + (0x1DAB, 'M', 'ʟ'), + (0x1DAC, 'M', 'ɱ'), + (0x1DAD, 'M', 'ɰ'), + (0x1DAE, 'M', 'ɲ'), + (0x1DAF, 'M', 'ɳ'), + (0x1DB0, 'M', 'ɴ'), + (0x1DB1, 'M', 'ɵ'), + (0x1DB2, 'M', 'ɸ'), + (0x1DB3, 'M', 'ʂ'), + (0x1DB4, 'M', 'ʃ'), + (0x1DB5, 'M', 'ƫ'), + (0x1DB6, 'M', 'ʉ'), + (0x1DB7, 'M', 'ʊ'), + (0x1DB8, 'M', 'ᴜ'), + (0x1DB9, 'M', 'ʋ'), + (0x1DBA, 'M', 'ʌ'), + (0x1DBB, 'M', 'z'), + (0x1DBC, 'M', 'ʐ'), + (0x1DBD, 'M', 'ʑ'), + (0x1DBE, 'M', 'ʒ'), + (0x1DBF, 'M', 'θ'), + (0x1DC0, 'V'), + (0x1E00, 'M', 'ḁ'), + (0x1E01, 'V'), + (0x1E02, 'M', 'ḃ'), + (0x1E03, 'V'), + (0x1E04, 'M', 'ḅ'), + (0x1E05, 'V'), + (0x1E06, 'M', 'ḇ'), + (0x1E07, 'V'), + (0x1E08, 'M', 'ḉ'), + (0x1E09, 'V'), + (0x1E0A, 'M', 'ḋ'), + (0x1E0B, 'V'), + (0x1E0C, 'M', 'ḍ'), + (0x1E0D, 'V'), + (0x1E0E, 'M', 'ḏ'), + (0x1E0F, 'V'), + (0x1E10, 'M', 'ḑ'), + (0x1E11, 'V'), + (0x1E12, 'M', 'ḓ'), + (0x1E13, 'V'), + (0x1E14, 'M', 'ḕ'), + (0x1E15, 'V'), + (0x1E16, 'M', 'ḗ'), + (0x1E17, 'V'), + (0x1E18, 'M', 'ḙ'), + (0x1E19, 'V'), + (0x1E1A, 'M', 'ḛ'), + (0x1E1B, 'V'), + (0x1E1C, 'M', 'ḝ'), + (0x1E1D, 'V'), + (0x1E1E, 'M', 'ḟ'), + (0x1E1F, 'V'), + (0x1E20, 'M', 'ḡ'), + (0x1E21, 'V'), + (0x1E22, 'M', 'ḣ'), + (0x1E23, 'V'), + ] + +def _seg_17() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1E24, 'M', 'ḥ'), + (0x1E25, 'V'), + (0x1E26, 'M', 'ḧ'), + (0x1E27, 'V'), + (0x1E28, 'M', 'ḩ'), + (0x1E29, 'V'), + (0x1E2A, 'M', 'ḫ'), + (0x1E2B, 'V'), + (0x1E2C, 'M', 'ḭ'), + (0x1E2D, 'V'), + (0x1E2E, 'M', 'ḯ'), + (0x1E2F, 'V'), + (0x1E30, 'M', 'ḱ'), + (0x1E31, 'V'), + (0x1E32, 'M', 'ḳ'), + (0x1E33, 'V'), + (0x1E34, 'M', 'ḵ'), + (0x1E35, 'V'), + (0x1E36, 'M', 'ḷ'), + (0x1E37, 'V'), + (0x1E38, 'M', 'ḹ'), + (0x1E39, 'V'), + (0x1E3A, 'M', 'ḻ'), + (0x1E3B, 'V'), + (0x1E3C, 'M', 'ḽ'), + (0x1E3D, 'V'), + (0x1E3E, 'M', 'ḿ'), + (0x1E3F, 'V'), + (0x1E40, 'M', 'ṁ'), + (0x1E41, 'V'), + (0x1E42, 'M', 'ṃ'), + (0x1E43, 'V'), + (0x1E44, 'M', 'ṅ'), + (0x1E45, 'V'), + (0x1E46, 'M', 'ṇ'), + (0x1E47, 'V'), + (0x1E48, 'M', 'ṉ'), + (0x1E49, 'V'), + (0x1E4A, 'M', 'ṋ'), + (0x1E4B, 'V'), + (0x1E4C, 'M', 'ṍ'), + (0x1E4D, 'V'), + (0x1E4E, 'M', 'ṏ'), + (0x1E4F, 'V'), + (0x1E50, 'M', 'ṑ'), + (0x1E51, 'V'), + (0x1E52, 'M', 'ṓ'), + (0x1E53, 'V'), + (0x1E54, 'M', 'ṕ'), + (0x1E55, 'V'), + (0x1E56, 'M', 'ṗ'), + (0x1E57, 'V'), + (0x1E58, 'M', 'ṙ'), + (0x1E59, 'V'), + (0x1E5A, 'M', 'ṛ'), + (0x1E5B, 'V'), + (0x1E5C, 'M', 'ṝ'), + (0x1E5D, 'V'), + (0x1E5E, 'M', 'ṟ'), + (0x1E5F, 'V'), + (0x1E60, 'M', 'ṡ'), + (0x1E61, 'V'), + (0x1E62, 'M', 'ṣ'), + (0x1E63, 'V'), + (0x1E64, 'M', 'ṥ'), + (0x1E65, 'V'), + (0x1E66, 'M', 'ṧ'), + (0x1E67, 'V'), + (0x1E68, 'M', 'ṩ'), + (0x1E69, 'V'), + (0x1E6A, 'M', 'ṫ'), + (0x1E6B, 'V'), + (0x1E6C, 'M', 'ṭ'), + (0x1E6D, 'V'), + (0x1E6E, 'M', 'ṯ'), + (0x1E6F, 'V'), + (0x1E70, 'M', 'ṱ'), + (0x1E71, 'V'), + (0x1E72, 'M', 'ṳ'), + (0x1E73, 'V'), + (0x1E74, 'M', 'ṵ'), + (0x1E75, 'V'), + (0x1E76, 'M', 'ṷ'), + (0x1E77, 'V'), + (0x1E78, 'M', 'ṹ'), + (0x1E79, 'V'), + (0x1E7A, 'M', 'ṻ'), + (0x1E7B, 'V'), + (0x1E7C, 'M', 'ṽ'), + (0x1E7D, 'V'), + (0x1E7E, 'M', 'ṿ'), + (0x1E7F, 'V'), + (0x1E80, 'M', 'ẁ'), + (0x1E81, 'V'), + (0x1E82, 'M', 'ẃ'), + (0x1E83, 'V'), + (0x1E84, 'M', 'ẅ'), + (0x1E85, 'V'), + (0x1E86, 'M', 'ẇ'), + (0x1E87, 'V'), + ] + +def _seg_18() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1E88, 'M', 'ẉ'), + (0x1E89, 'V'), + (0x1E8A, 'M', 'ẋ'), + (0x1E8B, 'V'), + (0x1E8C, 'M', 'ẍ'), + (0x1E8D, 'V'), + (0x1E8E, 'M', 'ẏ'), + (0x1E8F, 'V'), + (0x1E90, 'M', 'ẑ'), + (0x1E91, 'V'), + (0x1E92, 'M', 'ẓ'), + (0x1E93, 'V'), + (0x1E94, 'M', 'ẕ'), + (0x1E95, 'V'), + (0x1E9A, 'M', 'aʾ'), + (0x1E9B, 'M', 'ṡ'), + (0x1E9C, 'V'), + (0x1E9E, 'M', 'ß'), + (0x1E9F, 'V'), + (0x1EA0, 'M', 'ạ'), + (0x1EA1, 'V'), + (0x1EA2, 'M', 'ả'), + (0x1EA3, 'V'), + (0x1EA4, 'M', 'ấ'), + (0x1EA5, 'V'), + (0x1EA6, 'M', 'ầ'), + (0x1EA7, 'V'), + (0x1EA8, 'M', 'ẩ'), + (0x1EA9, 'V'), + (0x1EAA, 'M', 'ẫ'), + (0x1EAB, 'V'), + (0x1EAC, 'M', 'ậ'), + (0x1EAD, 'V'), + (0x1EAE, 'M', 'ắ'), + (0x1EAF, 'V'), + (0x1EB0, 'M', 'ằ'), + (0x1EB1, 'V'), + (0x1EB2, 'M', 'ẳ'), + (0x1EB3, 'V'), + (0x1EB4, 'M', 'ẵ'), + (0x1EB5, 'V'), + (0x1EB6, 'M', 'ặ'), + (0x1EB7, 'V'), + (0x1EB8, 'M', 'ẹ'), + (0x1EB9, 'V'), + (0x1EBA, 'M', 'ẻ'), + (0x1EBB, 'V'), + (0x1EBC, 'M', 'ẽ'), + (0x1EBD, 'V'), + (0x1EBE, 'M', 'ế'), + (0x1EBF, 'V'), + (0x1EC0, 'M', 'ề'), + (0x1EC1, 'V'), + (0x1EC2, 'M', 'ể'), + (0x1EC3, 'V'), + (0x1EC4, 'M', 'ễ'), + (0x1EC5, 'V'), + (0x1EC6, 'M', 'ệ'), + (0x1EC7, 'V'), + (0x1EC8, 'M', 'ỉ'), + (0x1EC9, 'V'), + (0x1ECA, 'M', 'ị'), + (0x1ECB, 'V'), + (0x1ECC, 'M', 'ọ'), + (0x1ECD, 'V'), + (0x1ECE, 'M', 'ỏ'), + (0x1ECF, 'V'), + (0x1ED0, 'M', 'ố'), + (0x1ED1, 'V'), + (0x1ED2, 'M', 'ồ'), + (0x1ED3, 'V'), + (0x1ED4, 'M', 'ổ'), + (0x1ED5, 'V'), + (0x1ED6, 'M', 'ỗ'), + (0x1ED7, 'V'), + (0x1ED8, 'M', 'ộ'), + (0x1ED9, 'V'), + (0x1EDA, 'M', 'ớ'), + (0x1EDB, 'V'), + (0x1EDC, 'M', 'ờ'), + (0x1EDD, 'V'), + (0x1EDE, 'M', 'ở'), + (0x1EDF, 'V'), + (0x1EE0, 'M', 'ỡ'), + (0x1EE1, 'V'), + (0x1EE2, 'M', 'ợ'), + (0x1EE3, 'V'), + (0x1EE4, 'M', 'ụ'), + (0x1EE5, 'V'), + (0x1EE6, 'M', 'ủ'), + (0x1EE7, 'V'), + (0x1EE8, 'M', 'ứ'), + (0x1EE9, 'V'), + (0x1EEA, 'M', 'ừ'), + (0x1EEB, 'V'), + (0x1EEC, 'M', 'ử'), + (0x1EED, 'V'), + (0x1EEE, 'M', 'ữ'), + (0x1EEF, 'V'), + (0x1EF0, 'M', 'ự'), + ] + +def _seg_19() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1EF1, 'V'), + (0x1EF2, 'M', 'ỳ'), + (0x1EF3, 'V'), + (0x1EF4, 'M', 'ỵ'), + (0x1EF5, 'V'), + (0x1EF6, 'M', 'ỷ'), + (0x1EF7, 'V'), + (0x1EF8, 'M', 'ỹ'), + (0x1EF9, 'V'), + (0x1EFA, 'M', 'ỻ'), + (0x1EFB, 'V'), + (0x1EFC, 'M', 'ỽ'), + (0x1EFD, 'V'), + (0x1EFE, 'M', 'ỿ'), + (0x1EFF, 'V'), + (0x1F08, 'M', 'ἀ'), + (0x1F09, 'M', 'ἁ'), + (0x1F0A, 'M', 'ἂ'), + (0x1F0B, 'M', 'ἃ'), + (0x1F0C, 'M', 'ἄ'), + (0x1F0D, 'M', 'ἅ'), + (0x1F0E, 'M', 'ἆ'), + (0x1F0F, 'M', 'ἇ'), + (0x1F10, 'V'), + (0x1F16, 'X'), + (0x1F18, 'M', 'ἐ'), + (0x1F19, 'M', 'ἑ'), + (0x1F1A, 'M', 'ἒ'), + (0x1F1B, 'M', 'ἓ'), + (0x1F1C, 'M', 'ἔ'), + (0x1F1D, 'M', 'ἕ'), + (0x1F1E, 'X'), + (0x1F20, 'V'), + (0x1F28, 'M', 'ἠ'), + (0x1F29, 'M', 'ἡ'), + (0x1F2A, 'M', 'ἢ'), + (0x1F2B, 'M', 'ἣ'), + (0x1F2C, 'M', 'ἤ'), + (0x1F2D, 'M', 'ἥ'), + (0x1F2E, 'M', 'ἦ'), + (0x1F2F, 'M', 'ἧ'), + (0x1F30, 'V'), + (0x1F38, 'M', 'ἰ'), + (0x1F39, 'M', 'ἱ'), + (0x1F3A, 'M', 'ἲ'), + (0x1F3B, 'M', 'ἳ'), + (0x1F3C, 'M', 'ἴ'), + (0x1F3D, 'M', 'ἵ'), + (0x1F3E, 'M', 'ἶ'), + (0x1F3F, 'M', 'ἷ'), + (0x1F40, 'V'), + (0x1F46, 'X'), + (0x1F48, 'M', 'ὀ'), + (0x1F49, 'M', 'ὁ'), + (0x1F4A, 'M', 'ὂ'), + (0x1F4B, 'M', 'ὃ'), + (0x1F4C, 'M', 'ὄ'), + (0x1F4D, 'M', 'ὅ'), + (0x1F4E, 'X'), + (0x1F50, 'V'), + (0x1F58, 'X'), + (0x1F59, 'M', 'ὑ'), + (0x1F5A, 'X'), + (0x1F5B, 'M', 'ὓ'), + (0x1F5C, 'X'), + (0x1F5D, 'M', 'ὕ'), + (0x1F5E, 'X'), + (0x1F5F, 'M', 'ὗ'), + (0x1F60, 'V'), + (0x1F68, 'M', 'ὠ'), + (0x1F69, 'M', 'ὡ'), + (0x1F6A, 'M', 'ὢ'), + (0x1F6B, 'M', 'ὣ'), + (0x1F6C, 'M', 'ὤ'), + (0x1F6D, 'M', 'ὥ'), + (0x1F6E, 'M', 'ὦ'), + (0x1F6F, 'M', 'ὧ'), + (0x1F70, 'V'), + (0x1F71, 'M', 'ά'), + (0x1F72, 'V'), + (0x1F73, 'M', 'έ'), + (0x1F74, 'V'), + (0x1F75, 'M', 'ή'), + (0x1F76, 'V'), + (0x1F77, 'M', 'ί'), + (0x1F78, 'V'), + (0x1F79, 'M', 'ό'), + (0x1F7A, 'V'), + (0x1F7B, 'M', 'ύ'), + (0x1F7C, 'V'), + (0x1F7D, 'M', 'ώ'), + (0x1F7E, 'X'), + (0x1F80, 'M', 'ἀι'), + (0x1F81, 'M', 'ἁι'), + (0x1F82, 'M', 'ἂι'), + (0x1F83, 'M', 'ἃι'), + (0x1F84, 'M', 'ἄι'), + (0x1F85, 'M', 'ἅι'), + (0x1F86, 'M', 'ἆι'), + (0x1F87, 'M', 'ἇι'), + ] + +def _seg_20() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1F88, 'M', 'ἀι'), + (0x1F89, 'M', 'ἁι'), + (0x1F8A, 'M', 'ἂι'), + (0x1F8B, 'M', 'ἃι'), + (0x1F8C, 'M', 'ἄι'), + (0x1F8D, 'M', 'ἅι'), + (0x1F8E, 'M', 'ἆι'), + (0x1F8F, 'M', 'ἇι'), + (0x1F90, 'M', 'ἠι'), + (0x1F91, 'M', 'ἡι'), + (0x1F92, 'M', 'ἢι'), + (0x1F93, 'M', 'ἣι'), + (0x1F94, 'M', 'ἤι'), + (0x1F95, 'M', 'ἥι'), + (0x1F96, 'M', 'ἦι'), + (0x1F97, 'M', 'ἧι'), + (0x1F98, 'M', 'ἠι'), + (0x1F99, 'M', 'ἡι'), + (0x1F9A, 'M', 'ἢι'), + (0x1F9B, 'M', 'ἣι'), + (0x1F9C, 'M', 'ἤι'), + (0x1F9D, 'M', 'ἥι'), + (0x1F9E, 'M', 'ἦι'), + (0x1F9F, 'M', 'ἧι'), + (0x1FA0, 'M', 'ὠι'), + (0x1FA1, 'M', 'ὡι'), + (0x1FA2, 'M', 'ὢι'), + (0x1FA3, 'M', 'ὣι'), + (0x1FA4, 'M', 'ὤι'), + (0x1FA5, 'M', 'ὥι'), + (0x1FA6, 'M', 'ὦι'), + (0x1FA7, 'M', 'ὧι'), + (0x1FA8, 'M', 'ὠι'), + (0x1FA9, 'M', 'ὡι'), + (0x1FAA, 'M', 'ὢι'), + (0x1FAB, 'M', 'ὣι'), + (0x1FAC, 'M', 'ὤι'), + (0x1FAD, 'M', 'ὥι'), + (0x1FAE, 'M', 'ὦι'), + (0x1FAF, 'M', 'ὧι'), + (0x1FB0, 'V'), + (0x1FB2, 'M', 'ὰι'), + (0x1FB3, 'M', 'αι'), + (0x1FB4, 'M', 'άι'), + (0x1FB5, 'X'), + (0x1FB6, 'V'), + (0x1FB7, 'M', 'ᾶι'), + (0x1FB8, 'M', 'ᾰ'), + (0x1FB9, 'M', 'ᾱ'), + (0x1FBA, 'M', 'ὰ'), + (0x1FBB, 'M', 'ά'), + (0x1FBC, 'M', 'αι'), + (0x1FBD, '3', ' ̓'), + (0x1FBE, 'M', 'ι'), + (0x1FBF, '3', ' ̓'), + (0x1FC0, '3', ' ͂'), + (0x1FC1, '3', ' ̈͂'), + (0x1FC2, 'M', 'ὴι'), + (0x1FC3, 'M', 'ηι'), + (0x1FC4, 'M', 'ήι'), + (0x1FC5, 'X'), + (0x1FC6, 'V'), + (0x1FC7, 'M', 'ῆι'), + (0x1FC8, 'M', 'ὲ'), + (0x1FC9, 'M', 'έ'), + (0x1FCA, 'M', 'ὴ'), + (0x1FCB, 'M', 'ή'), + (0x1FCC, 'M', 'ηι'), + (0x1FCD, '3', ' ̓̀'), + (0x1FCE, '3', ' ̓́'), + (0x1FCF, '3', ' ̓͂'), + (0x1FD0, 'V'), + (0x1FD3, 'M', 'ΐ'), + (0x1FD4, 'X'), + (0x1FD6, 'V'), + (0x1FD8, 'M', 'ῐ'), + (0x1FD9, 'M', 'ῑ'), + (0x1FDA, 'M', 'ὶ'), + (0x1FDB, 'M', 'ί'), + (0x1FDC, 'X'), + (0x1FDD, '3', ' ̔̀'), + (0x1FDE, '3', ' ̔́'), + (0x1FDF, '3', ' ̔͂'), + (0x1FE0, 'V'), + (0x1FE3, 'M', 'ΰ'), + (0x1FE4, 'V'), + (0x1FE8, 'M', 'ῠ'), + (0x1FE9, 'M', 'ῡ'), + (0x1FEA, 'M', 'ὺ'), + (0x1FEB, 'M', 'ύ'), + (0x1FEC, 'M', 'ῥ'), + (0x1FED, '3', ' ̈̀'), + (0x1FEE, '3', ' ̈́'), + (0x1FEF, '3', '`'), + (0x1FF0, 'X'), + (0x1FF2, 'M', 'ὼι'), + (0x1FF3, 'M', 'ωι'), + (0x1FF4, 'M', 'ώι'), + (0x1FF5, 'X'), + (0x1FF6, 'V'), + ] + +def _seg_21() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1FF7, 'M', 'ῶι'), + (0x1FF8, 'M', 'ὸ'), + (0x1FF9, 'M', 'ό'), + (0x1FFA, 'M', 'ὼ'), + (0x1FFB, 'M', 'ώ'), + (0x1FFC, 'M', 'ωι'), + (0x1FFD, '3', ' ́'), + (0x1FFE, '3', ' ̔'), + (0x1FFF, 'X'), + (0x2000, '3', ' '), + (0x200B, 'I'), + (0x200C, 'D', ''), + (0x200E, 'X'), + (0x2010, 'V'), + (0x2011, 'M', '‐'), + (0x2012, 'V'), + (0x2017, '3', ' ̳'), + (0x2018, 'V'), + (0x2024, 'X'), + (0x2027, 'V'), + (0x2028, 'X'), + (0x202F, '3', ' '), + (0x2030, 'V'), + (0x2033, 'M', '′′'), + (0x2034, 'M', '′′′'), + (0x2035, 'V'), + (0x2036, 'M', '‵‵'), + (0x2037, 'M', '‵‵‵'), + (0x2038, 'V'), + (0x203C, '3', '!!'), + (0x203D, 'V'), + (0x203E, '3', ' ̅'), + (0x203F, 'V'), + (0x2047, '3', '??'), + (0x2048, '3', '?!'), + (0x2049, '3', '!?'), + (0x204A, 'V'), + (0x2057, 'M', '′′′′'), + (0x2058, 'V'), + (0x205F, '3', ' '), + (0x2060, 'I'), + (0x2061, 'X'), + (0x2064, 'I'), + (0x2065, 'X'), + (0x2070, 'M', '0'), + (0x2071, 'M', 'i'), + (0x2072, 'X'), + (0x2074, 'M', '4'), + (0x2075, 'M', '5'), + (0x2076, 'M', '6'), + (0x2077, 'M', '7'), + (0x2078, 'M', '8'), + (0x2079, 'M', '9'), + (0x207A, '3', '+'), + (0x207B, 'M', '−'), + (0x207C, '3', '='), + (0x207D, '3', '('), + (0x207E, '3', ')'), + (0x207F, 'M', 'n'), + (0x2080, 'M', '0'), + (0x2081, 'M', '1'), + (0x2082, 'M', '2'), + (0x2083, 'M', '3'), + (0x2084, 'M', '4'), + (0x2085, 'M', '5'), + (0x2086, 'M', '6'), + (0x2087, 'M', '7'), + (0x2088, 'M', '8'), + (0x2089, 'M', '9'), + (0x208A, '3', '+'), + (0x208B, 'M', '−'), + (0x208C, '3', '='), + (0x208D, '3', '('), + (0x208E, '3', ')'), + (0x208F, 'X'), + (0x2090, 'M', 'a'), + (0x2091, 'M', 'e'), + (0x2092, 'M', 'o'), + (0x2093, 'M', 'x'), + (0x2094, 'M', 'ə'), + (0x2095, 'M', 'h'), + (0x2096, 'M', 'k'), + (0x2097, 'M', 'l'), + (0x2098, 'M', 'm'), + (0x2099, 'M', 'n'), + (0x209A, 'M', 'p'), + (0x209B, 'M', 's'), + (0x209C, 'M', 't'), + (0x209D, 'X'), + (0x20A0, 'V'), + (0x20A8, 'M', 'rs'), + (0x20A9, 'V'), + (0x20C1, 'X'), + (0x20D0, 'V'), + (0x20F1, 'X'), + (0x2100, '3', 'a/c'), + (0x2101, '3', 'a/s'), + (0x2102, 'M', 'c'), + (0x2103, 'M', '°c'), + (0x2104, 'V'), + ] + +def _seg_22() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x2105, '3', 'c/o'), + (0x2106, '3', 'c/u'), + (0x2107, 'M', 'ɛ'), + (0x2108, 'V'), + (0x2109, 'M', '°f'), + (0x210A, 'M', 'g'), + (0x210B, 'M', 'h'), + (0x210F, 'M', 'ħ'), + (0x2110, 'M', 'i'), + (0x2112, 'M', 'l'), + (0x2114, 'V'), + (0x2115, 'M', 'n'), + (0x2116, 'M', 'no'), + (0x2117, 'V'), + (0x2119, 'M', 'p'), + (0x211A, 'M', 'q'), + (0x211B, 'M', 'r'), + (0x211E, 'V'), + (0x2120, 'M', 'sm'), + (0x2121, 'M', 'tel'), + (0x2122, 'M', 'tm'), + (0x2123, 'V'), + (0x2124, 'M', 'z'), + (0x2125, 'V'), + (0x2126, 'M', 'ω'), + (0x2127, 'V'), + (0x2128, 'M', 'z'), + (0x2129, 'V'), + (0x212A, 'M', 'k'), + (0x212B, 'M', 'å'), + (0x212C, 'M', 'b'), + (0x212D, 'M', 'c'), + (0x212E, 'V'), + (0x212F, 'M', 'e'), + (0x2131, 'M', 'f'), + (0x2132, 'X'), + (0x2133, 'M', 'm'), + (0x2134, 'M', 'o'), + (0x2135, 'M', 'א'), + (0x2136, 'M', 'ב'), + (0x2137, 'M', 'ג'), + (0x2138, 'M', 'ד'), + (0x2139, 'M', 'i'), + (0x213A, 'V'), + (0x213B, 'M', 'fax'), + (0x213C, 'M', 'π'), + (0x213D, 'M', 'γ'), + (0x213F, 'M', 'π'), + (0x2140, 'M', '∑'), + (0x2141, 'V'), + (0x2145, 'M', 'd'), + (0x2147, 'M', 'e'), + (0x2148, 'M', 'i'), + (0x2149, 'M', 'j'), + (0x214A, 'V'), + (0x2150, 'M', '1⁄7'), + (0x2151, 'M', '1⁄9'), + (0x2152, 'M', '1⁄10'), + (0x2153, 'M', '1⁄3'), + (0x2154, 'M', '2⁄3'), + (0x2155, 'M', '1⁄5'), + (0x2156, 'M', '2⁄5'), + (0x2157, 'M', '3⁄5'), + (0x2158, 'M', '4⁄5'), + (0x2159, 'M', '1⁄6'), + (0x215A, 'M', '5⁄6'), + (0x215B, 'M', '1⁄8'), + (0x215C, 'M', '3⁄8'), + (0x215D, 'M', '5⁄8'), + (0x215E, 'M', '7⁄8'), + (0x215F, 'M', '1⁄'), + (0x2160, 'M', 'i'), + (0x2161, 'M', 'ii'), + (0x2162, 'M', 'iii'), + (0x2163, 'M', 'iv'), + (0x2164, 'M', 'v'), + (0x2165, 'M', 'vi'), + (0x2166, 'M', 'vii'), + (0x2167, 'M', 'viii'), + (0x2168, 'M', 'ix'), + (0x2169, 'M', 'x'), + (0x216A, 'M', 'xi'), + (0x216B, 'M', 'xii'), + (0x216C, 'M', 'l'), + (0x216D, 'M', 'c'), + (0x216E, 'M', 'd'), + (0x216F, 'M', 'm'), + (0x2170, 'M', 'i'), + (0x2171, 'M', 'ii'), + (0x2172, 'M', 'iii'), + (0x2173, 'M', 'iv'), + (0x2174, 'M', 'v'), + (0x2175, 'M', 'vi'), + (0x2176, 'M', 'vii'), + (0x2177, 'M', 'viii'), + (0x2178, 'M', 'ix'), + (0x2179, 'M', 'x'), + (0x217A, 'M', 'xi'), + (0x217B, 'M', 'xii'), + (0x217C, 'M', 'l'), + ] + +def _seg_23() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x217D, 'M', 'c'), + (0x217E, 'M', 'd'), + (0x217F, 'M', 'm'), + (0x2180, 'V'), + (0x2183, 'X'), + (0x2184, 'V'), + (0x2189, 'M', '0⁄3'), + (0x218A, 'V'), + (0x218C, 'X'), + (0x2190, 'V'), + (0x222C, 'M', '∫∫'), + (0x222D, 'M', '∫∫∫'), + (0x222E, 'V'), + (0x222F, 'M', '∮∮'), + (0x2230, 'M', '∮∮∮'), + (0x2231, 'V'), + (0x2329, 'M', '〈'), + (0x232A, 'M', '〉'), + (0x232B, 'V'), + (0x2427, 'X'), + (0x2440, 'V'), + (0x244B, 'X'), + (0x2460, 'M', '1'), + (0x2461, 'M', '2'), + (0x2462, 'M', '3'), + (0x2463, 'M', '4'), + (0x2464, 'M', '5'), + (0x2465, 'M', '6'), + (0x2466, 'M', '7'), + (0x2467, 'M', '8'), + (0x2468, 'M', '9'), + (0x2469, 'M', '10'), + (0x246A, 'M', '11'), + (0x246B, 'M', '12'), + (0x246C, 'M', '13'), + (0x246D, 'M', '14'), + (0x246E, 'M', '15'), + (0x246F, 'M', '16'), + (0x2470, 'M', '17'), + (0x2471, 'M', '18'), + (0x2472, 'M', '19'), + (0x2473, 'M', '20'), + (0x2474, '3', '(1)'), + (0x2475, '3', '(2)'), + (0x2476, '3', '(3)'), + (0x2477, '3', '(4)'), + (0x2478, '3', '(5)'), + (0x2479, '3', '(6)'), + (0x247A, '3', '(7)'), + (0x247B, '3', '(8)'), + (0x247C, '3', '(9)'), + (0x247D, '3', '(10)'), + (0x247E, '3', '(11)'), + (0x247F, '3', '(12)'), + (0x2480, '3', '(13)'), + (0x2481, '3', '(14)'), + (0x2482, '3', '(15)'), + (0x2483, '3', '(16)'), + (0x2484, '3', '(17)'), + (0x2485, '3', '(18)'), + (0x2486, '3', '(19)'), + (0x2487, '3', '(20)'), + (0x2488, 'X'), + (0x249C, '3', '(a)'), + (0x249D, '3', '(b)'), + (0x249E, '3', '(c)'), + (0x249F, '3', '(d)'), + (0x24A0, '3', '(e)'), + (0x24A1, '3', '(f)'), + (0x24A2, '3', '(g)'), + (0x24A3, '3', '(h)'), + (0x24A4, '3', '(i)'), + (0x24A5, '3', '(j)'), + (0x24A6, '3', '(k)'), + (0x24A7, '3', '(l)'), + (0x24A8, '3', '(m)'), + (0x24A9, '3', '(n)'), + (0x24AA, '3', '(o)'), + (0x24AB, '3', '(p)'), + (0x24AC, '3', '(q)'), + (0x24AD, '3', '(r)'), + (0x24AE, '3', '(s)'), + (0x24AF, '3', '(t)'), + (0x24B0, '3', '(u)'), + (0x24B1, '3', '(v)'), + (0x24B2, '3', '(w)'), + (0x24B3, '3', '(x)'), + (0x24B4, '3', '(y)'), + (0x24B5, '3', '(z)'), + (0x24B6, 'M', 'a'), + (0x24B7, 'M', 'b'), + (0x24B8, 'M', 'c'), + (0x24B9, 'M', 'd'), + (0x24BA, 'M', 'e'), + (0x24BB, 'M', 'f'), + (0x24BC, 'M', 'g'), + (0x24BD, 'M', 'h'), + (0x24BE, 'M', 'i'), + (0x24BF, 'M', 'j'), + (0x24C0, 'M', 'k'), + ] + +def _seg_24() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x24C1, 'M', 'l'), + (0x24C2, 'M', 'm'), + (0x24C3, 'M', 'n'), + (0x24C4, 'M', 'o'), + (0x24C5, 'M', 'p'), + (0x24C6, 'M', 'q'), + (0x24C7, 'M', 'r'), + (0x24C8, 'M', 's'), + (0x24C9, 'M', 't'), + (0x24CA, 'M', 'u'), + (0x24CB, 'M', 'v'), + (0x24CC, 'M', 'w'), + (0x24CD, 'M', 'x'), + (0x24CE, 'M', 'y'), + (0x24CF, 'M', 'z'), + (0x24D0, 'M', 'a'), + (0x24D1, 'M', 'b'), + (0x24D2, 'M', 'c'), + (0x24D3, 'M', 'd'), + (0x24D4, 'M', 'e'), + (0x24D5, 'M', 'f'), + (0x24D6, 'M', 'g'), + (0x24D7, 'M', 'h'), + (0x24D8, 'M', 'i'), + (0x24D9, 'M', 'j'), + (0x24DA, 'M', 'k'), + (0x24DB, 'M', 'l'), + (0x24DC, 'M', 'm'), + (0x24DD, 'M', 'n'), + (0x24DE, 'M', 'o'), + (0x24DF, 'M', 'p'), + (0x24E0, 'M', 'q'), + (0x24E1, 'M', 'r'), + (0x24E2, 'M', 's'), + (0x24E3, 'M', 't'), + (0x24E4, 'M', 'u'), + (0x24E5, 'M', 'v'), + (0x24E6, 'M', 'w'), + (0x24E7, 'M', 'x'), + (0x24E8, 'M', 'y'), + (0x24E9, 'M', 'z'), + (0x24EA, 'M', '0'), + (0x24EB, 'V'), + (0x2A0C, 'M', '∫∫∫∫'), + (0x2A0D, 'V'), + (0x2A74, '3', '::='), + (0x2A75, '3', '=='), + (0x2A76, '3', '==='), + (0x2A77, 'V'), + (0x2ADC, 'M', '⫝̸'), + (0x2ADD, 'V'), + (0x2B74, 'X'), + (0x2B76, 'V'), + (0x2B96, 'X'), + (0x2B97, 'V'), + (0x2C00, 'M', 'ⰰ'), + (0x2C01, 'M', 'ⰱ'), + (0x2C02, 'M', 'ⰲ'), + (0x2C03, 'M', 'ⰳ'), + (0x2C04, 'M', 'ⰴ'), + (0x2C05, 'M', 'ⰵ'), + (0x2C06, 'M', 'ⰶ'), + (0x2C07, 'M', 'ⰷ'), + (0x2C08, 'M', 'ⰸ'), + (0x2C09, 'M', 'ⰹ'), + (0x2C0A, 'M', 'ⰺ'), + (0x2C0B, 'M', 'ⰻ'), + (0x2C0C, 'M', 'ⰼ'), + (0x2C0D, 'M', 'ⰽ'), + (0x2C0E, 'M', 'ⰾ'), + (0x2C0F, 'M', 'ⰿ'), + (0x2C10, 'M', 'ⱀ'), + (0x2C11, 'M', 'ⱁ'), + (0x2C12, 'M', 'ⱂ'), + (0x2C13, 'M', 'ⱃ'), + (0x2C14, 'M', 'ⱄ'), + (0x2C15, 'M', 'ⱅ'), + (0x2C16, 'M', 'ⱆ'), + (0x2C17, 'M', 'ⱇ'), + (0x2C18, 'M', 'ⱈ'), + (0x2C19, 'M', 'ⱉ'), + (0x2C1A, 'M', 'ⱊ'), + (0x2C1B, 'M', 'ⱋ'), + (0x2C1C, 'M', 'ⱌ'), + (0x2C1D, 'M', 'ⱍ'), + (0x2C1E, 'M', 'ⱎ'), + (0x2C1F, 'M', 'ⱏ'), + (0x2C20, 'M', 'ⱐ'), + (0x2C21, 'M', 'ⱑ'), + (0x2C22, 'M', 'ⱒ'), + (0x2C23, 'M', 'ⱓ'), + (0x2C24, 'M', 'ⱔ'), + (0x2C25, 'M', 'ⱕ'), + (0x2C26, 'M', 'ⱖ'), + (0x2C27, 'M', 'ⱗ'), + (0x2C28, 'M', 'ⱘ'), + (0x2C29, 'M', 'ⱙ'), + (0x2C2A, 'M', 'ⱚ'), + (0x2C2B, 'M', 'ⱛ'), + (0x2C2C, 'M', 'ⱜ'), + ] + +def _seg_25() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x2C2D, 'M', 'ⱝ'), + (0x2C2E, 'M', 'ⱞ'), + (0x2C2F, 'M', 'ⱟ'), + (0x2C30, 'V'), + (0x2C60, 'M', 'ⱡ'), + (0x2C61, 'V'), + (0x2C62, 'M', 'ɫ'), + (0x2C63, 'M', 'ᵽ'), + (0x2C64, 'M', 'ɽ'), + (0x2C65, 'V'), + (0x2C67, 'M', 'ⱨ'), + (0x2C68, 'V'), + (0x2C69, 'M', 'ⱪ'), + (0x2C6A, 'V'), + (0x2C6B, 'M', 'ⱬ'), + (0x2C6C, 'V'), + (0x2C6D, 'M', 'ɑ'), + (0x2C6E, 'M', 'ɱ'), + (0x2C6F, 'M', 'ɐ'), + (0x2C70, 'M', 'ɒ'), + (0x2C71, 'V'), + (0x2C72, 'M', 'ⱳ'), + (0x2C73, 'V'), + (0x2C75, 'M', 'ⱶ'), + (0x2C76, 'V'), + (0x2C7C, 'M', 'j'), + (0x2C7D, 'M', 'v'), + (0x2C7E, 'M', 'ȿ'), + (0x2C7F, 'M', 'ɀ'), + (0x2C80, 'M', 'ⲁ'), + (0x2C81, 'V'), + (0x2C82, 'M', 'ⲃ'), + (0x2C83, 'V'), + (0x2C84, 'M', 'ⲅ'), + (0x2C85, 'V'), + (0x2C86, 'M', 'ⲇ'), + (0x2C87, 'V'), + (0x2C88, 'M', 'ⲉ'), + (0x2C89, 'V'), + (0x2C8A, 'M', 'ⲋ'), + (0x2C8B, 'V'), + (0x2C8C, 'M', 'ⲍ'), + (0x2C8D, 'V'), + (0x2C8E, 'M', 'ⲏ'), + (0x2C8F, 'V'), + (0x2C90, 'M', 'ⲑ'), + (0x2C91, 'V'), + (0x2C92, 'M', 'ⲓ'), + (0x2C93, 'V'), + (0x2C94, 'M', 'ⲕ'), + (0x2C95, 'V'), + (0x2C96, 'M', 'ⲗ'), + (0x2C97, 'V'), + (0x2C98, 'M', 'ⲙ'), + (0x2C99, 'V'), + (0x2C9A, 'M', 'ⲛ'), + (0x2C9B, 'V'), + (0x2C9C, 'M', 'ⲝ'), + (0x2C9D, 'V'), + (0x2C9E, 'M', 'ⲟ'), + (0x2C9F, 'V'), + (0x2CA0, 'M', 'ⲡ'), + (0x2CA1, 'V'), + (0x2CA2, 'M', 'ⲣ'), + (0x2CA3, 'V'), + (0x2CA4, 'M', 'ⲥ'), + (0x2CA5, 'V'), + (0x2CA6, 'M', 'ⲧ'), + (0x2CA7, 'V'), + (0x2CA8, 'M', 'ⲩ'), + (0x2CA9, 'V'), + (0x2CAA, 'M', 'ⲫ'), + (0x2CAB, 'V'), + (0x2CAC, 'M', 'ⲭ'), + (0x2CAD, 'V'), + (0x2CAE, 'M', 'ⲯ'), + (0x2CAF, 'V'), + (0x2CB0, 'M', 'ⲱ'), + (0x2CB1, 'V'), + (0x2CB2, 'M', 'ⲳ'), + (0x2CB3, 'V'), + (0x2CB4, 'M', 'ⲵ'), + (0x2CB5, 'V'), + (0x2CB6, 'M', 'ⲷ'), + (0x2CB7, 'V'), + (0x2CB8, 'M', 'ⲹ'), + (0x2CB9, 'V'), + (0x2CBA, 'M', 'ⲻ'), + (0x2CBB, 'V'), + (0x2CBC, 'M', 'ⲽ'), + (0x2CBD, 'V'), + (0x2CBE, 'M', 'ⲿ'), + (0x2CBF, 'V'), + (0x2CC0, 'M', 'ⳁ'), + (0x2CC1, 'V'), + (0x2CC2, 'M', 'ⳃ'), + (0x2CC3, 'V'), + (0x2CC4, 'M', 'ⳅ'), + (0x2CC5, 'V'), + (0x2CC6, 'M', 'ⳇ'), + ] + +def _seg_26() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x2CC7, 'V'), + (0x2CC8, 'M', 'ⳉ'), + (0x2CC9, 'V'), + (0x2CCA, 'M', 'ⳋ'), + (0x2CCB, 'V'), + (0x2CCC, 'M', 'ⳍ'), + (0x2CCD, 'V'), + (0x2CCE, 'M', 'ⳏ'), + (0x2CCF, 'V'), + (0x2CD0, 'M', 'ⳑ'), + (0x2CD1, 'V'), + (0x2CD2, 'M', 'ⳓ'), + (0x2CD3, 'V'), + (0x2CD4, 'M', 'ⳕ'), + (0x2CD5, 'V'), + (0x2CD6, 'M', 'ⳗ'), + (0x2CD7, 'V'), + (0x2CD8, 'M', 'ⳙ'), + (0x2CD9, 'V'), + (0x2CDA, 'M', 'ⳛ'), + (0x2CDB, 'V'), + (0x2CDC, 'M', 'ⳝ'), + (0x2CDD, 'V'), + (0x2CDE, 'M', 'ⳟ'), + (0x2CDF, 'V'), + (0x2CE0, 'M', 'ⳡ'), + (0x2CE1, 'V'), + (0x2CE2, 'M', 'ⳣ'), + (0x2CE3, 'V'), + (0x2CEB, 'M', 'ⳬ'), + (0x2CEC, 'V'), + (0x2CED, 'M', 'ⳮ'), + (0x2CEE, 'V'), + (0x2CF2, 'M', 'ⳳ'), + (0x2CF3, 'V'), + (0x2CF4, 'X'), + (0x2CF9, 'V'), + (0x2D26, 'X'), + (0x2D27, 'V'), + (0x2D28, 'X'), + (0x2D2D, 'V'), + (0x2D2E, 'X'), + (0x2D30, 'V'), + (0x2D68, 'X'), + (0x2D6F, 'M', 'ⵡ'), + (0x2D70, 'V'), + (0x2D71, 'X'), + (0x2D7F, 'V'), + (0x2D97, 'X'), + (0x2DA0, 'V'), + (0x2DA7, 'X'), + (0x2DA8, 'V'), + (0x2DAF, 'X'), + (0x2DB0, 'V'), + (0x2DB7, 'X'), + (0x2DB8, 'V'), + (0x2DBF, 'X'), + (0x2DC0, 'V'), + (0x2DC7, 'X'), + (0x2DC8, 'V'), + (0x2DCF, 'X'), + (0x2DD0, 'V'), + (0x2DD7, 'X'), + (0x2DD8, 'V'), + (0x2DDF, 'X'), + (0x2DE0, 'V'), + (0x2E5E, 'X'), + (0x2E80, 'V'), + (0x2E9A, 'X'), + (0x2E9B, 'V'), + (0x2E9F, 'M', '母'), + (0x2EA0, 'V'), + (0x2EF3, 'M', '龟'), + (0x2EF4, 'X'), + (0x2F00, 'M', '一'), + (0x2F01, 'M', '丨'), + (0x2F02, 'M', '丶'), + (0x2F03, 'M', '丿'), + (0x2F04, 'M', '乙'), + (0x2F05, 'M', '亅'), + (0x2F06, 'M', '二'), + (0x2F07, 'M', '亠'), + (0x2F08, 'M', '人'), + (0x2F09, 'M', '儿'), + (0x2F0A, 'M', '入'), + (0x2F0B, 'M', '八'), + (0x2F0C, 'M', '冂'), + (0x2F0D, 'M', '冖'), + (0x2F0E, 'M', '冫'), + (0x2F0F, 'M', '几'), + (0x2F10, 'M', '凵'), + (0x2F11, 'M', '刀'), + (0x2F12, 'M', '力'), + (0x2F13, 'M', '勹'), + (0x2F14, 'M', '匕'), + (0x2F15, 'M', '匚'), + (0x2F16, 'M', '匸'), + (0x2F17, 'M', '十'), + (0x2F18, 'M', '卜'), + (0x2F19, 'M', '卩'), + ] + +def _seg_27() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x2F1A, 'M', '厂'), + (0x2F1B, 'M', '厶'), + (0x2F1C, 'M', '又'), + (0x2F1D, 'M', '口'), + (0x2F1E, 'M', '囗'), + (0x2F1F, 'M', '土'), + (0x2F20, 'M', '士'), + (0x2F21, 'M', '夂'), + (0x2F22, 'M', '夊'), + (0x2F23, 'M', '夕'), + (0x2F24, 'M', '大'), + (0x2F25, 'M', '女'), + (0x2F26, 'M', '子'), + (0x2F27, 'M', '宀'), + (0x2F28, 'M', '寸'), + (0x2F29, 'M', '小'), + (0x2F2A, 'M', '尢'), + (0x2F2B, 'M', '尸'), + (0x2F2C, 'M', '屮'), + (0x2F2D, 'M', '山'), + (0x2F2E, 'M', '巛'), + (0x2F2F, 'M', '工'), + (0x2F30, 'M', '己'), + (0x2F31, 'M', '巾'), + (0x2F32, 'M', '干'), + (0x2F33, 'M', '幺'), + (0x2F34, 'M', '广'), + (0x2F35, 'M', '廴'), + (0x2F36, 'M', '廾'), + (0x2F37, 'M', '弋'), + (0x2F38, 'M', '弓'), + (0x2F39, 'M', '彐'), + (0x2F3A, 'M', '彡'), + (0x2F3B, 'M', '彳'), + (0x2F3C, 'M', '心'), + (0x2F3D, 'M', '戈'), + (0x2F3E, 'M', '戶'), + (0x2F3F, 'M', '手'), + (0x2F40, 'M', '支'), + (0x2F41, 'M', '攴'), + (0x2F42, 'M', '文'), + (0x2F43, 'M', '斗'), + (0x2F44, 'M', '斤'), + (0x2F45, 'M', '方'), + (0x2F46, 'M', '无'), + (0x2F47, 'M', '日'), + (0x2F48, 'M', '曰'), + (0x2F49, 'M', '月'), + (0x2F4A, 'M', '木'), + (0x2F4B, 'M', '欠'), + (0x2F4C, 'M', '止'), + (0x2F4D, 'M', '歹'), + (0x2F4E, 'M', '殳'), + (0x2F4F, 'M', '毋'), + (0x2F50, 'M', '比'), + (0x2F51, 'M', '毛'), + (0x2F52, 'M', '氏'), + (0x2F53, 'M', '气'), + (0x2F54, 'M', '水'), + (0x2F55, 'M', '火'), + (0x2F56, 'M', '爪'), + (0x2F57, 'M', '父'), + (0x2F58, 'M', '爻'), + (0x2F59, 'M', '爿'), + (0x2F5A, 'M', '片'), + (0x2F5B, 'M', '牙'), + (0x2F5C, 'M', '牛'), + (0x2F5D, 'M', '犬'), + (0x2F5E, 'M', '玄'), + (0x2F5F, 'M', '玉'), + (0x2F60, 'M', '瓜'), + (0x2F61, 'M', '瓦'), + (0x2F62, 'M', '甘'), + (0x2F63, 'M', '生'), + (0x2F64, 'M', '用'), + (0x2F65, 'M', '田'), + (0x2F66, 'M', '疋'), + (0x2F67, 'M', '疒'), + (0x2F68, 'M', '癶'), + (0x2F69, 'M', '白'), + (0x2F6A, 'M', '皮'), + (0x2F6B, 'M', '皿'), + (0x2F6C, 'M', '目'), + (0x2F6D, 'M', '矛'), + (0x2F6E, 'M', '矢'), + (0x2F6F, 'M', '石'), + (0x2F70, 'M', '示'), + (0x2F71, 'M', '禸'), + (0x2F72, 'M', '禾'), + (0x2F73, 'M', '穴'), + (0x2F74, 'M', '立'), + (0x2F75, 'M', '竹'), + (0x2F76, 'M', '米'), + (0x2F77, 'M', '糸'), + (0x2F78, 'M', '缶'), + (0x2F79, 'M', '网'), + (0x2F7A, 'M', '羊'), + (0x2F7B, 'M', '羽'), + (0x2F7C, 'M', '老'), + (0x2F7D, 'M', '而'), + ] + +def _seg_28() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x2F7E, 'M', '耒'), + (0x2F7F, 'M', '耳'), + (0x2F80, 'M', '聿'), + (0x2F81, 'M', '肉'), + (0x2F82, 'M', '臣'), + (0x2F83, 'M', '自'), + (0x2F84, 'M', '至'), + (0x2F85, 'M', '臼'), + (0x2F86, 'M', '舌'), + (0x2F87, 'M', '舛'), + (0x2F88, 'M', '舟'), + (0x2F89, 'M', '艮'), + (0x2F8A, 'M', '色'), + (0x2F8B, 'M', '艸'), + (0x2F8C, 'M', '虍'), + (0x2F8D, 'M', '虫'), + (0x2F8E, 'M', '血'), + (0x2F8F, 'M', '行'), + (0x2F90, 'M', '衣'), + (0x2F91, 'M', '襾'), + (0x2F92, 'M', '見'), + (0x2F93, 'M', '角'), + (0x2F94, 'M', '言'), + (0x2F95, 'M', '谷'), + (0x2F96, 'M', '豆'), + (0x2F97, 'M', '豕'), + (0x2F98, 'M', '豸'), + (0x2F99, 'M', '貝'), + (0x2F9A, 'M', '赤'), + (0x2F9B, 'M', '走'), + (0x2F9C, 'M', '足'), + (0x2F9D, 'M', '身'), + (0x2F9E, 'M', '車'), + (0x2F9F, 'M', '辛'), + (0x2FA0, 'M', '辰'), + (0x2FA1, 'M', '辵'), + (0x2FA2, 'M', '邑'), + (0x2FA3, 'M', '酉'), + (0x2FA4, 'M', '釆'), + (0x2FA5, 'M', '里'), + (0x2FA6, 'M', '金'), + (0x2FA7, 'M', '長'), + (0x2FA8, 'M', '門'), + (0x2FA9, 'M', '阜'), + (0x2FAA, 'M', '隶'), + (0x2FAB, 'M', '隹'), + (0x2FAC, 'M', '雨'), + (0x2FAD, 'M', '靑'), + (0x2FAE, 'M', '非'), + (0x2FAF, 'M', '面'), + (0x2FB0, 'M', '革'), + (0x2FB1, 'M', '韋'), + (0x2FB2, 'M', '韭'), + (0x2FB3, 'M', '音'), + (0x2FB4, 'M', '頁'), + (0x2FB5, 'M', '風'), + (0x2FB6, 'M', '飛'), + (0x2FB7, 'M', '食'), + (0x2FB8, 'M', '首'), + (0x2FB9, 'M', '香'), + (0x2FBA, 'M', '馬'), + (0x2FBB, 'M', '骨'), + (0x2FBC, 'M', '高'), + (0x2FBD, 'M', '髟'), + (0x2FBE, 'M', '鬥'), + (0x2FBF, 'M', '鬯'), + (0x2FC0, 'M', '鬲'), + (0x2FC1, 'M', '鬼'), + (0x2FC2, 'M', '魚'), + (0x2FC3, 'M', '鳥'), + (0x2FC4, 'M', '鹵'), + (0x2FC5, 'M', '鹿'), + (0x2FC6, 'M', '麥'), + (0x2FC7, 'M', '麻'), + (0x2FC8, 'M', '黃'), + (0x2FC9, 'M', '黍'), + (0x2FCA, 'M', '黑'), + (0x2FCB, 'M', '黹'), + (0x2FCC, 'M', '黽'), + (0x2FCD, 'M', '鼎'), + (0x2FCE, 'M', '鼓'), + (0x2FCF, 'M', '鼠'), + (0x2FD0, 'M', '鼻'), + (0x2FD1, 'M', '齊'), + (0x2FD2, 'M', '齒'), + (0x2FD3, 'M', '龍'), + (0x2FD4, 'M', '龜'), + (0x2FD5, 'M', '龠'), + (0x2FD6, 'X'), + (0x3000, '3', ' '), + (0x3001, 'V'), + (0x3002, 'M', '.'), + (0x3003, 'V'), + (0x3036, 'M', '〒'), + (0x3037, 'V'), + (0x3038, 'M', '十'), + (0x3039, 'M', '卄'), + (0x303A, 'M', '卅'), + (0x303B, 'V'), + (0x3040, 'X'), + ] + +def _seg_29() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x3041, 'V'), + (0x3097, 'X'), + (0x3099, 'V'), + (0x309B, '3', ' ゙'), + (0x309C, '3', ' ゚'), + (0x309D, 'V'), + (0x309F, 'M', 'より'), + (0x30A0, 'V'), + (0x30FF, 'M', 'コト'), + (0x3100, 'X'), + (0x3105, 'V'), + (0x3130, 'X'), + (0x3131, 'M', 'ᄀ'), + (0x3132, 'M', 'ᄁ'), + (0x3133, 'M', 'ᆪ'), + (0x3134, 'M', 'ᄂ'), + (0x3135, 'M', 'ᆬ'), + (0x3136, 'M', 'ᆭ'), + (0x3137, 'M', 'ᄃ'), + (0x3138, 'M', 'ᄄ'), + (0x3139, 'M', 'ᄅ'), + (0x313A, 'M', 'ᆰ'), + (0x313B, 'M', 'ᆱ'), + (0x313C, 'M', 'ᆲ'), + (0x313D, 'M', 'ᆳ'), + (0x313E, 'M', 'ᆴ'), + (0x313F, 'M', 'ᆵ'), + (0x3140, 'M', 'ᄚ'), + (0x3141, 'M', 'ᄆ'), + (0x3142, 'M', 'ᄇ'), + (0x3143, 'M', 'ᄈ'), + (0x3144, 'M', 'ᄡ'), + (0x3145, 'M', 'ᄉ'), + (0x3146, 'M', 'ᄊ'), + (0x3147, 'M', 'ᄋ'), + (0x3148, 'M', 'ᄌ'), + (0x3149, 'M', 'ᄍ'), + (0x314A, 'M', 'ᄎ'), + (0x314B, 'M', 'ᄏ'), + (0x314C, 'M', 'ᄐ'), + (0x314D, 'M', 'ᄑ'), + (0x314E, 'M', 'ᄒ'), + (0x314F, 'M', 'ᅡ'), + (0x3150, 'M', 'ᅢ'), + (0x3151, 'M', 'ᅣ'), + (0x3152, 'M', 'ᅤ'), + (0x3153, 'M', 'ᅥ'), + (0x3154, 'M', 'ᅦ'), + (0x3155, 'M', 'ᅧ'), + (0x3156, 'M', 'ᅨ'), + (0x3157, 'M', 'ᅩ'), + (0x3158, 'M', 'ᅪ'), + (0x3159, 'M', 'ᅫ'), + (0x315A, 'M', 'ᅬ'), + (0x315B, 'M', 'ᅭ'), + (0x315C, 'M', 'ᅮ'), + (0x315D, 'M', 'ᅯ'), + (0x315E, 'M', 'ᅰ'), + (0x315F, 'M', 'ᅱ'), + (0x3160, 'M', 'ᅲ'), + (0x3161, 'M', 'ᅳ'), + (0x3162, 'M', 'ᅴ'), + (0x3163, 'M', 'ᅵ'), + (0x3164, 'X'), + (0x3165, 'M', 'ᄔ'), + (0x3166, 'M', 'ᄕ'), + (0x3167, 'M', 'ᇇ'), + (0x3168, 'M', 'ᇈ'), + (0x3169, 'M', 'ᇌ'), + (0x316A, 'M', 'ᇎ'), + (0x316B, 'M', 'ᇓ'), + (0x316C, 'M', 'ᇗ'), + (0x316D, 'M', 'ᇙ'), + (0x316E, 'M', 'ᄜ'), + (0x316F, 'M', 'ᇝ'), + (0x3170, 'M', 'ᇟ'), + (0x3171, 'M', 'ᄝ'), + (0x3172, 'M', 'ᄞ'), + (0x3173, 'M', 'ᄠ'), + (0x3174, 'M', 'ᄢ'), + (0x3175, 'M', 'ᄣ'), + (0x3176, 'M', 'ᄧ'), + (0x3177, 'M', 'ᄩ'), + (0x3178, 'M', 'ᄫ'), + (0x3179, 'M', 'ᄬ'), + (0x317A, 'M', 'ᄭ'), + (0x317B, 'M', 'ᄮ'), + (0x317C, 'M', 'ᄯ'), + (0x317D, 'M', 'ᄲ'), + (0x317E, 'M', 'ᄶ'), + (0x317F, 'M', 'ᅀ'), + (0x3180, 'M', 'ᅇ'), + (0x3181, 'M', 'ᅌ'), + (0x3182, 'M', 'ᇱ'), + (0x3183, 'M', 'ᇲ'), + (0x3184, 'M', 'ᅗ'), + (0x3185, 'M', 'ᅘ'), + (0x3186, 'M', 'ᅙ'), + (0x3187, 'M', 'ᆄ'), + (0x3188, 'M', 'ᆅ'), + ] + +def _seg_30() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x3189, 'M', 'ᆈ'), + (0x318A, 'M', 'ᆑ'), + (0x318B, 'M', 'ᆒ'), + (0x318C, 'M', 'ᆔ'), + (0x318D, 'M', 'ᆞ'), + (0x318E, 'M', 'ᆡ'), + (0x318F, 'X'), + (0x3190, 'V'), + (0x3192, 'M', '一'), + (0x3193, 'M', '二'), + (0x3194, 'M', '三'), + (0x3195, 'M', '四'), + (0x3196, 'M', '上'), + (0x3197, 'M', '中'), + (0x3198, 'M', '下'), + (0x3199, 'M', '甲'), + (0x319A, 'M', '乙'), + (0x319B, 'M', '丙'), + (0x319C, 'M', '丁'), + (0x319D, 'M', '天'), + (0x319E, 'M', '地'), + (0x319F, 'M', '人'), + (0x31A0, 'V'), + (0x31E4, 'X'), + (0x31F0, 'V'), + (0x3200, '3', '(ᄀ)'), + (0x3201, '3', '(ᄂ)'), + (0x3202, '3', '(ᄃ)'), + (0x3203, '3', '(ᄅ)'), + (0x3204, '3', '(ᄆ)'), + (0x3205, '3', '(ᄇ)'), + (0x3206, '3', '(ᄉ)'), + (0x3207, '3', '(ᄋ)'), + (0x3208, '3', '(ᄌ)'), + (0x3209, '3', '(ᄎ)'), + (0x320A, '3', '(ᄏ)'), + (0x320B, '3', '(ᄐ)'), + (0x320C, '3', '(ᄑ)'), + (0x320D, '3', '(ᄒ)'), + (0x320E, '3', '(가)'), + (0x320F, '3', '(나)'), + (0x3210, '3', '(다)'), + (0x3211, '3', '(라)'), + (0x3212, '3', '(마)'), + (0x3213, '3', '(바)'), + (0x3214, '3', '(사)'), + (0x3215, '3', '(아)'), + (0x3216, '3', '(자)'), + (0x3217, '3', '(차)'), + (0x3218, '3', '(카)'), + (0x3219, '3', '(타)'), + (0x321A, '3', '(파)'), + (0x321B, '3', '(하)'), + (0x321C, '3', '(주)'), + (0x321D, '3', '(오전)'), + (0x321E, '3', '(오후)'), + (0x321F, 'X'), + (0x3220, '3', '(一)'), + (0x3221, '3', '(二)'), + (0x3222, '3', '(三)'), + (0x3223, '3', '(四)'), + (0x3224, '3', '(五)'), + (0x3225, '3', '(六)'), + (0x3226, '3', '(七)'), + (0x3227, '3', '(八)'), + (0x3228, '3', '(九)'), + (0x3229, '3', '(十)'), + (0x322A, '3', '(月)'), + (0x322B, '3', '(火)'), + (0x322C, '3', '(水)'), + (0x322D, '3', '(木)'), + (0x322E, '3', '(金)'), + (0x322F, '3', '(土)'), + (0x3230, '3', '(日)'), + (0x3231, '3', '(株)'), + (0x3232, '3', '(有)'), + (0x3233, '3', '(社)'), + (0x3234, '3', '(名)'), + (0x3235, '3', '(特)'), + (0x3236, '3', '(財)'), + (0x3237, '3', '(祝)'), + (0x3238, '3', '(労)'), + (0x3239, '3', '(代)'), + (0x323A, '3', '(呼)'), + (0x323B, '3', '(学)'), + (0x323C, '3', '(監)'), + (0x323D, '3', '(企)'), + (0x323E, '3', '(資)'), + (0x323F, '3', '(協)'), + (0x3240, '3', '(祭)'), + (0x3241, '3', '(休)'), + (0x3242, '3', '(自)'), + (0x3243, '3', '(至)'), + (0x3244, 'M', '問'), + (0x3245, 'M', '幼'), + (0x3246, 'M', '文'), + (0x3247, 'M', '箏'), + (0x3248, 'V'), + (0x3250, 'M', 'pte'), + (0x3251, 'M', '21'), + ] + +def _seg_31() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x3252, 'M', '22'), + (0x3253, 'M', '23'), + (0x3254, 'M', '24'), + (0x3255, 'M', '25'), + (0x3256, 'M', '26'), + (0x3257, 'M', '27'), + (0x3258, 'M', '28'), + (0x3259, 'M', '29'), + (0x325A, 'M', '30'), + (0x325B, 'M', '31'), + (0x325C, 'M', '32'), + (0x325D, 'M', '33'), + (0x325E, 'M', '34'), + (0x325F, 'M', '35'), + (0x3260, 'M', 'ᄀ'), + (0x3261, 'M', 'ᄂ'), + (0x3262, 'M', 'ᄃ'), + (0x3263, 'M', 'ᄅ'), + (0x3264, 'M', 'ᄆ'), + (0x3265, 'M', 'ᄇ'), + (0x3266, 'M', 'ᄉ'), + (0x3267, 'M', 'ᄋ'), + (0x3268, 'M', 'ᄌ'), + (0x3269, 'M', 'ᄎ'), + (0x326A, 'M', 'ᄏ'), + (0x326B, 'M', 'ᄐ'), + (0x326C, 'M', 'ᄑ'), + (0x326D, 'M', 'ᄒ'), + (0x326E, 'M', '가'), + (0x326F, 'M', '나'), + (0x3270, 'M', '다'), + (0x3271, 'M', '라'), + (0x3272, 'M', '마'), + (0x3273, 'M', '바'), + (0x3274, 'M', '사'), + (0x3275, 'M', '아'), + (0x3276, 'M', '자'), + (0x3277, 'M', '차'), + (0x3278, 'M', '카'), + (0x3279, 'M', '타'), + (0x327A, 'M', '파'), + (0x327B, 'M', '하'), + (0x327C, 'M', '참고'), + (0x327D, 'M', '주의'), + (0x327E, 'M', '우'), + (0x327F, 'V'), + (0x3280, 'M', '一'), + (0x3281, 'M', '二'), + (0x3282, 'M', '三'), + (0x3283, 'M', '四'), + (0x3284, 'M', '五'), + (0x3285, 'M', '六'), + (0x3286, 'M', '七'), + (0x3287, 'M', '八'), + (0x3288, 'M', '九'), + (0x3289, 'M', '十'), + (0x328A, 'M', '月'), + (0x328B, 'M', '火'), + (0x328C, 'M', '水'), + (0x328D, 'M', '木'), + (0x328E, 'M', '金'), + (0x328F, 'M', '土'), + (0x3290, 'M', '日'), + (0x3291, 'M', '株'), + (0x3292, 'M', '有'), + (0x3293, 'M', '社'), + (0x3294, 'M', '名'), + (0x3295, 'M', '特'), + (0x3296, 'M', '財'), + (0x3297, 'M', '祝'), + (0x3298, 'M', '労'), + (0x3299, 'M', '秘'), + (0x329A, 'M', '男'), + (0x329B, 'M', '女'), + (0x329C, 'M', '適'), + (0x329D, 'M', '優'), + (0x329E, 'M', '印'), + (0x329F, 'M', '注'), + (0x32A0, 'M', '項'), + (0x32A1, 'M', '休'), + (0x32A2, 'M', '写'), + (0x32A3, 'M', '正'), + (0x32A4, 'M', '上'), + (0x32A5, 'M', '中'), + (0x32A6, 'M', '下'), + (0x32A7, 'M', '左'), + (0x32A8, 'M', '右'), + (0x32A9, 'M', '医'), + (0x32AA, 'M', '宗'), + (0x32AB, 'M', '学'), + (0x32AC, 'M', '監'), + (0x32AD, 'M', '企'), + (0x32AE, 'M', '資'), + (0x32AF, 'M', '協'), + (0x32B0, 'M', '夜'), + (0x32B1, 'M', '36'), + (0x32B2, 'M', '37'), + (0x32B3, 'M', '38'), + (0x32B4, 'M', '39'), + (0x32B5, 'M', '40'), + ] + +def _seg_32() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x32B6, 'M', '41'), + (0x32B7, 'M', '42'), + (0x32B8, 'M', '43'), + (0x32B9, 'M', '44'), + (0x32BA, 'M', '45'), + (0x32BB, 'M', '46'), + (0x32BC, 'M', '47'), + (0x32BD, 'M', '48'), + (0x32BE, 'M', '49'), + (0x32BF, 'M', '50'), + (0x32C0, 'M', '1月'), + (0x32C1, 'M', '2月'), + (0x32C2, 'M', '3月'), + (0x32C3, 'M', '4月'), + (0x32C4, 'M', '5月'), + (0x32C5, 'M', '6月'), + (0x32C6, 'M', '7月'), + (0x32C7, 'M', '8月'), + (0x32C8, 'M', '9月'), + (0x32C9, 'M', '10月'), + (0x32CA, 'M', '11月'), + (0x32CB, 'M', '12月'), + (0x32CC, 'M', 'hg'), + (0x32CD, 'M', 'erg'), + (0x32CE, 'M', 'ev'), + (0x32CF, 'M', 'ltd'), + (0x32D0, 'M', 'ア'), + (0x32D1, 'M', 'イ'), + (0x32D2, 'M', 'ウ'), + (0x32D3, 'M', 'エ'), + (0x32D4, 'M', 'オ'), + (0x32D5, 'M', 'カ'), + (0x32D6, 'M', 'キ'), + (0x32D7, 'M', 'ク'), + (0x32D8, 'M', 'ケ'), + (0x32D9, 'M', 'コ'), + (0x32DA, 'M', 'サ'), + (0x32DB, 'M', 'シ'), + (0x32DC, 'M', 'ス'), + (0x32DD, 'M', 'セ'), + (0x32DE, 'M', 'ソ'), + (0x32DF, 'M', 'タ'), + (0x32E0, 'M', 'チ'), + (0x32E1, 'M', 'ツ'), + (0x32E2, 'M', 'テ'), + (0x32E3, 'M', 'ト'), + (0x32E4, 'M', 'ナ'), + (0x32E5, 'M', 'ニ'), + (0x32E6, 'M', 'ヌ'), + (0x32E7, 'M', 'ネ'), + (0x32E8, 'M', 'ノ'), + (0x32E9, 'M', 'ハ'), + (0x32EA, 'M', 'ヒ'), + (0x32EB, 'M', 'フ'), + (0x32EC, 'M', 'ヘ'), + (0x32ED, 'M', 'ホ'), + (0x32EE, 'M', 'マ'), + (0x32EF, 'M', 'ミ'), + (0x32F0, 'M', 'ム'), + (0x32F1, 'M', 'メ'), + (0x32F2, 'M', 'モ'), + (0x32F3, 'M', 'ヤ'), + (0x32F4, 'M', 'ユ'), + (0x32F5, 'M', 'ヨ'), + (0x32F6, 'M', 'ラ'), + (0x32F7, 'M', 'リ'), + (0x32F8, 'M', 'ル'), + (0x32F9, 'M', 'レ'), + (0x32FA, 'M', 'ロ'), + (0x32FB, 'M', 'ワ'), + (0x32FC, 'M', 'ヰ'), + (0x32FD, 'M', 'ヱ'), + (0x32FE, 'M', 'ヲ'), + (0x32FF, 'M', '令和'), + (0x3300, 'M', 'アパート'), + (0x3301, 'M', 'アルファ'), + (0x3302, 'M', 'アンペア'), + (0x3303, 'M', 'アール'), + (0x3304, 'M', 'イニング'), + (0x3305, 'M', 'インチ'), + (0x3306, 'M', 'ウォン'), + (0x3307, 'M', 'エスクード'), + (0x3308, 'M', 'エーカー'), + (0x3309, 'M', 'オンス'), + (0x330A, 'M', 'オーム'), + (0x330B, 'M', 'カイリ'), + (0x330C, 'M', 'カラット'), + (0x330D, 'M', 'カロリー'), + (0x330E, 'M', 'ガロン'), + (0x330F, 'M', 'ガンマ'), + (0x3310, 'M', 'ギガ'), + (0x3311, 'M', 'ギニー'), + (0x3312, 'M', 'キュリー'), + (0x3313, 'M', 'ギルダー'), + (0x3314, 'M', 'キロ'), + (0x3315, 'M', 'キログラム'), + (0x3316, 'M', 'キロメートル'), + (0x3317, 'M', 'キロワット'), + (0x3318, 'M', 'グラム'), + (0x3319, 'M', 'グラムトン'), + ] + +def _seg_33() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x331A, 'M', 'クルゼイロ'), + (0x331B, 'M', 'クローネ'), + (0x331C, 'M', 'ケース'), + (0x331D, 'M', 'コルナ'), + (0x331E, 'M', 'コーポ'), + (0x331F, 'M', 'サイクル'), + (0x3320, 'M', 'サンチーム'), + (0x3321, 'M', 'シリング'), + (0x3322, 'M', 'センチ'), + (0x3323, 'M', 'セント'), + (0x3324, 'M', 'ダース'), + (0x3325, 'M', 'デシ'), + (0x3326, 'M', 'ドル'), + (0x3327, 'M', 'トン'), + (0x3328, 'M', 'ナノ'), + (0x3329, 'M', 'ノット'), + (0x332A, 'M', 'ハイツ'), + (0x332B, 'M', 'パーセント'), + (0x332C, 'M', 'パーツ'), + (0x332D, 'M', 'バーレル'), + (0x332E, 'M', 'ピアストル'), + (0x332F, 'M', 'ピクル'), + (0x3330, 'M', 'ピコ'), + (0x3331, 'M', 'ビル'), + (0x3332, 'M', 'ファラッド'), + (0x3333, 'M', 'フィート'), + (0x3334, 'M', 'ブッシェル'), + (0x3335, 'M', 'フラン'), + (0x3336, 'M', 'ヘクタール'), + (0x3337, 'M', 'ペソ'), + (0x3338, 'M', 'ペニヒ'), + (0x3339, 'M', 'ヘルツ'), + (0x333A, 'M', 'ペンス'), + (0x333B, 'M', 'ページ'), + (0x333C, 'M', 'ベータ'), + (0x333D, 'M', 'ポイント'), + (0x333E, 'M', 'ボルト'), + (0x333F, 'M', 'ホン'), + (0x3340, 'M', 'ポンド'), + (0x3341, 'M', 'ホール'), + (0x3342, 'M', 'ホーン'), + (0x3343, 'M', 'マイクロ'), + (0x3344, 'M', 'マイル'), + (0x3345, 'M', 'マッハ'), + (0x3346, 'M', 'マルク'), + (0x3347, 'M', 'マンション'), + (0x3348, 'M', 'ミクロン'), + (0x3349, 'M', 'ミリ'), + (0x334A, 'M', 'ミリバール'), + (0x334B, 'M', 'メガ'), + (0x334C, 'M', 'メガトン'), + (0x334D, 'M', 'メートル'), + (0x334E, 'M', 'ヤード'), + (0x334F, 'M', 'ヤール'), + (0x3350, 'M', 'ユアン'), + (0x3351, 'M', 'リットル'), + (0x3352, 'M', 'リラ'), + (0x3353, 'M', 'ルピー'), + (0x3354, 'M', 'ルーブル'), + (0x3355, 'M', 'レム'), + (0x3356, 'M', 'レントゲン'), + (0x3357, 'M', 'ワット'), + (0x3358, 'M', '0点'), + (0x3359, 'M', '1点'), + (0x335A, 'M', '2点'), + (0x335B, 'M', '3点'), + (0x335C, 'M', '4点'), + (0x335D, 'M', '5点'), + (0x335E, 'M', '6点'), + (0x335F, 'M', '7点'), + (0x3360, 'M', '8点'), + (0x3361, 'M', '9点'), + (0x3362, 'M', '10点'), + (0x3363, 'M', '11点'), + (0x3364, 'M', '12点'), + (0x3365, 'M', '13点'), + (0x3366, 'M', '14点'), + (0x3367, 'M', '15点'), + (0x3368, 'M', '16点'), + (0x3369, 'M', '17点'), + (0x336A, 'M', '18点'), + (0x336B, 'M', '19点'), + (0x336C, 'M', '20点'), + (0x336D, 'M', '21点'), + (0x336E, 'M', '22点'), + (0x336F, 'M', '23点'), + (0x3370, 'M', '24点'), + (0x3371, 'M', 'hpa'), + (0x3372, 'M', 'da'), + (0x3373, 'M', 'au'), + (0x3374, 'M', 'bar'), + (0x3375, 'M', 'ov'), + (0x3376, 'M', 'pc'), + (0x3377, 'M', 'dm'), + (0x3378, 'M', 'dm2'), + (0x3379, 'M', 'dm3'), + (0x337A, 'M', 'iu'), + (0x337B, 'M', '平成'), + (0x337C, 'M', '昭和'), + (0x337D, 'M', '大正'), + ] + +def _seg_34() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x337E, 'M', '明治'), + (0x337F, 'M', '株式会社'), + (0x3380, 'M', 'pa'), + (0x3381, 'M', 'na'), + (0x3382, 'M', 'μa'), + (0x3383, 'M', 'ma'), + (0x3384, 'M', 'ka'), + (0x3385, 'M', 'kb'), + (0x3386, 'M', 'mb'), + (0x3387, 'M', 'gb'), + (0x3388, 'M', 'cal'), + (0x3389, 'M', 'kcal'), + (0x338A, 'M', 'pf'), + (0x338B, 'M', 'nf'), + (0x338C, 'M', 'μf'), + (0x338D, 'M', 'μg'), + (0x338E, 'M', 'mg'), + (0x338F, 'M', 'kg'), + (0x3390, 'M', 'hz'), + (0x3391, 'M', 'khz'), + (0x3392, 'M', 'mhz'), + (0x3393, 'M', 'ghz'), + (0x3394, 'M', 'thz'), + (0x3395, 'M', 'μl'), + (0x3396, 'M', 'ml'), + (0x3397, 'M', 'dl'), + (0x3398, 'M', 'kl'), + (0x3399, 'M', 'fm'), + (0x339A, 'M', 'nm'), + (0x339B, 'M', 'μm'), + (0x339C, 'M', 'mm'), + (0x339D, 'M', 'cm'), + (0x339E, 'M', 'km'), + (0x339F, 'M', 'mm2'), + (0x33A0, 'M', 'cm2'), + (0x33A1, 'M', 'm2'), + (0x33A2, 'M', 'km2'), + (0x33A3, 'M', 'mm3'), + (0x33A4, 'M', 'cm3'), + (0x33A5, 'M', 'm3'), + (0x33A6, 'M', 'km3'), + (0x33A7, 'M', 'm∕s'), + (0x33A8, 'M', 'm∕s2'), + (0x33A9, 'M', 'pa'), + (0x33AA, 'M', 'kpa'), + (0x33AB, 'M', 'mpa'), + (0x33AC, 'M', 'gpa'), + (0x33AD, 'M', 'rad'), + (0x33AE, 'M', 'rad∕s'), + (0x33AF, 'M', 'rad∕s2'), + (0x33B0, 'M', 'ps'), + (0x33B1, 'M', 'ns'), + (0x33B2, 'M', 'μs'), + (0x33B3, 'M', 'ms'), + (0x33B4, 'M', 'pv'), + (0x33B5, 'M', 'nv'), + (0x33B6, 'M', 'μv'), + (0x33B7, 'M', 'mv'), + (0x33B8, 'M', 'kv'), + (0x33B9, 'M', 'mv'), + (0x33BA, 'M', 'pw'), + (0x33BB, 'M', 'nw'), + (0x33BC, 'M', 'μw'), + (0x33BD, 'M', 'mw'), + (0x33BE, 'M', 'kw'), + (0x33BF, 'M', 'mw'), + (0x33C0, 'M', 'kω'), + (0x33C1, 'M', 'mω'), + (0x33C2, 'X'), + (0x33C3, 'M', 'bq'), + (0x33C4, 'M', 'cc'), + (0x33C5, 'M', 'cd'), + (0x33C6, 'M', 'c∕kg'), + (0x33C7, 'X'), + (0x33C8, 'M', 'db'), + (0x33C9, 'M', 'gy'), + (0x33CA, 'M', 'ha'), + (0x33CB, 'M', 'hp'), + (0x33CC, 'M', 'in'), + (0x33CD, 'M', 'kk'), + (0x33CE, 'M', 'km'), + (0x33CF, 'M', 'kt'), + (0x33D0, 'M', 'lm'), + (0x33D1, 'M', 'ln'), + (0x33D2, 'M', 'log'), + (0x33D3, 'M', 'lx'), + (0x33D4, 'M', 'mb'), + (0x33D5, 'M', 'mil'), + (0x33D6, 'M', 'mol'), + (0x33D7, 'M', 'ph'), + (0x33D8, 'X'), + (0x33D9, 'M', 'ppm'), + (0x33DA, 'M', 'pr'), + (0x33DB, 'M', 'sr'), + (0x33DC, 'M', 'sv'), + (0x33DD, 'M', 'wb'), + (0x33DE, 'M', 'v∕m'), + (0x33DF, 'M', 'a∕m'), + (0x33E0, 'M', '1日'), + (0x33E1, 'M', '2日'), + ] + +def _seg_35() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x33E2, 'M', '3日'), + (0x33E3, 'M', '4日'), + (0x33E4, 'M', '5日'), + (0x33E5, 'M', '6日'), + (0x33E6, 'M', '7日'), + (0x33E7, 'M', '8日'), + (0x33E8, 'M', '9日'), + (0x33E9, 'M', '10日'), + (0x33EA, 'M', '11日'), + (0x33EB, 'M', '12日'), + (0x33EC, 'M', '13日'), + (0x33ED, 'M', '14日'), + (0x33EE, 'M', '15日'), + (0x33EF, 'M', '16日'), + (0x33F0, 'M', '17日'), + (0x33F1, 'M', '18日'), + (0x33F2, 'M', '19日'), + (0x33F3, 'M', '20日'), + (0x33F4, 'M', '21日'), + (0x33F5, 'M', '22日'), + (0x33F6, 'M', '23日'), + (0x33F7, 'M', '24日'), + (0x33F8, 'M', '25日'), + (0x33F9, 'M', '26日'), + (0x33FA, 'M', '27日'), + (0x33FB, 'M', '28日'), + (0x33FC, 'M', '29日'), + (0x33FD, 'M', '30日'), + (0x33FE, 'M', '31日'), + (0x33FF, 'M', 'gal'), + (0x3400, 'V'), + (0xA48D, 'X'), + (0xA490, 'V'), + (0xA4C7, 'X'), + (0xA4D0, 'V'), + (0xA62C, 'X'), + (0xA640, 'M', 'ꙁ'), + (0xA641, 'V'), + (0xA642, 'M', 'ꙃ'), + (0xA643, 'V'), + (0xA644, 'M', 'ꙅ'), + (0xA645, 'V'), + (0xA646, 'M', 'ꙇ'), + (0xA647, 'V'), + (0xA648, 'M', 'ꙉ'), + (0xA649, 'V'), + (0xA64A, 'M', 'ꙋ'), + (0xA64B, 'V'), + (0xA64C, 'M', 'ꙍ'), + (0xA64D, 'V'), + (0xA64E, 'M', 'ꙏ'), + (0xA64F, 'V'), + (0xA650, 'M', 'ꙑ'), + (0xA651, 'V'), + (0xA652, 'M', 'ꙓ'), + (0xA653, 'V'), + (0xA654, 'M', 'ꙕ'), + (0xA655, 'V'), + (0xA656, 'M', 'ꙗ'), + (0xA657, 'V'), + (0xA658, 'M', 'ꙙ'), + (0xA659, 'V'), + (0xA65A, 'M', 'ꙛ'), + (0xA65B, 'V'), + (0xA65C, 'M', 'ꙝ'), + (0xA65D, 'V'), + (0xA65E, 'M', 'ꙟ'), + (0xA65F, 'V'), + (0xA660, 'M', 'ꙡ'), + (0xA661, 'V'), + (0xA662, 'M', 'ꙣ'), + (0xA663, 'V'), + (0xA664, 'M', 'ꙥ'), + (0xA665, 'V'), + (0xA666, 'M', 'ꙧ'), + (0xA667, 'V'), + (0xA668, 'M', 'ꙩ'), + (0xA669, 'V'), + (0xA66A, 'M', 'ꙫ'), + (0xA66B, 'V'), + (0xA66C, 'M', 'ꙭ'), + (0xA66D, 'V'), + (0xA680, 'M', 'ꚁ'), + (0xA681, 'V'), + (0xA682, 'M', 'ꚃ'), + (0xA683, 'V'), + (0xA684, 'M', 'ꚅ'), + (0xA685, 'V'), + (0xA686, 'M', 'ꚇ'), + (0xA687, 'V'), + (0xA688, 'M', 'ꚉ'), + (0xA689, 'V'), + (0xA68A, 'M', 'ꚋ'), + (0xA68B, 'V'), + (0xA68C, 'M', 'ꚍ'), + (0xA68D, 'V'), + (0xA68E, 'M', 'ꚏ'), + (0xA68F, 'V'), + (0xA690, 'M', 'ꚑ'), + (0xA691, 'V'), + ] + +def _seg_36() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xA692, 'M', 'ꚓ'), + (0xA693, 'V'), + (0xA694, 'M', 'ꚕ'), + (0xA695, 'V'), + (0xA696, 'M', 'ꚗ'), + (0xA697, 'V'), + (0xA698, 'M', 'ꚙ'), + (0xA699, 'V'), + (0xA69A, 'M', 'ꚛ'), + (0xA69B, 'V'), + (0xA69C, 'M', 'ъ'), + (0xA69D, 'M', 'ь'), + (0xA69E, 'V'), + (0xA6F8, 'X'), + (0xA700, 'V'), + (0xA722, 'M', 'ꜣ'), + (0xA723, 'V'), + (0xA724, 'M', 'ꜥ'), + (0xA725, 'V'), + (0xA726, 'M', 'ꜧ'), + (0xA727, 'V'), + (0xA728, 'M', 'ꜩ'), + (0xA729, 'V'), + (0xA72A, 'M', 'ꜫ'), + (0xA72B, 'V'), + (0xA72C, 'M', 'ꜭ'), + (0xA72D, 'V'), + (0xA72E, 'M', 'ꜯ'), + (0xA72F, 'V'), + (0xA732, 'M', 'ꜳ'), + (0xA733, 'V'), + (0xA734, 'M', 'ꜵ'), + (0xA735, 'V'), + (0xA736, 'M', 'ꜷ'), + (0xA737, 'V'), + (0xA738, 'M', 'ꜹ'), + (0xA739, 'V'), + (0xA73A, 'M', 'ꜻ'), + (0xA73B, 'V'), + (0xA73C, 'M', 'ꜽ'), + (0xA73D, 'V'), + (0xA73E, 'M', 'ꜿ'), + (0xA73F, 'V'), + (0xA740, 'M', 'ꝁ'), + (0xA741, 'V'), + (0xA742, 'M', 'ꝃ'), + (0xA743, 'V'), + (0xA744, 'M', 'ꝅ'), + (0xA745, 'V'), + (0xA746, 'M', 'ꝇ'), + (0xA747, 'V'), + (0xA748, 'M', 'ꝉ'), + (0xA749, 'V'), + (0xA74A, 'M', 'ꝋ'), + (0xA74B, 'V'), + (0xA74C, 'M', 'ꝍ'), + (0xA74D, 'V'), + (0xA74E, 'M', 'ꝏ'), + (0xA74F, 'V'), + (0xA750, 'M', 'ꝑ'), + (0xA751, 'V'), + (0xA752, 'M', 'ꝓ'), + (0xA753, 'V'), + (0xA754, 'M', 'ꝕ'), + (0xA755, 'V'), + (0xA756, 'M', 'ꝗ'), + (0xA757, 'V'), + (0xA758, 'M', 'ꝙ'), + (0xA759, 'V'), + (0xA75A, 'M', 'ꝛ'), + (0xA75B, 'V'), + (0xA75C, 'M', 'ꝝ'), + (0xA75D, 'V'), + (0xA75E, 'M', 'ꝟ'), + (0xA75F, 'V'), + (0xA760, 'M', 'ꝡ'), + (0xA761, 'V'), + (0xA762, 'M', 'ꝣ'), + (0xA763, 'V'), + (0xA764, 'M', 'ꝥ'), + (0xA765, 'V'), + (0xA766, 'M', 'ꝧ'), + (0xA767, 'V'), + (0xA768, 'M', 'ꝩ'), + (0xA769, 'V'), + (0xA76A, 'M', 'ꝫ'), + (0xA76B, 'V'), + (0xA76C, 'M', 'ꝭ'), + (0xA76D, 'V'), + (0xA76E, 'M', 'ꝯ'), + (0xA76F, 'V'), + (0xA770, 'M', 'ꝯ'), + (0xA771, 'V'), + (0xA779, 'M', 'ꝺ'), + (0xA77A, 'V'), + (0xA77B, 'M', 'ꝼ'), + (0xA77C, 'V'), + (0xA77D, 'M', 'ᵹ'), + (0xA77E, 'M', 'ꝿ'), + (0xA77F, 'V'), + ] + +def _seg_37() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xA780, 'M', 'ꞁ'), + (0xA781, 'V'), + (0xA782, 'M', 'ꞃ'), + (0xA783, 'V'), + (0xA784, 'M', 'ꞅ'), + (0xA785, 'V'), + (0xA786, 'M', 'ꞇ'), + (0xA787, 'V'), + (0xA78B, 'M', 'ꞌ'), + (0xA78C, 'V'), + (0xA78D, 'M', 'ɥ'), + (0xA78E, 'V'), + (0xA790, 'M', 'ꞑ'), + (0xA791, 'V'), + (0xA792, 'M', 'ꞓ'), + (0xA793, 'V'), + (0xA796, 'M', 'ꞗ'), + (0xA797, 'V'), + (0xA798, 'M', 'ꞙ'), + (0xA799, 'V'), + (0xA79A, 'M', 'ꞛ'), + (0xA79B, 'V'), + (0xA79C, 'M', 'ꞝ'), + (0xA79D, 'V'), + (0xA79E, 'M', 'ꞟ'), + (0xA79F, 'V'), + (0xA7A0, 'M', 'ꞡ'), + (0xA7A1, 'V'), + (0xA7A2, 'M', 'ꞣ'), + (0xA7A3, 'V'), + (0xA7A4, 'M', 'ꞥ'), + (0xA7A5, 'V'), + (0xA7A6, 'M', 'ꞧ'), + (0xA7A7, 'V'), + (0xA7A8, 'M', 'ꞩ'), + (0xA7A9, 'V'), + (0xA7AA, 'M', 'ɦ'), + (0xA7AB, 'M', 'ɜ'), + (0xA7AC, 'M', 'ɡ'), + (0xA7AD, 'M', 'ɬ'), + (0xA7AE, 'M', 'ɪ'), + (0xA7AF, 'V'), + (0xA7B0, 'M', 'ʞ'), + (0xA7B1, 'M', 'ʇ'), + (0xA7B2, 'M', 'ʝ'), + (0xA7B3, 'M', 'ꭓ'), + (0xA7B4, 'M', 'ꞵ'), + (0xA7B5, 'V'), + (0xA7B6, 'M', 'ꞷ'), + (0xA7B7, 'V'), + (0xA7B8, 'M', 'ꞹ'), + (0xA7B9, 'V'), + (0xA7BA, 'M', 'ꞻ'), + (0xA7BB, 'V'), + (0xA7BC, 'M', 'ꞽ'), + (0xA7BD, 'V'), + (0xA7BE, 'M', 'ꞿ'), + (0xA7BF, 'V'), + (0xA7C0, 'M', 'ꟁ'), + (0xA7C1, 'V'), + (0xA7C2, 'M', 'ꟃ'), + (0xA7C3, 'V'), + (0xA7C4, 'M', 'ꞔ'), + (0xA7C5, 'M', 'ʂ'), + (0xA7C6, 'M', 'ᶎ'), + (0xA7C7, 'M', 'ꟈ'), + (0xA7C8, 'V'), + (0xA7C9, 'M', 'ꟊ'), + (0xA7CA, 'V'), + (0xA7CB, 'X'), + (0xA7D0, 'M', 'ꟑ'), + (0xA7D1, 'V'), + (0xA7D2, 'X'), + (0xA7D3, 'V'), + (0xA7D4, 'X'), + (0xA7D5, 'V'), + (0xA7D6, 'M', 'ꟗ'), + (0xA7D7, 'V'), + (0xA7D8, 'M', 'ꟙ'), + (0xA7D9, 'V'), + (0xA7DA, 'X'), + (0xA7F2, 'M', 'c'), + (0xA7F3, 'M', 'f'), + (0xA7F4, 'M', 'q'), + (0xA7F5, 'M', 'ꟶ'), + (0xA7F6, 'V'), + (0xA7F8, 'M', 'ħ'), + (0xA7F9, 'M', 'œ'), + (0xA7FA, 'V'), + (0xA82D, 'X'), + (0xA830, 'V'), + (0xA83A, 'X'), + (0xA840, 'V'), + (0xA878, 'X'), + (0xA880, 'V'), + (0xA8C6, 'X'), + (0xA8CE, 'V'), + (0xA8DA, 'X'), + (0xA8E0, 'V'), + (0xA954, 'X'), + ] + +def _seg_38() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xA95F, 'V'), + (0xA97D, 'X'), + (0xA980, 'V'), + (0xA9CE, 'X'), + (0xA9CF, 'V'), + (0xA9DA, 'X'), + (0xA9DE, 'V'), + (0xA9FF, 'X'), + (0xAA00, 'V'), + (0xAA37, 'X'), + (0xAA40, 'V'), + (0xAA4E, 'X'), + (0xAA50, 'V'), + (0xAA5A, 'X'), + (0xAA5C, 'V'), + (0xAAC3, 'X'), + (0xAADB, 'V'), + (0xAAF7, 'X'), + (0xAB01, 'V'), + (0xAB07, 'X'), + (0xAB09, 'V'), + (0xAB0F, 'X'), + (0xAB11, 'V'), + (0xAB17, 'X'), + (0xAB20, 'V'), + (0xAB27, 'X'), + (0xAB28, 'V'), + (0xAB2F, 'X'), + (0xAB30, 'V'), + (0xAB5C, 'M', 'ꜧ'), + (0xAB5D, 'M', 'ꬷ'), + (0xAB5E, 'M', 'ɫ'), + (0xAB5F, 'M', 'ꭒ'), + (0xAB60, 'V'), + (0xAB69, 'M', 'ʍ'), + (0xAB6A, 'V'), + (0xAB6C, 'X'), + (0xAB70, 'M', 'Ꭰ'), + (0xAB71, 'M', 'Ꭱ'), + (0xAB72, 'M', 'Ꭲ'), + (0xAB73, 'M', 'Ꭳ'), + (0xAB74, 'M', 'Ꭴ'), + (0xAB75, 'M', 'Ꭵ'), + (0xAB76, 'M', 'Ꭶ'), + (0xAB77, 'M', 'Ꭷ'), + (0xAB78, 'M', 'Ꭸ'), + (0xAB79, 'M', 'Ꭹ'), + (0xAB7A, 'M', 'Ꭺ'), + (0xAB7B, 'M', 'Ꭻ'), + (0xAB7C, 'M', 'Ꭼ'), + (0xAB7D, 'M', 'Ꭽ'), + (0xAB7E, 'M', 'Ꭾ'), + (0xAB7F, 'M', 'Ꭿ'), + (0xAB80, 'M', 'Ꮀ'), + (0xAB81, 'M', 'Ꮁ'), + (0xAB82, 'M', 'Ꮂ'), + (0xAB83, 'M', 'Ꮃ'), + (0xAB84, 'M', 'Ꮄ'), + (0xAB85, 'M', 'Ꮅ'), + (0xAB86, 'M', 'Ꮆ'), + (0xAB87, 'M', 'Ꮇ'), + (0xAB88, 'M', 'Ꮈ'), + (0xAB89, 'M', 'Ꮉ'), + (0xAB8A, 'M', 'Ꮊ'), + (0xAB8B, 'M', 'Ꮋ'), + (0xAB8C, 'M', 'Ꮌ'), + (0xAB8D, 'M', 'Ꮍ'), + (0xAB8E, 'M', 'Ꮎ'), + (0xAB8F, 'M', 'Ꮏ'), + (0xAB90, 'M', 'Ꮐ'), + (0xAB91, 'M', 'Ꮑ'), + (0xAB92, 'M', 'Ꮒ'), + (0xAB93, 'M', 'Ꮓ'), + (0xAB94, 'M', 'Ꮔ'), + (0xAB95, 'M', 'Ꮕ'), + (0xAB96, 'M', 'Ꮖ'), + (0xAB97, 'M', 'Ꮗ'), + (0xAB98, 'M', 'Ꮘ'), + (0xAB99, 'M', 'Ꮙ'), + (0xAB9A, 'M', 'Ꮚ'), + (0xAB9B, 'M', 'Ꮛ'), + (0xAB9C, 'M', 'Ꮜ'), + (0xAB9D, 'M', 'Ꮝ'), + (0xAB9E, 'M', 'Ꮞ'), + (0xAB9F, 'M', 'Ꮟ'), + (0xABA0, 'M', 'Ꮠ'), + (0xABA1, 'M', 'Ꮡ'), + (0xABA2, 'M', 'Ꮢ'), + (0xABA3, 'M', 'Ꮣ'), + (0xABA4, 'M', 'Ꮤ'), + (0xABA5, 'M', 'Ꮥ'), + (0xABA6, 'M', 'Ꮦ'), + (0xABA7, 'M', 'Ꮧ'), + (0xABA8, 'M', 'Ꮨ'), + (0xABA9, 'M', 'Ꮩ'), + (0xABAA, 'M', 'Ꮪ'), + (0xABAB, 'M', 'Ꮫ'), + (0xABAC, 'M', 'Ꮬ'), + (0xABAD, 'M', 'Ꮭ'), + (0xABAE, 'M', 'Ꮮ'), + ] + +def _seg_39() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xABAF, 'M', 'Ꮯ'), + (0xABB0, 'M', 'Ꮰ'), + (0xABB1, 'M', 'Ꮱ'), + (0xABB2, 'M', 'Ꮲ'), + (0xABB3, 'M', 'Ꮳ'), + (0xABB4, 'M', 'Ꮴ'), + (0xABB5, 'M', 'Ꮵ'), + (0xABB6, 'M', 'Ꮶ'), + (0xABB7, 'M', 'Ꮷ'), + (0xABB8, 'M', 'Ꮸ'), + (0xABB9, 'M', 'Ꮹ'), + (0xABBA, 'M', 'Ꮺ'), + (0xABBB, 'M', 'Ꮻ'), + (0xABBC, 'M', 'Ꮼ'), + (0xABBD, 'M', 'Ꮽ'), + (0xABBE, 'M', 'Ꮾ'), + (0xABBF, 'M', 'Ꮿ'), + (0xABC0, 'V'), + (0xABEE, 'X'), + (0xABF0, 'V'), + (0xABFA, 'X'), + (0xAC00, 'V'), + (0xD7A4, 'X'), + (0xD7B0, 'V'), + (0xD7C7, 'X'), + (0xD7CB, 'V'), + (0xD7FC, 'X'), + (0xF900, 'M', '豈'), + (0xF901, 'M', '更'), + (0xF902, 'M', '車'), + (0xF903, 'M', '賈'), + (0xF904, 'M', '滑'), + (0xF905, 'M', '串'), + (0xF906, 'M', '句'), + (0xF907, 'M', '龜'), + (0xF909, 'M', '契'), + (0xF90A, 'M', '金'), + (0xF90B, 'M', '喇'), + (0xF90C, 'M', '奈'), + (0xF90D, 'M', '懶'), + (0xF90E, 'M', '癩'), + (0xF90F, 'M', '羅'), + (0xF910, 'M', '蘿'), + (0xF911, 'M', '螺'), + (0xF912, 'M', '裸'), + (0xF913, 'M', '邏'), + (0xF914, 'M', '樂'), + (0xF915, 'M', '洛'), + (0xF916, 'M', '烙'), + (0xF917, 'M', '珞'), + (0xF918, 'M', '落'), + (0xF919, 'M', '酪'), + (0xF91A, 'M', '駱'), + (0xF91B, 'M', '亂'), + (0xF91C, 'M', '卵'), + (0xF91D, 'M', '欄'), + (0xF91E, 'M', '爛'), + (0xF91F, 'M', '蘭'), + (0xF920, 'M', '鸞'), + (0xF921, 'M', '嵐'), + (0xF922, 'M', '濫'), + (0xF923, 'M', '藍'), + (0xF924, 'M', '襤'), + (0xF925, 'M', '拉'), + (0xF926, 'M', '臘'), + (0xF927, 'M', '蠟'), + (0xF928, 'M', '廊'), + (0xF929, 'M', '朗'), + (0xF92A, 'M', '浪'), + (0xF92B, 'M', '狼'), + (0xF92C, 'M', '郎'), + (0xF92D, 'M', '來'), + (0xF92E, 'M', '冷'), + (0xF92F, 'M', '勞'), + (0xF930, 'M', '擄'), + (0xF931, 'M', '櫓'), + (0xF932, 'M', '爐'), + (0xF933, 'M', '盧'), + (0xF934, 'M', '老'), + (0xF935, 'M', '蘆'), + (0xF936, 'M', '虜'), + (0xF937, 'M', '路'), + (0xF938, 'M', '露'), + (0xF939, 'M', '魯'), + (0xF93A, 'M', '鷺'), + (0xF93B, 'M', '碌'), + (0xF93C, 'M', '祿'), + (0xF93D, 'M', '綠'), + (0xF93E, 'M', '菉'), + (0xF93F, 'M', '錄'), + (0xF940, 'M', '鹿'), + (0xF941, 'M', '論'), + (0xF942, 'M', '壟'), + (0xF943, 'M', '弄'), + (0xF944, 'M', '籠'), + (0xF945, 'M', '聾'), + (0xF946, 'M', '牢'), + (0xF947, 'M', '磊'), + (0xF948, 'M', '賂'), + (0xF949, 'M', '雷'), + ] + +def _seg_40() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xF94A, 'M', '壘'), + (0xF94B, 'M', '屢'), + (0xF94C, 'M', '樓'), + (0xF94D, 'M', '淚'), + (0xF94E, 'M', '漏'), + (0xF94F, 'M', '累'), + (0xF950, 'M', '縷'), + (0xF951, 'M', '陋'), + (0xF952, 'M', '勒'), + (0xF953, 'M', '肋'), + (0xF954, 'M', '凜'), + (0xF955, 'M', '凌'), + (0xF956, 'M', '稜'), + (0xF957, 'M', '綾'), + (0xF958, 'M', '菱'), + (0xF959, 'M', '陵'), + (0xF95A, 'M', '讀'), + (0xF95B, 'M', '拏'), + (0xF95C, 'M', '樂'), + (0xF95D, 'M', '諾'), + (0xF95E, 'M', '丹'), + (0xF95F, 'M', '寧'), + (0xF960, 'M', '怒'), + (0xF961, 'M', '率'), + (0xF962, 'M', '異'), + (0xF963, 'M', '北'), + (0xF964, 'M', '磻'), + (0xF965, 'M', '便'), + (0xF966, 'M', '復'), + (0xF967, 'M', '不'), + (0xF968, 'M', '泌'), + (0xF969, 'M', '數'), + (0xF96A, 'M', '索'), + (0xF96B, 'M', '參'), + (0xF96C, 'M', '塞'), + (0xF96D, 'M', '省'), + (0xF96E, 'M', '葉'), + (0xF96F, 'M', '說'), + (0xF970, 'M', '殺'), + (0xF971, 'M', '辰'), + (0xF972, 'M', '沈'), + (0xF973, 'M', '拾'), + (0xF974, 'M', '若'), + (0xF975, 'M', '掠'), + (0xF976, 'M', '略'), + (0xF977, 'M', '亮'), + (0xF978, 'M', '兩'), + (0xF979, 'M', '凉'), + (0xF97A, 'M', '梁'), + (0xF97B, 'M', '糧'), + (0xF97C, 'M', '良'), + (0xF97D, 'M', '諒'), + (0xF97E, 'M', '量'), + (0xF97F, 'M', '勵'), + (0xF980, 'M', '呂'), + (0xF981, 'M', '女'), + (0xF982, 'M', '廬'), + (0xF983, 'M', '旅'), + (0xF984, 'M', '濾'), + (0xF985, 'M', '礪'), + (0xF986, 'M', '閭'), + (0xF987, 'M', '驪'), + (0xF988, 'M', '麗'), + (0xF989, 'M', '黎'), + (0xF98A, 'M', '力'), + (0xF98B, 'M', '曆'), + (0xF98C, 'M', '歷'), + (0xF98D, 'M', '轢'), + (0xF98E, 'M', '年'), + (0xF98F, 'M', '憐'), + (0xF990, 'M', '戀'), + (0xF991, 'M', '撚'), + (0xF992, 'M', '漣'), + (0xF993, 'M', '煉'), + (0xF994, 'M', '璉'), + (0xF995, 'M', '秊'), + (0xF996, 'M', '練'), + (0xF997, 'M', '聯'), + (0xF998, 'M', '輦'), + (0xF999, 'M', '蓮'), + (0xF99A, 'M', '連'), + (0xF99B, 'M', '鍊'), + (0xF99C, 'M', '列'), + (0xF99D, 'M', '劣'), + (0xF99E, 'M', '咽'), + (0xF99F, 'M', '烈'), + (0xF9A0, 'M', '裂'), + (0xF9A1, 'M', '說'), + (0xF9A2, 'M', '廉'), + (0xF9A3, 'M', '念'), + (0xF9A4, 'M', '捻'), + (0xF9A5, 'M', '殮'), + (0xF9A6, 'M', '簾'), + (0xF9A7, 'M', '獵'), + (0xF9A8, 'M', '令'), + (0xF9A9, 'M', '囹'), + (0xF9AA, 'M', '寧'), + (0xF9AB, 'M', '嶺'), + (0xF9AC, 'M', '怜'), + (0xF9AD, 'M', '玲'), + ] + +def _seg_41() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xF9AE, 'M', '瑩'), + (0xF9AF, 'M', '羚'), + (0xF9B0, 'M', '聆'), + (0xF9B1, 'M', '鈴'), + (0xF9B2, 'M', '零'), + (0xF9B3, 'M', '靈'), + (0xF9B4, 'M', '領'), + (0xF9B5, 'M', '例'), + (0xF9B6, 'M', '禮'), + (0xF9B7, 'M', '醴'), + (0xF9B8, 'M', '隸'), + (0xF9B9, 'M', '惡'), + (0xF9BA, 'M', '了'), + (0xF9BB, 'M', '僚'), + (0xF9BC, 'M', '寮'), + (0xF9BD, 'M', '尿'), + (0xF9BE, 'M', '料'), + (0xF9BF, 'M', '樂'), + (0xF9C0, 'M', '燎'), + (0xF9C1, 'M', '療'), + (0xF9C2, 'M', '蓼'), + (0xF9C3, 'M', '遼'), + (0xF9C4, 'M', '龍'), + (0xF9C5, 'M', '暈'), + (0xF9C6, 'M', '阮'), + (0xF9C7, 'M', '劉'), + (0xF9C8, 'M', '杻'), + (0xF9C9, 'M', '柳'), + (0xF9CA, 'M', '流'), + (0xF9CB, 'M', '溜'), + (0xF9CC, 'M', '琉'), + (0xF9CD, 'M', '留'), + (0xF9CE, 'M', '硫'), + (0xF9CF, 'M', '紐'), + (0xF9D0, 'M', '類'), + (0xF9D1, 'M', '六'), + (0xF9D2, 'M', '戮'), + (0xF9D3, 'M', '陸'), + (0xF9D4, 'M', '倫'), + (0xF9D5, 'M', '崙'), + (0xF9D6, 'M', '淪'), + (0xF9D7, 'M', '輪'), + (0xF9D8, 'M', '律'), + (0xF9D9, 'M', '慄'), + (0xF9DA, 'M', '栗'), + (0xF9DB, 'M', '率'), + (0xF9DC, 'M', '隆'), + (0xF9DD, 'M', '利'), + (0xF9DE, 'M', '吏'), + (0xF9DF, 'M', '履'), + (0xF9E0, 'M', '易'), + (0xF9E1, 'M', '李'), + (0xF9E2, 'M', '梨'), + (0xF9E3, 'M', '泥'), + (0xF9E4, 'M', '理'), + (0xF9E5, 'M', '痢'), + (0xF9E6, 'M', '罹'), + (0xF9E7, 'M', '裏'), + (0xF9E8, 'M', '裡'), + (0xF9E9, 'M', '里'), + (0xF9EA, 'M', '離'), + (0xF9EB, 'M', '匿'), + (0xF9EC, 'M', '溺'), + (0xF9ED, 'M', '吝'), + (0xF9EE, 'M', '燐'), + (0xF9EF, 'M', '璘'), + (0xF9F0, 'M', '藺'), + (0xF9F1, 'M', '隣'), + (0xF9F2, 'M', '鱗'), + (0xF9F3, 'M', '麟'), + (0xF9F4, 'M', '林'), + (0xF9F5, 'M', '淋'), + (0xF9F6, 'M', '臨'), + (0xF9F7, 'M', '立'), + (0xF9F8, 'M', '笠'), + (0xF9F9, 'M', '粒'), + (0xF9FA, 'M', '狀'), + (0xF9FB, 'M', '炙'), + (0xF9FC, 'M', '識'), + (0xF9FD, 'M', '什'), + (0xF9FE, 'M', '茶'), + (0xF9FF, 'M', '刺'), + (0xFA00, 'M', '切'), + (0xFA01, 'M', '度'), + (0xFA02, 'M', '拓'), + (0xFA03, 'M', '糖'), + (0xFA04, 'M', '宅'), + (0xFA05, 'M', '洞'), + (0xFA06, 'M', '暴'), + (0xFA07, 'M', '輻'), + (0xFA08, 'M', '行'), + (0xFA09, 'M', '降'), + (0xFA0A, 'M', '見'), + (0xFA0B, 'M', '廓'), + (0xFA0C, 'M', '兀'), + (0xFA0D, 'M', '嗀'), + (0xFA0E, 'V'), + (0xFA10, 'M', '塚'), + (0xFA11, 'V'), + (0xFA12, 'M', '晴'), + ] + +def _seg_42() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xFA13, 'V'), + (0xFA15, 'M', '凞'), + (0xFA16, 'M', '猪'), + (0xFA17, 'M', '益'), + (0xFA18, 'M', '礼'), + (0xFA19, 'M', '神'), + (0xFA1A, 'M', '祥'), + (0xFA1B, 'M', '福'), + (0xFA1C, 'M', '靖'), + (0xFA1D, 'M', '精'), + (0xFA1E, 'M', '羽'), + (0xFA1F, 'V'), + (0xFA20, 'M', '蘒'), + (0xFA21, 'V'), + (0xFA22, 'M', '諸'), + (0xFA23, 'V'), + (0xFA25, 'M', '逸'), + (0xFA26, 'M', '都'), + (0xFA27, 'V'), + (0xFA2A, 'M', '飯'), + (0xFA2B, 'M', '飼'), + (0xFA2C, 'M', '館'), + (0xFA2D, 'M', '鶴'), + (0xFA2E, 'M', '郞'), + (0xFA2F, 'M', '隷'), + (0xFA30, 'M', '侮'), + (0xFA31, 'M', '僧'), + (0xFA32, 'M', '免'), + (0xFA33, 'M', '勉'), + (0xFA34, 'M', '勤'), + (0xFA35, 'M', '卑'), + (0xFA36, 'M', '喝'), + (0xFA37, 'M', '嘆'), + (0xFA38, 'M', '器'), + (0xFA39, 'M', '塀'), + (0xFA3A, 'M', '墨'), + (0xFA3B, 'M', '層'), + (0xFA3C, 'M', '屮'), + (0xFA3D, 'M', '悔'), + (0xFA3E, 'M', '慨'), + (0xFA3F, 'M', '憎'), + (0xFA40, 'M', '懲'), + (0xFA41, 'M', '敏'), + (0xFA42, 'M', '既'), + (0xFA43, 'M', '暑'), + (0xFA44, 'M', '梅'), + (0xFA45, 'M', '海'), + (0xFA46, 'M', '渚'), + (0xFA47, 'M', '漢'), + (0xFA48, 'M', '煮'), + (0xFA49, 'M', '爫'), + (0xFA4A, 'M', '琢'), + (0xFA4B, 'M', '碑'), + (0xFA4C, 'M', '社'), + (0xFA4D, 'M', '祉'), + (0xFA4E, 'M', '祈'), + (0xFA4F, 'M', '祐'), + (0xFA50, 'M', '祖'), + (0xFA51, 'M', '祝'), + (0xFA52, 'M', '禍'), + (0xFA53, 'M', '禎'), + (0xFA54, 'M', '穀'), + (0xFA55, 'M', '突'), + (0xFA56, 'M', '節'), + (0xFA57, 'M', '練'), + (0xFA58, 'M', '縉'), + (0xFA59, 'M', '繁'), + (0xFA5A, 'M', '署'), + (0xFA5B, 'M', '者'), + (0xFA5C, 'M', '臭'), + (0xFA5D, 'M', '艹'), + (0xFA5F, 'M', '著'), + (0xFA60, 'M', '褐'), + (0xFA61, 'M', '視'), + (0xFA62, 'M', '謁'), + (0xFA63, 'M', '謹'), + (0xFA64, 'M', '賓'), + (0xFA65, 'M', '贈'), + (0xFA66, 'M', '辶'), + (0xFA67, 'M', '逸'), + (0xFA68, 'M', '難'), + (0xFA69, 'M', '響'), + (0xFA6A, 'M', '頻'), + (0xFA6B, 'M', '恵'), + (0xFA6C, 'M', '𤋮'), + (0xFA6D, 'M', '舘'), + (0xFA6E, 'X'), + (0xFA70, 'M', '並'), + (0xFA71, 'M', '况'), + (0xFA72, 'M', '全'), + (0xFA73, 'M', '侀'), + (0xFA74, 'M', '充'), + (0xFA75, 'M', '冀'), + (0xFA76, 'M', '勇'), + (0xFA77, 'M', '勺'), + (0xFA78, 'M', '喝'), + (0xFA79, 'M', '啕'), + (0xFA7A, 'M', '喙'), + (0xFA7B, 'M', '嗢'), + (0xFA7C, 'M', '塚'), + ] + +def _seg_43() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xFA7D, 'M', '墳'), + (0xFA7E, 'M', '奄'), + (0xFA7F, 'M', '奔'), + (0xFA80, 'M', '婢'), + (0xFA81, 'M', '嬨'), + (0xFA82, 'M', '廒'), + (0xFA83, 'M', '廙'), + (0xFA84, 'M', '彩'), + (0xFA85, 'M', '徭'), + (0xFA86, 'M', '惘'), + (0xFA87, 'M', '慎'), + (0xFA88, 'M', '愈'), + (0xFA89, 'M', '憎'), + (0xFA8A, 'M', '慠'), + (0xFA8B, 'M', '懲'), + (0xFA8C, 'M', '戴'), + (0xFA8D, 'M', '揄'), + (0xFA8E, 'M', '搜'), + (0xFA8F, 'M', '摒'), + (0xFA90, 'M', '敖'), + (0xFA91, 'M', '晴'), + (0xFA92, 'M', '朗'), + (0xFA93, 'M', '望'), + (0xFA94, 'M', '杖'), + (0xFA95, 'M', '歹'), + (0xFA96, 'M', '殺'), + (0xFA97, 'M', '流'), + (0xFA98, 'M', '滛'), + (0xFA99, 'M', '滋'), + (0xFA9A, 'M', '漢'), + (0xFA9B, 'M', '瀞'), + (0xFA9C, 'M', '煮'), + (0xFA9D, 'M', '瞧'), + (0xFA9E, 'M', '爵'), + (0xFA9F, 'M', '犯'), + (0xFAA0, 'M', '猪'), + (0xFAA1, 'M', '瑱'), + (0xFAA2, 'M', '甆'), + (0xFAA3, 'M', '画'), + (0xFAA4, 'M', '瘝'), + (0xFAA5, 'M', '瘟'), + (0xFAA6, 'M', '益'), + (0xFAA7, 'M', '盛'), + (0xFAA8, 'M', '直'), + (0xFAA9, 'M', '睊'), + (0xFAAA, 'M', '着'), + (0xFAAB, 'M', '磌'), + (0xFAAC, 'M', '窱'), + (0xFAAD, 'M', '節'), + (0xFAAE, 'M', '类'), + (0xFAAF, 'M', '絛'), + (0xFAB0, 'M', '練'), + (0xFAB1, 'M', '缾'), + (0xFAB2, 'M', '者'), + (0xFAB3, 'M', '荒'), + (0xFAB4, 'M', '華'), + (0xFAB5, 'M', '蝹'), + (0xFAB6, 'M', '襁'), + (0xFAB7, 'M', '覆'), + (0xFAB8, 'M', '視'), + (0xFAB9, 'M', '調'), + (0xFABA, 'M', '諸'), + (0xFABB, 'M', '請'), + (0xFABC, 'M', '謁'), + (0xFABD, 'M', '諾'), + (0xFABE, 'M', '諭'), + (0xFABF, 'M', '謹'), + (0xFAC0, 'M', '變'), + (0xFAC1, 'M', '贈'), + (0xFAC2, 'M', '輸'), + (0xFAC3, 'M', '遲'), + (0xFAC4, 'M', '醙'), + (0xFAC5, 'M', '鉶'), + (0xFAC6, 'M', '陼'), + (0xFAC7, 'M', '難'), + (0xFAC8, 'M', '靖'), + (0xFAC9, 'M', '韛'), + (0xFACA, 'M', '響'), + (0xFACB, 'M', '頋'), + (0xFACC, 'M', '頻'), + (0xFACD, 'M', '鬒'), + (0xFACE, 'M', '龜'), + (0xFACF, 'M', '𢡊'), + (0xFAD0, 'M', '𢡄'), + (0xFAD1, 'M', '𣏕'), + (0xFAD2, 'M', '㮝'), + (0xFAD3, 'M', '䀘'), + (0xFAD4, 'M', '䀹'), + (0xFAD5, 'M', '𥉉'), + (0xFAD6, 'M', '𥳐'), + (0xFAD7, 'M', '𧻓'), + (0xFAD8, 'M', '齃'), + (0xFAD9, 'M', '龎'), + (0xFADA, 'X'), + (0xFB00, 'M', 'ff'), + (0xFB01, 'M', 'fi'), + (0xFB02, 'M', 'fl'), + (0xFB03, 'M', 'ffi'), + (0xFB04, 'M', 'ffl'), + (0xFB05, 'M', 'st'), + ] + +def _seg_44() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xFB07, 'X'), + (0xFB13, 'M', 'մն'), + (0xFB14, 'M', 'մե'), + (0xFB15, 'M', 'մի'), + (0xFB16, 'M', 'վն'), + (0xFB17, 'M', 'մխ'), + (0xFB18, 'X'), + (0xFB1D, 'M', 'יִ'), + (0xFB1E, 'V'), + (0xFB1F, 'M', 'ײַ'), + (0xFB20, 'M', 'ע'), + (0xFB21, 'M', 'א'), + (0xFB22, 'M', 'ד'), + (0xFB23, 'M', 'ה'), + (0xFB24, 'M', 'כ'), + (0xFB25, 'M', 'ל'), + (0xFB26, 'M', 'ם'), + (0xFB27, 'M', 'ר'), + (0xFB28, 'M', 'ת'), + (0xFB29, '3', '+'), + (0xFB2A, 'M', 'שׁ'), + (0xFB2B, 'M', 'שׂ'), + (0xFB2C, 'M', 'שּׁ'), + (0xFB2D, 'M', 'שּׂ'), + (0xFB2E, 'M', 'אַ'), + (0xFB2F, 'M', 'אָ'), + (0xFB30, 'M', 'אּ'), + (0xFB31, 'M', 'בּ'), + (0xFB32, 'M', 'גּ'), + (0xFB33, 'M', 'דּ'), + (0xFB34, 'M', 'הּ'), + (0xFB35, 'M', 'וּ'), + (0xFB36, 'M', 'זּ'), + (0xFB37, 'X'), + (0xFB38, 'M', 'טּ'), + (0xFB39, 'M', 'יּ'), + (0xFB3A, 'M', 'ךּ'), + (0xFB3B, 'M', 'כּ'), + (0xFB3C, 'M', 'לּ'), + (0xFB3D, 'X'), + (0xFB3E, 'M', 'מּ'), + (0xFB3F, 'X'), + (0xFB40, 'M', 'נּ'), + (0xFB41, 'M', 'סּ'), + (0xFB42, 'X'), + (0xFB43, 'M', 'ףּ'), + (0xFB44, 'M', 'פּ'), + (0xFB45, 'X'), + (0xFB46, 'M', 'צּ'), + (0xFB47, 'M', 'קּ'), + (0xFB48, 'M', 'רּ'), + (0xFB49, 'M', 'שּ'), + (0xFB4A, 'M', 'תּ'), + (0xFB4B, 'M', 'וֹ'), + (0xFB4C, 'M', 'בֿ'), + (0xFB4D, 'M', 'כֿ'), + (0xFB4E, 'M', 'פֿ'), + (0xFB4F, 'M', 'אל'), + (0xFB50, 'M', 'ٱ'), + (0xFB52, 'M', 'ٻ'), + (0xFB56, 'M', 'پ'), + (0xFB5A, 'M', 'ڀ'), + (0xFB5E, 'M', 'ٺ'), + (0xFB62, 'M', 'ٿ'), + (0xFB66, 'M', 'ٹ'), + (0xFB6A, 'M', 'ڤ'), + (0xFB6E, 'M', 'ڦ'), + (0xFB72, 'M', 'ڄ'), + (0xFB76, 'M', 'ڃ'), + (0xFB7A, 'M', 'چ'), + (0xFB7E, 'M', 'ڇ'), + (0xFB82, 'M', 'ڍ'), + (0xFB84, 'M', 'ڌ'), + (0xFB86, 'M', 'ڎ'), + (0xFB88, 'M', 'ڈ'), + (0xFB8A, 'M', 'ژ'), + (0xFB8C, 'M', 'ڑ'), + (0xFB8E, 'M', 'ک'), + (0xFB92, 'M', 'گ'), + (0xFB96, 'M', 'ڳ'), + (0xFB9A, 'M', 'ڱ'), + (0xFB9E, 'M', 'ں'), + (0xFBA0, 'M', 'ڻ'), + (0xFBA4, 'M', 'ۀ'), + (0xFBA6, 'M', 'ہ'), + (0xFBAA, 'M', 'ھ'), + (0xFBAE, 'M', 'ے'), + (0xFBB0, 'M', 'ۓ'), + (0xFBB2, 'V'), + (0xFBC3, 'X'), + (0xFBD3, 'M', 'ڭ'), + (0xFBD7, 'M', 'ۇ'), + (0xFBD9, 'M', 'ۆ'), + (0xFBDB, 'M', 'ۈ'), + (0xFBDD, 'M', 'ۇٴ'), + (0xFBDE, 'M', 'ۋ'), + (0xFBE0, 'M', 'ۅ'), + (0xFBE2, 'M', 'ۉ'), + (0xFBE4, 'M', 'ې'), + (0xFBE8, 'M', 'ى'), + ] + +def _seg_45() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xFBEA, 'M', 'ئا'), + (0xFBEC, 'M', 'ئە'), + (0xFBEE, 'M', 'ئو'), + (0xFBF0, 'M', 'ئۇ'), + (0xFBF2, 'M', 'ئۆ'), + (0xFBF4, 'M', 'ئۈ'), + (0xFBF6, 'M', 'ئې'), + (0xFBF9, 'M', 'ئى'), + (0xFBFC, 'M', 'ی'), + (0xFC00, 'M', 'ئج'), + (0xFC01, 'M', 'ئح'), + (0xFC02, 'M', 'ئم'), + (0xFC03, 'M', 'ئى'), + (0xFC04, 'M', 'ئي'), + (0xFC05, 'M', 'بج'), + (0xFC06, 'M', 'بح'), + (0xFC07, 'M', 'بخ'), + (0xFC08, 'M', 'بم'), + (0xFC09, 'M', 'بى'), + (0xFC0A, 'M', 'بي'), + (0xFC0B, 'M', 'تج'), + (0xFC0C, 'M', 'تح'), + (0xFC0D, 'M', 'تخ'), + (0xFC0E, 'M', 'تم'), + (0xFC0F, 'M', 'تى'), + (0xFC10, 'M', 'تي'), + (0xFC11, 'M', 'ثج'), + (0xFC12, 'M', 'ثم'), + (0xFC13, 'M', 'ثى'), + (0xFC14, 'M', 'ثي'), + (0xFC15, 'M', 'جح'), + (0xFC16, 'M', 'جم'), + (0xFC17, 'M', 'حج'), + (0xFC18, 'M', 'حم'), + (0xFC19, 'M', 'خج'), + (0xFC1A, 'M', 'خح'), + (0xFC1B, 'M', 'خم'), + (0xFC1C, 'M', 'سج'), + (0xFC1D, 'M', 'سح'), + (0xFC1E, 'M', 'سخ'), + (0xFC1F, 'M', 'سم'), + (0xFC20, 'M', 'صح'), + (0xFC21, 'M', 'صم'), + (0xFC22, 'M', 'ضج'), + (0xFC23, 'M', 'ضح'), + (0xFC24, 'M', 'ضخ'), + (0xFC25, 'M', 'ضم'), + (0xFC26, 'M', 'طح'), + (0xFC27, 'M', 'طم'), + (0xFC28, 'M', 'ظم'), + (0xFC29, 'M', 'عج'), + (0xFC2A, 'M', 'عم'), + (0xFC2B, 'M', 'غج'), + (0xFC2C, 'M', 'غم'), + (0xFC2D, 'M', 'فج'), + (0xFC2E, 'M', 'فح'), + (0xFC2F, 'M', 'فخ'), + (0xFC30, 'M', 'فم'), + (0xFC31, 'M', 'فى'), + (0xFC32, 'M', 'في'), + (0xFC33, 'M', 'قح'), + (0xFC34, 'M', 'قم'), + (0xFC35, 'M', 'قى'), + (0xFC36, 'M', 'قي'), + (0xFC37, 'M', 'كا'), + (0xFC38, 'M', 'كج'), + (0xFC39, 'M', 'كح'), + (0xFC3A, 'M', 'كخ'), + (0xFC3B, 'M', 'كل'), + (0xFC3C, 'M', 'كم'), + (0xFC3D, 'M', 'كى'), + (0xFC3E, 'M', 'كي'), + (0xFC3F, 'M', 'لج'), + (0xFC40, 'M', 'لح'), + (0xFC41, 'M', 'لخ'), + (0xFC42, 'M', 'لم'), + (0xFC43, 'M', 'لى'), + (0xFC44, 'M', 'لي'), + (0xFC45, 'M', 'مج'), + (0xFC46, 'M', 'مح'), + (0xFC47, 'M', 'مخ'), + (0xFC48, 'M', 'مم'), + (0xFC49, 'M', 'مى'), + (0xFC4A, 'M', 'مي'), + (0xFC4B, 'M', 'نج'), + (0xFC4C, 'M', 'نح'), + (0xFC4D, 'M', 'نخ'), + (0xFC4E, 'M', 'نم'), + (0xFC4F, 'M', 'نى'), + (0xFC50, 'M', 'ني'), + (0xFC51, 'M', 'هج'), + (0xFC52, 'M', 'هم'), + (0xFC53, 'M', 'هى'), + (0xFC54, 'M', 'هي'), + (0xFC55, 'M', 'يج'), + (0xFC56, 'M', 'يح'), + (0xFC57, 'M', 'يخ'), + (0xFC58, 'M', 'يم'), + (0xFC59, 'M', 'يى'), + (0xFC5A, 'M', 'يي'), + ] + +def _seg_46() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xFC5B, 'M', 'ذٰ'), + (0xFC5C, 'M', 'رٰ'), + (0xFC5D, 'M', 'ىٰ'), + (0xFC5E, '3', ' ٌّ'), + (0xFC5F, '3', ' ٍّ'), + (0xFC60, '3', ' َّ'), + (0xFC61, '3', ' ُّ'), + (0xFC62, '3', ' ِّ'), + (0xFC63, '3', ' ّٰ'), + (0xFC64, 'M', 'ئر'), + (0xFC65, 'M', 'ئز'), + (0xFC66, 'M', 'ئم'), + (0xFC67, 'M', 'ئن'), + (0xFC68, 'M', 'ئى'), + (0xFC69, 'M', 'ئي'), + (0xFC6A, 'M', 'بر'), + (0xFC6B, 'M', 'بز'), + (0xFC6C, 'M', 'بم'), + (0xFC6D, 'M', 'بن'), + (0xFC6E, 'M', 'بى'), + (0xFC6F, 'M', 'بي'), + (0xFC70, 'M', 'تر'), + (0xFC71, 'M', 'تز'), + (0xFC72, 'M', 'تم'), + (0xFC73, 'M', 'تن'), + (0xFC74, 'M', 'تى'), + (0xFC75, 'M', 'تي'), + (0xFC76, 'M', 'ثر'), + (0xFC77, 'M', 'ثز'), + (0xFC78, 'M', 'ثم'), + (0xFC79, 'M', 'ثن'), + (0xFC7A, 'M', 'ثى'), + (0xFC7B, 'M', 'ثي'), + (0xFC7C, 'M', 'فى'), + (0xFC7D, 'M', 'في'), + (0xFC7E, 'M', 'قى'), + (0xFC7F, 'M', 'قي'), + (0xFC80, 'M', 'كا'), + (0xFC81, 'M', 'كل'), + (0xFC82, 'M', 'كم'), + (0xFC83, 'M', 'كى'), + (0xFC84, 'M', 'كي'), + (0xFC85, 'M', 'لم'), + (0xFC86, 'M', 'لى'), + (0xFC87, 'M', 'لي'), + (0xFC88, 'M', 'ما'), + (0xFC89, 'M', 'مم'), + (0xFC8A, 'M', 'نر'), + (0xFC8B, 'M', 'نز'), + (0xFC8C, 'M', 'نم'), + (0xFC8D, 'M', 'نن'), + (0xFC8E, 'M', 'نى'), + (0xFC8F, 'M', 'ني'), + (0xFC90, 'M', 'ىٰ'), + (0xFC91, 'M', 'ير'), + (0xFC92, 'M', 'يز'), + (0xFC93, 'M', 'يم'), + (0xFC94, 'M', 'ين'), + (0xFC95, 'M', 'يى'), + (0xFC96, 'M', 'يي'), + (0xFC97, 'M', 'ئج'), + (0xFC98, 'M', 'ئح'), + (0xFC99, 'M', 'ئخ'), + (0xFC9A, 'M', 'ئم'), + (0xFC9B, 'M', 'ئه'), + (0xFC9C, 'M', 'بج'), + (0xFC9D, 'M', 'بح'), + (0xFC9E, 'M', 'بخ'), + (0xFC9F, 'M', 'بم'), + (0xFCA0, 'M', 'به'), + (0xFCA1, 'M', 'تج'), + (0xFCA2, 'M', 'تح'), + (0xFCA3, 'M', 'تخ'), + (0xFCA4, 'M', 'تم'), + (0xFCA5, 'M', 'ته'), + (0xFCA6, 'M', 'ثم'), + (0xFCA7, 'M', 'جح'), + (0xFCA8, 'M', 'جم'), + (0xFCA9, 'M', 'حج'), + (0xFCAA, 'M', 'حم'), + (0xFCAB, 'M', 'خج'), + (0xFCAC, 'M', 'خم'), + (0xFCAD, 'M', 'سج'), + (0xFCAE, 'M', 'سح'), + (0xFCAF, 'M', 'سخ'), + (0xFCB0, 'M', 'سم'), + (0xFCB1, 'M', 'صح'), + (0xFCB2, 'M', 'صخ'), + (0xFCB3, 'M', 'صم'), + (0xFCB4, 'M', 'ضج'), + (0xFCB5, 'M', 'ضح'), + (0xFCB6, 'M', 'ضخ'), + (0xFCB7, 'M', 'ضم'), + (0xFCB8, 'M', 'طح'), + (0xFCB9, 'M', 'ظم'), + (0xFCBA, 'M', 'عج'), + (0xFCBB, 'M', 'عم'), + (0xFCBC, 'M', 'غج'), + (0xFCBD, 'M', 'غم'), + (0xFCBE, 'M', 'فج'), + ] + +def _seg_47() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xFCBF, 'M', 'فح'), + (0xFCC0, 'M', 'فخ'), + (0xFCC1, 'M', 'فم'), + (0xFCC2, 'M', 'قح'), + (0xFCC3, 'M', 'قم'), + (0xFCC4, 'M', 'كج'), + (0xFCC5, 'M', 'كح'), + (0xFCC6, 'M', 'كخ'), + (0xFCC7, 'M', 'كل'), + (0xFCC8, 'M', 'كم'), + (0xFCC9, 'M', 'لج'), + (0xFCCA, 'M', 'لح'), + (0xFCCB, 'M', 'لخ'), + (0xFCCC, 'M', 'لم'), + (0xFCCD, 'M', 'له'), + (0xFCCE, 'M', 'مج'), + (0xFCCF, 'M', 'مح'), + (0xFCD0, 'M', 'مخ'), + (0xFCD1, 'M', 'مم'), + (0xFCD2, 'M', 'نج'), + (0xFCD3, 'M', 'نح'), + (0xFCD4, 'M', 'نخ'), + (0xFCD5, 'M', 'نم'), + (0xFCD6, 'M', 'نه'), + (0xFCD7, 'M', 'هج'), + (0xFCD8, 'M', 'هم'), + (0xFCD9, 'M', 'هٰ'), + (0xFCDA, 'M', 'يج'), + (0xFCDB, 'M', 'يح'), + (0xFCDC, 'M', 'يخ'), + (0xFCDD, 'M', 'يم'), + (0xFCDE, 'M', 'يه'), + (0xFCDF, 'M', 'ئم'), + (0xFCE0, 'M', 'ئه'), + (0xFCE1, 'M', 'بم'), + (0xFCE2, 'M', 'به'), + (0xFCE3, 'M', 'تم'), + (0xFCE4, 'M', 'ته'), + (0xFCE5, 'M', 'ثم'), + (0xFCE6, 'M', 'ثه'), + (0xFCE7, 'M', 'سم'), + (0xFCE8, 'M', 'سه'), + (0xFCE9, 'M', 'شم'), + (0xFCEA, 'M', 'شه'), + (0xFCEB, 'M', 'كل'), + (0xFCEC, 'M', 'كم'), + (0xFCED, 'M', 'لم'), + (0xFCEE, 'M', 'نم'), + (0xFCEF, 'M', 'نه'), + (0xFCF0, 'M', 'يم'), + (0xFCF1, 'M', 'يه'), + (0xFCF2, 'M', 'ـَّ'), + (0xFCF3, 'M', 'ـُّ'), + (0xFCF4, 'M', 'ـِّ'), + (0xFCF5, 'M', 'طى'), + (0xFCF6, 'M', 'طي'), + (0xFCF7, 'M', 'عى'), + (0xFCF8, 'M', 'عي'), + (0xFCF9, 'M', 'غى'), + (0xFCFA, 'M', 'غي'), + (0xFCFB, 'M', 'سى'), + (0xFCFC, 'M', 'سي'), + (0xFCFD, 'M', 'شى'), + (0xFCFE, 'M', 'شي'), + (0xFCFF, 'M', 'حى'), + (0xFD00, 'M', 'حي'), + (0xFD01, 'M', 'جى'), + (0xFD02, 'M', 'جي'), + (0xFD03, 'M', 'خى'), + (0xFD04, 'M', 'خي'), + (0xFD05, 'M', 'صى'), + (0xFD06, 'M', 'صي'), + (0xFD07, 'M', 'ضى'), + (0xFD08, 'M', 'ضي'), + (0xFD09, 'M', 'شج'), + (0xFD0A, 'M', 'شح'), + (0xFD0B, 'M', 'شخ'), + (0xFD0C, 'M', 'شم'), + (0xFD0D, 'M', 'شر'), + (0xFD0E, 'M', 'سر'), + (0xFD0F, 'M', 'صر'), + (0xFD10, 'M', 'ضر'), + (0xFD11, 'M', 'طى'), + (0xFD12, 'M', 'طي'), + (0xFD13, 'M', 'عى'), + (0xFD14, 'M', 'عي'), + (0xFD15, 'M', 'غى'), + (0xFD16, 'M', 'غي'), + (0xFD17, 'M', 'سى'), + (0xFD18, 'M', 'سي'), + (0xFD19, 'M', 'شى'), + (0xFD1A, 'M', 'شي'), + (0xFD1B, 'M', 'حى'), + (0xFD1C, 'M', 'حي'), + (0xFD1D, 'M', 'جى'), + (0xFD1E, 'M', 'جي'), + (0xFD1F, 'M', 'خى'), + (0xFD20, 'M', 'خي'), + (0xFD21, 'M', 'صى'), + (0xFD22, 'M', 'صي'), + ] + +def _seg_48() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xFD23, 'M', 'ضى'), + (0xFD24, 'M', 'ضي'), + (0xFD25, 'M', 'شج'), + (0xFD26, 'M', 'شح'), + (0xFD27, 'M', 'شخ'), + (0xFD28, 'M', 'شم'), + (0xFD29, 'M', 'شر'), + (0xFD2A, 'M', 'سر'), + (0xFD2B, 'M', 'صر'), + (0xFD2C, 'M', 'ضر'), + (0xFD2D, 'M', 'شج'), + (0xFD2E, 'M', 'شح'), + (0xFD2F, 'M', 'شخ'), + (0xFD30, 'M', 'شم'), + (0xFD31, 'M', 'سه'), + (0xFD32, 'M', 'شه'), + (0xFD33, 'M', 'طم'), + (0xFD34, 'M', 'سج'), + (0xFD35, 'M', 'سح'), + (0xFD36, 'M', 'سخ'), + (0xFD37, 'M', 'شج'), + (0xFD38, 'M', 'شح'), + (0xFD39, 'M', 'شخ'), + (0xFD3A, 'M', 'طم'), + (0xFD3B, 'M', 'ظم'), + (0xFD3C, 'M', 'اً'), + (0xFD3E, 'V'), + (0xFD50, 'M', 'تجم'), + (0xFD51, 'M', 'تحج'), + (0xFD53, 'M', 'تحم'), + (0xFD54, 'M', 'تخم'), + (0xFD55, 'M', 'تمج'), + (0xFD56, 'M', 'تمح'), + (0xFD57, 'M', 'تمخ'), + (0xFD58, 'M', 'جمح'), + (0xFD5A, 'M', 'حمي'), + (0xFD5B, 'M', 'حمى'), + (0xFD5C, 'M', 'سحج'), + (0xFD5D, 'M', 'سجح'), + (0xFD5E, 'M', 'سجى'), + (0xFD5F, 'M', 'سمح'), + (0xFD61, 'M', 'سمج'), + (0xFD62, 'M', 'سمم'), + (0xFD64, 'M', 'صحح'), + (0xFD66, 'M', 'صمم'), + (0xFD67, 'M', 'شحم'), + (0xFD69, 'M', 'شجي'), + (0xFD6A, 'M', 'شمخ'), + (0xFD6C, 'M', 'شمم'), + (0xFD6E, 'M', 'ضحى'), + (0xFD6F, 'M', 'ضخم'), + (0xFD71, 'M', 'طمح'), + (0xFD73, 'M', 'طمم'), + (0xFD74, 'M', 'طمي'), + (0xFD75, 'M', 'عجم'), + (0xFD76, 'M', 'عمم'), + (0xFD78, 'M', 'عمى'), + (0xFD79, 'M', 'غمم'), + (0xFD7A, 'M', 'غمي'), + (0xFD7B, 'M', 'غمى'), + (0xFD7C, 'M', 'فخم'), + (0xFD7E, 'M', 'قمح'), + (0xFD7F, 'M', 'قمم'), + (0xFD80, 'M', 'لحم'), + (0xFD81, 'M', 'لحي'), + (0xFD82, 'M', 'لحى'), + (0xFD83, 'M', 'لجج'), + (0xFD85, 'M', 'لخم'), + (0xFD87, 'M', 'لمح'), + (0xFD89, 'M', 'محج'), + (0xFD8A, 'M', 'محم'), + (0xFD8B, 'M', 'محي'), + (0xFD8C, 'M', 'مجح'), + (0xFD8D, 'M', 'مجم'), + (0xFD8E, 'M', 'مخج'), + (0xFD8F, 'M', 'مخم'), + (0xFD90, 'X'), + (0xFD92, 'M', 'مجخ'), + (0xFD93, 'M', 'همج'), + (0xFD94, 'M', 'همم'), + (0xFD95, 'M', 'نحم'), + (0xFD96, 'M', 'نحى'), + (0xFD97, 'M', 'نجم'), + (0xFD99, 'M', 'نجى'), + (0xFD9A, 'M', 'نمي'), + (0xFD9B, 'M', 'نمى'), + (0xFD9C, 'M', 'يمم'), + (0xFD9E, 'M', 'بخي'), + (0xFD9F, 'M', 'تجي'), + (0xFDA0, 'M', 'تجى'), + (0xFDA1, 'M', 'تخي'), + (0xFDA2, 'M', 'تخى'), + (0xFDA3, 'M', 'تمي'), + (0xFDA4, 'M', 'تمى'), + (0xFDA5, 'M', 'جمي'), + (0xFDA6, 'M', 'جحى'), + (0xFDA7, 'M', 'جمى'), + (0xFDA8, 'M', 'سخى'), + (0xFDA9, 'M', 'صحي'), + (0xFDAA, 'M', 'شحي'), + ] + +def _seg_49() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xFDAB, 'M', 'ضحي'), + (0xFDAC, 'M', 'لجي'), + (0xFDAD, 'M', 'لمي'), + (0xFDAE, 'M', 'يحي'), + (0xFDAF, 'M', 'يجي'), + (0xFDB0, 'M', 'يمي'), + (0xFDB1, 'M', 'ممي'), + (0xFDB2, 'M', 'قمي'), + (0xFDB3, 'M', 'نحي'), + (0xFDB4, 'M', 'قمح'), + (0xFDB5, 'M', 'لحم'), + (0xFDB6, 'M', 'عمي'), + (0xFDB7, 'M', 'كمي'), + (0xFDB8, 'M', 'نجح'), + (0xFDB9, 'M', 'مخي'), + (0xFDBA, 'M', 'لجم'), + (0xFDBB, 'M', 'كمم'), + (0xFDBC, 'M', 'لجم'), + (0xFDBD, 'M', 'نجح'), + (0xFDBE, 'M', 'جحي'), + (0xFDBF, 'M', 'حجي'), + (0xFDC0, 'M', 'مجي'), + (0xFDC1, 'M', 'فمي'), + (0xFDC2, 'M', 'بحي'), + (0xFDC3, 'M', 'كمم'), + (0xFDC4, 'M', 'عجم'), + (0xFDC5, 'M', 'صمم'), + (0xFDC6, 'M', 'سخي'), + (0xFDC7, 'M', 'نجي'), + (0xFDC8, 'X'), + (0xFDCF, 'V'), + (0xFDD0, 'X'), + (0xFDF0, 'M', 'صلے'), + (0xFDF1, 'M', 'قلے'), + (0xFDF2, 'M', 'الله'), + (0xFDF3, 'M', 'اكبر'), + (0xFDF4, 'M', 'محمد'), + (0xFDF5, 'M', 'صلعم'), + (0xFDF6, 'M', 'رسول'), + (0xFDF7, 'M', 'عليه'), + (0xFDF8, 'M', 'وسلم'), + (0xFDF9, 'M', 'صلى'), + (0xFDFA, '3', 'صلى الله عليه وسلم'), + (0xFDFB, '3', 'جل جلاله'), + (0xFDFC, 'M', 'ریال'), + (0xFDFD, 'V'), + (0xFE00, 'I'), + (0xFE10, '3', ','), + (0xFE11, 'M', '、'), + (0xFE12, 'X'), + (0xFE13, '3', ':'), + (0xFE14, '3', ';'), + (0xFE15, '3', '!'), + (0xFE16, '3', '?'), + (0xFE17, 'M', '〖'), + (0xFE18, 'M', '〗'), + (0xFE19, 'X'), + (0xFE20, 'V'), + (0xFE30, 'X'), + (0xFE31, 'M', '—'), + (0xFE32, 'M', '–'), + (0xFE33, '3', '_'), + (0xFE35, '3', '('), + (0xFE36, '3', ')'), + (0xFE37, '3', '{'), + (0xFE38, '3', '}'), + (0xFE39, 'M', '〔'), + (0xFE3A, 'M', '〕'), + (0xFE3B, 'M', '【'), + (0xFE3C, 'M', '】'), + (0xFE3D, 'M', '《'), + (0xFE3E, 'M', '》'), + (0xFE3F, 'M', '〈'), + (0xFE40, 'M', '〉'), + (0xFE41, 'M', '「'), + (0xFE42, 'M', '」'), + (0xFE43, 'M', '『'), + (0xFE44, 'M', '』'), + (0xFE45, 'V'), + (0xFE47, '3', '['), + (0xFE48, '3', ']'), + (0xFE49, '3', ' ̅'), + (0xFE4D, '3', '_'), + (0xFE50, '3', ','), + (0xFE51, 'M', '、'), + (0xFE52, 'X'), + (0xFE54, '3', ';'), + (0xFE55, '3', ':'), + (0xFE56, '3', '?'), + (0xFE57, '3', '!'), + (0xFE58, 'M', '—'), + (0xFE59, '3', '('), + (0xFE5A, '3', ')'), + (0xFE5B, '3', '{'), + (0xFE5C, '3', '}'), + (0xFE5D, 'M', '〔'), + (0xFE5E, 'M', '〕'), + (0xFE5F, '3', '#'), + (0xFE60, '3', '&'), + (0xFE61, '3', '*'), + ] + +def _seg_50() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xFE62, '3', '+'), + (0xFE63, 'M', '-'), + (0xFE64, '3', '<'), + (0xFE65, '3', '>'), + (0xFE66, '3', '='), + (0xFE67, 'X'), + (0xFE68, '3', '\\'), + (0xFE69, '3', '$'), + (0xFE6A, '3', '%'), + (0xFE6B, '3', '@'), + (0xFE6C, 'X'), + (0xFE70, '3', ' ً'), + (0xFE71, 'M', 'ـً'), + (0xFE72, '3', ' ٌ'), + (0xFE73, 'V'), + (0xFE74, '3', ' ٍ'), + (0xFE75, 'X'), + (0xFE76, '3', ' َ'), + (0xFE77, 'M', 'ـَ'), + (0xFE78, '3', ' ُ'), + (0xFE79, 'M', 'ـُ'), + (0xFE7A, '3', ' ِ'), + (0xFE7B, 'M', 'ـِ'), + (0xFE7C, '3', ' ّ'), + (0xFE7D, 'M', 'ـّ'), + (0xFE7E, '3', ' ْ'), + (0xFE7F, 'M', 'ـْ'), + (0xFE80, 'M', 'ء'), + (0xFE81, 'M', 'آ'), + (0xFE83, 'M', 'أ'), + (0xFE85, 'M', 'ؤ'), + (0xFE87, 'M', 'إ'), + (0xFE89, 'M', 'ئ'), + (0xFE8D, 'M', 'ا'), + (0xFE8F, 'M', 'ب'), + (0xFE93, 'M', 'ة'), + (0xFE95, 'M', 'ت'), + (0xFE99, 'M', 'ث'), + (0xFE9D, 'M', 'ج'), + (0xFEA1, 'M', 'ح'), + (0xFEA5, 'M', 'خ'), + (0xFEA9, 'M', 'د'), + (0xFEAB, 'M', 'ذ'), + (0xFEAD, 'M', 'ر'), + (0xFEAF, 'M', 'ز'), + (0xFEB1, 'M', 'س'), + (0xFEB5, 'M', 'ش'), + (0xFEB9, 'M', 'ص'), + (0xFEBD, 'M', 'ض'), + (0xFEC1, 'M', 'ط'), + (0xFEC5, 'M', 'ظ'), + (0xFEC9, 'M', 'ع'), + (0xFECD, 'M', 'غ'), + (0xFED1, 'M', 'ف'), + (0xFED5, 'M', 'ق'), + (0xFED9, 'M', 'ك'), + (0xFEDD, 'M', 'ل'), + (0xFEE1, 'M', 'م'), + (0xFEE5, 'M', 'ن'), + (0xFEE9, 'M', 'ه'), + (0xFEED, 'M', 'و'), + (0xFEEF, 'M', 'ى'), + (0xFEF1, 'M', 'ي'), + (0xFEF5, 'M', 'لآ'), + (0xFEF7, 'M', 'لأ'), + (0xFEF9, 'M', 'لإ'), + (0xFEFB, 'M', 'لا'), + (0xFEFD, 'X'), + (0xFEFF, 'I'), + (0xFF00, 'X'), + (0xFF01, '3', '!'), + (0xFF02, '3', '"'), + (0xFF03, '3', '#'), + (0xFF04, '3', '$'), + (0xFF05, '3', '%'), + (0xFF06, '3', '&'), + (0xFF07, '3', '\''), + (0xFF08, '3', '('), + (0xFF09, '3', ')'), + (0xFF0A, '3', '*'), + (0xFF0B, '3', '+'), + (0xFF0C, '3', ','), + (0xFF0D, 'M', '-'), + (0xFF0E, 'M', '.'), + (0xFF0F, '3', '/'), + (0xFF10, 'M', '0'), + (0xFF11, 'M', '1'), + (0xFF12, 'M', '2'), + (0xFF13, 'M', '3'), + (0xFF14, 'M', '4'), + (0xFF15, 'M', '5'), + (0xFF16, 'M', '6'), + (0xFF17, 'M', '7'), + (0xFF18, 'M', '8'), + (0xFF19, 'M', '9'), + (0xFF1A, '3', ':'), + (0xFF1B, '3', ';'), + (0xFF1C, '3', '<'), + (0xFF1D, '3', '='), + (0xFF1E, '3', '>'), + ] + +def _seg_51() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xFF1F, '3', '?'), + (0xFF20, '3', '@'), + (0xFF21, 'M', 'a'), + (0xFF22, 'M', 'b'), + (0xFF23, 'M', 'c'), + (0xFF24, 'M', 'd'), + (0xFF25, 'M', 'e'), + (0xFF26, 'M', 'f'), + (0xFF27, 'M', 'g'), + (0xFF28, 'M', 'h'), + (0xFF29, 'M', 'i'), + (0xFF2A, 'M', 'j'), + (0xFF2B, 'M', 'k'), + (0xFF2C, 'M', 'l'), + (0xFF2D, 'M', 'm'), + (0xFF2E, 'M', 'n'), + (0xFF2F, 'M', 'o'), + (0xFF30, 'M', 'p'), + (0xFF31, 'M', 'q'), + (0xFF32, 'M', 'r'), + (0xFF33, 'M', 's'), + (0xFF34, 'M', 't'), + (0xFF35, 'M', 'u'), + (0xFF36, 'M', 'v'), + (0xFF37, 'M', 'w'), + (0xFF38, 'M', 'x'), + (0xFF39, 'M', 'y'), + (0xFF3A, 'M', 'z'), + (0xFF3B, '3', '['), + (0xFF3C, '3', '\\'), + (0xFF3D, '3', ']'), + (0xFF3E, '3', '^'), + (0xFF3F, '3', '_'), + (0xFF40, '3', '`'), + (0xFF41, 'M', 'a'), + (0xFF42, 'M', 'b'), + (0xFF43, 'M', 'c'), + (0xFF44, 'M', 'd'), + (0xFF45, 'M', 'e'), + (0xFF46, 'M', 'f'), + (0xFF47, 'M', 'g'), + (0xFF48, 'M', 'h'), + (0xFF49, 'M', 'i'), + (0xFF4A, 'M', 'j'), + (0xFF4B, 'M', 'k'), + (0xFF4C, 'M', 'l'), + (0xFF4D, 'M', 'm'), + (0xFF4E, 'M', 'n'), + (0xFF4F, 'M', 'o'), + (0xFF50, 'M', 'p'), + (0xFF51, 'M', 'q'), + (0xFF52, 'M', 'r'), + (0xFF53, 'M', 's'), + (0xFF54, 'M', 't'), + (0xFF55, 'M', 'u'), + (0xFF56, 'M', 'v'), + (0xFF57, 'M', 'w'), + (0xFF58, 'M', 'x'), + (0xFF59, 'M', 'y'), + (0xFF5A, 'M', 'z'), + (0xFF5B, '3', '{'), + (0xFF5C, '3', '|'), + (0xFF5D, '3', '}'), + (0xFF5E, '3', '~'), + (0xFF5F, 'M', '⦅'), + (0xFF60, 'M', '⦆'), + (0xFF61, 'M', '.'), + (0xFF62, 'M', '「'), + (0xFF63, 'M', '」'), + (0xFF64, 'M', '、'), + (0xFF65, 'M', '・'), + (0xFF66, 'M', 'ヲ'), + (0xFF67, 'M', 'ァ'), + (0xFF68, 'M', 'ィ'), + (0xFF69, 'M', 'ゥ'), + (0xFF6A, 'M', 'ェ'), + (0xFF6B, 'M', 'ォ'), + (0xFF6C, 'M', 'ャ'), + (0xFF6D, 'M', 'ュ'), + (0xFF6E, 'M', 'ョ'), + (0xFF6F, 'M', 'ッ'), + (0xFF70, 'M', 'ー'), + (0xFF71, 'M', 'ア'), + (0xFF72, 'M', 'イ'), + (0xFF73, 'M', 'ウ'), + (0xFF74, 'M', 'エ'), + (0xFF75, 'M', 'オ'), + (0xFF76, 'M', 'カ'), + (0xFF77, 'M', 'キ'), + (0xFF78, 'M', 'ク'), + (0xFF79, 'M', 'ケ'), + (0xFF7A, 'M', 'コ'), + (0xFF7B, 'M', 'サ'), + (0xFF7C, 'M', 'シ'), + (0xFF7D, 'M', 'ス'), + (0xFF7E, 'M', 'セ'), + (0xFF7F, 'M', 'ソ'), + (0xFF80, 'M', 'タ'), + (0xFF81, 'M', 'チ'), + (0xFF82, 'M', 'ツ'), + ] + +def _seg_52() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xFF83, 'M', 'テ'), + (0xFF84, 'M', 'ト'), + (0xFF85, 'M', 'ナ'), + (0xFF86, 'M', 'ニ'), + (0xFF87, 'M', 'ヌ'), + (0xFF88, 'M', 'ネ'), + (0xFF89, 'M', 'ノ'), + (0xFF8A, 'M', 'ハ'), + (0xFF8B, 'M', 'ヒ'), + (0xFF8C, 'M', 'フ'), + (0xFF8D, 'M', 'ヘ'), + (0xFF8E, 'M', 'ホ'), + (0xFF8F, 'M', 'マ'), + (0xFF90, 'M', 'ミ'), + (0xFF91, 'M', 'ム'), + (0xFF92, 'M', 'メ'), + (0xFF93, 'M', 'モ'), + (0xFF94, 'M', 'ヤ'), + (0xFF95, 'M', 'ユ'), + (0xFF96, 'M', 'ヨ'), + (0xFF97, 'M', 'ラ'), + (0xFF98, 'M', 'リ'), + (0xFF99, 'M', 'ル'), + (0xFF9A, 'M', 'レ'), + (0xFF9B, 'M', 'ロ'), + (0xFF9C, 'M', 'ワ'), + (0xFF9D, 'M', 'ン'), + (0xFF9E, 'M', '゙'), + (0xFF9F, 'M', '゚'), + (0xFFA0, 'X'), + (0xFFA1, 'M', 'ᄀ'), + (0xFFA2, 'M', 'ᄁ'), + (0xFFA3, 'M', 'ᆪ'), + (0xFFA4, 'M', 'ᄂ'), + (0xFFA5, 'M', 'ᆬ'), + (0xFFA6, 'M', 'ᆭ'), + (0xFFA7, 'M', 'ᄃ'), + (0xFFA8, 'M', 'ᄄ'), + (0xFFA9, 'M', 'ᄅ'), + (0xFFAA, 'M', 'ᆰ'), + (0xFFAB, 'M', 'ᆱ'), + (0xFFAC, 'M', 'ᆲ'), + (0xFFAD, 'M', 'ᆳ'), + (0xFFAE, 'M', 'ᆴ'), + (0xFFAF, 'M', 'ᆵ'), + (0xFFB0, 'M', 'ᄚ'), + (0xFFB1, 'M', 'ᄆ'), + (0xFFB2, 'M', 'ᄇ'), + (0xFFB3, 'M', 'ᄈ'), + (0xFFB4, 'M', 'ᄡ'), + (0xFFB5, 'M', 'ᄉ'), + (0xFFB6, 'M', 'ᄊ'), + (0xFFB7, 'M', 'ᄋ'), + (0xFFB8, 'M', 'ᄌ'), + (0xFFB9, 'M', 'ᄍ'), + (0xFFBA, 'M', 'ᄎ'), + (0xFFBB, 'M', 'ᄏ'), + (0xFFBC, 'M', 'ᄐ'), + (0xFFBD, 'M', 'ᄑ'), + (0xFFBE, 'M', 'ᄒ'), + (0xFFBF, 'X'), + (0xFFC2, 'M', 'ᅡ'), + (0xFFC3, 'M', 'ᅢ'), + (0xFFC4, 'M', 'ᅣ'), + (0xFFC5, 'M', 'ᅤ'), + (0xFFC6, 'M', 'ᅥ'), + (0xFFC7, 'M', 'ᅦ'), + (0xFFC8, 'X'), + (0xFFCA, 'M', 'ᅧ'), + (0xFFCB, 'M', 'ᅨ'), + (0xFFCC, 'M', 'ᅩ'), + (0xFFCD, 'M', 'ᅪ'), + (0xFFCE, 'M', 'ᅫ'), + (0xFFCF, 'M', 'ᅬ'), + (0xFFD0, 'X'), + (0xFFD2, 'M', 'ᅭ'), + (0xFFD3, 'M', 'ᅮ'), + (0xFFD4, 'M', 'ᅯ'), + (0xFFD5, 'M', 'ᅰ'), + (0xFFD6, 'M', 'ᅱ'), + (0xFFD7, 'M', 'ᅲ'), + (0xFFD8, 'X'), + (0xFFDA, 'M', 'ᅳ'), + (0xFFDB, 'M', 'ᅴ'), + (0xFFDC, 'M', 'ᅵ'), + (0xFFDD, 'X'), + (0xFFE0, 'M', '¢'), + (0xFFE1, 'M', '£'), + (0xFFE2, 'M', '¬'), + (0xFFE3, '3', ' ̄'), + (0xFFE4, 'M', '¦'), + (0xFFE5, 'M', '¥'), + (0xFFE6, 'M', '₩'), + (0xFFE7, 'X'), + (0xFFE8, 'M', '│'), + (0xFFE9, 'M', '←'), + (0xFFEA, 'M', '↑'), + (0xFFEB, 'M', '→'), + (0xFFEC, 'M', '↓'), + (0xFFED, 'M', '■'), + ] + +def _seg_53() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xFFEE, 'M', '○'), + (0xFFEF, 'X'), + (0x10000, 'V'), + (0x1000C, 'X'), + (0x1000D, 'V'), + (0x10027, 'X'), + (0x10028, 'V'), + (0x1003B, 'X'), + (0x1003C, 'V'), + (0x1003E, 'X'), + (0x1003F, 'V'), + (0x1004E, 'X'), + (0x10050, 'V'), + (0x1005E, 'X'), + (0x10080, 'V'), + (0x100FB, 'X'), + (0x10100, 'V'), + (0x10103, 'X'), + (0x10107, 'V'), + (0x10134, 'X'), + (0x10137, 'V'), + (0x1018F, 'X'), + (0x10190, 'V'), + (0x1019D, 'X'), + (0x101A0, 'V'), + (0x101A1, 'X'), + (0x101D0, 'V'), + (0x101FE, 'X'), + (0x10280, 'V'), + (0x1029D, 'X'), + (0x102A0, 'V'), + (0x102D1, 'X'), + (0x102E0, 'V'), + (0x102FC, 'X'), + (0x10300, 'V'), + (0x10324, 'X'), + (0x1032D, 'V'), + (0x1034B, 'X'), + (0x10350, 'V'), + (0x1037B, 'X'), + (0x10380, 'V'), + (0x1039E, 'X'), + (0x1039F, 'V'), + (0x103C4, 'X'), + (0x103C8, 'V'), + (0x103D6, 'X'), + (0x10400, 'M', '𐐨'), + (0x10401, 'M', '𐐩'), + (0x10402, 'M', '𐐪'), + (0x10403, 'M', '𐐫'), + (0x10404, 'M', '𐐬'), + (0x10405, 'M', '𐐭'), + (0x10406, 'M', '𐐮'), + (0x10407, 'M', '𐐯'), + (0x10408, 'M', '𐐰'), + (0x10409, 'M', '𐐱'), + (0x1040A, 'M', '𐐲'), + (0x1040B, 'M', '𐐳'), + (0x1040C, 'M', '𐐴'), + (0x1040D, 'M', '𐐵'), + (0x1040E, 'M', '𐐶'), + (0x1040F, 'M', '𐐷'), + (0x10410, 'M', '𐐸'), + (0x10411, 'M', '𐐹'), + (0x10412, 'M', '𐐺'), + (0x10413, 'M', '𐐻'), + (0x10414, 'M', '𐐼'), + (0x10415, 'M', '𐐽'), + (0x10416, 'M', '𐐾'), + (0x10417, 'M', '𐐿'), + (0x10418, 'M', '𐑀'), + (0x10419, 'M', '𐑁'), + (0x1041A, 'M', '𐑂'), + (0x1041B, 'M', '𐑃'), + (0x1041C, 'M', '𐑄'), + (0x1041D, 'M', '𐑅'), + (0x1041E, 'M', '𐑆'), + (0x1041F, 'M', '𐑇'), + (0x10420, 'M', '𐑈'), + (0x10421, 'M', '𐑉'), + (0x10422, 'M', '𐑊'), + (0x10423, 'M', '𐑋'), + (0x10424, 'M', '𐑌'), + (0x10425, 'M', '𐑍'), + (0x10426, 'M', '𐑎'), + (0x10427, 'M', '𐑏'), + (0x10428, 'V'), + (0x1049E, 'X'), + (0x104A0, 'V'), + (0x104AA, 'X'), + (0x104B0, 'M', '𐓘'), + (0x104B1, 'M', '𐓙'), + (0x104B2, 'M', '𐓚'), + (0x104B3, 'M', '𐓛'), + (0x104B4, 'M', '𐓜'), + (0x104B5, 'M', '𐓝'), + (0x104B6, 'M', '𐓞'), + (0x104B7, 'M', '𐓟'), + (0x104B8, 'M', '𐓠'), + (0x104B9, 'M', '𐓡'), + ] + +def _seg_54() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x104BA, 'M', '𐓢'), + (0x104BB, 'M', '𐓣'), + (0x104BC, 'M', '𐓤'), + (0x104BD, 'M', '𐓥'), + (0x104BE, 'M', '𐓦'), + (0x104BF, 'M', '𐓧'), + (0x104C0, 'M', '𐓨'), + (0x104C1, 'M', '𐓩'), + (0x104C2, 'M', '𐓪'), + (0x104C3, 'M', '𐓫'), + (0x104C4, 'M', '𐓬'), + (0x104C5, 'M', '𐓭'), + (0x104C6, 'M', '𐓮'), + (0x104C7, 'M', '𐓯'), + (0x104C8, 'M', '𐓰'), + (0x104C9, 'M', '𐓱'), + (0x104CA, 'M', '𐓲'), + (0x104CB, 'M', '𐓳'), + (0x104CC, 'M', '𐓴'), + (0x104CD, 'M', '𐓵'), + (0x104CE, 'M', '𐓶'), + (0x104CF, 'M', '𐓷'), + (0x104D0, 'M', '𐓸'), + (0x104D1, 'M', '𐓹'), + (0x104D2, 'M', '𐓺'), + (0x104D3, 'M', '𐓻'), + (0x104D4, 'X'), + (0x104D8, 'V'), + (0x104FC, 'X'), + (0x10500, 'V'), + (0x10528, 'X'), + (0x10530, 'V'), + (0x10564, 'X'), + (0x1056F, 'V'), + (0x10570, 'M', '𐖗'), + (0x10571, 'M', '𐖘'), + (0x10572, 'M', '𐖙'), + (0x10573, 'M', '𐖚'), + (0x10574, 'M', '𐖛'), + (0x10575, 'M', '𐖜'), + (0x10576, 'M', '𐖝'), + (0x10577, 'M', '𐖞'), + (0x10578, 'M', '𐖟'), + (0x10579, 'M', '𐖠'), + (0x1057A, 'M', '𐖡'), + (0x1057B, 'X'), + (0x1057C, 'M', '𐖣'), + (0x1057D, 'M', '𐖤'), + (0x1057E, 'M', '𐖥'), + (0x1057F, 'M', '𐖦'), + (0x10580, 'M', '𐖧'), + (0x10581, 'M', '𐖨'), + (0x10582, 'M', '𐖩'), + (0x10583, 'M', '𐖪'), + (0x10584, 'M', '𐖫'), + (0x10585, 'M', '𐖬'), + (0x10586, 'M', '𐖭'), + (0x10587, 'M', '𐖮'), + (0x10588, 'M', '𐖯'), + (0x10589, 'M', '𐖰'), + (0x1058A, 'M', '𐖱'), + (0x1058B, 'X'), + (0x1058C, 'M', '𐖳'), + (0x1058D, 'M', '𐖴'), + (0x1058E, 'M', '𐖵'), + (0x1058F, 'M', '𐖶'), + (0x10590, 'M', '𐖷'), + (0x10591, 'M', '𐖸'), + (0x10592, 'M', '𐖹'), + (0x10593, 'X'), + (0x10594, 'M', '𐖻'), + (0x10595, 'M', '𐖼'), + (0x10596, 'X'), + (0x10597, 'V'), + (0x105A2, 'X'), + (0x105A3, 'V'), + (0x105B2, 'X'), + (0x105B3, 'V'), + (0x105BA, 'X'), + (0x105BB, 'V'), + (0x105BD, 'X'), + (0x10600, 'V'), + (0x10737, 'X'), + (0x10740, 'V'), + (0x10756, 'X'), + (0x10760, 'V'), + (0x10768, 'X'), + (0x10780, 'V'), + (0x10781, 'M', 'ː'), + (0x10782, 'M', 'ˑ'), + (0x10783, 'M', 'æ'), + (0x10784, 'M', 'ʙ'), + (0x10785, 'M', 'ɓ'), + (0x10786, 'X'), + (0x10787, 'M', 'ʣ'), + (0x10788, 'M', 'ꭦ'), + (0x10789, 'M', 'ʥ'), + (0x1078A, 'M', 'ʤ'), + (0x1078B, 'M', 'ɖ'), + (0x1078C, 'M', 'ɗ'), + ] + +def _seg_55() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1078D, 'M', 'ᶑ'), + (0x1078E, 'M', 'ɘ'), + (0x1078F, 'M', 'ɞ'), + (0x10790, 'M', 'ʩ'), + (0x10791, 'M', 'ɤ'), + (0x10792, 'M', 'ɢ'), + (0x10793, 'M', 'ɠ'), + (0x10794, 'M', 'ʛ'), + (0x10795, 'M', 'ħ'), + (0x10796, 'M', 'ʜ'), + (0x10797, 'M', 'ɧ'), + (0x10798, 'M', 'ʄ'), + (0x10799, 'M', 'ʪ'), + (0x1079A, 'M', 'ʫ'), + (0x1079B, 'M', 'ɬ'), + (0x1079C, 'M', '𝼄'), + (0x1079D, 'M', 'ꞎ'), + (0x1079E, 'M', 'ɮ'), + (0x1079F, 'M', '𝼅'), + (0x107A0, 'M', 'ʎ'), + (0x107A1, 'M', '𝼆'), + (0x107A2, 'M', 'ø'), + (0x107A3, 'M', 'ɶ'), + (0x107A4, 'M', 'ɷ'), + (0x107A5, 'M', 'q'), + (0x107A6, 'M', 'ɺ'), + (0x107A7, 'M', '𝼈'), + (0x107A8, 'M', 'ɽ'), + (0x107A9, 'M', 'ɾ'), + (0x107AA, 'M', 'ʀ'), + (0x107AB, 'M', 'ʨ'), + (0x107AC, 'M', 'ʦ'), + (0x107AD, 'M', 'ꭧ'), + (0x107AE, 'M', 'ʧ'), + (0x107AF, 'M', 'ʈ'), + (0x107B0, 'M', 'ⱱ'), + (0x107B1, 'X'), + (0x107B2, 'M', 'ʏ'), + (0x107B3, 'M', 'ʡ'), + (0x107B4, 'M', 'ʢ'), + (0x107B5, 'M', 'ʘ'), + (0x107B6, 'M', 'ǀ'), + (0x107B7, 'M', 'ǁ'), + (0x107B8, 'M', 'ǂ'), + (0x107B9, 'M', '𝼊'), + (0x107BA, 'M', '𝼞'), + (0x107BB, 'X'), + (0x10800, 'V'), + (0x10806, 'X'), + (0x10808, 'V'), + (0x10809, 'X'), + (0x1080A, 'V'), + (0x10836, 'X'), + (0x10837, 'V'), + (0x10839, 'X'), + (0x1083C, 'V'), + (0x1083D, 'X'), + (0x1083F, 'V'), + (0x10856, 'X'), + (0x10857, 'V'), + (0x1089F, 'X'), + (0x108A7, 'V'), + (0x108B0, 'X'), + (0x108E0, 'V'), + (0x108F3, 'X'), + (0x108F4, 'V'), + (0x108F6, 'X'), + (0x108FB, 'V'), + (0x1091C, 'X'), + (0x1091F, 'V'), + (0x1093A, 'X'), + (0x1093F, 'V'), + (0x10940, 'X'), + (0x10980, 'V'), + (0x109B8, 'X'), + (0x109BC, 'V'), + (0x109D0, 'X'), + (0x109D2, 'V'), + (0x10A04, 'X'), + (0x10A05, 'V'), + (0x10A07, 'X'), + (0x10A0C, 'V'), + (0x10A14, 'X'), + (0x10A15, 'V'), + (0x10A18, 'X'), + (0x10A19, 'V'), + (0x10A36, 'X'), + (0x10A38, 'V'), + (0x10A3B, 'X'), + (0x10A3F, 'V'), + (0x10A49, 'X'), + (0x10A50, 'V'), + (0x10A59, 'X'), + (0x10A60, 'V'), + (0x10AA0, 'X'), + (0x10AC0, 'V'), + (0x10AE7, 'X'), + (0x10AEB, 'V'), + (0x10AF7, 'X'), + (0x10B00, 'V'), + ] + +def _seg_56() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x10B36, 'X'), + (0x10B39, 'V'), + (0x10B56, 'X'), + (0x10B58, 'V'), + (0x10B73, 'X'), + (0x10B78, 'V'), + (0x10B92, 'X'), + (0x10B99, 'V'), + (0x10B9D, 'X'), + (0x10BA9, 'V'), + (0x10BB0, 'X'), + (0x10C00, 'V'), + (0x10C49, 'X'), + (0x10C80, 'M', '𐳀'), + (0x10C81, 'M', '𐳁'), + (0x10C82, 'M', '𐳂'), + (0x10C83, 'M', '𐳃'), + (0x10C84, 'M', '𐳄'), + (0x10C85, 'M', '𐳅'), + (0x10C86, 'M', '𐳆'), + (0x10C87, 'M', '𐳇'), + (0x10C88, 'M', '𐳈'), + (0x10C89, 'M', '𐳉'), + (0x10C8A, 'M', '𐳊'), + (0x10C8B, 'M', '𐳋'), + (0x10C8C, 'M', '𐳌'), + (0x10C8D, 'M', '𐳍'), + (0x10C8E, 'M', '𐳎'), + (0x10C8F, 'M', '𐳏'), + (0x10C90, 'M', '𐳐'), + (0x10C91, 'M', '𐳑'), + (0x10C92, 'M', '𐳒'), + (0x10C93, 'M', '𐳓'), + (0x10C94, 'M', '𐳔'), + (0x10C95, 'M', '𐳕'), + (0x10C96, 'M', '𐳖'), + (0x10C97, 'M', '𐳗'), + (0x10C98, 'M', '𐳘'), + (0x10C99, 'M', '𐳙'), + (0x10C9A, 'M', '𐳚'), + (0x10C9B, 'M', '𐳛'), + (0x10C9C, 'M', '𐳜'), + (0x10C9D, 'M', '𐳝'), + (0x10C9E, 'M', '𐳞'), + (0x10C9F, 'M', '𐳟'), + (0x10CA0, 'M', '𐳠'), + (0x10CA1, 'M', '𐳡'), + (0x10CA2, 'M', '𐳢'), + (0x10CA3, 'M', '𐳣'), + (0x10CA4, 'M', '𐳤'), + (0x10CA5, 'M', '𐳥'), + (0x10CA6, 'M', '𐳦'), + (0x10CA7, 'M', '𐳧'), + (0x10CA8, 'M', '𐳨'), + (0x10CA9, 'M', '𐳩'), + (0x10CAA, 'M', '𐳪'), + (0x10CAB, 'M', '𐳫'), + (0x10CAC, 'M', '𐳬'), + (0x10CAD, 'M', '𐳭'), + (0x10CAE, 'M', '𐳮'), + (0x10CAF, 'M', '𐳯'), + (0x10CB0, 'M', '𐳰'), + (0x10CB1, 'M', '𐳱'), + (0x10CB2, 'M', '𐳲'), + (0x10CB3, 'X'), + (0x10CC0, 'V'), + (0x10CF3, 'X'), + (0x10CFA, 'V'), + (0x10D28, 'X'), + (0x10D30, 'V'), + (0x10D3A, 'X'), + (0x10E60, 'V'), + (0x10E7F, 'X'), + (0x10E80, 'V'), + (0x10EAA, 'X'), + (0x10EAB, 'V'), + (0x10EAE, 'X'), + (0x10EB0, 'V'), + (0x10EB2, 'X'), + (0x10EFD, 'V'), + (0x10F28, 'X'), + (0x10F30, 'V'), + (0x10F5A, 'X'), + (0x10F70, 'V'), + (0x10F8A, 'X'), + (0x10FB0, 'V'), + (0x10FCC, 'X'), + (0x10FE0, 'V'), + (0x10FF7, 'X'), + (0x11000, 'V'), + (0x1104E, 'X'), + (0x11052, 'V'), + (0x11076, 'X'), + (0x1107F, 'V'), + (0x110BD, 'X'), + (0x110BE, 'V'), + (0x110C3, 'X'), + (0x110D0, 'V'), + (0x110E9, 'X'), + (0x110F0, 'V'), + ] + +def _seg_57() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x110FA, 'X'), + (0x11100, 'V'), + (0x11135, 'X'), + (0x11136, 'V'), + (0x11148, 'X'), + (0x11150, 'V'), + (0x11177, 'X'), + (0x11180, 'V'), + (0x111E0, 'X'), + (0x111E1, 'V'), + (0x111F5, 'X'), + (0x11200, 'V'), + (0x11212, 'X'), + (0x11213, 'V'), + (0x11242, 'X'), + (0x11280, 'V'), + (0x11287, 'X'), + (0x11288, 'V'), + (0x11289, 'X'), + (0x1128A, 'V'), + (0x1128E, 'X'), + (0x1128F, 'V'), + (0x1129E, 'X'), + (0x1129F, 'V'), + (0x112AA, 'X'), + (0x112B0, 'V'), + (0x112EB, 'X'), + (0x112F0, 'V'), + (0x112FA, 'X'), + (0x11300, 'V'), + (0x11304, 'X'), + (0x11305, 'V'), + (0x1130D, 'X'), + (0x1130F, 'V'), + (0x11311, 'X'), + (0x11313, 'V'), + (0x11329, 'X'), + (0x1132A, 'V'), + (0x11331, 'X'), + (0x11332, 'V'), + (0x11334, 'X'), + (0x11335, 'V'), + (0x1133A, 'X'), + (0x1133B, 'V'), + (0x11345, 'X'), + (0x11347, 'V'), + (0x11349, 'X'), + (0x1134B, 'V'), + (0x1134E, 'X'), + (0x11350, 'V'), + (0x11351, 'X'), + (0x11357, 'V'), + (0x11358, 'X'), + (0x1135D, 'V'), + (0x11364, 'X'), + (0x11366, 'V'), + (0x1136D, 'X'), + (0x11370, 'V'), + (0x11375, 'X'), + (0x11400, 'V'), + (0x1145C, 'X'), + (0x1145D, 'V'), + (0x11462, 'X'), + (0x11480, 'V'), + (0x114C8, 'X'), + (0x114D0, 'V'), + (0x114DA, 'X'), + (0x11580, 'V'), + (0x115B6, 'X'), + (0x115B8, 'V'), + (0x115DE, 'X'), + (0x11600, 'V'), + (0x11645, 'X'), + (0x11650, 'V'), + (0x1165A, 'X'), + (0x11660, 'V'), + (0x1166D, 'X'), + (0x11680, 'V'), + (0x116BA, 'X'), + (0x116C0, 'V'), + (0x116CA, 'X'), + (0x11700, 'V'), + (0x1171B, 'X'), + (0x1171D, 'V'), + (0x1172C, 'X'), + (0x11730, 'V'), + (0x11747, 'X'), + (0x11800, 'V'), + (0x1183C, 'X'), + (0x118A0, 'M', '𑣀'), + (0x118A1, 'M', '𑣁'), + (0x118A2, 'M', '𑣂'), + (0x118A3, 'M', '𑣃'), + (0x118A4, 'M', '𑣄'), + (0x118A5, 'M', '𑣅'), + (0x118A6, 'M', '𑣆'), + (0x118A7, 'M', '𑣇'), + (0x118A8, 'M', '𑣈'), + (0x118A9, 'M', '𑣉'), + (0x118AA, 'M', '𑣊'), + ] + +def _seg_58() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x118AB, 'M', '𑣋'), + (0x118AC, 'M', '𑣌'), + (0x118AD, 'M', '𑣍'), + (0x118AE, 'M', '𑣎'), + (0x118AF, 'M', '𑣏'), + (0x118B0, 'M', '𑣐'), + (0x118B1, 'M', '𑣑'), + (0x118B2, 'M', '𑣒'), + (0x118B3, 'M', '𑣓'), + (0x118B4, 'M', '𑣔'), + (0x118B5, 'M', '𑣕'), + (0x118B6, 'M', '𑣖'), + (0x118B7, 'M', '𑣗'), + (0x118B8, 'M', '𑣘'), + (0x118B9, 'M', '𑣙'), + (0x118BA, 'M', '𑣚'), + (0x118BB, 'M', '𑣛'), + (0x118BC, 'M', '𑣜'), + (0x118BD, 'M', '𑣝'), + (0x118BE, 'M', '𑣞'), + (0x118BF, 'M', '𑣟'), + (0x118C0, 'V'), + (0x118F3, 'X'), + (0x118FF, 'V'), + (0x11907, 'X'), + (0x11909, 'V'), + (0x1190A, 'X'), + (0x1190C, 'V'), + (0x11914, 'X'), + (0x11915, 'V'), + (0x11917, 'X'), + (0x11918, 'V'), + (0x11936, 'X'), + (0x11937, 'V'), + (0x11939, 'X'), + (0x1193B, 'V'), + (0x11947, 'X'), + (0x11950, 'V'), + (0x1195A, 'X'), + (0x119A0, 'V'), + (0x119A8, 'X'), + (0x119AA, 'V'), + (0x119D8, 'X'), + (0x119DA, 'V'), + (0x119E5, 'X'), + (0x11A00, 'V'), + (0x11A48, 'X'), + (0x11A50, 'V'), + (0x11AA3, 'X'), + (0x11AB0, 'V'), + (0x11AF9, 'X'), + (0x11B00, 'V'), + (0x11B0A, 'X'), + (0x11C00, 'V'), + (0x11C09, 'X'), + (0x11C0A, 'V'), + (0x11C37, 'X'), + (0x11C38, 'V'), + (0x11C46, 'X'), + (0x11C50, 'V'), + (0x11C6D, 'X'), + (0x11C70, 'V'), + (0x11C90, 'X'), + (0x11C92, 'V'), + (0x11CA8, 'X'), + (0x11CA9, 'V'), + (0x11CB7, 'X'), + (0x11D00, 'V'), + (0x11D07, 'X'), + (0x11D08, 'V'), + (0x11D0A, 'X'), + (0x11D0B, 'V'), + (0x11D37, 'X'), + (0x11D3A, 'V'), + (0x11D3B, 'X'), + (0x11D3C, 'V'), + (0x11D3E, 'X'), + (0x11D3F, 'V'), + (0x11D48, 'X'), + (0x11D50, 'V'), + (0x11D5A, 'X'), + (0x11D60, 'V'), + (0x11D66, 'X'), + (0x11D67, 'V'), + (0x11D69, 'X'), + (0x11D6A, 'V'), + (0x11D8F, 'X'), + (0x11D90, 'V'), + (0x11D92, 'X'), + (0x11D93, 'V'), + (0x11D99, 'X'), + (0x11DA0, 'V'), + (0x11DAA, 'X'), + (0x11EE0, 'V'), + (0x11EF9, 'X'), + (0x11F00, 'V'), + (0x11F11, 'X'), + (0x11F12, 'V'), + (0x11F3B, 'X'), + (0x11F3E, 'V'), + ] + +def _seg_59() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x11F5A, 'X'), + (0x11FB0, 'V'), + (0x11FB1, 'X'), + (0x11FC0, 'V'), + (0x11FF2, 'X'), + (0x11FFF, 'V'), + (0x1239A, 'X'), + (0x12400, 'V'), + (0x1246F, 'X'), + (0x12470, 'V'), + (0x12475, 'X'), + (0x12480, 'V'), + (0x12544, 'X'), + (0x12F90, 'V'), + (0x12FF3, 'X'), + (0x13000, 'V'), + (0x13430, 'X'), + (0x13440, 'V'), + (0x13456, 'X'), + (0x14400, 'V'), + (0x14647, 'X'), + (0x16800, 'V'), + (0x16A39, 'X'), + (0x16A40, 'V'), + (0x16A5F, 'X'), + (0x16A60, 'V'), + (0x16A6A, 'X'), + (0x16A6E, 'V'), + (0x16ABF, 'X'), + (0x16AC0, 'V'), + (0x16ACA, 'X'), + (0x16AD0, 'V'), + (0x16AEE, 'X'), + (0x16AF0, 'V'), + (0x16AF6, 'X'), + (0x16B00, 'V'), + (0x16B46, 'X'), + (0x16B50, 'V'), + (0x16B5A, 'X'), + (0x16B5B, 'V'), + (0x16B62, 'X'), + (0x16B63, 'V'), + (0x16B78, 'X'), + (0x16B7D, 'V'), + (0x16B90, 'X'), + (0x16E40, 'M', '𖹠'), + (0x16E41, 'M', '𖹡'), + (0x16E42, 'M', '𖹢'), + (0x16E43, 'M', '𖹣'), + (0x16E44, 'M', '𖹤'), + (0x16E45, 'M', '𖹥'), + (0x16E46, 'M', '𖹦'), + (0x16E47, 'M', '𖹧'), + (0x16E48, 'M', '𖹨'), + (0x16E49, 'M', '𖹩'), + (0x16E4A, 'M', '𖹪'), + (0x16E4B, 'M', '𖹫'), + (0x16E4C, 'M', '𖹬'), + (0x16E4D, 'M', '𖹭'), + (0x16E4E, 'M', '𖹮'), + (0x16E4F, 'M', '𖹯'), + (0x16E50, 'M', '𖹰'), + (0x16E51, 'M', '𖹱'), + (0x16E52, 'M', '𖹲'), + (0x16E53, 'M', '𖹳'), + (0x16E54, 'M', '𖹴'), + (0x16E55, 'M', '𖹵'), + (0x16E56, 'M', '𖹶'), + (0x16E57, 'M', '𖹷'), + (0x16E58, 'M', '𖹸'), + (0x16E59, 'M', '𖹹'), + (0x16E5A, 'M', '𖹺'), + (0x16E5B, 'M', '𖹻'), + (0x16E5C, 'M', '𖹼'), + (0x16E5D, 'M', '𖹽'), + (0x16E5E, 'M', '𖹾'), + (0x16E5F, 'M', '𖹿'), + (0x16E60, 'V'), + (0x16E9B, 'X'), + (0x16F00, 'V'), + (0x16F4B, 'X'), + (0x16F4F, 'V'), + (0x16F88, 'X'), + (0x16F8F, 'V'), + (0x16FA0, 'X'), + (0x16FE0, 'V'), + (0x16FE5, 'X'), + (0x16FF0, 'V'), + (0x16FF2, 'X'), + (0x17000, 'V'), + (0x187F8, 'X'), + (0x18800, 'V'), + (0x18CD6, 'X'), + (0x18D00, 'V'), + (0x18D09, 'X'), + (0x1AFF0, 'V'), + (0x1AFF4, 'X'), + (0x1AFF5, 'V'), + (0x1AFFC, 'X'), + (0x1AFFD, 'V'), + ] + +def _seg_60() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1AFFF, 'X'), + (0x1B000, 'V'), + (0x1B123, 'X'), + (0x1B132, 'V'), + (0x1B133, 'X'), + (0x1B150, 'V'), + (0x1B153, 'X'), + (0x1B155, 'V'), + (0x1B156, 'X'), + (0x1B164, 'V'), + (0x1B168, 'X'), + (0x1B170, 'V'), + (0x1B2FC, 'X'), + (0x1BC00, 'V'), + (0x1BC6B, 'X'), + (0x1BC70, 'V'), + (0x1BC7D, 'X'), + (0x1BC80, 'V'), + (0x1BC89, 'X'), + (0x1BC90, 'V'), + (0x1BC9A, 'X'), + (0x1BC9C, 'V'), + (0x1BCA0, 'I'), + (0x1BCA4, 'X'), + (0x1CF00, 'V'), + (0x1CF2E, 'X'), + (0x1CF30, 'V'), + (0x1CF47, 'X'), + (0x1CF50, 'V'), + (0x1CFC4, 'X'), + (0x1D000, 'V'), + (0x1D0F6, 'X'), + (0x1D100, 'V'), + (0x1D127, 'X'), + (0x1D129, 'V'), + (0x1D15E, 'M', '𝅗𝅥'), + (0x1D15F, 'M', '𝅘𝅥'), + (0x1D160, 'M', '𝅘𝅥𝅮'), + (0x1D161, 'M', '𝅘𝅥𝅯'), + (0x1D162, 'M', '𝅘𝅥𝅰'), + (0x1D163, 'M', '𝅘𝅥𝅱'), + (0x1D164, 'M', '𝅘𝅥𝅲'), + (0x1D165, 'V'), + (0x1D173, 'X'), + (0x1D17B, 'V'), + (0x1D1BB, 'M', '𝆹𝅥'), + (0x1D1BC, 'M', '𝆺𝅥'), + (0x1D1BD, 'M', '𝆹𝅥𝅮'), + (0x1D1BE, 'M', '𝆺𝅥𝅮'), + (0x1D1BF, 'M', '𝆹𝅥𝅯'), + (0x1D1C0, 'M', '𝆺𝅥𝅯'), + (0x1D1C1, 'V'), + (0x1D1EB, 'X'), + (0x1D200, 'V'), + (0x1D246, 'X'), + (0x1D2C0, 'V'), + (0x1D2D4, 'X'), + (0x1D2E0, 'V'), + (0x1D2F4, 'X'), + (0x1D300, 'V'), + (0x1D357, 'X'), + (0x1D360, 'V'), + (0x1D379, 'X'), + (0x1D400, 'M', 'a'), + (0x1D401, 'M', 'b'), + (0x1D402, 'M', 'c'), + (0x1D403, 'M', 'd'), + (0x1D404, 'M', 'e'), + (0x1D405, 'M', 'f'), + (0x1D406, 'M', 'g'), + (0x1D407, 'M', 'h'), + (0x1D408, 'M', 'i'), + (0x1D409, 'M', 'j'), + (0x1D40A, 'M', 'k'), + (0x1D40B, 'M', 'l'), + (0x1D40C, 'M', 'm'), + (0x1D40D, 'M', 'n'), + (0x1D40E, 'M', 'o'), + (0x1D40F, 'M', 'p'), + (0x1D410, 'M', 'q'), + (0x1D411, 'M', 'r'), + (0x1D412, 'M', 's'), + (0x1D413, 'M', 't'), + (0x1D414, 'M', 'u'), + (0x1D415, 'M', 'v'), + (0x1D416, 'M', 'w'), + (0x1D417, 'M', 'x'), + (0x1D418, 'M', 'y'), + (0x1D419, 'M', 'z'), + (0x1D41A, 'M', 'a'), + (0x1D41B, 'M', 'b'), + (0x1D41C, 'M', 'c'), + (0x1D41D, 'M', 'd'), + (0x1D41E, 'M', 'e'), + (0x1D41F, 'M', 'f'), + (0x1D420, 'M', 'g'), + (0x1D421, 'M', 'h'), + (0x1D422, 'M', 'i'), + (0x1D423, 'M', 'j'), + (0x1D424, 'M', 'k'), + ] + +def _seg_61() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1D425, 'M', 'l'), + (0x1D426, 'M', 'm'), + (0x1D427, 'M', 'n'), + (0x1D428, 'M', 'o'), + (0x1D429, 'M', 'p'), + (0x1D42A, 'M', 'q'), + (0x1D42B, 'M', 'r'), + (0x1D42C, 'M', 's'), + (0x1D42D, 'M', 't'), + (0x1D42E, 'M', 'u'), + (0x1D42F, 'M', 'v'), + (0x1D430, 'M', 'w'), + (0x1D431, 'M', 'x'), + (0x1D432, 'M', 'y'), + (0x1D433, 'M', 'z'), + (0x1D434, 'M', 'a'), + (0x1D435, 'M', 'b'), + (0x1D436, 'M', 'c'), + (0x1D437, 'M', 'd'), + (0x1D438, 'M', 'e'), + (0x1D439, 'M', 'f'), + (0x1D43A, 'M', 'g'), + (0x1D43B, 'M', 'h'), + (0x1D43C, 'M', 'i'), + (0x1D43D, 'M', 'j'), + (0x1D43E, 'M', 'k'), + (0x1D43F, 'M', 'l'), + (0x1D440, 'M', 'm'), + (0x1D441, 'M', 'n'), + (0x1D442, 'M', 'o'), + (0x1D443, 'M', 'p'), + (0x1D444, 'M', 'q'), + (0x1D445, 'M', 'r'), + (0x1D446, 'M', 's'), + (0x1D447, 'M', 't'), + (0x1D448, 'M', 'u'), + (0x1D449, 'M', 'v'), + (0x1D44A, 'M', 'w'), + (0x1D44B, 'M', 'x'), + (0x1D44C, 'M', 'y'), + (0x1D44D, 'M', 'z'), + (0x1D44E, 'M', 'a'), + (0x1D44F, 'M', 'b'), + (0x1D450, 'M', 'c'), + (0x1D451, 'M', 'd'), + (0x1D452, 'M', 'e'), + (0x1D453, 'M', 'f'), + (0x1D454, 'M', 'g'), + (0x1D455, 'X'), + (0x1D456, 'M', 'i'), + (0x1D457, 'M', 'j'), + (0x1D458, 'M', 'k'), + (0x1D459, 'M', 'l'), + (0x1D45A, 'M', 'm'), + (0x1D45B, 'M', 'n'), + (0x1D45C, 'M', 'o'), + (0x1D45D, 'M', 'p'), + (0x1D45E, 'M', 'q'), + (0x1D45F, 'M', 'r'), + (0x1D460, 'M', 's'), + (0x1D461, 'M', 't'), + (0x1D462, 'M', 'u'), + (0x1D463, 'M', 'v'), + (0x1D464, 'M', 'w'), + (0x1D465, 'M', 'x'), + (0x1D466, 'M', 'y'), + (0x1D467, 'M', 'z'), + (0x1D468, 'M', 'a'), + (0x1D469, 'M', 'b'), + (0x1D46A, 'M', 'c'), + (0x1D46B, 'M', 'd'), + (0x1D46C, 'M', 'e'), + (0x1D46D, 'M', 'f'), + (0x1D46E, 'M', 'g'), + (0x1D46F, 'M', 'h'), + (0x1D470, 'M', 'i'), + (0x1D471, 'M', 'j'), + (0x1D472, 'M', 'k'), + (0x1D473, 'M', 'l'), + (0x1D474, 'M', 'm'), + (0x1D475, 'M', 'n'), + (0x1D476, 'M', 'o'), + (0x1D477, 'M', 'p'), + (0x1D478, 'M', 'q'), + (0x1D479, 'M', 'r'), + (0x1D47A, 'M', 's'), + (0x1D47B, 'M', 't'), + (0x1D47C, 'M', 'u'), + (0x1D47D, 'M', 'v'), + (0x1D47E, 'M', 'w'), + (0x1D47F, 'M', 'x'), + (0x1D480, 'M', 'y'), + (0x1D481, 'M', 'z'), + (0x1D482, 'M', 'a'), + (0x1D483, 'M', 'b'), + (0x1D484, 'M', 'c'), + (0x1D485, 'M', 'd'), + (0x1D486, 'M', 'e'), + (0x1D487, 'M', 'f'), + (0x1D488, 'M', 'g'), + ] + +def _seg_62() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1D489, 'M', 'h'), + (0x1D48A, 'M', 'i'), + (0x1D48B, 'M', 'j'), + (0x1D48C, 'M', 'k'), + (0x1D48D, 'M', 'l'), + (0x1D48E, 'M', 'm'), + (0x1D48F, 'M', 'n'), + (0x1D490, 'M', 'o'), + (0x1D491, 'M', 'p'), + (0x1D492, 'M', 'q'), + (0x1D493, 'M', 'r'), + (0x1D494, 'M', 's'), + (0x1D495, 'M', 't'), + (0x1D496, 'M', 'u'), + (0x1D497, 'M', 'v'), + (0x1D498, 'M', 'w'), + (0x1D499, 'M', 'x'), + (0x1D49A, 'M', 'y'), + (0x1D49B, 'M', 'z'), + (0x1D49C, 'M', 'a'), + (0x1D49D, 'X'), + (0x1D49E, 'M', 'c'), + (0x1D49F, 'M', 'd'), + (0x1D4A0, 'X'), + (0x1D4A2, 'M', 'g'), + (0x1D4A3, 'X'), + (0x1D4A5, 'M', 'j'), + (0x1D4A6, 'M', 'k'), + (0x1D4A7, 'X'), + (0x1D4A9, 'M', 'n'), + (0x1D4AA, 'M', 'o'), + (0x1D4AB, 'M', 'p'), + (0x1D4AC, 'M', 'q'), + (0x1D4AD, 'X'), + (0x1D4AE, 'M', 's'), + (0x1D4AF, 'M', 't'), + (0x1D4B0, 'M', 'u'), + (0x1D4B1, 'M', 'v'), + (0x1D4B2, 'M', 'w'), + (0x1D4B3, 'M', 'x'), + (0x1D4B4, 'M', 'y'), + (0x1D4B5, 'M', 'z'), + (0x1D4B6, 'M', 'a'), + (0x1D4B7, 'M', 'b'), + (0x1D4B8, 'M', 'c'), + (0x1D4B9, 'M', 'd'), + (0x1D4BA, 'X'), + (0x1D4BB, 'M', 'f'), + (0x1D4BC, 'X'), + (0x1D4BD, 'M', 'h'), + (0x1D4BE, 'M', 'i'), + (0x1D4BF, 'M', 'j'), + (0x1D4C0, 'M', 'k'), + (0x1D4C1, 'M', 'l'), + (0x1D4C2, 'M', 'm'), + (0x1D4C3, 'M', 'n'), + (0x1D4C4, 'X'), + (0x1D4C5, 'M', 'p'), + (0x1D4C6, 'M', 'q'), + (0x1D4C7, 'M', 'r'), + (0x1D4C8, 'M', 's'), + (0x1D4C9, 'M', 't'), + (0x1D4CA, 'M', 'u'), + (0x1D4CB, 'M', 'v'), + (0x1D4CC, 'M', 'w'), + (0x1D4CD, 'M', 'x'), + (0x1D4CE, 'M', 'y'), + (0x1D4CF, 'M', 'z'), + (0x1D4D0, 'M', 'a'), + (0x1D4D1, 'M', 'b'), + (0x1D4D2, 'M', 'c'), + (0x1D4D3, 'M', 'd'), + (0x1D4D4, 'M', 'e'), + (0x1D4D5, 'M', 'f'), + (0x1D4D6, 'M', 'g'), + (0x1D4D7, 'M', 'h'), + (0x1D4D8, 'M', 'i'), + (0x1D4D9, 'M', 'j'), + (0x1D4DA, 'M', 'k'), + (0x1D4DB, 'M', 'l'), + (0x1D4DC, 'M', 'm'), + (0x1D4DD, 'M', 'n'), + (0x1D4DE, 'M', 'o'), + (0x1D4DF, 'M', 'p'), + (0x1D4E0, 'M', 'q'), + (0x1D4E1, 'M', 'r'), + (0x1D4E2, 'M', 's'), + (0x1D4E3, 'M', 't'), + (0x1D4E4, 'M', 'u'), + (0x1D4E5, 'M', 'v'), + (0x1D4E6, 'M', 'w'), + (0x1D4E7, 'M', 'x'), + (0x1D4E8, 'M', 'y'), + (0x1D4E9, 'M', 'z'), + (0x1D4EA, 'M', 'a'), + (0x1D4EB, 'M', 'b'), + (0x1D4EC, 'M', 'c'), + (0x1D4ED, 'M', 'd'), + (0x1D4EE, 'M', 'e'), + (0x1D4EF, 'M', 'f'), + ] + +def _seg_63() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1D4F0, 'M', 'g'), + (0x1D4F1, 'M', 'h'), + (0x1D4F2, 'M', 'i'), + (0x1D4F3, 'M', 'j'), + (0x1D4F4, 'M', 'k'), + (0x1D4F5, 'M', 'l'), + (0x1D4F6, 'M', 'm'), + (0x1D4F7, 'M', 'n'), + (0x1D4F8, 'M', 'o'), + (0x1D4F9, 'M', 'p'), + (0x1D4FA, 'M', 'q'), + (0x1D4FB, 'M', 'r'), + (0x1D4FC, 'M', 's'), + (0x1D4FD, 'M', 't'), + (0x1D4FE, 'M', 'u'), + (0x1D4FF, 'M', 'v'), + (0x1D500, 'M', 'w'), + (0x1D501, 'M', 'x'), + (0x1D502, 'M', 'y'), + (0x1D503, 'M', 'z'), + (0x1D504, 'M', 'a'), + (0x1D505, 'M', 'b'), + (0x1D506, 'X'), + (0x1D507, 'M', 'd'), + (0x1D508, 'M', 'e'), + (0x1D509, 'M', 'f'), + (0x1D50A, 'M', 'g'), + (0x1D50B, 'X'), + (0x1D50D, 'M', 'j'), + (0x1D50E, 'M', 'k'), + (0x1D50F, 'M', 'l'), + (0x1D510, 'M', 'm'), + (0x1D511, 'M', 'n'), + (0x1D512, 'M', 'o'), + (0x1D513, 'M', 'p'), + (0x1D514, 'M', 'q'), + (0x1D515, 'X'), + (0x1D516, 'M', 's'), + (0x1D517, 'M', 't'), + (0x1D518, 'M', 'u'), + (0x1D519, 'M', 'v'), + (0x1D51A, 'M', 'w'), + (0x1D51B, 'M', 'x'), + (0x1D51C, 'M', 'y'), + (0x1D51D, 'X'), + (0x1D51E, 'M', 'a'), + (0x1D51F, 'M', 'b'), + (0x1D520, 'M', 'c'), + (0x1D521, 'M', 'd'), + (0x1D522, 'M', 'e'), + (0x1D523, 'M', 'f'), + (0x1D524, 'M', 'g'), + (0x1D525, 'M', 'h'), + (0x1D526, 'M', 'i'), + (0x1D527, 'M', 'j'), + (0x1D528, 'M', 'k'), + (0x1D529, 'M', 'l'), + (0x1D52A, 'M', 'm'), + (0x1D52B, 'M', 'n'), + (0x1D52C, 'M', 'o'), + (0x1D52D, 'M', 'p'), + (0x1D52E, 'M', 'q'), + (0x1D52F, 'M', 'r'), + (0x1D530, 'M', 's'), + (0x1D531, 'M', 't'), + (0x1D532, 'M', 'u'), + (0x1D533, 'M', 'v'), + (0x1D534, 'M', 'w'), + (0x1D535, 'M', 'x'), + (0x1D536, 'M', 'y'), + (0x1D537, 'M', 'z'), + (0x1D538, 'M', 'a'), + (0x1D539, 'M', 'b'), + (0x1D53A, 'X'), + (0x1D53B, 'M', 'd'), + (0x1D53C, 'M', 'e'), + (0x1D53D, 'M', 'f'), + (0x1D53E, 'M', 'g'), + (0x1D53F, 'X'), + (0x1D540, 'M', 'i'), + (0x1D541, 'M', 'j'), + (0x1D542, 'M', 'k'), + (0x1D543, 'M', 'l'), + (0x1D544, 'M', 'm'), + (0x1D545, 'X'), + (0x1D546, 'M', 'o'), + (0x1D547, 'X'), + (0x1D54A, 'M', 's'), + (0x1D54B, 'M', 't'), + (0x1D54C, 'M', 'u'), + (0x1D54D, 'M', 'v'), + (0x1D54E, 'M', 'w'), + (0x1D54F, 'M', 'x'), + (0x1D550, 'M', 'y'), + (0x1D551, 'X'), + (0x1D552, 'M', 'a'), + (0x1D553, 'M', 'b'), + (0x1D554, 'M', 'c'), + (0x1D555, 'M', 'd'), + (0x1D556, 'M', 'e'), + ] + +def _seg_64() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1D557, 'M', 'f'), + (0x1D558, 'M', 'g'), + (0x1D559, 'M', 'h'), + (0x1D55A, 'M', 'i'), + (0x1D55B, 'M', 'j'), + (0x1D55C, 'M', 'k'), + (0x1D55D, 'M', 'l'), + (0x1D55E, 'M', 'm'), + (0x1D55F, 'M', 'n'), + (0x1D560, 'M', 'o'), + (0x1D561, 'M', 'p'), + (0x1D562, 'M', 'q'), + (0x1D563, 'M', 'r'), + (0x1D564, 'M', 's'), + (0x1D565, 'M', 't'), + (0x1D566, 'M', 'u'), + (0x1D567, 'M', 'v'), + (0x1D568, 'M', 'w'), + (0x1D569, 'M', 'x'), + (0x1D56A, 'M', 'y'), + (0x1D56B, 'M', 'z'), + (0x1D56C, 'M', 'a'), + (0x1D56D, 'M', 'b'), + (0x1D56E, 'M', 'c'), + (0x1D56F, 'M', 'd'), + (0x1D570, 'M', 'e'), + (0x1D571, 'M', 'f'), + (0x1D572, 'M', 'g'), + (0x1D573, 'M', 'h'), + (0x1D574, 'M', 'i'), + (0x1D575, 'M', 'j'), + (0x1D576, 'M', 'k'), + (0x1D577, 'M', 'l'), + (0x1D578, 'M', 'm'), + (0x1D579, 'M', 'n'), + (0x1D57A, 'M', 'o'), + (0x1D57B, 'M', 'p'), + (0x1D57C, 'M', 'q'), + (0x1D57D, 'M', 'r'), + (0x1D57E, 'M', 's'), + (0x1D57F, 'M', 't'), + (0x1D580, 'M', 'u'), + (0x1D581, 'M', 'v'), + (0x1D582, 'M', 'w'), + (0x1D583, 'M', 'x'), + (0x1D584, 'M', 'y'), + (0x1D585, 'M', 'z'), + (0x1D586, 'M', 'a'), + (0x1D587, 'M', 'b'), + (0x1D588, 'M', 'c'), + (0x1D589, 'M', 'd'), + (0x1D58A, 'M', 'e'), + (0x1D58B, 'M', 'f'), + (0x1D58C, 'M', 'g'), + (0x1D58D, 'M', 'h'), + (0x1D58E, 'M', 'i'), + (0x1D58F, 'M', 'j'), + (0x1D590, 'M', 'k'), + (0x1D591, 'M', 'l'), + (0x1D592, 'M', 'm'), + (0x1D593, 'M', 'n'), + (0x1D594, 'M', 'o'), + (0x1D595, 'M', 'p'), + (0x1D596, 'M', 'q'), + (0x1D597, 'M', 'r'), + (0x1D598, 'M', 's'), + (0x1D599, 'M', 't'), + (0x1D59A, 'M', 'u'), + (0x1D59B, 'M', 'v'), + (0x1D59C, 'M', 'w'), + (0x1D59D, 'M', 'x'), + (0x1D59E, 'M', 'y'), + (0x1D59F, 'M', 'z'), + (0x1D5A0, 'M', 'a'), + (0x1D5A1, 'M', 'b'), + (0x1D5A2, 'M', 'c'), + (0x1D5A3, 'M', 'd'), + (0x1D5A4, 'M', 'e'), + (0x1D5A5, 'M', 'f'), + (0x1D5A6, 'M', 'g'), + (0x1D5A7, 'M', 'h'), + (0x1D5A8, 'M', 'i'), + (0x1D5A9, 'M', 'j'), + (0x1D5AA, 'M', 'k'), + (0x1D5AB, 'M', 'l'), + (0x1D5AC, 'M', 'm'), + (0x1D5AD, 'M', 'n'), + (0x1D5AE, 'M', 'o'), + (0x1D5AF, 'M', 'p'), + (0x1D5B0, 'M', 'q'), + (0x1D5B1, 'M', 'r'), + (0x1D5B2, 'M', 's'), + (0x1D5B3, 'M', 't'), + (0x1D5B4, 'M', 'u'), + (0x1D5B5, 'M', 'v'), + (0x1D5B6, 'M', 'w'), + (0x1D5B7, 'M', 'x'), + (0x1D5B8, 'M', 'y'), + (0x1D5B9, 'M', 'z'), + (0x1D5BA, 'M', 'a'), + ] + +def _seg_65() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1D5BB, 'M', 'b'), + (0x1D5BC, 'M', 'c'), + (0x1D5BD, 'M', 'd'), + (0x1D5BE, 'M', 'e'), + (0x1D5BF, 'M', 'f'), + (0x1D5C0, 'M', 'g'), + (0x1D5C1, 'M', 'h'), + (0x1D5C2, 'M', 'i'), + (0x1D5C3, 'M', 'j'), + (0x1D5C4, 'M', 'k'), + (0x1D5C5, 'M', 'l'), + (0x1D5C6, 'M', 'm'), + (0x1D5C7, 'M', 'n'), + (0x1D5C8, 'M', 'o'), + (0x1D5C9, 'M', 'p'), + (0x1D5CA, 'M', 'q'), + (0x1D5CB, 'M', 'r'), + (0x1D5CC, 'M', 's'), + (0x1D5CD, 'M', 't'), + (0x1D5CE, 'M', 'u'), + (0x1D5CF, 'M', 'v'), + (0x1D5D0, 'M', 'w'), + (0x1D5D1, 'M', 'x'), + (0x1D5D2, 'M', 'y'), + (0x1D5D3, 'M', 'z'), + (0x1D5D4, 'M', 'a'), + (0x1D5D5, 'M', 'b'), + (0x1D5D6, 'M', 'c'), + (0x1D5D7, 'M', 'd'), + (0x1D5D8, 'M', 'e'), + (0x1D5D9, 'M', 'f'), + (0x1D5DA, 'M', 'g'), + (0x1D5DB, 'M', 'h'), + (0x1D5DC, 'M', 'i'), + (0x1D5DD, 'M', 'j'), + (0x1D5DE, 'M', 'k'), + (0x1D5DF, 'M', 'l'), + (0x1D5E0, 'M', 'm'), + (0x1D5E1, 'M', 'n'), + (0x1D5E2, 'M', 'o'), + (0x1D5E3, 'M', 'p'), + (0x1D5E4, 'M', 'q'), + (0x1D5E5, 'M', 'r'), + (0x1D5E6, 'M', 's'), + (0x1D5E7, 'M', 't'), + (0x1D5E8, 'M', 'u'), + (0x1D5E9, 'M', 'v'), + (0x1D5EA, 'M', 'w'), + (0x1D5EB, 'M', 'x'), + (0x1D5EC, 'M', 'y'), + (0x1D5ED, 'M', 'z'), + (0x1D5EE, 'M', 'a'), + (0x1D5EF, 'M', 'b'), + (0x1D5F0, 'M', 'c'), + (0x1D5F1, 'M', 'd'), + (0x1D5F2, 'M', 'e'), + (0x1D5F3, 'M', 'f'), + (0x1D5F4, 'M', 'g'), + (0x1D5F5, 'M', 'h'), + (0x1D5F6, 'M', 'i'), + (0x1D5F7, 'M', 'j'), + (0x1D5F8, 'M', 'k'), + (0x1D5F9, 'M', 'l'), + (0x1D5FA, 'M', 'm'), + (0x1D5FB, 'M', 'n'), + (0x1D5FC, 'M', 'o'), + (0x1D5FD, 'M', 'p'), + (0x1D5FE, 'M', 'q'), + (0x1D5FF, 'M', 'r'), + (0x1D600, 'M', 's'), + (0x1D601, 'M', 't'), + (0x1D602, 'M', 'u'), + (0x1D603, 'M', 'v'), + (0x1D604, 'M', 'w'), + (0x1D605, 'M', 'x'), + (0x1D606, 'M', 'y'), + (0x1D607, 'M', 'z'), + (0x1D608, 'M', 'a'), + (0x1D609, 'M', 'b'), + (0x1D60A, 'M', 'c'), + (0x1D60B, 'M', 'd'), + (0x1D60C, 'M', 'e'), + (0x1D60D, 'M', 'f'), + (0x1D60E, 'M', 'g'), + (0x1D60F, 'M', 'h'), + (0x1D610, 'M', 'i'), + (0x1D611, 'M', 'j'), + (0x1D612, 'M', 'k'), + (0x1D613, 'M', 'l'), + (0x1D614, 'M', 'm'), + (0x1D615, 'M', 'n'), + (0x1D616, 'M', 'o'), + (0x1D617, 'M', 'p'), + (0x1D618, 'M', 'q'), + (0x1D619, 'M', 'r'), + (0x1D61A, 'M', 's'), + (0x1D61B, 'M', 't'), + (0x1D61C, 'M', 'u'), + (0x1D61D, 'M', 'v'), + (0x1D61E, 'M', 'w'), + ] + +def _seg_66() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1D61F, 'M', 'x'), + (0x1D620, 'M', 'y'), + (0x1D621, 'M', 'z'), + (0x1D622, 'M', 'a'), + (0x1D623, 'M', 'b'), + (0x1D624, 'M', 'c'), + (0x1D625, 'M', 'd'), + (0x1D626, 'M', 'e'), + (0x1D627, 'M', 'f'), + (0x1D628, 'M', 'g'), + (0x1D629, 'M', 'h'), + (0x1D62A, 'M', 'i'), + (0x1D62B, 'M', 'j'), + (0x1D62C, 'M', 'k'), + (0x1D62D, 'M', 'l'), + (0x1D62E, 'M', 'm'), + (0x1D62F, 'M', 'n'), + (0x1D630, 'M', 'o'), + (0x1D631, 'M', 'p'), + (0x1D632, 'M', 'q'), + (0x1D633, 'M', 'r'), + (0x1D634, 'M', 's'), + (0x1D635, 'M', 't'), + (0x1D636, 'M', 'u'), + (0x1D637, 'M', 'v'), + (0x1D638, 'M', 'w'), + (0x1D639, 'M', 'x'), + (0x1D63A, 'M', 'y'), + (0x1D63B, 'M', 'z'), + (0x1D63C, 'M', 'a'), + (0x1D63D, 'M', 'b'), + (0x1D63E, 'M', 'c'), + (0x1D63F, 'M', 'd'), + (0x1D640, 'M', 'e'), + (0x1D641, 'M', 'f'), + (0x1D642, 'M', 'g'), + (0x1D643, 'M', 'h'), + (0x1D644, 'M', 'i'), + (0x1D645, 'M', 'j'), + (0x1D646, 'M', 'k'), + (0x1D647, 'M', 'l'), + (0x1D648, 'M', 'm'), + (0x1D649, 'M', 'n'), + (0x1D64A, 'M', 'o'), + (0x1D64B, 'M', 'p'), + (0x1D64C, 'M', 'q'), + (0x1D64D, 'M', 'r'), + (0x1D64E, 'M', 's'), + (0x1D64F, 'M', 't'), + (0x1D650, 'M', 'u'), + (0x1D651, 'M', 'v'), + (0x1D652, 'M', 'w'), + (0x1D653, 'M', 'x'), + (0x1D654, 'M', 'y'), + (0x1D655, 'M', 'z'), + (0x1D656, 'M', 'a'), + (0x1D657, 'M', 'b'), + (0x1D658, 'M', 'c'), + (0x1D659, 'M', 'd'), + (0x1D65A, 'M', 'e'), + (0x1D65B, 'M', 'f'), + (0x1D65C, 'M', 'g'), + (0x1D65D, 'M', 'h'), + (0x1D65E, 'M', 'i'), + (0x1D65F, 'M', 'j'), + (0x1D660, 'M', 'k'), + (0x1D661, 'M', 'l'), + (0x1D662, 'M', 'm'), + (0x1D663, 'M', 'n'), + (0x1D664, 'M', 'o'), + (0x1D665, 'M', 'p'), + (0x1D666, 'M', 'q'), + (0x1D667, 'M', 'r'), + (0x1D668, 'M', 's'), + (0x1D669, 'M', 't'), + (0x1D66A, 'M', 'u'), + (0x1D66B, 'M', 'v'), + (0x1D66C, 'M', 'w'), + (0x1D66D, 'M', 'x'), + (0x1D66E, 'M', 'y'), + (0x1D66F, 'M', 'z'), + (0x1D670, 'M', 'a'), + (0x1D671, 'M', 'b'), + (0x1D672, 'M', 'c'), + (0x1D673, 'M', 'd'), + (0x1D674, 'M', 'e'), + (0x1D675, 'M', 'f'), + (0x1D676, 'M', 'g'), + (0x1D677, 'M', 'h'), + (0x1D678, 'M', 'i'), + (0x1D679, 'M', 'j'), + (0x1D67A, 'M', 'k'), + (0x1D67B, 'M', 'l'), + (0x1D67C, 'M', 'm'), + (0x1D67D, 'M', 'n'), + (0x1D67E, 'M', 'o'), + (0x1D67F, 'M', 'p'), + (0x1D680, 'M', 'q'), + (0x1D681, 'M', 'r'), + (0x1D682, 'M', 's'), + ] + +def _seg_67() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1D683, 'M', 't'), + (0x1D684, 'M', 'u'), + (0x1D685, 'M', 'v'), + (0x1D686, 'M', 'w'), + (0x1D687, 'M', 'x'), + (0x1D688, 'M', 'y'), + (0x1D689, 'M', 'z'), + (0x1D68A, 'M', 'a'), + (0x1D68B, 'M', 'b'), + (0x1D68C, 'M', 'c'), + (0x1D68D, 'M', 'd'), + (0x1D68E, 'M', 'e'), + (0x1D68F, 'M', 'f'), + (0x1D690, 'M', 'g'), + (0x1D691, 'M', 'h'), + (0x1D692, 'M', 'i'), + (0x1D693, 'M', 'j'), + (0x1D694, 'M', 'k'), + (0x1D695, 'M', 'l'), + (0x1D696, 'M', 'm'), + (0x1D697, 'M', 'n'), + (0x1D698, 'M', 'o'), + (0x1D699, 'M', 'p'), + (0x1D69A, 'M', 'q'), + (0x1D69B, 'M', 'r'), + (0x1D69C, 'M', 's'), + (0x1D69D, 'M', 't'), + (0x1D69E, 'M', 'u'), + (0x1D69F, 'M', 'v'), + (0x1D6A0, 'M', 'w'), + (0x1D6A1, 'M', 'x'), + (0x1D6A2, 'M', 'y'), + (0x1D6A3, 'M', 'z'), + (0x1D6A4, 'M', 'ı'), + (0x1D6A5, 'M', 'ȷ'), + (0x1D6A6, 'X'), + (0x1D6A8, 'M', 'α'), + (0x1D6A9, 'M', 'β'), + (0x1D6AA, 'M', 'γ'), + (0x1D6AB, 'M', 'δ'), + (0x1D6AC, 'M', 'ε'), + (0x1D6AD, 'M', 'ζ'), + (0x1D6AE, 'M', 'η'), + (0x1D6AF, 'M', 'θ'), + (0x1D6B0, 'M', 'ι'), + (0x1D6B1, 'M', 'κ'), + (0x1D6B2, 'M', 'λ'), + (0x1D6B3, 'M', 'μ'), + (0x1D6B4, 'M', 'ν'), + (0x1D6B5, 'M', 'ξ'), + (0x1D6B6, 'M', 'ο'), + (0x1D6B7, 'M', 'π'), + (0x1D6B8, 'M', 'ρ'), + (0x1D6B9, 'M', 'θ'), + (0x1D6BA, 'M', 'σ'), + (0x1D6BB, 'M', 'τ'), + (0x1D6BC, 'M', 'υ'), + (0x1D6BD, 'M', 'φ'), + (0x1D6BE, 'M', 'χ'), + (0x1D6BF, 'M', 'ψ'), + (0x1D6C0, 'M', 'ω'), + (0x1D6C1, 'M', '∇'), + (0x1D6C2, 'M', 'α'), + (0x1D6C3, 'M', 'β'), + (0x1D6C4, 'M', 'γ'), + (0x1D6C5, 'M', 'δ'), + (0x1D6C6, 'M', 'ε'), + (0x1D6C7, 'M', 'ζ'), + (0x1D6C8, 'M', 'η'), + (0x1D6C9, 'M', 'θ'), + (0x1D6CA, 'M', 'ι'), + (0x1D6CB, 'M', 'κ'), + (0x1D6CC, 'M', 'λ'), + (0x1D6CD, 'M', 'μ'), + (0x1D6CE, 'M', 'ν'), + (0x1D6CF, 'M', 'ξ'), + (0x1D6D0, 'M', 'ο'), + (0x1D6D1, 'M', 'π'), + (0x1D6D2, 'M', 'ρ'), + (0x1D6D3, 'M', 'σ'), + (0x1D6D5, 'M', 'τ'), + (0x1D6D6, 'M', 'υ'), + (0x1D6D7, 'M', 'φ'), + (0x1D6D8, 'M', 'χ'), + (0x1D6D9, 'M', 'ψ'), + (0x1D6DA, 'M', 'ω'), + (0x1D6DB, 'M', '∂'), + (0x1D6DC, 'M', 'ε'), + (0x1D6DD, 'M', 'θ'), + (0x1D6DE, 'M', 'κ'), + (0x1D6DF, 'M', 'φ'), + (0x1D6E0, 'M', 'ρ'), + (0x1D6E1, 'M', 'π'), + (0x1D6E2, 'M', 'α'), + (0x1D6E3, 'M', 'β'), + (0x1D6E4, 'M', 'γ'), + (0x1D6E5, 'M', 'δ'), + (0x1D6E6, 'M', 'ε'), + (0x1D6E7, 'M', 'ζ'), + (0x1D6E8, 'M', 'η'), + ] + +def _seg_68() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1D6E9, 'M', 'θ'), + (0x1D6EA, 'M', 'ι'), + (0x1D6EB, 'M', 'κ'), + (0x1D6EC, 'M', 'λ'), + (0x1D6ED, 'M', 'μ'), + (0x1D6EE, 'M', 'ν'), + (0x1D6EF, 'M', 'ξ'), + (0x1D6F0, 'M', 'ο'), + (0x1D6F1, 'M', 'π'), + (0x1D6F2, 'M', 'ρ'), + (0x1D6F3, 'M', 'θ'), + (0x1D6F4, 'M', 'σ'), + (0x1D6F5, 'M', 'τ'), + (0x1D6F6, 'M', 'υ'), + (0x1D6F7, 'M', 'φ'), + (0x1D6F8, 'M', 'χ'), + (0x1D6F9, 'M', 'ψ'), + (0x1D6FA, 'M', 'ω'), + (0x1D6FB, 'M', '∇'), + (0x1D6FC, 'M', 'α'), + (0x1D6FD, 'M', 'β'), + (0x1D6FE, 'M', 'γ'), + (0x1D6FF, 'M', 'δ'), + (0x1D700, 'M', 'ε'), + (0x1D701, 'M', 'ζ'), + (0x1D702, 'M', 'η'), + (0x1D703, 'M', 'θ'), + (0x1D704, 'M', 'ι'), + (0x1D705, 'M', 'κ'), + (0x1D706, 'M', 'λ'), + (0x1D707, 'M', 'μ'), + (0x1D708, 'M', 'ν'), + (0x1D709, 'M', 'ξ'), + (0x1D70A, 'M', 'ο'), + (0x1D70B, 'M', 'π'), + (0x1D70C, 'M', 'ρ'), + (0x1D70D, 'M', 'σ'), + (0x1D70F, 'M', 'τ'), + (0x1D710, 'M', 'υ'), + (0x1D711, 'M', 'φ'), + (0x1D712, 'M', 'χ'), + (0x1D713, 'M', 'ψ'), + (0x1D714, 'M', 'ω'), + (0x1D715, 'M', '∂'), + (0x1D716, 'M', 'ε'), + (0x1D717, 'M', 'θ'), + (0x1D718, 'M', 'κ'), + (0x1D719, 'M', 'φ'), + (0x1D71A, 'M', 'ρ'), + (0x1D71B, 'M', 'π'), + (0x1D71C, 'M', 'α'), + (0x1D71D, 'M', 'β'), + (0x1D71E, 'M', 'γ'), + (0x1D71F, 'M', 'δ'), + (0x1D720, 'M', 'ε'), + (0x1D721, 'M', 'ζ'), + (0x1D722, 'M', 'η'), + (0x1D723, 'M', 'θ'), + (0x1D724, 'M', 'ι'), + (0x1D725, 'M', 'κ'), + (0x1D726, 'M', 'λ'), + (0x1D727, 'M', 'μ'), + (0x1D728, 'M', 'ν'), + (0x1D729, 'M', 'ξ'), + (0x1D72A, 'M', 'ο'), + (0x1D72B, 'M', 'π'), + (0x1D72C, 'M', 'ρ'), + (0x1D72D, 'M', 'θ'), + (0x1D72E, 'M', 'σ'), + (0x1D72F, 'M', 'τ'), + (0x1D730, 'M', 'υ'), + (0x1D731, 'M', 'φ'), + (0x1D732, 'M', 'χ'), + (0x1D733, 'M', 'ψ'), + (0x1D734, 'M', 'ω'), + (0x1D735, 'M', '∇'), + (0x1D736, 'M', 'α'), + (0x1D737, 'M', 'β'), + (0x1D738, 'M', 'γ'), + (0x1D739, 'M', 'δ'), + (0x1D73A, 'M', 'ε'), + (0x1D73B, 'M', 'ζ'), + (0x1D73C, 'M', 'η'), + (0x1D73D, 'M', 'θ'), + (0x1D73E, 'M', 'ι'), + (0x1D73F, 'M', 'κ'), + (0x1D740, 'M', 'λ'), + (0x1D741, 'M', 'μ'), + (0x1D742, 'M', 'ν'), + (0x1D743, 'M', 'ξ'), + (0x1D744, 'M', 'ο'), + (0x1D745, 'M', 'π'), + (0x1D746, 'M', 'ρ'), + (0x1D747, 'M', 'σ'), + (0x1D749, 'M', 'τ'), + (0x1D74A, 'M', 'υ'), + (0x1D74B, 'M', 'φ'), + (0x1D74C, 'M', 'χ'), + (0x1D74D, 'M', 'ψ'), + (0x1D74E, 'M', 'ω'), + ] + +def _seg_69() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1D74F, 'M', '∂'), + (0x1D750, 'M', 'ε'), + (0x1D751, 'M', 'θ'), + (0x1D752, 'M', 'κ'), + (0x1D753, 'M', 'φ'), + (0x1D754, 'M', 'ρ'), + (0x1D755, 'M', 'π'), + (0x1D756, 'M', 'α'), + (0x1D757, 'M', 'β'), + (0x1D758, 'M', 'γ'), + (0x1D759, 'M', 'δ'), + (0x1D75A, 'M', 'ε'), + (0x1D75B, 'M', 'ζ'), + (0x1D75C, 'M', 'η'), + (0x1D75D, 'M', 'θ'), + (0x1D75E, 'M', 'ι'), + (0x1D75F, 'M', 'κ'), + (0x1D760, 'M', 'λ'), + (0x1D761, 'M', 'μ'), + (0x1D762, 'M', 'ν'), + (0x1D763, 'M', 'ξ'), + (0x1D764, 'M', 'ο'), + (0x1D765, 'M', 'π'), + (0x1D766, 'M', 'ρ'), + (0x1D767, 'M', 'θ'), + (0x1D768, 'M', 'σ'), + (0x1D769, 'M', 'τ'), + (0x1D76A, 'M', 'υ'), + (0x1D76B, 'M', 'φ'), + (0x1D76C, 'M', 'χ'), + (0x1D76D, 'M', 'ψ'), + (0x1D76E, 'M', 'ω'), + (0x1D76F, 'M', '∇'), + (0x1D770, 'M', 'α'), + (0x1D771, 'M', 'β'), + (0x1D772, 'M', 'γ'), + (0x1D773, 'M', 'δ'), + (0x1D774, 'M', 'ε'), + (0x1D775, 'M', 'ζ'), + (0x1D776, 'M', 'η'), + (0x1D777, 'M', 'θ'), + (0x1D778, 'M', 'ι'), + (0x1D779, 'M', 'κ'), + (0x1D77A, 'M', 'λ'), + (0x1D77B, 'M', 'μ'), + (0x1D77C, 'M', 'ν'), + (0x1D77D, 'M', 'ξ'), + (0x1D77E, 'M', 'ο'), + (0x1D77F, 'M', 'π'), + (0x1D780, 'M', 'ρ'), + (0x1D781, 'M', 'σ'), + (0x1D783, 'M', 'τ'), + (0x1D784, 'M', 'υ'), + (0x1D785, 'M', 'φ'), + (0x1D786, 'M', 'χ'), + (0x1D787, 'M', 'ψ'), + (0x1D788, 'M', 'ω'), + (0x1D789, 'M', '∂'), + (0x1D78A, 'M', 'ε'), + (0x1D78B, 'M', 'θ'), + (0x1D78C, 'M', 'κ'), + (0x1D78D, 'M', 'φ'), + (0x1D78E, 'M', 'ρ'), + (0x1D78F, 'M', 'π'), + (0x1D790, 'M', 'α'), + (0x1D791, 'M', 'β'), + (0x1D792, 'M', 'γ'), + (0x1D793, 'M', 'δ'), + (0x1D794, 'M', 'ε'), + (0x1D795, 'M', 'ζ'), + (0x1D796, 'M', 'η'), + (0x1D797, 'M', 'θ'), + (0x1D798, 'M', 'ι'), + (0x1D799, 'M', 'κ'), + (0x1D79A, 'M', 'λ'), + (0x1D79B, 'M', 'μ'), + (0x1D79C, 'M', 'ν'), + (0x1D79D, 'M', 'ξ'), + (0x1D79E, 'M', 'ο'), + (0x1D79F, 'M', 'π'), + (0x1D7A0, 'M', 'ρ'), + (0x1D7A1, 'M', 'θ'), + (0x1D7A2, 'M', 'σ'), + (0x1D7A3, 'M', 'τ'), + (0x1D7A4, 'M', 'υ'), + (0x1D7A5, 'M', 'φ'), + (0x1D7A6, 'M', 'χ'), + (0x1D7A7, 'M', 'ψ'), + (0x1D7A8, 'M', 'ω'), + (0x1D7A9, 'M', '∇'), + (0x1D7AA, 'M', 'α'), + (0x1D7AB, 'M', 'β'), + (0x1D7AC, 'M', 'γ'), + (0x1D7AD, 'M', 'δ'), + (0x1D7AE, 'M', 'ε'), + (0x1D7AF, 'M', 'ζ'), + (0x1D7B0, 'M', 'η'), + (0x1D7B1, 'M', 'θ'), + (0x1D7B2, 'M', 'ι'), + (0x1D7B3, 'M', 'κ'), + ] + +def _seg_70() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1D7B4, 'M', 'λ'), + (0x1D7B5, 'M', 'μ'), + (0x1D7B6, 'M', 'ν'), + (0x1D7B7, 'M', 'ξ'), + (0x1D7B8, 'M', 'ο'), + (0x1D7B9, 'M', 'π'), + (0x1D7BA, 'M', 'ρ'), + (0x1D7BB, 'M', 'σ'), + (0x1D7BD, 'M', 'τ'), + (0x1D7BE, 'M', 'υ'), + (0x1D7BF, 'M', 'φ'), + (0x1D7C0, 'M', 'χ'), + (0x1D7C1, 'M', 'ψ'), + (0x1D7C2, 'M', 'ω'), + (0x1D7C3, 'M', '∂'), + (0x1D7C4, 'M', 'ε'), + (0x1D7C5, 'M', 'θ'), + (0x1D7C6, 'M', 'κ'), + (0x1D7C7, 'M', 'φ'), + (0x1D7C8, 'M', 'ρ'), + (0x1D7C9, 'M', 'π'), + (0x1D7CA, 'M', 'ϝ'), + (0x1D7CC, 'X'), + (0x1D7CE, 'M', '0'), + (0x1D7CF, 'M', '1'), + (0x1D7D0, 'M', '2'), + (0x1D7D1, 'M', '3'), + (0x1D7D2, 'M', '4'), + (0x1D7D3, 'M', '5'), + (0x1D7D4, 'M', '6'), + (0x1D7D5, 'M', '7'), + (0x1D7D6, 'M', '8'), + (0x1D7D7, 'M', '9'), + (0x1D7D8, 'M', '0'), + (0x1D7D9, 'M', '1'), + (0x1D7DA, 'M', '2'), + (0x1D7DB, 'M', '3'), + (0x1D7DC, 'M', '4'), + (0x1D7DD, 'M', '5'), + (0x1D7DE, 'M', '6'), + (0x1D7DF, 'M', '7'), + (0x1D7E0, 'M', '8'), + (0x1D7E1, 'M', '9'), + (0x1D7E2, 'M', '0'), + (0x1D7E3, 'M', '1'), + (0x1D7E4, 'M', '2'), + (0x1D7E5, 'M', '3'), + (0x1D7E6, 'M', '4'), + (0x1D7E7, 'M', '5'), + (0x1D7E8, 'M', '6'), + (0x1D7E9, 'M', '7'), + (0x1D7EA, 'M', '8'), + (0x1D7EB, 'M', '9'), + (0x1D7EC, 'M', '0'), + (0x1D7ED, 'M', '1'), + (0x1D7EE, 'M', '2'), + (0x1D7EF, 'M', '3'), + (0x1D7F0, 'M', '4'), + (0x1D7F1, 'M', '5'), + (0x1D7F2, 'M', '6'), + (0x1D7F3, 'M', '7'), + (0x1D7F4, 'M', '8'), + (0x1D7F5, 'M', '9'), + (0x1D7F6, 'M', '0'), + (0x1D7F7, 'M', '1'), + (0x1D7F8, 'M', '2'), + (0x1D7F9, 'M', '3'), + (0x1D7FA, 'M', '4'), + (0x1D7FB, 'M', '5'), + (0x1D7FC, 'M', '6'), + (0x1D7FD, 'M', '7'), + (0x1D7FE, 'M', '8'), + (0x1D7FF, 'M', '9'), + (0x1D800, 'V'), + (0x1DA8C, 'X'), + (0x1DA9B, 'V'), + (0x1DAA0, 'X'), + (0x1DAA1, 'V'), + (0x1DAB0, 'X'), + (0x1DF00, 'V'), + (0x1DF1F, 'X'), + (0x1DF25, 'V'), + (0x1DF2B, 'X'), + (0x1E000, 'V'), + (0x1E007, 'X'), + (0x1E008, 'V'), + (0x1E019, 'X'), + (0x1E01B, 'V'), + (0x1E022, 'X'), + (0x1E023, 'V'), + (0x1E025, 'X'), + (0x1E026, 'V'), + (0x1E02B, 'X'), + (0x1E030, 'M', 'а'), + (0x1E031, 'M', 'б'), + (0x1E032, 'M', 'в'), + (0x1E033, 'M', 'г'), + (0x1E034, 'M', 'д'), + (0x1E035, 'M', 'е'), + (0x1E036, 'M', 'ж'), + ] + +def _seg_71() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1E037, 'M', 'з'), + (0x1E038, 'M', 'и'), + (0x1E039, 'M', 'к'), + (0x1E03A, 'M', 'л'), + (0x1E03B, 'M', 'м'), + (0x1E03C, 'M', 'о'), + (0x1E03D, 'M', 'п'), + (0x1E03E, 'M', 'р'), + (0x1E03F, 'M', 'с'), + (0x1E040, 'M', 'т'), + (0x1E041, 'M', 'у'), + (0x1E042, 'M', 'ф'), + (0x1E043, 'M', 'х'), + (0x1E044, 'M', 'ц'), + (0x1E045, 'M', 'ч'), + (0x1E046, 'M', 'ш'), + (0x1E047, 'M', 'ы'), + (0x1E048, 'M', 'э'), + (0x1E049, 'M', 'ю'), + (0x1E04A, 'M', 'ꚉ'), + (0x1E04B, 'M', 'ә'), + (0x1E04C, 'M', 'і'), + (0x1E04D, 'M', 'ј'), + (0x1E04E, 'M', 'ө'), + (0x1E04F, 'M', 'ү'), + (0x1E050, 'M', 'ӏ'), + (0x1E051, 'M', 'а'), + (0x1E052, 'M', 'б'), + (0x1E053, 'M', 'в'), + (0x1E054, 'M', 'г'), + (0x1E055, 'M', 'д'), + (0x1E056, 'M', 'е'), + (0x1E057, 'M', 'ж'), + (0x1E058, 'M', 'з'), + (0x1E059, 'M', 'и'), + (0x1E05A, 'M', 'к'), + (0x1E05B, 'M', 'л'), + (0x1E05C, 'M', 'о'), + (0x1E05D, 'M', 'п'), + (0x1E05E, 'M', 'с'), + (0x1E05F, 'M', 'у'), + (0x1E060, 'M', 'ф'), + (0x1E061, 'M', 'х'), + (0x1E062, 'M', 'ц'), + (0x1E063, 'M', 'ч'), + (0x1E064, 'M', 'ш'), + (0x1E065, 'M', 'ъ'), + (0x1E066, 'M', 'ы'), + (0x1E067, 'M', 'ґ'), + (0x1E068, 'M', 'і'), + (0x1E069, 'M', 'ѕ'), + (0x1E06A, 'M', 'џ'), + (0x1E06B, 'M', 'ҫ'), + (0x1E06C, 'M', 'ꙑ'), + (0x1E06D, 'M', 'ұ'), + (0x1E06E, 'X'), + (0x1E08F, 'V'), + (0x1E090, 'X'), + (0x1E100, 'V'), + (0x1E12D, 'X'), + (0x1E130, 'V'), + (0x1E13E, 'X'), + (0x1E140, 'V'), + (0x1E14A, 'X'), + (0x1E14E, 'V'), + (0x1E150, 'X'), + (0x1E290, 'V'), + (0x1E2AF, 'X'), + (0x1E2C0, 'V'), + (0x1E2FA, 'X'), + (0x1E2FF, 'V'), + (0x1E300, 'X'), + (0x1E4D0, 'V'), + (0x1E4FA, 'X'), + (0x1E7E0, 'V'), + (0x1E7E7, 'X'), + (0x1E7E8, 'V'), + (0x1E7EC, 'X'), + (0x1E7ED, 'V'), + (0x1E7EF, 'X'), + (0x1E7F0, 'V'), + (0x1E7FF, 'X'), + (0x1E800, 'V'), + (0x1E8C5, 'X'), + (0x1E8C7, 'V'), + (0x1E8D7, 'X'), + (0x1E900, 'M', '𞤢'), + (0x1E901, 'M', '𞤣'), + (0x1E902, 'M', '𞤤'), + (0x1E903, 'M', '𞤥'), + (0x1E904, 'M', '𞤦'), + (0x1E905, 'M', '𞤧'), + (0x1E906, 'M', '𞤨'), + (0x1E907, 'M', '𞤩'), + (0x1E908, 'M', '𞤪'), + (0x1E909, 'M', '𞤫'), + (0x1E90A, 'M', '𞤬'), + (0x1E90B, 'M', '𞤭'), + (0x1E90C, 'M', '𞤮'), + (0x1E90D, 'M', '𞤯'), + ] + +def _seg_72() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1E90E, 'M', '𞤰'), + (0x1E90F, 'M', '𞤱'), + (0x1E910, 'M', '𞤲'), + (0x1E911, 'M', '𞤳'), + (0x1E912, 'M', '𞤴'), + (0x1E913, 'M', '𞤵'), + (0x1E914, 'M', '𞤶'), + (0x1E915, 'M', '𞤷'), + (0x1E916, 'M', '𞤸'), + (0x1E917, 'M', '𞤹'), + (0x1E918, 'M', '𞤺'), + (0x1E919, 'M', '𞤻'), + (0x1E91A, 'M', '𞤼'), + (0x1E91B, 'M', '𞤽'), + (0x1E91C, 'M', '𞤾'), + (0x1E91D, 'M', '𞤿'), + (0x1E91E, 'M', '𞥀'), + (0x1E91F, 'M', '𞥁'), + (0x1E920, 'M', '𞥂'), + (0x1E921, 'M', '𞥃'), + (0x1E922, 'V'), + (0x1E94C, 'X'), + (0x1E950, 'V'), + (0x1E95A, 'X'), + (0x1E95E, 'V'), + (0x1E960, 'X'), + (0x1EC71, 'V'), + (0x1ECB5, 'X'), + (0x1ED01, 'V'), + (0x1ED3E, 'X'), + (0x1EE00, 'M', 'ا'), + (0x1EE01, 'M', 'ب'), + (0x1EE02, 'M', 'ج'), + (0x1EE03, 'M', 'د'), + (0x1EE04, 'X'), + (0x1EE05, 'M', 'و'), + (0x1EE06, 'M', 'ز'), + (0x1EE07, 'M', 'ح'), + (0x1EE08, 'M', 'ط'), + (0x1EE09, 'M', 'ي'), + (0x1EE0A, 'M', 'ك'), + (0x1EE0B, 'M', 'ل'), + (0x1EE0C, 'M', 'م'), + (0x1EE0D, 'M', 'ن'), + (0x1EE0E, 'M', 'س'), + (0x1EE0F, 'M', 'ع'), + (0x1EE10, 'M', 'ف'), + (0x1EE11, 'M', 'ص'), + (0x1EE12, 'M', 'ق'), + (0x1EE13, 'M', 'ر'), + (0x1EE14, 'M', 'ش'), + (0x1EE15, 'M', 'ت'), + (0x1EE16, 'M', 'ث'), + (0x1EE17, 'M', 'خ'), + (0x1EE18, 'M', 'ذ'), + (0x1EE19, 'M', 'ض'), + (0x1EE1A, 'M', 'ظ'), + (0x1EE1B, 'M', 'غ'), + (0x1EE1C, 'M', 'ٮ'), + (0x1EE1D, 'M', 'ں'), + (0x1EE1E, 'M', 'ڡ'), + (0x1EE1F, 'M', 'ٯ'), + (0x1EE20, 'X'), + (0x1EE21, 'M', 'ب'), + (0x1EE22, 'M', 'ج'), + (0x1EE23, 'X'), + (0x1EE24, 'M', 'ه'), + (0x1EE25, 'X'), + (0x1EE27, 'M', 'ح'), + (0x1EE28, 'X'), + (0x1EE29, 'M', 'ي'), + (0x1EE2A, 'M', 'ك'), + (0x1EE2B, 'M', 'ل'), + (0x1EE2C, 'M', 'م'), + (0x1EE2D, 'M', 'ن'), + (0x1EE2E, 'M', 'س'), + (0x1EE2F, 'M', 'ع'), + (0x1EE30, 'M', 'ف'), + (0x1EE31, 'M', 'ص'), + (0x1EE32, 'M', 'ق'), + (0x1EE33, 'X'), + (0x1EE34, 'M', 'ش'), + (0x1EE35, 'M', 'ت'), + (0x1EE36, 'M', 'ث'), + (0x1EE37, 'M', 'خ'), + (0x1EE38, 'X'), + (0x1EE39, 'M', 'ض'), + (0x1EE3A, 'X'), + (0x1EE3B, 'M', 'غ'), + (0x1EE3C, 'X'), + (0x1EE42, 'M', 'ج'), + (0x1EE43, 'X'), + (0x1EE47, 'M', 'ح'), + (0x1EE48, 'X'), + (0x1EE49, 'M', 'ي'), + (0x1EE4A, 'X'), + (0x1EE4B, 'M', 'ل'), + (0x1EE4C, 'X'), + (0x1EE4D, 'M', 'ن'), + (0x1EE4E, 'M', 'س'), + ] + +def _seg_73() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1EE4F, 'M', 'ع'), + (0x1EE50, 'X'), + (0x1EE51, 'M', 'ص'), + (0x1EE52, 'M', 'ق'), + (0x1EE53, 'X'), + (0x1EE54, 'M', 'ش'), + (0x1EE55, 'X'), + (0x1EE57, 'M', 'خ'), + (0x1EE58, 'X'), + (0x1EE59, 'M', 'ض'), + (0x1EE5A, 'X'), + (0x1EE5B, 'M', 'غ'), + (0x1EE5C, 'X'), + (0x1EE5D, 'M', 'ں'), + (0x1EE5E, 'X'), + (0x1EE5F, 'M', 'ٯ'), + (0x1EE60, 'X'), + (0x1EE61, 'M', 'ب'), + (0x1EE62, 'M', 'ج'), + (0x1EE63, 'X'), + (0x1EE64, 'M', 'ه'), + (0x1EE65, 'X'), + (0x1EE67, 'M', 'ح'), + (0x1EE68, 'M', 'ط'), + (0x1EE69, 'M', 'ي'), + (0x1EE6A, 'M', 'ك'), + (0x1EE6B, 'X'), + (0x1EE6C, 'M', 'م'), + (0x1EE6D, 'M', 'ن'), + (0x1EE6E, 'M', 'س'), + (0x1EE6F, 'M', 'ع'), + (0x1EE70, 'M', 'ف'), + (0x1EE71, 'M', 'ص'), + (0x1EE72, 'M', 'ق'), + (0x1EE73, 'X'), + (0x1EE74, 'M', 'ش'), + (0x1EE75, 'M', 'ت'), + (0x1EE76, 'M', 'ث'), + (0x1EE77, 'M', 'خ'), + (0x1EE78, 'X'), + (0x1EE79, 'M', 'ض'), + (0x1EE7A, 'M', 'ظ'), + (0x1EE7B, 'M', 'غ'), + (0x1EE7C, 'M', 'ٮ'), + (0x1EE7D, 'X'), + (0x1EE7E, 'M', 'ڡ'), + (0x1EE7F, 'X'), + (0x1EE80, 'M', 'ا'), + (0x1EE81, 'M', 'ب'), + (0x1EE82, 'M', 'ج'), + (0x1EE83, 'M', 'د'), + (0x1EE84, 'M', 'ه'), + (0x1EE85, 'M', 'و'), + (0x1EE86, 'M', 'ز'), + (0x1EE87, 'M', 'ح'), + (0x1EE88, 'M', 'ط'), + (0x1EE89, 'M', 'ي'), + (0x1EE8A, 'X'), + (0x1EE8B, 'M', 'ل'), + (0x1EE8C, 'M', 'م'), + (0x1EE8D, 'M', 'ن'), + (0x1EE8E, 'M', 'س'), + (0x1EE8F, 'M', 'ع'), + (0x1EE90, 'M', 'ف'), + (0x1EE91, 'M', 'ص'), + (0x1EE92, 'M', 'ق'), + (0x1EE93, 'M', 'ر'), + (0x1EE94, 'M', 'ش'), + (0x1EE95, 'M', 'ت'), + (0x1EE96, 'M', 'ث'), + (0x1EE97, 'M', 'خ'), + (0x1EE98, 'M', 'ذ'), + (0x1EE99, 'M', 'ض'), + (0x1EE9A, 'M', 'ظ'), + (0x1EE9B, 'M', 'غ'), + (0x1EE9C, 'X'), + (0x1EEA1, 'M', 'ب'), + (0x1EEA2, 'M', 'ج'), + (0x1EEA3, 'M', 'د'), + (0x1EEA4, 'X'), + (0x1EEA5, 'M', 'و'), + (0x1EEA6, 'M', 'ز'), + (0x1EEA7, 'M', 'ح'), + (0x1EEA8, 'M', 'ط'), + (0x1EEA9, 'M', 'ي'), + (0x1EEAA, 'X'), + (0x1EEAB, 'M', 'ل'), + (0x1EEAC, 'M', 'م'), + (0x1EEAD, 'M', 'ن'), + (0x1EEAE, 'M', 'س'), + (0x1EEAF, 'M', 'ع'), + (0x1EEB0, 'M', 'ف'), + (0x1EEB1, 'M', 'ص'), + (0x1EEB2, 'M', 'ق'), + (0x1EEB3, 'M', 'ر'), + (0x1EEB4, 'M', 'ش'), + (0x1EEB5, 'M', 'ت'), + (0x1EEB6, 'M', 'ث'), + (0x1EEB7, 'M', 'خ'), + (0x1EEB8, 'M', 'ذ'), + ] + +def _seg_74() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1EEB9, 'M', 'ض'), + (0x1EEBA, 'M', 'ظ'), + (0x1EEBB, 'M', 'غ'), + (0x1EEBC, 'X'), + (0x1EEF0, 'V'), + (0x1EEF2, 'X'), + (0x1F000, 'V'), + (0x1F02C, 'X'), + (0x1F030, 'V'), + (0x1F094, 'X'), + (0x1F0A0, 'V'), + (0x1F0AF, 'X'), + (0x1F0B1, 'V'), + (0x1F0C0, 'X'), + (0x1F0C1, 'V'), + (0x1F0D0, 'X'), + (0x1F0D1, 'V'), + (0x1F0F6, 'X'), + (0x1F101, '3', '0,'), + (0x1F102, '3', '1,'), + (0x1F103, '3', '2,'), + (0x1F104, '3', '3,'), + (0x1F105, '3', '4,'), + (0x1F106, '3', '5,'), + (0x1F107, '3', '6,'), + (0x1F108, '3', '7,'), + (0x1F109, '3', '8,'), + (0x1F10A, '3', '9,'), + (0x1F10B, 'V'), + (0x1F110, '3', '(a)'), + (0x1F111, '3', '(b)'), + (0x1F112, '3', '(c)'), + (0x1F113, '3', '(d)'), + (0x1F114, '3', '(e)'), + (0x1F115, '3', '(f)'), + (0x1F116, '3', '(g)'), + (0x1F117, '3', '(h)'), + (0x1F118, '3', '(i)'), + (0x1F119, '3', '(j)'), + (0x1F11A, '3', '(k)'), + (0x1F11B, '3', '(l)'), + (0x1F11C, '3', '(m)'), + (0x1F11D, '3', '(n)'), + (0x1F11E, '3', '(o)'), + (0x1F11F, '3', '(p)'), + (0x1F120, '3', '(q)'), + (0x1F121, '3', '(r)'), + (0x1F122, '3', '(s)'), + (0x1F123, '3', '(t)'), + (0x1F124, '3', '(u)'), + (0x1F125, '3', '(v)'), + (0x1F126, '3', '(w)'), + (0x1F127, '3', '(x)'), + (0x1F128, '3', '(y)'), + (0x1F129, '3', '(z)'), + (0x1F12A, 'M', '〔s〕'), + (0x1F12B, 'M', 'c'), + (0x1F12C, 'M', 'r'), + (0x1F12D, 'M', 'cd'), + (0x1F12E, 'M', 'wz'), + (0x1F12F, 'V'), + (0x1F130, 'M', 'a'), + (0x1F131, 'M', 'b'), + (0x1F132, 'M', 'c'), + (0x1F133, 'M', 'd'), + (0x1F134, 'M', 'e'), + (0x1F135, 'M', 'f'), + (0x1F136, 'M', 'g'), + (0x1F137, 'M', 'h'), + (0x1F138, 'M', 'i'), + (0x1F139, 'M', 'j'), + (0x1F13A, 'M', 'k'), + (0x1F13B, 'M', 'l'), + (0x1F13C, 'M', 'm'), + (0x1F13D, 'M', 'n'), + (0x1F13E, 'M', 'o'), + (0x1F13F, 'M', 'p'), + (0x1F140, 'M', 'q'), + (0x1F141, 'M', 'r'), + (0x1F142, 'M', 's'), + (0x1F143, 'M', 't'), + (0x1F144, 'M', 'u'), + (0x1F145, 'M', 'v'), + (0x1F146, 'M', 'w'), + (0x1F147, 'M', 'x'), + (0x1F148, 'M', 'y'), + (0x1F149, 'M', 'z'), + (0x1F14A, 'M', 'hv'), + (0x1F14B, 'M', 'mv'), + (0x1F14C, 'M', 'sd'), + (0x1F14D, 'M', 'ss'), + (0x1F14E, 'M', 'ppv'), + (0x1F14F, 'M', 'wc'), + (0x1F150, 'V'), + (0x1F16A, 'M', 'mc'), + (0x1F16B, 'M', 'md'), + (0x1F16C, 'M', 'mr'), + (0x1F16D, 'V'), + (0x1F190, 'M', 'dj'), + (0x1F191, 'V'), + ] + +def _seg_75() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1F1AE, 'X'), + (0x1F1E6, 'V'), + (0x1F200, 'M', 'ほか'), + (0x1F201, 'M', 'ココ'), + (0x1F202, 'M', 'サ'), + (0x1F203, 'X'), + (0x1F210, 'M', '手'), + (0x1F211, 'M', '字'), + (0x1F212, 'M', '双'), + (0x1F213, 'M', 'デ'), + (0x1F214, 'M', '二'), + (0x1F215, 'M', '多'), + (0x1F216, 'M', '解'), + (0x1F217, 'M', '天'), + (0x1F218, 'M', '交'), + (0x1F219, 'M', '映'), + (0x1F21A, 'M', '無'), + (0x1F21B, 'M', '料'), + (0x1F21C, 'M', '前'), + (0x1F21D, 'M', '後'), + (0x1F21E, 'M', '再'), + (0x1F21F, 'M', '新'), + (0x1F220, 'M', '初'), + (0x1F221, 'M', '終'), + (0x1F222, 'M', '生'), + (0x1F223, 'M', '販'), + (0x1F224, 'M', '声'), + (0x1F225, 'M', '吹'), + (0x1F226, 'M', '演'), + (0x1F227, 'M', '投'), + (0x1F228, 'M', '捕'), + (0x1F229, 'M', '一'), + (0x1F22A, 'M', '三'), + (0x1F22B, 'M', '遊'), + (0x1F22C, 'M', '左'), + (0x1F22D, 'M', '中'), + (0x1F22E, 'M', '右'), + (0x1F22F, 'M', '指'), + (0x1F230, 'M', '走'), + (0x1F231, 'M', '打'), + (0x1F232, 'M', '禁'), + (0x1F233, 'M', '空'), + (0x1F234, 'M', '合'), + (0x1F235, 'M', '満'), + (0x1F236, 'M', '有'), + (0x1F237, 'M', '月'), + (0x1F238, 'M', '申'), + (0x1F239, 'M', '割'), + (0x1F23A, 'M', '営'), + (0x1F23B, 'M', '配'), + (0x1F23C, 'X'), + (0x1F240, 'M', '〔本〕'), + (0x1F241, 'M', '〔三〕'), + (0x1F242, 'M', '〔二〕'), + (0x1F243, 'M', '〔安〕'), + (0x1F244, 'M', '〔点〕'), + (0x1F245, 'M', '〔打〕'), + (0x1F246, 'M', '〔盗〕'), + (0x1F247, 'M', '〔勝〕'), + (0x1F248, 'M', '〔敗〕'), + (0x1F249, 'X'), + (0x1F250, 'M', '得'), + (0x1F251, 'M', '可'), + (0x1F252, 'X'), + (0x1F260, 'V'), + (0x1F266, 'X'), + (0x1F300, 'V'), + (0x1F6D8, 'X'), + (0x1F6DC, 'V'), + (0x1F6ED, 'X'), + (0x1F6F0, 'V'), + (0x1F6FD, 'X'), + (0x1F700, 'V'), + (0x1F777, 'X'), + (0x1F77B, 'V'), + (0x1F7DA, 'X'), + (0x1F7E0, 'V'), + (0x1F7EC, 'X'), + (0x1F7F0, 'V'), + (0x1F7F1, 'X'), + (0x1F800, 'V'), + (0x1F80C, 'X'), + (0x1F810, 'V'), + (0x1F848, 'X'), + (0x1F850, 'V'), + (0x1F85A, 'X'), + (0x1F860, 'V'), + (0x1F888, 'X'), + (0x1F890, 'V'), + (0x1F8AE, 'X'), + (0x1F8B0, 'V'), + (0x1F8B2, 'X'), + (0x1F900, 'V'), + (0x1FA54, 'X'), + (0x1FA60, 'V'), + (0x1FA6E, 'X'), + (0x1FA70, 'V'), + (0x1FA7D, 'X'), + (0x1FA80, 'V'), + (0x1FA89, 'X'), + ] + +def _seg_76() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1FA90, 'V'), + (0x1FABE, 'X'), + (0x1FABF, 'V'), + (0x1FAC6, 'X'), + (0x1FACE, 'V'), + (0x1FADC, 'X'), + (0x1FAE0, 'V'), + (0x1FAE9, 'X'), + (0x1FAF0, 'V'), + (0x1FAF9, 'X'), + (0x1FB00, 'V'), + (0x1FB93, 'X'), + (0x1FB94, 'V'), + (0x1FBCB, 'X'), + (0x1FBF0, 'M', '0'), + (0x1FBF1, 'M', '1'), + (0x1FBF2, 'M', '2'), + (0x1FBF3, 'M', '3'), + (0x1FBF4, 'M', '4'), + (0x1FBF5, 'M', '5'), + (0x1FBF6, 'M', '6'), + (0x1FBF7, 'M', '7'), + (0x1FBF8, 'M', '8'), + (0x1FBF9, 'M', '9'), + (0x1FBFA, 'X'), + (0x20000, 'V'), + (0x2A6E0, 'X'), + (0x2A700, 'V'), + (0x2B73A, 'X'), + (0x2B740, 'V'), + (0x2B81E, 'X'), + (0x2B820, 'V'), + (0x2CEA2, 'X'), + (0x2CEB0, 'V'), + (0x2EBE1, 'X'), + (0x2EBF0, 'V'), + (0x2EE5E, 'X'), + (0x2F800, 'M', '丽'), + (0x2F801, 'M', '丸'), + (0x2F802, 'M', '乁'), + (0x2F803, 'M', '𠄢'), + (0x2F804, 'M', '你'), + (0x2F805, 'M', '侮'), + (0x2F806, 'M', '侻'), + (0x2F807, 'M', '倂'), + (0x2F808, 'M', '偺'), + (0x2F809, 'M', '備'), + (0x2F80A, 'M', '僧'), + (0x2F80B, 'M', '像'), + (0x2F80C, 'M', '㒞'), + (0x2F80D, 'M', '𠘺'), + (0x2F80E, 'M', '免'), + (0x2F80F, 'M', '兔'), + (0x2F810, 'M', '兤'), + (0x2F811, 'M', '具'), + (0x2F812, 'M', '𠔜'), + (0x2F813, 'M', '㒹'), + (0x2F814, 'M', '內'), + (0x2F815, 'M', '再'), + (0x2F816, 'M', '𠕋'), + (0x2F817, 'M', '冗'), + (0x2F818, 'M', '冤'), + (0x2F819, 'M', '仌'), + (0x2F81A, 'M', '冬'), + (0x2F81B, 'M', '况'), + (0x2F81C, 'M', '𩇟'), + (0x2F81D, 'M', '凵'), + (0x2F81E, 'M', '刃'), + (0x2F81F, 'M', '㓟'), + (0x2F820, 'M', '刻'), + (0x2F821, 'M', '剆'), + (0x2F822, 'M', '割'), + (0x2F823, 'M', '剷'), + (0x2F824, 'M', '㔕'), + (0x2F825, 'M', '勇'), + (0x2F826, 'M', '勉'), + (0x2F827, 'M', '勤'), + (0x2F828, 'M', '勺'), + (0x2F829, 'M', '包'), + (0x2F82A, 'M', '匆'), + (0x2F82B, 'M', '北'), + (0x2F82C, 'M', '卉'), + (0x2F82D, 'M', '卑'), + (0x2F82E, 'M', '博'), + (0x2F82F, 'M', '即'), + (0x2F830, 'M', '卽'), + (0x2F831, 'M', '卿'), + (0x2F834, 'M', '𠨬'), + (0x2F835, 'M', '灰'), + (0x2F836, 'M', '及'), + (0x2F837, 'M', '叟'), + (0x2F838, 'M', '𠭣'), + (0x2F839, 'M', '叫'), + (0x2F83A, 'M', '叱'), + (0x2F83B, 'M', '吆'), + (0x2F83C, 'M', '咞'), + (0x2F83D, 'M', '吸'), + (0x2F83E, 'M', '呈'), + (0x2F83F, 'M', '周'), + (0x2F840, 'M', '咢'), + ] + +def _seg_77() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x2F841, 'M', '哶'), + (0x2F842, 'M', '唐'), + (0x2F843, 'M', '啓'), + (0x2F844, 'M', '啣'), + (0x2F845, 'M', '善'), + (0x2F847, 'M', '喙'), + (0x2F848, 'M', '喫'), + (0x2F849, 'M', '喳'), + (0x2F84A, 'M', '嗂'), + (0x2F84B, 'M', '圖'), + (0x2F84C, 'M', '嘆'), + (0x2F84D, 'M', '圗'), + (0x2F84E, 'M', '噑'), + (0x2F84F, 'M', '噴'), + (0x2F850, 'M', '切'), + (0x2F851, 'M', '壮'), + (0x2F852, 'M', '城'), + (0x2F853, 'M', '埴'), + (0x2F854, 'M', '堍'), + (0x2F855, 'M', '型'), + (0x2F856, 'M', '堲'), + (0x2F857, 'M', '報'), + (0x2F858, 'M', '墬'), + (0x2F859, 'M', '𡓤'), + (0x2F85A, 'M', '売'), + (0x2F85B, 'M', '壷'), + (0x2F85C, 'M', '夆'), + (0x2F85D, 'M', '多'), + (0x2F85E, 'M', '夢'), + (0x2F85F, 'M', '奢'), + (0x2F860, 'M', '𡚨'), + (0x2F861, 'M', '𡛪'), + (0x2F862, 'M', '姬'), + (0x2F863, 'M', '娛'), + (0x2F864, 'M', '娧'), + (0x2F865, 'M', '姘'), + (0x2F866, 'M', '婦'), + (0x2F867, 'M', '㛮'), + (0x2F868, 'X'), + (0x2F869, 'M', '嬈'), + (0x2F86A, 'M', '嬾'), + (0x2F86C, 'M', '𡧈'), + (0x2F86D, 'M', '寃'), + (0x2F86E, 'M', '寘'), + (0x2F86F, 'M', '寧'), + (0x2F870, 'M', '寳'), + (0x2F871, 'M', '𡬘'), + (0x2F872, 'M', '寿'), + (0x2F873, 'M', '将'), + (0x2F874, 'X'), + (0x2F875, 'M', '尢'), + (0x2F876, 'M', '㞁'), + (0x2F877, 'M', '屠'), + (0x2F878, 'M', '屮'), + (0x2F879, 'M', '峀'), + (0x2F87A, 'M', '岍'), + (0x2F87B, 'M', '𡷤'), + (0x2F87C, 'M', '嵃'), + (0x2F87D, 'M', '𡷦'), + (0x2F87E, 'M', '嵮'), + (0x2F87F, 'M', '嵫'), + (0x2F880, 'M', '嵼'), + (0x2F881, 'M', '巡'), + (0x2F882, 'M', '巢'), + (0x2F883, 'M', '㠯'), + (0x2F884, 'M', '巽'), + (0x2F885, 'M', '帨'), + (0x2F886, 'M', '帽'), + (0x2F887, 'M', '幩'), + (0x2F888, 'M', '㡢'), + (0x2F889, 'M', '𢆃'), + (0x2F88A, 'M', '㡼'), + (0x2F88B, 'M', '庰'), + (0x2F88C, 'M', '庳'), + (0x2F88D, 'M', '庶'), + (0x2F88E, 'M', '廊'), + (0x2F88F, 'M', '𪎒'), + (0x2F890, 'M', '廾'), + (0x2F891, 'M', '𢌱'), + (0x2F893, 'M', '舁'), + (0x2F894, 'M', '弢'), + (0x2F896, 'M', '㣇'), + (0x2F897, 'M', '𣊸'), + (0x2F898, 'M', '𦇚'), + (0x2F899, 'M', '形'), + (0x2F89A, 'M', '彫'), + (0x2F89B, 'M', '㣣'), + (0x2F89C, 'M', '徚'), + (0x2F89D, 'M', '忍'), + (0x2F89E, 'M', '志'), + (0x2F89F, 'M', '忹'), + (0x2F8A0, 'M', '悁'), + (0x2F8A1, 'M', '㤺'), + (0x2F8A2, 'M', '㤜'), + (0x2F8A3, 'M', '悔'), + (0x2F8A4, 'M', '𢛔'), + (0x2F8A5, 'M', '惇'), + (0x2F8A6, 'M', '慈'), + (0x2F8A7, 'M', '慌'), + (0x2F8A8, 'M', '慎'), + ] + +def _seg_78() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x2F8A9, 'M', '慌'), + (0x2F8AA, 'M', '慺'), + (0x2F8AB, 'M', '憎'), + (0x2F8AC, 'M', '憲'), + (0x2F8AD, 'M', '憤'), + (0x2F8AE, 'M', '憯'), + (0x2F8AF, 'M', '懞'), + (0x2F8B0, 'M', '懲'), + (0x2F8B1, 'M', '懶'), + (0x2F8B2, 'M', '成'), + (0x2F8B3, 'M', '戛'), + (0x2F8B4, 'M', '扝'), + (0x2F8B5, 'M', '抱'), + (0x2F8B6, 'M', '拔'), + (0x2F8B7, 'M', '捐'), + (0x2F8B8, 'M', '𢬌'), + (0x2F8B9, 'M', '挽'), + (0x2F8BA, 'M', '拼'), + (0x2F8BB, 'M', '捨'), + (0x2F8BC, 'M', '掃'), + (0x2F8BD, 'M', '揤'), + (0x2F8BE, 'M', '𢯱'), + (0x2F8BF, 'M', '搢'), + (0x2F8C0, 'M', '揅'), + (0x2F8C1, 'M', '掩'), + (0x2F8C2, 'M', '㨮'), + (0x2F8C3, 'M', '摩'), + (0x2F8C4, 'M', '摾'), + (0x2F8C5, 'M', '撝'), + (0x2F8C6, 'M', '摷'), + (0x2F8C7, 'M', '㩬'), + (0x2F8C8, 'M', '敏'), + (0x2F8C9, 'M', '敬'), + (0x2F8CA, 'M', '𣀊'), + (0x2F8CB, 'M', '旣'), + (0x2F8CC, 'M', '書'), + (0x2F8CD, 'M', '晉'), + (0x2F8CE, 'M', '㬙'), + (0x2F8CF, 'M', '暑'), + (0x2F8D0, 'M', '㬈'), + (0x2F8D1, 'M', '㫤'), + (0x2F8D2, 'M', '冒'), + (0x2F8D3, 'M', '冕'), + (0x2F8D4, 'M', '最'), + (0x2F8D5, 'M', '暜'), + (0x2F8D6, 'M', '肭'), + (0x2F8D7, 'M', '䏙'), + (0x2F8D8, 'M', '朗'), + (0x2F8D9, 'M', '望'), + (0x2F8DA, 'M', '朡'), + (0x2F8DB, 'M', '杞'), + (0x2F8DC, 'M', '杓'), + (0x2F8DD, 'M', '𣏃'), + (0x2F8DE, 'M', '㭉'), + (0x2F8DF, 'M', '柺'), + (0x2F8E0, 'M', '枅'), + (0x2F8E1, 'M', '桒'), + (0x2F8E2, 'M', '梅'), + (0x2F8E3, 'M', '𣑭'), + (0x2F8E4, 'M', '梎'), + (0x2F8E5, 'M', '栟'), + (0x2F8E6, 'M', '椔'), + (0x2F8E7, 'M', '㮝'), + (0x2F8E8, 'M', '楂'), + (0x2F8E9, 'M', '榣'), + (0x2F8EA, 'M', '槪'), + (0x2F8EB, 'M', '檨'), + (0x2F8EC, 'M', '𣚣'), + (0x2F8ED, 'M', '櫛'), + (0x2F8EE, 'M', '㰘'), + (0x2F8EF, 'M', '次'), + (0x2F8F0, 'M', '𣢧'), + (0x2F8F1, 'M', '歔'), + (0x2F8F2, 'M', '㱎'), + (0x2F8F3, 'M', '歲'), + (0x2F8F4, 'M', '殟'), + (0x2F8F5, 'M', '殺'), + (0x2F8F6, 'M', '殻'), + (0x2F8F7, 'M', '𣪍'), + (0x2F8F8, 'M', '𡴋'), + (0x2F8F9, 'M', '𣫺'), + (0x2F8FA, 'M', '汎'), + (0x2F8FB, 'M', '𣲼'), + (0x2F8FC, 'M', '沿'), + (0x2F8FD, 'M', '泍'), + (0x2F8FE, 'M', '汧'), + (0x2F8FF, 'M', '洖'), + (0x2F900, 'M', '派'), + (0x2F901, 'M', '海'), + (0x2F902, 'M', '流'), + (0x2F903, 'M', '浩'), + (0x2F904, 'M', '浸'), + (0x2F905, 'M', '涅'), + (0x2F906, 'M', '𣴞'), + (0x2F907, 'M', '洴'), + (0x2F908, 'M', '港'), + (0x2F909, 'M', '湮'), + (0x2F90A, 'M', '㴳'), + (0x2F90B, 'M', '滋'), + (0x2F90C, 'M', '滇'), + ] + +def _seg_79() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x2F90D, 'M', '𣻑'), + (0x2F90E, 'M', '淹'), + (0x2F90F, 'M', '潮'), + (0x2F910, 'M', '𣽞'), + (0x2F911, 'M', '𣾎'), + (0x2F912, 'M', '濆'), + (0x2F913, 'M', '瀹'), + (0x2F914, 'M', '瀞'), + (0x2F915, 'M', '瀛'), + (0x2F916, 'M', '㶖'), + (0x2F917, 'M', '灊'), + (0x2F918, 'M', '災'), + (0x2F919, 'M', '灷'), + (0x2F91A, 'M', '炭'), + (0x2F91B, 'M', '𠔥'), + (0x2F91C, 'M', '煅'), + (0x2F91D, 'M', '𤉣'), + (0x2F91E, 'M', '熜'), + (0x2F91F, 'X'), + (0x2F920, 'M', '爨'), + (0x2F921, 'M', '爵'), + (0x2F922, 'M', '牐'), + (0x2F923, 'M', '𤘈'), + (0x2F924, 'M', '犀'), + (0x2F925, 'M', '犕'), + (0x2F926, 'M', '𤜵'), + (0x2F927, 'M', '𤠔'), + (0x2F928, 'M', '獺'), + (0x2F929, 'M', '王'), + (0x2F92A, 'M', '㺬'), + (0x2F92B, 'M', '玥'), + (0x2F92C, 'M', '㺸'), + (0x2F92E, 'M', '瑇'), + (0x2F92F, 'M', '瑜'), + (0x2F930, 'M', '瑱'), + (0x2F931, 'M', '璅'), + (0x2F932, 'M', '瓊'), + (0x2F933, 'M', '㼛'), + (0x2F934, 'M', '甤'), + (0x2F935, 'M', '𤰶'), + (0x2F936, 'M', '甾'), + (0x2F937, 'M', '𤲒'), + (0x2F938, 'M', '異'), + (0x2F939, 'M', '𢆟'), + (0x2F93A, 'M', '瘐'), + (0x2F93B, 'M', '𤾡'), + (0x2F93C, 'M', '𤾸'), + (0x2F93D, 'M', '𥁄'), + (0x2F93E, 'M', '㿼'), + (0x2F93F, 'M', '䀈'), + (0x2F940, 'M', '直'), + (0x2F941, 'M', '𥃳'), + (0x2F942, 'M', '𥃲'), + (0x2F943, 'M', '𥄙'), + (0x2F944, 'M', '𥄳'), + (0x2F945, 'M', '眞'), + (0x2F946, 'M', '真'), + (0x2F948, 'M', '睊'), + (0x2F949, 'M', '䀹'), + (0x2F94A, 'M', '瞋'), + (0x2F94B, 'M', '䁆'), + (0x2F94C, 'M', '䂖'), + (0x2F94D, 'M', '𥐝'), + (0x2F94E, 'M', '硎'), + (0x2F94F, 'M', '碌'), + (0x2F950, 'M', '磌'), + (0x2F951, 'M', '䃣'), + (0x2F952, 'M', '𥘦'), + (0x2F953, 'M', '祖'), + (0x2F954, 'M', '𥚚'), + (0x2F955, 'M', '𥛅'), + (0x2F956, 'M', '福'), + (0x2F957, 'M', '秫'), + (0x2F958, 'M', '䄯'), + (0x2F959, 'M', '穀'), + (0x2F95A, 'M', '穊'), + (0x2F95B, 'M', '穏'), + (0x2F95C, 'M', '𥥼'), + (0x2F95D, 'M', '𥪧'), + (0x2F95F, 'X'), + (0x2F960, 'M', '䈂'), + (0x2F961, 'M', '𥮫'), + (0x2F962, 'M', '篆'), + (0x2F963, 'M', '築'), + (0x2F964, 'M', '䈧'), + (0x2F965, 'M', '𥲀'), + (0x2F966, 'M', '糒'), + (0x2F967, 'M', '䊠'), + (0x2F968, 'M', '糨'), + (0x2F969, 'M', '糣'), + (0x2F96A, 'M', '紀'), + (0x2F96B, 'M', '𥾆'), + (0x2F96C, 'M', '絣'), + (0x2F96D, 'M', '䌁'), + (0x2F96E, 'M', '緇'), + (0x2F96F, 'M', '縂'), + (0x2F970, 'M', '繅'), + (0x2F971, 'M', '䌴'), + (0x2F972, 'M', '𦈨'), + (0x2F973, 'M', '𦉇'), + ] + +def _seg_80() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x2F974, 'M', '䍙'), + (0x2F975, 'M', '𦋙'), + (0x2F976, 'M', '罺'), + (0x2F977, 'M', '𦌾'), + (0x2F978, 'M', '羕'), + (0x2F979, 'M', '翺'), + (0x2F97A, 'M', '者'), + (0x2F97B, 'M', '𦓚'), + (0x2F97C, 'M', '𦔣'), + (0x2F97D, 'M', '聠'), + (0x2F97E, 'M', '𦖨'), + (0x2F97F, 'M', '聰'), + (0x2F980, 'M', '𣍟'), + (0x2F981, 'M', '䏕'), + (0x2F982, 'M', '育'), + (0x2F983, 'M', '脃'), + (0x2F984, 'M', '䐋'), + (0x2F985, 'M', '脾'), + (0x2F986, 'M', '媵'), + (0x2F987, 'M', '𦞧'), + (0x2F988, 'M', '𦞵'), + (0x2F989, 'M', '𣎓'), + (0x2F98A, 'M', '𣎜'), + (0x2F98B, 'M', '舁'), + (0x2F98C, 'M', '舄'), + (0x2F98D, 'M', '辞'), + (0x2F98E, 'M', '䑫'), + (0x2F98F, 'M', '芑'), + (0x2F990, 'M', '芋'), + (0x2F991, 'M', '芝'), + (0x2F992, 'M', '劳'), + (0x2F993, 'M', '花'), + (0x2F994, 'M', '芳'), + (0x2F995, 'M', '芽'), + (0x2F996, 'M', '苦'), + (0x2F997, 'M', '𦬼'), + (0x2F998, 'M', '若'), + (0x2F999, 'M', '茝'), + (0x2F99A, 'M', '荣'), + (0x2F99B, 'M', '莭'), + (0x2F99C, 'M', '茣'), + (0x2F99D, 'M', '莽'), + (0x2F99E, 'M', '菧'), + (0x2F99F, 'M', '著'), + (0x2F9A0, 'M', '荓'), + (0x2F9A1, 'M', '菊'), + (0x2F9A2, 'M', '菌'), + (0x2F9A3, 'M', '菜'), + (0x2F9A4, 'M', '𦰶'), + (0x2F9A5, 'M', '𦵫'), + (0x2F9A6, 'M', '𦳕'), + (0x2F9A7, 'M', '䔫'), + (0x2F9A8, 'M', '蓱'), + (0x2F9A9, 'M', '蓳'), + (0x2F9AA, 'M', '蔖'), + (0x2F9AB, 'M', '𧏊'), + (0x2F9AC, 'M', '蕤'), + (0x2F9AD, 'M', '𦼬'), + (0x2F9AE, 'M', '䕝'), + (0x2F9AF, 'M', '䕡'), + (0x2F9B0, 'M', '𦾱'), + (0x2F9B1, 'M', '𧃒'), + (0x2F9B2, 'M', '䕫'), + (0x2F9B3, 'M', '虐'), + (0x2F9B4, 'M', '虜'), + (0x2F9B5, 'M', '虧'), + (0x2F9B6, 'M', '虩'), + (0x2F9B7, 'M', '蚩'), + (0x2F9B8, 'M', '蚈'), + (0x2F9B9, 'M', '蜎'), + (0x2F9BA, 'M', '蛢'), + (0x2F9BB, 'M', '蝹'), + (0x2F9BC, 'M', '蜨'), + (0x2F9BD, 'M', '蝫'), + (0x2F9BE, 'M', '螆'), + (0x2F9BF, 'X'), + (0x2F9C0, 'M', '蟡'), + (0x2F9C1, 'M', '蠁'), + (0x2F9C2, 'M', '䗹'), + (0x2F9C3, 'M', '衠'), + (0x2F9C4, 'M', '衣'), + (0x2F9C5, 'M', '𧙧'), + (0x2F9C6, 'M', '裗'), + (0x2F9C7, 'M', '裞'), + (0x2F9C8, 'M', '䘵'), + (0x2F9C9, 'M', '裺'), + (0x2F9CA, 'M', '㒻'), + (0x2F9CB, 'M', '𧢮'), + (0x2F9CC, 'M', '𧥦'), + (0x2F9CD, 'M', '䚾'), + (0x2F9CE, 'M', '䛇'), + (0x2F9CF, 'M', '誠'), + (0x2F9D0, 'M', '諭'), + (0x2F9D1, 'M', '變'), + (0x2F9D2, 'M', '豕'), + (0x2F9D3, 'M', '𧲨'), + (0x2F9D4, 'M', '貫'), + (0x2F9D5, 'M', '賁'), + (0x2F9D6, 'M', '贛'), + (0x2F9D7, 'M', '起'), + ] + +def _seg_81() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x2F9D8, 'M', '𧼯'), + (0x2F9D9, 'M', '𠠄'), + (0x2F9DA, 'M', '跋'), + (0x2F9DB, 'M', '趼'), + (0x2F9DC, 'M', '跰'), + (0x2F9DD, 'M', '𠣞'), + (0x2F9DE, 'M', '軔'), + (0x2F9DF, 'M', '輸'), + (0x2F9E0, 'M', '𨗒'), + (0x2F9E1, 'M', '𨗭'), + (0x2F9E2, 'M', '邔'), + (0x2F9E3, 'M', '郱'), + (0x2F9E4, 'M', '鄑'), + (0x2F9E5, 'M', '𨜮'), + (0x2F9E6, 'M', '鄛'), + (0x2F9E7, 'M', '鈸'), + (0x2F9E8, 'M', '鋗'), + (0x2F9E9, 'M', '鋘'), + (0x2F9EA, 'M', '鉼'), + (0x2F9EB, 'M', '鏹'), + (0x2F9EC, 'M', '鐕'), + (0x2F9ED, 'M', '𨯺'), + (0x2F9EE, 'M', '開'), + (0x2F9EF, 'M', '䦕'), + (0x2F9F0, 'M', '閷'), + (0x2F9F1, 'M', '𨵷'), + (0x2F9F2, 'M', '䧦'), + (0x2F9F3, 'M', '雃'), + (0x2F9F4, 'M', '嶲'), + (0x2F9F5, 'M', '霣'), + (0x2F9F6, 'M', '𩅅'), + (0x2F9F7, 'M', '𩈚'), + (0x2F9F8, 'M', '䩮'), + (0x2F9F9, 'M', '䩶'), + (0x2F9FA, 'M', '韠'), + (0x2F9FB, 'M', '𩐊'), + (0x2F9FC, 'M', '䪲'), + (0x2F9FD, 'M', '𩒖'), + (0x2F9FE, 'M', '頋'), + (0x2FA00, 'M', '頩'), + (0x2FA01, 'M', '𩖶'), + (0x2FA02, 'M', '飢'), + (0x2FA03, 'M', '䬳'), + (0x2FA04, 'M', '餩'), + (0x2FA05, 'M', '馧'), + (0x2FA06, 'M', '駂'), + (0x2FA07, 'M', '駾'), + (0x2FA08, 'M', '䯎'), + (0x2FA09, 'M', '𩬰'), + (0x2FA0A, 'M', '鬒'), + (0x2FA0B, 'M', '鱀'), + (0x2FA0C, 'M', '鳽'), + (0x2FA0D, 'M', '䳎'), + (0x2FA0E, 'M', '䳭'), + (0x2FA0F, 'M', '鵧'), + (0x2FA10, 'M', '𪃎'), + (0x2FA11, 'M', '䳸'), + (0x2FA12, 'M', '𪄅'), + (0x2FA13, 'M', '𪈎'), + (0x2FA14, 'M', '𪊑'), + (0x2FA15, 'M', '麻'), + (0x2FA16, 'M', '䵖'), + (0x2FA17, 'M', '黹'), + (0x2FA18, 'M', '黾'), + (0x2FA19, 'M', '鼅'), + (0x2FA1A, 'M', '鼏'), + (0x2FA1B, 'M', '鼖'), + (0x2FA1C, 'M', '鼻'), + (0x2FA1D, 'M', '𪘀'), + (0x2FA1E, 'X'), + (0x30000, 'V'), + (0x3134B, 'X'), + (0x31350, 'V'), + (0x323B0, 'X'), + (0xE0100, 'I'), + (0xE01F0, 'X'), + ] + +uts46data = tuple( + _seg_0() + + _seg_1() + + _seg_2() + + _seg_3() + + _seg_4() + + _seg_5() + + _seg_6() + + _seg_7() + + _seg_8() + + _seg_9() + + _seg_10() + + _seg_11() + + _seg_12() + + _seg_13() + + _seg_14() + + _seg_15() + + _seg_16() + + _seg_17() + + _seg_18() + + _seg_19() + + _seg_20() + + _seg_21() + + _seg_22() + + _seg_23() + + _seg_24() + + _seg_25() + + _seg_26() + + _seg_27() + + _seg_28() + + _seg_29() + + _seg_30() + + _seg_31() + + _seg_32() + + _seg_33() + + _seg_34() + + _seg_35() + + _seg_36() + + _seg_37() + + _seg_38() + + _seg_39() + + _seg_40() + + _seg_41() + + _seg_42() + + _seg_43() + + _seg_44() + + _seg_45() + + _seg_46() + + _seg_47() + + _seg_48() + + _seg_49() + + _seg_50() + + _seg_51() + + _seg_52() + + _seg_53() + + _seg_54() + + _seg_55() + + _seg_56() + + _seg_57() + + _seg_58() + + _seg_59() + + _seg_60() + + _seg_61() + + _seg_62() + + _seg_63() + + _seg_64() + + _seg_65() + + _seg_66() + + _seg_67() + + _seg_68() + + _seg_69() + + _seg_70() + + _seg_71() + + _seg_72() + + _seg_73() + + _seg_74() + + _seg_75() + + _seg_76() + + _seg_77() + + _seg_78() + + _seg_79() + + _seg_80() + + _seg_81() +) # type: Tuple[Union[Tuple[int, str], Tuple[int, str, str]], ...] diff --git a/.venv/lib/python3.12/site-packages/pip-24.2.dist-info/AUTHORS.txt b/.venv/lib/python3.12/site-packages/pip-24.2.dist-info/AUTHORS.txt new file mode 100644 index 0000000..dda2ac3 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip-24.2.dist-info/AUTHORS.txt @@ -0,0 +1,796 @@ +@Switch01 +A_Rog +Aakanksha Agrawal +Abhinav Sagar +ABHYUDAY PRATAP SINGH +abs51295 +AceGentile +Adam Chainz +Adam Tse +Adam Wentz +admin +Adolfo Ochagavía +Adrien Morison +Agus +ahayrapetyan +Ahilya +AinsworthK +Akash Srivastava +Alan Yee +Albert Tugushev +Albert-Guan +albertg +Alberto Sottile +Aleks Bunin +Ales Erjavec +Alethea Flowers +Alex Gaynor +Alex Grönholm +Alex Hedges +Alex Loosley +Alex Morega +Alex Stachowiak +Alexander Shtyrov +Alexandre Conrad +Alexey Popravka +Aleš Erjavec +Alli +Ami Fischman +Ananya Maiti +Anatoly Techtonik +Anders Kaseorg +Andre Aguiar +Andreas Lutro +Andrei Geacar +Andrew Gaul +Andrew Shymanel +Andrey Bienkowski +Andrey Bulgakov +Andrés Delfino +Andy Freeland +Andy Kluger +Ani Hayrapetyan +Aniruddha Basak +Anish Tambe +Anrs Hu +Anthony Sottile +Antoine Musso +Anton Ovchinnikov +Anton Patrushev +Antonio Alvarado Hernandez +Antony Lee +Antti Kaihola +Anubhav Patel +Anudit Nagar +Anuj Godase +AQNOUCH Mohammed +AraHaan +arena +arenasys +Arindam Choudhury +Armin Ronacher +Arnon Yaari +Artem +Arun Babu Neelicattu +Ashley Manton +Ashwin Ramaswami +atse +Atsushi Odagiri +Avinash Karhana +Avner Cohen +Awit (Ah-Wit) Ghirmai +Baptiste Mispelon +Barney Gale +barneygale +Bartek Ogryczak +Bastian Venthur +Ben Bodenmiller +Ben Darnell +Ben Hoyt +Ben Mares +Ben Rosser +Bence Nagy +Benjamin Peterson +Benjamin VanEvery +Benoit Pierre +Berker Peksag +Bernard +Bernard Tyers +Bernardo B. Marques +Bernhard M. Wiedemann +Bertil Hatt +Bhavam Vidyarthi +Blazej Michalik +Bogdan Opanchuk +BorisZZZ +Brad Erickson +Bradley Ayers +Branch Vincent +Brandon L. Reiss +Brandt Bucher +Brannon Dorsey +Brett Randall +Brett Rosen +Brian Cristante +Brian Rosner +briantracy +BrownTruck +Bruno Oliveira +Bruno Renié +Bruno S +Bstrdsmkr +Buck Golemon +burrows +Bussonnier Matthias +bwoodsend +c22 +Caleb Martinez +Calvin Smith +Carl Meyer +Carlos Liam +Carol Willing +Carter Thayer +Cass +Chandrasekhar Atina +Charlie Marsh +Chih-Hsuan Yen +Chris Brinker +Chris Hunt +Chris Jerdonek +Chris Kuehl +Chris Markiewicz +Chris McDonough +Chris Pawley +Chris Pryer +Chris Wolfe +Christian Clauss +Christian Heimes +Christian Oudard +Christoph Reiter +Christopher Hunt +Christopher Snyder +chrysle +cjc7373 +Clark Boylan +Claudio Jolowicz +Clay McClure +Cody +Cody Soyland +Colin Watson +Collin Anderson +Connor Osborn +Cooper Lees +Cooper Ry Lees +Cory Benfield +Cory Wright +Craig Kerstiens +Cristian Sorinel +Cristina +Cristina Muñoz +ctg123 +Curtis Doty +cytolentino +Daan De Meyer +Dale +Damian +Damian Quiroga +Damian Shaw +Dan Black +Dan Savilonis +Dan Sully +Dane Hillard +daniel +Daniel Collins +Daniel Hahler +Daniel Holth +Daniel Jost +Daniel Katz +Daniel Shaulov +Daniele Esposti +Daniele Nicolodi +Daniele Procida +Daniil Konovalenko +Danny Hermes +Danny McClanahan +Darren Kavanagh +Dav Clark +Dave Abrahams +Dave Jones +David Aguilar +David Black +David Bordeynik +David Caro +David D Lowe +David Evans +David Hewitt +David Linke +David Poggi +David Poznik +David Pursehouse +David Runge +David Tucker +David Wales +Davidovich +ddelange +Deepak Sharma +Deepyaman Datta +Denise Yu +dependabot[bot] +derwolfe +Desetude +Devesh Kumar Singh +devsagul +Diego Caraballo +Diego Ramirez +DiegoCaraballo +Dimitri Merejkowsky +Dimitri Papadopoulos +Dirk Stolle +Dmitry Gladkov +Dmitry Volodin +Domen Kožar +Dominic Davis-Foster +Donald Stufft +Dongweiming +doron zarhi +Dos Moonen +Douglas Thor +DrFeathers +Dustin Ingram +Dustin Rodrigues +Dwayne Bailey +Ed Morley +Edgar Ramírez +Edgar Ramírez Mondragón +Ee Durbin +Efflam Lemaillet +efflamlemaillet +Eitan Adler +ekristina +elainechan +Eli Schwartz +Elisha Hollander +Ellen Marie Dash +Emil Burzo +Emil Styrke +Emmanuel Arias +Endoh Takanao +enoch +Erdinc Mutlu +Eric Cousineau +Eric Gillingham +Eric Hanchrow +Eric Hopper +Erik M. Bray +Erik Rose +Erwin Janssen +Eugene Vereshchagin +everdimension +Federico +Felipe Peter +Felix Yan +fiber-space +Filip Kokosiński +Filipe Laíns +Finn Womack +finnagin +Flavio Amurrio +Florian Briand +Florian Rathgeber +Francesco +Francesco Montesano +Fredrik Orderud +Frost Ming +Gabriel Curio +Gabriel de Perthuis +Garry Polley +gavin +gdanielson +Geoffrey Sneddon +George Song +Georgi Valkov +Georgy Pchelkin +ghost +Giftlin Rajaiah +gizmoguy1 +gkdoc +Godefroid Chapelle +Gopinath M +GOTO Hayato +gousaiyang +gpiks +Greg Roodt +Greg Ward +Guilherme Espada +Guillaume Seguin +gutsytechster +Guy Rozendorn +Guy Tuval +gzpan123 +Hanjun Kim +Hari Charan +Harsh Vardhan +harupy +Harutaka Kawamura +hauntsaninja +Henrich Hartzer +Henry Schreiner +Herbert Pfennig +Holly Stotelmyer +Honnix +Hsiaoming Yang +Hugo Lopes Tavares +Hugo van Kemenade +Hugues Bruant +Hynek Schlawack +Ian Bicking +Ian Cordasco +Ian Lee +Ian Stapleton Cordasco +Ian Wienand +Igor Kuzmitshov +Igor Sobreira +Ikko Ashimine +Ilan Schnell +Illia Volochii +Ilya Baryshev +Inada Naoki +Ionel Cristian Mărieș +Ionel Maries Cristian +Itamar Turner-Trauring +Ivan Pozdeev +J. Nick Koston +Jacob Kim +Jacob Walls +Jaime Sanz +jakirkham +Jakub Kuczys +Jakub Stasiak +Jakub Vysoky +Jakub Wilk +James Cleveland +James Curtin +James Firth +James Gerity +James Polley +Jan Pokorný +Jannis Leidel +Jarek Potiuk +jarondl +Jason Curtis +Jason R. Coombs +JasonMo +JasonMo1 +Jay Graves +Jean Abou Samra +Jean-Christophe Fillion-Robin +Jeff Barber +Jeff Dairiki +Jeff Widman +Jelmer Vernooij +jenix21 +Jeremy Fleischman +Jeremy Stanley +Jeremy Zafran +Jesse Rittner +Jiashuo Li +Jim Fisher +Jim Garrison +Jinzhe Zeng +Jiun Bae +Jivan Amara +Joe Bylund +Joe Michelini +John Paton +John Sirois +John T. Wodder II +John-Scott Atlakson +johnthagen +Jon Banafato +Jon Dufresne +Jon Parise +Jonas Nockert +Jonathan Herbert +Joonatan Partanen +Joost Molenaar +Jorge Niedbalski +Joseph Bylund +Joseph Long +Josh Bronson +Josh Cannon +Josh Hansen +Josh Schneier +Joshua +Juan Luis Cano Rodríguez +Juanjo Bazán +Judah Rand +Julian Berman +Julian Gethmann +Julien Demoor +Jussi Kukkonen +jwg4 +Jyrki Pulliainen +Kai Chen +Kai Mueller +Kamal Bin Mustafa +kasium +kaustav haldar +keanemind +Keith Maxwell +Kelsey Hightower +Kenneth Belitzky +Kenneth Reitz +Kevin Burke +Kevin Carter +Kevin Frommelt +Kevin R Patterson +Kexuan Sun +Kit Randel +Klaas van Schelven +KOLANICH +konstin +kpinc +Krishna Oza +Kumar McMillan +Kuntal Majumder +Kurt McKee +Kyle Persohn +lakshmanaram +Laszlo Kiss-Kollar +Laurent Bristiel +Laurent LAPORTE +Laurie O +Laurie Opperman +layday +Leon Sasson +Lev Givon +Lincoln de Sousa +Lipis +lorddavidiii +Loren Carvalho +Lucas Cimon +Ludovic Gasc +Luis Medel +Lukas Geiger +Lukas Juhrich +Luke Macken +Luo Jiebin +luojiebin +luz.paz +László Kiss Kollár +M00nL1ght +Marc Abramowitz +Marc Tamlyn +Marcus Smith +Mariatta +Mark Kohler +Mark McLoughlin +Mark Williams +Markus Hametner +Martey Dodoo +Martin Fischer +Martin Häcker +Martin Pavlasek +Masaki +Masklinn +Matej Stuchlik +Mathew Jennings +Mathieu Bridon +Mathieu Kniewallner +Matt Bacchi +Matt Good +Matt Maker +Matt Robenolt +Matt Wozniski +matthew +Matthew Einhorn +Matthew Feickert +Matthew Gilliard +Matthew Hughes +Matthew Iversen +Matthew Treinish +Matthew Trumbell +Matthew Willson +Matthias Bussonnier +mattip +Maurits van Rees +Max W Chase +Maxim Kurnikov +Maxime Rouyrre +mayeut +mbaluna +mdebi +memoselyk +meowmeowcat +Michael +Michael Aquilina +Michael E. Karpeles +Michael Klich +Michael Mintz +Michael Williamson +michaelpacer +Michał Górny +Mickaël Schoentgen +Miguel Araujo Perez +Mihir Singh +Mike +Mike Hendricks +Min RK +MinRK +Miro Hrončok +Monica Baluna +montefra +Monty Taylor +morotti +mrKazzila +Muha Ajjan +Nadav Wexler +Nahuel Ambrosini +Nate Coraor +Nate Prewitt +Nathan Houghton +Nathaniel J. Smith +Nehal J Wani +Neil Botelho +Nguyễn Gia Phong +Nicholas Serra +Nick Coghlan +Nick Stenning +Nick Timkovich +Nicolas Bock +Nicole Harris +Nikhil Benesch +Nikhil Ladha +Nikita Chepanov +Nikolay Korolev +Nipunn Koorapati +Nitesh Sharma +Niyas Sait +Noah +Noah Gorny +Nowell Strite +NtaleGrey +nvdv +OBITORASU +Ofek Lev +ofrinevo +Oliver Freund +Oliver Jeeves +Oliver Mannion +Oliver Tonnhofer +Olivier Girardot +Olivier Grisel +Ollie Rutherfurd +OMOTO Kenji +Omry Yadan +onlinejudge95 +Oren Held +Oscar Benjamin +Oz N Tiram +Pachwenko +Patrick Dubroy +Patrick Jenkins +Patrick Lawson +patricktokeeffe +Patrik Kopkan +Paul Ganssle +Paul Kehrer +Paul Moore +Paul Nasrat +Paul Oswald +Paul van der Linden +Paulus Schoutsen +Pavel Safronov +Pavithra Eswaramoorthy +Pawel Jasinski +Paweł Szramowski +Pekka Klärck +Peter Gessler +Peter Lisák +Peter Shen +Peter Waller +Petr Viktorin +petr-tik +Phaneendra Chiruvella +Phil Elson +Phil Freo +Phil Pennock +Phil Whelan +Philip Jägenstedt +Philip Molloy +Philippe Ombredanne +Pi Delport +Pierre-Yves Rofes +Pieter Degroote +pip +Prabakaran Kumaresshan +Prabhjyotsing Surjit Singh Sodhi +Prabhu Marappan +Pradyun Gedam +Prashant Sharma +Pratik Mallya +pre-commit-ci[bot] +Preet Thakkar +Preston Holmes +Przemek Wrzos +Pulkit Goyal +q0w +Qiangning Hong +Qiming Xu +Quentin Lee +Quentin Pradet +R. David Murray +Rafael Caricio +Ralf Schmitt +Ran Benita +Razzi Abuissa +rdb +Reece Dunham +Remi Rampin +Rene Dudfield +Riccardo Magliocchetti +Riccardo Schirone +Richard Jones +Richard Si +Ricky Ng-Adam +Rishi +rmorotti +RobberPhex +Robert Collins +Robert McGibbon +Robert Pollak +Robert T. McGibbon +robin elisha robinson +Roey Berman +Rohan Jain +Roman Bogorodskiy +Roman Donchenko +Romuald Brunet +ronaudinho +Ronny Pfannschmidt +Rory McCann +Ross Brattain +Roy Wellington Ⅳ +Ruairidh MacLeod +Russell Keith-Magee +Ryan Shepherd +Ryan Wooden +ryneeverett +S. Guliaev +Sachi King +Salvatore Rinchiera +sandeepkiran-js +Sander Van Balen +Savio Jomton +schlamar +Scott Kitterman +Sean +seanj +Sebastian Jordan +Sebastian Schaetz +Segev Finer +SeongSoo Cho +Sergey Vasilyev +Seth Michael Larson +Seth Woodworth +Shahar Epstein +Shantanu +shenxianpeng +shireenrao +Shivansh-007 +Shixian Sheng +Shlomi Fish +Shovan Maity +Simeon Visser +Simon Cross +Simon Pichugin +sinoroc +sinscary +snook92 +socketubs +Sorin Sbarnea +Srinivas Nyayapati +Stavros Korokithakis +Stefan Scherfke +Stefano Rivera +Stephan Erb +Stephen Rosen +stepshal +Steve (Gadget) Barnes +Steve Barnes +Steve Dower +Steve Kowalik +Steven Myint +Steven Silvester +stonebig +studioj +Stéphane Bidoul +Stéphane Bidoul (ACSONE) +Stéphane Klein +Sumana Harihareswara +Surbhi Sharma +Sviatoslav Sydorenko +Sviatoslav Sydorenko (Святослав Сидоренко) +Swat009 +Sylvain +Takayuki SHIMIZUKAWA +Taneli Hukkinen +tbeswick +Thiago +Thijs Triemstra +Thomas Fenzl +Thomas Grainger +Thomas Guettler +Thomas Johansson +Thomas Kluyver +Thomas Smith +Thomas VINCENT +Tim D. Smith +Tim Gates +Tim Harder +Tim Heap +tim smith +tinruufu +Tobias Hermann +Tom Forbes +Tom Freudenheim +Tom V +Tomas Hrnciar +Tomas Orsava +Tomer Chachamu +Tommi Enenkel | AnB +Tomáš Hrnčiar +Tony Beswick +Tony Narlock +Tony Zhaocheng Tan +TonyBeswick +toonarmycaptain +Toshio Kuratomi +toxinu +Travis Swicegood +Tushar Sadhwani +Tzu-ping Chung +Valentin Haenel +Victor Stinner +victorvpaulo +Vikram - Google +Viktor Szépe +Ville Skyttä +Vinay Sajip +Vincent Philippon +Vinicyus Macedo +Vipul Kumar +Vitaly Babiy +Vladimir Fokow +Vladimir Rutsky +W. Trevor King +Wil Tan +Wilfred Hughes +William Edwards +William ML Leslie +William T Olson +William Woodruff +Wilson Mo +wim glenn +Winson Luk +Wolfgang Maier +Wu Zhenyu +XAMES3 +Xavier Fernandez +Xianpeng Shen +xoviat +xtreak +YAMAMOTO Takashi +Yen Chi Hsuan +Yeray Diaz Diaz +Yoval P +Yu Jian +Yuan Jing Vincent Yan +Yusuke Hayashi +Zearin +Zhiping Deng +ziebam +Zvezdan Petkovic +Łukasz Langa +Роман Донченко +Семён Марьясин diff --git a/.venv/lib/python3.12/site-packages/pip-24.2.dist-info/INSTALLER b/.venv/lib/python3.12/site-packages/pip-24.2.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip-24.2.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/.venv/lib/python3.12/site-packages/pip-24.2.dist-info/LICENSE.txt b/.venv/lib/python3.12/site-packages/pip-24.2.dist-info/LICENSE.txt new file mode 100644 index 0000000..8e7b65e --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip-24.2.dist-info/LICENSE.txt @@ -0,0 +1,20 @@ +Copyright (c) 2008-present The pip developers (see AUTHORS.txt file) + +Permission is hereby granted, free of charge, to any person obtaining +a copy of this software and associated documentation files (the +"Software"), to deal in the Software without restriction, including +without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to +permit persons to whom the Software is furnished to do so, subject to +the following conditions: + +The above copyright notice and this permission notice shall be +included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND +NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE +LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION +OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION +WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. diff --git a/.venv/lib/python3.12/site-packages/pip-24.2.dist-info/METADATA b/.venv/lib/python3.12/site-packages/pip-24.2.dist-info/METADATA new file mode 100644 index 0000000..6141107 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip-24.2.dist-info/METADATA @@ -0,0 +1,89 @@ +Metadata-Version: 2.1 +Name: pip +Version: 24.2 +Summary: The PyPA recommended tool for installing Python packages. +Author-email: The pip developers +License: MIT +Project-URL: Homepage, https://pip.pypa.io/ +Project-URL: Documentation, https://pip.pypa.io +Project-URL: Source, https://github.com/pypa/pip +Project-URL: Changelog, https://pip.pypa.io/en/stable/news/ +Classifier: Development Status :: 5 - Production/Stable +Classifier: Intended Audience :: Developers +Classifier: License :: OSI Approved :: MIT License +Classifier: Topic :: Software Development :: Build Tools +Classifier: Programming Language :: Python +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3 :: Only +Classifier: Programming Language :: Python :: 3.8 +Classifier: Programming Language :: Python :: 3.9 +Classifier: Programming Language :: Python :: 3.10 +Classifier: Programming Language :: Python :: 3.11 +Classifier: Programming Language :: Python :: 3.12 +Classifier: Programming Language :: Python :: Implementation :: CPython +Classifier: Programming Language :: Python :: Implementation :: PyPy +Requires-Python: >=3.8 +Description-Content-Type: text/x-rst +License-File: LICENSE.txt +License-File: AUTHORS.txt + +pip - The Python Package Installer +================================== + +.. |pypi-version| image:: https://img.shields.io/pypi/v/pip.svg + :target: https://pypi.org/project/pip/ + :alt: PyPI + +.. |python-versions| image:: https://img.shields.io/pypi/pyversions/pip + :target: https://pypi.org/project/pip + :alt: PyPI - Python Version + +.. |docs-badge| image:: https://readthedocs.org/projects/pip/badge/?version=latest + :target: https://pip.pypa.io/en/latest + :alt: Documentation + +|pypi-version| |python-versions| |docs-badge| + +pip is the `package installer`_ for Python. You can use pip to install packages from the `Python Package Index`_ and other indexes. + +Please take a look at our documentation for how to install and use pip: + +* `Installation`_ +* `Usage`_ + +We release updates regularly, with a new version every 3 months. Find more details in our documentation: + +* `Release notes`_ +* `Release process`_ + +If you find bugs, need help, or want to talk to the developers, please use our mailing lists or chat rooms: + +* `Issue tracking`_ +* `Discourse channel`_ +* `User IRC`_ + +If you want to get involved head over to GitHub to get the source code, look at our development documentation and feel free to jump on the developer mailing lists and chat rooms: + +* `GitHub page`_ +* `Development documentation`_ +* `Development IRC`_ + +Code of Conduct +--------------- + +Everyone interacting in the pip project's codebases, issue trackers, chat +rooms, and mailing lists is expected to follow the `PSF Code of Conduct`_. + +.. _package installer: https://packaging.python.org/guides/tool-recommendations/ +.. _Python Package Index: https://pypi.org +.. _Installation: https://pip.pypa.io/en/stable/installation/ +.. _Usage: https://pip.pypa.io/en/stable/ +.. _Release notes: https://pip.pypa.io/en/stable/news.html +.. _Release process: https://pip.pypa.io/en/latest/development/release-process/ +.. _GitHub page: https://github.com/pypa/pip +.. _Development documentation: https://pip.pypa.io/en/latest/development +.. _Issue tracking: https://github.com/pypa/pip/issues +.. _Discourse channel: https://discuss.python.org/c/packaging +.. _User IRC: https://kiwiirc.com/nextclient/#ircs://irc.libera.chat:+6697/pypa +.. _Development IRC: https://kiwiirc.com/nextclient/#ircs://irc.libera.chat:+6697/pypa-dev +.. _PSF Code of Conduct: https://github.com/pypa/.github/blob/main/CODE_OF_CONDUCT.md diff --git a/.venv/lib/python3.12/site-packages/pip-24.2.dist-info/RECORD b/.venv/lib/python3.12/site-packages/pip-24.2.dist-info/RECORD new file mode 100644 index 0000000..9c347b8 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip-24.2.dist-info/RECORD @@ -0,0 +1,853 @@ +../../../bin/pip,sha256=DYaCRkqNIIndPxYPZQWkWCV23HZan2xAXzE3ZHvRuU4,248 +../../../bin/pip3,sha256=DYaCRkqNIIndPxYPZQWkWCV23HZan2xAXzE3ZHvRuU4,248 +../../../bin/pip3.12,sha256=DYaCRkqNIIndPxYPZQWkWCV23HZan2xAXzE3ZHvRuU4,248 +pip-24.2.dist-info/AUTHORS.txt,sha256=KDa8Pd3GDeKSogF6yFW0l9A9eMneLDOFrcIDqkL8G8s,10868 +pip-24.2.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +pip-24.2.dist-info/LICENSE.txt,sha256=Y0MApmnUmurmWxLGxIySTFGkzfPR_whtw0VtyLyqIQQ,1093 +pip-24.2.dist-info/METADATA,sha256=PhzCxQxIhsnZ871cPUe3Hew9PhhpgflLbfqU3WizZqM,3624 +pip-24.2.dist-info/RECORD,, +pip-24.2.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip-24.2.dist-info/WHEEL,sha256=Wyh-_nZ0DJYolHNn1_hMa4lM7uDedD_RGVwbmTjyItk,91 +pip-24.2.dist-info/entry_points.txt,sha256=eeIjuzfnfR2PrhbjnbzFU6MnSS70kZLxwaHHq6M-bD0,87 +pip-24.2.dist-info/top_level.txt,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +pip/__init__.py,sha256=EQxEGXUQIu-9fNJxVEK74ufx_fTk_HpYV9lAbw-WWbs,355 +pip/__main__.py,sha256=WzbhHXTbSE6gBY19mNN9m4s5o_365LOvTYSgqgbdBhE,854 +pip/__pip-runner__.py,sha256=cPPWuJ6NK_k-GzfvlejLFgwzmYUROmpAR6QC3Q-vkXQ,1450 +pip/__pycache__/__init__.cpython-312.pyc,, +pip/__pycache__/__main__.cpython-312.pyc,, +pip/__pycache__/__pip-runner__.cpython-312.pyc,, +pip/_internal/__init__.py,sha256=MfcoOluDZ8QMCFYal04IqOJ9q6m2V7a0aOsnI-WOxUo,513 +pip/_internal/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/__pycache__/build_env.cpython-312.pyc,, +pip/_internal/__pycache__/cache.cpython-312.pyc,, +pip/_internal/__pycache__/configuration.cpython-312.pyc,, +pip/_internal/__pycache__/exceptions.cpython-312.pyc,, +pip/_internal/__pycache__/main.cpython-312.pyc,, +pip/_internal/__pycache__/pyproject.cpython-312.pyc,, +pip/_internal/__pycache__/self_outdated_check.cpython-312.pyc,, +pip/_internal/__pycache__/wheel_builder.cpython-312.pyc,, +pip/_internal/build_env.py,sha256=QiusW8QEaj387y0hdRqVbuelHSHGYcT7WzVckbmMhR0,10420 +pip/_internal/cache.py,sha256=Jb698p5PNigRtpW5o26wQNkkUv4MnQ94mc471wL63A0,10369 +pip/_internal/cli/__init__.py,sha256=FkHBgpxxb-_gd6r1FjnNhfMOzAUYyXoXKJ6abijfcFU,132 +pip/_internal/cli/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/cli/__pycache__/autocompletion.cpython-312.pyc,, +pip/_internal/cli/__pycache__/base_command.cpython-312.pyc,, +pip/_internal/cli/__pycache__/cmdoptions.cpython-312.pyc,, +pip/_internal/cli/__pycache__/command_context.cpython-312.pyc,, +pip/_internal/cli/__pycache__/index_command.cpython-312.pyc,, +pip/_internal/cli/__pycache__/main.cpython-312.pyc,, +pip/_internal/cli/__pycache__/main_parser.cpython-312.pyc,, +pip/_internal/cli/__pycache__/parser.cpython-312.pyc,, +pip/_internal/cli/__pycache__/progress_bars.cpython-312.pyc,, +pip/_internal/cli/__pycache__/req_command.cpython-312.pyc,, +pip/_internal/cli/__pycache__/spinners.cpython-312.pyc,, +pip/_internal/cli/__pycache__/status_codes.cpython-312.pyc,, +pip/_internal/cli/autocompletion.py,sha256=Lli3Mr6aDNu7ZkJJFFvwD2-hFxNI6Avz8OwMyS5TVrs,6865 +pip/_internal/cli/base_command.py,sha256=F8nUcSM-Y-MQljJUe724-yxmc5viFXHyM_zH70NmIh4,8289 +pip/_internal/cli/cmdoptions.py,sha256=mDqBr0d0hoztbRJs-PWtcKpqNAc7khU6ZpoesZKocT8,30110 +pip/_internal/cli/command_context.py,sha256=RHgIPwtObh5KhMrd3YZTkl8zbVG-6Okml7YbFX4Ehg0,774 +pip/_internal/cli/index_command.py,sha256=YIJ84cfYcbDBACnB8eoDgqjYJU6GpiWP2Rh7Ij-Xyak,5633 +pip/_internal/cli/main.py,sha256=BDZef-bWe9g9Jpr4OVs4dDf-845HJsKw835T7AqEnAc,2817 +pip/_internal/cli/main_parser.py,sha256=laDpsuBDl6kyfywp9eMMA9s84jfH2TJJn-vmL0GG90w,4338 +pip/_internal/cli/parser.py,sha256=QAkY6s8N-AD7w5D2PQm2Y8C2MIJSv7iuAeNjOMvDBUA,10811 +pip/_internal/cli/progress_bars.py,sha256=0FAf7eN67KnIv_gZQhTWSnKXXUzQko1ftGXEoLe5Yec,2713 +pip/_internal/cli/req_command.py,sha256=DqeFhmUMs6o6Ev8qawAcOoYNdAZsfyKS0MZI5jsJYwQ,12250 +pip/_internal/cli/spinners.py,sha256=hIJ83GerdFgFCdobIA23Jggetegl_uC4Sp586nzFbPE,5118 +pip/_internal/cli/status_codes.py,sha256=sEFHUaUJbqv8iArL3HAtcztWZmGOFX01hTesSytDEh0,116 +pip/_internal/commands/__init__.py,sha256=5oRO9O3dM2vGuh0bFw4HOVletryrz5HHMmmPWwJrH9U,3882 +pip/_internal/commands/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/commands/__pycache__/cache.cpython-312.pyc,, +pip/_internal/commands/__pycache__/check.cpython-312.pyc,, +pip/_internal/commands/__pycache__/completion.cpython-312.pyc,, +pip/_internal/commands/__pycache__/configuration.cpython-312.pyc,, +pip/_internal/commands/__pycache__/debug.cpython-312.pyc,, +pip/_internal/commands/__pycache__/download.cpython-312.pyc,, +pip/_internal/commands/__pycache__/freeze.cpython-312.pyc,, +pip/_internal/commands/__pycache__/hash.cpython-312.pyc,, +pip/_internal/commands/__pycache__/help.cpython-312.pyc,, +pip/_internal/commands/__pycache__/index.cpython-312.pyc,, +pip/_internal/commands/__pycache__/inspect.cpython-312.pyc,, +pip/_internal/commands/__pycache__/install.cpython-312.pyc,, +pip/_internal/commands/__pycache__/list.cpython-312.pyc,, +pip/_internal/commands/__pycache__/search.cpython-312.pyc,, +pip/_internal/commands/__pycache__/show.cpython-312.pyc,, +pip/_internal/commands/__pycache__/uninstall.cpython-312.pyc,, +pip/_internal/commands/__pycache__/wheel.cpython-312.pyc,, +pip/_internal/commands/cache.py,sha256=xg76_ZFEBC6zoQ3gXLRfMZJft4z2a0RwH4GEFZC6nnU,7944 +pip/_internal/commands/check.py,sha256=Hr_4eiMd9cgVDgEvjtIdw915NmL7ROIWW8enkr8slPQ,2268 +pip/_internal/commands/completion.py,sha256=HT4lD0bgsflHq2IDgYfiEdp7IGGtE7s6MgI3xn0VQEw,4287 +pip/_internal/commands/configuration.py,sha256=n98enwp6y0b5G6fiRQjaZo43FlJKYve_daMhN-4BRNc,9766 +pip/_internal/commands/debug.py,sha256=DNDRgE9YsKrbYzU0s3VKi8rHtKF4X13CJ_br_8PUXO0,6797 +pip/_internal/commands/download.py,sha256=0qB0nys6ZEPsog451lDsjL5Bx7Z97t-B80oFZKhpzKM,5273 +pip/_internal/commands/freeze.py,sha256=2Vt72BYTSm9rzue6d8dNzt8idxWK4Db6Hd-anq7GQ80,3203 +pip/_internal/commands/hash.py,sha256=EVVOuvGtoPEdFi8SNnmdqlCQrhCxV-kJsdwtdcCnXGQ,1703 +pip/_internal/commands/help.py,sha256=gcc6QDkcgHMOuAn5UxaZwAStsRBrnGSn_yxjS57JIoM,1132 +pip/_internal/commands/index.py,sha256=RAXxmJwFhVb5S1BYzb5ifX3sn9Na8v2CCVYwSMP8pao,4731 +pip/_internal/commands/inspect.py,sha256=PGrY9TRTRCM3y5Ml8Bdk8DEOXquWRfscr4DRo1LOTPc,3189 +pip/_internal/commands/install.py,sha256=iqesiLIZc6Op9uihMQFYRhAA2DQRZUxbM4z1BwXoFls,29428 +pip/_internal/commands/list.py,sha256=RgaIV4kN-eMSpgUAXc-6bjnURzl0v3cRE11xr54O9Cg,12771 +pip/_internal/commands/search.py,sha256=hSGtIHg26LRe468Ly7oZ6gfd9KbTxBRZAAtJc9Um6S4,5628 +pip/_internal/commands/show.py,sha256=IG9L5uo8w6UA4tI_IlmaxLCoNKPa5JNJCljj3NWs0OE,7507 +pip/_internal/commands/uninstall.py,sha256=7pOR7enK76gimyxQbzxcG1OsyLXL3DvX939xmM8Fvtg,3892 +pip/_internal/commands/wheel.py,sha256=eJRhr_qoNNxWAkkdJCNiQM7CXd4E1_YyQhsqJnBPGGg,6414 +pip/_internal/configuration.py,sha256=XkAiBS0hpzsM-LF0Qu5hvPWO_Bs67-oQKRYFBuMbESs,14006 +pip/_internal/distributions/__init__.py,sha256=Hq6kt6gXBgjNit5hTTWLAzeCNOKoB-N0pGYSqehrli8,858 +pip/_internal/distributions/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/distributions/__pycache__/base.cpython-312.pyc,, +pip/_internal/distributions/__pycache__/installed.cpython-312.pyc,, +pip/_internal/distributions/__pycache__/sdist.cpython-312.pyc,, +pip/_internal/distributions/__pycache__/wheel.cpython-312.pyc,, +pip/_internal/distributions/base.py,sha256=QeB9qvKXDIjLdPBDE5fMgpfGqMMCr-govnuoQnGuiF8,1783 +pip/_internal/distributions/installed.py,sha256=QinHFbWAQ8oE0pbD8MFZWkwlnfU1QYTccA1vnhrlYOU,842 +pip/_internal/distributions/sdist.py,sha256=PlcP4a6-R6c98XnOM-b6Lkb3rsvh9iG4ok8shaanrzs,6751 +pip/_internal/distributions/wheel.py,sha256=THBYfnv7VVt8mYhMYUtH13S1E7FDwtDyDfmUcl8ai0E,1317 +pip/_internal/exceptions.py,sha256=6qcW3QgmFVlRxlZvDSLUhSzKJ7_Tedo-lyqWA6NfdAU,25371 +pip/_internal/index/__init__.py,sha256=vpt-JeTZefh8a-FC22ZeBSXFVbuBcXSGiILhQZJaNpQ,30 +pip/_internal/index/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/index/__pycache__/collector.cpython-312.pyc,, +pip/_internal/index/__pycache__/package_finder.cpython-312.pyc,, +pip/_internal/index/__pycache__/sources.cpython-312.pyc,, +pip/_internal/index/collector.py,sha256=RdPO0JLAlmyBWPAWYHPyRoGjz3GNAeTngCNkbGey_mE,16265 +pip/_internal/index/package_finder.py,sha256=yRC4xsyudwKnNoU6IXvNoyqYo5ScT7lB6Wa-z2eh7cs,37666 +pip/_internal/index/sources.py,sha256=dJegiR9f86kslaAHcv9-R5L_XBf5Rzm_FkyPteDuPxI,8688 +pip/_internal/locations/__init__.py,sha256=UaAxeZ_f93FyouuFf4p7SXYF-4WstXuEvd3LbmPCAno,14925 +pip/_internal/locations/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/locations/__pycache__/_distutils.cpython-312.pyc,, +pip/_internal/locations/__pycache__/_sysconfig.cpython-312.pyc,, +pip/_internal/locations/__pycache__/base.cpython-312.pyc,, +pip/_internal/locations/_distutils.py,sha256=H9ZHK_35rdDV1Qsmi4QeaBULjFT4Mbu6QuoVGkJ6QHI,6009 +pip/_internal/locations/_sysconfig.py,sha256=IGzds60qsFneRogC-oeBaY7bEh3lPt_v47kMJChQXsU,7724 +pip/_internal/locations/base.py,sha256=RQiPi1d4FVM2Bxk04dQhXZ2PqkeljEL2fZZ9SYqIQ78,2556 +pip/_internal/main.py,sha256=r-UnUe8HLo5XFJz8inTcOOTiu_sxNhgHb6VwlGUllOI,340 +pip/_internal/metadata/__init__.py,sha256=9pU3W3s-6HtjFuYhWcLTYVmSaziklPv7k2x8p7X1GmA,4339 +pip/_internal/metadata/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/metadata/__pycache__/_json.cpython-312.pyc,, +pip/_internal/metadata/__pycache__/base.cpython-312.pyc,, +pip/_internal/metadata/__pycache__/pkg_resources.cpython-312.pyc,, +pip/_internal/metadata/_json.py,sha256=P0cAJrH_mtmMZvlZ16ZXm_-izA4lpr5wy08laICuiaA,2644 +pip/_internal/metadata/base.py,sha256=ft0K5XNgI4ETqZnRv2-CtvgYiMOMAeGMAzxT-f6VLJA,25298 +pip/_internal/metadata/importlib/__init__.py,sha256=jUUidoxnHcfITHHaAWG1G2i5fdBYklv_uJcjo2x7VYE,135 +pip/_internal/metadata/importlib/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/metadata/importlib/__pycache__/_compat.cpython-312.pyc,, +pip/_internal/metadata/importlib/__pycache__/_dists.cpython-312.pyc,, +pip/_internal/metadata/importlib/__pycache__/_envs.cpython-312.pyc,, +pip/_internal/metadata/importlib/_compat.py,sha256=c6av8sP8BBjAZuFSJow1iWfygUXNM3xRTCn5nqw6B9M,2796 +pip/_internal/metadata/importlib/_dists.py,sha256=anh0mLI-FYRPUhAdipd0Va3YJJc6HelCKQ0bFhY10a0,8017 +pip/_internal/metadata/importlib/_envs.py,sha256=JHjNfnk9RsjrcQw8dLBqdfBglOKSepEe9aq03B4nRpU,7431 +pip/_internal/metadata/pkg_resources.py,sha256=U07ETAINSGeSRBfWUG93E4tZZbaW_f7PGzEqZN0hulc,10542 +pip/_internal/models/__init__.py,sha256=3DHUd_qxpPozfzouoqa9g9ts1Czr5qaHfFxbnxriepM,63 +pip/_internal/models/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/models/__pycache__/candidate.cpython-312.pyc,, +pip/_internal/models/__pycache__/direct_url.cpython-312.pyc,, +pip/_internal/models/__pycache__/format_control.cpython-312.pyc,, +pip/_internal/models/__pycache__/index.cpython-312.pyc,, +pip/_internal/models/__pycache__/installation_report.cpython-312.pyc,, +pip/_internal/models/__pycache__/link.cpython-312.pyc,, +pip/_internal/models/__pycache__/scheme.cpython-312.pyc,, +pip/_internal/models/__pycache__/search_scope.cpython-312.pyc,, +pip/_internal/models/__pycache__/selection_prefs.cpython-312.pyc,, +pip/_internal/models/__pycache__/target_python.cpython-312.pyc,, +pip/_internal/models/__pycache__/wheel.cpython-312.pyc,, +pip/_internal/models/candidate.py,sha256=zzgFRuw_kWPjKpGw7LC0ZUMD2CQ2EberUIYs8izjdCA,753 +pip/_internal/models/direct_url.py,sha256=uBtY2HHd3TO9cKQJWh0ThvE5FRr-MWRYChRU4IG9HZE,6578 +pip/_internal/models/format_control.py,sha256=wtsQqSK9HaUiNxQEuB-C62eVimw6G4_VQFxV9-_KDBE,2486 +pip/_internal/models/index.py,sha256=tYnL8oxGi4aSNWur0mG8DAP7rC6yuha_MwJO8xw0crI,1030 +pip/_internal/models/installation_report.py,sha256=zRVZoaz-2vsrezj_H3hLOhMZCK9c7TbzWgC-jOalD00,2818 +pip/_internal/models/link.py,sha256=jHax9O-9zlSzEwjBCDkx0OXjKXwBDwOuPwn-PsR8dCs,21034 +pip/_internal/models/scheme.py,sha256=PakmHJM3e8OOWSZFtfz1Az7f1meONJnkGuQxFlt3wBE,575 +pip/_internal/models/search_scope.py,sha256=67NEnsYY84784S-MM7ekQuo9KXLH-7MzFntXjapvAo0,4531 +pip/_internal/models/selection_prefs.py,sha256=qaFfDs3ciqoXPg6xx45N1jPLqccLJw4N0s4P0PyHTQ8,2015 +pip/_internal/models/target_python.py,sha256=2XaH2rZ5ZF-K5wcJbEMGEl7SqrTToDDNkrtQ2v_v_-Q,4271 +pip/_internal/models/wheel.py,sha256=Odc1NVWL5N-i6A3vFa50BfNvCRlGvGa4som60FQM198,3601 +pip/_internal/network/__init__.py,sha256=jf6Tt5nV_7zkARBrKojIXItgejvoegVJVKUbhAa5Ioc,50 +pip/_internal/network/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/network/__pycache__/auth.cpython-312.pyc,, +pip/_internal/network/__pycache__/cache.cpython-312.pyc,, +pip/_internal/network/__pycache__/download.cpython-312.pyc,, +pip/_internal/network/__pycache__/lazy_wheel.cpython-312.pyc,, +pip/_internal/network/__pycache__/session.cpython-312.pyc,, +pip/_internal/network/__pycache__/utils.cpython-312.pyc,, +pip/_internal/network/__pycache__/xmlrpc.cpython-312.pyc,, +pip/_internal/network/auth.py,sha256=D4gASjUrqoDFlSt6gQ767KAAjv6PUyJU0puDlhXNVRE,20809 +pip/_internal/network/cache.py,sha256=48A971qCzKNFvkb57uGEk7-0xaqPS0HWj2711QNTxkU,3935 +pip/_internal/network/download.py,sha256=FLOP29dPYECBiAi7eEjvAbNkyzaKNqbyjOT2m8HPW8U,6048 +pip/_internal/network/lazy_wheel.py,sha256=2PXVduYZPCPZkkQFe1J1GbfHJWeCU--FXonGyIfw9eU,7638 +pip/_internal/network/session.py,sha256=XmanBKjVwPFmh1iJ58q6TDh9xabH37gREuQJ_feuZGA,18741 +pip/_internal/network/utils.py,sha256=Inaxel-NxBu4PQWkjyErdnfewsFCcgHph7dzR1-FboY,4088 +pip/_internal/network/xmlrpc.py,sha256=sAxzOacJ-N1NXGPvap9jC3zuYWSnnv3GXtgR2-E2APA,1838 +pip/_internal/operations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_internal/operations/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/operations/__pycache__/check.cpython-312.pyc,, +pip/_internal/operations/__pycache__/freeze.cpython-312.pyc,, +pip/_internal/operations/__pycache__/prepare.cpython-312.pyc,, +pip/_internal/operations/build/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_internal/operations/build/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/operations/build/__pycache__/build_tracker.cpython-312.pyc,, +pip/_internal/operations/build/__pycache__/metadata.cpython-312.pyc,, +pip/_internal/operations/build/__pycache__/metadata_editable.cpython-312.pyc,, +pip/_internal/operations/build/__pycache__/metadata_legacy.cpython-312.pyc,, +pip/_internal/operations/build/__pycache__/wheel.cpython-312.pyc,, +pip/_internal/operations/build/__pycache__/wheel_editable.cpython-312.pyc,, +pip/_internal/operations/build/__pycache__/wheel_legacy.cpython-312.pyc,, +pip/_internal/operations/build/build_tracker.py,sha256=-ARW_TcjHCOX7D2NUOGntB4Fgc6b4aolsXkAK6BWL7w,4774 +pip/_internal/operations/build/metadata.py,sha256=9S0CUD8U3QqZeXp-Zyt8HxwU90lE4QrnYDgrqZDzBnc,1422 +pip/_internal/operations/build/metadata_editable.py,sha256=VLL7LvntKE8qxdhUdEJhcotFzUsOSI8NNS043xULKew,1474 +pip/_internal/operations/build/metadata_legacy.py,sha256=8i6i1QZX9m_lKPStEFsHKM0MT4a-CD408JOw99daLmo,2190 +pip/_internal/operations/build/wheel.py,sha256=sT12FBLAxDC6wyrDorh8kvcZ1jG5qInCRWzzP-UkJiQ,1075 +pip/_internal/operations/build/wheel_editable.py,sha256=yOtoH6zpAkoKYEUtr8FhzrYnkNHQaQBjWQ2HYae1MQg,1417 +pip/_internal/operations/build/wheel_legacy.py,sha256=K-6kNhmj-1xDF45ny1yheMerF0ui4EoQCLzEoHh6-tc,3045 +pip/_internal/operations/check.py,sha256=L24vRL8VWbyywdoeAhM89WCd8zLTnjIbULlKelUgIec,5912 +pip/_internal/operations/freeze.py,sha256=V59yEyCSz_YhZuhH09-6aV_zvYBMrS_IxFFNqn2QzlA,9864 +pip/_internal/operations/install/__init__.py,sha256=mX7hyD2GNBO2mFGokDQ30r_GXv7Y_PLdtxcUv144e-s,51 +pip/_internal/operations/install/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/operations/install/__pycache__/editable_legacy.cpython-312.pyc,, +pip/_internal/operations/install/__pycache__/wheel.cpython-312.pyc,, +pip/_internal/operations/install/editable_legacy.py,sha256=PoEsNEPGbIZ2yQphPsmYTKLOCMs4gv5OcCdzW124NcA,1283 +pip/_internal/operations/install/wheel.py,sha256=X5Iz9yUg5LlK5VNQ9g2ikc6dcRu8EPi_SUi5iuEDRgo,27615 +pip/_internal/operations/prepare.py,sha256=joWJwPkuqGscQgVNImLK71e9hRapwKvRCM8HclysmvU,28118 +pip/_internal/pyproject.py,sha256=rw4fwlptDp1hZgYoplwbAGwWA32sWQkp7ysf8Ju6iXc,7287 +pip/_internal/req/__init__.py,sha256=HxBFtZy_BbCclLgr26waMtpzYdO5T3vxePvpGAXSt5s,2653 +pip/_internal/req/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/req/__pycache__/constructors.cpython-312.pyc,, +pip/_internal/req/__pycache__/req_file.cpython-312.pyc,, +pip/_internal/req/__pycache__/req_install.cpython-312.pyc,, +pip/_internal/req/__pycache__/req_set.cpython-312.pyc,, +pip/_internal/req/__pycache__/req_uninstall.cpython-312.pyc,, +pip/_internal/req/constructors.py,sha256=qXNZtUqhsXpHxkRaIQhp20_Kz6I88MDKM8SQR9fckIc,18424 +pip/_internal/req/req_file.py,sha256=hnC9Oz-trqGQpuDnCVWqwpJkAvtbCsk7-5k0EWVQhlQ,17687 +pip/_internal/req/req_install.py,sha256=yhT98NGDoAEk03jznTJnYCznzhiMEEA2ocgsUG_dcNU,35788 +pip/_internal/req/req_set.py,sha256=j3esG0s6SzoVReX9rWn4rpYNtyET_fwxbwJPRimvRxo,2858 +pip/_internal/req/req_uninstall.py,sha256=qzDIxJo-OETWqGais7tSMCDcWbATYABT-Tid3ityF0s,23853 +pip/_internal/resolution/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_internal/resolution/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/resolution/__pycache__/base.cpython-312.pyc,, +pip/_internal/resolution/base.py,sha256=qlmh325SBVfvG6Me9gc5Nsh5sdwHBwzHBq6aEXtKsLA,583 +pip/_internal/resolution/legacy/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_internal/resolution/legacy/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/resolution/legacy/__pycache__/resolver.cpython-312.pyc,, +pip/_internal/resolution/legacy/resolver.py,sha256=3HZiJBRd1FTN6jQpI4qRO8-TbLYeIbUTS6PFvXnXs2w,24068 +pip/_internal/resolution/resolvelib/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_internal/resolution/resolvelib/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/resolution/resolvelib/__pycache__/base.cpython-312.pyc,, +pip/_internal/resolution/resolvelib/__pycache__/candidates.cpython-312.pyc,, +pip/_internal/resolution/resolvelib/__pycache__/factory.cpython-312.pyc,, +pip/_internal/resolution/resolvelib/__pycache__/found_candidates.cpython-312.pyc,, +pip/_internal/resolution/resolvelib/__pycache__/provider.cpython-312.pyc,, +pip/_internal/resolution/resolvelib/__pycache__/reporter.cpython-312.pyc,, +pip/_internal/resolution/resolvelib/__pycache__/requirements.cpython-312.pyc,, +pip/_internal/resolution/resolvelib/__pycache__/resolver.cpython-312.pyc,, +pip/_internal/resolution/resolvelib/base.py,sha256=DCf669FsqyQY5uqXeePDHQY1e4QO-pBzWH8O0s9-K94,5023 +pip/_internal/resolution/resolvelib/candidates.py,sha256=07CBc85ya3J19XqdvUsLQwtVIxiTYq9km9hbTRh0jb0,19823 +pip/_internal/resolution/resolvelib/factory.py,sha256=mTTq_nG1F9Eq3VnlYPH6Ap-mydcS-mxC5y5L-CLLp80,32459 +pip/_internal/resolution/resolvelib/found_candidates.py,sha256=9hrTyQqFvl9I7Tji79F1AxHv39Qh1rkJ_7deSHSMfQc,6383 +pip/_internal/resolution/resolvelib/provider.py,sha256=bcsFnYvlmtB80cwVdW1fIwgol8ZNr1f1VHyRTkz47SM,9935 +pip/_internal/resolution/resolvelib/reporter.py,sha256=00JtoXEkTlw0-rl_sl54d71avwOsJHt9GGHcrj5Sza0,3168 +pip/_internal/resolution/resolvelib/requirements.py,sha256=7JG4Z72e5Yk4vU0S5ulGvbqTy4FMQGYhY5zQhX9zTtY,8065 +pip/_internal/resolution/resolvelib/resolver.py,sha256=nLJOsVMEVi2gQUVJoUFKMZAeu2f7GRMjGMvNSWyz0Bc,12592 +pip/_internal/self_outdated_check.py,sha256=pkjQixuWyQ1vrVxZAaYD6SSHgXuFUnHZybXEWTkh0S0,8145 +pip/_internal/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_internal/utils/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/utils/__pycache__/_jaraco_text.cpython-312.pyc,, +pip/_internal/utils/__pycache__/_log.cpython-312.pyc,, +pip/_internal/utils/__pycache__/appdirs.cpython-312.pyc,, +pip/_internal/utils/__pycache__/compat.cpython-312.pyc,, +pip/_internal/utils/__pycache__/compatibility_tags.cpython-312.pyc,, +pip/_internal/utils/__pycache__/datetime.cpython-312.pyc,, +pip/_internal/utils/__pycache__/deprecation.cpython-312.pyc,, +pip/_internal/utils/__pycache__/direct_url_helpers.cpython-312.pyc,, +pip/_internal/utils/__pycache__/egg_link.cpython-312.pyc,, +pip/_internal/utils/__pycache__/encoding.cpython-312.pyc,, +pip/_internal/utils/__pycache__/entrypoints.cpython-312.pyc,, +pip/_internal/utils/__pycache__/filesystem.cpython-312.pyc,, +pip/_internal/utils/__pycache__/filetypes.cpython-312.pyc,, +pip/_internal/utils/__pycache__/glibc.cpython-312.pyc,, +pip/_internal/utils/__pycache__/hashes.cpython-312.pyc,, +pip/_internal/utils/__pycache__/logging.cpython-312.pyc,, +pip/_internal/utils/__pycache__/misc.cpython-312.pyc,, +pip/_internal/utils/__pycache__/packaging.cpython-312.pyc,, +pip/_internal/utils/__pycache__/retry.cpython-312.pyc,, +pip/_internal/utils/__pycache__/setuptools_build.cpython-312.pyc,, +pip/_internal/utils/__pycache__/subprocess.cpython-312.pyc,, +pip/_internal/utils/__pycache__/temp_dir.cpython-312.pyc,, +pip/_internal/utils/__pycache__/unpacking.cpython-312.pyc,, +pip/_internal/utils/__pycache__/urls.cpython-312.pyc,, +pip/_internal/utils/__pycache__/virtualenv.cpython-312.pyc,, +pip/_internal/utils/__pycache__/wheel.cpython-312.pyc,, +pip/_internal/utils/_jaraco_text.py,sha256=M15uUPIh5NpP1tdUGBxRau6q1ZAEtI8-XyLEETscFfE,3350 +pip/_internal/utils/_log.py,sha256=-jHLOE_THaZz5BFcCnoSL9EYAtJ0nXem49s9of4jvKw,1015 +pip/_internal/utils/appdirs.py,sha256=swgcTKOm3daLeXTW6v5BUS2Ti2RvEnGRQYH_yDXklAo,1665 +pip/_internal/utils/compat.py,sha256=ckkFveBiYQjRWjkNsajt_oWPS57tJvE8XxoC4OIYgCY,2399 +pip/_internal/utils/compatibility_tags.py,sha256=ydin8QG8BHqYRsPY4OL6cmb44CbqXl1T0xxS97VhHkk,5377 +pip/_internal/utils/datetime.py,sha256=m21Y3wAtQc-ji6Veb6k_M5g6A0ZyFI4egchTdnwh-pQ,242 +pip/_internal/utils/deprecation.py,sha256=k7Qg_UBAaaTdyq82YVARA6D7RmcGTXGv7fnfcgigj4Q,3707 +pip/_internal/utils/direct_url_helpers.py,sha256=r2MRtkVDACv9AGqYODBUC9CjwgtsUU1s68hmgfCJMtA,3196 +pip/_internal/utils/egg_link.py,sha256=0FePZoUYKv4RGQ2t6x7w5Z427wbA_Uo3WZnAkrgsuqo,2463 +pip/_internal/utils/encoding.py,sha256=qqsXDtiwMIjXMEiIVSaOjwH5YmirCaK-dIzb6-XJsL0,1169 +pip/_internal/utils/entrypoints.py,sha256=YlhLTRl2oHBAuqhc-zmL7USS67TPWVHImjeAQHreZTQ,3064 +pip/_internal/utils/filesystem.py,sha256=ajvA-q4ocliW9kPp8Yquh-4vssXbu-UKbo5FV9V4X64,4950 +pip/_internal/utils/filetypes.py,sha256=i8XAQ0eFCog26Fw9yV0Yb1ygAqKYB1w9Cz9n0fj8gZU,716 +pip/_internal/utils/glibc.py,sha256=vUkWq_1pJuzcYNcGKLlQmABoUiisK8noYY1yc8Wq4w4,3734 +pip/_internal/utils/hashes.py,sha256=XGGLL0AG8-RhWnyz87xF6MFZ--BKadHU35D47eApCKI,4972 +pip/_internal/utils/logging.py,sha256=7BFKB1uFjdxD5crM-GtwA5T2qjbQ2LPD-gJDuJeDNTg,11606 +pip/_internal/utils/misc.py,sha256=HR_V97vNTHNzwq01JrnTZtsLLkWAOJ9_EeYfHJZSgDY,23745 +pip/_internal/utils/packaging.py,sha256=iI3LH43lVNR4hWBOqF6lFsZq4aycb2j0UcHlmDmcqUg,2109 +pip/_internal/utils/retry.py,sha256=mhFbykXjhTnZfgzeuy-vl9c8nECnYn_CMtwNJX2tYzQ,1392 +pip/_internal/utils/setuptools_build.py,sha256=ouXpud-jeS8xPyTPsXJ-m34NPvK5os45otAzdSV_IJE,4435 +pip/_internal/utils/subprocess.py,sha256=EsvqSRiSMHF98T8Txmu6NLU3U--MpTTQjtNgKP0P--M,8988 +pip/_internal/utils/temp_dir.py,sha256=5qOXe8M4JeY6vaFQM867d5zkp1bSwMZ-KT5jymmP0Zg,9310 +pip/_internal/utils/unpacking.py,sha256=eyDkSsk4nW8ZfiSjNzJduCznpHyaGHVv3ak_LMGsiEM,11951 +pip/_internal/utils/urls.py,sha256=qceSOZb5lbNDrHNsv7_S4L4Ytszja5NwPKUMnZHbYnM,1599 +pip/_internal/utils/virtualenv.py,sha256=S6f7csYorRpiD6cvn3jISZYc3I8PJC43H5iMFpRAEDU,3456 +pip/_internal/utils/wheel.py,sha256=b442jkydFHjXzDy6cMR7MpzWBJ1Q82hR5F33cmcHV3g,4494 +pip/_internal/vcs/__init__.py,sha256=UAqvzpbi0VbZo3Ub6skEeZAw-ooIZR-zX_WpCbxyCoU,596 +pip/_internal/vcs/__pycache__/__init__.cpython-312.pyc,, +pip/_internal/vcs/__pycache__/bazaar.cpython-312.pyc,, +pip/_internal/vcs/__pycache__/git.cpython-312.pyc,, +pip/_internal/vcs/__pycache__/mercurial.cpython-312.pyc,, +pip/_internal/vcs/__pycache__/subversion.cpython-312.pyc,, +pip/_internal/vcs/__pycache__/versioncontrol.cpython-312.pyc,, +pip/_internal/vcs/bazaar.py,sha256=EKStcQaKpNu0NK4p5Q10Oc4xb3DUxFw024XrJy40bFQ,3528 +pip/_internal/vcs/git.py,sha256=3tpc9LQA_J4IVW5r5NvWaaSeDzcmJOrSFZN0J8vIKfU,18177 +pip/_internal/vcs/mercurial.py,sha256=oULOhzJ2Uie-06d1omkL-_Gc6meGaUkyogvqG9ZCyPs,5249 +pip/_internal/vcs/subversion.py,sha256=ddTugHBqHzV3ebKlU5QXHPN4gUqlyXbOx8q8NgXKvs8,11735 +pip/_internal/vcs/versioncontrol.py,sha256=cvf_-hnTAjQLXJ3d17FMNhQfcO1AcKWUF10tfrYyP-c,22440 +pip/_internal/wheel_builder.py,sha256=DL3A8LKeRj_ACp11WS5wSgASgPFqeyAeXJKdXfmaWXU,11799 +pip/_vendor/__init__.py,sha256=JYuAXvClhInxIrA2FTp5p-uuWVL7WV6-vEpTs46-Qh4,4873 +pip/_vendor/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/__pycache__/typing_extensions.cpython-312.pyc,, +pip/_vendor/cachecontrol/__init__.py,sha256=GiYoagwPEiJ_xR_lbwWGaoCiPtF_rz4isjfjdDAgHU4,676 +pip/_vendor/cachecontrol/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/cachecontrol/__pycache__/_cmd.cpython-312.pyc,, +pip/_vendor/cachecontrol/__pycache__/adapter.cpython-312.pyc,, +pip/_vendor/cachecontrol/__pycache__/cache.cpython-312.pyc,, +pip/_vendor/cachecontrol/__pycache__/controller.cpython-312.pyc,, +pip/_vendor/cachecontrol/__pycache__/filewrapper.cpython-312.pyc,, +pip/_vendor/cachecontrol/__pycache__/heuristics.cpython-312.pyc,, +pip/_vendor/cachecontrol/__pycache__/serialize.cpython-312.pyc,, +pip/_vendor/cachecontrol/__pycache__/wrapper.cpython-312.pyc,, +pip/_vendor/cachecontrol/_cmd.py,sha256=iist2EpzJvDVIhMAxXq8iFnTBsiZAd6iplxfmNboNyk,1737 +pip/_vendor/cachecontrol/adapter.py,sha256=fByO_Pd_EOemjWbuocvBWdN85xT0q_TBm2lxS6vD4fk,6355 +pip/_vendor/cachecontrol/cache.py,sha256=OTQj72tUf8C1uEgczdl3Gc8vkldSzsTITKtDGKMx4z8,1952 +pip/_vendor/cachecontrol/caches/__init__.py,sha256=dtrrroK5BnADR1GWjCZ19aZ0tFsMfvFBtLQQU1sp_ag,303 +pip/_vendor/cachecontrol/caches/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/cachecontrol/caches/__pycache__/file_cache.cpython-312.pyc,, +pip/_vendor/cachecontrol/caches/__pycache__/redis_cache.cpython-312.pyc,, +pip/_vendor/cachecontrol/caches/file_cache.py,sha256=9AlmmTJc6cslb6k5z_6q0sGPHVrMj8zv-uWy-simmfE,5406 +pip/_vendor/cachecontrol/caches/redis_cache.py,sha256=9rmqwtYu_ljVkW6_oLqbC7EaX_a8YT_yLuna-eS0dgo,1386 +pip/_vendor/cachecontrol/controller.py,sha256=o-ejGJlBmpKK8QQLyTPJj0t7siU8XVHXuV8MCybCxQ8,18575 +pip/_vendor/cachecontrol/filewrapper.py,sha256=STttGmIPBvZzt2b51dUOwoWX5crcMCpKZOisM3f5BNc,4292 +pip/_vendor/cachecontrol/heuristics.py,sha256=IYe4QmHERWsMvtxNrp920WeaIsaTTyqLB14DSheSbtY,4834 +pip/_vendor/cachecontrol/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/cachecontrol/serialize.py,sha256=HQd2IllQ05HzPkVLMXTF2uX5mjEQjDBkxCqUJUODpZk,5163 +pip/_vendor/cachecontrol/wrapper.py,sha256=hsGc7g8QGQTT-4f8tgz3AM5qwScg6FO0BSdLSRdEvpU,1417 +pip/_vendor/certifi/__init__.py,sha256=LHXz7E80YJYBzCBv6ZyidQ5-ciYSkSebpY2E5OM0l7o,94 +pip/_vendor/certifi/__main__.py,sha256=1k3Cr95vCxxGRGDljrW3wMdpZdL3Nhf0u1n-k2qdsCY,255 +pip/_vendor/certifi/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/certifi/__pycache__/__main__.cpython-312.pyc,, +pip/_vendor/certifi/__pycache__/core.cpython-312.pyc,, +pip/_vendor/certifi/cacert.pem,sha256=SIupYGAr8HzGP073rsEIaS_sQYIPwzKKjj894DgUmu4,291528 +pip/_vendor/certifi/core.py,sha256=2SRT5rIcQChFDbe37BQa-kULxAgJ8qN6l1jfqTp4HIs,4486 +pip/_vendor/certifi/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/distlib/__init__.py,sha256=hJKF7FHoqbmGckncDuEINWo_OYkDNiHODtYXSMcvjcc,625 +pip/_vendor/distlib/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/distlib/__pycache__/compat.cpython-312.pyc,, +pip/_vendor/distlib/__pycache__/database.cpython-312.pyc,, +pip/_vendor/distlib/__pycache__/index.cpython-312.pyc,, +pip/_vendor/distlib/__pycache__/locators.cpython-312.pyc,, +pip/_vendor/distlib/__pycache__/manifest.cpython-312.pyc,, +pip/_vendor/distlib/__pycache__/markers.cpython-312.pyc,, +pip/_vendor/distlib/__pycache__/metadata.cpython-312.pyc,, +pip/_vendor/distlib/__pycache__/resources.cpython-312.pyc,, +pip/_vendor/distlib/__pycache__/scripts.cpython-312.pyc,, +pip/_vendor/distlib/__pycache__/util.cpython-312.pyc,, +pip/_vendor/distlib/__pycache__/version.cpython-312.pyc,, +pip/_vendor/distlib/__pycache__/wheel.cpython-312.pyc,, +pip/_vendor/distlib/compat.py,sha256=Un-uIBvy02w-D267OG4VEhuddqWgKj9nNkxVltAb75w,41487 +pip/_vendor/distlib/database.py,sha256=0V9Qvs0Vrxa2F_-hLWitIyVyRifJ0pCxyOI-kEOBwsA,51965 +pip/_vendor/distlib/index.py,sha256=lTbw268rRhj8dw1sib3VZ_0EhSGgoJO3FKJzSFMOaeA,20797 +pip/_vendor/distlib/locators.py,sha256=o1r_M86_bRLafSpetmyfX8KRtFu-_Q58abvQrnOSnbA,51767 +pip/_vendor/distlib/manifest.py,sha256=3qfmAmVwxRqU1o23AlfXrQGZzh6g_GGzTAP_Hb9C5zQ,14168 +pip/_vendor/distlib/markers.py,sha256=n3DfOh1yvZ_8EW7atMyoYeZFXjYla0Nz0itQlojCd0A,5268 +pip/_vendor/distlib/metadata.py,sha256=pB9WZ9mBfmQxc9OVIldLS5CjOoQRvKAvUwwQyKwKQtQ,39693 +pip/_vendor/distlib/resources.py,sha256=LwbPksc0A1JMbi6XnuPdMBUn83X7BPuFNWqPGEKI698,10820 +pip/_vendor/distlib/scripts.py,sha256=8_gP9J7_tlNRicnWmPX4ZiDlP5wTwJKDeeg-8_qXUZU,18780 +pip/_vendor/distlib/t32.exe,sha256=a0GV5kCoWsMutvliiCKmIgV98eRZ33wXoS-XrqvJQVs,97792 +pip/_vendor/distlib/t64-arm.exe,sha256=68TAa32V504xVBnufojh0PcenpR3U4wAqTqf-MZqbPw,182784 +pip/_vendor/distlib/t64.exe,sha256=gaYY8hy4fbkHYTTnA4i26ct8IQZzkBG2pRdy0iyuBrc,108032 +pip/_vendor/distlib/util.py,sha256=XSznxEi_i3T20UJuaVc0qXHz5ksGUCW1khYlBprN_QE,67530 +pip/_vendor/distlib/version.py,sha256=9pXkduchve_aN7JG6iL9VTYV_kqNSGoc2Dwl8JuySnQ,23747 +pip/_vendor/distlib/w32.exe,sha256=R4csx3-OGM9kL4aPIzQKRo5TfmRSHZo6QWyLhDhNBks,91648 +pip/_vendor/distlib/w64-arm.exe,sha256=xdyYhKj0WDcVUOCb05blQYvzdYIKMbmJn2SZvzkcey4,168448 +pip/_vendor/distlib/w64.exe,sha256=ejGf-rojoBfXseGLpya6bFTFPWRG21X5KvU8J5iU-K0,101888 +pip/_vendor/distlib/wheel.py,sha256=FVQCve8u-L0QYk5-YTZc7s4WmNQdvjRWTK08KXzZVX4,43958 +pip/_vendor/distro/__init__.py,sha256=2fHjF-SfgPvjyNZ1iHh_wjqWdR_Yo5ODHwZC0jLBPhc,981 +pip/_vendor/distro/__main__.py,sha256=bu9d3TifoKciZFcqRBuygV3GSuThnVD_m2IK4cz96Vs,64 +pip/_vendor/distro/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/distro/__pycache__/__main__.cpython-312.pyc,, +pip/_vendor/distro/__pycache__/distro.cpython-312.pyc,, +pip/_vendor/distro/distro.py,sha256=XqbefacAhDT4zr_trnbA15eY8vdK4GTghgmvUGrEM_4,49430 +pip/_vendor/distro/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/idna/__init__.py,sha256=KJQN1eQBr8iIK5SKrJ47lXvxG0BJ7Lm38W4zT0v_8lk,849 +pip/_vendor/idna/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/idna/__pycache__/codec.cpython-312.pyc,, +pip/_vendor/idna/__pycache__/compat.cpython-312.pyc,, +pip/_vendor/idna/__pycache__/core.cpython-312.pyc,, +pip/_vendor/idna/__pycache__/idnadata.cpython-312.pyc,, +pip/_vendor/idna/__pycache__/intranges.cpython-312.pyc,, +pip/_vendor/idna/__pycache__/package_data.cpython-312.pyc,, +pip/_vendor/idna/__pycache__/uts46data.cpython-312.pyc,, +pip/_vendor/idna/codec.py,sha256=PS6m-XmdST7Wj7J7ulRMakPDt5EBJyYrT3CPtjh-7t4,3426 +pip/_vendor/idna/compat.py,sha256=0_sOEUMT4CVw9doD3vyRhX80X19PwqFoUBs7gWsFME4,321 +pip/_vendor/idna/core.py,sha256=lyhpoe2vulEaB_65xhXmoKgO-xUqFDvcwxu5hpNNO4E,12663 +pip/_vendor/idna/idnadata.py,sha256=dqRwytzkjIHMBa2R1lYvHDwACenZPt8eGVu1Y8UBE-E,78320 +pip/_vendor/idna/intranges.py,sha256=YBr4fRYuWH7kTKS2tXlFjM24ZF1Pdvcir-aywniInqg,1881 +pip/_vendor/idna/package_data.py,sha256=Tkt0KnIeyIlnHddOaz9WSkkislNgokJAuE-p5GorMqo,21 +pip/_vendor/idna/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/idna/uts46data.py,sha256=1KuksWqLuccPXm2uyRVkhfiFLNIhM_H2m4azCcnOqEU,206503 +pip/_vendor/msgpack/__init__.py,sha256=gsMP7JTECZNUSjvOyIbdhNOkpB9Z8BcGwabVGY2UcdQ,1077 +pip/_vendor/msgpack/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/msgpack/__pycache__/exceptions.cpython-312.pyc,, +pip/_vendor/msgpack/__pycache__/ext.cpython-312.pyc,, +pip/_vendor/msgpack/__pycache__/fallback.cpython-312.pyc,, +pip/_vendor/msgpack/exceptions.py,sha256=dCTWei8dpkrMsQDcjQk74ATl9HsIBH0ybt8zOPNqMYc,1081 +pip/_vendor/msgpack/ext.py,sha256=fKp00BqDLjUtZnPd70Llr138zk8JsCuSpJkkZ5S4dt8,5629 +pip/_vendor/msgpack/fallback.py,sha256=wdUWJkWX2gzfRW9BBCTOuIE1Wvrf5PtBtR8ZtY7G_EE,33175 +pip/_vendor/packaging/__init__.py,sha256=dtw2bNmWCQ9WnMoK3bk_elL1svSlikXtLpZhCFIB9SE,496 +pip/_vendor/packaging/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/packaging/__pycache__/_elffile.cpython-312.pyc,, +pip/_vendor/packaging/__pycache__/_manylinux.cpython-312.pyc,, +pip/_vendor/packaging/__pycache__/_musllinux.cpython-312.pyc,, +pip/_vendor/packaging/__pycache__/_parser.cpython-312.pyc,, +pip/_vendor/packaging/__pycache__/_structures.cpython-312.pyc,, +pip/_vendor/packaging/__pycache__/_tokenizer.cpython-312.pyc,, +pip/_vendor/packaging/__pycache__/markers.cpython-312.pyc,, +pip/_vendor/packaging/__pycache__/metadata.cpython-312.pyc,, +pip/_vendor/packaging/__pycache__/requirements.cpython-312.pyc,, +pip/_vendor/packaging/__pycache__/specifiers.cpython-312.pyc,, +pip/_vendor/packaging/__pycache__/tags.cpython-312.pyc,, +pip/_vendor/packaging/__pycache__/utils.cpython-312.pyc,, +pip/_vendor/packaging/__pycache__/version.cpython-312.pyc,, +pip/_vendor/packaging/_elffile.py,sha256=_LcJW4YNKywYsl4169B2ukKRqwxjxst_8H0FRVQKlz8,3282 +pip/_vendor/packaging/_manylinux.py,sha256=Xo4V0PZz8sbuVCbTni0t1CR0AHeir_7ib4lTmV8scD4,9586 +pip/_vendor/packaging/_musllinux.py,sha256=p9ZqNYiOItGee8KcZFeHF_YcdhVwGHdK6r-8lgixvGQ,2694 +pip/_vendor/packaging/_parser.py,sha256=s_TvTvDNK0NrM2QB3VKThdWFM4Nc0P6JnkObkl3MjpM,10236 +pip/_vendor/packaging/_structures.py,sha256=q3eVNmbWJGG_S0Dit_S3Ao8qQqz_5PYTXFAKBZe5yr4,1431 +pip/_vendor/packaging/_tokenizer.py,sha256=J6v5H7Jzvb-g81xp_2QACKwO7LxHQA6ikryMU7zXwN8,5273 +pip/_vendor/packaging/markers.py,sha256=dWKSqn5Sp-jDmOG-W3GfLHKjwhf1IsznbT71VlBoB5M,10671 +pip/_vendor/packaging/metadata.py,sha256=KINuSkJ12u-SyoKNTy_pHNGAfMUtxNvZ53qA1zAKcKI,32349 +pip/_vendor/packaging/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/packaging/requirements.py,sha256=gYyRSAdbrIyKDY66ugIDUQjRMvxkH2ALioTmX3tnL6o,2947 +pip/_vendor/packaging/specifiers.py,sha256=HfGgfNJRvrzC759gnnoojHyiWs_DYmcw5PEh5jHH-YE,39738 +pip/_vendor/packaging/tags.py,sha256=y8EbheOu9WS7s-MebaXMcHMF-jzsA_C1Lz5XRTiSy4w,18883 +pip/_vendor/packaging/utils.py,sha256=NAdYUwnlAOpkat_RthavX8a07YuVxgGL_vwrx73GSDM,5287 +pip/_vendor/packaging/version.py,sha256=wE4sSVlF-d1H6HFC1vszEe35CwTig_fh4HHIFg95hFE,16210 +pip/_vendor/pkg_resources/__init__.py,sha256=jrhDRbOubP74QuPXxd7U7Po42PH2l-LZ2XfcO7llpZ4,124463 +pip/_vendor/pkg_resources/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/platformdirs/__init__.py,sha256=FTA6LGNm40GwNZt3gG3uLAacWvf2E_2HTmH0rAALGR8,22285 +pip/_vendor/platformdirs/__main__.py,sha256=jBJ8zb7Mpx5ebcqF83xrpO94MaeCpNGHVf9cvDN2JLg,1505 +pip/_vendor/platformdirs/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/platformdirs/__pycache__/__main__.cpython-312.pyc,, +pip/_vendor/platformdirs/__pycache__/android.cpython-312.pyc,, +pip/_vendor/platformdirs/__pycache__/api.cpython-312.pyc,, +pip/_vendor/platformdirs/__pycache__/macos.cpython-312.pyc,, +pip/_vendor/platformdirs/__pycache__/unix.cpython-312.pyc,, +pip/_vendor/platformdirs/__pycache__/version.cpython-312.pyc,, +pip/_vendor/platformdirs/__pycache__/windows.cpython-312.pyc,, +pip/_vendor/platformdirs/android.py,sha256=xZXY9Jd46WOsxT2U6-5HsNtDZ-IQqxcEUrBLl3hYk4o,9016 +pip/_vendor/platformdirs/api.py,sha256=QBYdUac2eC521ek_y53uD1Dcq-lJX8IgSRVd4InC6uc,8996 +pip/_vendor/platformdirs/macos.py,sha256=wftsbsvq6nZ0WORXSiCrZNkRHz_WKuktl0a6mC7MFkI,5580 +pip/_vendor/platformdirs/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/platformdirs/unix.py,sha256=Cci9Wqt35dAMsg6HT9nRGHSBW5obb0pR3AE1JJnsCXg,10643 +pip/_vendor/platformdirs/version.py,sha256=r7F76tZRjgQKzrpx_I0_ZMQOMU-PS7eGnHD7zEK3KB0,411 +pip/_vendor/platformdirs/windows.py,sha256=IFpiohUBwxPtCzlyKwNtxyW4Jk8haa6W8o59mfrDXVo,10125 +pip/_vendor/pygments/__init__.py,sha256=7N1oiaWulw_nCsTY4EEixYLz15pWY5u4uPAFFi-ielU,2983 +pip/_vendor/pygments/__main__.py,sha256=isIhBxLg65nLlXukG4VkMuPfNdd7gFzTZ_R_z3Q8diY,353 +pip/_vendor/pygments/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/__main__.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/cmdline.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/console.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/filter.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/formatter.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/lexer.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/modeline.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/plugin.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/regexopt.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/scanner.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/sphinxext.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/style.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/token.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/unistring.cpython-312.pyc,, +pip/_vendor/pygments/__pycache__/util.cpython-312.pyc,, +pip/_vendor/pygments/cmdline.py,sha256=LIVzmAunlk9sRJJp54O4KRy9GDIN4Wu13v9p9QzfGPM,23656 +pip/_vendor/pygments/console.py,sha256=yhP9UsLAVmWKVQf2446JJewkA7AiXeeTf4Ieg3Oi2fU,1718 +pip/_vendor/pygments/filter.py,sha256=_ADNPCskD8_GmodHi6_LoVgPU3Zh336aBCT5cOeTMs0,1910 +pip/_vendor/pygments/filters/__init__.py,sha256=RdedK2KWKXlKwR7cvkfr3NUj9YiZQgMgilRMFUg2jPA,40392 +pip/_vendor/pygments/filters/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/pygments/formatter.py,sha256=jDWBTndlBH2Z5IYZFVDnP0qn1CaTQjTWt7iAGtCnJEg,4390 +pip/_vendor/pygments/formatters/__init__.py,sha256=8No-NUs8rBTSSBJIv4hSEQt2M0cFB4hwAT0snVc2QGE,5385 +pip/_vendor/pygments/formatters/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/pygments/formatters/__pycache__/_mapping.cpython-312.pyc,, +pip/_vendor/pygments/formatters/__pycache__/bbcode.cpython-312.pyc,, +pip/_vendor/pygments/formatters/__pycache__/groff.cpython-312.pyc,, +pip/_vendor/pygments/formatters/__pycache__/html.cpython-312.pyc,, +pip/_vendor/pygments/formatters/__pycache__/img.cpython-312.pyc,, +pip/_vendor/pygments/formatters/__pycache__/irc.cpython-312.pyc,, +pip/_vendor/pygments/formatters/__pycache__/latex.cpython-312.pyc,, +pip/_vendor/pygments/formatters/__pycache__/other.cpython-312.pyc,, +pip/_vendor/pygments/formatters/__pycache__/pangomarkup.cpython-312.pyc,, +pip/_vendor/pygments/formatters/__pycache__/rtf.cpython-312.pyc,, +pip/_vendor/pygments/formatters/__pycache__/svg.cpython-312.pyc,, +pip/_vendor/pygments/formatters/__pycache__/terminal.cpython-312.pyc,, +pip/_vendor/pygments/formatters/__pycache__/terminal256.cpython-312.pyc,, +pip/_vendor/pygments/formatters/_mapping.py,sha256=1Cw37FuQlNacnxRKmtlPX4nyLoX9_ttko5ZwscNUZZ4,4176 +pip/_vendor/pygments/formatters/bbcode.py,sha256=3JQLI45tcrQ_kRUMjuab6C7Hb0XUsbVWqqbSn9cMjkI,3320 +pip/_vendor/pygments/formatters/groff.py,sha256=M39k0PaSSZRnxWjqBSVPkF0mu1-Vr7bm6RsFvs-CNN4,5106 +pip/_vendor/pygments/formatters/html.py,sha256=SE2jc3YCqbMS3rZW9EAmDlAUhdVxJ52gA4dileEvCGU,35669 +pip/_vendor/pygments/formatters/img.py,sha256=MwA4xWPLOwh6j7Yc6oHzjuqSPt0M1fh5r-5BTIIUfsU,23287 +pip/_vendor/pygments/formatters/irc.py,sha256=dp1Z0l_ObJ5NFh9MhqLGg5ptG5hgJqedT2Vkutt9v0M,4981 +pip/_vendor/pygments/formatters/latex.py,sha256=XMmhOCqUKDBQtG5mGJNAFYxApqaC5puo5cMmPfK3944,19306 +pip/_vendor/pygments/formatters/other.py,sha256=56PMJOliin-rAUdnRM0i1wsV1GdUPd_dvQq0_UPfF9c,5034 +pip/_vendor/pygments/formatters/pangomarkup.py,sha256=y16U00aVYYEFpeCfGXlYBSMacG425CbfoG8oKbKegIg,2218 +pip/_vendor/pygments/formatters/rtf.py,sha256=ZT90dmcKyJboIB0mArhL7IhE467GXRN0G7QAUgG03To,11957 +pip/_vendor/pygments/formatters/svg.py,sha256=KKsiophPupHuxm0So-MsbQEWOT54IAiSF7hZPmxtKXE,7174 +pip/_vendor/pygments/formatters/terminal.py,sha256=AojNG4MlKq2L6IsC_VnXHu4AbHCBn9Otog6u45XvxeI,4674 +pip/_vendor/pygments/formatters/terminal256.py,sha256=kGkNUVo3FpwjytIDS0if79EuUoroAprcWt3igrcIqT0,11753 +pip/_vendor/pygments/lexer.py,sha256=TYHDt___gNW4axTl2zvPZff-VQi8fPaIh5OKRcVSjUM,35349 +pip/_vendor/pygments/lexers/__init__.py,sha256=pIlxyQJuu_syh9lE080cq8ceVbEVcKp0osAFU5fawJU,12115 +pip/_vendor/pygments/lexers/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/pygments/lexers/__pycache__/_mapping.cpython-312.pyc,, +pip/_vendor/pygments/lexers/__pycache__/python.cpython-312.pyc,, +pip/_vendor/pygments/lexers/_mapping.py,sha256=61-h3zr103m01OS5BUq_AfUiL9YI06Ves9ipQ7k4vr4,76097 +pip/_vendor/pygments/lexers/python.py,sha256=2J_YJrPTr_A6fJY_qKiKv0GpgPwHMrlMSeo59qN3fe4,53687 +pip/_vendor/pygments/modeline.py,sha256=gtRYZBS-CKOCDXHhGZqApboHBaZwGH8gznN3O6nuxj4,1005 +pip/_vendor/pygments/plugin.py,sha256=ioeJ3QeoJ-UQhZpY9JL7vbxsTVuwwM7BCu-Jb8nN0AU,1891 +pip/_vendor/pygments/regexopt.py,sha256=Hky4EB13rIXEHQUNkwmCrYqtIlnXDehNR3MztafZ43w,3072 +pip/_vendor/pygments/scanner.py,sha256=NDy3ofK_fHRFK4hIDvxpamG871aewqcsIb6sgTi7Fhk,3092 +pip/_vendor/pygments/sphinxext.py,sha256=iOptJBcqOGPwMEJ2p70PvwpZPIGdvdZ8dxvq6kzxDgA,7981 +pip/_vendor/pygments/style.py,sha256=rSCZWFpg1_DwFMXDU0nEVmAcBHpuQGf9RxvOPPQvKLQ,6420 +pip/_vendor/pygments/styles/__init__.py,sha256=qUk6_1z5KmT8EdJFZYgESmG6P_HJF_2vVrDD7HSCGYY,2042 +pip/_vendor/pygments/styles/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/pygments/styles/__pycache__/_mapping.cpython-312.pyc,, +pip/_vendor/pygments/styles/_mapping.py,sha256=6lovFUE29tz6EsV3XYY4hgozJ7q1JL7cfO3UOlgnS8w,3312 +pip/_vendor/pygments/token.py,sha256=qZwT7LSPy5YBY3JgDjut642CCy7JdQzAfmqD9NmT5j0,6226 +pip/_vendor/pygments/unistring.py,sha256=p5c1i-HhoIhWemy9CUsaN9o39oomYHNxXll0Xfw6tEA,63208 +pip/_vendor/pygments/util.py,sha256=2tj2nS1X9_OpcuSjf8dOET2bDVZhs8cEKd_uT6-Fgg8,10031 +pip/_vendor/pyproject_hooks/__init__.py,sha256=kCehmy0UaBa9oVMD7ZIZrnswfnP3LXZ5lvnNJAL5JBM,491 +pip/_vendor/pyproject_hooks/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/pyproject_hooks/__pycache__/_compat.cpython-312.pyc,, +pip/_vendor/pyproject_hooks/__pycache__/_impl.cpython-312.pyc,, +pip/_vendor/pyproject_hooks/_compat.py,sha256=by6evrYnqkisiM-MQcvOKs5bgDMzlOSgZqRHNqf04zE,138 +pip/_vendor/pyproject_hooks/_impl.py,sha256=61GJxzQip0IInhuO69ZI5GbNQ82XEDUB_1Gg5_KtUoc,11920 +pip/_vendor/pyproject_hooks/_in_process/__init__.py,sha256=9gQATptbFkelkIy0OfWFEACzqxXJMQDWCH9rBOAZVwQ,546 +pip/_vendor/pyproject_hooks/_in_process/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/pyproject_hooks/_in_process/__pycache__/_in_process.cpython-312.pyc,, +pip/_vendor/pyproject_hooks/_in_process/_in_process.py,sha256=m2b34c917IW5o-Q_6TYIHlsK9lSUlNiyrITTUH_zwew,10927 +pip/_vendor/requests/__init__.py,sha256=HlB_HzhrzGtfD_aaYUwUh1zWXLZ75_YCLyit75d0Vz8,5057 +pip/_vendor/requests/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/__version__.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/_internal_utils.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/adapters.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/api.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/auth.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/certs.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/compat.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/cookies.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/exceptions.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/help.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/hooks.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/models.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/packages.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/sessions.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/status_codes.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/structures.cpython-312.pyc,, +pip/_vendor/requests/__pycache__/utils.cpython-312.pyc,, +pip/_vendor/requests/__version__.py,sha256=FVfglgZmNQnmYPXpOohDU58F5EUb_-VnSTaAesS187g,435 +pip/_vendor/requests/_internal_utils.py,sha256=nMQymr4hs32TqVo5AbCrmcJEhvPUh7xXlluyqwslLiQ,1495 +pip/_vendor/requests/adapters.py,sha256=J7VeVxKBvawbtlX2DERVo05J9BXTcWYLMHNd1Baa-bk,27607 +pip/_vendor/requests/api.py,sha256=_Zb9Oa7tzVIizTKwFrPjDEY9ejtm_OnSRERnADxGsQs,6449 +pip/_vendor/requests/auth.py,sha256=kF75tqnLctZ9Mf_hm9TZIj4cQWnN5uxRz8oWsx5wmR0,10186 +pip/_vendor/requests/certs.py,sha256=PVPooB0jP5hkZEULSCwC074532UFbR2Ptgu0I5zwmCs,575 +pip/_vendor/requests/compat.py,sha256=Mo9f9xZpefod8Zm-n9_StJcVTmwSukXR2p3IQyyVXvU,1485 +pip/_vendor/requests/cookies.py,sha256=bNi-iqEj4NPZ00-ob-rHvzkvObzN3lEpgw3g6paS3Xw,18590 +pip/_vendor/requests/exceptions.py,sha256=D1wqzYWne1mS2rU43tP9CeN1G7QAy7eqL9o1god6Ejw,4272 +pip/_vendor/requests/help.py,sha256=hRKaf9u0G7fdwrqMHtF3oG16RKktRf6KiwtSq2Fo1_0,3813 +pip/_vendor/requests/hooks.py,sha256=CiuysiHA39V5UfcCBXFIx83IrDpuwfN9RcTUgv28ftQ,733 +pip/_vendor/requests/models.py,sha256=x4K4CmH-lC0l2Kb-iPfMN4dRXxHEcbOaEWBL_i09AwI,35483 +pip/_vendor/requests/packages.py,sha256=_ZQDCJTJ8SP3kVWunSqBsRZNPzj2c1WFVqbdr08pz3U,1057 +pip/_vendor/requests/sessions.py,sha256=ykTI8UWGSltOfH07HKollH7kTBGw4WhiBVaQGmckTw4,30495 +pip/_vendor/requests/status_codes.py,sha256=iJUAeA25baTdw-6PfD0eF4qhpINDJRJI-yaMqxs4LEI,4322 +pip/_vendor/requests/structures.py,sha256=-IbmhVz06S-5aPSZuUthZ6-6D9XOjRuTXHOabY041XM,2912 +pip/_vendor/requests/utils.py,sha256=L79vnFbzJ3SFLKtJwpoWe41Tozi3RlZv94pY1TFIyow,33631 +pip/_vendor/resolvelib/__init__.py,sha256=h509TdEcpb5-44JonaU3ex2TM15GVBLjM9CNCPwnTTs,537 +pip/_vendor/resolvelib/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/resolvelib/__pycache__/providers.cpython-312.pyc,, +pip/_vendor/resolvelib/__pycache__/reporters.cpython-312.pyc,, +pip/_vendor/resolvelib/__pycache__/resolvers.cpython-312.pyc,, +pip/_vendor/resolvelib/__pycache__/structs.cpython-312.pyc,, +pip/_vendor/resolvelib/compat/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/resolvelib/compat/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/resolvelib/compat/__pycache__/collections_abc.cpython-312.pyc,, +pip/_vendor/resolvelib/compat/collections_abc.py,sha256=uy8xUZ-NDEw916tugUXm8HgwCGiMO0f-RcdnpkfXfOs,156 +pip/_vendor/resolvelib/providers.py,sha256=fuuvVrCetu5gsxPB43ERyjfO8aReS3rFQHpDgiItbs4,5871 +pip/_vendor/resolvelib/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/resolvelib/reporters.py,sha256=TSbRmWzTc26w0ggsV1bxVpeWDB8QNIre6twYl7GIZBE,1601 +pip/_vendor/resolvelib/resolvers.py,sha256=G8rsLZSq64g5VmIq-lB7UcIJ1gjAxIQJmTF4REZleQ0,20511 +pip/_vendor/resolvelib/structs.py,sha256=0_1_XO8z_CLhegP3Vpf9VJ3zJcfLm0NOHRM-i0Ykz3o,4963 +pip/_vendor/rich/__init__.py,sha256=dRxjIL-SbFVY0q3IjSMrfgBTHrm1LZDgLOygVBwiYZc,6090 +pip/_vendor/rich/__main__.py,sha256=eO7Cq8JnrgG8zVoeImiAs92q3hXNMIfp0w5lMsO7Q2Y,8477 +pip/_vendor/rich/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/__main__.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_cell_widths.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_emoji_codes.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_emoji_replace.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_export_format.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_extension.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_fileno.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_inspect.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_log_render.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_loop.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_null_file.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_palettes.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_pick.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_ratio.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_spinners.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_stack.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_timer.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_win32_console.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_windows.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_windows_renderer.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/_wrap.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/abc.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/align.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/ansi.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/bar.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/box.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/cells.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/color.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/color_triplet.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/columns.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/console.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/constrain.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/containers.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/control.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/default_styles.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/diagnose.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/emoji.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/errors.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/file_proxy.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/filesize.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/highlighter.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/json.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/jupyter.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/layout.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/live.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/live_render.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/logging.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/markup.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/measure.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/padding.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/pager.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/palette.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/panel.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/pretty.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/progress.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/progress_bar.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/prompt.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/protocol.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/region.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/repr.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/rule.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/scope.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/screen.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/segment.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/spinner.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/status.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/style.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/styled.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/syntax.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/table.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/terminal_theme.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/text.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/theme.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/themes.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/traceback.cpython-312.pyc,, +pip/_vendor/rich/__pycache__/tree.cpython-312.pyc,, +pip/_vendor/rich/_cell_widths.py,sha256=fbmeyetEdHjzE_Vx2l1uK7tnPOhMs2X1lJfO3vsKDpA,10209 +pip/_vendor/rich/_emoji_codes.py,sha256=hu1VL9nbVdppJrVoijVshRlcRRe_v3dju3Mmd2sKZdY,140235 +pip/_vendor/rich/_emoji_replace.py,sha256=n-kcetsEUx2ZUmhQrfeMNc-teeGhpuSQ5F8VPBsyvDo,1064 +pip/_vendor/rich/_export_format.py,sha256=RI08pSrm5tBSzPMvnbTqbD9WIalaOoN5d4M1RTmLq1Y,2128 +pip/_vendor/rich/_extension.py,sha256=Xt47QacCKwYruzjDi-gOBq724JReDj9Cm9xUi5fr-34,265 +pip/_vendor/rich/_fileno.py,sha256=HWZxP5C2ajMbHryvAQZseflVfQoGzsKOHzKGsLD8ynQ,799 +pip/_vendor/rich/_inspect.py,sha256=oZJGw31e64dwXSCmrDnvZbwVb1ZKhWfU8wI3VWohjJk,9695 +pip/_vendor/rich/_log_render.py,sha256=1ByI0PA1ZpxZY3CGJOK54hjlq4X-Bz_boIjIqCd8Kns,3225 +pip/_vendor/rich/_loop.py,sha256=hV_6CLdoPm0va22Wpw4zKqM0RYsz3TZxXj0PoS-9eDQ,1236 +pip/_vendor/rich/_null_file.py,sha256=tGSXk_v-IZmbj1GAzHit8A3kYIQMiCpVsCFfsC-_KJ4,1387 +pip/_vendor/rich/_palettes.py,sha256=cdev1JQKZ0JvlguV9ipHgznTdnvlIzUFDBb0It2PzjI,7063 +pip/_vendor/rich/_pick.py,sha256=evDt8QN4lF5CiwrUIXlOJCntitBCOsI3ZLPEIAVRLJU,423 +pip/_vendor/rich/_ratio.py,sha256=Zt58apszI6hAAcXPpgdWKpu3c31UBWebOeR4mbyptvU,5471 +pip/_vendor/rich/_spinners.py,sha256=U2r1_g_1zSjsjiUdAESc2iAMc3i4ri_S8PYP6kQ5z1I,19919 +pip/_vendor/rich/_stack.py,sha256=-C8OK7rxn3sIUdVwxZBBpeHhIzX0eI-VM3MemYfaXm0,351 +pip/_vendor/rich/_timer.py,sha256=zelxbT6oPFZnNrwWPpc1ktUeAT-Vc4fuFcRZLQGLtMI,417 +pip/_vendor/rich/_win32_console.py,sha256=P0vxI2fcndym1UU1S37XAzQzQnkyY7YqAKmxm24_gug,22820 +pip/_vendor/rich/_windows.py,sha256=aBwaD_S56SbgopIvayVmpk0Y28uwY2C5Bab1wl3Bp-I,1925 +pip/_vendor/rich/_windows_renderer.py,sha256=t74ZL3xuDCP3nmTp9pH1L5LiI2cakJuQRQleHCJerlk,2783 +pip/_vendor/rich/_wrap.py,sha256=FlSsom5EX0LVkA3KWy34yHnCfLtqX-ZIepXKh-70rpc,3404 +pip/_vendor/rich/abc.py,sha256=ON-E-ZqSSheZ88VrKX2M3PXpFbGEUUZPMa_Af0l-4f0,890 +pip/_vendor/rich/align.py,sha256=sCUkisXkQfoq-IQPyBELfJ8l7LihZJX3HbH8K7Cie-M,10368 +pip/_vendor/rich/ansi.py,sha256=iD6532QYqnBm6hADulKjrV8l8kFJ-9fEVooHJHH3hMg,6906 +pip/_vendor/rich/bar.py,sha256=ldbVHOzKJOnflVNuv1xS7g6dLX2E3wMnXkdPbpzJTcs,3263 +pip/_vendor/rich/box.py,sha256=nr5fYIUghB_iUCEq6y0Z3LlCT8gFPDrzN9u2kn7tJl4,10831 +pip/_vendor/rich/cells.py,sha256=aMmGK4BjXhgE6_JF1ZEGmW3O7mKkE8g84vUnj4Et4To,4780 +pip/_vendor/rich/color.py,sha256=bCRATVdRe5IClJ6Hl62de2PKQ_U4i2MZ4ugjUEg7Tao,18223 +pip/_vendor/rich/color_triplet.py,sha256=3lhQkdJbvWPoLDO-AnYImAWmJvV5dlgYNCVZ97ORaN4,1054 +pip/_vendor/rich/columns.py,sha256=HUX0KcMm9dsKNi11fTbiM_h2iDtl8ySCaVcxlalEzq8,7131 +pip/_vendor/rich/console.py,sha256=deFZIubq2M9A2MCsKFAsFQlWDvcOMsGuUA07QkOaHIw,99173 +pip/_vendor/rich/constrain.py,sha256=1VIPuC8AgtKWrcncQrjBdYqA3JVWysu6jZo1rrh7c7Q,1288 +pip/_vendor/rich/containers.py,sha256=c_56TxcedGYqDepHBMTuZdUIijitAQgnox-Qde0Z1qo,5502 +pip/_vendor/rich/control.py,sha256=DSkHTUQLorfSERAKE_oTAEUFefZnZp4bQb4q8rHbKws,6630 +pip/_vendor/rich/default_styles.py,sha256=-Fe318kMVI_IwciK5POpThcO0-9DYJ67TZAN6DlmlmM,8082 +pip/_vendor/rich/diagnose.py,sha256=an6uouwhKPAlvQhYpNNpGq9EJysfMIOvvCbO3oSoR24,972 +pip/_vendor/rich/emoji.py,sha256=omTF9asaAnsM4yLY94eR_9dgRRSm1lHUszX20D1yYCQ,2501 +pip/_vendor/rich/errors.py,sha256=5pP3Kc5d4QJ_c0KFsxrfyhjiPVe7J1zOqSFbFAzcV-Y,642 +pip/_vendor/rich/file_proxy.py,sha256=Tl9THMDZ-Pk5Wm8sI1gGg_U5DhusmxD-FZ0fUbcU0W0,1683 +pip/_vendor/rich/filesize.py,sha256=9fTLAPCAwHmBXdRv7KZU194jSgNrRb6Wx7RIoBgqeKY,2508 +pip/_vendor/rich/highlighter.py,sha256=6ZAjUcNhBRajBCo9umFUclyi2xL0-55JL7S0vYGUJu4,9585 +pip/_vendor/rich/json.py,sha256=vVEoKdawoJRjAFayPwXkMBPLy7RSTs-f44wSQDR2nJ0,5031 +pip/_vendor/rich/jupyter.py,sha256=QyoKoE_8IdCbrtiSHp9TsTSNyTHY0FO5whE7jOTd9UE,3252 +pip/_vendor/rich/layout.py,sha256=ajkSFAtEVv9EFTcFs-w4uZfft7nEXhNzL7ZVdgrT5rI,14004 +pip/_vendor/rich/live.py,sha256=vUcnJV2LMSK3sQNaILbm0-_B8BpAeiHfcQMAMLfpRe0,14271 +pip/_vendor/rich/live_render.py,sha256=zJtB471jGziBtEwxc54x12wEQtH4BuQr1SA8v9kU82w,3666 +pip/_vendor/rich/logging.py,sha256=uB-cB-3Q4bmXDLLpbOWkmFviw-Fde39zyMV6tKJ2WHQ,11903 +pip/_vendor/rich/markup.py,sha256=3euGKP5s41NCQwaSjTnJxus5iZMHjxpIM0W6fCxra38,8451 +pip/_vendor/rich/measure.py,sha256=HmrIJX8sWRTHbgh8MxEay_83VkqNW_70s8aKP5ZcYI8,5305 +pip/_vendor/rich/padding.py,sha256=kTFGsdGe0os7tXLnHKpwTI90CXEvrceeZGCshmJy5zw,4970 +pip/_vendor/rich/pager.py,sha256=SO_ETBFKbg3n_AgOzXm41Sv36YxXAyI3_R-KOY2_uSc,828 +pip/_vendor/rich/palette.py,sha256=lInvR1ODDT2f3UZMfL1grq7dY_pDdKHw4bdUgOGaM4Y,3396 +pip/_vendor/rich/panel.py,sha256=2Fd1V7e1kHxlPFIusoHY5T7-Cs0RpkrihgVG9ZVqJ4g,10705 +pip/_vendor/rich/pretty.py,sha256=5oIHP_CGWnHEnD0zMdW5qfGC5kHqIKn7zH_eC4crULE,35848 +pip/_vendor/rich/progress.py,sha256=P02xi7T2Ua3qq17o83bkshe4c0v_45cg8VyTj6US6Vg,59715 +pip/_vendor/rich/progress_bar.py,sha256=L4jw8E6Qb_x-jhOrLVhkuMaPmiAhFIl8jHQbWFrKuR8,8164 +pip/_vendor/rich/prompt.py,sha256=wdOn2X8XTJKnLnlw6PoMY7xG4iUPp3ezt4O5gqvpV-E,11304 +pip/_vendor/rich/protocol.py,sha256=5hHHDDNHckdk8iWH5zEbi-zuIVSF5hbU2jIo47R7lTE,1391 +pip/_vendor/rich/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/rich/region.py,sha256=rNT9xZrVZTYIXZC0NYn41CJQwYNbR-KecPOxTgQvB8Y,166 +pip/_vendor/rich/repr.py,sha256=5MZJZmONgC6kud-QW-_m1okXwL2aR6u6y-pUcUCJz28,4431 +pip/_vendor/rich/rule.py,sha256=0fNaS_aERa3UMRc3T5WMpN_sumtDxfaor2y3of1ftBk,4602 +pip/_vendor/rich/scope.py,sha256=TMUU8qo17thyqQCPqjDLYpg_UU1k5qVd-WwiJvnJVas,2843 +pip/_vendor/rich/screen.py,sha256=YoeReESUhx74grqb0mSSb9lghhysWmFHYhsbMVQjXO8,1591 +pip/_vendor/rich/segment.py,sha256=hU1ueeXqI6YeFa08K9DAjlF2QLxcJY9pwZx7RsXavlk,24246 +pip/_vendor/rich/spinner.py,sha256=15koCmF0DQeD8-k28Lpt6X_zJQUlzEhgo_6A6uy47lc,4339 +pip/_vendor/rich/status.py,sha256=kkPph3YeAZBo-X-4wPp8gTqZyU466NLwZBA4PZTTewo,4424 +pip/_vendor/rich/style.py,sha256=3hiocH_4N8vwRm3-8yFWzM7tSwjjEven69XqWasSQwM,27073 +pip/_vendor/rich/styled.py,sha256=eZNnzGrI4ki_54pgY3Oj0T-x3lxdXTYh4_ryDB24wBU,1258 +pip/_vendor/rich/syntax.py,sha256=TnZDuOD4DeHFbkaVEAji1gf8qgAlMU9Boe_GksMGCkk,35475 +pip/_vendor/rich/table.py,sha256=nGEvAZHF4dy1vT9h9Gj9O5qhSQO3ODAxJv0RY1vnIB8,39680 +pip/_vendor/rich/terminal_theme.py,sha256=1j5-ufJfnvlAo5Qsi_ACZiXDmwMXzqgmFByObT9-yJY,3370 +pip/_vendor/rich/text.py,sha256=5rQ3zvNrg5UZKNLecbh7fiw9v3HeFulNVtRY_CBDjjE,47312 +pip/_vendor/rich/theme.py,sha256=belFJogzA0W0HysQabKaHOc3RWH2ko3fQAJhoN-AFdo,3777 +pip/_vendor/rich/themes.py,sha256=0xgTLozfabebYtcJtDdC5QkX5IVUEaviqDUJJh4YVFk,102 +pip/_vendor/rich/traceback.py,sha256=CUpxYLjQWIb6vQQ6O72X0hvDV6caryGqU6UweHgOyCY,29601 +pip/_vendor/rich/tree.py,sha256=meAOUU6sYnoBEOX2ILrPLY9k5bWrWNQKkaiEFvHinXM,9167 +pip/_vendor/tomli/__init__.py,sha256=JhUwV66DB1g4Hvt1UQCVMdfCu-IgAV8FXmvDU9onxd4,396 +pip/_vendor/tomli/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/tomli/__pycache__/_parser.cpython-312.pyc,, +pip/_vendor/tomli/__pycache__/_re.cpython-312.pyc,, +pip/_vendor/tomli/__pycache__/_types.cpython-312.pyc,, +pip/_vendor/tomli/_parser.py,sha256=g9-ENaALS-B8dokYpCuzUFalWlog7T-SIYMjLZSWrtM,22633 +pip/_vendor/tomli/_re.py,sha256=dbjg5ChZT23Ka9z9DHOXfdtSpPwUfdgMXnj8NOoly-w,2943 +pip/_vendor/tomli/_types.py,sha256=-GTG2VUqkpxwMqzmVO4F7ybKddIbAnuAHXfmWQcTi3Q,254 +pip/_vendor/tomli/py.typed,sha256=8PjyZ1aVoQpRVvt71muvuq5qE-jTFZkK-GLHkhdebmc,26 +pip/_vendor/truststore/__init__.py,sha256=M-PhuLMIF7gxKXk7tpo2MD7dk6nqG1ae8GXWdNXbMdQ,403 +pip/_vendor/truststore/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/truststore/__pycache__/_api.cpython-312.pyc,, +pip/_vendor/truststore/__pycache__/_macos.cpython-312.pyc,, +pip/_vendor/truststore/__pycache__/_openssl.cpython-312.pyc,, +pip/_vendor/truststore/__pycache__/_ssl_constants.cpython-312.pyc,, +pip/_vendor/truststore/__pycache__/_windows.cpython-312.pyc,, +pip/_vendor/truststore/_api.py,sha256=B9JIHipzBIS8pMP_J50-o1DHVZsvKZQUXTB0HQQ_UPg,10461 +pip/_vendor/truststore/_macos.py,sha256=VJ24avz5aEGYAs_kWvnGjMJtuIP4xJcYa459UQOQC3M,17608 +pip/_vendor/truststore/_openssl.py,sha256=LLUZ7ZGaio-i5dpKKjKCSeSufmn6T8pi9lDcFnvSyq0,2324 +pip/_vendor/truststore/_ssl_constants.py,sha256=NUD4fVKdSD02ri7-db0tnO0VqLP9aHuzmStcW7tAl08,1130 +pip/_vendor/truststore/_windows.py,sha256=eldNViHNHeY5r3fiBoz_JFGD37atXB9S5yaRoPKEGAA,17891 +pip/_vendor/truststore/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/typing_extensions.py,sha256=78hFl0HpDY-ylHUVCnWdU5nTHxUP2-S-3wEZk6CQmLk,134499 +pip/_vendor/urllib3/__init__.py,sha256=iXLcYiJySn0GNbWOOZDDApgBL1JgP44EZ8i1760S8Mc,3333 +pip/_vendor/urllib3/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/urllib3/__pycache__/_collections.cpython-312.pyc,, +pip/_vendor/urllib3/__pycache__/_version.cpython-312.pyc,, +pip/_vendor/urllib3/__pycache__/connection.cpython-312.pyc,, +pip/_vendor/urllib3/__pycache__/connectionpool.cpython-312.pyc,, +pip/_vendor/urllib3/__pycache__/exceptions.cpython-312.pyc,, +pip/_vendor/urllib3/__pycache__/fields.cpython-312.pyc,, +pip/_vendor/urllib3/__pycache__/filepost.cpython-312.pyc,, +pip/_vendor/urllib3/__pycache__/poolmanager.cpython-312.pyc,, +pip/_vendor/urllib3/__pycache__/request.cpython-312.pyc,, +pip/_vendor/urllib3/__pycache__/response.cpython-312.pyc,, +pip/_vendor/urllib3/_collections.py,sha256=pyASJJhW7wdOpqJj9QJA8FyGRfr8E8uUUhqUvhF0728,11372 +pip/_vendor/urllib3/_version.py,sha256=cuJvnSrWxXGYgQ3-ZRoPMw8-qaN5tpw71jnH1t16dLA,64 +pip/_vendor/urllib3/connection.py,sha256=92k9td_y4PEiTIjNufCUa1NzMB3J3w0LEdyokYgXnW8,20300 +pip/_vendor/urllib3/connectionpool.py,sha256=Be6q65SR9laoikg-h_jmc_p8OWtEmwgq_Om_Xtig-2M,40285 +pip/_vendor/urllib3/contrib/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/urllib3/contrib/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/urllib3/contrib/__pycache__/_appengine_environ.cpython-312.pyc,, +pip/_vendor/urllib3/contrib/__pycache__/appengine.cpython-312.pyc,, +pip/_vendor/urllib3/contrib/__pycache__/ntlmpool.cpython-312.pyc,, +pip/_vendor/urllib3/contrib/__pycache__/pyopenssl.cpython-312.pyc,, +pip/_vendor/urllib3/contrib/__pycache__/securetransport.cpython-312.pyc,, +pip/_vendor/urllib3/contrib/__pycache__/socks.cpython-312.pyc,, +pip/_vendor/urllib3/contrib/_appengine_environ.py,sha256=bDbyOEhW2CKLJcQqAKAyrEHN-aklsyHFKq6vF8ZFsmk,957 +pip/_vendor/urllib3/contrib/_securetransport/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/urllib3/contrib/_securetransport/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/urllib3/contrib/_securetransport/__pycache__/bindings.cpython-312.pyc,, +pip/_vendor/urllib3/contrib/_securetransport/__pycache__/low_level.cpython-312.pyc,, +pip/_vendor/urllib3/contrib/_securetransport/bindings.py,sha256=4Xk64qIkPBt09A5q-RIFUuDhNc9mXilVapm7WnYnzRw,17632 +pip/_vendor/urllib3/contrib/_securetransport/low_level.py,sha256=B2JBB2_NRP02xK6DCa1Pa9IuxrPwxzDzZbixQkb7U9M,13922 +pip/_vendor/urllib3/contrib/appengine.py,sha256=VR68eAVE137lxTgjBDwCna5UiBZTOKa01Aj_-5BaCz4,11036 +pip/_vendor/urllib3/contrib/ntlmpool.py,sha256=NlfkW7WMdW8ziqudopjHoW299og1BTWi0IeIibquFwk,4528 +pip/_vendor/urllib3/contrib/pyopenssl.py,sha256=hDJh4MhyY_p-oKlFcYcQaVQRDv6GMmBGuW9yjxyeejM,17081 +pip/_vendor/urllib3/contrib/securetransport.py,sha256=Fef1IIUUFHqpevzXiDPbIGkDKchY2FVKeVeLGR1Qq3g,34446 +pip/_vendor/urllib3/contrib/socks.py,sha256=aRi9eWXo9ZEb95XUxef4Z21CFlnnjbEiAo9HOseoMt4,7097 +pip/_vendor/urllib3/exceptions.py,sha256=0Mnno3KHTNfXRfY7638NufOPkUb6mXOm-Lqj-4x2w8A,8217 +pip/_vendor/urllib3/fields.py,sha256=kvLDCg_JmH1lLjUUEY_FLS8UhY7hBvDPuVETbY8mdrM,8579 +pip/_vendor/urllib3/filepost.py,sha256=5b_qqgRHVlL7uLtdAYBzBh-GHmU5AfJVt_2N0XS3PeY,2440 +pip/_vendor/urllib3/packages/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/urllib3/packages/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/urllib3/packages/__pycache__/six.cpython-312.pyc,, +pip/_vendor/urllib3/packages/backports/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pip/_vendor/urllib3/packages/backports/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/urllib3/packages/backports/__pycache__/makefile.cpython-312.pyc,, +pip/_vendor/urllib3/packages/backports/__pycache__/weakref_finalize.cpython-312.pyc,, +pip/_vendor/urllib3/packages/backports/makefile.py,sha256=nbzt3i0agPVP07jqqgjhaYjMmuAi_W5E0EywZivVO8E,1417 +pip/_vendor/urllib3/packages/backports/weakref_finalize.py,sha256=tRCal5OAhNSRyb0DhHp-38AtIlCsRP8BxF3NX-6rqIA,5343 +pip/_vendor/urllib3/packages/six.py,sha256=b9LM0wBXv7E7SrbCjAm4wwN-hrH-iNxv18LgWNMMKPo,34665 +pip/_vendor/urllib3/poolmanager.py,sha256=aWyhXRtNO4JUnCSVVqKTKQd8EXTvUm1VN9pgs2bcONo,19990 +pip/_vendor/urllib3/request.py,sha256=YTWFNr7QIwh7E1W9dde9LM77v2VWTJ5V78XuTTw7D1A,6691 +pip/_vendor/urllib3/response.py,sha256=fmDJAFkG71uFTn-sVSTh2Iw0WmcXQYqkbRjihvwBjU8,30641 +pip/_vendor/urllib3/util/__init__.py,sha256=JEmSmmqqLyaw8P51gUImZh8Gwg9i1zSe-DoqAitn2nc,1155 +pip/_vendor/urllib3/util/__pycache__/__init__.cpython-312.pyc,, +pip/_vendor/urllib3/util/__pycache__/connection.cpython-312.pyc,, +pip/_vendor/urllib3/util/__pycache__/proxy.cpython-312.pyc,, +pip/_vendor/urllib3/util/__pycache__/queue.cpython-312.pyc,, +pip/_vendor/urllib3/util/__pycache__/request.cpython-312.pyc,, +pip/_vendor/urllib3/util/__pycache__/response.cpython-312.pyc,, +pip/_vendor/urllib3/util/__pycache__/retry.cpython-312.pyc,, +pip/_vendor/urllib3/util/__pycache__/ssl_.cpython-312.pyc,, +pip/_vendor/urllib3/util/__pycache__/ssl_match_hostname.cpython-312.pyc,, +pip/_vendor/urllib3/util/__pycache__/ssltransport.cpython-312.pyc,, +pip/_vendor/urllib3/util/__pycache__/timeout.cpython-312.pyc,, +pip/_vendor/urllib3/util/__pycache__/url.cpython-312.pyc,, +pip/_vendor/urllib3/util/__pycache__/wait.cpython-312.pyc,, +pip/_vendor/urllib3/util/connection.py,sha256=5Lx2B1PW29KxBn2T0xkN1CBgRBa3gGVJBKoQoRogEVk,4901 +pip/_vendor/urllib3/util/proxy.py,sha256=zUvPPCJrp6dOF0N4GAVbOcl6o-4uXKSrGiTkkr5vUS4,1605 +pip/_vendor/urllib3/util/queue.py,sha256=nRgX8_eX-_VkvxoX096QWoz8Ps0QHUAExILCY_7PncM,498 +pip/_vendor/urllib3/util/request.py,sha256=C0OUt2tcU6LRiQJ7YYNP9GvPrSvl7ziIBekQ-5nlBZk,3997 +pip/_vendor/urllib3/util/response.py,sha256=GJpg3Egi9qaJXRwBh5wv-MNuRWan5BIu40oReoxWP28,3510 +pip/_vendor/urllib3/util/retry.py,sha256=Z6WEf518eTOXP5jr5QSQ9gqJI0DVYt3Xs3EKnYaTmus,22013 +pip/_vendor/urllib3/util/ssl_.py,sha256=X4-AqW91aYPhPx6-xbf66yHFQKbqqfC_5Zt4WkLX1Hc,17177 +pip/_vendor/urllib3/util/ssl_match_hostname.py,sha256=Ir4cZVEjmAk8gUAIHWSi7wtOO83UCYABY2xFD1Ql_WA,5758 +pip/_vendor/urllib3/util/ssltransport.py,sha256=NA-u5rMTrDFDFC8QzRKUEKMG0561hOD4qBTr3Z4pv6E,6895 +pip/_vendor/urllib3/util/timeout.py,sha256=cwq4dMk87mJHSBktK1miYJ-85G-3T3RmT20v7SFCpno,10168 +pip/_vendor/urllib3/util/url.py,sha256=lCAE7M5myA8EDdW0sJuyyZhVB9K_j38ljWhHAnFaWoE,14296 +pip/_vendor/urllib3/util/wait.py,sha256=fOX0_faozG2P7iVojQoE1mbydweNyTcm-hXEfFrTtLI,5403 +pip/_vendor/vendor.txt,sha256=PxNaxxkkpBaw5zOTsDpHEY-zEaHjgkDgyrSxOuxg8nw,330 +pip/py.typed,sha256=EBVvvPRTn_eIpz5e5QztSCdrMX7Qwd7VP93RSoIlZ2I,286 diff --git a/.venv/lib/python3.12/site-packages/pip-24.2.dist-info/REQUESTED b/.venv/lib/python3.12/site-packages/pip-24.2.dist-info/REQUESTED new file mode 100644 index 0000000..e69de29 diff --git a/.venv/lib/python3.12/site-packages/pip-24.2.dist-info/WHEEL b/.venv/lib/python3.12/site-packages/pip-24.2.dist-info/WHEEL new file mode 100644 index 0000000..ecaf39f --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip-24.2.dist-info/WHEEL @@ -0,0 +1,5 @@ +Wheel-Version: 1.0 +Generator: setuptools (71.1.0) +Root-Is-Purelib: true +Tag: py3-none-any + diff --git a/.venv/lib/python3.12/site-packages/pip-24.2.dist-info/entry_points.txt b/.venv/lib/python3.12/site-packages/pip-24.2.dist-info/entry_points.txt new file mode 100644 index 0000000..25fcf7e --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip-24.2.dist-info/entry_points.txt @@ -0,0 +1,3 @@ +[console_scripts] +pip = pip._internal.cli.main:main +pip3 = pip._internal.cli.main:main diff --git a/.venv/lib/python3.12/site-packages/pip-24.2.dist-info/top_level.txt b/.venv/lib/python3.12/site-packages/pip-24.2.dist-info/top_level.txt new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip-24.2.dist-info/top_level.txt @@ -0,0 +1 @@ +pip diff --git a/.venv/lib/python3.12/site-packages/pip/__init__.py b/.venv/lib/python3.12/site-packages/pip/__init__.py new file mode 100644 index 0000000..640e922 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/__init__.py @@ -0,0 +1,13 @@ +from typing import List, Optional + +__version__ = "24.2" + + +def main(args: Optional[List[str]] = None) -> int: + """This is an internal API only meant for use by pip's own console scripts. + + For additional details, see https://github.com/pypa/pip/issues/7498. + """ + from pip._internal.utils.entrypoints import _wrapper + + return _wrapper(args) diff --git a/.venv/lib/python3.12/site-packages/pip/__main__.py b/.venv/lib/python3.12/site-packages/pip/__main__.py new file mode 100644 index 0000000..5991326 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/__main__.py @@ -0,0 +1,24 @@ +import os +import sys + +# Remove '' and current working directory from the first entry +# of sys.path, if present to avoid using current directory +# in pip commands check, freeze, install, list and show, +# when invoked as python -m pip +if sys.path[0] in ("", os.getcwd()): + sys.path.pop(0) + +# If we are running from a wheel, add the wheel to sys.path +# This allows the usage python pip-*.whl/pip install pip-*.whl +if __package__ == "": + # __file__ is pip-*.whl/pip/__main__.py + # first dirname call strips of '/__main__.py', second strips off '/pip' + # Resulting path is the name of the wheel itself + # Add that to sys.path so we can import pip + path = os.path.dirname(os.path.dirname(__file__)) + sys.path.insert(0, path) + +if __name__ == "__main__": + from pip._internal.cli.main import main as _main + + sys.exit(_main()) diff --git a/.venv/lib/python3.12/site-packages/pip/__pip-runner__.py b/.venv/lib/python3.12/site-packages/pip/__pip-runner__.py new file mode 100644 index 0000000..c633787 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/__pip-runner__.py @@ -0,0 +1,50 @@ +"""Execute exactly this copy of pip, within a different environment. + +This file is named as it is, to ensure that this module can't be imported via +an import statement. +""" + +# /!\ This version compatibility check section must be Python 2 compatible. /!\ + +import sys + +# Copied from pyproject.toml +PYTHON_REQUIRES = (3, 8) + + +def version_str(version): # type: ignore + return ".".join(str(v) for v in version) + + +if sys.version_info[:2] < PYTHON_REQUIRES: + raise SystemExit( + "This version of pip does not support python {} (requires >={}).".format( + version_str(sys.version_info[:2]), version_str(PYTHON_REQUIRES) + ) + ) + +# From here on, we can use Python 3 features, but the syntax must remain +# Python 2 compatible. + +import runpy # noqa: E402 +from importlib.machinery import PathFinder # noqa: E402 +from os.path import dirname # noqa: E402 + +PIP_SOURCES_ROOT = dirname(dirname(__file__)) + + +class PipImportRedirectingFinder: + @classmethod + def find_spec(self, fullname, path=None, target=None): # type: ignore + if fullname != "pip": + return None + + spec = PathFinder.find_spec(fullname, [PIP_SOURCES_ROOT], target) + assert spec, (PIP_SOURCES_ROOT, fullname) + return spec + + +sys.meta_path.insert(0, PipImportRedirectingFinder()) + +assert __name__ == "__main__", "Cannot run __pip-runner__.py as a non-main module" +runpy.run_module("pip", run_name="__main__", alter_sys=True) diff --git a/.venv/lib/python3.12/site-packages/pip/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f308b3d8ef79209ccc88f310683ca0f587704ea5 GIT binary patch literal 683 zcmX|9&ubJh6i#Mlf4FNc{tZMi8YRs z*=@277RkxVi6BG=Ft*hyt4*xj3U;2(-<_Xu-E?ONqRvYJrUN` z?WfuaCDURn>MzIr^*Tz;*w#(M-NZ<*;J<~Cd7oW^0NpVQeD~KFqX2E=ZM1)k-ax%@ zYxhMiEP<6uBBbL6dXNXt9up;tij+K+j*OHc6U)i4B3kHcmZ(ihG9|4lII)=#+S$0% zAz+UHnldK-i6xA?R223)v7D3KIc@JzIujpg$edSozUC|Nh~-)i2S~3=Tp6daqSCU8RK_8$T2iL8!Y)GUdj?K$D~ntuu89 z`sa+FkU8yf{&yX<@0W^A3chO2LFvb4dk_vnjPW;g<@=cnJKe)(3txQuYA@Q`_;Bj$ Q;?)BL^~dbD-{w?*0UDjRz5oCK literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/__pycache__/__main__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/__pycache__/__main__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..835c1a904793a9d72b34c8dad6d41dc3dca8160e GIT binary patch literal 839 zcmb7C&ubGw6n?WiX?|BKwa`{P*o!&1i?Nb`Vkmm(p*4C?A(tg)Ce5Uq-DP);u7Wfm zw82AH1Zz*dD*02qXsaMogn}n;k=}Z8rpb~*>%n)J_syGc-uLa>`JBzBK*XO1z4{{+ z;FsJ)5gUTTR|sGW2oPjKWsp$?QPji{b(9HAiw#i}pwJu})g#m!g1XWMclPWa&1A$L zWdc3nLIwgFBg*O(0QbJoIKx9TJ7At%|AQHil%iZw{^4`tq{09bph`~}VBs`L)MKZY z#PqP4YNaa~1Y$O*Idl51sAr=2MA`@f6rfz}x1`_Wz!Qeisxr$ka)@Jza^qaFJ+69z z$FWoO8+>eq`n6|-tB&pPv|%{a+G=%$8U~LO=33Pjm0jx0l%+9ddDQh~MV^Stl*1g& zV3tn>*VJkz)1;0o-vf^wt8+}BGyfADN>@kAdc$r}-F2w%+HF>A=rx;AeVKVRU29XT zt()wL?gW0rwytZ}^18=-dUfc^(}kQKeU#<|M~Pc4n>;n?ZFfp^mw(-RFP6TF5ZZ_2 zKBW2?!148Br?|1uxf$leAau8ax52xYU(U~cRp)+)!^O_x`ch{poOoUCCjg%dFYl_8 z{S;)zHw)duW~p2Hkl!h67j{b9rH{qE+4;TnjkUYc&2pz4E`O-vg{6n?Y2{>QNsLm;GSHcFb}%Gf1Im8c@5YDy9kmH!-SsakDz$FN}UI=gFv z2}l$nHI*urLsjUFQaoY(dodUlvQnf}?V;QtKD6c3H(qZ*O52h4&Aff{zIpTJ zd++CHGz>WQhSqZ5`T%}oiZ?=yMa?Dv%b-FQRHAZuk|ipiGeCC_pX{wZLD$;3LvGZlo9@i{U zF^Xl;$caU*m=Ygo_)iyQQPpxeYEs=6sXnEdhF-vRIvgHlE;%hvMVxiHKvhw;M9oGu zCE5n=wn`>NWZ8D%3x-<4-HNQgX^Z#Jtxz;f8{MWfIV|f9U9@c3rtTR#Ea?6ux5J{} zVT4c`FUJfZ;KwYr3n-9DWa6+D|FNNRi!cixfR`)pg+?IB_wSSRD~K1-sg8ID2%^ry z$1#98!r1DLS>j=QMV1MH&yNaFhVS_YBuV;{#NjR5OmYsFe%m2a79*7??vG@~jRMV> zMQWSIl%|Yl6hoz%4>e24q^B^mnY?x{Q!Lx#hJG>Kbs=MEHtj6R%A`C-tqeX%Mv_o= znk8MQrX;0{<^53i7}e=?(d?OdeTtfvX6OYik!E4(l70CjKXS0@dx}h4;zWp z%Ka~|uaM;%>xtCg7E9zpODo3j2or{;;~Z$o z%4b&)ZuRD7B2|r~DnhD;CfH#an7LM`O9P-mGEp@sQpd1Gt5jrM5Z(KW59h=Vlin|B zCfa+hKAcOYF{JRIY>(g2bd{PcKvgpt>lAi|Hy9h(sIf9z1`60yAj?r+<&g)(<3Ls@ zlceCZ4{F7}Ithmo)iX3O#0vN=X=w4$HI?jf>Ke^0Xw)tPhu zorLtu6W_p{)>Rbq@H~=ODs4nw+fKCp9y_rWJG&k`yLxLgbFGqo@2B(CSl=VzX)I9* zc5NO%|2SA_>8b|19@*Qm#G{DGScuo^$8dv^#KM#$CoD;BXTWunB;7B`^$VaDQS!27 z6)4t(S`YRK)FIsHTM*1-;v9Z;ZZE>NFaCn_`b}Jc#0Eba zy*1D;4fhV+?HleLsTYgWq=&WPd*JdZwLFff`jY9!KY2FEBsbl$9h}G<71D{RN7M2rp_l1f4o-B+^O+gC|u)( zh<_IZpTBktNc0)J^$bq_nrQ#}^6Hi9$y7DbS%LVU{vc`I0~EW*fe4>QKZ$NZ^Exyy z4Xw9bsJ30&gm<0?VoUFC1Wr|8xN>^9iZXC&8{+f6Er_o}e5qx%{RjIO=&s-RAEYlN A00000 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/__init__.py b/.venv/lib/python3.12/site-packages/pip/_internal/__init__.py new file mode 100644 index 0000000..1a5b7f8 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/__init__.py @@ -0,0 +1,18 @@ +from typing import List, Optional + +from pip._internal.utils import _log + +# init_logging() must be called before any call to logging.getLogger() +# which happens at import of most modules. +_log.init_logging() + + +def main(args: Optional[List[str]] = None) -> int: + """This is preserved for old console scripts that may still be referencing + it. + + For additional details, see https://github.com/pypa/pip/issues/7498. + """ + from pip._internal.utils.entrypoints import _wrapper + + return _wrapper(args) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a913395b68b4587f91ef0336a13084109405b465 GIT binary patch literal 785 zcmZuvy=xRf6rb6hyKKIY7@Jt=C^iSWgC7thl1i*JA`ygZ&du(-+tJ;fVP@|1Bti-c z!N$(mSS$HcYzzp(HX>qSmk@1I`DSym^0D*2cpty_-hP^&pCL&5_jmdu$(@Ob(Nh_N04TJV(C1&)f~h{s z+Amw(XdHH;Up}@I)a;J5u8!_$Csmac9a^(qp$2O;OU%I5Z3Av-s+9Wh356*AJ2-<3 zky1p4NMBHoY?E%1ok{dM>4eYUKggx!_-O+c%m^~xSB9%1|JsTks?zm(u^!i~Ok`!|u!}#tT|l-){>+iq%J!_$wKPtX}-jNXGwi^<2{hPd>nmI<(HzAr9Fz`$){ZFENYkFuGZ)Y*@gm zIfbS_v0X;C7g9>Uk#j%Eg}sQ-lUwX7S=c2DU&!KqJEEswJ=+hy_Pn_Q)Xn#n5 Id(jmB3t)-Qb^rhX literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/build_env.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/build_env.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..bd9e8796d8c2f56ca1f9f434f7da064a1fb93e80 GIT binary patch literal 14514 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 F{})b#;9~#) literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/cache.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/cache.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..41b7134d6c45e478902ae234dc167a2bea6245a5 GIT binary patch literal 12663 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/configuration.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/configuration.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c96676db79b19c795d3080820c47c31e01816a2f GIT binary patch literal 17664 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%0AYSe$DxT9PL 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

4>>(S1mb32dD?>v@y4y)wNVDo}@62YTdFSdh$ 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¬o;--6YgxV||0o9e+|(p>)`YDnrqjq<3beXgc`%KNkOhUxy<+K<-;7iwD` z)wa*owr6U#&OSFAdlWo87d)Kl?8#L1PW3#7nd`vq0}B-g7ph-)(DUH=Ol9{+domTr z7oGN+vYWk7B5E2IsOrd%m2ByL?Hxrfh|p+|V1e-Y%cGVYg& zD3MOBs1Q-_fB!fT}4Z}k7lQA-~*K_aLUW%_TYN+;BjPTR1-I$j@;ln)q@nI2d0m}eI z#*$SH_B6h6m93pH*&%+0)^_7r+Hx4G5f)sTT@uu~Q8Ac!duSMWEJ?iv;0OU21xV8^ z^eR%m^!nocZB7G{|C8I06Vt#@hF7Abt+JV{qD{*_tfTd#S{m)Ux5Bu3f`F9#mjblf zLugg_ogB&(I3qUIBoR`hxCpHQN!Cr095|P@k3fy6CA7lHBq$2HmyDW8;aDcd!rtYq zi&k0T0U`++sW(DGVBZ_D10hYYcp#)m1P({=33B>gUl2r(KI*5zKxFxrTehCXO>0K6 zobY{7yibs#u+ffcdS?xiY#nD~ksYSrpy3D; z-|}cKyosCVfP z3{vtcCBu{u=jZMJdB1e+2L1d7C2vvk_bHj8T=S<=<)2EWe=3#nfA614zCV*X=A@24lTJU9PR~iF|5`dWCms8_ z)c$j6^MABg{M^y}*Ny{!>Dcpg$Dt?Q#;N*8-o`m^^AOO+EDOg zjf@XwARC>R_B!OWhv%9&~`5vGf!x*9ZvYJu}o&?6t0Au`jw@< zr89Dc+>u$|mDzuCNy6pQ<{G&rQ@Md2Z&?a%l@H08ik2mbE|y-EJ+f;WTMyy1REK0H zpkHs1eYbFp)6zN0bZeh}V~?!RHBL(@8Q&Y@?!tM=S0i`JnYJ!^QMa56$^mS5)bift zyO*c2i=e$7+aozPIWkhqQrQt%UV}Xbmn6DaI%8`<1Di1hI4|w?^N-IYoSDo1|A$|x A!vFvP literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/main.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/main.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..aea8abd171e45d2ae73ff09c3e0b7af4d065637b GIT binary patch literal 668 zcmX|9J#Q2-5Vd#rj^mODA*xV-K{O}9S|msigi;|Y2tt?YnrO40yS3O|TVvnBq99RF zAkokf8fs8}3JtW|AVfu%=%7i(_y`$!#?N1Gp2z;OveIW{M^6sM+nlkVVesENCt$ut z;5}1J@sd@1#H(l&ai+Q|h6p&stF#_mC6J60)p^|+b(&~!=2svXL~Zg=JKy#mTdz%> zm0N9+;l#CF1V6<(r@W^Y6AC`RM1gX06@{EHIcE{u<9qDjWcQE_;ujyc3+)6oi{Jof zpv2gqFr^Z?shuf7xE!_hPWU48qRJZKye>3?d4 z0-x#9T^9~O6y95RSIUX@#dJ5#O(kt(GikMz+PNt>dHdGJopeEj5nW=y+uqJI%&Y~Z zT3n``>5i^FAeADWk{Xvn?Xj_jW*zpznFvGi7uW?7A&!T#FcnC&;L*% zWjcd;CQH3bVtirh_4MYNblSrWo8?cl38@MKPt(dO({*Z_HVFWiC__T-&Qo~B{w%Z3 z#*d{7@9w|d{Fu-?8;HM$1lElzMt$5Kb-w`?&=|<@u&QE=oT!00i7|kc>n+a literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/pyproject.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/pyproject.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..947e5c94ce440dc89f41e5748fb1453bf39bdd6d GIT binary patch literal 5127 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 DYXUuW literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/wheel_builder.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/__pycache__/wheel_builder.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4372221b4a1579a44796234f952c73cd8c047969 GIT binary patch literal 13636 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 Union[Tuple[str], Tuple[str, str]]: + return (a, b) if a != b else (a,) + + +class _Prefix: + def __init__(self, path: str) -> None: + self.path = path + self.setup = False + scheme = get_scheme("", prefix=path) + self.bin_dir = scheme.scripts + self.lib_dirs = _dedup(scheme.purelib, scheme.platlib) + + +def get_runnable_pip() -> str: + """Get a file to pass to a Python executable, to run the currently-running pip. + + This is used to run a pip subprocess, for installing requirements into the build + environment. + """ + source = pathlib.Path(pip_location).resolve().parent + + if not source.is_dir(): + # This would happen if someone is using pip from inside a zip file. In that + # case, we can use that directly. + return str(source) + + return os.fsdecode(source / "__pip-runner__.py") + + +def _get_system_sitepackages() -> Set[str]: + """Get system site packages + + Usually from site.getsitepackages, + but fallback on `get_purelib()/get_platlib()` if unavailable + (e.g. in a virtualenv created by virtualenv<20) + + Returns normalized set of strings. + """ + if hasattr(site, "getsitepackages"): + system_sites = site.getsitepackages() + else: + # virtualenv < 20 overwrites site.py without getsitepackages + # fallback on get_purelib/get_platlib. + # this is known to miss things, but shouldn't in the cases + # where getsitepackages() has been removed (inside a virtualenv) + system_sites = [get_purelib(), get_platlib()] + return {os.path.normcase(path) for path in system_sites} + + +class BuildEnvironment: + """Creates and manages an isolated environment to install build deps""" + + def __init__(self) -> None: + temp_dir = TempDirectory(kind=tempdir_kinds.BUILD_ENV, globally_managed=True) + + self._prefixes = OrderedDict( + (name, _Prefix(os.path.join(temp_dir.path, name))) + for name in ("normal", "overlay") + ) + + self._bin_dirs: List[str] = [] + self._lib_dirs: List[str] = [] + for prefix in reversed(list(self._prefixes.values())): + self._bin_dirs.append(prefix.bin_dir) + self._lib_dirs.extend(prefix.lib_dirs) + + # Customize site to: + # - ensure .pth files are honored + # - prevent access to system site packages + system_sites = _get_system_sitepackages() + + self._site_dir = os.path.join(temp_dir.path, "site") + if not os.path.exists(self._site_dir): + os.mkdir(self._site_dir) + with open( + os.path.join(self._site_dir, "sitecustomize.py"), "w", encoding="utf-8" + ) as fp: + fp.write( + textwrap.dedent( + """ + import os, site, sys + + # First, drop system-sites related paths. + original_sys_path = sys.path[:] + known_paths = set() + for path in {system_sites!r}: + site.addsitedir(path, known_paths=known_paths) + system_paths = set( + os.path.normcase(path) + for path in sys.path[len(original_sys_path):] + ) + original_sys_path = [ + path for path in original_sys_path + if os.path.normcase(path) not in system_paths + ] + sys.path = original_sys_path + + # Second, add lib directories. + # ensuring .pth file are processed. + for path in {lib_dirs!r}: + assert not path in sys.path + site.addsitedir(path) + """ + ).format(system_sites=system_sites, lib_dirs=self._lib_dirs) + ) + + def __enter__(self) -> None: + self._save_env = { + name: os.environ.get(name, None) + for name in ("PATH", "PYTHONNOUSERSITE", "PYTHONPATH") + } + + path = self._bin_dirs[:] + old_path = self._save_env["PATH"] + if old_path: + path.extend(old_path.split(os.pathsep)) + + pythonpath = [self._site_dir] + + os.environ.update( + { + "PATH": os.pathsep.join(path), + "PYTHONNOUSERSITE": "1", + "PYTHONPATH": os.pathsep.join(pythonpath), + } + ) + + def __exit__( + self, + exc_type: Optional[Type[BaseException]], + exc_val: Optional[BaseException], + exc_tb: Optional[TracebackType], + ) -> None: + for varname, old_value in self._save_env.items(): + if old_value is None: + os.environ.pop(varname, None) + else: + os.environ[varname] = old_value + + def check_requirements( + self, reqs: Iterable[str] + ) -> Tuple[Set[Tuple[str, str]], Set[str]]: + """Return 2 sets: + - conflicting requirements: set of (installed, wanted) reqs tuples + - missing requirements: set of reqs + """ + missing = set() + conflicting = set() + if reqs: + env = ( + get_environment(self._lib_dirs) + if hasattr(self, "_lib_dirs") + else get_default_environment() + ) + for req_str in reqs: + req = get_requirement(req_str) + # We're explicitly evaluating with an empty extra value, since build + # environments are not provided any mechanism to select specific extras. + if req.marker is not None and not req.marker.evaluate({"extra": ""}): + continue + dist = env.get_distribution(req.name) + if not dist: + missing.add(req_str) + continue + if isinstance(dist.version, Version): + installed_req_str = f"{req.name}=={dist.version}" + else: + installed_req_str = f"{req.name}==={dist.version}" + if not req.specifier.contains(dist.version, prereleases=True): + conflicting.add((installed_req_str, req_str)) + # FIXME: Consider direct URL? + return conflicting, missing + + def install_requirements( + self, + finder: "PackageFinder", + requirements: Iterable[str], + prefix_as_string: str, + *, + kind: str, + ) -> None: + prefix = self._prefixes[prefix_as_string] + assert not prefix.setup + prefix.setup = True + if not requirements: + return + self._install_requirements( + get_runnable_pip(), + finder, + requirements, + prefix, + kind=kind, + ) + + @staticmethod + def _install_requirements( + pip_runnable: str, + finder: "PackageFinder", + requirements: Iterable[str], + prefix: _Prefix, + *, + kind: str, + ) -> None: + args: List[str] = [ + sys.executable, + pip_runnable, + "install", + "--ignore-installed", + "--no-user", + "--prefix", + prefix.path, + "--no-warn-script-location", + "--disable-pip-version-check", + ] + if logger.getEffectiveLevel() <= logging.DEBUG: + args.append("-vv") + elif logger.getEffectiveLevel() <= VERBOSE: + args.append("-v") + for format_control in ("no_binary", "only_binary"): + formats = getattr(finder.format_control, format_control) + args.extend( + ( + "--" + format_control.replace("_", "-"), + ",".join(sorted(formats or {":none:"})), + ) + ) + + index_urls = finder.index_urls + if index_urls: + args.extend(["-i", index_urls[0]]) + for extra_index in index_urls[1:]: + args.extend(["--extra-index-url", extra_index]) + else: + args.append("--no-index") + for link in finder.find_links: + args.extend(["--find-links", link]) + + for host in finder.trusted_hosts: + args.extend(["--trusted-host", host]) + if finder.allow_all_prereleases: + args.append("--pre") + if finder.prefer_binary: + args.append("--prefer-binary") + args.append("--") + args.extend(requirements) + extra_environ = {"_PIP_STANDALONE_CERT": where()} + with open_spinner(f"Installing {kind}") as spinner: + call_subprocess( + args, + command_desc=f"pip subprocess to install {kind}", + spinner=spinner, + extra_environ=extra_environ, + ) + + +class NoOpBuildEnvironment(BuildEnvironment): + """A no-op drop-in replacement for BuildEnvironment""" + + def __init__(self) -> None: + pass + + def __enter__(self) -> None: + pass + + def __exit__( + self, + exc_type: Optional[Type[BaseException]], + exc_val: Optional[BaseException], + exc_tb: Optional[TracebackType], + ) -> None: + pass + + def cleanup(self) -> None: + pass + + def install_requirements( + self, + finder: "PackageFinder", + requirements: Iterable[str], + prefix_as_string: str, + *, + kind: str, + ) -> None: + raise NotImplementedError() diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/cache.py b/.venv/lib/python3.12/site-packages/pip/_internal/cache.py new file mode 100644 index 0000000..6b45126 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/cache.py @@ -0,0 +1,290 @@ +"""Cache Management +""" + +import hashlib +import json +import logging +import os +from pathlib import Path +from typing import Any, Dict, List, Optional + +from pip._vendor.packaging.tags import Tag, interpreter_name, interpreter_version +from pip._vendor.packaging.utils import canonicalize_name + +from pip._internal.exceptions import InvalidWheelFilename +from pip._internal.models.direct_url import DirectUrl +from pip._internal.models.link import Link +from pip._internal.models.wheel import Wheel +from pip._internal.utils.temp_dir import TempDirectory, tempdir_kinds +from pip._internal.utils.urls import path_to_url + +logger = logging.getLogger(__name__) + +ORIGIN_JSON_NAME = "origin.json" + + +def _hash_dict(d: Dict[str, str]) -> str: + """Return a stable sha224 of a dictionary.""" + s = json.dumps(d, sort_keys=True, separators=(",", ":"), ensure_ascii=True) + return hashlib.sha224(s.encode("ascii")).hexdigest() + + +class Cache: + """An abstract class - provides cache directories for data from links + + :param cache_dir: The root of the cache. + """ + + def __init__(self, cache_dir: str) -> None: + super().__init__() + assert not cache_dir or os.path.isabs(cache_dir) + self.cache_dir = cache_dir or None + + def _get_cache_path_parts(self, link: Link) -> List[str]: + """Get parts of part that must be os.path.joined with cache_dir""" + + # We want to generate an url to use as our cache key, we don't want to + # just reuse the URL because it might have other items in the fragment + # and we don't care about those. + key_parts = {"url": link.url_without_fragment} + if link.hash_name is not None and link.hash is not None: + key_parts[link.hash_name] = link.hash + if link.subdirectory_fragment: + key_parts["subdirectory"] = link.subdirectory_fragment + + # Include interpreter name, major and minor version in cache key + # to cope with ill-behaved sdists that build a different wheel + # depending on the python version their setup.py is being run on, + # and don't encode the difference in compatibility tags. + # https://github.com/pypa/pip/issues/7296 + key_parts["interpreter_name"] = interpreter_name() + key_parts["interpreter_version"] = interpreter_version() + + # Encode our key url with sha224, we'll use this because it has similar + # security properties to sha256, but with a shorter total output (and + # thus less secure). However the differences don't make a lot of + # difference for our use case here. + hashed = _hash_dict(key_parts) + + # We want to nest the directories some to prevent having a ton of top + # level directories where we might run out of sub directories on some + # FS. + parts = [hashed[:2], hashed[2:4], hashed[4:6], hashed[6:]] + + return parts + + def _get_candidates(self, link: Link, canonical_package_name: str) -> List[Any]: + can_not_cache = not self.cache_dir or not canonical_package_name or not link + if can_not_cache: + return [] + + path = self.get_path_for_link(link) + if os.path.isdir(path): + return [(candidate, path) for candidate in os.listdir(path)] + return [] + + def get_path_for_link(self, link: Link) -> str: + """Return a directory to store cached items in for link.""" + raise NotImplementedError() + + def get( + self, + link: Link, + package_name: Optional[str], + supported_tags: List[Tag], + ) -> Link: + """Returns a link to a cached item if it exists, otherwise returns the + passed link. + """ + raise NotImplementedError() + + +class SimpleWheelCache(Cache): + """A cache of wheels for future installs.""" + + def __init__(self, cache_dir: str) -> None: + super().__init__(cache_dir) + + def get_path_for_link(self, link: Link) -> str: + """Return a directory to store cached wheels for link + + Because there are M wheels for any one sdist, we provide a directory + to cache them in, and then consult that directory when looking up + cache hits. + + We only insert things into the cache if they have plausible version + numbers, so that we don't contaminate the cache with things that were + not unique. E.g. ./package might have dozens of installs done for it + and build a version of 0.0...and if we built and cached a wheel, we'd + end up using the same wheel even if the source has been edited. + + :param link: The link of the sdist for which this will cache wheels. + """ + parts = self._get_cache_path_parts(link) + assert self.cache_dir + # Store wheels within the root cache_dir + return os.path.join(self.cache_dir, "wheels", *parts) + + def get( + self, + link: Link, + package_name: Optional[str], + supported_tags: List[Tag], + ) -> Link: + candidates = [] + + if not package_name: + return link + + canonical_package_name = canonicalize_name(package_name) + for wheel_name, wheel_dir in self._get_candidates(link, canonical_package_name): + try: + wheel = Wheel(wheel_name) + except InvalidWheelFilename: + continue + if canonicalize_name(wheel.name) != canonical_package_name: + logger.debug( + "Ignoring cached wheel %s for %s as it " + "does not match the expected distribution name %s.", + wheel_name, + link, + package_name, + ) + continue + if not wheel.supported(supported_tags): + # Built for a different python/arch/etc + continue + candidates.append( + ( + wheel.support_index_min(supported_tags), + wheel_name, + wheel_dir, + ) + ) + + if not candidates: + return link + + _, wheel_name, wheel_dir = min(candidates) + return Link(path_to_url(os.path.join(wheel_dir, wheel_name))) + + +class EphemWheelCache(SimpleWheelCache): + """A SimpleWheelCache that creates it's own temporary cache directory""" + + def __init__(self) -> None: + self._temp_dir = TempDirectory( + kind=tempdir_kinds.EPHEM_WHEEL_CACHE, + globally_managed=True, + ) + + super().__init__(self._temp_dir.path) + + +class CacheEntry: + def __init__( + self, + link: Link, + persistent: bool, + ): + self.link = link + self.persistent = persistent + self.origin: Optional[DirectUrl] = None + origin_direct_url_path = Path(self.link.file_path).parent / ORIGIN_JSON_NAME + if origin_direct_url_path.exists(): + try: + self.origin = DirectUrl.from_json( + origin_direct_url_path.read_text(encoding="utf-8") + ) + except Exception as e: + logger.warning( + "Ignoring invalid cache entry origin file %s for %s (%s)", + origin_direct_url_path, + link.filename, + e, + ) + + +class WheelCache(Cache): + """Wraps EphemWheelCache and SimpleWheelCache into a single Cache + + This Cache allows for gracefully degradation, using the ephem wheel cache + when a certain link is not found in the simple wheel cache first. + """ + + def __init__(self, cache_dir: str) -> None: + super().__init__(cache_dir) + self._wheel_cache = SimpleWheelCache(cache_dir) + self._ephem_cache = EphemWheelCache() + + def get_path_for_link(self, link: Link) -> str: + return self._wheel_cache.get_path_for_link(link) + + def get_ephem_path_for_link(self, link: Link) -> str: + return self._ephem_cache.get_path_for_link(link) + + def get( + self, + link: Link, + package_name: Optional[str], + supported_tags: List[Tag], + ) -> Link: + cache_entry = self.get_cache_entry(link, package_name, supported_tags) + if cache_entry is None: + return link + return cache_entry.link + + def get_cache_entry( + self, + link: Link, + package_name: Optional[str], + supported_tags: List[Tag], + ) -> Optional[CacheEntry]: + """Returns a CacheEntry with a link to a cached item if it exists or + None. The cache entry indicates if the item was found in the persistent + or ephemeral cache. + """ + retval = self._wheel_cache.get( + link=link, + package_name=package_name, + supported_tags=supported_tags, + ) + if retval is not link: + return CacheEntry(retval, persistent=True) + + retval = self._ephem_cache.get( + link=link, + package_name=package_name, + supported_tags=supported_tags, + ) + if retval is not link: + return CacheEntry(retval, persistent=False) + + return None + + @staticmethod + def record_download_origin(cache_dir: str, download_info: DirectUrl) -> None: + origin_path = Path(cache_dir) / ORIGIN_JSON_NAME + if origin_path.exists(): + try: + origin = DirectUrl.from_json(origin_path.read_text(encoding="utf-8")) + except Exception as e: + logger.warning( + "Could not read origin file %s in cache entry (%s). " + "Will attempt to overwrite it.", + origin_path, + e, + ) + else: + # TODO: use DirectUrl.equivalent when + # https://github.com/pypa/pip/pull/10564 is merged. + if origin.url != download_info.url: + logger.warning( + "Origin URL %s in cache entry %s does not match download URL " + "%s. This is likely a pip bug or a cache corruption issue. " + "Will overwrite it with the new value.", + origin.url, + cache_dir, + download_info.url, + ) + origin_path.write_text(download_info.to_json(), encoding="utf-8") diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/cli/__init__.py b/.venv/lib/python3.12/site-packages/pip/_internal/cli/__init__.py new file mode 100644 index 0000000..e589bb9 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/cli/__init__.py @@ -0,0 +1,4 @@ +"""Subpackage containing all of pip's command line interface related code +""" + +# This file intentionally does not import submodules diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..93ddd94de534e5981159756ed99eb802100d307c GIT binary patch literal 276 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/cmdoptions.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/cmdoptions.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a287ce5d16c51b3a297ccfc9f8e1a6df8eb0ecdb GIT binary patch literal 30396 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 z zij-xL39TaKGQ^84tAJESxGgLXBH8h6d&pbJlK=kAsIqNo4)R2ZkRoK}X^wI!S9}bf zAtEFcqQF*QYSW7l&g5SFsiLWjAi3w_6t zZ#@8mH)bfo<`R~%s1J9aUXIWi8hcH0HGI zJ1PBHpn7_z7~N}u&a3WD9^REF2C2eJy5d@?BNN3)2X~Gp75`RT33pDoS6Z0B+Z86q zN>hV6BRXG)JH6hZ?bH}~l;Nt4C&yq%>OQzA#cG`%AjQ>qfSRB`+I zbM9EhX}?6(5;n2m4s0%Zq^kDWouAwL%HAs*u2tSU`Or=Gs_X8qd3RUA8!C9Ku6vv3 zz0G{nI`3`$Zn@i30*GMDpT&y)f5*7?MKoFa5+zqC`9&n9SgSFyX2ZPp%K-e=4}~{E zmxVwZ-cXSBvs8m2ys}ejj;132E*sb7Z_EjJK`K(M@CW5QMke@$5W7Rhq`}^WF$rrN z-f%%+8WDoV+~F+lVrS9GeHm-b+*orr3`m#`w4hE4@6g@hcu=tNZda&;JDOc@q+pSG z$<`*RY9^JE7CQ!^+Y_f1qpTSq(8eqOZDfcVen<{TENQ?dxlJtYGaz~L##!Nke384L zCsPO{RYnf|bheuV3=j)IIy3uJOiP#+>$1WR0JlI28n_v0iQFkF$}A!xAI-oI!l9el z4Eki^0@fE^BbMR}nn2*GQK+8mEJ?-2<)K(2N$(A&EqrEd1sG~6m^d$0knxQ=Bd>Xc z52eVii{2Ds+z^+3tBi3NK>*+kw8MS{Iq*Y@i6&)z-PetG@1 zx-FAO;U_D2>k6UOh03OztJ(^o>OvLP$;&GCITkBJr0s{yiH?G--~S_mg&s_k@m)yv z&{C2Wa@-oGe|?fIX~6d(*&mTSBUl0v;e|}Wqlp6k z#6}!Y`!W(csWB&|1Y2~ZEKw%3vXw{;rhy=}jv}eGl~5Wx29qL^O52XIbgvmcBfMI_ zc8r`jw5GvM4O+HKLA^}S(haXX?lIx-kI070+G0QEC)2TrrC4@$ij~ud{0NG*PtT={ zjb^fl6&f$HJhMphzZk9zc~I~pGaQSev5i$v?I+QtIL%Y@M!))TxvYA=tBBDvF>ENpm@*$E9)KIqAIX zap|0++n@hKKgAcpvWH1eilbrKW8t6I=97sts@%4{4O3_PE~MbzZQCQeBHPhRHJL_(9{&Nd{6U}zDcJcSh}5Q0T0MMC%) z$IA{x-L7)OAp3&roP)!7x*gg$azhb!Mz&Dk5$d)n-tYMK&}M@3quTxXyGZe-QHhGR zeKV9TvWNYJ+500F>~5O#wJ7&5r0-2iUvItl(vDB|&(?nW@%h$!|BlVL=j$3ACLTIi zE3kLpirRxpfnijKRSj&X9R*^wS4Ds}kD=~AMfyS?hw!`DPQ>~n^*|5WM|Wv}Qp3A+ zL;GD6-$4y0pYx=IaI)a4Ta_)hf~#IUbn(!P>sqiCW@Nd4>h2%QPxn0kfkNf|e`Y*A z{QR@Gs_Ld=FL|fRZU!o*#(sSFjN`-i7wVd4w!ZY(%-HP1vnOW8uhw=?^)0wvWqWQm zv;q@X?tZiN-fIo_P6ZddQmARB<7!~-RrlKOEtX5cdJ6yDbEEP;iuc{~PPQ6t`bt%G z&j#r$8+<+6TwmGhK)SMVqXE{gG8TjOpG5aAxG$7Vls#9kU`~DlON0|;*i_)Y;IYkn z1mjM4u+xc%6+eXDx?%ehPb&FE4G8R|aUdXeJI|7bIPOPg*9xzL!J{rH#tacP^gM<> zn#TwW@8!y1yXCxdxBQw@7&sJw4^p79;$V1TGSLKpiMxUcqPTsOVVGdnMBxDtQMyZcuA=E?mZI`Z6+x7@PuI8>GPRHF{Wp2MW2CY^+q zYAkLM@f%XY;t!BFB;bNyVS{RYm8I4P`Hzk(L@{R!E$Kq9!p^#0h!jKVu?q1WUkA_F5Lvu@Kl zI^IcI3@8dV(o)cH3~Od^A;b;EDw2o04Drg^4)hn1&4Y>9VUX<)*l&uf-h-sr!|~Da z=#H&Fe21u{Tnv%+W>0K`ae}rzu)G z=?SB0W4_qb%Lx35Dc)|9T_){`-QM{qjfP0&9p*PWn93#Zt;Ml@+&T8`j{UC8{ zD81m=1$XeeyJ6nl@JZh%0&luIiq93-8oS8rNQLjLbJi3ZdE;pS<{Fp<&JShVXnt zc+po@=b1dR0A;EPVf_M`D98E{F)=dRaAQZNa9AmBc2XJ6SK*{W*b)qtGPT0|Q_(JL+rUZ)R~%n*WP z+!)I^9C1|HLMzT#!09fHRDi=Rj&L-UmKt;)-_pWDeoa5cQxj9iA|<}dN-P(HrX=qn zr@pne`vg_XqUsFYokX%kC$tu^KZ!438qVi}u-7bNE^3B2&&jp&`cBkxe2+U|y`g*J z2kUL!1)E!Z0$QVOt;pI0HfLK2dK?=FFStM8{>UzIJ?F42KX?8j%irT79#V#4Ldv}r zOvM@kp+m&$nm99d=NNY0Nm@$Be=r-s51?`&I{KKo)GO9#{-ttA2RN#I4Sn2?1uHU% zwcn;>10`oE`8i4oNHD`#b{b^u8z|%o(aRCsU^i!@ z($KHAzaIaUuIs_x zuLpbo9_9kRyu-%V3xRdgE54q9>+=mg9@keqWw@oVUy64&@t3dOXGFMKq-I5w6}2Ct zD-j({`6v$3*s?{@N8+})6X_lR=iB!oiY*6%70b`2bJf19D594G8?^B&-w5f+u{q|V zcGj>M^m_3gTb4M)K5N*X`A#F2hgw~t`l3>?P(;yj6rN8W?Xg5sG4=)EwO+|DqGAUC zy$Fc?3qw#K)sy*`O{7==LRfPyvg~8L2&^G?l$Q+2FKv0(BJzV&8^ZmH+p}y@?{EWg zeA(7}idL=>C~05|iUo5b5b{!oFe3eFy@pCJHa*`A7DAf6(Mfx?dKG^$vM{Q*_7W^J z7A|OMGg&1;^X}fd%TleDFce}2%&y55$PA@Qae@sLSqd4C?m1V{cvN6;7WERP3@)Ow zF_2h8UbdgbDhQQOt~N}PVm)o}pVB554w*4K&9(wKE5d)VjR)Ie zu=c?`x>%MGn28qr3)Pb$!`0gAw2E0?H}et15(^WJ`p+C1UMqhwKtnHMb9kB3%q}t# z+?I>1on2%mWvr;Qtw@NLPt|axtzYU&b0KDx!{`y1ue;%CM-VHA_K|fAXV+IyBOQ(* z9P}he4fligTe#16*RDQj3 z%Y4N_!_n5g(UISF5Uf~4iy`JU%WiSQjZi{i*0MpqjNP00fXTyQF7AiKBRL4WFPYTZ zaL2+>_ZOQBnYn^YWUmW+_D0vUG(Tw+P4`RPie1l*s|-%Luyx+o zVtHBMLaXY;B6XkwU4O&-X2rob0|%jUAzZCt&C3%nP0T)Yts#81K62>{WMl|_HOUuT z^e!pFBgyMcN!u!1HHZZ%lBo7qXh;6(N8o)CEPNMFQcEhVAPnGZK>pHsT(q{6>ToPR zjwMD!@g*Qju*(4I?UKm|q(6dsIo@6@$FkPPGC8z_udK|e6|fiL)GOJGibc{-f~d$f zc)>G)<49@Oy;cWKinpadI1cGF64$4!UGWav62Qvb7uG7Nq9s3Tow|IYe6l?uT_`V} z7x2TBGf`fYHgHvzpM}*^Ja1s4e8Nq7T&}{b-mDirG`^i)WqvDOCp?!8xkDjLCgg-? z*h%-iO%!g@;(fOp9{#=Wgm9(_$L#a^Qohxa@N$*!qdsz2W2;&w zt#zPoZH^LFF?rBm#iQ;|fXPFV!udkFJ4vd>2l2YwyOP6GcOfpH_M(jHE^ucioh;#= zW*hy4!?VGhae~>>HgJv;(f$sgcN2qo4L6u`9;vSR(ar#&x+UJA{e{q!>*d*;%9ud>q-a0J0?ki^G8lpw4=h+|R{(SXp*B&x7j$0Q%wguiSsx5& zAK^#(#QLGNX1J_*hInOa;e(hgPzpU0=3Y@jXA_V(0_peMz_3tN^bkK8 z`>?b5dqwy^jtME!s6A){eeDDm#zt`hjXX$dZIq>Ir)3pzRa`UI2W}-|(98-e#G_SX zT-0a;s)<%{w@Rud6k9b@L>)!|m=q{A?Fgt1wnot^FCF4!wT+uq#D&-f5KpSHbbg&M zNce&FfQnIs6~-Zb*hGe1&w|AkxhwAn<=k+3!pD$*{9u~nu%LdaFjepgyq$b|MrbI7 z-RWgT7=bIRDKI~l?ih!jNL!xa*0sy^(Ny}6rU`g z59{~&XGG^l;ljt3T|%DW?Z-O8@q6r|TF0=jB0It` zQ1ZlvS_M=fOmS{=RaZk%^FUU#?8yW3~? zU241L4qtcgn0N2Ea_TMjp6@L-@uGMc>J?f?p`vBxz|6f1l5>3nl2F6na&ay|yptt$ z?zOrHw@AOaWlirY*Kbuhkn({S)KL#Qs(Zx3V1D=%ZM>w|9E4+#5HhS3+U6uSQDMaq zyH*ht$g4Cwq=slR#1bs82bQi_z_XMc67C=cy$PnRv9@O} za2cQS_xB^57RC_yE}_2(S~5Ng9y>M)#1lb{rHcW0V(~p2!Rc7Er;a_o`Bw4{^8sUF zl@DJCv%V`l*mm6>LzM)t)$H$oE_ZX)*kbX5}91(}@ zc{!ZB%1nl0fT8@7N{>d<`D$jI2KJ|!3Vu<|UaH{em1s~DMMuq=!8WLkCN6NkL`(7B zgtA(kuM{o^uo|3_1I*@w#tYiRoz3qv8ec48#Xj&FI69%JDJ-Z_A9$V*VY`Bc6KU$H zk;Nj+R^%&rrWW< zdr~itMzK#G$1TwjYS=ak_gjR#Z`z+zspUBMgN_gqn~!9A<>OJIO2i*%c$csf9 z&2$k#O)e^prnpANvqtKg?!gfyR1)cOT7Z%uB_T>GkmxN?W+QaOkCM?MVtN3c8qS3ZekG}&#RGkrqxmj?Mp%EXrp8{ zBJ>Aq=S&?zHm?ZD*wyL@plwBfrE9_sE0jdI&qhcMd4Wy$VRO%6 zj1sUwD`C2ah71p9@xTs8Ekdu|bc8M+F2|>2iSx1!5zM3XxiT7Mo-0s-^R^zNPft?v zG$m0=-bYD{k~k#_B`PIDl%y!hP(mI@ZH$uhluS@ENy!u?7m+{@Bblkv27B$p^p@fV zwP{K|O34f*AE$(OM$XdR&r|YwO1?nJFH!Q#lw6_YOO%kinqx9WklXLmBZY?*10p!a zfmh>s#hKS4c`Z@9NpNpd@<){XF(rRO$zM}K-b?LoC?O}0_6{ZgK*>K+@=uifGbIv) zh~}V#G(tLh6XZ=vB_$+cv^q-gKNphphMvQZ_B`Gn?K|4@;NiY~(fxfrCm+Fy&l>(0 zLpU#&68z7FBy9~P{ZxD>CF_yAx1?QfOIyDwJ@~e?_ibt8+tPh+ zOFQ0{BDZ|aQw`UB&GWwInR~AJIwm~}o`9o%W&)>tIO?yQ;>#QDeEDj}9eTOY>T@*C zoSbc+&CYgx>}i}Q;Ap&h_W{0s_0S!9{7&O~N5$;^1qqkeJNWX|9e3zy;W!$-e&+0g zgv+H~zP#?@%Nwpc^m4)LaCFQvK*tpZ=y-zxI=;#P9gAMKBQot-lyJFSFUg%auead# zB0{C$t1Mt!hOcfhR4zLw%O=lHyQWV~2j6L zZJBv&HhyX6?3wx1+wMpnz*b4?x)`>i;6p#}McBwX=cH%KJ6$t9G~F`qU42I?16+mF zhKL=3mCAyzx)7)?1kvYXi7E>! z%1-Z}dS>3!Lhv*q8^R1lPRHgM?AyZSQVn0O z^z-G7O?hVKjYKNN5!db{(E zgv&w)-2)@I-0qN!krHE6UkKD-n25aJi=Ff<&1#aChiR-JvUWhpyBeT)8{Ag3P+NFwKC*nhFLY+j%xu z-SAZ|I6Xe^9hcYdS*)qt#aQp7UPN`+^A;8N# z55Oq{Ow_B)u9x|$7gtp-n+iN~Zge@Y0P!Qg?!H5pg$l2ui3SswOM8eTH7(Q=m7O(d znD7hkglUR7(9H7{6TKVEX4wS5>|UsEc62b#=-Sk};G*mLE^*yBPbt>Ag}GdMbbc4)R`zA

_Gpd6zY9FIhNOM3DLd*{GguviVdmoSWz2+nV5FX;e3s!B z>Z=^+5auOaiIC|^giKc=WL&v&TyJlX?%K+QLN9@EY%chMJTw?q9C+gNZ(6Jg-sPOE zoNk>=??e}uk$Z`p zXYHrp+l0YfCh&x=L0pb!hESAH?uNxc`7&-M+Ogw41_tSMh;gKL^f=Iv9UzsanR{k? zFV)W;ns3=+V%;WBf!0E(X8N(KK@i!IcOU*b$6g)*y3z>Hl}3QBGy=Ht2;h2qi#fA{ zSe*4k1;W6th1x{zdJhh=TQ;{z87uOi8-!1ithX^*VGwW$J{MVsXk^YAx*>E=h{Zt7 zZImDWZm4u(FOr_MQ15g+>>$OMu9tF)e1$+EbqA$X-XKk+=0>pYhOgm<7eo-4ItgVs QJKc5h>F?4QvElW<0D3xy#Q*>R literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/command_context.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/command_context.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a77ac2e9f15cbe420a21eb3d149891e8f58c362f GIT binary patch literal 1779 zcmZ`(O>7%g5T3VxUZ-|9sgt%u6gf>=Wh3EjL6HCjDp1Ig1RidR*gSf!WZG=)44$RxN-J}Xn+Ichc=FOY= zW@dj$r+Wa`!}r#v6%pVME_9aEX13o&W)&Q8ND0csBxS)A2$zMDSe8twESqv!F%<#= zP{k1)={tE%h;N$-0WN@}tbmi~>eQO5C;#FGx)3JcTyTR+fnEG4JXoxF0bK~nwr5|Z zOc%q0XJgI9SQ92MP>(V@sIV|ms8#9vHVXx-P|!)3ELP@h=GtCRjGvBaH;XBhKfydG zn8X27a1wQxCXTR@GDRvmgvyTi9NJ6^jvAajvsKDM)v{dA4J<3{MaC-INZQac9z>Ylqr)OdJ}pg$ zNy{phY~QympTC@4esaZ_sg$X~sx)AgIkz}t6e|ujF1miv$jwo2&M3K8jA|{Isdz8v zPQPUMZa`nGVllCRzEO3n21XE2=Gi5qSaR`tgjFY;T(!nDd}{IeeL&20(ooUD&mwue z4ENRajYLyDx~>jxW>3_mb@kZ&V<*4*urA$G2e;7%bTOaL?*U#x?J$1Zw~)L81iN4f zt|9;IV#3>SokY-gkCNQBTZpb2#?g-hUx=$Dng!%L{f)AK<>{K%@bS~&lX;w)%Xo{x zr+o|JWtb*HCw6rV%`#Q4vE@kVDy zIN@nCJ~vUQIPmdg7ipGLBI+b|fSYo{e>DC%B#&3%Z$XsxRu3rsEkTvX zZn}-pSDG)p`Up_i7CY)zzbKy}x4a*xnz@Ms^f_juPM@#If^$zJb^aZ}=zb>oEpzu;VE5D*7jpv_wM4132{n#+xwyyPT>Q VZWh+%{V3cvqqWHBRm3BY$E{DyhuRo^x9* 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 Gr~O|hVXTt? literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/main.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/main.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2834bd12f3a4d23b5d6341dd464bd30b478bd704 GIT binary patch literal 2298 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 S*k^(DvEq>*J<^f-8UG8)wq{HK literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/parser.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/parser.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..89e95ba82c9f9dacbbddbd9cc9e4a0d9cc908009 GIT binary patch literal 15064 zcmaibdvF`andc0E0RaL8K!OB8h>wvdN`%CR9+qTFmTXzFC0P;`Tedf5){8)xAqff( zdS)n!Fd1ue-diZqt;w}7q%X;t%KA#wIoW8hwrX`%S9MM{e|Yz*?g&v{awobAbDOI> z{|B4O+EK3R?)UY~fFuOlU1WF9bobXi{rDcgukl}MYN|PePo8^!;Lr|^`zLy^f?#G= zyLgV9;Uun~lX%IN;`@1)+WKuQwfEau>gac{ROlCw+EdPSReu#vZ5%0A+THI?SNB(^ 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/progress_bars.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/progress_bars.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..59e6463ed2db5762834b6adf1af231ca018f3572 GIT binary patch literal 3853 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/spinners.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/spinners.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4bd69ea090fbc11a9c2bdb40ac65fab14e47e5a0 GIT binary patch literal 7838 zcmb_hdu&wKnLqb6bLZh1zwH@=Jz#^G1ndw9ukvUJB$yDh8`9F4w6nw9J9x}Iyysrq z@vNhz6se|71#P2X6e{?Wh*nMiYFbrllK$C$JhhQW7gvk4snq>%$goPqR;&HKb070y z42`r0<~!$p=W);d&hLAi&wp%c@)9Ty{`pSwf7=N8PkgY8Y&FU!I6|%wg(zH_jF~kz z#<6F9jAyklCa_u@6QSnQQpPpr%DBhe8F@_RaE_4nWV~Zu))v#gjDO6}5uT|0MA&{| zrB(xX;GI~;f;@SJDAFaOxbE;4ubJ`Oz?0SHJA%b+VO$Szy;a;+#`OW$@62yg$;1|O zRy9?c)D9(}y47ZdQ@ErMg3hF<1TTqqtYKrFO7mEk(lXY)#tN;fOYOjUxQ^0ht5V-2mqa)gQ5E5Hc=!+ro~2nn>Nc8BO{TK&(vhsL z(qufL8ZN5pQ#3o8u;k7bMR}ui%bjd#-RZOCagqCw8~u z1-7WE>7<6UB9G1tkLNP#Fr8F&nww4~#)lI*MIC-Er6q=krq%59a5{B%cyd-B&t-QE zZGV1POX=#i$#~*?{G6%{Po^e^K?JZ}kj`)-of_86Ptb-YXW>QgkngDfsv%?t@dJE7 zE|As0hNVFNqTFAGM`HMsDOfC~fl#Nkgat0_0bD-y!>J#}&?X=s^0XP-9Y8dk8Hvyq zs0}bVVpml_{1A%2w7e}KmLypC=@r)Xa8QxedlT)VB*!IU_|2h>< zn>`dK8-k`&+KrRVHQ0Np2N;Y5prN69T_RnhmZ26)u6L z{4YQ%pz;v>r!*~s*=jIgdtu8o}{{xvf{cVjky&!Jj)sohz;m)X<2B&X`$y8c3ym*?i#CV))Mo$KsQ^?HbUuf2ybDyv^$>}HL9e$378Mp!~x-A$o zC)y?o`kgl_xW3C7jo4#l0ufSI=7g#hD(jL7XMSbE1cIxsD7@ZfvuuUT!%pVNgw3w1 z^UziVr1o3E6pOH1#4#(gBr1)*{D_O>rO43GP=umnqD_EC`y2#qRx@0huH>e4LyECe z@x2aba3YlfZKXz24D6U1OIwc~7=jw0DuxI9^;|Bk8B$_40mtc!ndiwKq#23>-0()j z6`M&Z`gl|_)oKIq=td;{NYKh@DDMasQ_($lV3Gd!g;dzc2MYR|q}#(av8V_|<_z=CE`*LR%dZwYyXM6o z`Iw@i@X**WO|P*y4o<&i;H;@GXo!;$*rR zdZRMk1{HlC$umf{12KfOnl+?kdP*CoTah7ARa5n-U}AA6vRr4uDNRjkXcQa>0%#Gz z`A{POvaV-gxb{6D7f7+K>)OGe99)z)ECx4}T%@&gLA>d^?klwP&%25>xaz#se_Q;e z??Yc<=5i^WBhTm*wX+p6F9%F*pk=GSq%_ag$y#m0@2zfYz)~oM`j80yHS^U zdiD{;m09{Vm}`hx^=+L#2Th7tFk=tXE26{9cQrU3G()>_@E#y=IKJSOgFiS}^tTp+ zZ7abIh2Vyj;9wy*xEzck6OPAs+4tU&h4z(Dv=E9ewLf!Le%AD(Xr*h^8Zm;u^2b1) zB32w%SLPgrVUQQ=y5X^rVk=Ld<+z*5iuQ4VTR@lRbXaQReFF?KQyCO=MP(>TjWXMc zxUftz3rZR)gXs|t!cgr+AT{zfMSJzcvb>=N!wc=pa&HZX+2!?MR|8D&pxAkF+go$P z=U_=FpB$nXl0ED`vJT05B#2dt(nd|s#dW#^8SJxINQMCw?L~rdnTehVwvb>b ztfhfmA|;vh4;I54?r(ekK~t;LeZQr>BtZ=t9qhVF7y5rZQwa2x+{ltiM|a7CEkD`( zY#E1_ws@ufg;OO0)vY(mSe3gaX=^Fql6o;pg9@WGsLYMv>l5&Eimg)R4Lyt8j} z8LB3#A&YJNmCv%x)J9q?E^;is?pTXC-qvk^oU$gf{Rux9lBI?j0kNS#-#^I6OC z##K3hhWF~R1?6Vudgk^w@5(!wh->_qgTiT8b4}^~Kl`z2gA2$6={0M5DxHqdscbft zJqOWrRIGR`dI0vugwxnbg&Ru@{nTj`*N`c$r~4^D;$p|(U3rTM#mBsp1I2GXU09BC z!ceP#Qga`GxA>WJkpbT!)cFo^G~a380wOaheLP}@z>&d6+~6Ak9j3F0lr@~ly2jEl z*ZdC5)1pA?{Rn<~*S6c~+u!+k`(np|W%*z+ROK%?%TbJe-ERql<6GU{?>F3 zFX1>Oufk6|2ILZXz>8AkmQW&4eX@yFi>FSP@v-C=q!$(vB?8qgrHobCD@oB(Kr{_M zRA~62G7k=yPQcG8qSY#6q*G=1nb}taF!3UoauHmBl;m07$ECR8S`OxZR)El#naBZ{ zYuWMYhz{EV{K^p^pg}b^=2|<>ux?%xd1GDd33qZxUZmriZrfwaVBijF3RRsJ@-q z5jRiKRGVK`A6lbdsQ(DKHRbRlF!2GIw{?-5BiBbhc(rn3rsB!_qY4`D3z>nL|t=A0zXJ6zVMW47@z zzK7_TTV&#0-RhEZ5p-!u5!;Rq%_;5oU8GZRA zy8r&mnORt)!X-G#p0OMQEP zcl!5l{pPJd^^L3!?D}YCY2eUh_vfvHx7|yv&&|6_yjSX5Z3^GmadY4GeM?Q79}vzH zF1Ch#@Yy!@nxj*Z1BWL5T zm%4>NbPK@GyL!$Xdj5s9RgbfrA4K`1wSSYqn1yNQmIm5MC561tA%0n+0^L|$vGt8^ z(nY(g(H+_zr_0VLM?-B6A?J?(jB4N6ROz)_I_BY7u{DjuEIN6g$DM-DX*37zX5Adr zuz!4XwJw-R6AwkxM$aHYxKr?4gnk`1(O66$rbo%xEjOif6GJ;t^y=v0>10aBdfM@98=m6g~?I(2j-;FZ>Naha?dEHHl)NYYxJIC(-6d}OU0Y(`9 zz%=CifoW(8!gp;bk;_a%dH|(n^fVe^*##@SdkuQ)} z76{+N29<_LFnqyR41_NDAR$s&Ajl0Y@C!SxyGsO`w?-C+4i*LueSr^b_5&VTERgv> D$D_}1 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/status_codes.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/cli/__pycache__/status_codes.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d7f110c51bb81289c1050c92b01e528c0933d7e9 GIT binary patch literal 373 zcmXw!!A`|h+qjMXXS`! zi6n33iDXIhLaVsq(G?$9#xx z?DQ2h!blt98_h($tZ}a^BULjEd~K@z9`337E?+?!9(0D?TgBLB-@%$)0vim+!Gyvn zq)8OaTxSfOfKWJaV+Xcp)Sp4meS+aU83+DF`|KRXZbDB(+j+HLXbeL)gxK{H8u_*d z9nXbvVkgrW^DS{ZoNr2(lYmS;dKFdKJ^pfh!tf&sf{>Q?7sa%+w~*3Gbs?wq#uC)h RBv$^bcZ0Xk7pR literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/cli/autocompletion.py b/.venv/lib/python3.12/site-packages/pip/_internal/cli/autocompletion.py new file mode 100644 index 0000000..f3f70ac --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/cli/autocompletion.py @@ -0,0 +1,176 @@ +"""Logic that powers autocompletion installed by ``pip completion``. +""" + +import optparse +import os +import sys +from itertools import chain +from typing import Any, Iterable, List, Optional + +from pip._internal.cli.main_parser import create_main_parser +from pip._internal.commands import commands_dict, create_command +from pip._internal.metadata import get_default_environment + + +def autocomplete() -> None: + """Entry Point for completion of main and subcommand options.""" + # Don't complete if user hasn't sourced bash_completion file. + if "PIP_AUTO_COMPLETE" not in os.environ: + return + # Don't complete if autocompletion environment variables + # are not present + if not os.environ.get("COMP_WORDS") or not os.environ.get("COMP_CWORD"): + return + cwords = os.environ["COMP_WORDS"].split()[1:] + cword = int(os.environ["COMP_CWORD"]) + try: + current = cwords[cword - 1] + except IndexError: + current = "" + + parser = create_main_parser() + subcommands = list(commands_dict) + options = [] + + # subcommand + subcommand_name: Optional[str] = None + for word in cwords: + if word in subcommands: + subcommand_name = word + break + # subcommand options + if subcommand_name is not None: + # special case: 'help' subcommand has no options + if subcommand_name == "help": + sys.exit(1) + # special case: list locally installed dists for show and uninstall + should_list_installed = not current.startswith("-") and subcommand_name in [ + "show", + "uninstall", + ] + if should_list_installed: + env = get_default_environment() + lc = current.lower() + installed = [ + dist.canonical_name + for dist in env.iter_installed_distributions(local_only=True) + if dist.canonical_name.startswith(lc) + and dist.canonical_name not in cwords[1:] + ] + # if there are no dists installed, fall back to option completion + if installed: + for dist in installed: + print(dist) + sys.exit(1) + + should_list_installables = ( + not current.startswith("-") and subcommand_name == "install" + ) + if should_list_installables: + for path in auto_complete_paths(current, "path"): + print(path) + sys.exit(1) + + subcommand = create_command(subcommand_name) + + for opt in subcommand.parser.option_list_all: + if opt.help != optparse.SUPPRESS_HELP: + options += [ + (opt_str, opt.nargs) for opt_str in opt._long_opts + opt._short_opts + ] + + # filter out previously specified options from available options + prev_opts = [x.split("=")[0] for x in cwords[1 : cword - 1]] + options = [(x, v) for (x, v) in options if x not in prev_opts] + # filter options by current input + options = [(k, v) for k, v in options if k.startswith(current)] + # get completion type given cwords and available subcommand options + completion_type = get_path_completion_type( + cwords, + cword, + subcommand.parser.option_list_all, + ) + # get completion files and directories if ``completion_type`` is + # ````, ```` or ```` + if completion_type: + paths = auto_complete_paths(current, completion_type) + options = [(path, 0) for path in paths] + for option in options: + opt_label = option[0] + # append '=' to options which require args + if option[1] and option[0][:2] == "--": + opt_label += "=" + print(opt_label) + else: + # show main parser options only when necessary + + opts = [i.option_list for i in parser.option_groups] + opts.append(parser.option_list) + flattened_opts = chain.from_iterable(opts) + if current.startswith("-"): + for opt in flattened_opts: + if opt.help != optparse.SUPPRESS_HELP: + subcommands += opt._long_opts + opt._short_opts + else: + # get completion type given cwords and all available options + completion_type = get_path_completion_type(cwords, cword, flattened_opts) + if completion_type: + subcommands = list(auto_complete_paths(current, completion_type)) + + print(" ".join([x for x in subcommands if x.startswith(current)])) + sys.exit(1) + + +def get_path_completion_type( + cwords: List[str], cword: int, opts: Iterable[Any] +) -> Optional[str]: + """Get the type of path completion (``file``, ``dir``, ``path`` or None) + + :param cwords: same as the environmental variable ``COMP_WORDS`` + :param cword: same as the environmental variable ``COMP_CWORD`` + :param opts: The available options to check + :return: path completion type (``file``, ``dir``, ``path`` or None) + """ + if cword < 2 or not cwords[cword - 2].startswith("-"): + return None + for opt in opts: + if opt.help == optparse.SUPPRESS_HELP: + continue + for o in str(opt).split("/"): + if cwords[cword - 2].split("=")[0] == o: + if not opt.metavar or any( + x in ("path", "file", "dir") for x in opt.metavar.split("/") + ): + return opt.metavar + return None + + +def auto_complete_paths(current: str, completion_type: str) -> Iterable[str]: + """If ``completion_type`` is ``file`` or ``path``, list all regular files + and directories starting with ``current``; otherwise only list directories + starting with ``current``. + + :param current: The word to be completed + :param completion_type: path completion type(``file``, ``path`` or ``dir``) + :return: A generator of regular files and/or directories + """ + directory, filename = os.path.split(current) + current_path = os.path.abspath(directory) + # Don't complete paths if they can't be accessed + if not os.access(current_path, os.R_OK): + return + filename = os.path.normcase(filename) + # list all files that start with ``filename`` + file_list = ( + x for x in os.listdir(current_path) if os.path.normcase(x).startswith(filename) + ) + for f in file_list: + opt = os.path.join(current_path, f) + comp_file = os.path.normcase(os.path.join(directory, f)) + # complete regular files when there is not ```` after option + # complete directories when there is ````, ```` or + # ````after option + if completion_type != "dir" and os.path.isfile(opt): + yield comp_file + elif os.path.isdir(opt): + yield os.path.join(comp_file, "") diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/cli/base_command.py b/.venv/lib/python3.12/site-packages/pip/_internal/cli/base_command.py new file mode 100644 index 0000000..bc1ab65 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/cli/base_command.py @@ -0,0 +1,231 @@ +"""Base Command class, and related routines""" + +import logging +import logging.config +import optparse +import os +import sys +import traceback +from optparse import Values +from typing import List, Optional, Tuple + +from pip._vendor.rich import reconfigure +from pip._vendor.rich import traceback as rich_traceback + +from pip._internal.cli import cmdoptions +from pip._internal.cli.command_context import CommandContextMixIn +from pip._internal.cli.parser import ConfigOptionParser, UpdatingDefaultsHelpFormatter +from pip._internal.cli.status_codes import ( + ERROR, + PREVIOUS_BUILD_DIR_ERROR, + UNKNOWN_ERROR, + VIRTUALENV_NOT_FOUND, +) +from pip._internal.exceptions import ( + BadCommand, + CommandError, + DiagnosticPipError, + InstallationError, + NetworkConnectionError, + PreviousBuildDirError, +) +from pip._internal.utils.filesystem import check_path_owner +from pip._internal.utils.logging import BrokenStdoutLoggingError, setup_logging +from pip._internal.utils.misc import get_prog, normalize_path +from pip._internal.utils.temp_dir import TempDirectoryTypeRegistry as TempDirRegistry +from pip._internal.utils.temp_dir import global_tempdir_manager, tempdir_registry +from pip._internal.utils.virtualenv import running_under_virtualenv + +__all__ = ["Command"] + +logger = logging.getLogger(__name__) + + +class Command(CommandContextMixIn): + usage: str = "" + ignore_require_venv: bool = False + + def __init__(self, name: str, summary: str, isolated: bool = False) -> None: + super().__init__() + + self.name = name + self.summary = summary + self.parser = ConfigOptionParser( + usage=self.usage, + prog=f"{get_prog()} {name}", + formatter=UpdatingDefaultsHelpFormatter(), + add_help_option=False, + name=name, + description=self.__doc__, + isolated=isolated, + ) + + self.tempdir_registry: Optional[TempDirRegistry] = None + + # Commands should add options to this option group + optgroup_name = f"{self.name.capitalize()} Options" + self.cmd_opts = optparse.OptionGroup(self.parser, optgroup_name) + + # Add the general options + gen_opts = cmdoptions.make_option_group( + cmdoptions.general_group, + self.parser, + ) + self.parser.add_option_group(gen_opts) + + self.add_options() + + def add_options(self) -> None: + pass + + def handle_pip_version_check(self, options: Values) -> None: + """ + This is a no-op so that commands by default do not do the pip version + check. + """ + # Make sure we do the pip version check if the index_group options + # are present. + assert not hasattr(options, "no_index") + + def run(self, options: Values, args: List[str]) -> int: + raise NotImplementedError + + def _run_wrapper(self, level_number: int, options: Values, args: List[str]) -> int: + def _inner_run() -> int: + try: + return self.run(options, args) + finally: + self.handle_pip_version_check(options) + + if options.debug_mode: + rich_traceback.install(show_locals=True) + return _inner_run() + + try: + status = _inner_run() + assert isinstance(status, int) + return status + except DiagnosticPipError as exc: + logger.error("%s", exc, extra={"rich": True}) + logger.debug("Exception information:", exc_info=True) + + return ERROR + except PreviousBuildDirError as exc: + logger.critical(str(exc)) + logger.debug("Exception information:", exc_info=True) + + return PREVIOUS_BUILD_DIR_ERROR + except ( + InstallationError, + BadCommand, + NetworkConnectionError, + ) as exc: + logger.critical(str(exc)) + logger.debug("Exception information:", exc_info=True) + + return ERROR + except CommandError as exc: + logger.critical("%s", exc) + logger.debug("Exception information:", exc_info=True) + + return ERROR + except BrokenStdoutLoggingError: + # Bypass our logger and write any remaining messages to + # stderr because stdout no longer works. + print("ERROR: Pipe to stdout was broken", file=sys.stderr) + if level_number <= logging.DEBUG: + traceback.print_exc(file=sys.stderr) + + return ERROR + except KeyboardInterrupt: + logger.critical("Operation cancelled by user") + logger.debug("Exception information:", exc_info=True) + + return ERROR + except BaseException: + logger.critical("Exception:", exc_info=True) + + return UNKNOWN_ERROR + + def parse_args(self, args: List[str]) -> Tuple[Values, List[str]]: + # factored out for testability + return self.parser.parse_args(args) + + def main(self, args: List[str]) -> int: + try: + with self.main_context(): + return self._main(args) + finally: + logging.shutdown() + + def _main(self, args: List[str]) -> int: + # We must initialize this before the tempdir manager, otherwise the + # configuration would not be accessible by the time we clean up the + # tempdir manager. + self.tempdir_registry = self.enter_context(tempdir_registry()) + # Intentionally set as early as possible so globally-managed temporary + # directories are available to the rest of the code. + self.enter_context(global_tempdir_manager()) + + options, args = self.parse_args(args) + + # Set verbosity so that it can be used elsewhere. + self.verbosity = options.verbose - options.quiet + + reconfigure(no_color=options.no_color) + level_number = setup_logging( + verbosity=self.verbosity, + no_color=options.no_color, + user_log_file=options.log, + ) + + always_enabled_features = set(options.features_enabled) & set( + cmdoptions.ALWAYS_ENABLED_FEATURES + ) + if always_enabled_features: + logger.warning( + "The following features are always enabled: %s. ", + ", ".join(sorted(always_enabled_features)), + ) + + # Make sure that the --python argument isn't specified after the + # subcommand. We can tell, because if --python was specified, + # we should only reach this point if we're running in the created + # subprocess, which has the _PIP_RUNNING_IN_SUBPROCESS environment + # variable set. + if options.python and "_PIP_RUNNING_IN_SUBPROCESS" not in os.environ: + logger.critical( + "The --python option must be placed before the pip subcommand name" + ) + sys.exit(ERROR) + + # TODO: Try to get these passing down from the command? + # without resorting to os.environ to hold these. + # This also affects isolated builds and it should. + + if options.no_input: + os.environ["PIP_NO_INPUT"] = "1" + + if options.exists_action: + os.environ["PIP_EXISTS_ACTION"] = " ".join(options.exists_action) + + if options.require_venv and not self.ignore_require_venv: + # If a venv is required check if it can really be found + if not running_under_virtualenv(): + logger.critical("Could not find an activated virtualenv (required).") + sys.exit(VIRTUALENV_NOT_FOUND) + + if options.cache_dir: + options.cache_dir = normalize_path(options.cache_dir) + if not check_path_owner(options.cache_dir): + logger.warning( + "The directory '%s' or its parent directory is not owned " + "or is not writable by the current user. The cache " + "has been disabled. Check the permissions and owner of " + "that directory. If executing pip with sudo, you should " + "use sudo's -H flag.", + options.cache_dir, + ) + options.cache_dir = None + + return self._run_wrapper(level_number, options, args) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/cli/cmdoptions.py b/.venv/lib/python3.12/site-packages/pip/_internal/cli/cmdoptions.py new file mode 100644 index 0000000..0b7cff7 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/cli/cmdoptions.py @@ -0,0 +1,1075 @@ +""" +shared options and groups + +The principle here is to define options once, but *not* instantiate them +globally. One reason being that options with action='append' can carry state +between parses. pip parses general options twice internally, and shouldn't +pass on state. To be consistent, all options will follow this design. +""" + +# The following comment should be removed at some point in the future. +# mypy: strict-optional=False + +import importlib.util +import logging +import os +import textwrap +from functools import partial +from optparse import SUPPRESS_HELP, Option, OptionGroup, OptionParser, Values +from textwrap import dedent +from typing import Any, Callable, Dict, Optional, Tuple + +from pip._vendor.packaging.utils import canonicalize_name + +from pip._internal.cli.parser import ConfigOptionParser +from pip._internal.exceptions import CommandError +from pip._internal.locations import USER_CACHE_DIR, get_src_prefix +from pip._internal.models.format_control import FormatControl +from pip._internal.models.index import PyPI +from pip._internal.models.target_python import TargetPython +from pip._internal.utils.hashes import STRONG_HASHES +from pip._internal.utils.misc import strtobool + +logger = logging.getLogger(__name__) + + +def raise_option_error(parser: OptionParser, option: Option, msg: str) -> None: + """ + Raise an option parsing error using parser.error(). + + Args: + parser: an OptionParser instance. + option: an Option instance. + msg: the error text. + """ + msg = f"{option} error: {msg}" + msg = textwrap.fill(" ".join(msg.split())) + parser.error(msg) + + +def make_option_group(group: Dict[str, Any], parser: ConfigOptionParser) -> OptionGroup: + """ + Return an OptionGroup object + group -- assumed to be dict with 'name' and 'options' keys + parser -- an optparse Parser + """ + option_group = OptionGroup(parser, group["name"]) + for option in group["options"]: + option_group.add_option(option()) + return option_group + + +def check_dist_restriction(options: Values, check_target: bool = False) -> None: + """Function for determining if custom platform options are allowed. + + :param options: The OptionParser options. + :param check_target: Whether or not to check if --target is being used. + """ + dist_restriction_set = any( + [ + options.python_version, + options.platforms, + options.abis, + options.implementation, + ] + ) + + binary_only = FormatControl(set(), {":all:"}) + sdist_dependencies_allowed = ( + options.format_control != binary_only and not options.ignore_dependencies + ) + + # Installations or downloads using dist restrictions must not combine + # source distributions and dist-specific wheels, as they are not + # guaranteed to be locally compatible. + if dist_restriction_set and sdist_dependencies_allowed: + raise CommandError( + "When restricting platform and interpreter constraints using " + "--python-version, --platform, --abi, or --implementation, " + "either --no-deps must be set, or --only-binary=:all: must be " + "set and --no-binary must not be set (or must be set to " + ":none:)." + ) + + if check_target: + if not options.dry_run and dist_restriction_set and not options.target_dir: + raise CommandError( + "Can not use any platform or abi specific options unless " + "installing via '--target' or using '--dry-run'" + ) + + +def _path_option_check(option: Option, opt: str, value: str) -> str: + return os.path.expanduser(value) + + +def _package_name_option_check(option: Option, opt: str, value: str) -> str: + return canonicalize_name(value) + + +class PipOption(Option): + TYPES = Option.TYPES + ("path", "package_name") + TYPE_CHECKER = Option.TYPE_CHECKER.copy() + TYPE_CHECKER["package_name"] = _package_name_option_check + TYPE_CHECKER["path"] = _path_option_check + + +########### +# options # +########### + +help_: Callable[..., Option] = partial( + Option, + "-h", + "--help", + dest="help", + action="help", + help="Show help.", +) + +debug_mode: Callable[..., Option] = partial( + Option, + "--debug", + dest="debug_mode", + action="store_true", + default=False, + help=( + "Let unhandled exceptions propagate outside the main subroutine, " + "instead of logging them to stderr." + ), +) + +isolated_mode: Callable[..., Option] = partial( + Option, + "--isolated", + dest="isolated_mode", + action="store_true", + default=False, + help=( + "Run pip in an isolated mode, ignoring environment variables and user " + "configuration." + ), +) + +require_virtualenv: Callable[..., Option] = partial( + Option, + "--require-virtualenv", + "--require-venv", + dest="require_venv", + action="store_true", + default=False, + help=( + "Allow pip to only run in a virtual environment; " + "exit with an error otherwise." + ), +) + +override_externally_managed: Callable[..., Option] = partial( + Option, + "--break-system-packages", + dest="override_externally_managed", + action="store_true", + help="Allow pip to modify an EXTERNALLY-MANAGED Python installation", +) + +python: Callable[..., Option] = partial( + Option, + "--python", + dest="python", + help="Run pip with the specified Python interpreter.", +) + +verbose: Callable[..., Option] = partial( + Option, + "-v", + "--verbose", + dest="verbose", + action="count", + default=0, + help="Give more output. Option is additive, and can be used up to 3 times.", +) + +no_color: Callable[..., Option] = partial( + Option, + "--no-color", + dest="no_color", + action="store_true", + default=False, + help="Suppress colored output.", +) + +version: Callable[..., Option] = partial( + Option, + "-V", + "--version", + dest="version", + action="store_true", + help="Show version and exit.", +) + +quiet: Callable[..., Option] = partial( + Option, + "-q", + "--quiet", + dest="quiet", + action="count", + default=0, + help=( + "Give less output. Option is additive, and can be used up to 3" + " times (corresponding to WARNING, ERROR, and CRITICAL logging" + " levels)." + ), +) + +progress_bar: Callable[..., Option] = partial( + Option, + "--progress-bar", + dest="progress_bar", + type="choice", + choices=["on", "off", "raw"], + default="on", + help="Specify whether the progress bar should be used [on, off, raw] (default: on)", +) + +log: Callable[..., Option] = partial( + PipOption, + "--log", + "--log-file", + "--local-log", + dest="log", + metavar="path", + type="path", + help="Path to a verbose appending log.", +) + +no_input: Callable[..., Option] = partial( + Option, + # Don't ask for input + "--no-input", + dest="no_input", + action="store_true", + default=False, + help="Disable prompting for input.", +) + +keyring_provider: Callable[..., Option] = partial( + Option, + "--keyring-provider", + dest="keyring_provider", + choices=["auto", "disabled", "import", "subprocess"], + default="auto", + help=( + "Enable the credential lookup via the keyring library if user input is allowed." + " Specify which mechanism to use [disabled, import, subprocess]." + " (default: disabled)" + ), +) + +proxy: Callable[..., Option] = partial( + Option, + "--proxy", + dest="proxy", + type="str", + default="", + help="Specify a proxy in the form scheme://[user:passwd@]proxy.server:port.", +) + +retries: Callable[..., Option] = partial( + Option, + "--retries", + dest="retries", + type="int", + default=5, + help="Maximum number of retries each connection should attempt " + "(default %default times).", +) + +timeout: Callable[..., Option] = partial( + Option, + "--timeout", + "--default-timeout", + metavar="sec", + dest="timeout", + type="float", + default=15, + help="Set the socket timeout (default %default seconds).", +) + + +def exists_action() -> Option: + return Option( + # Option when path already exist + "--exists-action", + dest="exists_action", + type="choice", + choices=["s", "i", "w", "b", "a"], + default=[], + action="append", + metavar="action", + help="Default action when a path already exists: " + "(s)witch, (i)gnore, (w)ipe, (b)ackup, (a)bort.", + ) + + +cert: Callable[..., Option] = partial( + PipOption, + "--cert", + dest="cert", + type="path", + metavar="path", + help=( + "Path to PEM-encoded CA certificate bundle. " + "If provided, overrides the default. " + "See 'SSL Certificate Verification' in pip documentation " + "for more information." + ), +) + +client_cert: Callable[..., Option] = partial( + PipOption, + "--client-cert", + dest="client_cert", + type="path", + default=None, + metavar="path", + help="Path to SSL client certificate, a single file containing the " + "private key and the certificate in PEM format.", +) + +index_url: Callable[..., Option] = partial( + Option, + "-i", + "--index-url", + "--pypi-url", + dest="index_url", + metavar="URL", + default=PyPI.simple_url, + help="Base URL of the Python Package Index (default %default). " + "This should point to a repository compliant with PEP 503 " + "(the simple repository API) or a local directory laid out " + "in the same format.", +) + + +def extra_index_url() -> Option: + return Option( + "--extra-index-url", + dest="extra_index_urls", + metavar="URL", + action="append", + default=[], + help="Extra URLs of package indexes to use in addition to " + "--index-url. Should follow the same rules as " + "--index-url.", + ) + + +no_index: Callable[..., Option] = partial( + Option, + "--no-index", + dest="no_index", + action="store_true", + default=False, + help="Ignore package index (only looking at --find-links URLs instead).", +) + + +def find_links() -> Option: + return Option( + "-f", + "--find-links", + dest="find_links", + action="append", + default=[], + metavar="url", + help="If a URL or path to an html file, then parse for links to " + "archives such as sdist (.tar.gz) or wheel (.whl) files. " + "If a local path or file:// URL that's a directory, " + "then look for archives in the directory listing. " + "Links to VCS project URLs are not supported.", + ) + + +def trusted_host() -> Option: + return Option( + "--trusted-host", + dest="trusted_hosts", + action="append", + metavar="HOSTNAME", + default=[], + help="Mark this host or host:port pair as trusted, even though it " + "does not have valid or any HTTPS.", + ) + + +def constraints() -> Option: + return Option( + "-c", + "--constraint", + dest="constraints", + action="append", + default=[], + metavar="file", + help="Constrain versions using the given constraints file. " + "This option can be used multiple times.", + ) + + +def requirements() -> Option: + return Option( + "-r", + "--requirement", + dest="requirements", + action="append", + default=[], + metavar="file", + help="Install from the given requirements file. " + "This option can be used multiple times.", + ) + + +def editable() -> Option: + return Option( + "-e", + "--editable", + dest="editables", + action="append", + default=[], + metavar="path/url", + help=( + "Install a project in editable mode (i.e. setuptools " + '"develop mode") from a local project path or a VCS url.' + ), + ) + + +def _handle_src(option: Option, opt_str: str, value: str, parser: OptionParser) -> None: + value = os.path.abspath(value) + setattr(parser.values, option.dest, value) + + +src: Callable[..., Option] = partial( + PipOption, + "--src", + "--source", + "--source-dir", + "--source-directory", + dest="src_dir", + type="path", + metavar="dir", + default=get_src_prefix(), + action="callback", + callback=_handle_src, + help="Directory to check out editable projects into. " + 'The default in a virtualenv is "/src". ' + 'The default for global installs is "/src".', +) + + +def _get_format_control(values: Values, option: Option) -> Any: + """Get a format_control object.""" + return getattr(values, option.dest) + + +def _handle_no_binary( + option: Option, opt_str: str, value: str, parser: OptionParser +) -> None: + existing = _get_format_control(parser.values, option) + FormatControl.handle_mutual_excludes( + value, + existing.no_binary, + existing.only_binary, + ) + + +def _handle_only_binary( + option: Option, opt_str: str, value: str, parser: OptionParser +) -> None: + existing = _get_format_control(parser.values, option) + FormatControl.handle_mutual_excludes( + value, + existing.only_binary, + existing.no_binary, + ) + + +def no_binary() -> Option: + format_control = FormatControl(set(), set()) + return Option( + "--no-binary", + dest="format_control", + action="callback", + callback=_handle_no_binary, + type="str", + default=format_control, + help="Do not use binary packages. Can be supplied multiple times, and " + 'each time adds to the existing value. Accepts either ":all:" to ' + 'disable all binary packages, ":none:" to empty the set (notice ' + "the colons), or one or more package names with commas between " + "them (no colons). Note that some packages are tricky to compile " + "and may fail to install when this option is used on them.", + ) + + +def only_binary() -> Option: + format_control = FormatControl(set(), set()) + return Option( + "--only-binary", + dest="format_control", + action="callback", + callback=_handle_only_binary, + type="str", + default=format_control, + help="Do not use source packages. Can be supplied multiple times, and " + 'each time adds to the existing value. Accepts either ":all:" to ' + 'disable all source packages, ":none:" to empty the set, or one ' + "or more package names with commas between them. Packages " + "without binary distributions will fail to install when this " + "option is used on them.", + ) + + +platforms: Callable[..., Option] = partial( + Option, + "--platform", + dest="platforms", + metavar="platform", + action="append", + default=None, + help=( + "Only use wheels compatible with . Defaults to the " + "platform of the running system. Use this option multiple times to " + "specify multiple platforms supported by the target interpreter." + ), +) + + +# This was made a separate function for unit-testing purposes. +def _convert_python_version(value: str) -> Tuple[Tuple[int, ...], Optional[str]]: + """ + Convert a version string like "3", "37", or "3.7.3" into a tuple of ints. + + :return: A 2-tuple (version_info, error_msg), where `error_msg` is + non-None if and only if there was a parsing error. + """ + if not value: + # The empty string is the same as not providing a value. + return (None, None) + + parts = value.split(".") + if len(parts) > 3: + return ((), "at most three version parts are allowed") + + if len(parts) == 1: + # Then we are in the case of "3" or "37". + value = parts[0] + if len(value) > 1: + parts = [value[0], value[1:]] + + try: + version_info = tuple(int(part) for part in parts) + except ValueError: + return ((), "each version part must be an integer") + + return (version_info, None) + + +def _handle_python_version( + option: Option, opt_str: str, value: str, parser: OptionParser +) -> None: + """ + Handle a provided --python-version value. + """ + version_info, error_msg = _convert_python_version(value) + if error_msg is not None: + msg = f"invalid --python-version value: {value!r}: {error_msg}" + raise_option_error(parser, option=option, msg=msg) + + parser.values.python_version = version_info + + +python_version: Callable[..., Option] = partial( + Option, + "--python-version", + dest="python_version", + metavar="python_version", + action="callback", + callback=_handle_python_version, + type="str", + default=None, + help=dedent( + """\ + The Python interpreter version to use for wheel and "Requires-Python" + compatibility checks. Defaults to a version derived from the running + interpreter. The version can be specified using up to three dot-separated + integers (e.g. "3" for 3.0.0, "3.7" for 3.7.0, or "3.7.3"). A major-minor + version can also be given as a string without dots (e.g. "37" for 3.7.0). + """ + ), +) + + +implementation: Callable[..., Option] = partial( + Option, + "--implementation", + dest="implementation", + metavar="implementation", + default=None, + help=( + "Only use wheels compatible with Python " + "implementation , e.g. 'pp', 'jy', 'cp', " + " or 'ip'. If not specified, then the current " + "interpreter implementation is used. Use 'py' to force " + "implementation-agnostic wheels." + ), +) + + +abis: Callable[..., Option] = partial( + Option, + "--abi", + dest="abis", + metavar="abi", + action="append", + default=None, + help=( + "Only use wheels compatible with Python abi , e.g. 'pypy_41'. " + "If not specified, then the current interpreter abi tag is used. " + "Use this option multiple times to specify multiple abis supported " + "by the target interpreter. Generally you will need to specify " + "--implementation, --platform, and --python-version when using this " + "option." + ), +) + + +def add_target_python_options(cmd_opts: OptionGroup) -> None: + cmd_opts.add_option(platforms()) + cmd_opts.add_option(python_version()) + cmd_opts.add_option(implementation()) + cmd_opts.add_option(abis()) + + +def make_target_python(options: Values) -> TargetPython: + target_python = TargetPython( + platforms=options.platforms, + py_version_info=options.python_version, + abis=options.abis, + implementation=options.implementation, + ) + + return target_python + + +def prefer_binary() -> Option: + return Option( + "--prefer-binary", + dest="prefer_binary", + action="store_true", + default=False, + help=( + "Prefer binary packages over source packages, even if the " + "source packages are newer." + ), + ) + + +cache_dir: Callable[..., Option] = partial( + PipOption, + "--cache-dir", + dest="cache_dir", + default=USER_CACHE_DIR, + metavar="dir", + type="path", + help="Store the cache data in .", +) + + +def _handle_no_cache_dir( + option: Option, opt: str, value: str, parser: OptionParser +) -> None: + """ + Process a value provided for the --no-cache-dir option. + + This is an optparse.Option callback for the --no-cache-dir option. + """ + # The value argument will be None if --no-cache-dir is passed via the + # command-line, since the option doesn't accept arguments. However, + # the value can be non-None if the option is triggered e.g. by an + # environment variable, like PIP_NO_CACHE_DIR=true. + if value is not None: + # Then parse the string value to get argument error-checking. + try: + strtobool(value) + except ValueError as exc: + raise_option_error(parser, option=option, msg=str(exc)) + + # Originally, setting PIP_NO_CACHE_DIR to a value that strtobool() + # converted to 0 (like "false" or "no") caused cache_dir to be disabled + # rather than enabled (logic would say the latter). Thus, we disable + # the cache directory not just on values that parse to True, but (for + # backwards compatibility reasons) also on values that parse to False. + # In other words, always set it to False if the option is provided in + # some (valid) form. + parser.values.cache_dir = False + + +no_cache: Callable[..., Option] = partial( + Option, + "--no-cache-dir", + dest="cache_dir", + action="callback", + callback=_handle_no_cache_dir, + help="Disable the cache.", +) + +no_deps: Callable[..., Option] = partial( + Option, + "--no-deps", + "--no-dependencies", + dest="ignore_dependencies", + action="store_true", + default=False, + help="Don't install package dependencies.", +) + +ignore_requires_python: Callable[..., Option] = partial( + Option, + "--ignore-requires-python", + dest="ignore_requires_python", + action="store_true", + help="Ignore the Requires-Python information.", +) + +no_build_isolation: Callable[..., Option] = partial( + Option, + "--no-build-isolation", + dest="build_isolation", + action="store_false", + default=True, + help="Disable isolation when building a modern source distribution. " + "Build dependencies specified by PEP 518 must be already installed " + "if this option is used.", +) + +check_build_deps: Callable[..., Option] = partial( + Option, + "--check-build-dependencies", + dest="check_build_deps", + action="store_true", + default=False, + help="Check the build dependencies when PEP517 is used.", +) + + +def _handle_no_use_pep517( + option: Option, opt: str, value: str, parser: OptionParser +) -> None: + """ + Process a value provided for the --no-use-pep517 option. + + This is an optparse.Option callback for the no_use_pep517 option. + """ + # Since --no-use-pep517 doesn't accept arguments, the value argument + # will be None if --no-use-pep517 is passed via the command-line. + # However, the value can be non-None if the option is triggered e.g. + # by an environment variable, for example "PIP_NO_USE_PEP517=true". + if value is not None: + msg = """A value was passed for --no-use-pep517, + probably using either the PIP_NO_USE_PEP517 environment variable + or the "no-use-pep517" config file option. Use an appropriate value + of the PIP_USE_PEP517 environment variable or the "use-pep517" + config file option instead. + """ + raise_option_error(parser, option=option, msg=msg) + + # If user doesn't wish to use pep517, we check if setuptools and wheel are installed + # and raise error if it is not. + packages = ("setuptools", "wheel") + if not all(importlib.util.find_spec(package) for package in packages): + msg = ( + f"It is not possible to use --no-use-pep517 " + f"without {' and '.join(packages)} installed." + ) + raise_option_error(parser, option=option, msg=msg) + + # Otherwise, --no-use-pep517 was passed via the command-line. + parser.values.use_pep517 = False + + +use_pep517: Any = partial( + Option, + "--use-pep517", + dest="use_pep517", + action="store_true", + default=None, + help="Use PEP 517 for building source distributions " + "(use --no-use-pep517 to force legacy behaviour).", +) + +no_use_pep517: Any = partial( + Option, + "--no-use-pep517", + dest="use_pep517", + action="callback", + callback=_handle_no_use_pep517, + default=None, + help=SUPPRESS_HELP, +) + + +def _handle_config_settings( + option: Option, opt_str: str, value: str, parser: OptionParser +) -> None: + key, sep, val = value.partition("=") + if sep != "=": + parser.error(f"Arguments to {opt_str} must be of the form KEY=VAL") + dest = getattr(parser.values, option.dest) + if dest is None: + dest = {} + setattr(parser.values, option.dest, dest) + if key in dest: + if isinstance(dest[key], list): + dest[key].append(val) + else: + dest[key] = [dest[key], val] + else: + dest[key] = val + + +config_settings: Callable[..., Option] = partial( + Option, + "-C", + "--config-settings", + dest="config_settings", + type=str, + action="callback", + callback=_handle_config_settings, + metavar="settings", + help="Configuration settings to be passed to the PEP 517 build backend. " + "Settings take the form KEY=VALUE. Use multiple --config-settings options " + "to pass multiple keys to the backend.", +) + +build_options: Callable[..., Option] = partial( + Option, + "--build-option", + dest="build_options", + metavar="options", + action="append", + help="Extra arguments to be supplied to 'setup.py bdist_wheel'.", +) + +global_options: Callable[..., Option] = partial( + Option, + "--global-option", + dest="global_options", + action="append", + metavar="options", + help="Extra global options to be supplied to the setup.py " + "call before the install or bdist_wheel command.", +) + +no_clean: Callable[..., Option] = partial( + Option, + "--no-clean", + action="store_true", + default=False, + help="Don't clean up build directories.", +) + +pre: Callable[..., Option] = partial( + Option, + "--pre", + action="store_true", + default=False, + help="Include pre-release and development versions. By default, " + "pip only finds stable versions.", +) + +disable_pip_version_check: Callable[..., Option] = partial( + Option, + "--disable-pip-version-check", + dest="disable_pip_version_check", + action="store_true", + default=False, + help="Don't periodically check PyPI to determine whether a new version " + "of pip is available for download. Implied with --no-index.", +) + +root_user_action: Callable[..., Option] = partial( + Option, + "--root-user-action", + dest="root_user_action", + default="warn", + choices=["warn", "ignore"], + help="Action if pip is run as a root user [warn, ignore] (default: warn)", +) + + +def _handle_merge_hash( + option: Option, opt_str: str, value: str, parser: OptionParser +) -> None: + """Given a value spelled "algo:digest", append the digest to a list + pointed to in a dict by the algo name.""" + if not parser.values.hashes: + parser.values.hashes = {} + try: + algo, digest = value.split(":", 1) + except ValueError: + parser.error( + f"Arguments to {opt_str} must be a hash name " + "followed by a value, like --hash=sha256:" + "abcde..." + ) + if algo not in STRONG_HASHES: + parser.error( + "Allowed hash algorithms for {} are {}.".format( + opt_str, ", ".join(STRONG_HASHES) + ) + ) + parser.values.hashes.setdefault(algo, []).append(digest) + + +hash: Callable[..., Option] = partial( + Option, + "--hash", + # Hash values eventually end up in InstallRequirement.hashes due to + # __dict__ copying in process_line(). + dest="hashes", + action="callback", + callback=_handle_merge_hash, + type="string", + help="Verify that the package's archive matches this " + "hash before installing. Example: --hash=sha256:abcdef...", +) + + +require_hashes: Callable[..., Option] = partial( + Option, + "--require-hashes", + dest="require_hashes", + action="store_true", + default=False, + help="Require a hash to check each requirement against, for " + "repeatable installs. This option is implied when any package in a " + "requirements file has a --hash option.", +) + + +list_path: Callable[..., Option] = partial( + PipOption, + "--path", + dest="path", + type="path", + action="append", + help="Restrict to the specified installation path for listing " + "packages (can be used multiple times).", +) + + +def check_list_path_option(options: Values) -> None: + if options.path and (options.user or options.local): + raise CommandError("Cannot combine '--path' with '--user' or '--local'") + + +list_exclude: Callable[..., Option] = partial( + PipOption, + "--exclude", + dest="excludes", + action="append", + metavar="package", + type="package_name", + help="Exclude specified package from the output", +) + + +no_python_version_warning: Callable[..., Option] = partial( + Option, + "--no-python-version-warning", + dest="no_python_version_warning", + action="store_true", + default=False, + help="Silence deprecation warnings for upcoming unsupported Pythons.", +) + + +# Features that are now always on. A warning is printed if they are used. +ALWAYS_ENABLED_FEATURES = [ + "truststore", # always on since 24.2 + "no-binary-enable-wheel-cache", # always on since 23.1 +] + +use_new_feature: Callable[..., Option] = partial( + Option, + "--use-feature", + dest="features_enabled", + metavar="feature", + action="append", + default=[], + choices=[ + "fast-deps", + ] + + ALWAYS_ENABLED_FEATURES, + help="Enable new functionality, that may be backward incompatible.", +) + +use_deprecated_feature: Callable[..., Option] = partial( + Option, + "--use-deprecated", + dest="deprecated_features_enabled", + metavar="feature", + action="append", + default=[], + choices=[ + "legacy-resolver", + "legacy-certs", + ], + help=("Enable deprecated functionality, that will be removed in the future."), +) + + +########## +# groups # +########## + +general_group: Dict[str, Any] = { + "name": "General Options", + "options": [ + help_, + debug_mode, + isolated_mode, + require_virtualenv, + python, + verbose, + version, + quiet, + log, + no_input, + keyring_provider, + proxy, + retries, + timeout, + exists_action, + trusted_host, + cert, + client_cert, + cache_dir, + no_cache, + disable_pip_version_check, + no_color, + no_python_version_warning, + use_new_feature, + use_deprecated_feature, + ], +} + +index_group: Dict[str, Any] = { + "name": "Package Index Options", + "options": [ + index_url, + extra_index_url, + no_index, + find_links, + ], +} diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/cli/command_context.py b/.venv/lib/python3.12/site-packages/pip/_internal/cli/command_context.py new file mode 100644 index 0000000..139995a --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/cli/command_context.py @@ -0,0 +1,27 @@ +from contextlib import ExitStack, contextmanager +from typing import ContextManager, Generator, TypeVar + +_T = TypeVar("_T", covariant=True) + + +class CommandContextMixIn: + def __init__(self) -> None: + super().__init__() + self._in_main_context = False + self._main_context = ExitStack() + + @contextmanager + def main_context(self) -> Generator[None, None, None]: + assert not self._in_main_context + + self._in_main_context = True + try: + with self._main_context: + yield + finally: + self._in_main_context = False + + def enter_context(self, context_provider: ContextManager[_T]) -> _T: + assert self._in_main_context + + return self._main_context.enter_context(context_provider) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/cli/index_command.py b/.venv/lib/python3.12/site-packages/pip/_internal/cli/index_command.py new file mode 100644 index 0000000..226f8da --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/cli/index_command.py @@ -0,0 +1,170 @@ +""" +Contains command classes which may interact with an index / the network. + +Unlike its sister module, req_command, this module still uses lazy imports +so commands which don't always hit the network (e.g. list w/o --outdated or +--uptodate) don't need waste time importing PipSession and friends. +""" + +import logging +import os +import sys +from optparse import Values +from typing import TYPE_CHECKING, List, Optional + +from pip._vendor import certifi + +from pip._internal.cli.base_command import Command +from pip._internal.cli.command_context import CommandContextMixIn + +if TYPE_CHECKING: + from ssl import SSLContext + + from pip._internal.network.session import PipSession + +logger = logging.getLogger(__name__) + + +def _create_truststore_ssl_context() -> Optional["SSLContext"]: + if sys.version_info < (3, 10): + logger.debug("Disabling truststore because Python version isn't 3.10+") + return None + + try: + import ssl + except ImportError: + logger.warning("Disabling truststore since ssl support is missing") + return None + + try: + from pip._vendor import truststore + except ImportError: + logger.warning("Disabling truststore because platform isn't supported") + return None + + ctx = truststore.SSLContext(ssl.PROTOCOL_TLS_CLIENT) + ctx.load_verify_locations(certifi.where()) + return ctx + + +class SessionCommandMixin(CommandContextMixIn): + """ + A class mixin for command classes needing _build_session(). + """ + + def __init__(self) -> None: + super().__init__() + self._session: Optional["PipSession"] = None + + @classmethod + def _get_index_urls(cls, options: Values) -> Optional[List[str]]: + """Return a list of index urls from user-provided options.""" + index_urls = [] + if not getattr(options, "no_index", False): + url = getattr(options, "index_url", None) + if url: + index_urls.append(url) + urls = getattr(options, "extra_index_urls", None) + if urls: + index_urls.extend(urls) + # Return None rather than an empty list + return index_urls or None + + def get_default_session(self, options: Values) -> "PipSession": + """Get a default-managed session.""" + if self._session is None: + self._session = self.enter_context(self._build_session(options)) + # there's no type annotation on requests.Session, so it's + # automatically ContextManager[Any] and self._session becomes Any, + # then https://github.com/python/mypy/issues/7696 kicks in + assert self._session is not None + return self._session + + def _build_session( + self, + options: Values, + retries: Optional[int] = None, + timeout: Optional[int] = None, + ) -> "PipSession": + from pip._internal.network.session import PipSession + + cache_dir = options.cache_dir + assert not cache_dir or os.path.isabs(cache_dir) + + if "legacy-certs" not in options.deprecated_features_enabled: + ssl_context = _create_truststore_ssl_context() + else: + ssl_context = None + + session = PipSession( + cache=os.path.join(cache_dir, "http-v2") if cache_dir else None, + retries=retries if retries is not None else options.retries, + trusted_hosts=options.trusted_hosts, + index_urls=self._get_index_urls(options), + ssl_context=ssl_context, + ) + + # Handle custom ca-bundles from the user + if options.cert: + session.verify = options.cert + + # Handle SSL client certificate + if options.client_cert: + session.cert = options.client_cert + + # Handle timeouts + if options.timeout or timeout: + session.timeout = timeout if timeout is not None else options.timeout + + # Handle configured proxies + if options.proxy: + session.proxies = { + "http": options.proxy, + "https": options.proxy, + } + session.trust_env = False + + # Determine if we can prompt the user for authentication or not + session.auth.prompting = not options.no_input + session.auth.keyring_provider = options.keyring_provider + + return session + + +def _pip_self_version_check(session: "PipSession", options: Values) -> None: + from pip._internal.self_outdated_check import pip_self_version_check as check + + check(session, options) + + +class IndexGroupCommand(Command, SessionCommandMixin): + """ + Abstract base class for commands with the index_group options. + + This also corresponds to the commands that permit the pip version check. + """ + + def handle_pip_version_check(self, options: Values) -> None: + """ + Do the pip version check if not disabled. + + This overrides the default behavior of not doing the check. + """ + # Make sure the index_group options are present. + assert hasattr(options, "no_index") + + if options.disable_pip_version_check or options.no_index: + return + + try: + # Otherwise, check if we're using the latest version of pip available. + session = self._build_session( + options, + retries=0, + timeout=min(5, options.timeout), + ) + with session: + _pip_self_version_check(session, options) + except Exception: + logger.warning("There was an error checking the latest version of pip.") + logger.debug("See below for error", exc_info=True) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/cli/main.py b/.venv/lib/python3.12/site-packages/pip/_internal/cli/main.py new file mode 100644 index 0000000..563ac79 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/cli/main.py @@ -0,0 +1,80 @@ +"""Primary application entrypoint. +""" + +import locale +import logging +import os +import sys +import warnings +from typing import List, Optional + +from pip._internal.cli.autocompletion import autocomplete +from pip._internal.cli.main_parser import parse_command +from pip._internal.commands import create_command +from pip._internal.exceptions import PipError +from pip._internal.utils import deprecation + +logger = logging.getLogger(__name__) + + +# Do not import and use main() directly! Using it directly is actively +# discouraged by pip's maintainers. The name, location and behavior of +# this function is subject to change, so calling it directly is not +# portable across different pip versions. + +# In addition, running pip in-process is unsupported and unsafe. This is +# elaborated in detail at +# https://pip.pypa.io/en/stable/user_guide/#using-pip-from-your-program. +# That document also provides suggestions that should work for nearly +# all users that are considering importing and using main() directly. + +# However, we know that certain users will still want to invoke pip +# in-process. If you understand and accept the implications of using pip +# in an unsupported manner, the best approach is to use runpy to avoid +# depending on the exact location of this entry point. + +# The following example shows how to use runpy to invoke pip in that +# case: +# +# sys.argv = ["pip", your, args, here] +# runpy.run_module("pip", run_name="__main__") +# +# Note that this will exit the process after running, unlike a direct +# call to main. As it is not safe to do any processing after calling +# main, this should not be an issue in practice. + + +def main(args: Optional[List[str]] = None) -> int: + if args is None: + args = sys.argv[1:] + + # Suppress the pkg_resources deprecation warning + # Note - we use a module of .*pkg_resources to cover + # the normal case (pip._vendor.pkg_resources) and the + # devendored case (a bare pkg_resources) + warnings.filterwarnings( + action="ignore", category=DeprecationWarning, module=".*pkg_resources" + ) + + # Configure our deprecation warnings to be sent through loggers + deprecation.install_warning_logger() + + autocomplete() + + try: + cmd_name, cmd_args = parse_command(args) + except PipError as exc: + sys.stderr.write(f"ERROR: {exc}") + sys.stderr.write(os.linesep) + sys.exit(1) + + # Needed for locale.getpreferredencoding(False) to work + # in pip._internal.utils.encoding.auto_decode + try: + locale.setlocale(locale.LC_ALL, "") + except locale.Error as e: + # setlocale can apparently crash if locale are uninitialized + logger.debug("Ignoring error %s when setting locale", e) + command = create_command(cmd_name, isolated=("--isolated" in cmd_args)) + + return command.main(cmd_args) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/cli/main_parser.py b/.venv/lib/python3.12/site-packages/pip/_internal/cli/main_parser.py new file mode 100644 index 0000000..5ade356 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/cli/main_parser.py @@ -0,0 +1,134 @@ +"""A single place for constructing and exposing the main parser +""" + +import os +import subprocess +import sys +from typing import List, Optional, Tuple + +from pip._internal.build_env import get_runnable_pip +from pip._internal.cli import cmdoptions +from pip._internal.cli.parser import ConfigOptionParser, UpdatingDefaultsHelpFormatter +from pip._internal.commands import commands_dict, get_similar_commands +from pip._internal.exceptions import CommandError +from pip._internal.utils.misc import get_pip_version, get_prog + +__all__ = ["create_main_parser", "parse_command"] + + +def create_main_parser() -> ConfigOptionParser: + """Creates and returns the main parser for pip's CLI""" + + parser = ConfigOptionParser( + usage="\n%prog [options]", + add_help_option=False, + formatter=UpdatingDefaultsHelpFormatter(), + name="global", + prog=get_prog(), + ) + parser.disable_interspersed_args() + + parser.version = get_pip_version() + + # add the general options + gen_opts = cmdoptions.make_option_group(cmdoptions.general_group, parser) + parser.add_option_group(gen_opts) + + # so the help formatter knows + parser.main = True # type: ignore + + # create command listing for description + description = [""] + [ + f"{name:27} {command_info.summary}" + for name, command_info in commands_dict.items() + ] + parser.description = "\n".join(description) + + return parser + + +def identify_python_interpreter(python: str) -> Optional[str]: + # If the named file exists, use it. + # If it's a directory, assume it's a virtual environment and + # look for the environment's Python executable. + if os.path.exists(python): + if os.path.isdir(python): + # bin/python for Unix, Scripts/python.exe for Windows + # Try both in case of odd cases like cygwin. + for exe in ("bin/python", "Scripts/python.exe"): + py = os.path.join(python, exe) + if os.path.exists(py): + return py + else: + return python + + # Could not find the interpreter specified + return None + + +def parse_command(args: List[str]) -> Tuple[str, List[str]]: + parser = create_main_parser() + + # Note: parser calls disable_interspersed_args(), so the result of this + # call is to split the initial args into the general options before the + # subcommand and everything else. + # For example: + # args: ['--timeout=5', 'install', '--user', 'INITools'] + # general_options: ['--timeout==5'] + # args_else: ['install', '--user', 'INITools'] + general_options, args_else = parser.parse_args(args) + + # --python + if general_options.python and "_PIP_RUNNING_IN_SUBPROCESS" not in os.environ: + # Re-invoke pip using the specified Python interpreter + interpreter = identify_python_interpreter(general_options.python) + if interpreter is None: + raise CommandError( + f"Could not locate Python interpreter {general_options.python}" + ) + + pip_cmd = [ + interpreter, + get_runnable_pip(), + ] + pip_cmd.extend(args) + + # Set a flag so the child doesn't re-invoke itself, causing + # an infinite loop. + os.environ["_PIP_RUNNING_IN_SUBPROCESS"] = "1" + returncode = 0 + try: + proc = subprocess.run(pip_cmd) + returncode = proc.returncode + except (subprocess.SubprocessError, OSError) as exc: + raise CommandError(f"Failed to run pip under {interpreter}: {exc}") + sys.exit(returncode) + + # --version + if general_options.version: + sys.stdout.write(parser.version) + sys.stdout.write(os.linesep) + sys.exit() + + # pip || pip help -> print_help() + if not args_else or (args_else[0] == "help" and len(args_else) == 1): + parser.print_help() + sys.exit() + + # the subcommand name + cmd_name = args_else[0] + + if cmd_name not in commands_dict: + guess = get_similar_commands(cmd_name) + + msg = [f'unknown command "{cmd_name}"'] + if guess: + msg.append(f'maybe you meant "{guess}"') + + raise CommandError(" - ".join(msg)) + + # all the args without the subcommand + cmd_args = args[:] + cmd_args.remove(cmd_name) + + return cmd_name, cmd_args diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/cli/parser.py b/.venv/lib/python3.12/site-packages/pip/_internal/cli/parser.py new file mode 100644 index 0000000..b7d7c1f --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/cli/parser.py @@ -0,0 +1,294 @@ +"""Base option parser setup""" + +import logging +import optparse +import shutil +import sys +import textwrap +from contextlib import suppress +from typing import Any, Dict, Generator, List, Optional, Tuple + +from pip._internal.cli.status_codes import UNKNOWN_ERROR +from pip._internal.configuration import Configuration, ConfigurationError +from pip._internal.utils.misc import redact_auth_from_url, strtobool + +logger = logging.getLogger(__name__) + + +class PrettyHelpFormatter(optparse.IndentedHelpFormatter): + """A prettier/less verbose help formatter for optparse.""" + + def __init__(self, *args: Any, **kwargs: Any) -> None: + # help position must be aligned with __init__.parseopts.description + kwargs["max_help_position"] = 30 + kwargs["indent_increment"] = 1 + kwargs["width"] = shutil.get_terminal_size()[0] - 2 + super().__init__(*args, **kwargs) + + def format_option_strings(self, option: optparse.Option) -> str: + return self._format_option_strings(option) + + def _format_option_strings( + self, option: optparse.Option, mvarfmt: str = " <{}>", optsep: str = ", " + ) -> str: + """ + Return a comma-separated list of option strings and metavars. + + :param option: tuple of (short opt, long opt), e.g: ('-f', '--format') + :param mvarfmt: metavar format string + :param optsep: separator + """ + opts = [] + + if option._short_opts: + opts.append(option._short_opts[0]) + if option._long_opts: + opts.append(option._long_opts[0]) + if len(opts) > 1: + opts.insert(1, optsep) + + if option.takes_value(): + assert option.dest is not None + metavar = option.metavar or option.dest.lower() + opts.append(mvarfmt.format(metavar.lower())) + + return "".join(opts) + + def format_heading(self, heading: str) -> str: + if heading == "Options": + return "" + return heading + ":\n" + + def format_usage(self, usage: str) -> str: + """ + Ensure there is only one newline between usage and the first heading + if there is no description. + """ + msg = "\nUsage: {}\n".format(self.indent_lines(textwrap.dedent(usage), " ")) + return msg + + def format_description(self, description: Optional[str]) -> str: + # leave full control over description to us + if description: + if hasattr(self.parser, "main"): + label = "Commands" + else: + label = "Description" + # some doc strings have initial newlines, some don't + description = description.lstrip("\n") + # some doc strings have final newlines and spaces, some don't + description = description.rstrip() + # dedent, then reindent + description = self.indent_lines(textwrap.dedent(description), " ") + description = f"{label}:\n{description}\n" + return description + else: + return "" + + def format_epilog(self, epilog: Optional[str]) -> str: + # leave full control over epilog to us + if epilog: + return epilog + else: + return "" + + def indent_lines(self, text: str, indent: str) -> str: + new_lines = [indent + line for line in text.split("\n")] + return "\n".join(new_lines) + + +class UpdatingDefaultsHelpFormatter(PrettyHelpFormatter): + """Custom help formatter for use in ConfigOptionParser. + + This is updates the defaults before expanding them, allowing + them to show up correctly in the help listing. + + Also redact auth from url type options + """ + + def expand_default(self, option: optparse.Option) -> str: + default_values = None + if self.parser is not None: + assert isinstance(self.parser, ConfigOptionParser) + self.parser._update_defaults(self.parser.defaults) + assert option.dest is not None + default_values = self.parser.defaults.get(option.dest) + help_text = super().expand_default(option) + + if default_values and option.metavar == "URL": + if isinstance(default_values, str): + default_values = [default_values] + + # If its not a list, we should abort and just return the help text + if not isinstance(default_values, list): + default_values = [] + + for val in default_values: + help_text = help_text.replace(val, redact_auth_from_url(val)) + + return help_text + + +class CustomOptionParser(optparse.OptionParser): + def insert_option_group( + self, idx: int, *args: Any, **kwargs: Any + ) -> optparse.OptionGroup: + """Insert an OptionGroup at a given position.""" + group = self.add_option_group(*args, **kwargs) + + self.option_groups.pop() + self.option_groups.insert(idx, group) + + return group + + @property + def option_list_all(self) -> List[optparse.Option]: + """Get a list of all options, including those in option groups.""" + res = self.option_list[:] + for i in self.option_groups: + res.extend(i.option_list) + + return res + + +class ConfigOptionParser(CustomOptionParser): + """Custom option parser which updates its defaults by checking the + configuration files and environmental variables""" + + def __init__( + self, + *args: Any, + name: str, + isolated: bool = False, + **kwargs: Any, + ) -> None: + self.name = name + self.config = Configuration(isolated) + + assert self.name + super().__init__(*args, **kwargs) + + def check_default(self, option: optparse.Option, key: str, val: Any) -> Any: + try: + return option.check_value(key, val) + except optparse.OptionValueError as exc: + print(f"An error occurred during configuration: {exc}") + sys.exit(3) + + def _get_ordered_configuration_items( + self, + ) -> Generator[Tuple[str, Any], None, None]: + # Configuration gives keys in an unordered manner. Order them. + override_order = ["global", self.name, ":env:"] + + # Pool the options into different groups + section_items: Dict[str, List[Tuple[str, Any]]] = { + name: [] for name in override_order + } + for section_key, val in self.config.items(): + # ignore empty values + if not val: + logger.debug( + "Ignoring configuration key '%s' as it's value is empty.", + section_key, + ) + continue + + section, key = section_key.split(".", 1) + if section in override_order: + section_items[section].append((key, val)) + + # Yield each group in their override order + for section in override_order: + for key, val in section_items[section]: + yield key, val + + def _update_defaults(self, defaults: Dict[str, Any]) -> Dict[str, Any]: + """Updates the given defaults with values from the config files and + the environ. Does a little special handling for certain types of + options (lists).""" + + # Accumulate complex default state. + self.values = optparse.Values(self.defaults) + late_eval = set() + # Then set the options with those values + for key, val in self._get_ordered_configuration_items(): + # '--' because configuration supports only long names + option = self.get_option("--" + key) + + # Ignore options not present in this parser. E.g. non-globals put + # in [global] by users that want them to apply to all applicable + # commands. + if option is None: + continue + + assert option.dest is not None + + if option.action in ("store_true", "store_false"): + try: + val = strtobool(val) + except ValueError: + self.error( + f"{val} is not a valid value for {key} option, " + "please specify a boolean value like yes/no, " + "true/false or 1/0 instead." + ) + elif option.action == "count": + with suppress(ValueError): + val = strtobool(val) + with suppress(ValueError): + val = int(val) + if not isinstance(val, int) or val < 0: + self.error( + f"{val} is not a valid value for {key} option, " + "please instead specify either a non-negative integer " + "or a boolean value like yes/no or false/true " + "which is equivalent to 1/0." + ) + elif option.action == "append": + val = val.split() + val = [self.check_default(option, key, v) for v in val] + elif option.action == "callback": + assert option.callback is not None + late_eval.add(option.dest) + opt_str = option.get_opt_string() + val = option.convert_value(opt_str, val) + # From take_action + args = option.callback_args or () + kwargs = option.callback_kwargs or {} + option.callback(option, opt_str, val, self, *args, **kwargs) + else: + val = self.check_default(option, key, val) + + defaults[option.dest] = val + + for key in late_eval: + defaults[key] = getattr(self.values, key) + self.values = None + return defaults + + def get_default_values(self) -> optparse.Values: + """Overriding to make updating the defaults after instantiation of + the option parser possible, _update_defaults() does the dirty work.""" + if not self.process_default_values: + # Old, pre-Optik 1.5 behaviour. + return optparse.Values(self.defaults) + + # Load the configuration, or error out in case of an error + try: + self.config.load() + except ConfigurationError as err: + self.exit(UNKNOWN_ERROR, str(err)) + + defaults = self._update_defaults(self.defaults.copy()) # ours + for option in self._get_all_options(): + assert option.dest is not None + default = defaults.get(option.dest) + if isinstance(default, str): + opt_str = option.get_opt_string() + defaults[option.dest] = option.check_value(opt_str, default) + return optparse.Values(defaults) + + def error(self, msg: str) -> None: + self.print_usage(sys.stderr) + self.exit(UNKNOWN_ERROR, f"{msg}\n") diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/cli/progress_bars.py b/.venv/lib/python3.12/site-packages/pip/_internal/cli/progress_bars.py new file mode 100644 index 0000000..883359c --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/cli/progress_bars.py @@ -0,0 +1,94 @@ +import functools +import sys +from typing import Callable, Generator, Iterable, Iterator, Optional, Tuple + +from pip._vendor.rich.progress import ( + BarColumn, + DownloadColumn, + FileSizeColumn, + Progress, + ProgressColumn, + SpinnerColumn, + TextColumn, + TimeElapsedColumn, + TimeRemainingColumn, + TransferSpeedColumn, +) + +from pip._internal.cli.spinners import RateLimiter +from pip._internal.utils.logging import get_indentation + +DownloadProgressRenderer = Callable[[Iterable[bytes]], Iterator[bytes]] + + +def _rich_progress_bar( + iterable: Iterable[bytes], + *, + bar_type: str, + size: int, +) -> Generator[bytes, None, None]: + assert bar_type == "on", "This should only be used in the default mode." + + if not size: + total = float("inf") + columns: Tuple[ProgressColumn, ...] = ( + TextColumn("[progress.description]{task.description}"), + SpinnerColumn("line", speed=1.5), + FileSizeColumn(), + TransferSpeedColumn(), + TimeElapsedColumn(), + ) + else: + total = size + columns = ( + TextColumn("[progress.description]{task.description}"), + BarColumn(), + DownloadColumn(), + TransferSpeedColumn(), + TextColumn("eta"), + TimeRemainingColumn(), + ) + + progress = Progress(*columns, refresh_per_second=5) + task_id = progress.add_task(" " * (get_indentation() + 2), total=total) + with progress: + for chunk in iterable: + yield chunk + progress.update(task_id, advance=len(chunk)) + + +def _raw_progress_bar( + iterable: Iterable[bytes], + *, + size: Optional[int], +) -> Generator[bytes, None, None]: + def write_progress(current: int, total: int) -> None: + sys.stdout.write("Progress %d of %d\n" % (current, total)) + sys.stdout.flush() + + current = 0 + total = size or 0 + rate_limiter = RateLimiter(0.25) + + write_progress(current, total) + for chunk in iterable: + current += len(chunk) + if rate_limiter.ready() or current == total: + write_progress(current, total) + rate_limiter.reset() + yield chunk + + +def get_download_progress_renderer( + *, bar_type: str, size: Optional[int] = None +) -> DownloadProgressRenderer: + """Get an object that can be used to render the download progress. + + Returns a callable, that takes an iterable to "wrap". + """ + if bar_type == "on": + return functools.partial(_rich_progress_bar, bar_type=bar_type, size=size) + elif bar_type == "raw": + return functools.partial(_raw_progress_bar, size=size) + else: + return iter # no-op, when passed an iterator diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/cli/req_command.py b/.venv/lib/python3.12/site-packages/pip/_internal/cli/req_command.py new file mode 100644 index 0000000..92900f9 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/cli/req_command.py @@ -0,0 +1,329 @@ +"""Contains the RequirementCommand base class. + +This class is in a separate module so the commands that do not always +need PackageFinder capability don't unnecessarily import the +PackageFinder machinery and all its vendored dependencies, etc. +""" + +import logging +from functools import partial +from optparse import Values +from typing import Any, List, Optional, Tuple + +from pip._internal.cache import WheelCache +from pip._internal.cli import cmdoptions +from pip._internal.cli.index_command import IndexGroupCommand +from pip._internal.cli.index_command import SessionCommandMixin as SessionCommandMixin +from pip._internal.exceptions import CommandError, PreviousBuildDirError +from pip._internal.index.collector import LinkCollector +from pip._internal.index.package_finder import PackageFinder +from pip._internal.models.selection_prefs import SelectionPreferences +from pip._internal.models.target_python import TargetPython +from pip._internal.network.session import PipSession +from pip._internal.operations.build.build_tracker import BuildTracker +from pip._internal.operations.prepare import RequirementPreparer +from pip._internal.req.constructors import ( + install_req_from_editable, + install_req_from_line, + install_req_from_parsed_requirement, + install_req_from_req_string, +) +from pip._internal.req.req_file import parse_requirements +from pip._internal.req.req_install import InstallRequirement +from pip._internal.resolution.base import BaseResolver +from pip._internal.utils.temp_dir import ( + TempDirectory, + TempDirectoryTypeRegistry, + tempdir_kinds, +) + +logger = logging.getLogger(__name__) + + +KEEPABLE_TEMPDIR_TYPES = [ + tempdir_kinds.BUILD_ENV, + tempdir_kinds.EPHEM_WHEEL_CACHE, + tempdir_kinds.REQ_BUILD, +] + + +def with_cleanup(func: Any) -> Any: + """Decorator for common logic related to managing temporary + directories. + """ + + def configure_tempdir_registry(registry: TempDirectoryTypeRegistry) -> None: + for t in KEEPABLE_TEMPDIR_TYPES: + registry.set_delete(t, False) + + def wrapper( + self: RequirementCommand, options: Values, args: List[Any] + ) -> Optional[int]: + assert self.tempdir_registry is not None + if options.no_clean: + configure_tempdir_registry(self.tempdir_registry) + + try: + return func(self, options, args) + except PreviousBuildDirError: + # This kind of conflict can occur when the user passes an explicit + # build directory with a pre-existing folder. In that case we do + # not want to accidentally remove it. + configure_tempdir_registry(self.tempdir_registry) + raise + + return wrapper + + +class RequirementCommand(IndexGroupCommand): + def __init__(self, *args: Any, **kw: Any) -> None: + super().__init__(*args, **kw) + + self.cmd_opts.add_option(cmdoptions.no_clean()) + + @staticmethod + def determine_resolver_variant(options: Values) -> str: + """Determines which resolver should be used, based on the given options.""" + if "legacy-resolver" in options.deprecated_features_enabled: + return "legacy" + + return "resolvelib" + + @classmethod + def make_requirement_preparer( + cls, + temp_build_dir: TempDirectory, + options: Values, + build_tracker: BuildTracker, + session: PipSession, + finder: PackageFinder, + use_user_site: bool, + download_dir: Optional[str] = None, + verbosity: int = 0, + ) -> RequirementPreparer: + """ + Create a RequirementPreparer instance for the given parameters. + """ + temp_build_dir_path = temp_build_dir.path + assert temp_build_dir_path is not None + legacy_resolver = False + + resolver_variant = cls.determine_resolver_variant(options) + if resolver_variant == "resolvelib": + lazy_wheel = "fast-deps" in options.features_enabled + if lazy_wheel: + logger.warning( + "pip is using lazily downloaded wheels using HTTP " + "range requests to obtain dependency information. " + "This experimental feature is enabled through " + "--use-feature=fast-deps and it is not ready for " + "production." + ) + else: + legacy_resolver = True + lazy_wheel = False + if "fast-deps" in options.features_enabled: + logger.warning( + "fast-deps has no effect when used with the legacy resolver." + ) + + return RequirementPreparer( + build_dir=temp_build_dir_path, + src_dir=options.src_dir, + download_dir=download_dir, + build_isolation=options.build_isolation, + check_build_deps=options.check_build_deps, + build_tracker=build_tracker, + session=session, + progress_bar=options.progress_bar, + finder=finder, + require_hashes=options.require_hashes, + use_user_site=use_user_site, + lazy_wheel=lazy_wheel, + verbosity=verbosity, + legacy_resolver=legacy_resolver, + ) + + @classmethod + def make_resolver( + cls, + preparer: RequirementPreparer, + finder: PackageFinder, + options: Values, + wheel_cache: Optional[WheelCache] = None, + use_user_site: bool = False, + ignore_installed: bool = True, + ignore_requires_python: bool = False, + force_reinstall: bool = False, + upgrade_strategy: str = "to-satisfy-only", + use_pep517: Optional[bool] = None, + py_version_info: Optional[Tuple[int, ...]] = None, + ) -> BaseResolver: + """ + Create a Resolver instance for the given parameters. + """ + make_install_req = partial( + install_req_from_req_string, + isolated=options.isolated_mode, + use_pep517=use_pep517, + ) + resolver_variant = cls.determine_resolver_variant(options) + # The long import name and duplicated invocation is needed to convince + # Mypy into correctly typechecking. Otherwise it would complain the + # "Resolver" class being redefined. + if resolver_variant == "resolvelib": + import pip._internal.resolution.resolvelib.resolver + + return pip._internal.resolution.resolvelib.resolver.Resolver( + preparer=preparer, + finder=finder, + wheel_cache=wheel_cache, + make_install_req=make_install_req, + use_user_site=use_user_site, + ignore_dependencies=options.ignore_dependencies, + ignore_installed=ignore_installed, + ignore_requires_python=ignore_requires_python, + force_reinstall=force_reinstall, + upgrade_strategy=upgrade_strategy, + py_version_info=py_version_info, + ) + import pip._internal.resolution.legacy.resolver + + return pip._internal.resolution.legacy.resolver.Resolver( + preparer=preparer, + finder=finder, + wheel_cache=wheel_cache, + make_install_req=make_install_req, + use_user_site=use_user_site, + ignore_dependencies=options.ignore_dependencies, + ignore_installed=ignore_installed, + ignore_requires_python=ignore_requires_python, + force_reinstall=force_reinstall, + upgrade_strategy=upgrade_strategy, + py_version_info=py_version_info, + ) + + def get_requirements( + self, + args: List[str], + options: Values, + finder: PackageFinder, + session: PipSession, + ) -> List[InstallRequirement]: + """ + Parse command-line arguments into the corresponding requirements. + """ + requirements: List[InstallRequirement] = [] + for filename in options.constraints: + for parsed_req in parse_requirements( + filename, + constraint=True, + finder=finder, + options=options, + session=session, + ): + req_to_add = install_req_from_parsed_requirement( + parsed_req, + isolated=options.isolated_mode, + user_supplied=False, + ) + requirements.append(req_to_add) + + for req in args: + req_to_add = install_req_from_line( + req, + comes_from=None, + isolated=options.isolated_mode, + use_pep517=options.use_pep517, + user_supplied=True, + config_settings=getattr(options, "config_settings", None), + ) + requirements.append(req_to_add) + + for req in options.editables: + req_to_add = install_req_from_editable( + req, + user_supplied=True, + isolated=options.isolated_mode, + use_pep517=options.use_pep517, + config_settings=getattr(options, "config_settings", None), + ) + requirements.append(req_to_add) + + # NOTE: options.require_hashes may be set if --require-hashes is True + for filename in options.requirements: + for parsed_req in parse_requirements( + filename, finder=finder, options=options, session=session + ): + req_to_add = install_req_from_parsed_requirement( + parsed_req, + isolated=options.isolated_mode, + use_pep517=options.use_pep517, + user_supplied=True, + config_settings=( + parsed_req.options.get("config_settings") + if parsed_req.options + else None + ), + ) + requirements.append(req_to_add) + + # If any requirement has hash options, enable hash checking. + if any(req.has_hash_options for req in requirements): + options.require_hashes = True + + if not (args or options.editables or options.requirements): + opts = {"name": self.name} + if options.find_links: + raise CommandError( + "You must give at least one requirement to {name} " + '(maybe you meant "pip {name} {links}"?)'.format( + **dict(opts, links=" ".join(options.find_links)) + ) + ) + else: + raise CommandError( + "You must give at least one requirement to {name} " + '(see "pip help {name}")'.format(**opts) + ) + + return requirements + + @staticmethod + def trace_basic_info(finder: PackageFinder) -> None: + """ + Trace basic information about the provided objects. + """ + # Display where finder is looking for packages + search_scope = finder.search_scope + locations = search_scope.get_formatted_locations() + if locations: + logger.info(locations) + + def _build_package_finder( + self, + options: Values, + session: PipSession, + target_python: Optional[TargetPython] = None, + ignore_requires_python: Optional[bool] = None, + ) -> PackageFinder: + """ + Create a package finder appropriate to this requirement command. + + :param ignore_requires_python: Whether to ignore incompatible + "Requires-Python" values in links. Defaults to False. + """ + link_collector = LinkCollector.create(session, options=options) + selection_prefs = SelectionPreferences( + allow_yanked=True, + format_control=options.format_control, + allow_all_prereleases=options.pre, + prefer_binary=options.prefer_binary, + ignore_requires_python=ignore_requires_python, + ) + + return PackageFinder.create( + link_collector=link_collector, + selection_prefs=selection_prefs, + target_python=target_python, + ) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/cli/spinners.py b/.venv/lib/python3.12/site-packages/pip/_internal/cli/spinners.py new file mode 100644 index 0000000..cf2b976 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/cli/spinners.py @@ -0,0 +1,159 @@ +import contextlib +import itertools +import logging +import sys +import time +from typing import IO, Generator, Optional + +from pip._internal.utils.compat import WINDOWS +from pip._internal.utils.logging import get_indentation + +logger = logging.getLogger(__name__) + + +class SpinnerInterface: + def spin(self) -> None: + raise NotImplementedError() + + def finish(self, final_status: str) -> None: + raise NotImplementedError() + + +class InteractiveSpinner(SpinnerInterface): + def __init__( + self, + message: str, + file: Optional[IO[str]] = None, + spin_chars: str = "-\\|/", + # Empirically, 8 updates/second looks nice + min_update_interval_seconds: float = 0.125, + ): + self._message = message + if file is None: + file = sys.stdout + self._file = file + self._rate_limiter = RateLimiter(min_update_interval_seconds) + self._finished = False + + self._spin_cycle = itertools.cycle(spin_chars) + + self._file.write(" " * get_indentation() + self._message + " ... ") + self._width = 0 + + def _write(self, status: str) -> None: + assert not self._finished + # Erase what we wrote before by backspacing to the beginning, writing + # spaces to overwrite the old text, and then backspacing again + backup = "\b" * self._width + self._file.write(backup + " " * self._width + backup) + # Now we have a blank slate to add our status + self._file.write(status) + self._width = len(status) + self._file.flush() + self._rate_limiter.reset() + + def spin(self) -> None: + if self._finished: + return + if not self._rate_limiter.ready(): + return + self._write(next(self._spin_cycle)) + + def finish(self, final_status: str) -> None: + if self._finished: + return + self._write(final_status) + self._file.write("\n") + self._file.flush() + self._finished = True + + +# Used for dumb terminals, non-interactive installs (no tty), etc. +# We still print updates occasionally (once every 60 seconds by default) to +# act as a keep-alive for systems like Travis-CI that take lack-of-output as +# an indication that a task has frozen. +class NonInteractiveSpinner(SpinnerInterface): + def __init__(self, message: str, min_update_interval_seconds: float = 60.0) -> None: + self._message = message + self._finished = False + self._rate_limiter = RateLimiter(min_update_interval_seconds) + self._update("started") + + def _update(self, status: str) -> None: + assert not self._finished + self._rate_limiter.reset() + logger.info("%s: %s", self._message, status) + + def spin(self) -> None: + if self._finished: + return + if not self._rate_limiter.ready(): + return + self._update("still running...") + + def finish(self, final_status: str) -> None: + if self._finished: + return + self._update(f"finished with status '{final_status}'") + self._finished = True + + +class RateLimiter: + def __init__(self, min_update_interval_seconds: float) -> None: + self._min_update_interval_seconds = min_update_interval_seconds + self._last_update: float = 0 + + def ready(self) -> bool: + now = time.time() + delta = now - self._last_update + return delta >= self._min_update_interval_seconds + + def reset(self) -> None: + self._last_update = time.time() + + +@contextlib.contextmanager +def open_spinner(message: str) -> Generator[SpinnerInterface, None, None]: + # Interactive spinner goes directly to sys.stdout rather than being routed + # through the logging system, but it acts like it has level INFO, + # i.e. it's only displayed if we're at level INFO or better. + # Non-interactive spinner goes through the logging system, so it is always + # in sync with logging configuration. + if sys.stdout.isatty() and logger.getEffectiveLevel() <= logging.INFO: + spinner: SpinnerInterface = InteractiveSpinner(message) + else: + spinner = NonInteractiveSpinner(message) + try: + with hidden_cursor(sys.stdout): + yield spinner + except KeyboardInterrupt: + spinner.finish("canceled") + raise + except Exception: + spinner.finish("error") + raise + else: + spinner.finish("done") + + +HIDE_CURSOR = "\x1b[?25l" +SHOW_CURSOR = "\x1b[?25h" + + +@contextlib.contextmanager +def hidden_cursor(file: IO[str]) -> Generator[None, None, None]: + # The Windows terminal does not support the hide/show cursor ANSI codes, + # even via colorama. So don't even try. + if WINDOWS: + yield + # We don't want to clutter the output with control characters if we're + # writing to a file, or if the user is running with --quiet. + # See https://github.com/pypa/pip/issues/3418 + elif not file.isatty() or logger.getEffectiveLevel() > logging.INFO: + yield + else: + file.write(HIDE_CURSOR) + try: + yield + finally: + file.write(SHOW_CURSOR) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/cli/status_codes.py b/.venv/lib/python3.12/site-packages/pip/_internal/cli/status_codes.py new file mode 100644 index 0000000..5e29502 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/cli/status_codes.py @@ -0,0 +1,6 @@ +SUCCESS = 0 +ERROR = 1 +UNKNOWN_ERROR = 2 +VIRTUALENV_NOT_FOUND = 3 +PREVIOUS_BUILD_DIR_ERROR = 4 +NO_MATCHES_FOUND = 23 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/commands/__init__.py b/.venv/lib/python3.12/site-packages/pip/_internal/commands/__init__.py new file mode 100644 index 0000000..858a410 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/commands/__init__.py @@ -0,0 +1,132 @@ +""" +Package containing all pip commands +""" + +import importlib +from collections import namedtuple +from typing import Any, Dict, Optional + +from pip._internal.cli.base_command import Command + +CommandInfo = namedtuple("CommandInfo", "module_path, class_name, summary") + +# This dictionary does a bunch of heavy lifting for help output: +# - Enables avoiding additional (costly) imports for presenting `--help`. +# - The ordering matters for help display. +# +# Even though the module path starts with the same "pip._internal.commands" +# prefix, the full path makes testing easier (specifically when modifying +# `commands_dict` in test setup / teardown). +commands_dict: Dict[str, CommandInfo] = { + "install": CommandInfo( + "pip._internal.commands.install", + "InstallCommand", + "Install packages.", + ), + "download": CommandInfo( + "pip._internal.commands.download", + "DownloadCommand", + "Download packages.", + ), + "uninstall": CommandInfo( + "pip._internal.commands.uninstall", + "UninstallCommand", + "Uninstall packages.", + ), + "freeze": CommandInfo( + "pip._internal.commands.freeze", + "FreezeCommand", + "Output installed packages in requirements format.", + ), + "inspect": CommandInfo( + "pip._internal.commands.inspect", + "InspectCommand", + "Inspect the python environment.", + ), + "list": CommandInfo( + "pip._internal.commands.list", + "ListCommand", + "List installed packages.", + ), + "show": CommandInfo( + "pip._internal.commands.show", + "ShowCommand", + "Show information about installed packages.", + ), + "check": CommandInfo( + "pip._internal.commands.check", + "CheckCommand", + "Verify installed packages have compatible dependencies.", + ), + "config": CommandInfo( + "pip._internal.commands.configuration", + "ConfigurationCommand", + "Manage local and global configuration.", + ), + "search": CommandInfo( + "pip._internal.commands.search", + "SearchCommand", + "Search PyPI for packages.", + ), + "cache": CommandInfo( + "pip._internal.commands.cache", + "CacheCommand", + "Inspect and manage pip's wheel cache.", + ), + "index": CommandInfo( + "pip._internal.commands.index", + "IndexCommand", + "Inspect information available from package indexes.", + ), + "wheel": CommandInfo( + "pip._internal.commands.wheel", + "WheelCommand", + "Build wheels from your requirements.", + ), + "hash": CommandInfo( + "pip._internal.commands.hash", + "HashCommand", + "Compute hashes of package archives.", + ), + "completion": CommandInfo( + "pip._internal.commands.completion", + "CompletionCommand", + "A helper command used for command completion.", + ), + "debug": CommandInfo( + "pip._internal.commands.debug", + "DebugCommand", + "Show information useful for debugging.", + ), + "help": CommandInfo( + "pip._internal.commands.help", + "HelpCommand", + "Show help for commands.", + ), +} + + +def create_command(name: str, **kwargs: Any) -> Command: + """ + Create an instance of the Command class with the given name. + """ + module_path, class_name, summary = commands_dict[name] + module = importlib.import_module(module_path) + command_class = getattr(module, class_name) + command = command_class(name=name, summary=summary, **kwargs) + + return command + + +def get_similar_commands(name: str) -> Optional[str]: + """Command name auto-correct.""" + from difflib import get_close_matches + + name = name.lower() + + close_commands = get_close_matches(name, commands_dict.keys()) + + if close_commands: + return close_commands[0] + else: + return None diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f85917762e810d2ab9a79eade3ed4f01303a3a1b GIT binary patch literal 4000 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/check.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/check.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..7c300b3796cd42f1fcade9d9725c5323fe6e0076 GIT binary patch literal 2614 zcma(TOK%&;d6xU+Q`94rELrjc_!xQ7g$|Q(>{%9a1ap%dFQA8HCa1 z>#0M>Cw^(4OE9gHLD!L$yN|3qmiGA(b+*k_3;$!tttuBu9~({!hX4sT?U2GLulTNO zcvdwNiC1sm{?qM9Uj1lga_1hG;g0QcaurlyZEgceI$&Qp!HqWh=F{D|f^{qP6qjjnd&eaX>dq z3D3!WH`@`DTi~7s?i`&=?=7yQbh4eCm0{`F7ZN&$K7C0*pVkD_kwB*YD=bK33l)eE zL}oX?Ti7k0umm20rD7-FDeR951?c20O2UROy6-&?#+BrJf$2Kz+eirY!|J zmqDKxN*yT_IzpJ~$V8$usr)KBVL?n|$sr1UCu3n60*RE@2-j8~2y$dn(-kYTy{O z;S+af@s_Wy6MqYPsWVJ(s5bnTXVt0&!itEn+KL1RrUqdJOkhZ&=rr^xIc{d%V%Ii! z!m4(NeC!mEM{5DR;h8@F#eQUH#xqCA5}{zW`wB9hbop8%<( z!^itiYxND^#dQ*3O8jleRNeF~T>roh&3bJc=40Kl*Xu!>Zus8YwTqYPA%y3xRAW7` zgF3_tBIX$mh{kg_tjB}27PP^EmbX(rIiG4knFmM0i!dYZp~3RCgXJ4N<&|!JZ*6eq z!WRn%XMWdHPIu+Kg+XP0P*@z4&mEMjPs-PNO>XqNvQy#tfIE;0!q&jE& zGhpJ(QBh`Efo~{+u3-huz4{!9*;4oVpfJ}jU+I@;pOn>JSq0$X#Dj?=Styono>PsjOZ#xoOA-r;g&11qwSj0n}M?55xECc#EBCoNl zvutCP6K^mHQFsBi`{Rco{ezVC+T!EK`wL;=XB++&N!Ttg?6HVmzyyyl zZH2&Q;qbU4qslMUxtJQ3L5-y6|4)q{U;d@D$Dd7hU=mU3rS$`!OSMnP&*Lqa5Pi=boaA-(}~!vrn?~z3lv> WcMq~>?@8ZF7r2GJ%SQ-~*wW7x7qSQd literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/completion.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/completion.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..1b970269acac2b51acaa163ecf2661fdfabb6f05 GIT binary patch literal 5190 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/debug.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/debug.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c9f3bf1f57439738584ace9fc7c6f534f4c7f2ac GIT binary patch literal 10112 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 RZ+8b*yKv;c2^8$C{ue|rFLM9@ literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/download.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/download.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5a66cf8694d982eda2c5e2ee785a5fafea334dd6 GIT binary patch literal 7506 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 W+X9StGS@|M^wanME3hZG@&5oK+zAf= literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/hash.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/hash.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2fcf158dc19aa8b518bb07350b6711e34e28eaa1 GIT binary patch literal 2981 zcmai0T}&L;6~6PgJF|a4!Cnmh85bjGtFqg;wOv~=l7&g!#K9`iRNgik4KtVB+04)8 z-dPjYpz`1ckQzCCf`>e$Ql(%~DS60q)xJcL@)ATN=q-^WwUyepb)bsmr=B~r3%Et< zg+2G2bI<)d=R4=l=hp!$#)zYLZ2K9JkRv)g2B+kjuSCK)A5Rl(+J;qa_-|2`nIle!ji3?M8=(~+DW(U$ybkgz!if71 zd?%D8TP(}AR95Vioq*FO>?BUwDps*}3T$l|r{EqMjHKt4LYk#-o3z?Kar51j4h^ETMj!u zMz&JZI{L%jPSnzeQinTSVWWMnPXGJlMl!Y%__;Ej8HatX>yYnowtD;>HpJLMK=Y`e zO*F+3vzZyu`p!`)8Y|eNgL0a4L4+R6}xr9&rndAYI(K+F`_JG+7Sn~gu9HWKv-fnAf5@6 zYJuakMBOA56V?mC#w6qu!Q7~jpi$>pM6o+dx$pF6zbsV)50^+Cha|Y~Sk;mh*tqn% zL#-yiKDVupJ(aA z!_sE{NE#H63=F_Qr~zaN?WmbY*_G_Js&A_LPNsV&b84sO^lsnzo!$XXd#-NxjBfUf z?sWI9YQNFmAKB`DVNVjjlWTP$?fgDUX{pvpq-7taSJK<+#ZC3%y0HGEk8V7^@uhlg z54J!o*+x2(O;VxOQJnI+8X@~rU;x=7Egg@H{`G#@pAXGphk5|;D(1K8l zYI#Q!_lwekcniG=ZdsH=o^4UHg#~#*3J>thr4B+j+BqelU!Rsy*xi{kg$m+CvwN6c zPsNqu2C&1lppii^Vd*-7&>0O1^@d4w9zaM#8xunK4G3R`@cd(0g9p?IW({5(2+y&C zLeB8<^PGH_6K>Arx*1lf0xYj`IyuXg5^4C&uA|Wh#S1V(?*Umtf9dLlSU-Ag<+bh1 z&}L@ncVi#E`rB9koGI=0_AlT0x^Hm1Z+NqBcv;)&>;DExT5kE)Zl-^yd+3Ad^=qGa zf4ucsVe88Dza=r7Ye_J?ucGe!a*pV*dO;*P=q3sorW%HCde|^n$}qgZZn&J!7{=QT z(`}C=4Z{vBP%E)ldYy_7iEXrttHCpZoPz}k2MXbS2hW9sN#IFR0P!)3_Kj{%c=RH| z!$z+Hd5E5hilVl1C|g(>-x)ajg`D4$Gs^YW>6DURyV63?t@o{4k55JH#}rVlFTjUD2P~J-q8J{)zSf2gpWbN;LIe<;n;abv(W`o<(5&k>%A zEYYajW{8*S*cD-YJLZFLPV%eyD^5As_l3f~|>JGVUEPKPz+%gouQ5~#jaU{Xs( zkS3!mqg(00FXX{*wg1&UqdZ~Xy?XPE^rth*&CAI`Ke+-LmUM$k#qld-m`f@Y!T62f zKwyb*zRt%YIG=@@UOcGjMay-HGbY7GySNj6S$2#Od{%@F3TE)G#RY^zhYdWxTqAVg z+k-m~tavGm9x>K`oRtTUP!yH83TYJ_-ho>{f%;x_YJMdUqOAATN6@wI2npfzn$$wjt;gNR(mt1>t^Wh^4Z98i literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/help.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/help.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..842543feb6b106ee2c0ee3a1b7f8f667df143afc GIT binary patch literal 1671 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/inspect.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/inspect.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..32d62d50e978237f6eb61c1ab40b01be0e116b84 GIT binary patch literal 3974 zcmb7HO>7&-6`o!0E|-5I^)FGfwN&g_G%V7Q?ItN=r?zFcc3q``oEBgZY}dOhit;X( znO!=NAQ=wegHjZ*4Fr%27-$Lm z17haQdvD&noq6AT!@nmIQ3UP9yK6JmI70uVlc0${vGp|&E66|wXQ2Wed5g380?$!8 zWQA;@AlPC-w55W?c!CwS<$}y;(Tdp7LX^>x6|>`oIHSW>!tN+^Fj}^fcB+tKbj0ek zy9!;5j#}MzPoc-|E%dT^%<8lI3;m3aTLboBVUR;SGSS@0!0GmA4y|#mSz(w*KSf63 zHZnTQ)LO{r9+>B{$$!(yRF)&suQaP_y4es3oh{E3VX~xqM7UCNJrH&q=8RUgJk>1U zC}F2;n`O$5R&c58sdKJVhFMHiZNSxbQEVs(Uf1#d$Uei*>P$L zoPkooj#1T3P{3xz!JbkoE0?F=nNnsPY-?VQ8NIsD$3{gt4Ejaoeg7~&AQCpcDlSjy z{{6D=4nt3Gc54i{D`*kTG4}3mj%w^_250a_$PgZhYeGxJ{gBmgmTbNJD6-}w=7+5J z0+gY-;Qn^_x8~D9Bs0tM4h5f_i+!JGME5^~HNK_Gp?Q>zO)Z4S$1O+KEE07+2b-#g ztLDXp=}R;8Rx}0T-K%OATp?Vq<|(t9s}wEgnr11QuA8oVOfej#?0AX=aqNq%`SDWO z^)$;e;kGsXx>hvZ9AHb*bQb1eA5cV?HLc2mG(KK+O-uyZFC2TPY|Sf9)vHv!?bYB- zU=aMGdgE@%Gjmyi2!;s=>Vwb1{j?jP9sSCzL}Wmr3X$WIsAezZ>= zv%jU;=zQDPlR&Rym)@V!^~|YS=F~>!^{?bN=uWXuVs-gQO+K>9t)Bez>4&GE%5QFg zABco~h!R1=MOWVmHX5`Ho|hRsy=~~u`Qb2t@h#0og4OL2RZ_Q0n$JFBx#WR6qq@JmP|)u>`5q>k8zHp-FT{(D@?L`474gS`q+qy@9knE((FA zd;ITu1<+m+JQ}L31t2#<4}>MrqdAwgMe))0Iu3d1fIkiEIcDP{loh7{RZ#|D)dAR$ z2!%$A6x{2j3gKP@h=l#h1l6Nd3Ca|SY-5VVcI0Rp@rLGU*^U-a`t(^-zpie>#fJy( z0FQ{k05l9ijv=mnh^oepn&uLb`G@J3k&p|(p=XWhg^>hPrRB_kf{SSu$23+jy`rpy z6-pnX-C^j6NDaH-9t=ckr3jZMPFjW(1!t&I2v^GsU3-uNyyGBrm!Z3bHs!9moUO^( z)gxcY6Pu}#&%&R_{}|s$jn`9`YpKhP{(~z^_m&!c2Ue_m)@EnVr|)lcW}0Et`Ezay z37yepu^C4LLz_ddHr}56dho(y@BX2B`dBS}Z1w8X^u&|F3!6i^jiKW&B2rg$S$YYe z>b@^Ml}9#{eajvH`%es|FLKQDzl{x?Q)K))_@(c}0!0f$OpYN2q81o?8*q27@x=!B zfM4Q4ChXOR7!56kKJHlz&C#RY(}GA`qA%|z|q>k(MINQJ#(U#Iq^aajYOA25aWI6 z74@FF9BssU*JGK6ad1DyYVOS15F8K$LnJkYhxGJu%`om0BtTC8l?9W$ND4a-%5*cc4>-9qYCz3Z`0d~t%<}>@E1CaJ}^pgz-=UR^u(8}2wz7Bs`SlT72ojMp^ zHY^d75U^Xhx|1mckC&Wom0I=T;P?2sYw*8D^Vg`)-&npUeY-6M z7;D`CD>v!g8t|vda&xc|R3TPX$iRLIfN7UujYQ!8)fG586XQ$lyy!W?gx%r0z-iy> zck)}Um^y=h0|Lmx$h`txGsJP+KTyXrH1rJ`t)bCx(dlRC$hT_d(sB literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/install.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/install.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e72763fb4e712d75df586dd47d765dc5762b6b9d GIT binary patch literal 29161 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/search.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/search.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..82c5c27b54fff094885720e30afbf8a513a85b58 GIT binary patch literal 7543 zcmb6;TWlQHb$51V-%pauHggfL;ctW0pH{@kF zbKIAx3Dq*#60b}6Lw*KZT)@y0|`s43ALYG!?Vyd}{ZYGtq^-j)c20t|M> z+Y=q34hFm8Vq!;V2ZP=5or%s+Cxbolu0(gJndEe!1bcP#NDN)yZzzCGVB@UNtqtApRu3?3R28T@|GI z_k_?ssX^W=HNwv?aaS!;6O8rRiJeI8IA5ognq`mN$L6lDIyc&s5$x6_yxyRnPG#nm0J3M&)+{lZX zfCQRwA*QIB?d7x@OC=+5%|14puFf^5BUF)riFGiQNJNqnfOVs?q5y4WJqc`)K%umoJYDY1YxpgM-7PqcF!+As(hQMWNp~E~{Zlz8aZ|t6@2LEk;wx zgq+0f3YTUtorAXaQY`&?B2LrMF&arK=@dn*BbJnaE*wvdL(er$W2ziZO{wWAHHzmq zO69APM+af#7JONh;E?Guk$G8=xaVM$K_&*7Wgc%7Fg*5W1-L8^TlQ*-CS>Vs4DKlz zNywU2nSy(uvzqOiOz{?!k)TDhg~Nyqhc!nyoJdJiafDsr@Virycm=~ND%HHN{|-UxCB-rX$gJBIB~spN^&b!?C0)Q}~Q9m3=RzUy&m;I?@z7L}#oJzFak4Z>|#S~U<7pf|5n;=mY~LU46p3|x{0#L*&I zWvgV9ZL*ySsvtW+-0gsIN{;F%(g@IV$#&VksWw3A1WNa;Iq25hqipvT>6v?8?~3qM zL=+RzIJ`JLky2z4uUZ6LiI;SF63-#E*i%tbvAY5UgMubVGMEf&LRKT!B2=?hP?|6y$I}!S zN1cc!q%hpCqB$ZGgFxhI4InjJdNv&kPtmw$VfKY;b?}j7sv4k>ght z{1PJFfis<(tdzOtZNkyF1=Rzz$~ma!Ny+BA>Avn>vxxq0oIt%@YDK!??YS6t@`6;nES#zf;*v2rG z6>vEU#lus)i=dSrK==?=hoREUY-5_82`O7kz?wb-NCoY+Zb2#%$HM;JdAjKDU$C!x1G!ky+p{1%XbvoR z)}5Z41J?)EoNWbX+dXIddZ2SHaHJ48QVblu!xaJp3nSmy>KCPzlV92fzH<84>sl5@ z*1a8hTZeAEPr=ID#1n;yiRU~BC5q?MEZ83vOjA_=w~8eXf?2UNS@WMSlpyZr>U@ix zWGs_a;e_2*N`}jD68DiwGF548*^eRe$l88jo93p;4F3k1=7Q#tpo!uk zDDGY}rRZGX^@|r?xirZ11+1%hH4=-1*1U-!z<@Ysddm@X(_Khiw>5TB^jM7Ijx@^* zi&|<-OWwK#=N~rQ#Mhv6+F9`K{Ei6ro(Hx4tL9&Mf9cKlKYy3MJG?e@xiEA& zKlp0i_ga}JZvTdb)OF;hi?zG+uHFAtw!@sq3Vz?uob{&&1*|7=uBIku4RlLZd_j zIFSb%N6%mveFVE%+JTUW6}nK`X;j!#-iGQu@|EyXS>W6|=7%4&wC9D!M}osVP;T;= z#oRMx0?mqlCHhG-16P$tI8qk9W`AyIx$c8=Wdh);g*A5$-xcnT{-*Qp>z{cF$6ww+ zl)gAy7iEGSdRusfdu7H6@;)$5n|{;qM_DdIhR9o22+5id}6 zMj!e#-)eBW#!)BG2pRJ@CkY<`b%urfH~JA`(W)8i$*T8-PNjgkg8g9u|7TY5)>+v; z)1Y|=f)Itf@g}TgaAwKI4M`xX5la);t<&JM*&4ewc#T3pHTRDWRGhI1Swy82uhLXP zL`4&03RsOuJU%N%bQA=0Mt0ICz9x&)5pcUz9AmQ?ILFipQ8k!unJFqNh@2$GlJQtl z?t_J49SEp_v#Q_>#^=ecB-NCdO2U$|7>y*wDMjvMbX%;QwX(M$zd1q@;N#V&fBF7D4h^)1q=@!+txFncPQlKk$?x9s^_bi-U9Q&)0vWvLu7ssxTKk8rUSv~wo-<_7io}psPaM3$l+IMKtmh&%palC^W%@U8Oa5d42D~2ILsv7mmAJZt%qo?UfhTN{mIOrGuqaSQW zp@vKzLFwn8md0c_lzE6TtI{oj_9eb;Q4#eK$Kuh7L+=6PJtUGoT9i8)oC8uZ2*->zIEDJ?v z_xw=F>dadk*WHcpfBzwI*#|(IZf34$a@W4_cCY)|@_{3(>aQ}t%zWt^`o`Cm3$IAO zh<_5l=R3Y$CoVS>>w4De_I**eZ{07JO<*;F79?yAc$=0Oe*u4}w1 zhQ@rOodd!p(~V;SteNGFQAxn@ic|a><_at8X9d^^b6_)^0%9v!ATqDIvOi}BSxd(B zqZ1iZhMR+!O|oL0wPxU1=ba%Cg8iFnG>I|Y69v*mtD#B|P1_|0MDb4C^&IR5+o#6* zHsgfg$OVYCT^S41Zj7um_6!HGHgb2VkYPjG%d%(9U3mfvqw`iYCsP64 zL}5@5V`xfI?<++Q4o@OutbPJNE{5`lqA+aP;m#{?h1gri#Ze7x%te-2Gb7|JrvvOnJnc z-5&6YUf)Bv#q9&_wYQZ0#OMEx)R=4jufP4GcGvQm1?zf^xLo)1#-BE>w5&!~FBf+l zFV;M_U@1A9^Um&4YcRj>M4|P>U9Ql2df`IJ+nT%bg;)GW?D@I-r|y;U)l5+wT6C9M zJC-~1!GSy9D+Es#cAhG5aO%z+k7Ojwb=PbD^%MHu66)xYfXTe#j4dgra z=i3jg`tpGT`I>{PovY)kZ{)qFFs%^mHS4aXod2GyecjaqG4i!9UC%u1fOGukcQtU< zKWywLKFA(8d(BraI4ZP{75r>Bj}Pv*{koxX@QCTxN9;qK`JV{~H4A{YMaC#_%q(>Q zur)Hy5Vh*>KdqV%h!ait9{?VLC&(@om_(yc1v$oAL6@l;dM1&qLcgw{5`jH;dKP9r zdh4EZZ(i8TA`DxEy5<+Coez(rSyTvGffp)}o~E$;#fDvs9JBy9!amG#q!jJbV>+OR7jQlFL!D!%(%KoJ z@#KxW=(_@bHC%c7rYPbSZrg|;jjGb1w|E*OaDD2O0%Y*k$sUT>labc6eMxyHD(g?k zdhXn?9gQ!fQUnx}dF_@bkia^w^s!W0e-~}rPLPz<=@fmZPrqb6#c$nCg0EdlpYe4t z2zYXbIz literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/show.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/show.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..be9d929e68990e61cb3aa3dc4cf3f442387e9b09 GIT binary patch literal 10490 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 z zS3qr9@C0bVGElh1p{2&dg_|6_@Wh*(Qout6pH}bZWGqQ1U{;d$0!!$;FhMb%6NUSn z&dSkRi;)pY6;yU; zJl%`;u(oFn-Tx+*_7OyKeV2!!$F!D_7SvZO@r4({FwE zg(XYPY}KNr`3uf7Gc@NxQ*x2pvIM2`bG>&4ZVxPS+n+53=7c-Z+tEdC7uLNox9iSJ zw_jT1x}daB)iLkM`nuD;?nUmUXPf@b+}S(lZ=YY}cIM3Xtl5_~`xeYNjGUwEz9+l= zWP1C_6|Kf<153$RHG}ZiZof94_+awxBpB<9+yUB2`#k%B@viZHTXx5x^o~QBO+AZT z?|+(IAZVeM3ObVBeq_;d6ko7;zU>45UH_tGFP54XEt_&+VmA5HO@1(>tlMWyOOA%w zSLcQvIktg4W!?S-Hd?g!a5n>uOs=JGM+aq#WDL#Zcrrwh_BYj0TF+nnAE$b4Sw3dtqjm zl10!!P~<@=48%bnoSX{*zq#X6Z z9gs6;X3jZ#X6Br4&io@Dk02-y-dvkKHh|E-S;s5E4)Lf7#7(3kRnSq1wLV=id?la2 zXi*mpf632jzaB7xr68vRddQGU5~qWD*oc%OoDS(xBUXxWTGHc2qLkotSRXKwr6i{# zddf(b(wvU!86#WD8aqlmct55O8bhTaW4JVIjFd(M!6f<#Dc&EFZ{wJhWZ{=+)w^MV_EThXh;2Fm}sW;@WP%8F^3T3OMx8j(%KATSsy z8>&@tG|ObHp;MM&D5eTzW`@`{40lG}(5`AGeQK;86Z>VOxsa(U18E^D77dI zrYj1yiA>3RRgDsZn2w$IxjVErD;t+*sb$EzW)gSrPlma)+Ap3L-Qn^)DPNJvRfkX$ zKDaD{jmjKR-2)YBIi&2!6|K_NYgno_3u|OH$?#j!Ox0Sl-OQ3gO<9|jY1Nb!Tc(!f zl-nEEuDky6JoInEDU<{im3*pD5>;QxuZGpY2mVq(4U(W5A|WD;0G}$7@N7_(U?#Hc z&qv(k1+%lJ&b}$Hz_CRzldG2kdcLUHh{rV|@45ip=@ zc9E+o;F&VjDh^(vN~J=m-DAL)m$xxSC5uG2Dwi&`ZKgV2KK(tTF0b?CLudY{I!KFv~} zN>8KL_G{*Fyp?w$zO~PKYGV66Uh}ni1+S0UkHR;$=~xu795B6iPU_m_$u{mBEk1W-($*YO@ZfL~ zfN)aQ%r?q{D8GvA$u1xQNV(D8YV6w1?g4kuw%9kD2b1huP`!_uQtYGnhw)7bHzeGQ zC7ZFaW@@~d8Ea+-o7vHpUr3!4S}7FHJx0-Rq&1Af@h1c_&D3BsGu}*{X+=3-5cm>X z`2IY)nVV|lrZ#fZccl|szR9LuZRB3v$ep_@{en$JKa6fl6Afu%Raiat*Oza-{EhU| zBQO@Zp$@jWeud82<$jo9aKeEp3pEF(POvdSuha!ExUY#Cy5_I@PNR3FTNn z>cT=NZ}8+;dt2~A?pm-O+zvqKNIh8hI}9Ru*`CX@UH+Vo0=oXT zAAxO&j{3d^R`DjRBIKmJ!Fs4J)WzH4T4!CrF%2A&lj(9u|L;0&;rhf=uk`1BbbSWw z_uKoO9i9!UAHZ!JDE>WM69021_=kYEhrbbE4TGMxUTa4j7WKS%ur45H%o|ffb^ju| zEqQtX>irA5yxCss$-?fPfZb!~KHi)4D6j#0bgu>b_w;%mrG~GZ249MJr+O`155s;Q zu7?-)c|5(=`#zlgNq+YGdvhM8Mz0(IY>PN7sCns0IS0M58I+H))K}7M3$jw8)@II` zi;(WB{m_0K@1t0oGXZv0T;TBEMHs+b4myxqRUoajG0T#-NCVXSD6_&1+3f_mcJQKA zh5G< zt+_cu-4N3OpQFrKX_Qs$cBU*|DLYuo;*i2q3S?j-;XUDoyPHLsGr8fmL7KDd2HEau z4$U#4B&!%qH8TQ7h&9$*!|7ybtAnOft%{G$`!?# zhs4!pma^o!T_|%M&`>pN*$ZA8?OhEpdJ?AXKLTdLm5?6XOdo8d53atjkv_T-`q$3g z>(WRwJNyvE!|9dN_tF#1WVShiH%E$%k>cZkm`SXhYDp-W`RM9zuQpGfUQg!k?m7C! zslT87+u4mhFW*T{f14bWrTDemh7fu9?hjCJ!`{2fj%jY{fwwF3(tIGrG4C-TV3CooL}+ zZ2WF4cW+>DB|#z95ri3o@$>npE6Mz|D$8y}X1-k23D7ZFey^(N%uApbl4aE@0}-g& z@V258AWPZ3K-o3tinc>t5poO4eBc)1pWyC7(~OB#qwu$%gX#nHz$XQyR@N6k_Wqei z(qQ0t>+o}dp--M~A!t^!tL0lGoczLm%tqSUn2!8zH^hPqg36WPB5&tT%nmo`ELT{p zaeKxfz>6}ZM5;xL?F0zsiu}pej?on7@Uo#|S=ZXx+wPx?7cVRD;_e_9WjTU7{!=D+ zy^*V3E|$Q%+o*yEy;HS;4U$U5(SVe(2RB>m0b~D_}ll5B2uxonsVp8h)ZbN>gnonWn#jF$i~L zGXk7m5dMi0_tDsWH1r*M={t1bK00zAo#6HJ_tD`We4^m{LGlZ}2MDTG3`NFPhBm{a fjqvCvFK&dNc|Z6#_-jEJy0Ns5kA9CB$v^yGNwKqm literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/wheel.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/commands/__pycache__/wheel.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..86242e65b9a2d0e5ed20d28e551d75146dce1de9 GIT binary patch literal 8873 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/commands/cache.py b/.venv/lib/python3.12/site-packages/pip/_internal/commands/cache.py new file mode 100644 index 0000000..3283361 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/commands/cache.py @@ -0,0 +1,225 @@ +import os +import textwrap +from optparse import Values +from typing import Any, List + +from pip._internal.cli.base_command import Command +from pip._internal.cli.status_codes import ERROR, SUCCESS +from pip._internal.exceptions import CommandError, PipError +from pip._internal.utils import filesystem +from pip._internal.utils.logging import getLogger + +logger = getLogger(__name__) + + +class CacheCommand(Command): + """ + Inspect and manage pip's wheel cache. + + Subcommands: + + - dir: Show the cache directory. + - info: Show information about the cache. + - list: List filenames of packages stored in the cache. + - remove: Remove one or more package from the cache. + - purge: Remove all items from the cache. + + ```` can be a glob expression or a package name. + """ + + ignore_require_venv = True + usage = """ + %prog dir + %prog info + %prog list [] [--format=[human, abspath]] + %prog remove + %prog purge + """ + + def add_options(self) -> None: + self.cmd_opts.add_option( + "--format", + action="store", + dest="list_format", + default="human", + choices=("human", "abspath"), + help="Select the output format among: human (default) or abspath", + ) + + self.parser.insert_option_group(0, self.cmd_opts) + + def run(self, options: Values, args: List[str]) -> int: + handlers = { + "dir": self.get_cache_dir, + "info": self.get_cache_info, + "list": self.list_cache_items, + "remove": self.remove_cache_items, + "purge": self.purge_cache, + } + + if not options.cache_dir: + logger.error("pip cache commands can not function since cache is disabled.") + return ERROR + + # Determine action + if not args or args[0] not in handlers: + logger.error( + "Need an action (%s) to perform.", + ", ".join(sorted(handlers)), + ) + return ERROR + + action = args[0] + + # Error handling happens here, not in the action-handlers. + try: + handlers[action](options, args[1:]) + except PipError as e: + logger.error(e.args[0]) + return ERROR + + return SUCCESS + + def get_cache_dir(self, options: Values, args: List[Any]) -> None: + if args: + raise CommandError("Too many arguments") + + logger.info(options.cache_dir) + + def get_cache_info(self, options: Values, args: List[Any]) -> None: + if args: + raise CommandError("Too many arguments") + + num_http_files = len(self._find_http_files(options)) + num_packages = len(self._find_wheels(options, "*")) + + http_cache_location = self._cache_dir(options, "http-v2") + old_http_cache_location = self._cache_dir(options, "http") + wheels_cache_location = self._cache_dir(options, "wheels") + http_cache_size = filesystem.format_size( + filesystem.directory_size(http_cache_location) + + filesystem.directory_size(old_http_cache_location) + ) + wheels_cache_size = filesystem.format_directory_size(wheels_cache_location) + + message = ( + textwrap.dedent( + """ + Package index page cache location (pip v23.3+): {http_cache_location} + Package index page cache location (older pips): {old_http_cache_location} + Package index page cache size: {http_cache_size} + Number of HTTP files: {num_http_files} + Locally built wheels location: {wheels_cache_location} + Locally built wheels size: {wheels_cache_size} + Number of locally built wheels: {package_count} + """ # noqa: E501 + ) + .format( + http_cache_location=http_cache_location, + old_http_cache_location=old_http_cache_location, + http_cache_size=http_cache_size, + num_http_files=num_http_files, + wheels_cache_location=wheels_cache_location, + package_count=num_packages, + wheels_cache_size=wheels_cache_size, + ) + .strip() + ) + + logger.info(message) + + def list_cache_items(self, options: Values, args: List[Any]) -> None: + if len(args) > 1: + raise CommandError("Too many arguments") + + if args: + pattern = args[0] + else: + pattern = "*" + + files = self._find_wheels(options, pattern) + if options.list_format == "human": + self.format_for_human(files) + else: + self.format_for_abspath(files) + + def format_for_human(self, files: List[str]) -> None: + if not files: + logger.info("No locally built wheels cached.") + return + + results = [] + for filename in files: + wheel = os.path.basename(filename) + size = filesystem.format_file_size(filename) + results.append(f" - {wheel} ({size})") + logger.info("Cache contents:\n") + logger.info("\n".join(sorted(results))) + + def format_for_abspath(self, files: List[str]) -> None: + if files: + logger.info("\n".join(sorted(files))) + + def remove_cache_items(self, options: Values, args: List[Any]) -> None: + if len(args) > 1: + raise CommandError("Too many arguments") + + if not args: + raise CommandError("Please provide a pattern") + + files = self._find_wheels(options, args[0]) + + no_matching_msg = "No matching packages" + if args[0] == "*": + # Only fetch http files if no specific pattern given + files += self._find_http_files(options) + else: + # Add the pattern to the log message + no_matching_msg += f' for pattern "{args[0]}"' + + if not files: + logger.warning(no_matching_msg) + + for filename in files: + os.unlink(filename) + logger.verbose("Removed %s", filename) + logger.info("Files removed: %s", len(files)) + + def purge_cache(self, options: Values, args: List[Any]) -> None: + if args: + raise CommandError("Too many arguments") + + return self.remove_cache_items(options, ["*"]) + + def _cache_dir(self, options: Values, subdir: str) -> str: + return os.path.join(options.cache_dir, subdir) + + def _find_http_files(self, options: Values) -> List[str]: + old_http_dir = self._cache_dir(options, "http") + new_http_dir = self._cache_dir(options, "http-v2") + return filesystem.find_files(old_http_dir, "*") + filesystem.find_files( + new_http_dir, "*" + ) + + def _find_wheels(self, options: Values, pattern: str) -> List[str]: + wheel_dir = self._cache_dir(options, "wheels") + + # The wheel filename format, as specified in PEP 427, is: + # {distribution}-{version}(-{build})?-{python}-{abi}-{platform}.whl + # + # Additionally, non-alphanumeric values in the distribution are + # normalized to underscores (_), meaning hyphens can never occur + # before `-{version}`. + # + # Given that information: + # - If the pattern we're given contains a hyphen (-), the user is + # providing at least the version. Thus, we can just append `*.whl` + # to match the rest of it. + # - If the pattern we're given doesn't contain a hyphen (-), the + # user is only providing the name. Thus, we append `-*.whl` to + # match the hyphen before the version, followed by anything else. + # + # PEP 427: https://www.python.org/dev/peps/pep-0427/ + pattern = pattern + ("*.whl" if "-" in pattern else "-*.whl") + + return filesystem.find_files(wheel_dir, pattern) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/commands/check.py b/.venv/lib/python3.12/site-packages/pip/_internal/commands/check.py new file mode 100644 index 0000000..f54a16d --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/commands/check.py @@ -0,0 +1,67 @@ +import logging +from optparse import Values +from typing import List + +from pip._internal.cli.base_command import Command +from pip._internal.cli.status_codes import ERROR, SUCCESS +from pip._internal.metadata import get_default_environment +from pip._internal.operations.check import ( + check_package_set, + check_unsupported, + create_package_set_from_installed, +) +from pip._internal.utils.compatibility_tags import get_supported +from pip._internal.utils.misc import write_output + +logger = logging.getLogger(__name__) + + +class CheckCommand(Command): + """Verify installed packages have compatible dependencies.""" + + ignore_require_venv = True + usage = """ + %prog [options]""" + + def run(self, options: Values, args: List[str]) -> int: + package_set, parsing_probs = create_package_set_from_installed() + missing, conflicting = check_package_set(package_set) + unsupported = list( + check_unsupported( + get_default_environment().iter_installed_distributions(), + get_supported(), + ) + ) + + for project_name in missing: + version = package_set[project_name].version + for dependency in missing[project_name]: + write_output( + "%s %s requires %s, which is not installed.", + project_name, + version, + dependency[0], + ) + + for project_name in conflicting: + version = package_set[project_name].version + for dep_name, dep_version, req in conflicting[project_name]: + write_output( + "%s %s has requirement %s, but you have %s %s.", + project_name, + version, + req, + dep_name, + dep_version, + ) + for package in unsupported: + write_output( + "%s %s is not supported on this platform", + package.raw_name, + package.version, + ) + if missing or conflicting or parsing_probs or unsupported: + return ERROR + else: + write_output("No broken requirements found.") + return SUCCESS diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/commands/completion.py b/.venv/lib/python3.12/site-packages/pip/_internal/commands/completion.py new file mode 100644 index 0000000..9e89e27 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/commands/completion.py @@ -0,0 +1,130 @@ +import sys +import textwrap +from optparse import Values +from typing import List + +from pip._internal.cli.base_command import Command +from pip._internal.cli.status_codes import SUCCESS +from pip._internal.utils.misc import get_prog + +BASE_COMPLETION = """ +# pip {shell} completion start{script}# pip {shell} completion end +""" + +COMPLETION_SCRIPTS = { + "bash": """ + _pip_completion() + {{ + COMPREPLY=( $( COMP_WORDS="${{COMP_WORDS[*]}}" \\ + COMP_CWORD=$COMP_CWORD \\ + PIP_AUTO_COMPLETE=1 $1 2>/dev/null ) ) + }} + complete -o default -F _pip_completion {prog} + """, + "zsh": """ + #compdef -P pip[0-9.]# + __pip() {{ + compadd $( COMP_WORDS="$words[*]" \\ + COMP_CWORD=$((CURRENT-1)) \\ + PIP_AUTO_COMPLETE=1 $words[1] 2>/dev/null ) + }} + if [[ $zsh_eval_context[-1] == loadautofunc ]]; then + # autoload from fpath, call function directly + __pip "$@" + else + # eval/source/. command, register function for later + compdef __pip -P 'pip[0-9.]#' + fi + """, + "fish": """ + function __fish_complete_pip + set -lx COMP_WORDS (commandline -o) "" + set -lx COMP_CWORD ( \\ + math (contains -i -- (commandline -t) $COMP_WORDS)-1 \\ + ) + set -lx PIP_AUTO_COMPLETE 1 + string split \\ -- (eval $COMP_WORDS[1]) + end + complete -fa "(__fish_complete_pip)" -c {prog} + """, + "powershell": """ + if ((Test-Path Function:\\TabExpansion) -and -not ` + (Test-Path Function:\\_pip_completeBackup)) {{ + Rename-Item Function:\\TabExpansion _pip_completeBackup + }} + function TabExpansion($line, $lastWord) {{ + $lastBlock = [regex]::Split($line, '[|;]')[-1].TrimStart() + if ($lastBlock.StartsWith("{prog} ")) {{ + $Env:COMP_WORDS=$lastBlock + $Env:COMP_CWORD=$lastBlock.Split().Length - 1 + $Env:PIP_AUTO_COMPLETE=1 + (& {prog}).Split() + Remove-Item Env:COMP_WORDS + Remove-Item Env:COMP_CWORD + Remove-Item Env:PIP_AUTO_COMPLETE + }} + elseif (Test-Path Function:\\_pip_completeBackup) {{ + # Fall back on existing tab expansion + _pip_completeBackup $line $lastWord + }} + }} + """, +} + + +class CompletionCommand(Command): + """A helper command to be used for command completion.""" + + ignore_require_venv = True + + def add_options(self) -> None: + self.cmd_opts.add_option( + "--bash", + "-b", + action="store_const", + const="bash", + dest="shell", + help="Emit completion code for bash", + ) + self.cmd_opts.add_option( + "--zsh", + "-z", + action="store_const", + const="zsh", + dest="shell", + help="Emit completion code for zsh", + ) + self.cmd_opts.add_option( + "--fish", + "-f", + action="store_const", + const="fish", + dest="shell", + help="Emit completion code for fish", + ) + self.cmd_opts.add_option( + "--powershell", + "-p", + action="store_const", + const="powershell", + dest="shell", + help="Emit completion code for powershell", + ) + + self.parser.insert_option_group(0, self.cmd_opts) + + def run(self, options: Values, args: List[str]) -> int: + """Prints the completion code of the given shell""" + shells = COMPLETION_SCRIPTS.keys() + shell_options = ["--" + shell for shell in sorted(shells)] + if options.shell in shells: + script = textwrap.dedent( + COMPLETION_SCRIPTS.get(options.shell, "").format(prog=get_prog()) + ) + print(BASE_COMPLETION.format(script=script, shell=options.shell)) + return SUCCESS + else: + sys.stderr.write( + "ERROR: You must pass {}\n".format(" or ".join(shell_options)) + ) + return SUCCESS diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/commands/configuration.py b/.venv/lib/python3.12/site-packages/pip/_internal/commands/configuration.py new file mode 100644 index 0000000..1a1dc6b --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/commands/configuration.py @@ -0,0 +1,280 @@ +import logging +import os +import subprocess +from optparse import Values +from typing import Any, List, Optional + +from pip._internal.cli.base_command import Command +from pip._internal.cli.status_codes import ERROR, SUCCESS +from pip._internal.configuration import ( + Configuration, + Kind, + get_configuration_files, + kinds, +) +from pip._internal.exceptions import PipError +from pip._internal.utils.logging import indent_log +from pip._internal.utils.misc import get_prog, write_output + +logger = logging.getLogger(__name__) + + +class ConfigurationCommand(Command): + """ + Manage local and global configuration. + + Subcommands: + + - list: List the active configuration (or from the file specified) + - edit: Edit the configuration file in an editor + - get: Get the value associated with command.option + - set: Set the command.option=value + - unset: Unset the value associated with command.option + - debug: List the configuration files and values defined under them + + Configuration keys should be dot separated command and option name, + with the special prefix "global" affecting any command. For example, + "pip config set global.index-url https://example.org/" would configure + the index url for all commands, but "pip config set download.timeout 10" + would configure a 10 second timeout only for "pip download" commands. + + If none of --user, --global and --site are passed, a virtual + environment configuration file is used if one is active and the file + exists. Otherwise, all modifications happen to the user file by + default. + """ + + ignore_require_venv = True + usage = """ + %prog [] list + %prog [] [--editor ] edit + + %prog [] get command.option + %prog [] set command.option value + %prog [] unset command.option + %prog [] debug + """ + + def add_options(self) -> None: + self.cmd_opts.add_option( + "--editor", + dest="editor", + action="store", + default=None, + help=( + "Editor to use to edit the file. Uses VISUAL or EDITOR " + "environment variables if not provided." + ), + ) + + self.cmd_opts.add_option( + "--global", + dest="global_file", + action="store_true", + default=False, + help="Use the system-wide configuration file only", + ) + + self.cmd_opts.add_option( + "--user", + dest="user_file", + action="store_true", + default=False, + help="Use the user configuration file only", + ) + + self.cmd_opts.add_option( + "--site", + dest="site_file", + action="store_true", + default=False, + help="Use the current environment configuration file only", + ) + + self.parser.insert_option_group(0, self.cmd_opts) + + def run(self, options: Values, args: List[str]) -> int: + handlers = { + "list": self.list_values, + "edit": self.open_in_editor, + "get": self.get_name, + "set": self.set_name_value, + "unset": self.unset_name, + "debug": self.list_config_values, + } + + # Determine action + if not args or args[0] not in handlers: + logger.error( + "Need an action (%s) to perform.", + ", ".join(sorted(handlers)), + ) + return ERROR + + action = args[0] + + # Determine which configuration files are to be loaded + # Depends on whether the command is modifying. + try: + load_only = self._determine_file( + options, need_value=(action in ["get", "set", "unset", "edit"]) + ) + except PipError as e: + logger.error(e.args[0]) + return ERROR + + # Load a new configuration + self.configuration = Configuration( + isolated=options.isolated_mode, load_only=load_only + ) + self.configuration.load() + + # Error handling happens here, not in the action-handlers. + try: + handlers[action](options, args[1:]) + except PipError as e: + logger.error(e.args[0]) + return ERROR + + return SUCCESS + + def _determine_file(self, options: Values, need_value: bool) -> Optional[Kind]: + file_options = [ + key + for key, value in ( + (kinds.USER, options.user_file), + (kinds.GLOBAL, options.global_file), + (kinds.SITE, options.site_file), + ) + if value + ] + + if not file_options: + if not need_value: + return None + # Default to user, unless there's a site file. + elif any( + os.path.exists(site_config_file) + for site_config_file in get_configuration_files()[kinds.SITE] + ): + return kinds.SITE + else: + return kinds.USER + elif len(file_options) == 1: + return file_options[0] + + raise PipError( + "Need exactly one file to operate upon " + "(--user, --site, --global) to perform." + ) + + def list_values(self, options: Values, args: List[str]) -> None: + self._get_n_args(args, "list", n=0) + + for key, value in sorted(self.configuration.items()): + write_output("%s=%r", key, value) + + def get_name(self, options: Values, args: List[str]) -> None: + key = self._get_n_args(args, "get [name]", n=1) + value = self.configuration.get_value(key) + + write_output("%s", value) + + def set_name_value(self, options: Values, args: List[str]) -> None: + key, value = self._get_n_args(args, "set [name] [value]", n=2) + self.configuration.set_value(key, value) + + self._save_configuration() + + def unset_name(self, options: Values, args: List[str]) -> None: + key = self._get_n_args(args, "unset [name]", n=1) + self.configuration.unset_value(key) + + self._save_configuration() + + def list_config_values(self, options: Values, args: List[str]) -> None: + """List config key-value pairs across different config files""" + self._get_n_args(args, "debug", n=0) + + self.print_env_var_values() + # Iterate over config files and print if they exist, and the + # key-value pairs present in them if they do + for variant, files in sorted(self.configuration.iter_config_files()): + write_output("%s:", variant) + for fname in files: + with indent_log(): + file_exists = os.path.exists(fname) + write_output("%s, exists: %r", fname, file_exists) + if file_exists: + self.print_config_file_values(variant) + + def print_config_file_values(self, variant: Kind) -> None: + """Get key-value pairs from the file of a variant""" + for name, value in self.configuration.get_values_in_config(variant).items(): + with indent_log(): + write_output("%s: %s", name, value) + + def print_env_var_values(self) -> None: + """Get key-values pairs present as environment variables""" + write_output("%s:", "env_var") + with indent_log(): + for key, value in sorted(self.configuration.get_environ_vars()): + env_var = f"PIP_{key.upper()}" + write_output("%s=%r", env_var, value) + + def open_in_editor(self, options: Values, args: List[str]) -> None: + editor = self._determine_editor(options) + + fname = self.configuration.get_file_to_edit() + if fname is None: + raise PipError("Could not determine appropriate file.") + elif '"' in fname: + # This shouldn't happen, unless we see a username like that. + # If that happens, we'd appreciate a pull request fixing this. + raise PipError( + f'Can not open an editor for a file name containing "\n{fname}' + ) + + try: + subprocess.check_call(f'{editor} "{fname}"', shell=True) + except FileNotFoundError as e: + if not e.filename: + e.filename = editor + raise + except subprocess.CalledProcessError as e: + raise PipError(f"Editor Subprocess exited with exit code {e.returncode}") + + def _get_n_args(self, args: List[str], example: str, n: int) -> Any: + """Helper to make sure the command got the right number of arguments""" + if len(args) != n: + msg = ( + f"Got unexpected number of arguments, expected {n}. " + f'(example: "{get_prog()} config {example}")' + ) + raise PipError(msg) + + if n == 1: + return args[0] + else: + return args + + def _save_configuration(self) -> None: + # We successfully ran a modifying command. Need to save the + # configuration. + try: + self.configuration.save() + except Exception: + logger.exception( + "Unable to save configuration. Please report this as a bug." + ) + raise PipError("Internal Error.") + + def _determine_editor(self, options: Values) -> str: + if options.editor is not None: + return options.editor + elif "VISUAL" in os.environ: + return os.environ["VISUAL"] + elif "EDITOR" in os.environ: + return os.environ["EDITOR"] + else: + raise PipError("Could not determine editor to use.") diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/commands/debug.py b/.venv/lib/python3.12/site-packages/pip/_internal/commands/debug.py new file mode 100644 index 0000000..567ca96 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/commands/debug.py @@ -0,0 +1,201 @@ +import locale +import logging +import os +import sys +from optparse import Values +from types import ModuleType +from typing import Any, Dict, List, Optional + +import pip._vendor +from pip._vendor.certifi import where +from pip._vendor.packaging.version import parse as parse_version + +from pip._internal.cli import cmdoptions +from pip._internal.cli.base_command import Command +from pip._internal.cli.cmdoptions import make_target_python +from pip._internal.cli.status_codes import SUCCESS +from pip._internal.configuration import Configuration +from pip._internal.metadata import get_environment +from pip._internal.utils.compat import open_text_resource +from pip._internal.utils.logging import indent_log +from pip._internal.utils.misc import get_pip_version + +logger = logging.getLogger(__name__) + + +def show_value(name: str, value: Any) -> None: + logger.info("%s: %s", name, value) + + +def show_sys_implementation() -> None: + logger.info("sys.implementation:") + implementation_name = sys.implementation.name + with indent_log(): + show_value("name", implementation_name) + + +def create_vendor_txt_map() -> Dict[str, str]: + with open_text_resource("pip._vendor", "vendor.txt") as f: + # Purge non version specifying lines. + # Also, remove any space prefix or suffixes (including comments). + lines = [ + line.strip().split(" ", 1)[0] for line in f.readlines() if "==" in line + ] + + # Transform into "module" -> version dict. + return dict(line.split("==", 1) for line in lines) + + +def get_module_from_module_name(module_name: str) -> Optional[ModuleType]: + # Module name can be uppercase in vendor.txt for some reason... + module_name = module_name.lower().replace("-", "_") + # PATCH: setuptools is actually only pkg_resources. + if module_name == "setuptools": + module_name = "pkg_resources" + + try: + __import__(f"pip._vendor.{module_name}", globals(), locals(), level=0) + return getattr(pip._vendor, module_name) + except ImportError: + # We allow 'truststore' to fail to import due + # to being unavailable on Python 3.9 and earlier. + if module_name == "truststore" and sys.version_info < (3, 10): + return None + raise + + +def get_vendor_version_from_module(module_name: str) -> Optional[str]: + module = get_module_from_module_name(module_name) + version = getattr(module, "__version__", None) + + if module and not version: + # Try to find version in debundled module info. + assert module.__file__ is not None + env = get_environment([os.path.dirname(module.__file__)]) + dist = env.get_distribution(module_name) + if dist: + version = str(dist.version) + + return version + + +def show_actual_vendor_versions(vendor_txt_versions: Dict[str, str]) -> None: + """Log the actual version and print extra info if there is + a conflict or if the actual version could not be imported. + """ + for module_name, expected_version in vendor_txt_versions.items(): + extra_message = "" + actual_version = get_vendor_version_from_module(module_name) + if not actual_version: + extra_message = ( + " (Unable to locate actual module version, using" + " vendor.txt specified version)" + ) + actual_version = expected_version + elif parse_version(actual_version) != parse_version(expected_version): + extra_message = ( + " (CONFLICT: vendor.txt suggests version should" + f" be {expected_version})" + ) + logger.info("%s==%s%s", module_name, actual_version, extra_message) + + +def show_vendor_versions() -> None: + logger.info("vendored library versions:") + + vendor_txt_versions = create_vendor_txt_map() + with indent_log(): + show_actual_vendor_versions(vendor_txt_versions) + + +def show_tags(options: Values) -> None: + tag_limit = 10 + + target_python = make_target_python(options) + tags = target_python.get_sorted_tags() + + # Display the target options that were explicitly provided. + formatted_target = target_python.format_given() + suffix = "" + if formatted_target: + suffix = f" (target: {formatted_target})" + + msg = f"Compatible tags: {len(tags)}{suffix}" + logger.info(msg) + + if options.verbose < 1 and len(tags) > tag_limit: + tags_limited = True + tags = tags[:tag_limit] + else: + tags_limited = False + + with indent_log(): + for tag in tags: + logger.info(str(tag)) + + if tags_limited: + msg = f"...\n[First {tag_limit} tags shown. Pass --verbose to show all.]" + logger.info(msg) + + +def ca_bundle_info(config: Configuration) -> str: + levels = {key.split(".", 1)[0] for key, _ in config.items()} + if not levels: + return "Not specified" + + levels_that_override_global = ["install", "wheel", "download"] + global_overriding_level = [ + level for level in levels if level in levels_that_override_global + ] + if not global_overriding_level: + return "global" + + if "global" in levels: + levels.remove("global") + return ", ".join(levels) + + +class DebugCommand(Command): + """ + Display debug information. + """ + + usage = """ + %prog """ + ignore_require_venv = True + + def add_options(self) -> None: + cmdoptions.add_target_python_options(self.cmd_opts) + self.parser.insert_option_group(0, self.cmd_opts) + self.parser.config.load() + + def run(self, options: Values, args: List[str]) -> int: + logger.warning( + "This command is only meant for debugging. " + "Do not use this with automation for parsing and getting these " + "details, since the output and options of this command may " + "change without notice." + ) + show_value("pip version", get_pip_version()) + show_value("sys.version", sys.version) + show_value("sys.executable", sys.executable) + show_value("sys.getdefaultencoding", sys.getdefaultencoding()) + show_value("sys.getfilesystemencoding", sys.getfilesystemencoding()) + show_value( + "locale.getpreferredencoding", + locale.getpreferredencoding(), + ) + show_value("sys.platform", sys.platform) + show_sys_implementation() + + show_value("'cert' config value", ca_bundle_info(self.parser.config)) + show_value("REQUESTS_CA_BUNDLE", os.environ.get("REQUESTS_CA_BUNDLE")) + show_value("CURL_CA_BUNDLE", os.environ.get("CURL_CA_BUNDLE")) + show_value("pip._vendor.certifi.where()", where()) + show_value("pip._vendor.DEBUNDLED", pip._vendor.DEBUNDLED) + + show_vendor_versions() + + show_tags(options) + + return SUCCESS diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/commands/download.py b/.venv/lib/python3.12/site-packages/pip/_internal/commands/download.py new file mode 100644 index 0000000..917bbb9 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/commands/download.py @@ -0,0 +1,146 @@ +import logging +import os +from optparse import Values +from typing import List + +from pip._internal.cli import cmdoptions +from pip._internal.cli.cmdoptions import make_target_python +from pip._internal.cli.req_command import RequirementCommand, with_cleanup +from pip._internal.cli.status_codes import SUCCESS +from pip._internal.operations.build.build_tracker import get_build_tracker +from pip._internal.req.req_install import check_legacy_setup_py_options +from pip._internal.utils.misc import ensure_dir, normalize_path, write_output +from pip._internal.utils.temp_dir import TempDirectory + +logger = logging.getLogger(__name__) + + +class DownloadCommand(RequirementCommand): + """ + Download packages from: + + - PyPI (and other indexes) using requirement specifiers. + - VCS project urls. + - Local project directories. + - Local or remote source archives. + + pip also supports downloading from "requirements files", which provide + an easy way to specify a whole environment to be downloaded. + """ + + usage = """ + %prog [options] [package-index-options] ... + %prog [options] -r [package-index-options] ... + %prog [options] ... + %prog [options] ... + %prog [options] ...""" + + def add_options(self) -> None: + self.cmd_opts.add_option(cmdoptions.constraints()) + self.cmd_opts.add_option(cmdoptions.requirements()) + self.cmd_opts.add_option(cmdoptions.no_deps()) + self.cmd_opts.add_option(cmdoptions.global_options()) + self.cmd_opts.add_option(cmdoptions.no_binary()) + self.cmd_opts.add_option(cmdoptions.only_binary()) + self.cmd_opts.add_option(cmdoptions.prefer_binary()) + self.cmd_opts.add_option(cmdoptions.src()) + self.cmd_opts.add_option(cmdoptions.pre()) + self.cmd_opts.add_option(cmdoptions.require_hashes()) + self.cmd_opts.add_option(cmdoptions.progress_bar()) + self.cmd_opts.add_option(cmdoptions.no_build_isolation()) + self.cmd_opts.add_option(cmdoptions.use_pep517()) + self.cmd_opts.add_option(cmdoptions.no_use_pep517()) + self.cmd_opts.add_option(cmdoptions.check_build_deps()) + self.cmd_opts.add_option(cmdoptions.ignore_requires_python()) + + self.cmd_opts.add_option( + "-d", + "--dest", + "--destination-dir", + "--destination-directory", + dest="download_dir", + metavar="dir", + default=os.curdir, + help="Download packages into .", + ) + + cmdoptions.add_target_python_options(self.cmd_opts) + + index_opts = cmdoptions.make_option_group( + cmdoptions.index_group, + self.parser, + ) + + self.parser.insert_option_group(0, index_opts) + self.parser.insert_option_group(0, self.cmd_opts) + + @with_cleanup + def run(self, options: Values, args: List[str]) -> int: + options.ignore_installed = True + # editable doesn't really make sense for `pip download`, but the bowels + # of the RequirementSet code require that property. + options.editables = [] + + cmdoptions.check_dist_restriction(options) + + options.download_dir = normalize_path(options.download_dir) + ensure_dir(options.download_dir) + + session = self.get_default_session(options) + + target_python = make_target_python(options) + finder = self._build_package_finder( + options=options, + session=session, + target_python=target_python, + ignore_requires_python=options.ignore_requires_python, + ) + + build_tracker = self.enter_context(get_build_tracker()) + + directory = TempDirectory( + delete=not options.no_clean, + kind="download", + globally_managed=True, + ) + + reqs = self.get_requirements(args, options, finder, session) + check_legacy_setup_py_options(options, reqs) + + preparer = self.make_requirement_preparer( + temp_build_dir=directory, + options=options, + build_tracker=build_tracker, + session=session, + finder=finder, + download_dir=options.download_dir, + use_user_site=False, + verbosity=self.verbosity, + ) + + resolver = self.make_resolver( + preparer=preparer, + finder=finder, + options=options, + ignore_requires_python=options.ignore_requires_python, + use_pep517=options.use_pep517, + py_version_info=options.python_version, + ) + + self.trace_basic_info(finder) + + requirement_set = resolver.resolve(reqs, check_supported_wheels=True) + + downloaded: List[str] = [] + for req in requirement_set.requirements.values(): + if req.satisfied_by is None: + assert req.name is not None + preparer.save_linked_requirement(req) + downloaded.append(req.name) + + preparer.prepare_linked_requirements_more(requirement_set.requirements.values()) + + if downloaded: + write_output("Successfully downloaded %s", " ".join(downloaded)) + + return SUCCESS diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/commands/freeze.py b/.venv/lib/python3.12/site-packages/pip/_internal/commands/freeze.py new file mode 100644 index 0000000..885fdfe --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/commands/freeze.py @@ -0,0 +1,109 @@ +import sys +from optparse import Values +from typing import AbstractSet, List + +from pip._internal.cli import cmdoptions +from pip._internal.cli.base_command import Command +from pip._internal.cli.status_codes import SUCCESS +from pip._internal.operations.freeze import freeze +from pip._internal.utils.compat import stdlib_pkgs + + +def _should_suppress_build_backends() -> bool: + return sys.version_info < (3, 12) + + +def _dev_pkgs() -> AbstractSet[str]: + pkgs = {"pip"} + + if _should_suppress_build_backends(): + pkgs |= {"setuptools", "distribute", "wheel"} + + return pkgs + + +class FreezeCommand(Command): + """ + Output installed packages in requirements format. + + packages are listed in a case-insensitive sorted order. + """ + + ignore_require_venv = True + usage = """ + %prog [options]""" + log_streams = ("ext://sys.stderr", "ext://sys.stderr") + + def add_options(self) -> None: + self.cmd_opts.add_option( + "-r", + "--requirement", + dest="requirements", + action="append", + default=[], + metavar="file", + help=( + "Use the order in the given requirements file and its " + "comments when generating output. This option can be " + "used multiple times." + ), + ) + self.cmd_opts.add_option( + "-l", + "--local", + dest="local", + action="store_true", + default=False, + help=( + "If in a virtualenv that has global access, do not output " + "globally-installed packages." + ), + ) + self.cmd_opts.add_option( + "--user", + dest="user", + action="store_true", + default=False, + help="Only output packages installed in user-site.", + ) + self.cmd_opts.add_option(cmdoptions.list_path()) + self.cmd_opts.add_option( + "--all", + dest="freeze_all", + action="store_true", + help=( + "Do not skip these packages in the output:" + " {}".format(", ".join(_dev_pkgs())) + ), + ) + self.cmd_opts.add_option( + "--exclude-editable", + dest="exclude_editable", + action="store_true", + help="Exclude editable package from output.", + ) + self.cmd_opts.add_option(cmdoptions.list_exclude()) + + self.parser.insert_option_group(0, self.cmd_opts) + + def run(self, options: Values, args: List[str]) -> int: + skip = set(stdlib_pkgs) + if not options.freeze_all: + skip.update(_dev_pkgs()) + + if options.excludes: + skip.update(options.excludes) + + cmdoptions.check_list_path_option(options) + + for line in freeze( + requirement=options.requirements, + local_only=options.local, + user_only=options.user, + paths=options.path, + isolated=options.isolated_mode, + skip=skip, + exclude_editable=options.exclude_editable, + ): + sys.stdout.write(line + "\n") + return SUCCESS diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/commands/hash.py b/.venv/lib/python3.12/site-packages/pip/_internal/commands/hash.py new file mode 100644 index 0000000..042dac8 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/commands/hash.py @@ -0,0 +1,59 @@ +import hashlib +import logging +import sys +from optparse import Values +from typing import List + +from pip._internal.cli.base_command import Command +from pip._internal.cli.status_codes import ERROR, SUCCESS +from pip._internal.utils.hashes import FAVORITE_HASH, STRONG_HASHES +from pip._internal.utils.misc import read_chunks, write_output + +logger = logging.getLogger(__name__) + + +class HashCommand(Command): + """ + Compute a hash of a local package archive. + + These can be used with --hash in a requirements file to do repeatable + installs. + """ + + usage = "%prog [options] ..." + ignore_require_venv = True + + def add_options(self) -> None: + self.cmd_opts.add_option( + "-a", + "--algorithm", + dest="algorithm", + choices=STRONG_HASHES, + action="store", + default=FAVORITE_HASH, + help="The hash algorithm to use: one of {}".format( + ", ".join(STRONG_HASHES) + ), + ) + self.parser.insert_option_group(0, self.cmd_opts) + + def run(self, options: Values, args: List[str]) -> int: + if not args: + self.parser.print_usage(sys.stderr) + return ERROR + + algorithm = options.algorithm + for path in args: + write_output( + "%s:\n--hash=%s:%s", path, algorithm, _hash_of_file(path, algorithm) + ) + return SUCCESS + + +def _hash_of_file(path: str, algorithm: str) -> str: + """Return the hash digest of a file.""" + with open(path, "rb") as archive: + hash = hashlib.new(algorithm) + for chunk in read_chunks(archive): + hash.update(chunk) + return hash.hexdigest() diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/commands/help.py b/.venv/lib/python3.12/site-packages/pip/_internal/commands/help.py new file mode 100644 index 0000000..6206631 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/commands/help.py @@ -0,0 +1,41 @@ +from optparse import Values +from typing import List + +from pip._internal.cli.base_command import Command +from pip._internal.cli.status_codes import SUCCESS +from pip._internal.exceptions import CommandError + + +class HelpCommand(Command): + """Show help for commands""" + + usage = """ + %prog """ + ignore_require_venv = True + + def run(self, options: Values, args: List[str]) -> int: + from pip._internal.commands import ( + commands_dict, + create_command, + get_similar_commands, + ) + + try: + # 'pip help' with no args is handled by pip.__init__.parseopt() + cmd_name = args[0] # the command we need help for + except IndexError: + return SUCCESS + + if cmd_name not in commands_dict: + guess = get_similar_commands(cmd_name) + + msg = [f'unknown command "{cmd_name}"'] + if guess: + msg.append(f'maybe you meant "{guess}"') + + raise CommandError(" - ".join(msg)) + + command = create_command(cmd_name) + command.parser.print_help() + + return SUCCESS diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/commands/index.py b/.venv/lib/python3.12/site-packages/pip/_internal/commands/index.py new file mode 100644 index 0000000..2e2661b --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/commands/index.py @@ -0,0 +1,139 @@ +import logging +from optparse import Values +from typing import Any, Iterable, List, Optional + +from pip._vendor.packaging.version import Version + +from pip._internal.cli import cmdoptions +from pip._internal.cli.req_command import IndexGroupCommand +from pip._internal.cli.status_codes import ERROR, SUCCESS +from pip._internal.commands.search import print_dist_installation_info +from pip._internal.exceptions import CommandError, DistributionNotFound, PipError +from pip._internal.index.collector import LinkCollector +from pip._internal.index.package_finder import PackageFinder +from pip._internal.models.selection_prefs import SelectionPreferences +from pip._internal.models.target_python import TargetPython +from pip._internal.network.session import PipSession +from pip._internal.utils.misc import write_output + +logger = logging.getLogger(__name__) + + +class IndexCommand(IndexGroupCommand): + """ + Inspect information available from package indexes. + """ + + ignore_require_venv = True + usage = """ + %prog versions + """ + + def add_options(self) -> None: + cmdoptions.add_target_python_options(self.cmd_opts) + + self.cmd_opts.add_option(cmdoptions.ignore_requires_python()) + self.cmd_opts.add_option(cmdoptions.pre()) + self.cmd_opts.add_option(cmdoptions.no_binary()) + self.cmd_opts.add_option(cmdoptions.only_binary()) + + index_opts = cmdoptions.make_option_group( + cmdoptions.index_group, + self.parser, + ) + + self.parser.insert_option_group(0, index_opts) + self.parser.insert_option_group(0, self.cmd_opts) + + def run(self, options: Values, args: List[str]) -> int: + handlers = { + "versions": self.get_available_package_versions, + } + + logger.warning( + "pip index is currently an experimental command. " + "It may be removed/changed in a future release " + "without prior warning." + ) + + # Determine action + if not args or args[0] not in handlers: + logger.error( + "Need an action (%s) to perform.", + ", ".join(sorted(handlers)), + ) + return ERROR + + action = args[0] + + # Error handling happens here, not in the action-handlers. + try: + handlers[action](options, args[1:]) + except PipError as e: + logger.error(e.args[0]) + return ERROR + + return SUCCESS + + def _build_package_finder( + self, + options: Values, + session: PipSession, + target_python: Optional[TargetPython] = None, + ignore_requires_python: Optional[bool] = None, + ) -> PackageFinder: + """ + Create a package finder appropriate to the index command. + """ + link_collector = LinkCollector.create(session, options=options) + + # Pass allow_yanked=False to ignore yanked versions. + selection_prefs = SelectionPreferences( + allow_yanked=False, + allow_all_prereleases=options.pre, + ignore_requires_python=ignore_requires_python, + ) + + return PackageFinder.create( + link_collector=link_collector, + selection_prefs=selection_prefs, + target_python=target_python, + ) + + def get_available_package_versions(self, options: Values, args: List[Any]) -> None: + if len(args) != 1: + raise CommandError("You need to specify exactly one argument") + + target_python = cmdoptions.make_target_python(options) + query = args[0] + + with self._build_session(options) as session: + finder = self._build_package_finder( + options=options, + session=session, + target_python=target_python, + ignore_requires_python=options.ignore_requires_python, + ) + + versions: Iterable[Version] = ( + candidate.version for candidate in finder.find_all_candidates(query) + ) + + if not options.pre: + # Remove prereleases + versions = ( + version for version in versions if not version.is_prerelease + ) + versions = set(versions) + + if not versions: + raise DistributionNotFound( + f"No matching distribution found for {query}" + ) + + formatted_versions = [str(ver) for ver in sorted(versions, reverse=True)] + latest = formatted_versions[0] + + write_output(f"{query} ({latest})") + write_output("Available versions: {}".format(", ".join(formatted_versions))) + print_dist_installation_info(query, latest) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/commands/inspect.py b/.venv/lib/python3.12/site-packages/pip/_internal/commands/inspect.py new file mode 100644 index 0000000..e810c13 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/commands/inspect.py @@ -0,0 +1,92 @@ +import logging +from optparse import Values +from typing import Any, Dict, List + +from pip._vendor.packaging.markers import default_environment +from pip._vendor.rich import print_json + +from pip import __version__ +from pip._internal.cli import cmdoptions +from pip._internal.cli.base_command import Command +from pip._internal.cli.status_codes import SUCCESS +from pip._internal.metadata import BaseDistribution, get_environment +from pip._internal.utils.compat import stdlib_pkgs +from pip._internal.utils.urls import path_to_url + +logger = logging.getLogger(__name__) + + +class InspectCommand(Command): + """ + Inspect the content of a Python environment and produce a report in JSON format. + """ + + ignore_require_venv = True + usage = """ + %prog [options]""" + + def add_options(self) -> None: + self.cmd_opts.add_option( + "--local", + action="store_true", + default=False, + help=( + "If in a virtualenv that has global access, do not list " + "globally-installed packages." + ), + ) + self.cmd_opts.add_option( + "--user", + dest="user", + action="store_true", + default=False, + help="Only output packages installed in user-site.", + ) + self.cmd_opts.add_option(cmdoptions.list_path()) + self.parser.insert_option_group(0, self.cmd_opts) + + def run(self, options: Values, args: List[str]) -> int: + cmdoptions.check_list_path_option(options) + dists = get_environment(options.path).iter_installed_distributions( + local_only=options.local, + user_only=options.user, + skip=set(stdlib_pkgs), + ) + output = { + "version": "1", + "pip_version": __version__, + "installed": [self._dist_to_dict(dist) for dist in dists], + "environment": default_environment(), + # TODO tags? scheme? + } + print_json(data=output) + return SUCCESS + + def _dist_to_dict(self, dist: BaseDistribution) -> Dict[str, Any]: + res: Dict[str, Any] = { + "metadata": dist.metadata_dict, + "metadata_location": dist.info_location, + } + # direct_url. Note that we don't have download_info (as in the installation + # report) since it is not recorded in installed metadata. + direct_url = dist.direct_url + if direct_url is not None: + res["direct_url"] = direct_url.to_dict() + else: + # Emulate direct_url for legacy editable installs. + editable_project_location = dist.editable_project_location + if editable_project_location is not None: + res["direct_url"] = { + "url": path_to_url(editable_project_location), + "dir_info": { + "editable": True, + }, + } + # installer + installer = dist.installer + if dist.installer: + res["installer"] = installer + # requested + if dist.installed_with_dist_info: + res["requested"] = dist.requested + return res diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/commands/install.py b/.venv/lib/python3.12/site-packages/pip/_internal/commands/install.py new file mode 100644 index 0000000..ad45a2f --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/commands/install.py @@ -0,0 +1,783 @@ +import errno +import json +import operator +import os +import shutil +import site +from optparse import SUPPRESS_HELP, Values +from typing import List, Optional + +from pip._vendor.packaging.utils import canonicalize_name +from pip._vendor.rich import print_json + +from pip._internal.cache import WheelCache +from pip._internal.cli import cmdoptions +from pip._internal.cli.cmdoptions import make_target_python +from pip._internal.cli.req_command import ( + RequirementCommand, + with_cleanup, +) +from pip._internal.cli.status_codes import ERROR, SUCCESS +from pip._internal.exceptions import CommandError, InstallationError +from pip._internal.locations import get_scheme +from pip._internal.metadata import get_environment +from pip._internal.models.installation_report import InstallationReport +from pip._internal.operations.build.build_tracker import get_build_tracker +from pip._internal.operations.check import ConflictDetails, check_install_conflicts +from pip._internal.req import install_given_reqs +from pip._internal.req.req_install import ( + InstallRequirement, + check_legacy_setup_py_options, +) +from pip._internal.utils.compat import WINDOWS +from pip._internal.utils.filesystem import test_writable_dir +from pip._internal.utils.logging import getLogger +from pip._internal.utils.misc import ( + check_externally_managed, + ensure_dir, + get_pip_version, + protect_pip_from_modification_on_windows, + warn_if_run_as_root, + write_output, +) +from pip._internal.utils.temp_dir import TempDirectory +from pip._internal.utils.virtualenv import ( + running_under_virtualenv, + virtualenv_no_global, +) +from pip._internal.wheel_builder import build, should_build_for_install_command + +logger = getLogger(__name__) + + +class InstallCommand(RequirementCommand): + """ + Install packages from: + + - PyPI (and other indexes) using requirement specifiers. + - VCS project urls. + - Local project directories. + - Local or remote source archives. + + pip also supports installing from "requirements files", which provide + an easy way to specify a whole environment to be installed. + """ + + usage = """ + %prog [options] [package-index-options] ... + %prog [options] -r [package-index-options] ... + %prog [options] [-e] ... + %prog [options] [-e] ... + %prog [options] ...""" + + def add_options(self) -> None: + self.cmd_opts.add_option(cmdoptions.requirements()) + self.cmd_opts.add_option(cmdoptions.constraints()) + self.cmd_opts.add_option(cmdoptions.no_deps()) + self.cmd_opts.add_option(cmdoptions.pre()) + + self.cmd_opts.add_option(cmdoptions.editable()) + self.cmd_opts.add_option( + "--dry-run", + action="store_true", + dest="dry_run", + default=False, + help=( + "Don't actually install anything, just print what would be. " + "Can be used in combination with --ignore-installed " + "to 'resolve' the requirements." + ), + ) + self.cmd_opts.add_option( + "-t", + "--target", + dest="target_dir", + metavar="dir", + default=None, + help=( + "Install packages into . " + "By default this will not replace existing files/folders in " + ". Use --upgrade to replace existing packages in " + "with new versions." + ), + ) + cmdoptions.add_target_python_options(self.cmd_opts) + + self.cmd_opts.add_option( + "--user", + dest="use_user_site", + action="store_true", + help=( + "Install to the Python user install directory for your " + "platform. Typically ~/.local/, or %APPDATA%\\Python on " + "Windows. (See the Python documentation for site.USER_BASE " + "for full details.)" + ), + ) + self.cmd_opts.add_option( + "--no-user", + dest="use_user_site", + action="store_false", + help=SUPPRESS_HELP, + ) + self.cmd_opts.add_option( + "--root", + dest="root_path", + metavar="dir", + default=None, + help="Install everything relative to this alternate root directory.", + ) + self.cmd_opts.add_option( + "--prefix", + dest="prefix_path", + metavar="dir", + default=None, + help=( + "Installation prefix where lib, bin and other top-level " + "folders are placed. Note that the resulting installation may " + "contain scripts and other resources which reference the " + "Python interpreter of pip, and not that of ``--prefix``. " + "See also the ``--python`` option if the intention is to " + "install packages into another (possibly pip-free) " + "environment." + ), + ) + + self.cmd_opts.add_option(cmdoptions.src()) + + self.cmd_opts.add_option( + "-U", + "--upgrade", + dest="upgrade", + action="store_true", + help=( + "Upgrade all specified packages to the newest available " + "version. The handling of dependencies depends on the " + "upgrade-strategy used." + ), + ) + + self.cmd_opts.add_option( + "--upgrade-strategy", + dest="upgrade_strategy", + default="only-if-needed", + choices=["only-if-needed", "eager"], + help=( + "Determines how dependency upgrading should be handled " + "[default: %default]. " + '"eager" - dependencies are upgraded regardless of ' + "whether the currently installed version satisfies the " + "requirements of the upgraded package(s). " + '"only-if-needed" - are upgraded only when they do not ' + "satisfy the requirements of the upgraded package(s)." + ), + ) + + self.cmd_opts.add_option( + "--force-reinstall", + dest="force_reinstall", + action="store_true", + help="Reinstall all packages even if they are already up-to-date.", + ) + + self.cmd_opts.add_option( + "-I", + "--ignore-installed", + dest="ignore_installed", + action="store_true", + help=( + "Ignore the installed packages, overwriting them. " + "This can break your system if the existing package " + "is of a different version or was installed " + "with a different package manager!" + ), + ) + + self.cmd_opts.add_option(cmdoptions.ignore_requires_python()) + self.cmd_opts.add_option(cmdoptions.no_build_isolation()) + self.cmd_opts.add_option(cmdoptions.use_pep517()) + self.cmd_opts.add_option(cmdoptions.no_use_pep517()) + self.cmd_opts.add_option(cmdoptions.check_build_deps()) + self.cmd_opts.add_option(cmdoptions.override_externally_managed()) + + self.cmd_opts.add_option(cmdoptions.config_settings()) + self.cmd_opts.add_option(cmdoptions.global_options()) + + self.cmd_opts.add_option( + "--compile", + action="store_true", + dest="compile", + default=True, + help="Compile Python source files to bytecode", + ) + + self.cmd_opts.add_option( + "--no-compile", + action="store_false", + dest="compile", + help="Do not compile Python source files to bytecode", + ) + + self.cmd_opts.add_option( + "--no-warn-script-location", + action="store_false", + dest="warn_script_location", + default=True, + help="Do not warn when installing scripts outside PATH", + ) + self.cmd_opts.add_option( + "--no-warn-conflicts", + action="store_false", + dest="warn_about_conflicts", + default=True, + help="Do not warn about broken dependencies", + ) + self.cmd_opts.add_option(cmdoptions.no_binary()) + self.cmd_opts.add_option(cmdoptions.only_binary()) + self.cmd_opts.add_option(cmdoptions.prefer_binary()) + self.cmd_opts.add_option(cmdoptions.require_hashes()) + self.cmd_opts.add_option(cmdoptions.progress_bar()) + self.cmd_opts.add_option(cmdoptions.root_user_action()) + + index_opts = cmdoptions.make_option_group( + cmdoptions.index_group, + self.parser, + ) + + self.parser.insert_option_group(0, index_opts) + self.parser.insert_option_group(0, self.cmd_opts) + + self.cmd_opts.add_option( + "--report", + dest="json_report_file", + metavar="file", + default=None, + help=( + "Generate a JSON file describing what pip did to install " + "the provided requirements. " + "Can be used in combination with --dry-run and --ignore-installed " + "to 'resolve' the requirements. " + "When - is used as file name it writes to stdout. " + "When writing to stdout, please combine with the --quiet option " + "to avoid mixing pip logging output with JSON output." + ), + ) + + @with_cleanup + def run(self, options: Values, args: List[str]) -> int: + if options.use_user_site and options.target_dir is not None: + raise CommandError("Can not combine '--user' and '--target'") + + # Check whether the environment we're installing into is externally + # managed, as specified in PEP 668. Specifying --root, --target, or + # --prefix disables the check, since there's no reliable way to locate + # the EXTERNALLY-MANAGED file for those cases. An exception is also + # made specifically for "--dry-run --report" for convenience. + installing_into_current_environment = ( + not (options.dry_run and options.json_report_file) + and options.root_path is None + and options.target_dir is None + and options.prefix_path is None + ) + if ( + installing_into_current_environment + and not options.override_externally_managed + ): + check_externally_managed() + + upgrade_strategy = "to-satisfy-only" + if options.upgrade: + upgrade_strategy = options.upgrade_strategy + + cmdoptions.check_dist_restriction(options, check_target=True) + + logger.verbose("Using %s", get_pip_version()) + options.use_user_site = decide_user_install( + options.use_user_site, + prefix_path=options.prefix_path, + target_dir=options.target_dir, + root_path=options.root_path, + isolated_mode=options.isolated_mode, + ) + + target_temp_dir: Optional[TempDirectory] = None + target_temp_dir_path: Optional[str] = None + if options.target_dir: + options.ignore_installed = True + options.target_dir = os.path.abspath(options.target_dir) + if ( + # fmt: off + os.path.exists(options.target_dir) and + not os.path.isdir(options.target_dir) + # fmt: on + ): + raise CommandError( + "Target path exists but is not a directory, will not continue." + ) + + # Create a target directory for using with the target option + target_temp_dir = TempDirectory(kind="target") + target_temp_dir_path = target_temp_dir.path + self.enter_context(target_temp_dir) + + global_options = options.global_options or [] + + session = self.get_default_session(options) + + target_python = make_target_python(options) + finder = self._build_package_finder( + options=options, + session=session, + target_python=target_python, + ignore_requires_python=options.ignore_requires_python, + ) + build_tracker = self.enter_context(get_build_tracker()) + + directory = TempDirectory( + delete=not options.no_clean, + kind="install", + globally_managed=True, + ) + + try: + reqs = self.get_requirements(args, options, finder, session) + check_legacy_setup_py_options(options, reqs) + + wheel_cache = WheelCache(options.cache_dir) + + # Only when installing is it permitted to use PEP 660. + # In other circumstances (pip wheel, pip download) we generate + # regular (i.e. non editable) metadata and wheels. + for req in reqs: + req.permit_editable_wheels = True + + preparer = self.make_requirement_preparer( + temp_build_dir=directory, + options=options, + build_tracker=build_tracker, + session=session, + finder=finder, + use_user_site=options.use_user_site, + verbosity=self.verbosity, + ) + resolver = self.make_resolver( + preparer=preparer, + finder=finder, + options=options, + wheel_cache=wheel_cache, + use_user_site=options.use_user_site, + ignore_installed=options.ignore_installed, + ignore_requires_python=options.ignore_requires_python, + force_reinstall=options.force_reinstall, + upgrade_strategy=upgrade_strategy, + use_pep517=options.use_pep517, + py_version_info=options.python_version, + ) + + self.trace_basic_info(finder) + + requirement_set = resolver.resolve( + reqs, check_supported_wheels=not options.target_dir + ) + + if options.json_report_file: + report = InstallationReport(requirement_set.requirements_to_install) + if options.json_report_file == "-": + print_json(data=report.to_dict()) + else: + with open(options.json_report_file, "w", encoding="utf-8") as f: + json.dump(report.to_dict(), f, indent=2, ensure_ascii=False) + + if options.dry_run: + would_install_items = sorted( + (r.metadata["name"], r.metadata["version"]) + for r in requirement_set.requirements_to_install + ) + if would_install_items: + write_output( + "Would install %s", + " ".join("-".join(item) for item in would_install_items), + ) + return SUCCESS + + try: + pip_req = requirement_set.get_requirement("pip") + except KeyError: + modifying_pip = False + else: + # If we're not replacing an already installed pip, + # we're not modifying it. + modifying_pip = pip_req.satisfied_by is None + if modifying_pip: + # Eagerly import this module to avoid crashes. Otherwise, this + # module would be imported *after* pip was replaced, resulting in + # crashes if the new self_outdated_check module was incompatible + # with the rest of pip that's already imported. + import pip._internal.self_outdated_check # noqa: F401 + protect_pip_from_modification_on_windows(modifying_pip=modifying_pip) + + reqs_to_build = [ + r + for r in requirement_set.requirements.values() + if should_build_for_install_command(r) + ] + + _, build_failures = build( + reqs_to_build, + wheel_cache=wheel_cache, + verify=True, + build_options=[], + global_options=global_options, + ) + + if build_failures: + raise InstallationError( + "ERROR: Failed to build installable wheels for some " + "pyproject.toml based projects ({})".format( + ", ".join(r.name for r in build_failures) # type: ignore + ) + ) + + to_install = resolver.get_installation_order(requirement_set) + + # Check for conflicts in the package set we're installing. + conflicts: Optional[ConflictDetails] = None + should_warn_about_conflicts = ( + not options.ignore_dependencies and options.warn_about_conflicts + ) + if should_warn_about_conflicts: + conflicts = self._determine_conflicts(to_install) + + # Don't warn about script install locations if + # --target or --prefix has been specified + warn_script_location = options.warn_script_location + if options.target_dir or options.prefix_path: + warn_script_location = False + + installed = install_given_reqs( + to_install, + global_options, + root=options.root_path, + home=target_temp_dir_path, + prefix=options.prefix_path, + warn_script_location=warn_script_location, + use_user_site=options.use_user_site, + pycompile=options.compile, + ) + + lib_locations = get_lib_location_guesses( + user=options.use_user_site, + home=target_temp_dir_path, + root=options.root_path, + prefix=options.prefix_path, + isolated=options.isolated_mode, + ) + env = get_environment(lib_locations) + + # Display a summary of installed packages, with extra care to + # display a package name as it was requested by the user. + installed.sort(key=operator.attrgetter("name")) + summary = [] + installed_versions = {} + for distribution in env.iter_all_distributions(): + installed_versions[distribution.canonical_name] = distribution.version + for package in installed: + display_name = package.name + version = installed_versions.get(canonicalize_name(display_name), None) + if version: + text = f"{display_name}-{version}" + else: + text = display_name + summary.append(text) + + if conflicts is not None: + self._warn_about_conflicts( + conflicts, + resolver_variant=self.determine_resolver_variant(options), + ) + + installed_desc = " ".join(summary) + if installed_desc: + write_output( + "Successfully installed %s", + installed_desc, + ) + except OSError as error: + show_traceback = self.verbosity >= 1 + + message = create_os_error_message( + error, + show_traceback, + options.use_user_site, + ) + logger.error(message, exc_info=show_traceback) + + return ERROR + + if options.target_dir: + assert target_temp_dir + self._handle_target_dir( + options.target_dir, target_temp_dir, options.upgrade + ) + if options.root_user_action == "warn": + warn_if_run_as_root() + return SUCCESS + + def _handle_target_dir( + self, target_dir: str, target_temp_dir: TempDirectory, upgrade: bool + ) -> None: + ensure_dir(target_dir) + + # Checking both purelib and platlib directories for installed + # packages to be moved to target directory + lib_dir_list = [] + + # Checking both purelib and platlib directories for installed + # packages to be moved to target directory + scheme = get_scheme("", home=target_temp_dir.path) + purelib_dir = scheme.purelib + platlib_dir = scheme.platlib + data_dir = scheme.data + + if os.path.exists(purelib_dir): + lib_dir_list.append(purelib_dir) + if os.path.exists(platlib_dir) and platlib_dir != purelib_dir: + lib_dir_list.append(platlib_dir) + if os.path.exists(data_dir): + lib_dir_list.append(data_dir) + + for lib_dir in lib_dir_list: + for item in os.listdir(lib_dir): + if lib_dir == data_dir: + ddir = os.path.join(data_dir, item) + if any(s.startswith(ddir) for s in lib_dir_list[:-1]): + continue + target_item_dir = os.path.join(target_dir, item) + if os.path.exists(target_item_dir): + if not upgrade: + logger.warning( + "Target directory %s already exists. Specify " + "--upgrade to force replacement.", + target_item_dir, + ) + continue + if os.path.islink(target_item_dir): + logger.warning( + "Target directory %s already exists and is " + "a link. pip will not automatically replace " + "links, please remove if replacement is " + "desired.", + target_item_dir, + ) + continue + if os.path.isdir(target_item_dir): + shutil.rmtree(target_item_dir) + else: + os.remove(target_item_dir) + + shutil.move(os.path.join(lib_dir, item), target_item_dir) + + def _determine_conflicts( + self, to_install: List[InstallRequirement] + ) -> Optional[ConflictDetails]: + try: + return check_install_conflicts(to_install) + except Exception: + logger.exception( + "Error while checking for conflicts. Please file an issue on " + "pip's issue tracker: https://github.com/pypa/pip/issues/new" + ) + return None + + def _warn_about_conflicts( + self, conflict_details: ConflictDetails, resolver_variant: str + ) -> None: + package_set, (missing, conflicting) = conflict_details + if not missing and not conflicting: + return + + parts: List[str] = [] + if resolver_variant == "legacy": + parts.append( + "pip's legacy dependency resolver does not consider dependency " + "conflicts when selecting packages. This behaviour is the " + "source of the following dependency conflicts." + ) + else: + assert resolver_variant == "resolvelib" + parts.append( + "pip's dependency resolver does not currently take into account " + "all the packages that are installed. This behaviour is the " + "source of the following dependency conflicts." + ) + + # NOTE: There is some duplication here, with commands/check.py + for project_name in missing: + version = package_set[project_name][0] + for dependency in missing[project_name]: + message = ( + f"{project_name} {version} requires {dependency[1]}, " + "which is not installed." + ) + parts.append(message) + + for project_name in conflicting: + version = package_set[project_name][0] + for dep_name, dep_version, req in conflicting[project_name]: + message = ( + "{name} {version} requires {requirement}, but {you} have " + "{dep_name} {dep_version} which is incompatible." + ).format( + name=project_name, + version=version, + requirement=req, + dep_name=dep_name, + dep_version=dep_version, + you=("you" if resolver_variant == "resolvelib" else "you'll"), + ) + parts.append(message) + + logger.critical("\n".join(parts)) + + +def get_lib_location_guesses( + user: bool = False, + home: Optional[str] = None, + root: Optional[str] = None, + isolated: bool = False, + prefix: Optional[str] = None, +) -> List[str]: + scheme = get_scheme( + "", + user=user, + home=home, + root=root, + isolated=isolated, + prefix=prefix, + ) + return [scheme.purelib, scheme.platlib] + + +def site_packages_writable(root: Optional[str], isolated: bool) -> bool: + return all( + test_writable_dir(d) + for d in set(get_lib_location_guesses(root=root, isolated=isolated)) + ) + + +def decide_user_install( + use_user_site: Optional[bool], + prefix_path: Optional[str] = None, + target_dir: Optional[str] = None, + root_path: Optional[str] = None, + isolated_mode: bool = False, +) -> bool: + """Determine whether to do a user install based on the input options. + + If use_user_site is False, no additional checks are done. + If use_user_site is True, it is checked for compatibility with other + options. + If use_user_site is None, the default behaviour depends on the environment, + which is provided by the other arguments. + """ + # In some cases (config from tox), use_user_site can be set to an integer + # rather than a bool, which 'use_user_site is False' wouldn't catch. + if (use_user_site is not None) and (not use_user_site): + logger.debug("Non-user install by explicit request") + return False + + if use_user_site: + if prefix_path: + raise CommandError( + "Can not combine '--user' and '--prefix' as they imply " + "different installation locations" + ) + if virtualenv_no_global(): + raise InstallationError( + "Can not perform a '--user' install. User site-packages " + "are not visible in this virtualenv." + ) + logger.debug("User install by explicit request") + return True + + # If we are here, user installs have not been explicitly requested/avoided + assert use_user_site is None + + # user install incompatible with --prefix/--target + if prefix_path or target_dir: + logger.debug("Non-user install due to --prefix or --target option") + return False + + # If user installs are not enabled, choose a non-user install + if not site.ENABLE_USER_SITE: + logger.debug("Non-user install because user site-packages disabled") + return False + + # If we have permission for a non-user install, do that, + # otherwise do a user install. + if site_packages_writable(root=root_path, isolated=isolated_mode): + logger.debug("Non-user install because site-packages writeable") + return False + + logger.info( + "Defaulting to user installation because normal site-packages " + "is not writeable" + ) + return True + + +def create_os_error_message( + error: OSError, show_traceback: bool, using_user_site: bool +) -> str: + """Format an error message for an OSError + + It may occur anytime during the execution of the install command. + """ + parts = [] + + # Mention the error if we are not going to show a traceback + parts.append("Could not install packages due to an OSError") + if not show_traceback: + parts.append(": ") + parts.append(str(error)) + else: + parts.append(".") + + # Spilt the error indication from a helper message (if any) + parts[-1] += "\n" + + # Suggest useful actions to the user: + # (1) using user site-packages or (2) verifying the permissions + if error.errno == errno.EACCES: + user_option_part = "Consider using the `--user` option" + permissions_part = "Check the permissions" + + if not running_under_virtualenv() and not using_user_site: + parts.extend( + [ + user_option_part, + " or ", + permissions_part.lower(), + ] + ) + else: + parts.append(permissions_part) + parts.append(".\n") + + # Suggest the user to enable Long Paths if path length is + # more than 260 + if ( + WINDOWS + and error.errno == errno.ENOENT + and error.filename + and len(error.filename) > 260 + ): + parts.append( + "HINT: This error might have occurred since " + "this system does not have Windows Long Path " + "support enabled. You can find information on " + "how to enable this at " + "https://pip.pypa.io/warnings/enable-long-paths\n" + ) + + return "".join(parts).strip() + "\n" diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/commands/list.py b/.venv/lib/python3.12/site-packages/pip/_internal/commands/list.py new file mode 100644 index 0000000..82fc46a --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/commands/list.py @@ -0,0 +1,375 @@ +import json +import logging +from optparse import Values +from typing import TYPE_CHECKING, Generator, List, Optional, Sequence, Tuple, cast + +from pip._vendor.packaging.utils import canonicalize_name +from pip._vendor.packaging.version import Version + +from pip._internal.cli import cmdoptions +from pip._internal.cli.index_command import IndexGroupCommand +from pip._internal.cli.status_codes import SUCCESS +from pip._internal.exceptions import CommandError +from pip._internal.metadata import BaseDistribution, get_environment +from pip._internal.models.selection_prefs import SelectionPreferences +from pip._internal.utils.compat import stdlib_pkgs +from pip._internal.utils.misc import tabulate, write_output + +if TYPE_CHECKING: + from pip._internal.index.package_finder import PackageFinder + from pip._internal.network.session import PipSession + + class _DistWithLatestInfo(BaseDistribution): + """Give the distribution object a couple of extra fields. + + These will be populated during ``get_outdated()``. This is dirty but + makes the rest of the code much cleaner. + """ + + latest_version: Version + latest_filetype: str + + _ProcessedDists = Sequence[_DistWithLatestInfo] + + +logger = logging.getLogger(__name__) + + +class ListCommand(IndexGroupCommand): + """ + List installed packages, including editables. + + Packages are listed in a case-insensitive sorted order. + """ + + ignore_require_venv = True + usage = """ + %prog [options]""" + + def add_options(self) -> None: + self.cmd_opts.add_option( + "-o", + "--outdated", + action="store_true", + default=False, + help="List outdated packages", + ) + self.cmd_opts.add_option( + "-u", + "--uptodate", + action="store_true", + default=False, + help="List uptodate packages", + ) + self.cmd_opts.add_option( + "-e", + "--editable", + action="store_true", + default=False, + help="List editable projects.", + ) + self.cmd_opts.add_option( + "-l", + "--local", + action="store_true", + default=False, + help=( + "If in a virtualenv that has global access, do not list " + "globally-installed packages." + ), + ) + self.cmd_opts.add_option( + "--user", + dest="user", + action="store_true", + default=False, + help="Only output packages installed in user-site.", + ) + self.cmd_opts.add_option(cmdoptions.list_path()) + self.cmd_opts.add_option( + "--pre", + action="store_true", + default=False, + help=( + "Include pre-release and development versions. By default, " + "pip only finds stable versions." + ), + ) + + self.cmd_opts.add_option( + "--format", + action="store", + dest="list_format", + default="columns", + choices=("columns", "freeze", "json"), + help=( + "Select the output format among: columns (default), freeze, or json. " + "The 'freeze' format cannot be used with the --outdated option." + ), + ) + + self.cmd_opts.add_option( + "--not-required", + action="store_true", + dest="not_required", + help="List packages that are not dependencies of installed packages.", + ) + + self.cmd_opts.add_option( + "--exclude-editable", + action="store_false", + dest="include_editable", + help="Exclude editable package from output.", + ) + self.cmd_opts.add_option( + "--include-editable", + action="store_true", + dest="include_editable", + help="Include editable package from output.", + default=True, + ) + self.cmd_opts.add_option(cmdoptions.list_exclude()) + index_opts = cmdoptions.make_option_group(cmdoptions.index_group, self.parser) + + self.parser.insert_option_group(0, index_opts) + self.parser.insert_option_group(0, self.cmd_opts) + + def handle_pip_version_check(self, options: Values) -> None: + if options.outdated or options.uptodate: + super().handle_pip_version_check(options) + + def _build_package_finder( + self, options: Values, session: "PipSession" + ) -> "PackageFinder": + """ + Create a package finder appropriate to this list command. + """ + # Lazy import the heavy index modules as most list invocations won't need 'em. + from pip._internal.index.collector import LinkCollector + from pip._internal.index.package_finder import PackageFinder + + link_collector = LinkCollector.create(session, options=options) + + # Pass allow_yanked=False to ignore yanked versions. + selection_prefs = SelectionPreferences( + allow_yanked=False, + allow_all_prereleases=options.pre, + ) + + return PackageFinder.create( + link_collector=link_collector, + selection_prefs=selection_prefs, + ) + + def run(self, options: Values, args: List[str]) -> int: + if options.outdated and options.uptodate: + raise CommandError("Options --outdated and --uptodate cannot be combined.") + + if options.outdated and options.list_format == "freeze": + raise CommandError( + "List format 'freeze' cannot be used with the --outdated option." + ) + + cmdoptions.check_list_path_option(options) + + skip = set(stdlib_pkgs) + if options.excludes: + skip.update(canonicalize_name(n) for n in options.excludes) + + packages: "_ProcessedDists" = [ + cast("_DistWithLatestInfo", d) + for d in get_environment(options.path).iter_installed_distributions( + local_only=options.local, + user_only=options.user, + editables_only=options.editable, + include_editables=options.include_editable, + skip=skip, + ) + ] + + # get_not_required must be called firstly in order to find and + # filter out all dependencies correctly. Otherwise a package + # can't be identified as requirement because some parent packages + # could be filtered out before. + if options.not_required: + packages = self.get_not_required(packages, options) + + if options.outdated: + packages = self.get_outdated(packages, options) + elif options.uptodate: + packages = self.get_uptodate(packages, options) + + self.output_package_listing(packages, options) + return SUCCESS + + def get_outdated( + self, packages: "_ProcessedDists", options: Values + ) -> "_ProcessedDists": + return [ + dist + for dist in self.iter_packages_latest_infos(packages, options) + if dist.latest_version > dist.version + ] + + def get_uptodate( + self, packages: "_ProcessedDists", options: Values + ) -> "_ProcessedDists": + return [ + dist + for dist in self.iter_packages_latest_infos(packages, options) + if dist.latest_version == dist.version + ] + + def get_not_required( + self, packages: "_ProcessedDists", options: Values + ) -> "_ProcessedDists": + dep_keys = { + canonicalize_name(dep.name) + for dist in packages + for dep in (dist.iter_dependencies() or ()) + } + + # Create a set to remove duplicate packages, and cast it to a list + # to keep the return type consistent with get_outdated and + # get_uptodate + return list({pkg for pkg in packages if pkg.canonical_name not in dep_keys}) + + def iter_packages_latest_infos( + self, packages: "_ProcessedDists", options: Values + ) -> Generator["_DistWithLatestInfo", None, None]: + with self._build_session(options) as session: + finder = self._build_package_finder(options, session) + + def latest_info( + dist: "_DistWithLatestInfo", + ) -> Optional["_DistWithLatestInfo"]: + all_candidates = finder.find_all_candidates(dist.canonical_name) + if not options.pre: + # Remove prereleases + all_candidates = [ + candidate + for candidate in all_candidates + if not candidate.version.is_prerelease + ] + + evaluator = finder.make_candidate_evaluator( + project_name=dist.canonical_name, + ) + best_candidate = evaluator.sort_best_candidate(all_candidates) + if best_candidate is None: + return None + + remote_version = best_candidate.version + if best_candidate.link.is_wheel: + typ = "wheel" + else: + typ = "sdist" + dist.latest_version = remote_version + dist.latest_filetype = typ + return dist + + for dist in map(latest_info, packages): + if dist is not None: + yield dist + + def output_package_listing( + self, packages: "_ProcessedDists", options: Values + ) -> None: + packages = sorted( + packages, + key=lambda dist: dist.canonical_name, + ) + if options.list_format == "columns" and packages: + data, header = format_for_columns(packages, options) + self.output_package_listing_columns(data, header) + elif options.list_format == "freeze": + for dist in packages: + if options.verbose >= 1: + write_output( + "%s==%s (%s)", dist.raw_name, dist.version, dist.location + ) + else: + write_output("%s==%s", dist.raw_name, dist.version) + elif options.list_format == "json": + write_output(format_for_json(packages, options)) + + def output_package_listing_columns( + self, data: List[List[str]], header: List[str] + ) -> None: + # insert the header first: we need to know the size of column names + if len(data) > 0: + data.insert(0, header) + + pkg_strings, sizes = tabulate(data) + + # Create and add a separator. + if len(data) > 0: + pkg_strings.insert(1, " ".join("-" * x for x in sizes)) + + for val in pkg_strings: + write_output(val) + + +def format_for_columns( + pkgs: "_ProcessedDists", options: Values +) -> Tuple[List[List[str]], List[str]]: + """ + Convert the package data into something usable + by output_package_listing_columns. + """ + header = ["Package", "Version"] + + running_outdated = options.outdated + if running_outdated: + header.extend(["Latest", "Type"]) + + has_editables = any(x.editable for x in pkgs) + if has_editables: + header.append("Editable project location") + + if options.verbose >= 1: + header.append("Location") + if options.verbose >= 1: + header.append("Installer") + + data = [] + for proj in pkgs: + # if we're working on the 'outdated' list, separate out the + # latest_version and type + row = [proj.raw_name, proj.raw_version] + + if running_outdated: + row.append(str(proj.latest_version)) + row.append(proj.latest_filetype) + + if has_editables: + row.append(proj.editable_project_location or "") + + if options.verbose >= 1: + row.append(proj.location or "") + if options.verbose >= 1: + row.append(proj.installer) + + data.append(row) + + return data, header + + +def format_for_json(packages: "_ProcessedDists", options: Values) -> str: + data = [] + for dist in packages: + info = { + "name": dist.raw_name, + "version": str(dist.version), + } + if options.verbose >= 1: + info["location"] = dist.location or "" + info["installer"] = dist.installer + if options.outdated: + info["latest_version"] = str(dist.latest_version) + info["latest_filetype"] = dist.latest_filetype + editable_project_location = dist.editable_project_location + if editable_project_location: + info["editable_project_location"] = editable_project_location + data.append(info) + return json.dumps(data) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/commands/search.py b/.venv/lib/python3.12/site-packages/pip/_internal/commands/search.py new file mode 100644 index 0000000..e0d329d --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/commands/search.py @@ -0,0 +1,172 @@ +import logging +import shutil +import sys +import textwrap +import xmlrpc.client +from collections import OrderedDict +from optparse import Values +from typing import TYPE_CHECKING, Dict, List, Optional, TypedDict + +from pip._vendor.packaging.version import parse as parse_version + +from pip._internal.cli.base_command import Command +from pip._internal.cli.req_command import SessionCommandMixin +from pip._internal.cli.status_codes import NO_MATCHES_FOUND, SUCCESS +from pip._internal.exceptions import CommandError +from pip._internal.metadata import get_default_environment +from pip._internal.models.index import PyPI +from pip._internal.network.xmlrpc import PipXmlrpcTransport +from pip._internal.utils.logging import indent_log +from pip._internal.utils.misc import write_output + +if TYPE_CHECKING: + + class TransformedHit(TypedDict): + name: str + summary: str + versions: List[str] + + +logger = logging.getLogger(__name__) + + +class SearchCommand(Command, SessionCommandMixin): + """Search for PyPI packages whose name or summary contains .""" + + usage = """ + %prog [options] """ + ignore_require_venv = True + + def add_options(self) -> None: + self.cmd_opts.add_option( + "-i", + "--index", + dest="index", + metavar="URL", + default=PyPI.pypi_url, + help="Base URL of Python Package Index (default %default)", + ) + + self.parser.insert_option_group(0, self.cmd_opts) + + def run(self, options: Values, args: List[str]) -> int: + if not args: + raise CommandError("Missing required argument (search query).") + query = args + pypi_hits = self.search(query, options) + hits = transform_hits(pypi_hits) + + terminal_width = None + if sys.stdout.isatty(): + terminal_width = shutil.get_terminal_size()[0] + + print_results(hits, terminal_width=terminal_width) + if pypi_hits: + return SUCCESS + return NO_MATCHES_FOUND + + def search(self, query: List[str], options: Values) -> List[Dict[str, str]]: + index_url = options.index + + session = self.get_default_session(options) + + transport = PipXmlrpcTransport(index_url, session) + pypi = xmlrpc.client.ServerProxy(index_url, transport) + try: + hits = pypi.search({"name": query, "summary": query}, "or") + except xmlrpc.client.Fault as fault: + message = ( + f"XMLRPC request failed [code: {fault.faultCode}]\n{fault.faultString}" + ) + raise CommandError(message) + assert isinstance(hits, list) + return hits + + +def transform_hits(hits: List[Dict[str, str]]) -> List["TransformedHit"]: + """ + The list from pypi is really a list of versions. We want a list of + packages with the list of versions stored inline. This converts the + list from pypi into one we can use. + """ + packages: Dict[str, "TransformedHit"] = OrderedDict() + for hit in hits: + name = hit["name"] + summary = hit["summary"] + version = hit["version"] + + if name not in packages.keys(): + packages[name] = { + "name": name, + "summary": summary, + "versions": [version], + } + else: + packages[name]["versions"].append(version) + + # if this is the highest version, replace summary and score + if version == highest_version(packages[name]["versions"]): + packages[name]["summary"] = summary + + return list(packages.values()) + + +def print_dist_installation_info(name: str, latest: str) -> None: + env = get_default_environment() + dist = env.get_distribution(name) + if dist is not None: + with indent_log(): + if dist.version == latest: + write_output("INSTALLED: %s (latest)", dist.version) + else: + write_output("INSTALLED: %s", dist.version) + if parse_version(latest).pre: + write_output( + "LATEST: %s (pre-release; install" + " with `pip install --pre`)", + latest, + ) + else: + write_output("LATEST: %s", latest) + + +def print_results( + hits: List["TransformedHit"], + name_column_width: Optional[int] = None, + terminal_width: Optional[int] = None, +) -> None: + if not hits: + return + if name_column_width is None: + name_column_width = ( + max( + [ + len(hit["name"]) + len(highest_version(hit.get("versions", ["-"]))) + for hit in hits + ] + ) + + 4 + ) + + for hit in hits: + name = hit["name"] + summary = hit["summary"] or "" + latest = highest_version(hit.get("versions", ["-"])) + if terminal_width is not None: + target_width = terminal_width - name_column_width - 5 + if target_width > 10: + # wrap and indent summary to fit terminal + summary_lines = textwrap.wrap(summary, target_width) + summary = ("\n" + " " * (name_column_width + 3)).join(summary_lines) + + name_latest = f"{name} ({latest})" + line = f"{name_latest:{name_column_width}} - {summary}" + try: + write_output(line) + print_dist_installation_info(name, latest) + except UnicodeEncodeError: + pass + + +def highest_version(versions: List[str]) -> str: + return max(versions, key=parse_version) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/commands/show.py b/.venv/lib/python3.12/site-packages/pip/_internal/commands/show.py new file mode 100644 index 0000000..c54d548 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/commands/show.py @@ -0,0 +1,217 @@ +import logging +from optparse import Values +from typing import Generator, Iterable, Iterator, List, NamedTuple, Optional + +from pip._vendor.packaging.requirements import InvalidRequirement +from pip._vendor.packaging.utils import canonicalize_name + +from pip._internal.cli.base_command import Command +from pip._internal.cli.status_codes import ERROR, SUCCESS +from pip._internal.metadata import BaseDistribution, get_default_environment +from pip._internal.utils.misc import write_output + +logger = logging.getLogger(__name__) + + +class ShowCommand(Command): + """ + Show information about one or more installed packages. + + The output is in RFC-compliant mail header format. + """ + + usage = """ + %prog [options] ...""" + ignore_require_venv = True + + def add_options(self) -> None: + self.cmd_opts.add_option( + "-f", + "--files", + dest="files", + action="store_true", + default=False, + help="Show the full list of installed files for each package.", + ) + + self.parser.insert_option_group(0, self.cmd_opts) + + def run(self, options: Values, args: List[str]) -> int: + if not args: + logger.warning("ERROR: Please provide a package name or names.") + return ERROR + query = args + + results = search_packages_info(query) + if not print_results( + results, list_files=options.files, verbose=options.verbose + ): + return ERROR + return SUCCESS + + +class _PackageInfo(NamedTuple): + name: str + version: str + location: str + editable_project_location: Optional[str] + requires: List[str] + required_by: List[str] + installer: str + metadata_version: str + classifiers: List[str] + summary: str + homepage: str + project_urls: List[str] + author: str + author_email: str + license: str + entry_points: List[str] + files: Optional[List[str]] + + +def search_packages_info(query: List[str]) -> Generator[_PackageInfo, None, None]: + """ + Gather details from installed distributions. Print distribution name, + version, location, and installed files. Installed files requires a + pip generated 'installed-files.txt' in the distributions '.egg-info' + directory. + """ + env = get_default_environment() + + installed = {dist.canonical_name: dist for dist in env.iter_all_distributions()} + query_names = [canonicalize_name(name) for name in query] + missing = sorted( + [name for name, pkg in zip(query, query_names) if pkg not in installed] + ) + if missing: + logger.warning("Package(s) not found: %s", ", ".join(missing)) + + def _get_requiring_packages(current_dist: BaseDistribution) -> Iterator[str]: + return ( + dist.metadata["Name"] or "UNKNOWN" + for dist in installed.values() + if current_dist.canonical_name + in {canonicalize_name(d.name) for d in dist.iter_dependencies()} + ) + + for query_name in query_names: + try: + dist = installed[query_name] + except KeyError: + continue + + try: + requires = sorted( + # Avoid duplicates in requirements (e.g. due to environment markers). + {req.name for req in dist.iter_dependencies()}, + key=str.lower, + ) + except InvalidRequirement: + requires = sorted(dist.iter_raw_dependencies(), key=str.lower) + + try: + required_by = sorted(_get_requiring_packages(dist), key=str.lower) + except InvalidRequirement: + required_by = ["#N/A"] + + try: + entry_points_text = dist.read_text("entry_points.txt") + entry_points = entry_points_text.splitlines(keepends=False) + except FileNotFoundError: + entry_points = [] + + files_iter = dist.iter_declared_entries() + if files_iter is None: + files: Optional[List[str]] = None + else: + files = sorted(files_iter) + + metadata = dist.metadata + + project_urls = metadata.get_all("Project-URL", []) + homepage = metadata.get("Home-page", "") + if not homepage: + # It's common that there is a "homepage" Project-URL, but Home-page + # remains unset (especially as PEP 621 doesn't surface the field). + # + # This logic was taken from PyPI's codebase. + for url in project_urls: + url_label, url = url.split(",", maxsplit=1) + normalized_label = ( + url_label.casefold().replace("-", "").replace("_", "").strip() + ) + if normalized_label == "homepage": + homepage = url.strip() + break + + yield _PackageInfo( + name=dist.raw_name, + version=dist.raw_version, + location=dist.location or "", + editable_project_location=dist.editable_project_location, + requires=requires, + required_by=required_by, + installer=dist.installer, + metadata_version=dist.metadata_version or "", + classifiers=metadata.get_all("Classifier", []), + summary=metadata.get("Summary", ""), + homepage=homepage, + project_urls=project_urls, + author=metadata.get("Author", ""), + author_email=metadata.get("Author-email", ""), + license=metadata.get("License", ""), + entry_points=entry_points, + files=files, + ) + + +def print_results( + distributions: Iterable[_PackageInfo], + list_files: bool, + verbose: bool, +) -> bool: + """ + Print the information from installed distributions found. + """ + results_printed = False + for i, dist in enumerate(distributions): + results_printed = True + if i > 0: + write_output("---") + + write_output("Name: %s", dist.name) + write_output("Version: %s", dist.version) + write_output("Summary: %s", dist.summary) + write_output("Home-page: %s", dist.homepage) + write_output("Author: %s", dist.author) + write_output("Author-email: %s", dist.author_email) + write_output("License: %s", dist.license) + write_output("Location: %s", dist.location) + if dist.editable_project_location is not None: + write_output( + "Editable project location: %s", dist.editable_project_location + ) + write_output("Requires: %s", ", ".join(dist.requires)) + write_output("Required-by: %s", ", ".join(dist.required_by)) + + if verbose: + write_output("Metadata-Version: %s", dist.metadata_version) + write_output("Installer: %s", dist.installer) + write_output("Classifiers:") + for classifier in dist.classifiers: + write_output(" %s", classifier) + write_output("Entry-points:") + for entry in dist.entry_points: + write_output(" %s", entry.strip()) + write_output("Project-URLs:") + for project_url in dist.project_urls: + write_output(" %s", project_url) + if list_files: + write_output("Files:") + if dist.files is None: + write_output("Cannot locate RECORD or installed-files.txt") + else: + for line in dist.files: + write_output(" %s", line.strip()) + return results_printed diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/commands/uninstall.py b/.venv/lib/python3.12/site-packages/pip/_internal/commands/uninstall.py new file mode 100644 index 0000000..bc0edea --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/commands/uninstall.py @@ -0,0 +1,114 @@ +import logging +from optparse import Values +from typing import List + +from pip._vendor.packaging.utils import canonicalize_name + +from pip._internal.cli import cmdoptions +from pip._internal.cli.base_command import Command +from pip._internal.cli.index_command import SessionCommandMixin +from pip._internal.cli.status_codes import SUCCESS +from pip._internal.exceptions import InstallationError +from pip._internal.req import parse_requirements +from pip._internal.req.constructors import ( + install_req_from_line, + install_req_from_parsed_requirement, +) +from pip._internal.utils.misc import ( + check_externally_managed, + protect_pip_from_modification_on_windows, + warn_if_run_as_root, +) + +logger = logging.getLogger(__name__) + + +class UninstallCommand(Command, SessionCommandMixin): + """ + Uninstall packages. + + pip is able to uninstall most installed packages. Known exceptions are: + + - Pure distutils packages installed with ``python setup.py install``, which + leave behind no metadata to determine what files were installed. + - Script wrappers installed by ``python setup.py develop``. + """ + + usage = """ + %prog [options] ... + %prog [options] -r ...""" + + def add_options(self) -> None: + self.cmd_opts.add_option( + "-r", + "--requirement", + dest="requirements", + action="append", + default=[], + metavar="file", + help=( + "Uninstall all the packages listed in the given requirements " + "file. This option can be used multiple times." + ), + ) + self.cmd_opts.add_option( + "-y", + "--yes", + dest="yes", + action="store_true", + help="Don't ask for confirmation of uninstall deletions.", + ) + self.cmd_opts.add_option(cmdoptions.root_user_action()) + self.cmd_opts.add_option(cmdoptions.override_externally_managed()) + self.parser.insert_option_group(0, self.cmd_opts) + + def run(self, options: Values, args: List[str]) -> int: + session = self.get_default_session(options) + + reqs_to_uninstall = {} + for name in args: + req = install_req_from_line( + name, + isolated=options.isolated_mode, + ) + if req.name: + reqs_to_uninstall[canonicalize_name(req.name)] = req + else: + logger.warning( + "Invalid requirement: %r ignored -" + " the uninstall command expects named" + " requirements.", + name, + ) + for filename in options.requirements: + for parsed_req in parse_requirements( + filename, options=options, session=session + ): + req = install_req_from_parsed_requirement( + parsed_req, isolated=options.isolated_mode + ) + if req.name: + reqs_to_uninstall[canonicalize_name(req.name)] = req + if not reqs_to_uninstall: + raise InstallationError( + f"You must give at least one requirement to {self.name} (see " + f'"pip help {self.name}")' + ) + + if not options.override_externally_managed: + check_externally_managed() + + protect_pip_from_modification_on_windows( + modifying_pip="pip" in reqs_to_uninstall + ) + + for req in reqs_to_uninstall.values(): + uninstall_pathset = req.uninstall( + auto_confirm=options.yes, + verbose=self.verbosity > 0, + ) + if uninstall_pathset: + uninstall_pathset.commit() + if options.root_user_action == "warn": + warn_if_run_as_root() + return SUCCESS diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/commands/wheel.py b/.venv/lib/python3.12/site-packages/pip/_internal/commands/wheel.py new file mode 100644 index 0000000..278719f --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/commands/wheel.py @@ -0,0 +1,182 @@ +import logging +import os +import shutil +from optparse import Values +from typing import List + +from pip._internal.cache import WheelCache +from pip._internal.cli import cmdoptions +from pip._internal.cli.req_command import RequirementCommand, with_cleanup +from pip._internal.cli.status_codes import SUCCESS +from pip._internal.exceptions import CommandError +from pip._internal.operations.build.build_tracker import get_build_tracker +from pip._internal.req.req_install import ( + InstallRequirement, + check_legacy_setup_py_options, +) +from pip._internal.utils.misc import ensure_dir, normalize_path +from pip._internal.utils.temp_dir import TempDirectory +from pip._internal.wheel_builder import build, should_build_for_wheel_command + +logger = logging.getLogger(__name__) + + +class WheelCommand(RequirementCommand): + """ + Build Wheel archives for your requirements and dependencies. + + Wheel is a built-package format, and offers the advantage of not + recompiling your software during every install. For more details, see the + wheel docs: https://wheel.readthedocs.io/en/latest/ + + 'pip wheel' uses the build system interface as described here: + https://pip.pypa.io/en/stable/reference/build-system/ + + """ + + usage = """ + %prog [options] ... + %prog [options] -r ... + %prog [options] [-e] ... + %prog [options] [-e] ... + %prog [options] ...""" + + def add_options(self) -> None: + self.cmd_opts.add_option( + "-w", + "--wheel-dir", + dest="wheel_dir", + metavar="dir", + default=os.curdir, + help=( + "Build wheels into , where the default is the " + "current working directory." + ), + ) + self.cmd_opts.add_option(cmdoptions.no_binary()) + self.cmd_opts.add_option(cmdoptions.only_binary()) + self.cmd_opts.add_option(cmdoptions.prefer_binary()) + self.cmd_opts.add_option(cmdoptions.no_build_isolation()) + self.cmd_opts.add_option(cmdoptions.use_pep517()) + self.cmd_opts.add_option(cmdoptions.no_use_pep517()) + self.cmd_opts.add_option(cmdoptions.check_build_deps()) + self.cmd_opts.add_option(cmdoptions.constraints()) + self.cmd_opts.add_option(cmdoptions.editable()) + self.cmd_opts.add_option(cmdoptions.requirements()) + self.cmd_opts.add_option(cmdoptions.src()) + self.cmd_opts.add_option(cmdoptions.ignore_requires_python()) + self.cmd_opts.add_option(cmdoptions.no_deps()) + self.cmd_opts.add_option(cmdoptions.progress_bar()) + + self.cmd_opts.add_option( + "--no-verify", + dest="no_verify", + action="store_true", + default=False, + help="Don't verify if built wheel is valid.", + ) + + self.cmd_opts.add_option(cmdoptions.config_settings()) + self.cmd_opts.add_option(cmdoptions.build_options()) + self.cmd_opts.add_option(cmdoptions.global_options()) + + self.cmd_opts.add_option( + "--pre", + action="store_true", + default=False, + help=( + "Include pre-release and development versions. By default, " + "pip only finds stable versions." + ), + ) + + self.cmd_opts.add_option(cmdoptions.require_hashes()) + + index_opts = cmdoptions.make_option_group( + cmdoptions.index_group, + self.parser, + ) + + self.parser.insert_option_group(0, index_opts) + self.parser.insert_option_group(0, self.cmd_opts) + + @with_cleanup + def run(self, options: Values, args: List[str]) -> int: + session = self.get_default_session(options) + + finder = self._build_package_finder(options, session) + + options.wheel_dir = normalize_path(options.wheel_dir) + ensure_dir(options.wheel_dir) + + build_tracker = self.enter_context(get_build_tracker()) + + directory = TempDirectory( + delete=not options.no_clean, + kind="wheel", + globally_managed=True, + ) + + reqs = self.get_requirements(args, options, finder, session) + check_legacy_setup_py_options(options, reqs) + + wheel_cache = WheelCache(options.cache_dir) + + preparer = self.make_requirement_preparer( + temp_build_dir=directory, + options=options, + build_tracker=build_tracker, + session=session, + finder=finder, + download_dir=options.wheel_dir, + use_user_site=False, + verbosity=self.verbosity, + ) + + resolver = self.make_resolver( + preparer=preparer, + finder=finder, + options=options, + wheel_cache=wheel_cache, + ignore_requires_python=options.ignore_requires_python, + use_pep517=options.use_pep517, + ) + + self.trace_basic_info(finder) + + requirement_set = resolver.resolve(reqs, check_supported_wheels=True) + + reqs_to_build: List[InstallRequirement] = [] + for req in requirement_set.requirements.values(): + if req.is_wheel: + preparer.save_linked_requirement(req) + elif should_build_for_wheel_command(req): + reqs_to_build.append(req) + + preparer.prepare_linked_requirements_more(requirement_set.requirements.values()) + + # build wheels + build_successes, build_failures = build( + reqs_to_build, + wheel_cache=wheel_cache, + verify=(not options.no_verify), + build_options=options.build_options or [], + global_options=options.global_options or [], + ) + for req in build_successes: + assert req.link and req.link.is_wheel + assert req.local_file_path + # copy from cache to target directory + try: + shutil.copy(req.local_file_path, options.wheel_dir) + except OSError as e: + logger.warning( + "Building wheel for %s failed: %s", + req.name, + e, + ) + build_failures.append(req) + if len(build_failures) != 0: + raise CommandError("Failed to build one or more wheels") + + return SUCCESS diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/configuration.py b/.venv/lib/python3.12/site-packages/pip/_internal/configuration.py new file mode 100644 index 0000000..c25273d --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/configuration.py @@ -0,0 +1,383 @@ +"""Configuration management setup + +Some terminology: +- name + As written in config files. +- value + Value associated with a name +- key + Name combined with it's section (section.name) +- variant + A single word describing where the configuration key-value pair came from +""" + +import configparser +import locale +import os +import sys +from typing import Any, Dict, Iterable, List, NewType, Optional, Tuple + +from pip._internal.exceptions import ( + ConfigurationError, + ConfigurationFileCouldNotBeLoaded, +) +from pip._internal.utils import appdirs +from pip._internal.utils.compat import WINDOWS +from pip._internal.utils.logging import getLogger +from pip._internal.utils.misc import ensure_dir, enum + +RawConfigParser = configparser.RawConfigParser # Shorthand +Kind = NewType("Kind", str) + +CONFIG_BASENAME = "pip.ini" if WINDOWS else "pip.conf" +ENV_NAMES_IGNORED = "version", "help" + +# The kinds of configurations there are. +kinds = enum( + USER="user", # User Specific + GLOBAL="global", # System Wide + SITE="site", # [Virtual] Environment Specific + ENV="env", # from PIP_CONFIG_FILE + ENV_VAR="env-var", # from Environment Variables +) +OVERRIDE_ORDER = kinds.GLOBAL, kinds.USER, kinds.SITE, kinds.ENV, kinds.ENV_VAR +VALID_LOAD_ONLY = kinds.USER, kinds.GLOBAL, kinds.SITE + +logger = getLogger(__name__) + + +# NOTE: Maybe use the optionx attribute to normalize keynames. +def _normalize_name(name: str) -> str: + """Make a name consistent regardless of source (environment or file)""" + name = name.lower().replace("_", "-") + if name.startswith("--"): + name = name[2:] # only prefer long opts + return name + + +def _disassemble_key(name: str) -> List[str]: + if "." not in name: + error_message = ( + "Key does not contain dot separated section and key. " + f"Perhaps you wanted to use 'global.{name}' instead?" + ) + raise ConfigurationError(error_message) + return name.split(".", 1) + + +def get_configuration_files() -> Dict[Kind, List[str]]: + global_config_files = [ + os.path.join(path, CONFIG_BASENAME) for path in appdirs.site_config_dirs("pip") + ] + + site_config_file = os.path.join(sys.prefix, CONFIG_BASENAME) + legacy_config_file = os.path.join( + os.path.expanduser("~"), + "pip" if WINDOWS else ".pip", + CONFIG_BASENAME, + ) + new_config_file = os.path.join(appdirs.user_config_dir("pip"), CONFIG_BASENAME) + return { + kinds.GLOBAL: global_config_files, + kinds.SITE: [site_config_file], + kinds.USER: [legacy_config_file, new_config_file], + } + + +class Configuration: + """Handles management of configuration. + + Provides an interface to accessing and managing configuration files. + + This class converts provides an API that takes "section.key-name" style + keys and stores the value associated with it as "key-name" under the + section "section". + + This allows for a clean interface wherein the both the section and the + key-name are preserved in an easy to manage form in the configuration files + and the data stored is also nice. + """ + + def __init__(self, isolated: bool, load_only: Optional[Kind] = None) -> None: + super().__init__() + + if load_only is not None and load_only not in VALID_LOAD_ONLY: + raise ConfigurationError( + "Got invalid value for load_only - should be one of {}".format( + ", ".join(map(repr, VALID_LOAD_ONLY)) + ) + ) + self.isolated = isolated + self.load_only = load_only + + # Because we keep track of where we got the data from + self._parsers: Dict[Kind, List[Tuple[str, RawConfigParser]]] = { + variant: [] for variant in OVERRIDE_ORDER + } + self._config: Dict[Kind, Dict[str, Any]] = { + variant: {} for variant in OVERRIDE_ORDER + } + self._modified_parsers: List[Tuple[str, RawConfigParser]] = [] + + def load(self) -> None: + """Loads configuration from configuration files and environment""" + self._load_config_files() + if not self.isolated: + self._load_environment_vars() + + def get_file_to_edit(self) -> Optional[str]: + """Returns the file with highest priority in configuration""" + assert self.load_only is not None, "Need to be specified a file to be editing" + + try: + return self._get_parser_to_modify()[0] + except IndexError: + return None + + def items(self) -> Iterable[Tuple[str, Any]]: + """Returns key-value pairs like dict.items() representing the loaded + configuration + """ + return self._dictionary.items() + + def get_value(self, key: str) -> Any: + """Get a value from the configuration.""" + orig_key = key + key = _normalize_name(key) + try: + return self._dictionary[key] + except KeyError: + # disassembling triggers a more useful error message than simply + # "No such key" in the case that the key isn't in the form command.option + _disassemble_key(key) + raise ConfigurationError(f"No such key - {orig_key}") + + def set_value(self, key: str, value: Any) -> None: + """Modify a value in the configuration.""" + key = _normalize_name(key) + self._ensure_have_load_only() + + assert self.load_only + fname, parser = self._get_parser_to_modify() + + if parser is not None: + section, name = _disassemble_key(key) + + # Modify the parser and the configuration + if not parser.has_section(section): + parser.add_section(section) + parser.set(section, name, value) + + self._config[self.load_only][key] = value + self._mark_as_modified(fname, parser) + + def unset_value(self, key: str) -> None: + """Unset a value in the configuration.""" + orig_key = key + key = _normalize_name(key) + self._ensure_have_load_only() + + assert self.load_only + if key not in self._config[self.load_only]: + raise ConfigurationError(f"No such key - {orig_key}") + + fname, parser = self._get_parser_to_modify() + + if parser is not None: + section, name = _disassemble_key(key) + if not ( + parser.has_section(section) and parser.remove_option(section, name) + ): + # The option was not removed. + raise ConfigurationError( + "Fatal Internal error [id=1]. Please report as a bug." + ) + + # The section may be empty after the option was removed. + if not parser.items(section): + parser.remove_section(section) + self._mark_as_modified(fname, parser) + + del self._config[self.load_only][key] + + def save(self) -> None: + """Save the current in-memory state.""" + self._ensure_have_load_only() + + for fname, parser in self._modified_parsers: + logger.info("Writing to %s", fname) + + # Ensure directory exists. + ensure_dir(os.path.dirname(fname)) + + # Ensure directory's permission(need to be writeable) + try: + with open(fname, "w") as f: + parser.write(f) + except OSError as error: + raise ConfigurationError( + f"An error occurred while writing to the configuration file " + f"{fname}: {error}" + ) + + # + # Private routines + # + + def _ensure_have_load_only(self) -> None: + if self.load_only is None: + raise ConfigurationError("Needed a specific file to be modifying.") + logger.debug("Will be working with %s variant only", self.load_only) + + @property + def _dictionary(self) -> Dict[str, Any]: + """A dictionary representing the loaded configuration.""" + # NOTE: Dictionaries are not populated if not loaded. So, conditionals + # are not needed here. + retval = {} + + for variant in OVERRIDE_ORDER: + retval.update(self._config[variant]) + + return retval + + def _load_config_files(self) -> None: + """Loads configuration from configuration files""" + config_files = dict(self.iter_config_files()) + if config_files[kinds.ENV][0:1] == [os.devnull]: + logger.debug( + "Skipping loading configuration files due to " + "environment's PIP_CONFIG_FILE being os.devnull" + ) + return + + for variant, files in config_files.items(): + for fname in files: + # If there's specific variant set in `load_only`, load only + # that variant, not the others. + if self.load_only is not None and variant != self.load_only: + logger.debug("Skipping file '%s' (variant: %s)", fname, variant) + continue + + parser = self._load_file(variant, fname) + + # Keeping track of the parsers used + self._parsers[variant].append((fname, parser)) + + def _load_file(self, variant: Kind, fname: str) -> RawConfigParser: + logger.verbose("For variant '%s', will try loading '%s'", variant, fname) + parser = self._construct_parser(fname) + + for section in parser.sections(): + items = parser.items(section) + self._config[variant].update(self._normalized_keys(section, items)) + + return parser + + def _construct_parser(self, fname: str) -> RawConfigParser: + parser = configparser.RawConfigParser() + # If there is no such file, don't bother reading it but create the + # parser anyway, to hold the data. + # Doing this is useful when modifying and saving files, where we don't + # need to construct a parser. + if os.path.exists(fname): + locale_encoding = locale.getpreferredencoding(False) + try: + parser.read(fname, encoding=locale_encoding) + except UnicodeDecodeError: + # See https://github.com/pypa/pip/issues/4963 + raise ConfigurationFileCouldNotBeLoaded( + reason=f"contains invalid {locale_encoding} characters", + fname=fname, + ) + except configparser.Error as error: + # See https://github.com/pypa/pip/issues/4893 + raise ConfigurationFileCouldNotBeLoaded(error=error) + return parser + + def _load_environment_vars(self) -> None: + """Loads configuration from environment variables""" + self._config[kinds.ENV_VAR].update( + self._normalized_keys(":env:", self.get_environ_vars()) + ) + + def _normalized_keys( + self, section: str, items: Iterable[Tuple[str, Any]] + ) -> Dict[str, Any]: + """Normalizes items to construct a dictionary with normalized keys. + + This routine is where the names become keys and are made the same + regardless of source - configuration files or environment. + """ + normalized = {} + for name, val in items: + key = section + "." + _normalize_name(name) + normalized[key] = val + return normalized + + def get_environ_vars(self) -> Iterable[Tuple[str, str]]: + """Returns a generator with all environmental vars with prefix PIP_""" + for key, val in os.environ.items(): + if key.startswith("PIP_"): + name = key[4:].lower() + if name not in ENV_NAMES_IGNORED: + yield name, val + + # XXX: This is patched in the tests. + def iter_config_files(self) -> Iterable[Tuple[Kind, List[str]]]: + """Yields variant and configuration files associated with it. + + This should be treated like items of a dictionary. The order + here doesn't affect what gets overridden. That is controlled + by OVERRIDE_ORDER. However this does control the order they are + displayed to the user. It's probably most ergononmic to display + things in the same order as OVERRIDE_ORDER + """ + # SMELL: Move the conditions out of this function + + env_config_file = os.environ.get("PIP_CONFIG_FILE", None) + config_files = get_configuration_files() + + yield kinds.GLOBAL, config_files[kinds.GLOBAL] + + # per-user config is not loaded when env_config_file exists + should_load_user_config = not self.isolated and not ( + env_config_file and os.path.exists(env_config_file) + ) + if should_load_user_config: + # The legacy config file is overridden by the new config file + yield kinds.USER, config_files[kinds.USER] + + # virtualenv config + yield kinds.SITE, config_files[kinds.SITE] + + if env_config_file is not None: + yield kinds.ENV, [env_config_file] + else: + yield kinds.ENV, [] + + def get_values_in_config(self, variant: Kind) -> Dict[str, Any]: + """Get values present in a config file""" + return self._config[variant] + + def _get_parser_to_modify(self) -> Tuple[str, RawConfigParser]: + # Determine which parser to modify + assert self.load_only + parsers = self._parsers[self.load_only] + if not parsers: + # This should not happen if everything works correctly. + raise ConfigurationError( + "Fatal Internal error [id=2]. Please report as a bug." + ) + + # Use the highest priority parser. + return parsers[-1] + + # XXX: This is patched in the tests. + def _mark_as_modified(self, fname: str, parser: RawConfigParser) -> None: + file_parser_tuple = (fname, parser) + if file_parser_tuple not in self._modified_parsers: + self._modified_parsers.append(file_parser_tuple) + + def __repr__(self) -> str: + return f"{self.__class__.__name__}({self._dictionary!r})" diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/distributions/__init__.py b/.venv/lib/python3.12/site-packages/pip/_internal/distributions/__init__.py new file mode 100644 index 0000000..9a89a83 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/distributions/__init__.py @@ -0,0 +1,21 @@ +from pip._internal.distributions.base import AbstractDistribution +from pip._internal.distributions.sdist import SourceDistribution +from pip._internal.distributions.wheel import WheelDistribution +from pip._internal.req.req_install import InstallRequirement + + +def make_distribution_for_install_requirement( + install_req: InstallRequirement, +) -> AbstractDistribution: + """Returns a Distribution for the given InstallRequirement""" + # Editable requirements will always be source distributions. They use the + # legacy logic until we create a modern standard for them. + if install_req.editable: + return SourceDistribution(install_req) + + # If it's a wheel, it's a WheelDistribution + if install_req.is_wheel: + return WheelDistribution(install_req) + + # Otherwise, a SourceDistribution + return SourceDistribution(install_req) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/distributions/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/distributions/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f0eeb3c6056210b9ef62ca69ec1ca82dfbdc77d1 GIT binary patch literal 939 zcmaJ;&ubGw6rO4JS54B;+KU8biy&-Ec2N%=ENY<_4+^#iVK2*OciK#|Khl{=B+`Qi z|A%_)Rr;rR3Fe?I1_V#uBI&6o->g|(qx8Yd``(*3Z@zEdhkE@Q0{ije{J^as^i2kZ zDRVH}1#pT&6ygZQ*u_}lrD!RxxRo4NA|+N`HOES%#k#8lR*4>J1Rp4&{#J2~p)NXiB~@NKnE1$vypQshQsQ>D<}96z#BBJA>;Zd zz4=jZerar+ZH*iD$grncDQliJ$Bov=XkBQicI#btT-_Wgn=`nMo?FYA2_)^`B<(T@ zZnu3-m>graaa9@5Z{@#vW!;}|&TjtQ4K3du}^H*>A;5nGYC2HT~v9j9SGB9GWQ rgmOgu4s6p3#(08uCg{loJ)WTLskVZ*KCj-MR=|H%Z(OM0^FBWT4#@;U literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/distributions/__pycache__/base.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/distributions/__pycache__/base.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5cc0dacd978152b30046efa42a1d4847681686e2 GIT binary patch literal 2891 zcmb7G-H#Jh6u&d=wA1dkTRsGK`5IvjTV$tv_+Zo+7DU__Ruo<=53|#`x7%T-GsC^p zUAp06V@QMt9u2P$6Lo_R{sH_4zCbi;Mu{5r!MDPq5}rI~rqgXJrD}@GEKO51T~A*jb%`pMhpP(9 zoG@J)jY^=Syz4-B(r^zg=a{rG)MESNQdBuzNmD#Piy1~ zxhPdjXGpmaZl0<^GE6JzPm1}OOvsd0gIsBrV+x_wJ+3uOmpZmPr`d77%$mbAlLvMk z)P3YKu&3wnU)S;213go<>=~c++-a zGkCq`noSnj1=ADYBPd&@yD!izk8@@PPCIrx)^t60vgOZllcJbl<*w6U6$A9+iVJPg z4jP(ZLCYVA90d9K_4hQ_L9)#r+={gB|M_1)b;dFqW>sk4 zuo4w)N!@Sr5iqs1bG_cx6JK|Mh=#tWvKz7u@_7(Kzc$5$j?f@}!Pg~m6+8kV9kj4sj*n=ZYyZW*2w z+k^KMU|A*)hsnsEZ;E^GsC)S);QZe*aJ+_NY57)I`n?;SV?i(2ffOw1>$>?&`TcnF z5G>2&_u`9v-iDca^hxAdI1ESPIBnrMCXTYOWHp#IZ^UdEQo>4uT=M(}kgY{mPDk12 z+d-S}z-1>a0`CLZbnCJ6x%FN;yl&Lb)zQ&Nw^GHyN|iU@EWnSBVT5_ZXnM5eAU$jt z7h0y%J;@pd^(+_{@DGVZy&9&>niZDJ?#I^W9?X@X%`uiR1s%n=AyrHS0Iv;?a{Ncd z$M7Uw^E`*|MzYYII2Lmp!zfF918^e{9E~8#@&8G*VEM$SuspgcV2$| z0f9G4Y>POZOrJzX8ULlUyQ9Dx_+z^|S)^35eRn5^RG#FE4~Bq>^dHJVMV%0N4S&9J z*ssx8Ef4c?2q4S^Z6Cf894Azqwe2t`_1>J+lMdH$L`I1VHw;R^NQw#)?iu7GnlI|z z@oV&hJ3Dpk_$lxta%+XeF5(n;tiBPK{!M-ewm2TdK3F;_Ns@jf`Jc)DKgg^1$iZJz arF-e44>S9v@f&A8KX>!o-vr3$qJII_xFN>? literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/distributions/__pycache__/installed.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/distributions/__pycache__/installed.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..285459507f6f08314f5e5787daa36dba157ba006 GIT binary patch literal 1698 zcma)6&2Jl35P$pWwPVLdX##C&S)ov2q3(v}NQG2{Kv*Ia=xGnE*89fsHv850)=}2t z5TP94#4%U6QRPqJ62t+tQlv_V12-3!OHa((wSygnsw3^Z-_FeY_|43FKet*9g7Wn9 zlR-}*%=5Dk0~~|?NO;iRy6^dW-Y$F;#1t4B zIv;o(7K41T+FXnonBGTlOn^8NC5}ubM*)?}pn-lBJp-94N9xHe*r}n%K%07`I(4c+ z1JArdYxv337#OsU_GWH$8^!u3G0(g(1iE;H@wZ<<%78;M>6+Ha%`;LogXU8U+mfK|DxURQZPJ^g;$6&CBKb0I}&O zQ985qbtx}w&5z}$e2Z(W*G>tb9RkI6+(9+D^RwJ8F!#8O5>$#RI`n0!qhijWKPP()pj z!&(npd)^G+NH0J0OVX8h#v7uT*tsL@i~PUZcjZFCG8Rpa)#HNzsN2t33pcMa&IF<2 z>Mmq%1er&@%ySp>HnuO%%l}ST6H8mD4$1HBweJtUJNT`=`Ad8Aw7qp|^iJ>eens8h zTJ{;6>=khieNbMoqFtpu;7M3EUD5G};P1JWnL^5Ue9=aWvea8_1zoI(s;jb9fj5MD zRjAicaWPw5hKm1*4cCnl zItm4Dy6z*a+{{yRU7Gl4Hd2WDm*Rn5Rd>8lf2(ysjQ_D|bC-u{~)oGNqUM3=RSC-|w?qxRH2p_)Sz3MUtd5 ba{W(o?~L3%BiqmPb*Xjw`qn=L$CA*$!>`7v literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/distributions/__pycache__/sdist.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/distributions/__pycache__/sdist.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..69b0466d9a8e0d60ff09e6880f696d5b4d22511a GIT binary patch literal 8480 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 N{?6II39M;C{sr%1S~LIv literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/distributions/base.py b/.venv/lib/python3.12/site-packages/pip/_internal/distributions/base.py new file mode 100644 index 0000000..6e4d0c9 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/distributions/base.py @@ -0,0 +1,53 @@ +import abc +from typing import TYPE_CHECKING, Optional + +from pip._internal.metadata.base import BaseDistribution +from pip._internal.req import InstallRequirement + +if TYPE_CHECKING: + from pip._internal.index.package_finder import PackageFinder + + +class AbstractDistribution(metaclass=abc.ABCMeta): + """A base class for handling installable artifacts. + + The requirements for anything installable are as follows: + + - we must be able to determine the requirement name + (or we can't correctly handle the non-upgrade case). + + - for packages with setup requirements, we must also be able + to determine their requirements without installing additional + packages (for the same reason as run-time dependencies) + + - we must be able to create a Distribution object exposing the + above metadata. + + - if we need to do work in the build tracker, we must be able to generate a unique + string to identify the requirement in the build tracker. + """ + + def __init__(self, req: InstallRequirement) -> None: + super().__init__() + self.req = req + + @abc.abstractproperty + def build_tracker_id(self) -> Optional[str]: + """A string that uniquely identifies this requirement to the build tracker. + + If None, then this dist has no work to do in the build tracker, and + ``.prepare_distribution_metadata()`` will not be called.""" + raise NotImplementedError() + + @abc.abstractmethod + def get_metadata_distribution(self) -> BaseDistribution: + raise NotImplementedError() + + @abc.abstractmethod + def prepare_distribution_metadata( + self, + finder: "PackageFinder", + build_isolation: bool, + check_build_deps: bool, + ) -> None: + raise NotImplementedError() diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/distributions/installed.py b/.venv/lib/python3.12/site-packages/pip/_internal/distributions/installed.py new file mode 100644 index 0000000..ab8d53b --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/distributions/installed.py @@ -0,0 +1,29 @@ +from typing import Optional + +from pip._internal.distributions.base import AbstractDistribution +from pip._internal.index.package_finder import PackageFinder +from pip._internal.metadata import BaseDistribution + + +class InstalledDistribution(AbstractDistribution): + """Represents an installed package. + + This does not need any preparation as the required information has already + been computed. + """ + + @property + def build_tracker_id(self) -> Optional[str]: + return None + + def get_metadata_distribution(self) -> BaseDistribution: + assert self.req.satisfied_by is not None, "not actually installed" + return self.req.satisfied_by + + def prepare_distribution_metadata( + self, + finder: PackageFinder, + build_isolation: bool, + check_build_deps: bool, + ) -> None: + pass diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/distributions/sdist.py b/.venv/lib/python3.12/site-packages/pip/_internal/distributions/sdist.py new file mode 100644 index 0000000..28ea5ce --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/distributions/sdist.py @@ -0,0 +1,158 @@ +import logging +from typing import TYPE_CHECKING, Iterable, Optional, Set, Tuple + +from pip._internal.build_env import BuildEnvironment +from pip._internal.distributions.base import AbstractDistribution +from pip._internal.exceptions import InstallationError +from pip._internal.metadata import BaseDistribution +from pip._internal.utils.subprocess import runner_with_spinner_message + +if TYPE_CHECKING: + from pip._internal.index.package_finder import PackageFinder + +logger = logging.getLogger(__name__) + + +class SourceDistribution(AbstractDistribution): + """Represents a source distribution. + + The preparation step for these needs metadata for the packages to be + generated, either using PEP 517 or using the legacy `setup.py egg_info`. + """ + + @property + def build_tracker_id(self) -> Optional[str]: + """Identify this requirement uniquely by its link.""" + assert self.req.link + return self.req.link.url_without_fragment + + def get_metadata_distribution(self) -> BaseDistribution: + return self.req.get_dist() + + def prepare_distribution_metadata( + self, + finder: "PackageFinder", + build_isolation: bool, + check_build_deps: bool, + ) -> None: + # Load pyproject.toml, to determine whether PEP 517 is to be used + self.req.load_pyproject_toml() + + # Set up the build isolation, if this requirement should be isolated + should_isolate = self.req.use_pep517 and build_isolation + if should_isolate: + # Setup an isolated environment and install the build backend static + # requirements in it. + self._prepare_build_backend(finder) + # Check that if the requirement is editable, it either supports PEP 660 or + # has a setup.py or a setup.cfg. This cannot be done earlier because we need + # to setup the build backend to verify it supports build_editable, nor can + # it be done later, because we want to avoid installing build requirements + # needlessly. Doing it here also works around setuptools generating + # UNKNOWN.egg-info when running get_requires_for_build_wheel on a directory + # without setup.py nor setup.cfg. + self.req.isolated_editable_sanity_check() + # Install the dynamic build requirements. + self._install_build_reqs(finder) + # Check if the current environment provides build dependencies + should_check_deps = self.req.use_pep517 and check_build_deps + if should_check_deps: + pyproject_requires = self.req.pyproject_requires + assert pyproject_requires is not None + conflicting, missing = self.req.build_env.check_requirements( + pyproject_requires + ) + if conflicting: + self._raise_conflicts("the backend dependencies", conflicting) + if missing: + self._raise_missing_reqs(missing) + self.req.prepare_metadata() + + def _prepare_build_backend(self, finder: "PackageFinder") -> None: + # Isolate in a BuildEnvironment and install the build-time + # requirements. + pyproject_requires = self.req.pyproject_requires + assert pyproject_requires is not None + + self.req.build_env = BuildEnvironment() + self.req.build_env.install_requirements( + finder, pyproject_requires, "overlay", kind="build dependencies" + ) + conflicting, missing = self.req.build_env.check_requirements( + self.req.requirements_to_check + ) + if conflicting: + self._raise_conflicts("PEP 517/518 supported requirements", conflicting) + if missing: + logger.warning( + "Missing build requirements in pyproject.toml for %s.", + self.req, + ) + logger.warning( + "The project does not specify a build backend, and " + "pip cannot fall back to setuptools without %s.", + " and ".join(map(repr, sorted(missing))), + ) + + def _get_build_requires_wheel(self) -> Iterable[str]: + with self.req.build_env: + runner = runner_with_spinner_message("Getting requirements to build wheel") + backend = self.req.pep517_backend + assert backend is not None + with backend.subprocess_runner(runner): + return backend.get_requires_for_build_wheel() + + def _get_build_requires_editable(self) -> Iterable[str]: + with self.req.build_env: + runner = runner_with_spinner_message( + "Getting requirements to build editable" + ) + backend = self.req.pep517_backend + assert backend is not None + with backend.subprocess_runner(runner): + return backend.get_requires_for_build_editable() + + def _install_build_reqs(self, finder: "PackageFinder") -> None: + # Install any extra build dependencies that the backend requests. + # This must be done in a second pass, as the pyproject.toml + # dependencies must be installed before we can call the backend. + if ( + self.req.editable + and self.req.permit_editable_wheels + and self.req.supports_pyproject_editable + ): + build_reqs = self._get_build_requires_editable() + else: + build_reqs = self._get_build_requires_wheel() + conflicting, missing = self.req.build_env.check_requirements(build_reqs) + if conflicting: + self._raise_conflicts("the backend dependencies", conflicting) + self.req.build_env.install_requirements( + finder, missing, "normal", kind="backend dependencies" + ) + + def _raise_conflicts( + self, conflicting_with: str, conflicting_reqs: Set[Tuple[str, str]] + ) -> None: + format_string = ( + "Some build dependencies for {requirement} " + "conflict with {conflicting_with}: {description}." + ) + error_message = format_string.format( + requirement=self.req, + conflicting_with=conflicting_with, + description=", ".join( + f"{installed} is incompatible with {wanted}" + for installed, wanted in sorted(conflicting_reqs) + ), + ) + raise InstallationError(error_message) + + def _raise_missing_reqs(self, missing: Set[str]) -> None: + format_string = ( + "Some build dependencies for {requirement} are missing: {missing}." + ) + error_message = format_string.format( + requirement=self.req, missing=", ".join(map(repr, sorted(missing))) + ) + raise InstallationError(error_message) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/distributions/wheel.py b/.venv/lib/python3.12/site-packages/pip/_internal/distributions/wheel.py new file mode 100644 index 0000000..bfadd39 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/distributions/wheel.py @@ -0,0 +1,42 @@ +from typing import TYPE_CHECKING, Optional + +from pip._vendor.packaging.utils import canonicalize_name + +from pip._internal.distributions.base import AbstractDistribution +from pip._internal.metadata import ( + BaseDistribution, + FilesystemWheel, + get_wheel_distribution, +) + +if TYPE_CHECKING: + from pip._internal.index.package_finder import PackageFinder + + +class WheelDistribution(AbstractDistribution): + """Represents a wheel distribution. + + This does not need any preparation as wheels can be directly unpacked. + """ + + @property + def build_tracker_id(self) -> Optional[str]: + return None + + def get_metadata_distribution(self) -> BaseDistribution: + """Loads the metadata from the wheel file into memory and returns a + Distribution that uses it, not relying on the wheel file or + requirement. + """ + assert self.req.local_file_path, "Set as part of preparation during download" + assert self.req.name, "Wheels are never unnamed" + wheel = FilesystemWheel(self.req.local_file_path) + return get_wheel_distribution(wheel, canonicalize_name(self.req.name)) + + def prepare_distribution_metadata( + self, + finder: "PackageFinder", + build_isolation: bool, + check_build_deps: bool, + ) -> None: + pass diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/exceptions.py b/.venv/lib/python3.12/site-packages/pip/_internal/exceptions.py new file mode 100644 index 0000000..2587740 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/exceptions.py @@ -0,0 +1,777 @@ +"""Exceptions used throughout package. + +This module MUST NOT try to import from anything within `pip._internal` to +operate. This is expected to be importable from any/all files within the +subpackage and, thus, should not depend on them. +""" + +import configparser +import contextlib +import locale +import logging +import pathlib +import re +import sys +from itertools import chain, groupby, repeat +from typing import TYPE_CHECKING, Dict, Iterator, List, Literal, Optional, Union + +from pip._vendor.rich.console import Console, ConsoleOptions, RenderResult +from pip._vendor.rich.markup import escape +from pip._vendor.rich.text import Text + +if TYPE_CHECKING: + from hashlib import _Hash + + from pip._vendor.requests.models import Request, Response + + from pip._internal.metadata import BaseDistribution + from pip._internal.req.req_install import InstallRequirement + +logger = logging.getLogger(__name__) + + +# +# Scaffolding +# +def _is_kebab_case(s: str) -> bool: + return re.match(r"^[a-z]+(-[a-z]+)*$", s) is not None + + +def _prefix_with_indent( + s: Union[Text, str], + console: Console, + *, + prefix: str, + indent: str, +) -> Text: + if isinstance(s, Text): + text = s + else: + text = console.render_str(s) + + return console.render_str(prefix, overflow="ignore") + console.render_str( + f"\n{indent}", overflow="ignore" + ).join(text.split(allow_blank=True)) + + +class PipError(Exception): + """The base pip error.""" + + +class DiagnosticPipError(PipError): + """An error, that presents diagnostic information to the user. + + This contains a bunch of logic, to enable pretty presentation of our error + messages. Each error gets a unique reference. Each error can also include + additional context, a hint and/or a note -- which are presented with the + main error message in a consistent style. + + This is adapted from the error output styling in `sphinx-theme-builder`. + """ + + reference: str + + def __init__( + self, + *, + kind: 'Literal["error", "warning"]' = "error", + reference: Optional[str] = None, + message: Union[str, Text], + context: Optional[Union[str, Text]], + hint_stmt: Optional[Union[str, Text]], + note_stmt: Optional[Union[str, Text]] = None, + link: Optional[str] = None, + ) -> None: + # Ensure a proper reference is provided. + if reference is None: + assert hasattr(self, "reference"), "error reference not provided!" + reference = self.reference + assert _is_kebab_case(reference), "error reference must be kebab-case!" + + self.kind = kind + self.reference = reference + + self.message = message + self.context = context + + self.note_stmt = note_stmt + self.hint_stmt = hint_stmt + + self.link = link + + super().__init__(f"<{self.__class__.__name__}: {self.reference}>") + + def __repr__(self) -> str: + return ( + f"<{self.__class__.__name__}(" + f"reference={self.reference!r}, " + f"message={self.message!r}, " + f"context={self.context!r}, " + f"note_stmt={self.note_stmt!r}, " + f"hint_stmt={self.hint_stmt!r}" + ")>" + ) + + def __rich_console__( + self, + console: Console, + options: ConsoleOptions, + ) -> RenderResult: + colour = "red" if self.kind == "error" else "yellow" + + yield f"[{colour} bold]{self.kind}[/]: [bold]{self.reference}[/]" + yield "" + + if not options.ascii_only: + # Present the main message, with relevant context indented. + if self.context is not None: + yield _prefix_with_indent( + self.message, + console, + prefix=f"[{colour}]×[/] ", + indent=f"[{colour}]│[/] ", + ) + yield _prefix_with_indent( + self.context, + console, + prefix=f"[{colour}]╰─>[/] ", + indent=f"[{colour}] [/] ", + ) + else: + yield _prefix_with_indent( + self.message, + console, + prefix="[red]×[/] ", + indent=" ", + ) + else: + yield self.message + if self.context is not None: + yield "" + yield self.context + + if self.note_stmt is not None or self.hint_stmt is not None: + yield "" + + if self.note_stmt is not None: + yield _prefix_with_indent( + self.note_stmt, + console, + prefix="[magenta bold]note[/]: ", + indent=" ", + ) + if self.hint_stmt is not None: + yield _prefix_with_indent( + self.hint_stmt, + console, + prefix="[cyan bold]hint[/]: ", + indent=" ", + ) + + if self.link is not None: + yield "" + yield f"Link: {self.link}" + + +# +# Actual Errors +# +class ConfigurationError(PipError): + """General exception in configuration""" + + +class InstallationError(PipError): + """General exception during installation""" + + +class MissingPyProjectBuildRequires(DiagnosticPipError): + """Raised when pyproject.toml has `build-system`, but no `build-system.requires`.""" + + reference = "missing-pyproject-build-system-requires" + + def __init__(self, *, package: str) -> None: + super().__init__( + message=f"Can not process {escape(package)}", + context=Text( + "This package has an invalid pyproject.toml file.\n" + "The [build-system] table is missing the mandatory `requires` key." + ), + note_stmt="This is an issue with the package mentioned above, not pip.", + hint_stmt=Text("See PEP 518 for the detailed specification."), + ) + + +class InvalidPyProjectBuildRequires(DiagnosticPipError): + """Raised when pyproject.toml an invalid `build-system.requires`.""" + + reference = "invalid-pyproject-build-system-requires" + + def __init__(self, *, package: str, reason: str) -> None: + super().__init__( + message=f"Can not process {escape(package)}", + context=Text( + "This package has an invalid `build-system.requires` key in " + f"pyproject.toml.\n{reason}" + ), + note_stmt="This is an issue with the package mentioned above, not pip.", + hint_stmt=Text("See PEP 518 for the detailed specification."), + ) + + +class NoneMetadataError(PipError): + """Raised when accessing a Distribution's "METADATA" or "PKG-INFO". + + This signifies an inconsistency, when the Distribution claims to have + the metadata file (if not, raise ``FileNotFoundError`` instead), but is + not actually able to produce its content. This may be due to permission + errors. + """ + + def __init__( + self, + dist: "BaseDistribution", + metadata_name: str, + ) -> None: + """ + :param dist: A Distribution object. + :param metadata_name: The name of the metadata being accessed + (can be "METADATA" or "PKG-INFO"). + """ + self.dist = dist + self.metadata_name = metadata_name + + def __str__(self) -> str: + # Use `dist` in the error message because its stringification + # includes more information, like the version and location. + return f"None {self.metadata_name} metadata found for distribution: {self.dist}" + + +class UserInstallationInvalid(InstallationError): + """A --user install is requested on an environment without user site.""" + + def __str__(self) -> str: + return "User base directory is not specified" + + +class InvalidSchemeCombination(InstallationError): + def __str__(self) -> str: + before = ", ".join(str(a) for a in self.args[:-1]) + return f"Cannot set {before} and {self.args[-1]} together" + + +class DistributionNotFound(InstallationError): + """Raised when a distribution cannot be found to satisfy a requirement""" + + +class RequirementsFileParseError(InstallationError): + """Raised when a general error occurs parsing a requirements file line.""" + + +class BestVersionAlreadyInstalled(PipError): + """Raised when the most up-to-date version of a package is already + installed.""" + + +class BadCommand(PipError): + """Raised when virtualenv or a command is not found""" + + +class CommandError(PipError): + """Raised when there is an error in command-line arguments""" + + +class PreviousBuildDirError(PipError): + """Raised when there's a previous conflicting build directory""" + + +class NetworkConnectionError(PipError): + """HTTP connection error""" + + def __init__( + self, + error_msg: str, + response: Optional["Response"] = None, + request: Optional["Request"] = None, + ) -> None: + """ + Initialize NetworkConnectionError with `request` and `response` + objects. + """ + self.response = response + self.request = request + self.error_msg = error_msg + if ( + self.response is not None + and not self.request + and hasattr(response, "request") + ): + self.request = self.response.request + super().__init__(error_msg, response, request) + + def __str__(self) -> str: + return str(self.error_msg) + + +class InvalidWheelFilename(InstallationError): + """Invalid wheel filename.""" + + +class UnsupportedWheel(InstallationError): + """Unsupported wheel.""" + + +class InvalidWheel(InstallationError): + """Invalid (e.g. corrupt) wheel.""" + + def __init__(self, location: str, name: str): + self.location = location + self.name = name + + def __str__(self) -> str: + return f"Wheel '{self.name}' located at {self.location} is invalid." + + +class MetadataInconsistent(InstallationError): + """Built metadata contains inconsistent information. + + This is raised when the metadata contains values (e.g. name and version) + that do not match the information previously obtained from sdist filename, + user-supplied ``#egg=`` value, or an install requirement name. + """ + + def __init__( + self, ireq: "InstallRequirement", field: str, f_val: str, m_val: str + ) -> None: + self.ireq = ireq + self.field = field + self.f_val = f_val + self.m_val = m_val + + def __str__(self) -> str: + return ( + f"Requested {self.ireq} has inconsistent {self.field}: " + f"expected {self.f_val!r}, but metadata has {self.m_val!r}" + ) + + +class MetadataInvalid(InstallationError): + """Metadata is invalid.""" + + def __init__(self, ireq: "InstallRequirement", error: str) -> None: + self.ireq = ireq + self.error = error + + def __str__(self) -> str: + return f"Requested {self.ireq} has invalid metadata: {self.error}" + + +class InstallationSubprocessError(DiagnosticPipError, InstallationError): + """A subprocess call failed.""" + + reference = "subprocess-exited-with-error" + + def __init__( + self, + *, + command_description: str, + exit_code: int, + output_lines: Optional[List[str]], + ) -> None: + if output_lines is None: + output_prompt = Text("See above for output.") + else: + output_prompt = ( + Text.from_markup(f"[red][{len(output_lines)} lines of output][/]\n") + + Text("".join(output_lines)) + + Text.from_markup(R"[red]\[end of output][/]") + ) + + super().__init__( + message=( + f"[green]{escape(command_description)}[/] did not run successfully.\n" + f"exit code: {exit_code}" + ), + context=output_prompt, + hint_stmt=None, + note_stmt=( + "This error originates from a subprocess, and is likely not a " + "problem with pip." + ), + ) + + self.command_description = command_description + self.exit_code = exit_code + + def __str__(self) -> str: + return f"{self.command_description} exited with {self.exit_code}" + + +class MetadataGenerationFailed(InstallationSubprocessError, InstallationError): + reference = "metadata-generation-failed" + + def __init__( + self, + *, + package_details: str, + ) -> None: + super(InstallationSubprocessError, self).__init__( + message="Encountered error while generating package metadata.", + context=escape(package_details), + hint_stmt="See above for details.", + note_stmt="This is an issue with the package mentioned above, not pip.", + ) + + def __str__(self) -> str: + return "metadata generation failed" + + +class HashErrors(InstallationError): + """Multiple HashError instances rolled into one for reporting""" + + def __init__(self) -> None: + self.errors: List["HashError"] = [] + + def append(self, error: "HashError") -> None: + self.errors.append(error) + + def __str__(self) -> str: + lines = [] + self.errors.sort(key=lambda e: e.order) + for cls, errors_of_cls in groupby(self.errors, lambda e: e.__class__): + lines.append(cls.head) + lines.extend(e.body() for e in errors_of_cls) + if lines: + return "\n".join(lines) + return "" + + def __bool__(self) -> bool: + return bool(self.errors) + + +class HashError(InstallationError): + """ + A failure to verify a package against known-good hashes + + :cvar order: An int sorting hash exception classes by difficulty of + recovery (lower being harder), so the user doesn't bother fretting + about unpinned packages when he has deeper issues, like VCS + dependencies, to deal with. Also keeps error reports in a + deterministic order. + :cvar head: A section heading for display above potentially many + exceptions of this kind + :ivar req: The InstallRequirement that triggered this error. This is + pasted on after the exception is instantiated, because it's not + typically available earlier. + + """ + + req: Optional["InstallRequirement"] = None + head = "" + order: int = -1 + + def body(self) -> str: + """Return a summary of me for display under the heading. + + This default implementation simply prints a description of the + triggering requirement. + + :param req: The InstallRequirement that provoked this error, with + its link already populated by the resolver's _populate_link(). + + """ + return f" {self._requirement_name()}" + + def __str__(self) -> str: + return f"{self.head}\n{self.body()}" + + def _requirement_name(self) -> str: + """Return a description of the requirement that triggered me. + + This default implementation returns long description of the req, with + line numbers + + """ + return str(self.req) if self.req else "unknown package" + + +class VcsHashUnsupported(HashError): + """A hash was provided for a version-control-system-based requirement, but + we don't have a method for hashing those.""" + + order = 0 + head = ( + "Can't verify hashes for these requirements because we don't " + "have a way to hash version control repositories:" + ) + + +class DirectoryUrlHashUnsupported(HashError): + """A hash was provided for a version-control-system-based requirement, but + we don't have a method for hashing those.""" + + order = 1 + head = ( + "Can't verify hashes for these file:// requirements because they " + "point to directories:" + ) + + +class HashMissing(HashError): + """A hash was needed for a requirement but is absent.""" + + order = 2 + head = ( + "Hashes are required in --require-hashes mode, but they are " + "missing from some requirements. Here is a list of those " + "requirements along with the hashes their downloaded archives " + "actually had. Add lines like these to your requirements files to " + "prevent tampering. (If you did not enable --require-hashes " + "manually, note that it turns on automatically when any package " + "has a hash.)" + ) + + def __init__(self, gotten_hash: str) -> None: + """ + :param gotten_hash: The hash of the (possibly malicious) archive we + just downloaded + """ + self.gotten_hash = gotten_hash + + def body(self) -> str: + # Dodge circular import. + from pip._internal.utils.hashes import FAVORITE_HASH + + package = None + if self.req: + # In the case of URL-based requirements, display the original URL + # seen in the requirements file rather than the package name, + # so the output can be directly copied into the requirements file. + package = ( + self.req.original_link + if self.req.is_direct + # In case someone feeds something downright stupid + # to InstallRequirement's constructor. + else getattr(self.req, "req", None) + ) + return " {} --hash={}:{}".format( + package or "unknown package", FAVORITE_HASH, self.gotten_hash + ) + + +class HashUnpinned(HashError): + """A requirement had a hash specified but was not pinned to a specific + version.""" + + order = 3 + head = ( + "In --require-hashes mode, all requirements must have their " + "versions pinned with ==. These do not:" + ) + + +class HashMismatch(HashError): + """ + Distribution file hash values don't match. + + :ivar package_name: The name of the package that triggered the hash + mismatch. Feel free to write to this after the exception is raise to + improve its error message. + + """ + + order = 4 + head = ( + "THESE PACKAGES DO NOT MATCH THE HASHES FROM THE REQUIREMENTS " + "FILE. If you have updated the package versions, please update " + "the hashes. Otherwise, examine the package contents carefully; " + "someone may have tampered with them." + ) + + def __init__(self, allowed: Dict[str, List[str]], gots: Dict[str, "_Hash"]) -> None: + """ + :param allowed: A dict of algorithm names pointing to lists of allowed + hex digests + :param gots: A dict of algorithm names pointing to hashes we + actually got from the files under suspicion + """ + self.allowed = allowed + self.gots = gots + + def body(self) -> str: + return f" {self._requirement_name()}:\n{self._hash_comparison()}" + + def _hash_comparison(self) -> str: + """ + Return a comparison of actual and expected hash values. + + Example:: + + Expected sha256 abcdeabcdeabcdeabcdeabcdeabcdeabcdeabcdeabcde + or 123451234512345123451234512345123451234512345 + Got bcdefbcdefbcdefbcdefbcdefbcdefbcdefbcdefbcdef + + """ + + def hash_then_or(hash_name: str) -> "chain[str]": + # For now, all the decent hashes have 6-char names, so we can get + # away with hard-coding space literals. + return chain([hash_name], repeat(" or")) + + lines: List[str] = [] + for hash_name, expecteds in self.allowed.items(): + prefix = hash_then_or(hash_name) + lines.extend((f" Expected {next(prefix)} {e}") for e in expecteds) + lines.append( + f" Got {self.gots[hash_name].hexdigest()}\n" + ) + return "\n".join(lines) + + +class UnsupportedPythonVersion(InstallationError): + """Unsupported python version according to Requires-Python package + metadata.""" + + +class ConfigurationFileCouldNotBeLoaded(ConfigurationError): + """When there are errors while loading a configuration file""" + + def __init__( + self, + reason: str = "could not be loaded", + fname: Optional[str] = None, + error: Optional[configparser.Error] = None, + ) -> None: + super().__init__(error) + self.reason = reason + self.fname = fname + self.error = error + + def __str__(self) -> str: + if self.fname is not None: + message_part = f" in {self.fname}." + else: + assert self.error is not None + message_part = f".\n{self.error}\n" + return f"Configuration file {self.reason}{message_part}" + + +_DEFAULT_EXTERNALLY_MANAGED_ERROR = f"""\ +The Python environment under {sys.prefix} is managed externally, and may not be +manipulated by the user. Please use specific tooling from the distributor of +the Python installation to interact with this environment instead. +""" + + +class ExternallyManagedEnvironment(DiagnosticPipError): + """The current environment is externally managed. + + This is raised when the current environment is externally managed, as + defined by `PEP 668`_. The ``EXTERNALLY-MANAGED`` configuration is checked + and displayed when the error is bubbled up to the user. + + :param error: The error message read from ``EXTERNALLY-MANAGED``. + """ + + reference = "externally-managed-environment" + + def __init__(self, error: Optional[str]) -> None: + if error is None: + context = Text(_DEFAULT_EXTERNALLY_MANAGED_ERROR) + else: + context = Text(error) + super().__init__( + message="This environment is externally managed", + context=context, + note_stmt=( + "If you believe this is a mistake, please contact your " + "Python installation or OS distribution provider. " + "You can override this, at the risk of breaking your Python " + "installation or OS, by passing --break-system-packages." + ), + hint_stmt=Text("See PEP 668 for the detailed specification."), + ) + + @staticmethod + def _iter_externally_managed_error_keys() -> Iterator[str]: + # LC_MESSAGES is in POSIX, but not the C standard. The most common + # platform that does not implement this category is Windows, where + # using other categories for console message localization is equally + # unreliable, so we fall back to the locale-less vendor message. This + # can always be re-evaluated when a vendor proposes a new alternative. + try: + category = locale.LC_MESSAGES + except AttributeError: + lang: Optional[str] = None + else: + lang, _ = locale.getlocale(category) + if lang is not None: + yield f"Error-{lang}" + for sep in ("-", "_"): + before, found, _ = lang.partition(sep) + if not found: + continue + yield f"Error-{before}" + yield "Error" + + @classmethod + def from_config( + cls, + config: Union[pathlib.Path, str], + ) -> "ExternallyManagedEnvironment": + parser = configparser.ConfigParser(interpolation=None) + try: + parser.read(config, encoding="utf-8") + section = parser["externally-managed"] + for key in cls._iter_externally_managed_error_keys(): + with contextlib.suppress(KeyError): + return cls(section[key]) + except KeyError: + pass + except (OSError, UnicodeDecodeError, configparser.ParsingError): + from pip._internal.utils._log import VERBOSE + + exc_info = logger.isEnabledFor(VERBOSE) + logger.warning("Failed to read %s", config, exc_info=exc_info) + return cls(None) + + +class UninstallMissingRecord(DiagnosticPipError): + reference = "uninstall-no-record-file" + + def __init__(self, *, distribution: "BaseDistribution") -> None: + installer = distribution.installer + if not installer or installer == "pip": + dep = f"{distribution.raw_name}=={distribution.version}" + hint = Text.assemble( + "You might be able to recover from this via: ", + (f"pip install --force-reinstall --no-deps {dep}", "green"), + ) + else: + hint = Text( + f"The package was installed by {installer}. " + "You should check if it can uninstall the package." + ) + + super().__init__( + message=Text(f"Cannot uninstall {distribution}"), + context=( + "The package's contents are unknown: " + f"no RECORD file was found for {distribution.raw_name}." + ), + hint_stmt=hint, + ) + + +class LegacyDistutilsInstall(DiagnosticPipError): + reference = "uninstall-distutils-installed-package" + + def __init__(self, *, distribution: "BaseDistribution") -> None: + super().__init__( + message=Text(f"Cannot uninstall {distribution}"), + context=( + "It is a distutils installed project and thus we cannot accurately " + "determine which files belong to it which would lead to only a partial " + "uninstall." + ), + hint_stmt=None, + ) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/index/__init__.py b/.venv/lib/python3.12/site-packages/pip/_internal/index/__init__.py new file mode 100644 index 0000000..7a17b7b --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/index/__init__.py @@ -0,0 +1,2 @@ +"""Index interaction code +""" diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/index/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/index/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..850a4320db50c688b1c2155b5f11547d94082cac GIT binary patch literal 230 zcmX@j%ge<81Rn!er^x~7#~=<2FhUuhIe?7m3@Hpz43&(UOjY8Zc`2zC3YmE&sYQv& zC7Jno3d#8?sa$@VjJMe1<5TjJpdSymC@(QbKNDoH xemqbhvm`!Vub}c5hfQvNN@-52T@f45HjsmhLH_x`%*e?2iHVVsrHBQ{1pwd^K>Yv! literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/index/__pycache__/collector.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/index/__pycache__/collector.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5351b905647e82d7ab35db1a2ed64c1f8ee74b30 GIT binary patch literal 21623 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 OKKrlx9#NQ0`2Pc*z&JMm literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/index/__pycache__/sources.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/index/__pycache__/sources.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..0588f492f7e0bff73e5c10a99b7646158898dead GIT binary patch literal 12602 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 Optional[str]: + """Look for VCS schemes in the URL. + + Returns the matched VCS scheme, or None if there's no match. + """ + for scheme in vcs.schemes: + if url.lower().startswith(scheme) and url[len(scheme)] in "+:": + return scheme + return None + + +class _NotAPIContent(Exception): + def __init__(self, content_type: str, request_desc: str) -> None: + super().__init__(content_type, request_desc) + self.content_type = content_type + self.request_desc = request_desc + + +def _ensure_api_header(response: Response) -> None: + """ + Check the Content-Type header to ensure the response contains a Simple + API Response. + + Raises `_NotAPIContent` if the content type is not a valid content-type. + """ + content_type = response.headers.get("Content-Type", "Unknown") + + content_type_l = content_type.lower() + if content_type_l.startswith( + ( + "text/html", + "application/vnd.pypi.simple.v1+html", + "application/vnd.pypi.simple.v1+json", + ) + ): + return + + raise _NotAPIContent(content_type, response.request.method) + + +class _NotHTTP(Exception): + pass + + +def _ensure_api_response(url: str, session: PipSession) -> None: + """ + Send a HEAD request to the URL, and ensure the response contains a simple + API Response. + + Raises `_NotHTTP` if the URL is not available for a HEAD request, or + `_NotAPIContent` if the content type is not a valid content type. + """ + scheme, netloc, path, query, fragment = urllib.parse.urlsplit(url) + if scheme not in {"http", "https"}: + raise _NotHTTP() + + resp = session.head(url, allow_redirects=True) + raise_for_status(resp) + + _ensure_api_header(resp) + + +def _get_simple_response(url: str, session: PipSession) -> Response: + """Access an Simple API response with GET, and return the response. + + This consists of three parts: + + 1. If the URL looks suspiciously like an archive, send a HEAD first to + check the Content-Type is HTML or Simple API, to avoid downloading a + large file. Raise `_NotHTTP` if the content type cannot be determined, or + `_NotAPIContent` if it is not HTML or a Simple API. + 2. Actually perform the request. Raise HTTP exceptions on network failures. + 3. Check the Content-Type header to make sure we got a Simple API response, + and raise `_NotAPIContent` otherwise. + """ + if is_archive_file(Link(url).filename): + _ensure_api_response(url, session=session) + + logger.debug("Getting page %s", redact_auth_from_url(url)) + + resp = session.get( + url, + headers={ + "Accept": ", ".join( + [ + "application/vnd.pypi.simple.v1+json", + "application/vnd.pypi.simple.v1+html; q=0.1", + "text/html; q=0.01", + ] + ), + # We don't want to blindly returned cached data for + # /simple/, because authors generally expecting that + # twine upload && pip install will function, but if + # they've done a pip install in the last ~10 minutes + # it won't. Thus by setting this to zero we will not + # blindly use any cached data, however the benefit of + # using max-age=0 instead of no-cache, is that we will + # still support conditional requests, so we will still + # minimize traffic sent in cases where the page hasn't + # changed at all, we will just always incur the round + # trip for the conditional GET now instead of only + # once per 10 minutes. + # For more information, please see pypa/pip#5670. + "Cache-Control": "max-age=0", + }, + ) + raise_for_status(resp) + + # The check for archives above only works if the url ends with + # something that looks like an archive. However that is not a + # requirement of an url. Unless we issue a HEAD request on every + # url we cannot know ahead of time for sure if something is a + # Simple API response or not. However we can check after we've + # downloaded it. + _ensure_api_header(resp) + + logger.debug( + "Fetched page %s as %s", + redact_auth_from_url(url), + resp.headers.get("Content-Type", "Unknown"), + ) + + return resp + + +def _get_encoding_from_headers(headers: ResponseHeaders) -> Optional[str]: + """Determine if we have any encoding information in our headers.""" + if headers and "Content-Type" in headers: + m = email.message.Message() + m["content-type"] = headers["Content-Type"] + charset = m.get_param("charset") + if charset: + return str(charset) + return None + + +class CacheablePageContent: + def __init__(self, page: "IndexContent") -> None: + assert page.cache_link_parsing + self.page = page + + def __eq__(self, other: object) -> bool: + return isinstance(other, type(self)) and self.page.url == other.page.url + + def __hash__(self) -> int: + return hash(self.page.url) + + +class ParseLinks(Protocol): + def __call__(self, page: "IndexContent") -> Iterable[Link]: ... + + +def with_cached_index_content(fn: ParseLinks) -> ParseLinks: + """ + Given a function that parses an Iterable[Link] from an IndexContent, cache the + function's result (keyed by CacheablePageContent), unless the IndexContent + `page` has `page.cache_link_parsing == False`. + """ + + @functools.lru_cache(maxsize=None) + def wrapper(cacheable_page: CacheablePageContent) -> List[Link]: + return list(fn(cacheable_page.page)) + + @functools.wraps(fn) + def wrapper_wrapper(page: "IndexContent") -> List[Link]: + if page.cache_link_parsing: + return wrapper(CacheablePageContent(page)) + return list(fn(page)) + + return wrapper_wrapper + + +@with_cached_index_content +def parse_links(page: "IndexContent") -> Iterable[Link]: + """ + Parse a Simple API's Index Content, and yield its anchor elements as Link objects. + """ + + content_type_l = page.content_type.lower() + if content_type_l.startswith("application/vnd.pypi.simple.v1+json"): + data = json.loads(page.content) + for file in data.get("files", []): + link = Link.from_json(file, page.url) + if link is None: + continue + yield link + return + + parser = HTMLLinkParser(page.url) + encoding = page.encoding or "utf-8" + parser.feed(page.content.decode(encoding)) + + url = page.url + base_url = parser.base_url or url + for anchor in parser.anchors: + link = Link.from_element(anchor, page_url=url, base_url=base_url) + if link is None: + continue + yield link + + +@dataclass(frozen=True) +class IndexContent: + """Represents one response (or page), along with its URL. + + :param encoding: the encoding to decode the given content. + :param url: the URL from which the HTML was downloaded. + :param cache_link_parsing: whether links parsed from this page's url + should be cached. PyPI index urls should + have this set to False, for example. + """ + + content: bytes + content_type: str + encoding: Optional[str] + url: str + cache_link_parsing: bool = True + + def __str__(self) -> str: + return redact_auth_from_url(self.url) + + +class HTMLLinkParser(HTMLParser): + """ + HTMLParser that keeps the first base HREF and a list of all anchor + elements' attributes. + """ + + def __init__(self, url: str) -> None: + super().__init__(convert_charrefs=True) + + self.url: str = url + self.base_url: Optional[str] = None + self.anchors: List[Dict[str, Optional[str]]] = [] + + def handle_starttag(self, tag: str, attrs: List[Tuple[str, Optional[str]]]) -> None: + if tag == "base" and self.base_url is None: + href = self.get_href(attrs) + if href is not None: + self.base_url = href + elif tag == "a": + self.anchors.append(dict(attrs)) + + def get_href(self, attrs: List[Tuple[str, Optional[str]]]) -> Optional[str]: + for name, value in attrs: + if name == "href": + return value + return None + + +def _handle_get_simple_fail( + link: Link, + reason: Union[str, Exception], + meth: Optional[Callable[..., None]] = None, +) -> None: + if meth is None: + meth = logger.debug + meth("Could not fetch URL %s: %s - skipping", link, reason) + + +def _make_index_content( + response: Response, cache_link_parsing: bool = True +) -> IndexContent: + encoding = _get_encoding_from_headers(response.headers) + return IndexContent( + response.content, + response.headers["Content-Type"], + encoding=encoding, + url=response.url, + cache_link_parsing=cache_link_parsing, + ) + + +def _get_index_content(link: Link, *, session: PipSession) -> Optional["IndexContent"]: + url = link.url.split("#", 1)[0] + + # Check for VCS schemes that do not support lookup as web pages. + vcs_scheme = _match_vcs_scheme(url) + if vcs_scheme: + logger.warning( + "Cannot look at %s URL %s because it does not support lookup as web pages.", + vcs_scheme, + link, + ) + return None + + # Tack index.html onto file:// URLs that point to directories + scheme, _, path, _, _, _ = urllib.parse.urlparse(url) + if scheme == "file" and os.path.isdir(urllib.request.url2pathname(path)): + # add trailing slash if not present so urljoin doesn't trim + # final segment + if not url.endswith("/"): + url += "/" + # TODO: In the future, it would be nice if pip supported PEP 691 + # style responses in the file:// URLs, however there's no + # standard file extension for application/vnd.pypi.simple.v1+json + # so we'll need to come up with something on our own. + url = urllib.parse.urljoin(url, "index.html") + logger.debug(" file: URL is directory, getting %s", url) + + try: + resp = _get_simple_response(url, session=session) + except _NotHTTP: + logger.warning( + "Skipping page %s because it looks like an archive, and cannot " + "be checked by a HTTP HEAD request.", + link, + ) + except _NotAPIContent as exc: + logger.warning( + "Skipping page %s because the %s request got Content-Type: %s. " + "The only supported Content-Types are application/vnd.pypi.simple.v1+json, " + "application/vnd.pypi.simple.v1+html, and text/html", + link, + exc.request_desc, + exc.content_type, + ) + except NetworkConnectionError as exc: + _handle_get_simple_fail(link, exc) + except RetryError as exc: + _handle_get_simple_fail(link, exc) + except SSLError as exc: + reason = "There was a problem confirming the ssl certificate: " + reason += str(exc) + _handle_get_simple_fail(link, reason, meth=logger.info) + except requests.ConnectionError as exc: + _handle_get_simple_fail(link, f"connection error: {exc}") + except requests.Timeout: + _handle_get_simple_fail(link, "timed out") + else: + return _make_index_content(resp, cache_link_parsing=link.cache_link_parsing) + return None + + +class CollectedSources(NamedTuple): + find_links: Sequence[Optional[LinkSource]] + index_urls: Sequence[Optional[LinkSource]] + + +class LinkCollector: + """ + Responsible for collecting Link objects from all configured locations, + making network requests as needed. + + The class's main method is its collect_sources() method. + """ + + def __init__( + self, + session: PipSession, + search_scope: SearchScope, + ) -> None: + self.search_scope = search_scope + self.session = session + + @classmethod + def create( + cls, + session: PipSession, + options: Values, + suppress_no_index: bool = False, + ) -> "LinkCollector": + """ + :param session: The Session to use to make requests. + :param suppress_no_index: Whether to ignore the --no-index option + when constructing the SearchScope object. + """ + index_urls = [options.index_url] + options.extra_index_urls + if options.no_index and not suppress_no_index: + logger.debug( + "Ignoring indexes: %s", + ",".join(redact_auth_from_url(url) for url in index_urls), + ) + index_urls = [] + + # Make sure find_links is a list before passing to create(). + find_links = options.find_links or [] + + search_scope = SearchScope.create( + find_links=find_links, + index_urls=index_urls, + no_index=options.no_index, + ) + link_collector = LinkCollector( + session=session, + search_scope=search_scope, + ) + return link_collector + + @property + def find_links(self) -> List[str]: + return self.search_scope.find_links + + def fetch_response(self, location: Link) -> Optional[IndexContent]: + """ + Fetch an HTML page containing package links. + """ + return _get_index_content(location, session=self.session) + + def collect_sources( + self, + project_name: str, + candidates_from_page: CandidatesFromPage, + ) -> CollectedSources: + # The OrderedDict calls deduplicate sources by URL. + index_url_sources = collections.OrderedDict( + build_source( + loc, + candidates_from_page=candidates_from_page, + page_validator=self.session.is_secure_origin, + expand_dir=False, + cache_link_parsing=False, + project_name=project_name, + ) + for loc in self.search_scope.get_index_urls_locations(project_name) + ).values() + find_links_sources = collections.OrderedDict( + build_source( + loc, + candidates_from_page=candidates_from_page, + page_validator=self.session.is_secure_origin, + expand_dir=True, + cache_link_parsing=True, + project_name=project_name, + ) + for loc in self.find_links + ).values() + + if logger.isEnabledFor(logging.DEBUG): + lines = [ + f"* {s.link}" + for s in itertools.chain(find_links_sources, index_url_sources) + if s is not None and s.link is not None + ] + lines = [ + f"{len(lines)} location(s) to search " + f"for versions of {project_name}:" + ] + lines + logger.debug("\n".join(lines)) + + return CollectedSources( + find_links=list(find_links_sources), + index_urls=list(index_url_sources), + ) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/index/package_finder.py b/.venv/lib/python3.12/site-packages/pip/_internal/index/package_finder.py new file mode 100644 index 0000000..0d65ce3 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/index/package_finder.py @@ -0,0 +1,1020 @@ +"""Routines related to PyPI, indexes""" + +import enum +import functools +import itertools +import logging +import re +from dataclasses import dataclass +from typing import TYPE_CHECKING, FrozenSet, Iterable, List, Optional, Set, Tuple, Union + +from pip._vendor.packaging import specifiers +from pip._vendor.packaging.tags import Tag +from pip._vendor.packaging.utils import canonicalize_name +from pip._vendor.packaging.version import InvalidVersion, _BaseVersion +from pip._vendor.packaging.version import parse as parse_version + +from pip._internal.exceptions import ( + BestVersionAlreadyInstalled, + DistributionNotFound, + InvalidWheelFilename, + UnsupportedWheel, +) +from pip._internal.index.collector import LinkCollector, parse_links +from pip._internal.models.candidate import InstallationCandidate +from pip._internal.models.format_control import FormatControl +from pip._internal.models.link import Link +from pip._internal.models.search_scope import SearchScope +from pip._internal.models.selection_prefs import SelectionPreferences +from pip._internal.models.target_python import TargetPython +from pip._internal.models.wheel import Wheel +from pip._internal.req import InstallRequirement +from pip._internal.utils._log import getLogger +from pip._internal.utils.filetypes import WHEEL_EXTENSION +from pip._internal.utils.hashes import Hashes +from pip._internal.utils.logging import indent_log +from pip._internal.utils.misc import build_netloc +from pip._internal.utils.packaging import check_requires_python +from pip._internal.utils.unpacking import SUPPORTED_EXTENSIONS + +if TYPE_CHECKING: + from pip._vendor.typing_extensions import TypeGuard + +__all__ = ["FormatControl", "BestCandidateResult", "PackageFinder"] + + +logger = getLogger(__name__) + +BuildTag = Union[Tuple[()], Tuple[int, str]] +CandidateSortingKey = Tuple[int, int, int, _BaseVersion, Optional[int], BuildTag] + + +def _check_link_requires_python( + link: Link, + version_info: Tuple[int, int, int], + ignore_requires_python: bool = False, +) -> bool: + """ + Return whether the given Python version is compatible with a link's + "Requires-Python" value. + + :param version_info: A 3-tuple of ints representing the Python + major-minor-micro version to check. + :param ignore_requires_python: Whether to ignore the "Requires-Python" + value if the given Python version isn't compatible. + """ + try: + is_compatible = check_requires_python( + link.requires_python, + version_info=version_info, + ) + except specifiers.InvalidSpecifier: + logger.debug( + "Ignoring invalid Requires-Python (%r) for link: %s", + link.requires_python, + link, + ) + else: + if not is_compatible: + version = ".".join(map(str, version_info)) + if not ignore_requires_python: + logger.verbose( + "Link requires a different Python (%s not in: %r): %s", + version, + link.requires_python, + link, + ) + return False + + logger.debug( + "Ignoring failed Requires-Python check (%s not in: %r) for link: %s", + version, + link.requires_python, + link, + ) + + return True + + +class LinkType(enum.Enum): + candidate = enum.auto() + different_project = enum.auto() + yanked = enum.auto() + format_unsupported = enum.auto() + format_invalid = enum.auto() + platform_mismatch = enum.auto() + requires_python_mismatch = enum.auto() + + +class LinkEvaluator: + """ + Responsible for evaluating links for a particular project. + """ + + _py_version_re = re.compile(r"-py([123]\.?[0-9]?)$") + + # Don't include an allow_yanked default value to make sure each call + # site considers whether yanked releases are allowed. This also causes + # that decision to be made explicit in the calling code, which helps + # people when reading the code. + def __init__( + self, + project_name: str, + canonical_name: str, + formats: FrozenSet[str], + target_python: TargetPython, + allow_yanked: bool, + ignore_requires_python: Optional[bool] = None, + ) -> None: + """ + :param project_name: The user supplied package name. + :param canonical_name: The canonical package name. + :param formats: The formats allowed for this package. Should be a set + with 'binary' or 'source' or both in it. + :param target_python: The target Python interpreter to use when + evaluating link compatibility. This is used, for example, to + check wheel compatibility, as well as when checking the Python + version, e.g. the Python version embedded in a link filename + (or egg fragment) and against an HTML link's optional PEP 503 + "data-requires-python" attribute. + :param allow_yanked: Whether files marked as yanked (in the sense + of PEP 592) are permitted to be candidates for install. + :param ignore_requires_python: Whether to ignore incompatible + PEP 503 "data-requires-python" values in HTML links. Defaults + to False. + """ + if ignore_requires_python is None: + ignore_requires_python = False + + self._allow_yanked = allow_yanked + self._canonical_name = canonical_name + self._ignore_requires_python = ignore_requires_python + self._formats = formats + self._target_python = target_python + + self.project_name = project_name + + def evaluate_link(self, link: Link) -> Tuple[LinkType, str]: + """ + Determine whether a link is a candidate for installation. + + :return: A tuple (result, detail), where *result* is an enum + representing whether the evaluation found a candidate, or the reason + why one is not found. If a candidate is found, *detail* will be the + candidate's version string; if one is not found, it contains the + reason the link fails to qualify. + """ + version = None + if link.is_yanked and not self._allow_yanked: + reason = link.yanked_reason or "" + return (LinkType.yanked, f"yanked for reason: {reason}") + + if link.egg_fragment: + egg_info = link.egg_fragment + ext = link.ext + else: + egg_info, ext = link.splitext() + if not ext: + return (LinkType.format_unsupported, "not a file") + if ext not in SUPPORTED_EXTENSIONS: + return ( + LinkType.format_unsupported, + f"unsupported archive format: {ext}", + ) + if "binary" not in self._formats and ext == WHEEL_EXTENSION: + reason = f"No binaries permitted for {self.project_name}" + return (LinkType.format_unsupported, reason) + if "macosx10" in link.path and ext == ".zip": + return (LinkType.format_unsupported, "macosx10 one") + if ext == WHEEL_EXTENSION: + try: + wheel = Wheel(link.filename) + except InvalidWheelFilename: + return ( + LinkType.format_invalid, + "invalid wheel filename", + ) + if canonicalize_name(wheel.name) != self._canonical_name: + reason = f"wrong project name (not {self.project_name})" + return (LinkType.different_project, reason) + + supported_tags = self._target_python.get_unsorted_tags() + if not wheel.supported(supported_tags): + # Include the wheel's tags in the reason string to + # simplify troubleshooting compatibility issues. + file_tags = ", ".join(wheel.get_formatted_file_tags()) + reason = ( + f"none of the wheel's tags ({file_tags}) are compatible " + f"(run pip debug --verbose to show compatible tags)" + ) + return (LinkType.platform_mismatch, reason) + + version = wheel.version + + # This should be up by the self.ok_binary check, but see issue 2700. + if "source" not in self._formats and ext != WHEEL_EXTENSION: + reason = f"No sources permitted for {self.project_name}" + return (LinkType.format_unsupported, reason) + + if not version: + version = _extract_version_from_fragment( + egg_info, + self._canonical_name, + ) + if not version: + reason = f"Missing project version for {self.project_name}" + return (LinkType.format_invalid, reason) + + match = self._py_version_re.search(version) + if match: + version = version[: match.start()] + py_version = match.group(1) + if py_version != self._target_python.py_version: + return ( + LinkType.platform_mismatch, + "Python version is incorrect", + ) + + supports_python = _check_link_requires_python( + link, + version_info=self._target_python.py_version_info, + ignore_requires_python=self._ignore_requires_python, + ) + if not supports_python: + reason = f"{version} Requires-Python {link.requires_python}" + return (LinkType.requires_python_mismatch, reason) + + logger.debug("Found link %s, version: %s", link, version) + + return (LinkType.candidate, version) + + +def filter_unallowed_hashes( + candidates: List[InstallationCandidate], + hashes: Optional[Hashes], + project_name: str, +) -> List[InstallationCandidate]: + """ + Filter out candidates whose hashes aren't allowed, and return a new + list of candidates. + + If at least one candidate has an allowed hash, then all candidates with + either an allowed hash or no hash specified are returned. Otherwise, + the given candidates are returned. + + Including the candidates with no hash specified when there is a match + allows a warning to be logged if there is a more preferred candidate + with no hash specified. Returning all candidates in the case of no + matches lets pip report the hash of the candidate that would otherwise + have been installed (e.g. permitting the user to more easily update + their requirements file with the desired hash). + """ + if not hashes: + logger.debug( + "Given no hashes to check %s links for project %r: " + "discarding no candidates", + len(candidates), + project_name, + ) + # Make sure we're not returning back the given value. + return list(candidates) + + matches_or_no_digest = [] + # Collect the non-matches for logging purposes. + non_matches = [] + match_count = 0 + for candidate in candidates: + link = candidate.link + if not link.has_hash: + pass + elif link.is_hash_allowed(hashes=hashes): + match_count += 1 + else: + non_matches.append(candidate) + continue + + matches_or_no_digest.append(candidate) + + if match_count: + filtered = matches_or_no_digest + else: + # Make sure we're not returning back the given value. + filtered = list(candidates) + + if len(filtered) == len(candidates): + discard_message = "discarding no candidates" + else: + discard_message = "discarding {} non-matches:\n {}".format( + len(non_matches), + "\n ".join(str(candidate.link) for candidate in non_matches), + ) + + logger.debug( + "Checked %s links for project %r against %s hashes " + "(%s matches, %s no digest): %s", + len(candidates), + project_name, + hashes.digest_count, + match_count, + len(matches_or_no_digest) - match_count, + discard_message, + ) + + return filtered + + +@dataclass +class CandidatePreferences: + """ + Encapsulates some of the preferences for filtering and sorting + InstallationCandidate objects. + """ + + prefer_binary: bool = False + allow_all_prereleases: bool = False + + +class BestCandidateResult: + """A collection of candidates, returned by `PackageFinder.find_best_candidate`. + + This class is only intended to be instantiated by CandidateEvaluator's + `compute_best_candidate()` method. + """ + + def __init__( + self, + candidates: List[InstallationCandidate], + applicable_candidates: List[InstallationCandidate], + best_candidate: Optional[InstallationCandidate], + ) -> None: + """ + :param candidates: A sequence of all available candidates found. + :param applicable_candidates: The applicable candidates. + :param best_candidate: The most preferred candidate found, or None + if no applicable candidates were found. + """ + assert set(applicable_candidates) <= set(candidates) + + if best_candidate is None: + assert not applicable_candidates + else: + assert best_candidate in applicable_candidates + + self._applicable_candidates = applicable_candidates + self._candidates = candidates + + self.best_candidate = best_candidate + + def iter_all(self) -> Iterable[InstallationCandidate]: + """Iterate through all candidates.""" + return iter(self._candidates) + + def iter_applicable(self) -> Iterable[InstallationCandidate]: + """Iterate through the applicable candidates.""" + return iter(self._applicable_candidates) + + +class CandidateEvaluator: + """ + Responsible for filtering and sorting candidates for installation based + on what tags are valid. + """ + + @classmethod + def create( + cls, + project_name: str, + target_python: Optional[TargetPython] = None, + prefer_binary: bool = False, + allow_all_prereleases: bool = False, + specifier: Optional[specifiers.BaseSpecifier] = None, + hashes: Optional[Hashes] = None, + ) -> "CandidateEvaluator": + """Create a CandidateEvaluator object. + + :param target_python: The target Python interpreter to use when + checking compatibility. If None (the default), a TargetPython + object will be constructed from the running Python. + :param specifier: An optional object implementing `filter` + (e.g. `packaging.specifiers.SpecifierSet`) to filter applicable + versions. + :param hashes: An optional collection of allowed hashes. + """ + if target_python is None: + target_python = TargetPython() + if specifier is None: + specifier = specifiers.SpecifierSet() + + supported_tags = target_python.get_sorted_tags() + + return cls( + project_name=project_name, + supported_tags=supported_tags, + specifier=specifier, + prefer_binary=prefer_binary, + allow_all_prereleases=allow_all_prereleases, + hashes=hashes, + ) + + def __init__( + self, + project_name: str, + supported_tags: List[Tag], + specifier: specifiers.BaseSpecifier, + prefer_binary: bool = False, + allow_all_prereleases: bool = False, + hashes: Optional[Hashes] = None, + ) -> None: + """ + :param supported_tags: The PEP 425 tags supported by the target + Python in order of preference (most preferred first). + """ + self._allow_all_prereleases = allow_all_prereleases + self._hashes = hashes + self._prefer_binary = prefer_binary + self._project_name = project_name + self._specifier = specifier + self._supported_tags = supported_tags + # Since the index of the tag in the _supported_tags list is used + # as a priority, precompute a map from tag to index/priority to be + # used in wheel.find_most_preferred_tag. + self._wheel_tag_preferences = { + tag: idx for idx, tag in enumerate(supported_tags) + } + + def get_applicable_candidates( + self, + candidates: List[InstallationCandidate], + ) -> List[InstallationCandidate]: + """ + Return the applicable candidates from a list of candidates. + """ + # Using None infers from the specifier instead. + allow_prereleases = self._allow_all_prereleases or None + specifier = self._specifier + + # We turn the version object into a str here because otherwise + # when we're debundled but setuptools isn't, Python will see + # packaging.version.Version and + # pkg_resources._vendor.packaging.version.Version as different + # types. This way we'll use a str as a common data interchange + # format. If we stop using the pkg_resources provided specifier + # and start using our own, we can drop the cast to str(). + candidates_and_versions = [(c, str(c.version)) for c in candidates] + versions = set( + specifier.filter( + (v for _, v in candidates_and_versions), + prereleases=allow_prereleases, + ) + ) + + applicable_candidates = [c for c, v in candidates_and_versions if v in versions] + filtered_applicable_candidates = filter_unallowed_hashes( + candidates=applicable_candidates, + hashes=self._hashes, + project_name=self._project_name, + ) + + return sorted(filtered_applicable_candidates, key=self._sort_key) + + def _sort_key(self, candidate: InstallationCandidate) -> CandidateSortingKey: + """ + Function to pass as the `key` argument to a call to sorted() to sort + InstallationCandidates by preference. + + Returns a tuple such that tuples sorting as greater using Python's + default comparison operator are more preferred. + + The preference is as follows: + + First and foremost, candidates with allowed (matching) hashes are + always preferred over candidates without matching hashes. This is + because e.g. if the only candidate with an allowed hash is yanked, + we still want to use that candidate. + + Second, excepting hash considerations, candidates that have been + yanked (in the sense of PEP 592) are always less preferred than + candidates that haven't been yanked. Then: + + If not finding wheels, they are sorted by version only. + If finding wheels, then the sort order is by version, then: + 1. existing installs + 2. wheels ordered via Wheel.support_index_min(self._supported_tags) + 3. source archives + If prefer_binary was set, then all wheels are sorted above sources. + + Note: it was considered to embed this logic into the Link + comparison operators, but then different sdist links + with the same version, would have to be considered equal + """ + valid_tags = self._supported_tags + support_num = len(valid_tags) + build_tag: BuildTag = () + binary_preference = 0 + link = candidate.link + if link.is_wheel: + # can raise InvalidWheelFilename + wheel = Wheel(link.filename) + try: + pri = -( + wheel.find_most_preferred_tag( + valid_tags, self._wheel_tag_preferences + ) + ) + except ValueError: + raise UnsupportedWheel( + f"{wheel.filename} is not a supported wheel for this platform. It " + "can't be sorted." + ) + if self._prefer_binary: + binary_preference = 1 + if wheel.build_tag is not None: + match = re.match(r"^(\d+)(.*)$", wheel.build_tag) + assert match is not None, "guaranteed by filename validation" + build_tag_groups = match.groups() + build_tag = (int(build_tag_groups[0]), build_tag_groups[1]) + else: # sdist + pri = -(support_num) + has_allowed_hash = int(link.is_hash_allowed(self._hashes)) + yank_value = -1 * int(link.is_yanked) # -1 for yanked. + return ( + has_allowed_hash, + yank_value, + binary_preference, + candidate.version, + pri, + build_tag, + ) + + def sort_best_candidate( + self, + candidates: List[InstallationCandidate], + ) -> Optional[InstallationCandidate]: + """ + Return the best candidate per the instance's sort order, or None if + no candidate is acceptable. + """ + if not candidates: + return None + best_candidate = max(candidates, key=self._sort_key) + return best_candidate + + def compute_best_candidate( + self, + candidates: List[InstallationCandidate], + ) -> BestCandidateResult: + """ + Compute and return a `BestCandidateResult` instance. + """ + applicable_candidates = self.get_applicable_candidates(candidates) + + best_candidate = self.sort_best_candidate(applicable_candidates) + + return BestCandidateResult( + candidates, + applicable_candidates=applicable_candidates, + best_candidate=best_candidate, + ) + + +class PackageFinder: + """This finds packages. + + This is meant to match easy_install's technique for looking for + packages, by reading pages and looking for appropriate links. + """ + + def __init__( + self, + link_collector: LinkCollector, + target_python: TargetPython, + allow_yanked: bool, + format_control: Optional[FormatControl] = None, + candidate_prefs: Optional[CandidatePreferences] = None, + ignore_requires_python: Optional[bool] = None, + ) -> None: + """ + This constructor is primarily meant to be used by the create() class + method and from tests. + + :param format_control: A FormatControl object, used to control + the selection of source packages / binary packages when consulting + the index and links. + :param candidate_prefs: Options to use when creating a + CandidateEvaluator object. + """ + if candidate_prefs is None: + candidate_prefs = CandidatePreferences() + + format_control = format_control or FormatControl(set(), set()) + + self._allow_yanked = allow_yanked + self._candidate_prefs = candidate_prefs + self._ignore_requires_python = ignore_requires_python + self._link_collector = link_collector + self._target_python = target_python + + self.format_control = format_control + + # These are boring links that have already been logged somehow. + self._logged_links: Set[Tuple[Link, LinkType, str]] = set() + + # Don't include an allow_yanked default value to make sure each call + # site considers whether yanked releases are allowed. This also causes + # that decision to be made explicit in the calling code, which helps + # people when reading the code. + @classmethod + def create( + cls, + link_collector: LinkCollector, + selection_prefs: SelectionPreferences, + target_python: Optional[TargetPython] = None, + ) -> "PackageFinder": + """Create a PackageFinder. + + :param selection_prefs: The candidate selection preferences, as a + SelectionPreferences object. + :param target_python: The target Python interpreter to use when + checking compatibility. If None (the default), a TargetPython + object will be constructed from the running Python. + """ + if target_python is None: + target_python = TargetPython() + + candidate_prefs = CandidatePreferences( + prefer_binary=selection_prefs.prefer_binary, + allow_all_prereleases=selection_prefs.allow_all_prereleases, + ) + + return cls( + candidate_prefs=candidate_prefs, + link_collector=link_collector, + target_python=target_python, + allow_yanked=selection_prefs.allow_yanked, + format_control=selection_prefs.format_control, + ignore_requires_python=selection_prefs.ignore_requires_python, + ) + + @property + def target_python(self) -> TargetPython: + return self._target_python + + @property + def search_scope(self) -> SearchScope: + return self._link_collector.search_scope + + @search_scope.setter + def search_scope(self, search_scope: SearchScope) -> None: + self._link_collector.search_scope = search_scope + + @property + def find_links(self) -> List[str]: + return self._link_collector.find_links + + @property + def index_urls(self) -> List[str]: + return self.search_scope.index_urls + + @property + def trusted_hosts(self) -> Iterable[str]: + for host_port in self._link_collector.session.pip_trusted_origins: + yield build_netloc(*host_port) + + @property + def allow_all_prereleases(self) -> bool: + return self._candidate_prefs.allow_all_prereleases + + def set_allow_all_prereleases(self) -> None: + self._candidate_prefs.allow_all_prereleases = True + + @property + def prefer_binary(self) -> bool: + return self._candidate_prefs.prefer_binary + + def set_prefer_binary(self) -> None: + self._candidate_prefs.prefer_binary = True + + def requires_python_skipped_reasons(self) -> List[str]: + reasons = { + detail + for _, result, detail in self._logged_links + if result == LinkType.requires_python_mismatch + } + return sorted(reasons) + + def make_link_evaluator(self, project_name: str) -> LinkEvaluator: + canonical_name = canonicalize_name(project_name) + formats = self.format_control.get_allowed_formats(canonical_name) + + return LinkEvaluator( + project_name=project_name, + canonical_name=canonical_name, + formats=formats, + target_python=self._target_python, + allow_yanked=self._allow_yanked, + ignore_requires_python=self._ignore_requires_python, + ) + + def _sort_links(self, links: Iterable[Link]) -> List[Link]: + """ + Returns elements of links in order, non-egg links first, egg links + second, while eliminating duplicates + """ + eggs, no_eggs = [], [] + seen: Set[Link] = set() + for link in links: + if link not in seen: + seen.add(link) + if link.egg_fragment: + eggs.append(link) + else: + no_eggs.append(link) + return no_eggs + eggs + + def _log_skipped_link(self, link: Link, result: LinkType, detail: str) -> None: + entry = (link, result, detail) + if entry not in self._logged_links: + # Put the link at the end so the reason is more visible and because + # the link string is usually very long. + logger.debug("Skipping link: %s: %s", detail, link) + self._logged_links.add(entry) + + def get_install_candidate( + self, link_evaluator: LinkEvaluator, link: Link + ) -> Optional[InstallationCandidate]: + """ + If the link is a candidate for install, convert it to an + InstallationCandidate and return it. Otherwise, return None. + """ + result, detail = link_evaluator.evaluate_link(link) + if result != LinkType.candidate: + self._log_skipped_link(link, result, detail) + return None + + try: + return InstallationCandidate( + name=link_evaluator.project_name, + link=link, + version=detail, + ) + except InvalidVersion: + return None + + def evaluate_links( + self, link_evaluator: LinkEvaluator, links: Iterable[Link] + ) -> List[InstallationCandidate]: + """ + Convert links that are candidates to InstallationCandidate objects. + """ + candidates = [] + for link in self._sort_links(links): + candidate = self.get_install_candidate(link_evaluator, link) + if candidate is not None: + candidates.append(candidate) + + return candidates + + def process_project_url( + self, project_url: Link, link_evaluator: LinkEvaluator + ) -> List[InstallationCandidate]: + logger.debug( + "Fetching project page and analyzing links: %s", + project_url, + ) + index_response = self._link_collector.fetch_response(project_url) + if index_response is None: + return [] + + page_links = list(parse_links(index_response)) + + with indent_log(): + package_links = self.evaluate_links( + link_evaluator, + links=page_links, + ) + + return package_links + + @functools.lru_cache(maxsize=None) + def find_all_candidates(self, project_name: str) -> List[InstallationCandidate]: + """Find all available InstallationCandidate for project_name + + This checks index_urls and find_links. + All versions found are returned as an InstallationCandidate list. + + See LinkEvaluator.evaluate_link() for details on which files + are accepted. + """ + link_evaluator = self.make_link_evaluator(project_name) + + collected_sources = self._link_collector.collect_sources( + project_name=project_name, + candidates_from_page=functools.partial( + self.process_project_url, + link_evaluator=link_evaluator, + ), + ) + + page_candidates_it = itertools.chain.from_iterable( + source.page_candidates() + for sources in collected_sources + for source in sources + if source is not None + ) + page_candidates = list(page_candidates_it) + + file_links_it = itertools.chain.from_iterable( + source.file_links() + for sources in collected_sources + for source in sources + if source is not None + ) + file_candidates = self.evaluate_links( + link_evaluator, + sorted(file_links_it, reverse=True), + ) + + if logger.isEnabledFor(logging.DEBUG) and file_candidates: + paths = [] + for candidate in file_candidates: + assert candidate.link.url # we need to have a URL + try: + paths.append(candidate.link.file_path) + except Exception: + paths.append(candidate.link.url) # it's not a local file + + logger.debug("Local files found: %s", ", ".join(paths)) + + # This is an intentional priority ordering + return file_candidates + page_candidates + + def make_candidate_evaluator( + self, + project_name: str, + specifier: Optional[specifiers.BaseSpecifier] = None, + hashes: Optional[Hashes] = None, + ) -> CandidateEvaluator: + """Create a CandidateEvaluator object to use.""" + candidate_prefs = self._candidate_prefs + return CandidateEvaluator.create( + project_name=project_name, + target_python=self._target_python, + prefer_binary=candidate_prefs.prefer_binary, + allow_all_prereleases=candidate_prefs.allow_all_prereleases, + specifier=specifier, + hashes=hashes, + ) + + @functools.lru_cache(maxsize=None) + def find_best_candidate( + self, + project_name: str, + specifier: Optional[specifiers.BaseSpecifier] = None, + hashes: Optional[Hashes] = None, + ) -> BestCandidateResult: + """Find matches for the given project and specifier. + + :param specifier: An optional object implementing `filter` + (e.g. `packaging.specifiers.SpecifierSet`) to filter applicable + versions. + + :return: A `BestCandidateResult` instance. + """ + candidates = self.find_all_candidates(project_name) + candidate_evaluator = self.make_candidate_evaluator( + project_name=project_name, + specifier=specifier, + hashes=hashes, + ) + return candidate_evaluator.compute_best_candidate(candidates) + + def find_requirement( + self, req: InstallRequirement, upgrade: bool + ) -> Optional[InstallationCandidate]: + """Try to find a Link matching req + + Expects req, an InstallRequirement and upgrade, a boolean + Returns a InstallationCandidate if found, + Raises DistributionNotFound or BestVersionAlreadyInstalled otherwise + """ + hashes = req.hashes(trust_internet=False) + best_candidate_result = self.find_best_candidate( + req.name, + specifier=req.specifier, + hashes=hashes, + ) + best_candidate = best_candidate_result.best_candidate + + installed_version: Optional[_BaseVersion] = None + if req.satisfied_by is not None: + installed_version = req.satisfied_by.version + + def _format_versions(cand_iter: Iterable[InstallationCandidate]) -> str: + # This repeated parse_version and str() conversion is needed to + # handle different vendoring sources from pip and pkg_resources. + # If we stop using the pkg_resources provided specifier and start + # using our own, we can drop the cast to str(). + return ( + ", ".join( + sorted( + {str(c.version) for c in cand_iter}, + key=parse_version, + ) + ) + or "none" + ) + + if installed_version is None and best_candidate is None: + logger.critical( + "Could not find a version that satisfies the requirement %s " + "(from versions: %s)", + req, + _format_versions(best_candidate_result.iter_all()), + ) + + raise DistributionNotFound(f"No matching distribution found for {req}") + + def _should_install_candidate( + candidate: Optional[InstallationCandidate], + ) -> "TypeGuard[InstallationCandidate]": + if installed_version is None: + return True + if best_candidate is None: + return False + return best_candidate.version > installed_version + + if not upgrade and installed_version is not None: + if _should_install_candidate(best_candidate): + logger.debug( + "Existing installed version (%s) satisfies requirement " + "(most up-to-date version is %s)", + installed_version, + best_candidate.version, + ) + else: + logger.debug( + "Existing installed version (%s) is most up-to-date and " + "satisfies requirement", + installed_version, + ) + return None + + if _should_install_candidate(best_candidate): + logger.debug( + "Using version %s (newest of versions: %s)", + best_candidate.version, + _format_versions(best_candidate_result.iter_applicable()), + ) + return best_candidate + + # We have an existing version, and its the best version + logger.debug( + "Installed version (%s) is most up-to-date (past versions: %s)", + installed_version, + _format_versions(best_candidate_result.iter_applicable()), + ) + raise BestVersionAlreadyInstalled + + +def _find_name_version_sep(fragment: str, canonical_name: str) -> int: + """Find the separator's index based on the package's canonical name. + + :param fragment: A + filename "fragment" (stem) or + egg fragment. + :param canonical_name: The package's canonical name. + + This function is needed since the canonicalized name does not necessarily + have the same length as the egg info's name part. An example:: + + >>> fragment = 'foo__bar-1.0' + >>> canonical_name = 'foo-bar' + >>> _find_name_version_sep(fragment, canonical_name) + 8 + """ + # Project name and version must be separated by one single dash. Find all + # occurrences of dashes; if the string in front of it matches the canonical + # name, this is the one separating the name and version parts. + for i, c in enumerate(fragment): + if c != "-": + continue + if canonicalize_name(fragment[:i]) == canonical_name: + return i + raise ValueError(f"{fragment} does not match {canonical_name}") + + +def _extract_version_from_fragment(fragment: str, canonical_name: str) -> Optional[str]: + """Parse the version string from a + filename + "fragment" (stem) or egg fragment. + + :param fragment: The string to parse. E.g. foo-2.1 + :param canonical_name: The canonicalized name of the package this + belongs to. + """ + try: + version_start = _find_name_version_sep(fragment, canonical_name) + 1 + except ValueError: + return None + version = fragment[version_start:] + if not version: + return None + return version diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/index/sources.py b/.venv/lib/python3.12/site-packages/pip/_internal/index/sources.py new file mode 100644 index 0000000..f4626d7 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/index/sources.py @@ -0,0 +1,285 @@ +import logging +import mimetypes +import os +from collections import defaultdict +from typing import Callable, Dict, Iterable, List, Optional, Tuple + +from pip._vendor.packaging.utils import ( + InvalidSdistFilename, + InvalidVersion, + InvalidWheelFilename, + canonicalize_name, + parse_sdist_filename, + parse_wheel_filename, +) + +from pip._internal.models.candidate import InstallationCandidate +from pip._internal.models.link import Link +from pip._internal.utils.urls import path_to_url, url_to_path +from pip._internal.vcs import is_url + +logger = logging.getLogger(__name__) + +FoundCandidates = Iterable[InstallationCandidate] +FoundLinks = Iterable[Link] +CandidatesFromPage = Callable[[Link], Iterable[InstallationCandidate]] +PageValidator = Callable[[Link], bool] + + +class LinkSource: + @property + def link(self) -> Optional[Link]: + """Returns the underlying link, if there's one.""" + raise NotImplementedError() + + def page_candidates(self) -> FoundCandidates: + """Candidates found by parsing an archive listing HTML file.""" + raise NotImplementedError() + + def file_links(self) -> FoundLinks: + """Links found by specifying archives directly.""" + raise NotImplementedError() + + +def _is_html_file(file_url: str) -> bool: + return mimetypes.guess_type(file_url, strict=False)[0] == "text/html" + + +class _FlatDirectoryToUrls: + """Scans directory and caches results""" + + def __init__(self, path: str) -> None: + self._path = path + self._page_candidates: List[str] = [] + self._project_name_to_urls: Dict[str, List[str]] = defaultdict(list) + self._scanned_directory = False + + def _scan_directory(self) -> None: + """Scans directory once and populates both page_candidates + and project_name_to_urls at the same time + """ + for entry in os.scandir(self._path): + url = path_to_url(entry.path) + if _is_html_file(url): + self._page_candidates.append(url) + continue + + # File must have a valid wheel or sdist name, + # otherwise not worth considering as a package + try: + project_filename = parse_wheel_filename(entry.name)[0] + except (InvalidWheelFilename, InvalidVersion): + try: + project_filename = parse_sdist_filename(entry.name)[0] + except (InvalidSdistFilename, InvalidVersion): + continue + + self._project_name_to_urls[project_filename].append(url) + self._scanned_directory = True + + @property + def page_candidates(self) -> List[str]: + if not self._scanned_directory: + self._scan_directory() + + return self._page_candidates + + @property + def project_name_to_urls(self) -> Dict[str, List[str]]: + if not self._scanned_directory: + self._scan_directory() + + return self._project_name_to_urls + + +class _FlatDirectorySource(LinkSource): + """Link source specified by ``--find-links=``. + + This looks the content of the directory, and returns: + + * ``page_candidates``: Links listed on each HTML file in the directory. + * ``file_candidates``: Archives in the directory. + """ + + _paths_to_urls: Dict[str, _FlatDirectoryToUrls] = {} + + def __init__( + self, + candidates_from_page: CandidatesFromPage, + path: str, + project_name: str, + ) -> None: + self._candidates_from_page = candidates_from_page + self._project_name = canonicalize_name(project_name) + + # Get existing instance of _FlatDirectoryToUrls if it exists + if path in self._paths_to_urls: + self._path_to_urls = self._paths_to_urls[path] + else: + self._path_to_urls = _FlatDirectoryToUrls(path=path) + self._paths_to_urls[path] = self._path_to_urls + + @property + def link(self) -> Optional[Link]: + return None + + def page_candidates(self) -> FoundCandidates: + for url in self._path_to_urls.page_candidates: + yield from self._candidates_from_page(Link(url)) + + def file_links(self) -> FoundLinks: + for url in self._path_to_urls.project_name_to_urls[self._project_name]: + yield Link(url) + + +class _LocalFileSource(LinkSource): + """``--find-links=`` or ``--[extra-]index-url=``. + + If a URL is supplied, it must be a ``file:`` URL. If a path is supplied to + the option, it is converted to a URL first. This returns: + + * ``page_candidates``: Links listed on an HTML file. + * ``file_candidates``: The non-HTML file. + """ + + def __init__( + self, + candidates_from_page: CandidatesFromPage, + link: Link, + ) -> None: + self._candidates_from_page = candidates_from_page + self._link = link + + @property + def link(self) -> Optional[Link]: + return self._link + + def page_candidates(self) -> FoundCandidates: + if not _is_html_file(self._link.url): + return + yield from self._candidates_from_page(self._link) + + def file_links(self) -> FoundLinks: + if _is_html_file(self._link.url): + return + yield self._link + + +class _RemoteFileSource(LinkSource): + """``--find-links=`` or ``--[extra-]index-url=``. + + This returns: + + * ``page_candidates``: Links listed on an HTML file. + * ``file_candidates``: The non-HTML file. + """ + + def __init__( + self, + candidates_from_page: CandidatesFromPage, + page_validator: PageValidator, + link: Link, + ) -> None: + self._candidates_from_page = candidates_from_page + self._page_validator = page_validator + self._link = link + + @property + def link(self) -> Optional[Link]: + return self._link + + def page_candidates(self) -> FoundCandidates: + if not self._page_validator(self._link): + return + yield from self._candidates_from_page(self._link) + + def file_links(self) -> FoundLinks: + yield self._link + + +class _IndexDirectorySource(LinkSource): + """``--[extra-]index-url=``. + + This is treated like a remote URL; ``candidates_from_page`` contains logic + for this by appending ``index.html`` to the link. + """ + + def __init__( + self, + candidates_from_page: CandidatesFromPage, + link: Link, + ) -> None: + self._candidates_from_page = candidates_from_page + self._link = link + + @property + def link(self) -> Optional[Link]: + return self._link + + def page_candidates(self) -> FoundCandidates: + yield from self._candidates_from_page(self._link) + + def file_links(self) -> FoundLinks: + return () + + +def build_source( + location: str, + *, + candidates_from_page: CandidatesFromPage, + page_validator: PageValidator, + expand_dir: bool, + cache_link_parsing: bool, + project_name: str, +) -> Tuple[Optional[str], Optional[LinkSource]]: + path: Optional[str] = None + url: Optional[str] = None + if os.path.exists(location): # Is a local path. + url = path_to_url(location) + path = location + elif location.startswith("file:"): # A file: URL. + url = location + path = url_to_path(location) + elif is_url(location): + url = location + + if url is None: + msg = ( + "Location '%s' is ignored: " + "it is either a non-existing path or lacks a specific scheme." + ) + logger.warning(msg, location) + return (None, None) + + if path is None: + source: LinkSource = _RemoteFileSource( + candidates_from_page=candidates_from_page, + page_validator=page_validator, + link=Link(url, cache_link_parsing=cache_link_parsing), + ) + return (url, source) + + if os.path.isdir(path): + if expand_dir: + source = _FlatDirectorySource( + candidates_from_page=candidates_from_page, + path=path, + project_name=project_name, + ) + else: + source = _IndexDirectorySource( + candidates_from_page=candidates_from_page, + link=Link(url, cache_link_parsing=cache_link_parsing), + ) + return (url, source) + elif os.path.isfile(path): + source = _LocalFileSource( + candidates_from_page=candidates_from_page, + link=Link(url, cache_link_parsing=cache_link_parsing), + ) + return (url, source) + logger.warning( + "Location '%s' is ignored: it is neither a file nor a directory.", + location, + ) + return (url, None) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/locations/__init__.py b/.venv/lib/python3.12/site-packages/pip/_internal/locations/__init__.py new file mode 100644 index 0000000..32382be --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/locations/__init__.py @@ -0,0 +1,456 @@ +import functools +import logging +import os +import pathlib +import sys +import sysconfig +from typing import Any, Dict, Generator, Optional, Tuple + +from pip._internal.models.scheme import SCHEME_KEYS, Scheme +from pip._internal.utils.compat import WINDOWS +from pip._internal.utils.deprecation import deprecated +from pip._internal.utils.virtualenv import running_under_virtualenv + +from . import _sysconfig +from .base import ( + USER_CACHE_DIR, + get_major_minor_version, + get_src_prefix, + is_osx_framework, + site_packages, + user_site, +) + +__all__ = [ + "USER_CACHE_DIR", + "get_bin_prefix", + "get_bin_user", + "get_major_minor_version", + "get_platlib", + "get_purelib", + "get_scheme", + "get_src_prefix", + "site_packages", + "user_site", +] + + +logger = logging.getLogger(__name__) + + +_PLATLIBDIR: str = getattr(sys, "platlibdir", "lib") + +_USE_SYSCONFIG_DEFAULT = sys.version_info >= (3, 10) + + +def _should_use_sysconfig() -> bool: + """This function determines the value of _USE_SYSCONFIG. + + By default, pip uses sysconfig on Python 3.10+. + But Python distributors can override this decision by setting: + sysconfig._PIP_USE_SYSCONFIG = True / False + Rationale in https://github.com/pypa/pip/issues/10647 + + This is a function for testability, but should be constant during any one + run. + """ + return bool(getattr(sysconfig, "_PIP_USE_SYSCONFIG", _USE_SYSCONFIG_DEFAULT)) + + +_USE_SYSCONFIG = _should_use_sysconfig() + +if not _USE_SYSCONFIG: + # Import distutils lazily to avoid deprecation warnings, + # but import it soon enough that it is in memory and available during + # a pip reinstall. + from . import _distutils + +# Be noisy about incompatibilities if this platforms "should" be using +# sysconfig, but is explicitly opting out and using distutils instead. +if _USE_SYSCONFIG_DEFAULT and not _USE_SYSCONFIG: + _MISMATCH_LEVEL = logging.WARNING +else: + _MISMATCH_LEVEL = logging.DEBUG + + +def _looks_like_bpo_44860() -> bool: + """The resolution to bpo-44860 will change this incorrect platlib. + + See . + """ + from distutils.command.install import INSTALL_SCHEMES + + try: + unix_user_platlib = INSTALL_SCHEMES["unix_user"]["platlib"] + except KeyError: + return False + return unix_user_platlib == "$usersite" + + +def _looks_like_red_hat_patched_platlib_purelib(scheme: Dict[str, str]) -> bool: + platlib = scheme["platlib"] + if "/$platlibdir/" in platlib: + platlib = platlib.replace("/$platlibdir/", f"/{_PLATLIBDIR}/") + if "/lib64/" not in platlib: + return False + unpatched = platlib.replace("/lib64/", "/lib/") + return unpatched.replace("$platbase/", "$base/") == scheme["purelib"] + + +@functools.lru_cache(maxsize=None) +def _looks_like_red_hat_lib() -> bool: + """Red Hat patches platlib in unix_prefix and unix_home, but not purelib. + + This is the only way I can see to tell a Red Hat-patched Python. + """ + from distutils.command.install import INSTALL_SCHEMES + + return all( + k in INSTALL_SCHEMES + and _looks_like_red_hat_patched_platlib_purelib(INSTALL_SCHEMES[k]) + for k in ("unix_prefix", "unix_home") + ) + + +@functools.lru_cache(maxsize=None) +def _looks_like_debian_scheme() -> bool: + """Debian adds two additional schemes.""" + from distutils.command.install import INSTALL_SCHEMES + + return "deb_system" in INSTALL_SCHEMES and "unix_local" in INSTALL_SCHEMES + + +@functools.lru_cache(maxsize=None) +def _looks_like_red_hat_scheme() -> bool: + """Red Hat patches ``sys.prefix`` and ``sys.exec_prefix``. + + Red Hat's ``00251-change-user-install-location.patch`` changes the install + command's ``prefix`` and ``exec_prefix`` to append ``"/local"``. This is + (fortunately?) done quite unconditionally, so we create a default command + object without any configuration to detect this. + """ + from distutils.command.install import install + from distutils.dist import Distribution + + cmd: Any = install(Distribution()) + cmd.finalize_options() + return ( + cmd.exec_prefix == f"{os.path.normpath(sys.exec_prefix)}/local" + and cmd.prefix == f"{os.path.normpath(sys.prefix)}/local" + ) + + +@functools.lru_cache(maxsize=None) +def _looks_like_slackware_scheme() -> bool: + """Slackware patches sysconfig but fails to patch distutils and site. + + Slackware changes sysconfig's user scheme to use ``"lib64"`` for the lib + path, but does not do the same to the site module. + """ + if user_site is None: # User-site not available. + return False + try: + paths = sysconfig.get_paths(scheme="posix_user", expand=False) + except KeyError: # User-site not available. + return False + return "/lib64/" in paths["purelib"] and "/lib64/" not in user_site + + +@functools.lru_cache(maxsize=None) +def _looks_like_msys2_mingw_scheme() -> bool: + """MSYS2 patches distutils and sysconfig to use a UNIX-like scheme. + + However, MSYS2 incorrectly patches sysconfig ``nt`` scheme. The fix is + likely going to be included in their 3.10 release, so we ignore the warning. + See msys2/MINGW-packages#9319. + + MSYS2 MINGW's patch uses lowercase ``"lib"`` instead of the usual uppercase, + and is missing the final ``"site-packages"``. + """ + paths = sysconfig.get_paths("nt", expand=False) + return all( + "Lib" not in p and "lib" in p and not p.endswith("site-packages") + for p in (paths[key] for key in ("platlib", "purelib")) + ) + + +def _fix_abiflags(parts: Tuple[str]) -> Generator[str, None, None]: + ldversion = sysconfig.get_config_var("LDVERSION") + abiflags = getattr(sys, "abiflags", None) + + # LDVERSION does not end with sys.abiflags. Just return the path unchanged. + if not ldversion or not abiflags or not ldversion.endswith(abiflags): + yield from parts + return + + # Strip sys.abiflags from LDVERSION-based path components. + for part in parts: + if part.endswith(ldversion): + part = part[: (0 - len(abiflags))] + yield part + + +@functools.lru_cache(maxsize=None) +def _warn_mismatched(old: pathlib.Path, new: pathlib.Path, *, key: str) -> None: + issue_url = "https://github.com/pypa/pip/issues/10151" + message = ( + "Value for %s does not match. Please report this to <%s>" + "\ndistutils: %s" + "\nsysconfig: %s" + ) + logger.log(_MISMATCH_LEVEL, message, key, issue_url, old, new) + + +def _warn_if_mismatch(old: pathlib.Path, new: pathlib.Path, *, key: str) -> bool: + if old == new: + return False + _warn_mismatched(old, new, key=key) + return True + + +@functools.lru_cache(maxsize=None) +def _log_context( + *, + user: bool = False, + home: Optional[str] = None, + root: Optional[str] = None, + prefix: Optional[str] = None, +) -> None: + parts = [ + "Additional context:", + "user = %r", + "home = %r", + "root = %r", + "prefix = %r", + ] + + logger.log(_MISMATCH_LEVEL, "\n".join(parts), user, home, root, prefix) + + +def get_scheme( + dist_name: str, + user: bool = False, + home: Optional[str] = None, + root: Optional[str] = None, + isolated: bool = False, + prefix: Optional[str] = None, +) -> Scheme: + new = _sysconfig.get_scheme( + dist_name, + user=user, + home=home, + root=root, + isolated=isolated, + prefix=prefix, + ) + if _USE_SYSCONFIG: + return new + + old = _distutils.get_scheme( + dist_name, + user=user, + home=home, + root=root, + isolated=isolated, + prefix=prefix, + ) + + warning_contexts = [] + for k in SCHEME_KEYS: + old_v = pathlib.Path(getattr(old, k)) + new_v = pathlib.Path(getattr(new, k)) + + if old_v == new_v: + continue + + # distutils incorrectly put PyPy packages under ``site-packages/python`` + # in the ``posix_home`` scheme, but PyPy devs said they expect the + # directory name to be ``pypy`` instead. So we treat this as a bug fix + # and not warn about it. See bpo-43307 and python/cpython#24628. + skip_pypy_special_case = ( + sys.implementation.name == "pypy" + and home is not None + and k in ("platlib", "purelib") + and old_v.parent == new_v.parent + and old_v.name.startswith("python") + and new_v.name.startswith("pypy") + ) + if skip_pypy_special_case: + continue + + # sysconfig's ``osx_framework_user`` does not include ``pythonX.Y`` in + # the ``include`` value, but distutils's ``headers`` does. We'll let + # CPython decide whether this is a bug or feature. See bpo-43948. + skip_osx_framework_user_special_case = ( + user + and is_osx_framework() + and k == "headers" + and old_v.parent.parent == new_v.parent + and old_v.parent.name.startswith("python") + ) + if skip_osx_framework_user_special_case: + continue + + # On Red Hat and derived Linux distributions, distutils is patched to + # use "lib64" instead of "lib" for platlib. + if k == "platlib" and _looks_like_red_hat_lib(): + continue + + # On Python 3.9+, sysconfig's posix_user scheme sets platlib against + # sys.platlibdir, but distutils's unix_user incorrectly coninutes + # using the same $usersite for both platlib and purelib. This creates a + # mismatch when sys.platlibdir is not "lib". + skip_bpo_44860 = ( + user + and k == "platlib" + and not WINDOWS + and sys.version_info >= (3, 9) + and _PLATLIBDIR != "lib" + and _looks_like_bpo_44860() + ) + if skip_bpo_44860: + continue + + # Slackware incorrectly patches posix_user to use lib64 instead of lib, + # but not usersite to match the location. + skip_slackware_user_scheme = ( + user + and k in ("platlib", "purelib") + and not WINDOWS + and _looks_like_slackware_scheme() + ) + if skip_slackware_user_scheme: + continue + + # Both Debian and Red Hat patch Python to place the system site under + # /usr/local instead of /usr. Debian also places lib in dist-packages + # instead of site-packages, but the /usr/local check should cover it. + skip_linux_system_special_case = ( + not (user or home or prefix or running_under_virtualenv()) + and old_v.parts[1:3] == ("usr", "local") + and len(new_v.parts) > 1 + and new_v.parts[1] == "usr" + and (len(new_v.parts) < 3 or new_v.parts[2] != "local") + and (_looks_like_red_hat_scheme() or _looks_like_debian_scheme()) + ) + if skip_linux_system_special_case: + continue + + # MSYS2 MINGW's sysconfig patch does not include the "site-packages" + # part of the path. This is incorrect and will be fixed in MSYS. + skip_msys2_mingw_bug = ( + WINDOWS and k in ("platlib", "purelib") and _looks_like_msys2_mingw_scheme() + ) + if skip_msys2_mingw_bug: + continue + + # CPython's POSIX install script invokes pip (via ensurepip) against the + # interpreter located in the source tree, not the install site. This + # triggers special logic in sysconfig that's not present in distutils. + # https://github.com/python/cpython/blob/8c21941ddaf/Lib/sysconfig.py#L178-L194 + skip_cpython_build = ( + sysconfig.is_python_build(check_home=True) + and not WINDOWS + and k in ("headers", "include", "platinclude") + ) + if skip_cpython_build: + continue + + warning_contexts.append((old_v, new_v, f"scheme.{k}")) + + if not warning_contexts: + return old + + # Check if this path mismatch is caused by distutils config files. Those + # files will no longer work once we switch to sysconfig, so this raises a + # deprecation message for them. + default_old = _distutils.distutils_scheme( + dist_name, + user, + home, + root, + isolated, + prefix, + ignore_config_files=True, + ) + if any(default_old[k] != getattr(old, k) for k in SCHEME_KEYS): + deprecated( + reason=( + "Configuring installation scheme with distutils config files " + "is deprecated and will no longer work in the near future. If you " + "are using a Homebrew or Linuxbrew Python, please see discussion " + "at https://github.com/Homebrew/homebrew-core/issues/76621" + ), + replacement=None, + gone_in=None, + ) + return old + + # Post warnings about this mismatch so user can report them back. + for old_v, new_v, key in warning_contexts: + _warn_mismatched(old_v, new_v, key=key) + _log_context(user=user, home=home, root=root, prefix=prefix) + + return old + + +def get_bin_prefix() -> str: + new = _sysconfig.get_bin_prefix() + if _USE_SYSCONFIG: + return new + + old = _distutils.get_bin_prefix() + if _warn_if_mismatch(pathlib.Path(old), pathlib.Path(new), key="bin_prefix"): + _log_context() + return old + + +def get_bin_user() -> str: + return _sysconfig.get_scheme("", user=True).scripts + + +def _looks_like_deb_system_dist_packages(value: str) -> bool: + """Check if the value is Debian's APT-controlled dist-packages. + + Debian's ``distutils.sysconfig.get_python_lib()`` implementation returns the + default package path controlled by APT, but does not patch ``sysconfig`` to + do the same. This is similar to the bug worked around in ``get_scheme()``, + but here the default is ``deb_system`` instead of ``unix_local``. Ultimately + we can't do anything about this Debian bug, and this detection allows us to + skip the warning when needed. + """ + if not _looks_like_debian_scheme(): + return False + if value == "/usr/lib/python3/dist-packages": + return True + return False + + +def get_purelib() -> str: + """Return the default pure-Python lib location.""" + new = _sysconfig.get_purelib() + if _USE_SYSCONFIG: + return new + + old = _distutils.get_purelib() + if _looks_like_deb_system_dist_packages(old): + return old + if _warn_if_mismatch(pathlib.Path(old), pathlib.Path(new), key="purelib"): + _log_context() + return old + + +def get_platlib() -> str: + """Return the default platform-shared lib location.""" + new = _sysconfig.get_platlib() + if _USE_SYSCONFIG: + return new + + from . import _distutils + + old = _distutils.get_platlib() + if _looks_like_deb_system_dist_packages(old): + return old + if _warn_if_mismatch(pathlib.Path(old), pathlib.Path(new), key="platlib"): + _log_context() + return old diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/locations/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/locations/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..885790f9426fa79218c963be2afb8ec9932f7060 GIT binary patch literal 16449 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/locations/__pycache__/_distutils.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/locations/__pycache__/_distutils.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..94cf9487972595cfa91d14ccd76827fca8b51ba9 GIT binary patch literal 6854 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/locations/__pycache__/_sysconfig.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/locations/__pycache__/_sysconfig.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..1e4dcca991e7222d5458fa1465d7596011c5c0f1 GIT binary patch literal 8031 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 XI(_{95^p;nM~~wT{fK|u$3g!;e>P`o literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/locations/_distutils.py b/.venv/lib/python3.12/site-packages/pip/_internal/locations/_distutils.py new file mode 100644 index 0000000..0e18c6e --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/locations/_distutils.py @@ -0,0 +1,172 @@ +"""Locations where we look for configs, install stuff, etc""" + +# The following comment should be removed at some point in the future. +# mypy: strict-optional=False + +# If pip's going to use distutils, it should not be using the copy that setuptools +# might have injected into the environment. This is done by removing the injected +# shim, if it's injected. +# +# See https://github.com/pypa/pip/issues/8761 for the original discussion and +# rationale for why this is done within pip. +try: + __import__("_distutils_hack").remove_shim() +except (ImportError, AttributeError): + pass + +import logging +import os +import sys +from distutils.cmd import Command as DistutilsCommand +from distutils.command.install import SCHEME_KEYS +from distutils.command.install import install as distutils_install_command +from distutils.sysconfig import get_python_lib +from typing import Dict, List, Optional, Union, cast + +from pip._internal.models.scheme import Scheme +from pip._internal.utils.compat import WINDOWS +from pip._internal.utils.virtualenv import running_under_virtualenv + +from .base import get_major_minor_version + +logger = logging.getLogger(__name__) + + +def distutils_scheme( + dist_name: str, + user: bool = False, + home: Optional[str] = None, + root: Optional[str] = None, + isolated: bool = False, + prefix: Optional[str] = None, + *, + ignore_config_files: bool = False, +) -> Dict[str, str]: + """ + Return a distutils install scheme + """ + from distutils.dist import Distribution + + dist_args: Dict[str, Union[str, List[str]]] = {"name": dist_name} + if isolated: + dist_args["script_args"] = ["--no-user-cfg"] + + d = Distribution(dist_args) + if not ignore_config_files: + try: + d.parse_config_files() + except UnicodeDecodeError: + paths = d.find_config_files() + logger.warning( + "Ignore distutils configs in %s due to encoding errors.", + ", ".join(os.path.basename(p) for p in paths), + ) + obj: Optional[DistutilsCommand] = None + obj = d.get_command_obj("install", create=True) + assert obj is not None + i = cast(distutils_install_command, obj) + # NOTE: setting user or home has the side-effect of creating the home dir + # or user base for installations during finalize_options() + # ideally, we'd prefer a scheme class that has no side-effects. + assert not (user and prefix), f"user={user} prefix={prefix}" + assert not (home and prefix), f"home={home} prefix={prefix}" + i.user = user or i.user + if user or home: + i.prefix = "" + i.prefix = prefix or i.prefix + i.home = home or i.home + i.root = root or i.root + i.finalize_options() + + scheme = {} + for key in SCHEME_KEYS: + scheme[key] = getattr(i, "install_" + key) + + # install_lib specified in setup.cfg should install *everything* + # into there (i.e. it takes precedence over both purelib and + # platlib). Note, i.install_lib is *always* set after + # finalize_options(); we only want to override here if the user + # has explicitly requested it hence going back to the config + if "install_lib" in d.get_option_dict("install"): + scheme.update({"purelib": i.install_lib, "platlib": i.install_lib}) + + if running_under_virtualenv(): + if home: + prefix = home + elif user: + prefix = i.install_userbase + else: + prefix = i.prefix + scheme["headers"] = os.path.join( + prefix, + "include", + "site", + f"python{get_major_minor_version()}", + dist_name, + ) + + if root is not None: + path_no_drive = os.path.splitdrive(os.path.abspath(scheme["headers"]))[1] + scheme["headers"] = os.path.join(root, path_no_drive[1:]) + + return scheme + + +def get_scheme( + dist_name: str, + user: bool = False, + home: Optional[str] = None, + root: Optional[str] = None, + isolated: bool = False, + prefix: Optional[str] = None, +) -> Scheme: + """ + Get the "scheme" corresponding to the input parameters. The distutils + documentation provides the context for the available schemes: + https://docs.python.org/3/install/index.html#alternate-installation + + :param dist_name: the name of the package to retrieve the scheme for, used + in the headers scheme path + :param user: indicates to use the "user" scheme + :param home: indicates to use the "home" scheme and provides the base + directory for the same + :param root: root under which other directories are re-based + :param isolated: equivalent to --no-user-cfg, i.e. do not consider + ~/.pydistutils.cfg (posix) or ~/pydistutils.cfg (non-posix) for + scheme paths + :param prefix: indicates to use the "prefix" scheme and provides the + base directory for the same + """ + scheme = distutils_scheme(dist_name, user, home, root, isolated, prefix) + return Scheme( + platlib=scheme["platlib"], + purelib=scheme["purelib"], + headers=scheme["headers"], + scripts=scheme["scripts"], + data=scheme["data"], + ) + + +def get_bin_prefix() -> str: + # XXX: In old virtualenv versions, sys.prefix can contain '..' components, + # so we need to call normpath to eliminate them. + prefix = os.path.normpath(sys.prefix) + if WINDOWS: + bin_py = os.path.join(prefix, "Scripts") + # buildout uses 'bin' on Windows too? + if not os.path.exists(bin_py): + bin_py = os.path.join(prefix, "bin") + return bin_py + # Forcing to use /usr/local/bin for standard macOS framework installs + # Also log to ~/Library/Logs/ for use with the Console.app log viewer + if sys.platform[:6] == "darwin" and prefix[:16] == "/System/Library/": + return "/usr/local/bin" + return os.path.join(prefix, "bin") + + +def get_purelib() -> str: + return get_python_lib(plat_specific=False) + + +def get_platlib() -> str: + return get_python_lib(plat_specific=True) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/locations/_sysconfig.py b/.venv/lib/python3.12/site-packages/pip/_internal/locations/_sysconfig.py new file mode 100644 index 0000000..ca860ea --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/locations/_sysconfig.py @@ -0,0 +1,214 @@ +import logging +import os +import sys +import sysconfig +import typing + +from pip._internal.exceptions import InvalidSchemeCombination, UserInstallationInvalid +from pip._internal.models.scheme import SCHEME_KEYS, Scheme +from pip._internal.utils.virtualenv import running_under_virtualenv + +from .base import change_root, get_major_minor_version, is_osx_framework + +logger = logging.getLogger(__name__) + + +# Notes on _infer_* functions. +# Unfortunately ``get_default_scheme()`` didn't exist before 3.10, so there's no +# way to ask things like "what is the '_prefix' scheme on this platform". These +# functions try to answer that with some heuristics while accounting for ad-hoc +# platforms not covered by CPython's default sysconfig implementation. If the +# ad-hoc implementation does not fully implement sysconfig, we'll fall back to +# a POSIX scheme. + +_AVAILABLE_SCHEMES = set(sysconfig.get_scheme_names()) + +_PREFERRED_SCHEME_API = getattr(sysconfig, "get_preferred_scheme", None) + + +def _should_use_osx_framework_prefix() -> bool: + """Check for Apple's ``osx_framework_library`` scheme. + + Python distributed by Apple's Command Line Tools has this special scheme + that's used when: + + * This is a framework build. + * We are installing into the system prefix. + + This does not account for ``pip install --prefix`` (also means we're not + installing to the system prefix), which should use ``posix_prefix``, but + logic here means ``_infer_prefix()`` outputs ``osx_framework_library``. But + since ``prefix`` is not available for ``sysconfig.get_default_scheme()``, + which is the stdlib replacement for ``_infer_prefix()``, presumably Apple + wouldn't be able to magically switch between ``osx_framework_library`` and + ``posix_prefix``. ``_infer_prefix()`` returning ``osx_framework_library`` + means its behavior is consistent whether we use the stdlib implementation + or our own, and we deal with this special case in ``get_scheme()`` instead. + """ + return ( + "osx_framework_library" in _AVAILABLE_SCHEMES + and not running_under_virtualenv() + and is_osx_framework() + ) + + +def _infer_prefix() -> str: + """Try to find a prefix scheme for the current platform. + + This tries: + + * A special ``osx_framework_library`` for Python distributed by Apple's + Command Line Tools, when not running in a virtual environment. + * Implementation + OS, used by PyPy on Windows (``pypy_nt``). + * Implementation without OS, used by PyPy on POSIX (``pypy``). + * OS + "prefix", used by CPython on POSIX (``posix_prefix``). + * Just the OS name, used by CPython on Windows (``nt``). + + If none of the above works, fall back to ``posix_prefix``. + """ + if _PREFERRED_SCHEME_API: + return _PREFERRED_SCHEME_API("prefix") + if _should_use_osx_framework_prefix(): + return "osx_framework_library" + implementation_suffixed = f"{sys.implementation.name}_{os.name}" + if implementation_suffixed in _AVAILABLE_SCHEMES: + return implementation_suffixed + if sys.implementation.name in _AVAILABLE_SCHEMES: + return sys.implementation.name + suffixed = f"{os.name}_prefix" + if suffixed in _AVAILABLE_SCHEMES: + return suffixed + if os.name in _AVAILABLE_SCHEMES: # On Windows, prefx is just called "nt". + return os.name + return "posix_prefix" + + +def _infer_user() -> str: + """Try to find a user scheme for the current platform.""" + if _PREFERRED_SCHEME_API: + return _PREFERRED_SCHEME_API("user") + if is_osx_framework() and not running_under_virtualenv(): + suffixed = "osx_framework_user" + else: + suffixed = f"{os.name}_user" + if suffixed in _AVAILABLE_SCHEMES: + return suffixed + if "posix_user" not in _AVAILABLE_SCHEMES: # User scheme unavailable. + raise UserInstallationInvalid() + return "posix_user" + + +def _infer_home() -> str: + """Try to find a home for the current platform.""" + if _PREFERRED_SCHEME_API: + return _PREFERRED_SCHEME_API("home") + suffixed = f"{os.name}_home" + if suffixed in _AVAILABLE_SCHEMES: + return suffixed + return "posix_home" + + +# Update these keys if the user sets a custom home. +_HOME_KEYS = [ + "installed_base", + "base", + "installed_platbase", + "platbase", + "prefix", + "exec_prefix", +] +if sysconfig.get_config_var("userbase") is not None: + _HOME_KEYS.append("userbase") + + +def get_scheme( + dist_name: str, + user: bool = False, + home: typing.Optional[str] = None, + root: typing.Optional[str] = None, + isolated: bool = False, + prefix: typing.Optional[str] = None, +) -> Scheme: + """ + Get the "scheme" corresponding to the input parameters. + + :param dist_name: the name of the package to retrieve the scheme for, used + in the headers scheme path + :param user: indicates to use the "user" scheme + :param home: indicates to use the "home" scheme + :param root: root under which other directories are re-based + :param isolated: ignored, but kept for distutils compatibility (where + this controls whether the user-site pydistutils.cfg is honored) + :param prefix: indicates to use the "prefix" scheme and provides the + base directory for the same + """ + if user and prefix: + raise InvalidSchemeCombination("--user", "--prefix") + if home and prefix: + raise InvalidSchemeCombination("--home", "--prefix") + + if home is not None: + scheme_name = _infer_home() + elif user: + scheme_name = _infer_user() + else: + scheme_name = _infer_prefix() + + # Special case: When installing into a custom prefix, use posix_prefix + # instead of osx_framework_library. See _should_use_osx_framework_prefix() + # docstring for details. + if prefix is not None and scheme_name == "osx_framework_library": + scheme_name = "posix_prefix" + + if home is not None: + variables = {k: home for k in _HOME_KEYS} + elif prefix is not None: + variables = {k: prefix for k in _HOME_KEYS} + else: + variables = {} + + paths = sysconfig.get_paths(scheme=scheme_name, vars=variables) + + # Logic here is very arbitrary, we're doing it for compatibility, don't ask. + # 1. Pip historically uses a special header path in virtual environments. + # 2. If the distribution name is not known, distutils uses 'UNKNOWN'. We + # only do the same when not running in a virtual environment because + # pip's historical header path logic (see point 1) did not do this. + if running_under_virtualenv(): + if user: + base = variables.get("userbase", sys.prefix) + else: + base = variables.get("base", sys.prefix) + python_xy = f"python{get_major_minor_version()}" + paths["include"] = os.path.join(base, "include", "site", python_xy) + elif not dist_name: + dist_name = "UNKNOWN" + + scheme = Scheme( + platlib=paths["platlib"], + purelib=paths["purelib"], + headers=os.path.join(paths["include"], dist_name), + scripts=paths["scripts"], + data=paths["data"], + ) + if root is not None: + converted_keys = {} + for key in SCHEME_KEYS: + converted_keys[key] = change_root(root, getattr(scheme, key)) + scheme = Scheme(**converted_keys) + return scheme + + +def get_bin_prefix() -> str: + # Forcing to use /usr/local/bin for standard macOS framework installs. + if sys.platform[:6] == "darwin" and sys.prefix[:16] == "/System/Library/": + return "/usr/local/bin" + return sysconfig.get_paths()["scripts"] + + +def get_purelib() -> str: + return sysconfig.get_paths()["purelib"] + + +def get_platlib() -> str: + return sysconfig.get_paths()["platlib"] diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/locations/base.py b/.venv/lib/python3.12/site-packages/pip/_internal/locations/base.py new file mode 100644 index 0000000..3f9f896 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/locations/base.py @@ -0,0 +1,81 @@ +import functools +import os +import site +import sys +import sysconfig +import typing + +from pip._internal.exceptions import InstallationError +from pip._internal.utils import appdirs +from pip._internal.utils.virtualenv import running_under_virtualenv + +# Application Directories +USER_CACHE_DIR = appdirs.user_cache_dir("pip") + +# FIXME doesn't account for venv linked to global site-packages +site_packages: str = sysconfig.get_path("purelib") + + +def get_major_minor_version() -> str: + """ + Return the major-minor version of the current Python as a string, e.g. + "3.7" or "3.10". + """ + return "{}.{}".format(*sys.version_info) + + +def change_root(new_root: str, pathname: str) -> str: + """Return 'pathname' with 'new_root' prepended. + + If 'pathname' is relative, this is equivalent to os.path.join(new_root, pathname). + Otherwise, it requires making 'pathname' relative and then joining the + two, which is tricky on DOS/Windows and Mac OS. + + This is borrowed from Python's standard library's distutils module. + """ + if os.name == "posix": + if not os.path.isabs(pathname): + return os.path.join(new_root, pathname) + else: + return os.path.join(new_root, pathname[1:]) + + elif os.name == "nt": + (drive, path) = os.path.splitdrive(pathname) + if path[0] == "\\": + path = path[1:] + return os.path.join(new_root, path) + + else: + raise InstallationError( + f"Unknown platform: {os.name}\n" + "Can not change root path prefix on unknown platform." + ) + + +def get_src_prefix() -> str: + if running_under_virtualenv(): + src_prefix = os.path.join(sys.prefix, "src") + else: + # FIXME: keep src in cwd for now (it is not a temporary folder) + try: + src_prefix = os.path.join(os.getcwd(), "src") + except OSError: + # In case the current working directory has been renamed or deleted + sys.exit("The folder you are executing pip from can no longer be found.") + + # under macOS + virtualenv sys.prefix is not properly resolved + # it is something like /path/to/python/bin/.. + return os.path.abspath(src_prefix) + + +try: + # Use getusersitepackages if this is present, as it ensures that the + # value is initialised properly. + user_site: typing.Optional[str] = site.getusersitepackages() +except AttributeError: + user_site = site.USER_SITE + + +@functools.lru_cache(maxsize=None) +def is_osx_framework() -> bool: + return bool(sysconfig.get_config_var("PYTHONFRAMEWORK")) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/main.py b/.venv/lib/python3.12/site-packages/pip/_internal/main.py new file mode 100644 index 0000000..33c6d24 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/main.py @@ -0,0 +1,12 @@ +from typing import List, Optional + + +def main(args: Optional[List[str]] = None) -> int: + """This is preserved for old console scripts that may still be referencing + it. + + For additional details, see https://github.com/pypa/pip/issues/7498. + """ + from pip._internal.utils.entrypoints import _wrapper + + return _wrapper(args) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/metadata/__init__.py b/.venv/lib/python3.12/site-packages/pip/_internal/metadata/__init__.py new file mode 100644 index 0000000..aa232b6 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/metadata/__init__.py @@ -0,0 +1,128 @@ +import contextlib +import functools +import os +import sys +from typing import TYPE_CHECKING, List, Optional, Type, cast + +from pip._internal.utils.misc import strtobool + +from .base import BaseDistribution, BaseEnvironment, FilesystemWheel, MemoryWheel, Wheel + +if TYPE_CHECKING: + from typing import Literal, Protocol +else: + Protocol = object + +__all__ = [ + "BaseDistribution", + "BaseEnvironment", + "FilesystemWheel", + "MemoryWheel", + "Wheel", + "get_default_environment", + "get_environment", + "get_wheel_distribution", + "select_backend", +] + + +def _should_use_importlib_metadata() -> bool: + """Whether to use the ``importlib.metadata`` or ``pkg_resources`` backend. + + By default, pip uses ``importlib.metadata`` on Python 3.11+, and + ``pkg_resourcess`` otherwise. This can be overridden by a couple of ways: + + * If environment variable ``_PIP_USE_IMPORTLIB_METADATA`` is set, it + dictates whether ``importlib.metadata`` is used, regardless of Python + version. + * On Python 3.11+, Python distributors can patch ``importlib.metadata`` + to add a global constant ``_PIP_USE_IMPORTLIB_METADATA = False``. This + makes pip use ``pkg_resources`` (unless the user set the aforementioned + environment variable to *True*). + """ + with contextlib.suppress(KeyError, ValueError): + return bool(strtobool(os.environ["_PIP_USE_IMPORTLIB_METADATA"])) + if sys.version_info < (3, 11): + return False + import importlib.metadata + + return bool(getattr(importlib.metadata, "_PIP_USE_IMPORTLIB_METADATA", True)) + + +class Backend(Protocol): + NAME: 'Literal["importlib", "pkg_resources"]' + Distribution: Type[BaseDistribution] + Environment: Type[BaseEnvironment] + + +@functools.lru_cache(maxsize=None) +def select_backend() -> Backend: + if _should_use_importlib_metadata(): + from . import importlib + + return cast(Backend, importlib) + from . import pkg_resources + + return cast(Backend, pkg_resources) + + +def get_default_environment() -> BaseEnvironment: + """Get the default representation for the current environment. + + This returns an Environment instance from the chosen backend. The default + Environment instance should be built from ``sys.path`` and may use caching + to share instance state accorss calls. + """ + return select_backend().Environment.default() + + +def get_environment(paths: Optional[List[str]]) -> BaseEnvironment: + """Get a representation of the environment specified by ``paths``. + + This returns an Environment instance from the chosen backend based on the + given import paths. The backend must build a fresh instance representing + the state of installed distributions when this function is called. + """ + return select_backend().Environment.from_paths(paths) + + +def get_directory_distribution(directory: str) -> BaseDistribution: + """Get the distribution metadata representation in the specified directory. + + This returns a Distribution instance from the chosen backend based on + the given on-disk ``.dist-info`` directory. + """ + return select_backend().Distribution.from_directory(directory) + + +def get_wheel_distribution(wheel: Wheel, canonical_name: str) -> BaseDistribution: + """Get the representation of the specified wheel's distribution metadata. + + This returns a Distribution instance from the chosen backend based on + the given wheel's ``.dist-info`` directory. + + :param canonical_name: Normalized project name of the given wheel. + """ + return select_backend().Distribution.from_wheel(wheel, canonical_name) + + +def get_metadata_distribution( + metadata_contents: bytes, + filename: str, + canonical_name: str, +) -> BaseDistribution: + """Get the dist representation of the specified METADATA file contents. + + This returns a Distribution instance from the chosen backend sourced from the data + in `metadata_contents`. + + :param metadata_contents: Contents of a METADATA file within a dist, or one served + via PEP 658. + :param filename: Filename for the dist this metadata represents. + :param canonical_name: Normalized project name of the given dist. + """ + return select_backend().Distribution.from_metadata_file_contents( + metadata_contents, + filename, + canonical_name, + ) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/metadata/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/metadata/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e9b57c9f4ed055e25523229384dacfd73a9eedcd GIT binary patch literal 5880 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/metadata/__pycache__/base.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/metadata/__pycache__/base.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..88b51f51c107acda9c15bce8128cc28de0cbd814 GIT binary patch literal 35222 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/metadata/__pycache__/pkg_resources.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/metadata/__pycache__/pkg_resources.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e24b8d571e5e1d6775cfe3d6191b088e8fc5bebc GIT binary patch literal 16103 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 str: + return field.lower().replace("-", "_") + + +def msg_to_json(msg: Message) -> Dict[str, Any]: + """Convert a Message object into a JSON-compatible dictionary.""" + + def sanitise_header(h: Union[Header, str]) -> str: + if isinstance(h, Header): + chunks = [] + for bytes, encoding in decode_header(h): + if encoding == "unknown-8bit": + try: + # See if UTF-8 works + bytes.decode("utf-8") + encoding = "utf-8" + except UnicodeDecodeError: + # If not, latin1 at least won't fail + encoding = "latin1" + chunks.append((bytes, encoding)) + return str(make_header(chunks)) + return str(h) + + result = {} + for field, multi in METADATA_FIELDS: + if field not in msg: + continue + key = json_name(field) + if multi: + value: Union[str, List[str]] = [ + sanitise_header(v) for v in msg.get_all(field) # type: ignore + ] + else: + value = sanitise_header(msg.get(field)) # type: ignore + if key == "keywords": + # Accept both comma-separated and space-separated + # forms, for better compatibility with old data. + if "," in value: + value = [v.strip() for v in value.split(",")] + else: + value = value.split() + result[key] = value + + payload = cast(str, msg.get_payload()) + if payload: + result["description"] = payload + + return result diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/metadata/base.py b/.venv/lib/python3.12/site-packages/pip/_internal/metadata/base.py new file mode 100644 index 0000000..9eabcdb --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/metadata/base.py @@ -0,0 +1,688 @@ +import csv +import email.message +import functools +import json +import logging +import pathlib +import re +import zipfile +from typing import ( + IO, + Any, + Collection, + Container, + Dict, + Iterable, + Iterator, + List, + NamedTuple, + Optional, + Protocol, + Tuple, + Union, +) + +from pip._vendor.packaging.requirements import Requirement +from pip._vendor.packaging.specifiers import InvalidSpecifier, SpecifierSet +from pip._vendor.packaging.utils import NormalizedName, canonicalize_name +from pip._vendor.packaging.version import Version + +from pip._internal.exceptions import NoneMetadataError +from pip._internal.locations import site_packages, user_site +from pip._internal.models.direct_url import ( + DIRECT_URL_METADATA_NAME, + DirectUrl, + DirectUrlValidationError, +) +from pip._internal.utils.compat import stdlib_pkgs # TODO: Move definition here. +from pip._internal.utils.egg_link import egg_link_path_from_sys_path +from pip._internal.utils.misc import is_local, normalize_path +from pip._internal.utils.urls import url_to_path + +from ._json import msg_to_json + +InfoPath = Union[str, pathlib.PurePath] + +logger = logging.getLogger(__name__) + + +class BaseEntryPoint(Protocol): + @property + def name(self) -> str: + raise NotImplementedError() + + @property + def value(self) -> str: + raise NotImplementedError() + + @property + def group(self) -> str: + raise NotImplementedError() + + +def _convert_installed_files_path( + entry: Tuple[str, ...], + info: Tuple[str, ...], +) -> str: + """Convert a legacy installed-files.txt path into modern RECORD path. + + The legacy format stores paths relative to the info directory, while the + modern format stores paths relative to the package root, e.g. the + site-packages directory. + + :param entry: Path parts of the installed-files.txt entry. + :param info: Path parts of the egg-info directory relative to package root. + :returns: The converted entry. + + For best compatibility with symlinks, this does not use ``abspath()`` or + ``Path.resolve()``, but tries to work with path parts: + + 1. While ``entry`` starts with ``..``, remove the equal amounts of parts + from ``info``; if ``info`` is empty, start appending ``..`` instead. + 2. Join the two directly. + """ + while entry and entry[0] == "..": + if not info or info[-1] == "..": + info += ("..",) + else: + info = info[:-1] + entry = entry[1:] + return str(pathlib.Path(*info, *entry)) + + +class RequiresEntry(NamedTuple): + requirement: str + extra: str + marker: str + + +class BaseDistribution(Protocol): + @classmethod + def from_directory(cls, directory: str) -> "BaseDistribution": + """Load the distribution from a metadata directory. + + :param directory: Path to a metadata directory, e.g. ``.dist-info``. + """ + raise NotImplementedError() + + @classmethod + def from_metadata_file_contents( + cls, + metadata_contents: bytes, + filename: str, + project_name: str, + ) -> "BaseDistribution": + """Load the distribution from the contents of a METADATA file. + + This is used to implement PEP 658 by generating a "shallow" dist object that can + be used for resolution without downloading or building the actual dist yet. + + :param metadata_contents: The contents of a METADATA file. + :param filename: File name for the dist with this metadata. + :param project_name: Name of the project this dist represents. + """ + raise NotImplementedError() + + @classmethod + def from_wheel(cls, wheel: "Wheel", name: str) -> "BaseDistribution": + """Load the distribution from a given wheel. + + :param wheel: A concrete wheel definition. + :param name: File name of the wheel. + + :raises InvalidWheel: Whenever loading of the wheel causes a + :py:exc:`zipfile.BadZipFile` exception to be thrown. + :raises UnsupportedWheel: If the wheel is a valid zip, but malformed + internally. + """ + raise NotImplementedError() + + def __repr__(self) -> str: + return f"{self.raw_name} {self.raw_version} ({self.location})" + + def __str__(self) -> str: + return f"{self.raw_name} {self.raw_version}" + + @property + def location(self) -> Optional[str]: + """Where the distribution is loaded from. + + A string value is not necessarily a filesystem path, since distributions + can be loaded from other sources, e.g. arbitrary zip archives. ``None`` + means the distribution is created in-memory. + + Do not canonicalize this value with e.g. ``pathlib.Path.resolve()``. If + this is a symbolic link, we want to preserve the relative path between + it and files in the distribution. + """ + raise NotImplementedError() + + @property + def editable_project_location(self) -> Optional[str]: + """The project location for editable distributions. + + This is the directory where pyproject.toml or setup.py is located. + None if the distribution is not installed in editable mode. + """ + # TODO: this property is relatively costly to compute, memoize it ? + direct_url = self.direct_url + if direct_url: + if direct_url.is_local_editable(): + return url_to_path(direct_url.url) + else: + # Search for an .egg-link file by walking sys.path, as it was + # done before by dist_is_editable(). + egg_link_path = egg_link_path_from_sys_path(self.raw_name) + if egg_link_path: + # TODO: get project location from second line of egg_link file + # (https://github.com/pypa/pip/issues/10243) + return self.location + return None + + @property + def installed_location(self) -> Optional[str]: + """The distribution's "installed" location. + + This should generally be a ``site-packages`` directory. This is + usually ``dist.location``, except for legacy develop-installed packages, + where ``dist.location`` is the source code location, and this is where + the ``.egg-link`` file is. + + The returned location is normalized (in particular, with symlinks removed). + """ + raise NotImplementedError() + + @property + def info_location(self) -> Optional[str]: + """Location of the .[egg|dist]-info directory or file. + + Similarly to ``location``, a string value is not necessarily a + filesystem path. ``None`` means the distribution is created in-memory. + + For a modern .dist-info installation on disk, this should be something + like ``{location}/{raw_name}-{version}.dist-info``. + + Do not canonicalize this value with e.g. ``pathlib.Path.resolve()``. If + this is a symbolic link, we want to preserve the relative path between + it and other files in the distribution. + """ + raise NotImplementedError() + + @property + def installed_by_distutils(self) -> bool: + """Whether this distribution is installed with legacy distutils format. + + A distribution installed with "raw" distutils not patched by setuptools + uses one single file at ``info_location`` to store metadata. We need to + treat this specially on uninstallation. + """ + info_location = self.info_location + if not info_location: + return False + return pathlib.Path(info_location).is_file() + + @property + def installed_as_egg(self) -> bool: + """Whether this distribution is installed as an egg. + + This usually indicates the distribution was installed by (older versions + of) easy_install. + """ + location = self.location + if not location: + return False + return location.endswith(".egg") + + @property + def installed_with_setuptools_egg_info(self) -> bool: + """Whether this distribution is installed with the ``.egg-info`` format. + + This usually indicates the distribution was installed with setuptools + with an old pip version or with ``single-version-externally-managed``. + + Note that this ensure the metadata store is a directory. distutils can + also installs an ``.egg-info``, but as a file, not a directory. This + property is *False* for that case. Also see ``installed_by_distutils``. + """ + info_location = self.info_location + if not info_location: + return False + if not info_location.endswith(".egg-info"): + return False + return pathlib.Path(info_location).is_dir() + + @property + def installed_with_dist_info(self) -> bool: + """Whether this distribution is installed with the "modern format". + + This indicates a "modern" installation, e.g. storing metadata in the + ``.dist-info`` directory. This applies to installations made by + setuptools (but through pip, not directly), or anything using the + standardized build backend interface (PEP 517). + """ + info_location = self.info_location + if not info_location: + return False + if not info_location.endswith(".dist-info"): + return False + return pathlib.Path(info_location).is_dir() + + @property + def canonical_name(self) -> NormalizedName: + raise NotImplementedError() + + @property + def version(self) -> Version: + raise NotImplementedError() + + @property + def raw_version(self) -> str: + raise NotImplementedError() + + @property + def setuptools_filename(self) -> str: + """Convert a project name to its setuptools-compatible filename. + + This is a copy of ``pkg_resources.to_filename()`` for compatibility. + """ + return self.raw_name.replace("-", "_") + + @property + def direct_url(self) -> Optional[DirectUrl]: + """Obtain a DirectUrl from this distribution. + + Returns None if the distribution has no `direct_url.json` metadata, + or if `direct_url.json` is invalid. + """ + try: + content = self.read_text(DIRECT_URL_METADATA_NAME) + except FileNotFoundError: + return None + try: + return DirectUrl.from_json(content) + except ( + UnicodeDecodeError, + json.JSONDecodeError, + DirectUrlValidationError, + ) as e: + logger.warning( + "Error parsing %s for %s: %s", + DIRECT_URL_METADATA_NAME, + self.canonical_name, + e, + ) + return None + + @property + def installer(self) -> str: + try: + installer_text = self.read_text("INSTALLER") + except (OSError, ValueError, NoneMetadataError): + return "" # Fail silently if the installer file cannot be read. + for line in installer_text.splitlines(): + cleaned_line = line.strip() + if cleaned_line: + return cleaned_line + return "" + + @property + def requested(self) -> bool: + return self.is_file("REQUESTED") + + @property + def editable(self) -> bool: + return bool(self.editable_project_location) + + @property + def local(self) -> bool: + """If distribution is installed in the current virtual environment. + + Always True if we're not in a virtualenv. + """ + if self.installed_location is None: + return False + return is_local(self.installed_location) + + @property + def in_usersite(self) -> bool: + if self.installed_location is None or user_site is None: + return False + return self.installed_location.startswith(normalize_path(user_site)) + + @property + def in_site_packages(self) -> bool: + if self.installed_location is None or site_packages is None: + return False + return self.installed_location.startswith(normalize_path(site_packages)) + + def is_file(self, path: InfoPath) -> bool: + """Check whether an entry in the info directory is a file.""" + raise NotImplementedError() + + def iter_distutils_script_names(self) -> Iterator[str]: + """Find distutils 'scripts' entries metadata. + + If 'scripts' is supplied in ``setup.py``, distutils records those in the + installed distribution's ``scripts`` directory, a file for each script. + """ + raise NotImplementedError() + + def read_text(self, path: InfoPath) -> str: + """Read a file in the info directory. + + :raise FileNotFoundError: If ``path`` does not exist in the directory. + :raise NoneMetadataError: If ``path`` exists in the info directory, but + cannot be read. + """ + raise NotImplementedError() + + def iter_entry_points(self) -> Iterable[BaseEntryPoint]: + raise NotImplementedError() + + def _metadata_impl(self) -> email.message.Message: + raise NotImplementedError() + + @functools.cached_property + def metadata(self) -> email.message.Message: + """Metadata of distribution parsed from e.g. METADATA or PKG-INFO. + + This should return an empty message if the metadata file is unavailable. + + :raises NoneMetadataError: If the metadata file is available, but does + not contain valid metadata. + """ + metadata = self._metadata_impl() + self._add_egg_info_requires(metadata) + return metadata + + @property + def metadata_dict(self) -> Dict[str, Any]: + """PEP 566 compliant JSON-serializable representation of METADATA or PKG-INFO. + + This should return an empty dict if the metadata file is unavailable. + + :raises NoneMetadataError: If the metadata file is available, but does + not contain valid metadata. + """ + return msg_to_json(self.metadata) + + @property + def metadata_version(self) -> Optional[str]: + """Value of "Metadata-Version:" in distribution metadata, if available.""" + return self.metadata.get("Metadata-Version") + + @property + def raw_name(self) -> str: + """Value of "Name:" in distribution metadata.""" + # The metadata should NEVER be missing the Name: key, but if it somehow + # does, fall back to the known canonical name. + return self.metadata.get("Name", self.canonical_name) + + @property + def requires_python(self) -> SpecifierSet: + """Value of "Requires-Python:" in distribution metadata. + + If the key does not exist or contains an invalid value, an empty + SpecifierSet should be returned. + """ + value = self.metadata.get("Requires-Python") + if value is None: + return SpecifierSet() + try: + # Convert to str to satisfy the type checker; this can be a Header object. + spec = SpecifierSet(str(value)) + except InvalidSpecifier as e: + message = "Package %r has an invalid Requires-Python: %s" + logger.warning(message, self.raw_name, e) + return SpecifierSet() + return spec + + def iter_dependencies(self, extras: Collection[str] = ()) -> Iterable[Requirement]: + """Dependencies of this distribution. + + For modern .dist-info distributions, this is the collection of + "Requires-Dist:" entries in distribution metadata. + """ + raise NotImplementedError() + + def iter_raw_dependencies(self) -> Iterable[str]: + """Raw Requires-Dist metadata.""" + return self.metadata.get_all("Requires-Dist", []) + + def iter_provided_extras(self) -> Iterable[NormalizedName]: + """Extras provided by this distribution. + + For modern .dist-info distributions, this is the collection of + "Provides-Extra:" entries in distribution metadata. + + The return value of this function is expected to be normalised names, + per PEP 685, with the returned value being handled appropriately by + `iter_dependencies`. + """ + raise NotImplementedError() + + def _iter_declared_entries_from_record(self) -> Optional[Iterator[str]]: + try: + text = self.read_text("RECORD") + except FileNotFoundError: + return None + # This extra Path-str cast normalizes entries. + return (str(pathlib.Path(row[0])) for row in csv.reader(text.splitlines())) + + def _iter_declared_entries_from_legacy(self) -> Optional[Iterator[str]]: + try: + text = self.read_text("installed-files.txt") + except FileNotFoundError: + return None + paths = (p for p in text.splitlines(keepends=False) if p) + root = self.location + info = self.info_location + if root is None or info is None: + return paths + try: + info_rel = pathlib.Path(info).relative_to(root) + except ValueError: # info is not relative to root. + return paths + if not info_rel.parts: # info *is* root. + return paths + return ( + _convert_installed_files_path(pathlib.Path(p).parts, info_rel.parts) + for p in paths + ) + + def iter_declared_entries(self) -> Optional[Iterator[str]]: + """Iterate through file entries declared in this distribution. + + For modern .dist-info distributions, this is the files listed in the + ``RECORD`` metadata file. For legacy setuptools distributions, this + comes from ``installed-files.txt``, with entries normalized to be + compatible with the format used by ``RECORD``. + + :return: An iterator for listed entries, or None if the distribution + contains neither ``RECORD`` nor ``installed-files.txt``. + """ + return ( + self._iter_declared_entries_from_record() + or self._iter_declared_entries_from_legacy() + ) + + def _iter_requires_txt_entries(self) -> Iterator[RequiresEntry]: + """Parse a ``requires.txt`` in an egg-info directory. + + This is an INI-ish format where an egg-info stores dependencies. A + section name describes extra other environment markers, while each entry + is an arbitrary string (not a key-value pair) representing a dependency + as a requirement string (no markers). + + There is a construct in ``importlib.metadata`` called ``Sectioned`` that + does mostly the same, but the format is currently considered private. + """ + try: + content = self.read_text("requires.txt") + except FileNotFoundError: + return + extra = marker = "" # Section-less entries don't have markers. + for line in content.splitlines(): + line = line.strip() + if not line or line.startswith("#"): # Comment; ignored. + continue + if line.startswith("[") and line.endswith("]"): # A section header. + extra, _, marker = line.strip("[]").partition(":") + continue + yield RequiresEntry(requirement=line, extra=extra, marker=marker) + + def _iter_egg_info_extras(self) -> Iterable[str]: + """Get extras from the egg-info directory.""" + known_extras = {""} + for entry in self._iter_requires_txt_entries(): + extra = canonicalize_name(entry.extra) + if extra in known_extras: + continue + known_extras.add(extra) + yield extra + + def _iter_egg_info_dependencies(self) -> Iterable[str]: + """Get distribution dependencies from the egg-info directory. + + To ease parsing, this converts a legacy dependency entry into a PEP 508 + requirement string. Like ``_iter_requires_txt_entries()``, there is code + in ``importlib.metadata`` that does mostly the same, but not do exactly + what we need. + + Namely, ``importlib.metadata`` does not normalize the extra name before + putting it into the requirement string, which causes marker comparison + to fail because the dist-info format do normalize. This is consistent in + all currently available PEP 517 backends, although not standardized. + """ + for entry in self._iter_requires_txt_entries(): + extra = canonicalize_name(entry.extra) + if extra and entry.marker: + marker = f'({entry.marker}) and extra == "{extra}"' + elif extra: + marker = f'extra == "{extra}"' + elif entry.marker: + marker = entry.marker + else: + marker = "" + if marker: + yield f"{entry.requirement} ; {marker}" + else: + yield entry.requirement + + def _add_egg_info_requires(self, metadata: email.message.Message) -> None: + """Add egg-info requires.txt information to the metadata.""" + if not metadata.get_all("Requires-Dist"): + for dep in self._iter_egg_info_dependencies(): + metadata["Requires-Dist"] = dep + if not metadata.get_all("Provides-Extra"): + for extra in self._iter_egg_info_extras(): + metadata["Provides-Extra"] = extra + + +class BaseEnvironment: + """An environment containing distributions to introspect.""" + + @classmethod + def default(cls) -> "BaseEnvironment": + raise NotImplementedError() + + @classmethod + def from_paths(cls, paths: Optional[List[str]]) -> "BaseEnvironment": + raise NotImplementedError() + + def get_distribution(self, name: str) -> Optional["BaseDistribution"]: + """Given a requirement name, return the installed distributions. + + The name may not be normalized. The implementation must canonicalize + it for lookup. + """ + raise NotImplementedError() + + def _iter_distributions(self) -> Iterator["BaseDistribution"]: + """Iterate through installed distributions. + + This function should be implemented by subclass, but never called + directly. Use the public ``iter_distribution()`` instead, which + implements additional logic to make sure the distributions are valid. + """ + raise NotImplementedError() + + def iter_all_distributions(self) -> Iterator[BaseDistribution]: + """Iterate through all installed distributions without any filtering.""" + for dist in self._iter_distributions(): + # Make sure the distribution actually comes from a valid Python + # packaging distribution. Pip's AdjacentTempDirectory leaves folders + # e.g. ``~atplotlib.dist-info`` if cleanup was interrupted. The + # valid project name pattern is taken from PEP 508. + project_name_valid = re.match( + r"^([A-Z0-9]|[A-Z0-9][A-Z0-9._-]*[A-Z0-9])$", + dist.canonical_name, + flags=re.IGNORECASE, + ) + if not project_name_valid: + logger.warning( + "Ignoring invalid distribution %s (%s)", + dist.canonical_name, + dist.location, + ) + continue + yield dist + + def iter_installed_distributions( + self, + local_only: bool = True, + skip: Container[str] = stdlib_pkgs, + include_editables: bool = True, + editables_only: bool = False, + user_only: bool = False, + ) -> Iterator[BaseDistribution]: + """Return a list of installed distributions. + + This is based on ``iter_all_distributions()`` with additional filtering + options. Note that ``iter_installed_distributions()`` without arguments + is *not* equal to ``iter_all_distributions()``, since some of the + configurations exclude packages by default. + + :param local_only: If True (default), only return installations + local to the current virtualenv, if in a virtualenv. + :param skip: An iterable of canonicalized project names to ignore; + defaults to ``stdlib_pkgs``. + :param include_editables: If False, don't report editables. + :param editables_only: If True, only report editables. + :param user_only: If True, only report installations in the user + site directory. + """ + it = self.iter_all_distributions() + if local_only: + it = (d for d in it if d.local) + if not include_editables: + it = (d for d in it if not d.editable) + if editables_only: + it = (d for d in it if d.editable) + if user_only: + it = (d for d in it if d.in_usersite) + return (d for d in it if d.canonical_name not in skip) + + +class Wheel(Protocol): + location: str + + def as_zipfile(self) -> zipfile.ZipFile: + raise NotImplementedError() + + +class FilesystemWheel(Wheel): + def __init__(self, location: str) -> None: + self.location = location + + def as_zipfile(self) -> zipfile.ZipFile: + return zipfile.ZipFile(self.location, allowZip64=True) + + +class MemoryWheel(Wheel): + def __init__(self, location: str, stream: IO[bytes]) -> None: + self.location = location + self.stream = stream + + def as_zipfile(self) -> zipfile.ZipFile: + return zipfile.ZipFile(self.stream, allowZip64=True) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/__init__.py b/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/__init__.py new file mode 100644 index 0000000..a779138 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/__init__.py @@ -0,0 +1,6 @@ +from ._dists import Distribution +from ._envs import Environment + +__all__ = ["NAME", "Distribution", "Environment"] + +NAME = "importlib" diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..64d28562247ed039ffad0f29472828b6fbfd2a49 GIT binary patch literal 356 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 t!{g25;a23xW&}O$6aDJMYI^RAT@D literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/__pycache__/_dists.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/__pycache__/_dists.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..1b8e0e8e598373684f2be129d0ef49d4c62e6e08 GIT binary patch literal 12571 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 bOa||OEZTOlzB|o3_+6Jr|BJ(o3ETeyv3+-a literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/_compat.py b/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/_compat.py new file mode 100644 index 0000000..ec1e815 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/_compat.py @@ -0,0 +1,85 @@ +import importlib.metadata +import os +from typing import Any, Optional, Protocol, Tuple, cast + +from pip._vendor.packaging.utils import NormalizedName, canonicalize_name + + +class BadMetadata(ValueError): + def __init__(self, dist: importlib.metadata.Distribution, *, reason: str) -> None: + self.dist = dist + self.reason = reason + + def __str__(self) -> str: + return f"Bad metadata in {self.dist} ({self.reason})" + + +class BasePath(Protocol): + """A protocol that various path objects conform. + + This exists because importlib.metadata uses both ``pathlib.Path`` and + ``zipfile.Path``, and we need a common base for type hints (Union does not + work well since ``zipfile.Path`` is too new for our linter setup). + + This does not mean to be exhaustive, but only contains things that present + in both classes *that we need*. + """ + + @property + def name(self) -> str: + raise NotImplementedError() + + @property + def parent(self) -> "BasePath": + raise NotImplementedError() + + +def get_info_location(d: importlib.metadata.Distribution) -> Optional[BasePath]: + """Find the path to the distribution's metadata directory. + + HACK: This relies on importlib.metadata's private ``_path`` attribute. Not + all distributions exist on disk, so importlib.metadata is correct to not + expose the attribute as public. But pip's code base is old and not as clean, + so we do this to avoid having to rewrite too many things. Hopefully we can + eliminate this some day. + """ + return getattr(d, "_path", None) + + +def parse_name_and_version_from_info_directory( + dist: importlib.metadata.Distribution, +) -> Tuple[Optional[str], Optional[str]]: + """Get a name and version from the metadata directory name. + + This is much faster than reading distribution metadata. + """ + info_location = get_info_location(dist) + if info_location is None: + return None, None + + stem, suffix = os.path.splitext(info_location.name) + if suffix == ".dist-info": + name, sep, version = stem.partition("-") + if sep: + return name, version + + if suffix == ".egg-info": + name = stem.split("-", 1)[0] + return name, None + + return None, None + + +def get_dist_canonical_name(dist: importlib.metadata.Distribution) -> NormalizedName: + """Get the distribution's normalized name. + + The ``name`` attribute is only available in Python 3.10 or later. We are + targeting exactly that, but Mypy does not know this. + """ + if name := parse_name_and_version_from_info_directory(dist)[0]: + return canonicalize_name(name) + + name = cast(Any, dist).name + if not isinstance(name, str): + raise BadMetadata(dist, reason="invalid metadata entry 'name'") + return canonicalize_name(name) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/_dists.py b/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/_dists.py new file mode 100644 index 0000000..36cd326 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/_dists.py @@ -0,0 +1,221 @@ +import email.message +import importlib.metadata +import pathlib +import zipfile +from typing import ( + Collection, + Dict, + Iterable, + Iterator, + Mapping, + Optional, + Sequence, + cast, +) + +from pip._vendor.packaging.requirements import Requirement +from pip._vendor.packaging.utils import NormalizedName, canonicalize_name +from pip._vendor.packaging.version import Version +from pip._vendor.packaging.version import parse as parse_version + +from pip._internal.exceptions import InvalidWheel, UnsupportedWheel +from pip._internal.metadata.base import ( + BaseDistribution, + BaseEntryPoint, + InfoPath, + Wheel, +) +from pip._internal.utils.misc import normalize_path +from pip._internal.utils.packaging import get_requirement +from pip._internal.utils.temp_dir import TempDirectory +from pip._internal.utils.wheel import parse_wheel, read_wheel_metadata_file + +from ._compat import ( + BasePath, + get_dist_canonical_name, + parse_name_and_version_from_info_directory, +) + + +class WheelDistribution(importlib.metadata.Distribution): + """An ``importlib.metadata.Distribution`` read from a wheel. + + Although ``importlib.metadata.PathDistribution`` accepts ``zipfile.Path``, + its implementation is too "lazy" for pip's needs (we can't keep the ZipFile + handle open for the entire lifetime of the distribution object). + + This implementation eagerly reads the entire metadata directory into the + memory instead, and operates from that. + """ + + def __init__( + self, + files: Mapping[pathlib.PurePosixPath, bytes], + info_location: pathlib.PurePosixPath, + ) -> None: + self._files = files + self.info_location = info_location + + @classmethod + def from_zipfile( + cls, + zf: zipfile.ZipFile, + name: str, + location: str, + ) -> "WheelDistribution": + info_dir, _ = parse_wheel(zf, name) + paths = ( + (name, pathlib.PurePosixPath(name.split("/", 1)[-1])) + for name in zf.namelist() + if name.startswith(f"{info_dir}/") + ) + files = { + relpath: read_wheel_metadata_file(zf, fullpath) + for fullpath, relpath in paths + } + info_location = pathlib.PurePosixPath(location, info_dir) + return cls(files, info_location) + + def iterdir(self, path: InfoPath) -> Iterator[pathlib.PurePosixPath]: + # Only allow iterating through the metadata directory. + if pathlib.PurePosixPath(str(path)) in self._files: + return iter(self._files) + raise FileNotFoundError(path) + + def read_text(self, filename: str) -> Optional[str]: + try: + data = self._files[pathlib.PurePosixPath(filename)] + except KeyError: + return None + try: + text = data.decode("utf-8") + except UnicodeDecodeError as e: + wheel = self.info_location.parent + error = f"Error decoding metadata for {wheel}: {e} in {filename} file" + raise UnsupportedWheel(error) + return text + + +class Distribution(BaseDistribution): + def __init__( + self, + dist: importlib.metadata.Distribution, + info_location: Optional[BasePath], + installed_location: Optional[BasePath], + ) -> None: + self._dist = dist + self._info_location = info_location + self._installed_location = installed_location + + @classmethod + def from_directory(cls, directory: str) -> BaseDistribution: + info_location = pathlib.Path(directory) + dist = importlib.metadata.Distribution.at(info_location) + return cls(dist, info_location, info_location.parent) + + @classmethod + def from_metadata_file_contents( + cls, + metadata_contents: bytes, + filename: str, + project_name: str, + ) -> BaseDistribution: + # Generate temp dir to contain the metadata file, and write the file contents. + temp_dir = pathlib.Path( + TempDirectory(kind="metadata", globally_managed=True).path + ) + metadata_path = temp_dir / "METADATA" + metadata_path.write_bytes(metadata_contents) + # Construct dist pointing to the newly created directory. + dist = importlib.metadata.Distribution.at(metadata_path.parent) + return cls(dist, metadata_path.parent, None) + + @classmethod + def from_wheel(cls, wheel: Wheel, name: str) -> BaseDistribution: + try: + with wheel.as_zipfile() as zf: + dist = WheelDistribution.from_zipfile(zf, name, wheel.location) + except zipfile.BadZipFile as e: + raise InvalidWheel(wheel.location, name) from e + return cls(dist, dist.info_location, pathlib.PurePosixPath(wheel.location)) + + @property + def location(self) -> Optional[str]: + if self._info_location is None: + return None + return str(self._info_location.parent) + + @property + def info_location(self) -> Optional[str]: + if self._info_location is None: + return None + return str(self._info_location) + + @property + def installed_location(self) -> Optional[str]: + if self._installed_location is None: + return None + return normalize_path(str(self._installed_location)) + + @property + def canonical_name(self) -> NormalizedName: + return get_dist_canonical_name(self._dist) + + @property + def version(self) -> Version: + if version := parse_name_and_version_from_info_directory(self._dist)[1]: + return parse_version(version) + return parse_version(self._dist.version) + + @property + def raw_version(self) -> str: + return self._dist.version + + def is_file(self, path: InfoPath) -> bool: + return self._dist.read_text(str(path)) is not None + + def iter_distutils_script_names(self) -> Iterator[str]: + # A distutils installation is always "flat" (not in e.g. egg form), so + # if this distribution's info location is NOT a pathlib.Path (but e.g. + # zipfile.Path), it can never contain any distutils scripts. + if not isinstance(self._info_location, pathlib.Path): + return + for child in self._info_location.joinpath("scripts").iterdir(): + yield child.name + + def read_text(self, path: InfoPath) -> str: + content = self._dist.read_text(str(path)) + if content is None: + raise FileNotFoundError(path) + return content + + def iter_entry_points(self) -> Iterable[BaseEntryPoint]: + # importlib.metadata's EntryPoint structure sasitfies BaseEntryPoint. + return self._dist.entry_points + + def _metadata_impl(self) -> email.message.Message: + # From Python 3.10+, importlib.metadata declares PackageMetadata as the + # return type. This protocol is unfortunately a disaster now and misses + # a ton of fields that we need, including get() and get_payload(). We + # rely on the implementation that the object is actually a Message now, + # until upstream can improve the protocol. (python/cpython#94952) + return cast(email.message.Message, self._dist.metadata) + + def iter_provided_extras(self) -> Iterable[NormalizedName]: + return [ + canonicalize_name(extra) + for extra in self.metadata.get_all("Provides-Extra", []) + ] + + def iter_dependencies(self, extras: Collection[str] = ()) -> Iterable[Requirement]: + contexts: Sequence[Dict[str, str]] = [{"extra": e} for e in extras] + for req_string in self.metadata.get_all("Requires-Dist", []): + # strip() because email.message.Message.get_all() may return a leading \n + # in case a long header was wrapped. + req = get_requirement(req_string.strip()) + if not req.marker: + yield req + elif not extras and req.marker.evaluate({"extra": ""}): + yield req + elif any(req.marker.evaluate(context) for context in contexts): + yield req diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/_envs.py b/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/_envs.py new file mode 100644 index 0000000..70cb7a6 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/metadata/importlib/_envs.py @@ -0,0 +1,189 @@ +import functools +import importlib.metadata +import logging +import os +import pathlib +import sys +import zipfile +import zipimport +from typing import Iterator, List, Optional, Sequence, Set, Tuple + +from pip._vendor.packaging.utils import NormalizedName, canonicalize_name + +from pip._internal.metadata.base import BaseDistribution, BaseEnvironment +from pip._internal.models.wheel import Wheel +from pip._internal.utils.deprecation import deprecated +from pip._internal.utils.filetypes import WHEEL_EXTENSION + +from ._compat import BadMetadata, BasePath, get_dist_canonical_name, get_info_location +from ._dists import Distribution + +logger = logging.getLogger(__name__) + + +def _looks_like_wheel(location: str) -> bool: + if not location.endswith(WHEEL_EXTENSION): + return False + if not os.path.isfile(location): + return False + if not Wheel.wheel_file_re.match(os.path.basename(location)): + return False + return zipfile.is_zipfile(location) + + +class _DistributionFinder: + """Finder to locate distributions. + + The main purpose of this class is to memoize found distributions' names, so + only one distribution is returned for each package name. At lot of pip code + assumes this (because it is setuptools's behavior), and not doing the same + can potentially cause a distribution in lower precedence path to override a + higher precedence one if the caller is not careful. + + Eventually we probably want to make it possible to see lower precedence + installations as well. It's useful feature, after all. + """ + + FoundResult = Tuple[importlib.metadata.Distribution, Optional[BasePath]] + + def __init__(self) -> None: + self._found_names: Set[NormalizedName] = set() + + def _find_impl(self, location: str) -> Iterator[FoundResult]: + """Find distributions in a location.""" + # Skip looking inside a wheel. Since a package inside a wheel is not + # always valid (due to .data directories etc.), its .dist-info entry + # should not be considered an installed distribution. + if _looks_like_wheel(location): + return + # To know exactly where we find a distribution, we have to feed in the + # paths one by one, instead of dumping the list to importlib.metadata. + for dist in importlib.metadata.distributions(path=[location]): + info_location = get_info_location(dist) + try: + name = get_dist_canonical_name(dist) + except BadMetadata as e: + logger.warning("Skipping %s due to %s", info_location, e.reason) + continue + if name in self._found_names: + continue + self._found_names.add(name) + yield dist, info_location + + def find(self, location: str) -> Iterator[BaseDistribution]: + """Find distributions in a location. + + The path can be either a directory, or a ZIP archive. + """ + for dist, info_location in self._find_impl(location): + if info_location is None: + installed_location: Optional[BasePath] = None + else: + installed_location = info_location.parent + yield Distribution(dist, info_location, installed_location) + + def find_linked(self, location: str) -> Iterator[BaseDistribution]: + """Read location in egg-link files and return distributions in there. + + The path should be a directory; otherwise this returns nothing. This + follows how setuptools does this for compatibility. The first non-empty + line in the egg-link is read as a path (resolved against the egg-link's + containing directory if relative). Distributions found at that linked + location are returned. + """ + path = pathlib.Path(location) + if not path.is_dir(): + return + for child in path.iterdir(): + if child.suffix != ".egg-link": + continue + with child.open() as f: + lines = (line.strip() for line in f) + target_rel = next((line for line in lines if line), "") + if not target_rel: + continue + target_location = str(path.joinpath(target_rel)) + for dist, info_location in self._find_impl(target_location): + yield Distribution(dist, info_location, path) + + def _find_eggs_in_dir(self, location: str) -> Iterator[BaseDistribution]: + from pip._vendor.pkg_resources import find_distributions + + from pip._internal.metadata import pkg_resources as legacy + + with os.scandir(location) as it: + for entry in it: + if not entry.name.endswith(".egg"): + continue + for dist in find_distributions(entry.path): + yield legacy.Distribution(dist) + + def _find_eggs_in_zip(self, location: str) -> Iterator[BaseDistribution]: + from pip._vendor.pkg_resources import find_eggs_in_zip + + from pip._internal.metadata import pkg_resources as legacy + + try: + importer = zipimport.zipimporter(location) + except zipimport.ZipImportError: + return + for dist in find_eggs_in_zip(importer, location): + yield legacy.Distribution(dist) + + def find_eggs(self, location: str) -> Iterator[BaseDistribution]: + """Find eggs in a location. + + This actually uses the old *pkg_resources* backend. We likely want to + deprecate this so we can eventually remove the *pkg_resources* + dependency entirely. Before that, this should first emit a deprecation + warning for some versions when using the fallback since importing + *pkg_resources* is slow for those who don't need it. + """ + if os.path.isdir(location): + yield from self._find_eggs_in_dir(location) + if zipfile.is_zipfile(location): + yield from self._find_eggs_in_zip(location) + + +@functools.lru_cache(maxsize=None) # Warn a distribution exactly once. +def _emit_egg_deprecation(location: Optional[str]) -> None: + deprecated( + reason=f"Loading egg at {location} is deprecated.", + replacement="to use pip for package installation", + gone_in="24.3", + issue=12330, + ) + + +class Environment(BaseEnvironment): + def __init__(self, paths: Sequence[str]) -> None: + self._paths = paths + + @classmethod + def default(cls) -> BaseEnvironment: + return cls(sys.path) + + @classmethod + def from_paths(cls, paths: Optional[List[str]]) -> BaseEnvironment: + if paths is None: + return cls(sys.path) + return cls(paths) + + def _iter_distributions(self) -> Iterator[BaseDistribution]: + finder = _DistributionFinder() + for location in self._paths: + yield from finder.find(location) + for dist in finder.find_eggs(location): + _emit_egg_deprecation(dist.location) + yield dist + # This must go last because that's how pkg_resources tie-breaks. + yield from finder.find_linked(location) + + def get_distribution(self, name: str) -> Optional[BaseDistribution]: + canonical_name = canonicalize_name(name) + matches = ( + distribution + for distribution in self.iter_all_distributions() + if distribution.canonical_name == canonical_name + ) + return next(matches, None) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/metadata/pkg_resources.py b/.venv/lib/python3.12/site-packages/pip/_internal/metadata/pkg_resources.py new file mode 100644 index 0000000..4ea84f9 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/metadata/pkg_resources.py @@ -0,0 +1,301 @@ +import email.message +import email.parser +import logging +import os +import zipfile +from typing import ( + Collection, + Iterable, + Iterator, + List, + Mapping, + NamedTuple, + Optional, +) + +from pip._vendor import pkg_resources +from pip._vendor.packaging.requirements import Requirement +from pip._vendor.packaging.utils import NormalizedName, canonicalize_name +from pip._vendor.packaging.version import Version +from pip._vendor.packaging.version import parse as parse_version + +from pip._internal.exceptions import InvalidWheel, NoneMetadataError, UnsupportedWheel +from pip._internal.utils.egg_link import egg_link_path_from_location +from pip._internal.utils.misc import display_path, normalize_path +from pip._internal.utils.wheel import parse_wheel, read_wheel_metadata_file + +from .base import ( + BaseDistribution, + BaseEntryPoint, + BaseEnvironment, + InfoPath, + Wheel, +) + +__all__ = ["NAME", "Distribution", "Environment"] + +logger = logging.getLogger(__name__) + +NAME = "pkg_resources" + + +class EntryPoint(NamedTuple): + name: str + value: str + group: str + + +class InMemoryMetadata: + """IMetadataProvider that reads metadata files from a dictionary. + + This also maps metadata decoding exceptions to our internal exception type. + """ + + def __init__(self, metadata: Mapping[str, bytes], wheel_name: str) -> None: + self._metadata = metadata + self._wheel_name = wheel_name + + def has_metadata(self, name: str) -> bool: + return name in self._metadata + + def get_metadata(self, name: str) -> str: + try: + return self._metadata[name].decode() + except UnicodeDecodeError as e: + # Augment the default error with the origin of the file. + raise UnsupportedWheel( + f"Error decoding metadata for {self._wheel_name}: {e} in {name} file" + ) + + def get_metadata_lines(self, name: str) -> Iterable[str]: + return pkg_resources.yield_lines(self.get_metadata(name)) + + def metadata_isdir(self, name: str) -> bool: + return False + + def metadata_listdir(self, name: str) -> List[str]: + return [] + + def run_script(self, script_name: str, namespace: str) -> None: + pass + + +class Distribution(BaseDistribution): + def __init__(self, dist: pkg_resources.Distribution) -> None: + self._dist = dist + # This is populated lazily, to avoid loading metadata for all possible + # distributions eagerly. + self.__extra_mapping: Optional[Mapping[NormalizedName, str]] = None + + @property + def _extra_mapping(self) -> Mapping[NormalizedName, str]: + if self.__extra_mapping is None: + self.__extra_mapping = { + canonicalize_name(extra): extra for extra in self._dist.extras + } + + return self.__extra_mapping + + @classmethod + def from_directory(cls, directory: str) -> BaseDistribution: + dist_dir = directory.rstrip(os.sep) + + # Build a PathMetadata object, from path to metadata. :wink: + base_dir, dist_dir_name = os.path.split(dist_dir) + metadata = pkg_resources.PathMetadata(base_dir, dist_dir) + + # Determine the correct Distribution object type. + if dist_dir.endswith(".egg-info"): + dist_cls = pkg_resources.Distribution + dist_name = os.path.splitext(dist_dir_name)[0] + else: + assert dist_dir.endswith(".dist-info") + dist_cls = pkg_resources.DistInfoDistribution + dist_name = os.path.splitext(dist_dir_name)[0].split("-")[0] + + dist = dist_cls(base_dir, project_name=dist_name, metadata=metadata) + return cls(dist) + + @classmethod + def from_metadata_file_contents( + cls, + metadata_contents: bytes, + filename: str, + project_name: str, + ) -> BaseDistribution: + metadata_dict = { + "METADATA": metadata_contents, + } + dist = pkg_resources.DistInfoDistribution( + location=filename, + metadata=InMemoryMetadata(metadata_dict, filename), + project_name=project_name, + ) + return cls(dist) + + @classmethod + def from_wheel(cls, wheel: Wheel, name: str) -> BaseDistribution: + try: + with wheel.as_zipfile() as zf: + info_dir, _ = parse_wheel(zf, name) + metadata_dict = { + path.split("/", 1)[-1]: read_wheel_metadata_file(zf, path) + for path in zf.namelist() + if path.startswith(f"{info_dir}/") + } + except zipfile.BadZipFile as e: + raise InvalidWheel(wheel.location, name) from e + except UnsupportedWheel as e: + raise UnsupportedWheel(f"{name} has an invalid wheel, {e}") + dist = pkg_resources.DistInfoDistribution( + location=wheel.location, + metadata=InMemoryMetadata(metadata_dict, wheel.location), + project_name=name, + ) + return cls(dist) + + @property + def location(self) -> Optional[str]: + return self._dist.location + + @property + def installed_location(self) -> Optional[str]: + egg_link = egg_link_path_from_location(self.raw_name) + if egg_link: + location = egg_link + elif self.location: + location = self.location + else: + return None + return normalize_path(location) + + @property + def info_location(self) -> Optional[str]: + return self._dist.egg_info + + @property + def installed_by_distutils(self) -> bool: + # A distutils-installed distribution is provided by FileMetadata. This + # provider has a "path" attribute not present anywhere else. Not the + # best introspection logic, but pip has been doing this for a long time. + try: + return bool(self._dist._provider.path) + except AttributeError: + return False + + @property + def canonical_name(self) -> NormalizedName: + return canonicalize_name(self._dist.project_name) + + @property + def version(self) -> Version: + return parse_version(self._dist.version) + + @property + def raw_version(self) -> str: + return self._dist.version + + def is_file(self, path: InfoPath) -> bool: + return self._dist.has_metadata(str(path)) + + def iter_distutils_script_names(self) -> Iterator[str]: + yield from self._dist.metadata_listdir("scripts") + + def read_text(self, path: InfoPath) -> str: + name = str(path) + if not self._dist.has_metadata(name): + raise FileNotFoundError(name) + content = self._dist.get_metadata(name) + if content is None: + raise NoneMetadataError(self, name) + return content + + def iter_entry_points(self) -> Iterable[BaseEntryPoint]: + for group, entries in self._dist.get_entry_map().items(): + for name, entry_point in entries.items(): + name, _, value = str(entry_point).partition("=") + yield EntryPoint(name=name.strip(), value=value.strip(), group=group) + + def _metadata_impl(self) -> email.message.Message: + """ + :raises NoneMetadataError: if the distribution reports `has_metadata()` + True but `get_metadata()` returns None. + """ + if isinstance(self._dist, pkg_resources.DistInfoDistribution): + metadata_name = "METADATA" + else: + metadata_name = "PKG-INFO" + try: + metadata = self.read_text(metadata_name) + except FileNotFoundError: + if self.location: + displaying_path = display_path(self.location) + else: + displaying_path = repr(self.location) + logger.warning("No metadata found in %s", displaying_path) + metadata = "" + feed_parser = email.parser.FeedParser() + feed_parser.feed(metadata) + return feed_parser.close() + + def iter_dependencies(self, extras: Collection[str] = ()) -> Iterable[Requirement]: + if extras: + relevant_extras = set(self._extra_mapping) & set( + map(canonicalize_name, extras) + ) + extras = [self._extra_mapping[extra] for extra in relevant_extras] + return self._dist.requires(extras) + + def iter_provided_extras(self) -> Iterable[NormalizedName]: + return self._extra_mapping.keys() + + +class Environment(BaseEnvironment): + def __init__(self, ws: pkg_resources.WorkingSet) -> None: + self._ws = ws + + @classmethod + def default(cls) -> BaseEnvironment: + return cls(pkg_resources.working_set) + + @classmethod + def from_paths(cls, paths: Optional[List[str]]) -> BaseEnvironment: + return cls(pkg_resources.WorkingSet(paths)) + + def _iter_distributions(self) -> Iterator[BaseDistribution]: + for dist in self._ws: + yield Distribution(dist) + + def _search_distribution(self, name: str) -> Optional[BaseDistribution]: + """Find a distribution matching the ``name`` in the environment. + + This searches from *all* distributions available in the environment, to + match the behavior of ``pkg_resources.get_distribution()``. + """ + canonical_name = canonicalize_name(name) + for dist in self.iter_all_distributions(): + if dist.canonical_name == canonical_name: + return dist + return None + + def get_distribution(self, name: str) -> Optional[BaseDistribution]: + # Search the distribution by looking through the working set. + dist = self._search_distribution(name) + if dist: + return dist + + # If distribution could not be found, call working_set.require to + # update the working set, and try to find the distribution again. + # This might happen for e.g. when you install a package twice, once + # using setup.py develop and again using setup.py install. Now when + # running pip uninstall twice, the package gets removed from the + # working set in the first uninstall, so we have to populate the + # working set again so that pip knows about it and the packages gets + # picked up and is successfully uninstalled the second time too. + try: + # We didn't pass in any version specifiers, so this can never + # raise pkg_resources.VersionConflict. + self._ws.require(name) + except pkg_resources.DistributionNotFound: + return None + return self._search_distribution(name) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/models/__init__.py b/.venv/lib/python3.12/site-packages/pip/_internal/models/__init__.py new file mode 100644 index 0000000..7855226 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/models/__init__.py @@ -0,0 +1,2 @@ +"""A package that contains models that represent entities. +""" diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..733d7a46f275a15f1355bf65feb9a577c486e629 GIT binary patch literal 264 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 IL?!V50eS4tKmY&$ literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/format_control.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/format_control.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..3e747c94a9fe2e087e6d650784cf3327d6f5ffd0 GIT binary patch literal 4225 zcmahMTWnLwb?(dWw?mph2sfMXFeLT@RiPA8X<>OR;B8>{$I|Mq@k|mY*S==%4Ixoj zMJ?4PRU|;#Hb$r=l`0j4s?vT`^p90Px>EaL6Hwf%NR8C4)crGLtM2BjXRcpKFfg*` zapv4JXU=>6=JmP|wC4j42LI$l=wED6Yhrb>dIBc%2qVm?D8nVV44>dLLPFpej90~s zl#r~spxQF_gq=e?I)$)!9bxGKU!jt4OxPm!uh=3Yn9h?_n=d5~%ud3-pX8kUoCE}0rl4iOmyCSM|Q zI;$H=RV6rTI=fmPXys0YKD=I@o~d?0i|4*KllD z%a9n&0lszxt{F>dn8ePf^;9f+g=DY9)byoTZo(MWvInF455)AeLHeqK&||rDE~ccj z2BBb3u?&2w>amLKlvG8&(cFaTPyi`yD9U8(2H8hza4)c<_dz#}$}Z&DQgC-Hw{5#4 z&73K@TMO>a<*nQA?3_8f(*D+rIOi*E+chITbF{6(2gsB(W0=rXT?PPSo@7b*Axu6+ zpK|l4A>mnW7LBaO1{~IEo}=50nkS-*2yktc{q_AU*9fLr zj^=bupqjoPR5f}Lv=u*@s_Pd{W#=D+zhy5!=g%UJSq=JVJ3`mEb@vjcxY`}oLBU>X z(9t~z{eqk4I5f9I1Y7x?FwRjQPzHy$4-q427&Ic9eDrOT8>KCd^ zaQAPa?kC;5xQJxB(z@kk*%UFIijq>3x~?duFRmG9GC7rG z2-qHGTe_+lY)b%-jPMrU)(v!~>5o6QST}8o!Z@64X~y?f#^ev7`*s>F``hz77g~PX z`RmT7{K7K!5*!P1+2Oi<2{&=xJUO4vt7nchS>6p@$q&h}Sn~|hocN?Ok1Y|8?{R%j; zgtgumV3Re>)%=CJ4Tfzs%-5hlW@2NMHZ?5NFs=z$oD!}edSQwmv2Q|yWz8=+h|h1_ zulsw04i;-C0R;iWe}skNO|5~2rAgTPDSr%M8}P+J9D$5(amdYGm=aE)kKP4;7pFvQ zV}4A7Z{lmN-C$wWYEyM?fC4|_ufZE*1H-y;lN+tam^;PdN5l>$);D>muP>|hRnngv zll%Hu2CS_$tJ;t$xjdGpM3?u=pz<;1x6w7OcTGA1{(9sqrs7H45vW7Rk%+@|L1Lwb zKAtv)DbtN9={YrRm{Lk5NeVuWu_>jqm|UeSIGT10`6@|qM54Q4O+h}$@_tjul5taH zHm@^tfRra!jl6Xj${Up^nK5H5sVd}ZN*%*QpX}Kf8=7P70$Tdtp_@i4?!c0JThYBO zfBdOiUJiAZ0%ukQKI|(a-s>ydkiX@|=F`SzZb#lng_nu(5%OVSJA`*(5$hrZhQ^RI!CXi*(5*%&EPBU{zg6_ zbepznIcd|iF`6Q@7x;xJ&SD5<#efySO()c+P}f7X7ZEBs4@wZks!n}OHELB}C8~!Z z(kkF>+Bm_=V5PpD?AmDUO;C;jLH!}bN4YziqFRL zho5?SzV@L&d%ktiFBcqg*^7J~dE@RUw?8R*H=?=Lqd5_{g}BtVrwBjqo(=SD>k%aj z@viT-ujt*i9&Op*Ry*|N{98{c7vLJNPAOm8cPsDPIc&M*?)(1G|Jo+U?j(a~M9TGP+{B>(^1vtYNQm~pXu1>yYV$FOc8cjyl*mVNe=kGn;m4grp2pyrgL=l^F($ex?Uvw2@9_2s{mN<>E{xl-UbqWz>CS@nabu zW%lpQG2SK1qWZg)$&SHciY7lhlVi{YJR2>=jA zTRZcqh3?zK#Vxzb3Z)zsx_8F9D{bRA~pg6Td2&pNZS`u zWdy^+gAesT9JZ#9kAES2e%hKA20nbjc2|WOdb!snbv^7ZBN!e<9v}a6bd^oNZj+>n zyscZsBTgu0CUWp}q?QyKlH3Mwq^JT3Ta(J>>f>Xq!(W?|G`QBlZ5#7dgF zmHR59JH_P33QJ3zYmTE8efHC{0Am)W!)pMQ1&-tXiS`xIzAw@DzeM~0XFJJpt`~^) H*605RP)My% literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/index.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/index.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d8c1365681a908106fbfd038c328dac4398bf98f GIT binary patch literal 1692 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/link.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/link.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..35f15c5d52ff2732771ada0378355040b2145517 GIT binary patch literal 26602 zcmd6QdvIIVdFQ=&5g-795AZ2IK#HUUN(4nxZ|nWC=t#6)j$_6)1>s(jkny1J1tpON zZMJb5Dsk7;c2hwcXGFDbMb++x*_lq1-EHGdn;p;Y{s9=kkDz2~0y`M&RbkMkY!y({f?Mpt_a400;(cqudmY|;QMdW>^J-HH zZbCicUo41FAGH>ZY!ez#a--PKO1B72C~ZL4px4%n_d$`nJh8S6HWn@DU#nJ{J{CLJ zw>Et9h?VacmAoT6g?4cV>e-22bfDZ_Xf=0va&5^1|L#U@#Dz}e>0n6RH zJ=45*)6XdTu$Rx;1b@sQ2>E5%Ys)$>Ja^{!=+TqMkA7ij_{psCaAZ1bIu;DXvZhl( zIhHLu?Vp?sM#i({!~U=+T$q{+iCOE@ld)hl;tyrbN`(2D2;Nb4xgbtTV!$601-!YQ zJ$d~2snO$Kx^R5>{Ls@>x#gr^o)BfPDQlhd2c@e)S#1PmC7N;nA7RMoMfSv^o`5nbp0Iz~ zGvU7?dc^Q0Q4mA{Z}Noaia#_Z%0AD9iJsrU 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/scheme.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/scheme.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..1b8f89435a73569490a782803d457ebadc2bbd20 GIT binary patch literal 1021 zcmZWo&ui2`6rLoT-EG!wEBK=a4}%J_pb54&DT+$9MO&2W!9@tu%-hXiHWO!Nx80r! z*1I?F-emm?{1?1>keozM-ntYKJo%E{Eus(d=6jR(CU3s?j>TwPTGW9+)k{X-L@^#CER&uwH=#)%_|?=ku}M;$$i4BhlJNgcw%9r$wJzd zVZAlC|IxcA6*a>QG-X=LNH7DO?g|rAk!r(|gc%`Is-qZspnb0_V6+P zOJ#?$0TT(^Nnn;uS<0!2K`0u@)WDv(N;QBN8$sAH_{tRzAm>VNrtJx7@szVZVvkLC{xFf*2SFrSqDOl*o+E zD@DN*tgLpF+=n!pQc^C?G?)?%q-`PD_EV(0?LejNLKSMIJMBbC4jb)@nr8dFAe zSY-a68KaL%I`Q1-1?z%e=Bo;}p$ZMDYT;^ytE1b(&gx;9vL1wC?uB7b@_tg_Q(^eB z&ywkzS{UN2aJ#X6cYSShEqt){Y&)L|L!C&Yao^EK}* zdl0A$jFJPqX%I;c!KTnr;13`j1URT*qJtIx`f{KJPJ4O-9b_U4LV@x@6(j+62#F3R zdPMQ4Msbg4o=gN?7v#a9o%{Nudl;f6XptK4e2Y5{}1aiS&A zs*r+OoaLx91u9F56v6se0Sf2R@x!56; literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/search_scope.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/search_scope.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..88e688bd59fc723a717219be83ecf19ecb526f83 GIT binary patch literal 4994 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 G)a_rxj0@ZV literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/target_python.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/target_python.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4b283cc156255e4ea48760194bc72789cdef0714 GIT binary patch literal 4952 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 VlOO(>oc>qD;<#g<5iHqm{{wB4*W3UA literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/wheel.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/models/__pycache__/wheel.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..0a3a102020463de9eb6987c59e7e761dac1dc02d GIT binary patch literal 5778 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 aM!Jin`y None: + object.__setattr__(self, "name", name) + object.__setattr__(self, "version", parse_version(version)) + object.__setattr__(self, "link", link) + + def __str__(self) -> str: + return f"{self.name!r} candidate (version {self.version} at {self.link})" diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/models/direct_url.py b/.venv/lib/python3.12/site-packages/pip/_internal/models/direct_url.py new file mode 100644 index 0000000..fc5ec8d --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/models/direct_url.py @@ -0,0 +1,224 @@ +""" PEP 610 """ + +import json +import re +import urllib.parse +from dataclasses import dataclass +from typing import Any, ClassVar, Dict, Iterable, Optional, Type, TypeVar, Union + +__all__ = [ + "DirectUrl", + "DirectUrlValidationError", + "DirInfo", + "ArchiveInfo", + "VcsInfo", +] + +T = TypeVar("T") + +DIRECT_URL_METADATA_NAME = "direct_url.json" +ENV_VAR_RE = re.compile(r"^\$\{[A-Za-z0-9-_]+\}(:\$\{[A-Za-z0-9-_]+\})?$") + + +class DirectUrlValidationError(Exception): + pass + + +def _get( + d: Dict[str, Any], expected_type: Type[T], key: str, default: Optional[T] = None +) -> Optional[T]: + """Get value from dictionary and verify expected type.""" + if key not in d: + return default + value = d[key] + if not isinstance(value, expected_type): + raise DirectUrlValidationError( + f"{value!r} has unexpected type for {key} (expected {expected_type})" + ) + return value + + +def _get_required( + d: Dict[str, Any], expected_type: Type[T], key: str, default: Optional[T] = None +) -> T: + value = _get(d, expected_type, key, default) + if value is None: + raise DirectUrlValidationError(f"{key} must have a value") + return value + + +def _exactly_one_of(infos: Iterable[Optional["InfoType"]]) -> "InfoType": + infos = [info for info in infos if info is not None] + if not infos: + raise DirectUrlValidationError( + "missing one of archive_info, dir_info, vcs_info" + ) + if len(infos) > 1: + raise DirectUrlValidationError( + "more than one of archive_info, dir_info, vcs_info" + ) + assert infos[0] is not None + return infos[0] + + +def _filter_none(**kwargs: Any) -> Dict[str, Any]: + """Make dict excluding None values.""" + return {k: v for k, v in kwargs.items() if v is not None} + + +@dataclass +class VcsInfo: + name: ClassVar = "vcs_info" + + vcs: str + commit_id: str + requested_revision: Optional[str] = None + + @classmethod + def _from_dict(cls, d: Optional[Dict[str, Any]]) -> Optional["VcsInfo"]: + if d is None: + return None + return cls( + vcs=_get_required(d, str, "vcs"), + commit_id=_get_required(d, str, "commit_id"), + requested_revision=_get(d, str, "requested_revision"), + ) + + def _to_dict(self) -> Dict[str, Any]: + return _filter_none( + vcs=self.vcs, + requested_revision=self.requested_revision, + commit_id=self.commit_id, + ) + + +class ArchiveInfo: + name = "archive_info" + + def __init__( + self, + hash: Optional[str] = None, + hashes: Optional[Dict[str, str]] = None, + ) -> None: + # set hashes before hash, since the hash setter will further populate hashes + self.hashes = hashes + self.hash = hash + + @property + def hash(self) -> Optional[str]: + return self._hash + + @hash.setter + def hash(self, value: Optional[str]) -> None: + if value is not None: + # Auto-populate the hashes key to upgrade to the new format automatically. + # We don't back-populate the legacy hash key from hashes. + try: + hash_name, hash_value = value.split("=", 1) + except ValueError: + raise DirectUrlValidationError( + f"invalid archive_info.hash format: {value!r}" + ) + if self.hashes is None: + self.hashes = {hash_name: hash_value} + elif hash_name not in self.hashes: + self.hashes = self.hashes.copy() + self.hashes[hash_name] = hash_value + self._hash = value + + @classmethod + def _from_dict(cls, d: Optional[Dict[str, Any]]) -> Optional["ArchiveInfo"]: + if d is None: + return None + return cls(hash=_get(d, str, "hash"), hashes=_get(d, dict, "hashes")) + + def _to_dict(self) -> Dict[str, Any]: + return _filter_none(hash=self.hash, hashes=self.hashes) + + +@dataclass +class DirInfo: + name: ClassVar = "dir_info" + + editable: bool = False + + @classmethod + def _from_dict(cls, d: Optional[Dict[str, Any]]) -> Optional["DirInfo"]: + if d is None: + return None + return cls(editable=_get_required(d, bool, "editable", default=False)) + + def _to_dict(self) -> Dict[str, Any]: + return _filter_none(editable=self.editable or None) + + +InfoType = Union[ArchiveInfo, DirInfo, VcsInfo] + + +@dataclass +class DirectUrl: + url: str + info: InfoType + subdirectory: Optional[str] = None + + def _remove_auth_from_netloc(self, netloc: str) -> str: + if "@" not in netloc: + return netloc + user_pass, netloc_no_user_pass = netloc.split("@", 1) + if ( + isinstance(self.info, VcsInfo) + and self.info.vcs == "git" + and user_pass == "git" + ): + return netloc + if ENV_VAR_RE.match(user_pass): + return netloc + return netloc_no_user_pass + + @property + def redacted_url(self) -> str: + """url with user:password part removed unless it is formed with + environment variables as specified in PEP 610, or it is ``git`` + in the case of a git URL. + """ + purl = urllib.parse.urlsplit(self.url) + netloc = self._remove_auth_from_netloc(purl.netloc) + surl = urllib.parse.urlunsplit( + (purl.scheme, netloc, purl.path, purl.query, purl.fragment) + ) + return surl + + def validate(self) -> None: + self.from_dict(self.to_dict()) + + @classmethod + def from_dict(cls, d: Dict[str, Any]) -> "DirectUrl": + return DirectUrl( + url=_get_required(d, str, "url"), + subdirectory=_get(d, str, "subdirectory"), + info=_exactly_one_of( + [ + ArchiveInfo._from_dict(_get(d, dict, "archive_info")), + DirInfo._from_dict(_get(d, dict, "dir_info")), + VcsInfo._from_dict(_get(d, dict, "vcs_info")), + ] + ), + ) + + def to_dict(self) -> Dict[str, Any]: + res = _filter_none( + url=self.redacted_url, + subdirectory=self.subdirectory, + ) + res[self.info.name] = self.info._to_dict() + return res + + @classmethod + def from_json(cls, s: str) -> "DirectUrl": + return cls.from_dict(json.loads(s)) + + def to_json(self) -> str: + return json.dumps(self.to_dict(), sort_keys=True) + + def is_local_editable(self) -> bool: + return isinstance(self.info, DirInfo) and self.info.editable diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/models/format_control.py b/.venv/lib/python3.12/site-packages/pip/_internal/models/format_control.py new file mode 100644 index 0000000..ccd1127 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/models/format_control.py @@ -0,0 +1,78 @@ +from typing import FrozenSet, Optional, Set + +from pip._vendor.packaging.utils import canonicalize_name + +from pip._internal.exceptions import CommandError + + +class FormatControl: + """Helper for managing formats from which a package can be installed.""" + + __slots__ = ["no_binary", "only_binary"] + + def __init__( + self, + no_binary: Optional[Set[str]] = None, + only_binary: Optional[Set[str]] = None, + ) -> None: + if no_binary is None: + no_binary = set() + if only_binary is None: + only_binary = set() + + self.no_binary = no_binary + self.only_binary = only_binary + + def __eq__(self, other: object) -> bool: + if not isinstance(other, self.__class__): + return NotImplemented + + if self.__slots__ != other.__slots__: + return False + + return all(getattr(self, k) == getattr(other, k) for k in self.__slots__) + + def __repr__(self) -> str: + return f"{self.__class__.__name__}({self.no_binary}, {self.only_binary})" + + @staticmethod + def handle_mutual_excludes(value: str, target: Set[str], other: Set[str]) -> None: + if value.startswith("-"): + raise CommandError( + "--no-binary / --only-binary option requires 1 argument." + ) + new = value.split(",") + while ":all:" in new: + other.clear() + target.clear() + target.add(":all:") + del new[: new.index(":all:") + 1] + # Without a none, we want to discard everything as :all: covers it + if ":none:" not in new: + return + for name in new: + if name == ":none:": + target.clear() + continue + name = canonicalize_name(name) + other.discard(name) + target.add(name) + + def get_allowed_formats(self, canonical_name: str) -> FrozenSet[str]: + result = {"binary", "source"} + if canonical_name in self.only_binary: + result.discard("source") + elif canonical_name in self.no_binary: + result.discard("binary") + elif ":all:" in self.only_binary: + result.discard("source") + elif ":all:" in self.no_binary: + result.discard("binary") + return frozenset(result) + + def disallow_binaries(self) -> None: + self.handle_mutual_excludes( + ":all:", + self.no_binary, + self.only_binary, + ) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/models/index.py b/.venv/lib/python3.12/site-packages/pip/_internal/models/index.py new file mode 100644 index 0000000..b94c325 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/models/index.py @@ -0,0 +1,28 @@ +import urllib.parse + + +class PackageIndex: + """Represents a Package Index and provides easier access to endpoints""" + + __slots__ = ["url", "netloc", "simple_url", "pypi_url", "file_storage_domain"] + + def __init__(self, url: str, file_storage_domain: str) -> None: + super().__init__() + self.url = url + self.netloc = urllib.parse.urlsplit(url).netloc + self.simple_url = self._url_for_path("simple") + self.pypi_url = self._url_for_path("pypi") + + # This is part of a temporary hack used to block installs of PyPI + # packages which depend on external urls only necessary until PyPI can + # block such packages themselves + self.file_storage_domain = file_storage_domain + + def _url_for_path(self, path: str) -> str: + return urllib.parse.urljoin(self.url, path) + + +PyPI = PackageIndex("https://pypi.org/", file_storage_domain="files.pythonhosted.org") +TestPyPI = PackageIndex( + "https://test.pypi.org/", file_storage_domain="test-files.pythonhosted.org" +) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/models/installation_report.py b/.venv/lib/python3.12/site-packages/pip/_internal/models/installation_report.py new file mode 100644 index 0000000..b9c6330 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/models/installation_report.py @@ -0,0 +1,56 @@ +from typing import Any, Dict, Sequence + +from pip._vendor.packaging.markers import default_environment + +from pip import __version__ +from pip._internal.req.req_install import InstallRequirement + + +class InstallationReport: + def __init__(self, install_requirements: Sequence[InstallRequirement]): + self._install_requirements = install_requirements + + @classmethod + def _install_req_to_dict(cls, ireq: InstallRequirement) -> Dict[str, Any]: + assert ireq.download_info, f"No download_info for {ireq}" + res = { + # PEP 610 json for the download URL. download_info.archive_info.hashes may + # be absent when the requirement was installed from the wheel cache + # and the cache entry was populated by an older pip version that did not + # record origin.json. + "download_info": ireq.download_info.to_dict(), + # is_direct is true if the requirement was a direct URL reference (which + # includes editable requirements), and false if the requirement was + # downloaded from a PEP 503 index or --find-links. + "is_direct": ireq.is_direct, + # is_yanked is true if the requirement was yanked from the index, but + # was still selected by pip to conform to PEP 592. + "is_yanked": ireq.link.is_yanked if ireq.link else False, + # requested is true if the requirement was specified by the user (aka + # top level requirement), and false if it was installed as a dependency of a + # requirement. https://peps.python.org/pep-0376/#requested + "requested": ireq.user_supplied, + # PEP 566 json encoding for metadata + # https://www.python.org/dev/peps/pep-0566/#json-compatible-metadata + "metadata": ireq.get_dist().metadata_dict, + } + if ireq.user_supplied and ireq.extras: + # For top level requirements, the list of requested extras, if any. + res["requested_extras"] = sorted(ireq.extras) + return res + + def to_dict(self) -> Dict[str, Any]: + return { + "version": "1", + "pip_version": __version__, + "install": [ + self._install_req_to_dict(ireq) for ireq in self._install_requirements + ], + # https://peps.python.org/pep-0508/#environment-markers + # TODO: currently, the resolver uses the default environment to evaluate + # environment markers, so that is what we report here. In the future, it + # should also take into account options such as --python-version or + # --platform, perhaps under the form of an environment_override field? + # https://github.com/pypa/pip/issues/11198 + "environment": default_environment(), + } diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/models/link.py b/.venv/lib/python3.12/site-packages/pip/_internal/models/link.py new file mode 100644 index 0000000..2f41f2f --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/models/link.py @@ -0,0 +1,590 @@ +import functools +import itertools +import logging +import os +import posixpath +import re +import urllib.parse +from dataclasses import dataclass +from typing import ( + TYPE_CHECKING, + Any, + Dict, + List, + Mapping, + NamedTuple, + Optional, + Tuple, + Union, +) + +from pip._internal.utils.deprecation import deprecated +from pip._internal.utils.filetypes import WHEEL_EXTENSION +from pip._internal.utils.hashes import Hashes +from pip._internal.utils.misc import ( + pairwise, + redact_auth_from_url, + split_auth_from_netloc, + splitext, +) +from pip._internal.utils.urls import path_to_url, url_to_path + +if TYPE_CHECKING: + from pip._internal.index.collector import IndexContent + +logger = logging.getLogger(__name__) + + +# Order matters, earlier hashes have a precedence over later hashes for what +# we will pick to use. +_SUPPORTED_HASHES = ("sha512", "sha384", "sha256", "sha224", "sha1", "md5") + + +@dataclass(frozen=True) +class LinkHash: + """Links to content may have embedded hash values. This class parses those. + + `name` must be any member of `_SUPPORTED_HASHES`. + + This class can be converted to and from `ArchiveInfo`. While ArchiveInfo intends to + be JSON-serializable to conform to PEP 610, this class contains the logic for + parsing a hash name and value for correctness, and then checking whether that hash + conforms to a schema with `.is_hash_allowed()`.""" + + name: str + value: str + + _hash_url_fragment_re = re.compile( + # NB: we do not validate that the second group (.*) is a valid hex + # digest. Instead, we simply keep that string in this class, and then check it + # against Hashes when hash-checking is needed. This is easier to debug than + # proactively discarding an invalid hex digest, as we handle incorrect hashes + # and malformed hashes in the same place. + r"[#&]({choices})=([^&]*)".format( + choices="|".join(re.escape(hash_name) for hash_name in _SUPPORTED_HASHES) + ), + ) + + def __post_init__(self) -> None: + assert self.name in _SUPPORTED_HASHES + + @classmethod + @functools.lru_cache(maxsize=None) + def find_hash_url_fragment(cls, url: str) -> Optional["LinkHash"]: + """Search a string for a checksum algorithm name and encoded output value.""" + match = cls._hash_url_fragment_re.search(url) + if match is None: + return None + name, value = match.groups() + return cls(name=name, value=value) + + def as_dict(self) -> Dict[str, str]: + return {self.name: self.value} + + def as_hashes(self) -> Hashes: + """Return a Hashes instance which checks only for the current hash.""" + return Hashes({self.name: [self.value]}) + + def is_hash_allowed(self, hashes: Optional[Hashes]) -> bool: + """ + Return True if the current hash is allowed by `hashes`. + """ + if hashes is None: + return False + return hashes.is_hash_allowed(self.name, hex_digest=self.value) + + +@dataclass(frozen=True) +class MetadataFile: + """Information about a core metadata file associated with a distribution.""" + + hashes: Optional[Dict[str, str]] + + def __post_init__(self) -> None: + if self.hashes is not None: + assert all(name in _SUPPORTED_HASHES for name in self.hashes) + + +def supported_hashes(hashes: Optional[Dict[str, str]]) -> Optional[Dict[str, str]]: + # Remove any unsupported hash types from the mapping. If this leaves no + # supported hashes, return None + if hashes is None: + return None + hashes = {n: v for n, v in hashes.items() if n in _SUPPORTED_HASHES} + if not hashes: + return None + return hashes + + +def _clean_url_path_part(part: str) -> str: + """ + Clean a "part" of a URL path (i.e. after splitting on "@" characters). + """ + # We unquote prior to quoting to make sure nothing is double quoted. + return urllib.parse.quote(urllib.parse.unquote(part)) + + +def _clean_file_url_path(part: str) -> str: + """ + Clean the first part of a URL path that corresponds to a local + filesystem path (i.e. the first part after splitting on "@" characters). + """ + # We unquote prior to quoting to make sure nothing is double quoted. + # Also, on Windows the path part might contain a drive letter which + # should not be quoted. On Linux where drive letters do not + # exist, the colon should be quoted. We rely on urllib.request + # to do the right thing here. + return urllib.request.pathname2url(urllib.request.url2pathname(part)) + + +# percent-encoded: / +_reserved_chars_re = re.compile("(@|%2F)", re.IGNORECASE) + + +def _clean_url_path(path: str, is_local_path: bool) -> str: + """ + Clean the path portion of a URL. + """ + if is_local_path: + clean_func = _clean_file_url_path + else: + clean_func = _clean_url_path_part + + # Split on the reserved characters prior to cleaning so that + # revision strings in VCS URLs are properly preserved. + parts = _reserved_chars_re.split(path) + + cleaned_parts = [] + for to_clean, reserved in pairwise(itertools.chain(parts, [""])): + cleaned_parts.append(clean_func(to_clean)) + # Normalize %xx escapes (e.g. %2f -> %2F) + cleaned_parts.append(reserved.upper()) + + return "".join(cleaned_parts) + + +def _ensure_quoted_url(url: str) -> str: + """ + Make sure a link is fully quoted. + For example, if ' ' occurs in the URL, it will be replaced with "%20", + and without double-quoting other characters. + """ + # Split the URL into parts according to the general structure + # `scheme://netloc/path;parameters?query#fragment`. + result = urllib.parse.urlparse(url) + # If the netloc is empty, then the URL refers to a local filesystem path. + is_local_path = not result.netloc + path = _clean_url_path(result.path, is_local_path=is_local_path) + return urllib.parse.urlunparse(result._replace(path=path)) + + +@functools.total_ordering +class Link: + """Represents a parsed link from a Package Index's simple URL""" + + __slots__ = [ + "_parsed_url", + "_url", + "_hashes", + "comes_from", + "requires_python", + "yanked_reason", + "metadata_file_data", + "cache_link_parsing", + "egg_fragment", + ] + + def __init__( + self, + url: str, + comes_from: Optional[Union[str, "IndexContent"]] = None, + requires_python: Optional[str] = None, + yanked_reason: Optional[str] = None, + metadata_file_data: Optional[MetadataFile] = None, + cache_link_parsing: bool = True, + hashes: Optional[Mapping[str, str]] = None, + ) -> None: + """ + :param url: url of the resource pointed to (href of the link) + :param comes_from: instance of IndexContent where the link was found, + or string. + :param requires_python: String containing the `Requires-Python` + metadata field, specified in PEP 345. This may be specified by + a data-requires-python attribute in the HTML link tag, as + described in PEP 503. + :param yanked_reason: the reason the file has been yanked, if the + file has been yanked, or None if the file hasn't been yanked. + This is the value of the "data-yanked" attribute, if present, in + a simple repository HTML link. If the file has been yanked but + no reason was provided, this should be the empty string. See + PEP 592 for more information and the specification. + :param metadata_file_data: the metadata attached to the file, or None if + no such metadata is provided. This argument, if not None, indicates + that a separate metadata file exists, and also optionally supplies + hashes for that file. + :param cache_link_parsing: A flag that is used elsewhere to determine + whether resources retrieved from this link should be cached. PyPI + URLs should generally have this set to False, for example. + :param hashes: A mapping of hash names to digests to allow us to + determine the validity of a download. + """ + + # The comes_from, requires_python, and metadata_file_data arguments are + # only used by classmethods of this class, and are not used in client + # code directly. + + # url can be a UNC windows share + if url.startswith("\\\\"): + url = path_to_url(url) + + self._parsed_url = urllib.parse.urlsplit(url) + # Store the url as a private attribute to prevent accidentally + # trying to set a new value. + self._url = url + + link_hash = LinkHash.find_hash_url_fragment(url) + hashes_from_link = {} if link_hash is None else link_hash.as_dict() + if hashes is None: + self._hashes = hashes_from_link + else: + self._hashes = {**hashes, **hashes_from_link} + + self.comes_from = comes_from + self.requires_python = requires_python if requires_python else None + self.yanked_reason = yanked_reason + self.metadata_file_data = metadata_file_data + + self.cache_link_parsing = cache_link_parsing + self.egg_fragment = self._egg_fragment() + + @classmethod + def from_json( + cls, + file_data: Dict[str, Any], + page_url: str, + ) -> Optional["Link"]: + """ + Convert an pypi json document from a simple repository page into a Link. + """ + file_url = file_data.get("url") + if file_url is None: + return None + + url = _ensure_quoted_url(urllib.parse.urljoin(page_url, file_url)) + pyrequire = file_data.get("requires-python") + yanked_reason = file_data.get("yanked") + hashes = file_data.get("hashes", {}) + + # PEP 714: Indexes must use the name core-metadata, but + # clients should support the old name as a fallback for compatibility. + metadata_info = file_data.get("core-metadata") + if metadata_info is None: + metadata_info = file_data.get("dist-info-metadata") + + # The metadata info value may be a boolean, or a dict of hashes. + if isinstance(metadata_info, dict): + # The file exists, and hashes have been supplied + metadata_file_data = MetadataFile(supported_hashes(metadata_info)) + elif metadata_info: + # The file exists, but there are no hashes + metadata_file_data = MetadataFile(None) + else: + # False or not present: the file does not exist + metadata_file_data = None + + # The Link.yanked_reason expects an empty string instead of a boolean. + if yanked_reason and not isinstance(yanked_reason, str): + yanked_reason = "" + # The Link.yanked_reason expects None instead of False. + elif not yanked_reason: + yanked_reason = None + + return cls( + url, + comes_from=page_url, + requires_python=pyrequire, + yanked_reason=yanked_reason, + hashes=hashes, + metadata_file_data=metadata_file_data, + ) + + @classmethod + def from_element( + cls, + anchor_attribs: Dict[str, Optional[str]], + page_url: str, + base_url: str, + ) -> Optional["Link"]: + """ + Convert an anchor element's attributes in a simple repository page to a Link. + """ + href = anchor_attribs.get("href") + if not href: + return None + + url = _ensure_quoted_url(urllib.parse.urljoin(base_url, href)) + pyrequire = anchor_attribs.get("data-requires-python") + yanked_reason = anchor_attribs.get("data-yanked") + + # PEP 714: Indexes must use the name data-core-metadata, but + # clients should support the old name as a fallback for compatibility. + metadata_info = anchor_attribs.get("data-core-metadata") + if metadata_info is None: + metadata_info = anchor_attribs.get("data-dist-info-metadata") + # The metadata info value may be the string "true", or a string of + # the form "hashname=hashval" + if metadata_info == "true": + # The file exists, but there are no hashes + metadata_file_data = MetadataFile(None) + elif metadata_info is None: + # The file does not exist + metadata_file_data = None + else: + # The file exists, and hashes have been supplied + hashname, sep, hashval = metadata_info.partition("=") + if sep == "=": + metadata_file_data = MetadataFile(supported_hashes({hashname: hashval})) + else: + # Error - data is wrong. Treat as no hashes supplied. + logger.debug( + "Index returned invalid data-dist-info-metadata value: %s", + metadata_info, + ) + metadata_file_data = MetadataFile(None) + + return cls( + url, + comes_from=page_url, + requires_python=pyrequire, + yanked_reason=yanked_reason, + metadata_file_data=metadata_file_data, + ) + + def __str__(self) -> str: + if self.requires_python: + rp = f" (requires-python:{self.requires_python})" + else: + rp = "" + if self.comes_from: + return f"{redact_auth_from_url(self._url)} (from {self.comes_from}){rp}" + else: + return redact_auth_from_url(str(self._url)) + + def __repr__(self) -> str: + return f"" + + def __hash__(self) -> int: + return hash(self.url) + + def __eq__(self, other: Any) -> bool: + if not isinstance(other, Link): + return NotImplemented + return self.url == other.url + + def __lt__(self, other: Any) -> bool: + if not isinstance(other, Link): + return NotImplemented + return self.url < other.url + + @property + def url(self) -> str: + return self._url + + @property + def filename(self) -> str: + path = self.path.rstrip("/") + name = posixpath.basename(path) + if not name: + # Make sure we don't leak auth information if the netloc + # includes a username and password. + netloc, user_pass = split_auth_from_netloc(self.netloc) + return netloc + + name = urllib.parse.unquote(name) + assert name, f"URL {self._url!r} produced no filename" + return name + + @property + def file_path(self) -> str: + return url_to_path(self.url) + + @property + def scheme(self) -> str: + return self._parsed_url.scheme + + @property + def netloc(self) -> str: + """ + This can contain auth information. + """ + return self._parsed_url.netloc + + @property + def path(self) -> str: + return urllib.parse.unquote(self._parsed_url.path) + + def splitext(self) -> Tuple[str, str]: + return splitext(posixpath.basename(self.path.rstrip("/"))) + + @property + def ext(self) -> str: + return self.splitext()[1] + + @property + def url_without_fragment(self) -> str: + scheme, netloc, path, query, fragment = self._parsed_url + return urllib.parse.urlunsplit((scheme, netloc, path, query, "")) + + _egg_fragment_re = re.compile(r"[#&]egg=([^&]*)") + + # Per PEP 508. + _project_name_re = re.compile( + r"^([A-Z0-9]|[A-Z0-9][A-Z0-9._-]*[A-Z0-9])$", re.IGNORECASE + ) + + def _egg_fragment(self) -> Optional[str]: + match = self._egg_fragment_re.search(self._url) + if not match: + return None + + # An egg fragment looks like a PEP 508 project name, along with + # an optional extras specifier. Anything else is invalid. + project_name = match.group(1) + if not self._project_name_re.match(project_name): + deprecated( + reason=f"{self} contains an egg fragment with a non-PEP 508 name", + replacement="to use the req @ url syntax, and remove the egg fragment", + gone_in="25.0", + issue=11617, + ) + + return project_name + + _subdirectory_fragment_re = re.compile(r"[#&]subdirectory=([^&]*)") + + @property + def subdirectory_fragment(self) -> Optional[str]: + match = self._subdirectory_fragment_re.search(self._url) + if not match: + return None + return match.group(1) + + def metadata_link(self) -> Optional["Link"]: + """Return a link to the associated core metadata file (if any).""" + if self.metadata_file_data is None: + return None + metadata_url = f"{self.url_without_fragment}.metadata" + if self.metadata_file_data.hashes is None: + return Link(metadata_url) + return Link(metadata_url, hashes=self.metadata_file_data.hashes) + + def as_hashes(self) -> Hashes: + return Hashes({k: [v] for k, v in self._hashes.items()}) + + @property + def hash(self) -> Optional[str]: + return next(iter(self._hashes.values()), None) + + @property + def hash_name(self) -> Optional[str]: + return next(iter(self._hashes), None) + + @property + def show_url(self) -> str: + return posixpath.basename(self._url.split("#", 1)[0].split("?", 1)[0]) + + @property + def is_file(self) -> bool: + return self.scheme == "file" + + def is_existing_dir(self) -> bool: + return self.is_file and os.path.isdir(self.file_path) + + @property + def is_wheel(self) -> bool: + return self.ext == WHEEL_EXTENSION + + @property + def is_vcs(self) -> bool: + from pip._internal.vcs import vcs + + return self.scheme in vcs.all_schemes + + @property + def is_yanked(self) -> bool: + return self.yanked_reason is not None + + @property + def has_hash(self) -> bool: + return bool(self._hashes) + + def is_hash_allowed(self, hashes: Optional[Hashes]) -> bool: + """ + Return True if the link has a hash and it is allowed by `hashes`. + """ + if hashes is None: + return False + return any(hashes.is_hash_allowed(k, v) for k, v in self._hashes.items()) + + +class _CleanResult(NamedTuple): + """Convert link for equivalency check. + + This is used in the resolver to check whether two URL-specified requirements + likely point to the same distribution and can be considered equivalent. This + equivalency logic avoids comparing URLs literally, which can be too strict + (e.g. "a=1&b=2" vs "b=2&a=1") and produce conflicts unexpecting to users. + + Currently this does three things: + + 1. Drop the basic auth part. This is technically wrong since a server can + serve different content based on auth, but if it does that, it is even + impossible to guarantee two URLs without auth are equivalent, since + the user can input different auth information when prompted. So the + practical solution is to assume the auth doesn't affect the response. + 2. Parse the query to avoid the ordering issue. Note that ordering under the + same key in the query are NOT cleaned; i.e. "a=1&a=2" and "a=2&a=1" are + still considered different. + 3. Explicitly drop most of the fragment part, except ``subdirectory=`` and + hash values, since it should have no impact the downloaded content. Note + that this drops the "egg=" part historically used to denote the requested + project (and extras), which is wrong in the strictest sense, but too many + people are supplying it inconsistently to cause superfluous resolution + conflicts, so we choose to also ignore them. + """ + + parsed: urllib.parse.SplitResult + query: Dict[str, List[str]] + subdirectory: str + hashes: Dict[str, str] + + +def _clean_link(link: Link) -> _CleanResult: + parsed = link._parsed_url + netloc = parsed.netloc.rsplit("@", 1)[-1] + # According to RFC 8089, an empty host in file: means localhost. + if parsed.scheme == "file" and not netloc: + netloc = "localhost" + fragment = urllib.parse.parse_qs(parsed.fragment) + if "egg" in fragment: + logger.debug("Ignoring egg= fragment in %s", link) + try: + # If there are multiple subdirectory values, use the first one. + # This matches the behavior of Link.subdirectory_fragment. + subdirectory = fragment["subdirectory"][0] + except (IndexError, KeyError): + subdirectory = "" + # If there are multiple hash values under the same algorithm, use the + # first one. This matches the behavior of Link.hash_value. + hashes = {k: fragment[k][0] for k in _SUPPORTED_HASHES if k in fragment} + return _CleanResult( + parsed=parsed._replace(netloc=netloc, query="", fragment=""), + query=urllib.parse.parse_qs(parsed.query), + subdirectory=subdirectory, + hashes=hashes, + ) + + +@functools.lru_cache(maxsize=None) +def links_equivalent(link1: Link, link2: Link) -> bool: + return _clean_link(link1) == _clean_link(link2) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/models/scheme.py b/.venv/lib/python3.12/site-packages/pip/_internal/models/scheme.py new file mode 100644 index 0000000..06a9a55 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/models/scheme.py @@ -0,0 +1,25 @@ +""" +For types associated with installation schemes. + +For a general overview of available schemes and their context, see +https://docs.python.org/3/install/index.html#alternate-installation. +""" + +from dataclasses import dataclass + +SCHEME_KEYS = ["platlib", "purelib", "headers", "scripts", "data"] + + +@dataclass(frozen=True) +class Scheme: + """A Scheme holds paths which are used as the base directories for + artifacts associated with a Python package. + """ + + __slots__ = SCHEME_KEYS + + platlib: str + purelib: str + headers: str + scripts: str + data: str diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/models/search_scope.py b/.venv/lib/python3.12/site-packages/pip/_internal/models/search_scope.py new file mode 100644 index 0000000..ee7bc86 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/models/search_scope.py @@ -0,0 +1,127 @@ +import itertools +import logging +import os +import posixpath +import urllib.parse +from dataclasses import dataclass +from typing import List + +from pip._vendor.packaging.utils import canonicalize_name + +from pip._internal.models.index import PyPI +from pip._internal.utils.compat import has_tls +from pip._internal.utils.misc import normalize_path, redact_auth_from_url + +logger = logging.getLogger(__name__) + + +@dataclass(frozen=True) +class SearchScope: + """ + Encapsulates the locations that pip is configured to search. + """ + + __slots__ = ["find_links", "index_urls", "no_index"] + + find_links: List[str] + index_urls: List[str] + no_index: bool + + @classmethod + def create( + cls, + find_links: List[str], + index_urls: List[str], + no_index: bool, + ) -> "SearchScope": + """ + Create a SearchScope object after normalizing the `find_links`. + """ + # Build find_links. If an argument starts with ~, it may be + # a local file relative to a home directory. So try normalizing + # it and if it exists, use the normalized version. + # This is deliberately conservative - it might be fine just to + # blindly normalize anything starting with a ~... + built_find_links: List[str] = [] + for link in find_links: + if link.startswith("~"): + new_link = normalize_path(link) + if os.path.exists(new_link): + link = new_link + built_find_links.append(link) + + # If we don't have TLS enabled, then WARN if anyplace we're looking + # relies on TLS. + if not has_tls(): + for link in itertools.chain(index_urls, built_find_links): + parsed = urllib.parse.urlparse(link) + if parsed.scheme == "https": + logger.warning( + "pip is configured with locations that require " + "TLS/SSL, however the ssl module in Python is not " + "available." + ) + break + + return cls( + find_links=built_find_links, + index_urls=index_urls, + no_index=no_index, + ) + + def get_formatted_locations(self) -> str: + lines = [] + redacted_index_urls = [] + if self.index_urls and self.index_urls != [PyPI.simple_url]: + for url in self.index_urls: + redacted_index_url = redact_auth_from_url(url) + + # Parse the URL + purl = urllib.parse.urlsplit(redacted_index_url) + + # URL is generally invalid if scheme and netloc is missing + # there are issues with Python and URL parsing, so this test + # is a bit crude. See bpo-20271, bpo-23505. Python doesn't + # always parse invalid URLs correctly - it should raise + # exceptions for malformed URLs + if not purl.scheme and not purl.netloc: + logger.warning( + 'The index url "%s" seems invalid, please provide a scheme.', + redacted_index_url, + ) + + redacted_index_urls.append(redacted_index_url) + + lines.append( + "Looking in indexes: {}".format(", ".join(redacted_index_urls)) + ) + + if self.find_links: + lines.append( + "Looking in links: {}".format( + ", ".join(redact_auth_from_url(url) for url in self.find_links) + ) + ) + return "\n".join(lines) + + def get_index_urls_locations(self, project_name: str) -> List[str]: + """Returns the locations found via self.index_urls + + Checks the url_name on the main (first in the list) index and + use this url_name to produce all locations + """ + + def mkurl_pypi_url(url: str) -> str: + loc = posixpath.join( + url, urllib.parse.quote(canonicalize_name(project_name)) + ) + # For maximum compatibility with easy_install, ensure the path + # ends in a trailing slash. Although this isn't in the spec + # (and PyPI can handle it without the slash) some other index + # implementations might break if they relied on easy_install's + # behavior. + if not loc.endswith("/"): + loc = loc + "/" + return loc + + return [mkurl_pypi_url(url) for url in self.index_urls] diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/models/selection_prefs.py b/.venv/lib/python3.12/site-packages/pip/_internal/models/selection_prefs.py new file mode 100644 index 0000000..e9b50aa --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/models/selection_prefs.py @@ -0,0 +1,53 @@ +from typing import Optional + +from pip._internal.models.format_control import FormatControl + + +# TODO: This needs Python 3.10's improved slots support for dataclasses +# to be converted into a dataclass. +class SelectionPreferences: + """ + Encapsulates the candidate selection preferences for downloading + and installing files. + """ + + __slots__ = [ + "allow_yanked", + "allow_all_prereleases", + "format_control", + "prefer_binary", + "ignore_requires_python", + ] + + # Don't include an allow_yanked default value to make sure each call + # site considers whether yanked releases are allowed. This also causes + # that decision to be made explicit in the calling code, which helps + # people when reading the code. + def __init__( + self, + allow_yanked: bool, + allow_all_prereleases: bool = False, + format_control: Optional[FormatControl] = None, + prefer_binary: bool = False, + ignore_requires_python: Optional[bool] = None, + ) -> None: + """Create a SelectionPreferences object. + + :param allow_yanked: Whether files marked as yanked (in the sense + of PEP 592) are permitted to be candidates for install. + :param format_control: A FormatControl object or None. Used to control + the selection of source packages / binary packages when consulting + the index and links. + :param prefer_binary: Whether to prefer an old, but valid, binary + dist over a new source dist. + :param ignore_requires_python: Whether to ignore incompatible + "Requires-Python" values in links. Defaults to False. + """ + if ignore_requires_python is None: + ignore_requires_python = False + + self.allow_yanked = allow_yanked + self.allow_all_prereleases = allow_all_prereleases + self.format_control = format_control + self.prefer_binary = prefer_binary + self.ignore_requires_python = ignore_requires_python diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/models/target_python.py b/.venv/lib/python3.12/site-packages/pip/_internal/models/target_python.py new file mode 100644 index 0000000..88925a9 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/models/target_python.py @@ -0,0 +1,121 @@ +import sys +from typing import List, Optional, Set, Tuple + +from pip._vendor.packaging.tags import Tag + +from pip._internal.utils.compatibility_tags import get_supported, version_info_to_nodot +from pip._internal.utils.misc import normalize_version_info + + +class TargetPython: + """ + Encapsulates the properties of a Python interpreter one is targeting + for a package install, download, etc. + """ + + __slots__ = [ + "_given_py_version_info", + "abis", + "implementation", + "platforms", + "py_version", + "py_version_info", + "_valid_tags", + "_valid_tags_set", + ] + + def __init__( + self, + platforms: Optional[List[str]] = None, + py_version_info: Optional[Tuple[int, ...]] = None, + abis: Optional[List[str]] = None, + implementation: Optional[str] = None, + ) -> None: + """ + :param platforms: A list of strings or None. If None, searches for + packages that are supported by the current system. Otherwise, will + find packages that can be built on the platforms passed in. These + packages will only be downloaded for distribution: they will + not be built locally. + :param py_version_info: An optional tuple of ints representing the + Python version information to use (e.g. `sys.version_info[:3]`). + This can have length 1, 2, or 3 when provided. + :param abis: A list of strings or None. This is passed to + compatibility_tags.py's get_supported() function as is. + :param implementation: A string or None. This is passed to + compatibility_tags.py's get_supported() function as is. + """ + # Store the given py_version_info for when we call get_supported(). + self._given_py_version_info = py_version_info + + if py_version_info is None: + py_version_info = sys.version_info[:3] + else: + py_version_info = normalize_version_info(py_version_info) + + py_version = ".".join(map(str, py_version_info[:2])) + + self.abis = abis + self.implementation = implementation + self.platforms = platforms + self.py_version = py_version + self.py_version_info = py_version_info + + # This is used to cache the return value of get_(un)sorted_tags. + self._valid_tags: Optional[List[Tag]] = None + self._valid_tags_set: Optional[Set[Tag]] = None + + def format_given(self) -> str: + """ + Format the given, non-None attributes for display. + """ + display_version = None + if self._given_py_version_info is not None: + display_version = ".".join( + str(part) for part in self._given_py_version_info + ) + + key_values = [ + ("platforms", self.platforms), + ("version_info", display_version), + ("abis", self.abis), + ("implementation", self.implementation), + ] + return " ".join( + f"{key}={value!r}" for key, value in key_values if value is not None + ) + + def get_sorted_tags(self) -> List[Tag]: + """ + Return the supported PEP 425 tags to check wheel candidates against. + + The tags are returned in order of preference (most preferred first). + """ + if self._valid_tags is None: + # Pass versions=None if no py_version_info was given since + # versions=None uses special default logic. + py_version_info = self._given_py_version_info + if py_version_info is None: + version = None + else: + version = version_info_to_nodot(py_version_info) + + tags = get_supported( + version=version, + platforms=self.platforms, + abis=self.abis, + impl=self.implementation, + ) + self._valid_tags = tags + + return self._valid_tags + + def get_unsorted_tags(self) -> Set[Tag]: + """Exactly the same as get_sorted_tags, but returns a set. + + This is important for performance. + """ + if self._valid_tags_set is None: + self._valid_tags_set = set(self.get_sorted_tags()) + + return self._valid_tags_set diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/models/wheel.py b/.venv/lib/python3.12/site-packages/pip/_internal/models/wheel.py new file mode 100644 index 0000000..36d4d2e --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/models/wheel.py @@ -0,0 +1,93 @@ +"""Represents a wheel file and provides access to the various parts of the +name that have meaning. +""" + +import re +from typing import Dict, Iterable, List + +from pip._vendor.packaging.tags import Tag + +from pip._internal.exceptions import InvalidWheelFilename + + +class Wheel: + """A wheel file""" + + wheel_file_re = re.compile( + r"""^(?P(?P[^\s-]+?)-(?P[^\s-]*?)) + ((-(?P\d[^-]*?))?-(?P[^\s-]+?)-(?P[^\s-]+?)-(?P[^\s-]+?) + \.whl|\.dist-info)$""", + re.VERBOSE, + ) + + def __init__(self, filename: str) -> None: + """ + :raises InvalidWheelFilename: when the filename is invalid for a wheel + """ + wheel_info = self.wheel_file_re.match(filename) + if not wheel_info: + raise InvalidWheelFilename(f"{filename} is not a valid wheel filename.") + self.filename = filename + self.name = wheel_info.group("name").replace("_", "-") + # we'll assume "_" means "-" due to wheel naming scheme + # (https://github.com/pypa/pip/issues/1150) + self.version = wheel_info.group("ver").replace("_", "-") + self.build_tag = wheel_info.group("build") + self.pyversions = wheel_info.group("pyver").split(".") + self.abis = wheel_info.group("abi").split(".") + self.plats = wheel_info.group("plat").split(".") + + # All the tag combinations from this file + self.file_tags = { + Tag(x, y, z) for x in self.pyversions for y in self.abis for z in self.plats + } + + def get_formatted_file_tags(self) -> List[str]: + """Return the wheel's tags as a sorted list of strings.""" + return sorted(str(tag) for tag in self.file_tags) + + def support_index_min(self, tags: List[Tag]) -> int: + """Return the lowest index that one of the wheel's file_tag combinations + achieves in the given list of supported tags. + + For example, if there are 8 supported tags and one of the file tags + is first in the list, then return 0. + + :param tags: the PEP 425 tags to check the wheel against, in order + with most preferred first. + + :raises ValueError: If none of the wheel's file tags match one of + the supported tags. + """ + try: + return next(i for i, t in enumerate(tags) if t in self.file_tags) + except StopIteration: + raise ValueError() + + def find_most_preferred_tag( + self, tags: List[Tag], tag_to_priority: Dict[Tag, int] + ) -> int: + """Return the priority of the most preferred tag that one of the wheel's file + tag combinations achieves in the given list of supported tags using the given + tag_to_priority mapping, where lower priorities are more-preferred. + + This is used in place of support_index_min in some cases in order to avoid + an expensive linear scan of a large list of tags. + + :param tags: the PEP 425 tags to check the wheel against. + :param tag_to_priority: a mapping from tag to priority of that tag, where + lower is more preferred. + + :raises ValueError: If none of the wheel's file tags match one of + the supported tags. + """ + return min( + tag_to_priority[tag] for tag in self.file_tags if tag in tag_to_priority + ) + + def supported(self, tags: Iterable[Tag]) -> bool: + """Return whether the wheel is compatible with one of the given tags. + + :param tags: the PEP 425 tags to check the wheel against. + """ + return not self.file_tags.isdisjoint(tags) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/network/__init__.py b/.venv/lib/python3.12/site-packages/pip/_internal/network/__init__.py new file mode 100644 index 0000000..b51bde9 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/network/__init__.py @@ -0,0 +1,2 @@ +"""Contains purely network-related utilities. +""" diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..44472d6007cd0f68c786e04b75f7824ab710c1ea GIT binary patch literal 252 zcmXw!F-`+95Jl|}g(y<)ux*60BSMSPqy~wW#xnN6j^fysJ-cYR2xmYXg&WZ30zkS{ zc%|ew^WQJ#>wnGXGg0*W@cFzdcR#>c@?;LvV%~)nkD`~0(c9G~c-G`|72AZauRQW= zNZVxr&1kEZ$q^IgdUn5%-gyF`Vq8XTw)zD#M2euuGbXPcoVr1kh*+sQ_Q&b%F4)%LI!#L7Fe48ue=eky LefHN4ldq5J% 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 RnO79WSjl96!>A#b^IxJn*K+^> literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/download.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/download.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d95e5e060bd58d157ad58e7f19004725e4671984 GIT binary patch literal 8506 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 Wb@=TqR`IxF+Q#=hg73#0MDTw>d!;-8 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/session.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/session.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..6ca1ce5c4e17051abdea70a20b3a29728051de91 GIT binary patch literal 18880 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 E7wcxDSO5S3 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/utils.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/network/__pycache__/utils.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..284d402d6329c05d757cee4de1113316a3e8542a GIT binary patch literal 2258 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 HLfrogV%6CD literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/network/auth.py b/.venv/lib/python3.12/site-packages/pip/_internal/network/auth.py new file mode 100644 index 0000000..1a2606e --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/network/auth.py @@ -0,0 +1,566 @@ +"""Network Authentication Helpers + +Contains interface (MultiDomainBasicAuth) and associated glue code for +providing credentials in the context of network requests. +""" + +import logging +import os +import shutil +import subprocess +import sysconfig +import typing +import urllib.parse +from abc import ABC, abstractmethod +from functools import lru_cache +from os.path import commonprefix +from pathlib import Path +from typing import Any, Dict, List, NamedTuple, Optional, Tuple + +from pip._vendor.requests.auth import AuthBase, HTTPBasicAuth +from pip._vendor.requests.models import Request, Response +from pip._vendor.requests.utils import get_netrc_auth + +from pip._internal.utils.logging import getLogger +from pip._internal.utils.misc import ( + ask, + ask_input, + ask_password, + remove_auth_from_url, + split_auth_netloc_from_url, +) +from pip._internal.vcs.versioncontrol import AuthInfo + +logger = getLogger(__name__) + +KEYRING_DISABLED = False + + +class Credentials(NamedTuple): + url: str + username: str + password: str + + +class KeyRingBaseProvider(ABC): + """Keyring base provider interface""" + + has_keyring: bool + + @abstractmethod + def get_auth_info( + self, url: str, username: Optional[str] + ) -> Optional[AuthInfo]: ... + + @abstractmethod + def save_auth_info(self, url: str, username: str, password: str) -> None: ... + + +class KeyRingNullProvider(KeyRingBaseProvider): + """Keyring null provider""" + + has_keyring = False + + def get_auth_info(self, url: str, username: Optional[str]) -> Optional[AuthInfo]: + return None + + def save_auth_info(self, url: str, username: str, password: str) -> None: + return None + + +class KeyRingPythonProvider(KeyRingBaseProvider): + """Keyring interface which uses locally imported `keyring`""" + + has_keyring = True + + def __init__(self) -> None: + import keyring + + self.keyring = keyring + + def get_auth_info(self, url: str, username: Optional[str]) -> Optional[AuthInfo]: + # Support keyring's get_credential interface which supports getting + # credentials without a username. This is only available for + # keyring>=15.2.0. + if hasattr(self.keyring, "get_credential"): + logger.debug("Getting credentials from keyring for %s", url) + cred = self.keyring.get_credential(url, username) + if cred is not None: + return cred.username, cred.password + return None + + if username is not None: + logger.debug("Getting password from keyring for %s", url) + password = self.keyring.get_password(url, username) + if password: + return username, password + return None + + def save_auth_info(self, url: str, username: str, password: str) -> None: + self.keyring.set_password(url, username, password) + + +class KeyRingCliProvider(KeyRingBaseProvider): + """Provider which uses `keyring` cli + + Instead of calling the keyring package installed alongside pip + we call keyring on the command line which will enable pip to + use which ever installation of keyring is available first in + PATH. + """ + + has_keyring = True + + def __init__(self, cmd: str) -> None: + self.keyring = cmd + + def get_auth_info(self, url: str, username: Optional[str]) -> Optional[AuthInfo]: + # This is the default implementation of keyring.get_credential + # https://github.com/jaraco/keyring/blob/97689324abcf01bd1793d49063e7ca01e03d7d07/keyring/backend.py#L134-L139 + if username is not None: + password = self._get_password(url, username) + if password is not None: + return username, password + return None + + def save_auth_info(self, url: str, username: str, password: str) -> None: + return self._set_password(url, username, password) + + def _get_password(self, service_name: str, username: str) -> Optional[str]: + """Mirror the implementation of keyring.get_password using cli""" + if self.keyring is None: + return None + + cmd = [self.keyring, "get", service_name, username] + env = os.environ.copy() + env["PYTHONIOENCODING"] = "utf-8" + res = subprocess.run( + cmd, + stdin=subprocess.DEVNULL, + stdout=subprocess.PIPE, + env=env, + ) + if res.returncode: + return None + return res.stdout.decode("utf-8").strip(os.linesep) + + def _set_password(self, service_name: str, username: str, password: str) -> None: + """Mirror the implementation of keyring.set_password using cli""" + if self.keyring is None: + return None + env = os.environ.copy() + env["PYTHONIOENCODING"] = "utf-8" + subprocess.run( + [self.keyring, "set", service_name, username], + input=f"{password}{os.linesep}".encode(), + env=env, + check=True, + ) + return None + + +@lru_cache(maxsize=None) +def get_keyring_provider(provider: str) -> KeyRingBaseProvider: + logger.verbose("Keyring provider requested: %s", provider) + + # keyring has previously failed and been disabled + if KEYRING_DISABLED: + provider = "disabled" + if provider in ["import", "auto"]: + try: + impl = KeyRingPythonProvider() + logger.verbose("Keyring provider set: import") + return impl + except ImportError: + pass + except Exception as exc: + # In the event of an unexpected exception + # we should warn the user + msg = "Installed copy of keyring fails with exception %s" + if provider == "auto": + msg = msg + ", trying to find a keyring executable as a fallback" + logger.warning(msg, exc, exc_info=logger.isEnabledFor(logging.DEBUG)) + if provider in ["subprocess", "auto"]: + cli = shutil.which("keyring") + if cli and cli.startswith(sysconfig.get_path("scripts")): + # all code within this function is stolen from shutil.which implementation + @typing.no_type_check + def PATH_as_shutil_which_determines_it() -> str: + path = os.environ.get("PATH", None) + if path is None: + try: + path = os.confstr("CS_PATH") + except (AttributeError, ValueError): + # os.confstr() or CS_PATH is not available + path = os.defpath + # bpo-35755: Don't use os.defpath if the PATH environment variable is + # set to an empty string + + return path + + scripts = Path(sysconfig.get_path("scripts")) + + paths = [] + for path in PATH_as_shutil_which_determines_it().split(os.pathsep): + p = Path(path) + try: + if not p.samefile(scripts): + paths.append(path) + except FileNotFoundError: + pass + + path = os.pathsep.join(paths) + + cli = shutil.which("keyring", path=path) + + if cli: + logger.verbose("Keyring provider set: subprocess with executable %s", cli) + return KeyRingCliProvider(cli) + + logger.verbose("Keyring provider set: disabled") + return KeyRingNullProvider() + + +class MultiDomainBasicAuth(AuthBase): + def __init__( + self, + prompting: bool = True, + index_urls: Optional[List[str]] = None, + keyring_provider: str = "auto", + ) -> None: + self.prompting = prompting + self.index_urls = index_urls + self.keyring_provider = keyring_provider # type: ignore[assignment] + self.passwords: Dict[str, AuthInfo] = {} + # When the user is prompted to enter credentials and keyring is + # available, we will offer to save them. If the user accepts, + # this value is set to the credentials they entered. After the + # request authenticates, the caller should call + # ``save_credentials`` to save these. + self._credentials_to_save: Optional[Credentials] = None + + @property + def keyring_provider(self) -> KeyRingBaseProvider: + return get_keyring_provider(self._keyring_provider) + + @keyring_provider.setter + def keyring_provider(self, provider: str) -> None: + # The free function get_keyring_provider has been decorated with + # functools.cache. If an exception occurs in get_keyring_auth that + # cache will be cleared and keyring disabled, take that into account + # if you want to remove this indirection. + self._keyring_provider = provider + + @property + def use_keyring(self) -> bool: + # We won't use keyring when --no-input is passed unless + # a specific provider is requested because it might require + # user interaction + return self.prompting or self._keyring_provider not in ["auto", "disabled"] + + def _get_keyring_auth( + self, + url: Optional[str], + username: Optional[str], + ) -> Optional[AuthInfo]: + """Return the tuple auth for a given url from keyring.""" + # Do nothing if no url was provided + if not url: + return None + + try: + return self.keyring_provider.get_auth_info(url, username) + except Exception as exc: + # Log the full exception (with stacktrace) at debug, so it'll only + # show up when running in verbose mode. + logger.debug("Keyring is skipped due to an exception", exc_info=True) + # Always log a shortened version of the exception. + logger.warning( + "Keyring is skipped due to an exception: %s", + str(exc), + ) + global KEYRING_DISABLED + KEYRING_DISABLED = True + get_keyring_provider.cache_clear() + return None + + def _get_index_url(self, url: str) -> Optional[str]: + """Return the original index URL matching the requested URL. + + Cached or dynamically generated credentials may work against + the original index URL rather than just the netloc. + + The provided url should have had its username and password + removed already. If the original index url had credentials then + they will be included in the return value. + + Returns None if no matching index was found, or if --no-index + was specified by the user. + """ + if not url or not self.index_urls: + return None + + url = remove_auth_from_url(url).rstrip("/") + "/" + parsed_url = urllib.parse.urlsplit(url) + + candidates = [] + + for index in self.index_urls: + index = index.rstrip("/") + "/" + parsed_index = urllib.parse.urlsplit(remove_auth_from_url(index)) + if parsed_url == parsed_index: + return index + + if parsed_url.netloc != parsed_index.netloc: + continue + + candidate = urllib.parse.urlsplit(index) + candidates.append(candidate) + + if not candidates: + return None + + candidates.sort( + reverse=True, + key=lambda candidate: commonprefix( + [ + parsed_url.path, + candidate.path, + ] + ).rfind("/"), + ) + + return urllib.parse.urlunsplit(candidates[0]) + + def _get_new_credentials( + self, + original_url: str, + *, + allow_netrc: bool = True, + allow_keyring: bool = False, + ) -> AuthInfo: + """Find and return credentials for the specified URL.""" + # Split the credentials and netloc from the url. + url, netloc, url_user_password = split_auth_netloc_from_url( + original_url, + ) + + # Start with the credentials embedded in the url + username, password = url_user_password + if username is not None and password is not None: + logger.debug("Found credentials in url for %s", netloc) + return url_user_password + + # Find a matching index url for this request + index_url = self._get_index_url(url) + if index_url: + # Split the credentials from the url. + index_info = split_auth_netloc_from_url(index_url) + if index_info: + index_url, _, index_url_user_password = index_info + logger.debug("Found index url %s", index_url) + + # If an index URL was found, try its embedded credentials + if index_url and index_url_user_password[0] is not None: + username, password = index_url_user_password + if username is not None and password is not None: + logger.debug("Found credentials in index url for %s", netloc) + return index_url_user_password + + # Get creds from netrc if we still don't have them + if allow_netrc: + netrc_auth = get_netrc_auth(original_url) + if netrc_auth: + logger.debug("Found credentials in netrc for %s", netloc) + return netrc_auth + + # If we don't have a password and keyring is available, use it. + if allow_keyring: + # The index url is more specific than the netloc, so try it first + # fmt: off + kr_auth = ( + self._get_keyring_auth(index_url, username) or + self._get_keyring_auth(netloc, username) + ) + # fmt: on + if kr_auth: + logger.debug("Found credentials in keyring for %s", netloc) + return kr_auth + + return username, password + + def _get_url_and_credentials( + self, original_url: str + ) -> Tuple[str, Optional[str], Optional[str]]: + """Return the credentials to use for the provided URL. + + If allowed, netrc and keyring may be used to obtain the + correct credentials. + + Returns (url_without_credentials, username, password). Note + that even if the original URL contains credentials, this + function may return a different username and password. + """ + url, netloc, _ = split_auth_netloc_from_url(original_url) + + # Try to get credentials from original url + username, password = self._get_new_credentials(original_url) + + # If credentials not found, use any stored credentials for this netloc. + # Do this if either the username or the password is missing. + # This accounts for the situation in which the user has specified + # the username in the index url, but the password comes from keyring. + if (username is None or password is None) and netloc in self.passwords: + un, pw = self.passwords[netloc] + # It is possible that the cached credentials are for a different username, + # in which case the cache should be ignored. + if username is None or username == un: + username, password = un, pw + + if username is not None or password is not None: + # Convert the username and password if they're None, so that + # this netloc will show up as "cached" in the conditional above. + # Further, HTTPBasicAuth doesn't accept None, so it makes sense to + # cache the value that is going to be used. + username = username or "" + password = password or "" + + # Store any acquired credentials. + self.passwords[netloc] = (username, password) + + assert ( + # Credentials were found + (username is not None and password is not None) + # Credentials were not found + or (username is None and password is None) + ), f"Could not load credentials from url: {original_url}" + + return url, username, password + + def __call__(self, req: Request) -> Request: + # Get credentials for this request + url, username, password = self._get_url_and_credentials(req.url) + + # Set the url of the request to the url without any credentials + req.url = url + + if username is not None and password is not None: + # Send the basic auth with this request + req = HTTPBasicAuth(username, password)(req) + + # Attach a hook to handle 401 responses + req.register_hook("response", self.handle_401) + + return req + + # Factored out to allow for easy patching in tests + def _prompt_for_password( + self, netloc: str + ) -> Tuple[Optional[str], Optional[str], bool]: + username = ask_input(f"User for {netloc}: ") if self.prompting else None + if not username: + return None, None, False + if self.use_keyring: + auth = self._get_keyring_auth(netloc, username) + if auth and auth[0] is not None and auth[1] is not None: + return auth[0], auth[1], False + password = ask_password("Password: ") + return username, password, True + + # Factored out to allow for easy patching in tests + def _should_save_password_to_keyring(self) -> bool: + if ( + not self.prompting + or not self.use_keyring + or not self.keyring_provider.has_keyring + ): + return False + return ask("Save credentials to keyring [y/N]: ", ["y", "n"]) == "y" + + def handle_401(self, resp: Response, **kwargs: Any) -> Response: + # We only care about 401 responses, anything else we want to just + # pass through the actual response + if resp.status_code != 401: + return resp + + username, password = None, None + + # Query the keyring for credentials: + if self.use_keyring: + username, password = self._get_new_credentials( + resp.url, + allow_netrc=False, + allow_keyring=True, + ) + + # We are not able to prompt the user so simply return the response + if not self.prompting and not username and not password: + return resp + + parsed = urllib.parse.urlparse(resp.url) + + # Prompt the user for a new username and password + save = False + if not username and not password: + username, password, save = self._prompt_for_password(parsed.netloc) + + # Store the new username and password to use for future requests + self._credentials_to_save = None + if username is not None and password is not None: + self.passwords[parsed.netloc] = (username, password) + + # Prompt to save the password to keyring + if save and self._should_save_password_to_keyring(): + self._credentials_to_save = Credentials( + url=parsed.netloc, + username=username, + password=password, + ) + + # Consume content and release the original connection to allow our new + # request to reuse the same one. + # The result of the assignment isn't used, it's just needed to consume + # the content. + _ = resp.content + resp.raw.release_conn() + + # Add our new username and password to the request + req = HTTPBasicAuth(username or "", password or "")(resp.request) + req.register_hook("response", self.warn_on_401) + + # On successful request, save the credentials that were used to + # keyring. (Note that if the user responded "no" above, this member + # is not set and nothing will be saved.) + if self._credentials_to_save: + req.register_hook("response", self.save_credentials) + + # Send our new request + new_resp = resp.connection.send(req, **kwargs) + new_resp.history.append(resp) + + return new_resp + + def warn_on_401(self, resp: Response, **kwargs: Any) -> None: + """Response callback to warn about incorrect credentials.""" + if resp.status_code == 401: + logger.warning( + "401 Error, Credentials not correct for %s", + resp.request.url, + ) + + def save_credentials(self, resp: Response, **kwargs: Any) -> None: + """Response callback to save credentials on success.""" + assert ( + self.keyring_provider.has_keyring + ), "should never reach here without keyring" + + creds = self._credentials_to_save + self._credentials_to_save = None + if creds and resp.status_code < 400: + try: + logger.info("Saving credentials to keyring") + self.keyring_provider.save_auth_info( + creds.url, creds.username, creds.password + ) + except Exception: + logger.exception("Failed to save credentials") diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/network/cache.py b/.venv/lib/python3.12/site-packages/pip/_internal/network/cache.py new file mode 100644 index 0000000..4d0fb54 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/network/cache.py @@ -0,0 +1,106 @@ +"""HTTP cache implementation. +""" + +import os +from contextlib import contextmanager +from datetime import datetime +from typing import BinaryIO, Generator, Optional, Union + +from pip._vendor.cachecontrol.cache import SeparateBodyBaseCache +from pip._vendor.cachecontrol.caches import SeparateBodyFileCache +from pip._vendor.requests.models import Response + +from pip._internal.utils.filesystem import adjacent_tmp_file, replace +from pip._internal.utils.misc import ensure_dir + + +def is_from_cache(response: Response) -> bool: + return getattr(response, "from_cache", False) + + +@contextmanager +def suppressed_cache_errors() -> Generator[None, None, None]: + """If we can't access the cache then we can just skip caching and process + requests as if caching wasn't enabled. + """ + try: + yield + except OSError: + pass + + +class SafeFileCache(SeparateBodyBaseCache): + """ + A file based cache which is safe to use even when the target directory may + not be accessible or writable. + + There is a race condition when two processes try to write and/or read the + same entry at the same time, since each entry consists of two separate + files (https://github.com/psf/cachecontrol/issues/324). We therefore have + additional logic that makes sure that both files to be present before + returning an entry; this fixes the read side of the race condition. + + For the write side, we assume that the server will only ever return the + same data for the same URL, which ought to be the case for files pip is + downloading. PyPI does not have a mechanism to swap out a wheel for + another wheel, for example. If this assumption is not true, the + CacheControl issue will need to be fixed. + """ + + def __init__(self, directory: str) -> None: + assert directory is not None, "Cache directory must not be None." + super().__init__() + self.directory = directory + + def _get_cache_path(self, name: str) -> str: + # From cachecontrol.caches.file_cache.FileCache._fn, brought into our + # class for backwards-compatibility and to avoid using a non-public + # method. + hashed = SeparateBodyFileCache.encode(name) + parts = list(hashed[:5]) + [hashed] + return os.path.join(self.directory, *parts) + + def get(self, key: str) -> Optional[bytes]: + # The cache entry is only valid if both metadata and body exist. + metadata_path = self._get_cache_path(key) + body_path = metadata_path + ".body" + if not (os.path.exists(metadata_path) and os.path.exists(body_path)): + return None + with suppressed_cache_errors(): + with open(metadata_path, "rb") as f: + return f.read() + + def _write(self, path: str, data: bytes) -> None: + with suppressed_cache_errors(): + ensure_dir(os.path.dirname(path)) + + with adjacent_tmp_file(path) as f: + f.write(data) + + replace(f.name, path) + + def set( + self, key: str, value: bytes, expires: Union[int, datetime, None] = None + ) -> None: + path = self._get_cache_path(key) + self._write(path, value) + + def delete(self, key: str) -> None: + path = self._get_cache_path(key) + with suppressed_cache_errors(): + os.remove(path) + with suppressed_cache_errors(): + os.remove(path + ".body") + + def get_body(self, key: str) -> Optional[BinaryIO]: + # The cache entry is only valid if both metadata and body exist. + metadata_path = self._get_cache_path(key) + body_path = metadata_path + ".body" + if not (os.path.exists(metadata_path) and os.path.exists(body_path)): + return None + with suppressed_cache_errors(): + return open(body_path, "rb") + + def set_body(self, key: str, body: bytes) -> None: + path = self._get_cache_path(key) + ".body" + self._write(path, body) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/network/download.py b/.venv/lib/python3.12/site-packages/pip/_internal/network/download.py new file mode 100644 index 0000000..5c3bce3 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/network/download.py @@ -0,0 +1,187 @@ +"""Download files with progress indicators. +""" + +import email.message +import logging +import mimetypes +import os +from typing import Iterable, Optional, Tuple + +from pip._vendor.requests.models import Response + +from pip._internal.cli.progress_bars import get_download_progress_renderer +from pip._internal.exceptions import NetworkConnectionError +from pip._internal.models.index import PyPI +from pip._internal.models.link import Link +from pip._internal.network.cache import is_from_cache +from pip._internal.network.session import PipSession +from pip._internal.network.utils import HEADERS, raise_for_status, response_chunks +from pip._internal.utils.misc import format_size, redact_auth_from_url, splitext + +logger = logging.getLogger(__name__) + + +def _get_http_response_size(resp: Response) -> Optional[int]: + try: + return int(resp.headers["content-length"]) + except (ValueError, KeyError, TypeError): + return None + + +def _prepare_download( + resp: Response, + link: Link, + progress_bar: str, +) -> Iterable[bytes]: + total_length = _get_http_response_size(resp) + + if link.netloc == PyPI.file_storage_domain: + url = link.show_url + else: + url = link.url_without_fragment + + logged_url = redact_auth_from_url(url) + + if total_length: + logged_url = f"{logged_url} ({format_size(total_length)})" + + if is_from_cache(resp): + logger.info("Using cached %s", logged_url) + else: + logger.info("Downloading %s", logged_url) + + if logger.getEffectiveLevel() > logging.INFO: + show_progress = False + elif is_from_cache(resp): + show_progress = False + elif not total_length: + show_progress = True + elif total_length > (512 * 1024): + show_progress = True + else: + show_progress = False + + chunks = response_chunks(resp) + + if not show_progress: + return chunks + + renderer = get_download_progress_renderer(bar_type=progress_bar, size=total_length) + return renderer(chunks) + + +def sanitize_content_filename(filename: str) -> str: + """ + Sanitize the "filename" value from a Content-Disposition header. + """ + return os.path.basename(filename) + + +def parse_content_disposition(content_disposition: str, default_filename: str) -> str: + """ + Parse the "filename" value from a Content-Disposition header, and + return the default filename if the result is empty. + """ + m = email.message.Message() + m["content-type"] = content_disposition + filename = m.get_param("filename") + if filename: + # We need to sanitize the filename to prevent directory traversal + # in case the filename contains ".." path parts. + filename = sanitize_content_filename(str(filename)) + return filename or default_filename + + +def _get_http_response_filename(resp: Response, link: Link) -> str: + """Get an ideal filename from the given HTTP response, falling back to + the link filename if not provided. + """ + filename = link.filename # fallback + # Have a look at the Content-Disposition header for a better guess + content_disposition = resp.headers.get("content-disposition") + if content_disposition: + filename = parse_content_disposition(content_disposition, filename) + ext: Optional[str] = splitext(filename)[1] + if not ext: + ext = mimetypes.guess_extension(resp.headers.get("content-type", "")) + if ext: + filename += ext + if not ext and link.url != resp.url: + ext = os.path.splitext(resp.url)[1] + if ext: + filename += ext + return filename + + +def _http_get_download(session: PipSession, link: Link) -> Response: + target_url = link.url.split("#", 1)[0] + resp = session.get(target_url, headers=HEADERS, stream=True) + raise_for_status(resp) + return resp + + +class Downloader: + def __init__( + self, + session: PipSession, + progress_bar: str, + ) -> None: + self._session = session + self._progress_bar = progress_bar + + def __call__(self, link: Link, location: str) -> Tuple[str, str]: + """Download the file given by link into location.""" + try: + resp = _http_get_download(self._session, link) + except NetworkConnectionError as e: + assert e.response is not None + logger.critical( + "HTTP error %s while getting %s", e.response.status_code, link + ) + raise + + filename = _get_http_response_filename(resp, link) + filepath = os.path.join(location, filename) + + chunks = _prepare_download(resp, link, self._progress_bar) + with open(filepath, "wb") as content_file: + for chunk in chunks: + content_file.write(chunk) + content_type = resp.headers.get("Content-Type", "") + return filepath, content_type + + +class BatchDownloader: + def __init__( + self, + session: PipSession, + progress_bar: str, + ) -> None: + self._session = session + self._progress_bar = progress_bar + + def __call__( + self, links: Iterable[Link], location: str + ) -> Iterable[Tuple[Link, Tuple[str, str]]]: + """Download the files given by links into location.""" + for link in links: + try: + resp = _http_get_download(self._session, link) + except NetworkConnectionError as e: + assert e.response is not None + logger.critical( + "HTTP error %s while getting %s", + e.response.status_code, + link, + ) + raise + + filename = _get_http_response_filename(resp, link) + filepath = os.path.join(location, filename) + + chunks = _prepare_download(resp, link, self._progress_bar) + with open(filepath, "wb") as content_file: + for chunk in chunks: + content_file.write(chunk) + content_type = resp.headers.get("Content-Type", "") + yield link, (filepath, content_type) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/network/lazy_wheel.py b/.venv/lib/python3.12/site-packages/pip/_internal/network/lazy_wheel.py new file mode 100644 index 0000000..82ec50d --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/network/lazy_wheel.py @@ -0,0 +1,210 @@ +"""Lazy ZIP over HTTP""" + +__all__ = ["HTTPRangeRequestUnsupported", "dist_from_wheel_url"] + +from bisect import bisect_left, bisect_right +from contextlib import contextmanager +from tempfile import NamedTemporaryFile +from typing import Any, Dict, Generator, List, Optional, Tuple +from zipfile import BadZipFile, ZipFile + +from pip._vendor.packaging.utils import canonicalize_name +from pip._vendor.requests.models import CONTENT_CHUNK_SIZE, Response + +from pip._internal.metadata import BaseDistribution, MemoryWheel, get_wheel_distribution +from pip._internal.network.session import PipSession +from pip._internal.network.utils import HEADERS, raise_for_status, response_chunks + + +class HTTPRangeRequestUnsupported(Exception): + pass + + +def dist_from_wheel_url(name: str, url: str, session: PipSession) -> BaseDistribution: + """Return a distribution object from the given wheel URL. + + This uses HTTP range requests to only fetch the portion of the wheel + containing metadata, just enough for the object to be constructed. + If such requests are not supported, HTTPRangeRequestUnsupported + is raised. + """ + with LazyZipOverHTTP(url, session) as zf: + # For read-only ZIP files, ZipFile only needs methods read, + # seek, seekable and tell, not the whole IO protocol. + wheel = MemoryWheel(zf.name, zf) # type: ignore + # After context manager exit, wheel.name + # is an invalid file by intention. + return get_wheel_distribution(wheel, canonicalize_name(name)) + + +class LazyZipOverHTTP: + """File-like object mapped to a ZIP file over HTTP. + + This uses HTTP range requests to lazily fetch the file's content, + which is supposed to be fed to ZipFile. If such requests are not + supported by the server, raise HTTPRangeRequestUnsupported + during initialization. + """ + + def __init__( + self, url: str, session: PipSession, chunk_size: int = CONTENT_CHUNK_SIZE + ) -> None: + head = session.head(url, headers=HEADERS) + raise_for_status(head) + assert head.status_code == 200 + self._session, self._url, self._chunk_size = session, url, chunk_size + self._length = int(head.headers["Content-Length"]) + self._file = NamedTemporaryFile() + self.truncate(self._length) + self._left: List[int] = [] + self._right: List[int] = [] + if "bytes" not in head.headers.get("Accept-Ranges", "none"): + raise HTTPRangeRequestUnsupported("range request is not supported") + self._check_zip() + + @property + def mode(self) -> str: + """Opening mode, which is always rb.""" + return "rb" + + @property + def name(self) -> str: + """Path to the underlying file.""" + return self._file.name + + def seekable(self) -> bool: + """Return whether random access is supported, which is True.""" + return True + + def close(self) -> None: + """Close the file.""" + self._file.close() + + @property + def closed(self) -> bool: + """Whether the file is closed.""" + return self._file.closed + + def read(self, size: int = -1) -> bytes: + """Read up to size bytes from the object and return them. + + As a convenience, if size is unspecified or -1, + all bytes until EOF are returned. Fewer than + size bytes may be returned if EOF is reached. + """ + download_size = max(size, self._chunk_size) + start, length = self.tell(), self._length + stop = length if size < 0 else min(start + download_size, length) + start = max(0, stop - download_size) + self._download(start, stop - 1) + return self._file.read(size) + + def readable(self) -> bool: + """Return whether the file is readable, which is True.""" + return True + + def seek(self, offset: int, whence: int = 0) -> int: + """Change stream position and return the new absolute position. + + Seek to offset relative position indicated by whence: + * 0: Start of stream (the default). pos should be >= 0; + * 1: Current position - pos may be negative; + * 2: End of stream - pos usually negative. + """ + return self._file.seek(offset, whence) + + def tell(self) -> int: + """Return the current position.""" + return self._file.tell() + + def truncate(self, size: Optional[int] = None) -> int: + """Resize the stream to the given size in bytes. + + If size is unspecified resize to the current position. + The current stream position isn't changed. + + Return the new file size. + """ + return self._file.truncate(size) + + def writable(self) -> bool: + """Return False.""" + return False + + def __enter__(self) -> "LazyZipOverHTTP": + self._file.__enter__() + return self + + def __exit__(self, *exc: Any) -> None: + self._file.__exit__(*exc) + + @contextmanager + def _stay(self) -> Generator[None, None, None]: + """Return a context manager keeping the position. + + At the end of the block, seek back to original position. + """ + pos = self.tell() + try: + yield + finally: + self.seek(pos) + + def _check_zip(self) -> None: + """Check and download until the file is a valid ZIP.""" + end = self._length - 1 + for start in reversed(range(0, end, self._chunk_size)): + self._download(start, end) + with self._stay(): + try: + # For read-only ZIP files, ZipFile only needs + # methods read, seek, seekable and tell. + ZipFile(self) # type: ignore + except BadZipFile: + pass + else: + break + + def _stream_response( + self, start: int, end: int, base_headers: Dict[str, str] = HEADERS + ) -> Response: + """Return HTTP response to a range request from start to end.""" + headers = base_headers.copy() + headers["Range"] = f"bytes={start}-{end}" + # TODO: Get range requests to be correctly cached + headers["Cache-Control"] = "no-cache" + return self._session.get(self._url, headers=headers, stream=True) + + def _merge( + self, start: int, end: int, left: int, right: int + ) -> Generator[Tuple[int, int], None, None]: + """Return a generator of intervals to be fetched. + + Args: + start (int): Start of needed interval + end (int): End of needed interval + left (int): Index of first overlapping downloaded data + right (int): Index after last overlapping downloaded data + """ + lslice, rslice = self._left[left:right], self._right[left:right] + i = start = min([start] + lslice[:1]) + end = max([end] + rslice[-1:]) + for j, k in zip(lslice, rslice): + if j > i: + yield i, j - 1 + i = k + 1 + if i <= end: + yield i, end + self._left[left:right], self._right[left:right] = [start], [end] + + def _download(self, start: int, end: int) -> None: + """Download bytes from start to end inclusively.""" + with self._stay(): + left = bisect_left(self._right, start) + right = bisect_right(self._left, end) + for start, end in self._merge(start, end, left, right): + response = self._stream_response(start, end) + response.raise_for_status() + self.seek(start) + for chunk in response_chunks(response, self._chunk_size): + self._file.write(chunk) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/network/session.py b/.venv/lib/python3.12/site-packages/pip/_internal/network/session.py new file mode 100644 index 0000000..1765b4f --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/network/session.py @@ -0,0 +1,522 @@ +"""PipSession and supporting code, containing all pip-specific +network request configuration and behavior. +""" + +import email.utils +import functools +import io +import ipaddress +import json +import logging +import mimetypes +import os +import platform +import shutil +import subprocess +import sys +import urllib.parse +import warnings +from typing import ( + TYPE_CHECKING, + Any, + Dict, + Generator, + List, + Mapping, + Optional, + Sequence, + Tuple, + Union, +) + +from pip._vendor import requests, urllib3 +from pip._vendor.cachecontrol import CacheControlAdapter as _BaseCacheControlAdapter +from pip._vendor.requests.adapters import DEFAULT_POOLBLOCK, BaseAdapter +from pip._vendor.requests.adapters import HTTPAdapter as _BaseHTTPAdapter +from pip._vendor.requests.models import PreparedRequest, Response +from pip._vendor.requests.structures import CaseInsensitiveDict +from pip._vendor.urllib3.connectionpool import ConnectionPool +from pip._vendor.urllib3.exceptions import InsecureRequestWarning + +from pip import __version__ +from pip._internal.metadata import get_default_environment +from pip._internal.models.link import Link +from pip._internal.network.auth import MultiDomainBasicAuth +from pip._internal.network.cache import SafeFileCache + +# Import ssl from compat so the initial import occurs in only one place. +from pip._internal.utils.compat import has_tls +from pip._internal.utils.glibc import libc_ver +from pip._internal.utils.misc import build_url_from_netloc, parse_netloc +from pip._internal.utils.urls import url_to_path + +if TYPE_CHECKING: + from ssl import SSLContext + + from pip._vendor.urllib3.poolmanager import PoolManager + + +logger = logging.getLogger(__name__) + +SecureOrigin = Tuple[str, str, Optional[Union[int, str]]] + + +# Ignore warning raised when using --trusted-host. +warnings.filterwarnings("ignore", category=InsecureRequestWarning) + + +SECURE_ORIGINS: List[SecureOrigin] = [ + # protocol, hostname, port + # Taken from Chrome's list of secure origins (See: http://bit.ly/1qrySKC) + ("https", "*", "*"), + ("*", "localhost", "*"), + ("*", "127.0.0.0/8", "*"), + ("*", "::1/128", "*"), + ("file", "*", None), + # ssh is always secure. + ("ssh", "*", "*"), +] + + +# These are environment variables present when running under various +# CI systems. For each variable, some CI systems that use the variable +# are indicated. The collection was chosen so that for each of a number +# of popular systems, at least one of the environment variables is used. +# This list is used to provide some indication of and lower bound for +# CI traffic to PyPI. Thus, it is okay if the list is not comprehensive. +# For more background, see: https://github.com/pypa/pip/issues/5499 +CI_ENVIRONMENT_VARIABLES = ( + # Azure Pipelines + "BUILD_BUILDID", + # Jenkins + "BUILD_ID", + # AppVeyor, CircleCI, Codeship, Gitlab CI, Shippable, Travis CI + "CI", + # Explicit environment variable. + "PIP_IS_CI", +) + + +def looks_like_ci() -> bool: + """ + Return whether it looks like pip is running under CI. + """ + # We don't use the method of checking for a tty (e.g. using isatty()) + # because some CI systems mimic a tty (e.g. Travis CI). Thus that + # method doesn't provide definitive information in either direction. + return any(name in os.environ for name in CI_ENVIRONMENT_VARIABLES) + + +@functools.lru_cache(maxsize=1) +def user_agent() -> str: + """ + Return a string representing the user agent. + """ + data: Dict[str, Any] = { + "installer": {"name": "pip", "version": __version__}, + "python": platform.python_version(), + "implementation": { + "name": platform.python_implementation(), + }, + } + + if data["implementation"]["name"] == "CPython": + data["implementation"]["version"] = platform.python_version() + elif data["implementation"]["name"] == "PyPy": + pypy_version_info = sys.pypy_version_info # type: ignore + if pypy_version_info.releaselevel == "final": + pypy_version_info = pypy_version_info[:3] + data["implementation"]["version"] = ".".join( + [str(x) for x in pypy_version_info] + ) + elif data["implementation"]["name"] == "Jython": + # Complete Guess + data["implementation"]["version"] = platform.python_version() + elif data["implementation"]["name"] == "IronPython": + # Complete Guess + data["implementation"]["version"] = platform.python_version() + + if sys.platform.startswith("linux"): + from pip._vendor import distro + + linux_distribution = distro.name(), distro.version(), distro.codename() + distro_infos: Dict[str, Any] = dict( + filter( + lambda x: x[1], + zip(["name", "version", "id"], linux_distribution), + ) + ) + libc = dict( + filter( + lambda x: x[1], + zip(["lib", "version"], libc_ver()), + ) + ) + if libc: + distro_infos["libc"] = libc + if distro_infos: + data["distro"] = distro_infos + + if sys.platform.startswith("darwin") and platform.mac_ver()[0]: + data["distro"] = {"name": "macOS", "version": platform.mac_ver()[0]} + + if platform.system(): + data.setdefault("system", {})["name"] = platform.system() + + if platform.release(): + data.setdefault("system", {})["release"] = platform.release() + + if platform.machine(): + data["cpu"] = platform.machine() + + if has_tls(): + import _ssl as ssl + + data["openssl_version"] = ssl.OPENSSL_VERSION + + setuptools_dist = get_default_environment().get_distribution("setuptools") + if setuptools_dist is not None: + data["setuptools_version"] = str(setuptools_dist.version) + + if shutil.which("rustc") is not None: + # If for any reason `rustc --version` fails, silently ignore it + try: + rustc_output = subprocess.check_output( + ["rustc", "--version"], stderr=subprocess.STDOUT, timeout=0.5 + ) + except Exception: + pass + else: + if rustc_output.startswith(b"rustc "): + # The format of `rustc --version` is: + # `b'rustc 1.52.1 (9bc8c42bb 2021-05-09)\n'` + # We extract just the middle (1.52.1) part + data["rustc_version"] = rustc_output.split(b" ")[1].decode() + + # Use None rather than False so as not to give the impression that + # pip knows it is not being run under CI. Rather, it is a null or + # inconclusive result. Also, we include some value rather than no + # value to make it easier to know that the check has been run. + data["ci"] = True if looks_like_ci() else None + + user_data = os.environ.get("PIP_USER_AGENT_USER_DATA") + if user_data is not None: + data["user_data"] = user_data + + return "{data[installer][name]}/{data[installer][version]} {json}".format( + data=data, + json=json.dumps(data, separators=(",", ":"), sort_keys=True), + ) + + +class LocalFSAdapter(BaseAdapter): + def send( + self, + request: PreparedRequest, + stream: bool = False, + timeout: Optional[Union[float, Tuple[float, float]]] = None, + verify: Union[bool, str] = True, + cert: Optional[Union[str, Tuple[str, str]]] = None, + proxies: Optional[Mapping[str, str]] = None, + ) -> Response: + pathname = url_to_path(request.url) + + resp = Response() + resp.status_code = 200 + resp.url = request.url + + try: + stats = os.stat(pathname) + except OSError as exc: + # format the exception raised as a io.BytesIO object, + # to return a better error message: + resp.status_code = 404 + resp.reason = type(exc).__name__ + resp.raw = io.BytesIO(f"{resp.reason}: {exc}".encode()) + else: + modified = email.utils.formatdate(stats.st_mtime, usegmt=True) + content_type = mimetypes.guess_type(pathname)[0] or "text/plain" + resp.headers = CaseInsensitiveDict( + { + "Content-Type": content_type, + "Content-Length": stats.st_size, + "Last-Modified": modified, + } + ) + + resp.raw = open(pathname, "rb") + resp.close = resp.raw.close + + return resp + + def close(self) -> None: + pass + + +class _SSLContextAdapterMixin: + """Mixin to add the ``ssl_context`` constructor argument to HTTP adapters. + + The additional argument is forwarded directly to the pool manager. This allows us + to dynamically decide what SSL store to use at runtime, which is used to implement + the optional ``truststore`` backend. + """ + + def __init__( + self, + *, + ssl_context: Optional["SSLContext"] = None, + **kwargs: Any, + ) -> None: + self._ssl_context = ssl_context + super().__init__(**kwargs) + + def init_poolmanager( + self, + connections: int, + maxsize: int, + block: bool = DEFAULT_POOLBLOCK, + **pool_kwargs: Any, + ) -> "PoolManager": + if self._ssl_context is not None: + pool_kwargs.setdefault("ssl_context", self._ssl_context) + return super().init_poolmanager( # type: ignore[misc] + connections=connections, + maxsize=maxsize, + block=block, + **pool_kwargs, + ) + + +class HTTPAdapter(_SSLContextAdapterMixin, _BaseHTTPAdapter): + pass + + +class CacheControlAdapter(_SSLContextAdapterMixin, _BaseCacheControlAdapter): + pass + + +class InsecureHTTPAdapter(HTTPAdapter): + def cert_verify( + self, + conn: ConnectionPool, + url: str, + verify: Union[bool, str], + cert: Optional[Union[str, Tuple[str, str]]], + ) -> None: + super().cert_verify(conn=conn, url=url, verify=False, cert=cert) + + +class InsecureCacheControlAdapter(CacheControlAdapter): + def cert_verify( + self, + conn: ConnectionPool, + url: str, + verify: Union[bool, str], + cert: Optional[Union[str, Tuple[str, str]]], + ) -> None: + super().cert_verify(conn=conn, url=url, verify=False, cert=cert) + + +class PipSession(requests.Session): + timeout: Optional[int] = None + + def __init__( + self, + *args: Any, + retries: int = 0, + cache: Optional[str] = None, + trusted_hosts: Sequence[str] = (), + index_urls: Optional[List[str]] = None, + ssl_context: Optional["SSLContext"] = None, + **kwargs: Any, + ) -> None: + """ + :param trusted_hosts: Domains not to emit warnings for when not using + HTTPS. + """ + super().__init__(*args, **kwargs) + + # Namespace the attribute with "pip_" just in case to prevent + # possible conflicts with the base class. + self.pip_trusted_origins: List[Tuple[str, Optional[int]]] = [] + + # Attach our User Agent to the request + self.headers["User-Agent"] = user_agent() + + # Attach our Authentication handler to the session + self.auth = MultiDomainBasicAuth(index_urls=index_urls) + + # Create our urllib3.Retry instance which will allow us to customize + # how we handle retries. + retries = urllib3.Retry( + # Set the total number of retries that a particular request can + # have. + total=retries, + # A 503 error from PyPI typically means that the Fastly -> Origin + # connection got interrupted in some way. A 503 error in general + # is typically considered a transient error so we'll go ahead and + # retry it. + # A 500 may indicate transient error in Amazon S3 + # A 502 may be a transient error from a CDN like CloudFlare or CloudFront + # A 520 or 527 - may indicate transient error in CloudFlare + status_forcelist=[500, 502, 503, 520, 527], + # Add a small amount of back off between failed requests in + # order to prevent hammering the service. + backoff_factor=0.25, + ) # type: ignore + + # Our Insecure HTTPAdapter disables HTTPS validation. It does not + # support caching so we'll use it for all http:// URLs. + # If caching is disabled, we will also use it for + # https:// hosts that we've marked as ignoring + # TLS errors for (trusted-hosts). + insecure_adapter = InsecureHTTPAdapter(max_retries=retries) + + # We want to _only_ cache responses on securely fetched origins or when + # the host is specified as trusted. We do this because + # we can't validate the response of an insecurely/untrusted fetched + # origin, and we don't want someone to be able to poison the cache and + # require manual eviction from the cache to fix it. + if cache: + secure_adapter = CacheControlAdapter( + cache=SafeFileCache(cache), + max_retries=retries, + ssl_context=ssl_context, + ) + self._trusted_host_adapter = InsecureCacheControlAdapter( + cache=SafeFileCache(cache), + max_retries=retries, + ) + else: + secure_adapter = HTTPAdapter(max_retries=retries, ssl_context=ssl_context) + self._trusted_host_adapter = insecure_adapter + + self.mount("https://", secure_adapter) + self.mount("http://", insecure_adapter) + + # Enable file:// urls + self.mount("file://", LocalFSAdapter()) + + for host in trusted_hosts: + self.add_trusted_host(host, suppress_logging=True) + + def update_index_urls(self, new_index_urls: List[str]) -> None: + """ + :param new_index_urls: New index urls to update the authentication + handler with. + """ + self.auth.index_urls = new_index_urls + + def add_trusted_host( + self, host: str, source: Optional[str] = None, suppress_logging: bool = False + ) -> None: + """ + :param host: It is okay to provide a host that has previously been + added. + :param source: An optional source string, for logging where the host + string came from. + """ + if not suppress_logging: + msg = f"adding trusted host: {host!r}" + if source is not None: + msg += f" (from {source})" + logger.info(msg) + + parsed_host, parsed_port = parse_netloc(host) + if parsed_host is None: + raise ValueError(f"Trusted host URL must include a host part: {host!r}") + if (parsed_host, parsed_port) not in self.pip_trusted_origins: + self.pip_trusted_origins.append((parsed_host, parsed_port)) + + self.mount( + build_url_from_netloc(host, scheme="http") + "/", self._trusted_host_adapter + ) + self.mount(build_url_from_netloc(host) + "/", self._trusted_host_adapter) + if not parsed_port: + self.mount( + build_url_from_netloc(host, scheme="http") + ":", + self._trusted_host_adapter, + ) + # Mount wildcard ports for the same host. + self.mount(build_url_from_netloc(host) + ":", self._trusted_host_adapter) + + def iter_secure_origins(self) -> Generator[SecureOrigin, None, None]: + yield from SECURE_ORIGINS + for host, port in self.pip_trusted_origins: + yield ("*", host, "*" if port is None else port) + + def is_secure_origin(self, location: Link) -> bool: + # Determine if this url used a secure transport mechanism + parsed = urllib.parse.urlparse(str(location)) + origin_protocol, origin_host, origin_port = ( + parsed.scheme, + parsed.hostname, + parsed.port, + ) + + # The protocol to use to see if the protocol matches. + # Don't count the repository type as part of the protocol: in + # cases such as "git+ssh", only use "ssh". (I.e., Only verify against + # the last scheme.) + origin_protocol = origin_protocol.rsplit("+", 1)[-1] + + # Determine if our origin is a secure origin by looking through our + # hardcoded list of secure origins, as well as any additional ones + # configured on this PackageFinder instance. + for secure_origin in self.iter_secure_origins(): + secure_protocol, secure_host, secure_port = secure_origin + if origin_protocol != secure_protocol and secure_protocol != "*": + continue + + try: + addr = ipaddress.ip_address(origin_host or "") + network = ipaddress.ip_network(secure_host) + except ValueError: + # We don't have both a valid address or a valid network, so + # we'll check this origin against hostnames. + if ( + origin_host + and origin_host.lower() != secure_host.lower() + and secure_host != "*" + ): + continue + else: + # We have a valid address and network, so see if the address + # is contained within the network. + if addr not in network: + continue + + # Check to see if the port matches. + if ( + origin_port != secure_port + and secure_port != "*" + and secure_port is not None + ): + continue + + # If we've gotten here, then this origin matches the current + # secure origin and we should return True + return True + + # If we've gotten to this point, then the origin isn't secure and we + # will not accept it as a valid location to search. We will however + # log a warning that we are ignoring it. + logger.warning( + "The repository located at %s is not a trusted or secure host and " + "is being ignored. If this repository is available via HTTPS we " + "recommend you use HTTPS instead, otherwise you may silence " + "this warning and allow it anyway with '--trusted-host %s'.", + origin_host, + origin_host, + ) + + return False + + def request(self, method: str, url: str, *args: Any, **kwargs: Any) -> Response: + # Allow setting a default timeout on a session + kwargs.setdefault("timeout", self.timeout) + # Allow setting a default proxies on a session + kwargs.setdefault("proxies", self.proxies) + + # Dispatch the actual request + return super().request(method, url, *args, **kwargs) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/network/utils.py b/.venv/lib/python3.12/site-packages/pip/_internal/network/utils.py new file mode 100644 index 0000000..bba4c26 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/network/utils.py @@ -0,0 +1,98 @@ +from typing import Dict, Generator + +from pip._vendor.requests.models import Response + +from pip._internal.exceptions import NetworkConnectionError + +# The following comments and HTTP headers were originally added by +# Donald Stufft in git commit 22c562429a61bb77172039e480873fb239dd8c03. +# +# We use Accept-Encoding: identity here because requests defaults to +# accepting compressed responses. This breaks in a variety of ways +# depending on how the server is configured. +# - Some servers will notice that the file isn't a compressible file +# and will leave the file alone and with an empty Content-Encoding +# - Some servers will notice that the file is already compressed and +# will leave the file alone, adding a Content-Encoding: gzip header +# - Some servers won't notice anything at all and will take a file +# that's already been compressed and compress it again, and set +# the Content-Encoding: gzip header +# By setting this to request only the identity encoding we're hoping +# to eliminate the third case. Hopefully there does not exist a server +# which when given a file will notice it is already compressed and that +# you're not asking for a compressed file and will then decompress it +# before sending because if that's the case I don't think it'll ever be +# possible to make this work. +HEADERS: Dict[str, str] = {"Accept-Encoding": "identity"} + +DOWNLOAD_CHUNK_SIZE = 256 * 1024 + + +def raise_for_status(resp: Response) -> None: + http_error_msg = "" + if isinstance(resp.reason, bytes): + # We attempt to decode utf-8 first because some servers + # choose to localize their reason strings. If the string + # isn't utf-8, we fall back to iso-8859-1 for all other + # encodings. + try: + reason = resp.reason.decode("utf-8") + except UnicodeDecodeError: + reason = resp.reason.decode("iso-8859-1") + else: + reason = resp.reason + + if 400 <= resp.status_code < 500: + http_error_msg = ( + f"{resp.status_code} Client Error: {reason} for url: {resp.url}" + ) + + elif 500 <= resp.status_code < 600: + http_error_msg = ( + f"{resp.status_code} Server Error: {reason} for url: {resp.url}" + ) + + if http_error_msg: + raise NetworkConnectionError(http_error_msg, response=resp) + + +def response_chunks( + response: Response, chunk_size: int = DOWNLOAD_CHUNK_SIZE +) -> Generator[bytes, None, None]: + """Given a requests Response, provide the data chunks.""" + try: + # Special case for urllib3. + for chunk in response.raw.stream( + chunk_size, + # We use decode_content=False here because we don't + # want urllib3 to mess with the raw bytes we get + # from the server. If we decompress inside of + # urllib3 then we cannot verify the checksum + # because the checksum will be of the compressed + # file. This breakage will only occur if the + # server adds a Content-Encoding header, which + # depends on how the server was configured: + # - Some servers will notice that the file isn't a + # compressible file and will leave the file alone + # and with an empty Content-Encoding + # - Some servers will notice that the file is + # already compressed and will leave the file + # alone and will add a Content-Encoding: gzip + # header + # - Some servers won't notice anything at all and + # will take a file that's already been compressed + # and compress it again and set the + # Content-Encoding: gzip header + # + # By setting this not to decode automatically we + # hope to eliminate problems with the second case. + decode_content=False, + ): + yield chunk + except AttributeError: + # Standard file-like object. + while True: + chunk = response.raw.read(chunk_size) + if not chunk: + break + yield chunk diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/network/xmlrpc.py b/.venv/lib/python3.12/site-packages/pip/_internal/network/xmlrpc.py new file mode 100644 index 0000000..22ec8d2 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/network/xmlrpc.py @@ -0,0 +1,62 @@ +"""xmlrpclib.Transport implementation +""" + +import logging +import urllib.parse +import xmlrpc.client +from typing import TYPE_CHECKING, Tuple + +from pip._internal.exceptions import NetworkConnectionError +from pip._internal.network.session import PipSession +from pip._internal.network.utils import raise_for_status + +if TYPE_CHECKING: + from xmlrpc.client import _HostType, _Marshallable + + from _typeshed import SizedBuffer + +logger = logging.getLogger(__name__) + + +class PipXmlrpcTransport(xmlrpc.client.Transport): + """Provide a `xmlrpclib.Transport` implementation via a `PipSession` + object. + """ + + def __init__( + self, index_url: str, session: PipSession, use_datetime: bool = False + ) -> None: + super().__init__(use_datetime) + index_parts = urllib.parse.urlparse(index_url) + self._scheme = index_parts.scheme + self._session = session + + def request( + self, + host: "_HostType", + handler: str, + request_body: "SizedBuffer", + verbose: bool = False, + ) -> Tuple["_Marshallable", ...]: + assert isinstance(host, str) + parts = (self._scheme, host, handler, None, None, None) + url = urllib.parse.urlunparse(parts) + try: + headers = {"Content-Type": "text/xml"} + response = self._session.post( + url, + data=request_body, + headers=headers, + stream=True, + ) + raise_for_status(response) + self.verbose = verbose + return self.parse_response(response.raw) + except NetworkConnectionError as exc: + assert exc.response + logger.critical( + "HTTP error %s while getting %s", + exc.response.status_code, + url, + ) + raise diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/operations/__init__.py b/.venv/lib/python3.12/site-packages/pip/_internal/operations/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/operations/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/operations/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..7f145c8fcee9f6c70534821fb0b88a41ba0332b8 GIT binary patch literal 195 zcmZ9FK?=e!5JeNKAVLq~!Vce1lQE#gZa M?Gp?c=iFtHe#zxD^Z)<= literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/operations/__pycache__/check.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/operations/__pycache__/check.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ef32b4df6b01caf40ac244a80a16238fd4b93e3d GIT binary patch literal 7151 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/operations/__pycache__/prepare.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/operations/__pycache__/prepare.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b6c3b75ff7872cf2bbef89e6b92c017be2542000 GIT binary patch literal 25868 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 z M(Nuz+5%lyHRnu%nZofgnZ^6N7S5vTy6T@2bR63pTTWQkutmVB1u-V4Rj?&*y z{s)oXijVC%2*=0O114m)1#{j0gTF)m_4^N6HSwg@kV>uT%vK`+{IVQ>Kq&Y*Y60Qx zBEoz2)!D4$RJQHZvg6eJ>}RS~#^Tu0=!&E7GgbXj>)gQ*lPtm+K{b5CeEmG^wsy9{ zscT&`TZoEMX<;walk6a#*xQM>5-XnVpy2YJ4rohPJdje>Up?^pfvl%<@xZFE>!vxs z`{~^7r zZNr7Fm>3M|WrVOm3iO^XluNUNU1iCvky=8l70OBWSH_zAk!ISYp9mLohqvm@(5(F}pw`5yd3*fmWJ%`>9Hrs&wXs-e8_^ha3&4G3EMM8M{%gu5_GZ+jBH_}ODE;vB*(av zPSIXSs9n@oggaVG5KX7=2uP5@p=?Mw6m%+{%Fa~)-%Wf?Rh9cP`50B_CLgVR>oDoR zB4Rxz=|@`XU0w%DBNeZ$w17xM8YmfN`A>vOe~fxmD>JBAJ8twFuyL=c(A1i53g()E*~Tqk<-7x6<(w`g0nhLBsg`9uOW%S9G?3qOBDd#6 ze$NxRJ!I$)Gg%u~)ku0>2h^fvWCLUGx#B6B%yoTt%~qVT0ke$Y^}upqFdsOc3mhj+ zYBgoK$1;A-ToqM*BMdX)a zIh#%=B%%l;5|2xyz*Efll+t%8NaAqmH_7<{IbGzuMNTa_e@M>nlhZ)XACN_9|iEtRQvDXmGP8B?)N_3_vDLHw1a0uV#7vJGN zu?R)WZtKq5f%>8qcX09z9oOV5$)cS?4z8xI=p>&DVv?epd>*c)qv$1H71!8Z^pVfc z)wC9?$ydWQG#3NptL3WOi*@9yhcKhqK)yz5jSEim^)F zU>@oRd2TzK)~w_yj`7?{{&6I1wYmzmty%08tle5`KhY>VNe<&9KY>qi(^dpFI7L~a1z53@Ng0l=RZZD!I4BHw zDp@HT8}GztsPm}>XV?yfanx-r4YXkg+al=@F`}}%B|uGq8OBbz9U_UQc9OWP9^%`> z$}mnbq$8I^IH@$QPYZFW$WHB(CE^JrVp-I!dyKH8O$e%3m$(jP)B4PGg7d{vqeYnc z(TUtDAk?oDZ8hw$94v9I^lG+(lwwVChP4NADR<@T62sGEE4gG#frw z&5B8&qO`A1kW!BtAJQ0jcKC>TB8gy}vf_{tlCm&!W*m;Zu31{C+6gBFjLN|JH08sI zhuEPws;eD`%>Z>{v9!kHhwd|yf??~%@5jc;5bd>>1gf=neXZ)_@>|8xCkY(WB1@gr zmrayo!z)yCs4R*K-`$jI!yr^s(fL(0u6roOhJmG~z^Q9dRg$uqD(oXCNU2+m+NmAh z$&5=kz74fNm4~59`>B}f^~KO>cmq@iTgRB(=f6{su{LZC`yUiMLe6n=BILx#Ns#kA zIcyy{L%yTr?1A%zW1o6>>;cKl6Jd!3W-AsLEa5zV$HeoNH4n#E|2^mYd(QhQ*ZC>e z_z&F3GB@&%+@62rp7@kIe$V9KO;~|>6V`9u^z#~y-~SKX*r(jCPq{6has&Us9lK{T zZ!S8?=i(Y#if;0GI9vUimwer3evH4?4N3*~>s{*o zX6a5?O7Tc)KrC=(^*qr=zvFD-n^?)X-v+^8#hu=4sS|bzI=EJ$NC~MsRrAqTURZM@bZ_5L O2mcuVImd2nMEzd?W4{~# literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__init__.py b/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f53229cb0e7093713f578c73971698bb36a306bb GIT binary patch literal 201 zcmZ8aK?=e!5Nxc12z`hLyQo+32MWF*r0HrG( z3hWRXqxa=@2c80MtdMtcLl2fLaMA&t77C0-CjuGmq3TH0z~hes=cOIK%R_7GPT|ol QVlj*3lNfWxn9HO30XU{NIRF3v literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/build_tracker.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/build_tracker.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a5c157b2d28d4cebfe83781e18300e64c654d02b GIT binary patch literal 7717 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/metadata.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/metadata.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d6aa8778d61f8184f205a76a80f0cb117addd65a GIT binary patch literal 1878 zcmZ`)&2Jk;6rb4-ukCpA(Nt-q6tW^E!AS8^+ENL%1q>lY(6q$up}wrvyOVg+{nE@j zZXyRN#DPkPiW3|-^or6yfR9sis>CH#DkWNhR0;LKEg?Zc;li7>*P&Gz%QN%ly?OJS z_kQ#C7gfz8XgeRT&V3~#^g9>QmhDV->oEBS*{F(aYzr=~Vi-kN@WiT!`I_WPo?Mla zx$I^>2n>=#Dver51B);=MQK3e;S|Vp7svai z;}RR3jnIY<;Ebjd)eROpiQvIjbDn@&y-K|BJ%N#88Mr5|3T5krl#7%TlypEc944p&_HwBEY!+kLN z^78+zSK8}EW!dc{nrL21!3J~uc@V9-={wA0noXDmyd$>e_}Z1JE83ZpXG{6K25mOU zBh#WfNvR8FT~~HWhf-p_+~);0q5foQa25C{-Ee$6?w@yq8nAN7@Jt^FWiO9ip(HeE z8%yVPyb>+}T^E32r6};+BG9fc1aiR!qr97~}Y)hW+hw4u;lyM=L3a!7 z^`c`Z){AdGxcX>l_SWUcgD-6kPCOi(xb@NF+>srWlPh>Hi;hgLPtI-(RKCb;sYf@} z@rUa8-Ng;Hw1cEv1#b(YTESbRxo*EFaWRAny?4&uK6~ff z?Q`E2?z$U2r`DxYfA1;isQxFyu>IGe(hto?L(>ngt@qFVvn}$qgMB6OpPX{gcD0>g zI$&=B{O?{UPl!L_@`(KNz&q!q`)U^C`{#4zVP!3&mIsx!L7C5oMKD<#k;^A?YnlQ! zYZG$$HKo`WD~4eQmSNDN;4U74(3T9yfE`c>Ux$819m*`Dyk5n}5{oqWrEcA$64wqt zttB@t5+()wKLmU6X&Wf;E-M{!woT&W&ohdk=5kK8DKEnJAxY-^XRK z4VPS?;~?^q$Sy($;ly}Hz*ySNAe?`KE<8b}_XQCPe`OJ##=oIAwlhQc^j6>Kw#dg< V-)@f|&LrbwIlCvrI(-?O{R^{-1ls@r literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/metadata_editable.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/metadata_editable.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..aa8496d9d6b99683fe234e1ae0c44a7a7ed9e7fc GIT binary patch literal 1912 zcmZ`)-)|H}9G}^rch}n%S}YAkyRq1MMs7h65>il45k&bR#YFC9v$s3#ZP{PW?6tJH zDltAtVnTe<2OoGfY&0P;Jowhynwt9JclLIVAHliY%zS^$cRus| zerEPpO)DX2YacI7Ez1b~!G*jPvdMZACf^|k)scf8!NYY7qv#2~SQjzZNuK1(bvd2O zp5m)@)i2ZwsjPTKzf>=!bJgqd%k?tM3q*E`M083-b9#t2RdC8*N%h`&p`tAuJWXQD zv0_V~CIO*V?1q8vh10IBPlZ%xVT;;CcU%@zx6$HORxSO>!Jet$WU$t9J*Q^bmq_58 z48u$BTAoKJShl5>RGy$`Af%wsTE+uvx()py=;Gj$r%qD8111(VZ(ZCk7eDgttKbP01FwcDqeW&pX+z^+9j2lYNIz1Mlsa1(;R6j zi?JxT@eGguOl!-z2VYr4;8lFa1;qB_I7$&Y3jgJ3psvrzac>^sc_?SL=hnw#Tl%6K zZxW57IOQj|??JSGQH{0Sw=LZ0B5tc+3XZatr~~ER{{R@MZhvxX=WrlQz=q@pA#vv;wI(gPqwoz-^~u2 zlhG*MhL|}f6KHw_!oW}J4JZB%FBMj4*lFrxXm z83qTc``<8_8e*_FLJ#LTtbe9+y1 zjnkI>0^Jp~(TjHOS*aYkec|5V`73814!nGSVEoR&_?3?y7W>ywk35Mt3aEeYgYuDe zQRpvyt*k1j_l5h~*d1-``s`h;x`w3UBwiInZ4y5i8M{An>dwfi+Y@(3KK-`5DRbLq zUm9i?D)(MHeD(0PiK`Rem#=$wdk(Bf2maYm(GKG;gkkw_gVmdJ_Xbbg{$yp_`F~eM zuG`vF)A;EwTb)p=DXuN{798P+7i;6Gp%zMMEHWF z1^p4N!`_GvL$_6!fP2~U$T2zwB7Zd5N$4P*7_SK!OX~{4rAO%4BXn?65V7!g0pSz) jcXVh~8Nvr2^o^{Fe0=Tg&iLV(bbKfmHe}G#S0LDbQ7#b# literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/metadata_legacy.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/metadata_legacy.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..bb60689ddda28d06542b017f91d816cf0de80828 GIT binary patch literal 3025 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 RvFuX$^D9qMAkl*m;UA{(u-O0r literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/wheel_editable.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/__pycache__/wheel_editable.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f3fff1db5648506c8686b23ea3bc3005239f251d GIT binary patch literal 2023 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 bXO(|&*$q++o}5uPOr=P3$h|0N>?HmNxJKC2 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/build_tracker.py b/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/build_tracker.py new file mode 100644 index 0000000..0ed8dd2 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/build_tracker.py @@ -0,0 +1,138 @@ +import contextlib +import hashlib +import logging +import os +from types import TracebackType +from typing import Dict, Generator, Optional, Type, Union + +from pip._internal.req.req_install import InstallRequirement +from pip._internal.utils.temp_dir import TempDirectory + +logger = logging.getLogger(__name__) + + +@contextlib.contextmanager +def update_env_context_manager(**changes: str) -> Generator[None, None, None]: + target = os.environ + + # Save values from the target and change them. + non_existent_marker = object() + saved_values: Dict[str, Union[object, str]] = {} + for name, new_value in changes.items(): + try: + saved_values[name] = target[name] + except KeyError: + saved_values[name] = non_existent_marker + target[name] = new_value + + try: + yield + finally: + # Restore original values in the target. + for name, original_value in saved_values.items(): + if original_value is non_existent_marker: + del target[name] + else: + assert isinstance(original_value, str) # for mypy + target[name] = original_value + + +@contextlib.contextmanager +def get_build_tracker() -> Generator["BuildTracker", None, None]: + root = os.environ.get("PIP_BUILD_TRACKER") + with contextlib.ExitStack() as ctx: + if root is None: + root = ctx.enter_context(TempDirectory(kind="build-tracker")).path + ctx.enter_context(update_env_context_manager(PIP_BUILD_TRACKER=root)) + logger.debug("Initialized build tracking at %s", root) + + with BuildTracker(root) as tracker: + yield tracker + + +class TrackerId(str): + """Uniquely identifying string provided to the build tracker.""" + + +class BuildTracker: + """Ensure that an sdist cannot request itself as a setup requirement. + + When an sdist is prepared, it identifies its setup requirements in the + context of ``BuildTracker.track()``. If a requirement shows up recursively, this + raises an exception. + + This stops fork bombs embedded in malicious packages.""" + + def __init__(self, root: str) -> None: + self._root = root + self._entries: Dict[TrackerId, InstallRequirement] = {} + logger.debug("Created build tracker: %s", self._root) + + def __enter__(self) -> "BuildTracker": + logger.debug("Entered build tracker: %s", self._root) + return self + + def __exit__( + self, + exc_type: Optional[Type[BaseException]], + exc_val: Optional[BaseException], + exc_tb: Optional[TracebackType], + ) -> None: + self.cleanup() + + def _entry_path(self, key: TrackerId) -> str: + hashed = hashlib.sha224(key.encode()).hexdigest() + return os.path.join(self._root, hashed) + + def add(self, req: InstallRequirement, key: TrackerId) -> None: + """Add an InstallRequirement to build tracking.""" + + # Get the file to write information about this requirement. + entry_path = self._entry_path(key) + + # Try reading from the file. If it exists and can be read from, a build + # is already in progress, so a LookupError is raised. + try: + with open(entry_path) as fp: + contents = fp.read() + except FileNotFoundError: + pass + else: + message = f"{req.link} is already being built: {contents}" + raise LookupError(message) + + # If we're here, req should really not be building already. + assert key not in self._entries + + # Start tracking this requirement. + with open(entry_path, "w", encoding="utf-8") as fp: + fp.write(str(req)) + self._entries[key] = req + + logger.debug("Added %s to build tracker %r", req, self._root) + + def remove(self, req: InstallRequirement, key: TrackerId) -> None: + """Remove an InstallRequirement from build tracking.""" + + # Delete the created file and the corresponding entry. + os.unlink(self._entry_path(key)) + del self._entries[key] + + logger.debug("Removed %s from build tracker %r", req, self._root) + + def cleanup(self) -> None: + for key, req in list(self._entries.items()): + self.remove(req, key) + + logger.debug("Removed build tracker: %r", self._root) + + @contextlib.contextmanager + def track(self, req: InstallRequirement, key: str) -> Generator[None, None, None]: + """Ensure that `key` cannot install itself as a setup requirement. + + :raises LookupError: If `key` was already provided in a parent invocation of + the context introduced by this method.""" + tracker_id = TrackerId(key) + self.add(req, tracker_id) + yield + self.remove(req, tracker_id) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/metadata.py b/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/metadata.py new file mode 100644 index 0000000..c66ac35 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/metadata.py @@ -0,0 +1,39 @@ +"""Metadata generation logic for source distributions. +""" + +import os + +from pip._vendor.pyproject_hooks import BuildBackendHookCaller + +from pip._internal.build_env import BuildEnvironment +from pip._internal.exceptions import ( + InstallationSubprocessError, + MetadataGenerationFailed, +) +from pip._internal.utils.subprocess import runner_with_spinner_message +from pip._internal.utils.temp_dir import TempDirectory + + +def generate_metadata( + build_env: BuildEnvironment, backend: BuildBackendHookCaller, details: str +) -> str: + """Generate metadata using mechanisms described in PEP 517. + + Returns the generated metadata directory. + """ + metadata_tmpdir = TempDirectory(kind="modern-metadata", globally_managed=True) + + metadata_dir = metadata_tmpdir.path + + with build_env: + # Note that BuildBackendHookCaller implements a fallback for + # prepare_metadata_for_build_wheel, so we don't have to + # consider the possibility that this hook doesn't exist. + runner = runner_with_spinner_message("Preparing metadata (pyproject.toml)") + with backend.subprocess_runner(runner): + try: + distinfo_dir = backend.prepare_metadata_for_build_wheel(metadata_dir) + except InstallationSubprocessError as error: + raise MetadataGenerationFailed(package_details=details) from error + + return os.path.join(metadata_dir, distinfo_dir) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/metadata_editable.py b/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/metadata_editable.py new file mode 100644 index 0000000..27c69f0 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/metadata_editable.py @@ -0,0 +1,41 @@ +"""Metadata generation logic for source distributions. +""" + +import os + +from pip._vendor.pyproject_hooks import BuildBackendHookCaller + +from pip._internal.build_env import BuildEnvironment +from pip._internal.exceptions import ( + InstallationSubprocessError, + MetadataGenerationFailed, +) +from pip._internal.utils.subprocess import runner_with_spinner_message +from pip._internal.utils.temp_dir import TempDirectory + + +def generate_editable_metadata( + build_env: BuildEnvironment, backend: BuildBackendHookCaller, details: str +) -> str: + """Generate metadata using mechanisms described in PEP 660. + + Returns the generated metadata directory. + """ + metadata_tmpdir = TempDirectory(kind="modern-metadata", globally_managed=True) + + metadata_dir = metadata_tmpdir.path + + with build_env: + # Note that BuildBackendHookCaller implements a fallback for + # prepare_metadata_for_build_wheel/editable, so we don't have to + # consider the possibility that this hook doesn't exist. + runner = runner_with_spinner_message( + "Preparing editable metadata (pyproject.toml)" + ) + with backend.subprocess_runner(runner): + try: + distinfo_dir = backend.prepare_metadata_for_build_editable(metadata_dir) + except InstallationSubprocessError as error: + raise MetadataGenerationFailed(package_details=details) from error + + return os.path.join(metadata_dir, distinfo_dir) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/metadata_legacy.py b/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/metadata_legacy.py new file mode 100644 index 0000000..c01dd1c --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/metadata_legacy.py @@ -0,0 +1,74 @@ +"""Metadata generation logic for legacy source distributions. +""" + +import logging +import os + +from pip._internal.build_env import BuildEnvironment +from pip._internal.cli.spinners import open_spinner +from pip._internal.exceptions import ( + InstallationError, + InstallationSubprocessError, + MetadataGenerationFailed, +) +from pip._internal.utils.setuptools_build import make_setuptools_egg_info_args +from pip._internal.utils.subprocess import call_subprocess +from pip._internal.utils.temp_dir import TempDirectory + +logger = logging.getLogger(__name__) + + +def _find_egg_info(directory: str) -> str: + """Find an .egg-info subdirectory in `directory`.""" + filenames = [f for f in os.listdir(directory) if f.endswith(".egg-info")] + + if not filenames: + raise InstallationError(f"No .egg-info directory found in {directory}") + + if len(filenames) > 1: + raise InstallationError( + f"More than one .egg-info directory found in {directory}" + ) + + return os.path.join(directory, filenames[0]) + + +def generate_metadata( + build_env: BuildEnvironment, + setup_py_path: str, + source_dir: str, + isolated: bool, + details: str, +) -> str: + """Generate metadata using setup.py-based defacto mechanisms. + + Returns the generated metadata directory. + """ + logger.debug( + "Running setup.py (path:%s) egg_info for package %s", + setup_py_path, + details, + ) + + egg_info_dir = TempDirectory(kind="pip-egg-info", globally_managed=True).path + + args = make_setuptools_egg_info_args( + setup_py_path, + egg_info_dir=egg_info_dir, + no_user_config=isolated, + ) + + with build_env: + with open_spinner("Preparing metadata (setup.py)") as spinner: + try: + call_subprocess( + args, + cwd=source_dir, + command_desc="python setup.py egg_info", + spinner=spinner, + ) + except InstallationSubprocessError as error: + raise MetadataGenerationFailed(package_details=details) from error + + # Return the .egg-info directory. + return _find_egg_info(egg_info_dir) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/wheel.py b/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/wheel.py new file mode 100644 index 0000000..064811a --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/wheel.py @@ -0,0 +1,37 @@ +import logging +import os +from typing import Optional + +from pip._vendor.pyproject_hooks import BuildBackendHookCaller + +from pip._internal.utils.subprocess import runner_with_spinner_message + +logger = logging.getLogger(__name__) + + +def build_wheel_pep517( + name: str, + backend: BuildBackendHookCaller, + metadata_directory: str, + tempd: str, +) -> Optional[str]: + """Build one InstallRequirement using the PEP 517 build process. + + Returns path to wheel if successfully built. Otherwise, returns None. + """ + assert metadata_directory is not None + try: + logger.debug("Destination directory: %s", tempd) + + runner = runner_with_spinner_message( + f"Building wheel for {name} (pyproject.toml)" + ) + with backend.subprocess_runner(runner): + wheel_name = backend.build_wheel( + tempd, + metadata_directory=metadata_directory, + ) + except Exception: + logger.error("Failed building wheel for %s", name) + return None + return os.path.join(tempd, wheel_name) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/wheel_editable.py b/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/wheel_editable.py new file mode 100644 index 0000000..719d69d --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/wheel_editable.py @@ -0,0 +1,46 @@ +import logging +import os +from typing import Optional + +from pip._vendor.pyproject_hooks import BuildBackendHookCaller, HookMissing + +from pip._internal.utils.subprocess import runner_with_spinner_message + +logger = logging.getLogger(__name__) + + +def build_wheel_editable( + name: str, + backend: BuildBackendHookCaller, + metadata_directory: str, + tempd: str, +) -> Optional[str]: + """Build one InstallRequirement using the PEP 660 build process. + + Returns path to wheel if successfully built. Otherwise, returns None. + """ + assert metadata_directory is not None + try: + logger.debug("Destination directory: %s", tempd) + + runner = runner_with_spinner_message( + f"Building editable for {name} (pyproject.toml)" + ) + with backend.subprocess_runner(runner): + try: + wheel_name = backend.build_editable( + tempd, + metadata_directory=metadata_directory, + ) + except HookMissing as e: + logger.error( + "Cannot build editable %s because the build " + "backend does not have the %s hook", + name, + e, + ) + return None + except Exception: + logger.error("Failed building editable for %s", name) + return None + return os.path.join(tempd, wheel_name) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/wheel_legacy.py b/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/wheel_legacy.py new file mode 100644 index 0000000..3ee2a70 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/operations/build/wheel_legacy.py @@ -0,0 +1,102 @@ +import logging +import os.path +from typing import List, Optional + +from pip._internal.cli.spinners import open_spinner +from pip._internal.utils.setuptools_build import make_setuptools_bdist_wheel_args +from pip._internal.utils.subprocess import call_subprocess, format_command_args + +logger = logging.getLogger(__name__) + + +def format_command_result( + command_args: List[str], + command_output: str, +) -> str: + """Format command information for logging.""" + command_desc = format_command_args(command_args) + text = f"Command arguments: {command_desc}\n" + + if not command_output: + text += "Command output: None" + elif logger.getEffectiveLevel() > logging.DEBUG: + text += "Command output: [use --verbose to show]" + else: + if not command_output.endswith("\n"): + command_output += "\n" + text += f"Command output:\n{command_output}" + + return text + + +def get_legacy_build_wheel_path( + names: List[str], + temp_dir: str, + name: str, + command_args: List[str], + command_output: str, +) -> Optional[str]: + """Return the path to the wheel in the temporary build directory.""" + # Sort for determinism. + names = sorted(names) + if not names: + msg = f"Legacy build of wheel for {name!r} created no files.\n" + msg += format_command_result(command_args, command_output) + logger.warning(msg) + return None + + if len(names) > 1: + msg = ( + f"Legacy build of wheel for {name!r} created more than one file.\n" + f"Filenames (choosing first): {names}\n" + ) + msg += format_command_result(command_args, command_output) + logger.warning(msg) + + return os.path.join(temp_dir, names[0]) + + +def build_wheel_legacy( + name: str, + setup_py_path: str, + source_dir: str, + global_options: List[str], + build_options: List[str], + tempd: str, +) -> Optional[str]: + """Build one unpacked package using the "legacy" build process. + + Returns path to wheel if successfully built. Otherwise, returns None. + """ + wheel_args = make_setuptools_bdist_wheel_args( + setup_py_path, + global_options=global_options, + build_options=build_options, + destination_dir=tempd, + ) + + spin_message = f"Building wheel for {name} (setup.py)" + with open_spinner(spin_message) as spinner: + logger.debug("Destination directory: %s", tempd) + + try: + output = call_subprocess( + wheel_args, + command_desc="python setup.py bdist_wheel", + cwd=source_dir, + spinner=spinner, + ) + except Exception: + spinner.finish("error") + logger.error("Failed building wheel for %s", name) + return None + + names = os.listdir(tempd) + wheel_path = get_legacy_build_wheel_path( + names=names, + temp_dir=tempd, + name=name, + command_args=wheel_args, + command_output=output, + ) + return wheel_path diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/operations/check.py b/.venv/lib/python3.12/site-packages/pip/_internal/operations/check.py new file mode 100644 index 0000000..4b6fbc4 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/operations/check.py @@ -0,0 +1,181 @@ +"""Validation of dependencies of packages +""" + +import logging +from contextlib import suppress +from email.parser import Parser +from functools import reduce +from typing import ( + Callable, + Dict, + FrozenSet, + Generator, + Iterable, + List, + NamedTuple, + Optional, + Set, + Tuple, +) + +from pip._vendor.packaging.requirements import Requirement +from pip._vendor.packaging.tags import Tag, parse_tag +from pip._vendor.packaging.utils import NormalizedName, canonicalize_name +from pip._vendor.packaging.version import Version + +from pip._internal.distributions import make_distribution_for_install_requirement +from pip._internal.metadata import get_default_environment +from pip._internal.metadata.base import BaseDistribution +from pip._internal.req.req_install import InstallRequirement + +logger = logging.getLogger(__name__) + + +class PackageDetails(NamedTuple): + version: Version + dependencies: List[Requirement] + + +# Shorthands +PackageSet = Dict[NormalizedName, PackageDetails] +Missing = Tuple[NormalizedName, Requirement] +Conflicting = Tuple[NormalizedName, Version, Requirement] + +MissingDict = Dict[NormalizedName, List[Missing]] +ConflictingDict = Dict[NormalizedName, List[Conflicting]] +CheckResult = Tuple[MissingDict, ConflictingDict] +ConflictDetails = Tuple[PackageSet, CheckResult] + + +def create_package_set_from_installed() -> Tuple[PackageSet, bool]: + """Converts a list of distributions into a PackageSet.""" + package_set = {} + problems = False + env = get_default_environment() + for dist in env.iter_installed_distributions(local_only=False, skip=()): + name = dist.canonical_name + try: + dependencies = list(dist.iter_dependencies()) + package_set[name] = PackageDetails(dist.version, dependencies) + except (OSError, ValueError) as e: + # Don't crash on unreadable or broken metadata. + logger.warning("Error parsing dependencies of %s: %s", name, e) + problems = True + return package_set, problems + + +def check_package_set( + package_set: PackageSet, should_ignore: Optional[Callable[[str], bool]] = None +) -> CheckResult: + """Check if a package set is consistent + + If should_ignore is passed, it should be a callable that takes a + package name and returns a boolean. + """ + + missing = {} + conflicting = {} + + for package_name, package_detail in package_set.items(): + # Info about dependencies of package_name + missing_deps: Set[Missing] = set() + conflicting_deps: Set[Conflicting] = set() + + if should_ignore and should_ignore(package_name): + continue + + for req in package_detail.dependencies: + name = canonicalize_name(req.name) + + # Check if it's missing + if name not in package_set: + missed = True + if req.marker is not None: + missed = req.marker.evaluate({"extra": ""}) + if missed: + missing_deps.add((name, req)) + continue + + # Check if there's a conflict + version = package_set[name].version + if not req.specifier.contains(version, prereleases=True): + conflicting_deps.add((name, version, req)) + + if missing_deps: + missing[package_name] = sorted(missing_deps, key=str) + if conflicting_deps: + conflicting[package_name] = sorted(conflicting_deps, key=str) + + return missing, conflicting + + +def check_install_conflicts(to_install: List[InstallRequirement]) -> ConflictDetails: + """For checking if the dependency graph would be consistent after \ + installing given requirements + """ + # Start from the current state + package_set, _ = create_package_set_from_installed() + # Install packages + would_be_installed = _simulate_installation_of(to_install, package_set) + + # Only warn about directly-dependent packages; create a whitelist of them + whitelist = _create_whitelist(would_be_installed, package_set) + + return ( + package_set, + check_package_set( + package_set, should_ignore=lambda name: name not in whitelist + ), + ) + + +def check_unsupported( + packages: Iterable[BaseDistribution], + supported_tags: Iterable[Tag], +) -> Generator[BaseDistribution, None, None]: + for p in packages: + with suppress(FileNotFoundError): + wheel_file = p.read_text("WHEEL") + wheel_tags: FrozenSet[Tag] = reduce( + frozenset.union, + map(parse_tag, Parser().parsestr(wheel_file).get_all("Tag", [])), + frozenset(), + ) + if wheel_tags.isdisjoint(supported_tags): + yield p + + +def _simulate_installation_of( + to_install: List[InstallRequirement], package_set: PackageSet +) -> Set[NormalizedName]: + """Computes the version of packages after installing to_install.""" + # Keep track of packages that were installed + installed = set() + + # Modify it as installing requirement_set would (assuming no errors) + for inst_req in to_install: + abstract_dist = make_distribution_for_install_requirement(inst_req) + dist = abstract_dist.get_metadata_distribution() + name = dist.canonical_name + package_set[name] = PackageDetails(dist.version, list(dist.iter_dependencies())) + + installed.add(name) + + return installed + + +def _create_whitelist( + would_be_installed: Set[NormalizedName], package_set: PackageSet +) -> Set[NormalizedName]: + packages_affected = set(would_be_installed) + + for package_name in package_set: + if package_name in packages_affected: + continue + + for req in package_set[package_name].dependencies: + if canonicalize_name(req.name) in packages_affected: + packages_affected.add(package_name) + break + + return packages_affected diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/operations/freeze.py b/.venv/lib/python3.12/site-packages/pip/_internal/operations/freeze.py new file mode 100644 index 0000000..bb1039f --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/operations/freeze.py @@ -0,0 +1,258 @@ +import collections +import logging +import os +from typing import Container, Dict, Generator, Iterable, List, NamedTuple, Optional, Set + +from pip._vendor.packaging.utils import canonicalize_name +from pip._vendor.packaging.version import InvalidVersion + +from pip._internal.exceptions import BadCommand, InstallationError +from pip._internal.metadata import BaseDistribution, get_environment +from pip._internal.req.constructors import ( + install_req_from_editable, + install_req_from_line, +) +from pip._internal.req.req_file import COMMENT_RE +from pip._internal.utils.direct_url_helpers import direct_url_as_pep440_direct_reference + +logger = logging.getLogger(__name__) + + +class _EditableInfo(NamedTuple): + requirement: str + comments: List[str] + + +def freeze( + requirement: Optional[List[str]] = None, + local_only: bool = False, + user_only: bool = False, + paths: Optional[List[str]] = None, + isolated: bool = False, + exclude_editable: bool = False, + skip: Container[str] = (), +) -> Generator[str, None, None]: + installations: Dict[str, FrozenRequirement] = {} + + dists = get_environment(paths).iter_installed_distributions( + local_only=local_only, + skip=(), + user_only=user_only, + ) + for dist in dists: + req = FrozenRequirement.from_dist(dist) + if exclude_editable and req.editable: + continue + installations[req.canonical_name] = req + + if requirement: + # the options that don't get turned into an InstallRequirement + # should only be emitted once, even if the same option is in multiple + # requirements files, so we need to keep track of what has been emitted + # so that we don't emit it again if it's seen again + emitted_options: Set[str] = set() + # keep track of which files a requirement is in so that we can + # give an accurate warning if a requirement appears multiple times. + req_files: Dict[str, List[str]] = collections.defaultdict(list) + for req_file_path in requirement: + with open(req_file_path) as req_file: + for line in req_file: + if ( + not line.strip() + or line.strip().startswith("#") + or line.startswith( + ( + "-r", + "--requirement", + "-f", + "--find-links", + "-i", + "--index-url", + "--pre", + "--trusted-host", + "--process-dependency-links", + "--extra-index-url", + "--use-feature", + ) + ) + ): + line = line.rstrip() + if line not in emitted_options: + emitted_options.add(line) + yield line + continue + + if line.startswith("-e") or line.startswith("--editable"): + if line.startswith("-e"): + line = line[2:].strip() + else: + line = line[len("--editable") :].strip().lstrip("=") + line_req = install_req_from_editable( + line, + isolated=isolated, + ) + else: + line_req = install_req_from_line( + COMMENT_RE.sub("", line).strip(), + isolated=isolated, + ) + + if not line_req.name: + logger.info( + "Skipping line in requirement file [%s] because " + "it's not clear what it would install: %s", + req_file_path, + line.strip(), + ) + logger.info( + " (add #egg=PackageName to the URL to avoid" + " this warning)" + ) + else: + line_req_canonical_name = canonicalize_name(line_req.name) + if line_req_canonical_name not in installations: + # either it's not installed, or it is installed + # but has been processed already + if not req_files[line_req.name]: + logger.warning( + "Requirement file [%s] contains %s, but " + "package %r is not installed", + req_file_path, + COMMENT_RE.sub("", line).strip(), + line_req.name, + ) + else: + req_files[line_req.name].append(req_file_path) + else: + yield str(installations[line_req_canonical_name]).rstrip() + del installations[line_req_canonical_name] + req_files[line_req.name].append(req_file_path) + + # Warn about requirements that were included multiple times (in a + # single requirements file or in different requirements files). + for name, files in req_files.items(): + if len(files) > 1: + logger.warning( + "Requirement %s included multiple times [%s]", + name, + ", ".join(sorted(set(files))), + ) + + yield ("## The following requirements were added by pip freeze:") + for installation in sorted(installations.values(), key=lambda x: x.name.lower()): + if installation.canonical_name not in skip: + yield str(installation).rstrip() + + +def _format_as_name_version(dist: BaseDistribution) -> str: + try: + dist_version = dist.version + except InvalidVersion: + # legacy version + return f"{dist.raw_name}==={dist.raw_version}" + else: + return f"{dist.raw_name}=={dist_version}" + + +def _get_editable_info(dist: BaseDistribution) -> _EditableInfo: + """ + Compute and return values (req, comments) for use in + FrozenRequirement.from_dist(). + """ + editable_project_location = dist.editable_project_location + assert editable_project_location + location = os.path.normcase(os.path.abspath(editable_project_location)) + + from pip._internal.vcs import RemoteNotFoundError, RemoteNotValidError, vcs + + vcs_backend = vcs.get_backend_for_dir(location) + + if vcs_backend is None: + display = _format_as_name_version(dist) + logger.debug( + 'No VCS found for editable requirement "%s" in: %r', + display, + location, + ) + return _EditableInfo( + requirement=location, + comments=[f"# Editable install with no version control ({display})"], + ) + + vcs_name = type(vcs_backend).__name__ + + try: + req = vcs_backend.get_src_requirement(location, dist.raw_name) + except RemoteNotFoundError: + display = _format_as_name_version(dist) + return _EditableInfo( + requirement=location, + comments=[f"# Editable {vcs_name} install with no remote ({display})"], + ) + except RemoteNotValidError as ex: + display = _format_as_name_version(dist) + return _EditableInfo( + requirement=location, + comments=[ + f"# Editable {vcs_name} install ({display}) with either a deleted " + f"local remote or invalid URI:", + f"# '{ex.url}'", + ], + ) + except BadCommand: + logger.warning( + "cannot determine version of editable source in %s " + "(%s command not found in path)", + location, + vcs_backend.name, + ) + return _EditableInfo(requirement=location, comments=[]) + except InstallationError as exc: + logger.warning("Error when trying to get requirement for VCS system %s", exc) + else: + return _EditableInfo(requirement=req, comments=[]) + + logger.warning("Could not determine repository location of %s", location) + + return _EditableInfo( + requirement=location, + comments=["## !! Could not determine repository location"], + ) + + +class FrozenRequirement: + def __init__( + self, + name: str, + req: str, + editable: bool, + comments: Iterable[str] = (), + ) -> None: + self.name = name + self.canonical_name = canonicalize_name(name) + self.req = req + self.editable = editable + self.comments = comments + + @classmethod + def from_dist(cls, dist: BaseDistribution) -> "FrozenRequirement": + editable = dist.editable + if editable: + req, comments = _get_editable_info(dist) + else: + comments = [] + direct_url = dist.direct_url + if direct_url: + # if PEP 610 metadata is present, use it + req = direct_url_as_pep440_direct_reference(direct_url, dist.raw_name) + else: + # name==version requirement + req = _format_as_name_version(dist) + + return cls(dist.raw_name, req, editable, comments=comments) + + def __str__(self) -> str: + req = self.req + if self.editable: + req = f"-e {req}" + return "\n".join(list(self.comments) + [str(req)]) + "\n" diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/operations/install/__init__.py b/.venv/lib/python3.12/site-packages/pip/_internal/operations/install/__init__.py new file mode 100644 index 0000000..24d6a5d --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/operations/install/__init__.py @@ -0,0 +1,2 @@ +"""For modules related to installing packages. +""" diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/operations/install/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/operations/install/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..0f7024ed41b0f5f3c6733669a5f134ff5a7d857c GIT binary patch literal 264 zcmXv}F-`+95VVsBqDc9J+emOLNQ)@xK%%9wjJ@QRI9|&(CmkQ*4Tz`k16n=+q)UZQ zNv7EujWj#+IiJr&#qa&c)3V<0K^!3uWIL_oO*ru&dbt?Ap51U#8+I=qvr6bqL8l5U z3b`2XDXdg9c5POeo7vq$ew}LV*lPVQwnOCZ8Cu>Tq=+SPN45pa4&j!vg{H&Mfu~1^ zeQ7x?n~O`xRPg+m36Uab3I$Uz9ynq$g*aq56aZaaDq1(O-%YRfO|R2QeLYOd!{VQ@ Nl=5#REpm6dtdC*53alyIGo+)}@VL5m_s3K@~!vAUL2lMbJ~1!_=`SyKcRNg(R1=J|VXX6Lu4!f z{d`~V=qc8GqhIJ0Qk?gT{ZgkSp&TO8jk$eChhI|JkTR`Pb#8OK%(Z6L-?~h?wlg$|>&5npPfRahvF-bI?1h0D z(a<4`y<&Q8(l)O%5)YzwG&EhZM*J|k-Y)zt;FJrcyczjX_vuz)q!X*8>~!X;gzl* zuGl^fQ-6$W5hbhM9j^4kKH=p7BN!&d%!>(E0$Ui<<8d^^ksbHA?y(RqNL+5Li1088 z*7&hO5ZTU6;$jvKs6(*pQR2iQ9deDry=mZNsYl2Fpu?15ZgUV1Pz*8~H-z=baHWy5 zk;{w{ih)Vl7^x#P(niuKH$|L=evN7=p z98$&a(9=@mk`uL0pK-&?V=u+O&_&sl=53zGyhEAk=>dqGSnbd(iFgr*J2tVw%X z`~8ajw0|LUyf#_G`)l+##3X`cLlAe-&Pk*eKfCnFrJrhx-(L7dx%g-C#j)NPH|NLA zQ{!r5T%H=wp4lnqOWNIccBWCG{>6zcq^Xs0d3Fn_M&-BC@o}v_e*U#_ec_+HQm*XE zVBM8rOCt8|=0Huv&b>q99(w`2ewzp34h-T3vcM-R|m1@v-ae$w8H%CvvwTv z5~l~IjNm7qx%J>BO3A{FE{QK^WYRGf&ke@3DPoaX3CZ8Pk#gY zX5f=IX$w^GsI#v@B(fw)TRBNmwlySGe@F9wp$nVn+$LJyM6W+J=00!!YRvs?%sssL z#5j9bOEgoeJguL2c=fC0L9RGmqt1e!)QGno;nj?6PjL!eot6?U3{=t~gizh2kwwg3PC literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/operations/install/__pycache__/wheel.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/operations/install/__pycache__/wheel.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..be392ce02422fc2003731e7428851850c58a1d11 GIT binary patch literal 34244 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 QqY%~Zel|kVUaaN+5BtqydjJ3c literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/operations/install/editable_legacy.py b/.venv/lib/python3.12/site-packages/pip/_internal/operations/install/editable_legacy.py new file mode 100644 index 0000000..9aaa699 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/operations/install/editable_legacy.py @@ -0,0 +1,47 @@ +"""Legacy editable installation process, i.e. `setup.py develop`. +""" + +import logging +from typing import Optional, Sequence + +from pip._internal.build_env import BuildEnvironment +from pip._internal.utils.logging import indent_log +from pip._internal.utils.setuptools_build import make_setuptools_develop_args +from pip._internal.utils.subprocess import call_subprocess + +logger = logging.getLogger(__name__) + + +def install_editable( + *, + global_options: Sequence[str], + prefix: Optional[str], + home: Optional[str], + use_user_site: bool, + name: str, + setup_py_path: str, + isolated: bool, + build_env: BuildEnvironment, + unpacked_source_directory: str, +) -> None: + """Install a package in editable mode. Most arguments are pass-through + to setuptools. + """ + logger.info("Running setup.py develop for %s", name) + + args = make_setuptools_develop_args( + setup_py_path, + global_options=global_options, + no_user_config=isolated, + prefix=prefix, + home=home, + use_user_site=use_user_site, + ) + + with indent_log(): + with build_env: + call_subprocess( + args, + command_desc="python setup.py develop", + cwd=unpacked_source_directory, + ) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/operations/install/wheel.py b/.venv/lib/python3.12/site-packages/pip/_internal/operations/install/wheel.py new file mode 100644 index 0000000..aef42aa --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/operations/install/wheel.py @@ -0,0 +1,741 @@ +"""Support for installing and building the "wheel" binary package format. +""" + +import collections +import compileall +import contextlib +import csv +import importlib +import logging +import os.path +import re +import shutil +import sys +import warnings +from base64 import urlsafe_b64encode +from email.message import Message +from itertools import chain, filterfalse, starmap +from typing import ( + IO, + TYPE_CHECKING, + Any, + BinaryIO, + Callable, + Dict, + Generator, + Iterable, + Iterator, + List, + NewType, + Optional, + Protocol, + Sequence, + Set, + Tuple, + Union, + cast, +) +from zipfile import ZipFile, ZipInfo + +from pip._vendor.distlib.scripts import ScriptMaker +from pip._vendor.distlib.util import get_export_entry +from pip._vendor.packaging.utils import canonicalize_name + +from pip._internal.exceptions import InstallationError +from pip._internal.locations import get_major_minor_version +from pip._internal.metadata import ( + BaseDistribution, + FilesystemWheel, + get_wheel_distribution, +) +from pip._internal.models.direct_url import DIRECT_URL_METADATA_NAME, DirectUrl +from pip._internal.models.scheme import SCHEME_KEYS, Scheme +from pip._internal.utils.filesystem import adjacent_tmp_file, replace +from pip._internal.utils.misc import StreamWrapper, ensure_dir, hash_file, partition +from pip._internal.utils.unpacking import ( + current_umask, + is_within_directory, + set_extracted_file_to_default_mode_plus_executable, + zip_item_is_executable, +) +from pip._internal.utils.wheel import parse_wheel + +if TYPE_CHECKING: + + class File(Protocol): + src_record_path: "RecordPath" + dest_path: str + changed: bool + + def save(self) -> None: + pass + + +logger = logging.getLogger(__name__) + +RecordPath = NewType("RecordPath", str) +InstalledCSVRow = Tuple[RecordPath, str, Union[int, str]] + + +def rehash(path: str, blocksize: int = 1 << 20) -> Tuple[str, str]: + """Return (encoded_digest, length) for path using hashlib.sha256()""" + h, length = hash_file(path, blocksize) + digest = "sha256=" + urlsafe_b64encode(h.digest()).decode("latin1").rstrip("=") + return (digest, str(length)) + + +def csv_io_kwargs(mode: str) -> Dict[str, Any]: + """Return keyword arguments to properly open a CSV file + in the given mode. + """ + return {"mode": mode, "newline": "", "encoding": "utf-8"} + + +def fix_script(path: str) -> bool: + """Replace #!python with #!/path/to/python + Return True if file was changed. + """ + # XXX RECORD hashes will need to be updated + assert os.path.isfile(path) + + with open(path, "rb") as script: + firstline = script.readline() + if not firstline.startswith(b"#!python"): + return False + exename = sys.executable.encode(sys.getfilesystemencoding()) + firstline = b"#!" + exename + os.linesep.encode("ascii") + rest = script.read() + with open(path, "wb") as script: + script.write(firstline) + script.write(rest) + return True + + +def wheel_root_is_purelib(metadata: Message) -> bool: + return metadata.get("Root-Is-Purelib", "").lower() == "true" + + +def get_entrypoints(dist: BaseDistribution) -> Tuple[Dict[str, str], Dict[str, str]]: + console_scripts = {} + gui_scripts = {} + for entry_point in dist.iter_entry_points(): + if entry_point.group == "console_scripts": + console_scripts[entry_point.name] = entry_point.value + elif entry_point.group == "gui_scripts": + gui_scripts[entry_point.name] = entry_point.value + return console_scripts, gui_scripts + + +def message_about_scripts_not_on_PATH(scripts: Sequence[str]) -> Optional[str]: + """Determine if any scripts are not on PATH and format a warning. + Returns a warning message if one or more scripts are not on PATH, + otherwise None. + """ + if not scripts: + return None + + # Group scripts by the path they were installed in + grouped_by_dir: Dict[str, Set[str]] = collections.defaultdict(set) + for destfile in scripts: + parent_dir = os.path.dirname(destfile) + script_name = os.path.basename(destfile) + grouped_by_dir[parent_dir].add(script_name) + + # We don't want to warn for directories that are on PATH. + not_warn_dirs = [ + os.path.normcase(os.path.normpath(i)).rstrip(os.sep) + for i in os.environ.get("PATH", "").split(os.pathsep) + ] + # If an executable sits with sys.executable, we don't warn for it. + # This covers the case of venv invocations without activating the venv. + not_warn_dirs.append( + os.path.normcase(os.path.normpath(os.path.dirname(sys.executable))) + ) + warn_for: Dict[str, Set[str]] = { + parent_dir: scripts + for parent_dir, scripts in grouped_by_dir.items() + if os.path.normcase(os.path.normpath(parent_dir)) not in not_warn_dirs + } + if not warn_for: + return None + + # Format a message + msg_lines = [] + for parent_dir, dir_scripts in warn_for.items(): + sorted_scripts: List[str] = sorted(dir_scripts) + if len(sorted_scripts) == 1: + start_text = f"script {sorted_scripts[0]} is" + else: + start_text = "scripts {} are".format( + ", ".join(sorted_scripts[:-1]) + " and " + sorted_scripts[-1] + ) + + msg_lines.append( + f"The {start_text} installed in '{parent_dir}' which is not on PATH." + ) + + last_line_fmt = ( + "Consider adding {} to PATH or, if you prefer " + "to suppress this warning, use --no-warn-script-location." + ) + if len(msg_lines) == 1: + msg_lines.append(last_line_fmt.format("this directory")) + else: + msg_lines.append(last_line_fmt.format("these directories")) + + # Add a note if any directory starts with ~ + warn_for_tilde = any( + i[0] == "~" for i in os.environ.get("PATH", "").split(os.pathsep) if i + ) + if warn_for_tilde: + tilde_warning_msg = ( + "NOTE: The current PATH contains path(s) starting with `~`, " + "which may not be expanded by all applications." + ) + msg_lines.append(tilde_warning_msg) + + # Returns the formatted multiline message + return "\n".join(msg_lines) + + +def _normalized_outrows( + outrows: Iterable[InstalledCSVRow], +) -> List[Tuple[str, str, str]]: + """Normalize the given rows of a RECORD file. + + Items in each row are converted into str. Rows are then sorted to make + the value more predictable for tests. + + Each row is a 3-tuple (path, hash, size) and corresponds to a record of + a RECORD file (see PEP 376 and PEP 427 for details). For the rows + passed to this function, the size can be an integer as an int or string, + or the empty string. + """ + # Normally, there should only be one row per path, in which case the + # second and third elements don't come into play when sorting. + # However, in cases in the wild where a path might happen to occur twice, + # we don't want the sort operation to trigger an error (but still want + # determinism). Since the third element can be an int or string, we + # coerce each element to a string to avoid a TypeError in this case. + # For additional background, see-- + # https://github.com/pypa/pip/issues/5868 + return sorted( + (record_path, hash_, str(size)) for record_path, hash_, size in outrows + ) + + +def _record_to_fs_path(record_path: RecordPath, lib_dir: str) -> str: + return os.path.join(lib_dir, record_path) + + +def _fs_to_record_path(path: str, lib_dir: str) -> RecordPath: + # On Windows, do not handle relative paths if they belong to different + # logical disks + if os.path.splitdrive(path)[0].lower() == os.path.splitdrive(lib_dir)[0].lower(): + path = os.path.relpath(path, lib_dir) + + path = path.replace(os.path.sep, "/") + return cast("RecordPath", path) + + +def get_csv_rows_for_installed( + old_csv_rows: List[List[str]], + installed: Dict[RecordPath, RecordPath], + changed: Set[RecordPath], + generated: List[str], + lib_dir: str, +) -> List[InstalledCSVRow]: + """ + :param installed: A map from archive RECORD path to installation RECORD + path. + """ + installed_rows: List[InstalledCSVRow] = [] + for row in old_csv_rows: + if len(row) > 3: + logger.warning("RECORD line has more than three elements: %s", row) + old_record_path = cast("RecordPath", row[0]) + new_record_path = installed.pop(old_record_path, old_record_path) + if new_record_path in changed: + digest, length = rehash(_record_to_fs_path(new_record_path, lib_dir)) + else: + digest = row[1] if len(row) > 1 else "" + length = row[2] if len(row) > 2 else "" + installed_rows.append((new_record_path, digest, length)) + for f in generated: + path = _fs_to_record_path(f, lib_dir) + digest, length = rehash(f) + installed_rows.append((path, digest, length)) + return installed_rows + [ + (installed_record_path, "", "") for installed_record_path in installed.values() + ] + + +def get_console_script_specs(console: Dict[str, str]) -> List[str]: + """ + Given the mapping from entrypoint name to callable, return the relevant + console script specs. + """ + # Don't mutate caller's version + console = console.copy() + + scripts_to_generate = [] + + # Special case pip and setuptools to generate versioned wrappers + # + # The issue is that some projects (specifically, pip and setuptools) use + # code in setup.py to create "versioned" entry points - pip2.7 on Python + # 2.7, pip3.3 on Python 3.3, etc. But these entry points are baked into + # the wheel metadata at build time, and so if the wheel is installed with + # a *different* version of Python the entry points will be wrong. The + # correct fix for this is to enhance the metadata to be able to describe + # such versioned entry points. + # Currently, projects using versioned entry points will either have + # incorrect versioned entry points, or they will not be able to distribute + # "universal" wheels (i.e., they will need a wheel per Python version). + # + # Because setuptools and pip are bundled with _ensurepip and virtualenv, + # we need to use universal wheels. As a workaround, we + # override the versioned entry points in the wheel and generate the + # correct ones. + # + # To add the level of hack in this section of code, in order to support + # ensurepip this code will look for an ``ENSUREPIP_OPTIONS`` environment + # variable which will control which version scripts get installed. + # + # ENSUREPIP_OPTIONS=altinstall + # - Only pipX.Y and easy_install-X.Y will be generated and installed + # ENSUREPIP_OPTIONS=install + # - pipX.Y, pipX, easy_install-X.Y will be generated and installed. Note + # that this option is technically if ENSUREPIP_OPTIONS is set and is + # not altinstall + # DEFAULT + # - The default behavior is to install pip, pipX, pipX.Y, easy_install + # and easy_install-X.Y. + pip_script = console.pop("pip", None) + if pip_script: + if "ENSUREPIP_OPTIONS" not in os.environ: + scripts_to_generate.append("pip = " + pip_script) + + if os.environ.get("ENSUREPIP_OPTIONS", "") != "altinstall": + scripts_to_generate.append(f"pip{sys.version_info[0]} = {pip_script}") + + scripts_to_generate.append(f"pip{get_major_minor_version()} = {pip_script}") + # Delete any other versioned pip entry points + pip_ep = [k for k in console if re.match(r"pip(\d+(\.\d+)?)?$", k)] + for k in pip_ep: + del console[k] + easy_install_script = console.pop("easy_install", None) + if easy_install_script: + if "ENSUREPIP_OPTIONS" not in os.environ: + scripts_to_generate.append("easy_install = " + easy_install_script) + + scripts_to_generate.append( + f"easy_install-{get_major_minor_version()} = {easy_install_script}" + ) + # Delete any other versioned easy_install entry points + easy_install_ep = [ + k for k in console if re.match(r"easy_install(-\d+\.\d+)?$", k) + ] + for k in easy_install_ep: + del console[k] + + # Generate the console entry points specified in the wheel + scripts_to_generate.extend(starmap("{} = {}".format, console.items())) + + return scripts_to_generate + + +class ZipBackedFile: + def __init__( + self, src_record_path: RecordPath, dest_path: str, zip_file: ZipFile + ) -> None: + self.src_record_path = src_record_path + self.dest_path = dest_path + self._zip_file = zip_file + self.changed = False + + def _getinfo(self) -> ZipInfo: + return self._zip_file.getinfo(self.src_record_path) + + def save(self) -> None: + # When we open the output file below, any existing file is truncated + # before we start writing the new contents. This is fine in most + # cases, but can cause a segfault if pip has loaded a shared + # object (e.g. from pyopenssl through its vendored urllib3) + # Since the shared object is mmap'd an attempt to call a + # symbol in it will then cause a segfault. Unlinking the file + # allows writing of new contents while allowing the process to + # continue to use the old copy. + if os.path.exists(self.dest_path): + os.unlink(self.dest_path) + + zipinfo = self._getinfo() + + # optimization: the file is created by open(), + # skip the decompression when there is 0 bytes to decompress. + with open(self.dest_path, "wb") as dest: + if zipinfo.file_size > 0: + with self._zip_file.open(zipinfo) as f: + blocksize = min(zipinfo.file_size, 1024 * 1024) + shutil.copyfileobj(f, dest, blocksize) + + if zip_item_is_executable(zipinfo): + set_extracted_file_to_default_mode_plus_executable(self.dest_path) + + +class ScriptFile: + def __init__(self, file: "File") -> None: + self._file = file + self.src_record_path = self._file.src_record_path + self.dest_path = self._file.dest_path + self.changed = False + + def save(self) -> None: + self._file.save() + self.changed = fix_script(self.dest_path) + + +class MissingCallableSuffix(InstallationError): + def __init__(self, entry_point: str) -> None: + super().__init__( + f"Invalid script entry point: {entry_point} - A callable " + "suffix is required. Cf https://packaging.python.org/" + "specifications/entry-points/#use-for-scripts for more " + "information." + ) + + +def _raise_for_invalid_entrypoint(specification: str) -> None: + entry = get_export_entry(specification) + if entry is not None and entry.suffix is None: + raise MissingCallableSuffix(str(entry)) + + +class PipScriptMaker(ScriptMaker): + def make( + self, specification: str, options: Optional[Dict[str, Any]] = None + ) -> List[str]: + _raise_for_invalid_entrypoint(specification) + return super().make(specification, options) + + +def _install_wheel( # noqa: C901, PLR0915 function is too long + name: str, + wheel_zip: ZipFile, + wheel_path: str, + scheme: Scheme, + pycompile: bool = True, + warn_script_location: bool = True, + direct_url: Optional[DirectUrl] = None, + requested: bool = False, +) -> None: + """Install a wheel. + + :param name: Name of the project to install + :param wheel_zip: open ZipFile for wheel being installed + :param scheme: Distutils scheme dictating the install directories + :param req_description: String used in place of the requirement, for + logging + :param pycompile: Whether to byte-compile installed Python files + :param warn_script_location: Whether to check that scripts are installed + into a directory on PATH + :raises UnsupportedWheel: + * when the directory holds an unpacked wheel with incompatible + Wheel-Version + * when the .dist-info dir does not match the wheel + """ + info_dir, metadata = parse_wheel(wheel_zip, name) + + if wheel_root_is_purelib(metadata): + lib_dir = scheme.purelib + else: + lib_dir = scheme.platlib + + # Record details of the files moved + # installed = files copied from the wheel to the destination + # changed = files changed while installing (scripts #! line typically) + # generated = files newly generated during the install (script wrappers) + installed: Dict[RecordPath, RecordPath] = {} + changed: Set[RecordPath] = set() + generated: List[str] = [] + + def record_installed( + srcfile: RecordPath, destfile: str, modified: bool = False + ) -> None: + """Map archive RECORD paths to installation RECORD paths.""" + newpath = _fs_to_record_path(destfile, lib_dir) + installed[srcfile] = newpath + if modified: + changed.add(newpath) + + def is_dir_path(path: RecordPath) -> bool: + return path.endswith("/") + + def assert_no_path_traversal(dest_dir_path: str, target_path: str) -> None: + if not is_within_directory(dest_dir_path, target_path): + message = ( + "The wheel {!r} has a file {!r} trying to install" + " outside the target directory {!r}" + ) + raise InstallationError( + message.format(wheel_path, target_path, dest_dir_path) + ) + + def root_scheme_file_maker( + zip_file: ZipFile, dest: str + ) -> Callable[[RecordPath], "File"]: + def make_root_scheme_file(record_path: RecordPath) -> "File": + normed_path = os.path.normpath(record_path) + dest_path = os.path.join(dest, normed_path) + assert_no_path_traversal(dest, dest_path) + return ZipBackedFile(record_path, dest_path, zip_file) + + return make_root_scheme_file + + def data_scheme_file_maker( + zip_file: ZipFile, scheme: Scheme + ) -> Callable[[RecordPath], "File"]: + scheme_paths = {key: getattr(scheme, key) for key in SCHEME_KEYS} + + def make_data_scheme_file(record_path: RecordPath) -> "File": + normed_path = os.path.normpath(record_path) + try: + _, scheme_key, dest_subpath = normed_path.split(os.path.sep, 2) + except ValueError: + message = ( + f"Unexpected file in {wheel_path}: {record_path!r}. .data directory" + " contents should be named like: '/'." + ) + raise InstallationError(message) + + try: + scheme_path = scheme_paths[scheme_key] + except KeyError: + valid_scheme_keys = ", ".join(sorted(scheme_paths)) + message = ( + f"Unknown scheme key used in {wheel_path}: {scheme_key} " + f"(for file {record_path!r}). .data directory contents " + f"should be in subdirectories named with a valid scheme " + f"key ({valid_scheme_keys})" + ) + raise InstallationError(message) + + dest_path = os.path.join(scheme_path, dest_subpath) + assert_no_path_traversal(scheme_path, dest_path) + return ZipBackedFile(record_path, dest_path, zip_file) + + return make_data_scheme_file + + def is_data_scheme_path(path: RecordPath) -> bool: + return path.split("/", 1)[0].endswith(".data") + + paths = cast(List[RecordPath], wheel_zip.namelist()) + file_paths = filterfalse(is_dir_path, paths) + root_scheme_paths, data_scheme_paths = partition(is_data_scheme_path, file_paths) + + make_root_scheme_file = root_scheme_file_maker(wheel_zip, lib_dir) + files: Iterator[File] = map(make_root_scheme_file, root_scheme_paths) + + def is_script_scheme_path(path: RecordPath) -> bool: + parts = path.split("/", 2) + return len(parts) > 2 and parts[0].endswith(".data") and parts[1] == "scripts" + + other_scheme_paths, script_scheme_paths = partition( + is_script_scheme_path, data_scheme_paths + ) + + make_data_scheme_file = data_scheme_file_maker(wheel_zip, scheme) + other_scheme_files = map(make_data_scheme_file, other_scheme_paths) + files = chain(files, other_scheme_files) + + # Get the defined entry points + distribution = get_wheel_distribution( + FilesystemWheel(wheel_path), + canonicalize_name(name), + ) + console, gui = get_entrypoints(distribution) + + def is_entrypoint_wrapper(file: "File") -> bool: + # EP, EP.exe and EP-script.py are scripts generated for + # entry point EP by setuptools + path = file.dest_path + name = os.path.basename(path) + if name.lower().endswith(".exe"): + matchname = name[:-4] + elif name.lower().endswith("-script.py"): + matchname = name[:-10] + elif name.lower().endswith(".pya"): + matchname = name[:-4] + else: + matchname = name + # Ignore setuptools-generated scripts + return matchname in console or matchname in gui + + script_scheme_files: Iterator[File] = map( + make_data_scheme_file, script_scheme_paths + ) + script_scheme_files = filterfalse(is_entrypoint_wrapper, script_scheme_files) + script_scheme_files = map(ScriptFile, script_scheme_files) + files = chain(files, script_scheme_files) + + existing_parents = set() + for file in files: + # directory creation is lazy and after file filtering + # to ensure we don't install empty dirs; empty dirs can't be + # uninstalled. + parent_dir = os.path.dirname(file.dest_path) + if parent_dir not in existing_parents: + ensure_dir(parent_dir) + existing_parents.add(parent_dir) + file.save() + record_installed(file.src_record_path, file.dest_path, file.changed) + + def pyc_source_file_paths() -> Generator[str, None, None]: + # We de-duplicate installation paths, since there can be overlap (e.g. + # file in .data maps to same location as file in wheel root). + # Sorting installation paths makes it easier to reproduce and debug + # issues related to permissions on existing files. + for installed_path in sorted(set(installed.values())): + full_installed_path = os.path.join(lib_dir, installed_path) + if not os.path.isfile(full_installed_path): + continue + if not full_installed_path.endswith(".py"): + continue + yield full_installed_path + + def pyc_output_path(path: str) -> str: + """Return the path the pyc file would have been written to.""" + return importlib.util.cache_from_source(path) + + # Compile all of the pyc files for the installed files + if pycompile: + with contextlib.redirect_stdout( + StreamWrapper.from_stream(sys.stdout) + ) as stdout: + with warnings.catch_warnings(): + warnings.filterwarnings("ignore") + for path in pyc_source_file_paths(): + success = compileall.compile_file(path, force=True, quiet=True) + if success: + pyc_path = pyc_output_path(path) + assert os.path.exists(pyc_path) + pyc_record_path = cast( + "RecordPath", pyc_path.replace(os.path.sep, "/") + ) + record_installed(pyc_record_path, pyc_path) + logger.debug(stdout.getvalue()) + + maker = PipScriptMaker(None, scheme.scripts) + + # Ensure old scripts are overwritten. + # See https://github.com/pypa/pip/issues/1800 + maker.clobber = True + + # Ensure we don't generate any variants for scripts because this is almost + # never what somebody wants. + # See https://bitbucket.org/pypa/distlib/issue/35/ + maker.variants = {""} + + # This is required because otherwise distlib creates scripts that are not + # executable. + # See https://bitbucket.org/pypa/distlib/issue/32/ + maker.set_mode = True + + # Generate the console and GUI entry points specified in the wheel + scripts_to_generate = get_console_script_specs(console) + + gui_scripts_to_generate = list(starmap("{} = {}".format, gui.items())) + + generated_console_scripts = maker.make_multiple(scripts_to_generate) + generated.extend(generated_console_scripts) + + generated.extend(maker.make_multiple(gui_scripts_to_generate, {"gui": True})) + + if warn_script_location: + msg = message_about_scripts_not_on_PATH(generated_console_scripts) + if msg is not None: + logger.warning(msg) + + generated_file_mode = 0o666 & ~current_umask() + + @contextlib.contextmanager + def _generate_file(path: str, **kwargs: Any) -> Generator[BinaryIO, None, None]: + with adjacent_tmp_file(path, **kwargs) as f: + yield f + os.chmod(f.name, generated_file_mode) + replace(f.name, path) + + dest_info_dir = os.path.join(lib_dir, info_dir) + + # Record pip as the installer + installer_path = os.path.join(dest_info_dir, "INSTALLER") + with _generate_file(installer_path) as installer_file: + installer_file.write(b"pip\n") + generated.append(installer_path) + + # Record the PEP 610 direct URL reference + if direct_url is not None: + direct_url_path = os.path.join(dest_info_dir, DIRECT_URL_METADATA_NAME) + with _generate_file(direct_url_path) as direct_url_file: + direct_url_file.write(direct_url.to_json().encode("utf-8")) + generated.append(direct_url_path) + + # Record the REQUESTED file + if requested: + requested_path = os.path.join(dest_info_dir, "REQUESTED") + with open(requested_path, "wb"): + pass + generated.append(requested_path) + + record_text = distribution.read_text("RECORD") + record_rows = list(csv.reader(record_text.splitlines())) + + rows = get_csv_rows_for_installed( + record_rows, + installed=installed, + changed=changed, + generated=generated, + lib_dir=lib_dir, + ) + + # Record details of all files installed + record_path = os.path.join(dest_info_dir, "RECORD") + + with _generate_file(record_path, **csv_io_kwargs("w")) as record_file: + # Explicitly cast to typing.IO[str] as a workaround for the mypy error: + # "writer" has incompatible type "BinaryIO"; expected "_Writer" + writer = csv.writer(cast("IO[str]", record_file)) + writer.writerows(_normalized_outrows(rows)) + + +@contextlib.contextmanager +def req_error_context(req_description: str) -> Generator[None, None, None]: + try: + yield + except InstallationError as e: + message = f"For req: {req_description}. {e.args[0]}" + raise InstallationError(message) from e + + +def install_wheel( + name: str, + wheel_path: str, + scheme: Scheme, + req_description: str, + pycompile: bool = True, + warn_script_location: bool = True, + direct_url: Optional[DirectUrl] = None, + requested: bool = False, +) -> None: + with ZipFile(wheel_path, allowZip64=True) as z: + with req_error_context(req_description): + _install_wheel( + name=name, + wheel_zip=z, + wheel_path=wheel_path, + scheme=scheme, + pycompile=pycompile, + warn_script_location=warn_script_location, + direct_url=direct_url, + requested=requested, + ) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/operations/prepare.py b/.venv/lib/python3.12/site-packages/pip/_internal/operations/prepare.py new file mode 100644 index 0000000..e6aa344 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/operations/prepare.py @@ -0,0 +1,732 @@ +"""Prepares a distribution for installation +""" + +# The following comment should be removed at some point in the future. +# mypy: strict-optional=False + +import mimetypes +import os +import shutil +from dataclasses import dataclass +from pathlib import Path +from typing import Dict, Iterable, List, Optional + +from pip._vendor.packaging.utils import canonicalize_name + +from pip._internal.distributions import make_distribution_for_install_requirement +from pip._internal.distributions.installed import InstalledDistribution +from pip._internal.exceptions import ( + DirectoryUrlHashUnsupported, + HashMismatch, + HashUnpinned, + InstallationError, + MetadataInconsistent, + NetworkConnectionError, + VcsHashUnsupported, +) +from pip._internal.index.package_finder import PackageFinder +from pip._internal.metadata import BaseDistribution, get_metadata_distribution +from pip._internal.models.direct_url import ArchiveInfo +from pip._internal.models.link import Link +from pip._internal.models.wheel import Wheel +from pip._internal.network.download import BatchDownloader, Downloader +from pip._internal.network.lazy_wheel import ( + HTTPRangeRequestUnsupported, + dist_from_wheel_url, +) +from pip._internal.network.session import PipSession +from pip._internal.operations.build.build_tracker import BuildTracker +from pip._internal.req.req_install import InstallRequirement +from pip._internal.utils._log import getLogger +from pip._internal.utils.direct_url_helpers import ( + direct_url_for_editable, + direct_url_from_link, +) +from pip._internal.utils.hashes import Hashes, MissingHashes +from pip._internal.utils.logging import indent_log +from pip._internal.utils.misc import ( + display_path, + hash_file, + hide_url, + redact_auth_from_requirement, +) +from pip._internal.utils.temp_dir import TempDirectory +from pip._internal.utils.unpacking import unpack_file +from pip._internal.vcs import vcs + +logger = getLogger(__name__) + + +def _get_prepared_distribution( + req: InstallRequirement, + build_tracker: BuildTracker, + finder: PackageFinder, + build_isolation: bool, + check_build_deps: bool, +) -> BaseDistribution: + """Prepare a distribution for installation.""" + abstract_dist = make_distribution_for_install_requirement(req) + tracker_id = abstract_dist.build_tracker_id + if tracker_id is not None: + with build_tracker.track(req, tracker_id): + abstract_dist.prepare_distribution_metadata( + finder, build_isolation, check_build_deps + ) + return abstract_dist.get_metadata_distribution() + + +def unpack_vcs_link(link: Link, location: str, verbosity: int) -> None: + vcs_backend = vcs.get_backend_for_scheme(link.scheme) + assert vcs_backend is not None + vcs_backend.unpack(location, url=hide_url(link.url), verbosity=verbosity) + + +@dataclass +class File: + path: str + content_type: Optional[str] = None + + def __post_init__(self) -> None: + if self.content_type is None: + self.content_type = mimetypes.guess_type(self.path)[0] + + +def get_http_url( + link: Link, + download: Downloader, + download_dir: Optional[str] = None, + hashes: Optional[Hashes] = None, +) -> File: + temp_dir = TempDirectory(kind="unpack", globally_managed=True) + # If a download dir is specified, is the file already downloaded there? + already_downloaded_path = None + if download_dir: + already_downloaded_path = _check_download_dir(link, download_dir, hashes) + + if already_downloaded_path: + from_path = already_downloaded_path + content_type = None + else: + # let's download to a tmp dir + from_path, content_type = download(link, temp_dir.path) + if hashes: + hashes.check_against_path(from_path) + + return File(from_path, content_type) + + +def get_file_url( + link: Link, download_dir: Optional[str] = None, hashes: Optional[Hashes] = None +) -> File: + """Get file and optionally check its hash.""" + # If a download dir is specified, is the file already there and valid? + already_downloaded_path = None + if download_dir: + already_downloaded_path = _check_download_dir(link, download_dir, hashes) + + if already_downloaded_path: + from_path = already_downloaded_path + else: + from_path = link.file_path + + # If --require-hashes is off, `hashes` is either empty, the + # link's embedded hash, or MissingHashes; it is required to + # match. If --require-hashes is on, we are satisfied by any + # hash in `hashes` matching: a URL-based or an option-based + # one; no internet-sourced hash will be in `hashes`. + if hashes: + hashes.check_against_path(from_path) + return File(from_path, None) + + +def unpack_url( + link: Link, + location: str, + download: Downloader, + verbosity: int, + download_dir: Optional[str] = None, + hashes: Optional[Hashes] = None, +) -> Optional[File]: + """Unpack link into location, downloading if required. + + :param hashes: A Hashes object, one of whose embedded hashes must match, + or HashMismatch will be raised. If the Hashes is empty, no matches are + required, and unhashable types of requirements (like VCS ones, which + would ordinarily raise HashUnsupported) are allowed. + """ + # non-editable vcs urls + if link.is_vcs: + unpack_vcs_link(link, location, verbosity=verbosity) + return None + + assert not link.is_existing_dir() + + # file urls + if link.is_file: + file = get_file_url(link, download_dir, hashes=hashes) + + # http urls + else: + file = get_http_url( + link, + download, + download_dir, + hashes=hashes, + ) + + # unpack the archive to the build dir location. even when only downloading + # archives, they have to be unpacked to parse dependencies, except wheels + if not link.is_wheel: + unpack_file(file.path, location, file.content_type) + + return file + + +def _check_download_dir( + link: Link, + download_dir: str, + hashes: Optional[Hashes], + warn_on_hash_mismatch: bool = True, +) -> Optional[str]: + """Check download_dir for previously downloaded file with correct hash + If a correct file is found return its path else None + """ + download_path = os.path.join(download_dir, link.filename) + + if not os.path.exists(download_path): + return None + + # If already downloaded, does its hash match? + logger.info("File was already downloaded %s", download_path) + if hashes: + try: + hashes.check_against_path(download_path) + except HashMismatch: + if warn_on_hash_mismatch: + logger.warning( + "Previously-downloaded file %s has bad hash. Re-downloading.", + download_path, + ) + os.unlink(download_path) + return None + return download_path + + +class RequirementPreparer: + """Prepares a Requirement""" + + def __init__( + self, + build_dir: str, + download_dir: Optional[str], + src_dir: str, + build_isolation: bool, + check_build_deps: bool, + build_tracker: BuildTracker, + session: PipSession, + progress_bar: str, + finder: PackageFinder, + require_hashes: bool, + use_user_site: bool, + lazy_wheel: bool, + verbosity: int, + legacy_resolver: bool, + ) -> None: + super().__init__() + + self.src_dir = src_dir + self.build_dir = build_dir + self.build_tracker = build_tracker + self._session = session + self._download = Downloader(session, progress_bar) + self._batch_download = BatchDownloader(session, progress_bar) + self.finder = finder + + # Where still-packed archives should be written to. If None, they are + # not saved, and are deleted immediately after unpacking. + self.download_dir = download_dir + + # Is build isolation allowed? + self.build_isolation = build_isolation + + # Should check build dependencies? + self.check_build_deps = check_build_deps + + # Should hash-checking be required? + self.require_hashes = require_hashes + + # Should install in user site-packages? + self.use_user_site = use_user_site + + # Should wheels be downloaded lazily? + self.use_lazy_wheel = lazy_wheel + + # How verbose should underlying tooling be? + self.verbosity = verbosity + + # Are we using the legacy resolver? + self.legacy_resolver = legacy_resolver + + # Memoized downloaded files, as mapping of url: path. + self._downloaded: Dict[str, str] = {} + + # Previous "header" printed for a link-based InstallRequirement + self._previous_requirement_header = ("", "") + + def _log_preparing_link(self, req: InstallRequirement) -> None: + """Provide context for the requirement being prepared.""" + if req.link.is_file and not req.is_wheel_from_cache: + message = "Processing %s" + information = str(display_path(req.link.file_path)) + else: + message = "Collecting %s" + information = redact_auth_from_requirement(req.req) if req.req else str(req) + + # If we used req.req, inject requirement source if available (this + # would already be included if we used req directly) + if req.req and req.comes_from: + if isinstance(req.comes_from, str): + comes_from: Optional[str] = req.comes_from + else: + comes_from = req.comes_from.from_path() + if comes_from: + information += f" (from {comes_from})" + + if (message, information) != self._previous_requirement_header: + self._previous_requirement_header = (message, information) + logger.info(message, information) + + if req.is_wheel_from_cache: + with indent_log(): + logger.info("Using cached %s", req.link.filename) + + def _ensure_link_req_src_dir( + self, req: InstallRequirement, parallel_builds: bool + ) -> None: + """Ensure source_dir of a linked InstallRequirement.""" + # Since source_dir is only set for editable requirements. + if req.link.is_wheel: + # We don't need to unpack wheels, so no need for a source + # directory. + return + assert req.source_dir is None + if req.link.is_existing_dir(): + # build local directories in-tree + req.source_dir = req.link.file_path + return + + # We always delete unpacked sdists after pip runs. + req.ensure_has_source_dir( + self.build_dir, + autodelete=True, + parallel_builds=parallel_builds, + ) + req.ensure_pristine_source_checkout() + + def _get_linked_req_hashes(self, req: InstallRequirement) -> Hashes: + # By the time this is called, the requirement's link should have + # been checked so we can tell what kind of requirements req is + # and raise some more informative errors than otherwise. + # (For example, we can raise VcsHashUnsupported for a VCS URL + # rather than HashMissing.) + if not self.require_hashes: + return req.hashes(trust_internet=True) + + # We could check these first 2 conditions inside unpack_url + # and save repetition of conditions, but then we would + # report less-useful error messages for unhashable + # requirements, complaining that there's no hash provided. + if req.link.is_vcs: + raise VcsHashUnsupported() + if req.link.is_existing_dir(): + raise DirectoryUrlHashUnsupported() + + # Unpinned packages are asking for trouble when a new version + # is uploaded. This isn't a security check, but it saves users + # a surprising hash mismatch in the future. + # file:/// URLs aren't pinnable, so don't complain about them + # not being pinned. + if not req.is_direct and not req.is_pinned: + raise HashUnpinned() + + # If known-good hashes are missing for this requirement, + # shim it with a facade object that will provoke hash + # computation and then raise a HashMissing exception + # showing the user what the hash should be. + return req.hashes(trust_internet=False) or MissingHashes() + + def _fetch_metadata_only( + self, + req: InstallRequirement, + ) -> Optional[BaseDistribution]: + if self.legacy_resolver: + logger.debug( + "Metadata-only fetching is not used in the legacy resolver", + ) + return None + if self.require_hashes: + logger.debug( + "Metadata-only fetching is not used as hash checking is required", + ) + return None + # Try PEP 658 metadata first, then fall back to lazy wheel if unavailable. + return self._fetch_metadata_using_link_data_attr( + req + ) or self._fetch_metadata_using_lazy_wheel(req.link) + + def _fetch_metadata_using_link_data_attr( + self, + req: InstallRequirement, + ) -> Optional[BaseDistribution]: + """Fetch metadata from the data-dist-info-metadata attribute, if possible.""" + # (1) Get the link to the metadata file, if provided by the backend. + metadata_link = req.link.metadata_link() + if metadata_link is None: + return None + assert req.req is not None + logger.verbose( + "Obtaining dependency information for %s from %s", + req.req, + metadata_link, + ) + # (2) Download the contents of the METADATA file, separate from the dist itself. + metadata_file = get_http_url( + metadata_link, + self._download, + hashes=metadata_link.as_hashes(), + ) + with open(metadata_file.path, "rb") as f: + metadata_contents = f.read() + # (3) Generate a dist just from those file contents. + metadata_dist = get_metadata_distribution( + metadata_contents, + req.link.filename, + req.req.name, + ) + # (4) Ensure the Name: field from the METADATA file matches the name from the + # install requirement. + # + # NB: raw_name will fall back to the name from the install requirement if + # the Name: field is not present, but it's noted in the raw_name docstring + # that that should NEVER happen anyway. + if canonicalize_name(metadata_dist.raw_name) != canonicalize_name(req.req.name): + raise MetadataInconsistent( + req, "Name", req.req.name, metadata_dist.raw_name + ) + return metadata_dist + + def _fetch_metadata_using_lazy_wheel( + self, + link: Link, + ) -> Optional[BaseDistribution]: + """Fetch metadata using lazy wheel, if possible.""" + # --use-feature=fast-deps must be provided. + if not self.use_lazy_wheel: + return None + if link.is_file or not link.is_wheel: + logger.debug( + "Lazy wheel is not used as %r does not point to a remote wheel", + link, + ) + return None + + wheel = Wheel(link.filename) + name = canonicalize_name(wheel.name) + logger.info( + "Obtaining dependency information from %s %s", + name, + wheel.version, + ) + url = link.url.split("#", 1)[0] + try: + return dist_from_wheel_url(name, url, self._session) + except HTTPRangeRequestUnsupported: + logger.debug("%s does not support range requests", url) + return None + + def _complete_partial_requirements( + self, + partially_downloaded_reqs: Iterable[InstallRequirement], + parallel_builds: bool = False, + ) -> None: + """Download any requirements which were only fetched by metadata.""" + # Download to a temporary directory. These will be copied over as + # needed for downstream 'download', 'wheel', and 'install' commands. + temp_dir = TempDirectory(kind="unpack", globally_managed=True).path + + # Map each link to the requirement that owns it. This allows us to set + # `req.local_file_path` on the appropriate requirement after passing + # all the links at once into BatchDownloader. + links_to_fully_download: Dict[Link, InstallRequirement] = {} + for req in partially_downloaded_reqs: + assert req.link + links_to_fully_download[req.link] = req + + batch_download = self._batch_download( + links_to_fully_download.keys(), + temp_dir, + ) + for link, (filepath, _) in batch_download: + logger.debug("Downloading link %s to %s", link, filepath) + req = links_to_fully_download[link] + # Record the downloaded file path so wheel reqs can extract a Distribution + # in .get_dist(). + req.local_file_path = filepath + # Record that the file is downloaded so we don't do it again in + # _prepare_linked_requirement(). + self._downloaded[req.link.url] = filepath + + # If this is an sdist, we need to unpack it after downloading, but the + # .source_dir won't be set up until we are in _prepare_linked_requirement(). + # Add the downloaded archive to the install requirement to unpack after + # preparing the source dir. + if not req.is_wheel: + req.needs_unpacked_archive(Path(filepath)) + + # This step is necessary to ensure all lazy wheels are processed + # successfully by the 'download', 'wheel', and 'install' commands. + for req in partially_downloaded_reqs: + self._prepare_linked_requirement(req, parallel_builds) + + def prepare_linked_requirement( + self, req: InstallRequirement, parallel_builds: bool = False + ) -> BaseDistribution: + """Prepare a requirement to be obtained from req.link.""" + assert req.link + self._log_preparing_link(req) + with indent_log(): + # Check if the relevant file is already available + # in the download directory + file_path = None + if self.download_dir is not None and req.link.is_wheel: + hashes = self._get_linked_req_hashes(req) + file_path = _check_download_dir( + req.link, + self.download_dir, + hashes, + # When a locally built wheel has been found in cache, we don't warn + # about re-downloading when the already downloaded wheel hash does + # not match. This is because the hash must be checked against the + # original link, not the cached link. It that case the already + # downloaded file will be removed and re-fetched from cache (which + # implies a hash check against the cache entry's origin.json). + warn_on_hash_mismatch=not req.is_wheel_from_cache, + ) + + if file_path is not None: + # The file is already available, so mark it as downloaded + self._downloaded[req.link.url] = file_path + else: + # The file is not available, attempt to fetch only metadata + metadata_dist = self._fetch_metadata_only(req) + if metadata_dist is not None: + req.needs_more_preparation = True + return metadata_dist + + # None of the optimizations worked, fully prepare the requirement + return self._prepare_linked_requirement(req, parallel_builds) + + def prepare_linked_requirements_more( + self, reqs: Iterable[InstallRequirement], parallel_builds: bool = False + ) -> None: + """Prepare linked requirements more, if needed.""" + reqs = [req for req in reqs if req.needs_more_preparation] + for req in reqs: + # Determine if any of these requirements were already downloaded. + if self.download_dir is not None and req.link.is_wheel: + hashes = self._get_linked_req_hashes(req) + file_path = _check_download_dir(req.link, self.download_dir, hashes) + if file_path is not None: + self._downloaded[req.link.url] = file_path + req.needs_more_preparation = False + + # Prepare requirements we found were already downloaded for some + # reason. The other downloads will be completed separately. + partially_downloaded_reqs: List[InstallRequirement] = [] + for req in reqs: + if req.needs_more_preparation: + partially_downloaded_reqs.append(req) + else: + self._prepare_linked_requirement(req, parallel_builds) + + # TODO: separate this part out from RequirementPreparer when the v1 + # resolver can be removed! + self._complete_partial_requirements( + partially_downloaded_reqs, + parallel_builds=parallel_builds, + ) + + def _prepare_linked_requirement( + self, req: InstallRequirement, parallel_builds: bool + ) -> BaseDistribution: + assert req.link + link = req.link + + hashes = self._get_linked_req_hashes(req) + + if hashes and req.is_wheel_from_cache: + assert req.download_info is not None + assert link.is_wheel + assert link.is_file + # We need to verify hashes, and we have found the requirement in the cache + # of locally built wheels. + if ( + isinstance(req.download_info.info, ArchiveInfo) + and req.download_info.info.hashes + and hashes.has_one_of(req.download_info.info.hashes) + ): + # At this point we know the requirement was built from a hashable source + # artifact, and we verified that the cache entry's hash of the original + # artifact matches one of the hashes we expect. We don't verify hashes + # against the cached wheel, because the wheel is not the original. + hashes = None + else: + logger.warning( + "The hashes of the source archive found in cache entry " + "don't match, ignoring cached built wheel " + "and re-downloading source." + ) + req.link = req.cached_wheel_source_link + link = req.link + + self._ensure_link_req_src_dir(req, parallel_builds) + + if link.is_existing_dir(): + local_file = None + elif link.url not in self._downloaded: + try: + local_file = unpack_url( + link, + req.source_dir, + self._download, + self.verbosity, + self.download_dir, + hashes, + ) + except NetworkConnectionError as exc: + raise InstallationError( + f"Could not install requirement {req} because of HTTP " + f"error {exc} for URL {link}" + ) + else: + file_path = self._downloaded[link.url] + if hashes: + hashes.check_against_path(file_path) + local_file = File(file_path, content_type=None) + + # If download_info is set, we got it from the wheel cache. + if req.download_info is None: + # Editables don't go through this function (see + # prepare_editable_requirement). + assert not req.editable + req.download_info = direct_url_from_link(link, req.source_dir) + # Make sure we have a hash in download_info. If we got it as part of the + # URL, it will have been verified and we can rely on it. Otherwise we + # compute it from the downloaded file. + # FIXME: https://github.com/pypa/pip/issues/11943 + if ( + isinstance(req.download_info.info, ArchiveInfo) + and not req.download_info.info.hashes + and local_file + ): + hash = hash_file(local_file.path)[0].hexdigest() + # We populate info.hash for backward compatibility. + # This will automatically populate info.hashes. + req.download_info.info.hash = f"sha256={hash}" + + # For use in later processing, + # preserve the file path on the requirement. + if local_file: + req.local_file_path = local_file.path + + dist = _get_prepared_distribution( + req, + self.build_tracker, + self.finder, + self.build_isolation, + self.check_build_deps, + ) + return dist + + def save_linked_requirement(self, req: InstallRequirement) -> None: + assert self.download_dir is not None + assert req.link is not None + link = req.link + if link.is_vcs or (link.is_existing_dir() and req.editable): + # Make a .zip of the source_dir we already created. + req.archive(self.download_dir) + return + + if link.is_existing_dir(): + logger.debug( + "Not copying link to destination directory " + "since it is a directory: %s", + link, + ) + return + if req.local_file_path is None: + # No distribution was downloaded for this requirement. + return + + download_location = os.path.join(self.download_dir, link.filename) + if not os.path.exists(download_location): + shutil.copy(req.local_file_path, download_location) + download_path = display_path(download_location) + logger.info("Saved %s", download_path) + + def prepare_editable_requirement( + self, + req: InstallRequirement, + ) -> BaseDistribution: + """Prepare an editable requirement.""" + assert req.editable, "cannot prepare a non-editable req as editable" + + logger.info("Obtaining %s", req) + + with indent_log(): + if self.require_hashes: + raise InstallationError( + f"The editable requirement {req} cannot be installed when " + "requiring hashes, because there is no single file to " + "hash." + ) + req.ensure_has_source_dir(self.src_dir) + req.update_editable() + assert req.source_dir + req.download_info = direct_url_for_editable(req.unpacked_source_directory) + + dist = _get_prepared_distribution( + req, + self.build_tracker, + self.finder, + self.build_isolation, + self.check_build_deps, + ) + + req.check_if_exists(self.use_user_site) + + return dist + + def prepare_installed_requirement( + self, + req: InstallRequirement, + skip_reason: str, + ) -> BaseDistribution: + """Prepare an already-installed requirement.""" + assert req.satisfied_by, "req should have been satisfied but isn't" + assert skip_reason is not None, ( + "did not get skip reason skipped but req.satisfied_by " + f"is set to {req.satisfied_by}" + ) + logger.info( + "Requirement %s: %s (%s)", skip_reason, req, req.satisfied_by.version + ) + with indent_log(): + if self.require_hashes: + logger.debug( + "Since it is already installed, we are trusting this " + "package without checking its hash. To ensure a " + "completely repeatable environment, install into an " + "empty virtualenv." + ) + return InstalledDistribution(req).get_metadata_distribution() diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/pyproject.py b/.venv/lib/python3.12/site-packages/pip/_internal/pyproject.py new file mode 100644 index 0000000..2a9cad4 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/pyproject.py @@ -0,0 +1,185 @@ +import importlib.util +import os +import sys +from collections import namedtuple +from typing import Any, List, Optional + +if sys.version_info >= (3, 11): + import tomllib +else: + from pip._vendor import tomli as tomllib + +from pip._vendor.packaging.requirements import InvalidRequirement + +from pip._internal.exceptions import ( + InstallationError, + InvalidPyProjectBuildRequires, + MissingPyProjectBuildRequires, +) +from pip._internal.utils.packaging import get_requirement + + +def _is_list_of_str(obj: Any) -> bool: + return isinstance(obj, list) and all(isinstance(item, str) for item in obj) + + +def make_pyproject_path(unpacked_source_directory: str) -> str: + return os.path.join(unpacked_source_directory, "pyproject.toml") + + +BuildSystemDetails = namedtuple( + "BuildSystemDetails", ["requires", "backend", "check", "backend_path"] +) + + +def load_pyproject_toml( + use_pep517: Optional[bool], pyproject_toml: str, setup_py: str, req_name: str +) -> Optional[BuildSystemDetails]: + """Load the pyproject.toml file. + + Parameters: + use_pep517 - Has the user requested PEP 517 processing? None + means the user hasn't explicitly specified. + pyproject_toml - Location of the project's pyproject.toml file + setup_py - Location of the project's setup.py file + req_name - The name of the requirement we're processing (for + error reporting) + + Returns: + None if we should use the legacy code path, otherwise a tuple + ( + requirements from pyproject.toml, + name of PEP 517 backend, + requirements we should check are installed after setting + up the build environment + directory paths to import the backend from (backend-path), + relative to the project root. + ) + """ + has_pyproject = os.path.isfile(pyproject_toml) + has_setup = os.path.isfile(setup_py) + + if not has_pyproject and not has_setup: + raise InstallationError( + f"{req_name} does not appear to be a Python project: " + f"neither 'setup.py' nor 'pyproject.toml' found." + ) + + if has_pyproject: + with open(pyproject_toml, encoding="utf-8") as f: + pp_toml = tomllib.loads(f.read()) + build_system = pp_toml.get("build-system") + else: + build_system = None + + # The following cases must use PEP 517 + # We check for use_pep517 being non-None and falsey because that means + # the user explicitly requested --no-use-pep517. The value 0 as + # opposed to False can occur when the value is provided via an + # environment variable or config file option (due to the quirk of + # strtobool() returning an integer in pip's configuration code). + if has_pyproject and not has_setup: + if use_pep517 is not None and not use_pep517: + raise InstallationError( + "Disabling PEP 517 processing is invalid: " + "project does not have a setup.py" + ) + use_pep517 = True + elif build_system and "build-backend" in build_system: + if use_pep517 is not None and not use_pep517: + raise InstallationError( + "Disabling PEP 517 processing is invalid: " + "project specifies a build backend of {} " + "in pyproject.toml".format(build_system["build-backend"]) + ) + use_pep517 = True + + # If we haven't worked out whether to use PEP 517 yet, + # and the user hasn't explicitly stated a preference, + # we do so if the project has a pyproject.toml file + # or if we cannot import setuptools or wheels. + + # We fallback to PEP 517 when without setuptools or without the wheel package, + # so setuptools can be installed as a default build backend. + # For more info see: + # https://discuss.python.org/t/pip-without-setuptools-could-the-experience-be-improved/11810/9 + # https://github.com/pypa/pip/issues/8559 + elif use_pep517 is None: + use_pep517 = ( + has_pyproject + or not importlib.util.find_spec("setuptools") + or not importlib.util.find_spec("wheel") + ) + + # At this point, we know whether we're going to use PEP 517. + assert use_pep517 is not None + + # If we're using the legacy code path, there is nothing further + # for us to do here. + if not use_pep517: + return None + + if build_system is None: + # Either the user has a pyproject.toml with no build-system + # section, or the user has no pyproject.toml, but has opted in + # explicitly via --use-pep517. + # In the absence of any explicit backend specification, we + # assume the setuptools backend that most closely emulates the + # traditional direct setup.py execution, and require wheel and + # a version of setuptools that supports that backend. + + build_system = { + "requires": ["setuptools>=40.8.0"], + "build-backend": "setuptools.build_meta:__legacy__", + } + + # If we're using PEP 517, we have build system information (either + # from pyproject.toml, or defaulted by the code above). + # Note that at this point, we do not know if the user has actually + # specified a backend, though. + assert build_system is not None + + # Ensure that the build-system section in pyproject.toml conforms + # to PEP 518. + + # Specifying the build-system table but not the requires key is invalid + if "requires" not in build_system: + raise MissingPyProjectBuildRequires(package=req_name) + + # Error out if requires is not a list of strings + requires = build_system["requires"] + if not _is_list_of_str(requires): + raise InvalidPyProjectBuildRequires( + package=req_name, + reason="It is not a list of strings.", + ) + + # Each requirement must be valid as per PEP 508 + for requirement in requires: + try: + get_requirement(requirement) + except InvalidRequirement as error: + raise InvalidPyProjectBuildRequires( + package=req_name, + reason=f"It contains an invalid requirement: {requirement!r}", + ) from error + + backend = build_system.get("build-backend") + backend_path = build_system.get("backend-path", []) + check: List[str] = [] + if backend is None: + # If the user didn't specify a backend, we assume they want to use + # the setuptools backend. But we can't be sure they have included + # a version of setuptools which supplies the backend. So we + # make a note to check that this requirement is present once + # we have set up the environment. + # This is quite a lot of work to check for a very specific case. But + # the problem is, that case is potentially quite common - projects that + # adopted PEP 518 early for the ability to specify requirements to + # execute setup.py, but never considered needing to mention the build + # tools themselves. The original PEP 518 code had a similar check (but + # implemented in a different way). + backend = "setuptools.build_meta:__legacy__" + check = ["setuptools>=40.8.0"] + + return BuildSystemDetails(requires, backend, check, backend_path) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/req/__init__.py b/.venv/lib/python3.12/site-packages/pip/_internal/req/__init__.py new file mode 100644 index 0000000..422d851 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/req/__init__.py @@ -0,0 +1,90 @@ +import collections +import logging +from dataclasses import dataclass +from typing import Generator, List, Optional, Sequence, Tuple + +from pip._internal.utils.logging import indent_log + +from .req_file import parse_requirements +from .req_install import InstallRequirement +from .req_set import RequirementSet + +__all__ = [ + "RequirementSet", + "InstallRequirement", + "parse_requirements", + "install_given_reqs", +] + +logger = logging.getLogger(__name__) + + +@dataclass(frozen=True) +class InstallationResult: + name: str + + +def _validate_requirements( + requirements: List[InstallRequirement], +) -> Generator[Tuple[str, InstallRequirement], None, None]: + for req in requirements: + assert req.name, f"invalid to-be-installed requirement: {req}" + yield req.name, req + + +def install_given_reqs( + requirements: List[InstallRequirement], + global_options: Sequence[str], + root: Optional[str], + home: Optional[str], + prefix: Optional[str], + warn_script_location: bool, + use_user_site: bool, + pycompile: bool, +) -> List[InstallationResult]: + """ + Install everything in the given list. + + (to be called after having downloaded and unpacked the packages) + """ + to_install = collections.OrderedDict(_validate_requirements(requirements)) + + if to_install: + logger.info( + "Installing collected packages: %s", + ", ".join(to_install.keys()), + ) + + installed = [] + + with indent_log(): + for req_name, requirement in to_install.items(): + if requirement.should_reinstall: + logger.info("Attempting uninstall: %s", req_name) + with indent_log(): + uninstalled_pathset = requirement.uninstall(auto_confirm=True) + else: + uninstalled_pathset = None + + try: + requirement.install( + global_options, + root=root, + home=home, + prefix=prefix, + warn_script_location=warn_script_location, + use_user_site=use_user_site, + pycompile=pycompile, + ) + except Exception: + # if install did not succeed, rollback previous uninstall + if uninstalled_pathset and not requirement.install_succeeded: + uninstalled_pathset.rollback() + raise + else: + if uninstalled_pathset and requirement.install_succeeded: + uninstalled_pathset.commit() + + installed.append(InstallationResult(req_name)) + + return installed diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/req/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/req/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..09f751cb96213b6ee2f5da8ce702cc2b2641d02d GIT binary patch literal 3474 zcmahMOKcm*b#|9a?($EHlw^sDY0HX4$rk;A~Z2A=tCiw1RhTD-w(JWEINmj;0>gN?y)VNd#w)TI+ZZ? z;>Zr5l?djsh`Vs4z&bReFa?fc1&}z8k8(3lkOX3|$CwyJ- zMPR2+M_yd%26;WROlHT|RFlgY#ugRXlJlBuni<{}&tV-C*)oXjxu}|!ExcQ{R700F zTNuM1RGZ#Bm_c8kTwBm?6}%mCQYbQSf@hGtFX>nAjTYM0xTQAwXyYXK$a0k)FN{1 z_u)mbM`4b`=q#JzHZ+mxsjgtNqFJ^_mrM9EoL-P5ib|60m!y)RR5XeQCF#S8thHx2 z(;{|6l4M;sEJundNxwzwbpKaB$W9t1oF!#!5o1ctPiFImg0q)YGoKxWBTQvAbv#?1 zwI&Vy(CC4KSyQ#}zOtOZCQo29TUN_iN!2Y(;KH+T+^htoYDv;)d6vXr2dC)-#PmV) zWAw})x^aQfw{>RhAS~Lrc-u>`RUvx5ZJ@w~kO#hg_|^;1d>1irSyglzeK3U3JX2+g zFuEN~|2yDpRpuAym#k~R*T03g$`sh2Gs_Hvem3kuv*>r+G?QU3&kd;hl&q;r+A{Wy z<9+Ri#Y%dM!bj5?hQwj_3`=^UvpM?W)N|5l(nAM2B}a&Cebd6oPMD-C%(tNVJNm~0 zYI;#L^&GK$YLRP1; z|1{|ZUC$l>^PJF(aaofL#{*2;Lkt6qg}$)uEfZW&XY9nZOmxZ26SYj;AnzE29jbr} zz(*wdzP4DN%^Rh%s^Po^1d^zQZUdJCEbLbZ zy$>gw_s<8afg*k9Z9tCypEGb(|E4D2qD7#X+$I)C#dDu`&oUoWy!5vzNoN)Bd{9K7 zRo8#6tuj@%%2hp8zUr;|?)&ah&jVo4kAkER*3gKv4M?mSEK-Bq2JUSz2zC>TyS7aO zX;I&F0M6RB2)75H`i%!xZr8smj)6-bKqfQIGUz?f3^*rexcAUB(~qo_D{&7ZX-DhS zf7jZKg4WcPw!x;>*U>a`<$iNNszYlgBg|F&X@GXjPva>}AmXX|L|WC;)+A0l;XJKD zei`*UtV5QO9>?iCqzDKJaseV>dQzUEOB7>T*9=*qITX z(}unb*+ZKF+R$1c6So8HogkfvOCAJp=OG&kC@ytvfJ8{Yu z2poMJF3I-F9ZDXZ#a3whOg6Bkk(~n{u3m5(-cKkH8hEn{o#z1y; z;BbB5@XElE=crdaRuAr4Jim0U5$Rctj695tJc)KL2W|&ysW*NvJc^!rlHB>x`)i1a zjWLbk!>hw5>%%Aic(pcsa%K2REiw3#qccrs9x}?{NG;mm^u$638qwa>Xn#H0-$?9k z?C7I^y}KHj6OG;3#%qJk2#W1_frMCm?KPAbynAeQ*N%X~FF80y^Ee77Yo5f*!<+m63vMdW_Z)dbonLmme)or~ z*^3Xe7af`V>xuo35(gX6WK)FcS1$**$arO*fZP5<`V@DjoBO1{<8<2h$r}N{KV`d5 z@AZ7za}4m$(){U6;IjcA#rI~;Bz>PJDgWo){F&XpOfSiR4BJPI8QjJWY}Aa{Bs7QF zUTd}tGlXVOLUR?N>4?x+Nodlud!e`)-6(EGE0(I6qiuODUvLbp09mqC{81}&?a-+S zZ66&0^K!~W+Xpq6ra^rsPGIYz<7I^Yk3dFf;}lD@P-?lMXWTHfmi^Ii-Kv;qN%2ZJ z-YWFoBIkgl5!Zwuikck5Fkhhf7byG`?fMHk@fe->3LX3k4LwC8Pf`DK49BJWMyEN0{W66+k^pr0$H}zSQIa2fGY( zEFHSJuj!+d;8G%`{3w)M8oPO^8K6`U_3mtjC>BPE?q-ByQ4~!yV-$-cufOI`)%m^` J9Y8yG^lv6%NOJ%H literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/req/__pycache__/constructors.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/req/__pycache__/constructors.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d98a45a240e89e6f84bb00d91bf43527ff7e47a7 GIT binary patch literal 21237 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 M+VH@J7-Lrd7jD&+;{X5v literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/req/__pycache__/req_file.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/req/__pycache__/req_file.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..877cb695d59072c0e3ed238daf2c411c4cab1e05 GIT binary patch literal 21479 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%0D`e3!li3A!x7+*b@8 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 Us{0)IpI)}K@SX=8JT@8sAIte4!2kdN literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/req/constructors.py b/.venv/lib/python3.12/site-packages/pip/_internal/req/constructors.py new file mode 100644 index 0000000..d73236e --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/req/constructors.py @@ -0,0 +1,560 @@ +"""Backing implementation for InstallRequirement's various constructors + +The idea here is that these formed a major chunk of InstallRequirement's size +so, moving them and support code dedicated to them outside of that class +helps creates for better understandability for the rest of the code. + +These are meant to be used elsewhere within pip to create instances of +InstallRequirement. +""" + +import copy +import logging +import os +import re +from dataclasses import dataclass +from typing import Collection, Dict, List, Optional, Set, Tuple, Union + +from pip._vendor.packaging.markers import Marker +from pip._vendor.packaging.requirements import InvalidRequirement, Requirement +from pip._vendor.packaging.specifiers import Specifier + +from pip._internal.exceptions import InstallationError +from pip._internal.models.index import PyPI, TestPyPI +from pip._internal.models.link import Link +from pip._internal.models.wheel import Wheel +from pip._internal.req.req_file import ParsedRequirement +from pip._internal.req.req_install import InstallRequirement +from pip._internal.utils.filetypes import is_archive_file +from pip._internal.utils.misc import is_installable_dir +from pip._internal.utils.packaging import get_requirement +from pip._internal.utils.urls import path_to_url +from pip._internal.vcs import is_url, vcs + +__all__ = [ + "install_req_from_editable", + "install_req_from_line", + "parse_editable", +] + +logger = logging.getLogger(__name__) +operators = Specifier._operators.keys() + + +def _strip_extras(path: str) -> Tuple[str, Optional[str]]: + m = re.match(r"^(.+)(\[[^\]]+\])$", path) + extras = None + if m: + path_no_extras = m.group(1) + extras = m.group(2) + else: + path_no_extras = path + + return path_no_extras, extras + + +def convert_extras(extras: Optional[str]) -> Set[str]: + if not extras: + return set() + return get_requirement("placeholder" + extras.lower()).extras + + +def _set_requirement_extras(req: Requirement, new_extras: Set[str]) -> Requirement: + """ + Returns a new requirement based on the given one, with the supplied extras. If the + given requirement already has extras those are replaced (or dropped if no new extras + are given). + """ + match: Optional[re.Match[str]] = re.fullmatch( + # see https://peps.python.org/pep-0508/#complete-grammar + r"([\w\t .-]+)(\[[^\]]*\])?(.*)", + str(req), + flags=re.ASCII, + ) + # ireq.req is a valid requirement so the regex should always match + assert ( + match is not None + ), f"regex match on requirement {req} failed, this should never happen" + pre: Optional[str] = match.group(1) + post: Optional[str] = match.group(3) + assert ( + pre is not None and post is not None + ), f"regex group selection for requirement {req} failed, this should never happen" + extras: str = "[%s]" % ",".join(sorted(new_extras)) if new_extras else "" + return get_requirement(f"{pre}{extras}{post}") + + +def parse_editable(editable_req: str) -> Tuple[Optional[str], str, Set[str]]: + """Parses an editable requirement into: + - a requirement name + - an URL + - extras + - editable options + Accepted requirements: + svn+http://blahblah@rev#egg=Foobar[baz]&subdirectory=version_subdir + .[some_extra] + """ + + url = editable_req + + # If a file path is specified with extras, strip off the extras. + url_no_extras, extras = _strip_extras(url) + + if os.path.isdir(url_no_extras): + # Treating it as code that has already been checked out + url_no_extras = path_to_url(url_no_extras) + + if url_no_extras.lower().startswith("file:"): + package_name = Link(url_no_extras).egg_fragment + if extras: + return ( + package_name, + url_no_extras, + get_requirement("placeholder" + extras.lower()).extras, + ) + else: + return package_name, url_no_extras, set() + + for version_control in vcs: + if url.lower().startswith(f"{version_control}:"): + url = f"{version_control}+{url}" + break + + link = Link(url) + + if not link.is_vcs: + backends = ", ".join(vcs.all_schemes) + raise InstallationError( + f"{editable_req} is not a valid editable requirement. " + f"It should either be a path to a local project or a VCS URL " + f"(beginning with {backends})." + ) + + package_name = link.egg_fragment + if not package_name: + raise InstallationError( + f"Could not detect requirement name for '{editable_req}', " + "please specify one with #egg=your_package_name" + ) + return package_name, url, set() + + +def check_first_requirement_in_file(filename: str) -> None: + """Check if file is parsable as a requirements file. + + This is heavily based on ``pkg_resources.parse_requirements``, but + simplified to just check the first meaningful line. + + :raises InvalidRequirement: If the first meaningful line cannot be parsed + as an requirement. + """ + with open(filename, encoding="utf-8", errors="ignore") as f: + # Create a steppable iterator, so we can handle \-continuations. + lines = ( + line + for line in (line.strip() for line in f) + if line and not line.startswith("#") # Skip blank lines/comments. + ) + + for line in lines: + # Drop comments -- a hash without a space may be in a URL. + if " #" in line: + line = line[: line.find(" #")] + # If there is a line continuation, drop it, and append the next line. + if line.endswith("\\"): + line = line[:-2].strip() + next(lines, "") + get_requirement(line) + return + + +def deduce_helpful_msg(req: str) -> str: + """Returns helpful msg in case requirements file does not exist, + or cannot be parsed. + + :params req: Requirements file path + """ + if not os.path.exists(req): + return f" File '{req}' does not exist." + msg = " The path does exist. " + # Try to parse and check if it is a requirements file. + try: + check_first_requirement_in_file(req) + except InvalidRequirement: + logger.debug("Cannot parse '%s' as requirements file", req) + else: + msg += ( + f"The argument you provided " + f"({req}) appears to be a" + f" requirements file. If that is the" + f" case, use the '-r' flag to install" + f" the packages specified within it." + ) + return msg + + +@dataclass(frozen=True) +class RequirementParts: + requirement: Optional[Requirement] + link: Optional[Link] + markers: Optional[Marker] + extras: Set[str] + + +def parse_req_from_editable(editable_req: str) -> RequirementParts: + name, url, extras_override = parse_editable(editable_req) + + if name is not None: + try: + req: Optional[Requirement] = get_requirement(name) + except InvalidRequirement as exc: + raise InstallationError(f"Invalid requirement: {name!r}: {exc}") + else: + req = None + + link = Link(url) + + return RequirementParts(req, link, None, extras_override) + + +# ---- The actual constructors follow ---- + + +def install_req_from_editable( + editable_req: str, + comes_from: Optional[Union[InstallRequirement, str]] = None, + *, + use_pep517: Optional[bool] = None, + isolated: bool = False, + global_options: Optional[List[str]] = None, + hash_options: Optional[Dict[str, List[str]]] = None, + constraint: bool = False, + user_supplied: bool = False, + permit_editable_wheels: bool = False, + config_settings: Optional[Dict[str, Union[str, List[str]]]] = None, +) -> InstallRequirement: + parts = parse_req_from_editable(editable_req) + + return InstallRequirement( + parts.requirement, + comes_from=comes_from, + user_supplied=user_supplied, + editable=True, + permit_editable_wheels=permit_editable_wheels, + link=parts.link, + constraint=constraint, + use_pep517=use_pep517, + isolated=isolated, + global_options=global_options, + hash_options=hash_options, + config_settings=config_settings, + extras=parts.extras, + ) + + +def _looks_like_path(name: str) -> bool: + """Checks whether the string "looks like" a path on the filesystem. + + This does not check whether the target actually exists, only judge from the + appearance. + + Returns true if any of the following conditions is true: + * a path separator is found (either os.path.sep or os.path.altsep); + * a dot is found (which represents the current directory). + """ + if os.path.sep in name: + return True + if os.path.altsep is not None and os.path.altsep in name: + return True + if name.startswith("."): + return True + return False + + +def _get_url_from_path(path: str, name: str) -> Optional[str]: + """ + First, it checks whether a provided path is an installable directory. If it + is, returns the path. + + If false, check if the path is an archive file (such as a .whl). + The function checks if the path is a file. If false, if the path has + an @, it will treat it as a PEP 440 URL requirement and return the path. + """ + if _looks_like_path(name) and os.path.isdir(path): + if is_installable_dir(path): + return path_to_url(path) + # TODO: The is_installable_dir test here might not be necessary + # now that it is done in load_pyproject_toml too. + raise InstallationError( + f"Directory {name!r} is not installable. Neither 'setup.py' " + "nor 'pyproject.toml' found." + ) + if not is_archive_file(path): + return None + if os.path.isfile(path): + return path_to_url(path) + urlreq_parts = name.split("@", 1) + if len(urlreq_parts) >= 2 and not _looks_like_path(urlreq_parts[0]): + # If the path contains '@' and the part before it does not look + # like a path, try to treat it as a PEP 440 URL req instead. + return None + logger.warning( + "Requirement %r looks like a filename, but the file does not exist", + name, + ) + return path_to_url(path) + + +def parse_req_from_line(name: str, line_source: Optional[str]) -> RequirementParts: + if is_url(name): + marker_sep = "; " + else: + marker_sep = ";" + if marker_sep in name: + name, markers_as_string = name.split(marker_sep, 1) + markers_as_string = markers_as_string.strip() + if not markers_as_string: + markers = None + else: + markers = Marker(markers_as_string) + else: + markers = None + name = name.strip() + req_as_string = None + path = os.path.normpath(os.path.abspath(name)) + link = None + extras_as_string = None + + if is_url(name): + link = Link(name) + else: + p, extras_as_string = _strip_extras(path) + url = _get_url_from_path(p, name) + if url is not None: + link = Link(url) + + # it's a local file, dir, or url + if link: + # Handle relative file URLs + if link.scheme == "file" and re.search(r"\.\./", link.url): + link = Link(path_to_url(os.path.normpath(os.path.abspath(link.path)))) + # wheel file + if link.is_wheel: + wheel = Wheel(link.filename) # can raise InvalidWheelFilename + req_as_string = f"{wheel.name}=={wheel.version}" + else: + # set the req to the egg fragment. when it's not there, this + # will become an 'unnamed' requirement + req_as_string = link.egg_fragment + + # a requirement specifier + else: + req_as_string = name + + extras = convert_extras(extras_as_string) + + def with_source(text: str) -> str: + if not line_source: + return text + return f"{text} (from {line_source})" + + def _parse_req_string(req_as_string: str) -> Requirement: + try: + return get_requirement(req_as_string) + except InvalidRequirement as exc: + if os.path.sep in req_as_string: + add_msg = "It looks like a path." + add_msg += deduce_helpful_msg(req_as_string) + elif "=" in req_as_string and not any( + op in req_as_string for op in operators + ): + add_msg = "= is not a valid operator. Did you mean == ?" + else: + add_msg = "" + msg = with_source(f"Invalid requirement: {req_as_string!r}: {exc}") + if add_msg: + msg += f"\nHint: {add_msg}" + raise InstallationError(msg) + + if req_as_string is not None: + req: Optional[Requirement] = _parse_req_string(req_as_string) + else: + req = None + + return RequirementParts(req, link, markers, extras) + + +def install_req_from_line( + name: str, + comes_from: Optional[Union[str, InstallRequirement]] = None, + *, + use_pep517: Optional[bool] = None, + isolated: bool = False, + global_options: Optional[List[str]] = None, + hash_options: Optional[Dict[str, List[str]]] = None, + constraint: bool = False, + line_source: Optional[str] = None, + user_supplied: bool = False, + config_settings: Optional[Dict[str, Union[str, List[str]]]] = None, +) -> InstallRequirement: + """Creates an InstallRequirement from a name, which might be a + requirement, directory containing 'setup.py', filename, or URL. + + :param line_source: An optional string describing where the line is from, + for logging purposes in case of an error. + """ + parts = parse_req_from_line(name, line_source) + + return InstallRequirement( + parts.requirement, + comes_from, + link=parts.link, + markers=parts.markers, + use_pep517=use_pep517, + isolated=isolated, + global_options=global_options, + hash_options=hash_options, + config_settings=config_settings, + constraint=constraint, + extras=parts.extras, + user_supplied=user_supplied, + ) + + +def install_req_from_req_string( + req_string: str, + comes_from: Optional[InstallRequirement] = None, + isolated: bool = False, + use_pep517: Optional[bool] = None, + user_supplied: bool = False, +) -> InstallRequirement: + try: + req = get_requirement(req_string) + except InvalidRequirement as exc: + raise InstallationError(f"Invalid requirement: {req_string!r}: {exc}") + + domains_not_allowed = [ + PyPI.file_storage_domain, + TestPyPI.file_storage_domain, + ] + if ( + req.url + and comes_from + and comes_from.link + and comes_from.link.netloc in domains_not_allowed + ): + # Explicitly disallow pypi packages that depend on external urls + raise InstallationError( + "Packages installed from PyPI cannot depend on packages " + "which are not also hosted on PyPI.\n" + f"{comes_from.name} depends on {req} " + ) + + return InstallRequirement( + req, + comes_from, + isolated=isolated, + use_pep517=use_pep517, + user_supplied=user_supplied, + ) + + +def install_req_from_parsed_requirement( + parsed_req: ParsedRequirement, + isolated: bool = False, + use_pep517: Optional[bool] = None, + user_supplied: bool = False, + config_settings: Optional[Dict[str, Union[str, List[str]]]] = None, +) -> InstallRequirement: + if parsed_req.is_editable: + req = install_req_from_editable( + parsed_req.requirement, + comes_from=parsed_req.comes_from, + use_pep517=use_pep517, + constraint=parsed_req.constraint, + isolated=isolated, + user_supplied=user_supplied, + config_settings=config_settings, + ) + + else: + req = install_req_from_line( + parsed_req.requirement, + comes_from=parsed_req.comes_from, + use_pep517=use_pep517, + isolated=isolated, + global_options=( + parsed_req.options.get("global_options", []) + if parsed_req.options + else [] + ), + hash_options=( + parsed_req.options.get("hashes", {}) if parsed_req.options else {} + ), + constraint=parsed_req.constraint, + line_source=parsed_req.line_source, + user_supplied=user_supplied, + config_settings=config_settings, + ) + return req + + +def install_req_from_link_and_ireq( + link: Link, ireq: InstallRequirement +) -> InstallRequirement: + return InstallRequirement( + req=ireq.req, + comes_from=ireq.comes_from, + editable=ireq.editable, + link=link, + markers=ireq.markers, + use_pep517=ireq.use_pep517, + isolated=ireq.isolated, + global_options=ireq.global_options, + hash_options=ireq.hash_options, + config_settings=ireq.config_settings, + user_supplied=ireq.user_supplied, + ) + + +def install_req_drop_extras(ireq: InstallRequirement) -> InstallRequirement: + """ + Creates a new InstallationRequirement using the given template but without + any extras. Sets the original requirement as the new one's parent + (comes_from). + """ + return InstallRequirement( + req=( + _set_requirement_extras(ireq.req, set()) if ireq.req is not None else None + ), + comes_from=ireq, + editable=ireq.editable, + link=ireq.link, + markers=ireq.markers, + use_pep517=ireq.use_pep517, + isolated=ireq.isolated, + global_options=ireq.global_options, + hash_options=ireq.hash_options, + constraint=ireq.constraint, + extras=[], + config_settings=ireq.config_settings, + user_supplied=ireq.user_supplied, + permit_editable_wheels=ireq.permit_editable_wheels, + ) + + +def install_req_extend_extras( + ireq: InstallRequirement, + extras: Collection[str], +) -> InstallRequirement: + """ + Returns a copy of an installation requirement with some additional extras. + Makes a shallow copy of the ireq object. + """ + result = copy.copy(ireq) + result.extras = {*ireq.extras, *extras} + result.req = ( + _set_requirement_extras(ireq.req, result.extras) + if ireq.req is not None + else None + ) + return result diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/req/req_file.py b/.venv/lib/python3.12/site-packages/pip/_internal/req/req_file.py new file mode 100644 index 0000000..53ad867 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/req/req_file.py @@ -0,0 +1,551 @@ +""" +Requirements file parsing +""" + +import logging +import optparse +import os +import re +import shlex +import urllib.parse +from optparse import Values +from typing import ( + TYPE_CHECKING, + Any, + Callable, + Dict, + Generator, + Iterable, + List, + NoReturn, + Optional, + Tuple, +) + +from pip._internal.cli import cmdoptions +from pip._internal.exceptions import InstallationError, RequirementsFileParseError +from pip._internal.models.search_scope import SearchScope +from pip._internal.utils.encoding import auto_decode + +if TYPE_CHECKING: + from pip._internal.index.package_finder import PackageFinder + from pip._internal.network.session import PipSession + +__all__ = ["parse_requirements"] + +ReqFileLines = Iterable[Tuple[int, str]] + +LineParser = Callable[[str], Tuple[str, Values]] + +SCHEME_RE = re.compile(r"^(http|https|file):", re.I) +COMMENT_RE = re.compile(r"(^|\s+)#.*$") + +# Matches environment variable-style values in '${MY_VARIABLE_1}' with the +# variable name consisting of only uppercase letters, digits or the '_' +# (underscore). This follows the POSIX standard defined in IEEE Std 1003.1, +# 2013 Edition. +ENV_VAR_RE = re.compile(r"(?P\$\{(?P[A-Z0-9_]+)\})") + +SUPPORTED_OPTIONS: List[Callable[..., optparse.Option]] = [ + cmdoptions.index_url, + cmdoptions.extra_index_url, + cmdoptions.no_index, + cmdoptions.constraints, + cmdoptions.requirements, + cmdoptions.editable, + cmdoptions.find_links, + cmdoptions.no_binary, + cmdoptions.only_binary, + cmdoptions.prefer_binary, + cmdoptions.require_hashes, + cmdoptions.pre, + cmdoptions.trusted_host, + cmdoptions.use_new_feature, +] + +# options to be passed to requirements +SUPPORTED_OPTIONS_REQ: List[Callable[..., optparse.Option]] = [ + cmdoptions.global_options, + cmdoptions.hash, + cmdoptions.config_settings, +] + +SUPPORTED_OPTIONS_EDITABLE_REQ: List[Callable[..., optparse.Option]] = [ + cmdoptions.config_settings, +] + + +# the 'dest' string values +SUPPORTED_OPTIONS_REQ_DEST = [str(o().dest) for o in SUPPORTED_OPTIONS_REQ] +SUPPORTED_OPTIONS_EDITABLE_REQ_DEST = [ + str(o().dest) for o in SUPPORTED_OPTIONS_EDITABLE_REQ +] + +logger = logging.getLogger(__name__) + + +class ParsedRequirement: + def __init__( + self, + requirement: str, + is_editable: bool, + comes_from: str, + constraint: bool, + options: Optional[Dict[str, Any]] = None, + line_source: Optional[str] = None, + ) -> None: + self.requirement = requirement + self.is_editable = is_editable + self.comes_from = comes_from + self.options = options + self.constraint = constraint + self.line_source = line_source + + +class ParsedLine: + def __init__( + self, + filename: str, + lineno: int, + args: str, + opts: Values, + constraint: bool, + ) -> None: + self.filename = filename + self.lineno = lineno + self.opts = opts + self.constraint = constraint + + if args: + self.is_requirement = True + self.is_editable = False + self.requirement = args + elif opts.editables: + self.is_requirement = True + self.is_editable = True + # We don't support multiple -e on one line + self.requirement = opts.editables[0] + else: + self.is_requirement = False + + +def parse_requirements( + filename: str, + session: "PipSession", + finder: Optional["PackageFinder"] = None, + options: Optional[optparse.Values] = None, + constraint: bool = False, +) -> Generator[ParsedRequirement, None, None]: + """Parse a requirements file and yield ParsedRequirement instances. + + :param filename: Path or url of requirements file. + :param session: PipSession instance. + :param finder: Instance of pip.index.PackageFinder. + :param options: cli options. + :param constraint: If true, parsing a constraint file rather than + requirements file. + """ + line_parser = get_line_parser(finder) + parser = RequirementsFileParser(session, line_parser) + + for parsed_line in parser.parse(filename, constraint): + parsed_req = handle_line( + parsed_line, options=options, finder=finder, session=session + ) + if parsed_req is not None: + yield parsed_req + + +def preprocess(content: str) -> ReqFileLines: + """Split, filter, and join lines, and return a line iterator + + :param content: the content of the requirements file + """ + lines_enum: ReqFileLines = enumerate(content.splitlines(), start=1) + lines_enum = join_lines(lines_enum) + lines_enum = ignore_comments(lines_enum) + lines_enum = expand_env_variables(lines_enum) + return lines_enum + + +def handle_requirement_line( + line: ParsedLine, + options: Optional[optparse.Values] = None, +) -> ParsedRequirement: + # preserve for the nested code path + line_comes_from = "{} {} (line {})".format( + "-c" if line.constraint else "-r", + line.filename, + line.lineno, + ) + + assert line.is_requirement + + # get the options that apply to requirements + if line.is_editable: + supported_dest = SUPPORTED_OPTIONS_EDITABLE_REQ_DEST + else: + supported_dest = SUPPORTED_OPTIONS_REQ_DEST + req_options = {} + for dest in supported_dest: + if dest in line.opts.__dict__ and line.opts.__dict__[dest]: + req_options[dest] = line.opts.__dict__[dest] + + line_source = f"line {line.lineno} of {line.filename}" + return ParsedRequirement( + requirement=line.requirement, + is_editable=line.is_editable, + comes_from=line_comes_from, + constraint=line.constraint, + options=req_options, + line_source=line_source, + ) + + +def handle_option_line( + opts: Values, + filename: str, + lineno: int, + finder: Optional["PackageFinder"] = None, + options: Optional[optparse.Values] = None, + session: Optional["PipSession"] = None, +) -> None: + if opts.hashes: + logger.warning( + "%s line %s has --hash but no requirement, and will be ignored.", + filename, + lineno, + ) + + if options: + # percolate options upward + if opts.require_hashes: + options.require_hashes = opts.require_hashes + if opts.features_enabled: + options.features_enabled.extend( + f for f in opts.features_enabled if f not in options.features_enabled + ) + + # set finder options + if finder: + find_links = finder.find_links + index_urls = finder.index_urls + no_index = finder.search_scope.no_index + if opts.no_index is True: + no_index = True + index_urls = [] + if opts.index_url and not no_index: + index_urls = [opts.index_url] + if opts.extra_index_urls and not no_index: + index_urls.extend(opts.extra_index_urls) + if opts.find_links: + # FIXME: it would be nice to keep track of the source + # of the find_links: support a find-links local path + # relative to a requirements file. + value = opts.find_links[0] + req_dir = os.path.dirname(os.path.abspath(filename)) + relative_to_reqs_file = os.path.join(req_dir, value) + if os.path.exists(relative_to_reqs_file): + value = relative_to_reqs_file + find_links.append(value) + + if session: + # We need to update the auth urls in session + session.update_index_urls(index_urls) + + search_scope = SearchScope( + find_links=find_links, + index_urls=index_urls, + no_index=no_index, + ) + finder.search_scope = search_scope + + if opts.pre: + finder.set_allow_all_prereleases() + + if opts.prefer_binary: + finder.set_prefer_binary() + + if session: + for host in opts.trusted_hosts or []: + source = f"line {lineno} of {filename}" + session.add_trusted_host(host, source=source) + + +def handle_line( + line: ParsedLine, + options: Optional[optparse.Values] = None, + finder: Optional["PackageFinder"] = None, + session: Optional["PipSession"] = None, +) -> Optional[ParsedRequirement]: + """Handle a single parsed requirements line; This can result in + creating/yielding requirements, or updating the finder. + + :param line: The parsed line to be processed. + :param options: CLI options. + :param finder: The finder - updated by non-requirement lines. + :param session: The session - updated by non-requirement lines. + + Returns a ParsedRequirement object if the line is a requirement line, + otherwise returns None. + + For lines that contain requirements, the only options that have an effect + are from SUPPORTED_OPTIONS_REQ, and they are scoped to the + requirement. Other options from SUPPORTED_OPTIONS may be present, but are + ignored. + + For lines that do not contain requirements, the only options that have an + effect are from SUPPORTED_OPTIONS. Options from SUPPORTED_OPTIONS_REQ may + be present, but are ignored. These lines may contain multiple options + (although our docs imply only one is supported), and all our parsed and + affect the finder. + """ + + if line.is_requirement: + parsed_req = handle_requirement_line(line, options) + return parsed_req + else: + handle_option_line( + line.opts, + line.filename, + line.lineno, + finder, + options, + session, + ) + return None + + +class RequirementsFileParser: + def __init__( + self, + session: "PipSession", + line_parser: LineParser, + ) -> None: + self._session = session + self._line_parser = line_parser + + def parse( + self, filename: str, constraint: bool + ) -> Generator[ParsedLine, None, None]: + """Parse a given file, yielding parsed lines.""" + yield from self._parse_and_recurse(filename, constraint) + + def _parse_and_recurse( + self, filename: str, constraint: bool + ) -> Generator[ParsedLine, None, None]: + for line in self._parse_file(filename, constraint): + if not line.is_requirement and ( + line.opts.requirements or line.opts.constraints + ): + # parse a nested requirements file + if line.opts.requirements: + req_path = line.opts.requirements[0] + nested_constraint = False + else: + req_path = line.opts.constraints[0] + nested_constraint = True + + # original file is over http + if SCHEME_RE.search(filename): + # do a url join so relative paths work + req_path = urllib.parse.urljoin(filename, req_path) + # original file and nested file are paths + elif not SCHEME_RE.search(req_path): + # do a join so relative paths work + req_path = os.path.join( + os.path.dirname(filename), + req_path, + ) + + yield from self._parse_and_recurse(req_path, nested_constraint) + else: + yield line + + def _parse_file( + self, filename: str, constraint: bool + ) -> Generator[ParsedLine, None, None]: + _, content = get_file_content(filename, self._session) + + lines_enum = preprocess(content) + + for line_number, line in lines_enum: + try: + args_str, opts = self._line_parser(line) + except OptionParsingError as e: + # add offending line + msg = f"Invalid requirement: {line}\n{e.msg}" + raise RequirementsFileParseError(msg) + + yield ParsedLine( + filename, + line_number, + args_str, + opts, + constraint, + ) + + +def get_line_parser(finder: Optional["PackageFinder"]) -> LineParser: + def parse_line(line: str) -> Tuple[str, Values]: + # Build new parser for each line since it accumulates appendable + # options. + parser = build_parser() + defaults = parser.get_default_values() + defaults.index_url = None + if finder: + defaults.format_control = finder.format_control + + args_str, options_str = break_args_options(line) + + try: + options = shlex.split(options_str) + except ValueError as e: + raise OptionParsingError(f"Could not split options: {options_str}") from e + + opts, _ = parser.parse_args(options, defaults) + + return args_str, opts + + return parse_line + + +def break_args_options(line: str) -> Tuple[str, str]: + """Break up the line into an args and options string. We only want to shlex + (and then optparse) the options, not the args. args can contain markers + which are corrupted by shlex. + """ + tokens = line.split(" ") + args = [] + options = tokens[:] + for token in tokens: + if token.startswith("-") or token.startswith("--"): + break + else: + args.append(token) + options.pop(0) + return " ".join(args), " ".join(options) + + +class OptionParsingError(Exception): + def __init__(self, msg: str) -> None: + self.msg = msg + + +def build_parser() -> optparse.OptionParser: + """ + Return a parser for parsing requirement lines + """ + parser = optparse.OptionParser(add_help_option=False) + + option_factories = SUPPORTED_OPTIONS + SUPPORTED_OPTIONS_REQ + for option_factory in option_factories: + option = option_factory() + parser.add_option(option) + + # By default optparse sys.exits on parsing errors. We want to wrap + # that in our own exception. + def parser_exit(self: Any, msg: str) -> "NoReturn": + raise OptionParsingError(msg) + + # NOTE: mypy disallows assigning to a method + # https://github.com/python/mypy/issues/2427 + parser.exit = parser_exit # type: ignore + + return parser + + +def join_lines(lines_enum: ReqFileLines) -> ReqFileLines: + """Joins a line ending in '\' with the previous line (except when following + comments). The joined line takes on the index of the first line. + """ + primary_line_number = None + new_line: List[str] = [] + for line_number, line in lines_enum: + if not line.endswith("\\") or COMMENT_RE.match(line): + if COMMENT_RE.match(line): + # this ensures comments are always matched later + line = " " + line + if new_line: + new_line.append(line) + assert primary_line_number is not None + yield primary_line_number, "".join(new_line) + new_line = [] + else: + yield line_number, line + else: + if not new_line: + primary_line_number = line_number + new_line.append(line.strip("\\")) + + # last line contains \ + if new_line: + assert primary_line_number is not None + yield primary_line_number, "".join(new_line) + + # TODO: handle space after '\'. + + +def ignore_comments(lines_enum: ReqFileLines) -> ReqFileLines: + """ + Strips comments and filter empty lines. + """ + for line_number, line in lines_enum: + line = COMMENT_RE.sub("", line) + line = line.strip() + if line: + yield line_number, line + + +def expand_env_variables(lines_enum: ReqFileLines) -> ReqFileLines: + """Replace all environment variables that can be retrieved via `os.getenv`. + + The only allowed format for environment variables defined in the + requirement file is `${MY_VARIABLE_1}` to ensure two things: + + 1. Strings that contain a `$` aren't accidentally (partially) expanded. + 2. Ensure consistency across platforms for requirement files. + + These points are the result of a discussion on the `github pull + request #3514 `_. + + Valid characters in variable names follow the `POSIX standard + `_ and are limited + to uppercase letter, digits and the `_` (underscore). + """ + for line_number, line in lines_enum: + for env_var, var_name in ENV_VAR_RE.findall(line): + value = os.getenv(var_name) + if not value: + continue + + line = line.replace(env_var, value) + + yield line_number, line + + +def get_file_content(url: str, session: "PipSession") -> Tuple[str, str]: + """Gets the content of a file; it may be a filename, file: URL, or + http: URL. Returns (location, content). Content is unicode. + Respects # -*- coding: declarations on the retrieved files. + + :param url: File path or url. + :param session: PipSession instance. + """ + scheme = urllib.parse.urlsplit(url).scheme + # Pip has special support for file:// URLs (LocalFSAdapter). + if scheme in ["http", "https", "file"]: + # Delay importing heavy network modules until absolutely necessary. + from pip._internal.network.utils import raise_for_status + + resp = session.get(url) + raise_for_status(resp) + return resp.url, resp.text + + # Assume this is a bare path. + try: + with open(url, "rb") as f: + content = auto_decode(f.read()) + except OSError as exc: + raise InstallationError(f"Could not open requirements file: {exc}") + return url, content diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/req/req_install.py b/.venv/lib/python3.12/site-packages/pip/_internal/req/req_install.py new file mode 100644 index 0000000..834bc51 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/req/req_install.py @@ -0,0 +1,934 @@ +import functools +import logging +import os +import shutil +import sys +import uuid +import zipfile +from optparse import Values +from pathlib import Path +from typing import Any, Collection, Dict, Iterable, List, Optional, Sequence, Union + +from pip._vendor.packaging.markers import Marker +from pip._vendor.packaging.requirements import Requirement +from pip._vendor.packaging.specifiers import SpecifierSet +from pip._vendor.packaging.utils import canonicalize_name +from pip._vendor.packaging.version import Version +from pip._vendor.packaging.version import parse as parse_version +from pip._vendor.pyproject_hooks import BuildBackendHookCaller + +from pip._internal.build_env import BuildEnvironment, NoOpBuildEnvironment +from pip._internal.exceptions import InstallationError, PreviousBuildDirError +from pip._internal.locations import get_scheme +from pip._internal.metadata import ( + BaseDistribution, + get_default_environment, + get_directory_distribution, + get_wheel_distribution, +) +from pip._internal.metadata.base import FilesystemWheel +from pip._internal.models.direct_url import DirectUrl +from pip._internal.models.link import Link +from pip._internal.operations.build.metadata import generate_metadata +from pip._internal.operations.build.metadata_editable import generate_editable_metadata +from pip._internal.operations.build.metadata_legacy import ( + generate_metadata as generate_metadata_legacy, +) +from pip._internal.operations.install.editable_legacy import ( + install_editable as install_editable_legacy, +) +from pip._internal.operations.install.wheel import install_wheel +from pip._internal.pyproject import load_pyproject_toml, make_pyproject_path +from pip._internal.req.req_uninstall import UninstallPathSet +from pip._internal.utils.deprecation import deprecated +from pip._internal.utils.hashes import Hashes +from pip._internal.utils.misc import ( + ConfiguredBuildBackendHookCaller, + ask_path_exists, + backup_dir, + display_path, + hide_url, + is_installable_dir, + redact_auth_from_requirement, + redact_auth_from_url, +) +from pip._internal.utils.packaging import get_requirement +from pip._internal.utils.subprocess import runner_with_spinner_message +from pip._internal.utils.temp_dir import TempDirectory, tempdir_kinds +from pip._internal.utils.unpacking import unpack_file +from pip._internal.utils.virtualenv import running_under_virtualenv +from pip._internal.vcs import vcs + +logger = logging.getLogger(__name__) + + +class InstallRequirement: + """ + Represents something that may be installed later on, may have information + about where to fetch the relevant requirement and also contains logic for + installing the said requirement. + """ + + def __init__( + self, + req: Optional[Requirement], + comes_from: Optional[Union[str, "InstallRequirement"]], + editable: bool = False, + link: Optional[Link] = None, + markers: Optional[Marker] = None, + use_pep517: Optional[bool] = None, + isolated: bool = False, + *, + global_options: Optional[List[str]] = None, + hash_options: Optional[Dict[str, List[str]]] = None, + config_settings: Optional[Dict[str, Union[str, List[str]]]] = None, + constraint: bool = False, + extras: Collection[str] = (), + user_supplied: bool = False, + permit_editable_wheels: bool = False, + ) -> None: + assert req is None or isinstance(req, Requirement), req + self.req = req + self.comes_from = comes_from + self.constraint = constraint + self.editable = editable + self.permit_editable_wheels = permit_editable_wheels + + # source_dir is the local directory where the linked requirement is + # located, or unpacked. In case unpacking is needed, creating and + # populating source_dir is done by the RequirementPreparer. Note this + # is not necessarily the directory where pyproject.toml or setup.py is + # located - that one is obtained via unpacked_source_directory. + self.source_dir: Optional[str] = None + if self.editable: + assert link + if link.is_file: + self.source_dir = os.path.normpath(os.path.abspath(link.file_path)) + + # original_link is the direct URL that was provided by the user for the + # requirement, either directly or via a constraints file. + if link is None and req and req.url: + # PEP 508 URL requirement + link = Link(req.url) + self.link = self.original_link = link + + # When this InstallRequirement is a wheel obtained from the cache of locally + # built wheels, this is the source link corresponding to the cache entry, which + # was used to download and build the cached wheel. + self.cached_wheel_source_link: Optional[Link] = None + + # Information about the location of the artifact that was downloaded . This + # property is guaranteed to be set in resolver results. + self.download_info: Optional[DirectUrl] = None + + # Path to any downloaded or already-existing package. + self.local_file_path: Optional[str] = None + if self.link and self.link.is_file: + self.local_file_path = self.link.file_path + + if extras: + self.extras = extras + elif req: + self.extras = req.extras + else: + self.extras = set() + if markers is None and req: + markers = req.marker + self.markers = markers + + # This holds the Distribution object if this requirement is already installed. + self.satisfied_by: Optional[BaseDistribution] = None + # Whether the installation process should try to uninstall an existing + # distribution before installing this requirement. + self.should_reinstall = False + # Temporary build location + self._temp_build_dir: Optional[TempDirectory] = None + # Set to True after successful installation + self.install_succeeded: Optional[bool] = None + # Supplied options + self.global_options = global_options if global_options else [] + self.hash_options = hash_options if hash_options else {} + self.config_settings = config_settings + # Set to True after successful preparation of this requirement + self.prepared = False + # User supplied requirement are explicitly requested for installation + # by the user via CLI arguments or requirements files, as opposed to, + # e.g. dependencies, extras or constraints. + self.user_supplied = user_supplied + + self.isolated = isolated + self.build_env: BuildEnvironment = NoOpBuildEnvironment() + + # For PEP 517, the directory where we request the project metadata + # gets stored. We need this to pass to build_wheel, so the backend + # can ensure that the wheel matches the metadata (see the PEP for + # details). + self.metadata_directory: Optional[str] = None + + # The static build requirements (from pyproject.toml) + self.pyproject_requires: Optional[List[str]] = None + + # Build requirements that we will check are available + self.requirements_to_check: List[str] = [] + + # The PEP 517 backend we should use to build the project + self.pep517_backend: Optional[BuildBackendHookCaller] = None + + # Are we using PEP 517 for this requirement? + # After pyproject.toml has been loaded, the only valid values are True + # and False. Before loading, None is valid (meaning "use the default"). + # Setting an explicit value before loading pyproject.toml is supported, + # but after loading this flag should be treated as read only. + self.use_pep517 = use_pep517 + + # If config settings are provided, enforce PEP 517. + if self.config_settings: + if self.use_pep517 is False: + logger.warning( + "--no-use-pep517 ignored for %s " + "because --config-settings are specified.", + self, + ) + self.use_pep517 = True + + # This requirement needs more preparation before it can be built + self.needs_more_preparation = False + + # This requirement needs to be unpacked before it can be installed. + self._archive_source: Optional[Path] = None + + def __str__(self) -> str: + if self.req: + s = redact_auth_from_requirement(self.req) + if self.link: + s += f" from {redact_auth_from_url(self.link.url)}" + elif self.link: + s = redact_auth_from_url(self.link.url) + else: + s = "" + if self.satisfied_by is not None: + if self.satisfied_by.location is not None: + location = display_path(self.satisfied_by.location) + else: + location = "" + s += f" in {location}" + if self.comes_from: + if isinstance(self.comes_from, str): + comes_from: Optional[str] = self.comes_from + else: + comes_from = self.comes_from.from_path() + if comes_from: + s += f" (from {comes_from})" + return s + + def __repr__(self) -> str: + return ( + f"<{self.__class__.__name__} object: " + f"{str(self)} editable={self.editable!r}>" + ) + + def format_debug(self) -> str: + """An un-tested helper for getting state, for debugging.""" + attributes = vars(self) + names = sorted(attributes) + + state = (f"{attr}={attributes[attr]!r}" for attr in sorted(names)) + return "<{name} object: {{{state}}}>".format( + name=self.__class__.__name__, + state=", ".join(state), + ) + + # Things that are valid for all kinds of requirements? + @property + def name(self) -> Optional[str]: + if self.req is None: + return None + return self.req.name + + @functools.cached_property + def supports_pyproject_editable(self) -> bool: + if not self.use_pep517: + return False + assert self.pep517_backend + with self.build_env: + runner = runner_with_spinner_message( + "Checking if build backend supports build_editable" + ) + with self.pep517_backend.subprocess_runner(runner): + return "build_editable" in self.pep517_backend._supported_features() + + @property + def specifier(self) -> SpecifierSet: + assert self.req is not None + return self.req.specifier + + @property + def is_direct(self) -> bool: + """Whether this requirement was specified as a direct URL.""" + return self.original_link is not None + + @property + def is_pinned(self) -> bool: + """Return whether I am pinned to an exact version. + + For example, some-package==1.2 is pinned; some-package>1.2 is not. + """ + assert self.req is not None + specifiers = self.req.specifier + return len(specifiers) == 1 and next(iter(specifiers)).operator in {"==", "==="} + + def match_markers(self, extras_requested: Optional[Iterable[str]] = None) -> bool: + if not extras_requested: + # Provide an extra to safely evaluate the markers + # without matching any extra + extras_requested = ("",) + if self.markers is not None: + return any( + self.markers.evaluate({"extra": extra}) for extra in extras_requested + ) + else: + return True + + @property + def has_hash_options(self) -> bool: + """Return whether any known-good hashes are specified as options. + + These activate --require-hashes mode; hashes specified as part of a + URL do not. + + """ + return bool(self.hash_options) + + def hashes(self, trust_internet: bool = True) -> Hashes: + """Return a hash-comparer that considers my option- and URL-based + hashes to be known-good. + + Hashes in URLs--ones embedded in the requirements file, not ones + downloaded from an index server--are almost peers with ones from + flags. They satisfy --require-hashes (whether it was implicitly or + explicitly activated) but do not activate it. md5 and sha224 are not + allowed in flags, which should nudge people toward good algos. We + always OR all hashes together, even ones from URLs. + + :param trust_internet: Whether to trust URL-based (#md5=...) hashes + downloaded from the internet, as by populate_link() + + """ + good_hashes = self.hash_options.copy() + if trust_internet: + link = self.link + elif self.is_direct and self.user_supplied: + link = self.original_link + else: + link = None + if link and link.hash: + assert link.hash_name is not None + good_hashes.setdefault(link.hash_name, []).append(link.hash) + return Hashes(good_hashes) + + def from_path(self) -> Optional[str]: + """Format a nice indicator to show where this "comes from" """ + if self.req is None: + return None + s = str(self.req) + if self.comes_from: + comes_from: Optional[str] + if isinstance(self.comes_from, str): + comes_from = self.comes_from + else: + comes_from = self.comes_from.from_path() + if comes_from: + s += "->" + comes_from + return s + + def ensure_build_location( + self, build_dir: str, autodelete: bool, parallel_builds: bool + ) -> str: + assert build_dir is not None + if self._temp_build_dir is not None: + assert self._temp_build_dir.path + return self._temp_build_dir.path + if self.req is None: + # Some systems have /tmp as a symlink which confuses custom + # builds (such as numpy). Thus, we ensure that the real path + # is returned. + self._temp_build_dir = TempDirectory( + kind=tempdir_kinds.REQ_BUILD, globally_managed=True + ) + + return self._temp_build_dir.path + + # This is the only remaining place where we manually determine the path + # for the temporary directory. It is only needed for editables where + # it is the value of the --src option. + + # When parallel builds are enabled, add a UUID to the build directory + # name so multiple builds do not interfere with each other. + dir_name: str = canonicalize_name(self.req.name) + if parallel_builds: + dir_name = f"{dir_name}_{uuid.uuid4().hex}" + + # FIXME: Is there a better place to create the build_dir? (hg and bzr + # need this) + if not os.path.exists(build_dir): + logger.debug("Creating directory %s", build_dir) + os.makedirs(build_dir) + actual_build_dir = os.path.join(build_dir, dir_name) + # `None` indicates that we respect the globally-configured deletion + # settings, which is what we actually want when auto-deleting. + delete_arg = None if autodelete else False + return TempDirectory( + path=actual_build_dir, + delete=delete_arg, + kind=tempdir_kinds.REQ_BUILD, + globally_managed=True, + ).path + + def _set_requirement(self) -> None: + """Set requirement after generating metadata.""" + assert self.req is None + assert self.metadata is not None + assert self.source_dir is not None + + # Construct a Requirement object from the generated metadata + if isinstance(parse_version(self.metadata["Version"]), Version): + op = "==" + else: + op = "===" + + self.req = get_requirement( + "".join( + [ + self.metadata["Name"], + op, + self.metadata["Version"], + ] + ) + ) + + def warn_on_mismatching_name(self) -> None: + assert self.req is not None + metadata_name = canonicalize_name(self.metadata["Name"]) + if canonicalize_name(self.req.name) == metadata_name: + # Everything is fine. + return + + # If we're here, there's a mismatch. Log a warning about it. + logger.warning( + "Generating metadata for package %s " + "produced metadata for project name %s. Fix your " + "#egg=%s fragments.", + self.name, + metadata_name, + self.name, + ) + self.req = get_requirement(metadata_name) + + def check_if_exists(self, use_user_site: bool) -> None: + """Find an installed distribution that satisfies or conflicts + with this requirement, and set self.satisfied_by or + self.should_reinstall appropriately. + """ + if self.req is None: + return + existing_dist = get_default_environment().get_distribution(self.req.name) + if not existing_dist: + return + + version_compatible = self.req.specifier.contains( + existing_dist.version, + prereleases=True, + ) + if not version_compatible: + self.satisfied_by = None + if use_user_site: + if existing_dist.in_usersite: + self.should_reinstall = True + elif running_under_virtualenv() and existing_dist.in_site_packages: + raise InstallationError( + f"Will not install to the user site because it will " + f"lack sys.path precedence to {existing_dist.raw_name} " + f"in {existing_dist.location}" + ) + else: + self.should_reinstall = True + else: + if self.editable: + self.should_reinstall = True + # when installing editables, nothing pre-existing should ever + # satisfy + self.satisfied_by = None + else: + self.satisfied_by = existing_dist + + # Things valid for wheels + @property + def is_wheel(self) -> bool: + if not self.link: + return False + return self.link.is_wheel + + @property + def is_wheel_from_cache(self) -> bool: + # When True, it means that this InstallRequirement is a local wheel file in the + # cache of locally built wheels. + return self.cached_wheel_source_link is not None + + # Things valid for sdists + @property + def unpacked_source_directory(self) -> str: + assert self.source_dir, f"No source dir for {self}" + return os.path.join( + self.source_dir, self.link and self.link.subdirectory_fragment or "" + ) + + @property + def setup_py_path(self) -> str: + assert self.source_dir, f"No source dir for {self}" + setup_py = os.path.join(self.unpacked_source_directory, "setup.py") + + return setup_py + + @property + def setup_cfg_path(self) -> str: + assert self.source_dir, f"No source dir for {self}" + setup_cfg = os.path.join(self.unpacked_source_directory, "setup.cfg") + + return setup_cfg + + @property + def pyproject_toml_path(self) -> str: + assert self.source_dir, f"No source dir for {self}" + return make_pyproject_path(self.unpacked_source_directory) + + def load_pyproject_toml(self) -> None: + """Load the pyproject.toml file. + + After calling this routine, all of the attributes related to PEP 517 + processing for this requirement have been set. In particular, the + use_pep517 attribute can be used to determine whether we should + follow the PEP 517 or legacy (setup.py) code path. + """ + pyproject_toml_data = load_pyproject_toml( + self.use_pep517, self.pyproject_toml_path, self.setup_py_path, str(self) + ) + + if pyproject_toml_data is None: + assert not self.config_settings + self.use_pep517 = False + return + + self.use_pep517 = True + requires, backend, check, backend_path = pyproject_toml_data + self.requirements_to_check = check + self.pyproject_requires = requires + self.pep517_backend = ConfiguredBuildBackendHookCaller( + self, + self.unpacked_source_directory, + backend, + backend_path=backend_path, + ) + + def isolated_editable_sanity_check(self) -> None: + """Check that an editable requirement if valid for use with PEP 517/518. + + This verifies that an editable that has a pyproject.toml either supports PEP 660 + or as a setup.py or a setup.cfg + """ + if ( + self.editable + and self.use_pep517 + and not self.supports_pyproject_editable + and not os.path.isfile(self.setup_py_path) + and not os.path.isfile(self.setup_cfg_path) + ): + raise InstallationError( + f"Project {self} has a 'pyproject.toml' and its build " + f"backend is missing the 'build_editable' hook. Since it does not " + f"have a 'setup.py' nor a 'setup.cfg', " + f"it cannot be installed in editable mode. " + f"Consider using a build backend that supports PEP 660." + ) + + def prepare_metadata(self) -> None: + """Ensure that project metadata is available. + + Under PEP 517 and PEP 660, call the backend hook to prepare the metadata. + Under legacy processing, call setup.py egg-info. + """ + assert self.source_dir, f"No source dir for {self}" + details = self.name or f"from {self.link}" + + if self.use_pep517: + assert self.pep517_backend is not None + if ( + self.editable + and self.permit_editable_wheels + and self.supports_pyproject_editable + ): + self.metadata_directory = generate_editable_metadata( + build_env=self.build_env, + backend=self.pep517_backend, + details=details, + ) + else: + self.metadata_directory = generate_metadata( + build_env=self.build_env, + backend=self.pep517_backend, + details=details, + ) + else: + self.metadata_directory = generate_metadata_legacy( + build_env=self.build_env, + setup_py_path=self.setup_py_path, + source_dir=self.unpacked_source_directory, + isolated=self.isolated, + details=details, + ) + + # Act on the newly generated metadata, based on the name and version. + if not self.name: + self._set_requirement() + else: + self.warn_on_mismatching_name() + + self.assert_source_matches_version() + + @property + def metadata(self) -> Any: + if not hasattr(self, "_metadata"): + self._metadata = self.get_dist().metadata + + return self._metadata + + def get_dist(self) -> BaseDistribution: + if self.metadata_directory: + return get_directory_distribution(self.metadata_directory) + elif self.local_file_path and self.is_wheel: + assert self.req is not None + return get_wheel_distribution( + FilesystemWheel(self.local_file_path), + canonicalize_name(self.req.name), + ) + raise AssertionError( + f"InstallRequirement {self} has no metadata directory and no wheel: " + f"can't make a distribution." + ) + + def assert_source_matches_version(self) -> None: + assert self.source_dir, f"No source dir for {self}" + version = self.metadata["version"] + if self.req and self.req.specifier and version not in self.req.specifier: + logger.warning( + "Requested %s, but installing version %s", + self, + version, + ) + else: + logger.debug( + "Source in %s has version %s, which satisfies requirement %s", + display_path(self.source_dir), + version, + self, + ) + + # For both source distributions and editables + def ensure_has_source_dir( + self, + parent_dir: str, + autodelete: bool = False, + parallel_builds: bool = False, + ) -> None: + """Ensure that a source_dir is set. + + This will create a temporary build dir if the name of the requirement + isn't known yet. + + :param parent_dir: The ideal pip parent_dir for the source_dir. + Generally src_dir for editables and build_dir for sdists. + :return: self.source_dir + """ + if self.source_dir is None: + self.source_dir = self.ensure_build_location( + parent_dir, + autodelete=autodelete, + parallel_builds=parallel_builds, + ) + + def needs_unpacked_archive(self, archive_source: Path) -> None: + assert self._archive_source is None + self._archive_source = archive_source + + def ensure_pristine_source_checkout(self) -> None: + """Ensure the source directory has not yet been built in.""" + assert self.source_dir is not None + if self._archive_source is not None: + unpack_file(str(self._archive_source), self.source_dir) + elif is_installable_dir(self.source_dir): + # If a checkout exists, it's unwise to keep going. + # version inconsistencies are logged later, but do not fail + # the installation. + raise PreviousBuildDirError( + f"pip can't proceed with requirements '{self}' due to a " + f"pre-existing build directory ({self.source_dir}). This is likely " + "due to a previous installation that failed . pip is " + "being responsible and not assuming it can delete this. " + "Please delete it and try again." + ) + + # For editable installations + def update_editable(self) -> None: + if not self.link: + logger.debug( + "Cannot update repository at %s; repository location is unknown", + self.source_dir, + ) + return + assert self.editable + assert self.source_dir + if self.link.scheme == "file": + # Static paths don't get updated + return + vcs_backend = vcs.get_backend_for_scheme(self.link.scheme) + # Editable requirements are validated in Requirement constructors. + # So here, if it's neither a path nor a valid VCS URL, it's a bug. + assert vcs_backend, f"Unsupported VCS URL {self.link.url}" + hidden_url = hide_url(self.link.url) + vcs_backend.obtain(self.source_dir, url=hidden_url, verbosity=0) + + # Top-level Actions + def uninstall( + self, auto_confirm: bool = False, verbose: bool = False + ) -> Optional[UninstallPathSet]: + """ + Uninstall the distribution currently satisfying this requirement. + + Prompts before removing or modifying files unless + ``auto_confirm`` is True. + + Refuses to delete or modify files outside of ``sys.prefix`` - + thus uninstallation within a virtual environment can only + modify that virtual environment, even if the virtualenv is + linked to global site-packages. + + """ + assert self.req + dist = get_default_environment().get_distribution(self.req.name) + if not dist: + logger.warning("Skipping %s as it is not installed.", self.name) + return None + logger.info("Found existing installation: %s", dist) + + uninstalled_pathset = UninstallPathSet.from_dist(dist) + uninstalled_pathset.remove(auto_confirm, verbose) + return uninstalled_pathset + + def _get_archive_name(self, path: str, parentdir: str, rootdir: str) -> str: + def _clean_zip_name(name: str, prefix: str) -> str: + assert name.startswith( + prefix + os.path.sep + ), f"name {name!r} doesn't start with prefix {prefix!r}" + name = name[len(prefix) + 1 :] + name = name.replace(os.path.sep, "/") + return name + + assert self.req is not None + path = os.path.join(parentdir, path) + name = _clean_zip_name(path, rootdir) + return self.req.name + "/" + name + + def archive(self, build_dir: Optional[str]) -> None: + """Saves archive to provided build_dir. + + Used for saving downloaded VCS requirements as part of `pip download`. + """ + assert self.source_dir + if build_dir is None: + return + + create_archive = True + archive_name = "{}-{}.zip".format(self.name, self.metadata["version"]) + archive_path = os.path.join(build_dir, archive_name) + + if os.path.exists(archive_path): + response = ask_path_exists( + f"The file {display_path(archive_path)} exists. (i)gnore, (w)ipe, " + "(b)ackup, (a)bort ", + ("i", "w", "b", "a"), + ) + if response == "i": + create_archive = False + elif response == "w": + logger.warning("Deleting %s", display_path(archive_path)) + os.remove(archive_path) + elif response == "b": + dest_file = backup_dir(archive_path) + logger.warning( + "Backing up %s to %s", + display_path(archive_path), + display_path(dest_file), + ) + shutil.move(archive_path, dest_file) + elif response == "a": + sys.exit(-1) + + if not create_archive: + return + + zip_output = zipfile.ZipFile( + archive_path, + "w", + zipfile.ZIP_DEFLATED, + allowZip64=True, + ) + with zip_output: + dir = os.path.normcase(os.path.abspath(self.unpacked_source_directory)) + for dirpath, dirnames, filenames in os.walk(dir): + for dirname in dirnames: + dir_arcname = self._get_archive_name( + dirname, + parentdir=dirpath, + rootdir=dir, + ) + zipdir = zipfile.ZipInfo(dir_arcname + "/") + zipdir.external_attr = 0x1ED << 16 # 0o755 + zip_output.writestr(zipdir, "") + for filename in filenames: + file_arcname = self._get_archive_name( + filename, + parentdir=dirpath, + rootdir=dir, + ) + filename = os.path.join(dirpath, filename) + zip_output.write(filename, file_arcname) + + logger.info("Saved %s", display_path(archive_path)) + + def install( + self, + global_options: Optional[Sequence[str]] = None, + root: Optional[str] = None, + home: Optional[str] = None, + prefix: Optional[str] = None, + warn_script_location: bool = True, + use_user_site: bool = False, + pycompile: bool = True, + ) -> None: + assert self.req is not None + scheme = get_scheme( + self.req.name, + user=use_user_site, + home=home, + root=root, + isolated=self.isolated, + prefix=prefix, + ) + + if self.editable and not self.is_wheel: + deprecated( + reason=( + f"Legacy editable install of {self} (setup.py develop) " + "is deprecated." + ), + replacement=( + "to add a pyproject.toml or enable --use-pep517, " + "and use setuptools >= 64. " + "If the resulting installation is not behaving as expected, " + "try using --config-settings editable_mode=compat. " + "Please consult the setuptools documentation for more information" + ), + gone_in="25.0", + issue=11457, + ) + if self.config_settings: + logger.warning( + "--config-settings ignored for legacy editable install of %s. " + "Consider upgrading to a version of setuptools " + "that supports PEP 660 (>= 64).", + self, + ) + install_editable_legacy( + global_options=global_options if global_options is not None else [], + prefix=prefix, + home=home, + use_user_site=use_user_site, + name=self.req.name, + setup_py_path=self.setup_py_path, + isolated=self.isolated, + build_env=self.build_env, + unpacked_source_directory=self.unpacked_source_directory, + ) + self.install_succeeded = True + return + + assert self.is_wheel + assert self.local_file_path + + install_wheel( + self.req.name, + self.local_file_path, + scheme=scheme, + req_description=str(self.req), + pycompile=pycompile, + warn_script_location=warn_script_location, + direct_url=self.download_info if self.is_direct else None, + requested=self.user_supplied, + ) + self.install_succeeded = True + + +def check_invalid_constraint_type(req: InstallRequirement) -> str: + # Check for unsupported forms + problem = "" + if not req.name: + problem = "Unnamed requirements are not allowed as constraints" + elif req.editable: + problem = "Editable requirements are not allowed as constraints" + elif req.extras: + problem = "Constraints cannot have extras" + + if problem: + deprecated( + reason=( + "Constraints are only allowed to take the form of a package " + "name and a version specifier. Other forms were originally " + "permitted as an accident of the implementation, but were " + "undocumented. The new implementation of the resolver no " + "longer supports these forms." + ), + replacement="replacing the constraint with a requirement", + # No plan yet for when the new resolver becomes default + gone_in=None, + issue=8210, + ) + + return problem + + +def _has_option(options: Values, reqs: List[InstallRequirement], option: str) -> bool: + if getattr(options, option, None): + return True + for req in reqs: + if getattr(req, option, None): + return True + return False + + +def check_legacy_setup_py_options( + options: Values, + reqs: List[InstallRequirement], +) -> None: + has_build_options = _has_option(options, reqs, "build_options") + has_global_options = _has_option(options, reqs, "global_options") + if has_build_options or has_global_options: + deprecated( + reason="--build-option and --global-option are deprecated.", + issue=11859, + replacement="to use --config-settings", + gone_in="25.0", + ) + logger.warning( + "Implying --no-binary=:all: due to the presence of " + "--build-option / --global-option. " + ) + options.format_control.disallow_binaries() diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/req/req_set.py b/.venv/lib/python3.12/site-packages/pip/_internal/req/req_set.py new file mode 100644 index 0000000..ec7a6e0 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/req/req_set.py @@ -0,0 +1,82 @@ +import logging +from collections import OrderedDict +from typing import Dict, List + +from pip._vendor.packaging.utils import canonicalize_name + +from pip._internal.req.req_install import InstallRequirement + +logger = logging.getLogger(__name__) + + +class RequirementSet: + def __init__(self, check_supported_wheels: bool = True) -> None: + """Create a RequirementSet.""" + + self.requirements: Dict[str, InstallRequirement] = OrderedDict() + self.check_supported_wheels = check_supported_wheels + + self.unnamed_requirements: List[InstallRequirement] = [] + + def __str__(self) -> str: + requirements = sorted( + (req for req in self.requirements.values() if not req.comes_from), + key=lambda req: canonicalize_name(req.name or ""), + ) + return " ".join(str(req.req) for req in requirements) + + def __repr__(self) -> str: + requirements = sorted( + self.requirements.values(), + key=lambda req: canonicalize_name(req.name or ""), + ) + + format_string = "<{classname} object; {count} requirement(s): {reqs}>" + return format_string.format( + classname=self.__class__.__name__, + count=len(requirements), + reqs=", ".join(str(req.req) for req in requirements), + ) + + def add_unnamed_requirement(self, install_req: InstallRequirement) -> None: + assert not install_req.name + self.unnamed_requirements.append(install_req) + + def add_named_requirement(self, install_req: InstallRequirement) -> None: + assert install_req.name + + project_name = canonicalize_name(install_req.name) + self.requirements[project_name] = install_req + + def has_requirement(self, name: str) -> bool: + project_name = canonicalize_name(name) + + return ( + project_name in self.requirements + and not self.requirements[project_name].constraint + ) + + def get_requirement(self, name: str) -> InstallRequirement: + project_name = canonicalize_name(name) + + if project_name in self.requirements: + return self.requirements[project_name] + + raise KeyError(f"No project with the name {name!r}") + + @property + def all_requirements(self) -> List[InstallRequirement]: + return self.unnamed_requirements + list(self.requirements.values()) + + @property + def requirements_to_install(self) -> List[InstallRequirement]: + """Return the list of requirements that need to be installed. + + TODO remove this property together with the legacy resolver, since the new + resolver only returns requirements that need to be installed. + """ + return [ + install_req + for install_req in self.all_requirements + if not install_req.constraint and not install_req.satisfied_by + ] diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/req/req_uninstall.py b/.venv/lib/python3.12/site-packages/pip/_internal/req/req_uninstall.py new file mode 100644 index 0000000..26df208 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/req/req_uninstall.py @@ -0,0 +1,633 @@ +import functools +import os +import sys +import sysconfig +from importlib.util import cache_from_source +from typing import Any, Callable, Dict, Generator, Iterable, List, Optional, Set, Tuple + +from pip._internal.exceptions import LegacyDistutilsInstall, UninstallMissingRecord +from pip._internal.locations import get_bin_prefix, get_bin_user +from pip._internal.metadata import BaseDistribution +from pip._internal.utils.compat import WINDOWS +from pip._internal.utils.egg_link import egg_link_path_from_location +from pip._internal.utils.logging import getLogger, indent_log +from pip._internal.utils.misc import ask, normalize_path, renames, rmtree +from pip._internal.utils.temp_dir import AdjacentTempDirectory, TempDirectory +from pip._internal.utils.virtualenv import running_under_virtualenv + +logger = getLogger(__name__) + + +def _script_names( + bin_dir: str, script_name: str, is_gui: bool +) -> Generator[str, None, None]: + """Create the fully qualified name of the files created by + {console,gui}_scripts for the given ``dist``. + Returns the list of file names + """ + exe_name = os.path.join(bin_dir, script_name) + yield exe_name + if not WINDOWS: + return + yield f"{exe_name}.exe" + yield f"{exe_name}.exe.manifest" + if is_gui: + yield f"{exe_name}-script.pyw" + else: + yield f"{exe_name}-script.py" + + +def _unique( + fn: Callable[..., Generator[Any, None, None]] +) -> Callable[..., Generator[Any, None, None]]: + @functools.wraps(fn) + def unique(*args: Any, **kw: Any) -> Generator[Any, None, None]: + seen: Set[Any] = set() + for item in fn(*args, **kw): + if item not in seen: + seen.add(item) + yield item + + return unique + + +@_unique +def uninstallation_paths(dist: BaseDistribution) -> Generator[str, None, None]: + """ + Yield all the uninstallation paths for dist based on RECORD-without-.py[co] + + Yield paths to all the files in RECORD. For each .py file in RECORD, add + the .pyc and .pyo in the same directory. + + UninstallPathSet.add() takes care of the __pycache__ .py[co]. + + If RECORD is not found, raises an error, + with possible information from the INSTALLER file. + + https://packaging.python.org/specifications/recording-installed-packages/ + """ + location = dist.location + assert location is not None, "not installed" + + entries = dist.iter_declared_entries() + if entries is None: + raise UninstallMissingRecord(distribution=dist) + + for entry in entries: + path = os.path.join(location, entry) + yield path + if path.endswith(".py"): + dn, fn = os.path.split(path) + base = fn[:-3] + path = os.path.join(dn, base + ".pyc") + yield path + path = os.path.join(dn, base + ".pyo") + yield path + + +def compact(paths: Iterable[str]) -> Set[str]: + """Compact a path set to contain the minimal number of paths + necessary to contain all paths in the set. If /a/path/ and + /a/path/to/a/file.txt are both in the set, leave only the + shorter path.""" + + sep = os.path.sep + short_paths: Set[str] = set() + for path in sorted(paths, key=len): + should_skip = any( + path.startswith(shortpath.rstrip("*")) + and path[len(shortpath.rstrip("*").rstrip(sep))] == sep + for shortpath in short_paths + ) + if not should_skip: + short_paths.add(path) + return short_paths + + +def compress_for_rename(paths: Iterable[str]) -> Set[str]: + """Returns a set containing the paths that need to be renamed. + + This set may include directories when the original sequence of paths + included every file on disk. + """ + case_map = {os.path.normcase(p): p for p in paths} + remaining = set(case_map) + unchecked = sorted({os.path.split(p)[0] for p in case_map.values()}, key=len) + wildcards: Set[str] = set() + + def norm_join(*a: str) -> str: + return os.path.normcase(os.path.join(*a)) + + for root in unchecked: + if any(os.path.normcase(root).startswith(w) for w in wildcards): + # This directory has already been handled. + continue + + all_files: Set[str] = set() + all_subdirs: Set[str] = set() + for dirname, subdirs, files in os.walk(root): + all_subdirs.update(norm_join(root, dirname, d) for d in subdirs) + all_files.update(norm_join(root, dirname, f) for f in files) + # If all the files we found are in our remaining set of files to + # remove, then remove them from the latter set and add a wildcard + # for the directory. + if not (all_files - remaining): + remaining.difference_update(all_files) + wildcards.add(root + os.sep) + + return set(map(case_map.__getitem__, remaining)) | wildcards + + +def compress_for_output_listing(paths: Iterable[str]) -> Tuple[Set[str], Set[str]]: + """Returns a tuple of 2 sets of which paths to display to user + + The first set contains paths that would be deleted. Files of a package + are not added and the top-level directory of the package has a '*' added + at the end - to signify that all it's contents are removed. + + The second set contains files that would have been skipped in the above + folders. + """ + + will_remove = set(paths) + will_skip = set() + + # Determine folders and files + folders = set() + files = set() + for path in will_remove: + if path.endswith(".pyc"): + continue + if path.endswith("__init__.py") or ".dist-info" in path: + folders.add(os.path.dirname(path)) + files.add(path) + + _normcased_files = set(map(os.path.normcase, files)) + + folders = compact(folders) + + # This walks the tree using os.walk to not miss extra folders + # that might get added. + for folder in folders: + for dirpath, _, dirfiles in os.walk(folder): + for fname in dirfiles: + if fname.endswith(".pyc"): + continue + + file_ = os.path.join(dirpath, fname) + if ( + os.path.isfile(file_) + and os.path.normcase(file_) not in _normcased_files + ): + # We are skipping this file. Add it to the set. + will_skip.add(file_) + + will_remove = files | {os.path.join(folder, "*") for folder in folders} + + return will_remove, will_skip + + +class StashedUninstallPathSet: + """A set of file rename operations to stash files while + tentatively uninstalling them.""" + + def __init__(self) -> None: + # Mapping from source file root to [Adjacent]TempDirectory + # for files under that directory. + self._save_dirs: Dict[str, TempDirectory] = {} + # (old path, new path) tuples for each move that may need + # to be undone. + self._moves: List[Tuple[str, str]] = [] + + def _get_directory_stash(self, path: str) -> str: + """Stashes a directory. + + Directories are stashed adjacent to their original location if + possible, or else moved/copied into the user's temp dir.""" + + try: + save_dir: TempDirectory = AdjacentTempDirectory(path) + except OSError: + save_dir = TempDirectory(kind="uninstall") + self._save_dirs[os.path.normcase(path)] = save_dir + + return save_dir.path + + def _get_file_stash(self, path: str) -> str: + """Stashes a file. + + If no root has been provided, one will be created for the directory + in the user's temp directory.""" + path = os.path.normcase(path) + head, old_head = os.path.dirname(path), None + save_dir = None + + while head != old_head: + try: + save_dir = self._save_dirs[head] + break + except KeyError: + pass + head, old_head = os.path.dirname(head), head + else: + # Did not find any suitable root + head = os.path.dirname(path) + save_dir = TempDirectory(kind="uninstall") + self._save_dirs[head] = save_dir + + relpath = os.path.relpath(path, head) + if relpath and relpath != os.path.curdir: + return os.path.join(save_dir.path, relpath) + return save_dir.path + + def stash(self, path: str) -> str: + """Stashes the directory or file and returns its new location. + Handle symlinks as files to avoid modifying the symlink targets. + """ + path_is_dir = os.path.isdir(path) and not os.path.islink(path) + if path_is_dir: + new_path = self._get_directory_stash(path) + else: + new_path = self._get_file_stash(path) + + self._moves.append((path, new_path)) + if path_is_dir and os.path.isdir(new_path): + # If we're moving a directory, we need to + # remove the destination first or else it will be + # moved to inside the existing directory. + # We just created new_path ourselves, so it will + # be removable. + os.rmdir(new_path) + renames(path, new_path) + return new_path + + def commit(self) -> None: + """Commits the uninstall by removing stashed files.""" + for save_dir in self._save_dirs.values(): + save_dir.cleanup() + self._moves = [] + self._save_dirs = {} + + def rollback(self) -> None: + """Undoes the uninstall by moving stashed files back.""" + for p in self._moves: + logger.info("Moving to %s\n from %s", *p) + + for new_path, path in self._moves: + try: + logger.debug("Replacing %s from %s", new_path, path) + if os.path.isfile(new_path) or os.path.islink(new_path): + os.unlink(new_path) + elif os.path.isdir(new_path): + rmtree(new_path) + renames(path, new_path) + except OSError as ex: + logger.error("Failed to restore %s", new_path) + logger.debug("Exception: %s", ex) + + self.commit() + + @property + def can_rollback(self) -> bool: + return bool(self._moves) + + +class UninstallPathSet: + """A set of file paths to be removed in the uninstallation of a + requirement.""" + + def __init__(self, dist: BaseDistribution) -> None: + self._paths: Set[str] = set() + self._refuse: Set[str] = set() + self._pth: Dict[str, UninstallPthEntries] = {} + self._dist = dist + self._moved_paths = StashedUninstallPathSet() + # Create local cache of normalize_path results. Creating an UninstallPathSet + # can result in hundreds/thousands of redundant calls to normalize_path with + # the same args, which hurts performance. + self._normalize_path_cached = functools.lru_cache(normalize_path) + + def _permitted(self, path: str) -> bool: + """ + Return True if the given path is one we are permitted to + remove/modify, False otherwise. + + """ + # aka is_local, but caching normalized sys.prefix + if not running_under_virtualenv(): + return True + return path.startswith(self._normalize_path_cached(sys.prefix)) + + def add(self, path: str) -> None: + head, tail = os.path.split(path) + + # we normalize the head to resolve parent directory symlinks, but not + # the tail, since we only want to uninstall symlinks, not their targets + path = os.path.join(self._normalize_path_cached(head), os.path.normcase(tail)) + + if not os.path.exists(path): + return + if self._permitted(path): + self._paths.add(path) + else: + self._refuse.add(path) + + # __pycache__ files can show up after 'installed-files.txt' is created, + # due to imports + if os.path.splitext(path)[1] == ".py": + self.add(cache_from_source(path)) + + def add_pth(self, pth_file: str, entry: str) -> None: + pth_file = self._normalize_path_cached(pth_file) + if self._permitted(pth_file): + if pth_file not in self._pth: + self._pth[pth_file] = UninstallPthEntries(pth_file) + self._pth[pth_file].add(entry) + else: + self._refuse.add(pth_file) + + def remove(self, auto_confirm: bool = False, verbose: bool = False) -> None: + """Remove paths in ``self._paths`` with confirmation (unless + ``auto_confirm`` is True).""" + + if not self._paths: + logger.info( + "Can't uninstall '%s'. No files were found to uninstall.", + self._dist.raw_name, + ) + return + + dist_name_version = f"{self._dist.raw_name}-{self._dist.raw_version}" + logger.info("Uninstalling %s:", dist_name_version) + + with indent_log(): + if auto_confirm or self._allowed_to_proceed(verbose): + moved = self._moved_paths + + for_rename = compress_for_rename(self._paths) + + for path in sorted(compact(for_rename)): + moved.stash(path) + logger.verbose("Removing file or directory %s", path) + + for pth in self._pth.values(): + pth.remove() + + logger.info("Successfully uninstalled %s", dist_name_version) + + def _allowed_to_proceed(self, verbose: bool) -> bool: + """Display which files would be deleted and prompt for confirmation""" + + def _display(msg: str, paths: Iterable[str]) -> None: + if not paths: + return + + logger.info(msg) + with indent_log(): + for path in sorted(compact(paths)): + logger.info(path) + + if not verbose: + will_remove, will_skip = compress_for_output_listing(self._paths) + else: + # In verbose mode, display all the files that are going to be + # deleted. + will_remove = set(self._paths) + will_skip = set() + + _display("Would remove:", will_remove) + _display("Would not remove (might be manually added):", will_skip) + _display("Would not remove (outside of prefix):", self._refuse) + if verbose: + _display("Will actually move:", compress_for_rename(self._paths)) + + return ask("Proceed (Y/n)? ", ("y", "n", "")) != "n" + + def rollback(self) -> None: + """Rollback the changes previously made by remove().""" + if not self._moved_paths.can_rollback: + logger.error( + "Can't roll back %s; was not uninstalled", + self._dist.raw_name, + ) + return + logger.info("Rolling back uninstall of %s", self._dist.raw_name) + self._moved_paths.rollback() + for pth in self._pth.values(): + pth.rollback() + + def commit(self) -> None: + """Remove temporary save dir: rollback will no longer be possible.""" + self._moved_paths.commit() + + @classmethod + def from_dist(cls, dist: BaseDistribution) -> "UninstallPathSet": + dist_location = dist.location + info_location = dist.info_location + if dist_location is None: + logger.info( + "Not uninstalling %s since it is not installed", + dist.canonical_name, + ) + return cls(dist) + + normalized_dist_location = normalize_path(dist_location) + if not dist.local: + logger.info( + "Not uninstalling %s at %s, outside environment %s", + dist.canonical_name, + normalized_dist_location, + sys.prefix, + ) + return cls(dist) + + if normalized_dist_location in { + p + for p in {sysconfig.get_path("stdlib"), sysconfig.get_path("platstdlib")} + if p + }: + logger.info( + "Not uninstalling %s at %s, as it is in the standard library.", + dist.canonical_name, + normalized_dist_location, + ) + return cls(dist) + + paths_to_remove = cls(dist) + develop_egg_link = egg_link_path_from_location(dist.raw_name) + + # Distribution is installed with metadata in a "flat" .egg-info + # directory. This means it is not a modern .dist-info installation, an + # egg, or legacy editable. + setuptools_flat_installation = ( + dist.installed_with_setuptools_egg_info + and info_location is not None + and os.path.exists(info_location) + # If dist is editable and the location points to a ``.egg-info``, + # we are in fact in the legacy editable case. + and not info_location.endswith(f"{dist.setuptools_filename}.egg-info") + ) + + # Uninstall cases order do matter as in the case of 2 installs of the + # same package, pip needs to uninstall the currently detected version + if setuptools_flat_installation: + if info_location is not None: + paths_to_remove.add(info_location) + installed_files = dist.iter_declared_entries() + if installed_files is not None: + for installed_file in installed_files: + paths_to_remove.add(os.path.join(dist_location, installed_file)) + # FIXME: need a test for this elif block + # occurs with --single-version-externally-managed/--record outside + # of pip + elif dist.is_file("top_level.txt"): + try: + namespace_packages = dist.read_text("namespace_packages.txt") + except FileNotFoundError: + namespaces = [] + else: + namespaces = namespace_packages.splitlines(keepends=False) + for top_level_pkg in [ + p + for p in dist.read_text("top_level.txt").splitlines() + if p and p not in namespaces + ]: + path = os.path.join(dist_location, top_level_pkg) + paths_to_remove.add(path) + paths_to_remove.add(f"{path}.py") + paths_to_remove.add(f"{path}.pyc") + paths_to_remove.add(f"{path}.pyo") + + elif dist.installed_by_distutils: + raise LegacyDistutilsInstall(distribution=dist) + + elif dist.installed_as_egg: + # package installed by easy_install + # We cannot match on dist.egg_name because it can slightly vary + # i.e. setuptools-0.6c11-py2.6.egg vs setuptools-0.6rc11-py2.6.egg + paths_to_remove.add(dist_location) + easy_install_egg = os.path.split(dist_location)[1] + easy_install_pth = os.path.join( + os.path.dirname(dist_location), + "easy-install.pth", + ) + paths_to_remove.add_pth(easy_install_pth, "./" + easy_install_egg) + + elif dist.installed_with_dist_info: + for path in uninstallation_paths(dist): + paths_to_remove.add(path) + + elif develop_egg_link: + # PEP 660 modern editable is handled in the ``.dist-info`` case + # above, so this only covers the setuptools-style editable. + with open(develop_egg_link) as fh: + link_pointer = os.path.normcase(fh.readline().strip()) + normalized_link_pointer = paths_to_remove._normalize_path_cached( + link_pointer + ) + assert os.path.samefile( + normalized_link_pointer, normalized_dist_location + ), ( + f"Egg-link {develop_egg_link} (to {link_pointer}) does not match " + f"installed location of {dist.raw_name} (at {dist_location})" + ) + paths_to_remove.add(develop_egg_link) + easy_install_pth = os.path.join( + os.path.dirname(develop_egg_link), "easy-install.pth" + ) + paths_to_remove.add_pth(easy_install_pth, dist_location) + + else: + logger.debug( + "Not sure how to uninstall: %s - Check: %s", + dist, + dist_location, + ) + + if dist.in_usersite: + bin_dir = get_bin_user() + else: + bin_dir = get_bin_prefix() + + # find distutils scripts= scripts + try: + for script in dist.iter_distutils_script_names(): + paths_to_remove.add(os.path.join(bin_dir, script)) + if WINDOWS: + paths_to_remove.add(os.path.join(bin_dir, f"{script}.bat")) + except (FileNotFoundError, NotADirectoryError): + pass + + # find console_scripts and gui_scripts + def iter_scripts_to_remove( + dist: BaseDistribution, + bin_dir: str, + ) -> Generator[str, None, None]: + for entry_point in dist.iter_entry_points(): + if entry_point.group == "console_scripts": + yield from _script_names(bin_dir, entry_point.name, False) + elif entry_point.group == "gui_scripts": + yield from _script_names(bin_dir, entry_point.name, True) + + for s in iter_scripts_to_remove(dist, bin_dir): + paths_to_remove.add(s) + + return paths_to_remove + + +class UninstallPthEntries: + def __init__(self, pth_file: str) -> None: + self.file = pth_file + self.entries: Set[str] = set() + self._saved_lines: Optional[List[bytes]] = None + + def add(self, entry: str) -> None: + entry = os.path.normcase(entry) + # On Windows, os.path.normcase converts the entry to use + # backslashes. This is correct for entries that describe absolute + # paths outside of site-packages, but all the others use forward + # slashes. + # os.path.splitdrive is used instead of os.path.isabs because isabs + # treats non-absolute paths with drive letter markings like c:foo\bar + # as absolute paths. It also does not recognize UNC paths if they don't + # have more than "\\sever\share". Valid examples: "\\server\share\" or + # "\\server\share\folder". + if WINDOWS and not os.path.splitdrive(entry)[0]: + entry = entry.replace("\\", "/") + self.entries.add(entry) + + def remove(self) -> None: + logger.verbose("Removing pth entries from %s:", self.file) + + # If the file doesn't exist, log a warning and return + if not os.path.isfile(self.file): + logger.warning("Cannot remove entries from nonexistent file %s", self.file) + return + with open(self.file, "rb") as fh: + # windows uses '\r\n' with py3k, but uses '\n' with py2.x + lines = fh.readlines() + self._saved_lines = lines + if any(b"\r\n" in line for line in lines): + endline = "\r\n" + else: + endline = "\n" + # handle missing trailing newline + if lines and not lines[-1].endswith(endline.encode("utf-8")): + lines[-1] = lines[-1] + endline.encode("utf-8") + for entry in self.entries: + try: + logger.verbose("Removing entry: %s", entry) + lines.remove((entry + endline).encode("utf-8")) + except ValueError: + pass + with open(self.file, "wb") as fh: + fh.writelines(lines) + + def rollback(self) -> bool: + if self._saved_lines is None: + logger.error("Cannot roll back changes to %s, none were made", self.file) + return False + logger.debug("Rolling %s back to previous state", self.file) + with open(self.file, "wb") as fh: + fh.writelines(self._saved_lines) + return True diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/resolution/__init__.py b/.venv/lib/python3.12/site-packages/pip/_internal/resolution/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/resolution/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/resolution/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..6c740ecc998642ab01249b66b1dc5dc05b98bcca GIT binary patch literal 195 zcmZ9FK?=e!5JeNKAVLq~!Vcx! Nv`;W(oO72&`T@;3H3R?v literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/resolution/__pycache__/base.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/resolution/__pycache__/base.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..98571b3726427674bff57dd8cfa65903735b82f5 GIT binary patch literal 1183 zcma)5OKTHR6ux&}nWQglwOXMPZL0<`<7;J$h$13t>ti>F!!&c!49+WeZX$6d;=+H> z-%$Ef+@!dX3!)${+*MN$TzSqU6~!*RFz0^fyLZlf=P_?5CMpcqw};!!+Ztn^$=P4V z2n?Pe*kl0p}VSa)?!oE90e>6!)BBP%YsCC-3@4LX=}_~wQNW>X{NmNj;p z1;%R@nA`X@T5hFh)kR#o8Y2ulN>U-QsFyHI;YbEGn{u;Fb`n!15S5L`^{*6Juy{idC&ve?E0u zX$+3YK#H^*Hd;<24Zyh{<_)Lbg{135;kuLcWGhWB*Dqdj@=(J0%x^sNHz0SiFmt>x zksz?rj-VtvRCZ?_bFODSRVuhHyg2-473w2)990Y^(7a@O7MnWtZgQb-FAR`i^k&=3 zu`i=`6Zt=75R-UMOrfc1;t*jfSx!-^RWXg5n%w}2s*9QMNv@ZQ0K|)hzce0vsfc)( z!X81hS}QBt^AbM>&r=o8i_@SJ5gzxvcE^u~CxU(mK|`gC^)!t{iToKd$IxsIgB9XL znOHJKpROZ#&2}~2Tzo$_-#>9-XYS&zPTt+MV*gY=Ixx}Stq^&1X+%!+C#yT;uZP+v{!~TyCxQpqq)wnqS@6s=O5X*9d_;uTlv7Qe41Z+Z`yCp_GgxM fDyRF#nSO1#Z!CY)wG&#O9sf}&^TqEBO%eMS7!WcL literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/resolution/base.py b/.venv/lib/python3.12/site-packages/pip/_internal/resolution/base.py new file mode 100644 index 0000000..42dade1 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/resolution/base.py @@ -0,0 +1,20 @@ +from typing import Callable, List, Optional + +from pip._internal.req.req_install import InstallRequirement +from pip._internal.req.req_set import RequirementSet + +InstallRequirementProvider = Callable[ + [str, Optional[InstallRequirement]], InstallRequirement +] + + +class BaseResolver: + def resolve( + self, root_reqs: List[InstallRequirement], check_supported_wheels: bool + ) -> RequirementSet: + raise NotImplementedError() + + def get_installation_order( + self, req_set: RequirementSet + ) -> List[InstallRequirement]: + raise NotImplementedError() diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/resolution/legacy/__init__.py b/.venv/lib/python3.12/site-packages/pip/_internal/resolution/legacy/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/resolution/legacy/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/resolution/legacy/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..7952fd3b262647bd4375b7be1a08ad550d31b299 GIT binary patch literal 202 zcmZ8aK?=e!5Nxc12z`hLyQo+32MWF*#B{ZbX%dpOkeB!d@hLvT7nI(5GQB#mJ2Sfj z^C^l|me60`w~4>g`o}O&muD8UH9NmDH%o4qG9y848U$xCIMb1=L7EETL|#JKq3%G@ z6>JQ((fe|{15W`rR>+6AqX$bCIO%{+3k43nQEecjLE&A<2s}M0a9-LtE)R{VT7^fq QNX;ybpG2QC#$2A%4|}^euK)l5 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/resolution/legacy/__pycache__/resolver.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/resolution/legacy/__pycache__/resolver.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..df561fffd4a7cc97fd79708c98a8b14cb053c458 GIT binary patch literal 22615 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/resolution/legacy/resolver.py b/.venv/lib/python3.12/site-packages/pip/_internal/resolution/legacy/resolver.py new file mode 100644 index 0000000..1dd0d70 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/resolution/legacy/resolver.py @@ -0,0 +1,597 @@ +"""Dependency Resolution + +The dependency resolution in pip is performed as follows: + +for top-level requirements: + a. only one spec allowed per project, regardless of conflicts or not. + otherwise a "double requirement" exception is raised + b. they override sub-dependency requirements. +for sub-dependencies + a. "first found, wins" (where the order is breadth first) +""" + +import logging +import sys +from collections import defaultdict +from itertools import chain +from typing import DefaultDict, Iterable, List, Optional, Set, Tuple + +from pip._vendor.packaging import specifiers +from pip._vendor.packaging.requirements import Requirement + +from pip._internal.cache import WheelCache +from pip._internal.exceptions import ( + BestVersionAlreadyInstalled, + DistributionNotFound, + HashError, + HashErrors, + InstallationError, + NoneMetadataError, + UnsupportedPythonVersion, +) +from pip._internal.index.package_finder import PackageFinder +from pip._internal.metadata import BaseDistribution +from pip._internal.models.link import Link +from pip._internal.models.wheel import Wheel +from pip._internal.operations.prepare import RequirementPreparer +from pip._internal.req.req_install import ( + InstallRequirement, + check_invalid_constraint_type, +) +from pip._internal.req.req_set import RequirementSet +from pip._internal.resolution.base import BaseResolver, InstallRequirementProvider +from pip._internal.utils import compatibility_tags +from pip._internal.utils.compatibility_tags import get_supported +from pip._internal.utils.direct_url_helpers import direct_url_from_link +from pip._internal.utils.logging import indent_log +from pip._internal.utils.misc import normalize_version_info +from pip._internal.utils.packaging import check_requires_python + +logger = logging.getLogger(__name__) + +DiscoveredDependencies = DefaultDict[Optional[str], List[InstallRequirement]] + + +def _check_dist_requires_python( + dist: BaseDistribution, + version_info: Tuple[int, int, int], + ignore_requires_python: bool = False, +) -> None: + """ + Check whether the given Python version is compatible with a distribution's + "Requires-Python" value. + + :param version_info: A 3-tuple of ints representing the Python + major-minor-micro version to check. + :param ignore_requires_python: Whether to ignore the "Requires-Python" + value if the given Python version isn't compatible. + + :raises UnsupportedPythonVersion: When the given Python version isn't + compatible. + """ + # This idiosyncratically converts the SpecifierSet to str and let + # check_requires_python then parse it again into SpecifierSet. But this + # is the legacy resolver so I'm just not going to bother refactoring. + try: + requires_python = str(dist.requires_python) + except FileNotFoundError as e: + raise NoneMetadataError(dist, str(e)) + try: + is_compatible = check_requires_python( + requires_python, + version_info=version_info, + ) + except specifiers.InvalidSpecifier as exc: + logger.warning( + "Package %r has an invalid Requires-Python: %s", dist.raw_name, exc + ) + return + + if is_compatible: + return + + version = ".".join(map(str, version_info)) + if ignore_requires_python: + logger.debug( + "Ignoring failed Requires-Python check for package %r: %s not in %r", + dist.raw_name, + version, + requires_python, + ) + return + + raise UnsupportedPythonVersion( + f"Package {dist.raw_name!r} requires a different Python: " + f"{version} not in {requires_python!r}" + ) + + +class Resolver(BaseResolver): + """Resolves which packages need to be installed/uninstalled to perform \ + the requested operation without breaking the requirements of any package. + """ + + _allowed_strategies = {"eager", "only-if-needed", "to-satisfy-only"} + + def __init__( + self, + preparer: RequirementPreparer, + finder: PackageFinder, + wheel_cache: Optional[WheelCache], + make_install_req: InstallRequirementProvider, + use_user_site: bool, + ignore_dependencies: bool, + ignore_installed: bool, + ignore_requires_python: bool, + force_reinstall: bool, + upgrade_strategy: str, + py_version_info: Optional[Tuple[int, ...]] = None, + ) -> None: + super().__init__() + assert upgrade_strategy in self._allowed_strategies + + if py_version_info is None: + py_version_info = sys.version_info[:3] + else: + py_version_info = normalize_version_info(py_version_info) + + self._py_version_info = py_version_info + + self.preparer = preparer + self.finder = finder + self.wheel_cache = wheel_cache + + self.upgrade_strategy = upgrade_strategy + self.force_reinstall = force_reinstall + self.ignore_dependencies = ignore_dependencies + self.ignore_installed = ignore_installed + self.ignore_requires_python = ignore_requires_python + self.use_user_site = use_user_site + self._make_install_req = make_install_req + + self._discovered_dependencies: DiscoveredDependencies = defaultdict(list) + + def resolve( + self, root_reqs: List[InstallRequirement], check_supported_wheels: bool + ) -> RequirementSet: + """Resolve what operations need to be done + + As a side-effect of this method, the packages (and their dependencies) + are downloaded, unpacked and prepared for installation. This + preparation is done by ``pip.operations.prepare``. + + Once PyPI has static dependency metadata available, it would be + possible to move the preparation to become a step separated from + dependency resolution. + """ + requirement_set = RequirementSet(check_supported_wheels=check_supported_wheels) + for req in root_reqs: + if req.constraint: + check_invalid_constraint_type(req) + self._add_requirement_to_set(requirement_set, req) + + # Actually prepare the files, and collect any exceptions. Most hash + # exceptions cannot be checked ahead of time, because + # _populate_link() needs to be called before we can make decisions + # based on link type. + discovered_reqs: List[InstallRequirement] = [] + hash_errors = HashErrors() + for req in chain(requirement_set.all_requirements, discovered_reqs): + try: + discovered_reqs.extend(self._resolve_one(requirement_set, req)) + except HashError as exc: + exc.req = req + hash_errors.append(exc) + + if hash_errors: + raise hash_errors + + return requirement_set + + def _add_requirement_to_set( + self, + requirement_set: RequirementSet, + install_req: InstallRequirement, + parent_req_name: Optional[str] = None, + extras_requested: Optional[Iterable[str]] = None, + ) -> Tuple[List[InstallRequirement], Optional[InstallRequirement]]: + """Add install_req as a requirement to install. + + :param parent_req_name: The name of the requirement that needed this + added. The name is used because when multiple unnamed requirements + resolve to the same name, we could otherwise end up with dependency + links that point outside the Requirements set. parent_req must + already be added. Note that None implies that this is a user + supplied requirement, vs an inferred one. + :param extras_requested: an iterable of extras used to evaluate the + environment markers. + :return: Additional requirements to scan. That is either [] if + the requirement is not applicable, or [install_req] if the + requirement is applicable and has just been added. + """ + # If the markers do not match, ignore this requirement. + if not install_req.match_markers(extras_requested): + logger.info( + "Ignoring %s: markers '%s' don't match your environment", + install_req.name, + install_req.markers, + ) + return [], None + + # If the wheel is not supported, raise an error. + # Should check this after filtering out based on environment markers to + # allow specifying different wheels based on the environment/OS, in a + # single requirements file. + if install_req.link and install_req.link.is_wheel: + wheel = Wheel(install_req.link.filename) + tags = compatibility_tags.get_supported() + if requirement_set.check_supported_wheels and not wheel.supported(tags): + raise InstallationError( + f"{wheel.filename} is not a supported wheel on this platform." + ) + + # This next bit is really a sanity check. + assert ( + not install_req.user_supplied or parent_req_name is None + ), "a user supplied req shouldn't have a parent" + + # Unnamed requirements are scanned again and the requirement won't be + # added as a dependency until after scanning. + if not install_req.name: + requirement_set.add_unnamed_requirement(install_req) + return [install_req], None + + try: + existing_req: Optional[InstallRequirement] = ( + requirement_set.get_requirement(install_req.name) + ) + except KeyError: + existing_req = None + + has_conflicting_requirement = ( + parent_req_name is None + and existing_req + and not existing_req.constraint + and existing_req.extras == install_req.extras + and existing_req.req + and install_req.req + and existing_req.req.specifier != install_req.req.specifier + ) + if has_conflicting_requirement: + raise InstallationError( + f"Double requirement given: {install_req} " + f"(already in {existing_req}, name={install_req.name!r})" + ) + + # When no existing requirement exists, add the requirement as a + # dependency and it will be scanned again after. + if not existing_req: + requirement_set.add_named_requirement(install_req) + # We'd want to rescan this requirement later + return [install_req], install_req + + # Assume there's no need to scan, and that we've already + # encountered this for scanning. + if install_req.constraint or not existing_req.constraint: + return [], existing_req + + does_not_satisfy_constraint = install_req.link and not ( + existing_req.link and install_req.link.path == existing_req.link.path + ) + if does_not_satisfy_constraint: + raise InstallationError( + f"Could not satisfy constraints for '{install_req.name}': " + "installation from path or url cannot be " + "constrained to a version" + ) + # If we're now installing a constraint, mark the existing + # object for real installation. + existing_req.constraint = False + # If we're now installing a user supplied requirement, + # mark the existing object as such. + if install_req.user_supplied: + existing_req.user_supplied = True + existing_req.extras = tuple( + sorted(set(existing_req.extras) | set(install_req.extras)) + ) + logger.debug( + "Setting %s extras to: %s", + existing_req, + existing_req.extras, + ) + # Return the existing requirement for addition to the parent and + # scanning again. + return [existing_req], existing_req + + def _is_upgrade_allowed(self, req: InstallRequirement) -> bool: + if self.upgrade_strategy == "to-satisfy-only": + return False + elif self.upgrade_strategy == "eager": + return True + else: + assert self.upgrade_strategy == "only-if-needed" + return req.user_supplied or req.constraint + + def _set_req_to_reinstall(self, req: InstallRequirement) -> None: + """ + Set a requirement to be installed. + """ + # Don't uninstall the conflict if doing a user install and the + # conflict is not a user install. + assert req.satisfied_by is not None + if not self.use_user_site or req.satisfied_by.in_usersite: + req.should_reinstall = True + req.satisfied_by = None + + def _check_skip_installed( + self, req_to_install: InstallRequirement + ) -> Optional[str]: + """Check if req_to_install should be skipped. + + This will check if the req is installed, and whether we should upgrade + or reinstall it, taking into account all the relevant user options. + + After calling this req_to_install will only have satisfied_by set to + None if the req_to_install is to be upgraded/reinstalled etc. Any + other value will be a dist recording the current thing installed that + satisfies the requirement. + + Note that for vcs urls and the like we can't assess skipping in this + routine - we simply identify that we need to pull the thing down, + then later on it is pulled down and introspected to assess upgrade/ + reinstalls etc. + + :return: A text reason for why it was skipped, or None. + """ + if self.ignore_installed: + return None + + req_to_install.check_if_exists(self.use_user_site) + if not req_to_install.satisfied_by: + return None + + if self.force_reinstall: + self._set_req_to_reinstall(req_to_install) + return None + + if not self._is_upgrade_allowed(req_to_install): + if self.upgrade_strategy == "only-if-needed": + return "already satisfied, skipping upgrade" + return "already satisfied" + + # Check for the possibility of an upgrade. For link-based + # requirements we have to pull the tree down and inspect to assess + # the version #, so it's handled way down. + if not req_to_install.link: + try: + self.finder.find_requirement(req_to_install, upgrade=True) + except BestVersionAlreadyInstalled: + # Then the best version is installed. + return "already up-to-date" + except DistributionNotFound: + # No distribution found, so we squash the error. It will + # be raised later when we re-try later to do the install. + # Why don't we just raise here? + pass + + self._set_req_to_reinstall(req_to_install) + return None + + def _find_requirement_link(self, req: InstallRequirement) -> Optional[Link]: + upgrade = self._is_upgrade_allowed(req) + best_candidate = self.finder.find_requirement(req, upgrade) + if not best_candidate: + return None + + # Log a warning per PEP 592 if necessary before returning. + link = best_candidate.link + if link.is_yanked: + reason = link.yanked_reason or "" + msg = ( + # Mark this as a unicode string to prevent + # "UnicodeEncodeError: 'ascii' codec can't encode character" + # in Python 2 when the reason contains non-ascii characters. + "The candidate selected for download or install is a " + f"yanked version: {best_candidate}\n" + f"Reason for being yanked: {reason}" + ) + logger.warning(msg) + + return link + + def _populate_link(self, req: InstallRequirement) -> None: + """Ensure that if a link can be found for this, that it is found. + + Note that req.link may still be None - if the requirement is already + installed and not needed to be upgraded based on the return value of + _is_upgrade_allowed(). + + If preparer.require_hashes is True, don't use the wheel cache, because + cached wheels, always built locally, have different hashes than the + files downloaded from the index server and thus throw false hash + mismatches. Furthermore, cached wheels at present have undeterministic + contents due to file modification times. + """ + if req.link is None: + req.link = self._find_requirement_link(req) + + if self.wheel_cache is None or self.preparer.require_hashes: + return + + assert req.link is not None, "_find_requirement_link unexpectedly returned None" + cache_entry = self.wheel_cache.get_cache_entry( + link=req.link, + package_name=req.name, + supported_tags=get_supported(), + ) + if cache_entry is not None: + logger.debug("Using cached wheel link: %s", cache_entry.link) + if req.link is req.original_link and cache_entry.persistent: + req.cached_wheel_source_link = req.link + if cache_entry.origin is not None: + req.download_info = cache_entry.origin + else: + # Legacy cache entry that does not have origin.json. + # download_info may miss the archive_info.hashes field. + req.download_info = direct_url_from_link( + req.link, link_is_in_wheel_cache=cache_entry.persistent + ) + req.link = cache_entry.link + + def _get_dist_for(self, req: InstallRequirement) -> BaseDistribution: + """Takes a InstallRequirement and returns a single AbstractDist \ + representing a prepared variant of the same. + """ + if req.editable: + return self.preparer.prepare_editable_requirement(req) + + # satisfied_by is only evaluated by calling _check_skip_installed, + # so it must be None here. + assert req.satisfied_by is None + skip_reason = self._check_skip_installed(req) + + if req.satisfied_by: + return self.preparer.prepare_installed_requirement(req, skip_reason) + + # We eagerly populate the link, since that's our "legacy" behavior. + self._populate_link(req) + dist = self.preparer.prepare_linked_requirement(req) + + # NOTE + # The following portion is for determining if a certain package is + # going to be re-installed/upgraded or not and reporting to the user. + # This should probably get cleaned up in a future refactor. + + # req.req is only avail after unpack for URL + # pkgs repeat check_if_exists to uninstall-on-upgrade + # (#14) + if not self.ignore_installed: + req.check_if_exists(self.use_user_site) + + if req.satisfied_by: + should_modify = ( + self.upgrade_strategy != "to-satisfy-only" + or self.force_reinstall + or self.ignore_installed + or req.link.scheme == "file" + ) + if should_modify: + self._set_req_to_reinstall(req) + else: + logger.info( + "Requirement already satisfied (use --upgrade to upgrade): %s", + req, + ) + return dist + + def _resolve_one( + self, + requirement_set: RequirementSet, + req_to_install: InstallRequirement, + ) -> List[InstallRequirement]: + """Prepare a single requirements file. + + :return: A list of additional InstallRequirements to also install. + """ + # Tell user what we are doing for this requirement: + # obtain (editable), skipping, processing (local url), collecting + # (remote url or package name) + if req_to_install.constraint or req_to_install.prepared: + return [] + + req_to_install.prepared = True + + # Parse and return dependencies + dist = self._get_dist_for(req_to_install) + # This will raise UnsupportedPythonVersion if the given Python + # version isn't compatible with the distribution's Requires-Python. + _check_dist_requires_python( + dist, + version_info=self._py_version_info, + ignore_requires_python=self.ignore_requires_python, + ) + + more_reqs: List[InstallRequirement] = [] + + def add_req(subreq: Requirement, extras_requested: Iterable[str]) -> None: + # This idiosyncratically converts the Requirement to str and let + # make_install_req then parse it again into Requirement. But this is + # the legacy resolver so I'm just not going to bother refactoring. + sub_install_req = self._make_install_req(str(subreq), req_to_install) + parent_req_name = req_to_install.name + to_scan_again, add_to_parent = self._add_requirement_to_set( + requirement_set, + sub_install_req, + parent_req_name=parent_req_name, + extras_requested=extras_requested, + ) + if parent_req_name and add_to_parent: + self._discovered_dependencies[parent_req_name].append(add_to_parent) + more_reqs.extend(to_scan_again) + + with indent_log(): + # We add req_to_install before its dependencies, so that we + # can refer to it when adding dependencies. + assert req_to_install.name is not None + if not requirement_set.has_requirement(req_to_install.name): + # 'unnamed' requirements will get added here + # 'unnamed' requirements can only come from being directly + # provided by the user. + assert req_to_install.user_supplied + self._add_requirement_to_set( + requirement_set, req_to_install, parent_req_name=None + ) + + if not self.ignore_dependencies: + if req_to_install.extras: + logger.debug( + "Installing extra requirements: %r", + ",".join(req_to_install.extras), + ) + missing_requested = sorted( + set(req_to_install.extras) - set(dist.iter_provided_extras()) + ) + for missing in missing_requested: + logger.warning( + "%s %s does not provide the extra '%s'", + dist.raw_name, + dist.version, + missing, + ) + + available_requested = sorted( + set(dist.iter_provided_extras()) & set(req_to_install.extras) + ) + for subreq in dist.iter_dependencies(available_requested): + add_req(subreq, extras_requested=available_requested) + + return more_reqs + + def get_installation_order( + self, req_set: RequirementSet + ) -> List[InstallRequirement]: + """Create the installation order. + + The installation order is topological - requirements are installed + before the requiring thing. We break cycles at an arbitrary point, + and make no other guarantees. + """ + # The current implementation, which we may change at any point + # installs the user specified things in the order given, except when + # dependencies must come earlier to achieve topological order. + order = [] + ordered_reqs: Set[InstallRequirement] = set() + + def schedule(req: InstallRequirement) -> None: + if req.satisfied_by or req in ordered_reqs: + return + if req.constraint: + return + ordered_reqs.add(req) + for dep in self._discovered_dependencies[req.name]: + schedule(dep) + order.append(req) + + for install_req in req_set.requirements.values(): + schedule(install_req) + return order diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__init__.py b/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..770aad4c121f786c13c08da30044cc9a30ec484a GIT binary patch literal 206 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/candidates.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/candidates.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..7982ddb26161894a4fe11f6d3f343c788cfb2c8b GIT binary patch literal 29191 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 K4>)oe7W{8Oorc2z literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/found_candidates.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/found_candidates.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..12f61bcc1dca70d0a6394a04c9d91339463d68f2 GIT binary patch literal 6805 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 ASpWb4 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/provider.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/provider.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..0da0d636e2d8755348dd85f1266b0ad657501a38 GIT binary patch literal 10521 zcmbtaYiu0HeV@Je9q)K|Oa}*YKx-fREvM@cix6FLpEbZ`80J{soPVZh^74n8YL@ z!zPTkFd?9A%hA%hpWPWc?Fa&rF2(NoG4cW$tMuEvrr44I%F}G==iNo<_ znzJnvE%??V*U6!jtp!`1h|0Cpl3P=D-fqj;;5 zS@)gF=V(wmr|C840V}P@SvjX+di4D1=U*5(e|jwb+$-ZxpBs&j44)nyA9-rz^m%-B zKLx;fWe!!}bBdgj71{+_ja5)aa;dzMO=#GUE)46!i@G~&Zrq0r<+OAvEdv`#P9t(!D880FuQ0kI*QJM zL-7{umHC|Qm~R_nF zv^I?)imc`{mt{rV#Am?g6Y-2sr&UqD3gTkwR5~f5nUiHnmc%R5a!%ByWl>8gQ&`i2 zi4m9NISiPbv)1OIX#IVdl}=8J$wV%f*ThL#l)$T`mYL%_!z66Z*i^1+GvZ!jS~fAq zK_&A!4cx}QAvdaqX?%-nY(P9INoitLBD1;Sghcz*@?s*R=J`UjOhUYz$jr(dAhz0_ z%*crx#1Y@RIbH@#gN%e{HF1bGzZJd=QSr_s6pb$#b16+=ozhGNu~l~v&bmK8Bj@6i z5aLU+rVDY^g>M7^AhLtg`K&ys%*YzacXE0#nV00jXVYqOaNx3>yF8dlPY%w^Y18@K zqXP#H4ys^nzsXW{a3(!77>C%)3J@OTY@8+Rjp}8YPc{$Ez|5Q;iGx#dB5-^Y8>Jij zc?>`GX%yF3xtV$D7GEm4+t!1Pi}R&m_ll>x>}TzJ*4p-$+V(HkueKd7Ia;m_FYH?q zK5*ABIc~b&4$@%ljpB-@ZM~-M+UN#gu_P7N<2NfC=OLwUF`1E0ov=y5gk7@94#_S% zWtZ$Wb&^B&NN7tg-s?4c-I6Eem%PwRKFKH7Kwkx{FS0A;kZSOyR`O$BKn?<$^|h9_ zLUMrkV$KNizOWRk>I=(tMq6@Aby%q$@aj3dhzY@8HM(I3sBSrIuHumzF*^d?+aP(~ zZMtn9aH(1LOD%Fha?75SONw51+%^d_(P;M9$;K)UsTB~K zz2>>}jHM?N-^Y4r?@`4WQv$?vb|%9$BiCjk^qO__At>gFKLUA9WK|Jo%+#ss5%FZ@ zbmvpmUqp3APLlrPr=1STtST!5;#ql4q7DA#0K#_}&s%Yd!$Q%MU{EqmcYe}69DkMZh-3tK_W&P*u@Nsbd5 znmjdk1lr8lVE^W}%|W6yXd4JD7O!X-qJs)eM>N=qPnC*QvCD*3*=mIf>g>!+h6qJe z$GIhalm>|tnarTM31e;DoiePFUQ@*by?zJE=%MX6>a|3l%`GcY$ku3*G>-MyQK8?) zH57&|ilb&c1zUl|O+jUh>`dHN`Q|{2X7Z;1>lJrcEv?3?U9^t5)q%GpTxXW}W0u?c zGzXhCxQAm-Gr+;A@x(2r z_~X@FiNtqeOE~@+z69f28AHs?WN-+etyR6obRHz~l>+fgx%`zJodIoHjk$D(DrZs( z+*PLRp<*u;F)I2{RGAZwH}+~`I3L*w?+Kdo1r*TqA=V-;IBo>i+x9Ft?s{6*dmpEF z*Lv3hdUvdM_S3uV-r$k7!KX_2JM+@&;L8h+fAK^)rS)by9j3n(&nxf(O|L9j%`jps zmpKwglDUg`Z-2&^(vQBFpmfm7rX0abIfg{_3X&PUP;u>2I?pX`& zD+Twhc=j1`L8e)+*|d|Y?yGDVTz~{sT)l=(hp^fM3{B#!lS6t5sDh=cLgKpRfO*it zk^LFA{f9u;%e2ao(&!6+3J$~hvkr#!hPN*iT?LoYEZMI!Yt%5atVGeRRSrX%QQc>GBzflXy%^4g z{+G4F*!54XUB_w?KZp3j!;of^vX~InyrPk_&u!XN8vZJG$xU@2P9{{?yL=Az-iobE zCxhGqGRB$w71OL6L6hNA*0icZpm^Dx8PibR5Ft%R}8okdC0m|xm8sdsA4LusM>%CY-uE4 z!HfW_z##;aWCSwVG*A`y%2P)~X%@j{Ud-j;eQL>R;uoA#Vs#9pK$L5Esl-=VssaTy zP9|QiCiOYu^6%UwHbC3s;y|@I?zmPw#cE*N`35vHo;ol}u?I`|}eR7Sx-#Gra!^a;>78yemqgo52n0@ruM4Wls@#CCq7DBfC%8)?xBHBWayS{ z@%)l)DZKdNlJ=dil_EnX*XkkyIqG=IU)X|HMRvc2Z{HCri1k)UukE##H|#q(p9R}a z5eCKjIYAOkLhP;(!ZvE|fjg>CV3^^wIyi&5KX54-;gYp9f^ z`GgbbBWCZa`&Dz-lCbnx+0KSetUNxlIJ_3wU5f0!dHH)^|L)h{k39Ngbv1JSfgK|a z+P&V_FKi)MMbbq8t`H2-B1wXYw8ui4ALcD=7o^{p>wisHk^5tCz4yee1Ap;+srQ7* zYk#c}3n7h$R2&Wstb-mH)ABPTluYIcS^Io?M)z3ePq)Kh>yF8MKBEw+bPo~{rxhiy zC3YU~GQgM=sQz-P{bV5a-wHYzE z4Yj7~-ioHvo&2Qhfr<)2~LDouwQyD z)|27aNJem|2MiH2Lq%geR#f9g#!wG#LrR73&n`d?Kl2!|Rqa;&Iv@Rf-J1a<^#`yW zP_yMBx3}k>KlCS&#Y;E)N{#)i;eosULF5cOdlt_9swVnDmGJHb*S&BAD&toAZe(aRJVfn=#q=L{F1X5$ zfVXS?z~Qw6r%MM;zjv{8;Q57fNO^X2EsUaF8&3EAUHg}#rCrA!I?-4RJOmkc;Senc?)IKo z?K<&ZeW`2s&DwwO+V#EW?=~;iep;>vl;5h9J$Sw8)Diag?&xrh>qoBOaG3qWk(yzT z{U6-|mEn`Y(>?Zo>K0Jy{%WUA52tgtW z&a!F<@oWXBjfdQ~O{WMUogEM=0h%?Iv3H%f%^l+A#WiYV{mFi9QLuy%90#^hK=B>n zE%t_OC+i~#WNsB<&h|Oq?fiS&X7&K%s>u!L^c0xnz{ZI1c(^%t%nD;{&J}Yf?gFQi z2&l~5l#1&RiocAEB#*7kyzCb?gCWur{0<0rd&x^i^kmMjq)hkmXaUzjaGH%At(D)s z0#A0Urz^s>4xsHwUBd@eKB zEoO1)L}Ud~svvKHMO38QGRuZYRqi`&TzAU2-&4ltYYAk3I@NF7(2c$$@N1~2Vs_;) z#6jt%g6twXcqYupbCTS&7+wkqj^(824RPEbO{GDpIEW&kC4%q4_3NjdtEEHJ_?kWX$-D-M2xPQH=bv@j$7T!||?^$`|==yeK2Hu0g`(NVYPgQ{)rz7<(%>R$=zTla_7{Ou)w`?|mJUZi6!(p!r3u10o)WR1QBB3UT%t>PO+BOAKj)V1ES3*`qr zLwBO9J;N)V!|NS`AhB`3R}QdH{|0lDS#o=QoWOKho=sd;aeYJi(@M%$NnmG5Q{SL! zD1B;g!0k3ty{0OqkJeMLSqgSD>C1^|H;DKL7|20yi3&NL=Ub~OwT*)hFi$0YdyU-> zM%RLUrC{H!Csu=pS3HL~9$T`~q(J#rNhMRDyOV16GamF-qlnS;Y$Ad5sy%7r$yGPh zuDxKtMp2^uP1_Bx11Z;{eGDa1eyCkBv)nf25MaQJ!k680-4$~fG$6|A0e)9&5?ocD zMxPZ*m|_$nmkl|U%5~X%TQz~UfBl#skXR!YCF8re0U+S-rBp?`dF#;vE|}w z>*;?DzO?b=~KLTNcmm&e#bkG{f;e^BhPP&i_R|fzn&!aGP zA@}JO?$i<@)+tpemYnaXrs!uwg-&n{mZkVw`%tNUXs!Kt zsr~r-!Q&r5(FHr8`BtI%`tAhRhDJ+6qiaKBrJ=FazA=0*doh_#Y=d#|qI91_|3?sy z>%MqAi`**|a$NVvRFLlC`i!o}H03BYYp5WPMxkuH za)JtS*A&PuQ^=`N$jef)RFL1I5JmXmQ(i|+_d|;!-IRs#%}bm@JSyb-HR9V{G=Yk9 z_^CgH2Dr{1*gQ^8ITCQbBHRx*mz`9Bo7)&&>RFm!8Z0&RmEFA0!#cXlUS5S;-BGUL zRX=NKUmCmFv-I-YwdDZss%5^~jUcaf2+scHhUKrnH?s2hv!w&0WrmKGu@^V!U3R@9 zIDPjcO=T?Uq)?)fK*g56R%+N+cJn?DYiL_Kb+h?atkiXArR`8Da=7f}Uwp>sy(^DA zS?WHu(tfJcFkG(TpZu(~XQk&zDSEUV;2qde<3^BIFWdH-YvPS1n>v<~H-~PWE%gko zbPSampD4TOgNL>C+NCZpF%s-gi9jwU&mS-QW!@>8dM( z84c^8h@IY#Ji2n|Z0V6_c9Zy39xh!$1;_}6%%12*G1a(Tx55#e4Amx<-^IwqY{}A9k^8fTw6>{7W z&f^-v5LGVCTynoiP$+aau0^@jlivSapeB4pRp>fMd6Eh`A-HXQ&Rp+FT89E;rI8Bm z0B}LxPt6`Gx=`R=**JtJlsC~N>!#j8QML<$@Jm+rOIGtC>->$)E7*R+P;5}~aU&B> z{0BQ!VuwCt2R~$Ozp{rubR7NAapr#8!R4dxc~>4CDYboR#nEy<(tGpE%dtCSE4#i} ziky7yS#(@`_CX(W`WH^U{>(Mu14oTfDZ3hl`t?9$acrq;@x?ddWjosUL-l1R-jKN3 mVA)MI@VjQ=z(Qi-&}(1b@S^A8LDeQSEcSnli&eqk?*9NPZlDAJ literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/reporter.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/reporter.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..065d802049438069457e7bae84457491c08feb66 GIT binary patch literal 5043 zcmd5ATWlN0@s4*#9z{x`9)2k?vW}eCv}MwET+32iH;#m+iW6D36BJfkUr%>S>g3}c zvv-tDmInOc4;d&B<)?Phm+}=EE)eyr>R0n=p#2bG3sMdV>Y^wLqd!XJ{`jjicO*qg zY}x=R(1SEPyE{8OGdnvo%RjWXws7!$ap8XEhjEVk3wCOsR7KWr0dj}aIh{AT96!$U zh=}-~@WXKcF zT178591si#1o78ZhhC(4o4J%d!R>)CI;2{po|py#l{uw8hCAu7@6QDoty+xZid<3}EzRbQJTV+%+V)k$$`aKj zIWUruHz}E>%rR`sA$ErRD6eW))htykHAim{*CsjzyW|Xul53NOHd&)aW}2PLtFAEt zJgyn;B(dE|$_U%Amy;szO!|ZcQzx!^l@b-%m^4-TNmU}pHB9sWNUp#85`)knE?Ua8 zEpQ&5dUY{WXzA26wWiaiF_F#}-AUVeC3Wn0+A&;uq`HlR%BK~O zgfdGt)4nkaE_iByPE%aWsy7#`6%M%ihERq}KZSu~%Qww4zKHyq z%#{Uyt?1T588;Q(vK+d4s4Py!wvRX0=hs3lG~KUi3!z@TA(i!4y+KKN^Bp!A>W9UC0#;$0biMsGQeiG{TZi+VWx9C515JkLJT-q5^$5N+@x}3 zYR7i^`_-X<>c`&`xdxl<+D>1VYF6Me07pmtdsdQ1M!$W2ki6tTVv09L+S1YQVia^) z5dx%cWHOXNx*>IM>mzyrqKl28BV$4o87xUH1ioiHDaETH2LiZ7N?q?j3@SL)KujGM zB2+TY&b24v`3tOvJ}`~c!bszJjOa!%HhfjQh(*joUM?FT{!oe!1rKeiLs zb_LM|!k$t$M(Ksd+uekq7n$MRy~(Z0@fCT0MczMm`J*czUU?{=SmZ160JM)2-7AT{ zN}_N6^2b;1U8y8a&q%AW#9eV^_sI(U#ZIoqJ0ExMTtE{ zY1eQiG5mq>IMKDV3#FVDR$Gx1O_b?740 zNI}g6bxcMKY9_yiiqHtwHc&^&KqKq5zNkl`ABAeLMUT-~l_m~jalIARwAIJjVXU>@ z7xe`6+loT6)5BabjGmhXFRK-1rGc}MmxH1ZbH7V;n>qw)0Q6ZX3bF(opHR3BMTBr! z4VO5SI;p_)n+iJ24fwyF0&s_O>-Lz!(Ji0OZ;BnE(Nb4Us+8lZ%mpzICgF%*fQ5`8 z=mrp^+~C&8HM-K?X3Evsd=uBT1AvSec=l3va#=p)pPnZfP{v%>8j}_#5nqv`fc$4g z%KSzWfG`NEJhx31g+Y0tAAE@=*-2oU3gag9Tb6=v_8>rJ3 zuSm{=R~!qXRxix^38}eb9Ea)u#xb@WHaLH8{U}vEIP8t55~$Wk>X)E;h;>OeA7bbB z<)s5n72ZzxCMu5=K*NC!EWY|6yeyv&)UPM*uUq~7b@iL%?56tHMcJgkpP)(yn=0Id z^V>}{9$Xyxq_`|!_#gOecU{Z8Vc~mio6}-Zv?;Vjs+6VYo9a}Z9m8c?-1gA?$g+Gg zI5*5K$##~8hGBSS#{hT{MbT|dQCL3?;c_;Jz)$xW|Jkh4_CJdlmH=!R0eXAD zAL}u8q6UzO^Gg7?xKG8Qb&;12uZ4MOaBgUggJyns9h;0VD`zNmVuiU`jxPyO=cFvx97=8X`_-Xhs-!t3yl!NB!_xW9X|J~F75O F{1?UU#T@_u literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/requirements.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/requirements.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f9bb3319b477270c05e8e44e35ec18e50776c80f GIT binary patch literal 15348 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 B3cdgU literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/resolver.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/__pycache__/resolver.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..597be9bc24f24dedb01e448da4e19da047f880cd GIT binary patch literal 12349 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/base.py b/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/base.py new file mode 100644 index 0000000..0f31dc9 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/base.py @@ -0,0 +1,139 @@ +from dataclasses import dataclass +from typing import FrozenSet, Iterable, Optional, Tuple + +from pip._vendor.packaging.specifiers import SpecifierSet +from pip._vendor.packaging.utils import NormalizedName +from pip._vendor.packaging.version import Version + +from pip._internal.models.link import Link, links_equivalent +from pip._internal.req.req_install import InstallRequirement +from pip._internal.utils.hashes import Hashes + +CandidateLookup = Tuple[Optional["Candidate"], Optional[InstallRequirement]] + + +def format_name(project: NormalizedName, extras: FrozenSet[NormalizedName]) -> str: + if not extras: + return project + extras_expr = ",".join(sorted(extras)) + return f"{project}[{extras_expr}]" + + +@dataclass(frozen=True) +class Constraint: + specifier: SpecifierSet + hashes: Hashes + links: FrozenSet[Link] + + @classmethod + def empty(cls) -> "Constraint": + return Constraint(SpecifierSet(), Hashes(), frozenset()) + + @classmethod + def from_ireq(cls, ireq: InstallRequirement) -> "Constraint": + links = frozenset([ireq.link]) if ireq.link else frozenset() + return Constraint(ireq.specifier, ireq.hashes(trust_internet=False), links) + + def __bool__(self) -> bool: + return bool(self.specifier) or bool(self.hashes) or bool(self.links) + + def __and__(self, other: InstallRequirement) -> "Constraint": + if not isinstance(other, InstallRequirement): + return NotImplemented + specifier = self.specifier & other.specifier + hashes = self.hashes & other.hashes(trust_internet=False) + links = self.links + if other.link: + links = links.union([other.link]) + return Constraint(specifier, hashes, links) + + def is_satisfied_by(self, candidate: "Candidate") -> bool: + # Reject if there are any mismatched URL constraints on this package. + if self.links and not all(_match_link(link, candidate) for link in self.links): + return False + # We can safely always allow prereleases here since PackageFinder + # already implements the prerelease logic, and would have filtered out + # prerelease candidates if the user does not expect them. + return self.specifier.contains(candidate.version, prereleases=True) + + +class Requirement: + @property + def project_name(self) -> NormalizedName: + """The "project name" of a requirement. + + This is different from ``name`` if this requirement contains extras, + in which case ``name`` would contain the ``[...]`` part, while this + refers to the name of the project. + """ + raise NotImplementedError("Subclass should override") + + @property + def name(self) -> str: + """The name identifying this requirement in the resolver. + + This is different from ``project_name`` if this requirement contains + extras, where ``project_name`` would not contain the ``[...]`` part. + """ + raise NotImplementedError("Subclass should override") + + def is_satisfied_by(self, candidate: "Candidate") -> bool: + return False + + def get_candidate_lookup(self) -> CandidateLookup: + raise NotImplementedError("Subclass should override") + + def format_for_error(self) -> str: + raise NotImplementedError("Subclass should override") + + +def _match_link(link: Link, candidate: "Candidate") -> bool: + if candidate.source_link: + return links_equivalent(link, candidate.source_link) + return False + + +class Candidate: + @property + def project_name(self) -> NormalizedName: + """The "project name" of the candidate. + + This is different from ``name`` if this candidate contains extras, + in which case ``name`` would contain the ``[...]`` part, while this + refers to the name of the project. + """ + raise NotImplementedError("Override in subclass") + + @property + def name(self) -> str: + """The name identifying this candidate in the resolver. + + This is different from ``project_name`` if this candidate contains + extras, where ``project_name`` would not contain the ``[...]`` part. + """ + raise NotImplementedError("Override in subclass") + + @property + def version(self) -> Version: + raise NotImplementedError("Override in subclass") + + @property + def is_installed(self) -> bool: + raise NotImplementedError("Override in subclass") + + @property + def is_editable(self) -> bool: + raise NotImplementedError("Override in subclass") + + @property + def source_link(self) -> Optional[Link]: + raise NotImplementedError("Override in subclass") + + def iter_dependencies(self, with_requires: bool) -> Iterable[Optional[Requirement]]: + raise NotImplementedError("Override in subclass") + + def get_install_requirement(self) -> Optional[InstallRequirement]: + raise NotImplementedError("Override in subclass") + + def format_for_error(self) -> str: + raise NotImplementedError("Subclass should override") diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/candidates.py b/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/candidates.py new file mode 100644 index 0000000..d30d477 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/candidates.py @@ -0,0 +1,569 @@ +import logging +import sys +from typing import TYPE_CHECKING, Any, FrozenSet, Iterable, Optional, Tuple, Union, cast + +from pip._vendor.packaging.requirements import InvalidRequirement +from pip._vendor.packaging.utils import NormalizedName, canonicalize_name +from pip._vendor.packaging.version import Version + +from pip._internal.exceptions import ( + HashError, + InstallationSubprocessError, + MetadataInconsistent, + MetadataInvalid, +) +from pip._internal.metadata import BaseDistribution +from pip._internal.models.link import Link, links_equivalent +from pip._internal.models.wheel import Wheel +from pip._internal.req.constructors import ( + install_req_from_editable, + install_req_from_line, +) +from pip._internal.req.req_install import InstallRequirement +from pip._internal.utils.direct_url_helpers import direct_url_from_link +from pip._internal.utils.misc import normalize_version_info + +from .base import Candidate, Requirement, format_name + +if TYPE_CHECKING: + from .factory import Factory + +logger = logging.getLogger(__name__) + +BaseCandidate = Union[ + "AlreadyInstalledCandidate", + "EditableCandidate", + "LinkCandidate", +] + +# Avoid conflicting with the PyPI package "Python". +REQUIRES_PYTHON_IDENTIFIER = cast(NormalizedName, "") + + +def as_base_candidate(candidate: Candidate) -> Optional[BaseCandidate]: + """The runtime version of BaseCandidate.""" + base_candidate_classes = ( + AlreadyInstalledCandidate, + EditableCandidate, + LinkCandidate, + ) + if isinstance(candidate, base_candidate_classes): + return candidate + return None + + +def make_install_req_from_link( + link: Link, template: InstallRequirement +) -> InstallRequirement: + assert not template.editable, "template is editable" + if template.req: + line = str(template.req) + else: + line = link.url + ireq = install_req_from_line( + line, + user_supplied=template.user_supplied, + comes_from=template.comes_from, + use_pep517=template.use_pep517, + isolated=template.isolated, + constraint=template.constraint, + global_options=template.global_options, + hash_options=template.hash_options, + config_settings=template.config_settings, + ) + ireq.original_link = template.original_link + ireq.link = link + ireq.extras = template.extras + return ireq + + +def make_install_req_from_editable( + link: Link, template: InstallRequirement +) -> InstallRequirement: + assert template.editable, "template not editable" + ireq = install_req_from_editable( + link.url, + user_supplied=template.user_supplied, + comes_from=template.comes_from, + use_pep517=template.use_pep517, + isolated=template.isolated, + constraint=template.constraint, + permit_editable_wheels=template.permit_editable_wheels, + global_options=template.global_options, + hash_options=template.hash_options, + config_settings=template.config_settings, + ) + ireq.extras = template.extras + return ireq + + +def _make_install_req_from_dist( + dist: BaseDistribution, template: InstallRequirement +) -> InstallRequirement: + if template.req: + line = str(template.req) + elif template.link: + line = f"{dist.canonical_name} @ {template.link.url}" + else: + line = f"{dist.canonical_name}=={dist.version}" + ireq = install_req_from_line( + line, + user_supplied=template.user_supplied, + comes_from=template.comes_from, + use_pep517=template.use_pep517, + isolated=template.isolated, + constraint=template.constraint, + global_options=template.global_options, + hash_options=template.hash_options, + config_settings=template.config_settings, + ) + ireq.satisfied_by = dist + return ireq + + +class _InstallRequirementBackedCandidate(Candidate): + """A candidate backed by an ``InstallRequirement``. + + This represents a package request with the target not being already + in the environment, and needs to be fetched and installed. The backing + ``InstallRequirement`` is responsible for most of the leg work; this + class exposes appropriate information to the resolver. + + :param link: The link passed to the ``InstallRequirement``. The backing + ``InstallRequirement`` will use this link to fetch the distribution. + :param source_link: The link this candidate "originates" from. This is + different from ``link`` when the link is found in the wheel cache. + ``link`` would point to the wheel cache, while this points to the + found remote link (e.g. from pypi.org). + """ + + dist: BaseDistribution + is_installed = False + + def __init__( + self, + link: Link, + source_link: Link, + ireq: InstallRequirement, + factory: "Factory", + name: Optional[NormalizedName] = None, + version: Optional[Version] = None, + ) -> None: + self._link = link + self._source_link = source_link + self._factory = factory + self._ireq = ireq + self._name = name + self._version = version + self.dist = self._prepare() + self._hash: Optional[int] = None + + def __str__(self) -> str: + return f"{self.name} {self.version}" + + def __repr__(self) -> str: + return f"{self.__class__.__name__}({str(self._link)!r})" + + def __hash__(self) -> int: + if self._hash is not None: + return self._hash + + self._hash = hash((self.__class__, self._link)) + return self._hash + + def __eq__(self, other: Any) -> bool: + if isinstance(other, self.__class__): + return links_equivalent(self._link, other._link) + return False + + @property + def source_link(self) -> Optional[Link]: + return self._source_link + + @property + def project_name(self) -> NormalizedName: + """The normalised name of the project the candidate refers to""" + if self._name is None: + self._name = self.dist.canonical_name + return self._name + + @property + def name(self) -> str: + return self.project_name + + @property + def version(self) -> Version: + if self._version is None: + self._version = self.dist.version + return self._version + + def format_for_error(self) -> str: + return ( + f"{self.name} {self.version} " + f"(from {self._link.file_path if self._link.is_file else self._link})" + ) + + def _prepare_distribution(self) -> BaseDistribution: + raise NotImplementedError("Override in subclass") + + def _check_metadata_consistency(self, dist: BaseDistribution) -> None: + """Check for consistency of project name and version of dist.""" + if self._name is not None and self._name != dist.canonical_name: + raise MetadataInconsistent( + self._ireq, + "name", + self._name, + dist.canonical_name, + ) + if self._version is not None and self._version != dist.version: + raise MetadataInconsistent( + self._ireq, + "version", + str(self._version), + str(dist.version), + ) + # check dependencies are valid + # TODO performance: this means we iterate the dependencies at least twice, + # we may want to cache parsed Requires-Dist + try: + list(dist.iter_dependencies(list(dist.iter_provided_extras()))) + except InvalidRequirement as e: + raise MetadataInvalid(self._ireq, str(e)) + + def _prepare(self) -> BaseDistribution: + try: + dist = self._prepare_distribution() + except HashError as e: + # Provide HashError the underlying ireq that caused it. This + # provides context for the resulting error message to show the + # offending line to the user. + e.req = self._ireq + raise + except InstallationSubprocessError as exc: + # The output has been presented already, so don't duplicate it. + exc.context = "See above for output." + raise + + self._check_metadata_consistency(dist) + return dist + + def iter_dependencies(self, with_requires: bool) -> Iterable[Optional[Requirement]]: + requires = self.dist.iter_dependencies() if with_requires else () + for r in requires: + yield from self._factory.make_requirements_from_spec(str(r), self._ireq) + yield self._factory.make_requires_python_requirement(self.dist.requires_python) + + def get_install_requirement(self) -> Optional[InstallRequirement]: + return self._ireq + + +class LinkCandidate(_InstallRequirementBackedCandidate): + is_editable = False + + def __init__( + self, + link: Link, + template: InstallRequirement, + factory: "Factory", + name: Optional[NormalizedName] = None, + version: Optional[Version] = None, + ) -> None: + source_link = link + cache_entry = factory.get_wheel_cache_entry(source_link, name) + if cache_entry is not None: + logger.debug("Using cached wheel link: %s", cache_entry.link) + link = cache_entry.link + ireq = make_install_req_from_link(link, template) + assert ireq.link == link + if ireq.link.is_wheel and not ireq.link.is_file: + wheel = Wheel(ireq.link.filename) + wheel_name = canonicalize_name(wheel.name) + assert name == wheel_name, f"{name!r} != {wheel_name!r} for wheel" + # Version may not be present for PEP 508 direct URLs + if version is not None: + wheel_version = Version(wheel.version) + assert ( + version == wheel_version + ), f"{version!r} != {wheel_version!r} for wheel {name}" + + if cache_entry is not None: + assert ireq.link.is_wheel + assert ireq.link.is_file + if cache_entry.persistent and template.link is template.original_link: + ireq.cached_wheel_source_link = source_link + if cache_entry.origin is not None: + ireq.download_info = cache_entry.origin + else: + # Legacy cache entry that does not have origin.json. + # download_info may miss the archive_info.hashes field. + ireq.download_info = direct_url_from_link( + source_link, link_is_in_wheel_cache=cache_entry.persistent + ) + + super().__init__( + link=link, + source_link=source_link, + ireq=ireq, + factory=factory, + name=name, + version=version, + ) + + def _prepare_distribution(self) -> BaseDistribution: + preparer = self._factory.preparer + return preparer.prepare_linked_requirement(self._ireq, parallel_builds=True) + + +class EditableCandidate(_InstallRequirementBackedCandidate): + is_editable = True + + def __init__( + self, + link: Link, + template: InstallRequirement, + factory: "Factory", + name: Optional[NormalizedName] = None, + version: Optional[Version] = None, + ) -> None: + super().__init__( + link=link, + source_link=link, + ireq=make_install_req_from_editable(link, template), + factory=factory, + name=name, + version=version, + ) + + def _prepare_distribution(self) -> BaseDistribution: + return self._factory.preparer.prepare_editable_requirement(self._ireq) + + +class AlreadyInstalledCandidate(Candidate): + is_installed = True + source_link = None + + def __init__( + self, + dist: BaseDistribution, + template: InstallRequirement, + factory: "Factory", + ) -> None: + self.dist = dist + self._ireq = _make_install_req_from_dist(dist, template) + self._factory = factory + self._version = None + + # This is just logging some messages, so we can do it eagerly. + # The returned dist would be exactly the same as self.dist because we + # set satisfied_by in _make_install_req_from_dist. + # TODO: Supply reason based on force_reinstall and upgrade_strategy. + skip_reason = "already satisfied" + factory.preparer.prepare_installed_requirement(self._ireq, skip_reason) + + def __str__(self) -> str: + return str(self.dist) + + def __repr__(self) -> str: + return f"{self.__class__.__name__}({self.dist!r})" + + def __eq__(self, other: object) -> bool: + if not isinstance(other, AlreadyInstalledCandidate): + return NotImplemented + return self.name == other.name and self.version == other.version + + def __hash__(self) -> int: + return hash((self.name, self.version)) + + @property + def project_name(self) -> NormalizedName: + return self.dist.canonical_name + + @property + def name(self) -> str: + return self.project_name + + @property + def version(self) -> Version: + if self._version is None: + self._version = self.dist.version + return self._version + + @property + def is_editable(self) -> bool: + return self.dist.editable + + def format_for_error(self) -> str: + return f"{self.name} {self.version} (Installed)" + + def iter_dependencies(self, with_requires: bool) -> Iterable[Optional[Requirement]]: + if not with_requires: + return + for r in self.dist.iter_dependencies(): + yield from self._factory.make_requirements_from_spec(str(r), self._ireq) + + def get_install_requirement(self) -> Optional[InstallRequirement]: + return None + + +class ExtrasCandidate(Candidate): + """A candidate that has 'extras', indicating additional dependencies. + + Requirements can be for a project with dependencies, something like + foo[extra]. The extras don't affect the project/version being installed + directly, but indicate that we need additional dependencies. We model that + by having an artificial ExtrasCandidate that wraps the "base" candidate. + + The ExtrasCandidate differs from the base in the following ways: + + 1. It has a unique name, of the form foo[extra]. This causes the resolver + to treat it as a separate node in the dependency graph. + 2. When we're getting the candidate's dependencies, + a) We specify that we want the extra dependencies as well. + b) We add a dependency on the base candidate. + See below for why this is needed. + 3. We return None for the underlying InstallRequirement, as the base + candidate will provide it, and we don't want to end up with duplicates. + + The dependency on the base candidate is needed so that the resolver can't + decide that it should recommend foo[extra1] version 1.0 and foo[extra2] + version 2.0. Having those candidates depend on foo=1.0 and foo=2.0 + respectively forces the resolver to recognise that this is a conflict. + """ + + def __init__( + self, + base: BaseCandidate, + extras: FrozenSet[str], + *, + comes_from: Optional[InstallRequirement] = None, + ) -> None: + """ + :param comes_from: the InstallRequirement that led to this candidate if it + differs from the base's InstallRequirement. This will often be the + case in the sense that this candidate's requirement has the extras + while the base's does not. Unlike the InstallRequirement backed + candidates, this requirement is used solely for reporting purposes, + it does not do any leg work. + """ + self.base = base + self.extras = frozenset(canonicalize_name(e) for e in extras) + self._comes_from = comes_from if comes_from is not None else self.base._ireq + + def __str__(self) -> str: + name, rest = str(self.base).split(" ", 1) + return "{}[{}] {}".format(name, ",".join(self.extras), rest) + + def __repr__(self) -> str: + return f"{self.__class__.__name__}(base={self.base!r}, extras={self.extras!r})" + + def __hash__(self) -> int: + return hash((self.base, self.extras)) + + def __eq__(self, other: Any) -> bool: + if isinstance(other, self.__class__): + return self.base == other.base and self.extras == other.extras + return False + + @property + def project_name(self) -> NormalizedName: + return self.base.project_name + + @property + def name(self) -> str: + """The normalised name of the project the candidate refers to""" + return format_name(self.base.project_name, self.extras) + + @property + def version(self) -> Version: + return self.base.version + + def format_for_error(self) -> str: + return "{} [{}]".format( + self.base.format_for_error(), ", ".join(sorted(self.extras)) + ) + + @property + def is_installed(self) -> bool: + return self.base.is_installed + + @property + def is_editable(self) -> bool: + return self.base.is_editable + + @property + def source_link(self) -> Optional[Link]: + return self.base.source_link + + def iter_dependencies(self, with_requires: bool) -> Iterable[Optional[Requirement]]: + factory = self.base._factory + + # Add a dependency on the exact base + # (See note 2b in the class docstring) + yield factory.make_requirement_from_candidate(self.base) + if not with_requires: + return + + # The user may have specified extras that the candidate doesn't + # support. We ignore any unsupported extras here. + valid_extras = self.extras.intersection(self.base.dist.iter_provided_extras()) + invalid_extras = self.extras.difference(self.base.dist.iter_provided_extras()) + for extra in sorted(invalid_extras): + logger.warning( + "%s %s does not provide the extra '%s'", + self.base.name, + self.version, + extra, + ) + + for r in self.base.dist.iter_dependencies(valid_extras): + yield from factory.make_requirements_from_spec( + str(r), + self._comes_from, + valid_extras, + ) + + def get_install_requirement(self) -> Optional[InstallRequirement]: + # We don't return anything here, because we always + # depend on the base candidate, and we'll get the + # install requirement from that. + return None + + +class RequiresPythonCandidate(Candidate): + is_installed = False + source_link = None + + def __init__(self, py_version_info: Optional[Tuple[int, ...]]) -> None: + if py_version_info is not None: + version_info = normalize_version_info(py_version_info) + else: + version_info = sys.version_info[:3] + self._version = Version(".".join(str(c) for c in version_info)) + + # We don't need to implement __eq__() and __ne__() since there is always + # only one RequiresPythonCandidate in a resolution, i.e. the host Python. + # The built-in object.__eq__() and object.__ne__() do exactly what we want. + + def __str__(self) -> str: + return f"Python {self._version}" + + @property + def project_name(self) -> NormalizedName: + return REQUIRES_PYTHON_IDENTIFIER + + @property + def name(self) -> str: + return REQUIRES_PYTHON_IDENTIFIER + + @property + def version(self) -> Version: + return self._version + + def format_for_error(self) -> str: + return f"Python {self.version}" + + def iter_dependencies(self, with_requires: bool) -> Iterable[Optional[Requirement]]: + return () + + def get_install_requirement(self) -> Optional[InstallRequirement]: + return None diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/factory.py b/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/factory.py new file mode 100644 index 0000000..145bdbf --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/factory.py @@ -0,0 +1,817 @@ +import contextlib +import functools +import logging +from typing import ( + TYPE_CHECKING, + Callable, + Dict, + FrozenSet, + Iterable, + Iterator, + List, + Mapping, + NamedTuple, + Optional, + Protocol, + Sequence, + Set, + Tuple, + TypeVar, + cast, +) + +from pip._vendor.packaging.requirements import InvalidRequirement +from pip._vendor.packaging.specifiers import SpecifierSet +from pip._vendor.packaging.utils import NormalizedName, canonicalize_name +from pip._vendor.packaging.version import Version +from pip._vendor.resolvelib import ResolutionImpossible + +from pip._internal.cache import CacheEntry, WheelCache +from pip._internal.exceptions import ( + DistributionNotFound, + InstallationError, + MetadataInconsistent, + MetadataInvalid, + UnsupportedPythonVersion, + UnsupportedWheel, +) +from pip._internal.index.package_finder import PackageFinder +from pip._internal.metadata import BaseDistribution, get_default_environment +from pip._internal.models.link import Link +from pip._internal.models.wheel import Wheel +from pip._internal.operations.prepare import RequirementPreparer +from pip._internal.req.constructors import ( + install_req_drop_extras, + install_req_from_link_and_ireq, +) +from pip._internal.req.req_install import ( + InstallRequirement, + check_invalid_constraint_type, +) +from pip._internal.resolution.base import InstallRequirementProvider +from pip._internal.utils.compatibility_tags import get_supported +from pip._internal.utils.hashes import Hashes +from pip._internal.utils.packaging import get_requirement +from pip._internal.utils.virtualenv import running_under_virtualenv + +from .base import Candidate, Constraint, Requirement +from .candidates import ( + AlreadyInstalledCandidate, + BaseCandidate, + EditableCandidate, + ExtrasCandidate, + LinkCandidate, + RequiresPythonCandidate, + as_base_candidate, +) +from .found_candidates import FoundCandidates, IndexCandidateInfo +from .requirements import ( + ExplicitRequirement, + RequiresPythonRequirement, + SpecifierRequirement, + SpecifierWithoutExtrasRequirement, + UnsatisfiableRequirement, +) + +if TYPE_CHECKING: + + class ConflictCause(Protocol): + requirement: RequiresPythonRequirement + parent: Candidate + + +logger = logging.getLogger(__name__) + +C = TypeVar("C") +Cache = Dict[Link, C] + + +class CollectedRootRequirements(NamedTuple): + requirements: List[Requirement] + constraints: Dict[str, Constraint] + user_requested: Dict[str, int] + + +class Factory: + def __init__( + self, + finder: PackageFinder, + preparer: RequirementPreparer, + make_install_req: InstallRequirementProvider, + wheel_cache: Optional[WheelCache], + use_user_site: bool, + force_reinstall: bool, + ignore_installed: bool, + ignore_requires_python: bool, + py_version_info: Optional[Tuple[int, ...]] = None, + ) -> None: + self._finder = finder + self.preparer = preparer + self._wheel_cache = wheel_cache + self._python_candidate = RequiresPythonCandidate(py_version_info) + self._make_install_req_from_spec = make_install_req + self._use_user_site = use_user_site + self._force_reinstall = force_reinstall + self._ignore_requires_python = ignore_requires_python + + self._build_failures: Cache[InstallationError] = {} + self._link_candidate_cache: Cache[LinkCandidate] = {} + self._editable_candidate_cache: Cache[EditableCandidate] = {} + self._installed_candidate_cache: Dict[str, AlreadyInstalledCandidate] = {} + self._extras_candidate_cache: Dict[ + Tuple[int, FrozenSet[NormalizedName]], ExtrasCandidate + ] = {} + self._supported_tags_cache = get_supported() + + if not ignore_installed: + env = get_default_environment() + self._installed_dists = { + dist.canonical_name: dist + for dist in env.iter_installed_distributions(local_only=False) + } + else: + self._installed_dists = {} + + @property + def force_reinstall(self) -> bool: + return self._force_reinstall + + def _fail_if_link_is_unsupported_wheel(self, link: Link) -> None: + if not link.is_wheel: + return + wheel = Wheel(link.filename) + if wheel.supported(self._finder.target_python.get_unsorted_tags()): + return + msg = f"{link.filename} is not a supported wheel on this platform." + raise UnsupportedWheel(msg) + + def _make_extras_candidate( + self, + base: BaseCandidate, + extras: FrozenSet[str], + *, + comes_from: Optional[InstallRequirement] = None, + ) -> ExtrasCandidate: + cache_key = (id(base), frozenset(canonicalize_name(e) for e in extras)) + try: + candidate = self._extras_candidate_cache[cache_key] + except KeyError: + candidate = ExtrasCandidate(base, extras, comes_from=comes_from) + self._extras_candidate_cache[cache_key] = candidate + return candidate + + def _make_candidate_from_dist( + self, + dist: BaseDistribution, + extras: FrozenSet[str], + template: InstallRequirement, + ) -> Candidate: + try: + base = self._installed_candidate_cache[dist.canonical_name] + except KeyError: + base = AlreadyInstalledCandidate(dist, template, factory=self) + self._installed_candidate_cache[dist.canonical_name] = base + if not extras: + return base + return self._make_extras_candidate(base, extras, comes_from=template) + + def _make_candidate_from_link( + self, + link: Link, + extras: FrozenSet[str], + template: InstallRequirement, + name: Optional[NormalizedName], + version: Optional[Version], + ) -> Optional[Candidate]: + base: Optional[BaseCandidate] = self._make_base_candidate_from_link( + link, template, name, version + ) + if not extras or base is None: + return base + return self._make_extras_candidate(base, extras, comes_from=template) + + def _make_base_candidate_from_link( + self, + link: Link, + template: InstallRequirement, + name: Optional[NormalizedName], + version: Optional[Version], + ) -> Optional[BaseCandidate]: + # TODO: Check already installed candidate, and use it if the link and + # editable flag match. + + if link in self._build_failures: + # We already tried this candidate before, and it does not build. + # Don't bother trying again. + return None + + if template.editable: + if link not in self._editable_candidate_cache: + try: + self._editable_candidate_cache[link] = EditableCandidate( + link, + template, + factory=self, + name=name, + version=version, + ) + except (MetadataInconsistent, MetadataInvalid) as e: + logger.info( + "Discarding [blue underline]%s[/]: [yellow]%s[reset]", + link, + e, + extra={"markup": True}, + ) + self._build_failures[link] = e + return None + + return self._editable_candidate_cache[link] + else: + if link not in self._link_candidate_cache: + try: + self._link_candidate_cache[link] = LinkCandidate( + link, + template, + factory=self, + name=name, + version=version, + ) + except MetadataInconsistent as e: + logger.info( + "Discarding [blue underline]%s[/]: [yellow]%s[reset]", + link, + e, + extra={"markup": True}, + ) + self._build_failures[link] = e + return None + return self._link_candidate_cache[link] + + def _iter_found_candidates( + self, + ireqs: Sequence[InstallRequirement], + specifier: SpecifierSet, + hashes: Hashes, + prefers_installed: bool, + incompatible_ids: Set[int], + ) -> Iterable[Candidate]: + if not ireqs: + return () + + # The InstallRequirement implementation requires us to give it a + # "template". Here we just choose the first requirement to represent + # all of them. + # Hopefully the Project model can correct this mismatch in the future. + template = ireqs[0] + assert template.req, "Candidates found on index must be PEP 508" + name = canonicalize_name(template.req.name) + + extras: FrozenSet[str] = frozenset() + for ireq in ireqs: + assert ireq.req, "Candidates found on index must be PEP 508" + specifier &= ireq.req.specifier + hashes &= ireq.hashes(trust_internet=False) + extras |= frozenset(ireq.extras) + + def _get_installed_candidate() -> Optional[Candidate]: + """Get the candidate for the currently-installed version.""" + # If --force-reinstall is set, we want the version from the index + # instead, so we "pretend" there is nothing installed. + if self._force_reinstall: + return None + try: + installed_dist = self._installed_dists[name] + except KeyError: + return None + # Don't use the installed distribution if its version does not fit + # the current dependency graph. + if not specifier.contains(installed_dist.version, prereleases=True): + return None + candidate = self._make_candidate_from_dist( + dist=installed_dist, + extras=extras, + template=template, + ) + # The candidate is a known incompatibility. Don't use it. + if id(candidate) in incompatible_ids: + return None + return candidate + + def iter_index_candidate_infos() -> Iterator[IndexCandidateInfo]: + result = self._finder.find_best_candidate( + project_name=name, + specifier=specifier, + hashes=hashes, + ) + icans = list(result.iter_applicable()) + + # PEP 592: Yanked releases are ignored unless the specifier + # explicitly pins a version (via '==' or '===') that can be + # solely satisfied by a yanked release. + all_yanked = all(ican.link.is_yanked for ican in icans) + + def is_pinned(specifier: SpecifierSet) -> bool: + for sp in specifier: + if sp.operator == "===": + return True + if sp.operator != "==": + continue + if sp.version.endswith(".*"): + continue + return True + return False + + pinned = is_pinned(specifier) + + # PackageFinder returns earlier versions first, so we reverse. + for ican in reversed(icans): + if not (all_yanked and pinned) and ican.link.is_yanked: + continue + func = functools.partial( + self._make_candidate_from_link, + link=ican.link, + extras=extras, + template=template, + name=name, + version=ican.version, + ) + yield ican.version, func + + return FoundCandidates( + iter_index_candidate_infos, + _get_installed_candidate(), + prefers_installed, + incompatible_ids, + ) + + def _iter_explicit_candidates_from_base( + self, + base_requirements: Iterable[Requirement], + extras: FrozenSet[str], + ) -> Iterator[Candidate]: + """Produce explicit candidates from the base given an extra-ed package. + + :param base_requirements: Requirements known to the resolver. The + requirements are guaranteed to not have extras. + :param extras: The extras to inject into the explicit requirements' + candidates. + """ + for req in base_requirements: + lookup_cand, _ = req.get_candidate_lookup() + if lookup_cand is None: # Not explicit. + continue + # We've stripped extras from the identifier, and should always + # get a BaseCandidate here, unless there's a bug elsewhere. + base_cand = as_base_candidate(lookup_cand) + assert base_cand is not None, "no extras here" + yield self._make_extras_candidate(base_cand, extras) + + def _iter_candidates_from_constraints( + self, + identifier: str, + constraint: Constraint, + template: InstallRequirement, + ) -> Iterator[Candidate]: + """Produce explicit candidates from constraints. + + This creates "fake" InstallRequirement objects that are basically clones + of what "should" be the template, but with original_link set to link. + """ + for link in constraint.links: + self._fail_if_link_is_unsupported_wheel(link) + candidate = self._make_base_candidate_from_link( + link, + template=install_req_from_link_and_ireq(link, template), + name=canonicalize_name(identifier), + version=None, + ) + if candidate: + yield candidate + + def find_candidates( + self, + identifier: str, + requirements: Mapping[str, Iterable[Requirement]], + incompatibilities: Mapping[str, Iterator[Candidate]], + constraint: Constraint, + prefers_installed: bool, + is_satisfied_by: Callable[[Requirement, Candidate], bool], + ) -> Iterable[Candidate]: + # Collect basic lookup information from the requirements. + explicit_candidates: Set[Candidate] = set() + ireqs: List[InstallRequirement] = [] + for req in requirements[identifier]: + cand, ireq = req.get_candidate_lookup() + if cand is not None: + explicit_candidates.add(cand) + if ireq is not None: + ireqs.append(ireq) + + # If the current identifier contains extras, add requires and explicit + # candidates from entries from extra-less identifier. + with contextlib.suppress(InvalidRequirement): + parsed_requirement = get_requirement(identifier) + if parsed_requirement.name != identifier: + explicit_candidates.update( + self._iter_explicit_candidates_from_base( + requirements.get(parsed_requirement.name, ()), + frozenset(parsed_requirement.extras), + ), + ) + for req in requirements.get(parsed_requirement.name, []): + _, ireq = req.get_candidate_lookup() + if ireq is not None: + ireqs.append(ireq) + + # Add explicit candidates from constraints. We only do this if there are + # known ireqs, which represent requirements not already explicit. If + # there are no ireqs, we're constraining already-explicit requirements, + # which is handled later when we return the explicit candidates. + if ireqs: + try: + explicit_candidates.update( + self._iter_candidates_from_constraints( + identifier, + constraint, + template=ireqs[0], + ), + ) + except UnsupportedWheel: + # If we're constrained to install a wheel incompatible with the + # target architecture, no candidates will ever be valid. + return () + + # Since we cache all the candidates, incompatibility identification + # can be made quicker by comparing only the id() values. + incompat_ids = {id(c) for c in incompatibilities.get(identifier, ())} + + # If none of the requirements want an explicit candidate, we can ask + # the finder for candidates. + if not explicit_candidates: + return self._iter_found_candidates( + ireqs, + constraint.specifier, + constraint.hashes, + prefers_installed, + incompat_ids, + ) + + return ( + c + for c in explicit_candidates + if id(c) not in incompat_ids + and constraint.is_satisfied_by(c) + and all(is_satisfied_by(req, c) for req in requirements[identifier]) + ) + + def _make_requirements_from_install_req( + self, ireq: InstallRequirement, requested_extras: Iterable[str] + ) -> Iterator[Requirement]: + """ + Returns requirement objects associated with the given InstallRequirement. In + most cases this will be a single object but the following special cases exist: + - the InstallRequirement has markers that do not apply -> result is empty + - the InstallRequirement has both a constraint (or link) and extras + -> result is split in two requirement objects: one with the constraint + (or link) and one with the extra. This allows centralized constraint + handling for the base, resulting in fewer candidate rejections. + """ + if not ireq.match_markers(requested_extras): + logger.info( + "Ignoring %s: markers '%s' don't match your environment", + ireq.name, + ireq.markers, + ) + elif not ireq.link: + if ireq.extras and ireq.req is not None and ireq.req.specifier: + yield SpecifierWithoutExtrasRequirement(ireq) + yield SpecifierRequirement(ireq) + else: + self._fail_if_link_is_unsupported_wheel(ireq.link) + # Always make the link candidate for the base requirement to make it + # available to `find_candidates` for explicit candidate lookup for any + # set of extras. + # The extras are required separately via a second requirement. + cand = self._make_base_candidate_from_link( + ireq.link, + template=install_req_drop_extras(ireq) if ireq.extras else ireq, + name=canonicalize_name(ireq.name) if ireq.name else None, + version=None, + ) + if cand is None: + # There's no way we can satisfy a URL requirement if the underlying + # candidate fails to build. An unnamed URL must be user-supplied, so + # we fail eagerly. If the URL is named, an unsatisfiable requirement + # can make the resolver do the right thing, either backtrack (and + # maybe find some other requirement that's buildable) or raise a + # ResolutionImpossible eventually. + if not ireq.name: + raise self._build_failures[ireq.link] + yield UnsatisfiableRequirement(canonicalize_name(ireq.name)) + else: + # require the base from the link + yield self.make_requirement_from_candidate(cand) + if ireq.extras: + # require the extras on top of the base candidate + yield self.make_requirement_from_candidate( + self._make_extras_candidate(cand, frozenset(ireq.extras)) + ) + + def collect_root_requirements( + self, root_ireqs: List[InstallRequirement] + ) -> CollectedRootRequirements: + collected = CollectedRootRequirements([], {}, {}) + for i, ireq in enumerate(root_ireqs): + if ireq.constraint: + # Ensure we only accept valid constraints + problem = check_invalid_constraint_type(ireq) + if problem: + raise InstallationError(problem) + if not ireq.match_markers(): + continue + assert ireq.name, "Constraint must be named" + name = canonicalize_name(ireq.name) + if name in collected.constraints: + collected.constraints[name] &= ireq + else: + collected.constraints[name] = Constraint.from_ireq(ireq) + else: + reqs = list( + self._make_requirements_from_install_req( + ireq, + requested_extras=(), + ) + ) + if not reqs: + continue + template = reqs[0] + if ireq.user_supplied and template.name not in collected.user_requested: + collected.user_requested[template.name] = i + collected.requirements.extend(reqs) + # Put requirements with extras at the end of the root requires. This does not + # affect resolvelib's picking preference but it does affect its initial criteria + # population: by putting extras at the end we enable the candidate finder to + # present resolvelib with a smaller set of candidates to resolvelib, already + # taking into account any non-transient constraints on the associated base. This + # means resolvelib will have fewer candidates to visit and reject. + # Python's list sort is stable, meaning relative order is kept for objects with + # the same key. + collected.requirements.sort(key=lambda r: r.name != r.project_name) + return collected + + def make_requirement_from_candidate( + self, candidate: Candidate + ) -> ExplicitRequirement: + return ExplicitRequirement(candidate) + + def make_requirements_from_spec( + self, + specifier: str, + comes_from: Optional[InstallRequirement], + requested_extras: Iterable[str] = (), + ) -> Iterator[Requirement]: + """ + Returns requirement objects associated with the given specifier. In most cases + this will be a single object but the following special cases exist: + - the specifier has markers that do not apply -> result is empty + - the specifier has both a constraint and extras -> result is split + in two requirement objects: one with the constraint and one with the + extra. This allows centralized constraint handling for the base, + resulting in fewer candidate rejections. + """ + ireq = self._make_install_req_from_spec(specifier, comes_from) + return self._make_requirements_from_install_req(ireq, requested_extras) + + def make_requires_python_requirement( + self, + specifier: SpecifierSet, + ) -> Optional[Requirement]: + if self._ignore_requires_python: + return None + # Don't bother creating a dependency for an empty Requires-Python. + if not str(specifier): + return None + return RequiresPythonRequirement(specifier, self._python_candidate) + + def get_wheel_cache_entry( + self, link: Link, name: Optional[str] + ) -> Optional[CacheEntry]: + """Look up the link in the wheel cache. + + If ``preparer.require_hashes`` is True, don't use the wheel cache, + because cached wheels, always built locally, have different hashes + than the files downloaded from the index server and thus throw false + hash mismatches. Furthermore, cached wheels at present have + nondeterministic contents due to file modification times. + """ + if self._wheel_cache is None: + return None + return self._wheel_cache.get_cache_entry( + link=link, + package_name=name, + supported_tags=self._supported_tags_cache, + ) + + def get_dist_to_uninstall(self, candidate: Candidate) -> Optional[BaseDistribution]: + # TODO: Are there more cases this needs to return True? Editable? + dist = self._installed_dists.get(candidate.project_name) + if dist is None: # Not installed, no uninstallation required. + return None + + # We're installing into global site. The current installation must + # be uninstalled, no matter it's in global or user site, because the + # user site installation has precedence over global. + if not self._use_user_site: + return dist + + # We're installing into user site. Remove the user site installation. + if dist.in_usersite: + return dist + + # We're installing into user site, but the installed incompatible + # package is in global site. We can't uninstall that, and would let + # the new user installation to "shadow" it. But shadowing won't work + # in virtual environments, so we error out. + if running_under_virtualenv() and dist.in_site_packages: + message = ( + f"Will not install to the user site because it will lack " + f"sys.path precedence to {dist.raw_name} in {dist.location}" + ) + raise InstallationError(message) + return None + + def _report_requires_python_error( + self, causes: Sequence["ConflictCause"] + ) -> UnsupportedPythonVersion: + assert causes, "Requires-Python error reported with no cause" + + version = self._python_candidate.version + + if len(causes) == 1: + specifier = str(causes[0].requirement.specifier) + message = ( + f"Package {causes[0].parent.name!r} requires a different " + f"Python: {version} not in {specifier!r}" + ) + return UnsupportedPythonVersion(message) + + message = f"Packages require a different Python. {version} not in:" + for cause in causes: + package = cause.parent.format_for_error() + specifier = str(cause.requirement.specifier) + message += f"\n{specifier!r} (required by {package})" + return UnsupportedPythonVersion(message) + + def _report_single_requirement_conflict( + self, req: Requirement, parent: Optional[Candidate] + ) -> DistributionNotFound: + if parent is None: + req_disp = str(req) + else: + req_disp = f"{req} (from {parent.name})" + + cands = self._finder.find_all_candidates(req.project_name) + skipped_by_requires_python = self._finder.requires_python_skipped_reasons() + + versions_set: Set[Version] = set() + yanked_versions_set: Set[Version] = set() + for c in cands: + is_yanked = c.link.is_yanked if c.link else False + if is_yanked: + yanked_versions_set.add(c.version) + else: + versions_set.add(c.version) + + versions = [str(v) for v in sorted(versions_set)] + yanked_versions = [str(v) for v in sorted(yanked_versions_set)] + + if yanked_versions: + # Saying "version X is yanked" isn't entirely accurate. + # https://github.com/pypa/pip/issues/11745#issuecomment-1402805842 + logger.critical( + "Ignored the following yanked versions: %s", + ", ".join(yanked_versions) or "none", + ) + if skipped_by_requires_python: + logger.critical( + "Ignored the following versions that require a different python " + "version: %s", + "; ".join(skipped_by_requires_python) or "none", + ) + logger.critical( + "Could not find a version that satisfies the requirement %s " + "(from versions: %s)", + req_disp, + ", ".join(versions) or "none", + ) + if str(req) == "requirements.txt": + logger.info( + "HINT: You are attempting to install a package literally " + 'named "requirements.txt" (which cannot exist). Consider ' + "using the '-r' flag to install the packages listed in " + "requirements.txt" + ) + + return DistributionNotFound(f"No matching distribution found for {req}") + + def get_installation_error( + self, + e: "ResolutionImpossible[Requirement, Candidate]", + constraints: Dict[str, Constraint], + ) -> InstallationError: + assert e.causes, "Installation error reported with no cause" + + # If one of the things we can't solve is "we need Python X.Y", + # that is what we report. + requires_python_causes = [ + cause + for cause in e.causes + if isinstance(cause.requirement, RequiresPythonRequirement) + and not cause.requirement.is_satisfied_by(self._python_candidate) + ] + if requires_python_causes: + # The comprehension above makes sure all Requirement instances are + # RequiresPythonRequirement, so let's cast for convenience. + return self._report_requires_python_error( + cast("Sequence[ConflictCause]", requires_python_causes), + ) + + # Otherwise, we have a set of causes which can't all be satisfied + # at once. + + # The simplest case is when we have *one* cause that can't be + # satisfied. We just report that case. + if len(e.causes) == 1: + req, parent = e.causes[0] + if req.name not in constraints: + return self._report_single_requirement_conflict(req, parent) + + # OK, we now have a list of requirements that can't all be + # satisfied at once. + + # A couple of formatting helpers + def text_join(parts: List[str]) -> str: + if len(parts) == 1: + return parts[0] + + return ", ".join(parts[:-1]) + " and " + parts[-1] + + def describe_trigger(parent: Candidate) -> str: + ireq = parent.get_install_requirement() + if not ireq or not ireq.comes_from: + return f"{parent.name}=={parent.version}" + if isinstance(ireq.comes_from, InstallRequirement): + return str(ireq.comes_from.name) + return str(ireq.comes_from) + + triggers = set() + for req, parent in e.causes: + if parent is None: + # This is a root requirement, so we can report it directly + trigger = req.format_for_error() + else: + trigger = describe_trigger(parent) + triggers.add(trigger) + + if triggers: + info = text_join(sorted(triggers)) + else: + info = "the requested packages" + + msg = ( + f"Cannot install {info} because these package versions " + "have conflicting dependencies." + ) + logger.critical(msg) + msg = "\nThe conflict is caused by:" + + relevant_constraints = set() + for req, parent in e.causes: + if req.name in constraints: + relevant_constraints.add(req.name) + msg = msg + "\n " + if parent: + msg = msg + f"{parent.name} {parent.version} depends on " + else: + msg = msg + "The user requested " + msg = msg + req.format_for_error() + for key in relevant_constraints: + spec = constraints[key].specifier + msg += f"\n The user requested (constraint) {key}{spec}" + + msg = ( + msg + + "\n\n" + + "To fix this you could try to:\n" + + "1. loosen the range of package versions you've specified\n" + + "2. remove package versions to allow pip to attempt to solve " + + "the dependency conflict\n" + ) + + logger.info(msg) + + return DistributionNotFound( + "ResolutionImpossible: for help visit " + "https://pip.pypa.io/en/latest/topics/dependency-resolution/" + "#dealing-with-dependency-conflicts" + ) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/found_candidates.py b/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/found_candidates.py new file mode 100644 index 0000000..a1d57e0 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/found_candidates.py @@ -0,0 +1,174 @@ +"""Utilities to lazily create and visit candidates found. + +Creating and visiting a candidate is a *very* costly operation. It involves +fetching, extracting, potentially building modules from source, and verifying +distribution metadata. It is therefore crucial for performance to keep +everything here lazy all the way down, so we only touch candidates that we +absolutely need, and not "download the world" when we only need one version of +something. +""" + +import functools +import logging +from collections.abc import Sequence +from typing import TYPE_CHECKING, Any, Callable, Iterator, Optional, Set, Tuple + +from pip._vendor.packaging.version import _BaseVersion + +from pip._internal.exceptions import MetadataInvalid + +from .base import Candidate + +logger = logging.getLogger(__name__) + +IndexCandidateInfo = Tuple[_BaseVersion, Callable[[], Optional[Candidate]]] + +if TYPE_CHECKING: + SequenceCandidate = Sequence[Candidate] +else: + # For compatibility: Python before 3.9 does not support using [] on the + # Sequence class. + # + # >>> from collections.abc import Sequence + # >>> Sequence[str] + # Traceback (most recent call last): + # File "", line 1, in + # TypeError: 'ABCMeta' object is not subscriptable + # + # TODO: Remove this block after dropping Python 3.8 support. + SequenceCandidate = Sequence + + +def _iter_built(infos: Iterator[IndexCandidateInfo]) -> Iterator[Candidate]: + """Iterator for ``FoundCandidates``. + + This iterator is used when the package is not already installed. Candidates + from index come later in their normal ordering. + """ + versions_found: Set[_BaseVersion] = set() + for version, func in infos: + if version in versions_found: + continue + try: + candidate = func() + except MetadataInvalid as e: + logger.warning( + "Ignoring version %s of %s since it has invalid metadata:\n" + "%s\n" + "Please use pip<24.1 if you need to use this version.", + version, + e.ireq.name, + e, + ) + # Mark version as found to avoid trying other candidates with the same + # version, since they most likely have invalid metadata as well. + versions_found.add(version) + else: + if candidate is None: + continue + yield candidate + versions_found.add(version) + + +def _iter_built_with_prepended( + installed: Candidate, infos: Iterator[IndexCandidateInfo] +) -> Iterator[Candidate]: + """Iterator for ``FoundCandidates``. + + This iterator is used when the resolver prefers the already-installed + candidate and NOT to upgrade. The installed candidate is therefore + always yielded first, and candidates from index come later in their + normal ordering, except skipped when the version is already installed. + """ + yield installed + versions_found: Set[_BaseVersion] = {installed.version} + for version, func in infos: + if version in versions_found: + continue + candidate = func() + if candidate is None: + continue + yield candidate + versions_found.add(version) + + +def _iter_built_with_inserted( + installed: Candidate, infos: Iterator[IndexCandidateInfo] +) -> Iterator[Candidate]: + """Iterator for ``FoundCandidates``. + + This iterator is used when the resolver prefers to upgrade an + already-installed package. Candidates from index are returned in their + normal ordering, except replaced when the version is already installed. + + The implementation iterates through and yields other candidates, inserting + the installed candidate exactly once before we start yielding older or + equivalent candidates, or after all other candidates if they are all newer. + """ + versions_found: Set[_BaseVersion] = set() + for version, func in infos: + if version in versions_found: + continue + # If the installed candidate is better, yield it first. + if installed.version >= version: + yield installed + versions_found.add(installed.version) + candidate = func() + if candidate is None: + continue + yield candidate + versions_found.add(version) + + # If the installed candidate is older than all other candidates. + if installed.version not in versions_found: + yield installed + + +class FoundCandidates(SequenceCandidate): + """A lazy sequence to provide candidates to the resolver. + + The intended usage is to return this from `find_matches()` so the resolver + can iterate through the sequence multiple times, but only access the index + page when remote packages are actually needed. This improve performances + when suitable candidates are already installed on disk. + """ + + def __init__( + self, + get_infos: Callable[[], Iterator[IndexCandidateInfo]], + installed: Optional[Candidate], + prefers_installed: bool, + incompatible_ids: Set[int], + ): + self._get_infos = get_infos + self._installed = installed + self._prefers_installed = prefers_installed + self._incompatible_ids = incompatible_ids + + def __getitem__(self, index: Any) -> Any: + # Implemented to satisfy the ABC check. This is not needed by the + # resolver, and should not be used by the provider either (for + # performance reasons). + raise NotImplementedError("don't do this") + + def __iter__(self) -> Iterator[Candidate]: + infos = self._get_infos() + if not self._installed: + iterator = _iter_built(infos) + elif self._prefers_installed: + iterator = _iter_built_with_prepended(self._installed, infos) + else: + iterator = _iter_built_with_inserted(self._installed, infos) + return (c for c in iterator if id(c) not in self._incompatible_ids) + + def __len__(self) -> int: + # Implemented to satisfy the ABC check. This is not needed by the + # resolver, and should not be used by the provider either (for + # performance reasons). + raise NotImplementedError("don't do this") + + @functools.lru_cache(maxsize=1) + def __bool__(self) -> bool: + if self._prefers_installed and self._installed: + return True + return any(self) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/provider.py b/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/provider.py new file mode 100644 index 0000000..fb0dd85 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/provider.py @@ -0,0 +1,258 @@ +import collections +import math +from functools import lru_cache +from typing import ( + TYPE_CHECKING, + Dict, + Iterable, + Iterator, + Mapping, + Sequence, + TypeVar, + Union, +) + +from pip._vendor.resolvelib.providers import AbstractProvider + +from .base import Candidate, Constraint, Requirement +from .candidates import REQUIRES_PYTHON_IDENTIFIER +from .factory import Factory + +if TYPE_CHECKING: + from pip._vendor.resolvelib.providers import Preference + from pip._vendor.resolvelib.resolvers import RequirementInformation + + PreferenceInformation = RequirementInformation[Requirement, Candidate] + + _ProviderBase = AbstractProvider[Requirement, Candidate, str] +else: + _ProviderBase = AbstractProvider + +# Notes on the relationship between the provider, the factory, and the +# candidate and requirement classes. +# +# The provider is a direct implementation of the resolvelib class. Its role +# is to deliver the API that resolvelib expects. +# +# Rather than work with completely abstract "requirement" and "candidate" +# concepts as resolvelib does, pip has concrete classes implementing these two +# ideas. The API of Requirement and Candidate objects are defined in the base +# classes, but essentially map fairly directly to the equivalent provider +# methods. In particular, `find_matches` and `is_satisfied_by` are +# requirement methods, and `get_dependencies` is a candidate method. +# +# The factory is the interface to pip's internal mechanisms. It is stateless, +# and is created by the resolver and held as a property of the provider. It is +# responsible for creating Requirement and Candidate objects, and provides +# services to those objects (access to pip's finder and preparer). + + +D = TypeVar("D") +V = TypeVar("V") + + +def _get_with_identifier( + mapping: Mapping[str, V], + identifier: str, + default: D, +) -> Union[D, V]: + """Get item from a package name lookup mapping with a resolver identifier. + + This extra logic is needed when the target mapping is keyed by package + name, which cannot be directly looked up with an identifier (which may + contain requested extras). Additional logic is added to also look up a value + by "cleaning up" the extras from the identifier. + """ + if identifier in mapping: + return mapping[identifier] + # HACK: Theoretically we should check whether this identifier is a valid + # "NAME[EXTRAS]" format, and parse out the name part with packaging or + # some regular expression. But since pip's resolver only spits out three + # kinds of identifiers: normalized PEP 503 names, normalized names plus + # extras, and Requires-Python, we can cheat a bit here. + name, open_bracket, _ = identifier.partition("[") + if open_bracket and name in mapping: + return mapping[name] + return default + + +class PipProvider(_ProviderBase): + """Pip's provider implementation for resolvelib. + + :params constraints: A mapping of constraints specified by the user. Keys + are canonicalized project names. + :params ignore_dependencies: Whether the user specified ``--no-deps``. + :params upgrade_strategy: The user-specified upgrade strategy. + :params user_requested: A set of canonicalized package names that the user + supplied for pip to install/upgrade. + """ + + def __init__( + self, + factory: Factory, + constraints: Dict[str, Constraint], + ignore_dependencies: bool, + upgrade_strategy: str, + user_requested: Dict[str, int], + ) -> None: + self._factory = factory + self._constraints = constraints + self._ignore_dependencies = ignore_dependencies + self._upgrade_strategy = upgrade_strategy + self._user_requested = user_requested + self._known_depths: Dict[str, float] = collections.defaultdict(lambda: math.inf) + + def identify(self, requirement_or_candidate: Union[Requirement, Candidate]) -> str: + return requirement_or_candidate.name + + def get_preference( + self, + identifier: str, + resolutions: Mapping[str, Candidate], + candidates: Mapping[str, Iterator[Candidate]], + information: Mapping[str, Iterable["PreferenceInformation"]], + backtrack_causes: Sequence["PreferenceInformation"], + ) -> "Preference": + """Produce a sort key for given requirement based on preference. + + The lower the return value is, the more preferred this group of + arguments is. + + Currently pip considers the following in order: + + * Prefer if any of the known requirements is "direct", e.g. points to an + explicit URL. + * If equal, prefer if any requirement is "pinned", i.e. contains + operator ``===`` or ``==``. + * If equal, calculate an approximate "depth" and resolve requirements + closer to the user-specified requirements first. If the depth cannot + by determined (eg: due to no matching parents), it is considered + infinite. + * Order user-specified requirements by the order they are specified. + * If equal, prefers "non-free" requirements, i.e. contains at least one + operator, such as ``>=`` or ``<``. + * If equal, order alphabetically for consistency (helps debuggability). + """ + try: + next(iter(information[identifier])) + except StopIteration: + # There is no information for this identifier, so there's no known + # candidates. + has_information = False + else: + has_information = True + + if has_information: + lookups = (r.get_candidate_lookup() for r, _ in information[identifier]) + candidate, ireqs = zip(*lookups) + else: + candidate, ireqs = None, () + + operators = [ + specifier.operator + for specifier_set in (ireq.specifier for ireq in ireqs if ireq) + for specifier in specifier_set + ] + + direct = candidate is not None + pinned = any(op[:2] == "==" for op in operators) + unfree = bool(operators) + + try: + requested_order: Union[int, float] = self._user_requested[identifier] + except KeyError: + requested_order = math.inf + if has_information: + parent_depths = ( + self._known_depths[parent.name] if parent is not None else 0.0 + for _, parent in information[identifier] + ) + inferred_depth = min(d for d in parent_depths) + 1.0 + else: + inferred_depth = math.inf + else: + inferred_depth = 1.0 + self._known_depths[identifier] = inferred_depth + + requested_order = self._user_requested.get(identifier, math.inf) + + # Requires-Python has only one candidate and the check is basically + # free, so we always do it first to avoid needless work if it fails. + requires_python = identifier == REQUIRES_PYTHON_IDENTIFIER + + # Prefer the causes of backtracking on the assumption that the problem + # resolving the dependency tree is related to the failures that caused + # the backtracking + backtrack_cause = self.is_backtrack_cause(identifier, backtrack_causes) + + return ( + not requires_python, + not direct, + not pinned, + not backtrack_cause, + inferred_depth, + requested_order, + not unfree, + identifier, + ) + + def find_matches( + self, + identifier: str, + requirements: Mapping[str, Iterator[Requirement]], + incompatibilities: Mapping[str, Iterator[Candidate]], + ) -> Iterable[Candidate]: + def _eligible_for_upgrade(identifier: str) -> bool: + """Are upgrades allowed for this project? + + This checks the upgrade strategy, and whether the project was one + that the user specified in the command line, in order to decide + whether we should upgrade if there's a newer version available. + + (Note that we don't need access to the `--upgrade` flag, because + an upgrade strategy of "to-satisfy-only" means that `--upgrade` + was not specified). + """ + if self._upgrade_strategy == "eager": + return True + elif self._upgrade_strategy == "only-if-needed": + user_order = _get_with_identifier( + self._user_requested, + identifier, + default=None, + ) + return user_order is not None + return False + + constraint = _get_with_identifier( + self._constraints, + identifier, + default=Constraint.empty(), + ) + return self._factory.find_candidates( + identifier=identifier, + requirements=requirements, + constraint=constraint, + prefers_installed=(not _eligible_for_upgrade(identifier)), + incompatibilities=incompatibilities, + is_satisfied_by=self.is_satisfied_by, + ) + + @lru_cache(maxsize=None) + def is_satisfied_by(self, requirement: Requirement, candidate: Candidate) -> bool: + return requirement.is_satisfied_by(candidate) + + def get_dependencies(self, candidate: Candidate) -> Sequence[Requirement]: + with_requires = not self._ignore_dependencies + return [r for r in candidate.iter_dependencies(with_requires) if r is not None] + + @staticmethod + def is_backtrack_cause( + identifier: str, backtrack_causes: Sequence["PreferenceInformation"] + ) -> bool: + for backtrack_cause in backtrack_causes: + if identifier == backtrack_cause.requirement.name: + return True + if backtrack_cause.parent and identifier == backtrack_cause.parent.name: + return True + return False diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/reporter.py b/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/reporter.py new file mode 100644 index 0000000..0594569 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/reporter.py @@ -0,0 +1,81 @@ +from collections import defaultdict +from logging import getLogger +from typing import Any, DefaultDict + +from pip._vendor.resolvelib.reporters import BaseReporter + +from .base import Candidate, Requirement + +logger = getLogger(__name__) + + +class PipReporter(BaseReporter): + def __init__(self) -> None: + self.reject_count_by_package: DefaultDict[str, int] = defaultdict(int) + + self._messages_at_reject_count = { + 1: ( + "pip is looking at multiple versions of {package_name} to " + "determine which version is compatible with other " + "requirements. This could take a while." + ), + 8: ( + "pip is still looking at multiple versions of {package_name} to " + "determine which version is compatible with other " + "requirements. This could take a while." + ), + 13: ( + "This is taking longer than usual. You might need to provide " + "the dependency resolver with stricter constraints to reduce " + "runtime. See https://pip.pypa.io/warnings/backtracking for " + "guidance. If you want to abort this run, press Ctrl + C." + ), + } + + def rejecting_candidate(self, criterion: Any, candidate: Candidate) -> None: + self.reject_count_by_package[candidate.name] += 1 + + count = self.reject_count_by_package[candidate.name] + if count not in self._messages_at_reject_count: + return + + message = self._messages_at_reject_count[count] + logger.info("INFO: %s", message.format(package_name=candidate.name)) + + msg = "Will try a different candidate, due to conflict:" + for req_info in criterion.information: + req, parent = req_info.requirement, req_info.parent + # Inspired by Factory.get_installation_error + msg += "\n " + if parent: + msg += f"{parent.name} {parent.version} depends on " + else: + msg += "The user requested " + msg += req.format_for_error() + logger.debug(msg) + + +class PipDebuggingReporter(BaseReporter): + """A reporter that does an info log for every event it sees.""" + + def starting(self) -> None: + logger.info("Reporter.starting()") + + def starting_round(self, index: int) -> None: + logger.info("Reporter.starting_round(%r)", index) + + def ending_round(self, index: int, state: Any) -> None: + logger.info("Reporter.ending_round(%r, state)", index) + logger.debug("Reporter.ending_round(%r, %r)", index, state) + + def ending(self, state: Any) -> None: + logger.info("Reporter.ending(%r)", state) + + def adding_requirement(self, requirement: Requirement, parent: Candidate) -> None: + logger.info("Reporter.adding_requirement(%r, %r)", requirement, parent) + + def rejecting_candidate(self, criterion: Any, candidate: Candidate) -> None: + logger.info("Reporter.rejecting_candidate(%r, %r)", criterion, candidate) + + def pinning(self, candidate: Candidate) -> None: + logger.info("Reporter.pinning(%r)", candidate) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/requirements.py b/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/requirements.py new file mode 100644 index 0000000..b04f41b --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/requirements.py @@ -0,0 +1,245 @@ +from typing import Any, Optional + +from pip._vendor.packaging.specifiers import SpecifierSet +from pip._vendor.packaging.utils import NormalizedName, canonicalize_name + +from pip._internal.req.constructors import install_req_drop_extras +from pip._internal.req.req_install import InstallRequirement + +from .base import Candidate, CandidateLookup, Requirement, format_name + + +class ExplicitRequirement(Requirement): + def __init__(self, candidate: Candidate) -> None: + self.candidate = candidate + + def __str__(self) -> str: + return str(self.candidate) + + def __repr__(self) -> str: + return f"{self.__class__.__name__}({self.candidate!r})" + + def __hash__(self) -> int: + return hash(self.candidate) + + def __eq__(self, other: Any) -> bool: + if not isinstance(other, ExplicitRequirement): + return False + return self.candidate == other.candidate + + @property + def project_name(self) -> NormalizedName: + # No need to canonicalize - the candidate did this + return self.candidate.project_name + + @property + def name(self) -> str: + # No need to canonicalize - the candidate did this + return self.candidate.name + + def format_for_error(self) -> str: + return self.candidate.format_for_error() + + def get_candidate_lookup(self) -> CandidateLookup: + return self.candidate, None + + def is_satisfied_by(self, candidate: Candidate) -> bool: + return candidate == self.candidate + + +class SpecifierRequirement(Requirement): + def __init__(self, ireq: InstallRequirement) -> None: + assert ireq.link is None, "This is a link, not a specifier" + self._ireq = ireq + self._equal_cache: Optional[str] = None + self._hash: Optional[int] = None + self._extras = frozenset(canonicalize_name(e) for e in self._ireq.extras) + + @property + def _equal(self) -> str: + if self._equal_cache is not None: + return self._equal_cache + + self._equal_cache = str(self._ireq) + return self._equal_cache + + def __str__(self) -> str: + return str(self._ireq.req) + + def __repr__(self) -> str: + return f"{self.__class__.__name__}({str(self._ireq.req)!r})" + + def __eq__(self, other: object) -> bool: + if not isinstance(other, SpecifierRequirement): + return NotImplemented + return self._equal == other._equal + + def __hash__(self) -> int: + if self._hash is not None: + return self._hash + + self._hash = hash(self._equal) + return self._hash + + @property + def project_name(self) -> NormalizedName: + assert self._ireq.req, "Specifier-backed ireq is always PEP 508" + return canonicalize_name(self._ireq.req.name) + + @property + def name(self) -> str: + return format_name(self.project_name, self._extras) + + def format_for_error(self) -> str: + # Convert comma-separated specifiers into "A, B, ..., F and G" + # This makes the specifier a bit more "human readable", without + # risking a change in meaning. (Hopefully! Not all edge cases have + # been checked) + parts = [s.strip() for s in str(self).split(",")] + if len(parts) == 0: + return "" + elif len(parts) == 1: + return parts[0] + + return ", ".join(parts[:-1]) + " and " + parts[-1] + + def get_candidate_lookup(self) -> CandidateLookup: + return None, self._ireq + + def is_satisfied_by(self, candidate: Candidate) -> bool: + assert candidate.name == self.name, ( + f"Internal issue: Candidate is not for this requirement " + f"{candidate.name} vs {self.name}" + ) + # We can safely always allow prereleases here since PackageFinder + # already implements the prerelease logic, and would have filtered out + # prerelease candidates if the user does not expect them. + assert self._ireq.req, "Specifier-backed ireq is always PEP 508" + spec = self._ireq.req.specifier + return spec.contains(candidate.version, prereleases=True) + + +class SpecifierWithoutExtrasRequirement(SpecifierRequirement): + """ + Requirement backed by an install requirement on a base package. + Trims extras from its install requirement if there are any. + """ + + def __init__(self, ireq: InstallRequirement) -> None: + assert ireq.link is None, "This is a link, not a specifier" + self._ireq = install_req_drop_extras(ireq) + self._equal_cache: Optional[str] = None + self._hash: Optional[int] = None + self._extras = frozenset(canonicalize_name(e) for e in self._ireq.extras) + + @property + def _equal(self) -> str: + if self._equal_cache is not None: + return self._equal_cache + + self._equal_cache = str(self._ireq) + return self._equal_cache + + def __eq__(self, other: object) -> bool: + if not isinstance(other, SpecifierWithoutExtrasRequirement): + return NotImplemented + return self._equal == other._equal + + def __hash__(self) -> int: + if self._hash is not None: + return self._hash + + self._hash = hash(self._equal) + return self._hash + + +class RequiresPythonRequirement(Requirement): + """A requirement representing Requires-Python metadata.""" + + def __init__(self, specifier: SpecifierSet, match: Candidate) -> None: + self.specifier = specifier + self._specifier_string = str(specifier) # for faster __eq__ + self._hash: Optional[int] = None + self._candidate = match + + def __str__(self) -> str: + return f"Python {self.specifier}" + + def __repr__(self) -> str: + return f"{self.__class__.__name__}({str(self.specifier)!r})" + + def __hash__(self) -> int: + if self._hash is not None: + return self._hash + + self._hash = hash((self._specifier_string, self._candidate)) + return self._hash + + def __eq__(self, other: Any) -> bool: + if not isinstance(other, RequiresPythonRequirement): + return False + return ( + self._specifier_string == other._specifier_string + and self._candidate == other._candidate + ) + + @property + def project_name(self) -> NormalizedName: + return self._candidate.project_name + + @property + def name(self) -> str: + return self._candidate.name + + def format_for_error(self) -> str: + return str(self) + + def get_candidate_lookup(self) -> CandidateLookup: + if self.specifier.contains(self._candidate.version, prereleases=True): + return self._candidate, None + return None, None + + def is_satisfied_by(self, candidate: Candidate) -> bool: + assert candidate.name == self._candidate.name, "Not Python candidate" + # We can safely always allow prereleases here since PackageFinder + # already implements the prerelease logic, and would have filtered out + # prerelease candidates if the user does not expect them. + return self.specifier.contains(candidate.version, prereleases=True) + + +class UnsatisfiableRequirement(Requirement): + """A requirement that cannot be satisfied.""" + + def __init__(self, name: NormalizedName) -> None: + self._name = name + + def __str__(self) -> str: + return f"{self._name} (unavailable)" + + def __repr__(self) -> str: + return f"{self.__class__.__name__}({str(self._name)!r})" + + def __eq__(self, other: object) -> bool: + if not isinstance(other, UnsatisfiableRequirement): + return NotImplemented + return self._name == other._name + + def __hash__(self) -> int: + return hash(self._name) + + @property + def project_name(self) -> NormalizedName: + return self._name + + @property + def name(self) -> str: + return self._name + + def format_for_error(self) -> str: + return str(self) + + def get_candidate_lookup(self) -> CandidateLookup: + return None, None + + def is_satisfied_by(self, candidate: Candidate) -> bool: + return False diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/resolver.py b/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/resolver.py new file mode 100644 index 0000000..c12beef --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/resolution/resolvelib/resolver.py @@ -0,0 +1,317 @@ +import contextlib +import functools +import logging +import os +from typing import TYPE_CHECKING, Dict, List, Optional, Set, Tuple, cast + +from pip._vendor.packaging.utils import canonicalize_name +from pip._vendor.resolvelib import BaseReporter, ResolutionImpossible +from pip._vendor.resolvelib import Resolver as RLResolver +from pip._vendor.resolvelib.structs import DirectedGraph + +from pip._internal.cache import WheelCache +from pip._internal.index.package_finder import PackageFinder +from pip._internal.operations.prepare import RequirementPreparer +from pip._internal.req.constructors import install_req_extend_extras +from pip._internal.req.req_install import InstallRequirement +from pip._internal.req.req_set import RequirementSet +from pip._internal.resolution.base import BaseResolver, InstallRequirementProvider +from pip._internal.resolution.resolvelib.provider import PipProvider +from pip._internal.resolution.resolvelib.reporter import ( + PipDebuggingReporter, + PipReporter, +) +from pip._internal.utils.packaging import get_requirement + +from .base import Candidate, Requirement +from .factory import Factory + +if TYPE_CHECKING: + from pip._vendor.resolvelib.resolvers import Result as RLResult + + Result = RLResult[Requirement, Candidate, str] + + +logger = logging.getLogger(__name__) + + +class Resolver(BaseResolver): + _allowed_strategies = {"eager", "only-if-needed", "to-satisfy-only"} + + def __init__( + self, + preparer: RequirementPreparer, + finder: PackageFinder, + wheel_cache: Optional[WheelCache], + make_install_req: InstallRequirementProvider, + use_user_site: bool, + ignore_dependencies: bool, + ignore_installed: bool, + ignore_requires_python: bool, + force_reinstall: bool, + upgrade_strategy: str, + py_version_info: Optional[Tuple[int, ...]] = None, + ): + super().__init__() + assert upgrade_strategy in self._allowed_strategies + + self.factory = Factory( + finder=finder, + preparer=preparer, + make_install_req=make_install_req, + wheel_cache=wheel_cache, + use_user_site=use_user_site, + force_reinstall=force_reinstall, + ignore_installed=ignore_installed, + ignore_requires_python=ignore_requires_python, + py_version_info=py_version_info, + ) + self.ignore_dependencies = ignore_dependencies + self.upgrade_strategy = upgrade_strategy + self._result: Optional[Result] = None + + def resolve( + self, root_reqs: List[InstallRequirement], check_supported_wheels: bool + ) -> RequirementSet: + collected = self.factory.collect_root_requirements(root_reqs) + provider = PipProvider( + factory=self.factory, + constraints=collected.constraints, + ignore_dependencies=self.ignore_dependencies, + upgrade_strategy=self.upgrade_strategy, + user_requested=collected.user_requested, + ) + if "PIP_RESOLVER_DEBUG" in os.environ: + reporter: BaseReporter = PipDebuggingReporter() + else: + reporter = PipReporter() + resolver: RLResolver[Requirement, Candidate, str] = RLResolver( + provider, + reporter, + ) + + try: + limit_how_complex_resolution_can_be = 200000 + result = self._result = resolver.resolve( + collected.requirements, max_rounds=limit_how_complex_resolution_can_be + ) + + except ResolutionImpossible as e: + error = self.factory.get_installation_error( + cast("ResolutionImpossible[Requirement, Candidate]", e), + collected.constraints, + ) + raise error from e + + req_set = RequirementSet(check_supported_wheels=check_supported_wheels) + # process candidates with extras last to ensure their base equivalent is + # already in the req_set if appropriate. + # Python's sort is stable so using a binary key function keeps relative order + # within both subsets. + for candidate in sorted( + result.mapping.values(), key=lambda c: c.name != c.project_name + ): + ireq = candidate.get_install_requirement() + if ireq is None: + if candidate.name != candidate.project_name: + # extend existing req's extras + with contextlib.suppress(KeyError): + req = req_set.get_requirement(candidate.project_name) + req_set.add_named_requirement( + install_req_extend_extras( + req, get_requirement(candidate.name).extras + ) + ) + continue + + # Check if there is already an installation under the same name, + # and set a flag for later stages to uninstall it, if needed. + installed_dist = self.factory.get_dist_to_uninstall(candidate) + if installed_dist is None: + # There is no existing installation -- nothing to uninstall. + ireq.should_reinstall = False + elif self.factory.force_reinstall: + # The --force-reinstall flag is set -- reinstall. + ireq.should_reinstall = True + elif installed_dist.version != candidate.version: + # The installation is different in version -- reinstall. + ireq.should_reinstall = True + elif candidate.is_editable or installed_dist.editable: + # The incoming distribution is editable, or different in + # editable-ness to installation -- reinstall. + ireq.should_reinstall = True + elif candidate.source_link and candidate.source_link.is_file: + # The incoming distribution is under file:// + if candidate.source_link.is_wheel: + # is a local wheel -- do nothing. + logger.info( + "%s is already installed with the same version as the " + "provided wheel. Use --force-reinstall to force an " + "installation of the wheel.", + ireq.name, + ) + continue + + # is a local sdist or path -- reinstall + ireq.should_reinstall = True + else: + continue + + link = candidate.source_link + if link and link.is_yanked: + # The reason can contain non-ASCII characters, Unicode + # is required for Python 2. + msg = ( + "The candidate selected for download or install is a " + "yanked version: {name!r} candidate (version {version} " + "at {link})\nReason for being yanked: {reason}" + ).format( + name=candidate.name, + version=candidate.version, + link=link, + reason=link.yanked_reason or "", + ) + logger.warning(msg) + + req_set.add_named_requirement(ireq) + + reqs = req_set.all_requirements + self.factory.preparer.prepare_linked_requirements_more(reqs) + for req in reqs: + req.prepared = True + req.needs_more_preparation = False + return req_set + + def get_installation_order( + self, req_set: RequirementSet + ) -> List[InstallRequirement]: + """Get order for installation of requirements in RequirementSet. + + The returned list contains a requirement before another that depends on + it. This helps ensure that the environment is kept consistent as they + get installed one-by-one. + + The current implementation creates a topological ordering of the + dependency graph, giving more weight to packages with less + or no dependencies, while breaking any cycles in the graph at + arbitrary points. We make no guarantees about where the cycle + would be broken, other than it *would* be broken. + """ + assert self._result is not None, "must call resolve() first" + + if not req_set.requirements: + # Nothing is left to install, so we do not need an order. + return [] + + graph = self._result.graph + weights = get_topological_weights(graph, set(req_set.requirements.keys())) + + sorted_items = sorted( + req_set.requirements.items(), + key=functools.partial(_req_set_item_sorter, weights=weights), + reverse=True, + ) + return [ireq for _, ireq in sorted_items] + + +def get_topological_weights( + graph: "DirectedGraph[Optional[str]]", requirement_keys: Set[str] +) -> Dict[Optional[str], int]: + """Assign weights to each node based on how "deep" they are. + + This implementation may change at any point in the future without prior + notice. + + We first simplify the dependency graph by pruning any leaves and giving them + the highest weight: a package without any dependencies should be installed + first. This is done again and again in the same way, giving ever less weight + to the newly found leaves. The loop stops when no leaves are left: all + remaining packages have at least one dependency left in the graph. + + Then we continue with the remaining graph, by taking the length for the + longest path to any node from root, ignoring any paths that contain a single + node twice (i.e. cycles). This is done through a depth-first search through + the graph, while keeping track of the path to the node. + + Cycles in the graph result would result in node being revisited while also + being on its own path. In this case, take no action. This helps ensure we + don't get stuck in a cycle. + + When assigning weight, the longer path (i.e. larger length) is preferred. + + We are only interested in the weights of packages that are in the + requirement_keys. + """ + path: Set[Optional[str]] = set() + weights: Dict[Optional[str], int] = {} + + def visit(node: Optional[str]) -> None: + if node in path: + # We hit a cycle, so we'll break it here. + return + + # Time to visit the children! + path.add(node) + for child in graph.iter_children(node): + visit(child) + path.remove(node) + + if node not in requirement_keys: + return + + last_known_parent_count = weights.get(node, 0) + weights[node] = max(last_known_parent_count, len(path)) + + # Simplify the graph, pruning leaves that have no dependencies. + # This is needed for large graphs (say over 200 packages) because the + # `visit` function is exponentially slower then, taking minutes. + # See https://github.com/pypa/pip/issues/10557 + # We will loop until we explicitly break the loop. + while True: + leaves = set() + for key in graph: + if key is None: + continue + for _child in graph.iter_children(key): + # This means we have at least one child + break + else: + # No child. + leaves.add(key) + if not leaves: + # We are done simplifying. + break + # Calculate the weight for the leaves. + weight = len(graph) - 1 + for leaf in leaves: + if leaf not in requirement_keys: + continue + weights[leaf] = weight + # Remove the leaves from the graph, making it simpler. + for leaf in leaves: + graph.remove(leaf) + + # Visit the remaining graph. + # `None` is guaranteed to be the root node by resolvelib. + visit(None) + + # Sanity check: all requirement keys should be in the weights, + # and no other keys should be in the weights. + difference = set(weights.keys()).difference(requirement_keys) + assert not difference, difference + + return weights + + +def _req_set_item_sorter( + item: Tuple[str, InstallRequirement], + weights: Dict[Optional[str], int], +) -> Tuple[int, str]: + """Key function used to sort install requirements for installation. + + Based on the "weight" mapping calculated in ``get_installation_order()``. + The canonical package name is returned as the second member as a tie- + breaker to ensure the result is predictable, which is useful in tests. + """ + name = canonicalize_name(item[0]) + return weights[name], name diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/self_outdated_check.py b/.venv/lib/python3.12/site-packages/pip/_internal/self_outdated_check.py new file mode 100644 index 0000000..f9a91af --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/self_outdated_check.py @@ -0,0 +1,244 @@ +import datetime +import functools +import hashlib +import json +import logging +import optparse +import os.path +import sys +from dataclasses import dataclass +from typing import Any, Callable, Dict, Optional + +from pip._vendor.packaging.version import Version +from pip._vendor.packaging.version import parse as parse_version +from pip._vendor.rich.console import Group +from pip._vendor.rich.markup import escape +from pip._vendor.rich.text import Text + +from pip._internal.index.collector import LinkCollector +from pip._internal.index.package_finder import PackageFinder +from pip._internal.metadata import get_default_environment +from pip._internal.models.selection_prefs import SelectionPreferences +from pip._internal.network.session import PipSession +from pip._internal.utils.compat import WINDOWS +from pip._internal.utils.entrypoints import ( + get_best_invocation_for_this_pip, + get_best_invocation_for_this_python, +) +from pip._internal.utils.filesystem import adjacent_tmp_file, check_path_owner, replace +from pip._internal.utils.misc import ensure_dir + +_WEEK = datetime.timedelta(days=7) + +logger = logging.getLogger(__name__) + + +def _get_statefile_name(key: str) -> str: + key_bytes = key.encode() + name = hashlib.sha224(key_bytes).hexdigest() + return name + + +def _convert_date(isodate: str) -> datetime.datetime: + """Convert an ISO format string to a date. + + Handles the format 2020-01-22T14:24:01Z (trailing Z) + which is not supported by older versions of fromisoformat. + """ + return datetime.datetime.fromisoformat(isodate.replace("Z", "+00:00")) + + +class SelfCheckState: + def __init__(self, cache_dir: str) -> None: + self._state: Dict[str, Any] = {} + self._statefile_path = None + + # Try to load the existing state + if cache_dir: + self._statefile_path = os.path.join( + cache_dir, "selfcheck", _get_statefile_name(self.key) + ) + try: + with open(self._statefile_path, encoding="utf-8") as statefile: + self._state = json.load(statefile) + except (OSError, ValueError, KeyError): + # Explicitly suppressing exceptions, since we don't want to + # error out if the cache file is invalid. + pass + + @property + def key(self) -> str: + return sys.prefix + + def get(self, current_time: datetime.datetime) -> Optional[str]: + """Check if we have a not-outdated version loaded already.""" + if not self._state: + return None + + if "last_check" not in self._state: + return None + + if "pypi_version" not in self._state: + return None + + # Determine if we need to refresh the state + last_check = _convert_date(self._state["last_check"]) + time_since_last_check = current_time - last_check + if time_since_last_check > _WEEK: + return None + + return self._state["pypi_version"] + + def set(self, pypi_version: str, current_time: datetime.datetime) -> None: + # If we do not have a path to cache in, don't bother saving. + if not self._statefile_path: + return + + # Check to make sure that we own the directory + if not check_path_owner(os.path.dirname(self._statefile_path)): + return + + # Now that we've ensured the directory is owned by this user, we'll go + # ahead and make sure that all our directories are created. + ensure_dir(os.path.dirname(self._statefile_path)) + + state = { + # Include the key so it's easy to tell which pip wrote the + # file. + "key": self.key, + "last_check": current_time.isoformat(), + "pypi_version": pypi_version, + } + + text = json.dumps(state, sort_keys=True, separators=(",", ":")) + + with adjacent_tmp_file(self._statefile_path) as f: + f.write(text.encode()) + + try: + # Since we have a prefix-specific state file, we can just + # overwrite whatever is there, no need to check. + replace(f.name, self._statefile_path) + except OSError: + # Best effort. + pass + + +@dataclass +class UpgradePrompt: + old: str + new: str + + def __rich__(self) -> Group: + if WINDOWS: + pip_cmd = f"{get_best_invocation_for_this_python()} -m pip" + else: + pip_cmd = get_best_invocation_for_this_pip() + + notice = "[bold][[reset][blue]notice[reset][bold]][reset]" + return Group( + Text(), + Text.from_markup( + f"{notice} A new release of pip is available: " + f"[red]{self.old}[reset] -> [green]{self.new}[reset]" + ), + Text.from_markup( + f"{notice} To update, run: " + f"[green]{escape(pip_cmd)} install --upgrade pip" + ), + ) + + +def was_installed_by_pip(pkg: str) -> bool: + """Checks whether pkg was installed by pip + + This is used not to display the upgrade message when pip is in fact + installed by system package manager, such as dnf on Fedora. + """ + dist = get_default_environment().get_distribution(pkg) + return dist is not None and "pip" == dist.installer + + +def _get_current_remote_pip_version( + session: PipSession, options: optparse.Values +) -> Optional[str]: + # Lets use PackageFinder to see what the latest pip version is + link_collector = LinkCollector.create( + session, + options=options, + suppress_no_index=True, + ) + + # Pass allow_yanked=False so we don't suggest upgrading to a + # yanked version. + selection_prefs = SelectionPreferences( + allow_yanked=False, + allow_all_prereleases=False, # Explicitly set to False + ) + + finder = PackageFinder.create( + link_collector=link_collector, + selection_prefs=selection_prefs, + ) + best_candidate = finder.find_best_candidate("pip").best_candidate + if best_candidate is None: + return None + + return str(best_candidate.version) + + +def _self_version_check_logic( + *, + state: SelfCheckState, + current_time: datetime.datetime, + local_version: Version, + get_remote_version: Callable[[], Optional[str]], +) -> Optional[UpgradePrompt]: + remote_version_str = state.get(current_time) + if remote_version_str is None: + remote_version_str = get_remote_version() + if remote_version_str is None: + logger.debug("No remote pip version found") + return None + state.set(remote_version_str, current_time) + + remote_version = parse_version(remote_version_str) + logger.debug("Remote version of pip: %s", remote_version) + logger.debug("Local version of pip: %s", local_version) + + pip_installed_by_pip = was_installed_by_pip("pip") + logger.debug("Was pip installed by pip? %s", pip_installed_by_pip) + if not pip_installed_by_pip: + return None # Only suggest upgrade if pip is installed by pip. + + local_version_is_older = ( + local_version < remote_version + and local_version.base_version != remote_version.base_version + ) + if local_version_is_older: + return UpgradePrompt(old=str(local_version), new=remote_version_str) + + return None + + +def pip_self_version_check(session: PipSession, options: optparse.Values) -> None: + """Check for an update for pip. + + Limit the frequency of checks to once per week. State is stored either in + the active virtualenv or in the user's USER_CACHE_DIR keyed off the prefix + of the pip script path. + """ + installed_dist = get_default_environment().get_distribution("pip") + if not installed_dist: + return + + upgrade_prompt = _self_version_check_logic( + state=SelfCheckState(cache_dir=options.cache_dir), + current_time=datetime.datetime.now(datetime.timezone.utc), + local_version=installed_dist.version, + get_remote_version=functools.partial( + _get_current_remote_pip_version, session, options + ), + ) + if upgrade_prompt is not None: + logger.warning("%s", upgrade_prompt, extra={"rich": True}) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/__init__.py b/.venv/lib/python3.12/site-packages/pip/_internal/utils/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f9c1c88b6bb89e1a5f7002577ac3670eaf244930 GIT binary patch literal 190 zcmX@j%ge<81Rn!er-A6lAOanHW&w&!XQ*V*Wb|9fP{ah}eFmxd6|0|-pPQ;*RFGOy zlwX#aoS~nbpOUKYn^~N!uUD3uSEiqnnWSG(S(1^TXRK#vq+gs_lB!#fn4F!Mo?5J5 zkXfJ~pP5&ZT9lWVqhDH*nNzGE4;08OiI3MSsQkrYlbfGXnv-f*#0s>H5r~UHjE~HW KjEqIhKo$U*=`!2^ literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/_jaraco_text.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/_jaraco_text.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..dfb47c21c2a817e2c2cc5e5e98c7c76fa6d8edc7 GIT binary patch literal 4530 zcmcgvO>EoN9VaC@v8gys>LqDXqxLbg&8cF^u^L(OB)ORrrwUCzTXZOr zc%@}wyc1h+92{d4r?XcdQxQ8Mbmi_)uAC{Z6 z>n@`$^6|a@*Zcjy9{)Hvs42Ma|M=$8!9hj&JH2$SaC@+I1%vB~shm?x)ePC{IaNMG z=R#)qZRK2;t1JB-rtPO0d0V;Jem&R6`&JO z0w3}N3#OUeg9h#x4Q99wKf!#r#%Vv0P}KoYUG&)C^PuiA%a>Rfbs-?d2B+>xW8EdK z3i&p;fnm-vxC0ag_k?TK4L~K4#&(u1Km=7}I&iezwU;z)()Aixf>&PAeb-^d1e-2iRsDQaL9?jH)h{d7QScI}HZNNsPM~=$1np(y>La zp@9+`^r3z!SR=<0B)adrhNVLuGhL%z!^U(96}DvAz zEOp%g&jiAf;T8vxVb@Kvfr5p+WLq_>tpV(s+_z7bBc$Te&N!>NrnS_-lgn*+^+ntA zt8r#pBzmzPfYPT)iF2Ixk#vRTbK52f?KtVRPSTJTU<3Vah@{@NDw3d=7D#JLb>To| zE8a~PkV%az+z3btkuSM6+(%nO{Fs(ZFF3P|C4CX;CHK;DD-sB%O1Py1q!BHzwwL^> z4%?AfEx@4Hax|LiY)8ARsmWX_I}>N=)J*C$SyyBQNGWPW*0PSB zozBn{=}X~%vYajCX&aM;e7T6%ICfbqcUjM7OPM%J6|*Ins!bIO5KnM|1JWS`eECdE z3PCLa>Usnu1lSxl-LZwGGpQV8l{7HZVuv`PeMS{NZ?p@&Ecet}=(m-??YeSBxvYw( zRXkUEsU)d_rqgK>dz6wA3*{fGBQdq9A&^AiQ%d43jHL33nLX5#NCuu19uI`OY8lm} z;hH=-WBEohfvUQiw5`RY*FY*e-%EV=#iVZq`~^=pF6qnMPofbdyNw`O4=meHR$BGF zBKwQiXbw~y*IBf6=aQh#cN{RQ)XgqcL3b7Pn2d zs@s-{8s@ZGkv&}c!H#!#s9XEmN9ZS>vB_o zYr&zvC+}@1s`5Eg_8fTs>}Ee1feBLpdIWC%JK zAOyR)7j#1~=muUu0V}U39rlp9(a!qzvvd6G24!0=1!X?AtGNs98Gy(f5_`cXNJ+Dg z;?YBbd$twGm;(wC%Do;0nrcNH1oa90{A0LXRsIp(|6%OsrC$#H`tUCf|0eyr!pDV; z_>VS@PHaR^-j1An9Dr^a8V5g>p|3ALW{7ee#)sGcAcHq8To27n2AJQIGA8CL?fEeZ zW;ViPG)pd-1g-o^;k@TpyT=M-BFYeFHNDYlqfBRW#oSj)t_FekQZmUe>opHK3yn!A zqu?KHW$5VFP)J+WLu^ElSAg(~N zkej}AZTAH6;(&4mpCxAai1MT|*@?mJa=EQ%9a6u62KBucuc$v$udAx^-kFHf2#qM) zCHJ@@BC0Zvy);5=%H{C9vZnqvyr#w?`fC7IqWp@Bb7rgF;+Pd!P90|>oPl)~2;IWM zGQz{SRslH`(S+A&#L*}_7ny0(kWjv`AT(3zJebSwG)U0&DH^_{g6 zCZa&2HcI>Q^79PG`L!y}%s3q<5(&9LM^XAT&<#`y<_V535dw@(uU*jSyF#~pe0QO< zar2vCxQrGfAvEnqk73KMeD9nPp}LU&?B9<9kq^iNp|syBTp% zHJgK_!1c0NmH`wCHT$G3lBMQT`ZLzb^8Js6hd7Sq0)9RnQU0lXfj*N^2KQe(@a~zb znS1*VJWzJ^4gEB7Z|~FZ*WRh!NdI~7vCU9;@X))k>9;b0E+T2~K;8U0$p5@pV_X`Gla(K~>9t z4L8`Us`o=j)yUR_qVE5zvhTqzRsGIpzY>bxRS(}$58n?xrDoKvuo615DTkZKmC)c_ k^}rqVz%^q-J#s&!sxM1|XE){WLH{0gWb3)-)FG+=KdZvfS^xk5 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/_log.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/_log.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..10c405ea42df55d962b7dd3cd5e4f8e617306439 GIT binary patch literal 1861 zcmZux&u`pB6rQoY>y3Alq0WuccO?jL&@SL!R}zRkk*Qji(w?DEXy+Qu(pVoLT(v`7kIHf zNH}G(He_Opg1L_G3l1Kn5zGmCEQDl|wL{+Z;ly~!iPNC`GFD5(*Rzw1Cs&nfAdFDk>UVKl8fPGy5@Fo<= z+12?gpI)=lutaS~tweKVD@uxY?`2ksxGRIYtK?OH#dg5z`jPtc=*j4 zZ7FNY_w<*dN7mFI=+|_Cm^8%;uA1nB3z}M@MZ#}NL`sgJ!k&yYP*}&)&udFzThwGn z#4=p*+@+cua#6eCMQ#nAJ6Ngt-eRrOgO?62Sns@Bi@aFObR74t(-Kjw<8^Ab7sNsa zj$iA>o*&h)6Rb`z(FfSAzIF=jyop}NdrX2_Cx2GQzl^`R|JD6%edpD^>g-PZdv*55 zmHq1MUTL-uA;i>^l5Gc0TiAAD*ml-J;8$$>i>~7jc68h3p$p4u6ibPmkS~M!iO5&b ze+iYIEBqH><7|*4MJ<#L4O+PP;KCsRvlFG}p_`gt`7thLN$~qb!vkd*T$h5%r3en5 z+W!dD7Kw*@Cl43r%qPnj{hX|k-N84zgQv!4UA+R3B3n-gGR+pdF%v=5mB6I1E7>WK z2mFQh%(_i*QUW!RkJCZ3jJfsOnu7R$pXhK+&57@bO9KYa$h7a@sI9a}fc63Lg{ zrWp4+&{-K-@DNli+pvrM6I}*%s8ULglmgZI yV}w@!Cg%=Iq&&K=9~X6car4?%{oDF60r&8XLN9I39TG4PZuHR{8#!zgrgC9rsNE%+X1Vrj;?%LN_nfA! z(yg74C?~j4q)B8q5FC2!kt5PB4Xsq>b*HhzZmF`%&<^|FbJA8_H~1vK@BR7S_r3S~ zec$s>>9ov&?A&-fwUpqv-{_z#Qm51Y9y<3piz{#zZwU@x;F%T*0_d0%tB3`Wr)#1U zuOtc*^y4ULB~Wrow4|G2A!YTjnIw|gY{E+2j2D!D&B`zvStgK(k|!Z9cu>GYdQQlt z=l_x?N;XkV&q8Vq8$MBk5>jW7Yk3%1s^R;Vjfqfp+-}a*jlLkR~8A2k}b^}^#yc$yh!YXW5JI>&k zs#!AJBC_)GAC!x+93P6;Y!ZO(@f{<8qgUvSLkX_#8Wj{KqN|!bweN@sItE|+A~g57 zV0W!7bS(C%I`H^Jc-&bT=W?;JQ3#iU07f+^c{nG8Nxg$~*jptC>!x9rkPZjQ@i-2? z2#uh=`dTY_6{KMw1=yRh&5}lm)4s5YspSEJ8O^aLHGdAgx9`*X3v-_L}|a!}fPi0t|~|qmKlf1S?EU=jCs;yy>}9c2UbonBF5yGoCFY zFeuHT;E_;-`YDBRo6rfd?AdN8qgfyFo7(0?mI=%uK0;k&9NVqV>W)2)bh?$$ORFH5 z-Y-0^R}9l5dX!KsIt_(Sz~bBRk#C?`dKklD;#1dw5GZ z-BeDmcpFN7UCiSi2yu9Z_^<*Q0&OIRRgT3^e*h5n1T?Rh)VVs}WoeuXy6-7hrdS^k zs5=4jE7r{~#!Hy63|zC_QJewuTs(}CIT9wjrO&{L2+AD5Ehp^ZPiWG2aK@*g&ziH) zA@oInvXSIl^`-jV+2_*x+nIqz@nLNvGrXQ0W@z^}mHx)n)#}sYrZToJjzuu-J|f^@ zw~+pZ!5hMKau24%%7?;X#h!>=IEp*~xC`um0l0t10{cWDz< z7=8To-3rUFVN`{z;S(-ol2~Jkl!I0vc$&lZ`;pvm_6Wt-~rhBA$-J!<^bv0 zceb+Uo7wY?+S~aQbt>?&{k=r9b2oL1@@&@F~OrzA?E2+9l{@h}cd?b=`A=4^v^Y?WD{ZQFk_xXiU<%agIi{ZWx9Mo-l*nJ_ lSH@c$)ekR6dTpr9#;qeMURyC+9H@r%aOg+-PugW?`v;4uBfS6s literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/compat.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/compat.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..391769160ad66cdb9a461efe2f966f8f852a71f3 GIT binary patch literal 2902 zcmaJ@U2Gf25#IYDc|4LLEy|H4!^PQhZL^U{)oL79b^|n4jH*>c$8@5Y4RAQ|j^t6N zJ7RZfT7s0SL4Zm?0Le`Osc3@~?TZZuNFV#yJoTY3q7{Jd+69cZDBw3bN`b;pojr;Y zBO4uXcW!rQXJ%)1zU5zIF%OIiQDIYNdRxRnQ-S7KIk`ZGpuB z*icl>o(}{0zA`f7e-QGA!Se9)dMcUc=gdUsEVl%r3FyT;%|o+i5V|GcI7rBqkr(Lc z&<8 zqBZOmy1kTPAVJ%?1l{EH#ZNlSu& z7KI#2$y1n%Uk8_>6FL3rjqKGorgFK-l+0wE5Qjx3=Bgg1Z(!_UcBE=o)A~)zH9efJ zVF$b&O~cU~43`$AM9goo|4q17O?&p!Oxc^WGPr6{?A^2r1=w=3V zWU77yN7LUummxN_&Q^`WtWmN^2JB^Y+ocwE4JX4b5l}D(Axl^1S*UCfojL^ffUyKL z@*U`wQA-R2Vh@$%<9PDFk0LL9g@i!tZ%VW!0e|+NAPSs+9O>VZ`w1_t59AQ~MK~$_ zQb|(Fq^`?-H_v1%4L13@FX3e#jfO3f(I61xUaLK zJiodSLa1YDN$9fVW5+k;7llqGR66+4C9ouR?dHKdK>NGlnuxh>zj&ArP$hX_0)~sI zW1k%FveozhBwy^QZ@<5@ZxQ_lnc^p6NBajtN-|QA6jcMd=9h}blX#kFP*Z8upC9)u zqPZT`ik{DXWHm0jo8~$$WqGl_99* zLXGeu*YPW(Bd?B(jJEY(b&P^#0z}wEE7sfsFLsU*?W?MpHA|!39%2;08Cd_}#Je0S zd>4M~7r<~EWJuYoIi_YodC;2SIP+S`(~PJWOII1j%m|n%k>YffqkQM zI?cmc!EjGgZN}2DWk4|aNtv3}r?OYFlatx$h0Hg0T-2s*$MFNz1|1$kh#BsvB&n!h zbOxoEi5_9HSG8QGWc6#~*{R7J_z>iY1&V|klm!X(VJ%Q_JYwNEUkciU2cF5kL}>Q} zDXG0G7EPuUZO7vK2(KjY7sr5OUQB*>3_i$h=$6sfN01W#2(MrIGNe6<#n+}+r`NCl z_S~lze|_<@-p`NSJ=QpSemnN+iufpbc;mwD3!AThe5si{)kvONQ64GknzE{__kI*@ z^`dCsa`x*OO7yPPSLMGXus?hg$3}T0+4Z#Okq)6ls*&h?Lrm20@4%{Fu?Z^ z$l{aG0sMz;ANT>DS-9gqf!soR2=I|)Azq^+Gd*2^!5POV#1? zq+f$Z#-M{V2GOCxW@4z37-}X`jYR6s>Fvb1Kfc>Y{Gb`X+=yR(5RGr1xpTfHp~Seb zgT#c|LSk6O-{N}sAy}~efUr=Vlx%DjnPT8l)xgAJQr&i$RB&u2x-=y&1ZuQ+_5#10 z*e=l2APecb=@oRHCHD@T?zl?uX|6uxc%>5L40E7k5}79~Naw43#y1ZtpiDtU7~b*Gu=MV-E&SGzW$o1H;XM^9}gPFG1P7DZDK_l>!0v!J)pE z&$Xd8&zx)XD-%9{9FDA9UhUrrfb3U;C_b_rf$fo=wc*v_rh2@g9{=69x79QE)#*FA k&)>WI-k;uXoPGWN*?0bo|5E>=zIE-LFMjs(kRONt0WV0fD*ylh literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/compatibility_tags.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/compatibility_tags.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..90a2e210e7e24e81d18bf666bf5e9f3e9751c259 GIT binary patch literal 5556 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/datetime.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/datetime.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..388d51818da618726acfd8052b0d9701ad330272 GIT binary patch literal 679 zcmZuvF>ezw6t?etNmMSVQW;?CAsC1dF$J*!3oTnJA+|{9bUnL0H<$Ct=cGDxl`^n& zf~_4pg0e93A6P&gkSqoyCbpC?b>jI*goJp~d*6G{@A-Xx^2c_21%aGDo9_Mu{BDD# zv=+|%7C6U6F7n_Y%5)KE z8N>;X2Z2s_z#`29sL^7`yDLBJm~BH!9x3AuWu_D3vZyo-#q~&KvAf`5!2`ANd<^Co zX|R7}-&uNpao<+|Bhy8E=xV$?`d@E_DqK0!#q2{;xfK~~BJ><}@OH;FE&B-j07I;2 zJS~B9$5XaL5o_#pW!G!GJu&84VH1Isix)JJLrzuBwUT2ICp4Cf)1D||+J(|FO~nq) zOP$Ekn^51YSivcB;*`$MCN literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/deprecation.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/deprecation.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..732757b5c34076d0e75474f6784c47135b90d5b8 GIT binary patch literal 4185 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 E2lLtkf&c&j literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/egg_link.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/egg_link.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..142db4aa27d367243b25475a62b48def32b3d284 GIT binary patch literal 3221 zcmbVO&2JmW6`x%$KShalZCSG0SmP+E&D!F|R*)cWQnW~%)P;KS83fq9N70^Rc6umJ~fC4`Cy&;$SsDcC? zkh5>z%)FU-?>E0Ue;pmo5h$Pi^g;E*EFqs@BQD8-u=g7fwunbOBOvAe*C-phZI(^= znn9vrm90jyoHVdM5u_UFa=MWzXLQ>NvW;9h*BB{}Ks)KBYGyg_rP-*LVHO)b3-+s) zm;IGh9vf(rLv0SUh5ylxfc8YkDCYl-o18D2ku~Q_6=i+$E>R zWRz`5CMu|dzDdyvLqDulTA>HpWnZY46R>bOI=wGfLSCr_e8CB#Z?amg68PZ~*i-dN zRq#edcBF0{+Zk}z!JR}I;j}BE(_m3bFx3*FYv7g#1$~@=|K9hZ+9GP$w`hXmNbwBM z?2-pK9*UP(fx1gR0O@yT&Adg5ma_^5aumv|JX~f%QHRdM+O)xx<2lNq%TCZ@RB`Ai z!I@_8Ocb|wg)Vfc(`*JEaEmsf>WoU9EL#gw`KpEIp^l`@rCLQW$y>r@@}h)6Ri=+f ztF6$*Q6+6)o-1~pwi$JuFyx9t08r$i?>d3MGMKZ#TnBr6MeAVPp`Kr@GQmPc177pp zQcfHDIipS>Iq3Kjt#Uzed*EBWd3vest2%Ef8gkJ<HX@rED>2KY#Uw7mNL4 zuZ;cTogd7Uotc&AW?m}Yx%|YKS;-Ea4d62cixS|}q9H~ggc5^JpWLzQyuobIWJ>U5 z->us&_n7^rFI~H|4A8U#e*u<m`!zkrT zG+0b(m_%cT0~lpB6#)nu(dePBC=)j&@(a=d6(>Ow=rUbh071S36$Cy*&OEz)`{8(L zb$)kza_jcy?azsoq-)uor!Id^5?Q+T=I+GVt@dVntGn6VzIp%d!--ecez;pWxzS#4 zZ@jzy?)&w}g^N2AQ}+s=rD1$80n>Xql0P9%!4k&<MEm9)@ivd6gc>trai0^id zMTFClqK2@E!(+&m1b{b&e)22kV_1%qZZh_ShJNxm=sOdzfJXmYI+bY- zMidSSc}R0qUj@I4~DjTK^B>%(q*9|d@ir+HLezc z%@y?_=g|G6th)fvN^~%dRsGPzAxMU$pWV9gR^`^sw{Kj*o%NN&2Y{YAo61ef1XvM7^E=0zSqdmH+?% literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/encoding.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/encoding.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c83aa14eb52fc252303a2988c69858b12ae1d9ac GIT binary patch literal 2153 zcma)7&2JM&6rcUf#&+U><2p$pY)C0_P;3$t1Puj=eDp&Q+5%E#h^)=dI9{{ab$7>r zBS%fEN_DDAIO-vm+CvUKP|*X&{tvy_Sjf?W)I(3)T*3+U(3y4CMpX_xdFTD!*Sz;; z->m=a>G1(V|9t)^y~P9YHx)dR_QBpo27qmF6F>kN9VAFa1b1bNqT*poXP3a+KUqwx?FUCTS3+~KgxwG4DL9)gl< z8S>-~huvv*r7PKs1SFy$>PxeO#7G}>2>LD%&H}_{-|Iwp2>Kt9Q=*g%!2k-v9um#N z-tYKie}RbxUr^Ixly&$knvEUdMn0#bH6f4F6X(`M$|ldQb+`D$GHOHOBy_}Hz9+xKEir=kuI6|6X-g>c?7)cqo9H9#N_ zN1nZZ-4~3h&ZRl9G!4LQ7JzkToh^ba_4*$b8LwfR`Ej5KFx}0ijs-G9Alv2XJG{tx zu`0`e>wpI&M|a2WA=vhV4CICYsmmZWaYYXDP#6MGyfX#>$sfS(7}L0Hj~CtHMb67d ze2>4a?>b-PH`q_Xw@i`G20OcX=+QoaJROjO`h;CxUiTE=_9PDQ!-u@A*@Lc!K^;kNey7sIRDi@6S>-D^M0W{`SER^;UZMz(BYi_DUoHZ7te6DDI*R!z%7D%J}! zM3?{>XON7H*4X)cGNA=U*OwKt4{_H`Rnbvw1>u~9(ul-D&v}ga*(fUO+8rdDIb@7Q zWz E8vW2Bo_DRkosPb@dFlJUQpRpjyi&3tD3eD4On#E9G{I93)}ZJoN+iE8IA}M zDF``&ozpe!_~#dAug!h3_)+SMc}KL7VyPKNT(Qi2&UVCBiBA7PH9DMKu${xi1W{Va z>)0zkDp(>-%`Ka&j^t?_Ue^pnubEAJZCV^X5c%~|JY%k+xRpcLGVf|?CQj>%U)5|i z9=nT-yK!Axj^|pf$0n!ZwuaF}jvS)0g6w!s%f(Zgfsth>dOVLc-Hv-XW4VIkSMu0Q zwVJkuNmlxew3}qv0Iwu4H2e~kmG-w0WtLcUL*Z@Tmaj5h?;F`UzB5_vJMj_-LbSw_jmk`Uq;$T* z*ZoI+eYY`^sEs5Z&pjPE|2!-=!Y6CtlMnfNc%rnh8yc*JPE-RY$hsRjy1l-&{?pex zU)3VfM&xuYa{6(k9ywq7n3S_Uvo%w>Uk{Bv35+%UBu_H{0(}o=HfNqoy$xx!CXMdQ z*QN0%(!%d*BQ{ry&DCQIdmI}Oo1{l^kMs(O>s7;QI>2kQjm4|BnBQ^2p9*`Ke*$;w)rR4|N&1`irQSUvo;ctq4j95lZK-doV JiZZve{{TC6?9%`M literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/entrypoints.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/entrypoints.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b92e064627ee7c3d88314b336ffc8797b298040a GIT binary patch literal 3988 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/filesystem.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/filesystem.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..30040ae5c0342dbabd116f02df7b9709aae8b306 GIT binary patch literal 7347 zcmcgxeQXnHdVj|rk3SQ~`5*~jnLr@%LJ}abz;=OS6CiYRu*b*2TDNr_&)6Bq_W0hJ zU>rHy>=u=H7aie_JA&>cyb{s|vDNWUrE68`ZkMWBsr@6ttTsEFZC5I-y8n3zQYq>m zeV!SQ?SOl$>Z(rU_w#wbpWp9!-Z%eHSLY(|efxvEksme@@-LV%KfMMrE0-8TZV-V8 zOq>Lamu7o?_PIv;IL|vdR zQ6H#JcmrO&-WG32_yRsX&BYrNO@SsoZI3r6S^_PQc8F^Pr`Q@{1=l4u&?a(viCc6* zsYi4RjKD;!?J(&GCwMNgcS~ytv|EUUh%G{$Q2&wluEi)8nb_`5sO~K3e8Z%mul9)3R)oFSyOTi)NHDf zY=!*h4C8P61}ApH&uH~wIjM>l)kG*6ii#9U8c&20qHsn`q+}YRnWIu%^mCf^a5AGg zUXzkgbo`{|JSHYZ8d7Ddu_KbAYPPdUNlt2PIHai1i6<(m!Bj{c3rUQf{WqeL786 zN!HpY)Whe#su@-95Od|H8QW%}Hk#sHgjyN$Cdt^+QdO#1WQF3MX*Nj-jVhWwE?xvRR45Ka@fEy zQ=qN#1t~n%AC?8N|ND{>?(e%GCNK2IrP2OWMjexr1ARMp^(&Gp_NGGNaln$&pORAj zK?&dm1IGI&R4K0XM*vQ+CRI%Ir7~JWcuWkB8$glMfGEnt&|df{e-FVldBPEg`*QZ3 z>}>jhedF!uN2B-r54XO$c0kwdvdbGsk9`A1&g)ydrC``Ni4Kk)KJ&g$!2?$|azROr|_J6z;Q8=v2KZEB&R z>rrd_jm))7zWFx&F#SQg(AvMy(Es&@&fB{_-21`a4-b8C=-%$a=6$om%y4l7aeHTb z3a+)qjl|=7`ov4xIvx|o*ZIXdzG#K`nSy8X3F{u@$$j2AxZQex8v~)nji*C2s;t62 zYTGvWt^6b4{&m8DxlqfzAlL*(E#p6i9P!*2DQPIrrXzQ%BF;kVcf<>_Yip?^& znV&Fw$dpAbbA{?DOP9H3%IYLp>o2S~7zW}P9_VwQiEf6dsBQWeYcNxl7+Qllef~3B zo7}_@ClOfuGf~Wt47>UNX>1e8o5@b1Flh_on}NR!YaskDt%&l_7C6XLI@R+b9&ykc zm&Qe29*v1%l~2il6e$_yRT-+)L`oOolVF>$2(j7casev&Gh?DrCn4BA=#`s)|X>36e6d_Y#T#E_oIDDp^1tx&k;Vyrg1#p){JI zqVb z?St}{;HUf*1piK+0#P*+*ZLyiT-=hkdD&Bc^;quM)swlCb3+AB=Q0paI+y<3+p*~F z$g>6SmL+e?w@wf)x`^BNts7IsW7}Hv5SM$|*K&O<&lG%{X1Jn-b#7g1YGH{QDT*3W{UdA9sVJ2u7kPm60vUDN+0_pBoLU&_lc^LG!s2fLV$ z>wJT4){i^b*Lcgvn+G8MNvjjeKjHTbw%G2sSfS*8n{BYuet&}<%D+KEioy@Rg+qRe z)}W|zDyS<|5DqK^j!ilwsjG+$w-kZCatc}lsbORNtL4zd%8raFMZhTE#c|NZ5N#bWTAgLRAORB!5my3UXR8(5cx{vLapdJ1Ve4F9e1((8ub?TMKii>mbn9 z1XWQ{gXS!PAQ%L9$8RzG4=xp=fGq{>S{ZRKw4nQ-dKiAn1Oxy#4*^U?bJ44bTw-qM zVSVSaujxkXwbmOQ*E;ge1>e>gZprPNJ@ekdC65o#Hp4z~u4?jGeJ6C{a9vKnlb-E< zU~fl|W^$Ri=3miU>6__-w|l|S{m9*!?<%;v7ufC<7?`ZmX*_LRr~eH!^D+lFJ7$Uz zEbnoZvlgtT)((-k{)T|z%rXKS!&c9IGhBobY?mBWZMjO@=MCN@w4So6h${Vyl^uSw zgpgXJfa`8Gb!mzPm%5C!S{H&WTQx!rt*xr9p|g{K!zzgyEXJf0HOD#vhX6^>K z43$}z9qY=vvus5YjIf<0YT02IoMzp-47laxYl7*PUn!{Ns{xd;hAGcDOcU>SozQv= zk5sA1u+sGlVaoXL{d)um@4YTh4jVDZF%=D|#hp2exx!yC=zd*U$C3;| z7vv6e0?3-9;3CKgjSG*-QW&lQnx$`t#soD-D4rS%jf!f?{h!vY-!tc{QLxMxQ}p1Z zzc!NlUX9D)P+U3KR~G$Kn6`ox@KiUB4?0JF6S}?i!`=^i?>Ro-w12U4^aeL18>}ZPYHSSrrz%Eb(V@_| zlfhF%=T5<0C^&fP$l)_saOC{ph-M4NWkuAuiDX<#j%(hdKy^p-8boR>J%zU)#*RR}pWwB$=-&%g_{A=f8$KitSwVBtR zfP3K8y@yj*M$nNso;yA(TsiqgQ)_WEjQ*sDxEmK5j}=_Q3+(XICmo~#FEdWx7oLV? z@5aZ3bGASBkmmMc9i*NqxGNv8JIoEXTkf|z2Y1-+cR4WZXCTz<;I!i9FI>K}fH*=| zC(U_CAZbSNHc>L|Kw8zZAc0@S&;g0UZvF_`zsF5kr`ReYs6l{PxUW>`C2NV*xZ&uu z%Up6~ZA0XFk_GVWV@cMco7cZETz7>J@o~6m^D@}kQALhVsOS`{V_+yFC5t%Ga1@O+dyHG9C64as2prHiwJO&qQ9v+7vL`V7TiR0&c6*UtVd1XuluR9u- zN3k#5%DzEf3^0smW!1G<7Dnvi9EKNx&82Gtf2d#Q+ft7XWl> zG`rqLROmS71*rEY^rtAeD3uRh<0M5VO?<7w_slztt`G`hxO8Q5;x6lt zoiq%kxD*9hbDBJ|JJI91{PsI<&k7Ii>z2F?tDb2JZhnE~U)+{5ZQ!-5`cb6vd{ChY z(*m9*hT2*vx+nTn=qS#mYN`#Tm)XjUMUc3RQuy3BO_tqjuESH%&;HDC17DmPGLL>@ z_aI?7f&U9W`y+$TrYy*3Sr!;>2cXwhb#5$l``lOa+$>p}iQXwL%cy0x%a$Fa-wQM2*wi22&77ttpjb=knUZFn%Va;LEnP!~4PKXsl zSkj96^0mZJjd5uDKKvAf*fd#k*G~^EZ{%-9Z$|UNFB6Z6)#hJxtOZ<&vuBsuHUQ3? z{+Z$BwzaqHH|@7PH$C|?^ZN>IyJwCsc^a-CpOXsBJ&T^6+|ai+kStoEebGTY4b!i` zcxwL_3WW=JL7`eo3iaG#6CisX7mFUNp;d3^g+lALf_wV{yIr54zl*+!T_V;rJKWK5 zAL(H%!bdR8ReGv{S67M}r#Z|=82ueYi?x@Lt}FMOPlVQ{1his+;I#^R3AZVZql4R6%(YC;w!;^IMyHz0(u(hng# zv@*<>r2b3d)WfZfNG4*Xzo;M8L*TCtj<#T~@mpWBl6%{M=E_07{? zPu`gr2d1d}c besZyM*9zu~jSSP9x1xCOy!8o2`iA~D{5?3l literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/filetypes.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/filetypes.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..46e77c86839664bdb49ae74944732c349b74941f GIT binary patch literal 1159 zcmZ8fy>HV%6uvQ0d1^-@5@IR`Qp{1*_t_H3T0r>$9E5`_jMc6 zncSkRJ!`#xz7OxgXnX3Q0WfSbO;+LJlM87^xs2dQbgt94Hz85++!pN3Q za`t2sTUDolum~ybCki7IfUdV0$KiZ zL#z5Vq~QQX*l##iRkM5>X_uVP($og>8k*~@XhAco`rZlk_=FacF&+y{>$bUyLM?Ct z&2YR3Vb656dgQpFMvJ0fB2PX@GY^ikdUn4M2gV->_Nx?8o&-0`7--d>P1>(XP3RwygWpXRN@1}*n2DnJg zg9QF$PuG0A?xHjJ5INEzgwF}|SP0=y214$)0N}xI;MnKlfmWeAI@OZeeA`+((XKu# zY=EgABaAYw{Ns9iac!)<{N&*#5Fpc&!1&QuXFrUd`k#KPJ39TpWx6{&_R{MNPriB3 e87{recZQcffMQSJ;n3Px4-oNk{1+8z&3^%&8a7e@ literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/glibc.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/glibc.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..89142e8e32a396d5a796929dda0ed0f4acafae3d GIT binary patch literal 2414 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 K|DHg^Ci-9ZY^!Ym literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/logging.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/logging.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2abff749a6dab1dcf555a30ed7060c4423dca30d GIT binary patch literal 13552 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 b2$ZfIGtv(me$n|+tC3HRp%*oBA@F|ze3gv> literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/misc.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/misc.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2b733875b06afc25ab3e26aa2b8e4727586d9aff GIT binary patch literal 33554 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 T>6XVIa1?nEH?86|*6;rXhQy{V literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/packaging.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/packaging.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..9f394c91b8d2090712260ee5d803d56905722108 GIT binary patch literal 2578 zcmai0O>7fK6rS~O{F69@gpdg6B(wqpwt)x&QCo?oMIh0HlAKI~J=q=G8}`SYStmFO zQVtw?1gTPTsz9m)C>&a;ha7wF#gQw4mR6-|rK&f#K|OHloAIubBGj(p`F-=|z3;vE zO}_8$jwAT~{A8o_UKc{Yii!V4yutS0Fjzwx(i8*b+r5%kkIQ+;NSMidQb7SkLt2=2Zv@(RNgwqB)f*L2m{bcFW2G2xNTcZwH*Pw}=+} z5c>uBkV468@T#^hYa-A3k5V-`@_d1Xlu!Xa=Q&WE~8PWB4X3RK1Dy5_T#S zm-R(z;j7YT?756h;;0qMF~OrAXgt#v8O0rNvvH|yqDmMs{i71C348&MWgHO{Y?rWZ zIUF-uWt0Q-x>W|fZEaG4Fv%nfHp`g0C0mu*zCP^O7)$|skJ4;8i;KL@v%4d6ePV2` znD%XH2WbKqXIYIF|I?t{r`-g;T*AfI5~_$R1Q4|V4k?XGA_KkKW?w1Ubd*IQq;9gKXNEdV+|L9>cl2T<2wBYNmXYVVKu*i$^dg~vBjO?;^lI{4eb zfwj4NbN9y{o_lca$>g`euRm>`_@H@svN`bK>eREuP~+g)M&fKEbaoqbAsqo+X~m72 z-1iNZ}Q>;QCJT#K2w$4!-~ke#_G6@uc%Z4V`6E9Y50gV{0O#)N!vtm!K!0cv$&uH%eFGas8)zoGbz(msBvHs z6;cUGgi*m322rWjh85HTsz4@33P(=J>V!+YvgI|y!8)8WmPnmr!(O5c-T|t4H9A{? z%~H)$#akf+HJ~M3B@QSrG26t&V)bSjqQdPOQz4b^#t(es;Q--Vka7oUz?*&4ah9GPk+rW>JYnOy1pZcHL$+XlRphFva;c zs6hS@npRLzl;^1TIqG?iVn3r(O?2vabmk{C@k`%OWBB-^nP%Uq)zpjF@aKb1W5Zjq z;q`OP*xRd-R-|7Ue>QM%UA;Hg3X1XR@y+1o%x2d&IXQn3j%|lwy_H3Qfz_d>O8=J9 uzdrkeGTI76mBaUgEd<@8#9yM@4x+$ex!&rJDOZ)dY72>e-F_*1>Bv7#gS%k> literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/retry.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/retry.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..3e046d26d128076678dfd3d22500e8de7b983ff1 GIT binary patch literal 2103 zcma)6O>7fK6rR~1|K*2-qz(`gFD0#N32c6Zgb<2U0f+uYP*5u@Rc5n0ju+Ou+nF(r zQ9xFSgd-uUs)a^s45c)=OwFVT;sOZ4bS<4MLPt-^@BrNPFnm`)1#~ zw{PD2=9~9jPfrTL`190aDbNx6RVZsiT0mL74&qZ}BOAM@AZEqI6{Vn5)PjnIuDV)9 zFX)w6AtrUrjaL$d1V#!XF5`*PL`o7(Y`F$U7#@;xKvA zq-N!GK&%j-3GvBLtCmm&v-Bnhqmu&-058gE%4{v5lI;%hJls z3NcJNRjm+@GZ_p3c3i{ZVpqV186qQy&K+=doeEfFDAOtvJ7>IGCf>j8G7_uOz+{Zr zQ6{d*xIv~Z637~4l6Dj;dT&>ABoL=(h$A~4vD0%6mw{?Z3nt_sC8b@ank^zt=kiujG)>oU%Sz$ z6lTt<82Xww*8I84SeJCqfMlpM|jtH8Dq3YzzpU0%hP?odt1I-B?2>mXbtC zxc_tN406y6zKd@_?A;qK${3;tu)Msgxu72Q$hTsRnn6J9OM4^3QP+nn$i{QgI?Z(!o^u}-iM|cu zX#+h@pdBxNHrjlBWox>n=>5jS;mqy9<>7q`=?BC6mIwDeeKchJh17oI(a`RXuPme< z3>{cLbmIG=6D!+B9u01vAG`HND-PyotvDJOVuGnR;%Rj2rE&EeJg#PAVNy00-*;K4 zi^LdBg3~&jRFEvIMM$QFX&p`h{W(CBz5p*_yj|C&^nceYT0T1l;_n9fExGl>%v@%E z@Q37ROGzb-yZv9J@1$D@UYGXYKm7G!`T8w>B34#al*&lA);82PvYgnt3SkhCL9ixD zSf;7UV~#SE+X=FqJ7+`*>M}1X02Vc{y&xc$*3K>Z$S38`-@m(So`2-E5U5{nTiUgB z>Z`GPqfdm|dJ%OGG$!Z{_#)dwhhPddNiea2q+l51^#Hn1l#(D?I07We6@g1ObnD1k zB-5OD4Ei{uqDx40WdWgHa($D_?Cv4Clg#>A;%LRUt1cO*yWj)SCfIu*S}Ml)N7VNd z8iW7u=-@9}SM%7_Hyik&*3-1EPBd^UmcaunsVyy4%)4Ka^Ur!ub9x@n@1NJ^t}OSC a-cBs^FTA=ic&B%{H}^o#Ki0unZvPJnIt#l1 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/setuptools_build.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/setuptools_build.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2d250bbf0b44052c3693ccfac8a4105361f28d35 GIT binary patch literal 4545 zcmaJ_&2JmW72hS744vNTW-B@yKscECYpjO-=xz=)b zGrN>5l?LQCDCAr!pRC^8TMg%r=&?XABpRUV=1>Rir8gQfP#~wiH?#awo36F9^YPxB z_kQnVhW>LVla%0j{nMAFrDKxx4;-|gp|Ep!N0y{#k|7zgC9R0ByduLmVnwRam1tF2 zQL3?(m@GvkDnCfK1$4hg^d-o^=RsSl81nXI*k4fxB>ZQL8VVgSVpO3qI&d0R@ipQ! zX(ZrPX;jRXlE%Piv6WOv9nu=fHkXkCDZSL`&y1rPJYp(A&mZueU%cATi(KMnH zF(7_L_X*IEnnyk2JA~D2!g+G;mXH@p)yQq1m{r$dz9%TSRI)}(4x_}hH=K3TE_aw` zQ5v=NHH#9LIS*(N`1p2)$zWiG;=v9fm6VuMC94LQUGq)L%N0THDoWXO*gDxX{R*+^ zCS}Cci|cxsZ|3W^p)M!D0qrOH3@uZeGTrB>c@?wT<4ABYsel}dLyiHJE0)Td zV_RDt*9uvoCmnB=0Av^f>(n;4X_Bkxvn`=325(5(jZaQO9~LPXf1AhIE$%km6aMS6 zy3Dlw8BULq@R_)E@7~>ebL4&9<_2PF)O_0G8RD6cJiX9|e%Cj2)8b)j+GL_%D&oCX zGc5xmdBbFmU8T04o0#pRLTGPbgm^wg1nVwlJ7l;@ADaHmm8^iGP(ZFif!rV$87J!r zF_>(x3u?1O953hUeg&m?zBkie&vsEkfwo?yz1#vEB9f==jGW_AyDNbJz@@GjWZ_OJ zxLbvyW1zfJj#1s15%y5aqh0czT_>*VHQ&+Nfn@Yz9oC*Myhpc~;Mw1ehQ9cCSBRR) zP6#~u3SXb3Ssv&J!z`IVvWcwF8pC~l{;lWytggi2f)s=c% zLWE07rwX;jAW#Ksm;|1PDPAcyneMtY^tY%qSOAMU9$h)% zvN>00dRSC2vJlNVsBLgKKo6@t2O3Tt?5{zU7D7c`3Ay{hpCdmo3{xDBL@bfeFMVA7 zE}A2^OJteVAVA=#!Myi~OPPmZ*e=LX||)G4jR&kBY~0d--=L6$fY^8H47uBpr+;TRGQHr4T6B^;b@3}0xf7l1D{wDaL1h?jy4 zSE-Y&LvShZO`AKm0N0TJos-vr6LK=l9!aW8b=i==h`hv%g@!_5zc%Y6wxBsNPiAK`#o%vQ=iVf`E-=BY;Z=|m_m8(1Ri10#FISoC; zjEw+qv9|(s>eM^1@_#Xj)FTF964n|R2^`o-U<_h-4YRjnng$mvhFA71)HC=9khsMN zE`+GC_smgyxd375TR?apUhgtAV5#~omi~ON+(?f%mGNHdg1F0Q$$S_nmjhsO7lZ1H4EW)b+MiO%v8&0RaP#3;_3+JCn_^QsfFL7JA!P?t&$PwFsDK^;j_;KlLbO=yk; zF#0VF_D9ir)QE&fVYDuTN1_INLyy2J9*&Dynb+1pZSS|8)HLX8YdREd9@mP1cnY=? zb(mv{YIFg8>nNaYaRSk4ApQ-!-Zf|-z>^T*&+q^7=9j5^JM*s~Wmk6ZG?h~b-3VfG zZol3bo^7hLyGj?6Y;^I153<7ye{u(^PapbtpayY&%Y|D!LrfTI#W2o;xIqm#)Zwn; z`S9z54dP@J`hl_rza4qGVpw7rW*=;Yq_p1t?5JKaiPPnAxcYauag z5l`+;KK}SHg`@8bh5YbE{-vi2tr+xy6-Mtrz0peGNR>{UZVh0s%Z{TdHDrfxhaLLB z9`2IB(TTGm8GKQxxA;B@9I2?{0QQnnW^8Zi$wDiIqqLM7*}L{cYh`dWD2<+K4PkG% kE%+FYuBSu6@O^ds%>K2fS}O+q&~oglA;X&i7;&Hc2R4G!LI3~& literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/subprocess.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/subprocess.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..dcc59046f1581eedaafdbbbcdacbedea4229c50d GIT binary patch literal 8659 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 V2P+7QzYgDum39w2!ga#I{{^6X8`J;* literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/temp_dir.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/temp_dir.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..7b937bbff2fec3b5edd7fc5208ac8f1ff3f2ff95 GIT binary patch literal 12057 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 TiyH`v+P(<9m){^LY<>O@w5C-- literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/wheel.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/utils/__pycache__/wheel.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c1e6594dcc20d812beb9ce1e86a4bc088da603b6 GIT binary patch literal 5894 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 list(yield_lines('')) + [] + >>> list(yield_lines(['foo', 'bar'])) + ['foo', 'bar'] + >>> list(yield_lines('foo\nbar')) + ['foo', 'bar'] + >>> list(yield_lines('\nfoo\n#bar\nbaz #comment')) + ['foo', 'baz #comment'] + >>> list(yield_lines(['foo\nbar', 'baz', 'bing\n\n\n'])) + ['foo', 'bar', 'baz', 'bing'] + """ + return itertools.chain.from_iterable(map(yield_lines, iterable)) + + +@yield_lines.register(str) +def _(text): + return filter(_nonblank, map(str.strip, text.splitlines())) + + +def drop_comment(line): + """ + Drop comments. + + >>> drop_comment('foo # bar') + 'foo' + + A hash without a space may be in a URL. + + >>> drop_comment('http://example.com/foo#bar') + 'http://example.com/foo#bar' + """ + return line.partition(" #")[0] + + +def join_continuation(lines): + r""" + Join lines continued by a trailing backslash. + + >>> list(join_continuation(['foo \\', 'bar', 'baz'])) + ['foobar', 'baz'] + >>> list(join_continuation(['foo \\', 'bar', 'baz'])) + ['foobar', 'baz'] + >>> list(join_continuation(['foo \\', 'bar \\', 'baz'])) + ['foobarbaz'] + + Not sure why, but... + The character preceding the backslash is also elided. + + >>> list(join_continuation(['goo\\', 'dly'])) + ['godly'] + + A terrible idea, but... + If no line is available to continue, suppress the lines. + + >>> list(join_continuation(['foo', 'bar\\', 'baz\\'])) + ['foo'] + """ + lines = iter(lines) + for item in lines: + while item.endswith("\\"): + try: + item = item[:-2].strip() + next(lines) + except StopIteration: + return + yield item diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/_log.py b/.venv/lib/python3.12/site-packages/pip/_internal/utils/_log.py new file mode 100644 index 0000000..92c4c6a --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/utils/_log.py @@ -0,0 +1,38 @@ +"""Customize logging + +Defines custom logger class for the `logger.verbose(...)` method. + +init_logging() must be called before any other modules that call logging.getLogger. +""" + +import logging +from typing import Any, cast + +# custom log level for `--verbose` output +# between DEBUG and INFO +VERBOSE = 15 + + +class VerboseLogger(logging.Logger): + """Custom Logger, defining a verbose log-level + + VERBOSE is between INFO and DEBUG. + """ + + def verbose(self, msg: str, *args: Any, **kwargs: Any) -> None: + return self.log(VERBOSE, msg, *args, **kwargs) + + +def getLogger(name: str) -> VerboseLogger: + """logging.getLogger, but ensures our VerboseLogger class is returned""" + return cast(VerboseLogger, logging.getLogger(name)) + + +def init_logging() -> None: + """Register our VerboseLogger and VERBOSE log level. + + Should be called before any calls to getLogger(), + i.e. in pip._internal.__init__ + """ + logging.setLoggerClass(VerboseLogger) + logging.addLevelName(VERBOSE, "VERBOSE") diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/appdirs.py b/.venv/lib/python3.12/site-packages/pip/_internal/utils/appdirs.py new file mode 100644 index 0000000..16933bf --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/utils/appdirs.py @@ -0,0 +1,52 @@ +""" +This code wraps the vendored appdirs module to so the return values are +compatible for the current pip code base. + +The intention is to rewrite current usages gradually, keeping the tests pass, +and eventually drop this after all usages are changed. +""" + +import os +import sys +from typing import List + +from pip._vendor import platformdirs as _appdirs + + +def user_cache_dir(appname: str) -> str: + return _appdirs.user_cache_dir(appname, appauthor=False) + + +def _macos_user_config_dir(appname: str, roaming: bool = True) -> str: + # Use ~/Application Support/pip, if the directory exists. + path = _appdirs.user_data_dir(appname, appauthor=False, roaming=roaming) + if os.path.isdir(path): + return path + + # Use a Linux-like ~/.config/pip, by default. + linux_like_path = "~/.config/" + if appname: + linux_like_path = os.path.join(linux_like_path, appname) + + return os.path.expanduser(linux_like_path) + + +def user_config_dir(appname: str, roaming: bool = True) -> str: + if sys.platform == "darwin": + return _macos_user_config_dir(appname, roaming) + + return _appdirs.user_config_dir(appname, appauthor=False, roaming=roaming) + + +# for the discussion regarding site_config_dir locations +# see +def site_config_dirs(appname: str) -> List[str]: + if sys.platform == "darwin": + return [_appdirs.site_data_dir(appname, appauthor=False, multipath=True)] + + dirval = _appdirs.site_config_dir(appname, appauthor=False, multipath=True) + if sys.platform == "win32": + return [dirval] + + # Unix-y system. Look in /etc as well. + return dirval.split(os.pathsep) + ["/etc"] diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/compat.py b/.venv/lib/python3.12/site-packages/pip/_internal/utils/compat.py new file mode 100644 index 0000000..d8b54e4 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/utils/compat.py @@ -0,0 +1,79 @@ +"""Stuff that differs in different Python versions and platform +distributions.""" + +import importlib.resources +import logging +import os +import sys +from typing import IO + +__all__ = ["get_path_uid", "stdlib_pkgs", "WINDOWS"] + + +logger = logging.getLogger(__name__) + + +def has_tls() -> bool: + try: + import _ssl # noqa: F401 # ignore unused + + return True + except ImportError: + pass + + from pip._vendor.urllib3.util import IS_PYOPENSSL + + return IS_PYOPENSSL + + +def get_path_uid(path: str) -> int: + """ + Return path's uid. + + Does not follow symlinks: + https://github.com/pypa/pip/pull/935#discussion_r5307003 + + Placed this function in compat due to differences on AIX and + Jython, that should eventually go away. + + :raises OSError: When path is a symlink or can't be read. + """ + if hasattr(os, "O_NOFOLLOW"): + fd = os.open(path, os.O_RDONLY | os.O_NOFOLLOW) + file_uid = os.fstat(fd).st_uid + os.close(fd) + else: # AIX and Jython + # WARNING: time of check vulnerability, but best we can do w/o NOFOLLOW + if not os.path.islink(path): + # older versions of Jython don't have `os.fstat` + file_uid = os.stat(path).st_uid + else: + # raise OSError for parity with os.O_NOFOLLOW above + raise OSError(f"{path} is a symlink; Will not return uid for symlinks") + return file_uid + + +# The importlib.resources.open_text function was deprecated in 3.11 with suggested +# replacement we use below. +if sys.version_info < (3, 11): + open_text_resource = importlib.resources.open_text +else: + + def open_text_resource( + package: str, resource: str, encoding: str = "utf-8", errors: str = "strict" + ) -> IO[str]: + return (importlib.resources.files(package) / resource).open( + "r", encoding=encoding, errors=errors + ) + + +# packages in the stdlib that may have installation metadata, but should not be +# considered 'installed'. this theoretically could be determined based on +# dist.location (py27:`sysconfig.get_paths()['stdlib']`, +# py26:sysconfig.get_config_vars('LIBDEST')), but fear platform variation may +# make this ineffective, so hard-coding +stdlib_pkgs = {"python", "wsgiref", "argparse"} + + +# windows detection, covers cpython and ironpython +WINDOWS = sys.platform.startswith("win") or (sys.platform == "cli" and os.name == "nt") diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/compatibility_tags.py b/.venv/lib/python3.12/site-packages/pip/_internal/utils/compatibility_tags.py new file mode 100644 index 0000000..b6ed9a7 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/utils/compatibility_tags.py @@ -0,0 +1,165 @@ +"""Generate and work with PEP 425 Compatibility Tags. +""" + +import re +from typing import List, Optional, Tuple + +from pip._vendor.packaging.tags import ( + PythonVersion, + Tag, + compatible_tags, + cpython_tags, + generic_tags, + interpreter_name, + interpreter_version, + mac_platforms, +) + +_osx_arch_pat = re.compile(r"(.+)_(\d+)_(\d+)_(.+)") + + +def version_info_to_nodot(version_info: Tuple[int, ...]) -> str: + # Only use up to the first two numbers. + return "".join(map(str, version_info[:2])) + + +def _mac_platforms(arch: str) -> List[str]: + match = _osx_arch_pat.match(arch) + if match: + name, major, minor, actual_arch = match.groups() + mac_version = (int(major), int(minor)) + arches = [ + # Since we have always only checked that the platform starts + # with "macosx", for backwards-compatibility we extract the + # actual prefix provided by the user in case they provided + # something like "macosxcustom_". It may be good to remove + # this as undocumented or deprecate it in the future. + "{}_{}".format(name, arch[len("macosx_") :]) + for arch in mac_platforms(mac_version, actual_arch) + ] + else: + # arch pattern didn't match (?!) + arches = [arch] + return arches + + +def _custom_manylinux_platforms(arch: str) -> List[str]: + arches = [arch] + arch_prefix, arch_sep, arch_suffix = arch.partition("_") + if arch_prefix == "manylinux2014": + # manylinux1/manylinux2010 wheels run on most manylinux2014 systems + # with the exception of wheels depending on ncurses. PEP 599 states + # manylinux1/manylinux2010 wheels should be considered + # manylinux2014 wheels: + # https://www.python.org/dev/peps/pep-0599/#backwards-compatibility-with-manylinux2010-wheels + if arch_suffix in {"i686", "x86_64"}: + arches.append("manylinux2010" + arch_sep + arch_suffix) + arches.append("manylinux1" + arch_sep + arch_suffix) + elif arch_prefix == "manylinux2010": + # manylinux1 wheels run on most manylinux2010 systems with the + # exception of wheels depending on ncurses. PEP 571 states + # manylinux1 wheels should be considered manylinux2010 wheels: + # https://www.python.org/dev/peps/pep-0571/#backwards-compatibility-with-manylinux1-wheels + arches.append("manylinux1" + arch_sep + arch_suffix) + return arches + + +def _get_custom_platforms(arch: str) -> List[str]: + arch_prefix, arch_sep, arch_suffix = arch.partition("_") + if arch.startswith("macosx"): + arches = _mac_platforms(arch) + elif arch_prefix in ["manylinux2014", "manylinux2010"]: + arches = _custom_manylinux_platforms(arch) + else: + arches = [arch] + return arches + + +def _expand_allowed_platforms(platforms: Optional[List[str]]) -> Optional[List[str]]: + if not platforms: + return None + + seen = set() + result = [] + + for p in platforms: + if p in seen: + continue + additions = [c for c in _get_custom_platforms(p) if c not in seen] + seen.update(additions) + result.extend(additions) + + return result + + +def _get_python_version(version: str) -> PythonVersion: + if len(version) > 1: + return int(version[0]), int(version[1:]) + else: + return (int(version[0]),) + + +def _get_custom_interpreter( + implementation: Optional[str] = None, version: Optional[str] = None +) -> str: + if implementation is None: + implementation = interpreter_name() + if version is None: + version = interpreter_version() + return f"{implementation}{version}" + + +def get_supported( + version: Optional[str] = None, + platforms: Optional[List[str]] = None, + impl: Optional[str] = None, + abis: Optional[List[str]] = None, +) -> List[Tag]: + """Return a list of supported tags for each version specified in + `versions`. + + :param version: a string version, of the form "33" or "32", + or None. The version will be assumed to support our ABI. + :param platform: specify a list of platforms you want valid + tags for, or None. If None, use the local system platform. + :param impl: specify the exact implementation you want valid + tags for, or None. If None, use the local interpreter impl. + :param abis: specify a list of abis you want valid + tags for, or None. If None, use the local interpreter abi. + """ + supported: List[Tag] = [] + + python_version: Optional[PythonVersion] = None + if version is not None: + python_version = _get_python_version(version) + + interpreter = _get_custom_interpreter(impl, version) + + platforms = _expand_allowed_platforms(platforms) + + is_cpython = (impl or interpreter_name()) == "cp" + if is_cpython: + supported.extend( + cpython_tags( + python_version=python_version, + abis=abis, + platforms=platforms, + ) + ) + else: + supported.extend( + generic_tags( + interpreter=interpreter, + abis=abis, + platforms=platforms, + ) + ) + supported.extend( + compatible_tags( + python_version=python_version, + interpreter=interpreter, + platforms=platforms, + ) + ) + + return supported diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/datetime.py b/.venv/lib/python3.12/site-packages/pip/_internal/utils/datetime.py new file mode 100644 index 0000000..8668b3b --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/utils/datetime.py @@ -0,0 +1,11 @@ +"""For when pip wants to check the date or time. +""" + +import datetime + + +def today_is_later_than(year: int, month: int, day: int) -> bool: + today = datetime.date.today() + given = datetime.date(year, month, day) + + return today > given diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/deprecation.py b/.venv/lib/python3.12/site-packages/pip/_internal/utils/deprecation.py new file mode 100644 index 0000000..0911147 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/utils/deprecation.py @@ -0,0 +1,124 @@ +""" +A module that implements tooling to enable easy warnings about deprecations. +""" + +import logging +import warnings +from typing import Any, Optional, TextIO, Type, Union + +from pip._vendor.packaging.version import parse + +from pip import __version__ as current_version # NOTE: tests patch this name. + +DEPRECATION_MSG_PREFIX = "DEPRECATION: " + + +class PipDeprecationWarning(Warning): + pass + + +_original_showwarning: Any = None + + +# Warnings <-> Logging Integration +def _showwarning( + message: Union[Warning, str], + category: Type[Warning], + filename: str, + lineno: int, + file: Optional[TextIO] = None, + line: Optional[str] = None, +) -> None: + if file is not None: + if _original_showwarning is not None: + _original_showwarning(message, category, filename, lineno, file, line) + elif issubclass(category, PipDeprecationWarning): + # We use a specially named logger which will handle all of the + # deprecation messages for pip. + logger = logging.getLogger("pip._internal.deprecations") + logger.warning(message) + else: + _original_showwarning(message, category, filename, lineno, file, line) + + +def install_warning_logger() -> None: + # Enable our Deprecation Warnings + warnings.simplefilter("default", PipDeprecationWarning, append=True) + + global _original_showwarning + + if _original_showwarning is None: + _original_showwarning = warnings.showwarning + warnings.showwarning = _showwarning + + +def deprecated( + *, + reason: str, + replacement: Optional[str], + gone_in: Optional[str], + feature_flag: Optional[str] = None, + issue: Optional[int] = None, +) -> None: + """Helper to deprecate existing functionality. + + reason: + Textual reason shown to the user about why this functionality has + been deprecated. Should be a complete sentence. + replacement: + Textual suggestion shown to the user about what alternative + functionality they can use. + gone_in: + The version of pip does this functionality should get removed in. + Raises an error if pip's current version is greater than or equal to + this. + feature_flag: + Command-line flag of the form --use-feature={feature_flag} for testing + upcoming functionality. + issue: + Issue number on the tracker that would serve as a useful place for + users to find related discussion and provide feedback. + """ + + # Determine whether or not the feature is already gone in this version. + is_gone = gone_in is not None and parse(current_version) >= parse(gone_in) + + message_parts = [ + (reason, f"{DEPRECATION_MSG_PREFIX}{{}}"), + ( + gone_in, + ( + "pip {} will enforce this behaviour change." + if not is_gone + else "Since pip {}, this is no longer supported." + ), + ), + ( + replacement, + "A possible replacement is {}.", + ), + ( + feature_flag, + ( + "You can use the flag --use-feature={} to test the upcoming behaviour." + if not is_gone + else None + ), + ), + ( + issue, + "Discussion can be found at https://github.com/pypa/pip/issues/{}", + ), + ] + + message = " ".join( + format_str.format(value) + for value, format_str in message_parts + if format_str is not None and value is not None + ) + + # Raise as an error if this behaviour is deprecated. + if is_gone: + raise PipDeprecationWarning(message) + + warnings.warn(message, category=PipDeprecationWarning, stacklevel=2) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/direct_url_helpers.py b/.venv/lib/python3.12/site-packages/pip/_internal/utils/direct_url_helpers.py new file mode 100644 index 0000000..66020d3 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/utils/direct_url_helpers.py @@ -0,0 +1,87 @@ +from typing import Optional + +from pip._internal.models.direct_url import ArchiveInfo, DirectUrl, DirInfo, VcsInfo +from pip._internal.models.link import Link +from pip._internal.utils.urls import path_to_url +from pip._internal.vcs import vcs + + +def direct_url_as_pep440_direct_reference(direct_url: DirectUrl, name: str) -> str: + """Convert a DirectUrl to a pip requirement string.""" + direct_url.validate() # if invalid, this is a pip bug + requirement = name + " @ " + fragments = [] + if isinstance(direct_url.info, VcsInfo): + requirement += ( + f"{direct_url.info.vcs}+{direct_url.url}@{direct_url.info.commit_id}" + ) + elif isinstance(direct_url.info, ArchiveInfo): + requirement += direct_url.url + if direct_url.info.hash: + fragments.append(direct_url.info.hash) + else: + assert isinstance(direct_url.info, DirInfo) + requirement += direct_url.url + if direct_url.subdirectory: + fragments.append("subdirectory=" + direct_url.subdirectory) + if fragments: + requirement += "#" + "&".join(fragments) + return requirement + + +def direct_url_for_editable(source_dir: str) -> DirectUrl: + return DirectUrl( + url=path_to_url(source_dir), + info=DirInfo(editable=True), + ) + + +def direct_url_from_link( + link: Link, source_dir: Optional[str] = None, link_is_in_wheel_cache: bool = False +) -> DirectUrl: + if link.is_vcs: + vcs_backend = vcs.get_backend_for_scheme(link.scheme) + assert vcs_backend + url, requested_revision, _ = vcs_backend.get_url_rev_and_auth( + link.url_without_fragment + ) + # For VCS links, we need to find out and add commit_id. + if link_is_in_wheel_cache: + # If the requested VCS link corresponds to a cached + # wheel, it means the requested revision was an + # immutable commit hash, otherwise it would not have + # been cached. In that case we don't have a source_dir + # with the VCS checkout. + assert requested_revision + commit_id = requested_revision + else: + # If the wheel was not in cache, it means we have + # had to checkout from VCS to build and we have a source_dir + # which we can inspect to find out the commit id. + assert source_dir + commit_id = vcs_backend.get_revision(source_dir) + return DirectUrl( + url=url, + info=VcsInfo( + vcs=vcs_backend.name, + commit_id=commit_id, + requested_revision=requested_revision, + ), + subdirectory=link.subdirectory_fragment, + ) + elif link.is_existing_dir(): + return DirectUrl( + url=link.url_without_fragment, + info=DirInfo(), + subdirectory=link.subdirectory_fragment, + ) + else: + hash = None + hash_name = link.hash_name + if hash_name: + hash = f"{hash_name}={link.hash}" + return DirectUrl( + url=link.url_without_fragment, + info=ArchiveInfo(hash=hash), + subdirectory=link.subdirectory_fragment, + ) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/egg_link.py b/.venv/lib/python3.12/site-packages/pip/_internal/utils/egg_link.py new file mode 100644 index 0000000..4a384a6 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/utils/egg_link.py @@ -0,0 +1,80 @@ +import os +import re +import sys +from typing import List, Optional + +from pip._internal.locations import site_packages, user_site +from pip._internal.utils.virtualenv import ( + running_under_virtualenv, + virtualenv_no_global, +) + +__all__ = [ + "egg_link_path_from_sys_path", + "egg_link_path_from_location", +] + + +def _egg_link_names(raw_name: str) -> List[str]: + """ + Convert a Name metadata value to a .egg-link name, by applying + the same substitution as pkg_resources's safe_name function. + Note: we cannot use canonicalize_name because it has a different logic. + + We also look for the raw name (without normalization) as setuptools 69 changed + the way it names .egg-link files (https://github.com/pypa/setuptools/issues/4167). + """ + return [ + re.sub("[^A-Za-z0-9.]+", "-", raw_name) + ".egg-link", + f"{raw_name}.egg-link", + ] + + +def egg_link_path_from_sys_path(raw_name: str) -> Optional[str]: + """ + Look for a .egg-link file for project name, by walking sys.path. + """ + egg_link_names = _egg_link_names(raw_name) + for path_item in sys.path: + for egg_link_name in egg_link_names: + egg_link = os.path.join(path_item, egg_link_name) + if os.path.isfile(egg_link): + return egg_link + return None + + +def egg_link_path_from_location(raw_name: str) -> Optional[str]: + """ + Return the path for the .egg-link file if it exists, otherwise, None. + + There's 3 scenarios: + 1) not in a virtualenv + try to find in site.USER_SITE, then site_packages + 2) in a no-global virtualenv + try to find in site_packages + 3) in a yes-global virtualenv + try to find in site_packages, then site.USER_SITE + (don't look in global location) + + For #1 and #3, there could be odd cases, where there's an egg-link in 2 + locations. + + This method will just return the first one found. + """ + sites: List[str] = [] + if running_under_virtualenv(): + sites.append(site_packages) + if not virtualenv_no_global() and user_site: + sites.append(user_site) + else: + if user_site: + sites.append(user_site) + sites.append(site_packages) + + egg_link_names = _egg_link_names(raw_name) + for site in sites: + for egg_link_name in egg_link_names: + egglink = os.path.join(site, egg_link_name) + if os.path.isfile(egglink): + return egglink + return None diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/encoding.py b/.venv/lib/python3.12/site-packages/pip/_internal/utils/encoding.py new file mode 100644 index 0000000..008f06a --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/utils/encoding.py @@ -0,0 +1,36 @@ +import codecs +import locale +import re +import sys +from typing import List, Tuple + +BOMS: List[Tuple[bytes, str]] = [ + (codecs.BOM_UTF8, "utf-8"), + (codecs.BOM_UTF16, "utf-16"), + (codecs.BOM_UTF16_BE, "utf-16-be"), + (codecs.BOM_UTF16_LE, "utf-16-le"), + (codecs.BOM_UTF32, "utf-32"), + (codecs.BOM_UTF32_BE, "utf-32-be"), + (codecs.BOM_UTF32_LE, "utf-32-le"), +] + +ENCODING_RE = re.compile(rb"coding[:=]\s*([-\w.]+)") + + +def auto_decode(data: bytes) -> str: + """Check a bytes string for a BOM to correctly detect the encoding + + Fallback to locale.getpreferredencoding(False) like open() on Python3""" + for bom, encoding in BOMS: + if data.startswith(bom): + return data[len(bom) :].decode(encoding) + # Lets check the first two lines as in PEP263 + for line in data.split(b"\n")[:2]: + if line[0:1] == b"#" and ENCODING_RE.search(line): + result = ENCODING_RE.search(line) + assert result is not None + encoding = result.groups()[0].decode("ascii") + return data.decode(encoding) + return data.decode( + locale.getpreferredencoding(False) or sys.getdefaultencoding(), + ) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/entrypoints.py b/.venv/lib/python3.12/site-packages/pip/_internal/utils/entrypoints.py new file mode 100644 index 0000000..1501369 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/utils/entrypoints.py @@ -0,0 +1,84 @@ +import itertools +import os +import shutil +import sys +from typing import List, Optional + +from pip._internal.cli.main import main +from pip._internal.utils.compat import WINDOWS + +_EXECUTABLE_NAMES = [ + "pip", + f"pip{sys.version_info.major}", + f"pip{sys.version_info.major}.{sys.version_info.minor}", +] +if WINDOWS: + _allowed_extensions = {"", ".exe"} + _EXECUTABLE_NAMES = [ + "".join(parts) + for parts in itertools.product(_EXECUTABLE_NAMES, _allowed_extensions) + ] + + +def _wrapper(args: Optional[List[str]] = None) -> int: + """Central wrapper for all old entrypoints. + + Historically pip has had several entrypoints defined. Because of issues + arising from PATH, sys.path, multiple Pythons, their interactions, and most + of them having a pip installed, users suffer every time an entrypoint gets + moved. + + To alleviate this pain, and provide a mechanism for warning users and + directing them to an appropriate place for help, we now define all of + our old entrypoints as wrappers for the current one. + """ + sys.stderr.write( + "WARNING: pip is being invoked by an old script wrapper. This will " + "fail in a future version of pip.\n" + "Please see https://github.com/pypa/pip/issues/5599 for advice on " + "fixing the underlying issue.\n" + "To avoid this problem you can invoke Python with '-m pip' instead of " + "running pip directly.\n" + ) + return main(args) + + +def get_best_invocation_for_this_pip() -> str: + """Try to figure out the best way to invoke pip in the current environment.""" + binary_directory = "Scripts" if WINDOWS else "bin" + binary_prefix = os.path.join(sys.prefix, binary_directory) + + # Try to use pip[X[.Y]] names, if those executables for this environment are + # the first on PATH with that name. + path_parts = os.path.normcase(os.environ.get("PATH", "")).split(os.pathsep) + exe_are_in_PATH = os.path.normcase(binary_prefix) in path_parts + if exe_are_in_PATH: + for exe_name in _EXECUTABLE_NAMES: + found_executable = shutil.which(exe_name) + binary_executable = os.path.join(binary_prefix, exe_name) + if ( + found_executable + and os.path.exists(binary_executable) + and os.path.samefile( + found_executable, + binary_executable, + ) + ): + return exe_name + + # Use the `-m` invocation, if there's no "nice" invocation. + return f"{get_best_invocation_for_this_python()} -m pip" + + +def get_best_invocation_for_this_python() -> str: + """Try to figure out the best way to invoke the current Python.""" + exe = sys.executable + exe_name = os.path.basename(exe) + + # Try to use the basename, if it's the first executable. + found_executable = shutil.which(exe_name) + if found_executable and os.path.samefile(found_executable, exe): + return exe_name + + # Use the full executable name, because we couldn't find something simpler. + return exe diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/filesystem.py b/.venv/lib/python3.12/site-packages/pip/_internal/utils/filesystem.py new file mode 100644 index 0000000..22e356c --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/utils/filesystem.py @@ -0,0 +1,149 @@ +import fnmatch +import os +import os.path +import random +import sys +from contextlib import contextmanager +from tempfile import NamedTemporaryFile +from typing import Any, BinaryIO, Generator, List, Union, cast + +from pip._internal.utils.compat import get_path_uid +from pip._internal.utils.misc import format_size +from pip._internal.utils.retry import retry + + +def check_path_owner(path: str) -> bool: + # If we don't have a way to check the effective uid of this process, then + # we'll just assume that we own the directory. + if sys.platform == "win32" or not hasattr(os, "geteuid"): + return True + + assert os.path.isabs(path) + + previous = None + while path != previous: + if os.path.lexists(path): + # Check if path is writable by current user. + if os.geteuid() == 0: + # Special handling for root user in order to handle properly + # cases where users use sudo without -H flag. + try: + path_uid = get_path_uid(path) + except OSError: + return False + return path_uid == 0 + else: + return os.access(path, os.W_OK) + else: + previous, path = path, os.path.dirname(path) + return False # assume we don't own the path + + +@contextmanager +def adjacent_tmp_file(path: str, **kwargs: Any) -> Generator[BinaryIO, None, None]: + """Return a file-like object pointing to a tmp file next to path. + + The file is created securely and is ensured to be written to disk + after the context reaches its end. + + kwargs will be passed to tempfile.NamedTemporaryFile to control + the way the temporary file will be opened. + """ + with NamedTemporaryFile( + delete=False, + dir=os.path.dirname(path), + prefix=os.path.basename(path), + suffix=".tmp", + **kwargs, + ) as f: + result = cast(BinaryIO, f) + try: + yield result + finally: + result.flush() + os.fsync(result.fileno()) + + +replace = retry(stop_after_delay=1, wait=0.25)(os.replace) + + +# test_writable_dir and _test_writable_dir_win are copied from Flit, +# with the author's agreement to also place them under pip's license. +def test_writable_dir(path: str) -> bool: + """Check if a directory is writable. + + Uses os.access() on POSIX, tries creating files on Windows. + """ + # If the directory doesn't exist, find the closest parent that does. + while not os.path.isdir(path): + parent = os.path.dirname(path) + if parent == path: + break # Should never get here, but infinite loops are bad + path = parent + + if os.name == "posix": + return os.access(path, os.W_OK) + + return _test_writable_dir_win(path) + + +def _test_writable_dir_win(path: str) -> bool: + # os.access doesn't work on Windows: http://bugs.python.org/issue2528 + # and we can't use tempfile: http://bugs.python.org/issue22107 + basename = "accesstest_deleteme_fishfingers_custard_" + alphabet = "abcdefghijklmnopqrstuvwxyz0123456789" + for _ in range(10): + name = basename + "".join(random.choice(alphabet) for _ in range(6)) + file = os.path.join(path, name) + try: + fd = os.open(file, os.O_RDWR | os.O_CREAT | os.O_EXCL) + except FileExistsError: + pass + except PermissionError: + # This could be because there's a directory with the same name. + # But it's highly unlikely there's a directory called that, + # so we'll assume it's because the parent dir is not writable. + # This could as well be because the parent dir is not readable, + # due to non-privileged user access. + return False + else: + os.close(fd) + os.unlink(file) + return True + + # This should never be reached + raise OSError("Unexpected condition testing for writable directory") + + +def find_files(path: str, pattern: str) -> List[str]: + """Returns a list of absolute paths of files beneath path, recursively, + with filenames which match the UNIX-style shell glob pattern.""" + result: List[str] = [] + for root, _, files in os.walk(path): + matches = fnmatch.filter(files, pattern) + result.extend(os.path.join(root, f) for f in matches) + return result + + +def file_size(path: str) -> Union[int, float]: + # If it's a symlink, return 0. + if os.path.islink(path): + return 0 + return os.path.getsize(path) + + +def format_file_size(path: str) -> str: + return format_size(file_size(path)) + + +def directory_size(path: str) -> Union[int, float]: + size = 0.0 + for root, _dirs, files in os.walk(path): + for filename in files: + file_path = os.path.join(root, filename) + size += file_size(file_path) + return size + + +def format_directory_size(path: str) -> str: + return format_size(directory_size(path)) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/filetypes.py b/.venv/lib/python3.12/site-packages/pip/_internal/utils/filetypes.py new file mode 100644 index 0000000..5948570 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/utils/filetypes.py @@ -0,0 +1,27 @@ +"""Filetype information. +""" + +from typing import Tuple + +from pip._internal.utils.misc import splitext + +WHEEL_EXTENSION = ".whl" +BZ2_EXTENSIONS: Tuple[str, ...] = (".tar.bz2", ".tbz") +XZ_EXTENSIONS: Tuple[str, ...] = ( + ".tar.xz", + ".txz", + ".tlz", + ".tar.lz", + ".tar.lzma", +) +ZIP_EXTENSIONS: Tuple[str, ...] = (".zip", WHEEL_EXTENSION) +TAR_EXTENSIONS: Tuple[str, ...] = (".tar.gz", ".tgz", ".tar") +ARCHIVE_EXTENSIONS = ZIP_EXTENSIONS + BZ2_EXTENSIONS + TAR_EXTENSIONS + XZ_EXTENSIONS + + +def is_archive_file(name: str) -> bool: + """Return True if `name` is a considered as an archive file.""" + ext = splitext(name)[1].lower() + if ext in ARCHIVE_EXTENSIONS: + return True + return False diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/glibc.py b/.venv/lib/python3.12/site-packages/pip/_internal/utils/glibc.py new file mode 100644 index 0000000..998868f --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/utils/glibc.py @@ -0,0 +1,101 @@ +import os +import sys +from typing import Optional, Tuple + + +def glibc_version_string() -> Optional[str]: + "Returns glibc version string, or None if not using glibc." + return glibc_version_string_confstr() or glibc_version_string_ctypes() + + +def glibc_version_string_confstr() -> Optional[str]: + "Primary implementation of glibc_version_string using os.confstr." + # os.confstr is quite a bit faster than ctypes.DLL. It's also less likely + # to be broken or missing. This strategy is used in the standard library + # platform module: + # https://github.com/python/cpython/blob/fcf1d003bf4f0100c9d0921ff3d70e1127ca1b71/Lib/platform.py#L175-L183 + if sys.platform == "win32": + return None + try: + gnu_libc_version = os.confstr("CS_GNU_LIBC_VERSION") + if gnu_libc_version is None: + return None + # os.confstr("CS_GNU_LIBC_VERSION") returns a string like "glibc 2.17": + _, version = gnu_libc_version.split() + except (AttributeError, OSError, ValueError): + # os.confstr() or CS_GNU_LIBC_VERSION not available (or a bad value)... + return None + return version + + +def glibc_version_string_ctypes() -> Optional[str]: + "Fallback implementation of glibc_version_string using ctypes." + + try: + import ctypes + except ImportError: + return None + + # ctypes.CDLL(None) internally calls dlopen(NULL), and as the dlopen + # manpage says, "If filename is NULL, then the returned handle is for the + # main program". This way we can let the linker do the work to figure out + # which libc our process is actually using. + # + # We must also handle the special case where the executable is not a + # dynamically linked executable. This can occur when using musl libc, + # for example. In this situation, dlopen() will error, leading to an + # OSError. Interestingly, at least in the case of musl, there is no + # errno set on the OSError. The single string argument used to construct + # OSError comes from libc itself and is therefore not portable to + # hard code here. In any case, failure to call dlopen() means we + # can't proceed, so we bail on our attempt. + try: + process_namespace = ctypes.CDLL(None) + except OSError: + return None + + try: + gnu_get_libc_version = process_namespace.gnu_get_libc_version + except AttributeError: + # Symbol doesn't exist -> therefore, we are not linked to + # glibc. + return None + + # Call gnu_get_libc_version, which returns a string like "2.5" + gnu_get_libc_version.restype = ctypes.c_char_p + version_str: str = gnu_get_libc_version() + # py2 / py3 compatibility: + if not isinstance(version_str, str): + version_str = version_str.decode("ascii") + + return version_str + + +# platform.libc_ver regularly returns completely nonsensical glibc +# versions. E.g. on my computer, platform says: +# +# ~$ python2.7 -c 'import platform; print(platform.libc_ver())' +# ('glibc', '2.7') +# ~$ python3.5 -c 'import platform; print(platform.libc_ver())' +# ('glibc', '2.9') +# +# But the truth is: +# +# ~$ ldd --version +# ldd (Debian GLIBC 2.22-11) 2.22 +# +# This is unfortunate, because it means that the linehaul data on libc +# versions that was generated by pip 8.1.2 and earlier is useless and +# misleading. Solution: instead of using platform, use our code that actually +# works. +def libc_ver() -> Tuple[str, str]: + """Try to determine the glibc version + + Returns a tuple of strings (lib, version) which default to empty strings + in case the lookup fails. + """ + glibc_version = glibc_version_string() + if glibc_version is None: + return ("", "") + else: + return ("glibc", glibc_version) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/hashes.py b/.venv/lib/python3.12/site-packages/pip/_internal/utils/hashes.py new file mode 100644 index 0000000..535e94f --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/utils/hashes.py @@ -0,0 +1,147 @@ +import hashlib +from typing import TYPE_CHECKING, BinaryIO, Dict, Iterable, List, NoReturn, Optional + +from pip._internal.exceptions import HashMismatch, HashMissing, InstallationError +from pip._internal.utils.misc import read_chunks + +if TYPE_CHECKING: + from hashlib import _Hash + + +# The recommended hash algo of the moment. Change this whenever the state of +# the art changes; it won't hurt backward compatibility. +FAVORITE_HASH = "sha256" + + +# Names of hashlib algorithms allowed by the --hash option and ``pip hash`` +# Currently, those are the ones at least as collision-resistant as sha256. +STRONG_HASHES = ["sha256", "sha384", "sha512"] + + +class Hashes: + """A wrapper that builds multiple hashes at once and checks them against + known-good values + + """ + + def __init__(self, hashes: Optional[Dict[str, List[str]]] = None) -> None: + """ + :param hashes: A dict of algorithm names pointing to lists of allowed + hex digests + """ + allowed = {} + if hashes is not None: + for alg, keys in hashes.items(): + # Make sure values are always sorted (to ease equality checks) + allowed[alg] = [k.lower() for k in sorted(keys)] + self._allowed = allowed + + def __and__(self, other: "Hashes") -> "Hashes": + if not isinstance(other, Hashes): + return NotImplemented + + # If either of the Hashes object is entirely empty (i.e. no hash + # specified at all), all hashes from the other object are allowed. + if not other: + return self + if not self: + return other + + # Otherwise only hashes that present in both objects are allowed. + new = {} + for alg, values in other._allowed.items(): + if alg not in self._allowed: + continue + new[alg] = [v for v in values if v in self._allowed[alg]] + return Hashes(new) + + @property + def digest_count(self) -> int: + return sum(len(digests) for digests in self._allowed.values()) + + def is_hash_allowed(self, hash_name: str, hex_digest: str) -> bool: + """Return whether the given hex digest is allowed.""" + return hex_digest in self._allowed.get(hash_name, []) + + def check_against_chunks(self, chunks: Iterable[bytes]) -> None: + """Check good hashes against ones built from iterable of chunks of + data. + + Raise HashMismatch if none match. + + """ + gots = {} + for hash_name in self._allowed.keys(): + try: + gots[hash_name] = hashlib.new(hash_name) + except (ValueError, TypeError): + raise InstallationError(f"Unknown hash name: {hash_name}") + + for chunk in chunks: + for hash in gots.values(): + hash.update(chunk) + + for hash_name, got in gots.items(): + if got.hexdigest() in self._allowed[hash_name]: + return + self._raise(gots) + + def _raise(self, gots: Dict[str, "_Hash"]) -> "NoReturn": + raise HashMismatch(self._allowed, gots) + + def check_against_file(self, file: BinaryIO) -> None: + """Check good hashes against a file-like object + + Raise HashMismatch if none match. + + """ + return self.check_against_chunks(read_chunks(file)) + + def check_against_path(self, path: str) -> None: + with open(path, "rb") as file: + return self.check_against_file(file) + + def has_one_of(self, hashes: Dict[str, str]) -> bool: + """Return whether any of the given hashes are allowed.""" + for hash_name, hex_digest in hashes.items(): + if self.is_hash_allowed(hash_name, hex_digest): + return True + return False + + def __bool__(self) -> bool: + """Return whether I know any known-good hashes.""" + return bool(self._allowed) + + def __eq__(self, other: object) -> bool: + if not isinstance(other, Hashes): + return NotImplemented + return self._allowed == other._allowed + + def __hash__(self) -> int: + return hash( + ",".join( + sorted( + ":".join((alg, digest)) + for alg, digest_list in self._allowed.items() + for digest in digest_list + ) + ) + ) + + +class MissingHashes(Hashes): + """A workalike for Hashes used when we're missing a hash for a requirement + + It computes the actual hash of the requirement and raises a HashMissing + exception showing it to the user. + + """ + + def __init__(self) -> None: + """Don't offer the ``hashes`` kwarg.""" + # Pass our favorite hash in to generate a "gotten hash". With the + # empty list, it will never match, so an error will always raise. + super().__init__(hashes={FAVORITE_HASH: []}) + + def _raise(self, gots: Dict[str, "_Hash"]) -> "NoReturn": + raise HashMissing(gots[FAVORITE_HASH].hexdigest()) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/logging.py b/.venv/lib/python3.12/site-packages/pip/_internal/utils/logging.py new file mode 100644 index 0000000..41f6eb5 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/utils/logging.py @@ -0,0 +1,347 @@ +import contextlib +import errno +import logging +import logging.handlers +import os +import sys +import threading +from dataclasses import dataclass +from io import TextIOWrapper +from logging import Filter +from typing import Any, ClassVar, Generator, List, Optional, TextIO, Type + +from pip._vendor.rich.console import ( + Console, + ConsoleOptions, + ConsoleRenderable, + RenderableType, + RenderResult, + RichCast, +) +from pip._vendor.rich.highlighter import NullHighlighter +from pip._vendor.rich.logging import RichHandler +from pip._vendor.rich.segment import Segment +from pip._vendor.rich.style import Style + +from pip._internal.utils._log import VERBOSE, getLogger +from pip._internal.utils.compat import WINDOWS +from pip._internal.utils.deprecation import DEPRECATION_MSG_PREFIX +from pip._internal.utils.misc import ensure_dir + +_log_state = threading.local() +subprocess_logger = getLogger("pip.subprocessor") + + +class BrokenStdoutLoggingError(Exception): + """ + Raised if BrokenPipeError occurs for the stdout stream while logging. + """ + + +def _is_broken_pipe_error(exc_class: Type[BaseException], exc: BaseException) -> bool: + if exc_class is BrokenPipeError: + return True + + # On Windows, a broken pipe can show up as EINVAL rather than EPIPE: + # https://bugs.python.org/issue19612 + # https://bugs.python.org/issue30418 + if not WINDOWS: + return False + + return isinstance(exc, OSError) and exc.errno in (errno.EINVAL, errno.EPIPE) + + +@contextlib.contextmanager +def indent_log(num: int = 2) -> Generator[None, None, None]: + """ + A context manager which will cause the log output to be indented for any + log messages emitted inside it. + """ + # For thread-safety + _log_state.indentation = get_indentation() + _log_state.indentation += num + try: + yield + finally: + _log_state.indentation -= num + + +def get_indentation() -> int: + return getattr(_log_state, "indentation", 0) + + +class IndentingFormatter(logging.Formatter): + default_time_format = "%Y-%m-%dT%H:%M:%S" + + def __init__( + self, + *args: Any, + add_timestamp: bool = False, + **kwargs: Any, + ) -> None: + """ + A logging.Formatter that obeys the indent_log() context manager. + + :param add_timestamp: A bool indicating output lines should be prefixed + with their record's timestamp. + """ + self.add_timestamp = add_timestamp + super().__init__(*args, **kwargs) + + def get_message_start(self, formatted: str, levelno: int) -> str: + """ + Return the start of the formatted log message (not counting the + prefix to add to each line). + """ + if levelno < logging.WARNING: + return "" + if formatted.startswith(DEPRECATION_MSG_PREFIX): + # Then the message already has a prefix. We don't want it to + # look like "WARNING: DEPRECATION: ...." + return "" + if levelno < logging.ERROR: + return "WARNING: " + + return "ERROR: " + + def format(self, record: logging.LogRecord) -> str: + """ + Calls the standard formatter, but will indent all of the log message + lines by our current indentation level. + """ + formatted = super().format(record) + message_start = self.get_message_start(formatted, record.levelno) + formatted = message_start + formatted + + prefix = "" + if self.add_timestamp: + prefix = f"{self.formatTime(record)} " + prefix += " " * get_indentation() + formatted = "".join([prefix + line for line in formatted.splitlines(True)]) + return formatted + + +@dataclass +class IndentedRenderable: + renderable: RenderableType + indent: int + + def __rich_console__( + self, console: Console, options: ConsoleOptions + ) -> RenderResult: + segments = console.render(self.renderable, options) + lines = Segment.split_lines(segments) + for line in lines: + yield Segment(" " * self.indent) + yield from line + yield Segment("\n") + + +class RichPipStreamHandler(RichHandler): + KEYWORDS: ClassVar[Optional[List[str]]] = [] + + def __init__(self, stream: Optional[TextIO], no_color: bool) -> None: + super().__init__( + console=Console(file=stream, no_color=no_color, soft_wrap=True), + show_time=False, + show_level=False, + show_path=False, + highlighter=NullHighlighter(), + ) + + # Our custom override on Rich's logger, to make things work as we need them to. + def emit(self, record: logging.LogRecord) -> None: + style: Optional[Style] = None + + # If we are given a diagnostic error to present, present it with indentation. + if getattr(record, "rich", False): + assert isinstance(record.args, tuple) + (rich_renderable,) = record.args + assert isinstance( + rich_renderable, (ConsoleRenderable, RichCast, str) + ), f"{rich_renderable} is not rich-console-renderable" + + renderable: RenderableType = IndentedRenderable( + rich_renderable, indent=get_indentation() + ) + else: + message = self.format(record) + renderable = self.render_message(record, message) + if record.levelno is not None: + if record.levelno >= logging.ERROR: + style = Style(color="red") + elif record.levelno >= logging.WARNING: + style = Style(color="yellow") + + try: + self.console.print(renderable, overflow="ignore", crop=False, style=style) + except Exception: + self.handleError(record) + + def handleError(self, record: logging.LogRecord) -> None: + """Called when logging is unable to log some output.""" + + exc_class, exc = sys.exc_info()[:2] + # If a broken pipe occurred while calling write() or flush() on the + # stdout stream in logging's Handler.emit(), then raise our special + # exception so we can handle it in main() instead of logging the + # broken pipe error and continuing. + if ( + exc_class + and exc + and self.console.file is sys.stdout + and _is_broken_pipe_error(exc_class, exc) + ): + raise BrokenStdoutLoggingError() + + return super().handleError(record) + + +class BetterRotatingFileHandler(logging.handlers.RotatingFileHandler): + def _open(self) -> TextIOWrapper: + ensure_dir(os.path.dirname(self.baseFilename)) + return super()._open() + + +class MaxLevelFilter(Filter): + def __init__(self, level: int) -> None: + self.level = level + + def filter(self, record: logging.LogRecord) -> bool: + return record.levelno < self.level + + +class ExcludeLoggerFilter(Filter): + """ + A logging Filter that excludes records from a logger (or its children). + """ + + def filter(self, record: logging.LogRecord) -> bool: + # The base Filter class allows only records from a logger (or its + # children). + return not super().filter(record) + + +def setup_logging(verbosity: int, no_color: bool, user_log_file: Optional[str]) -> int: + """Configures and sets up all of the logging + + Returns the requested logging level, as its integer value. + """ + + # Determine the level to be logging at. + if verbosity >= 2: + level_number = logging.DEBUG + elif verbosity == 1: + level_number = VERBOSE + elif verbosity == -1: + level_number = logging.WARNING + elif verbosity == -2: + level_number = logging.ERROR + elif verbosity <= -3: + level_number = logging.CRITICAL + else: + level_number = logging.INFO + + level = logging.getLevelName(level_number) + + # The "root" logger should match the "console" level *unless* we also need + # to log to a user log file. + include_user_log = user_log_file is not None + if include_user_log: + additional_log_file = user_log_file + root_level = "DEBUG" + else: + additional_log_file = "/dev/null" + root_level = level + + # Disable any logging besides WARNING unless we have DEBUG level logging + # enabled for vendored libraries. + vendored_log_level = "WARNING" if level in ["INFO", "ERROR"] else "DEBUG" + + # Shorthands for clarity + log_streams = { + "stdout": "ext://sys.stdout", + "stderr": "ext://sys.stderr", + } + handler_classes = { + "stream": "pip._internal.utils.logging.RichPipStreamHandler", + "file": "pip._internal.utils.logging.BetterRotatingFileHandler", + } + handlers = ["console", "console_errors", "console_subprocess"] + ( + ["user_log"] if include_user_log else [] + ) + + logging.config.dictConfig( + { + "version": 1, + "disable_existing_loggers": False, + "filters": { + "exclude_warnings": { + "()": "pip._internal.utils.logging.MaxLevelFilter", + "level": logging.WARNING, + }, + "restrict_to_subprocess": { + "()": "logging.Filter", + "name": subprocess_logger.name, + }, + "exclude_subprocess": { + "()": "pip._internal.utils.logging.ExcludeLoggerFilter", + "name": subprocess_logger.name, + }, + }, + "formatters": { + "indent": { + "()": IndentingFormatter, + "format": "%(message)s", + }, + "indent_with_timestamp": { + "()": IndentingFormatter, + "format": "%(message)s", + "add_timestamp": True, + }, + }, + "handlers": { + "console": { + "level": level, + "class": handler_classes["stream"], + "no_color": no_color, + "stream": log_streams["stdout"], + "filters": ["exclude_subprocess", "exclude_warnings"], + "formatter": "indent", + }, + "console_errors": { + "level": "WARNING", + "class": handler_classes["stream"], + "no_color": no_color, + "stream": log_streams["stderr"], + "filters": ["exclude_subprocess"], + "formatter": "indent", + }, + # A handler responsible for logging to the console messages + # from the "subprocessor" logger. + "console_subprocess": { + "level": level, + "class": handler_classes["stream"], + "stream": log_streams["stderr"], + "no_color": no_color, + "filters": ["restrict_to_subprocess"], + "formatter": "indent", + }, + "user_log": { + "level": "DEBUG", + "class": handler_classes["file"], + "filename": additional_log_file, + "encoding": "utf-8", + "delay": True, + "formatter": "indent_with_timestamp", + }, + }, + "root": { + "level": root_level, + "handlers": handlers, + }, + "loggers": {"pip._vendor": {"level": vendored_log_level}}, + } + ) + + return level_number diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/misc.py b/.venv/lib/python3.12/site-packages/pip/_internal/utils/misc.py new file mode 100644 index 0000000..3707e87 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/utils/misc.py @@ -0,0 +1,777 @@ +import errno +import getpass +import hashlib +import logging +import os +import posixpath +import shutil +import stat +import sys +import sysconfig +import urllib.parse +from dataclasses import dataclass +from functools import partial +from io import StringIO +from itertools import filterfalse, tee, zip_longest +from pathlib import Path +from types import FunctionType, TracebackType +from typing import ( + Any, + BinaryIO, + Callable, + Dict, + Generator, + Iterable, + Iterator, + List, + Optional, + TextIO, + Tuple, + Type, + TypeVar, + Union, + cast, +) + +from pip._vendor.packaging.requirements import Requirement +from pip._vendor.pyproject_hooks import BuildBackendHookCaller + +from pip import __version__ +from pip._internal.exceptions import CommandError, ExternallyManagedEnvironment +from pip._internal.locations import get_major_minor_version +from pip._internal.utils.compat import WINDOWS +from pip._internal.utils.retry import retry +from pip._internal.utils.virtualenv import running_under_virtualenv + +__all__ = [ + "rmtree", + "display_path", + "backup_dir", + "ask", + "splitext", + "format_size", + "is_installable_dir", + "normalize_path", + "renames", + "get_prog", + "ensure_dir", + "remove_auth_from_url", + "check_externally_managed", + "ConfiguredBuildBackendHookCaller", +] + +logger = logging.getLogger(__name__) + +T = TypeVar("T") +ExcInfo = Tuple[Type[BaseException], BaseException, TracebackType] +VersionInfo = Tuple[int, int, int] +NetlocTuple = Tuple[str, Tuple[Optional[str], Optional[str]]] +OnExc = Callable[[FunctionType, Path, BaseException], Any] +OnErr = Callable[[FunctionType, Path, ExcInfo], Any] + +FILE_CHUNK_SIZE = 1024 * 1024 + + +def get_pip_version() -> str: + pip_pkg_dir = os.path.join(os.path.dirname(__file__), "..", "..") + pip_pkg_dir = os.path.abspath(pip_pkg_dir) + + return f"pip {__version__} from {pip_pkg_dir} (python {get_major_minor_version()})" + + +def normalize_version_info(py_version_info: Tuple[int, ...]) -> Tuple[int, int, int]: + """ + Convert a tuple of ints representing a Python version to one of length + three. + + :param py_version_info: a tuple of ints representing a Python version, + or None to specify no version. The tuple can have any length. + + :return: a tuple of length three if `py_version_info` is non-None. + Otherwise, return `py_version_info` unchanged (i.e. None). + """ + if len(py_version_info) < 3: + py_version_info += (3 - len(py_version_info)) * (0,) + elif len(py_version_info) > 3: + py_version_info = py_version_info[:3] + + return cast("VersionInfo", py_version_info) + + +def ensure_dir(path: str) -> None: + """os.path.makedirs without EEXIST.""" + try: + os.makedirs(path) + except OSError as e: + # Windows can raise spurious ENOTEMPTY errors. See #6426. + if e.errno != errno.EEXIST and e.errno != errno.ENOTEMPTY: + raise + + +def get_prog() -> str: + try: + prog = os.path.basename(sys.argv[0]) + if prog in ("__main__.py", "-c"): + return f"{sys.executable} -m pip" + else: + return prog + except (AttributeError, TypeError, IndexError): + pass + return "pip" + + +# Retry every half second for up to 3 seconds +@retry(stop_after_delay=3, wait=0.5) +def rmtree( + dir: str, ignore_errors: bool = False, onexc: Optional[OnExc] = None +) -> None: + if ignore_errors: + onexc = _onerror_ignore + if onexc is None: + onexc = _onerror_reraise + handler: OnErr = partial( + # `[func, path, Union[ExcInfo, BaseException]] -> Any` is equivalent to + # `Union[([func, path, ExcInfo] -> Any), ([func, path, BaseException] -> Any)]`. + cast(Union[OnExc, OnErr], rmtree_errorhandler), + onexc=onexc, + ) + if sys.version_info >= (3, 12): + # See https://docs.python.org/3.12/whatsnew/3.12.html#shutil. + shutil.rmtree(dir, onexc=handler) # type: ignore + else: + shutil.rmtree(dir, onerror=handler) # type: ignore + + +def _onerror_ignore(*_args: Any) -> None: + pass + + +def _onerror_reraise(*_args: Any) -> None: + raise # noqa: PLE0704 - Bare exception used to reraise existing exception + + +def rmtree_errorhandler( + func: FunctionType, + path: Path, + exc_info: Union[ExcInfo, BaseException], + *, + onexc: OnExc = _onerror_reraise, +) -> None: + """ + `rmtree` error handler to 'force' a file remove (i.e. like `rm -f`). + + * If a file is readonly then it's write flag is set and operation is + retried. + + * `onerror` is the original callback from `rmtree(... onerror=onerror)` + that is chained at the end if the "rm -f" still fails. + """ + try: + st_mode = os.stat(path).st_mode + except OSError: + # it's equivalent to os.path.exists + return + + if not st_mode & stat.S_IWRITE: + # convert to read/write + try: + os.chmod(path, st_mode | stat.S_IWRITE) + except OSError: + pass + else: + # use the original function to repeat the operation + try: + func(path) + return + except OSError: + pass + + if not isinstance(exc_info, BaseException): + _, exc_info, _ = exc_info + onexc(func, path, exc_info) + + +def display_path(path: str) -> str: + """Gives the display value for a given path, making it relative to cwd + if possible.""" + path = os.path.normcase(os.path.abspath(path)) + if path.startswith(os.getcwd() + os.path.sep): + path = "." + path[len(os.getcwd()) :] + return path + + +def backup_dir(dir: str, ext: str = ".bak") -> str: + """Figure out the name of a directory to back up the given dir to + (adding .bak, .bak2, etc)""" + n = 1 + extension = ext + while os.path.exists(dir + extension): + n += 1 + extension = ext + str(n) + return dir + extension + + +def ask_path_exists(message: str, options: Iterable[str]) -> str: + for action in os.environ.get("PIP_EXISTS_ACTION", "").split(): + if action in options: + return action + return ask(message, options) + + +def _check_no_input(message: str) -> None: + """Raise an error if no input is allowed.""" + if os.environ.get("PIP_NO_INPUT"): + raise Exception( + f"No input was expected ($PIP_NO_INPUT set); question: {message}" + ) + + +def ask(message: str, options: Iterable[str]) -> str: + """Ask the message interactively, with the given possible responses""" + while 1: + _check_no_input(message) + response = input(message) + response = response.strip().lower() + if response not in options: + print( + "Your response ({!r}) was not one of the expected responses: " + "{}".format(response, ", ".join(options)) + ) + else: + return response + + +def ask_input(message: str) -> str: + """Ask for input interactively.""" + _check_no_input(message) + return input(message) + + +def ask_password(message: str) -> str: + """Ask for a password interactively.""" + _check_no_input(message) + return getpass.getpass(message) + + +def strtobool(val: str) -> int: + """Convert a string representation of truth to true (1) or false (0). + + True values are 'y', 'yes', 't', 'true', 'on', and '1'; false values + are 'n', 'no', 'f', 'false', 'off', and '0'. Raises ValueError if + 'val' is anything else. + """ + val = val.lower() + if val in ("y", "yes", "t", "true", "on", "1"): + return 1 + elif val in ("n", "no", "f", "false", "off", "0"): + return 0 + else: + raise ValueError(f"invalid truth value {val!r}") + + +def format_size(bytes: float) -> str: + if bytes > 1000 * 1000: + return f"{bytes / 1000.0 / 1000:.1f} MB" + elif bytes > 10 * 1000: + return f"{int(bytes / 1000)} kB" + elif bytes > 1000: + return f"{bytes / 1000.0:.1f} kB" + else: + return f"{int(bytes)} bytes" + + +def tabulate(rows: Iterable[Iterable[Any]]) -> Tuple[List[str], List[int]]: + """Return a list of formatted rows and a list of column sizes. + + For example:: + + >>> tabulate([['foobar', 2000], [0xdeadbeef]]) + (['foobar 2000', '3735928559'], [10, 4]) + """ + rows = [tuple(map(str, row)) for row in rows] + sizes = [max(map(len, col)) for col in zip_longest(*rows, fillvalue="")] + table = [" ".join(map(str.ljust, row, sizes)).rstrip() for row in rows] + return table, sizes + + +def is_installable_dir(path: str) -> bool: + """Is path is a directory containing pyproject.toml or setup.py? + + If pyproject.toml exists, this is a PEP 517 project. Otherwise we look for + a legacy setuptools layout by identifying setup.py. We don't check for the + setup.cfg because using it without setup.py is only available for PEP 517 + projects, which are already covered by the pyproject.toml check. + """ + if not os.path.isdir(path): + return False + if os.path.isfile(os.path.join(path, "pyproject.toml")): + return True + if os.path.isfile(os.path.join(path, "setup.py")): + return True + return False + + +def read_chunks( + file: BinaryIO, size: int = FILE_CHUNK_SIZE +) -> Generator[bytes, None, None]: + """Yield pieces of data from a file-like object until EOF.""" + while True: + chunk = file.read(size) + if not chunk: + break + yield chunk + + +def normalize_path(path: str, resolve_symlinks: bool = True) -> str: + """ + Convert a path to its canonical, case-normalized, absolute version. + + """ + path = os.path.expanduser(path) + if resolve_symlinks: + path = os.path.realpath(path) + else: + path = os.path.abspath(path) + return os.path.normcase(path) + + +def splitext(path: str) -> Tuple[str, str]: + """Like os.path.splitext, but take off .tar too""" + base, ext = posixpath.splitext(path) + if base.lower().endswith(".tar"): + ext = base[-4:] + ext + base = base[:-4] + return base, ext + + +def renames(old: str, new: str) -> None: + """Like os.renames(), but handles renaming across devices.""" + # Implementation borrowed from os.renames(). + head, tail = os.path.split(new) + if head and tail and not os.path.exists(head): + os.makedirs(head) + + shutil.move(old, new) + + head, tail = os.path.split(old) + if head and tail: + try: + os.removedirs(head) + except OSError: + pass + + +def is_local(path: str) -> bool: + """ + Return True if path is within sys.prefix, if we're running in a virtualenv. + + If we're not in a virtualenv, all paths are considered "local." + + Caution: this function assumes the head of path has been normalized + with normalize_path. + """ + if not running_under_virtualenv(): + return True + return path.startswith(normalize_path(sys.prefix)) + + +def write_output(msg: Any, *args: Any) -> None: + logger.info(msg, *args) + + +class StreamWrapper(StringIO): + orig_stream: TextIO + + @classmethod + def from_stream(cls, orig_stream: TextIO) -> "StreamWrapper": + ret = cls() + ret.orig_stream = orig_stream + return ret + + # compileall.compile_dir() needs stdout.encoding to print to stdout + # type ignore is because TextIOBase.encoding is writeable + @property + def encoding(self) -> str: # type: ignore + return self.orig_stream.encoding + + +# Simulates an enum +def enum(*sequential: Any, **named: Any) -> Type[Any]: + enums = dict(zip(sequential, range(len(sequential))), **named) + reverse = {value: key for key, value in enums.items()} + enums["reverse_mapping"] = reverse + return type("Enum", (), enums) + + +def build_netloc(host: str, port: Optional[int]) -> str: + """ + Build a netloc from a host-port pair + """ + if port is None: + return host + if ":" in host: + # Only wrap host with square brackets when it is IPv6 + host = f"[{host}]" + return f"{host}:{port}" + + +def build_url_from_netloc(netloc: str, scheme: str = "https") -> str: + """ + Build a full URL from a netloc. + """ + if netloc.count(":") >= 2 and "@" not in netloc and "[" not in netloc: + # It must be a bare IPv6 address, so wrap it with brackets. + netloc = f"[{netloc}]" + return f"{scheme}://{netloc}" + + +def parse_netloc(netloc: str) -> Tuple[Optional[str], Optional[int]]: + """ + Return the host-port pair from a netloc. + """ + url = build_url_from_netloc(netloc) + parsed = urllib.parse.urlparse(url) + return parsed.hostname, parsed.port + + +def split_auth_from_netloc(netloc: str) -> NetlocTuple: + """ + Parse out and remove the auth information from a netloc. + + Returns: (netloc, (username, password)). + """ + if "@" not in netloc: + return netloc, (None, None) + + # Split from the right because that's how urllib.parse.urlsplit() + # behaves if more than one @ is present (which can be checked using + # the password attribute of urlsplit()'s return value). + auth, netloc = netloc.rsplit("@", 1) + pw: Optional[str] = None + if ":" in auth: + # Split from the left because that's how urllib.parse.urlsplit() + # behaves if more than one : is present (which again can be checked + # using the password attribute of the return value) + user, pw = auth.split(":", 1) + else: + user, pw = auth, None + + user = urllib.parse.unquote(user) + if pw is not None: + pw = urllib.parse.unquote(pw) + + return netloc, (user, pw) + + +def redact_netloc(netloc: str) -> str: + """ + Replace the sensitive data in a netloc with "****", if it exists. + + For example: + - "user:pass@example.com" returns "user:****@example.com" + - "accesstoken@example.com" returns "****@example.com" + """ + netloc, (user, password) = split_auth_from_netloc(netloc) + if user is None: + return netloc + if password is None: + user = "****" + password = "" + else: + user = urllib.parse.quote(user) + password = ":****" + return f"{user}{password}@{netloc}" + + +def _transform_url( + url: str, transform_netloc: Callable[[str], Tuple[Any, ...]] +) -> Tuple[str, NetlocTuple]: + """Transform and replace netloc in a url. + + transform_netloc is a function taking the netloc and returning a + tuple. The first element of this tuple is the new netloc. The + entire tuple is returned. + + Returns a tuple containing the transformed url as item 0 and the + original tuple returned by transform_netloc as item 1. + """ + purl = urllib.parse.urlsplit(url) + netloc_tuple = transform_netloc(purl.netloc) + # stripped url + url_pieces = (purl.scheme, netloc_tuple[0], purl.path, purl.query, purl.fragment) + surl = urllib.parse.urlunsplit(url_pieces) + return surl, cast("NetlocTuple", netloc_tuple) + + +def _get_netloc(netloc: str) -> NetlocTuple: + return split_auth_from_netloc(netloc) + + +def _redact_netloc(netloc: str) -> Tuple[str]: + return (redact_netloc(netloc),) + + +def split_auth_netloc_from_url( + url: str, +) -> Tuple[str, str, Tuple[Optional[str], Optional[str]]]: + """ + Parse a url into separate netloc, auth, and url with no auth. + + Returns: (url_without_auth, netloc, (username, password)) + """ + url_without_auth, (netloc, auth) = _transform_url(url, _get_netloc) + return url_without_auth, netloc, auth + + +def remove_auth_from_url(url: str) -> str: + """Return a copy of url with 'username:password@' removed.""" + # username/pass params are passed to subversion through flags + # and are not recognized in the url. + return _transform_url(url, _get_netloc)[0] + + +def redact_auth_from_url(url: str) -> str: + """Replace the password in a given url with ****.""" + return _transform_url(url, _redact_netloc)[0] + + +def redact_auth_from_requirement(req: Requirement) -> str: + """Replace the password in a given requirement url with ****.""" + if not req.url: + return str(req) + return str(req).replace(req.url, redact_auth_from_url(req.url)) + + +@dataclass(frozen=True) +class HiddenText: + secret: str + redacted: str + + def __repr__(self) -> str: + return f"" + + def __str__(self) -> str: + return self.redacted + + # This is useful for testing. + def __eq__(self, other: Any) -> bool: + if type(self) != type(other): + return False + + # The string being used for redaction doesn't also have to match, + # just the raw, original string. + return self.secret == other.secret + + +def hide_value(value: str) -> HiddenText: + return HiddenText(value, redacted="****") + + +def hide_url(url: str) -> HiddenText: + redacted = redact_auth_from_url(url) + return HiddenText(url, redacted=redacted) + + +def protect_pip_from_modification_on_windows(modifying_pip: bool) -> None: + """Protection of pip.exe from modification on Windows + + On Windows, any operation modifying pip should be run as: + python -m pip ... + """ + pip_names = [ + "pip", + f"pip{sys.version_info.major}", + f"pip{sys.version_info.major}.{sys.version_info.minor}", + ] + + # See https://github.com/pypa/pip/issues/1299 for more discussion + should_show_use_python_msg = ( + modifying_pip and WINDOWS and os.path.basename(sys.argv[0]) in pip_names + ) + + if should_show_use_python_msg: + new_command = [sys.executable, "-m", "pip"] + sys.argv[1:] + raise CommandError( + "To modify pip, please run the following command:\n{}".format( + " ".join(new_command) + ) + ) + + +def check_externally_managed() -> None: + """Check whether the current environment is externally managed. + + If the ``EXTERNALLY-MANAGED`` config file is found, the current environment + is considered externally managed, and an ExternallyManagedEnvironment is + raised. + """ + if running_under_virtualenv(): + return + marker = os.path.join(sysconfig.get_path("stdlib"), "EXTERNALLY-MANAGED") + if not os.path.isfile(marker): + return + raise ExternallyManagedEnvironment.from_config(marker) + + +def is_console_interactive() -> bool: + """Is this console interactive?""" + return sys.stdin is not None and sys.stdin.isatty() + + +def hash_file(path: str, blocksize: int = 1 << 20) -> Tuple[Any, int]: + """Return (hash, length) for path using hashlib.sha256()""" + + h = hashlib.sha256() + length = 0 + with open(path, "rb") as f: + for block in read_chunks(f, size=blocksize): + length += len(block) + h.update(block) + return h, length + + +def pairwise(iterable: Iterable[Any]) -> Iterator[Tuple[Any, Any]]: + """ + Return paired elements. + + For example: + s -> (s0, s1), (s2, s3), (s4, s5), ... + """ + iterable = iter(iterable) + return zip_longest(iterable, iterable) + + +def partition( + pred: Callable[[T], bool], iterable: Iterable[T] +) -> Tuple[Iterable[T], Iterable[T]]: + """ + Use a predicate to partition entries into false entries and true entries, + like + + partition(is_odd, range(10)) --> 0 2 4 6 8 and 1 3 5 7 9 + """ + t1, t2 = tee(iterable) + return filterfalse(pred, t1), filter(pred, t2) + + +class ConfiguredBuildBackendHookCaller(BuildBackendHookCaller): + def __init__( + self, + config_holder: Any, + source_dir: str, + build_backend: str, + backend_path: Optional[str] = None, + runner: Optional[Callable[..., None]] = None, + python_executable: Optional[str] = None, + ): + super().__init__( + source_dir, build_backend, backend_path, runner, python_executable + ) + self.config_holder = config_holder + + def build_wheel( + self, + wheel_directory: str, + config_settings: Optional[Dict[str, Union[str, List[str]]]] = None, + metadata_directory: Optional[str] = None, + ) -> str: + cs = self.config_holder.config_settings + return super().build_wheel( + wheel_directory, config_settings=cs, metadata_directory=metadata_directory + ) + + def build_sdist( + self, + sdist_directory: str, + config_settings: Optional[Dict[str, Union[str, List[str]]]] = None, + ) -> str: + cs = self.config_holder.config_settings + return super().build_sdist(sdist_directory, config_settings=cs) + + def build_editable( + self, + wheel_directory: str, + config_settings: Optional[Dict[str, Union[str, List[str]]]] = None, + metadata_directory: Optional[str] = None, + ) -> str: + cs = self.config_holder.config_settings + return super().build_editable( + wheel_directory, config_settings=cs, metadata_directory=metadata_directory + ) + + def get_requires_for_build_wheel( + self, config_settings: Optional[Dict[str, Union[str, List[str]]]] = None + ) -> List[str]: + cs = self.config_holder.config_settings + return super().get_requires_for_build_wheel(config_settings=cs) + + def get_requires_for_build_sdist( + self, config_settings: Optional[Dict[str, Union[str, List[str]]]] = None + ) -> List[str]: + cs = self.config_holder.config_settings + return super().get_requires_for_build_sdist(config_settings=cs) + + def get_requires_for_build_editable( + self, config_settings: Optional[Dict[str, Union[str, List[str]]]] = None + ) -> List[str]: + cs = self.config_holder.config_settings + return super().get_requires_for_build_editable(config_settings=cs) + + def prepare_metadata_for_build_wheel( + self, + metadata_directory: str, + config_settings: Optional[Dict[str, Union[str, List[str]]]] = None, + _allow_fallback: bool = True, + ) -> str: + cs = self.config_holder.config_settings + return super().prepare_metadata_for_build_wheel( + metadata_directory=metadata_directory, + config_settings=cs, + _allow_fallback=_allow_fallback, + ) + + def prepare_metadata_for_build_editable( + self, + metadata_directory: str, + config_settings: Optional[Dict[str, Union[str, List[str]]]] = None, + _allow_fallback: bool = True, + ) -> str: + cs = self.config_holder.config_settings + return super().prepare_metadata_for_build_editable( + metadata_directory=metadata_directory, + config_settings=cs, + _allow_fallback=_allow_fallback, + ) + + +def warn_if_run_as_root() -> None: + """Output a warning for sudo users on Unix. + + In a virtual environment, sudo pip still writes to virtualenv. + On Windows, users may run pip as Administrator without issues. + This warning only applies to Unix root users outside of virtualenv. + """ + if running_under_virtualenv(): + return + if not hasattr(os, "getuid"): + return + # On Windows, there are no "system managed" Python packages. Installing as + # Administrator via pip is the correct way of updating system environments. + # + # We choose sys.platform over utils.compat.WINDOWS here to enable Mypy platform + # checks: https://mypy.readthedocs.io/en/stable/common_issues.html + if sys.platform == "win32" or sys.platform == "cygwin": + return + + if os.getuid() != 0: + return + + logger.warning( + "Running pip as the 'root' user can result in broken permissions and " + "conflicting behaviour with the system package manager, possibly " + "rendering your system unusable." + "It is recommended to use a virtual environment instead: " + "https://pip.pypa.io/warnings/venv. " + "Use the --root-user-action option if you know what you are doing and " + "want to suppress this warning." + ) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/packaging.py b/.venv/lib/python3.12/site-packages/pip/_internal/utils/packaging.py new file mode 100644 index 0000000..4b8fa0f --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/utils/packaging.py @@ -0,0 +1,57 @@ +import functools +import logging +import re +from typing import NewType, Optional, Tuple, cast + +from pip._vendor.packaging import specifiers, version +from pip._vendor.packaging.requirements import Requirement + +NormalizedExtra = NewType("NormalizedExtra", str) + +logger = logging.getLogger(__name__) + + +def check_requires_python( + requires_python: Optional[str], version_info: Tuple[int, ...] +) -> bool: + """ + Check if the given Python version matches a "Requires-Python" specifier. + + :param version_info: A 3-tuple of ints representing a Python + major-minor-micro version to check (e.g. `sys.version_info[:3]`). + + :return: `True` if the given Python version satisfies the requirement. + Otherwise, return `False`. + + :raises InvalidSpecifier: If `requires_python` has an invalid format. + """ + if requires_python is None: + # The package provides no information + return True + requires_python_specifier = specifiers.SpecifierSet(requires_python) + + python_version = version.parse(".".join(map(str, version_info))) + return python_version in requires_python_specifier + + +@functools.lru_cache(maxsize=2048) +def get_requirement(req_string: str) -> Requirement: + """Construct a packaging.Requirement object with caching""" + # Parsing requirement strings is expensive, and is also expected to happen + # with a low diversity of different arguments (at least relative the number + # constructed). This method adds a cache to requirement object creation to + # minimize repeated parsing of the same string to construct equivalent + # Requirement objects. + return Requirement(req_string) + + +def safe_extra(extra: str) -> NormalizedExtra: + """Convert an arbitrary string to a standard 'extra' name + + Any runs of non-alphanumeric characters are replaced with a single '_', + and the result is always lowercased. + + This function is duplicated from ``pkg_resources``. Note that this is not + the same to either ``canonicalize_name`` or ``_egg_link_name``. + """ + return cast(NormalizedExtra, re.sub("[^A-Za-z0-9.-]+", "_", extra).lower()) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/retry.py b/.venv/lib/python3.12/site-packages/pip/_internal/utils/retry.py new file mode 100644 index 0000000..abfe072 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/utils/retry.py @@ -0,0 +1,42 @@ +import functools +from time import perf_counter, sleep +from typing import Callable, TypeVar + +from pip._vendor.typing_extensions import ParamSpec + +T = TypeVar("T") +P = ParamSpec("P") + + +def retry( + wait: float, stop_after_delay: float +) -> Callable[[Callable[P, T]], Callable[P, T]]: + """Decorator to automatically retry a function on error. + + If the function raises, the function is recalled with the same arguments + until it returns or the time limit is reached. When the time limit is + surpassed, the last exception raised is reraised. + + :param wait: The time to wait after an error before retrying, in seconds. + :param stop_after_delay: The time limit after which retries will cease, + in seconds. + """ + + def wrapper(func: Callable[P, T]) -> Callable[P, T]: + + @functools.wraps(func) + def retry_wrapped(*args: P.args, **kwargs: P.kwargs) -> T: + # The performance counter is monotonic on all platforms we care + # about and has much better resolution than time.monotonic(). + start_time = perf_counter() + while True: + try: + return func(*args, **kwargs) + except Exception: + if perf_counter() - start_time > stop_after_delay: + raise + sleep(wait) + + return retry_wrapped + + return wrapper diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/setuptools_build.py b/.venv/lib/python3.12/site-packages/pip/_internal/utils/setuptools_build.py new file mode 100644 index 0000000..96d1b24 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/utils/setuptools_build.py @@ -0,0 +1,146 @@ +import sys +import textwrap +from typing import List, Optional, Sequence + +# Shim to wrap setup.py invocation with setuptools +# Note that __file__ is handled via two {!r} *and* %r, to ensure that paths on +# Windows are correctly handled (it should be "C:\\Users" not "C:\Users"). +_SETUPTOOLS_SHIM = textwrap.dedent( + """ + exec(compile(''' + # This is -- a caller that pip uses to run setup.py + # + # - It imports setuptools before invoking setup.py, to enable projects that directly + # import from `distutils.core` to work with newer packaging standards. + # - It provides a clear error message when setuptools is not installed. + # - It sets `sys.argv[0]` to the underlying `setup.py`, when invoking `setup.py` so + # setuptools doesn't think the script is `-c`. This avoids the following warning: + # manifest_maker: standard file '-c' not found". + # - It generates a shim setup.py, for handling setup.cfg-only projects. + import os, sys, tokenize + + try: + import setuptools + except ImportError as error: + print( + "ERROR: Can not execute `setup.py` since setuptools is not available in " + "the build environment.", + file=sys.stderr, + ) + sys.exit(1) + + __file__ = %r + sys.argv[0] = __file__ + + if os.path.exists(__file__): + filename = __file__ + with tokenize.open(__file__) as f: + setup_py_code = f.read() + else: + filename = "" + setup_py_code = "from setuptools import setup; setup()" + + exec(compile(setup_py_code, filename, "exec")) + ''' % ({!r},), "", "exec")) + """ +).rstrip() + + +def make_setuptools_shim_args( + setup_py_path: str, + global_options: Optional[Sequence[str]] = None, + no_user_config: bool = False, + unbuffered_output: bool = False, +) -> List[str]: + """ + Get setuptools command arguments with shim wrapped setup file invocation. + + :param setup_py_path: The path to setup.py to be wrapped. + :param global_options: Additional global options. + :param no_user_config: If True, disables personal user configuration. + :param unbuffered_output: If True, adds the unbuffered switch to the + argument list. + """ + args = [sys.executable] + if unbuffered_output: + args += ["-u"] + args += ["-c", _SETUPTOOLS_SHIM.format(setup_py_path)] + if global_options: + args += global_options + if no_user_config: + args += ["--no-user-cfg"] + return args + + +def make_setuptools_bdist_wheel_args( + setup_py_path: str, + global_options: Sequence[str], + build_options: Sequence[str], + destination_dir: str, +) -> List[str]: + # NOTE: Eventually, we'd want to also -S to the flags here, when we're + # isolating. Currently, it breaks Python in virtualenvs, because it + # relies on site.py to find parts of the standard library outside the + # virtualenv. + args = make_setuptools_shim_args( + setup_py_path, global_options=global_options, unbuffered_output=True + ) + args += ["bdist_wheel", "-d", destination_dir] + args += build_options + return args + + +def make_setuptools_clean_args( + setup_py_path: str, + global_options: Sequence[str], +) -> List[str]: + args = make_setuptools_shim_args( + setup_py_path, global_options=global_options, unbuffered_output=True + ) + args += ["clean", "--all"] + return args + + +def make_setuptools_develop_args( + setup_py_path: str, + *, + global_options: Sequence[str], + no_user_config: bool, + prefix: Optional[str], + home: Optional[str], + use_user_site: bool, +) -> List[str]: + assert not (use_user_site and prefix) + + args = make_setuptools_shim_args( + setup_py_path, + global_options=global_options, + no_user_config=no_user_config, + ) + + args += ["develop", "--no-deps"] + + if prefix: + args += ["--prefix", prefix] + if home is not None: + args += ["--install-dir", home] + + if use_user_site: + args += ["--user", "--prefix="] + + return args + + +def make_setuptools_egg_info_args( + setup_py_path: str, + egg_info_dir: Optional[str], + no_user_config: bool, +) -> List[str]: + args = make_setuptools_shim_args(setup_py_path, no_user_config=no_user_config) + + args += ["egg_info"] + + if egg_info_dir: + args += ["--egg-base", egg_info_dir] + + return args diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/subprocess.py b/.venv/lib/python3.12/site-packages/pip/_internal/utils/subprocess.py new file mode 100644 index 0000000..cb2e23f --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/utils/subprocess.py @@ -0,0 +1,245 @@ +import logging +import os +import shlex +import subprocess +from typing import Any, Callable, Iterable, List, Literal, Mapping, Optional, Union + +from pip._vendor.rich.markup import escape + +from pip._internal.cli.spinners import SpinnerInterface, open_spinner +from pip._internal.exceptions import InstallationSubprocessError +from pip._internal.utils.logging import VERBOSE, subprocess_logger +from pip._internal.utils.misc import HiddenText + +CommandArgs = List[Union[str, HiddenText]] + + +def make_command(*args: Union[str, HiddenText, CommandArgs]) -> CommandArgs: + """ + Create a CommandArgs object. + """ + command_args: CommandArgs = [] + for arg in args: + # Check for list instead of CommandArgs since CommandArgs is + # only known during type-checking. + if isinstance(arg, list): + command_args.extend(arg) + else: + # Otherwise, arg is str or HiddenText. + command_args.append(arg) + + return command_args + + +def format_command_args(args: Union[List[str], CommandArgs]) -> str: + """ + Format command arguments for display. + """ + # For HiddenText arguments, display the redacted form by calling str(). + # Also, we don't apply str() to arguments that aren't HiddenText since + # this can trigger a UnicodeDecodeError in Python 2 if the argument + # has type unicode and includes a non-ascii character. (The type + # checker doesn't ensure the annotations are correct in all cases.) + return " ".join( + shlex.quote(str(arg)) if isinstance(arg, HiddenText) else shlex.quote(arg) + for arg in args + ) + + +def reveal_command_args(args: Union[List[str], CommandArgs]) -> List[str]: + """ + Return the arguments in their raw, unredacted form. + """ + return [arg.secret if isinstance(arg, HiddenText) else arg for arg in args] + + +def call_subprocess( + cmd: Union[List[str], CommandArgs], + show_stdout: bool = False, + cwd: Optional[str] = None, + on_returncode: 'Literal["raise", "warn", "ignore"]' = "raise", + extra_ok_returncodes: Optional[Iterable[int]] = None, + extra_environ: Optional[Mapping[str, Any]] = None, + unset_environ: Optional[Iterable[str]] = None, + spinner: Optional[SpinnerInterface] = None, + log_failed_cmd: Optional[bool] = True, + stdout_only: Optional[bool] = False, + *, + command_desc: str, +) -> str: + """ + Args: + show_stdout: if true, use INFO to log the subprocess's stderr and + stdout streams. Otherwise, use DEBUG. Defaults to False. + extra_ok_returncodes: an iterable of integer return codes that are + acceptable, in addition to 0. Defaults to None, which means []. + unset_environ: an iterable of environment variable names to unset + prior to calling subprocess.Popen(). + log_failed_cmd: if false, failed commands are not logged, only raised. + stdout_only: if true, return only stdout, else return both. When true, + logging of both stdout and stderr occurs when the subprocess has + terminated, else logging occurs as subprocess output is produced. + """ + if extra_ok_returncodes is None: + extra_ok_returncodes = [] + if unset_environ is None: + unset_environ = [] + # Most places in pip use show_stdout=False. What this means is-- + # + # - We connect the child's output (combined stderr and stdout) to a + # single pipe, which we read. + # - We log this output to stderr at DEBUG level as it is received. + # - If DEBUG logging isn't enabled (e.g. if --verbose logging wasn't + # requested), then we show a spinner so the user can still see the + # subprocess is in progress. + # - If the subprocess exits with an error, we log the output to stderr + # at ERROR level if it hasn't already been displayed to the console + # (e.g. if --verbose logging wasn't enabled). This way we don't log + # the output to the console twice. + # + # If show_stdout=True, then the above is still done, but with DEBUG + # replaced by INFO. + if show_stdout: + # Then log the subprocess output at INFO level. + log_subprocess: Callable[..., None] = subprocess_logger.info + used_level = logging.INFO + else: + # Then log the subprocess output using VERBOSE. This also ensures + # it will be logged to the log file (aka user_log), if enabled. + log_subprocess = subprocess_logger.verbose + used_level = VERBOSE + + # Whether the subprocess will be visible in the console. + showing_subprocess = subprocess_logger.getEffectiveLevel() <= used_level + + # Only use the spinner if we're not showing the subprocess output + # and we have a spinner. + use_spinner = not showing_subprocess and spinner is not None + + log_subprocess("Running command %s", command_desc) + env = os.environ.copy() + if extra_environ: + env.update(extra_environ) + for name in unset_environ: + env.pop(name, None) + try: + proc = subprocess.Popen( + # Convert HiddenText objects to the underlying str. + reveal_command_args(cmd), + stdin=subprocess.PIPE, + stdout=subprocess.PIPE, + stderr=subprocess.STDOUT if not stdout_only else subprocess.PIPE, + cwd=cwd, + env=env, + errors="backslashreplace", + ) + except Exception as exc: + if log_failed_cmd: + subprocess_logger.critical( + "Error %s while executing command %s", + exc, + command_desc, + ) + raise + all_output = [] + if not stdout_only: + assert proc.stdout + assert proc.stdin + proc.stdin.close() + # In this mode, stdout and stderr are in the same pipe. + while True: + line: str = proc.stdout.readline() + if not line: + break + line = line.rstrip() + all_output.append(line + "\n") + + # Show the line immediately. + log_subprocess(line) + # Update the spinner. + if use_spinner: + assert spinner + spinner.spin() + try: + proc.wait() + finally: + if proc.stdout: + proc.stdout.close() + output = "".join(all_output) + else: + # In this mode, stdout and stderr are in different pipes. + # We must use communicate() which is the only safe way to read both. + out, err = proc.communicate() + # log line by line to preserve pip log indenting + for out_line in out.splitlines(): + log_subprocess(out_line) + all_output.append(out) + for err_line in err.splitlines(): + log_subprocess(err_line) + all_output.append(err) + output = out + + proc_had_error = proc.returncode and proc.returncode not in extra_ok_returncodes + if use_spinner: + assert spinner + if proc_had_error: + spinner.finish("error") + else: + spinner.finish("done") + if proc_had_error: + if on_returncode == "raise": + error = InstallationSubprocessError( + command_description=command_desc, + exit_code=proc.returncode, + output_lines=all_output if not showing_subprocess else None, + ) + if log_failed_cmd: + subprocess_logger.error("%s", error, extra={"rich": True}) + subprocess_logger.verbose( + "[bold magenta]full command[/]: [blue]%s[/]", + escape(format_command_args(cmd)), + extra={"markup": True}, + ) + subprocess_logger.verbose( + "[bold magenta]cwd[/]: %s", + escape(cwd or "[inherit]"), + extra={"markup": True}, + ) + + raise error + elif on_returncode == "warn": + subprocess_logger.warning( + 'Command "%s" had error code %s in %s', + command_desc, + proc.returncode, + cwd, + ) + elif on_returncode == "ignore": + pass + else: + raise ValueError(f"Invalid value: on_returncode={on_returncode!r}") + return output + + +def runner_with_spinner_message(message: str) -> Callable[..., None]: + """Provide a subprocess_runner that shows a spinner message. + + Intended for use with for BuildBackendHookCaller. Thus, the runner has + an API that matches what's expected by BuildBackendHookCaller.subprocess_runner. + """ + + def runner( + cmd: List[str], + cwd: Optional[str] = None, + extra_environ: Optional[Mapping[str, Any]] = None, + ) -> None: + with open_spinner(message) as spinner: + call_subprocess( + cmd, + command_desc=message, + cwd=cwd, + extra_environ=extra_environ, + spinner=spinner, + ) + + return runner diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/temp_dir.py b/.venv/lib/python3.12/site-packages/pip/_internal/utils/temp_dir.py new file mode 100644 index 0000000..06668e8 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/utils/temp_dir.py @@ -0,0 +1,296 @@ +import errno +import itertools +import logging +import os.path +import tempfile +import traceback +from contextlib import ExitStack, contextmanager +from pathlib import Path +from typing import ( + Any, + Callable, + Dict, + Generator, + List, + Optional, + TypeVar, + Union, +) + +from pip._internal.utils.misc import enum, rmtree + +logger = logging.getLogger(__name__) + +_T = TypeVar("_T", bound="TempDirectory") + + +# Kinds of temporary directories. Only needed for ones that are +# globally-managed. +tempdir_kinds = enum( + BUILD_ENV="build-env", + EPHEM_WHEEL_CACHE="ephem-wheel-cache", + REQ_BUILD="req-build", +) + + +_tempdir_manager: Optional[ExitStack] = None + + +@contextmanager +def global_tempdir_manager() -> Generator[None, None, None]: + global _tempdir_manager + with ExitStack() as stack: + old_tempdir_manager, _tempdir_manager = _tempdir_manager, stack + try: + yield + finally: + _tempdir_manager = old_tempdir_manager + + +class TempDirectoryTypeRegistry: + """Manages temp directory behavior""" + + def __init__(self) -> None: + self._should_delete: Dict[str, bool] = {} + + def set_delete(self, kind: str, value: bool) -> None: + """Indicate whether a TempDirectory of the given kind should be + auto-deleted. + """ + self._should_delete[kind] = value + + def get_delete(self, kind: str) -> bool: + """Get configured auto-delete flag for a given TempDirectory type, + default True. + """ + return self._should_delete.get(kind, True) + + +_tempdir_registry: Optional[TempDirectoryTypeRegistry] = None + + +@contextmanager +def tempdir_registry() -> Generator[TempDirectoryTypeRegistry, None, None]: + """Provides a scoped global tempdir registry that can be used to dictate + whether directories should be deleted. + """ + global _tempdir_registry + old_tempdir_registry = _tempdir_registry + _tempdir_registry = TempDirectoryTypeRegistry() + try: + yield _tempdir_registry + finally: + _tempdir_registry = old_tempdir_registry + + +class _Default: + pass + + +_default = _Default() + + +class TempDirectory: + """Helper class that owns and cleans up a temporary directory. + + This class can be used as a context manager or as an OO representation of a + temporary directory. + + Attributes: + path + Location to the created temporary directory + delete + Whether the directory should be deleted when exiting + (when used as a contextmanager) + + Methods: + cleanup() + Deletes the temporary directory + + When used as a context manager, if the delete attribute is True, on + exiting the context the temporary directory is deleted. + """ + + def __init__( + self, + path: Optional[str] = None, + delete: Union[bool, None, _Default] = _default, + kind: str = "temp", + globally_managed: bool = False, + ignore_cleanup_errors: bool = True, + ): + super().__init__() + + if delete is _default: + if path is not None: + # If we were given an explicit directory, resolve delete option + # now. + delete = False + else: + # Otherwise, we wait until cleanup and see what + # tempdir_registry says. + delete = None + + # The only time we specify path is in for editables where it + # is the value of the --src option. + if path is None: + path = self._create(kind) + + self._path = path + self._deleted = False + self.delete = delete + self.kind = kind + self.ignore_cleanup_errors = ignore_cleanup_errors + + if globally_managed: + assert _tempdir_manager is not None + _tempdir_manager.enter_context(self) + + @property + def path(self) -> str: + assert not self._deleted, f"Attempted to access deleted path: {self._path}" + return self._path + + def __repr__(self) -> str: + return f"<{self.__class__.__name__} {self.path!r}>" + + def __enter__(self: _T) -> _T: + return self + + def __exit__(self, exc: Any, value: Any, tb: Any) -> None: + if self.delete is not None: + delete = self.delete + elif _tempdir_registry: + delete = _tempdir_registry.get_delete(self.kind) + else: + delete = True + + if delete: + self.cleanup() + + def _create(self, kind: str) -> str: + """Create a temporary directory and store its path in self.path""" + # We realpath here because some systems have their default tmpdir + # symlinked to another directory. This tends to confuse build + # scripts, so we canonicalize the path by traversing potential + # symlinks here. + path = os.path.realpath(tempfile.mkdtemp(prefix=f"pip-{kind}-")) + logger.debug("Created temporary directory: %s", path) + return path + + def cleanup(self) -> None: + """Remove the temporary directory created and reset state""" + self._deleted = True + if not os.path.exists(self._path): + return + + errors: List[BaseException] = [] + + def onerror( + func: Callable[..., Any], + path: Path, + exc_val: BaseException, + ) -> None: + """Log a warning for a `rmtree` error and continue""" + formatted_exc = "\n".join( + traceback.format_exception_only(type(exc_val), exc_val) + ) + formatted_exc = formatted_exc.rstrip() # remove trailing new line + if func in (os.unlink, os.remove, os.rmdir): + logger.debug( + "Failed to remove a temporary file '%s' due to %s.\n", + path, + formatted_exc, + ) + else: + logger.debug("%s failed with %s.", func.__qualname__, formatted_exc) + errors.append(exc_val) + + if self.ignore_cleanup_errors: + try: + # first try with @retry; retrying to handle ephemeral errors + rmtree(self._path, ignore_errors=False) + except OSError: + # last pass ignore/log all errors + rmtree(self._path, onexc=onerror) + if errors: + logger.warning( + "Failed to remove contents in a temporary directory '%s'.\n" + "You can safely remove it manually.", + self._path, + ) + else: + rmtree(self._path) + + +class AdjacentTempDirectory(TempDirectory): + """Helper class that creates a temporary directory adjacent to a real one. + + Attributes: + original + The original directory to create a temp directory for. + path + After calling create() or entering, contains the full + path to the temporary directory. + delete + Whether the directory should be deleted when exiting + (when used as a contextmanager) + + """ + + # The characters that may be used to name the temp directory + # We always prepend a ~ and then rotate through these until + # a usable name is found. + # pkg_resources raises a different error for .dist-info folder + # with leading '-' and invalid metadata + LEADING_CHARS = "-~.=%0123456789" + + def __init__(self, original: str, delete: Optional[bool] = None) -> None: + self.original = original.rstrip("/\\") + super().__init__(delete=delete) + + @classmethod + def _generate_names(cls, name: str) -> Generator[str, None, None]: + """Generates a series of temporary names. + + The algorithm replaces the leading characters in the name + with ones that are valid filesystem characters, but are not + valid package names (for both Python and pip definitions of + package). + """ + for i in range(1, len(name)): + for candidate in itertools.combinations_with_replacement( + cls.LEADING_CHARS, i - 1 + ): + new_name = "~" + "".join(candidate) + name[i:] + if new_name != name: + yield new_name + + # If we make it this far, we will have to make a longer name + for i in range(len(cls.LEADING_CHARS)): + for candidate in itertools.combinations_with_replacement( + cls.LEADING_CHARS, i + ): + new_name = "~" + "".join(candidate) + name + if new_name != name: + yield new_name + + def _create(self, kind: str) -> str: + root, name = os.path.split(self.original) + for candidate in self._generate_names(name): + path = os.path.join(root, candidate) + try: + os.mkdir(path) + except OSError as ex: + # Continue if the name exists already + if ex.errno != errno.EEXIST: + raise + else: + path = os.path.realpath(path) + break + else: + # Final fallback on the default behavior. + path = os.path.realpath(tempfile.mkdtemp(prefix=f"pip-{kind}-")) + + logger.debug("Created temporary directory: %s", path) + return path diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/unpacking.py b/.venv/lib/python3.12/site-packages/pip/_internal/utils/unpacking.py new file mode 100644 index 0000000..875e30e --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/utils/unpacking.py @@ -0,0 +1,337 @@ +"""Utilities related archives. +""" + +import logging +import os +import shutil +import stat +import sys +import tarfile +import zipfile +from typing import Iterable, List, Optional +from zipfile import ZipInfo + +from pip._internal.exceptions import InstallationError +from pip._internal.utils.filetypes import ( + BZ2_EXTENSIONS, + TAR_EXTENSIONS, + XZ_EXTENSIONS, + ZIP_EXTENSIONS, +) +from pip._internal.utils.misc import ensure_dir + +logger = logging.getLogger(__name__) + + +SUPPORTED_EXTENSIONS = ZIP_EXTENSIONS + TAR_EXTENSIONS + +try: + import bz2 # noqa + + SUPPORTED_EXTENSIONS += BZ2_EXTENSIONS +except ImportError: + logger.debug("bz2 module is not available") + +try: + # Only for Python 3.3+ + import lzma # noqa + + SUPPORTED_EXTENSIONS += XZ_EXTENSIONS +except ImportError: + logger.debug("lzma module is not available") + + +def current_umask() -> int: + """Get the current umask which involves having to set it temporarily.""" + mask = os.umask(0) + os.umask(mask) + return mask + + +def split_leading_dir(path: str) -> List[str]: + path = path.lstrip("/").lstrip("\\") + if "/" in path and ( + ("\\" in path and path.find("/") < path.find("\\")) or "\\" not in path + ): + return path.split("/", 1) + elif "\\" in path: + return path.split("\\", 1) + else: + return [path, ""] + + +def has_leading_dir(paths: Iterable[str]) -> bool: + """Returns true if all the paths have the same leading path name + (i.e., everything is in one subdirectory in an archive)""" + common_prefix = None + for path in paths: + prefix, rest = split_leading_dir(path) + if not prefix: + return False + elif common_prefix is None: + common_prefix = prefix + elif prefix != common_prefix: + return False + return True + + +def is_within_directory(directory: str, target: str) -> bool: + """ + Return true if the absolute path of target is within the directory + """ + abs_directory = os.path.abspath(directory) + abs_target = os.path.abspath(target) + + prefix = os.path.commonprefix([abs_directory, abs_target]) + return prefix == abs_directory + + +def _get_default_mode_plus_executable() -> int: + return 0o777 & ~current_umask() | 0o111 + + +def set_extracted_file_to_default_mode_plus_executable(path: str) -> None: + """ + Make file present at path have execute for user/group/world + (chmod +x) is no-op on windows per python docs + """ + os.chmod(path, _get_default_mode_plus_executable()) + + +def zip_item_is_executable(info: ZipInfo) -> bool: + mode = info.external_attr >> 16 + # if mode and regular file and any execute permissions for + # user/group/world? + return bool(mode and stat.S_ISREG(mode) and mode & 0o111) + + +def unzip_file(filename: str, location: str, flatten: bool = True) -> None: + """ + Unzip the file (with path `filename`) to the destination `location`. All + files are written based on system defaults and umask (i.e. permissions are + not preserved), except that regular file members with any execute + permissions (user, group, or world) have "chmod +x" applied after being + written. Note that for windows, any execute changes using os.chmod are + no-ops per the python docs. + """ + ensure_dir(location) + zipfp = open(filename, "rb") + try: + zip = zipfile.ZipFile(zipfp, allowZip64=True) + leading = has_leading_dir(zip.namelist()) and flatten + for info in zip.infolist(): + name = info.filename + fn = name + if leading: + fn = split_leading_dir(name)[1] + fn = os.path.join(location, fn) + dir = os.path.dirname(fn) + if not is_within_directory(location, fn): + message = ( + "The zip file ({}) has a file ({}) trying to install " + "outside target directory ({})" + ) + raise InstallationError(message.format(filename, fn, location)) + if fn.endswith("/") or fn.endswith("\\"): + # A directory + ensure_dir(fn) + else: + ensure_dir(dir) + # Don't use read() to avoid allocating an arbitrarily large + # chunk of memory for the file's content + fp = zip.open(name) + try: + with open(fn, "wb") as destfp: + shutil.copyfileobj(fp, destfp) + finally: + fp.close() + if zip_item_is_executable(info): + set_extracted_file_to_default_mode_plus_executable(fn) + finally: + zipfp.close() + + +def untar_file(filename: str, location: str) -> None: + """ + Untar the file (with path `filename`) to the destination `location`. + All files are written based on system defaults and umask (i.e. permissions + are not preserved), except that regular file members with any execute + permissions (user, group, or world) have "chmod +x" applied on top of the + default. Note that for windows, any execute changes using os.chmod are + no-ops per the python docs. + """ + ensure_dir(location) + if filename.lower().endswith(".gz") or filename.lower().endswith(".tgz"): + mode = "r:gz" + elif filename.lower().endswith(BZ2_EXTENSIONS): + mode = "r:bz2" + elif filename.lower().endswith(XZ_EXTENSIONS): + mode = "r:xz" + elif filename.lower().endswith(".tar"): + mode = "r" + else: + logger.warning( + "Cannot determine compression type for file %s", + filename, + ) + mode = "r:*" + + tar = tarfile.open(filename, mode, encoding="utf-8") + try: + leading = has_leading_dir([member.name for member in tar.getmembers()]) + + # PEP 706 added `tarfile.data_filter`, and made some other changes to + # Python's tarfile module (see below). The features were backported to + # security releases. + try: + data_filter = tarfile.data_filter + except AttributeError: + _untar_without_filter(filename, location, tar, leading) + else: + default_mode_plus_executable = _get_default_mode_plus_executable() + + if leading: + # Strip the leading directory from all files in the archive, + # including hardlink targets (which are relative to the + # unpack location). + for member in tar.getmembers(): + name_lead, name_rest = split_leading_dir(member.name) + member.name = name_rest + if member.islnk(): + lnk_lead, lnk_rest = split_leading_dir(member.linkname) + if lnk_lead == name_lead: + member.linkname = lnk_rest + + def pip_filter(member: tarfile.TarInfo, path: str) -> tarfile.TarInfo: + orig_mode = member.mode + try: + try: + member = data_filter(member, location) + except tarfile.LinkOutsideDestinationError: + if sys.version_info[:3] in { + (3, 8, 17), + (3, 9, 17), + (3, 10, 12), + (3, 11, 4), + }: + # The tarfile filter in specific Python versions + # raises LinkOutsideDestinationError on valid input + # (https://github.com/python/cpython/issues/107845) + # Ignore the error there, but do use the + # more lax `tar_filter` + member = tarfile.tar_filter(member, location) + else: + raise + except tarfile.TarError as exc: + message = "Invalid member in the tar file {}: {}" + # Filter error messages mention the member name. + # No need to add it here. + raise InstallationError( + message.format( + filename, + exc, + ) + ) + if member.isfile() and orig_mode & 0o111: + member.mode = default_mode_plus_executable + else: + # See PEP 706 note above. + # The PEP changed this from `int` to `Optional[int]`, + # where None means "use the default". Mypy doesn't + # know this yet. + member.mode = None # type: ignore [assignment] + return member + + tar.extractall(location, filter=pip_filter) + + finally: + tar.close() + + +def _untar_without_filter( + filename: str, + location: str, + tar: tarfile.TarFile, + leading: bool, +) -> None: + """Fallback for Python without tarfile.data_filter""" + for member in tar.getmembers(): + fn = member.name + if leading: + fn = split_leading_dir(fn)[1] + path = os.path.join(location, fn) + if not is_within_directory(location, path): + message = ( + "The tar file ({}) has a file ({}) trying to install " + "outside target directory ({})" + ) + raise InstallationError(message.format(filename, path, location)) + if member.isdir(): + ensure_dir(path) + elif member.issym(): + try: + tar._extract_member(member, path) + except Exception as exc: + # Some corrupt tar files seem to produce this + # (specifically bad symlinks) + logger.warning( + "In the tar file %s the member %s is invalid: %s", + filename, + member.name, + exc, + ) + continue + else: + try: + fp = tar.extractfile(member) + except (KeyError, AttributeError) as exc: + # Some corrupt tar files seem to produce this + # (specifically bad symlinks) + logger.warning( + "In the tar file %s the member %s is invalid: %s", + filename, + member.name, + exc, + ) + continue + ensure_dir(os.path.dirname(path)) + assert fp is not None + with open(path, "wb") as destfp: + shutil.copyfileobj(fp, destfp) + fp.close() + # Update the timestamp (useful for cython compiled files) + tar.utime(member, path) + # member have any execute permissions for user/group/world? + if member.mode & 0o111: + set_extracted_file_to_default_mode_plus_executable(path) + + +def unpack_file( + filename: str, + location: str, + content_type: Optional[str] = None, +) -> None: + filename = os.path.realpath(filename) + if ( + content_type == "application/zip" + or filename.lower().endswith(ZIP_EXTENSIONS) + or zipfile.is_zipfile(filename) + ): + unzip_file(filename, location, flatten=not filename.endswith(".whl")) + elif ( + content_type == "application/x-gzip" + or tarfile.is_tarfile(filename) + or filename.lower().endswith(TAR_EXTENSIONS + BZ2_EXTENSIONS + XZ_EXTENSIONS) + ): + untar_file(filename, location) + else: + # FIXME: handle? + # FIXME: magic signatures? + logger.critical( + "Cannot unpack file %s (downloaded from %s, content-type: %s); " + "cannot detect archive format", + filename, + location, + content_type, + ) + raise InstallationError(f"Cannot determine archive format of {location}") diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/urls.py b/.venv/lib/python3.12/site-packages/pip/_internal/utils/urls.py new file mode 100644 index 0000000..9f34f88 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/utils/urls.py @@ -0,0 +1,55 @@ +import os +import string +import urllib.parse +import urllib.request + +from .compat import WINDOWS + + +def path_to_url(path: str) -> str: + """ + Convert a path to a file: URL. The path will be made absolute and have + quoted path parts. + """ + path = os.path.normpath(os.path.abspath(path)) + url = urllib.parse.urljoin("file:", urllib.request.pathname2url(path)) + return url + + +def url_to_path(url: str) -> str: + """ + Convert a file: URL to a path. + """ + assert url.startswith( + "file:" + ), f"You can only turn file: urls into filenames (not {url!r})" + + _, netloc, path, _, _ = urllib.parse.urlsplit(url) + + if not netloc or netloc == "localhost": + # According to RFC 8089, same as empty authority. + netloc = "" + elif WINDOWS: + # If we have a UNC path, prepend UNC share notation. + netloc = "\\\\" + netloc + else: + raise ValueError( + f"non-local file URIs are not supported on this platform: {url!r}" + ) + + path = urllib.request.url2pathname(netloc + path) + + # On Windows, urlsplit parses the path as something like "/C:/Users/foo". + # This creates issues for path-related functions like io.open(), so we try + # to detect and strip the leading slash. + if ( + WINDOWS + and not netloc # Not UNC. + and len(path) >= 3 + and path[0] == "/" # Leading slash to strip. + and path[1] in string.ascii_letters # Drive letter. + and path[2:4] in (":", ":/") # Colon + end of string, or colon + absolute path. + ): + path = path[1:] + + return path diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/virtualenv.py b/.venv/lib/python3.12/site-packages/pip/_internal/utils/virtualenv.py new file mode 100644 index 0000000..882e36f --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/utils/virtualenv.py @@ -0,0 +1,104 @@ +import logging +import os +import re +import site +import sys +from typing import List, Optional + +logger = logging.getLogger(__name__) +_INCLUDE_SYSTEM_SITE_PACKAGES_REGEX = re.compile( + r"include-system-site-packages\s*=\s*(?Ptrue|false)" +) + + +def _running_under_venv() -> bool: + """Checks if sys.base_prefix and sys.prefix match. + + This handles PEP 405 compliant virtual environments. + """ + return sys.prefix != getattr(sys, "base_prefix", sys.prefix) + + +def _running_under_legacy_virtualenv() -> bool: + """Checks if sys.real_prefix is set. + + This handles virtual environments created with pypa's virtualenv. + """ + # pypa/virtualenv case + return hasattr(sys, "real_prefix") + + +def running_under_virtualenv() -> bool: + """True if we're running inside a virtual environment, False otherwise.""" + return _running_under_venv() or _running_under_legacy_virtualenv() + + +def _get_pyvenv_cfg_lines() -> Optional[List[str]]: + """Reads {sys.prefix}/pyvenv.cfg and returns its contents as list of lines + + Returns None, if it could not read/access the file. + """ + pyvenv_cfg_file = os.path.join(sys.prefix, "pyvenv.cfg") + try: + # Although PEP 405 does not specify, the built-in venv module always + # writes with UTF-8. (pypa/pip#8717) + with open(pyvenv_cfg_file, encoding="utf-8") as f: + return f.read().splitlines() # avoids trailing newlines + except OSError: + return None + + +def _no_global_under_venv() -> bool: + """Check `{sys.prefix}/pyvenv.cfg` for system site-packages inclusion + + PEP 405 specifies that when system site-packages are not supposed to be + visible from a virtual environment, `pyvenv.cfg` must contain the following + line: + + include-system-site-packages = false + + Additionally, log a warning if accessing the file fails. + """ + cfg_lines = _get_pyvenv_cfg_lines() + if cfg_lines is None: + # We're not in a "sane" venv, so assume there is no system + # site-packages access (since that's PEP 405's default state). + logger.warning( + "Could not access 'pyvenv.cfg' despite a virtual environment " + "being active. Assuming global site-packages is not accessible " + "in this environment." + ) + return True + + for line in cfg_lines: + match = _INCLUDE_SYSTEM_SITE_PACKAGES_REGEX.match(line) + if match is not None and match.group("value") == "false": + return True + return False + + +def _no_global_under_legacy_virtualenv() -> bool: + """Check if "no-global-site-packages.txt" exists beside site.py + + This mirrors logic in pypa/virtualenv for determining whether system + site-packages are visible in the virtual environment. + """ + site_mod_dir = os.path.dirname(os.path.abspath(site.__file__)) + no_global_site_packages_file = os.path.join( + site_mod_dir, + "no-global-site-packages.txt", + ) + return os.path.exists(no_global_site_packages_file) + + +def virtualenv_no_global() -> bool: + """Returns a boolean, whether running in venv with no system site-packages.""" + # PEP 405 compliance needs to be checked first since virtualenv >=20 would + # return True for both checks, but is only able to use the PEP 405 config. + if _running_under_venv(): + return _no_global_under_venv() + + if _running_under_legacy_virtualenv(): + return _no_global_under_legacy_virtualenv() + + return False diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/utils/wheel.py b/.venv/lib/python3.12/site-packages/pip/_internal/utils/wheel.py new file mode 100644 index 0000000..f85aee8 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/utils/wheel.py @@ -0,0 +1,134 @@ +"""Support functions for working with wheel files. +""" + +import logging +from email.message import Message +from email.parser import Parser +from typing import Tuple +from zipfile import BadZipFile, ZipFile + +from pip._vendor.packaging.utils import canonicalize_name + +from pip._internal.exceptions import UnsupportedWheel + +VERSION_COMPATIBLE = (1, 0) + + +logger = logging.getLogger(__name__) + + +def parse_wheel(wheel_zip: ZipFile, name: str) -> Tuple[str, Message]: + """Extract information from the provided wheel, ensuring it meets basic + standards. + + Returns the name of the .dist-info directory and the parsed WHEEL metadata. + """ + try: + info_dir = wheel_dist_info_dir(wheel_zip, name) + metadata = wheel_metadata(wheel_zip, info_dir) + version = wheel_version(metadata) + except UnsupportedWheel as e: + raise UnsupportedWheel(f"{name} has an invalid wheel, {e}") + + check_compatibility(version, name) + + return info_dir, metadata + + +def wheel_dist_info_dir(source: ZipFile, name: str) -> str: + """Returns the name of the contained .dist-info directory. + + Raises AssertionError or UnsupportedWheel if not found, >1 found, or + it doesn't match the provided name. + """ + # Zip file path separators must be / + subdirs = {p.split("/", 1)[0] for p in source.namelist()} + + info_dirs = [s for s in subdirs if s.endswith(".dist-info")] + + if not info_dirs: + raise UnsupportedWheel(".dist-info directory not found") + + if len(info_dirs) > 1: + raise UnsupportedWheel( + "multiple .dist-info directories found: {}".format(", ".join(info_dirs)) + ) + + info_dir = info_dirs[0] + + info_dir_name = canonicalize_name(info_dir) + canonical_name = canonicalize_name(name) + if not info_dir_name.startswith(canonical_name): + raise UnsupportedWheel( + f".dist-info directory {info_dir!r} does not start with {canonical_name!r}" + ) + + return info_dir + + +def read_wheel_metadata_file(source: ZipFile, path: str) -> bytes: + try: + return source.read(path) + # BadZipFile for general corruption, KeyError for missing entry, + # and RuntimeError for password-protected files + except (BadZipFile, KeyError, RuntimeError) as e: + raise UnsupportedWheel(f"could not read {path!r} file: {e!r}") + + +def wheel_metadata(source: ZipFile, dist_info_dir: str) -> Message: + """Return the WHEEL metadata of an extracted wheel, if possible. + Otherwise, raise UnsupportedWheel. + """ + path = f"{dist_info_dir}/WHEEL" + # Zip file path separators must be / + wheel_contents = read_wheel_metadata_file(source, path) + + try: + wheel_text = wheel_contents.decode() + except UnicodeDecodeError as e: + raise UnsupportedWheel(f"error decoding {path!r}: {e!r}") + + # FeedParser (used by Parser) does not raise any exceptions. The returned + # message may have .defects populated, but for backwards-compatibility we + # currently ignore them. + return Parser().parsestr(wheel_text) + + +def wheel_version(wheel_data: Message) -> Tuple[int, ...]: + """Given WHEEL metadata, return the parsed Wheel-Version. + Otherwise, raise UnsupportedWheel. + """ + version_text = wheel_data["Wheel-Version"] + if version_text is None: + raise UnsupportedWheel("WHEEL is missing Wheel-Version") + + version = version_text.strip() + + try: + return tuple(map(int, version.split("."))) + except ValueError: + raise UnsupportedWheel(f"invalid Wheel-Version: {version!r}") + + +def check_compatibility(version: Tuple[int, ...], name: str) -> None: + """Raises errors or warns if called with an incompatible Wheel-Version. + + pip should refuse to install a Wheel-Version that's a major series + ahead of what it's compatible with (e.g 2.0 > 1.1); and warn when + installing a version only minor version ahead (e.g 1.2 > 1.1). + + version: a 2-tuple representing a Wheel-Version (Major, Minor) + name: name of wheel or package to raise exception about + + :raises UnsupportedWheel: when an incompatible Wheel-Version is given + """ + if version[0] > VERSION_COMPATIBLE[0]: + raise UnsupportedWheel( + "{}'s Wheel-Version ({}) is not compatible with this version " + "of pip".format(name, ".".join(map(str, version))) + ) + elif version > VERSION_COMPATIBLE: + logger.warning( + "Installing from a newer Wheel-Version (%s)", + ".".join(map(str, version)), + ) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/vcs/__init__.py b/.venv/lib/python3.12/site-packages/pip/_internal/vcs/__init__.py new file mode 100644 index 0000000..b6beddb --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/vcs/__init__.py @@ -0,0 +1,15 @@ +# Expose a limited set of classes and functions so callers outside of +# the vcs package don't need to import deeper than `pip._internal.vcs`. +# (The test directory may still need to import from a vcs sub-package.) +# Import all vcs modules to register each VCS in the VcsSupport object. +import pip._internal.vcs.bazaar +import pip._internal.vcs.git +import pip._internal.vcs.mercurial +import pip._internal.vcs.subversion # noqa: F401 +from pip._internal.vcs.versioncontrol import ( # noqa: F401 + RemoteNotFoundError, + RemoteNotValidError, + is_url, + make_vcs_requirement_url, + vcs, +) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/vcs/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/vcs/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d2584fe108228a1c7687753f7eb11c378c35ff84 GIT binary patch literal 529 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 WHI^{G1@0aBdvg7iPe{o6>c0SOKeNC9 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/vcs/__pycache__/git.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/vcs/__pycache__/git.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a067b893a5eab56e1e8f7943eb576779e8cb90ab GIT binary patch literal 19025 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/vcs/__pycache__/mercurial.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/vcs/__pycache__/mercurial.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a5fae64eeaa45eb37f1deb085e332f2debe1531c GIT binary patch literal 7610 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 ViCFMe^Orqe@)Rb1%!Sx@{13-@xB&nF literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/vcs/__pycache__/versioncontrol.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_internal/vcs/__pycache__/versioncontrol.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f98a8c28813fe7b840808620aa2ac4f13981836b GIT binary patch literal 29006 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 MS^^IQa@kz@KNzz>x&QzG literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/vcs/bazaar.py b/.venv/lib/python3.12/site-packages/pip/_internal/vcs/bazaar.py new file mode 100644 index 0000000..c754b7c --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/vcs/bazaar.py @@ -0,0 +1,112 @@ +import logging +from typing import List, Optional, Tuple + +from pip._internal.utils.misc import HiddenText, display_path +from pip._internal.utils.subprocess import make_command +from pip._internal.utils.urls import path_to_url +from pip._internal.vcs.versioncontrol import ( + AuthInfo, + RemoteNotFoundError, + RevOptions, + VersionControl, + vcs, +) + +logger = logging.getLogger(__name__) + + +class Bazaar(VersionControl): + name = "bzr" + dirname = ".bzr" + repo_name = "branch" + schemes = ( + "bzr+http", + "bzr+https", + "bzr+ssh", + "bzr+sftp", + "bzr+ftp", + "bzr+lp", + "bzr+file", + ) + + @staticmethod + def get_base_rev_args(rev: str) -> List[str]: + return ["-r", rev] + + def fetch_new( + self, dest: str, url: HiddenText, rev_options: RevOptions, verbosity: int + ) -> None: + rev_display = rev_options.to_display() + logger.info( + "Checking out %s%s to %s", + url, + rev_display, + display_path(dest), + ) + if verbosity <= 0: + flags = ["--quiet"] + elif verbosity == 1: + flags = [] + else: + flags = [f"-{'v'*verbosity}"] + cmd_args = make_command( + "checkout", "--lightweight", *flags, rev_options.to_args(), url, dest + ) + self.run_command(cmd_args) + + def switch(self, dest: str, url: HiddenText, rev_options: RevOptions) -> None: + self.run_command(make_command("switch", url), cwd=dest) + + def update(self, dest: str, url: HiddenText, rev_options: RevOptions) -> None: + output = self.run_command( + make_command("info"), show_stdout=False, stdout_only=True, cwd=dest + ) + if output.startswith("Standalone "): + # Older versions of pip used to create standalone branches. + # Convert the standalone branch to a checkout by calling "bzr bind". + cmd_args = make_command("bind", "-q", url) + self.run_command(cmd_args, cwd=dest) + + cmd_args = make_command("update", "-q", rev_options.to_args()) + self.run_command(cmd_args, cwd=dest) + + @classmethod + def get_url_rev_and_auth(cls, url: str) -> Tuple[str, Optional[str], AuthInfo]: + # hotfix the URL scheme after removing bzr+ from bzr+ssh:// re-add it + url, rev, user_pass = super().get_url_rev_and_auth(url) + if url.startswith("ssh://"): + url = "bzr+" + url + return url, rev, user_pass + + @classmethod + def get_remote_url(cls, location: str) -> str: + urls = cls.run_command( + ["info"], show_stdout=False, stdout_only=True, cwd=location + ) + for line in urls.splitlines(): + line = line.strip() + for x in ("checkout of branch: ", "parent branch: "): + if line.startswith(x): + repo = line.split(x)[1] + if cls._is_local_repository(repo): + return path_to_url(repo) + return repo + raise RemoteNotFoundError + + @classmethod + def get_revision(cls, location: str) -> str: + revision = cls.run_command( + ["revno"], + show_stdout=False, + stdout_only=True, + cwd=location, + ) + return revision.splitlines()[-1] + + @classmethod + def is_commit_id_equal(cls, dest: str, name: Optional[str]) -> bool: + """Always assume the versions don't match""" + return False + + +vcs.register(Bazaar) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/vcs/git.py b/.venv/lib/python3.12/site-packages/pip/_internal/vcs/git.py new file mode 100644 index 0000000..0425deb --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/vcs/git.py @@ -0,0 +1,527 @@ +import logging +import os.path +import pathlib +import re +import urllib.parse +import urllib.request +from dataclasses import replace +from typing import List, Optional, Tuple + +from pip._internal.exceptions import BadCommand, InstallationError +from pip._internal.utils.misc import HiddenText, display_path, hide_url +from pip._internal.utils.subprocess import make_command +from pip._internal.vcs.versioncontrol import ( + AuthInfo, + RemoteNotFoundError, + RemoteNotValidError, + RevOptions, + VersionControl, + find_path_to_project_root_from_repo_root, + vcs, +) + +urlsplit = urllib.parse.urlsplit +urlunsplit = urllib.parse.urlunsplit + + +logger = logging.getLogger(__name__) + + +GIT_VERSION_REGEX = re.compile( + r"^git version " # Prefix. + r"(\d+)" # Major. + r"\.(\d+)" # Dot, minor. + r"(?:\.(\d+))?" # Optional dot, patch. + r".*$" # Suffix, including any pre- and post-release segments we don't care about. +) + +HASH_REGEX = re.compile("^[a-fA-F0-9]{40}$") + +# SCP (Secure copy protocol) shorthand. e.g. 'git@example.com:foo/bar.git' +SCP_REGEX = re.compile( + r"""^ + # Optional user, e.g. 'git@' + (\w+@)? + # Server, e.g. 'github.com'. + ([^/:]+): + # The server-side path. e.g. 'user/project.git'. Must start with an + # alphanumeric character so as not to be confusable with a Windows paths + # like 'C:/foo/bar' or 'C:\foo\bar'. + (\w[^:]*) + $""", + re.VERBOSE, +) + + +def looks_like_hash(sha: str) -> bool: + return bool(HASH_REGEX.match(sha)) + + +class Git(VersionControl): + name = "git" + dirname = ".git" + repo_name = "clone" + schemes = ( + "git+http", + "git+https", + "git+ssh", + "git+git", + "git+file", + ) + # Prevent the user's environment variables from interfering with pip: + # https://github.com/pypa/pip/issues/1130 + unset_environ = ("GIT_DIR", "GIT_WORK_TREE") + default_arg_rev = "HEAD" + + @staticmethod + def get_base_rev_args(rev: str) -> List[str]: + return [rev] + + def is_immutable_rev_checkout(self, url: str, dest: str) -> bool: + _, rev_options = self.get_url_rev_options(hide_url(url)) + if not rev_options.rev: + return False + if not self.is_commit_id_equal(dest, rev_options.rev): + # the current commit is different from rev, + # which means rev was something else than a commit hash + return False + # return False in the rare case rev is both a commit hash + # and a tag or a branch; we don't want to cache in that case + # because that branch/tag could point to something else in the future + is_tag_or_branch = bool(self.get_revision_sha(dest, rev_options.rev)[0]) + return not is_tag_or_branch + + def get_git_version(self) -> Tuple[int, ...]: + version = self.run_command( + ["version"], + command_desc="git version", + show_stdout=False, + stdout_only=True, + ) + match = GIT_VERSION_REGEX.match(version) + if not match: + logger.warning("Can't parse git version: %s", version) + return () + return (int(match.group(1)), int(match.group(2))) + + @classmethod + def get_current_branch(cls, location: str) -> Optional[str]: + """ + Return the current branch, or None if HEAD isn't at a branch + (e.g. detached HEAD). + """ + # git-symbolic-ref exits with empty stdout if "HEAD" is a detached + # HEAD rather than a symbolic ref. In addition, the -q causes the + # command to exit with status code 1 instead of 128 in this case + # and to suppress the message to stderr. + args = ["symbolic-ref", "-q", "HEAD"] + output = cls.run_command( + args, + extra_ok_returncodes=(1,), + show_stdout=False, + stdout_only=True, + cwd=location, + ) + ref = output.strip() + + if ref.startswith("refs/heads/"): + return ref[len("refs/heads/") :] + + return None + + @classmethod + def get_revision_sha(cls, dest: str, rev: str) -> Tuple[Optional[str], bool]: + """ + Return (sha_or_none, is_branch), where sha_or_none is a commit hash + if the revision names a remote branch or tag, otherwise None. + + Args: + dest: the repository directory. + rev: the revision name. + """ + # Pass rev to pre-filter the list. + output = cls.run_command( + ["show-ref", rev], + cwd=dest, + show_stdout=False, + stdout_only=True, + on_returncode="ignore", + ) + refs = {} + # NOTE: We do not use splitlines here since that would split on other + # unicode separators, which can be maliciously used to install a + # different revision. + for line in output.strip().split("\n"): + line = line.rstrip("\r") + if not line: + continue + try: + ref_sha, ref_name = line.split(" ", maxsplit=2) + except ValueError: + # Include the offending line to simplify troubleshooting if + # this error ever occurs. + raise ValueError(f"unexpected show-ref line: {line!r}") + + refs[ref_name] = ref_sha + + branch_ref = f"refs/remotes/origin/{rev}" + tag_ref = f"refs/tags/{rev}" + + sha = refs.get(branch_ref) + if sha is not None: + return (sha, True) + + sha = refs.get(tag_ref) + + return (sha, False) + + @classmethod + def _should_fetch(cls, dest: str, rev: str) -> bool: + """ + Return true if rev is a ref or is a commit that we don't have locally. + + Branches and tags are not considered in this method because they are + assumed to be always available locally (which is a normal outcome of + ``git clone`` and ``git fetch --tags``). + """ + if rev.startswith("refs/"): + # Always fetch remote refs. + return True + + if not looks_like_hash(rev): + # Git fetch would fail with abbreviated commits. + return False + + if cls.has_commit(dest, rev): + # Don't fetch if we have the commit locally. + return False + + return True + + @classmethod + def resolve_revision( + cls, dest: str, url: HiddenText, rev_options: RevOptions + ) -> RevOptions: + """ + Resolve a revision to a new RevOptions object with the SHA1 of the + branch, tag, or ref if found. + + Args: + rev_options: a RevOptions object. + """ + rev = rev_options.arg_rev + # The arg_rev property's implementation for Git ensures that the + # rev return value is always non-None. + assert rev is not None + + sha, is_branch = cls.get_revision_sha(dest, rev) + + if sha is not None: + rev_options = rev_options.make_new(sha) + rev_options = replace(rev_options, branch_name=(rev if is_branch else None)) + + return rev_options + + # Do not show a warning for the common case of something that has + # the form of a Git commit hash. + if not looks_like_hash(rev): + logger.warning( + "Did not find branch or tag '%s', assuming revision or ref.", + rev, + ) + + if not cls._should_fetch(dest, rev): + return rev_options + + # fetch the requested revision + cls.run_command( + make_command("fetch", "-q", url, rev_options.to_args()), + cwd=dest, + ) + # Change the revision to the SHA of the ref we fetched + sha = cls.get_revision(dest, rev="FETCH_HEAD") + rev_options = rev_options.make_new(sha) + + return rev_options + + @classmethod + def is_commit_id_equal(cls, dest: str, name: Optional[str]) -> bool: + """ + Return whether the current commit hash equals the given name. + + Args: + dest: the repository directory. + name: a string name. + """ + if not name: + # Then avoid an unnecessary subprocess call. + return False + + return cls.get_revision(dest) == name + + def fetch_new( + self, dest: str, url: HiddenText, rev_options: RevOptions, verbosity: int + ) -> None: + rev_display = rev_options.to_display() + logger.info("Cloning %s%s to %s", url, rev_display, display_path(dest)) + if verbosity <= 0: + flags: Tuple[str, ...] = ("--quiet",) + elif verbosity == 1: + flags = () + else: + flags = ("--verbose", "--progress") + if self.get_git_version() >= (2, 17): + # Git added support for partial clone in 2.17 + # https://git-scm.com/docs/partial-clone + # Speeds up cloning by functioning without a complete copy of repository + self.run_command( + make_command( + "clone", + "--filter=blob:none", + *flags, + url, + dest, + ) + ) + else: + self.run_command(make_command("clone", *flags, url, dest)) + + if rev_options.rev: + # Then a specific revision was requested. + rev_options = self.resolve_revision(dest, url, rev_options) + branch_name = getattr(rev_options, "branch_name", None) + logger.debug("Rev options %s, branch_name %s", rev_options, branch_name) + if branch_name is None: + # Only do a checkout if the current commit id doesn't match + # the requested revision. + if not self.is_commit_id_equal(dest, rev_options.rev): + cmd_args = make_command( + "checkout", + "-q", + rev_options.to_args(), + ) + self.run_command(cmd_args, cwd=dest) + elif self.get_current_branch(dest) != branch_name: + # Then a specific branch was requested, and that branch + # is not yet checked out. + track_branch = f"origin/{branch_name}" + cmd_args = [ + "checkout", + "-b", + branch_name, + "--track", + track_branch, + ] + self.run_command(cmd_args, cwd=dest) + else: + sha = self.get_revision(dest) + rev_options = rev_options.make_new(sha) + + logger.info("Resolved %s to commit %s", url, rev_options.rev) + + #: repo may contain submodules + self.update_submodules(dest) + + def switch(self, dest: str, url: HiddenText, rev_options: RevOptions) -> None: + self.run_command( + make_command("config", "remote.origin.url", url), + cwd=dest, + ) + cmd_args = make_command("checkout", "-q", rev_options.to_args()) + self.run_command(cmd_args, cwd=dest) + + self.update_submodules(dest) + + def update(self, dest: str, url: HiddenText, rev_options: RevOptions) -> None: + # First fetch changes from the default remote + if self.get_git_version() >= (1, 9): + # fetch tags in addition to everything else + self.run_command(["fetch", "-q", "--tags"], cwd=dest) + else: + self.run_command(["fetch", "-q"], cwd=dest) + # Then reset to wanted revision (maybe even origin/master) + rev_options = self.resolve_revision(dest, url, rev_options) + cmd_args = make_command("reset", "--hard", "-q", rev_options.to_args()) + self.run_command(cmd_args, cwd=dest) + #: update submodules + self.update_submodules(dest) + + @classmethod + def get_remote_url(cls, location: str) -> str: + """ + Return URL of the first remote encountered. + + Raises RemoteNotFoundError if the repository does not have a remote + url configured. + """ + # We need to pass 1 for extra_ok_returncodes since the command + # exits with return code 1 if there are no matching lines. + stdout = cls.run_command( + ["config", "--get-regexp", r"remote\..*\.url"], + extra_ok_returncodes=(1,), + show_stdout=False, + stdout_only=True, + cwd=location, + ) + remotes = stdout.splitlines() + try: + found_remote = remotes[0] + except IndexError: + raise RemoteNotFoundError + + for remote in remotes: + if remote.startswith("remote.origin.url "): + found_remote = remote + break + url = found_remote.split(" ")[1] + return cls._git_remote_to_pip_url(url.strip()) + + @staticmethod + def _git_remote_to_pip_url(url: str) -> str: + """ + Convert a remote url from what git uses to what pip accepts. + + There are 3 legal forms **url** may take: + + 1. A fully qualified url: ssh://git@example.com/foo/bar.git + 2. A local project.git folder: /path/to/bare/repository.git + 3. SCP shorthand for form 1: git@example.com:foo/bar.git + + Form 1 is output as-is. Form 2 must be converted to URI and form 3 must + be converted to form 1. + + See the corresponding test test_git_remote_url_to_pip() for examples of + sample inputs/outputs. + """ + if re.match(r"\w+://", url): + # This is already valid. Pass it though as-is. + return url + if os.path.exists(url): + # A local bare remote (git clone --mirror). + # Needs a file:// prefix. + return pathlib.PurePath(url).as_uri() + scp_match = SCP_REGEX.match(url) + if scp_match: + # Add an ssh:// prefix and replace the ':' with a '/'. + return scp_match.expand(r"ssh://\1\2/\3") + # Otherwise, bail out. + raise RemoteNotValidError(url) + + @classmethod + def has_commit(cls, location: str, rev: str) -> bool: + """ + Check if rev is a commit that is available in the local repository. + """ + try: + cls.run_command( + ["rev-parse", "-q", "--verify", "sha^" + rev], + cwd=location, + log_failed_cmd=False, + ) + except InstallationError: + return False + else: + return True + + @classmethod + def get_revision(cls, location: str, rev: Optional[str] = None) -> str: + if rev is None: + rev = "HEAD" + current_rev = cls.run_command( + ["rev-parse", rev], + show_stdout=False, + stdout_only=True, + cwd=location, + ) + return current_rev.strip() + + @classmethod + def get_subdirectory(cls, location: str) -> Optional[str]: + """ + Return the path to Python project root, relative to the repo root. + Return None if the project root is in the repo root. + """ + # find the repo root + git_dir = cls.run_command( + ["rev-parse", "--git-dir"], + show_stdout=False, + stdout_only=True, + cwd=location, + ).strip() + if not os.path.isabs(git_dir): + git_dir = os.path.join(location, git_dir) + repo_root = os.path.abspath(os.path.join(git_dir, "..")) + return find_path_to_project_root_from_repo_root(location, repo_root) + + @classmethod + def get_url_rev_and_auth(cls, url: str) -> Tuple[str, Optional[str], AuthInfo]: + """ + Prefixes stub URLs like 'user@hostname:user/repo.git' with 'ssh://'. + That's required because although they use SSH they sometimes don't + work with a ssh:// scheme (e.g. GitHub). But we need a scheme for + parsing. Hence we remove it again afterwards and return it as a stub. + """ + # Works around an apparent Git bug + # (see https://article.gmane.org/gmane.comp.version-control.git/146500) + scheme, netloc, path, query, fragment = urlsplit(url) + if scheme.endswith("file"): + initial_slashes = path[: -len(path.lstrip("/"))] + newpath = initial_slashes + urllib.request.url2pathname(path).replace( + "\\", "/" + ).lstrip("/") + after_plus = scheme.find("+") + 1 + url = scheme[:after_plus] + urlunsplit( + (scheme[after_plus:], netloc, newpath, query, fragment), + ) + + if "://" not in url: + assert "file:" not in url + url = url.replace("git+", "git+ssh://") + url, rev, user_pass = super().get_url_rev_and_auth(url) + url = url.replace("ssh://", "") + else: + url, rev, user_pass = super().get_url_rev_and_auth(url) + + return url, rev, user_pass + + @classmethod + def update_submodules(cls, location: str) -> None: + if not os.path.exists(os.path.join(location, ".gitmodules")): + return + cls.run_command( + ["submodule", "update", "--init", "--recursive", "-q"], + cwd=location, + ) + + @classmethod + def get_repository_root(cls, location: str) -> Optional[str]: + loc = super().get_repository_root(location) + if loc: + return loc + try: + r = cls.run_command( + ["rev-parse", "--show-toplevel"], + cwd=location, + show_stdout=False, + stdout_only=True, + on_returncode="raise", + log_failed_cmd=False, + ) + except BadCommand: + logger.debug( + "could not determine if %s is under git control " + "because git is not available", + location, + ) + return None + except InstallationError: + return None + return os.path.normpath(r.rstrip("\r\n")) + + @staticmethod + def should_add_vcs_url_prefix(repo_url: str) -> bool: + """In either https or ssh form, requirements must be prefixed with git+.""" + return True + + +vcs.register(Git) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/vcs/mercurial.py b/.venv/lib/python3.12/site-packages/pip/_internal/vcs/mercurial.py new file mode 100644 index 0000000..c183d41 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/vcs/mercurial.py @@ -0,0 +1,163 @@ +import configparser +import logging +import os +from typing import List, Optional, Tuple + +from pip._internal.exceptions import BadCommand, InstallationError +from pip._internal.utils.misc import HiddenText, display_path +from pip._internal.utils.subprocess import make_command +from pip._internal.utils.urls import path_to_url +from pip._internal.vcs.versioncontrol import ( + RevOptions, + VersionControl, + find_path_to_project_root_from_repo_root, + vcs, +) + +logger = logging.getLogger(__name__) + + +class Mercurial(VersionControl): + name = "hg" + dirname = ".hg" + repo_name = "clone" + schemes = ( + "hg+file", + "hg+http", + "hg+https", + "hg+ssh", + "hg+static-http", + ) + + @staticmethod + def get_base_rev_args(rev: str) -> List[str]: + return [f"--rev={rev}"] + + def fetch_new( + self, dest: str, url: HiddenText, rev_options: RevOptions, verbosity: int + ) -> None: + rev_display = rev_options.to_display() + logger.info( + "Cloning hg %s%s to %s", + url, + rev_display, + display_path(dest), + ) + if verbosity <= 0: + flags: Tuple[str, ...] = ("--quiet",) + elif verbosity == 1: + flags = () + elif verbosity == 2: + flags = ("--verbose",) + else: + flags = ("--verbose", "--debug") + self.run_command(make_command("clone", "--noupdate", *flags, url, dest)) + self.run_command( + make_command("update", *flags, rev_options.to_args()), + cwd=dest, + ) + + def switch(self, dest: str, url: HiddenText, rev_options: RevOptions) -> None: + repo_config = os.path.join(dest, self.dirname, "hgrc") + config = configparser.RawConfigParser() + try: + config.read(repo_config) + config.set("paths", "default", url.secret) + with open(repo_config, "w") as config_file: + config.write(config_file) + except (OSError, configparser.NoSectionError) as exc: + logger.warning("Could not switch Mercurial repository to %s: %s", url, exc) + else: + cmd_args = make_command("update", "-q", rev_options.to_args()) + self.run_command(cmd_args, cwd=dest) + + def update(self, dest: str, url: HiddenText, rev_options: RevOptions) -> None: + self.run_command(["pull", "-q"], cwd=dest) + cmd_args = make_command("update", "-q", rev_options.to_args()) + self.run_command(cmd_args, cwd=dest) + + @classmethod + def get_remote_url(cls, location: str) -> str: + url = cls.run_command( + ["showconfig", "paths.default"], + show_stdout=False, + stdout_only=True, + cwd=location, + ).strip() + if cls._is_local_repository(url): + url = path_to_url(url) + return url.strip() + + @classmethod + def get_revision(cls, location: str) -> str: + """ + Return the repository-local changeset revision number, as an integer. + """ + current_revision = cls.run_command( + ["parents", "--template={rev}"], + show_stdout=False, + stdout_only=True, + cwd=location, + ).strip() + return current_revision + + @classmethod + def get_requirement_revision(cls, location: str) -> str: + """ + Return the changeset identification hash, as a 40-character + hexadecimal string + """ + current_rev_hash = cls.run_command( + ["parents", "--template={node}"], + show_stdout=False, + stdout_only=True, + cwd=location, + ).strip() + return current_rev_hash + + @classmethod + def is_commit_id_equal(cls, dest: str, name: Optional[str]) -> bool: + """Always assume the versions don't match""" + return False + + @classmethod + def get_subdirectory(cls, location: str) -> Optional[str]: + """ + Return the path to Python project root, relative to the repo root. + Return None if the project root is in the repo root. + """ + # find the repo root + repo_root = cls.run_command( + ["root"], show_stdout=False, stdout_only=True, cwd=location + ).strip() + if not os.path.isabs(repo_root): + repo_root = os.path.abspath(os.path.join(location, repo_root)) + return find_path_to_project_root_from_repo_root(location, repo_root) + + @classmethod + def get_repository_root(cls, location: str) -> Optional[str]: + loc = super().get_repository_root(location) + if loc: + return loc + try: + r = cls.run_command( + ["root"], + cwd=location, + show_stdout=False, + stdout_only=True, + on_returncode="raise", + log_failed_cmd=False, + ) + except BadCommand: + logger.debug( + "could not determine if %s is under hg control " + "because hg is not available", + location, + ) + return None + except InstallationError: + return None + return os.path.normpath(r.rstrip("\r\n")) + + +vcs.register(Mercurial) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/vcs/subversion.py b/.venv/lib/python3.12/site-packages/pip/_internal/vcs/subversion.py new file mode 100644 index 0000000..f359266 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/vcs/subversion.py @@ -0,0 +1,324 @@ +import logging +import os +import re +from typing import List, Optional, Tuple + +from pip._internal.utils.misc import ( + HiddenText, + display_path, + is_console_interactive, + is_installable_dir, + split_auth_from_netloc, +) +from pip._internal.utils.subprocess import CommandArgs, make_command +from pip._internal.vcs.versioncontrol import ( + AuthInfo, + RemoteNotFoundError, + RevOptions, + VersionControl, + vcs, +) + +logger = logging.getLogger(__name__) + +_svn_xml_url_re = re.compile('url="([^"]+)"') +_svn_rev_re = re.compile(r'committed-rev="(\d+)"') +_svn_info_xml_rev_re = re.compile(r'\s*revision="(\d+)"') +_svn_info_xml_url_re = re.compile(r"(.*)") + + +class Subversion(VersionControl): + name = "svn" + dirname = ".svn" + repo_name = "checkout" + schemes = ("svn+ssh", "svn+http", "svn+https", "svn+svn", "svn+file") + + @classmethod + def should_add_vcs_url_prefix(cls, remote_url: str) -> bool: + return True + + @staticmethod + def get_base_rev_args(rev: str) -> List[str]: + return ["-r", rev] + + @classmethod + def get_revision(cls, location: str) -> str: + """ + Return the maximum revision for all files under a given location + """ + # Note: taken from setuptools.command.egg_info + revision = 0 + + for base, dirs, _ in os.walk(location): + if cls.dirname not in dirs: + dirs[:] = [] + continue # no sense walking uncontrolled subdirs + dirs.remove(cls.dirname) + entries_fn = os.path.join(base, cls.dirname, "entries") + if not os.path.exists(entries_fn): + # FIXME: should we warn? + continue + + dirurl, localrev = cls._get_svn_url_rev(base) + + if base == location: + assert dirurl is not None + base = dirurl + "/" # save the root url + elif not dirurl or not dirurl.startswith(base): + dirs[:] = [] + continue # not part of the same svn tree, skip it + revision = max(revision, localrev) + return str(revision) + + @classmethod + def get_netloc_and_auth( + cls, netloc: str, scheme: str + ) -> Tuple[str, Tuple[Optional[str], Optional[str]]]: + """ + This override allows the auth information to be passed to svn via the + --username and --password options instead of via the URL. + """ + if scheme == "ssh": + # The --username and --password options can't be used for + # svn+ssh URLs, so keep the auth information in the URL. + return super().get_netloc_and_auth(netloc, scheme) + + return split_auth_from_netloc(netloc) + + @classmethod + def get_url_rev_and_auth(cls, url: str) -> Tuple[str, Optional[str], AuthInfo]: + # hotfix the URL scheme after removing svn+ from svn+ssh:// re-add it + url, rev, user_pass = super().get_url_rev_and_auth(url) + if url.startswith("ssh://"): + url = "svn+" + url + return url, rev, user_pass + + @staticmethod + def make_rev_args( + username: Optional[str], password: Optional[HiddenText] + ) -> CommandArgs: + extra_args: CommandArgs = [] + if username: + extra_args += ["--username", username] + if password: + extra_args += ["--password", password] + + return extra_args + + @classmethod + def get_remote_url(cls, location: str) -> str: + # In cases where the source is in a subdirectory, we have to look up in + # the location until we find a valid project root. + orig_location = location + while not is_installable_dir(location): + last_location = location + location = os.path.dirname(location) + if location == last_location: + # We've traversed up to the root of the filesystem without + # finding a Python project. + logger.warning( + "Could not find Python project for directory %s (tried all " + "parent directories)", + orig_location, + ) + raise RemoteNotFoundError + + url, _rev = cls._get_svn_url_rev(location) + if url is None: + raise RemoteNotFoundError + + return url + + @classmethod + def _get_svn_url_rev(cls, location: str) -> Tuple[Optional[str], int]: + from pip._internal.exceptions import InstallationError + + entries_path = os.path.join(location, cls.dirname, "entries") + if os.path.exists(entries_path): + with open(entries_path) as f: + data = f.read() + else: # subversion >= 1.7 does not have the 'entries' file + data = "" + + url = None + if data.startswith("8") or data.startswith("9") or data.startswith("10"): + entries = list(map(str.splitlines, data.split("\n\x0c\n"))) + del entries[0][0] # get rid of the '8' + url = entries[0][3] + revs = [int(d[9]) for d in entries if len(d) > 9 and d[9]] + [0] + elif data.startswith("= 1.7 + # Note that using get_remote_call_options is not necessary here + # because `svn info` is being run against a local directory. + # We don't need to worry about making sure interactive mode + # is being used to prompt for passwords, because passwords + # are only potentially needed for remote server requests. + xml = cls.run_command( + ["info", "--xml", location], + show_stdout=False, + stdout_only=True, + ) + match = _svn_info_xml_url_re.search(xml) + assert match is not None + url = match.group(1) + revs = [int(m.group(1)) for m in _svn_info_xml_rev_re.finditer(xml)] + except InstallationError: + url, revs = None, [] + + if revs: + rev = max(revs) + else: + rev = 0 + + return url, rev + + @classmethod + def is_commit_id_equal(cls, dest: str, name: Optional[str]) -> bool: + """Always assume the versions don't match""" + return False + + def __init__(self, use_interactive: Optional[bool] = None) -> None: + if use_interactive is None: + use_interactive = is_console_interactive() + self.use_interactive = use_interactive + + # This member is used to cache the fetched version of the current + # ``svn`` client. + # Special value definitions: + # None: Not evaluated yet. + # Empty tuple: Could not parse version. + self._vcs_version: Optional[Tuple[int, ...]] = None + + super().__init__() + + def call_vcs_version(self) -> Tuple[int, ...]: + """Query the version of the currently installed Subversion client. + + :return: A tuple containing the parts of the version information or + ``()`` if the version returned from ``svn`` could not be parsed. + :raises: BadCommand: If ``svn`` is not installed. + """ + # Example versions: + # svn, version 1.10.3 (r1842928) + # compiled Feb 25 2019, 14:20:39 on x86_64-apple-darwin17.0.0 + # svn, version 1.7.14 (r1542130) + # compiled Mar 28 2018, 08:49:13 on x86_64-pc-linux-gnu + # svn, version 1.12.0-SlikSvn (SlikSvn/1.12.0) + # compiled May 28 2019, 13:44:56 on x86_64-microsoft-windows6.2 + version_prefix = "svn, version " + version = self.run_command(["--version"], show_stdout=False, stdout_only=True) + if not version.startswith(version_prefix): + return () + + version = version[len(version_prefix) :].split()[0] + version_list = version.partition("-")[0].split(".") + try: + parsed_version = tuple(map(int, version_list)) + except ValueError: + return () + + return parsed_version + + def get_vcs_version(self) -> Tuple[int, ...]: + """Return the version of the currently installed Subversion client. + + If the version of the Subversion client has already been queried, + a cached value will be used. + + :return: A tuple containing the parts of the version information or + ``()`` if the version returned from ``svn`` could not be parsed. + :raises: BadCommand: If ``svn`` is not installed. + """ + if self._vcs_version is not None: + # Use cached version, if available. + # If parsing the version failed previously (empty tuple), + # do not attempt to parse it again. + return self._vcs_version + + vcs_version = self.call_vcs_version() + self._vcs_version = vcs_version + return vcs_version + + def get_remote_call_options(self) -> CommandArgs: + """Return options to be used on calls to Subversion that contact the server. + + These options are applicable for the following ``svn`` subcommands used + in this class. + + - checkout + - switch + - update + + :return: A list of command line arguments to pass to ``svn``. + """ + if not self.use_interactive: + # --non-interactive switch is available since Subversion 0.14.4. + # Subversion < 1.8 runs in interactive mode by default. + return ["--non-interactive"] + + svn_version = self.get_vcs_version() + # By default, Subversion >= 1.8 runs in non-interactive mode if + # stdin is not a TTY. Since that is how pip invokes SVN, in + # call_subprocess(), pip must pass --force-interactive to ensure + # the user can be prompted for a password, if required. + # SVN added the --force-interactive option in SVN 1.8. Since + # e.g. RHEL/CentOS 7, which is supported until 2024, ships with + # SVN 1.7, pip should continue to support SVN 1.7. Therefore, pip + # can't safely add the option if the SVN version is < 1.8 (or unknown). + if svn_version >= (1, 8): + return ["--force-interactive"] + + return [] + + def fetch_new( + self, dest: str, url: HiddenText, rev_options: RevOptions, verbosity: int + ) -> None: + rev_display = rev_options.to_display() + logger.info( + "Checking out %s%s to %s", + url, + rev_display, + display_path(dest), + ) + if verbosity <= 0: + flags = ["--quiet"] + else: + flags = [] + cmd_args = make_command( + "checkout", + *flags, + self.get_remote_call_options(), + rev_options.to_args(), + url, + dest, + ) + self.run_command(cmd_args) + + def switch(self, dest: str, url: HiddenText, rev_options: RevOptions) -> None: + cmd_args = make_command( + "switch", + self.get_remote_call_options(), + rev_options.to_args(), + url, + dest, + ) + self.run_command(cmd_args) + + def update(self, dest: str, url: HiddenText, rev_options: RevOptions) -> None: + cmd_args = make_command( + "update", + self.get_remote_call_options(), + rev_options.to_args(), + dest, + ) + self.run_command(cmd_args) + + +vcs.register(Subversion) diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/vcs/versioncontrol.py b/.venv/lib/python3.12/site-packages/pip/_internal/vcs/versioncontrol.py new file mode 100644 index 0000000..a413316 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/vcs/versioncontrol.py @@ -0,0 +1,688 @@ +"""Handles all VCS (version control) support""" + +import logging +import os +import shutil +import sys +import urllib.parse +from dataclasses import dataclass, field +from typing import ( + Any, + Dict, + Iterable, + Iterator, + List, + Literal, + Mapping, + Optional, + Tuple, + Type, + Union, +) + +from pip._internal.cli.spinners import SpinnerInterface +from pip._internal.exceptions import BadCommand, InstallationError +from pip._internal.utils.misc import ( + HiddenText, + ask_path_exists, + backup_dir, + display_path, + hide_url, + hide_value, + is_installable_dir, + rmtree, +) +from pip._internal.utils.subprocess import ( + CommandArgs, + call_subprocess, + format_command_args, + make_command, +) + +__all__ = ["vcs"] + + +logger = logging.getLogger(__name__) + +AuthInfo = Tuple[Optional[str], Optional[str]] + + +def is_url(name: str) -> bool: + """ + Return true if the name looks like a URL. + """ + scheme = urllib.parse.urlsplit(name).scheme + if not scheme: + return False + return scheme in ["http", "https", "file", "ftp"] + vcs.all_schemes + + +def make_vcs_requirement_url( + repo_url: str, rev: str, project_name: str, subdir: Optional[str] = None +) -> str: + """ + Return the URL for a VCS requirement. + + Args: + repo_url: the remote VCS url, with any needed VCS prefix (e.g. "git+"). + project_name: the (unescaped) project name. + """ + egg_project_name = project_name.replace("-", "_") + req = f"{repo_url}@{rev}#egg={egg_project_name}" + if subdir: + req += f"&subdirectory={subdir}" + + return req + + +def find_path_to_project_root_from_repo_root( + location: str, repo_root: str +) -> Optional[str]: + """ + Find the the Python project's root by searching up the filesystem from + `location`. Return the path to project root relative to `repo_root`. + Return None if the project root is `repo_root`, or cannot be found. + """ + # find project root. + orig_location = location + while not is_installable_dir(location): + last_location = location + location = os.path.dirname(location) + if location == last_location: + # We've traversed up to the root of the filesystem without + # finding a Python project. + logger.warning( + "Could not find a Python project for directory %s (tried all " + "parent directories)", + orig_location, + ) + return None + + if os.path.samefile(repo_root, location): + return None + + return os.path.relpath(location, repo_root) + + +class RemoteNotFoundError(Exception): + pass + + +class RemoteNotValidError(Exception): + def __init__(self, url: str): + super().__init__(url) + self.url = url + + +@dataclass(frozen=True) +class RevOptions: + """ + Encapsulates a VCS-specific revision to install, along with any VCS + install options. + + Args: + vc_class: a VersionControl subclass. + rev: the name of the revision to install. + extra_args: a list of extra options. + """ + + vc_class: Type["VersionControl"] + rev: Optional[str] = None + extra_args: CommandArgs = field(default_factory=list) + branch_name: Optional[str] = None + + def __repr__(self) -> str: + return f"" + + @property + def arg_rev(self) -> Optional[str]: + if self.rev is None: + return self.vc_class.default_arg_rev + + return self.rev + + def to_args(self) -> CommandArgs: + """ + Return the VCS-specific command arguments. + """ + args: CommandArgs = [] + rev = self.arg_rev + if rev is not None: + args += self.vc_class.get_base_rev_args(rev) + args += self.extra_args + + return args + + def to_display(self) -> str: + if not self.rev: + return "" + + return f" (to revision {self.rev})" + + def make_new(self, rev: str) -> "RevOptions": + """ + Make a copy of the current instance, but with a new rev. + + Args: + rev: the name of the revision for the new object. + """ + return self.vc_class.make_rev_options(rev, extra_args=self.extra_args) + + +class VcsSupport: + _registry: Dict[str, "VersionControl"] = {} + schemes = ["ssh", "git", "hg", "bzr", "sftp", "svn"] + + def __init__(self) -> None: + # Register more schemes with urlparse for various version control + # systems + urllib.parse.uses_netloc.extend(self.schemes) + super().__init__() + + def __iter__(self) -> Iterator[str]: + return self._registry.__iter__() + + @property + def backends(self) -> List["VersionControl"]: + return list(self._registry.values()) + + @property + def dirnames(self) -> List[str]: + return [backend.dirname for backend in self.backends] + + @property + def all_schemes(self) -> List[str]: + schemes: List[str] = [] + for backend in self.backends: + schemes.extend(backend.schemes) + return schemes + + def register(self, cls: Type["VersionControl"]) -> None: + if not hasattr(cls, "name"): + logger.warning("Cannot register VCS %s", cls.__name__) + return + if cls.name not in self._registry: + self._registry[cls.name] = cls() + logger.debug("Registered VCS backend: %s", cls.name) + + def unregister(self, name: str) -> None: + if name in self._registry: + del self._registry[name] + + def get_backend_for_dir(self, location: str) -> Optional["VersionControl"]: + """ + Return a VersionControl object if a repository of that type is found + at the given directory. + """ + vcs_backends = {} + for vcs_backend in self._registry.values(): + repo_path = vcs_backend.get_repository_root(location) + if not repo_path: + continue + logger.debug("Determine that %s uses VCS: %s", location, vcs_backend.name) + vcs_backends[repo_path] = vcs_backend + + if not vcs_backends: + return None + + # Choose the VCS in the inner-most directory. Since all repository + # roots found here would be either `location` or one of its + # parents, the longest path should have the most path components, + # i.e. the backend representing the inner-most repository. + inner_most_repo_path = max(vcs_backends, key=len) + return vcs_backends[inner_most_repo_path] + + def get_backend_for_scheme(self, scheme: str) -> Optional["VersionControl"]: + """ + Return a VersionControl object or None. + """ + for vcs_backend in self._registry.values(): + if scheme in vcs_backend.schemes: + return vcs_backend + return None + + def get_backend(self, name: str) -> Optional["VersionControl"]: + """ + Return a VersionControl object or None. + """ + name = name.lower() + return self._registry.get(name) + + +vcs = VcsSupport() + + +class VersionControl: + name = "" + dirname = "" + repo_name = "" + # List of supported schemes for this Version Control + schemes: Tuple[str, ...] = () + # Iterable of environment variable names to pass to call_subprocess(). + unset_environ: Tuple[str, ...] = () + default_arg_rev: Optional[str] = None + + @classmethod + def should_add_vcs_url_prefix(cls, remote_url: str) -> bool: + """ + Return whether the vcs prefix (e.g. "git+") should be added to a + repository's remote url when used in a requirement. + """ + return not remote_url.lower().startswith(f"{cls.name}:") + + @classmethod + def get_subdirectory(cls, location: str) -> Optional[str]: + """ + Return the path to Python project root, relative to the repo root. + Return None if the project root is in the repo root. + """ + return None + + @classmethod + def get_requirement_revision(cls, repo_dir: str) -> str: + """ + Return the revision string that should be used in a requirement. + """ + return cls.get_revision(repo_dir) + + @classmethod + def get_src_requirement(cls, repo_dir: str, project_name: str) -> str: + """ + Return the requirement string to use to redownload the files + currently at the given repository directory. + + Args: + project_name: the (unescaped) project name. + + The return value has a form similar to the following: + + {repository_url}@{revision}#egg={project_name} + """ + repo_url = cls.get_remote_url(repo_dir) + + if cls.should_add_vcs_url_prefix(repo_url): + repo_url = f"{cls.name}+{repo_url}" + + revision = cls.get_requirement_revision(repo_dir) + subdir = cls.get_subdirectory(repo_dir) + req = make_vcs_requirement_url(repo_url, revision, project_name, subdir=subdir) + + return req + + @staticmethod + def get_base_rev_args(rev: str) -> List[str]: + """ + Return the base revision arguments for a vcs command. + + Args: + rev: the name of a revision to install. Cannot be None. + """ + raise NotImplementedError + + def is_immutable_rev_checkout(self, url: str, dest: str) -> bool: + """ + Return true if the commit hash checked out at dest matches + the revision in url. + + Always return False, if the VCS does not support immutable commit + hashes. + + This method does not check if there are local uncommitted changes + in dest after checkout, as pip currently has no use case for that. + """ + return False + + @classmethod + def make_rev_options( + cls, rev: Optional[str] = None, extra_args: Optional[CommandArgs] = None + ) -> RevOptions: + """ + Return a RevOptions object. + + Args: + rev: the name of a revision to install. + extra_args: a list of extra options. + """ + return RevOptions(cls, rev, extra_args=extra_args or []) + + @classmethod + def _is_local_repository(cls, repo: str) -> bool: + """ + posix absolute paths start with os.path.sep, + win32 ones start with drive (like c:\\folder) + """ + drive, tail = os.path.splitdrive(repo) + return repo.startswith(os.path.sep) or bool(drive) + + @classmethod + def get_netloc_and_auth( + cls, netloc: str, scheme: str + ) -> Tuple[str, Tuple[Optional[str], Optional[str]]]: + """ + Parse the repository URL's netloc, and return the new netloc to use + along with auth information. + + Args: + netloc: the original repository URL netloc. + scheme: the repository URL's scheme without the vcs prefix. + + This is mainly for the Subversion class to override, so that auth + information can be provided via the --username and --password options + instead of through the URL. For other subclasses like Git without + such an option, auth information must stay in the URL. + + Returns: (netloc, (username, password)). + """ + return netloc, (None, None) + + @classmethod + def get_url_rev_and_auth(cls, url: str) -> Tuple[str, Optional[str], AuthInfo]: + """ + Parse the repository URL to use, and return the URL, revision, + and auth info to use. + + Returns: (url, rev, (username, password)). + """ + scheme, netloc, path, query, frag = urllib.parse.urlsplit(url) + if "+" not in scheme: + raise ValueError( + f"Sorry, {url!r} is a malformed VCS url. " + "The format is +://, " + "e.g. svn+http://myrepo/svn/MyApp#egg=MyApp" + ) + # Remove the vcs prefix. + scheme = scheme.split("+", 1)[1] + netloc, user_pass = cls.get_netloc_and_auth(netloc, scheme) + rev = None + if "@" in path: + path, rev = path.rsplit("@", 1) + if not rev: + raise InstallationError( + f"The URL {url!r} has an empty revision (after @) " + "which is not supported. Include a revision after @ " + "or remove @ from the URL." + ) + url = urllib.parse.urlunsplit((scheme, netloc, path, query, "")) + return url, rev, user_pass + + @staticmethod + def make_rev_args( + username: Optional[str], password: Optional[HiddenText] + ) -> CommandArgs: + """ + Return the RevOptions "extra arguments" to use in obtain(). + """ + return [] + + def get_url_rev_options(self, url: HiddenText) -> Tuple[HiddenText, RevOptions]: + """ + Return the URL and RevOptions object to use in obtain(), + as a tuple (url, rev_options). + """ + secret_url, rev, user_pass = self.get_url_rev_and_auth(url.secret) + username, secret_password = user_pass + password: Optional[HiddenText] = None + if secret_password is not None: + password = hide_value(secret_password) + extra_args = self.make_rev_args(username, password) + rev_options = self.make_rev_options(rev, extra_args=extra_args) + + return hide_url(secret_url), rev_options + + @staticmethod + def normalize_url(url: str) -> str: + """ + Normalize a URL for comparison by unquoting it and removing any + trailing slash. + """ + return urllib.parse.unquote(url).rstrip("/") + + @classmethod + def compare_urls(cls, url1: str, url2: str) -> bool: + """ + Compare two repo URLs for identity, ignoring incidental differences. + """ + return cls.normalize_url(url1) == cls.normalize_url(url2) + + def fetch_new( + self, dest: str, url: HiddenText, rev_options: RevOptions, verbosity: int + ) -> None: + """ + Fetch a revision from a repository, in the case that this is the + first fetch from the repository. + + Args: + dest: the directory to fetch the repository to. + rev_options: a RevOptions object. + verbosity: verbosity level. + """ + raise NotImplementedError + + def switch(self, dest: str, url: HiddenText, rev_options: RevOptions) -> None: + """ + Switch the repo at ``dest`` to point to ``URL``. + + Args: + rev_options: a RevOptions object. + """ + raise NotImplementedError + + def update(self, dest: str, url: HiddenText, rev_options: RevOptions) -> None: + """ + Update an already-existing repo to the given ``rev_options``. + + Args: + rev_options: a RevOptions object. + """ + raise NotImplementedError + + @classmethod + def is_commit_id_equal(cls, dest: str, name: Optional[str]) -> bool: + """ + Return whether the id of the current commit equals the given name. + + Args: + dest: the repository directory. + name: a string name. + """ + raise NotImplementedError + + def obtain(self, dest: str, url: HiddenText, verbosity: int) -> None: + """ + Install or update in editable mode the package represented by this + VersionControl object. + + :param dest: the repository directory in which to install or update. + :param url: the repository URL starting with a vcs prefix. + :param verbosity: verbosity level. + """ + url, rev_options = self.get_url_rev_options(url) + + if not os.path.exists(dest): + self.fetch_new(dest, url, rev_options, verbosity=verbosity) + return + + rev_display = rev_options.to_display() + if self.is_repository_directory(dest): + existing_url = self.get_remote_url(dest) + if self.compare_urls(existing_url, url.secret): + logger.debug( + "%s in %s exists, and has correct URL (%s)", + self.repo_name.title(), + display_path(dest), + url, + ) + if not self.is_commit_id_equal(dest, rev_options.rev): + logger.info( + "Updating %s %s%s", + display_path(dest), + self.repo_name, + rev_display, + ) + self.update(dest, url, rev_options) + else: + logger.info("Skipping because already up-to-date.") + return + + logger.warning( + "%s %s in %s exists with URL %s", + self.name, + self.repo_name, + display_path(dest), + existing_url, + ) + prompt = ("(s)witch, (i)gnore, (w)ipe, (b)ackup ", ("s", "i", "w", "b")) + else: + logger.warning( + "Directory %s already exists, and is not a %s %s.", + dest, + self.name, + self.repo_name, + ) + # https://github.com/python/mypy/issues/1174 + prompt = ("(i)gnore, (w)ipe, (b)ackup ", ("i", "w", "b")) # type: ignore + + logger.warning( + "The plan is to install the %s repository %s", + self.name, + url, + ) + response = ask_path_exists(f"What to do? {prompt[0]}", prompt[1]) + + if response == "a": + sys.exit(-1) + + if response == "w": + logger.warning("Deleting %s", display_path(dest)) + rmtree(dest) + self.fetch_new(dest, url, rev_options, verbosity=verbosity) + return + + if response == "b": + dest_dir = backup_dir(dest) + logger.warning("Backing up %s to %s", display_path(dest), dest_dir) + shutil.move(dest, dest_dir) + self.fetch_new(dest, url, rev_options, verbosity=verbosity) + return + + # Do nothing if the response is "i". + if response == "s": + logger.info( + "Switching %s %s to %s%s", + self.repo_name, + display_path(dest), + url, + rev_display, + ) + self.switch(dest, url, rev_options) + + def unpack(self, location: str, url: HiddenText, verbosity: int) -> None: + """ + Clean up current location and download the url repository + (and vcs infos) into location + + :param url: the repository URL starting with a vcs prefix. + :param verbosity: verbosity level. + """ + if os.path.exists(location): + rmtree(location) + self.obtain(location, url=url, verbosity=verbosity) + + @classmethod + def get_remote_url(cls, location: str) -> str: + """ + Return the url used at location + + Raises RemoteNotFoundError if the repository does not have a remote + url configured. + """ + raise NotImplementedError + + @classmethod + def get_revision(cls, location: str) -> str: + """ + Return the current commit id of the files at the given location. + """ + raise NotImplementedError + + @classmethod + def run_command( + cls, + cmd: Union[List[str], CommandArgs], + show_stdout: bool = True, + cwd: Optional[str] = None, + on_returncode: 'Literal["raise", "warn", "ignore"]' = "raise", + extra_ok_returncodes: Optional[Iterable[int]] = None, + command_desc: Optional[str] = None, + extra_environ: Optional[Mapping[str, Any]] = None, + spinner: Optional[SpinnerInterface] = None, + log_failed_cmd: bool = True, + stdout_only: bool = False, + ) -> str: + """ + Run a VCS subcommand + This is simply a wrapper around call_subprocess that adds the VCS + command name, and checks that the VCS is available + """ + cmd = make_command(cls.name, *cmd) + if command_desc is None: + command_desc = format_command_args(cmd) + try: + return call_subprocess( + cmd, + show_stdout, + cwd, + on_returncode=on_returncode, + extra_ok_returncodes=extra_ok_returncodes, + command_desc=command_desc, + extra_environ=extra_environ, + unset_environ=cls.unset_environ, + spinner=spinner, + log_failed_cmd=log_failed_cmd, + stdout_only=stdout_only, + ) + except NotADirectoryError: + raise BadCommand(f"Cannot find command {cls.name!r} - invalid PATH") + except FileNotFoundError: + # errno.ENOENT = no such file or directory + # In other words, the VCS executable isn't available + raise BadCommand( + f"Cannot find command {cls.name!r} - do you have " + f"{cls.name!r} installed and in your PATH?" + ) + except PermissionError: + # errno.EACCES = Permission denied + # This error occurs, for instance, when the command is installed + # only for another user. So, the current user don't have + # permission to call the other user command. + raise BadCommand( + f"No permission to execute {cls.name!r} - install it " + f"locally, globally (ask admin), or check your PATH. " + f"See possible solutions at " + f"https://pip.pypa.io/en/latest/reference/pip_freeze/" + f"#fixing-permission-denied." + ) + + @classmethod + def is_repository_directory(cls, path: str) -> bool: + """ + Return whether a directory path is a repository directory. + """ + logger.debug("Checking in %s for %s (%s)...", path, cls.dirname, cls.name) + return os.path.exists(os.path.join(path, cls.dirname)) + + @classmethod + def get_repository_root(cls, location: str) -> Optional[str]: + """ + Return the "root" (top-level) directory controlled by the vcs, + or `None` if the directory is not in any. + + It is meant to be overridden to implement smarter detection + mechanisms for specific vcs. + + This can do more than is_repository_directory() alone. For + example, the Git override checks that Git is actually available. + """ + if cls.is_repository_directory(location): + return location + return None diff --git a/.venv/lib/python3.12/site-packages/pip/_internal/wheel_builder.py b/.venv/lib/python3.12/site-packages/pip/_internal/wheel_builder.py new file mode 100644 index 0000000..93f8e1f --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_internal/wheel_builder.py @@ -0,0 +1,354 @@ +"""Orchestrator for building wheels from InstallRequirements. +""" + +import logging +import os.path +import re +import shutil +from typing import Iterable, List, Optional, Tuple + +from pip._vendor.packaging.utils import canonicalize_name, canonicalize_version +from pip._vendor.packaging.version import InvalidVersion, Version + +from pip._internal.cache import WheelCache +from pip._internal.exceptions import InvalidWheelFilename, UnsupportedWheel +from pip._internal.metadata import FilesystemWheel, get_wheel_distribution +from pip._internal.models.link import Link +from pip._internal.models.wheel import Wheel +from pip._internal.operations.build.wheel import build_wheel_pep517 +from pip._internal.operations.build.wheel_editable import build_wheel_editable +from pip._internal.operations.build.wheel_legacy import build_wheel_legacy +from pip._internal.req.req_install import InstallRequirement +from pip._internal.utils.logging import indent_log +from pip._internal.utils.misc import ensure_dir, hash_file +from pip._internal.utils.setuptools_build import make_setuptools_clean_args +from pip._internal.utils.subprocess import call_subprocess +from pip._internal.utils.temp_dir import TempDirectory +from pip._internal.utils.urls import path_to_url +from pip._internal.vcs import vcs + +logger = logging.getLogger(__name__) + +_egg_info_re = re.compile(r"([a-z0-9_.]+)-([a-z0-9_.!+-]+)", re.IGNORECASE) + +BuildResult = Tuple[List[InstallRequirement], List[InstallRequirement]] + + +def _contains_egg_info(s: str) -> bool: + """Determine whether the string looks like an egg_info. + + :param s: The string to parse. E.g. foo-2.1 + """ + return bool(_egg_info_re.search(s)) + + +def _should_build( + req: InstallRequirement, + need_wheel: bool, +) -> bool: + """Return whether an InstallRequirement should be built into a wheel.""" + if req.constraint: + # never build requirements that are merely constraints + return False + if req.is_wheel: + if need_wheel: + logger.info( + "Skipping %s, due to already being wheel.", + req.name, + ) + return False + + if need_wheel: + # i.e. pip wheel, not pip install + return True + + # From this point, this concerns the pip install command only + # (need_wheel=False). + + if not req.source_dir: + return False + + if req.editable: + # we only build PEP 660 editable requirements + return req.supports_pyproject_editable + + return True + + +def should_build_for_wheel_command( + req: InstallRequirement, +) -> bool: + return _should_build(req, need_wheel=True) + + +def should_build_for_install_command( + req: InstallRequirement, +) -> bool: + return _should_build(req, need_wheel=False) + + +def _should_cache( + req: InstallRequirement, +) -> Optional[bool]: + """ + Return whether a built InstallRequirement can be stored in the persistent + wheel cache, assuming the wheel cache is available, and _should_build() + has determined a wheel needs to be built. + """ + if req.editable or not req.source_dir: + # never cache editable requirements + return False + + if req.link and req.link.is_vcs: + # VCS checkout. Do not cache + # unless it points to an immutable commit hash. + assert not req.editable + assert req.source_dir + vcs_backend = vcs.get_backend_for_scheme(req.link.scheme) + assert vcs_backend + if vcs_backend.is_immutable_rev_checkout(req.link.url, req.source_dir): + return True + return False + + assert req.link + base, ext = req.link.splitext() + if _contains_egg_info(base): + return True + + # Otherwise, do not cache. + return False + + +def _get_cache_dir( + req: InstallRequirement, + wheel_cache: WheelCache, +) -> str: + """Return the persistent or temporary cache directory where the built + wheel need to be stored. + """ + cache_available = bool(wheel_cache.cache_dir) + assert req.link + if cache_available and _should_cache(req): + cache_dir = wheel_cache.get_path_for_link(req.link) + else: + cache_dir = wheel_cache.get_ephem_path_for_link(req.link) + return cache_dir + + +def _verify_one(req: InstallRequirement, wheel_path: str) -> None: + canonical_name = canonicalize_name(req.name or "") + w = Wheel(os.path.basename(wheel_path)) + if canonicalize_name(w.name) != canonical_name: + raise InvalidWheelFilename( + f"Wheel has unexpected file name: expected {canonical_name!r}, " + f"got {w.name!r}", + ) + dist = get_wheel_distribution(FilesystemWheel(wheel_path), canonical_name) + dist_verstr = str(dist.version) + if canonicalize_version(dist_verstr) != canonicalize_version(w.version): + raise InvalidWheelFilename( + f"Wheel has unexpected file name: expected {dist_verstr!r}, " + f"got {w.version!r}", + ) + metadata_version_value = dist.metadata_version + if metadata_version_value is None: + raise UnsupportedWheel("Missing Metadata-Version") + try: + metadata_version = Version(metadata_version_value) + except InvalidVersion: + msg = f"Invalid Metadata-Version: {metadata_version_value}" + raise UnsupportedWheel(msg) + if metadata_version >= Version("1.2") and not isinstance(dist.version, Version): + raise UnsupportedWheel( + f"Metadata 1.2 mandates PEP 440 version, but {dist_verstr!r} is not" + ) + + +def _build_one( + req: InstallRequirement, + output_dir: str, + verify: bool, + build_options: List[str], + global_options: List[str], + editable: bool, +) -> Optional[str]: + """Build one wheel. + + :return: The filename of the built wheel, or None if the build failed. + """ + artifact = "editable" if editable else "wheel" + try: + ensure_dir(output_dir) + except OSError as e: + logger.warning( + "Building %s for %s failed: %s", + artifact, + req.name, + e, + ) + return None + + # Install build deps into temporary directory (PEP 518) + with req.build_env: + wheel_path = _build_one_inside_env( + req, output_dir, build_options, global_options, editable + ) + if wheel_path and verify: + try: + _verify_one(req, wheel_path) + except (InvalidWheelFilename, UnsupportedWheel) as e: + logger.warning("Built %s for %s is invalid: %s", artifact, req.name, e) + return None + return wheel_path + + +def _build_one_inside_env( + req: InstallRequirement, + output_dir: str, + build_options: List[str], + global_options: List[str], + editable: bool, +) -> Optional[str]: + with TempDirectory(kind="wheel") as temp_dir: + assert req.name + if req.use_pep517: + assert req.metadata_directory + assert req.pep517_backend + if global_options: + logger.warning( + "Ignoring --global-option when building %s using PEP 517", req.name + ) + if build_options: + logger.warning( + "Ignoring --build-option when building %s using PEP 517", req.name + ) + if editable: + wheel_path = build_wheel_editable( + name=req.name, + backend=req.pep517_backend, + metadata_directory=req.metadata_directory, + tempd=temp_dir.path, + ) + else: + wheel_path = build_wheel_pep517( + name=req.name, + backend=req.pep517_backend, + metadata_directory=req.metadata_directory, + tempd=temp_dir.path, + ) + else: + wheel_path = build_wheel_legacy( + name=req.name, + setup_py_path=req.setup_py_path, + source_dir=req.unpacked_source_directory, + global_options=global_options, + build_options=build_options, + tempd=temp_dir.path, + ) + + if wheel_path is not None: + wheel_name = os.path.basename(wheel_path) + dest_path = os.path.join(output_dir, wheel_name) + try: + wheel_hash, length = hash_file(wheel_path) + shutil.move(wheel_path, dest_path) + logger.info( + "Created wheel for %s: filename=%s size=%d sha256=%s", + req.name, + wheel_name, + length, + wheel_hash.hexdigest(), + ) + logger.info("Stored in directory: %s", output_dir) + return dest_path + except Exception as e: + logger.warning( + "Building wheel for %s failed: %s", + req.name, + e, + ) + # Ignore return, we can't do anything else useful. + if not req.use_pep517: + _clean_one_legacy(req, global_options) + return None + + +def _clean_one_legacy(req: InstallRequirement, global_options: List[str]) -> bool: + clean_args = make_setuptools_clean_args( + req.setup_py_path, + global_options=global_options, + ) + + logger.info("Running setup.py clean for %s", req.name) + try: + call_subprocess( + clean_args, command_desc="python setup.py clean", cwd=req.source_dir + ) + return True + except Exception: + logger.error("Failed cleaning build dir for %s", req.name) + return False + + +def build( + requirements: Iterable[InstallRequirement], + wheel_cache: WheelCache, + verify: bool, + build_options: List[str], + global_options: List[str], +) -> BuildResult: + """Build wheels. + + :return: The list of InstallRequirement that succeeded to build and + the list of InstallRequirement that failed to build. + """ + if not requirements: + return [], [] + + # Build the wheels. + logger.info( + "Building wheels for collected packages: %s", + ", ".join(req.name for req in requirements), # type: ignore + ) + + with indent_log(): + build_successes, build_failures = [], [] + for req in requirements: + assert req.name + cache_dir = _get_cache_dir(req, wheel_cache) + wheel_file = _build_one( + req, + cache_dir, + verify, + build_options, + global_options, + req.editable and req.permit_editable_wheels, + ) + if wheel_file: + # Record the download origin in the cache + if req.download_info is not None: + # download_info is guaranteed to be set because when we build an + # InstallRequirement it has been through the preparer before, but + # let's be cautious. + wheel_cache.record_download_origin(cache_dir, req.download_info) + # Update the link for this. + req.link = Link(path_to_url(wheel_file)) + req.local_file_path = req.link.file_path + assert req.link.is_wheel + build_successes.append(req) + else: + build_failures.append(req) + + # notify success/failure + if build_successes: + logger.info( + "Successfully built %s", + " ".join([req.name for req in build_successes]), # type: ignore + ) + if build_failures: + logger.info( + "Failed to build %s", + " ".join([req.name for req in build_failures]), # type: ignore + ) + # Return a list of requirements that failed to build + return build_successes, build_failures diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/__init__.py b/.venv/lib/python3.12/site-packages/pip/_vendor/__init__.py new file mode 100644 index 0000000..561089c --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/__init__.py @@ -0,0 +1,116 @@ +""" +pip._vendor is for vendoring dependencies of pip to prevent needing pip to +depend on something external. + +Files inside of pip._vendor should be considered immutable and should only be +updated to versions from upstream. +""" +from __future__ import absolute_import + +import glob +import os.path +import sys + +# Downstream redistributors which have debundled our dependencies should also +# patch this value to be true. This will trigger the additional patching +# to cause things like "six" to be available as pip. +DEBUNDLED = False + +# By default, look in this directory for a bunch of .whl files which we will +# add to the beginning of sys.path before attempting to import anything. This +# is done to support downstream re-distributors like Debian and Fedora who +# wish to create their own Wheels for our dependencies to aid in debundling. +WHEEL_DIR = os.path.abspath(os.path.dirname(__file__)) + + +# Define a small helper function to alias our vendored modules to the real ones +# if the vendored ones do not exist. This idea of this was taken from +# https://github.com/kennethreitz/requests/pull/2567. +def vendored(modulename): + vendored_name = "{0}.{1}".format(__name__, modulename) + + try: + __import__(modulename, globals(), locals(), level=0) + except ImportError: + # We can just silently allow import failures to pass here. If we + # got to this point it means that ``import pip._vendor.whatever`` + # failed and so did ``import whatever``. Since we're importing this + # upfront in an attempt to alias imports, not erroring here will + # just mean we get a regular import error whenever pip *actually* + # tries to import one of these modules to use it, which actually + # gives us a better error message than we would have otherwise + # gotten. + pass + else: + sys.modules[vendored_name] = sys.modules[modulename] + base, head = vendored_name.rsplit(".", 1) + setattr(sys.modules[base], head, sys.modules[modulename]) + + +# If we're operating in a debundled setup, then we want to go ahead and trigger +# the aliasing of our vendored libraries as well as looking for wheels to add +# to our sys.path. This will cause all of this code to be a no-op typically +# however downstream redistributors can enable it in a consistent way across +# all platforms. +if DEBUNDLED: + # Actually look inside of WHEEL_DIR to find .whl files and add them to the + # front of our sys.path. + sys.path[:] = glob.glob(os.path.join(WHEEL_DIR, "*.whl")) + sys.path + + # Actually alias all of our vendored dependencies. + vendored("cachecontrol") + vendored("certifi") + vendored("distlib") + vendored("distro") + vendored("packaging") + vendored("packaging.version") + vendored("packaging.specifiers") + vendored("pkg_resources") + vendored("platformdirs") + vendored("progress") + vendored("pyproject_hooks") + vendored("requests") + vendored("requests.exceptions") + vendored("requests.packages") + vendored("requests.packages.urllib3") + vendored("requests.packages.urllib3._collections") + vendored("requests.packages.urllib3.connection") + vendored("requests.packages.urllib3.connectionpool") + vendored("requests.packages.urllib3.contrib") + vendored("requests.packages.urllib3.contrib.ntlmpool") + vendored("requests.packages.urllib3.contrib.pyopenssl") + vendored("requests.packages.urllib3.exceptions") + vendored("requests.packages.urllib3.fields") + vendored("requests.packages.urllib3.filepost") + vendored("requests.packages.urllib3.packages") + vendored("requests.packages.urllib3.packages.ordered_dict") + vendored("requests.packages.urllib3.packages.six") + vendored("requests.packages.urllib3.packages.ssl_match_hostname") + vendored("requests.packages.urllib3.packages.ssl_match_hostname." + "_implementation") + vendored("requests.packages.urllib3.poolmanager") + vendored("requests.packages.urllib3.request") + vendored("requests.packages.urllib3.response") + vendored("requests.packages.urllib3.util") + vendored("requests.packages.urllib3.util.connection") + vendored("requests.packages.urllib3.util.request") + vendored("requests.packages.urllib3.util.response") + vendored("requests.packages.urllib3.util.retry") + vendored("requests.packages.urllib3.util.ssl_") + vendored("requests.packages.urllib3.util.timeout") + vendored("requests.packages.urllib3.util.url") + vendored("resolvelib") + vendored("rich") + vendored("rich.console") + vendored("rich.highlighter") + vendored("rich.logging") + vendored("rich.markup") + vendored("rich.progress") + vendored("rich.segment") + vendored("rich.style") + vendored("rich.text") + vendored("rich.traceback") + if sys.version_info < (3, 11): + vendored("tomli") + vendored("truststore") + vendored("urllib3") diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b2c3a11c27a467f068c0f506d05abbd41a03d62e GIT binary patch literal 4548 zcmbVOOKcp+5$)OO{c=~N_z@*hpP@*7Rkh44E zo?b~ik^lw>5DEw&8VDc>3E%_>5E>K^9dk^4$srdr96|C}m%u08s84`Er&P~=NVd(T zkpXtPUe)XBp6cqV{bwqbK=8bHe{nM2fzUS`)SpOAc=ZS)bPwq$hjd8~nNl&73rSp- zO*tnABhH0`F_MeuI2R@1>9)F?)o~hD5T6a0T_O)5(y}O3we>NV)Wg3*xfF@chiD{( zh&)~2^P1@!tgw3xr6!W39$5^nUxP%x>q}f9eYZuIb-4$@UQ&9rzE7!&V*-u~I3eK1 z_txeo1$#=sTLj!H;5Gqo6>z(NI|SS*;4T4g6L7bHw+ncOfOiVGN5H!Tyj#F~1iV+k zihz3syidS=0`3>^egPj4@Ie6|5^!3;hXs5@z;6losDLv9&IxrVHNFB1Gr3syb0+D^^KytRi6rZX!1r zp(WMKBogl$CU`MQj-iv9v&PC!!77`&GC>s03J8?wicu_Gmq82lW=R90#$!}FB9Lp>-k~fOBMcJiywOW-7;>qiw z48K<&gBEJIG`-duP!M9ZnupLWRIh)xr8r{Y8UgeyT9+5=v*Myg4?UC@p;z!nLM-Sk zT%Jzy_xk4++5w79IMNVsZb{Rv>*sQ$V?A8o>qoHv+o9Vs+gj&s;y1+Cz9nzM3U;{2 zqX&!_9{ZCA5mFCS3r9m-H@-K>ry&$$&KDTb~|%(;5OwEh0_U}kWA(qDf66% zJ)Q6)kb^~)`LTSyq!vj&?G%=T()cJl6~~VjExiosRZ)^1l8KB8o> zd_H4W{8)Wy+6^o5KI`0t*DQM4x%)|H|59iFpFUi0mpjkRUR=Sg;bG}ntbP96@2~%^ z^6%eD#l4AMIS)KlB^b)^^j7Cu?- z8n}~~!*lwxSnF@)do7=~+#gwL>;1!thaG?E`Ml>*ZYll4$FU#%_jM0ScE3dNaOy=n zil3)J%C)o4I9aJM!@h+S}L-Og2&V-pQLfWc4MGgEm=9IH$#0j^AomK%OQV%NHzb227NEQYH>_+>W}GAvZK)GhQIvtqo=Ugxnq9Qf122g#8b? z2R1Zi@|tCuux#M9e`6j*r&Oi6hrSQXwk*@_ZOUZSm~anoO39R%37HS>j%?1gD;5-b z$1&X|-?Ao-%Em6?{7l_(_cddf#I_vPjMF%t?8biToQy?v0{tSd8yahNXpISual<|N zJsd+o@=%Gi0%VuNc+GG}|F3BoUcXFIgr=$ToN@OzaRX;oR7+4kXtPYHIcOF{xFR-W zJ#qJJyjqzVrkieV&#cMfCU=6n%G9@Ya1)n}y){X=nnOk_Zr>*E_(?T8`oI-4io_~6 z&AWgH_uo(O;$uQ%fEsL|}AS1-!-snZchXcS}{IszxTDo1{a}d6#|O0xv(ztfFc72}a9M z>X=1|AFUOwbekW|=XFb~w#~^hD^qBplu!0C@11_sax%8c3Vz6PXo~COBcsC~TpGDB zI^yHN5`}+ERRIca&?})CPs0B<@EZU5_~__`{K$Jh4SJW4r!Ax8Cu{W_dfcS-IeGQ2 zyJL68?q0rg`Tp={V-LnYyZqqt!uay8lgr6dv+>|oN(6Q6n(x1t{xn@< zUU+a}VaKDfry{ zI?$Z-@Tou;^zey5IPKvxfpE;j1A%bX!{-9woQK~Iga$e5;bVbjz{AJa3+FxjgFw?* zV#LFvpjkoEmc6f$6juJtzw3mDPX@fkdJSJkJ)8+lXFPm%y{}UqJ{@QpTRHCG!S$S) zpSh1byb~;QKl5-WA8P^oGPT#k${NMoFFf4Cu^8F9gT`6x_VAvk(ZrKz_foX`{=t7m dd%udc&3Ah-epHS1t~|!wD>o%b4tg3g?tkZT#i;-Q literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/__pycache__/typing_extensions.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/__pycache__/typing_extensions.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..eef223b322c2f4f6f21001122eb4cd6347210a0e GIT binary patch literal 139544 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 Dxgl#F literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__init__.py b/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__init__.py new file mode 100644 index 0000000..b34b0fc --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__init__.py @@ -0,0 +1,28 @@ +# SPDX-FileCopyrightText: 2015 Eric Larson +# +# SPDX-License-Identifier: Apache-2.0 + +"""CacheControl import Interface. + +Make it easy to import from cachecontrol without long namespaces. +""" +__author__ = "Eric Larson" +__email__ = "eric@ionrock.org" +__version__ = "0.14.0" + +from pip._vendor.cachecontrol.adapter import CacheControlAdapter +from pip._vendor.cachecontrol.controller import CacheController +from pip._vendor.cachecontrol.wrapper import CacheControl + +__all__ = [ + "__author__", + "__email__", + "__version__", + "CacheControlAdapter", + "CacheController", + "CacheControl", +] + +import logging + +logging.getLogger(__name__).addHandler(logging.NullHandler()) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..347299394f75518fdbec90450bfeca5b9c3cc655 GIT binary patch literal 901 zcmaJ<&1=*^6rb6zY?6Me6rorGLf1VsY1NCRYNZGYZNZa}%P`H%W~ZHG!X(?Wd)hz2 zn^zGJO8*oumLe^If*>Bewf5GNFWX(Z7oEeK-+S{ue($~cIyq?}I2UgYTc1h@{VbHx zsSLs8X8`XJLq1~I$E@U+SlKVL3aiRWRQ0PE0j|kfWcbDa8?qjmzKKzYSp6gREqFJj z?b{{9?cKYh0yj6GJjB=9?!6o92o0hZM%vANIE15EjJjsi>g{aMpv^Z_oM|N;5hY4z z&g(eix65vd?u2B?-}GD58sH=_-ir=1gu7!c+iHwZdu?q7EW=5|OwN z88fBb@lIWOO=^%UzyD9S;b4I4px}QJ9%z~*;8sv7_)uB!Hlzwe5r?@M@@x|@*Lj_g zVzlsTQN~`;m_hp7-tI^_RKB1~$bznRytazCrxOmF-4{XI3l!ttmPiB7g|7BJDR#W1 z3-gK}xhoI7RAhV!R<=h&o_f%gH*DS;Z{8zB#3CcaO}bb0wMem!)XH3`WbqDhMxSX7|T;4)>`Ujfr8z*S?2+h8G haE#_p(BctV{MK0gaB$LCJ!-5TH`czRr}_@${tMf)1g-!8 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/_cmd.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/_cmd.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..1c2f68cebd58c6b8b9545ac7a7b524694de36172 GIT binary patch literal 2645 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/cache.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/cache.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..8a177eae48b355b8e3c98d4a2a76685a466b8cd1 GIT binary patch literal 3808 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/filewrapper.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/filewrapper.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..34d0e5b4dcf16b70b46d0b8efed7b20809cc07c1 GIT binary patch literal 4346 zcmc&%T}&L;6~6Pc%l@($Fy_a>V{l@xjoG?!qgu6NAsb@H@g@zZl}V%V?95&7!0gQS z&MbHlR;}uMs1BhZrsQ#Q=RW zUJ=ugZ?KaV{J3V@j;DF1W4l@Cw`a8?H701Wm@#!QQ*B|kZF?X6Mu!lls*S1xB? z^Q95H;zurMmZjxjUhor_CMMo`o4O@Hp?a`SP)b21Y-gcSC6r7G27zM;lTwuI{25V0 zyaR_aVul2D$cP&<)L|oGgrIIQl18i1awjwyF;YeZMxvE)y3OxE9depJje7o+X{8cn zS_|wMQ{Wpf!mKhI3@aLQ%C@0sO1`8xxhbl9%51^Z3(BksQXZuWouRDa6-@hv!l-5_ zrtLY3#-VcMe4er)MFWJ{0<{&dpm|Cjc2!JQ(JjZNAP8Q>`~ZCuc-&)UIErn z4yHS{M{UnloP2;2pby9R>d7?-PE%Vx zQQ!(`uB((?SYM>Y9A$2xfu({+vDeqptt~j>xhG~~?riTKRIdwTSjpb-YU~L3f%sd(qFgP4o$aTwLH`u#i z-Y9^|V-8bX?rTU#pfg`tcFWvgvyOe#QxF@~1jm8VA&v%m;`!kpX2DcQF9)f(aO&E= z;6{3Z4k0Tr4_mthr)(Lx#C8IuD9bynsM$K86ib@!4fAmwu0rF(=mLFV`yw=|#1rZ> zhG2-FN%iORc;wf^4Kd>Y_q$*`Lx(0qD=L67`rf0~b4^I|j{MHC;V3 zJVWi7jAiCBCAi>@{qpds?`K@oqbI>u)7lN{W=du$qk@>>unf01-csgR8Kk2YLxxKb z_EgohO;1(l4mLUBaDDbLXyqzU+$K-Lr0dwHq0f!={XbfeKZtF1c0m>0>>XH;KTK_d z4AC1lhE9X0v(TxMc{0`D17(BH5boDTZ;4)m6JSWF^Egh@VwSancv|$^RP_dhFkcHR zs_M7Y`e}(l8X~@IL*Qropjo#l>%j4NVcrs*oJu9<6gfK}U*N838lAF>sGAle6FI-=yjgYqeTXB?kQPW=>=p`RVUy^<+yd?eZz=%k`5Thfl(iceq%3ZXzfHV&)zXUS5 zyTZWUkNq0RY(m^rXs;w8_iICjFb)31BtyI<*!pwUNDeUd&=QVJq&<*x{5K?OwvvE}+oHo16aA|870Uvb`WE)7&(F(8Wp0BQz zKzLwgXl#DRFgQc{hOCv2vJ{TunS9x!mW2V8PW!PSzs;C*)|ZP#t>lL>>e-GTAGvU0 zbbMTWdvxTYAL5Q$^JhN{iLh*WyIeXP`0`wDQ&;B8$6#~!S5Vw0oAK1r`S;InraG49 z7U!1UTYL{f!|KRiQZGL4Ik+6&N|1f~tFh%+HMN{t6;@BJx4rnNXYf&HclGk}h|we?6{1U|PDec;$nuk5e5B@gQY98$}u{ z{R#H?pIL%t7_|7}I3jEG_cSy-PHhou_=QTzb zugq*;#!*PKJ+R1^T#vCIAO_}a2t?TS<(%VKwGMj)XHVd)%)STJTnv82)j$LB5Z|vh z?MpBnK%T)xF?`?QO9);_F;y)(M%lu4LREhbZ~59xi>exquBxmPck9JshXuS5-0=5; z_!}^RnSx<~iNZYx#U1jk*cOUx9SMa7H{1KSB&?5L;`QTbaytb5?bcZ6@OF1wX#e(+ zo>1SDSE8ZLCtdMSC%+0DFP%U|^JTCWD9Vt2b_5DPfPd#{F2*N)jL>T;<#J?g( b|3)%vB=dKv?JN1%zrv;bub literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/heuristics.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/heuristics.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2fa59f2df82b0e9b8e11b882d2bf2fd498d98ac5 GIT binary patch literal 6693 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 P=6mkE@D&FywvPV=@}>VL literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/serialize.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/serialize.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..37ba7447a1cd9182ac892b2e2dbea46922bce7b1 GIT binary patch literal 5264 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 bI{GE*`Wx%~lI!`WdC3fBy literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/wrapper.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/__pycache__/wrapper.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..102593bf261aa5c0f273080ac598233880879619 GIT binary patch literal 1673 zcmaJ>TW{k;6rPD4$8qZB($MX;WjEUv7ITS#El^f0VhPn=s*OP17hIvpwPzcHZ_GG_ zMy?bjBtY8tR{R1`dE#&IhWcPEMOuVbh&Q7yFMVRhN!k=B6J`9JbG|tFaaK_F!oW?o4#-}o8XB|NkQq0>qN7O_J z5Qi^OZr08_k|w1#f!YdMA;md+!jUyO#iBjw6t!ZC^LEK8Yh?)XXMX0yS^2*tQ#K1< zX0^(Wq)h(7E}+1;pu4UY=z-vu$KBE9Fi#bfb+L zo*Q7#zG>=yfG}0(-?NM$HBmvt=+h1&0bz!Bb%I8Q;`m}aT_`jAZPdXQ2`qyykk%2l zbld78+%&{Nh|`&28gh8_Ed_fZggq&MBm2P+xG;pfFcdzAgoZlEjO@EY282Qg!%WD9 ze3%V$KfnWFVBHl%@G(v9KZltK#e<;-2+rYfXF2OY;hRb}E*LCKEfnZmB$mj@mEwGR zbl13K45CN_(K2kEkhq+#(l>3?a!}CrOw!G@gTTM8s$G!*LXpDZ96c&#r;oFa*Kq?S zAM*rJ2iepCo@DkSn@VgdGp4K$k~P>0SC}q0)R8=uYNK(it8LFgD)tdg^0sBPRl_rp zde0(;THi+QwrX3Os=q@|=w7S8@~TR#0KMev#wYp~BC2osYKziL53A{UhWAuI!@BPy zT=#e4iN;tN;fr+pD*clUI`u$O1@l+-Z#=y7aP2$PTaBt$ey*+@KC{xh_sis5B+60s zay0dHRGEt|D$(ocguy}W? zXKH$6Vp-_U2RlC67{5Ht{zoIqG^5o1MH#l)3615hJAK-g8zeaK5epav9qi&cN>Zj` zsnvSWp$gP$VfJ9f0(Eb>TbQQ;W>p{8Xu|5lgw@9rRv(tfpwup%OH0?JMHv^yNSJjj zW~CJ`j;YUXaoPizy|n+sJZT()3yisNuFunUn_wqk)%88VvkcGB=~#Tr@yw2m-o{s{ z$legLN2i2?5dI|sxcEDG@iBO(50-!BN_~FmF~8F18-4y}pTChv;PPTLGaoHI7d`uY z^xB)z>(`@~my_}ZSc;_Cgrna_g}Ee4zli`U(@BmY5tJ8_JVO#FEhPnpCcuSjiOkR> Zs4gc(hDu None: + logger.setLevel(logging.DEBUG) + handler = logging.StreamHandler() + logger.addHandler(handler) + + +def get_session() -> requests.Session: + adapter = CacheControlAdapter( + DictCache(), cache_etags=True, serializer=None, heuristic=None + ) + sess = requests.Session() + sess.mount("http://", adapter) + sess.mount("https://", adapter) + + sess.cache_controller = adapter.controller # type: ignore[attr-defined] + return sess + + +def get_args() -> Namespace: + parser = ArgumentParser() + parser.add_argument("url", help="The URL to try and cache") + return parser.parse_args() + + +def main() -> None: + args = get_args() + sess = get_session() + + # Make a request to get a response + resp = sess.get(args.url) + + # Turn on logging + setup_logging() + + # try setting the cache + cache_controller: CacheController = ( + sess.cache_controller # type: ignore[attr-defined] + ) + cache_controller.cache_response(resp.request, resp.raw) + + # Now try to get it + if cache_controller.cached_request(resp.request): + print("Cached!") + else: + print("Not cached :(") + + +if __name__ == "__main__": + main() diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/adapter.py b/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/adapter.py new file mode 100644 index 0000000..fbb4ecc --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/adapter.py @@ -0,0 +1,161 @@ +# SPDX-FileCopyrightText: 2015 Eric Larson +# +# SPDX-License-Identifier: Apache-2.0 +from __future__ import annotations + +import functools +import types +import zlib +from typing import TYPE_CHECKING, Any, Collection, Mapping + +from pip._vendor.requests.adapters import HTTPAdapter + +from pip._vendor.cachecontrol.cache import DictCache +from pip._vendor.cachecontrol.controller import PERMANENT_REDIRECT_STATUSES, CacheController +from pip._vendor.cachecontrol.filewrapper import CallbackFileWrapper + +if TYPE_CHECKING: + from pip._vendor.requests import PreparedRequest, Response + from pip._vendor.urllib3 import HTTPResponse + + from pip._vendor.cachecontrol.cache import BaseCache + from pip._vendor.cachecontrol.heuristics import BaseHeuristic + from pip._vendor.cachecontrol.serialize import Serializer + + +class CacheControlAdapter(HTTPAdapter): + invalidating_methods = {"PUT", "PATCH", "DELETE"} + + def __init__( + self, + cache: BaseCache | None = None, + cache_etags: bool = True, + controller_class: type[CacheController] | None = None, + serializer: Serializer | None = None, + heuristic: BaseHeuristic | None = None, + cacheable_methods: Collection[str] | None = None, + *args: Any, + **kw: Any, + ) -> None: + super().__init__(*args, **kw) + self.cache = DictCache() if cache is None else cache + self.heuristic = heuristic + self.cacheable_methods = cacheable_methods or ("GET",) + + controller_factory = controller_class or CacheController + self.controller = controller_factory( + self.cache, cache_etags=cache_etags, serializer=serializer + ) + + def send( + self, + request: PreparedRequest, + stream: bool = False, + timeout: None | float | tuple[float, float] | tuple[float, None] = None, + verify: bool | str = True, + cert: (None | bytes | str | tuple[bytes | str, bytes | str]) = None, + proxies: Mapping[str, str] | None = None, + cacheable_methods: Collection[str] | None = None, + ) -> Response: + """ + Send a request. Use the request information to see if it + exists in the cache and cache the response if we need to and can. + """ + cacheable = cacheable_methods or self.cacheable_methods + if request.method in cacheable: + try: + cached_response = self.controller.cached_request(request) + except zlib.error: + cached_response = None + if cached_response: + return self.build_response(request, cached_response, from_cache=True) + + # check for etags and add headers if appropriate + request.headers.update(self.controller.conditional_headers(request)) + + resp = super().send(request, stream, timeout, verify, cert, proxies) + + return resp + + def build_response( + self, + request: PreparedRequest, + response: HTTPResponse, + from_cache: bool = False, + cacheable_methods: Collection[str] | None = None, + ) -> Response: + """ + Build a response by making a request or using the cache. + + This will end up calling send and returning a potentially + cached response + """ + cacheable = cacheable_methods or self.cacheable_methods + if not from_cache and request.method in cacheable: + # Check for any heuristics that might update headers + # before trying to cache. + if self.heuristic: + response = self.heuristic.apply(response) + + # apply any expiration heuristics + if response.status == 304: + # We must have sent an ETag request. This could mean + # that we've been expired already or that we simply + # have an etag. In either case, we want to try and + # update the cache if that is the case. + cached_response = self.controller.update_cached_response( + request, response + ) + + if cached_response is not response: + from_cache = True + + # We are done with the server response, read a + # possible response body (compliant servers will + # not return one, but we cannot be 100% sure) and + # release the connection back to the pool. + response.read(decode_content=False) + response.release_conn() + + response = cached_response + + # We always cache the 301 responses + elif int(response.status) in PERMANENT_REDIRECT_STATUSES: + self.controller.cache_response(request, response) + else: + # Wrap the response file with a wrapper that will cache the + # response when the stream has been consumed. + response._fp = CallbackFileWrapper( # type: ignore[assignment] + response._fp, # type: ignore[arg-type] + functools.partial( + self.controller.cache_response, request, response + ), + ) + if response.chunked: + super_update_chunk_length = response._update_chunk_length + + def _update_chunk_length(self: HTTPResponse) -> None: + super_update_chunk_length() + if self.chunk_left == 0: + self._fp._close() # type: ignore[union-attr] + + response._update_chunk_length = types.MethodType( # type: ignore[method-assign] + _update_chunk_length, response + ) + + resp: Response = super().build_response(request, response) # type: ignore[no-untyped-call] + + # See if we should invalidate the cache. + if request.method in self.invalidating_methods and resp.ok: + assert request.url is not None + cache_url = self.controller.cache_url(request.url) + self.cache.delete(cache_url) + + # Give the request a from_cache attr to let people use it + resp.from_cache = from_cache # type: ignore[attr-defined] + + return resp + + def close(self) -> None: + self.cache.close() + super().close() # type: ignore[no-untyped-call] diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/cache.py b/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/cache.py new file mode 100644 index 0000000..3293b00 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/cache.py @@ -0,0 +1,74 @@ +# SPDX-FileCopyrightText: 2015 Eric Larson +# +# SPDX-License-Identifier: Apache-2.0 + +""" +The cache object API for implementing caches. The default is a thread +safe in-memory dictionary. +""" +from __future__ import annotations + +from threading import Lock +from typing import IO, TYPE_CHECKING, MutableMapping + +if TYPE_CHECKING: + from datetime import datetime + + +class BaseCache: + def get(self, key: str) -> bytes | None: + raise NotImplementedError() + + def set( + self, key: str, value: bytes, expires: int | datetime | None = None + ) -> None: + raise NotImplementedError() + + def delete(self, key: str) -> None: + raise NotImplementedError() + + def close(self) -> None: + pass + + +class DictCache(BaseCache): + def __init__(self, init_dict: MutableMapping[str, bytes] | None = None) -> None: + self.lock = Lock() + self.data = init_dict or {} + + def get(self, key: str) -> bytes | None: + return self.data.get(key, None) + + def set( + self, key: str, value: bytes, expires: int | datetime | None = None + ) -> None: + with self.lock: + self.data.update({key: value}) + + def delete(self, key: str) -> None: + with self.lock: + if key in self.data: + self.data.pop(key) + + +class SeparateBodyBaseCache(BaseCache): + """ + In this variant, the body is not stored mixed in with the metadata, but is + passed in (as a bytes-like object) in a separate call to ``set_body()``. + + That is, the expected interaction pattern is:: + + cache.set(key, serialized_metadata) + cache.set_body(key) + + Similarly, the body should be loaded separately via ``get_body()``. + """ + + def set_body(self, key: str, body: bytes) -> None: + raise NotImplementedError() + + def get_body(self, key: str) -> IO[bytes] | None: + """ + Return the body as file-like object. + """ + raise NotImplementedError() diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/__init__.py b/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/__init__.py new file mode 100644 index 0000000..24ff469 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/__init__.py @@ -0,0 +1,8 @@ +# SPDX-FileCopyrightText: 2015 Eric Larson +# +# SPDX-License-Identifier: Apache-2.0 + +from pip._vendor.cachecontrol.caches.file_cache import FileCache, SeparateBodyFileCache +from pip._vendor.cachecontrol.caches.redis_cache import RedisCache + +__all__ = ["FileCache", "SeparateBodyFileCache", "RedisCache"] diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b3873739bf8a3572a74b692bc74a60ee85c0406a GIT binary patch literal 434 zcmaixy-ve06os#oltM%)iWv49nIC=we;z=E<^!FC%9C${WRDI-t8&W3mt-XIbS zOl+VINS(0T@UwA;t9xu8e@D7cgFy_gKF%J;7y-O`@m)bT%(mQc2MidJP@)W#K^7pd z0~wZ479p4b3-3|ZYoet0=50yPt{n@>k8)b@cJqSk+~hSMDc1ZPC#a3jITLpAC<#sI zj3)A}=h|tq(r#;^Q!?chQzoVUFRH5AD7h3i9XkeDT>QG*o&Q|MQ#+eSwS7WzDG7Oi znUgRVxKJg>Mso+73R+;Q7{@2VQk=RtQ!K?5)=gcg>LA_Q$5zyQSLgIPpKyyEA9tzo z-_%QCF(IN7H6f{P=BtOLVmFcx&AKDI9e~|%?L9;Yea3(;(KC!*;^A%I_*H!Yc`Sb* literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/__pycache__/file_cache.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/__pycache__/file_cache.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2e0dd52d6a1481a6bf8dacf6d93613bd69d17ca7 GIT binary patch literal 7787 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/__pycache__/redis_cache.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/__pycache__/redis_cache.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4c2ed914fb66a05738d814306fae5db6de558f28 GIT binary patch literal 2737 zcmbVO-ES0C6u zJHI9p9R%8=kLE{<3L$^sq}^bSO=x}&bdFfW5*$(za)N+k(Gg2xPAo||iO(fRE-5*M zk7Y+K#d0x$P=%?$t2kOIo{I}aB*Vl~r->D#v3ZGKPjVeqEfxO@Cn+J^WV)^wn1SuN zeo72A%M55>muRRVt$8j5ro<y>5xF=BCBHA46%K)YER@B;~)jr^vi1Q+1u%WdPnw0BO z5dqoIrnc7QBHFj1S>&f@=;GPBTmw0i%70jipl)b&AwWcVt1HF6_IS0QZw=cz0xB&p zBPuT=3G`ccHYH+;s6owkN4=EZiVB|wVTbM8t{<3gfiiSxD7oGhh7Jg&N>E^^W*B3% z?3e`_DsY5e4JF$R!bAY|#mW1a50;-&d3Z52F;pf@r$WORy;`;z^}`t4nTOj##iCAN z`sh=Gw~B<-^yK|SUn6$A|F^`! z`@MVSoSV+=!5>b1e`2xs$o1jn&feK;GuQ5RCYN^%e3$t)^K(xlv$*4}8?oh{osF@D zp5*n@?HkX{oNEl-?!I;5UUG0DIk=cSzBusCFBg{dp@%J*oa0vCkI5zd2oL@j=j(CM z_W$K8`gdK%ssI!~&3Gb4bu5A^iBN4>ldTaWF8jy~39IR|@tOENt$#u5Z*(tdyCaob zr2%*dK~M8^y$XYuQMnzWr^v8K&bH!8kRrP#Lysm)eB%bPDJhC- z8ILi<<2mp`h0CaQt$~lP8~|?r2#_hVqLQBexnnnv&7Hh?a;$kws%UvIy~9WaYbDo>B3sZ{RCM3#hVD_B;pdJ!H6^;ZkZDfd?RX zU?Ez+%9zgHfft>pmyb>~cqE`Pz`Ma1SV;qmj}Dk34>g@@n36d*HJvN+*`;bg{fnW> zXi#BpC};6+K#o#Z@&m>W!ReaL*^Ih@+fi_8oQI(VW&jBl&cg@bj)gy{6@s>r299C3U-U9&{<`LH9OFL_qQ!Lgpte^D`=Xoq#-jaXnA){V&3=t1@x zl7mRFfJga)j{!r1r~F|c)1)a1%J!xzDEn44az^+-Sdnz)=yG>&)bD*I>NBT!|1h3t zDzM+&B`ABEs;umLtcyw_l7Tm8Q=3rR(F&jm+A^%!yp~2~R1K IO[bytes]: + # We only want to write to this file, so open it in write only mode + flags = os.O_WRONLY + + # os.O_CREAT | os.O_EXCL will fail if the file already exists, so we only + # will open *new* files. + # We specify this because we want to ensure that the mode we pass is the + # mode of the file. + flags |= os.O_CREAT | os.O_EXCL + + # Do not follow symlinks to prevent someone from making a symlink that + # we follow and insecurely open a cache file. + if hasattr(os, "O_NOFOLLOW"): + flags |= os.O_NOFOLLOW + + # On Windows we'll mark this file as binary + if hasattr(os, "O_BINARY"): + flags |= os.O_BINARY + + # Before we open our file, we want to delete any existing file that is + # there + try: + os.remove(filename) + except OSError: + # The file must not exist already, so we can just skip ahead to opening + pass + + # Open our file, the use of os.O_CREAT | os.O_EXCL will ensure that if a + # race condition happens between the os.remove and this line, that an + # error will be raised. Because we utilize a lockfile this should only + # happen if someone is attempting to attack us. + fd = os.open(filename, flags, fmode) + try: + return os.fdopen(fd, "wb") + + except: + # An error occurred wrapping our FD in a file object + os.close(fd) + raise + + +class _FileCacheMixin: + """Shared implementation for both FileCache variants.""" + + def __init__( + self, + directory: str | Path, + forever: bool = False, + filemode: int = 0o0600, + dirmode: int = 0o0700, + lock_class: type[BaseFileLock] | None = None, + ) -> None: + try: + if lock_class is None: + from filelock import FileLock + + lock_class = FileLock + except ImportError: + notice = dedent( + """ + NOTE: In order to use the FileCache you must have + filelock installed. You can install it via pip: + pip install cachecontrol[filecache] + """ + ) + raise ImportError(notice) + + self.directory = directory + self.forever = forever + self.filemode = filemode + self.dirmode = dirmode + self.lock_class = lock_class + + @staticmethod + def encode(x: str) -> str: + return hashlib.sha224(x.encode()).hexdigest() + + def _fn(self, name: str) -> str: + # NOTE: This method should not change as some may depend on it. + # See: https://github.com/ionrock/cachecontrol/issues/63 + hashed = self.encode(name) + parts = list(hashed[:5]) + [hashed] + return os.path.join(self.directory, *parts) + + def get(self, key: str) -> bytes | None: + name = self._fn(key) + try: + with open(name, "rb") as fh: + return fh.read() + + except FileNotFoundError: + return None + + def set( + self, key: str, value: bytes, expires: int | datetime | None = None + ) -> None: + name = self._fn(key) + self._write(name, value) + + def _write(self, path: str, data: bytes) -> None: + """ + Safely write the data to the given path. + """ + # Make sure the directory exists + try: + os.makedirs(os.path.dirname(path), self.dirmode) + except OSError: + pass + + with self.lock_class(path + ".lock"): + # Write our actual file + with _secure_open_write(path, self.filemode) as fh: + fh.write(data) + + def _delete(self, key: str, suffix: str) -> None: + name = self._fn(key) + suffix + if not self.forever: + try: + os.remove(name) + except FileNotFoundError: + pass + + +class FileCache(_FileCacheMixin, BaseCache): + """ + Traditional FileCache: body is stored in memory, so not suitable for large + downloads. + """ + + def delete(self, key: str) -> None: + self._delete(key, "") + + +class SeparateBodyFileCache(_FileCacheMixin, SeparateBodyBaseCache): + """ + Memory-efficient FileCache: body is stored in a separate file, reducing + peak memory usage. + """ + + def get_body(self, key: str) -> IO[bytes] | None: + name = self._fn(key) + ".body" + try: + return open(name, "rb") + except FileNotFoundError: + return None + + def set_body(self, key: str, body: bytes) -> None: + name = self._fn(key) + ".body" + self._write(name, body) + + def delete(self, key: str) -> None: + self._delete(key, "") + self._delete(key, ".body") + + +def url_to_file_path(url: str, filecache: FileCache) -> str: + """Return the file cache path based on the URL. + + This does not ensure the file exists! + """ + key = CacheController.cache_url(url) + return filecache._fn(key) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/redis_cache.py b/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/redis_cache.py new file mode 100644 index 0000000..f4f68c4 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/caches/redis_cache.py @@ -0,0 +1,48 @@ +# SPDX-FileCopyrightText: 2015 Eric Larson +# +# SPDX-License-Identifier: Apache-2.0 +from __future__ import annotations + + +from datetime import datetime, timezone +from typing import TYPE_CHECKING + +from pip._vendor.cachecontrol.cache import BaseCache + +if TYPE_CHECKING: + from redis import Redis + + +class RedisCache(BaseCache): + def __init__(self, conn: Redis[bytes]) -> None: + self.conn = conn + + def get(self, key: str) -> bytes | None: + return self.conn.get(key) + + def set( + self, key: str, value: bytes, expires: int | datetime | None = None + ) -> None: + if not expires: + self.conn.set(key, value) + elif isinstance(expires, datetime): + now_utc = datetime.now(timezone.utc) + if expires.tzinfo is None: + now_utc = now_utc.replace(tzinfo=None) + delta = expires - now_utc + self.conn.setex(key, int(delta.total_seconds()), value) + else: + self.conn.setex(key, expires, value) + + def delete(self, key: str) -> None: + self.conn.delete(key) + + def clear(self) -> None: + """Helper for clearing all the keys in a database. Use with + caution!""" + for key in self.conn.keys(): + self.conn.delete(key) + + def close(self) -> None: + """Redis uses connection pooling, no need to close the connection.""" + pass diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/controller.py b/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/controller.py new file mode 100644 index 0000000..d7dd86e --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/controller.py @@ -0,0 +1,499 @@ +# SPDX-FileCopyrightText: 2015 Eric Larson +# +# SPDX-License-Identifier: Apache-2.0 + +""" +The httplib2 algorithms ported for use with requests. +""" +from __future__ import annotations + +import calendar +import logging +import re +import time +from email.utils import parsedate_tz +from typing import TYPE_CHECKING, Collection, Mapping + +from pip._vendor.requests.structures import CaseInsensitiveDict + +from pip._vendor.cachecontrol.cache import DictCache, SeparateBodyBaseCache +from pip._vendor.cachecontrol.serialize import Serializer + +if TYPE_CHECKING: + from typing import Literal + + from pip._vendor.requests import PreparedRequest + from pip._vendor.urllib3 import HTTPResponse + + from pip._vendor.cachecontrol.cache import BaseCache + +logger = logging.getLogger(__name__) + +URI = re.compile(r"^(([^:/?#]+):)?(//([^/?#]*))?([^?#]*)(\?([^#]*))?(#(.*))?") + +PERMANENT_REDIRECT_STATUSES = (301, 308) + + +def parse_uri(uri: str) -> tuple[str, str, str, str, str]: + """Parses a URI using the regex given in Appendix B of RFC 3986. + + (scheme, authority, path, query, fragment) = parse_uri(uri) + """ + match = URI.match(uri) + assert match is not None + groups = match.groups() + return (groups[1], groups[3], groups[4], groups[6], groups[8]) + + +class CacheController: + """An interface to see if request should cached or not.""" + + def __init__( + self, + cache: BaseCache | None = None, + cache_etags: bool = True, + serializer: Serializer | None = None, + status_codes: Collection[int] | None = None, + ): + self.cache = DictCache() if cache is None else cache + self.cache_etags = cache_etags + self.serializer = serializer or Serializer() + self.cacheable_status_codes = status_codes or (200, 203, 300, 301, 308) + + @classmethod + def _urlnorm(cls, uri: str) -> str: + """Normalize the URL to create a safe key for the cache""" + (scheme, authority, path, query, fragment) = parse_uri(uri) + if not scheme or not authority: + raise Exception("Only absolute URIs are allowed. uri = %s" % uri) + + scheme = scheme.lower() + authority = authority.lower() + + if not path: + path = "/" + + # Could do syntax based normalization of the URI before + # computing the digest. See Section 6.2.2 of Std 66. + request_uri = query and "?".join([path, query]) or path + defrag_uri = scheme + "://" + authority + request_uri + + return defrag_uri + + @classmethod + def cache_url(cls, uri: str) -> str: + return cls._urlnorm(uri) + + def parse_cache_control(self, headers: Mapping[str, str]) -> dict[str, int | None]: + known_directives = { + # https://tools.ietf.org/html/rfc7234#section-5.2 + "max-age": (int, True), + "max-stale": (int, False), + "min-fresh": (int, True), + "no-cache": (None, False), + "no-store": (None, False), + "no-transform": (None, False), + "only-if-cached": (None, False), + "must-revalidate": (None, False), + "public": (None, False), + "private": (None, False), + "proxy-revalidate": (None, False), + "s-maxage": (int, True), + } + + cc_headers = headers.get("cache-control", headers.get("Cache-Control", "")) + + retval: dict[str, int | None] = {} + + for cc_directive in cc_headers.split(","): + if not cc_directive.strip(): + continue + + parts = cc_directive.split("=", 1) + directive = parts[0].strip() + + try: + typ, required = known_directives[directive] + except KeyError: + logger.debug("Ignoring unknown cache-control directive: %s", directive) + continue + + if not typ or not required: + retval[directive] = None + if typ: + try: + retval[directive] = typ(parts[1].strip()) + except IndexError: + if required: + logger.debug( + "Missing value for cache-control " "directive: %s", + directive, + ) + except ValueError: + logger.debug( + "Invalid value for cache-control directive " "%s, must be %s", + directive, + typ.__name__, + ) + + return retval + + def _load_from_cache(self, request: PreparedRequest) -> HTTPResponse | None: + """ + Load a cached response, or return None if it's not available. + """ + # We do not support caching of partial content: so if the request contains a + # Range header then we don't want to load anything from the cache. + if "Range" in request.headers: + return None + + cache_url = request.url + assert cache_url is not None + cache_data = self.cache.get(cache_url) + if cache_data is None: + logger.debug("No cache entry available") + return None + + if isinstance(self.cache, SeparateBodyBaseCache): + body_file = self.cache.get_body(cache_url) + else: + body_file = None + + result = self.serializer.loads(request, cache_data, body_file) + if result is None: + logger.warning("Cache entry deserialization failed, entry ignored") + return result + + def cached_request(self, request: PreparedRequest) -> HTTPResponse | Literal[False]: + """ + Return a cached response if it exists in the cache, otherwise + return False. + """ + assert request.url is not None + cache_url = self.cache_url(request.url) + logger.debug('Looking up "%s" in the cache', cache_url) + cc = self.parse_cache_control(request.headers) + + # Bail out if the request insists on fresh data + if "no-cache" in cc: + logger.debug('Request header has "no-cache", cache bypassed') + return False + + if "max-age" in cc and cc["max-age"] == 0: + logger.debug('Request header has "max_age" as 0, cache bypassed') + return False + + # Check whether we can load the response from the cache: + resp = self._load_from_cache(request) + if not resp: + return False + + # If we have a cached permanent redirect, return it immediately. We + # don't need to test our response for other headers b/c it is + # intrinsically "cacheable" as it is Permanent. + # + # See: + # https://tools.ietf.org/html/rfc7231#section-6.4.2 + # + # Client can try to refresh the value by repeating the request + # with cache busting headers as usual (ie no-cache). + if int(resp.status) in PERMANENT_REDIRECT_STATUSES: + msg = ( + "Returning cached permanent redirect response " + "(ignoring date and etag information)" + ) + logger.debug(msg) + return resp + + headers: CaseInsensitiveDict[str] = CaseInsensitiveDict(resp.headers) + if not headers or "date" not in headers: + if "etag" not in headers: + # Without date or etag, the cached response can never be used + # and should be deleted. + logger.debug("Purging cached response: no date or etag") + self.cache.delete(cache_url) + logger.debug("Ignoring cached response: no date") + return False + + now = time.time() + time_tuple = parsedate_tz(headers["date"]) + assert time_tuple is not None + date = calendar.timegm(time_tuple[:6]) + current_age = max(0, now - date) + logger.debug("Current age based on date: %i", current_age) + + # TODO: There is an assumption that the result will be a + # urllib3 response object. This may not be best since we + # could probably avoid instantiating or constructing the + # response until we know we need it. + resp_cc = self.parse_cache_control(headers) + + # determine freshness + freshness_lifetime = 0 + + # Check the max-age pragma in the cache control header + max_age = resp_cc.get("max-age") + if max_age is not None: + freshness_lifetime = max_age + logger.debug("Freshness lifetime from max-age: %i", freshness_lifetime) + + # If there isn't a max-age, check for an expires header + elif "expires" in headers: + expires = parsedate_tz(headers["expires"]) + if expires is not None: + expire_time = calendar.timegm(expires[:6]) - date + freshness_lifetime = max(0, expire_time) + logger.debug("Freshness lifetime from expires: %i", freshness_lifetime) + + # Determine if we are setting freshness limit in the + # request. Note, this overrides what was in the response. + max_age = cc.get("max-age") + if max_age is not None: + freshness_lifetime = max_age + logger.debug( + "Freshness lifetime from request max-age: %i", freshness_lifetime + ) + + min_fresh = cc.get("min-fresh") + if min_fresh is not None: + # adjust our current age by our min fresh + current_age += min_fresh + logger.debug("Adjusted current age from min-fresh: %i", current_age) + + # Return entry if it is fresh enough + if freshness_lifetime > current_age: + logger.debug('The response is "fresh", returning cached response') + logger.debug("%i > %i", freshness_lifetime, current_age) + return resp + + # we're not fresh. If we don't have an Etag, clear it out + if "etag" not in headers: + logger.debug('The cached response is "stale" with no etag, purging') + self.cache.delete(cache_url) + + # return the original handler + return False + + def conditional_headers(self, request: PreparedRequest) -> dict[str, str]: + resp = self._load_from_cache(request) + new_headers = {} + + if resp: + headers: CaseInsensitiveDict[str] = CaseInsensitiveDict(resp.headers) + + if "etag" in headers: + new_headers["If-None-Match"] = headers["ETag"] + + if "last-modified" in headers: + new_headers["If-Modified-Since"] = headers["Last-Modified"] + + return new_headers + + def _cache_set( + self, + cache_url: str, + request: PreparedRequest, + response: HTTPResponse, + body: bytes | None = None, + expires_time: int | None = None, + ) -> None: + """ + Store the data in the cache. + """ + if isinstance(self.cache, SeparateBodyBaseCache): + # We pass in the body separately; just put a placeholder empty + # string in the metadata. + self.cache.set( + cache_url, + self.serializer.dumps(request, response, b""), + expires=expires_time, + ) + # body is None can happen when, for example, we're only updating + # headers, as is the case in update_cached_response(). + if body is not None: + self.cache.set_body(cache_url, body) + else: + self.cache.set( + cache_url, + self.serializer.dumps(request, response, body), + expires=expires_time, + ) + + def cache_response( + self, + request: PreparedRequest, + response: HTTPResponse, + body: bytes | None = None, + status_codes: Collection[int] | None = None, + ) -> None: + """ + Algorithm for caching requests. + + This assumes a requests Response object. + """ + # From httplib2: Don't cache 206's since we aren't going to + # handle byte range requests + cacheable_status_codes = status_codes or self.cacheable_status_codes + if response.status not in cacheable_status_codes: + logger.debug( + "Status code %s not in %s", response.status, cacheable_status_codes + ) + return + + response_headers: CaseInsensitiveDict[str] = CaseInsensitiveDict( + response.headers + ) + + if "date" in response_headers: + time_tuple = parsedate_tz(response_headers["date"]) + assert time_tuple is not None + date = calendar.timegm(time_tuple[:6]) + else: + date = 0 + + # If we've been given a body, our response has a Content-Length, that + # Content-Length is valid then we can check to see if the body we've + # been given matches the expected size, and if it doesn't we'll just + # skip trying to cache it. + if ( + body is not None + and "content-length" in response_headers + and response_headers["content-length"].isdigit() + and int(response_headers["content-length"]) != len(body) + ): + return + + cc_req = self.parse_cache_control(request.headers) + cc = self.parse_cache_control(response_headers) + + assert request.url is not None + cache_url = self.cache_url(request.url) + logger.debug('Updating cache with response from "%s"', cache_url) + + # Delete it from the cache if we happen to have it stored there + no_store = False + if "no-store" in cc: + no_store = True + logger.debug('Response header has "no-store"') + if "no-store" in cc_req: + no_store = True + logger.debug('Request header has "no-store"') + if no_store and self.cache.get(cache_url): + logger.debug('Purging existing cache entry to honor "no-store"') + self.cache.delete(cache_url) + if no_store: + return + + # https://tools.ietf.org/html/rfc7234#section-4.1: + # A Vary header field-value of "*" always fails to match. + # Storing such a response leads to a deserialization warning + # during cache lookup and is not allowed to ever be served, + # so storing it can be avoided. + if "*" in response_headers.get("vary", ""): + logger.debug('Response header has "Vary: *"') + return + + # If we've been given an etag, then keep the response + if self.cache_etags and "etag" in response_headers: + expires_time = 0 + if response_headers.get("expires"): + expires = parsedate_tz(response_headers["expires"]) + if expires is not None: + expires_time = calendar.timegm(expires[:6]) - date + + expires_time = max(expires_time, 14 * 86400) + + logger.debug(f"etag object cached for {expires_time} seconds") + logger.debug("Caching due to etag") + self._cache_set(cache_url, request, response, body, expires_time) + + # Add to the cache any permanent redirects. We do this before looking + # that the Date headers. + elif int(response.status) in PERMANENT_REDIRECT_STATUSES: + logger.debug("Caching permanent redirect") + self._cache_set(cache_url, request, response, b"") + + # Add to the cache if the response headers demand it. If there + # is no date header then we can't do anything about expiring + # the cache. + elif "date" in response_headers: + time_tuple = parsedate_tz(response_headers["date"]) + assert time_tuple is not None + date = calendar.timegm(time_tuple[:6]) + # cache when there is a max-age > 0 + max_age = cc.get("max-age") + if max_age is not None and max_age > 0: + logger.debug("Caching b/c date exists and max-age > 0") + expires_time = max_age + self._cache_set( + cache_url, + request, + response, + body, + expires_time, + ) + + # If the request can expire, it means we should cache it + # in the meantime. + elif "expires" in response_headers: + if response_headers["expires"]: + expires = parsedate_tz(response_headers["expires"]) + if expires is not None: + expires_time = calendar.timegm(expires[:6]) - date + else: + expires_time = None + + logger.debug( + "Caching b/c of expires header. expires in {} seconds".format( + expires_time + ) + ) + self._cache_set( + cache_url, + request, + response, + body, + expires_time, + ) + + def update_cached_response( + self, request: PreparedRequest, response: HTTPResponse + ) -> HTTPResponse: + """On a 304 we will get a new set of headers that we want to + update our cached value with, assuming we have one. + + This should only ever be called when we've sent an ETag and + gotten a 304 as the response. + """ + assert request.url is not None + cache_url = self.cache_url(request.url) + cached_response = self._load_from_cache(request) + + if not cached_response: + # we didn't have a cached response + return response + + # Lets update our headers with the headers from the new request: + # http://tools.ietf.org/html/draft-ietf-httpbis-p4-conditional-26#section-4.1 + # + # The server isn't supposed to send headers that would make + # the cached body invalid. But... just in case, we'll be sure + # to strip out ones we know that might be problmatic due to + # typical assumptions. + excluded_headers = ["content-length"] + + cached_response.headers.update( + { + k: v + for k, v in response.headers.items() + if k.lower() not in excluded_headers + } + ) + + # we want a 200 b/c we have content via the cache + cached_response.status = 200 + + # update our cache + self._cache_set(cache_url, request, cached_response) + + return cached_response diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/filewrapper.py b/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/filewrapper.py new file mode 100644 index 0000000..2514390 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/filewrapper.py @@ -0,0 +1,119 @@ +# SPDX-FileCopyrightText: 2015 Eric Larson +# +# SPDX-License-Identifier: Apache-2.0 +from __future__ import annotations + +import mmap +from tempfile import NamedTemporaryFile +from typing import TYPE_CHECKING, Any, Callable + +if TYPE_CHECKING: + from http.client import HTTPResponse + + +class CallbackFileWrapper: + """ + Small wrapper around a fp object which will tee everything read into a + buffer, and when that file is closed it will execute a callback with the + contents of that buffer. + + All attributes are proxied to the underlying file object. + + This class uses members with a double underscore (__) leading prefix so as + not to accidentally shadow an attribute. + + The data is stored in a temporary file until it is all available. As long + as the temporary files directory is disk-based (sometimes it's a + memory-backed-``tmpfs`` on Linux), data will be unloaded to disk if memory + pressure is high. For small files the disk usually won't be used at all, + it'll all be in the filesystem memory cache, so there should be no + performance impact. + """ + + def __init__( + self, fp: HTTPResponse, callback: Callable[[bytes], None] | None + ) -> None: + self.__buf = NamedTemporaryFile("rb+", delete=True) + self.__fp = fp + self.__callback = callback + + def __getattr__(self, name: str) -> Any: + # The vaguaries of garbage collection means that self.__fp is + # not always set. By using __getattribute__ and the private + # name[0] allows looking up the attribute value and raising an + # AttributeError when it doesn't exist. This stop thigns from + # infinitely recursing calls to getattr in the case where + # self.__fp hasn't been set. + # + # [0] https://docs.python.org/2/reference/expressions.html#atom-identifiers + fp = self.__getattribute__("_CallbackFileWrapper__fp") + return getattr(fp, name) + + def __is_fp_closed(self) -> bool: + try: + return self.__fp.fp is None + + except AttributeError: + pass + + try: + closed: bool = self.__fp.closed + return closed + + except AttributeError: + pass + + # We just don't cache it then. + # TODO: Add some logging here... + return False + + def _close(self) -> None: + if self.__callback: + if self.__buf.tell() == 0: + # Empty file: + result = b"" + else: + # Return the data without actually loading it into memory, + # relying on Python's buffer API and mmap(). mmap() just gives + # a view directly into the filesystem's memory cache, so it + # doesn't result in duplicate memory use. + self.__buf.seek(0, 0) + result = memoryview( + mmap.mmap(self.__buf.fileno(), 0, access=mmap.ACCESS_READ) + ) + self.__callback(result) + + # We assign this to None here, because otherwise we can get into + # really tricky problems where the CPython interpreter dead locks + # because the callback is holding a reference to something which + # has a __del__ method. Setting this to None breaks the cycle + # and allows the garbage collector to do it's thing normally. + self.__callback = None + + # Closing the temporary file releases memory and frees disk space. + # Important when caching big files. + self.__buf.close() + + def read(self, amt: int | None = None) -> bytes: + data: bytes = self.__fp.read(amt) + if data: + # We may be dealing with b'', a sign that things are over: + # it's passed e.g. after we've already closed self.__buf. + self.__buf.write(data) + if self.__is_fp_closed(): + self._close() + + return data + + def _safe_read(self, amt: int) -> bytes: + data: bytes = self.__fp._safe_read(amt) # type: ignore[attr-defined] + if amt == 2 and data == b"\r\n": + # urllib executes this read to toss the CRLF at the end + # of the chunk. + return data + + self.__buf.write(data) + if self.__is_fp_closed(): + self._close() + + return data diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/heuristics.py b/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/heuristics.py new file mode 100644 index 0000000..f6e5634 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/heuristics.py @@ -0,0 +1,154 @@ +# SPDX-FileCopyrightText: 2015 Eric Larson +# +# SPDX-License-Identifier: Apache-2.0 +from __future__ import annotations + +import calendar +import time +from datetime import datetime, timedelta, timezone +from email.utils import formatdate, parsedate, parsedate_tz +from typing import TYPE_CHECKING, Any, Mapping + +if TYPE_CHECKING: + from pip._vendor.urllib3 import HTTPResponse + +TIME_FMT = "%a, %d %b %Y %H:%M:%S GMT" + + +def expire_after(delta: timedelta, date: datetime | None = None) -> datetime: + date = date or datetime.now(timezone.utc) + return date + delta + + +def datetime_to_header(dt: datetime) -> str: + return formatdate(calendar.timegm(dt.timetuple())) + + +class BaseHeuristic: + def warning(self, response: HTTPResponse) -> str | None: + """ + Return a valid 1xx warning header value describing the cache + adjustments. + + The response is provided too allow warnings like 113 + http://tools.ietf.org/html/rfc7234#section-5.5.4 where we need + to explicitly say response is over 24 hours old. + """ + return '110 - "Response is Stale"' + + def update_headers(self, response: HTTPResponse) -> dict[str, str]: + """Update the response headers with any new headers. + + NOTE: This SHOULD always include some Warning header to + signify that the response was cached by the client, not + by way of the provided headers. + """ + return {} + + def apply(self, response: HTTPResponse) -> HTTPResponse: + updated_headers = self.update_headers(response) + + if updated_headers: + response.headers.update(updated_headers) + warning_header_value = self.warning(response) + if warning_header_value is not None: + response.headers.update({"Warning": warning_header_value}) + + return response + + +class OneDayCache(BaseHeuristic): + """ + Cache the response by providing an expires 1 day in the + future. + """ + + def update_headers(self, response: HTTPResponse) -> dict[str, str]: + headers = {} + + if "expires" not in response.headers: + date = parsedate(response.headers["date"]) + expires = expire_after(timedelta(days=1), date=datetime(*date[:6], tzinfo=timezone.utc)) # type: ignore[index,misc] + headers["expires"] = datetime_to_header(expires) + headers["cache-control"] = "public" + return headers + + +class ExpiresAfter(BaseHeuristic): + """ + Cache **all** requests for a defined time period. + """ + + def __init__(self, **kw: Any) -> None: + self.delta = timedelta(**kw) + + def update_headers(self, response: HTTPResponse) -> dict[str, str]: + expires = expire_after(self.delta) + return {"expires": datetime_to_header(expires), "cache-control": "public"} + + def warning(self, response: HTTPResponse) -> str | None: + tmpl = "110 - Automatically cached for %s. Response might be stale" + return tmpl % self.delta + + +class LastModified(BaseHeuristic): + """ + If there is no Expires header already, fall back on Last-Modified + using the heuristic from + http://tools.ietf.org/html/rfc7234#section-4.2.2 + to calculate a reasonable value. + + Firefox also does something like this per + https://developer.mozilla.org/en-US/docs/Web/HTTP/Caching_FAQ + http://lxr.mozilla.org/mozilla-release/source/netwerk/protocol/http/nsHttpResponseHead.cpp#397 + Unlike mozilla we limit this to 24-hr. + """ + + cacheable_by_default_statuses = { + 200, + 203, + 204, + 206, + 300, + 301, + 404, + 405, + 410, + 414, + 501, + } + + def update_headers(self, resp: HTTPResponse) -> dict[str, str]: + headers: Mapping[str, str] = resp.headers + + if "expires" in headers: + return {} + + if "cache-control" in headers and headers["cache-control"] != "public": + return {} + + if resp.status not in self.cacheable_by_default_statuses: + return {} + + if "date" not in headers or "last-modified" not in headers: + return {} + + time_tuple = parsedate_tz(headers["date"]) + assert time_tuple is not None + date = calendar.timegm(time_tuple[:6]) + last_modified = parsedate(headers["last-modified"]) + if last_modified is None: + return {} + + now = time.time() + current_age = max(0, now - date) + delta = date - calendar.timegm(last_modified) + freshness_lifetime = max(0, min(delta / 10, 24 * 3600)) + if freshness_lifetime <= current_age: + return {} + + expires = date + freshness_lifetime + return {"expires": time.strftime(TIME_FMT, time.gmtime(expires))} + + def warning(self, resp: HTTPResponse) -> str | None: + return None diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/py.typed b/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/serialize.py b/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/serialize.py new file mode 100644 index 0000000..a49487a --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/serialize.py @@ -0,0 +1,146 @@ +# SPDX-FileCopyrightText: 2015 Eric Larson +# +# SPDX-License-Identifier: Apache-2.0 +from __future__ import annotations + +import io +from typing import IO, TYPE_CHECKING, Any, Mapping, cast + +from pip._vendor import msgpack +from pip._vendor.requests.structures import CaseInsensitiveDict +from pip._vendor.urllib3 import HTTPResponse + +if TYPE_CHECKING: + from pip._vendor.requests import PreparedRequest + + +class Serializer: + serde_version = "4" + + def dumps( + self, + request: PreparedRequest, + response: HTTPResponse, + body: bytes | None = None, + ) -> bytes: + response_headers: CaseInsensitiveDict[str] = CaseInsensitiveDict( + response.headers + ) + + if body is None: + # When a body isn't passed in, we'll read the response. We + # also update the response with a new file handler to be + # sure it acts as though it was never read. + body = response.read(decode_content=False) + response._fp = io.BytesIO(body) # type: ignore[assignment] + response.length_remaining = len(body) + + data = { + "response": { + "body": body, # Empty bytestring if body is stored separately + "headers": {str(k): str(v) for k, v in response.headers.items()}, + "status": response.status, + "version": response.version, + "reason": str(response.reason), + "decode_content": response.decode_content, + } + } + + # Construct our vary headers + data["vary"] = {} + if "vary" in response_headers: + varied_headers = response_headers["vary"].split(",") + for header in varied_headers: + header = str(header).strip() + header_value = request.headers.get(header, None) + if header_value is not None: + header_value = str(header_value) + data["vary"][header] = header_value + + return b",".join([f"cc={self.serde_version}".encode(), self.serialize(data)]) + + def serialize(self, data: dict[str, Any]) -> bytes: + return cast(bytes, msgpack.dumps(data, use_bin_type=True)) + + def loads( + self, + request: PreparedRequest, + data: bytes, + body_file: IO[bytes] | None = None, + ) -> HTTPResponse | None: + # Short circuit if we've been given an empty set of data + if not data: + return None + + # Previous versions of this library supported other serialization + # formats, but these have all been removed. + if not data.startswith(f"cc={self.serde_version},".encode()): + return None + + data = data[5:] + return self._loads_v4(request, data, body_file) + + def prepare_response( + self, + request: PreparedRequest, + cached: Mapping[str, Any], + body_file: IO[bytes] | None = None, + ) -> HTTPResponse | None: + """Verify our vary headers match and construct a real urllib3 + HTTPResponse object. + """ + # Special case the '*' Vary value as it means we cannot actually + # determine if the cached response is suitable for this request. + # This case is also handled in the controller code when creating + # a cache entry, but is left here for backwards compatibility. + if "*" in cached.get("vary", {}): + return None + + # Ensure that the Vary headers for the cached response match our + # request + for header, value in cached.get("vary", {}).items(): + if request.headers.get(header, None) != value: + return None + + body_raw = cached["response"].pop("body") + + headers: CaseInsensitiveDict[str] = CaseInsensitiveDict( + data=cached["response"]["headers"] + ) + if headers.get("transfer-encoding", "") == "chunked": + headers.pop("transfer-encoding") + + cached["response"]["headers"] = headers + + try: + body: IO[bytes] + if body_file is None: + body = io.BytesIO(body_raw) + else: + body = body_file + except TypeError: + # This can happen if cachecontrol serialized to v1 format (pickle) + # using Python 2. A Python 2 str(byte string) will be unpickled as + # a Python 3 str (unicode string), which will cause the above to + # fail with: + # + # TypeError: 'str' does not support the buffer interface + body = io.BytesIO(body_raw.encode("utf8")) + + # Discard any `strict` parameter serialized by older version of cachecontrol. + cached["response"].pop("strict", None) + + return HTTPResponse(body=body, preload_content=False, **cached["response"]) + + def _loads_v4( + self, + request: PreparedRequest, + data: bytes, + body_file: IO[bytes] | None = None, + ) -> HTTPResponse | None: + try: + cached = msgpack.loads(data, raw=False) + except ValueError: + return None + + return self.prepare_response(request, cached, body_file) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/wrapper.py b/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/wrapper.py new file mode 100644 index 0000000..f618bc3 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/cachecontrol/wrapper.py @@ -0,0 +1,43 @@ +# SPDX-FileCopyrightText: 2015 Eric Larson +# +# SPDX-License-Identifier: Apache-2.0 +from __future__ import annotations + +from typing import TYPE_CHECKING, Collection + +from pip._vendor.cachecontrol.adapter import CacheControlAdapter +from pip._vendor.cachecontrol.cache import DictCache + +if TYPE_CHECKING: + from pip._vendor import requests + + from pip._vendor.cachecontrol.cache import BaseCache + from pip._vendor.cachecontrol.controller import CacheController + from pip._vendor.cachecontrol.heuristics import BaseHeuristic + from pip._vendor.cachecontrol.serialize import Serializer + + +def CacheControl( + sess: requests.Session, + cache: BaseCache | None = None, + cache_etags: bool = True, + serializer: Serializer | None = None, + heuristic: BaseHeuristic | None = None, + controller_class: type[CacheController] | None = None, + adapter_class: type[CacheControlAdapter] | None = None, + cacheable_methods: Collection[str] | None = None, +) -> requests.Session: + cache = DictCache() if cache is None else cache + adapter_class = adapter_class or CacheControlAdapter + adapter = adapter_class( + cache, + cache_etags=cache_etags, + serializer=serializer, + heuristic=heuristic, + controller_class=controller_class, + cacheable_methods=cacheable_methods, + ) + sess.mount("http://", adapter) + sess.mount("https://", adapter) + + return sess diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/certifi/__init__.py b/.venv/lib/python3.12/site-packages/pip/_vendor/certifi/__init__.py new file mode 100644 index 0000000..d321f1b --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/certifi/__init__.py @@ -0,0 +1,4 @@ +from .core import contents, where + +__all__ = ["contents", "where"] +__version__ = "2024.07.04" diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/certifi/__main__.py b/.venv/lib/python3.12/site-packages/pip/_vendor/certifi/__main__.py new file mode 100644 index 0000000..0037634 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/certifi/__main__.py @@ -0,0 +1,12 @@ +import argparse + +from pip._vendor.certifi import contents, where + +parser = argparse.ArgumentParser() +parser.add_argument("-c", "--contents", action="store_true") +args = parser.parse_args() + +if args.contents: + print(contents()) +else: + print(where()) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/certifi/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/certifi/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..57973b4e47f1adba287b18bbfe6dd5b0e9b6d3cd GIT binary patch literal 317 zcmYjMyH3L}6t(l9B~jTB5(_Y9AP%7t3*rwzVvPh=u-(QYu`S!A3KRVUHogJzDJ+aA z3rI|Cpl+RTC6GA7x#!+m&z~ljE`F?%KX|`lvFpSGpn$>}G_Zh;S9lOm zkNQ)u@M%y4U6`zWLf4jf{g6munXsl0XBE>-`>w77N4HU)<>NFvO0)4<67~U+|LuN& zaaq?G_c6vT(}qid@grEcQLwx~m24Q&idijNPAWtsW$2U}g3^|W7S;R;sm@kX9Hs|3 zGTgF#Rg&v+$_!FmA-7aesS#n?@(D*6bHOdfsp^))<3`e(nw{v_U0c0kwj6!=5W+XG W_a1NF&t9UPyTR+m_B__>&iesZFIIs7 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/certifi/__pycache__/__main__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/certifi/__pycache__/__main__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2c7869edfd2ca2eda1d42c802b4647a036bf4bc0 GIT binary patch literal 644 zcmZutO=}ZD7@pbhT}&$tLhuv>(TLfhdTk4WSBu^xAj`TlO(te{mf1-prH3L&TYB-P zKS7EA#EYSo)bUdBAl{VTdeND5x4Ael^FH%D@5eLqsa6YsT7RBQw*IR4Ltm<8m*DJJ zfwuqy3 z)riMBn@eY2#pRV4<484`YciO#`d&zDe%d*wnfL(CwAJ%xsK-)*cuoXoBbxM3!Z1OP zXpx{$%^slveU9?6=&|g6xOxv2RFHNaCokeIDUh;=N{gtph@vQsX%Qig{E zvcXr>H2samQ+50{A%x$+@=t(H{pNmS<~OH)^T@xk>zn{*2I^B#fAjF&-S<16LH!u4 tow&7`+nBnIBlr5Qb!xhM>#x?oTK>W9!#iKBYu^>Rd3fvfCcmnh{{shLpq>B# literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/certifi/__pycache__/core.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/certifi/__pycache__/core.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..09bb30e5a807388dfa775117e860c27b219b9bef GIT binary patch literal 3219 zcmbVOO>7&-6`t82a!FBINu(&+N-aXRW7D?C*il;>ZCyARg2IPh4CUZsk2wZt4`k><#>N2*G(g}RT^b0WQ{G$dQk0?| z+DFWLv$HdgGvE8(oBcZYDpLi)wI|RL?#}I{V0F?pSfd zV%%P|^R<=uAG#8cFD%(^w&IvK%T|_I{3ffqS-xat?W)W5a#`oLQ_YqgqtkH~vxbhI z@-?fHby(KsZq{(B+^TXnAAf*UorEaLfK_I61nG~)DVC7i`#gi}$fG6v&VcUy0V0gnGBB{x#dfU=Wfz6BzjI^Nid#r-Qrr8f(#kN(x^sJWl&)$*aNK3Hea2Em+pB` zJ(SCkvBUMlXa9bxd2sswCRw*;90KRNNoEQ@SrBfJD};@Kc|;ioW$#9_IELynv^KH{ zgP*A%$UjbezWhX;t1EMzFjG%{uL>8!oj%9S&qGqq*f%UM8kA5>Lf5&;Ai;4%UIeny zVXo1Q91KRF`5d?no!%|)Fd&TOs_+>Nneb!sk+dr9mlNS^LkKR7fIAcpeVCjkE?pKV zxkf1bR>*Df8d;_}VV3;}{y!&rl2fy)ev~{3QzR#|9K2yCP~j=qNl>0->Rfjb?<|U6 zRXSKApgJ`74Nwr^1Q{6q^U+U^J-qa!f3ihrZ2WQRX>#_`M;BczdjVQle0`wH&~XuDU|C||{`9?R zznWfZCXU{v->5_Pm+vj#U%j`wabaV%sh+AUr+!#o|5xU-*YV$X-wHnEef2whc?=cC zBPTFqD12|+k#F+F$+KPrE*;z8xlu2wX{KYq8AW%+?c_hEzL&UVF&7d;v#X1am$WN2 zhjIAY$cGu>?p$g9MdnwQPATz$$$}RjP<8}+ewv;}&oW=BS*{lW12vstY4+mp`rm5{ z@WzYIcfMad<#L#OyN|i8{Jisdcb;8<#TXGc2D&9uN?!^xmD&kH`@SOmZHdy8Erm$Y zEiu^;lk3Z0iif_H&O9GZue}2tUYlu2qw;I(Z?*}T))^{mblrGG(6%BZ65EnT8uG|S z`b&BITj`g*%QBs1U|LgDo)4DI)3!q7fv=>&ucgel^>Zx2~;KbVW zQ#G}IWn;2Fa;%{qU%S*ACI_-l(}!NhqVo9Dp-f8z`+WFdO9l&DNTyp+>?vd@)xtTg YIEnYS`>>Z5 None: + _CACERT_CTX.__exit__(None, None, None) # type: ignore[union-attr] + + +if sys.version_info >= (3, 11): + + from importlib.resources import as_file, files + + _CACERT_CTX = None + _CACERT_PATH = None + + def where() -> str: + # This is slightly terrible, but we want to delay extracting the file + # in cases where we're inside of a zipimport situation until someone + # actually calls where(), but we don't want to re-extract the file + # on every call of where(), so we'll do it once then store it in a + # global variable. + global _CACERT_CTX + global _CACERT_PATH + if _CACERT_PATH is None: + # This is slightly janky, the importlib.resources API wants you to + # manage the cleanup of this file, so it doesn't actually return a + # path, it returns a context manager that will give you the path + # when you enter it and will do any cleanup when you leave it. In + # the common case of not needing a temporary file, it will just + # return the file system location and the __exit__() is a no-op. + # + # We also have to hold onto the actual context manager, because + # it will do the cleanup whenever it gets garbage collected, so + # we will also store that at the global level as well. + _CACERT_CTX = as_file(files("pip._vendor.certifi").joinpath("cacert.pem")) + _CACERT_PATH = str(_CACERT_CTX.__enter__()) + atexit.register(exit_cacert_ctx) + + return _CACERT_PATH + + def contents() -> str: + return files("pip._vendor.certifi").joinpath("cacert.pem").read_text(encoding="ascii") + +elif sys.version_info >= (3, 7): + + from importlib.resources import path as get_path, read_text + + _CACERT_CTX = None + _CACERT_PATH = None + + def where() -> str: + # This is slightly terrible, but we want to delay extracting the + # file in cases where we're inside of a zipimport situation until + # someone actually calls where(), but we don't want to re-extract + # the file on every call of where(), so we'll do it once then store + # it in a global variable. + global _CACERT_CTX + global _CACERT_PATH + if _CACERT_PATH is None: + # This is slightly janky, the importlib.resources API wants you + # to manage the cleanup of this file, so it doesn't actually + # return a path, it returns a context manager that will give + # you the path when you enter it and will do any cleanup when + # you leave it. In the common case of not needing a temporary + # file, it will just return the file system location and the + # __exit__() is a no-op. + # + # We also have to hold onto the actual context manager, because + # it will do the cleanup whenever it gets garbage collected, so + # we will also store that at the global level as well. + _CACERT_CTX = get_path("pip._vendor.certifi", "cacert.pem") + _CACERT_PATH = str(_CACERT_CTX.__enter__()) + atexit.register(exit_cacert_ctx) + + return _CACERT_PATH + + def contents() -> str: + return read_text("pip._vendor.certifi", "cacert.pem", encoding="ascii") + +else: + import os + import types + from typing import Union + + Package = Union[types.ModuleType, str] + Resource = Union[str, "os.PathLike"] + + # This fallback will work for Python versions prior to 3.7 that lack the + # importlib.resources module but relies on the existing `where` function + # so won't address issues with environments like PyOxidizer that don't set + # __file__ on modules. + def read_text( + package: Package, + resource: Resource, + encoding: str = 'utf-8', + errors: str = 'strict' + ) -> str: + with open(where(), encoding=encoding) as data: + return data.read() + + # If we don't have importlib.resources, then we will just do the old logic + # of assuming we're on the filesystem and munge the path directly. + def where() -> str: + f = os.path.dirname(__file__) + + return os.path.join(f, "cacert.pem") + + def contents() -> str: + return read_text("pip._vendor.certifi", "cacert.pem", encoding="ascii") diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/certifi/py.typed b/.venv/lib/python3.12/site-packages/pip/_vendor/certifi/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__init__.py b/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__init__.py new file mode 100644 index 0000000..e999438 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__init__.py @@ -0,0 +1,33 @@ +# -*- coding: utf-8 -*- +# +# Copyright (C) 2012-2023 Vinay Sajip. +# Licensed to the Python Software Foundation under a contributor agreement. +# See LICENSE.txt and CONTRIBUTORS.txt. +# +import logging + +__version__ = '0.3.8' + + +class DistlibException(Exception): + pass + + +try: + from logging import NullHandler +except ImportError: # pragma: no cover + + class NullHandler(logging.Handler): + + def handle(self, record): + pass + + def emit(self, record): + pass + + def createLock(self): + self.lock = None + + +logger = logging.getLogger(__name__) +logger.addHandler(NullHandler()) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..254088278542c1c8b0014c7b7e81e8aed0b7471b GIT binary patch literal 1268 zcmaJ=%}X0m5TCc%Y_f^pR%@+aMK7V4ZR^EDDF{j{*g%g4%98FrlhsW&zFj{Odhn2g zhZYnM>AxWPD}>&9l2Vj~LZPSLQX{2!>dYoFT1wyH_vX!;ncvL3d7rwwV}R@DtJ>P8 z1n`{>?WMGY#zz#YV1mhPNP{V*nFPgq zM{BI*p>lP7sB_bn&{M9p4sBZoB{mH_JOg5cVk5tT{1N2nYWsEe>zw3Oc(=3zyP;Ls zVTtGuGD(%gkCJoAd81r&p6Z*FDm=FKrQh~nzCmUHr46GiR`XWKGzn&FsSduh3bmfYrr zZ4HBK#gdnE3UkTFPc+x^_-rv_Y-F6Z z`!^_wDwN=ur9>3vW676YZm;=@;D#eim%OH?1dW@oyw1lMo%efH)h!l-2O~LAL4~I==wLdKi^gL068H1qn{1 M(S^y-$pl0E1KDE@nE(I) literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/compat.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/compat.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..3e8bc02857332f4dca52547887350ea7cfa07d3e GIT binary patch literal 45604 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%0A3$&eU&1o-r0 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/index.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/index.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..bd4c0bb73cf4e75962b3e85b26dfcb7f662af2d7 GIT binary patch literal 24365 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 Ib@E967nD}_;Q#;t literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/locators.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/locators.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..172a374a0037ee8568ac61395249d8cc83fbeb2b GIT binary patch literal 60157 zcmce<33Oc7c_vu?jfo0fHO2lORZnBq)pY21|yDcm)t3HoqzmM7dxw zj?)2cdIZSMA<$NuMO$+SMoJ5g-N$q%9m}>7%XZHM#R7v;4bsCT?#^*9=Rl;!QOjp0 z^Zoa&C_GSh=1d-mTkqX>?|t{(ckjRd|NXhkm8HY+-p5|=-}5t_?(gYBIxOPJlPsf7 zcT30VIQ_7$hkgyi`Vm8qK`-PPdyMR!smH{A%{^xJYw5ADUu%!mE|j$O*jSFE$H5sn z)39^I)#E}dM$SB(J>u?hk9c}KBRM@eBe^}fBiRX1(M=E+MM*Kbgk;;x`jLj7hLJ!|U}Rg*wvp{U+eaFE8b_LXnpipeaPvq@Ps_-To*nEuYq)i!t*32d zXU|T(&Y%mKhAvA(r2K|MuT+Tb2@Z-=TkX(Uv~E%#X#6EL)E&^Lt;eP!q44SRzobu(YftB3I5IqV z>BP0Z(0F8UY&4LawodTFLt}%ZX&X+)gM2uY&cfNmsBrGYdE0m}a(Og35=uLzvo>U> z&7YeHO@!!YED}Qf(NMTAIF3@6CI*MO-m&q}XoydHPhGtD>~kS*kPr1mP6bD~VPx7P zp=*)e$P`Ljp9`U#a3pP~f+u)>j8EG>{@hu17BHrr)MLw z^>Qc_Fr;ngLXjXBj0Dp@>Fo6A)!^_TCp2eEyZeHDmqT3dIFJ7Ek*TyZG#Z}ZL%reQ zVEA%6J3Kx-80qaF91gKJ_6&p~RCWlR?_~|=uz~62(QCZYNN6;Y&KI(%LN8vh_iBg_ zQ)e9)LOjl&<;Si~rL#xJ_!0CZ8tSEj=xi3X9Y$|3vIQSUFUH5m_(+KRgiu}Ru_0~# z`gb(#dtrMZTD<@H@V36o^bsRC zJBYuA=4}D|)I`f^#9J;$Muua-alB(6+8G;dxz=zw5;#0E9L>8NiHwIkT3W`Z#s{0n z_yKm(Cjt#NH3{I-0)285$t_(>cij?UHz=9bMa0Fc!yQilhC!O*(|WrurXMoPMdg#% z#WMrIR!q+sB>*Ai>vb1&)ws9SU3tozqJNO($MIY!GQp4fgTupqnh?@F@za2Z{Z~fE zCP)33ru@NC|KKPWy4K7pb>Qm-NBo%49sY}#Lw?LX|5(32f>U)Vp0(ZKKk6Sw(^P^U zBec2sVM5dYAiSXM$UQ8^$lyq5Y$B32_YIGQLzvmF&J$fnKYsRN@9FN&6QANMP&n

SrBF-(XtKHNM$ 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 XDtwzY>&yMZ&-)$YmXcqHBGUf`B@U-^ literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/manifest.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/manifest.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5a0f4aa6ac8c31b40f46d56415a18e90a45cbd04 GIT binary patch literal 15124 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 N^mq6{BCoFd{|A*i$~*u7 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/markers.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/markers.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..0f68e4796dd22651a863a415f72d90e59d469aec GIT binary patch literal 7681 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/metadata.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/metadata.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..6bf934822c934ba633781ea51d09d07d5ae2e963 GIT binary patch literal 41798 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 !%{n4U_$ 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 V;q(7I=!PnUwfl*G-?2Tq{|8cn0h0g# literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/util.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/__pycache__/util.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b09ccd28d8ca64b78acea6699832db0a007d968d GIT binary patch literal 88255 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 jw&S5uXI9M^(Cd<#aA2``x{}$X~-{jM~Q> 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/compat.py b/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/compat.py new file mode 100644 index 0000000..e93dc27 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/compat.py @@ -0,0 +1,1138 @@ +# -*- coding: utf-8 -*- +# +# Copyright (C) 2013-2017 Vinay Sajip. +# Licensed to the Python Software Foundation under a contributor agreement. +# See LICENSE.txt and CONTRIBUTORS.txt. +# +from __future__ import absolute_import + +import os +import re +import shutil +import sys + +try: + import ssl +except ImportError: # pragma: no cover + ssl = None + +if sys.version_info[0] < 3: # pragma: no cover + from StringIO import StringIO + string_types = basestring, + text_type = unicode + from types import FileType as file_type + import __builtin__ as builtins + import ConfigParser as configparser + from urlparse import urlparse, urlunparse, urljoin, urlsplit, urlunsplit + from urllib import (urlretrieve, quote as _quote, unquote, url2pathname, + pathname2url, ContentTooShortError, splittype) + + def quote(s): + if isinstance(s, unicode): + s = s.encode('utf-8') + return _quote(s) + + import urllib2 + from urllib2 import (Request, urlopen, URLError, HTTPError, + HTTPBasicAuthHandler, HTTPPasswordMgr, HTTPHandler, + HTTPRedirectHandler, build_opener) + if ssl: + from urllib2 import HTTPSHandler + import httplib + import xmlrpclib + import Queue as queue + from HTMLParser import HTMLParser + import htmlentitydefs + raw_input = raw_input + from itertools import ifilter as filter + from itertools import ifilterfalse as filterfalse + + # Leaving this around for now, in case it needs resurrecting in some way + # _userprog = None + # def splituser(host): + # """splituser('user[:passwd]@host[:port]') --> 'user[:passwd]', 'host[:port]'.""" + # global _userprog + # if _userprog is None: + # import re + # _userprog = re.compile('^(.*)@(.*)$') + + # match = _userprog.match(host) + # if match: return match.group(1, 2) + # return None, host + +else: # pragma: no cover + from io import StringIO + string_types = str, + text_type = str + from io import TextIOWrapper as file_type + import builtins + import configparser + from urllib.parse import (urlparse, urlunparse, urljoin, quote, unquote, + urlsplit, urlunsplit, splittype) + from urllib.request import (urlopen, urlretrieve, Request, url2pathname, + pathname2url, HTTPBasicAuthHandler, + HTTPPasswordMgr, HTTPHandler, + HTTPRedirectHandler, build_opener) + if ssl: + from urllib.request import HTTPSHandler + from urllib.error import HTTPError, URLError, ContentTooShortError + import http.client as httplib + import urllib.request as urllib2 + import xmlrpc.client as xmlrpclib + import queue + from html.parser import HTMLParser + import html.entities as htmlentitydefs + raw_input = input + from itertools import filterfalse + filter = filter + +try: + from ssl import match_hostname, CertificateError +except ImportError: # pragma: no cover + + class CertificateError(ValueError): + pass + + def _dnsname_match(dn, hostname, max_wildcards=1): + """Matching according to RFC 6125, section 6.4.3 + + http://tools.ietf.org/html/rfc6125#section-6.4.3 + """ + pats = [] + if not dn: + return False + + parts = dn.split('.') + leftmost, remainder = parts[0], parts[1:] + + wildcards = leftmost.count('*') + if wildcards > max_wildcards: + # Issue #17980: avoid denials of service by refusing more + # than one wildcard per fragment. A survey of established + # policy among SSL implementations showed it to be a + # reasonable choice. + raise CertificateError( + "too many wildcards in certificate DNS name: " + repr(dn)) + + # speed up common case w/o wildcards + if not wildcards: + return dn.lower() == hostname.lower() + + # RFC 6125, section 6.4.3, subitem 1. + # The client SHOULD NOT attempt to match a presented identifier in which + # the wildcard character comprises a label other than the left-most label. + if leftmost == '*': + # When '*' is a fragment by itself, it matches a non-empty dotless + # fragment. + pats.append('[^.]+') + elif leftmost.startswith('xn--') or hostname.startswith('xn--'): + # RFC 6125, section 6.4.3, subitem 3. + # The client SHOULD NOT attempt to match a presented identifier + # where the wildcard character is embedded within an A-label or + # U-label of an internationalized domain name. + pats.append(re.escape(leftmost)) + else: + # Otherwise, '*' matches any dotless string, e.g. www* + pats.append(re.escape(leftmost).replace(r'\*', '[^.]*')) + + # add the remaining fragments, ignore any wildcards + for frag in remainder: + pats.append(re.escape(frag)) + + pat = re.compile(r'\A' + r'\.'.join(pats) + r'\Z', re.IGNORECASE) + return pat.match(hostname) + + def match_hostname(cert, hostname): + """Verify that *cert* (in decoded format as returned by + SSLSocket.getpeercert()) matches the *hostname*. RFC 2818 and RFC 6125 + rules are followed, but IP addresses are not accepted for *hostname*. + + CertificateError is raised on failure. On success, the function + returns nothing. + """ + if not cert: + raise ValueError("empty or no certificate, match_hostname needs a " + "SSL socket or SSL context with either " + "CERT_OPTIONAL or CERT_REQUIRED") + dnsnames = [] + san = cert.get('subjectAltName', ()) + for key, value in san: + if key == 'DNS': + if _dnsname_match(value, hostname): + return + dnsnames.append(value) + if not dnsnames: + # The subject is only checked when there is no dNSName entry + # in subjectAltName + for sub in cert.get('subject', ()): + for key, value in sub: + # XXX according to RFC 2818, the most specific Common Name + # must be used. + if key == 'commonName': + if _dnsname_match(value, hostname): + return + dnsnames.append(value) + if len(dnsnames) > 1: + raise CertificateError("hostname %r " + "doesn't match either of %s" % + (hostname, ', '.join(map(repr, dnsnames)))) + elif len(dnsnames) == 1: + raise CertificateError("hostname %r " + "doesn't match %r" % + (hostname, dnsnames[0])) + else: + raise CertificateError("no appropriate commonName or " + "subjectAltName fields were found") + + +try: + from types import SimpleNamespace as Container +except ImportError: # pragma: no cover + + class Container(object): + """ + A generic container for when multiple values need to be returned + """ + + def __init__(self, **kwargs): + self.__dict__.update(kwargs) + + +try: + from shutil import which +except ImportError: # pragma: no cover + # Implementation from Python 3.3 + def which(cmd, mode=os.F_OK | os.X_OK, path=None): + """Given a command, mode, and a PATH string, return the path which + conforms to the given mode on the PATH, or None if there is no such + file. + + `mode` defaults to os.F_OK | os.X_OK. `path` defaults to the result + of os.environ.get("PATH"), or can be overridden with a custom search + path. + + """ + + # Check that a given file can be accessed with the correct mode. + # Additionally check that `file` is not a directory, as on Windows + # directories pass the os.access check. + def _access_check(fn, mode): + return (os.path.exists(fn) and os.access(fn, mode) + and not os.path.isdir(fn)) + + # If we're given a path with a directory part, look it up directly rather + # than referring to PATH directories. This includes checking relative to the + # current directory, e.g. ./script + if os.path.dirname(cmd): + if _access_check(cmd, mode): + return cmd + return None + + if path is None: + path = os.environ.get("PATH", os.defpath) + if not path: + return None + path = path.split(os.pathsep) + + if sys.platform == "win32": + # The current directory takes precedence on Windows. + if os.curdir not in path: + path.insert(0, os.curdir) + + # PATHEXT is necessary to check on Windows. + pathext = os.environ.get("PATHEXT", "").split(os.pathsep) + # See if the given file matches any of the expected path extensions. + # This will allow us to short circuit when given "python.exe". + # If it does match, only test that one, otherwise we have to try + # others. + if any(cmd.lower().endswith(ext.lower()) for ext in pathext): + files = [cmd] + else: + files = [cmd + ext for ext in pathext] + else: + # On other platforms you don't have things like PATHEXT to tell you + # what file suffixes are executable, so just pass on cmd as-is. + files = [cmd] + + seen = set() + for dir in path: + normdir = os.path.normcase(dir) + if normdir not in seen: + seen.add(normdir) + for thefile in files: + name = os.path.join(dir, thefile) + if _access_check(name, mode): + return name + return None + + +# ZipFile is a context manager in 2.7, but not in 2.6 + +from zipfile import ZipFile as BaseZipFile + +if hasattr(BaseZipFile, '__enter__'): # pragma: no cover + ZipFile = BaseZipFile +else: # pragma: no cover + from zipfile import ZipExtFile as BaseZipExtFile + + class ZipExtFile(BaseZipExtFile): + + def __init__(self, base): + self.__dict__.update(base.__dict__) + + def __enter__(self): + return self + + def __exit__(self, *exc_info): + self.close() + # return None, so if an exception occurred, it will propagate + + class ZipFile(BaseZipFile): + + def __enter__(self): + return self + + def __exit__(self, *exc_info): + self.close() + # return None, so if an exception occurred, it will propagate + + def open(self, *args, **kwargs): + base = BaseZipFile.open(self, *args, **kwargs) + return ZipExtFile(base) + + +try: + from platform import python_implementation +except ImportError: # pragma: no cover + + def python_implementation(): + """Return a string identifying the Python implementation.""" + if 'PyPy' in sys.version: + return 'PyPy' + if os.name == 'java': + return 'Jython' + if sys.version.startswith('IronPython'): + return 'IronPython' + return 'CPython' + + +import sysconfig + +try: + callable = callable +except NameError: # pragma: no cover + from collections.abc import Callable + + def callable(obj): + return isinstance(obj, Callable) + + +try: + fsencode = os.fsencode + fsdecode = os.fsdecode +except AttributeError: # pragma: no cover + # Issue #99: on some systems (e.g. containerised), + # sys.getfilesystemencoding() returns None, and we need a real value, + # so fall back to utf-8. From the CPython 2.7 docs relating to Unix and + # sys.getfilesystemencoding(): the return value is "the user’s preference + # according to the result of nl_langinfo(CODESET), or None if the + # nl_langinfo(CODESET) failed." + _fsencoding = sys.getfilesystemencoding() or 'utf-8' + if _fsencoding == 'mbcs': + _fserrors = 'strict' + else: + _fserrors = 'surrogateescape' + + def fsencode(filename): + if isinstance(filename, bytes): + return filename + elif isinstance(filename, text_type): + return filename.encode(_fsencoding, _fserrors) + else: + raise TypeError("expect bytes or str, not %s" % + type(filename).__name__) + + def fsdecode(filename): + if isinstance(filename, text_type): + return filename + elif isinstance(filename, bytes): + return filename.decode(_fsencoding, _fserrors) + else: + raise TypeError("expect bytes or str, not %s" % + type(filename).__name__) + + +try: + from tokenize import detect_encoding +except ImportError: # pragma: no cover + from codecs import BOM_UTF8, lookup + + cookie_re = re.compile(r"coding[:=]\s*([-\w.]+)") + + def _get_normal_name(orig_enc): + """Imitates get_normal_name in tokenizer.c.""" + # Only care about the first 12 characters. + enc = orig_enc[:12].lower().replace("_", "-") + if enc == "utf-8" or enc.startswith("utf-8-"): + return "utf-8" + if enc in ("latin-1", "iso-8859-1", "iso-latin-1") or \ + enc.startswith(("latin-1-", "iso-8859-1-", "iso-latin-1-")): + return "iso-8859-1" + return orig_enc + + def detect_encoding(readline): + """ + The detect_encoding() function is used to detect the encoding that should + be used to decode a Python source file. It requires one argument, readline, + in the same way as the tokenize() generator. + + It will call readline a maximum of twice, and return the encoding used + (as a string) and a list of any lines (left as bytes) it has read in. + + It detects the encoding from the presence of a utf-8 bom or an encoding + cookie as specified in pep-0263. If both a bom and a cookie are present, + but disagree, a SyntaxError will be raised. If the encoding cookie is an + invalid charset, raise a SyntaxError. Note that if a utf-8 bom is found, + 'utf-8-sig' is returned. + + If no encoding is specified, then the default of 'utf-8' will be returned. + """ + try: + filename = readline.__self__.name + except AttributeError: + filename = None + bom_found = False + encoding = None + default = 'utf-8' + + def read_or_stop(): + try: + return readline() + except StopIteration: + return b'' + + def find_cookie(line): + try: + # Decode as UTF-8. Either the line is an encoding declaration, + # in which case it should be pure ASCII, or it must be UTF-8 + # per default encoding. + line_string = line.decode('utf-8') + except UnicodeDecodeError: + msg = "invalid or missing encoding declaration" + if filename is not None: + msg = '{} for {!r}'.format(msg, filename) + raise SyntaxError(msg) + + matches = cookie_re.findall(line_string) + if not matches: + return None + encoding = _get_normal_name(matches[0]) + try: + codec = lookup(encoding) + except LookupError: + # This behaviour mimics the Python interpreter + if filename is None: + msg = "unknown encoding: " + encoding + else: + msg = "unknown encoding for {!r}: {}".format( + filename, encoding) + raise SyntaxError(msg) + + if bom_found: + if codec.name != 'utf-8': + # This behaviour mimics the Python interpreter + if filename is None: + msg = 'encoding problem: utf-8' + else: + msg = 'encoding problem for {!r}: utf-8'.format( + filename) + raise SyntaxError(msg) + encoding += '-sig' + return encoding + + first = read_or_stop() + if first.startswith(BOM_UTF8): + bom_found = True + first = first[3:] + default = 'utf-8-sig' + if not first: + return default, [] + + encoding = find_cookie(first) + if encoding: + return encoding, [first] + + second = read_or_stop() + if not second: + return default, [first] + + encoding = find_cookie(second) + if encoding: + return encoding, [first, second] + + return default, [first, second] + + +# For converting & <-> & etc. +try: + from html import escape +except ImportError: + from cgi import escape +if sys.version_info[:2] < (3, 4): + unescape = HTMLParser().unescape +else: + from html import unescape + +try: + from collections import ChainMap +except ImportError: # pragma: no cover + from collections import MutableMapping + + try: + from reprlib import recursive_repr as _recursive_repr + except ImportError: + + def _recursive_repr(fillvalue='...'): + ''' + Decorator to make a repr function return fillvalue for a recursive + call + ''' + + def decorating_function(user_function): + repr_running = set() + + def wrapper(self): + key = id(self), get_ident() + if key in repr_running: + return fillvalue + repr_running.add(key) + try: + result = user_function(self) + finally: + repr_running.discard(key) + return result + + # Can't use functools.wraps() here because of bootstrap issues + wrapper.__module__ = getattr(user_function, '__module__') + wrapper.__doc__ = getattr(user_function, '__doc__') + wrapper.__name__ = getattr(user_function, '__name__') + wrapper.__annotations__ = getattr(user_function, + '__annotations__', {}) + return wrapper + + return decorating_function + + class ChainMap(MutableMapping): + ''' + A ChainMap groups multiple dicts (or other mappings) together + to create a single, updateable view. + + The underlying mappings are stored in a list. That list is public and can + accessed or updated using the *maps* attribute. There is no other state. + + Lookups search the underlying mappings successively until a key is found. + In contrast, writes, updates, and deletions only operate on the first + mapping. + ''' + + def __init__(self, *maps): + '''Initialize a ChainMap by setting *maps* to the given mappings. + If no mappings are provided, a single empty dictionary is used. + + ''' + self.maps = list(maps) or [{}] # always at least one map + + def __missing__(self, key): + raise KeyError(key) + + def __getitem__(self, key): + for mapping in self.maps: + try: + return mapping[ + key] # can't use 'key in mapping' with defaultdict + except KeyError: + pass + return self.__missing__( + key) # support subclasses that define __missing__ + + def get(self, key, default=None): + return self[key] if key in self else default + + def __len__(self): + return len(set().union( + *self.maps)) # reuses stored hash values if possible + + def __iter__(self): + return iter(set().union(*self.maps)) + + def __contains__(self, key): + return any(key in m for m in self.maps) + + def __bool__(self): + return any(self.maps) + + @_recursive_repr() + def __repr__(self): + return '{0.__class__.__name__}({1})'.format( + self, ', '.join(map(repr, self.maps))) + + @classmethod + def fromkeys(cls, iterable, *args): + 'Create a ChainMap with a single dict created from the iterable.' + return cls(dict.fromkeys(iterable, *args)) + + def copy(self): + 'New ChainMap or subclass with a new copy of maps[0] and refs to maps[1:]' + return self.__class__(self.maps[0].copy(), *self.maps[1:]) + + __copy__ = copy + + def new_child(self): # like Django's Context.push() + 'New ChainMap with a new dict followed by all previous maps.' + return self.__class__({}, *self.maps) + + @property + def parents(self): # like Django's Context.pop() + 'New ChainMap from maps[1:].' + return self.__class__(*self.maps[1:]) + + def __setitem__(self, key, value): + self.maps[0][key] = value + + def __delitem__(self, key): + try: + del self.maps[0][key] + except KeyError: + raise KeyError( + 'Key not found in the first mapping: {!r}'.format(key)) + + def popitem(self): + 'Remove and return an item pair from maps[0]. Raise KeyError is maps[0] is empty.' + try: + return self.maps[0].popitem() + except KeyError: + raise KeyError('No keys found in the first mapping.') + + def pop(self, key, *args): + 'Remove *key* from maps[0] and return its value. Raise KeyError if *key* not in maps[0].' + try: + return self.maps[0].pop(key, *args) + except KeyError: + raise KeyError( + 'Key not found in the first mapping: {!r}'.format(key)) + + def clear(self): + 'Clear maps[0], leaving maps[1:] intact.' + self.maps[0].clear() + + +try: + from importlib.util import cache_from_source # Python >= 3.4 +except ImportError: # pragma: no cover + + def cache_from_source(path, debug_override=None): + assert path.endswith('.py') + if debug_override is None: + debug_override = __debug__ + if debug_override: + suffix = 'c' + else: + suffix = 'o' + return path + suffix + + +try: + from collections import OrderedDict +except ImportError: # pragma: no cover + # {{{ http://code.activestate.com/recipes/576693/ (r9) + # Backport of OrderedDict() class that runs on Python 2.4, 2.5, 2.6, 2.7 and pypy. + # Passes Python2.7's test suite and incorporates all the latest updates. + try: + from thread import get_ident as _get_ident + except ImportError: + from dummy_thread import get_ident as _get_ident + + try: + from _abcoll import KeysView, ValuesView, ItemsView + except ImportError: + pass + + class OrderedDict(dict): + 'Dictionary that remembers insertion order' + + # An inherited dict maps keys to values. + # The inherited dict provides __getitem__, __len__, __contains__, and get. + # The remaining methods are order-aware. + # Big-O running times for all methods are the same as for regular dictionaries. + + # The internal self.__map dictionary maps keys to links in a doubly linked list. + # The circular doubly linked list starts and ends with a sentinel element. + # The sentinel element never gets deleted (this simplifies the algorithm). + # Each link is stored as a list of length three: [PREV, NEXT, KEY]. + + def __init__(self, *args, **kwds): + '''Initialize an ordered dictionary. Signature is the same as for + regular dictionaries, but keyword arguments are not recommended + because their insertion order is arbitrary. + + ''' + if len(args) > 1: + raise TypeError('expected at most 1 arguments, got %d' % + len(args)) + try: + self.__root + except AttributeError: + self.__root = root = [] # sentinel node + root[:] = [root, root, None] + self.__map = {} + self.__update(*args, **kwds) + + def __setitem__(self, key, value, dict_setitem=dict.__setitem__): + 'od.__setitem__(i, y) <==> od[i]=y' + # Setting a new item creates a new link which goes at the end of the linked + # list, and the inherited dictionary is updated with the new key/value pair. + if key not in self: + root = self.__root + last = root[0] + last[1] = root[0] = self.__map[key] = [last, root, key] + dict_setitem(self, key, value) + + def __delitem__(self, key, dict_delitem=dict.__delitem__): + 'od.__delitem__(y) <==> del od[y]' + # Deleting an existing item uses self.__map to find the link which is + # then removed by updating the links in the predecessor and successor nodes. + dict_delitem(self, key) + link_prev, link_next, key = self.__map.pop(key) + link_prev[1] = link_next + link_next[0] = link_prev + + def __iter__(self): + 'od.__iter__() <==> iter(od)' + root = self.__root + curr = root[1] + while curr is not root: + yield curr[2] + curr = curr[1] + + def __reversed__(self): + 'od.__reversed__() <==> reversed(od)' + root = self.__root + curr = root[0] + while curr is not root: + yield curr[2] + curr = curr[0] + + def clear(self): + 'od.clear() -> None. Remove all items from od.' + try: + for node in self.__map.itervalues(): + del node[:] + root = self.__root + root[:] = [root, root, None] + self.__map.clear() + except AttributeError: + pass + dict.clear(self) + + def popitem(self, last=True): + '''od.popitem() -> (k, v), return and remove a (key, value) pair. + Pairs are returned in LIFO order if last is true or FIFO order if false. + + ''' + if not self: + raise KeyError('dictionary is empty') + root = self.__root + if last: + link = root[0] + link_prev = link[0] + link_prev[1] = root + root[0] = link_prev + else: + link = root[1] + link_next = link[1] + root[1] = link_next + link_next[0] = root + key = link[2] + del self.__map[key] + value = dict.pop(self, key) + return key, value + + # -- the following methods do not depend on the internal structure -- + + def keys(self): + 'od.keys() -> list of keys in od' + return list(self) + + def values(self): + 'od.values() -> list of values in od' + return [self[key] for key in self] + + def items(self): + 'od.items() -> list of (key, value) pairs in od' + return [(key, self[key]) for key in self] + + def iterkeys(self): + 'od.iterkeys() -> an iterator over the keys in od' + return iter(self) + + def itervalues(self): + 'od.itervalues -> an iterator over the values in od' + for k in self: + yield self[k] + + def iteritems(self): + 'od.iteritems -> an iterator over the (key, value) items in od' + for k in self: + yield (k, self[k]) + + def update(*args, **kwds): + '''od.update(E, **F) -> None. Update od from dict/iterable E and F. + + If E is a dict instance, does: for k in E: od[k] = E[k] + If E has a .keys() method, does: for k in E.keys(): od[k] = E[k] + Or if E is an iterable of items, does: for k, v in E: od[k] = v + In either case, this is followed by: for k, v in F.items(): od[k] = v + + ''' + if len(args) > 2: + raise TypeError('update() takes at most 2 positional ' + 'arguments (%d given)' % (len(args), )) + elif not args: + raise TypeError('update() takes at least 1 argument (0 given)') + self = args[0] + # Make progressively weaker assumptions about "other" + other = () + if len(args) == 2: + other = args[1] + if isinstance(other, dict): + for key in other: + self[key] = other[key] + elif hasattr(other, 'keys'): + for key in other.keys(): + self[key] = other[key] + else: + for key, value in other: + self[key] = value + for key, value in kwds.items(): + self[key] = value + + __update = update # let subclasses override update without breaking __init__ + + __marker = object() + + def pop(self, key, default=__marker): + '''od.pop(k[,d]) -> v, remove specified key and return the corresponding value. + If key is not found, d is returned if given, otherwise KeyError is raised. + + ''' + if key in self: + result = self[key] + del self[key] + return result + if default is self.__marker: + raise KeyError(key) + return default + + def setdefault(self, key, default=None): + 'od.setdefault(k[,d]) -> od.get(k,d), also set od[k]=d if k not in od' + if key in self: + return self[key] + self[key] = default + return default + + def __repr__(self, _repr_running=None): + 'od.__repr__() <==> repr(od)' + if not _repr_running: + _repr_running = {} + call_key = id(self), _get_ident() + if call_key in _repr_running: + return '...' + _repr_running[call_key] = 1 + try: + if not self: + return '%s()' % (self.__class__.__name__, ) + return '%s(%r)' % (self.__class__.__name__, self.items()) + finally: + del _repr_running[call_key] + + def __reduce__(self): + 'Return state information for pickling' + items = [[k, self[k]] for k in self] + inst_dict = vars(self).copy() + for k in vars(OrderedDict()): + inst_dict.pop(k, None) + if inst_dict: + return (self.__class__, (items, ), inst_dict) + return self.__class__, (items, ) + + def copy(self): + 'od.copy() -> a shallow copy of od' + return self.__class__(self) + + @classmethod + def fromkeys(cls, iterable, value=None): + '''OD.fromkeys(S[, v]) -> New ordered dictionary with keys from S + and values equal to v (which defaults to None). + + ''' + d = cls() + for key in iterable: + d[key] = value + return d + + def __eq__(self, other): + '''od.__eq__(y) <==> od==y. Comparison to another OD is order-sensitive + while comparison to a regular mapping is order-insensitive. + + ''' + if isinstance(other, OrderedDict): + return len(self) == len( + other) and self.items() == other.items() + return dict.__eq__(self, other) + + def __ne__(self, other): + return not self == other + + # -- the following methods are only used in Python 2.7 -- + + def viewkeys(self): + "od.viewkeys() -> a set-like object providing a view on od's keys" + return KeysView(self) + + def viewvalues(self): + "od.viewvalues() -> an object providing a view on od's values" + return ValuesView(self) + + def viewitems(self): + "od.viewitems() -> a set-like object providing a view on od's items" + return ItemsView(self) + + +try: + from logging.config import BaseConfigurator, valid_ident +except ImportError: # pragma: no cover + IDENTIFIER = re.compile('^[a-z_][a-z0-9_]*$', re.I) + + def valid_ident(s): + m = IDENTIFIER.match(s) + if not m: + raise ValueError('Not a valid Python identifier: %r' % s) + return True + + # The ConvertingXXX classes are wrappers around standard Python containers, + # and they serve to convert any suitable values in the container. The + # conversion converts base dicts, lists and tuples to their wrapped + # equivalents, whereas strings which match a conversion format are converted + # appropriately. + # + # Each wrapper should have a configurator attribute holding the actual + # configurator to use for conversion. + + class ConvertingDict(dict): + """A converting dictionary wrapper.""" + + def __getitem__(self, key): + value = dict.__getitem__(self, key) + result = self.configurator.convert(value) + # If the converted value is different, save for next time + if value is not result: + self[key] = result + if type(result) in (ConvertingDict, ConvertingList, + ConvertingTuple): + result.parent = self + result.key = key + return result + + def get(self, key, default=None): + value = dict.get(self, key, default) + result = self.configurator.convert(value) + # If the converted value is different, save for next time + if value is not result: + self[key] = result + if type(result) in (ConvertingDict, ConvertingList, + ConvertingTuple): + result.parent = self + result.key = key + return result + + def pop(self, key, default=None): + value = dict.pop(self, key, default) + result = self.configurator.convert(value) + if value is not result: + if type(result) in (ConvertingDict, ConvertingList, + ConvertingTuple): + result.parent = self + result.key = key + return result + + class ConvertingList(list): + """A converting list wrapper.""" + + def __getitem__(self, key): + value = list.__getitem__(self, key) + result = self.configurator.convert(value) + # If the converted value is different, save for next time + if value is not result: + self[key] = result + if type(result) in (ConvertingDict, ConvertingList, + ConvertingTuple): + result.parent = self + result.key = key + return result + + def pop(self, idx=-1): + value = list.pop(self, idx) + result = self.configurator.convert(value) + if value is not result: + if type(result) in (ConvertingDict, ConvertingList, + ConvertingTuple): + result.parent = self + return result + + class ConvertingTuple(tuple): + """A converting tuple wrapper.""" + + def __getitem__(self, key): + value = tuple.__getitem__(self, key) + result = self.configurator.convert(value) + if value is not result: + if type(result) in (ConvertingDict, ConvertingList, + ConvertingTuple): + result.parent = self + result.key = key + return result + + class BaseConfigurator(object): + """ + The configurator base class which defines some useful defaults. + """ + + CONVERT_PATTERN = re.compile(r'^(?P[a-z]+)://(?P.*)$') + + WORD_PATTERN = re.compile(r'^\s*(\w+)\s*') + DOT_PATTERN = re.compile(r'^\.\s*(\w+)\s*') + INDEX_PATTERN = re.compile(r'^\[\s*(\w+)\s*\]\s*') + DIGIT_PATTERN = re.compile(r'^\d+$') + + value_converters = { + 'ext': 'ext_convert', + 'cfg': 'cfg_convert', + } + + # We might want to use a different one, e.g. importlib + importer = staticmethod(__import__) + + def __init__(self, config): + self.config = ConvertingDict(config) + self.config.configurator = self + + def resolve(self, s): + """ + Resolve strings to objects using standard import and attribute + syntax. + """ + name = s.split('.') + used = name.pop(0) + try: + found = self.importer(used) + for frag in name: + used += '.' + frag + try: + found = getattr(found, frag) + except AttributeError: + self.importer(used) + found = getattr(found, frag) + return found + except ImportError: + e, tb = sys.exc_info()[1:] + v = ValueError('Cannot resolve %r: %s' % (s, e)) + v.__cause__, v.__traceback__ = e, tb + raise v + + def ext_convert(self, value): + """Default converter for the ext:// protocol.""" + return self.resolve(value) + + def cfg_convert(self, value): + """Default converter for the cfg:// protocol.""" + rest = value + m = self.WORD_PATTERN.match(rest) + if m is None: + raise ValueError("Unable to convert %r" % value) + else: + rest = rest[m.end():] + d = self.config[m.groups()[0]] + while rest: + m = self.DOT_PATTERN.match(rest) + if m: + d = d[m.groups()[0]] + else: + m = self.INDEX_PATTERN.match(rest) + if m: + idx = m.groups()[0] + if not self.DIGIT_PATTERN.match(idx): + d = d[idx] + else: + try: + n = int( + idx + ) # try as number first (most likely) + d = d[n] + except TypeError: + d = d[idx] + if m: + rest = rest[m.end():] + else: + raise ValueError('Unable to convert ' + '%r at %r' % (value, rest)) + # rest should be empty + return d + + def convert(self, value): + """ + Convert values to an appropriate type. dicts, lists and tuples are + replaced by their converting alternatives. Strings are checked to + see if they have a conversion format and are converted if they do. + """ + if not isinstance(value, ConvertingDict) and isinstance( + value, dict): + value = ConvertingDict(value) + value.configurator = self + elif not isinstance(value, ConvertingList) and isinstance( + value, list): + value = ConvertingList(value) + value.configurator = self + elif not isinstance(value, ConvertingTuple) and isinstance(value, tuple): + value = ConvertingTuple(value) + value.configurator = self + elif isinstance(value, string_types): + m = self.CONVERT_PATTERN.match(value) + if m: + d = m.groupdict() + prefix = d['prefix'] + converter = self.value_converters.get(prefix, None) + if converter: + suffix = d['suffix'] + converter = getattr(self, converter) + value = converter(suffix) + return value + + def configure_custom(self, config): + """Configure an object with a user-supplied factory.""" + c = config.pop('()') + if not callable(c): + c = self.resolve(c) + props = config.pop('.', None) + # Check for valid identifiers + kwargs = dict([(k, config[k]) for k in config if valid_ident(k)]) + result = c(**kwargs) + if props: + for name, value in props.items(): + setattr(result, name, value) + return result + + def as_tuple(self, value): + """Utility function which converts lists to tuples.""" + if isinstance(value, list): + value = tuple(value) + return value diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/database.py b/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/database.py new file mode 100644 index 0000000..eb3765f --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/database.py @@ -0,0 +1,1359 @@ +# -*- coding: utf-8 -*- +# +# Copyright (C) 2012-2023 The Python Software Foundation. +# See LICENSE.txt and CONTRIBUTORS.txt. +# +"""PEP 376 implementation.""" + +from __future__ import unicode_literals + +import base64 +import codecs +import contextlib +import hashlib +import logging +import os +import posixpath +import sys +import zipimport + +from . import DistlibException, resources +from .compat import StringIO +from .version import get_scheme, UnsupportedVersionError +from .metadata import (Metadata, METADATA_FILENAME, WHEEL_METADATA_FILENAME, + LEGACY_METADATA_FILENAME) +from .util import (parse_requirement, cached_property, parse_name_and_version, + read_exports, write_exports, CSVReader, CSVWriter) + +__all__ = [ + 'Distribution', 'BaseInstalledDistribution', 'InstalledDistribution', + 'EggInfoDistribution', 'DistributionPath' +] + +logger = logging.getLogger(__name__) + +EXPORTS_FILENAME = 'pydist-exports.json' +COMMANDS_FILENAME = 'pydist-commands.json' + +DIST_FILES = ('INSTALLER', METADATA_FILENAME, 'RECORD', 'REQUESTED', + 'RESOURCES', EXPORTS_FILENAME, 'SHARED') + +DISTINFO_EXT = '.dist-info' + + +class _Cache(object): + """ + A simple cache mapping names and .dist-info paths to distributions + """ + + def __init__(self): + """ + Initialise an instance. There is normally one for each DistributionPath. + """ + self.name = {} + self.path = {} + self.generated = False + + def clear(self): + """ + Clear the cache, setting it to its initial state. + """ + self.name.clear() + self.path.clear() + self.generated = False + + def add(self, dist): + """ + Add a distribution to the cache. + :param dist: The distribution to add. + """ + if dist.path not in self.path: + self.path[dist.path] = dist + self.name.setdefault(dist.key, []).append(dist) + + +class DistributionPath(object): + """ + Represents a set of distributions installed on a path (typically sys.path). + """ + + def __init__(self, path=None, include_egg=False): + """ + Create an instance from a path, optionally including legacy (distutils/ + setuptools/distribute) distributions. + :param path: The path to use, as a list of directories. If not specified, + sys.path is used. + :param include_egg: If True, this instance will look for and return legacy + distributions as well as those based on PEP 376. + """ + if path is None: + path = sys.path + self.path = path + self._include_dist = True + self._include_egg = include_egg + + self._cache = _Cache() + self._cache_egg = _Cache() + self._cache_enabled = True + self._scheme = get_scheme('default') + + def _get_cache_enabled(self): + return self._cache_enabled + + def _set_cache_enabled(self, value): + self._cache_enabled = value + + cache_enabled = property(_get_cache_enabled, _set_cache_enabled) + + def clear_cache(self): + """ + Clears the internal cache. + """ + self._cache.clear() + self._cache_egg.clear() + + def _yield_distributions(self): + """ + Yield .dist-info and/or .egg(-info) distributions. + """ + # We need to check if we've seen some resources already, because on + # some Linux systems (e.g. some Debian/Ubuntu variants) there are + # symlinks which alias other files in the environment. + seen = set() + for path in self.path: + finder = resources.finder_for_path(path) + if finder is None: + continue + r = finder.find('') + if not r or not r.is_container: + continue + rset = sorted(r.resources) + for entry in rset: + r = finder.find(entry) + if not r or r.path in seen: + continue + try: + if self._include_dist and entry.endswith(DISTINFO_EXT): + possible_filenames = [ + METADATA_FILENAME, WHEEL_METADATA_FILENAME, + LEGACY_METADATA_FILENAME + ] + for metadata_filename in possible_filenames: + metadata_path = posixpath.join( + entry, metadata_filename) + pydist = finder.find(metadata_path) + if pydist: + break + else: + continue + + with contextlib.closing(pydist.as_stream()) as stream: + metadata = Metadata(fileobj=stream, + scheme='legacy') + logger.debug('Found %s', r.path) + seen.add(r.path) + yield new_dist_class(r.path, + metadata=metadata, + env=self) + elif self._include_egg and entry.endswith( + ('.egg-info', '.egg')): + logger.debug('Found %s', r.path) + seen.add(r.path) + yield old_dist_class(r.path, self) + except Exception as e: + msg = 'Unable to read distribution at %s, perhaps due to bad metadata: %s' + logger.warning(msg, r.path, e) + import warnings + warnings.warn(msg % (r.path, e), stacklevel=2) + + def _generate_cache(self): + """ + Scan the path for distributions and populate the cache with + those that are found. + """ + gen_dist = not self._cache.generated + gen_egg = self._include_egg and not self._cache_egg.generated + if gen_dist or gen_egg: + for dist in self._yield_distributions(): + if isinstance(dist, InstalledDistribution): + self._cache.add(dist) + else: + self._cache_egg.add(dist) + + if gen_dist: + self._cache.generated = True + if gen_egg: + self._cache_egg.generated = True + + @classmethod + def distinfo_dirname(cls, name, version): + """ + The *name* and *version* parameters are converted into their + filename-escaped form, i.e. any ``'-'`` characters are replaced + with ``'_'`` other than the one in ``'dist-info'`` and the one + separating the name from the version number. + + :parameter name: is converted to a standard distribution name by replacing + any runs of non- alphanumeric characters with a single + ``'-'``. + :type name: string + :parameter version: is converted to a standard version string. Spaces + become dots, and all other non-alphanumeric characters + (except dots) become dashes, with runs of multiple + dashes condensed to a single dash. + :type version: string + :returns: directory name + :rtype: string""" + name = name.replace('-', '_') + return '-'.join([name, version]) + DISTINFO_EXT + + def get_distributions(self): + """ + Provides an iterator that looks for distributions and returns + :class:`InstalledDistribution` or + :class:`EggInfoDistribution` instances for each one of them. + + :rtype: iterator of :class:`InstalledDistribution` and + :class:`EggInfoDistribution` instances + """ + if not self._cache_enabled: + for dist in self._yield_distributions(): + yield dist + else: + self._generate_cache() + + for dist in self._cache.path.values(): + yield dist + + if self._include_egg: + for dist in self._cache_egg.path.values(): + yield dist + + def get_distribution(self, name): + """ + Looks for a named distribution on the path. + + This function only returns the first result found, as no more than one + value is expected. If nothing is found, ``None`` is returned. + + :rtype: :class:`InstalledDistribution`, :class:`EggInfoDistribution` + or ``None`` + """ + result = None + name = name.lower() + if not self._cache_enabled: + for dist in self._yield_distributions(): + if dist.key == name: + result = dist + break + else: + self._generate_cache() + + if name in self._cache.name: + result = self._cache.name[name][0] + elif self._include_egg and name in self._cache_egg.name: + result = self._cache_egg.name[name][0] + return result + + def provides_distribution(self, name, version=None): + """ + Iterates over all distributions to find which distributions provide *name*. + If a *version* is provided, it will be used to filter the results. + + This function only returns the first result found, since no more than + one values are expected. If the directory is not found, returns ``None``. + + :parameter version: a version specifier that indicates the version + required, conforming to the format in ``PEP-345`` + + :type name: string + :type version: string + """ + matcher = None + if version is not None: + try: + matcher = self._scheme.matcher('%s (%s)' % (name, version)) + except ValueError: + raise DistlibException('invalid name or version: %r, %r' % + (name, version)) + + for dist in self.get_distributions(): + # We hit a problem on Travis where enum34 was installed and doesn't + # have a provides attribute ... + if not hasattr(dist, 'provides'): + logger.debug('No "provides": %s', dist) + else: + provided = dist.provides + + for p in provided: + p_name, p_ver = parse_name_and_version(p) + if matcher is None: + if p_name == name: + yield dist + break + else: + if p_name == name and matcher.match(p_ver): + yield dist + break + + def get_file_path(self, name, relative_path): + """ + Return the path to a resource file. + """ + dist = self.get_distribution(name) + if dist is None: + raise LookupError('no distribution named %r found' % name) + return dist.get_resource_path(relative_path) + + def get_exported_entries(self, category, name=None): + """ + Return all of the exported entries in a particular category. + + :param category: The category to search for entries. + :param name: If specified, only entries with that name are returned. + """ + for dist in self.get_distributions(): + r = dist.exports + if category in r: + d = r[category] + if name is not None: + if name in d: + yield d[name] + else: + for v in d.values(): + yield v + + +class Distribution(object): + """ + A base class for distributions, whether installed or from indexes. + Either way, it must have some metadata, so that's all that's needed + for construction. + """ + + build_time_dependency = False + """ + Set to True if it's known to be only a build-time dependency (i.e. + not needed after installation). + """ + + requested = False + """A boolean that indicates whether the ``REQUESTED`` metadata file is + present (in other words, whether the package was installed by user + request or it was installed as a dependency).""" + + def __init__(self, metadata): + """ + Initialise an instance. + :param metadata: The instance of :class:`Metadata` describing this + distribution. + """ + self.metadata = metadata + self.name = metadata.name + self.key = self.name.lower() # for case-insensitive comparisons + self.version = metadata.version + self.locator = None + self.digest = None + self.extras = None # additional features requested + self.context = None # environment marker overrides + self.download_urls = set() + self.digests = {} + + @property + def source_url(self): + """ + The source archive download URL for this distribution. + """ + return self.metadata.source_url + + download_url = source_url # Backward compatibility + + @property + def name_and_version(self): + """ + A utility property which displays the name and version in parentheses. + """ + return '%s (%s)' % (self.name, self.version) + + @property + def provides(self): + """ + A set of distribution names and versions provided by this distribution. + :return: A set of "name (version)" strings. + """ + plist = self.metadata.provides + s = '%s (%s)' % (self.name, self.version) + if s not in plist: + plist.append(s) + return plist + + def _get_requirements(self, req_attr): + md = self.metadata + reqts = getattr(md, req_attr) + logger.debug('%s: got requirements %r from metadata: %r', self.name, + req_attr, reqts) + return set( + md.get_requirements(reqts, extras=self.extras, env=self.context)) + + @property + def run_requires(self): + return self._get_requirements('run_requires') + + @property + def meta_requires(self): + return self._get_requirements('meta_requires') + + @property + def build_requires(self): + return self._get_requirements('build_requires') + + @property + def test_requires(self): + return self._get_requirements('test_requires') + + @property + def dev_requires(self): + return self._get_requirements('dev_requires') + + def matches_requirement(self, req): + """ + Say if this instance matches (fulfills) a requirement. + :param req: The requirement to match. + :rtype req: str + :return: True if it matches, else False. + """ + # Requirement may contain extras - parse to lose those + # from what's passed to the matcher + r = parse_requirement(req) + scheme = get_scheme(self.metadata.scheme) + try: + matcher = scheme.matcher(r.requirement) + except UnsupportedVersionError: + # XXX compat-mode if cannot read the version + logger.warning('could not read version %r - using name only', req) + name = req.split()[0] + matcher = scheme.matcher(name) + + name = matcher.key # case-insensitive + + result = False + for p in self.provides: + p_name, p_ver = parse_name_and_version(p) + if p_name != name: + continue + try: + result = matcher.match(p_ver) + break + except UnsupportedVersionError: + pass + return result + + def __repr__(self): + """ + Return a textual representation of this instance, + """ + if self.source_url: + suffix = ' [%s]' % self.source_url + else: + suffix = '' + return '' % (self.name, self.version, suffix) + + def __eq__(self, other): + """ + See if this distribution is the same as another. + :param other: The distribution to compare with. To be equal to one + another. distributions must have the same type, name, + version and source_url. + :return: True if it is the same, else False. + """ + if type(other) is not type(self): + result = False + else: + result = (self.name == other.name and self.version == other.version + and self.source_url == other.source_url) + return result + + def __hash__(self): + """ + Compute hash in a way which matches the equality test. + """ + return hash(self.name) + hash(self.version) + hash(self.source_url) + + +class BaseInstalledDistribution(Distribution): + """ + This is the base class for installed distributions (whether PEP 376 or + legacy). + """ + + hasher = None + + def __init__(self, metadata, path, env=None): + """ + Initialise an instance. + :param metadata: An instance of :class:`Metadata` which describes the + distribution. This will normally have been initialised + from a metadata file in the ``path``. + :param path: The path of the ``.dist-info`` or ``.egg-info`` + directory for the distribution. + :param env: This is normally the :class:`DistributionPath` + instance where this distribution was found. + """ + super(BaseInstalledDistribution, self).__init__(metadata) + self.path = path + self.dist_path = env + + def get_hash(self, data, hasher=None): + """ + Get the hash of some data, using a particular hash algorithm, if + specified. + + :param data: The data to be hashed. + :type data: bytes + :param hasher: The name of a hash implementation, supported by hashlib, + or ``None``. Examples of valid values are ``'sha1'``, + ``'sha224'``, ``'sha384'``, '``sha256'``, ``'md5'`` and + ``'sha512'``. If no hasher is specified, the ``hasher`` + attribute of the :class:`InstalledDistribution` instance + is used. If the hasher is determined to be ``None``, MD5 + is used as the hashing algorithm. + :returns: The hash of the data. If a hasher was explicitly specified, + the returned hash will be prefixed with the specified hasher + followed by '='. + :rtype: str + """ + if hasher is None: + hasher = self.hasher + if hasher is None: + hasher = hashlib.md5 + prefix = '' + else: + hasher = getattr(hashlib, hasher) + prefix = '%s=' % self.hasher + digest = hasher(data).digest() + digest = base64.urlsafe_b64encode(digest).rstrip(b'=').decode('ascii') + return '%s%s' % (prefix, digest) + + +class InstalledDistribution(BaseInstalledDistribution): + """ + Created with the *path* of the ``.dist-info`` directory provided to the + constructor. It reads the metadata contained in ``pydist.json`` when it is + instantiated., or uses a passed in Metadata instance (useful for when + dry-run mode is being used). + """ + + hasher = 'sha256' + + def __init__(self, path, metadata=None, env=None): + self.modules = [] + self.finder = finder = resources.finder_for_path(path) + if finder is None: + raise ValueError('finder unavailable for %s' % path) + if env and env._cache_enabled and path in env._cache.path: + metadata = env._cache.path[path].metadata + elif metadata is None: + r = finder.find(METADATA_FILENAME) + # Temporary - for Wheel 0.23 support + if r is None: + r = finder.find(WHEEL_METADATA_FILENAME) + # Temporary - for legacy support + if r is None: + r = finder.find(LEGACY_METADATA_FILENAME) + if r is None: + raise ValueError('no %s found in %s' % + (METADATA_FILENAME, path)) + with contextlib.closing(r.as_stream()) as stream: + metadata = Metadata(fileobj=stream, scheme='legacy') + + super(InstalledDistribution, self).__init__(metadata, path, env) + + if env and env._cache_enabled: + env._cache.add(self) + + r = finder.find('REQUESTED') + self.requested = r is not None + p = os.path.join(path, 'top_level.txt') + if os.path.exists(p): + with open(p, 'rb') as f: + data = f.read().decode('utf-8') + self.modules = data.splitlines() + + def __repr__(self): + return '' % ( + self.name, self.version, self.path) + + def __str__(self): + return "%s %s" % (self.name, self.version) + + def _get_records(self): + """ + Get the list of installed files for the distribution + :return: A list of tuples of path, hash and size. Note that hash and + size might be ``None`` for some entries. The path is exactly + as stored in the file (which is as in PEP 376). + """ + results = [] + r = self.get_distinfo_resource('RECORD') + with contextlib.closing(r.as_stream()) as stream: + with CSVReader(stream=stream) as record_reader: + # Base location is parent dir of .dist-info dir + # base_location = os.path.dirname(self.path) + # base_location = os.path.abspath(base_location) + for row in record_reader: + missing = [None for i in range(len(row), 3)] + path, checksum, size = row + missing + # if not os.path.isabs(path): + # path = path.replace('/', os.sep) + # path = os.path.join(base_location, path) + results.append((path, checksum, size)) + return results + + @cached_property + def exports(self): + """ + Return the information exported by this distribution. + :return: A dictionary of exports, mapping an export category to a dict + of :class:`ExportEntry` instances describing the individual + export entries, and keyed by name. + """ + result = {} + r = self.get_distinfo_resource(EXPORTS_FILENAME) + if r: + result = self.read_exports() + return result + + def read_exports(self): + """ + Read exports data from a file in .ini format. + + :return: A dictionary of exports, mapping an export category to a list + of :class:`ExportEntry` instances describing the individual + export entries. + """ + result = {} + r = self.get_distinfo_resource(EXPORTS_FILENAME) + if r: + with contextlib.closing(r.as_stream()) as stream: + result = read_exports(stream) + return result + + def write_exports(self, exports): + """ + Write a dictionary of exports to a file in .ini format. + :param exports: A dictionary of exports, mapping an export category to + a list of :class:`ExportEntry` instances describing the + individual export entries. + """ + rf = self.get_distinfo_file(EXPORTS_FILENAME) + with open(rf, 'w') as f: + write_exports(exports, f) + + def get_resource_path(self, relative_path): + """ + NOTE: This API may change in the future. + + Return the absolute path to a resource file with the given relative + path. + + :param relative_path: The path, relative to .dist-info, of the resource + of interest. + :return: The absolute path where the resource is to be found. + """ + r = self.get_distinfo_resource('RESOURCES') + with contextlib.closing(r.as_stream()) as stream: + with CSVReader(stream=stream) as resources_reader: + for relative, destination in resources_reader: + if relative == relative_path: + return destination + raise KeyError('no resource file with relative path %r ' + 'is installed' % relative_path) + + def list_installed_files(self): + """ + Iterates over the ``RECORD`` entries and returns a tuple + ``(path, hash, size)`` for each line. + + :returns: iterator of (path, hash, size) + """ + for result in self._get_records(): + yield result + + def write_installed_files(self, paths, prefix, dry_run=False): + """ + Writes the ``RECORD`` file, using the ``paths`` iterable passed in. Any + existing ``RECORD`` file is silently overwritten. + + prefix is used to determine when to write absolute paths. + """ + prefix = os.path.join(prefix, '') + base = os.path.dirname(self.path) + base_under_prefix = base.startswith(prefix) + base = os.path.join(base, '') + record_path = self.get_distinfo_file('RECORD') + logger.info('creating %s', record_path) + if dry_run: + return None + with CSVWriter(record_path) as writer: + for path in paths: + if os.path.isdir(path) or path.endswith(('.pyc', '.pyo')): + # do not put size and hash, as in PEP-376 + hash_value = size = '' + else: + size = '%d' % os.path.getsize(path) + with open(path, 'rb') as fp: + hash_value = self.get_hash(fp.read()) + if path.startswith(base) or (base_under_prefix + and path.startswith(prefix)): + path = os.path.relpath(path, base) + writer.writerow((path, hash_value, size)) + + # add the RECORD file itself + if record_path.startswith(base): + record_path = os.path.relpath(record_path, base) + writer.writerow((record_path, '', '')) + return record_path + + def check_installed_files(self): + """ + Checks that the hashes and sizes of the files in ``RECORD`` are + matched by the files themselves. Returns a (possibly empty) list of + mismatches. Each entry in the mismatch list will be a tuple consisting + of the path, 'exists', 'size' or 'hash' according to what didn't match + (existence is checked first, then size, then hash), the expected + value and the actual value. + """ + mismatches = [] + base = os.path.dirname(self.path) + record_path = self.get_distinfo_file('RECORD') + for path, hash_value, size in self.list_installed_files(): + if not os.path.isabs(path): + path = os.path.join(base, path) + if path == record_path: + continue + if not os.path.exists(path): + mismatches.append((path, 'exists', True, False)) + elif os.path.isfile(path): + actual_size = str(os.path.getsize(path)) + if size and actual_size != size: + mismatches.append((path, 'size', size, actual_size)) + elif hash_value: + if '=' in hash_value: + hasher = hash_value.split('=', 1)[0] + else: + hasher = None + + with open(path, 'rb') as f: + actual_hash = self.get_hash(f.read(), hasher) + if actual_hash != hash_value: + mismatches.append( + (path, 'hash', hash_value, actual_hash)) + return mismatches + + @cached_property + def shared_locations(self): + """ + A dictionary of shared locations whose keys are in the set 'prefix', + 'purelib', 'platlib', 'scripts', 'headers', 'data' and 'namespace'. + The corresponding value is the absolute path of that category for + this distribution, and takes into account any paths selected by the + user at installation time (e.g. via command-line arguments). In the + case of the 'namespace' key, this would be a list of absolute paths + for the roots of namespace packages in this distribution. + + The first time this property is accessed, the relevant information is + read from the SHARED file in the .dist-info directory. + """ + result = {} + shared_path = os.path.join(self.path, 'SHARED') + if os.path.isfile(shared_path): + with codecs.open(shared_path, 'r', encoding='utf-8') as f: + lines = f.read().splitlines() + for line in lines: + key, value = line.split('=', 1) + if key == 'namespace': + result.setdefault(key, []).append(value) + else: + result[key] = value + return result + + def write_shared_locations(self, paths, dry_run=False): + """ + Write shared location information to the SHARED file in .dist-info. + :param paths: A dictionary as described in the documentation for + :meth:`shared_locations`. + :param dry_run: If True, the action is logged but no file is actually + written. + :return: The path of the file written to. + """ + shared_path = os.path.join(self.path, 'SHARED') + logger.info('creating %s', shared_path) + if dry_run: + return None + lines = [] + for key in ('prefix', 'lib', 'headers', 'scripts', 'data'): + path = paths[key] + if os.path.isdir(paths[key]): + lines.append('%s=%s' % (key, path)) + for ns in paths.get('namespace', ()): + lines.append('namespace=%s' % ns) + + with codecs.open(shared_path, 'w', encoding='utf-8') as f: + f.write('\n'.join(lines)) + return shared_path + + def get_distinfo_resource(self, path): + if path not in DIST_FILES: + raise DistlibException('invalid path for a dist-info file: ' + '%r at %r' % (path, self.path)) + finder = resources.finder_for_path(self.path) + if finder is None: + raise DistlibException('Unable to get a finder for %s' % self.path) + return finder.find(path) + + def get_distinfo_file(self, path): + """ + Returns a path located under the ``.dist-info`` directory. Returns a + string representing the path. + + :parameter path: a ``'/'``-separated path relative to the + ``.dist-info`` directory or an absolute path; + If *path* is an absolute path and doesn't start + with the ``.dist-info`` directory path, + a :class:`DistlibException` is raised + :type path: str + :rtype: str + """ + # Check if it is an absolute path # XXX use relpath, add tests + if path.find(os.sep) >= 0: + # it's an absolute path? + distinfo_dirname, path = path.split(os.sep)[-2:] + if distinfo_dirname != self.path.split(os.sep)[-1]: + raise DistlibException( + 'dist-info file %r does not belong to the %r %s ' + 'distribution' % (path, self.name, self.version)) + + # The file must be relative + if path not in DIST_FILES: + raise DistlibException('invalid path for a dist-info file: ' + '%r at %r' % (path, self.path)) + + return os.path.join(self.path, path) + + def list_distinfo_files(self): + """ + Iterates over the ``RECORD`` entries and returns paths for each line if + the path is pointing to a file located in the ``.dist-info`` directory + or one of its subdirectories. + + :returns: iterator of paths + """ + base = os.path.dirname(self.path) + for path, checksum, size in self._get_records(): + # XXX add separator or use real relpath algo + if not os.path.isabs(path): + path = os.path.join(base, path) + if path.startswith(self.path): + yield path + + def __eq__(self, other): + return (isinstance(other, InstalledDistribution) + and self.path == other.path) + + # See http://docs.python.org/reference/datamodel#object.__hash__ + __hash__ = object.__hash__ + + +class EggInfoDistribution(BaseInstalledDistribution): + """Created with the *path* of the ``.egg-info`` directory or file provided + to the constructor. It reads the metadata contained in the file itself, or + if the given path happens to be a directory, the metadata is read from the + file ``PKG-INFO`` under that directory.""" + + requested = True # as we have no way of knowing, assume it was + shared_locations = {} + + def __init__(self, path, env=None): + + def set_name_and_version(s, n, v): + s.name = n + s.key = n.lower() # for case-insensitive comparisons + s.version = v + + self.path = path + self.dist_path = env + if env and env._cache_enabled and path in env._cache_egg.path: + metadata = env._cache_egg.path[path].metadata + set_name_and_version(self, metadata.name, metadata.version) + else: + metadata = self._get_metadata(path) + + # Need to be set before caching + set_name_and_version(self, metadata.name, metadata.version) + + if env and env._cache_enabled: + env._cache_egg.add(self) + super(EggInfoDistribution, self).__init__(metadata, path, env) + + def _get_metadata(self, path): + requires = None + + def parse_requires_data(data): + """Create a list of dependencies from a requires.txt file. + + *data*: the contents of a setuptools-produced requires.txt file. + """ + reqs = [] + lines = data.splitlines() + for line in lines: + line = line.strip() + # sectioned files have bare newlines (separating sections) + if not line: # pragma: no cover + continue + if line.startswith('['): # pragma: no cover + logger.warning( + 'Unexpected line: quitting requirement scan: %r', line) + break + r = parse_requirement(line) + if not r: # pragma: no cover + logger.warning('Not recognised as a requirement: %r', line) + continue + if r.extras: # pragma: no cover + logger.warning('extra requirements in requires.txt are ' + 'not supported') + if not r.constraints: + reqs.append(r.name) + else: + cons = ', '.join('%s%s' % c for c in r.constraints) + reqs.append('%s (%s)' % (r.name, cons)) + return reqs + + def parse_requires_path(req_path): + """Create a list of dependencies from a requires.txt file. + + *req_path*: the path to a setuptools-produced requires.txt file. + """ + + reqs = [] + try: + with codecs.open(req_path, 'r', 'utf-8') as fp: + reqs = parse_requires_data(fp.read()) + except IOError: + pass + return reqs + + tl_path = tl_data = None + if path.endswith('.egg'): + if os.path.isdir(path): + p = os.path.join(path, 'EGG-INFO') + meta_path = os.path.join(p, 'PKG-INFO') + metadata = Metadata(path=meta_path, scheme='legacy') + req_path = os.path.join(p, 'requires.txt') + tl_path = os.path.join(p, 'top_level.txt') + requires = parse_requires_path(req_path) + else: + # FIXME handle the case where zipfile is not available + zipf = zipimport.zipimporter(path) + fileobj = StringIO( + zipf.get_data('EGG-INFO/PKG-INFO').decode('utf8')) + metadata = Metadata(fileobj=fileobj, scheme='legacy') + try: + data = zipf.get_data('EGG-INFO/requires.txt') + tl_data = zipf.get_data('EGG-INFO/top_level.txt').decode( + 'utf-8') + requires = parse_requires_data(data.decode('utf-8')) + except IOError: + requires = None + elif path.endswith('.egg-info'): + if os.path.isdir(path): + req_path = os.path.join(path, 'requires.txt') + requires = parse_requires_path(req_path) + path = os.path.join(path, 'PKG-INFO') + tl_path = os.path.join(path, 'top_level.txt') + metadata = Metadata(path=path, scheme='legacy') + else: + raise DistlibException('path must end with .egg-info or .egg, ' + 'got %r' % path) + + if requires: + metadata.add_requirements(requires) + # look for top-level modules in top_level.txt, if present + if tl_data is None: + if tl_path is not None and os.path.exists(tl_path): + with open(tl_path, 'rb') as f: + tl_data = f.read().decode('utf-8') + if not tl_data: + tl_data = [] + else: + tl_data = tl_data.splitlines() + self.modules = tl_data + return metadata + + def __repr__(self): + return '' % (self.name, self.version, + self.path) + + def __str__(self): + return "%s %s" % (self.name, self.version) + + def check_installed_files(self): + """ + Checks that the hashes and sizes of the files in ``RECORD`` are + matched by the files themselves. Returns a (possibly empty) list of + mismatches. Each entry in the mismatch list will be a tuple consisting + of the path, 'exists', 'size' or 'hash' according to what didn't match + (existence is checked first, then size, then hash), the expected + value and the actual value. + """ + mismatches = [] + record_path = os.path.join(self.path, 'installed-files.txt') + if os.path.exists(record_path): + for path, _, _ in self.list_installed_files(): + if path == record_path: + continue + if not os.path.exists(path): + mismatches.append((path, 'exists', True, False)) + return mismatches + + def list_installed_files(self): + """ + Iterates over the ``installed-files.txt`` entries and returns a tuple + ``(path, hash, size)`` for each line. + + :returns: a list of (path, hash, size) + """ + + def _md5(path): + f = open(path, 'rb') + try: + content = f.read() + finally: + f.close() + return hashlib.md5(content).hexdigest() + + def _size(path): + return os.stat(path).st_size + + record_path = os.path.join(self.path, 'installed-files.txt') + result = [] + if os.path.exists(record_path): + with codecs.open(record_path, 'r', encoding='utf-8') as f: + for line in f: + line = line.strip() + p = os.path.normpath(os.path.join(self.path, line)) + # "./" is present as a marker between installed files + # and installation metadata files + if not os.path.exists(p): + logger.warning('Non-existent file: %s', p) + if p.endswith(('.pyc', '.pyo')): + continue + # otherwise fall through and fail + if not os.path.isdir(p): + result.append((p, _md5(p), _size(p))) + result.append((record_path, None, None)) + return result + + def list_distinfo_files(self, absolute=False): + """ + Iterates over the ``installed-files.txt`` entries and returns paths for + each line if the path is pointing to a file located in the + ``.egg-info`` directory or one of its subdirectories. + + :parameter absolute: If *absolute* is ``True``, each returned path is + transformed into a local absolute path. Otherwise the + raw value from ``installed-files.txt`` is returned. + :type absolute: boolean + :returns: iterator of paths + """ + record_path = os.path.join(self.path, 'installed-files.txt') + if os.path.exists(record_path): + skip = True + with codecs.open(record_path, 'r', encoding='utf-8') as f: + for line in f: + line = line.strip() + if line == './': + skip = False + continue + if not skip: + p = os.path.normpath(os.path.join(self.path, line)) + if p.startswith(self.path): + if absolute: + yield p + else: + yield line + + def __eq__(self, other): + return (isinstance(other, EggInfoDistribution) + and self.path == other.path) + + # See http://docs.python.org/reference/datamodel#object.__hash__ + __hash__ = object.__hash__ + + +new_dist_class = InstalledDistribution +old_dist_class = EggInfoDistribution + + +class DependencyGraph(object): + """ + Represents a dependency graph between distributions. + + The dependency relationships are stored in an ``adjacency_list`` that maps + distributions to a list of ``(other, label)`` tuples where ``other`` + is a distribution and the edge is labeled with ``label`` (i.e. the version + specifier, if such was provided). Also, for more efficient traversal, for + every distribution ``x``, a list of predecessors is kept in + ``reverse_list[x]``. An edge from distribution ``a`` to + distribution ``b`` means that ``a`` depends on ``b``. If any missing + dependencies are found, they are stored in ``missing``, which is a + dictionary that maps distributions to a list of requirements that were not + provided by any other distributions. + """ + + def __init__(self): + self.adjacency_list = {} + self.reverse_list = {} + self.missing = {} + + def add_distribution(self, distribution): + """Add the *distribution* to the graph. + + :type distribution: :class:`distutils2.database.InstalledDistribution` + or :class:`distutils2.database.EggInfoDistribution` + """ + self.adjacency_list[distribution] = [] + self.reverse_list[distribution] = [] + # self.missing[distribution] = [] + + def add_edge(self, x, y, label=None): + """Add an edge from distribution *x* to distribution *y* with the given + *label*. + + :type x: :class:`distutils2.database.InstalledDistribution` or + :class:`distutils2.database.EggInfoDistribution` + :type y: :class:`distutils2.database.InstalledDistribution` or + :class:`distutils2.database.EggInfoDistribution` + :type label: ``str`` or ``None`` + """ + self.adjacency_list[x].append((y, label)) + # multiple edges are allowed, so be careful + if x not in self.reverse_list[y]: + self.reverse_list[y].append(x) + + def add_missing(self, distribution, requirement): + """ + Add a missing *requirement* for the given *distribution*. + + :type distribution: :class:`distutils2.database.InstalledDistribution` + or :class:`distutils2.database.EggInfoDistribution` + :type requirement: ``str`` + """ + logger.debug('%s missing %r', distribution, requirement) + self.missing.setdefault(distribution, []).append(requirement) + + def _repr_dist(self, dist): + return '%s %s' % (dist.name, dist.version) + + def repr_node(self, dist, level=1): + """Prints only a subgraph""" + output = [self._repr_dist(dist)] + for other, label in self.adjacency_list[dist]: + dist = self._repr_dist(other) + if label is not None: + dist = '%s [%s]' % (dist, label) + output.append(' ' * level + str(dist)) + suboutput = self.repr_node(other, level + 1) + subs = suboutput.split('\n') + output.extend(subs[1:]) + return '\n'.join(output) + + def to_dot(self, f, skip_disconnected=True): + """Writes a DOT output for the graph to the provided file *f*. + + If *skip_disconnected* is set to ``True``, then all distributions + that are not dependent on any other distribution are skipped. + + :type f: has to support ``file``-like operations + :type skip_disconnected: ``bool`` + """ + disconnected = [] + + f.write("digraph dependencies {\n") + for dist, adjs in self.adjacency_list.items(): + if len(adjs) == 0 and not skip_disconnected: + disconnected.append(dist) + for other, label in adjs: + if label is not None: + f.write('"%s" -> "%s" [label="%s"]\n' % + (dist.name, other.name, label)) + else: + f.write('"%s" -> "%s"\n' % (dist.name, other.name)) + if not skip_disconnected and len(disconnected) > 0: + f.write('subgraph disconnected {\n') + f.write('label = "Disconnected"\n') + f.write('bgcolor = red\n') + + for dist in disconnected: + f.write('"%s"' % dist.name) + f.write('\n') + f.write('}\n') + f.write('}\n') + + def topological_sort(self): + """ + Perform a topological sort of the graph. + :return: A tuple, the first element of which is a topologically sorted + list of distributions, and the second element of which is a + list of distributions that cannot be sorted because they have + circular dependencies and so form a cycle. + """ + result = [] + # Make a shallow copy of the adjacency list + alist = {} + for k, v in self.adjacency_list.items(): + alist[k] = v[:] + while True: + # See what we can remove in this run + to_remove = [] + for k, v in list(alist.items())[:]: + if not v: + to_remove.append(k) + del alist[k] + if not to_remove: + # What's left in alist (if anything) is a cycle. + break + # Remove from the adjacency list of others + for k, v in alist.items(): + alist[k] = [(d, r) for d, r in v if d not in to_remove] + logger.debug('Moving to result: %s', + ['%s (%s)' % (d.name, d.version) for d in to_remove]) + result.extend(to_remove) + return result, list(alist.keys()) + + def __repr__(self): + """Representation of the graph""" + output = [] + for dist, adjs in self.adjacency_list.items(): + output.append(self.repr_node(dist)) + return '\n'.join(output) + + +def make_graph(dists, scheme='default'): + """Makes a dependency graph from the given distributions. + + :parameter dists: a list of distributions + :type dists: list of :class:`distutils2.database.InstalledDistribution` and + :class:`distutils2.database.EggInfoDistribution` instances + :rtype: a :class:`DependencyGraph` instance + """ + scheme = get_scheme(scheme) + graph = DependencyGraph() + provided = {} # maps names to lists of (version, dist) tuples + + # first, build the graph and find out what's provided + for dist in dists: + graph.add_distribution(dist) + + for p in dist.provides: + name, version = parse_name_and_version(p) + logger.debug('Add to provided: %s, %s, %s', name, version, dist) + provided.setdefault(name, []).append((version, dist)) + + # now make the edges + for dist in dists: + requires = (dist.run_requires | dist.meta_requires + | dist.build_requires | dist.dev_requires) + for req in requires: + try: + matcher = scheme.matcher(req) + except UnsupportedVersionError: + # XXX compat-mode if cannot read the version + logger.warning('could not read version %r - using name only', + req) + name = req.split()[0] + matcher = scheme.matcher(name) + + name = matcher.key # case-insensitive + + matched = False + if name in provided: + for version, provider in provided[name]: + try: + match = matcher.match(version) + except UnsupportedVersionError: + match = False + + if match: + graph.add_edge(dist, provider, req) + matched = True + break + if not matched: + graph.add_missing(dist, req) + return graph + + +def get_dependent_dists(dists, dist): + """Recursively generate a list of distributions from *dists* that are + dependent on *dist*. + + :param dists: a list of distributions + :param dist: a distribution, member of *dists* for which we are interested + """ + if dist not in dists: + raise DistlibException('given distribution %r is not a member ' + 'of the list' % dist.name) + graph = make_graph(dists) + + dep = [dist] # dependent distributions + todo = graph.reverse_list[dist] # list of nodes we should inspect + + while todo: + d = todo.pop() + dep.append(d) + for succ in graph.reverse_list[d]: + if succ not in dep: + todo.append(succ) + + dep.pop(0) # remove dist from dep, was there to prevent infinite loops + return dep + + +def get_required_dists(dists, dist): + """Recursively generate a list of distributions from *dists* that are + required by *dist*. + + :param dists: a list of distributions + :param dist: a distribution, member of *dists* for which we are interested + in finding the dependencies. + """ + if dist not in dists: + raise DistlibException('given distribution %r is not a member ' + 'of the list' % dist.name) + graph = make_graph(dists) + + req = set() # required distributions + todo = graph.adjacency_list[dist] # list of nodes we should inspect + seen = set(t[0] for t in todo) # already added to todo + + while todo: + d = todo.pop()[0] + req.add(d) + pred_list = graph.adjacency_list[d] + for pred in pred_list: + d = pred[0] + if d not in req and d not in seen: + seen.add(d) + todo.append(pred) + return req + + +def make_dist(name, version, **kwargs): + """ + A convenience method for making a dist given just a name and version. + """ + summary = kwargs.pop('summary', 'Placeholder for summary') + md = Metadata(**kwargs) + md.name = name + md.version = version + md.summary = summary or 'Placeholder for summary' + return Distribution(md) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/index.py b/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/index.py new file mode 100644 index 0000000..56cd286 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/index.py @@ -0,0 +1,508 @@ +# -*- coding: utf-8 -*- +# +# Copyright (C) 2013-2023 Vinay Sajip. +# Licensed to the Python Software Foundation under a contributor agreement. +# See LICENSE.txt and CONTRIBUTORS.txt. +# +import hashlib +import logging +import os +import shutil +import subprocess +import tempfile +try: + from threading import Thread +except ImportError: # pragma: no cover + from dummy_threading import Thread + +from . import DistlibException +from .compat import (HTTPBasicAuthHandler, Request, HTTPPasswordMgr, + urlparse, build_opener, string_types) +from .util import zip_dir, ServerProxy + +logger = logging.getLogger(__name__) + +DEFAULT_INDEX = 'https://pypi.org/pypi' +DEFAULT_REALM = 'pypi' + + +class PackageIndex(object): + """ + This class represents a package index compatible with PyPI, the Python + Package Index. + """ + + boundary = b'----------ThIs_Is_tHe_distlib_index_bouNdaRY_$' + + def __init__(self, url=None): + """ + Initialise an instance. + + :param url: The URL of the index. If not specified, the URL for PyPI is + used. + """ + self.url = url or DEFAULT_INDEX + self.read_configuration() + scheme, netloc, path, params, query, frag = urlparse(self.url) + if params or query or frag or scheme not in ('http', 'https'): + raise DistlibException('invalid repository: %s' % self.url) + self.password_handler = None + self.ssl_verifier = None + self.gpg = None + self.gpg_home = None + with open(os.devnull, 'w') as sink: + # Use gpg by default rather than gpg2, as gpg2 insists on + # prompting for passwords + for s in ('gpg', 'gpg2'): + try: + rc = subprocess.check_call([s, '--version'], stdout=sink, + stderr=sink) + if rc == 0: + self.gpg = s + break + except OSError: + pass + + def _get_pypirc_command(self): + """ + Get the distutils command for interacting with PyPI configurations. + :return: the command. + """ + from .util import _get_pypirc_command as cmd + return cmd() + + def read_configuration(self): + """ + Read the PyPI access configuration as supported by distutils. This populates + ``username``, ``password``, ``realm`` and ``url`` attributes from the + configuration. + """ + from .util import _load_pypirc + cfg = _load_pypirc(self) + self.username = cfg.get('username') + self.password = cfg.get('password') + self.realm = cfg.get('realm', 'pypi') + self.url = cfg.get('repository', self.url) + + def save_configuration(self): + """ + Save the PyPI access configuration. You must have set ``username`` and + ``password`` attributes before calling this method. + """ + self.check_credentials() + from .util import _store_pypirc + _store_pypirc(self) + + def check_credentials(self): + """ + Check that ``username`` and ``password`` have been set, and raise an + exception if not. + """ + if self.username is None or self.password is None: + raise DistlibException('username and password must be set') + pm = HTTPPasswordMgr() + _, netloc, _, _, _, _ = urlparse(self.url) + pm.add_password(self.realm, netloc, self.username, self.password) + self.password_handler = HTTPBasicAuthHandler(pm) + + def register(self, metadata): # pragma: no cover + """ + Register a distribution on PyPI, using the provided metadata. + + :param metadata: A :class:`Metadata` instance defining at least a name + and version number for the distribution to be + registered. + :return: The HTTP response received from PyPI upon submission of the + request. + """ + self.check_credentials() + metadata.validate() + d = metadata.todict() + d[':action'] = 'verify' + request = self.encode_request(d.items(), []) + self.send_request(request) + d[':action'] = 'submit' + request = self.encode_request(d.items(), []) + return self.send_request(request) + + def _reader(self, name, stream, outbuf): + """ + Thread runner for reading lines of from a subprocess into a buffer. + + :param name: The logical name of the stream (used for logging only). + :param stream: The stream to read from. This will typically a pipe + connected to the output stream of a subprocess. + :param outbuf: The list to append the read lines to. + """ + while True: + s = stream.readline() + if not s: + break + s = s.decode('utf-8').rstrip() + outbuf.append(s) + logger.debug('%s: %s' % (name, s)) + stream.close() + + def get_sign_command(self, filename, signer, sign_password, keystore=None): # pragma: no cover + """ + Return a suitable command for signing a file. + + :param filename: The pathname to the file to be signed. + :param signer: The identifier of the signer of the file. + :param sign_password: The passphrase for the signer's + private key used for signing. + :param keystore: The path to a directory which contains the keys + used in verification. If not specified, the + instance's ``gpg_home`` attribute is used instead. + :return: The signing command as a list suitable to be + passed to :class:`subprocess.Popen`. + """ + cmd = [self.gpg, '--status-fd', '2', '--no-tty'] + if keystore is None: + keystore = self.gpg_home + if keystore: + cmd.extend(['--homedir', keystore]) + if sign_password is not None: + cmd.extend(['--batch', '--passphrase-fd', '0']) + td = tempfile.mkdtemp() + sf = os.path.join(td, os.path.basename(filename) + '.asc') + cmd.extend(['--detach-sign', '--armor', '--local-user', + signer, '--output', sf, filename]) + logger.debug('invoking: %s', ' '.join(cmd)) + return cmd, sf + + def run_command(self, cmd, input_data=None): + """ + Run a command in a child process , passing it any input data specified. + + :param cmd: The command to run. + :param input_data: If specified, this must be a byte string containing + data to be sent to the child process. + :return: A tuple consisting of the subprocess' exit code, a list of + lines read from the subprocess' ``stdout``, and a list of + lines read from the subprocess' ``stderr``. + """ + kwargs = { + 'stdout': subprocess.PIPE, + 'stderr': subprocess.PIPE, + } + if input_data is not None: + kwargs['stdin'] = subprocess.PIPE + stdout = [] + stderr = [] + p = subprocess.Popen(cmd, **kwargs) + # We don't use communicate() here because we may need to + # get clever with interacting with the command + t1 = Thread(target=self._reader, args=('stdout', p.stdout, stdout)) + t1.start() + t2 = Thread(target=self._reader, args=('stderr', p.stderr, stderr)) + t2.start() + if input_data is not None: + p.stdin.write(input_data) + p.stdin.close() + + p.wait() + t1.join() + t2.join() + return p.returncode, stdout, stderr + + def sign_file(self, filename, signer, sign_password, keystore=None): # pragma: no cover + """ + Sign a file. + + :param filename: The pathname to the file to be signed. + :param signer: The identifier of the signer of the file. + :param sign_password: The passphrase for the signer's + private key used for signing. + :param keystore: The path to a directory which contains the keys + used in signing. If not specified, the instance's + ``gpg_home`` attribute is used instead. + :return: The absolute pathname of the file where the signature is + stored. + """ + cmd, sig_file = self.get_sign_command(filename, signer, sign_password, + keystore) + rc, stdout, stderr = self.run_command(cmd, + sign_password.encode('utf-8')) + if rc != 0: + raise DistlibException('sign command failed with error ' + 'code %s' % rc) + return sig_file + + def upload_file(self, metadata, filename, signer=None, sign_password=None, + filetype='sdist', pyversion='source', keystore=None): + """ + Upload a release file to the index. + + :param metadata: A :class:`Metadata` instance defining at least a name + and version number for the file to be uploaded. + :param filename: The pathname of the file to be uploaded. + :param signer: The identifier of the signer of the file. + :param sign_password: The passphrase for the signer's + private key used for signing. + :param filetype: The type of the file being uploaded. This is the + distutils command which produced that file, e.g. + ``sdist`` or ``bdist_wheel``. + :param pyversion: The version of Python which the release relates + to. For code compatible with any Python, this would + be ``source``, otherwise it would be e.g. ``3.2``. + :param keystore: The path to a directory which contains the keys + used in signing. If not specified, the instance's + ``gpg_home`` attribute is used instead. + :return: The HTTP response received from PyPI upon submission of the + request. + """ + self.check_credentials() + if not os.path.exists(filename): + raise DistlibException('not found: %s' % filename) + metadata.validate() + d = metadata.todict() + sig_file = None + if signer: + if not self.gpg: + logger.warning('no signing program available - not signed') + else: + sig_file = self.sign_file(filename, signer, sign_password, + keystore) + with open(filename, 'rb') as f: + file_data = f.read() + md5_digest = hashlib.md5(file_data).hexdigest() + sha256_digest = hashlib.sha256(file_data).hexdigest() + d.update({ + ':action': 'file_upload', + 'protocol_version': '1', + 'filetype': filetype, + 'pyversion': pyversion, + 'md5_digest': md5_digest, + 'sha256_digest': sha256_digest, + }) + files = [('content', os.path.basename(filename), file_data)] + if sig_file: + with open(sig_file, 'rb') as f: + sig_data = f.read() + files.append(('gpg_signature', os.path.basename(sig_file), + sig_data)) + shutil.rmtree(os.path.dirname(sig_file)) + request = self.encode_request(d.items(), files) + return self.send_request(request) + + def upload_documentation(self, metadata, doc_dir): # pragma: no cover + """ + Upload documentation to the index. + + :param metadata: A :class:`Metadata` instance defining at least a name + and version number for the documentation to be + uploaded. + :param doc_dir: The pathname of the directory which contains the + documentation. This should be the directory that + contains the ``index.html`` for the documentation. + :return: The HTTP response received from PyPI upon submission of the + request. + """ + self.check_credentials() + if not os.path.isdir(doc_dir): + raise DistlibException('not a directory: %r' % doc_dir) + fn = os.path.join(doc_dir, 'index.html') + if not os.path.exists(fn): + raise DistlibException('not found: %r' % fn) + metadata.validate() + name, version = metadata.name, metadata.version + zip_data = zip_dir(doc_dir).getvalue() + fields = [(':action', 'doc_upload'), + ('name', name), ('version', version)] + files = [('content', name, zip_data)] + request = self.encode_request(fields, files) + return self.send_request(request) + + def get_verify_command(self, signature_filename, data_filename, + keystore=None): + """ + Return a suitable command for verifying a file. + + :param signature_filename: The pathname to the file containing the + signature. + :param data_filename: The pathname to the file containing the + signed data. + :param keystore: The path to a directory which contains the keys + used in verification. If not specified, the + instance's ``gpg_home`` attribute is used instead. + :return: The verifying command as a list suitable to be + passed to :class:`subprocess.Popen`. + """ + cmd = [self.gpg, '--status-fd', '2', '--no-tty'] + if keystore is None: + keystore = self.gpg_home + if keystore: + cmd.extend(['--homedir', keystore]) + cmd.extend(['--verify', signature_filename, data_filename]) + logger.debug('invoking: %s', ' '.join(cmd)) + return cmd + + def verify_signature(self, signature_filename, data_filename, + keystore=None): + """ + Verify a signature for a file. + + :param signature_filename: The pathname to the file containing the + signature. + :param data_filename: The pathname to the file containing the + signed data. + :param keystore: The path to a directory which contains the keys + used in verification. If not specified, the + instance's ``gpg_home`` attribute is used instead. + :return: True if the signature was verified, else False. + """ + if not self.gpg: + raise DistlibException('verification unavailable because gpg ' + 'unavailable') + cmd = self.get_verify_command(signature_filename, data_filename, + keystore) + rc, stdout, stderr = self.run_command(cmd) + if rc not in (0, 1): + raise DistlibException('verify command failed with error code %s' % rc) + return rc == 0 + + def download_file(self, url, destfile, digest=None, reporthook=None): + """ + This is a convenience method for downloading a file from an URL. + Normally, this will be a file from the index, though currently + no check is made for this (i.e. a file can be downloaded from + anywhere). + + The method is just like the :func:`urlretrieve` function in the + standard library, except that it allows digest computation to be + done during download and checking that the downloaded data + matched any expected value. + + :param url: The URL of the file to be downloaded (assumed to be + available via an HTTP GET request). + :param destfile: The pathname where the downloaded file is to be + saved. + :param digest: If specified, this must be a (hasher, value) + tuple, where hasher is the algorithm used (e.g. + ``'md5'``) and ``value`` is the expected value. + :param reporthook: The same as for :func:`urlretrieve` in the + standard library. + """ + if digest is None: + digester = None + logger.debug('No digest specified') + else: + if isinstance(digest, (list, tuple)): + hasher, digest = digest + else: + hasher = 'md5' + digester = getattr(hashlib, hasher)() + logger.debug('Digest specified: %s' % digest) + # The following code is equivalent to urlretrieve. + # We need to do it this way so that we can compute the + # digest of the file as we go. + with open(destfile, 'wb') as dfp: + # addinfourl is not a context manager on 2.x + # so we have to use try/finally + sfp = self.send_request(Request(url)) + try: + headers = sfp.info() + blocksize = 8192 + size = -1 + read = 0 + blocknum = 0 + if "content-length" in headers: + size = int(headers["Content-Length"]) + if reporthook: + reporthook(blocknum, blocksize, size) + while True: + block = sfp.read(blocksize) + if not block: + break + read += len(block) + dfp.write(block) + if digester: + digester.update(block) + blocknum += 1 + if reporthook: + reporthook(blocknum, blocksize, size) + finally: + sfp.close() + + # check that we got the whole file, if we can + if size >= 0 and read < size: + raise DistlibException( + 'retrieval incomplete: got only %d out of %d bytes' + % (read, size)) + # if we have a digest, it must match. + if digester: + actual = digester.hexdigest() + if digest != actual: + raise DistlibException('%s digest mismatch for %s: expected ' + '%s, got %s' % (hasher, destfile, + digest, actual)) + logger.debug('Digest verified: %s', digest) + + def send_request(self, req): + """ + Send a standard library :class:`Request` to PyPI and return its + response. + + :param req: The request to send. + :return: The HTTP response from PyPI (a standard library HTTPResponse). + """ + handlers = [] + if self.password_handler: + handlers.append(self.password_handler) + if self.ssl_verifier: + handlers.append(self.ssl_verifier) + opener = build_opener(*handlers) + return opener.open(req) + + def encode_request(self, fields, files): + """ + Encode fields and files for posting to an HTTP server. + + :param fields: The fields to send as a list of (fieldname, value) + tuples. + :param files: The files to send as a list of (fieldname, filename, + file_bytes) tuple. + """ + # Adapted from packaging, which in turn was adapted from + # http://code.activestate.com/recipes/146306 + + parts = [] + boundary = self.boundary + for k, values in fields: + if not isinstance(values, (list, tuple)): + values = [values] + + for v in values: + parts.extend(( + b'--' + boundary, + ('Content-Disposition: form-data; name="%s"' % + k).encode('utf-8'), + b'', + v.encode('utf-8'))) + for key, filename, value in files: + parts.extend(( + b'--' + boundary, + ('Content-Disposition: form-data; name="%s"; filename="%s"' % + (key, filename)).encode('utf-8'), + b'', + value)) + + parts.extend((b'--' + boundary + b'--', b'')) + + body = b'\r\n'.join(parts) + ct = b'multipart/form-data; boundary=' + boundary + headers = { + 'Content-type': ct, + 'Content-length': str(len(body)) + } + return Request(self.url, body, headers) + + def search(self, terms, operator=None): # pragma: no cover + if isinstance(terms, string_types): + terms = {'name': terms} + rpc_proxy = ServerProxy(self.url, timeout=3.0) + try: + return rpc_proxy.search(terms, operator or 'and') + finally: + rpc_proxy('close')() diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/locators.py b/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/locators.py new file mode 100644 index 0000000..f9f0788 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/locators.py @@ -0,0 +1,1303 @@ +# -*- coding: utf-8 -*- +# +# Copyright (C) 2012-2023 Vinay Sajip. +# Licensed to the Python Software Foundation under a contributor agreement. +# See LICENSE.txt and CONTRIBUTORS.txt. +# + +import gzip +from io import BytesIO +import json +import logging +import os +import posixpath +import re +try: + import threading +except ImportError: # pragma: no cover + import dummy_threading as threading +import zlib + +from . import DistlibException +from .compat import (urljoin, urlparse, urlunparse, url2pathname, pathname2url, + queue, quote, unescape, build_opener, + HTTPRedirectHandler as BaseRedirectHandler, text_type, + Request, HTTPError, URLError) +from .database import Distribution, DistributionPath, make_dist +from .metadata import Metadata, MetadataInvalidError +from .util import (cached_property, ensure_slash, split_filename, get_project_data, + parse_requirement, parse_name_and_version, ServerProxy, + normalize_name) +from .version import get_scheme, UnsupportedVersionError +from .wheel import Wheel, is_compatible + +logger = logging.getLogger(__name__) + +HASHER_HASH = re.compile(r'^(\w+)=([a-f0-9]+)') +CHARSET = re.compile(r';\s*charset\s*=\s*(.*)\s*$', re.I) +HTML_CONTENT_TYPE = re.compile('text/html|application/x(ht)?ml') +DEFAULT_INDEX = 'https://pypi.org/pypi' + + +def get_all_distribution_names(url=None): + """ + Return all distribution names known by an index. + :param url: The URL of the index. + :return: A list of all known distribution names. + """ + if url is None: + url = DEFAULT_INDEX + client = ServerProxy(url, timeout=3.0) + try: + return client.list_packages() + finally: + client('close')() + + +class RedirectHandler(BaseRedirectHandler): + """ + A class to work around a bug in some Python 3.2.x releases. + """ + # There's a bug in the base version for some 3.2.x + # (e.g. 3.2.2 on Ubuntu Oneiric). If a Location header + # returns e.g. /abc, it bails because it says the scheme '' + # is bogus, when actually it should use the request's + # URL for the scheme. See Python issue #13696. + def http_error_302(self, req, fp, code, msg, headers): + # Some servers (incorrectly) return multiple Location headers + # (so probably same goes for URI). Use first header. + newurl = None + for key in ('location', 'uri'): + if key in headers: + newurl = headers[key] + break + if newurl is None: # pragma: no cover + return + urlparts = urlparse(newurl) + if urlparts.scheme == '': + newurl = urljoin(req.get_full_url(), newurl) + if hasattr(headers, 'replace_header'): + headers.replace_header(key, newurl) + else: + headers[key] = newurl + return BaseRedirectHandler.http_error_302(self, req, fp, code, msg, + headers) + + http_error_301 = http_error_303 = http_error_307 = http_error_302 + + +class Locator(object): + """ + A base class for locators - things that locate distributions. + """ + source_extensions = ('.tar.gz', '.tar.bz2', '.tar', '.zip', '.tgz', '.tbz') + binary_extensions = ('.egg', '.exe', '.whl') + excluded_extensions = ('.pdf',) + + # A list of tags indicating which wheels you want to match. The default + # value of None matches against the tags compatible with the running + # Python. If you want to match other values, set wheel_tags on a locator + # instance to a list of tuples (pyver, abi, arch) which you want to match. + wheel_tags = None + + downloadable_extensions = source_extensions + ('.whl',) + + def __init__(self, scheme='default'): + """ + Initialise an instance. + :param scheme: Because locators look for most recent versions, they + need to know the version scheme to use. This specifies + the current PEP-recommended scheme - use ``'legacy'`` + if you need to support existing distributions on PyPI. + """ + self._cache = {} + self.scheme = scheme + # Because of bugs in some of the handlers on some of the platforms, + # we use our own opener rather than just using urlopen. + self.opener = build_opener(RedirectHandler()) + # If get_project() is called from locate(), the matcher instance + # is set from the requirement passed to locate(). See issue #18 for + # why this can be useful to know. + self.matcher = None + self.errors = queue.Queue() + + def get_errors(self): + """ + Return any errors which have occurred. + """ + result = [] + while not self.errors.empty(): # pragma: no cover + try: + e = self.errors.get(False) + result.append(e) + except self.errors.Empty: + continue + self.errors.task_done() + return result + + def clear_errors(self): + """ + Clear any errors which may have been logged. + """ + # Just get the errors and throw them away + self.get_errors() + + def clear_cache(self): + self._cache.clear() + + def _get_scheme(self): + return self._scheme + + def _set_scheme(self, value): + self._scheme = value + + scheme = property(_get_scheme, _set_scheme) + + def _get_project(self, name): + """ + For a given project, get a dictionary mapping available versions to Distribution + instances. + + This should be implemented in subclasses. + + If called from a locate() request, self.matcher will be set to a + matcher for the requirement to satisfy, otherwise it will be None. + """ + raise NotImplementedError('Please implement in the subclass') + + def get_distribution_names(self): + """ + Return all the distribution names known to this locator. + """ + raise NotImplementedError('Please implement in the subclass') + + def get_project(self, name): + """ + For a given project, get a dictionary mapping available versions to Distribution + instances. + + This calls _get_project to do all the work, and just implements a caching layer on top. + """ + if self._cache is None: # pragma: no cover + result = self._get_project(name) + elif name in self._cache: + result = self._cache[name] + else: + self.clear_errors() + result = self._get_project(name) + self._cache[name] = result + return result + + def score_url(self, url): + """ + Give an url a score which can be used to choose preferred URLs + for a given project release. + """ + t = urlparse(url) + basename = posixpath.basename(t.path) + compatible = True + is_wheel = basename.endswith('.whl') + is_downloadable = basename.endswith(self.downloadable_extensions) + if is_wheel: + compatible = is_compatible(Wheel(basename), self.wheel_tags) + return (t.scheme == 'https', 'pypi.org' in t.netloc, + is_downloadable, is_wheel, compatible, basename) + + def prefer_url(self, url1, url2): + """ + Choose one of two URLs where both are candidates for distribution + archives for the same version of a distribution (for example, + .tar.gz vs. zip). + + The current implementation favours https:// URLs over http://, archives + from PyPI over those from other locations, wheel compatibility (if a + wheel) and then the archive name. + """ + result = url2 + if url1: + s1 = self.score_url(url1) + s2 = self.score_url(url2) + if s1 > s2: + result = url1 + if result != url2: + logger.debug('Not replacing %r with %r', url1, url2) + else: + logger.debug('Replacing %r with %r', url1, url2) + return result + + def split_filename(self, filename, project_name): + """ + Attempt to split a filename in project name, version and Python version. + """ + return split_filename(filename, project_name) + + def convert_url_to_download_info(self, url, project_name): + """ + See if a URL is a candidate for a download URL for a project (the URL + has typically been scraped from an HTML page). + + If it is, a dictionary is returned with keys "name", "version", + "filename" and "url"; otherwise, None is returned. + """ + def same_project(name1, name2): + return normalize_name(name1) == normalize_name(name2) + + result = None + scheme, netloc, path, params, query, frag = urlparse(url) + if frag.lower().startswith('egg='): # pragma: no cover + logger.debug('%s: version hint in fragment: %r', + project_name, frag) + m = HASHER_HASH.match(frag) + if m: + algo, digest = m.groups() + else: + algo, digest = None, None + origpath = path + if path and path[-1] == '/': # pragma: no cover + path = path[:-1] + if path.endswith('.whl'): + try: + wheel = Wheel(path) + if not is_compatible(wheel, self.wheel_tags): + logger.debug('Wheel not compatible: %s', path) + else: + if project_name is None: + include = True + else: + include = same_project(wheel.name, project_name) + if include: + result = { + 'name': wheel.name, + 'version': wheel.version, + 'filename': wheel.filename, + 'url': urlunparse((scheme, netloc, origpath, + params, query, '')), + 'python-version': ', '.join( + ['.'.join(list(v[2:])) for v in wheel.pyver]), + } + except Exception: # pragma: no cover + logger.warning('invalid path for wheel: %s', path) + elif not path.endswith(self.downloadable_extensions): # pragma: no cover + logger.debug('Not downloadable: %s', path) + else: # downloadable extension + path = filename = posixpath.basename(path) + for ext in self.downloadable_extensions: + if path.endswith(ext): + path = path[:-len(ext)] + t = self.split_filename(path, project_name) + if not t: # pragma: no cover + logger.debug('No match for project/version: %s', path) + else: + name, version, pyver = t + if not project_name or same_project(project_name, name): + result = { + 'name': name, + 'version': version, + 'filename': filename, + 'url': urlunparse((scheme, netloc, origpath, + params, query, '')), + } + if pyver: # pragma: no cover + result['python-version'] = pyver + break + if result and algo: + result['%s_digest' % algo] = digest + return result + + def _get_digest(self, info): + """ + Get a digest from a dictionary by looking at a "digests" dictionary + or keys of the form 'algo_digest'. + + Returns a 2-tuple (algo, digest) if found, else None. Currently + looks only for SHA256, then MD5. + """ + result = None + if 'digests' in info: + digests = info['digests'] + for algo in ('sha256', 'md5'): + if algo in digests: + result = (algo, digests[algo]) + break + if not result: + for algo in ('sha256', 'md5'): + key = '%s_digest' % algo + if key in info: + result = (algo, info[key]) + break + return result + + def _update_version_data(self, result, info): + """ + Update a result dictionary (the final result from _get_project) with a + dictionary for a specific version, which typically holds information + gleaned from a filename or URL for an archive for the distribution. + """ + name = info.pop('name') + version = info.pop('version') + if version in result: + dist = result[version] + md = dist.metadata + else: + dist = make_dist(name, version, scheme=self.scheme) + md = dist.metadata + dist.digest = digest = self._get_digest(info) + url = info['url'] + result['digests'][url] = digest + if md.source_url != info['url']: + md.source_url = self.prefer_url(md.source_url, url) + result['urls'].setdefault(version, set()).add(url) + dist.locator = self + result[version] = dist + + def locate(self, requirement, prereleases=False): + """ + Find the most recent distribution which matches the given + requirement. + + :param requirement: A requirement of the form 'foo (1.0)' or perhaps + 'foo (>= 1.0, < 2.0, != 1.3)' + :param prereleases: If ``True``, allow pre-release versions + to be located. Otherwise, pre-release versions + are not returned. + :return: A :class:`Distribution` instance, or ``None`` if no such + distribution could be located. + """ + result = None + r = parse_requirement(requirement) + if r is None: # pragma: no cover + raise DistlibException('Not a valid requirement: %r' % requirement) + scheme = get_scheme(self.scheme) + self.matcher = matcher = scheme.matcher(r.requirement) + logger.debug('matcher: %s (%s)', matcher, type(matcher).__name__) + versions = self.get_project(r.name) + if len(versions) > 2: # urls and digests keys are present + # sometimes, versions are invalid + slist = [] + vcls = matcher.version_class + for k in versions: + if k in ('urls', 'digests'): + continue + try: + if not matcher.match(k): + pass # logger.debug('%s did not match %r', matcher, k) + else: + if prereleases or not vcls(k).is_prerelease: + slist.append(k) + except Exception: # pragma: no cover + logger.warning('error matching %s with %r', matcher, k) + pass # slist.append(k) + if len(slist) > 1: + slist = sorted(slist, key=scheme.key) + if slist: + logger.debug('sorted list: %s', slist) + version = slist[-1] + result = versions[version] + if result: + if r.extras: + result.extras = r.extras + result.download_urls = versions.get('urls', {}).get(version, set()) + d = {} + sd = versions.get('digests', {}) + for url in result.download_urls: + if url in sd: # pragma: no cover + d[url] = sd[url] + result.digests = d + self.matcher = None + return result + + +class PyPIRPCLocator(Locator): + """ + This locator uses XML-RPC to locate distributions. It therefore + cannot be used with simple mirrors (that only mirror file content). + """ + def __init__(self, url, **kwargs): + """ + Initialise an instance. + + :param url: The URL to use for XML-RPC. + :param kwargs: Passed to the superclass constructor. + """ + super(PyPIRPCLocator, self).__init__(**kwargs) + self.base_url = url + self.client = ServerProxy(url, timeout=3.0) + + def get_distribution_names(self): + """ + Return all the distribution names known to this locator. + """ + return set(self.client.list_packages()) + + def _get_project(self, name): + result = {'urls': {}, 'digests': {}} + versions = self.client.package_releases(name, True) + for v in versions: + urls = self.client.release_urls(name, v) + data = self.client.release_data(name, v) + metadata = Metadata(scheme=self.scheme) + metadata.name = data['name'] + metadata.version = data['version'] + metadata.license = data.get('license') + metadata.keywords = data.get('keywords', []) + metadata.summary = data.get('summary') + dist = Distribution(metadata) + if urls: + info = urls[0] + metadata.source_url = info['url'] + dist.digest = self._get_digest(info) + dist.locator = self + result[v] = dist + for info in urls: + url = info['url'] + digest = self._get_digest(info) + result['urls'].setdefault(v, set()).add(url) + result['digests'][url] = digest + return result + + +class PyPIJSONLocator(Locator): + """ + This locator uses PyPI's JSON interface. It's very limited in functionality + and probably not worth using. + """ + def __init__(self, url, **kwargs): + super(PyPIJSONLocator, self).__init__(**kwargs) + self.base_url = ensure_slash(url) + + def get_distribution_names(self): + """ + Return all the distribution names known to this locator. + """ + raise NotImplementedError('Not available from this locator') + + def _get_project(self, name): + result = {'urls': {}, 'digests': {}} + url = urljoin(self.base_url, '%s/json' % quote(name)) + try: + resp = self.opener.open(url) + data = resp.read().decode() # for now + d = json.loads(data) + md = Metadata(scheme=self.scheme) + data = d['info'] + md.name = data['name'] + md.version = data['version'] + md.license = data.get('license') + md.keywords = data.get('keywords', []) + md.summary = data.get('summary') + dist = Distribution(md) + dist.locator = self + # urls = d['urls'] + result[md.version] = dist + for info in d['urls']: + url = info['url'] + dist.download_urls.add(url) + dist.digests[url] = self._get_digest(info) + result['urls'].setdefault(md.version, set()).add(url) + result['digests'][url] = self._get_digest(info) + # Now get other releases + for version, infos in d['releases'].items(): + if version == md.version: + continue # already done + omd = Metadata(scheme=self.scheme) + omd.name = md.name + omd.version = version + odist = Distribution(omd) + odist.locator = self + result[version] = odist + for info in infos: + url = info['url'] + odist.download_urls.add(url) + odist.digests[url] = self._get_digest(info) + result['urls'].setdefault(version, set()).add(url) + result['digests'][url] = self._get_digest(info) +# for info in urls: +# md.source_url = info['url'] +# dist.digest = self._get_digest(info) +# dist.locator = self +# for info in urls: +# url = info['url'] +# result['urls'].setdefault(md.version, set()).add(url) +# result['digests'][url] = self._get_digest(info) + except Exception as e: + self.errors.put(text_type(e)) + logger.exception('JSON fetch failed: %s', e) + return result + + +class Page(object): + """ + This class represents a scraped HTML page. + """ + # The following slightly hairy-looking regex just looks for the contents of + # an anchor link, which has an attribute "href" either immediately preceded + # or immediately followed by a "rel" attribute. The attribute values can be + # declared with double quotes, single quotes or no quotes - which leads to + # the length of the expression. + _href = re.compile(""" +(rel\\s*=\\s*(?:"(?P[^"]*)"|'(?P[^']*)'|(?P[^>\\s\n]*))\\s+)? +href\\s*=\\s*(?:"(?P[^"]*)"|'(?P[^']*)'|(?P[^>\\s\n]*)) +(\\s+rel\\s*=\\s*(?:"(?P[^"]*)"|'(?P[^']*)'|(?P[^>\\s\n]*)))? +""", re.I | re.S | re.X) + _base = re.compile(r"""]+)""", re.I | re.S) + + def __init__(self, data, url): + """ + Initialise an instance with the Unicode page contents and the URL they + came from. + """ + self.data = data + self.base_url = self.url = url + m = self._base.search(self.data) + if m: + self.base_url = m.group(1) + + _clean_re = re.compile(r'[^a-z0-9$&+,/:;=?@.#%_\\|-]', re.I) + + @cached_property + def links(self): + """ + Return the URLs of all the links on a page together with information + about their "rel" attribute, for determining which ones to treat as + downloads and which ones to queue for further scraping. + """ + def clean(url): + "Tidy up an URL." + scheme, netloc, path, params, query, frag = urlparse(url) + return urlunparse((scheme, netloc, quote(path), + params, query, frag)) + + result = set() + for match in self._href.finditer(self.data): + d = match.groupdict('') + rel = (d['rel1'] or d['rel2'] or d['rel3'] or + d['rel4'] or d['rel5'] or d['rel6']) + url = d['url1'] or d['url2'] or d['url3'] + url = urljoin(self.base_url, url) + url = unescape(url) + url = self._clean_re.sub(lambda m: '%%%2x' % ord(m.group(0)), url) + result.add((url, rel)) + # We sort the result, hoping to bring the most recent versions + # to the front + result = sorted(result, key=lambda t: t[0], reverse=True) + return result + + +class SimpleScrapingLocator(Locator): + """ + A locator which scrapes HTML pages to locate downloads for a distribution. + This runs multiple threads to do the I/O; performance is at least as good + as pip's PackageFinder, which works in an analogous fashion. + """ + + # These are used to deal with various Content-Encoding schemes. + decoders = { + 'deflate': zlib.decompress, + 'gzip': lambda b: gzip.GzipFile(fileobj=BytesIO(b)).read(), + 'none': lambda b: b, + } + + def __init__(self, url, timeout=None, num_workers=10, **kwargs): + """ + Initialise an instance. + :param url: The root URL to use for scraping. + :param timeout: The timeout, in seconds, to be applied to requests. + This defaults to ``None`` (no timeout specified). + :param num_workers: The number of worker threads you want to do I/O, + This defaults to 10. + :param kwargs: Passed to the superclass. + """ + super(SimpleScrapingLocator, self).__init__(**kwargs) + self.base_url = ensure_slash(url) + self.timeout = timeout + self._page_cache = {} + self._seen = set() + self._to_fetch = queue.Queue() + self._bad_hosts = set() + self.skip_externals = False + self.num_workers = num_workers + self._lock = threading.RLock() + # See issue #45: we need to be resilient when the locator is used + # in a thread, e.g. with concurrent.futures. We can't use self._lock + # as it is for coordinating our internal threads - the ones created + # in _prepare_threads. + self._gplock = threading.RLock() + self.platform_check = False # See issue #112 + + def _prepare_threads(self): + """ + Threads are created only when get_project is called, and terminate + before it returns. They are there primarily to parallelise I/O (i.e. + fetching web pages). + """ + self._threads = [] + for i in range(self.num_workers): + t = threading.Thread(target=self._fetch) + t.daemon = True + t.start() + self._threads.append(t) + + def _wait_threads(self): + """ + Tell all the threads to terminate (by sending a sentinel value) and + wait for them to do so. + """ + # Note that you need two loops, since you can't say which + # thread will get each sentinel + for t in self._threads: + self._to_fetch.put(None) # sentinel + for t in self._threads: + t.join() + self._threads = [] + + def _get_project(self, name): + result = {'urls': {}, 'digests': {}} + with self._gplock: + self.result = result + self.project_name = name + url = urljoin(self.base_url, '%s/' % quote(name)) + self._seen.clear() + self._page_cache.clear() + self._prepare_threads() + try: + logger.debug('Queueing %s', url) + self._to_fetch.put(url) + self._to_fetch.join() + finally: + self._wait_threads() + del self.result + return result + + platform_dependent = re.compile(r'\b(linux_(i\d86|x86_64|arm\w+)|' + r'win(32|_amd64)|macosx_?\d+)\b', re.I) + + def _is_platform_dependent(self, url): + """ + Does an URL refer to a platform-specific download? + """ + return self.platform_dependent.search(url) + + def _process_download(self, url): + """ + See if an URL is a suitable download for a project. + + If it is, register information in the result dictionary (for + _get_project) about the specific version it's for. + + Note that the return value isn't actually used other than as a boolean + value. + """ + if self.platform_check and self._is_platform_dependent(url): + info = None + else: + info = self.convert_url_to_download_info(url, self.project_name) + logger.debug('process_download: %s -> %s', url, info) + if info: + with self._lock: # needed because self.result is shared + self._update_version_data(self.result, info) + return info + + def _should_queue(self, link, referrer, rel): + """ + Determine whether a link URL from a referring page and with a + particular "rel" attribute should be queued for scraping. + """ + scheme, netloc, path, _, _, _ = urlparse(link) + if path.endswith(self.source_extensions + self.binary_extensions + + self.excluded_extensions): + result = False + elif self.skip_externals and not link.startswith(self.base_url): + result = False + elif not referrer.startswith(self.base_url): + result = False + elif rel not in ('homepage', 'download'): + result = False + elif scheme not in ('http', 'https', 'ftp'): + result = False + elif self._is_platform_dependent(link): + result = False + else: + host = netloc.split(':', 1)[0] + if host.lower() == 'localhost': + result = False + else: + result = True + logger.debug('should_queue: %s (%s) from %s -> %s', link, rel, + referrer, result) + return result + + def _fetch(self): + """ + Get a URL to fetch from the work queue, get the HTML page, examine its + links for download candidates and candidates for further scraping. + + This is a handy method to run in a thread. + """ + while True: + url = self._to_fetch.get() + try: + if url: + page = self.get_page(url) + if page is None: # e.g. after an error + continue + for link, rel in page.links: + if link not in self._seen: + try: + self._seen.add(link) + if (not self._process_download(link) and + self._should_queue(link, url, rel)): + logger.debug('Queueing %s from %s', link, url) + self._to_fetch.put(link) + except MetadataInvalidError: # e.g. invalid versions + pass + except Exception as e: # pragma: no cover + self.errors.put(text_type(e)) + finally: + # always do this, to avoid hangs :-) + self._to_fetch.task_done() + if not url: + # logger.debug('Sentinel seen, quitting.') + break + + def get_page(self, url): + """ + Get the HTML for an URL, possibly from an in-memory cache. + + XXX TODO Note: this cache is never actually cleared. It's assumed that + the data won't get stale over the lifetime of a locator instance (not + necessarily true for the default_locator). + """ + # http://peak.telecommunity.com/DevCenter/EasyInstall#package-index-api + scheme, netloc, path, _, _, _ = urlparse(url) + if scheme == 'file' and os.path.isdir(url2pathname(path)): + url = urljoin(ensure_slash(url), 'index.html') + + if url in self._page_cache: + result = self._page_cache[url] + logger.debug('Returning %s from cache: %s', url, result) + else: + host = netloc.split(':', 1)[0] + result = None + if host in self._bad_hosts: + logger.debug('Skipping %s due to bad host %s', url, host) + else: + req = Request(url, headers={'Accept-encoding': 'identity'}) + try: + logger.debug('Fetching %s', url) + resp = self.opener.open(req, timeout=self.timeout) + logger.debug('Fetched %s', url) + headers = resp.info() + content_type = headers.get('Content-Type', '') + if HTML_CONTENT_TYPE.match(content_type): + final_url = resp.geturl() + data = resp.read() + encoding = headers.get('Content-Encoding') + if encoding: + decoder = self.decoders[encoding] # fail if not found + data = decoder(data) + encoding = 'utf-8' + m = CHARSET.search(content_type) + if m: + encoding = m.group(1) + try: + data = data.decode(encoding) + except UnicodeError: # pragma: no cover + data = data.decode('latin-1') # fallback + result = Page(data, final_url) + self._page_cache[final_url] = result + except HTTPError as e: + if e.code != 404: + logger.exception('Fetch failed: %s: %s', url, e) + except URLError as e: # pragma: no cover + logger.exception('Fetch failed: %s: %s', url, e) + with self._lock: + self._bad_hosts.add(host) + except Exception as e: # pragma: no cover + logger.exception('Fetch failed: %s: %s', url, e) + finally: + self._page_cache[url] = result # even if None (failure) + return result + + _distname_re = re.compile(']*>([^<]+)<') + + def get_distribution_names(self): + """ + Return all the distribution names known to this locator. + """ + result = set() + page = self.get_page(self.base_url) + if not page: + raise DistlibException('Unable to get %s' % self.base_url) + for match in self._distname_re.finditer(page.data): + result.add(match.group(1)) + return result + + +class DirectoryLocator(Locator): + """ + This class locates distributions in a directory tree. + """ + + def __init__(self, path, **kwargs): + """ + Initialise an instance. + :param path: The root of the directory tree to search. + :param kwargs: Passed to the superclass constructor, + except for: + * recursive - if True (the default), subdirectories are + recursed into. If False, only the top-level directory + is searched, + """ + self.recursive = kwargs.pop('recursive', True) + super(DirectoryLocator, self).__init__(**kwargs) + path = os.path.abspath(path) + if not os.path.isdir(path): # pragma: no cover + raise DistlibException('Not a directory: %r' % path) + self.base_dir = path + + def should_include(self, filename, parent): + """ + Should a filename be considered as a candidate for a distribution + archive? As well as the filename, the directory which contains it + is provided, though not used by the current implementation. + """ + return filename.endswith(self.downloadable_extensions) + + def _get_project(self, name): + result = {'urls': {}, 'digests': {}} + for root, dirs, files in os.walk(self.base_dir): + for fn in files: + if self.should_include(fn, root): + fn = os.path.join(root, fn) + url = urlunparse(('file', '', + pathname2url(os.path.abspath(fn)), + '', '', '')) + info = self.convert_url_to_download_info(url, name) + if info: + self._update_version_data(result, info) + if not self.recursive: + break + return result + + def get_distribution_names(self): + """ + Return all the distribution names known to this locator. + """ + result = set() + for root, dirs, files in os.walk(self.base_dir): + for fn in files: + if self.should_include(fn, root): + fn = os.path.join(root, fn) + url = urlunparse(('file', '', + pathname2url(os.path.abspath(fn)), + '', '', '')) + info = self.convert_url_to_download_info(url, None) + if info: + result.add(info['name']) + if not self.recursive: + break + return result + + +class JSONLocator(Locator): + """ + This locator uses special extended metadata (not available on PyPI) and is + the basis of performant dependency resolution in distlib. Other locators + require archive downloads before dependencies can be determined! As you + might imagine, that can be slow. + """ + def get_distribution_names(self): + """ + Return all the distribution names known to this locator. + """ + raise NotImplementedError('Not available from this locator') + + def _get_project(self, name): + result = {'urls': {}, 'digests': {}} + data = get_project_data(name) + if data: + for info in data.get('files', []): + if info['ptype'] != 'sdist' or info['pyversion'] != 'source': + continue + # We don't store summary in project metadata as it makes + # the data bigger for no benefit during dependency + # resolution + dist = make_dist(data['name'], info['version'], + summary=data.get('summary', + 'Placeholder for summary'), + scheme=self.scheme) + md = dist.metadata + md.source_url = info['url'] + # TODO SHA256 digest + if 'digest' in info and info['digest']: + dist.digest = ('md5', info['digest']) + md.dependencies = info.get('requirements', {}) + dist.exports = info.get('exports', {}) + result[dist.version] = dist + result['urls'].setdefault(dist.version, set()).add(info['url']) + return result + + +class DistPathLocator(Locator): + """ + This locator finds installed distributions in a path. It can be useful for + adding to an :class:`AggregatingLocator`. + """ + def __init__(self, distpath, **kwargs): + """ + Initialise an instance. + + :param distpath: A :class:`DistributionPath` instance to search. + """ + super(DistPathLocator, self).__init__(**kwargs) + assert isinstance(distpath, DistributionPath) + self.distpath = distpath + + def _get_project(self, name): + dist = self.distpath.get_distribution(name) + if dist is None: + result = {'urls': {}, 'digests': {}} + else: + result = { + dist.version: dist, + 'urls': {dist.version: set([dist.source_url])}, + 'digests': {dist.version: set([None])} + } + return result + + +class AggregatingLocator(Locator): + """ + This class allows you to chain and/or merge a list of locators. + """ + def __init__(self, *locators, **kwargs): + """ + Initialise an instance. + + :param locators: The list of locators to search. + :param kwargs: Passed to the superclass constructor, + except for: + * merge - if False (the default), the first successful + search from any of the locators is returned. If True, + the results from all locators are merged (this can be + slow). + """ + self.merge = kwargs.pop('merge', False) + self.locators = locators + super(AggregatingLocator, self).__init__(**kwargs) + + def clear_cache(self): + super(AggregatingLocator, self).clear_cache() + for locator in self.locators: + locator.clear_cache() + + def _set_scheme(self, value): + self._scheme = value + for locator in self.locators: + locator.scheme = value + + scheme = property(Locator.scheme.fget, _set_scheme) + + def _get_project(self, name): + result = {} + for locator in self.locators: + d = locator.get_project(name) + if d: + if self.merge: + files = result.get('urls', {}) + digests = result.get('digests', {}) + # next line could overwrite result['urls'], result['digests'] + result.update(d) + df = result.get('urls') + if files and df: + for k, v in files.items(): + if k in df: + df[k] |= v + else: + df[k] = v + dd = result.get('digests') + if digests and dd: + dd.update(digests) + else: + # See issue #18. If any dists are found and we're looking + # for specific constraints, we only return something if + # a match is found. For example, if a DirectoryLocator + # returns just foo (1.0) while we're looking for + # foo (>= 2.0), we'll pretend there was nothing there so + # that subsequent locators can be queried. Otherwise we + # would just return foo (1.0) which would then lead to a + # failure to find foo (>= 2.0), because other locators + # weren't searched. Note that this only matters when + # merge=False. + if self.matcher is None: + found = True + else: + found = False + for k in d: + if self.matcher.match(k): + found = True + break + if found: + result = d + break + return result + + def get_distribution_names(self): + """ + Return all the distribution names known to this locator. + """ + result = set() + for locator in self.locators: + try: + result |= locator.get_distribution_names() + except NotImplementedError: + pass + return result + + +# We use a legacy scheme simply because most of the dists on PyPI use legacy +# versions which don't conform to PEP 440. +default_locator = AggregatingLocator( + # JSONLocator(), # don't use as PEP 426 is withdrawn + SimpleScrapingLocator('https://pypi.org/simple/', + timeout=3.0), + scheme='legacy') + +locate = default_locator.locate + + +class DependencyFinder(object): + """ + Locate dependencies for distributions. + """ + + def __init__(self, locator=None): + """ + Initialise an instance, using the specified locator + to locate distributions. + """ + self.locator = locator or default_locator + self.scheme = get_scheme(self.locator.scheme) + + def add_distribution(self, dist): + """ + Add a distribution to the finder. This will update internal information + about who provides what. + :param dist: The distribution to add. + """ + logger.debug('adding distribution %s', dist) + name = dist.key + self.dists_by_name[name] = dist + self.dists[(name, dist.version)] = dist + for p in dist.provides: + name, version = parse_name_and_version(p) + logger.debug('Add to provided: %s, %s, %s', name, version, dist) + self.provided.setdefault(name, set()).add((version, dist)) + + def remove_distribution(self, dist): + """ + Remove a distribution from the finder. This will update internal + information about who provides what. + :param dist: The distribution to remove. + """ + logger.debug('removing distribution %s', dist) + name = dist.key + del self.dists_by_name[name] + del self.dists[(name, dist.version)] + for p in dist.provides: + name, version = parse_name_and_version(p) + logger.debug('Remove from provided: %s, %s, %s', name, version, dist) + s = self.provided[name] + s.remove((version, dist)) + if not s: + del self.provided[name] + + def get_matcher(self, reqt): + """ + Get a version matcher for a requirement. + :param reqt: The requirement + :type reqt: str + :return: A version matcher (an instance of + :class:`distlib.version.Matcher`). + """ + try: + matcher = self.scheme.matcher(reqt) + except UnsupportedVersionError: # pragma: no cover + # XXX compat-mode if cannot read the version + name = reqt.split()[0] + matcher = self.scheme.matcher(name) + return matcher + + def find_providers(self, reqt): + """ + Find the distributions which can fulfill a requirement. + + :param reqt: The requirement. + :type reqt: str + :return: A set of distribution which can fulfill the requirement. + """ + matcher = self.get_matcher(reqt) + name = matcher.key # case-insensitive + result = set() + provided = self.provided + if name in provided: + for version, provider in provided[name]: + try: + match = matcher.match(version) + except UnsupportedVersionError: + match = False + + if match: + result.add(provider) + break + return result + + def try_to_replace(self, provider, other, problems): + """ + Attempt to replace one provider with another. This is typically used + when resolving dependencies from multiple sources, e.g. A requires + (B >= 1.0) while C requires (B >= 1.1). + + For successful replacement, ``provider`` must meet all the requirements + which ``other`` fulfills. + + :param provider: The provider we are trying to replace with. + :param other: The provider we're trying to replace. + :param problems: If False is returned, this will contain what + problems prevented replacement. This is currently + a tuple of the literal string 'cantreplace', + ``provider``, ``other`` and the set of requirements + that ``provider`` couldn't fulfill. + :return: True if we can replace ``other`` with ``provider``, else + False. + """ + rlist = self.reqts[other] + unmatched = set() + for s in rlist: + matcher = self.get_matcher(s) + if not matcher.match(provider.version): + unmatched.add(s) + if unmatched: + # can't replace other with provider + problems.add(('cantreplace', provider, other, + frozenset(unmatched))) + result = False + else: + # can replace other with provider + self.remove_distribution(other) + del self.reqts[other] + for s in rlist: + self.reqts.setdefault(provider, set()).add(s) + self.add_distribution(provider) + result = True + return result + + def find(self, requirement, meta_extras=None, prereleases=False): + """ + Find a distribution and all distributions it depends on. + + :param requirement: The requirement specifying the distribution to + find, or a Distribution instance. + :param meta_extras: A list of meta extras such as :test:, :build: and + so on. + :param prereleases: If ``True``, allow pre-release versions to be + returned - otherwise, don't return prereleases + unless they're all that's available. + + Return a set of :class:`Distribution` instances and a set of + problems. + + The distributions returned should be such that they have the + :attr:`required` attribute set to ``True`` if they were + from the ``requirement`` passed to ``find()``, and they have the + :attr:`build_time_dependency` attribute set to ``True`` unless they + are post-installation dependencies of the ``requirement``. + + The problems should be a tuple consisting of the string + ``'unsatisfied'`` and the requirement which couldn't be satisfied + by any distribution known to the locator. + """ + + self.provided = {} + self.dists = {} + self.dists_by_name = {} + self.reqts = {} + + meta_extras = set(meta_extras or []) + if ':*:' in meta_extras: + meta_extras.remove(':*:') + # :meta: and :run: are implicitly included + meta_extras |= set([':test:', ':build:', ':dev:']) + + if isinstance(requirement, Distribution): + dist = odist = requirement + logger.debug('passed %s as requirement', odist) + else: + dist = odist = self.locator.locate(requirement, + prereleases=prereleases) + if dist is None: + raise DistlibException('Unable to locate %r' % requirement) + logger.debug('located %s', odist) + dist.requested = True + problems = set() + todo = set([dist]) + install_dists = set([odist]) + while todo: + dist = todo.pop() + name = dist.key # case-insensitive + if name not in self.dists_by_name: + self.add_distribution(dist) + else: + # import pdb; pdb.set_trace() + other = self.dists_by_name[name] + if other != dist: + self.try_to_replace(dist, other, problems) + + ireqts = dist.run_requires | dist.meta_requires + sreqts = dist.build_requires + ereqts = set() + if meta_extras and dist in install_dists: + for key in ('test', 'build', 'dev'): + e = ':%s:' % key + if e in meta_extras: + ereqts |= getattr(dist, '%s_requires' % key) + all_reqts = ireqts | sreqts | ereqts + for r in all_reqts: + providers = self.find_providers(r) + if not providers: + logger.debug('No providers found for %r', r) + provider = self.locator.locate(r, prereleases=prereleases) + # If no provider is found and we didn't consider + # prereleases, consider them now. + if provider is None and not prereleases: + provider = self.locator.locate(r, prereleases=True) + if provider is None: + logger.debug('Cannot satisfy %r', r) + problems.add(('unsatisfied', r)) + else: + n, v = provider.key, provider.version + if (n, v) not in self.dists: + todo.add(provider) + providers.add(provider) + if r in ireqts and dist in install_dists: + install_dists.add(provider) + logger.debug('Adding %s to install_dists', + provider.name_and_version) + for p in providers: + name = p.key + if name not in self.dists_by_name: + self.reqts.setdefault(p, set()).add(r) + else: + other = self.dists_by_name[name] + if other != p: + # see if other can be replaced by p + self.try_to_replace(p, other, problems) + + dists = set(self.dists.values()) + for dist in dists: + dist.build_time_dependency = dist not in install_dists + if dist.build_time_dependency: + logger.debug('%s is a build-time dependency only.', + dist.name_and_version) + logger.debug('find done for %s', odist) + return dists, problems diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/manifest.py b/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/manifest.py new file mode 100644 index 0000000..420dcf1 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/manifest.py @@ -0,0 +1,384 @@ +# -*- coding: utf-8 -*- +# +# Copyright (C) 2012-2023 Python Software Foundation. +# See LICENSE.txt and CONTRIBUTORS.txt. +# +""" +Class representing the list of files in a distribution. + +Equivalent to distutils.filelist, but fixes some problems. +""" +import fnmatch +import logging +import os +import re +import sys + +from . import DistlibException +from .compat import fsdecode +from .util import convert_path + + +__all__ = ['Manifest'] + +logger = logging.getLogger(__name__) + +# a \ followed by some spaces + EOL +_COLLAPSE_PATTERN = re.compile('\\\\w*\n', re.M) +_COMMENTED_LINE = re.compile('#.*?(?=\n)|\n(?=$)', re.M | re.S) + +# +# Due to the different results returned by fnmatch.translate, we need +# to do slightly different processing for Python 2.7 and 3.2 ... this needed +# to be brought in for Python 3.6 onwards. +# +_PYTHON_VERSION = sys.version_info[:2] + + +class Manifest(object): + """ + A list of files built by exploring the filesystem and filtered by applying various + patterns to what we find there. + """ + + def __init__(self, base=None): + """ + Initialise an instance. + + :param base: The base directory to explore under. + """ + self.base = os.path.abspath(os.path.normpath(base or os.getcwd())) + self.prefix = self.base + os.sep + self.allfiles = None + self.files = set() + + # + # Public API + # + + def findall(self): + """Find all files under the base and set ``allfiles`` to the absolute + pathnames of files found. + """ + from stat import S_ISREG, S_ISDIR, S_ISLNK + + self.allfiles = allfiles = [] + root = self.base + stack = [root] + pop = stack.pop + push = stack.append + + while stack: + root = pop() + names = os.listdir(root) + + for name in names: + fullname = os.path.join(root, name) + + # Avoid excess stat calls -- just one will do, thank you! + stat = os.stat(fullname) + mode = stat.st_mode + if S_ISREG(mode): + allfiles.append(fsdecode(fullname)) + elif S_ISDIR(mode) and not S_ISLNK(mode): + push(fullname) + + def add(self, item): + """ + Add a file to the manifest. + + :param item: The pathname to add. This can be relative to the base. + """ + if not item.startswith(self.prefix): + item = os.path.join(self.base, item) + self.files.add(os.path.normpath(item)) + + def add_many(self, items): + """ + Add a list of files to the manifest. + + :param items: The pathnames to add. These can be relative to the base. + """ + for item in items: + self.add(item) + + def sorted(self, wantdirs=False): + """ + Return sorted files in directory order + """ + + def add_dir(dirs, d): + dirs.add(d) + logger.debug('add_dir added %s', d) + if d != self.base: + parent, _ = os.path.split(d) + assert parent not in ('', '/') + add_dir(dirs, parent) + + result = set(self.files) # make a copy! + if wantdirs: + dirs = set() + for f in result: + add_dir(dirs, os.path.dirname(f)) + result |= dirs + return [os.path.join(*path_tuple) for path_tuple in + sorted(os.path.split(path) for path in result)] + + def clear(self): + """Clear all collected files.""" + self.files = set() + self.allfiles = [] + + def process_directive(self, directive): + """ + Process a directive which either adds some files from ``allfiles`` to + ``files``, or removes some files from ``files``. + + :param directive: The directive to process. This should be in a format + compatible with distutils ``MANIFEST.in`` files: + + http://docs.python.org/distutils/sourcedist.html#commands + """ + # Parse the line: split it up, make sure the right number of words + # is there, and return the relevant words. 'action' is always + # defined: it's the first word of the line. Which of the other + # three are defined depends on the action; it'll be either + # patterns, (dir and patterns), or (dirpattern). + action, patterns, thedir, dirpattern = self._parse_directive(directive) + + # OK, now we know that the action is valid and we have the + # right number of words on the line for that action -- so we + # can proceed with minimal error-checking. + if action == 'include': + for pattern in patterns: + if not self._include_pattern(pattern, anchor=True): + logger.warning('no files found matching %r', pattern) + + elif action == 'exclude': + for pattern in patterns: + self._exclude_pattern(pattern, anchor=True) + + elif action == 'global-include': + for pattern in patterns: + if not self._include_pattern(pattern, anchor=False): + logger.warning('no files found matching %r ' + 'anywhere in distribution', pattern) + + elif action == 'global-exclude': + for pattern in patterns: + self._exclude_pattern(pattern, anchor=False) + + elif action == 'recursive-include': + for pattern in patterns: + if not self._include_pattern(pattern, prefix=thedir): + logger.warning('no files found matching %r ' + 'under directory %r', pattern, thedir) + + elif action == 'recursive-exclude': + for pattern in patterns: + self._exclude_pattern(pattern, prefix=thedir) + + elif action == 'graft': + if not self._include_pattern(None, prefix=dirpattern): + logger.warning('no directories found matching %r', + dirpattern) + + elif action == 'prune': + if not self._exclude_pattern(None, prefix=dirpattern): + logger.warning('no previously-included directories found ' + 'matching %r', dirpattern) + else: # pragma: no cover + # This should never happen, as it should be caught in + # _parse_template_line + raise DistlibException( + 'invalid action %r' % action) + + # + # Private API + # + + def _parse_directive(self, directive): + """ + Validate a directive. + :param directive: The directive to validate. + :return: A tuple of action, patterns, thedir, dir_patterns + """ + words = directive.split() + if len(words) == 1 and words[0] not in ('include', 'exclude', + 'global-include', + 'global-exclude', + 'recursive-include', + 'recursive-exclude', + 'graft', 'prune'): + # no action given, let's use the default 'include' + words.insert(0, 'include') + + action = words[0] + patterns = thedir = dir_pattern = None + + if action in ('include', 'exclude', + 'global-include', 'global-exclude'): + if len(words) < 2: + raise DistlibException( + '%r expects ...' % action) + + patterns = [convert_path(word) for word in words[1:]] + + elif action in ('recursive-include', 'recursive-exclude'): + if len(words) < 3: + raise DistlibException( + '%r expects

...' % action) + + thedir = convert_path(words[1]) + patterns = [convert_path(word) for word in words[2:]] + + elif action in ('graft', 'prune'): + if len(words) != 2: + raise DistlibException( + '%r expects a single ' % action) + + dir_pattern = convert_path(words[1]) + + else: + raise DistlibException('unknown action %r' % action) + + return action, patterns, thedir, dir_pattern + + def _include_pattern(self, pattern, anchor=True, prefix=None, + is_regex=False): + """Select strings (presumably filenames) from 'self.files' that + match 'pattern', a Unix-style wildcard (glob) pattern. + + Patterns are not quite the same as implemented by the 'fnmatch' + module: '*' and '?' match non-special characters, where "special" + is platform-dependent: slash on Unix; colon, slash, and backslash on + DOS/Windows; and colon on Mac OS. + + If 'anchor' is true (the default), then the pattern match is more + stringent: "*.py" will match "foo.py" but not "foo/bar.py". If + 'anchor' is false, both of these will match. + + If 'prefix' is supplied, then only filenames starting with 'prefix' + (itself a pattern) and ending with 'pattern', with anything in between + them, will match. 'anchor' is ignored in this case. + + If 'is_regex' is true, 'anchor' and 'prefix' are ignored, and + 'pattern' is assumed to be either a string containing a regex or a + regex object -- no translation is done, the regex is just compiled + and used as-is. + + Selected strings will be added to self.files. + + Return True if files are found. + """ + # XXX docstring lying about what the special chars are? + found = False + pattern_re = self._translate_pattern(pattern, anchor, prefix, is_regex) + + # delayed loading of allfiles list + if self.allfiles is None: + self.findall() + + for name in self.allfiles: + if pattern_re.search(name): + self.files.add(name) + found = True + return found + + def _exclude_pattern(self, pattern, anchor=True, prefix=None, + is_regex=False): + """Remove strings (presumably filenames) from 'files' that match + 'pattern'. + + Other parameters are the same as for 'include_pattern()', above. + The list 'self.files' is modified in place. Return True if files are + found. + + This API is public to allow e.g. exclusion of SCM subdirs, e.g. when + packaging source distributions + """ + found = False + pattern_re = self._translate_pattern(pattern, anchor, prefix, is_regex) + for f in list(self.files): + if pattern_re.search(f): + self.files.remove(f) + found = True + return found + + def _translate_pattern(self, pattern, anchor=True, prefix=None, + is_regex=False): + """Translate a shell-like wildcard pattern to a compiled regular + expression. + + Return the compiled regex. If 'is_regex' true, + then 'pattern' is directly compiled to a regex (if it's a string) + or just returned as-is (assumes it's a regex object). + """ + if is_regex: + if isinstance(pattern, str): + return re.compile(pattern) + else: + return pattern + + if _PYTHON_VERSION > (3, 2): + # ditch start and end characters + start, _, end = self._glob_to_re('_').partition('_') + + if pattern: + pattern_re = self._glob_to_re(pattern) + if _PYTHON_VERSION > (3, 2): + assert pattern_re.startswith(start) and pattern_re.endswith(end) + else: + pattern_re = '' + + base = re.escape(os.path.join(self.base, '')) + if prefix is not None: + # ditch end of pattern character + if _PYTHON_VERSION <= (3, 2): + empty_pattern = self._glob_to_re('') + prefix_re = self._glob_to_re(prefix)[:-len(empty_pattern)] + else: + prefix_re = self._glob_to_re(prefix) + assert prefix_re.startswith(start) and prefix_re.endswith(end) + prefix_re = prefix_re[len(start): len(prefix_re) - len(end)] + sep = os.sep + if os.sep == '\\': + sep = r'\\' + if _PYTHON_VERSION <= (3, 2): + pattern_re = '^' + base + sep.join((prefix_re, + '.*' + pattern_re)) + else: + pattern_re = pattern_re[len(start): len(pattern_re) - len(end)] + pattern_re = r'%s%s%s%s.*%s%s' % (start, base, prefix_re, sep, + pattern_re, end) + else: # no prefix -- respect anchor flag + if anchor: + if _PYTHON_VERSION <= (3, 2): + pattern_re = '^' + base + pattern_re + else: + pattern_re = r'%s%s%s' % (start, base, pattern_re[len(start):]) + + return re.compile(pattern_re) + + def _glob_to_re(self, pattern): + """Translate a shell-like glob pattern to a regular expression. + + Return a string containing the regex. Differs from + 'fnmatch.translate()' in that '*' does not match "special characters" + (which are platform-specific). + """ + pattern_re = fnmatch.translate(pattern) + + # '?' and '*' in the glob pattern become '.' and '.*' in the RE, which + # IMHO is wrong -- '?' and '*' aren't supposed to match slash in Unix, + # and by extension they shouldn't match such "special characters" under + # any OS. So change all non-escaped dots in the RE to match any + # character except the special characters (currently: just os.sep). + sep = os.sep + if os.sep == '\\': + # we're using a regex to manipulate a regex, so we need + # to escape the backslash twice + sep = r'\\\\' + escaped = r'\1[^%s]' % sep + pattern_re = re.sub(r'((? y, + '!=': lambda x, y: x != y, + '<': lambda x, y: x < y, + '<=': lambda x, y: x == y or x < y, + '>': lambda x, y: x > y, + '>=': lambda x, y: x == y or x > y, + 'and': lambda x, y: x and y, + 'or': lambda x, y: x or y, + 'in': lambda x, y: x in y, + 'not in': lambda x, y: x not in y, + } + + def evaluate(self, expr, context): + """ + Evaluate a marker expression returned by the :func:`parse_requirement` + function in the specified context. + """ + if isinstance(expr, string_types): + if expr[0] in '\'"': + result = expr[1:-1] + else: + if expr not in context: + raise SyntaxError('unknown variable: %s' % expr) + result = context[expr] + else: + assert isinstance(expr, dict) + op = expr['op'] + if op not in self.operations: + raise NotImplementedError('op not implemented: %s' % op) + elhs = expr['lhs'] + erhs = expr['rhs'] + if _is_literal(expr['lhs']) and _is_literal(expr['rhs']): + raise SyntaxError('invalid comparison: %s %s %s' % + (elhs, op, erhs)) + + lhs = self.evaluate(elhs, context) + rhs = self.evaluate(erhs, context) + if ((_is_version_marker(elhs) or _is_version_marker(erhs)) + and op in ('<', '<=', '>', '>=', '===', '==', '!=', '~=')): + lhs = LV(lhs) + rhs = LV(rhs) + elif _is_version_marker(elhs) and op in ('in', 'not in'): + lhs = LV(lhs) + rhs = _get_versions(rhs) + result = self.operations[op](lhs, rhs) + return result + + +_DIGITS = re.compile(r'\d+\.\d+') + + +def default_context(): + + def format_full_version(info): + version = '%s.%s.%s' % (info.major, info.minor, info.micro) + kind = info.releaselevel + if kind != 'final': + version += kind[0] + str(info.serial) + return version + + if hasattr(sys, 'implementation'): + implementation_version = format_full_version( + sys.implementation.version) + implementation_name = sys.implementation.name + else: + implementation_version = '0' + implementation_name = '' + + ppv = platform.python_version() + m = _DIGITS.match(ppv) + pv = m.group(0) + result = { + 'implementation_name': implementation_name, + 'implementation_version': implementation_version, + 'os_name': os.name, + 'platform_machine': platform.machine(), + 'platform_python_implementation': platform.python_implementation(), + 'platform_release': platform.release(), + 'platform_system': platform.system(), + 'platform_version': platform.version(), + 'platform_in_venv': str(in_venv()), + 'python_full_version': ppv, + 'python_version': pv, + 'sys_platform': sys.platform, + } + return result + + +DEFAULT_CONTEXT = default_context() +del default_context + +evaluator = Evaluator() + + +def interpret(marker, execution_context=None): + """ + Interpret a marker and return a result depending on environment. + + :param marker: The marker to interpret. + :type marker: str + :param execution_context: The context used for name lookup. + :type execution_context: mapping + """ + try: + expr, rest = parse_marker(marker) + except Exception as e: + raise SyntaxError('Unable to interpret marker syntax: %s: %s' % + (marker, e)) + if rest and rest[0] != '#': + raise SyntaxError('unexpected trailing data in marker: %s: %s' % + (marker, rest)) + context = dict(DEFAULT_CONTEXT) + if execution_context: + context.update(execution_context) + return evaluator.evaluate(expr, context) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/metadata.py b/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/metadata.py new file mode 100644 index 0000000..7189aee --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/metadata.py @@ -0,0 +1,1068 @@ +# -*- coding: utf-8 -*- +# +# Copyright (C) 2012 The Python Software Foundation. +# See LICENSE.txt and CONTRIBUTORS.txt. +# +"""Implementation of the Metadata for Python packages PEPs. + +Supports all metadata formats (1.0, 1.1, 1.2, 1.3/2.1 and 2.2). +""" +from __future__ import unicode_literals + +import codecs +from email import message_from_file +import json +import logging +import re + + +from . import DistlibException, __version__ +from .compat import StringIO, string_types, text_type +from .markers import interpret +from .util import extract_by_key, get_extras +from .version import get_scheme, PEP440_VERSION_RE + +logger = logging.getLogger(__name__) + + +class MetadataMissingError(DistlibException): + """A required metadata is missing""" + + +class MetadataConflictError(DistlibException): + """Attempt to read or write metadata fields that are conflictual.""" + + +class MetadataUnrecognizedVersionError(DistlibException): + """Unknown metadata version number.""" + + +class MetadataInvalidError(DistlibException): + """A metadata value is invalid""" + +# public API of this module +__all__ = ['Metadata', 'PKG_INFO_ENCODING', 'PKG_INFO_PREFERRED_VERSION'] + +# Encoding used for the PKG-INFO files +PKG_INFO_ENCODING = 'utf-8' + +# preferred version. Hopefully will be changed +# to 1.2 once PEP 345 is supported everywhere +PKG_INFO_PREFERRED_VERSION = '1.1' + +_LINE_PREFIX_1_2 = re.compile('\n \\|') +_LINE_PREFIX_PRE_1_2 = re.compile('\n ') +_241_FIELDS = ('Metadata-Version', 'Name', 'Version', 'Platform', + 'Summary', 'Description', + 'Keywords', 'Home-page', 'Author', 'Author-email', + 'License') + +_314_FIELDS = ('Metadata-Version', 'Name', 'Version', 'Platform', + 'Supported-Platform', 'Summary', 'Description', + 'Keywords', 'Home-page', 'Author', 'Author-email', + 'License', 'Classifier', 'Download-URL', 'Obsoletes', + 'Provides', 'Requires') + +_314_MARKERS = ('Obsoletes', 'Provides', 'Requires', 'Classifier', + 'Download-URL') + +_345_FIELDS = ('Metadata-Version', 'Name', 'Version', 'Platform', + 'Supported-Platform', 'Summary', 'Description', + 'Keywords', 'Home-page', 'Author', 'Author-email', + 'Maintainer', 'Maintainer-email', 'License', + 'Classifier', 'Download-URL', 'Obsoletes-Dist', + 'Project-URL', 'Provides-Dist', 'Requires-Dist', + 'Requires-Python', 'Requires-External') + +_345_MARKERS = ('Provides-Dist', 'Requires-Dist', 'Requires-Python', + 'Obsoletes-Dist', 'Requires-External', 'Maintainer', + 'Maintainer-email', 'Project-URL') + +_426_FIELDS = ('Metadata-Version', 'Name', 'Version', 'Platform', + 'Supported-Platform', 'Summary', 'Description', + 'Keywords', 'Home-page', 'Author', 'Author-email', + 'Maintainer', 'Maintainer-email', 'License', + 'Classifier', 'Download-URL', 'Obsoletes-Dist', + 'Project-URL', 'Provides-Dist', 'Requires-Dist', + 'Requires-Python', 'Requires-External', 'Private-Version', + 'Obsoleted-By', 'Setup-Requires-Dist', 'Extension', + 'Provides-Extra') + +_426_MARKERS = ('Private-Version', 'Provides-Extra', 'Obsoleted-By', + 'Setup-Requires-Dist', 'Extension') + +# See issue #106: Sometimes 'Requires' and 'Provides' occur wrongly in +# the metadata. Include them in the tuple literal below to allow them +# (for now). +# Ditto for Obsoletes - see issue #140. +_566_FIELDS = _426_FIELDS + ('Description-Content-Type', + 'Requires', 'Provides', 'Obsoletes') + +_566_MARKERS = ('Description-Content-Type',) + +_643_MARKERS = ('Dynamic', 'License-File') + +_643_FIELDS = _566_FIELDS + _643_MARKERS + +_ALL_FIELDS = set() +_ALL_FIELDS.update(_241_FIELDS) +_ALL_FIELDS.update(_314_FIELDS) +_ALL_FIELDS.update(_345_FIELDS) +_ALL_FIELDS.update(_426_FIELDS) +_ALL_FIELDS.update(_566_FIELDS) +_ALL_FIELDS.update(_643_FIELDS) + +EXTRA_RE = re.compile(r'''extra\s*==\s*("([^"]+)"|'([^']+)')''') + + +def _version2fieldlist(version): + if version == '1.0': + return _241_FIELDS + elif version == '1.1': + return _314_FIELDS + elif version == '1.2': + return _345_FIELDS + elif version in ('1.3', '2.1'): + # avoid adding field names if already there + return _345_FIELDS + tuple(f for f in _566_FIELDS if f not in _345_FIELDS) + elif version == '2.0': + raise ValueError('Metadata 2.0 is withdrawn and not supported') + # return _426_FIELDS + elif version == '2.2': + return _643_FIELDS + raise MetadataUnrecognizedVersionError(version) + + +def _best_version(fields): + """Detect the best version depending on the fields used.""" + def _has_marker(keys, markers): + return any(marker in keys for marker in markers) + + keys = [key for key, value in fields.items() if value not in ([], 'UNKNOWN', None)] + possible_versions = ['1.0', '1.1', '1.2', '1.3', '2.1', '2.2'] # 2.0 removed + + # first let's try to see if a field is not part of one of the version + for key in keys: + if key not in _241_FIELDS and '1.0' in possible_versions: + possible_versions.remove('1.0') + logger.debug('Removed 1.0 due to %s', key) + if key not in _314_FIELDS and '1.1' in possible_versions: + possible_versions.remove('1.1') + logger.debug('Removed 1.1 due to %s', key) + if key not in _345_FIELDS and '1.2' in possible_versions: + possible_versions.remove('1.2') + logger.debug('Removed 1.2 due to %s', key) + if key not in _566_FIELDS and '1.3' in possible_versions: + possible_versions.remove('1.3') + logger.debug('Removed 1.3 due to %s', key) + if key not in _566_FIELDS and '2.1' in possible_versions: + if key != 'Description': # In 2.1, description allowed after headers + possible_versions.remove('2.1') + logger.debug('Removed 2.1 due to %s', key) + if key not in _643_FIELDS and '2.2' in possible_versions: + possible_versions.remove('2.2') + logger.debug('Removed 2.2 due to %s', key) + # if key not in _426_FIELDS and '2.0' in possible_versions: + # possible_versions.remove('2.0') + # logger.debug('Removed 2.0 due to %s', key) + + # possible_version contains qualified versions + if len(possible_versions) == 1: + return possible_versions[0] # found ! + elif len(possible_versions) == 0: + logger.debug('Out of options - unknown metadata set: %s', fields) + raise MetadataConflictError('Unknown metadata set') + + # let's see if one unique marker is found + is_1_1 = '1.1' in possible_versions and _has_marker(keys, _314_MARKERS) + is_1_2 = '1.2' in possible_versions and _has_marker(keys, _345_MARKERS) + is_2_1 = '2.1' in possible_versions and _has_marker(keys, _566_MARKERS) + # is_2_0 = '2.0' in possible_versions and _has_marker(keys, _426_MARKERS) + is_2_2 = '2.2' in possible_versions and _has_marker(keys, _643_MARKERS) + if int(is_1_1) + int(is_1_2) + int(is_2_1) + int(is_2_2) > 1: + raise MetadataConflictError('You used incompatible 1.1/1.2/2.1/2.2 fields') + + # we have the choice, 1.0, or 1.2, 2.1 or 2.2 + # - 1.0 has a broken Summary field but works with all tools + # - 1.1 is to avoid + # - 1.2 fixes Summary but has little adoption + # - 2.1 adds more features + # - 2.2 is the latest + if not is_1_1 and not is_1_2 and not is_2_1 and not is_2_2: + # we couldn't find any specific marker + if PKG_INFO_PREFERRED_VERSION in possible_versions: + return PKG_INFO_PREFERRED_VERSION + if is_1_1: + return '1.1' + if is_1_2: + return '1.2' + if is_2_1: + return '2.1' + # if is_2_2: + # return '2.2' + + return '2.2' + +# This follows the rules about transforming keys as described in +# https://www.python.org/dev/peps/pep-0566/#id17 +_ATTR2FIELD = { + name.lower().replace("-", "_"): name for name in _ALL_FIELDS +} +_FIELD2ATTR = {field: attr for attr, field in _ATTR2FIELD.items()} + +_PREDICATE_FIELDS = ('Requires-Dist', 'Obsoletes-Dist', 'Provides-Dist') +_VERSIONS_FIELDS = ('Requires-Python',) +_VERSION_FIELDS = ('Version',) +_LISTFIELDS = ('Platform', 'Classifier', 'Obsoletes', + 'Requires', 'Provides', 'Obsoletes-Dist', + 'Provides-Dist', 'Requires-Dist', 'Requires-External', + 'Project-URL', 'Supported-Platform', 'Setup-Requires-Dist', + 'Provides-Extra', 'Extension', 'License-File') +_LISTTUPLEFIELDS = ('Project-URL',) + +_ELEMENTSFIELD = ('Keywords',) + +_UNICODEFIELDS = ('Author', 'Maintainer', 'Summary', 'Description') + +_MISSING = object() + +_FILESAFE = re.compile('[^A-Za-z0-9.]+') + + +def _get_name_and_version(name, version, for_filename=False): + """Return the distribution name with version. + + If for_filename is true, return a filename-escaped form.""" + if for_filename: + # For both name and version any runs of non-alphanumeric or '.' + # characters are replaced with a single '-'. Additionally any + # spaces in the version string become '.' + name = _FILESAFE.sub('-', name) + version = _FILESAFE.sub('-', version.replace(' ', '.')) + return '%s-%s' % (name, version) + + +class LegacyMetadata(object): + """The legacy metadata of a release. + + Supports versions 1.0, 1.1, 1.2, 2.0 and 1.3/2.1 (auto-detected). You can + instantiate the class with one of these arguments (or none): + - *path*, the path to a metadata file + - *fileobj* give a file-like object with metadata as content + - *mapping* is a dict-like object + - *scheme* is a version scheme name + """ + # TODO document the mapping API and UNKNOWN default key + + def __init__(self, path=None, fileobj=None, mapping=None, + scheme='default'): + if [path, fileobj, mapping].count(None) < 2: + raise TypeError('path, fileobj and mapping are exclusive') + self._fields = {} + self.requires_files = [] + self._dependencies = None + self.scheme = scheme + if path is not None: + self.read(path) + elif fileobj is not None: + self.read_file(fileobj) + elif mapping is not None: + self.update(mapping) + self.set_metadata_version() + + def set_metadata_version(self): + self._fields['Metadata-Version'] = _best_version(self._fields) + + def _write_field(self, fileobj, name, value): + fileobj.write('%s: %s\n' % (name, value)) + + def __getitem__(self, name): + return self.get(name) + + def __setitem__(self, name, value): + return self.set(name, value) + + def __delitem__(self, name): + field_name = self._convert_name(name) + try: + del self._fields[field_name] + except KeyError: + raise KeyError(name) + + def __contains__(self, name): + return (name in self._fields or + self._convert_name(name) in self._fields) + + def _convert_name(self, name): + if name in _ALL_FIELDS: + return name + name = name.replace('-', '_').lower() + return _ATTR2FIELD.get(name, name) + + def _default_value(self, name): + if name in _LISTFIELDS or name in _ELEMENTSFIELD: + return [] + return 'UNKNOWN' + + def _remove_line_prefix(self, value): + if self.metadata_version in ('1.0', '1.1'): + return _LINE_PREFIX_PRE_1_2.sub('\n', value) + else: + return _LINE_PREFIX_1_2.sub('\n', value) + + def __getattr__(self, name): + if name in _ATTR2FIELD: + return self[name] + raise AttributeError(name) + + # + # Public API + # + +# dependencies = property(_get_dependencies, _set_dependencies) + + def get_fullname(self, filesafe=False): + """Return the distribution name with version. + + If filesafe is true, return a filename-escaped form.""" + return _get_name_and_version(self['Name'], self['Version'], filesafe) + + def is_field(self, name): + """return True if name is a valid metadata key""" + name = self._convert_name(name) + return name in _ALL_FIELDS + + def is_multi_field(self, name): + name = self._convert_name(name) + return name in _LISTFIELDS + + def read(self, filepath): + """Read the metadata values from a file path.""" + fp = codecs.open(filepath, 'r', encoding='utf-8') + try: + self.read_file(fp) + finally: + fp.close() + + def read_file(self, fileob): + """Read the metadata values from a file object.""" + msg = message_from_file(fileob) + self._fields['Metadata-Version'] = msg['metadata-version'] + + # When reading, get all the fields we can + for field in _ALL_FIELDS: + if field not in msg: + continue + if field in _LISTFIELDS: + # we can have multiple lines + values = msg.get_all(field) + if field in _LISTTUPLEFIELDS and values is not None: + values = [tuple(value.split(',')) for value in values] + self.set(field, values) + else: + # single line + value = msg[field] + if value is not None and value != 'UNKNOWN': + self.set(field, value) + + # PEP 566 specifies that the body be used for the description, if + # available + body = msg.get_payload() + self["Description"] = body if body else self["Description"] + # logger.debug('Attempting to set metadata for %s', self) + # self.set_metadata_version() + + def write(self, filepath, skip_unknown=False): + """Write the metadata fields to filepath.""" + fp = codecs.open(filepath, 'w', encoding='utf-8') + try: + self.write_file(fp, skip_unknown) + finally: + fp.close() + + def write_file(self, fileobject, skip_unknown=False): + """Write the PKG-INFO format data to a file object.""" + self.set_metadata_version() + + for field in _version2fieldlist(self['Metadata-Version']): + values = self.get(field) + if skip_unknown and values in ('UNKNOWN', [], ['UNKNOWN']): + continue + if field in _ELEMENTSFIELD: + self._write_field(fileobject, field, ','.join(values)) + continue + if field not in _LISTFIELDS: + if field == 'Description': + if self.metadata_version in ('1.0', '1.1'): + values = values.replace('\n', '\n ') + else: + values = values.replace('\n', '\n |') + values = [values] + + if field in _LISTTUPLEFIELDS: + values = [','.join(value) for value in values] + + for value in values: + self._write_field(fileobject, field, value) + + def update(self, other=None, **kwargs): + """Set metadata values from the given iterable `other` and kwargs. + + Behavior is like `dict.update`: If `other` has a ``keys`` method, + they are looped over and ``self[key]`` is assigned ``other[key]``. + Else, ``other`` is an iterable of ``(key, value)`` iterables. + + Keys that don't match a metadata field or that have an empty value are + dropped. + """ + def _set(key, value): + if key in _ATTR2FIELD and value: + self.set(self._convert_name(key), value) + + if not other: + # other is None or empty container + pass + elif hasattr(other, 'keys'): + for k in other.keys(): + _set(k, other[k]) + else: + for k, v in other: + _set(k, v) + + if kwargs: + for k, v in kwargs.items(): + _set(k, v) + + def set(self, name, value): + """Control then set a metadata field.""" + name = self._convert_name(name) + + if ((name in _ELEMENTSFIELD or name == 'Platform') and + not isinstance(value, (list, tuple))): + if isinstance(value, string_types): + value = [v.strip() for v in value.split(',')] + else: + value = [] + elif (name in _LISTFIELDS and + not isinstance(value, (list, tuple))): + if isinstance(value, string_types): + value = [value] + else: + value = [] + + if logger.isEnabledFor(logging.WARNING): + project_name = self['Name'] + + scheme = get_scheme(self.scheme) + if name in _PREDICATE_FIELDS and value is not None: + for v in value: + # check that the values are valid + if not scheme.is_valid_matcher(v.split(';')[0]): + logger.warning( + "'%s': '%s' is not valid (field '%s')", + project_name, v, name) + # FIXME this rejects UNKNOWN, is that right? + elif name in _VERSIONS_FIELDS and value is not None: + if not scheme.is_valid_constraint_list(value): + logger.warning("'%s': '%s' is not a valid version (field '%s')", + project_name, value, name) + elif name in _VERSION_FIELDS and value is not None: + if not scheme.is_valid_version(value): + logger.warning("'%s': '%s' is not a valid version (field '%s')", + project_name, value, name) + + if name in _UNICODEFIELDS: + if name == 'Description': + value = self._remove_line_prefix(value) + + self._fields[name] = value + + def get(self, name, default=_MISSING): + """Get a metadata field.""" + name = self._convert_name(name) + if name not in self._fields: + if default is _MISSING: + default = self._default_value(name) + return default + if name in _UNICODEFIELDS: + value = self._fields[name] + return value + elif name in _LISTFIELDS: + value = self._fields[name] + if value is None: + return [] + res = [] + for val in value: + if name not in _LISTTUPLEFIELDS: + res.append(val) + else: + # That's for Project-URL + res.append((val[0], val[1])) + return res + + elif name in _ELEMENTSFIELD: + value = self._fields[name] + if isinstance(value, string_types): + return value.split(',') + return self._fields[name] + + def check(self, strict=False): + """Check if the metadata is compliant. If strict is True then raise if + no Name or Version are provided""" + self.set_metadata_version() + + # XXX should check the versions (if the file was loaded) + missing, warnings = [], [] + + for attr in ('Name', 'Version'): # required by PEP 345 + if attr not in self: + missing.append(attr) + + if strict and missing != []: + msg = 'missing required metadata: %s' % ', '.join(missing) + raise MetadataMissingError(msg) + + for attr in ('Home-page', 'Author'): + if attr not in self: + missing.append(attr) + + # checking metadata 1.2 (XXX needs to check 1.1, 1.0) + if self['Metadata-Version'] != '1.2': + return missing, warnings + + scheme = get_scheme(self.scheme) + + def are_valid_constraints(value): + for v in value: + if not scheme.is_valid_matcher(v.split(';')[0]): + return False + return True + + for fields, controller in ((_PREDICATE_FIELDS, are_valid_constraints), + (_VERSIONS_FIELDS, + scheme.is_valid_constraint_list), + (_VERSION_FIELDS, + scheme.is_valid_version)): + for field in fields: + value = self.get(field, None) + if value is not None and not controller(value): + warnings.append("Wrong value for '%s': %s" % (field, value)) + + return missing, warnings + + def todict(self, skip_missing=False): + """Return fields as a dict. + + Field names will be converted to use the underscore-lowercase style + instead of hyphen-mixed case (i.e. home_page instead of Home-page). + This is as per https://www.python.org/dev/peps/pep-0566/#id17. + """ + self.set_metadata_version() + + fields = _version2fieldlist(self['Metadata-Version']) + + data = {} + + for field_name in fields: + if not skip_missing or field_name in self._fields: + key = _FIELD2ATTR[field_name] + if key != 'project_url': + data[key] = self[field_name] + else: + data[key] = [','.join(u) for u in self[field_name]] + + return data + + def add_requirements(self, requirements): + if self['Metadata-Version'] == '1.1': + # we can't have 1.1 metadata *and* Setuptools requires + for field in ('Obsoletes', 'Requires', 'Provides'): + if field in self: + del self[field] + self['Requires-Dist'] += requirements + + # Mapping API + # TODO could add iter* variants + + def keys(self): + return list(_version2fieldlist(self['Metadata-Version'])) + + def __iter__(self): + for key in self.keys(): + yield key + + def values(self): + return [self[key] for key in self.keys()] + + def items(self): + return [(key, self[key]) for key in self.keys()] + + def __repr__(self): + return '<%s %s %s>' % (self.__class__.__name__, self.name, + self.version) + + +METADATA_FILENAME = 'pydist.json' +WHEEL_METADATA_FILENAME = 'metadata.json' +LEGACY_METADATA_FILENAME = 'METADATA' + + +class Metadata(object): + """ + The metadata of a release. This implementation uses 2.1 + metadata where possible. If not possible, it wraps a LegacyMetadata + instance which handles the key-value metadata format. + """ + + METADATA_VERSION_MATCHER = re.compile(r'^\d+(\.\d+)*$') + + NAME_MATCHER = re.compile('^[0-9A-Z]([0-9A-Z_.-]*[0-9A-Z])?$', re.I) + + FIELDNAME_MATCHER = re.compile('^[A-Z]([0-9A-Z-]*[0-9A-Z])?$', re.I) + + VERSION_MATCHER = PEP440_VERSION_RE + + SUMMARY_MATCHER = re.compile('.{1,2047}') + + METADATA_VERSION = '2.0' + + GENERATOR = 'distlib (%s)' % __version__ + + MANDATORY_KEYS = { + 'name': (), + 'version': (), + 'summary': ('legacy',), + } + + INDEX_KEYS = ('name version license summary description author ' + 'author_email keywords platform home_page classifiers ' + 'download_url') + + DEPENDENCY_KEYS = ('extras run_requires test_requires build_requires ' + 'dev_requires provides meta_requires obsoleted_by ' + 'supports_environments') + + SYNTAX_VALIDATORS = { + 'metadata_version': (METADATA_VERSION_MATCHER, ()), + 'name': (NAME_MATCHER, ('legacy',)), + 'version': (VERSION_MATCHER, ('legacy',)), + 'summary': (SUMMARY_MATCHER, ('legacy',)), + 'dynamic': (FIELDNAME_MATCHER, ('legacy',)), + } + + __slots__ = ('_legacy', '_data', 'scheme') + + def __init__(self, path=None, fileobj=None, mapping=None, + scheme='default'): + if [path, fileobj, mapping].count(None) < 2: + raise TypeError('path, fileobj and mapping are exclusive') + self._legacy = None + self._data = None + self.scheme = scheme + #import pdb; pdb.set_trace() + if mapping is not None: + try: + self._validate_mapping(mapping, scheme) + self._data = mapping + except MetadataUnrecognizedVersionError: + self._legacy = LegacyMetadata(mapping=mapping, scheme=scheme) + self.validate() + else: + data = None + if path: + with open(path, 'rb') as f: + data = f.read() + elif fileobj: + data = fileobj.read() + if data is None: + # Initialised with no args - to be added + self._data = { + 'metadata_version': self.METADATA_VERSION, + 'generator': self.GENERATOR, + } + else: + if not isinstance(data, text_type): + data = data.decode('utf-8') + try: + self._data = json.loads(data) + self._validate_mapping(self._data, scheme) + except ValueError: + # Note: MetadataUnrecognizedVersionError does not + # inherit from ValueError (it's a DistlibException, + # which should not inherit from ValueError). + # The ValueError comes from the json.load - if that + # succeeds and we get a validation error, we want + # that to propagate + self._legacy = LegacyMetadata(fileobj=StringIO(data), + scheme=scheme) + self.validate() + + common_keys = set(('name', 'version', 'license', 'keywords', 'summary')) + + none_list = (None, list) + none_dict = (None, dict) + + mapped_keys = { + 'run_requires': ('Requires-Dist', list), + 'build_requires': ('Setup-Requires-Dist', list), + 'dev_requires': none_list, + 'test_requires': none_list, + 'meta_requires': none_list, + 'extras': ('Provides-Extra', list), + 'modules': none_list, + 'namespaces': none_list, + 'exports': none_dict, + 'commands': none_dict, + 'classifiers': ('Classifier', list), + 'source_url': ('Download-URL', None), + 'metadata_version': ('Metadata-Version', None), + } + + del none_list, none_dict + + def __getattribute__(self, key): + common = object.__getattribute__(self, 'common_keys') + mapped = object.__getattribute__(self, 'mapped_keys') + if key in mapped: + lk, maker = mapped[key] + if self._legacy: + if lk is None: + result = None if maker is None else maker() + else: + result = self._legacy.get(lk) + else: + value = None if maker is None else maker() + if key not in ('commands', 'exports', 'modules', 'namespaces', + 'classifiers'): + result = self._data.get(key, value) + else: + # special cases for PEP 459 + sentinel = object() + result = sentinel + d = self._data.get('extensions') + if d: + if key == 'commands': + result = d.get('python.commands', value) + elif key == 'classifiers': + d = d.get('python.details') + if d: + result = d.get(key, value) + else: + d = d.get('python.exports') + if not d: + d = self._data.get('python.exports') + if d: + result = d.get(key, value) + if result is sentinel: + result = value + elif key not in common: + result = object.__getattribute__(self, key) + elif self._legacy: + result = self._legacy.get(key) + else: + result = self._data.get(key) + return result + + def _validate_value(self, key, value, scheme=None): + if key in self.SYNTAX_VALIDATORS: + pattern, exclusions = self.SYNTAX_VALIDATORS[key] + if (scheme or self.scheme) not in exclusions: + m = pattern.match(value) + if not m: + raise MetadataInvalidError("'%s' is an invalid value for " + "the '%s' property" % (value, + key)) + + def __setattr__(self, key, value): + self._validate_value(key, value) + common = object.__getattribute__(self, 'common_keys') + mapped = object.__getattribute__(self, 'mapped_keys') + if key in mapped: + lk, _ = mapped[key] + if self._legacy: + if lk is None: + raise NotImplementedError + self._legacy[lk] = value + elif key not in ('commands', 'exports', 'modules', 'namespaces', + 'classifiers'): + self._data[key] = value + else: + # special cases for PEP 459 + d = self._data.setdefault('extensions', {}) + if key == 'commands': + d['python.commands'] = value + elif key == 'classifiers': + d = d.setdefault('python.details', {}) + d[key] = value + else: + d = d.setdefault('python.exports', {}) + d[key] = value + elif key not in common: + object.__setattr__(self, key, value) + else: + if key == 'keywords': + if isinstance(value, string_types): + value = value.strip() + if value: + value = value.split() + else: + value = [] + if self._legacy: + self._legacy[key] = value + else: + self._data[key] = value + + @property + def name_and_version(self): + return _get_name_and_version(self.name, self.version, True) + + @property + def provides(self): + if self._legacy: + result = self._legacy['Provides-Dist'] + else: + result = self._data.setdefault('provides', []) + s = '%s (%s)' % (self.name, self.version) + if s not in result: + result.append(s) + return result + + @provides.setter + def provides(self, value): + if self._legacy: + self._legacy['Provides-Dist'] = value + else: + self._data['provides'] = value + + def get_requirements(self, reqts, extras=None, env=None): + """ + Base method to get dependencies, given a set of extras + to satisfy and an optional environment context. + :param reqts: A list of sometimes-wanted dependencies, + perhaps dependent on extras and environment. + :param extras: A list of optional components being requested. + :param env: An optional environment for marker evaluation. + """ + if self._legacy: + result = reqts + else: + result = [] + extras = get_extras(extras or [], self.extras) + for d in reqts: + if 'extra' not in d and 'environment' not in d: + # unconditional + include = True + else: + if 'extra' not in d: + # Not extra-dependent - only environment-dependent + include = True + else: + include = d.get('extra') in extras + if include: + # Not excluded because of extras, check environment + marker = d.get('environment') + if marker: + include = interpret(marker, env) + if include: + result.extend(d['requires']) + for key in ('build', 'dev', 'test'): + e = ':%s:' % key + if e in extras: + extras.remove(e) + # A recursive call, but it should terminate since 'test' + # has been removed from the extras + reqts = self._data.get('%s_requires' % key, []) + result.extend(self.get_requirements(reqts, extras=extras, + env=env)) + return result + + @property + def dictionary(self): + if self._legacy: + return self._from_legacy() + return self._data + + @property + def dependencies(self): + if self._legacy: + raise NotImplementedError + else: + return extract_by_key(self._data, self.DEPENDENCY_KEYS) + + @dependencies.setter + def dependencies(self, value): + if self._legacy: + raise NotImplementedError + else: + self._data.update(value) + + def _validate_mapping(self, mapping, scheme): + if mapping.get('metadata_version') != self.METADATA_VERSION: + raise MetadataUnrecognizedVersionError() + missing = [] + for key, exclusions in self.MANDATORY_KEYS.items(): + if key not in mapping: + if scheme not in exclusions: + missing.append(key) + if missing: + msg = 'Missing metadata items: %s' % ', '.join(missing) + raise MetadataMissingError(msg) + for k, v in mapping.items(): + self._validate_value(k, v, scheme) + + def validate(self): + if self._legacy: + missing, warnings = self._legacy.check(True) + if missing or warnings: + logger.warning('Metadata: missing: %s, warnings: %s', + missing, warnings) + else: + self._validate_mapping(self._data, self.scheme) + + def todict(self): + if self._legacy: + return self._legacy.todict(True) + else: + result = extract_by_key(self._data, self.INDEX_KEYS) + return result + + def _from_legacy(self): + assert self._legacy and not self._data + result = { + 'metadata_version': self.METADATA_VERSION, + 'generator': self.GENERATOR, + } + lmd = self._legacy.todict(True) # skip missing ones + for k in ('name', 'version', 'license', 'summary', 'description', + 'classifier'): + if k in lmd: + if k == 'classifier': + nk = 'classifiers' + else: + nk = k + result[nk] = lmd[k] + kw = lmd.get('Keywords', []) + if kw == ['']: + kw = [] + result['keywords'] = kw + keys = (('requires_dist', 'run_requires'), + ('setup_requires_dist', 'build_requires')) + for ok, nk in keys: + if ok in lmd and lmd[ok]: + result[nk] = [{'requires': lmd[ok]}] + result['provides'] = self.provides + author = {} + maintainer = {} + return result + + LEGACY_MAPPING = { + 'name': 'Name', + 'version': 'Version', + ('extensions', 'python.details', 'license'): 'License', + 'summary': 'Summary', + 'description': 'Description', + ('extensions', 'python.project', 'project_urls', 'Home'): 'Home-page', + ('extensions', 'python.project', 'contacts', 0, 'name'): 'Author', + ('extensions', 'python.project', 'contacts', 0, 'email'): 'Author-email', + 'source_url': 'Download-URL', + ('extensions', 'python.details', 'classifiers'): 'Classifier', + } + + def _to_legacy(self): + def process_entries(entries): + reqts = set() + for e in entries: + extra = e.get('extra') + env = e.get('environment') + rlist = e['requires'] + for r in rlist: + if not env and not extra: + reqts.add(r) + else: + marker = '' + if extra: + marker = 'extra == "%s"' % extra + if env: + if marker: + marker = '(%s) and %s' % (env, marker) + else: + marker = env + reqts.add(';'.join((r, marker))) + return reqts + + assert self._data and not self._legacy + result = LegacyMetadata() + nmd = self._data + # import pdb; pdb.set_trace() + for nk, ok in self.LEGACY_MAPPING.items(): + if not isinstance(nk, tuple): + if nk in nmd: + result[ok] = nmd[nk] + else: + d = nmd + found = True + for k in nk: + try: + d = d[k] + except (KeyError, IndexError): + found = False + break + if found: + result[ok] = d + r1 = process_entries(self.run_requires + self.meta_requires) + r2 = process_entries(self.build_requires + self.dev_requires) + if self.extras: + result['Provides-Extra'] = sorted(self.extras) + result['Requires-Dist'] = sorted(r1) + result['Setup-Requires-Dist'] = sorted(r2) + # TODO: any other fields wanted + return result + + def write(self, path=None, fileobj=None, legacy=False, skip_unknown=True): + if [path, fileobj].count(None) != 1: + raise ValueError('Exactly one of path and fileobj is needed') + self.validate() + if legacy: + if self._legacy: + legacy_md = self._legacy + else: + legacy_md = self._to_legacy() + if path: + legacy_md.write(path, skip_unknown=skip_unknown) + else: + legacy_md.write_file(fileobj, skip_unknown=skip_unknown) + else: + if self._legacy: + d = self._from_legacy() + else: + d = self._data + if fileobj: + json.dump(d, fileobj, ensure_ascii=True, indent=2, + sort_keys=True) + else: + with codecs.open(path, 'w', 'utf-8') as f: + json.dump(d, f, ensure_ascii=True, indent=2, + sort_keys=True) + + def add_requirements(self, requirements): + if self._legacy: + self._legacy.add_requirements(requirements) + else: + run_requires = self._data.setdefault('run_requires', []) + always = None + for entry in run_requires: + if 'environment' not in entry and 'extra' not in entry: + always = entry + break + if always is None: + always = { 'requires': requirements } + run_requires.insert(0, always) + else: + rset = set(always['requires']) | set(requirements) + always['requires'] = sorted(rset) + + def __repr__(self): + name = self.name or '(no name)' + version = self.version or 'no version' + return '<%s %s %s (%s)>' % (self.__class__.__name__, + self.metadata_version, name, version) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/resources.py b/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/resources.py new file mode 100644 index 0000000..fef52aa --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/resources.py @@ -0,0 +1,358 @@ +# -*- coding: utf-8 -*- +# +# Copyright (C) 2013-2017 Vinay Sajip. +# Licensed to the Python Software Foundation under a contributor agreement. +# See LICENSE.txt and CONTRIBUTORS.txt. +# +from __future__ import unicode_literals + +import bisect +import io +import logging +import os +import pkgutil +import sys +import types +import zipimport + +from . import DistlibException +from .util import cached_property, get_cache_base, Cache + +logger = logging.getLogger(__name__) + + +cache = None # created when needed + + +class ResourceCache(Cache): + def __init__(self, base=None): + if base is None: + # Use native string to avoid issues on 2.x: see Python #20140. + base = os.path.join(get_cache_base(), str('resource-cache')) + super(ResourceCache, self).__init__(base) + + def is_stale(self, resource, path): + """ + Is the cache stale for the given resource? + + :param resource: The :class:`Resource` being cached. + :param path: The path of the resource in the cache. + :return: True if the cache is stale. + """ + # Cache invalidation is a hard problem :-) + return True + + def get(self, resource): + """ + Get a resource into the cache, + + :param resource: A :class:`Resource` instance. + :return: The pathname of the resource in the cache. + """ + prefix, path = resource.finder.get_cache_info(resource) + if prefix is None: + result = path + else: + result = os.path.join(self.base, self.prefix_to_dir(prefix), path) + dirname = os.path.dirname(result) + if not os.path.isdir(dirname): + os.makedirs(dirname) + if not os.path.exists(result): + stale = True + else: + stale = self.is_stale(resource, path) + if stale: + # write the bytes of the resource to the cache location + with open(result, 'wb') as f: + f.write(resource.bytes) + return result + + +class ResourceBase(object): + def __init__(self, finder, name): + self.finder = finder + self.name = name + + +class Resource(ResourceBase): + """ + A class representing an in-package resource, such as a data file. This is + not normally instantiated by user code, but rather by a + :class:`ResourceFinder` which manages the resource. + """ + is_container = False # Backwards compatibility + + def as_stream(self): + """ + Get the resource as a stream. + + This is not a property to make it obvious that it returns a new stream + each time. + """ + return self.finder.get_stream(self) + + @cached_property + def file_path(self): + global cache + if cache is None: + cache = ResourceCache() + return cache.get(self) + + @cached_property + def bytes(self): + return self.finder.get_bytes(self) + + @cached_property + def size(self): + return self.finder.get_size(self) + + +class ResourceContainer(ResourceBase): + is_container = True # Backwards compatibility + + @cached_property + def resources(self): + return self.finder.get_resources(self) + + +class ResourceFinder(object): + """ + Resource finder for file system resources. + """ + + if sys.platform.startswith('java'): + skipped_extensions = ('.pyc', '.pyo', '.class') + else: + skipped_extensions = ('.pyc', '.pyo') + + def __init__(self, module): + self.module = module + self.loader = getattr(module, '__loader__', None) + self.base = os.path.dirname(getattr(module, '__file__', '')) + + def _adjust_path(self, path): + return os.path.realpath(path) + + def _make_path(self, resource_name): + # Issue #50: need to preserve type of path on Python 2.x + # like os.path._get_sep + if isinstance(resource_name, bytes): # should only happen on 2.x + sep = b'/' + else: + sep = '/' + parts = resource_name.split(sep) + parts.insert(0, self.base) + result = os.path.join(*parts) + return self._adjust_path(result) + + def _find(self, path): + return os.path.exists(path) + + def get_cache_info(self, resource): + return None, resource.path + + def find(self, resource_name): + path = self._make_path(resource_name) + if not self._find(path): + result = None + else: + if self._is_directory(path): + result = ResourceContainer(self, resource_name) + else: + result = Resource(self, resource_name) + result.path = path + return result + + def get_stream(self, resource): + return open(resource.path, 'rb') + + def get_bytes(self, resource): + with open(resource.path, 'rb') as f: + return f.read() + + def get_size(self, resource): + return os.path.getsize(resource.path) + + def get_resources(self, resource): + def allowed(f): + return (f != '__pycache__' and not + f.endswith(self.skipped_extensions)) + return set([f for f in os.listdir(resource.path) if allowed(f)]) + + def is_container(self, resource): + return self._is_directory(resource.path) + + _is_directory = staticmethod(os.path.isdir) + + def iterator(self, resource_name): + resource = self.find(resource_name) + if resource is not None: + todo = [resource] + while todo: + resource = todo.pop(0) + yield resource + if resource.is_container: + rname = resource.name + for name in resource.resources: + if not rname: + new_name = name + else: + new_name = '/'.join([rname, name]) + child = self.find(new_name) + if child.is_container: + todo.append(child) + else: + yield child + + +class ZipResourceFinder(ResourceFinder): + """ + Resource finder for resources in .zip files. + """ + def __init__(self, module): + super(ZipResourceFinder, self).__init__(module) + archive = self.loader.archive + self.prefix_len = 1 + len(archive) + # PyPy doesn't have a _files attr on zipimporter, and you can't set one + if hasattr(self.loader, '_files'): + self._files = self.loader._files + else: + self._files = zipimport._zip_directory_cache[archive] + self.index = sorted(self._files) + + def _adjust_path(self, path): + return path + + def _find(self, path): + path = path[self.prefix_len:] + if path in self._files: + result = True + else: + if path and path[-1] != os.sep: + path = path + os.sep + i = bisect.bisect(self.index, path) + try: + result = self.index[i].startswith(path) + except IndexError: + result = False + if not result: + logger.debug('_find failed: %r %r', path, self.loader.prefix) + else: + logger.debug('_find worked: %r %r', path, self.loader.prefix) + return result + + def get_cache_info(self, resource): + prefix = self.loader.archive + path = resource.path[1 + len(prefix):] + return prefix, path + + def get_bytes(self, resource): + return self.loader.get_data(resource.path) + + def get_stream(self, resource): + return io.BytesIO(self.get_bytes(resource)) + + def get_size(self, resource): + path = resource.path[self.prefix_len:] + return self._files[path][3] + + def get_resources(self, resource): + path = resource.path[self.prefix_len:] + if path and path[-1] != os.sep: + path += os.sep + plen = len(path) + result = set() + i = bisect.bisect(self.index, path) + while i < len(self.index): + if not self.index[i].startswith(path): + break + s = self.index[i][plen:] + result.add(s.split(os.sep, 1)[0]) # only immediate children + i += 1 + return result + + def _is_directory(self, path): + path = path[self.prefix_len:] + if path and path[-1] != os.sep: + path += os.sep + i = bisect.bisect(self.index, path) + try: + result = self.index[i].startswith(path) + except IndexError: + result = False + return result + + +_finder_registry = { + type(None): ResourceFinder, + zipimport.zipimporter: ZipResourceFinder +} + +try: + # In Python 3.6, _frozen_importlib -> _frozen_importlib_external + try: + import _frozen_importlib_external as _fi + except ImportError: + import _frozen_importlib as _fi + _finder_registry[_fi.SourceFileLoader] = ResourceFinder + _finder_registry[_fi.FileFinder] = ResourceFinder + # See issue #146 + _finder_registry[_fi.SourcelessFileLoader] = ResourceFinder + del _fi +except (ImportError, AttributeError): + pass + + +def register_finder(loader, finder_maker): + _finder_registry[type(loader)] = finder_maker + + +_finder_cache = {} + + +def finder(package): + """ + Return a resource finder for a package. + :param package: The name of the package. + :return: A :class:`ResourceFinder` instance for the package. + """ + if package in _finder_cache: + result = _finder_cache[package] + else: + if package not in sys.modules: + __import__(package) + module = sys.modules[package] + path = getattr(module, '__path__', None) + if path is None: + raise DistlibException('You cannot get a finder for a module, ' + 'only for a package') + loader = getattr(module, '__loader__', None) + finder_maker = _finder_registry.get(type(loader)) + if finder_maker is None: + raise DistlibException('Unable to locate finder for %r' % package) + result = finder_maker(module) + _finder_cache[package] = result + return result + + +_dummy_module = types.ModuleType(str('__dummy__')) + + +def finder_for_path(path): + """ + Return a resource finder for a path, which should represent a container. + + :param path: The path. + :return: A :class:`ResourceFinder` instance for the path. + """ + result = None + # calls any path hooks, gets importer into cache + pkgutil.get_importer(path) + loader = sys.path_importer_cache.get(path) + finder = _finder_registry.get(type(loader)) + if finder: + module = _dummy_module + module.__file__ = os.path.join(path, '') + module.__loader__ = loader + result = finder(module) + return result diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/scripts.py b/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/scripts.py new file mode 100644 index 0000000..e16292b --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/scripts.py @@ -0,0 +1,466 @@ +# -*- coding: utf-8 -*- +# +# Copyright (C) 2013-2023 Vinay Sajip. +# Licensed to the Python Software Foundation under a contributor agreement. +# See LICENSE.txt and CONTRIBUTORS.txt. +# +from io import BytesIO +import logging +import os +import re +import struct +import sys +import time +from zipfile import ZipInfo + +from .compat import sysconfig, detect_encoding, ZipFile +from .resources import finder +from .util import (FileOperator, get_export_entry, convert_path, + get_executable, get_platform, in_venv) + +logger = logging.getLogger(__name__) + +_DEFAULT_MANIFEST = ''' + + + + + + + + + + + + +'''.strip() + +# check if Python is called on the first line with this expression +FIRST_LINE_RE = re.compile(b'^#!.*pythonw?[0-9.]*([ \t].*)?$') +SCRIPT_TEMPLATE = r'''# -*- coding: utf-8 -*- +import re +import sys +from %(module)s import %(import_name)s +if __name__ == '__main__': + sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0]) + sys.exit(%(func)s()) +''' + +# Pre-fetch the contents of all executable wrapper stubs. +# This is to address https://github.com/pypa/pip/issues/12666. +# When updating pip, we rename the old pip in place before installing the +# new version. If we try to fetch a wrapper *after* that rename, the finder +# machinery will be confused as the package is no longer available at the +# location where it was imported from. So we load everything into memory in +# advance. + +# Issue 31: don't hardcode an absolute package name, but +# determine it relative to the current package +distlib_package = __name__.rsplit('.', 1)[0] + +WRAPPERS = { + r.name: r.bytes + for r in finder(distlib_package).iterator("") + if r.name.endswith(".exe") +} + + +def enquote_executable(executable): + if ' ' in executable: + # make sure we quote only the executable in case of env + # for example /usr/bin/env "/dir with spaces/bin/jython" + # instead of "/usr/bin/env /dir with spaces/bin/jython" + # otherwise whole + if executable.startswith('/usr/bin/env '): + env, _executable = executable.split(' ', 1) + if ' ' in _executable and not _executable.startswith('"'): + executable = '%s "%s"' % (env, _executable) + else: + if not executable.startswith('"'): + executable = '"%s"' % executable + return executable + + +# Keep the old name around (for now), as there is at least one project using it! +_enquote_executable = enquote_executable + + +class ScriptMaker(object): + """ + A class to copy or create scripts from source scripts or callable + specifications. + """ + script_template = SCRIPT_TEMPLATE + + executable = None # for shebangs + + def __init__(self, + source_dir, + target_dir, + add_launchers=True, + dry_run=False, + fileop=None): + self.source_dir = source_dir + self.target_dir = target_dir + self.add_launchers = add_launchers + self.force = False + self.clobber = False + # It only makes sense to set mode bits on POSIX. + self.set_mode = (os.name == 'posix') or (os.name == 'java' + and os._name == 'posix') + self.variants = set(('', 'X.Y')) + self._fileop = fileop or FileOperator(dry_run) + + self._is_nt = os.name == 'nt' or (os.name == 'java' + and os._name == 'nt') + self.version_info = sys.version_info + + def _get_alternate_executable(self, executable, options): + if options.get('gui', False) and self._is_nt: # pragma: no cover + dn, fn = os.path.split(executable) + fn = fn.replace('python', 'pythonw') + executable = os.path.join(dn, fn) + return executable + + if sys.platform.startswith('java'): # pragma: no cover + + def _is_shell(self, executable): + """ + Determine if the specified executable is a script + (contains a #! line) + """ + try: + with open(executable) as fp: + return fp.read(2) == '#!' + except (OSError, IOError): + logger.warning('Failed to open %s', executable) + return False + + def _fix_jython_executable(self, executable): + if self._is_shell(executable): + # Workaround for Jython is not needed on Linux systems. + import java + + if java.lang.System.getProperty('os.name') == 'Linux': + return executable + elif executable.lower().endswith('jython.exe'): + # Use wrapper exe for Jython on Windows + return executable + return '/usr/bin/env %s' % executable + + def _build_shebang(self, executable, post_interp): + """ + Build a shebang line. In the simple case (on Windows, or a shebang line + which is not too long or contains spaces) use a simple formulation for + the shebang. Otherwise, use /bin/sh as the executable, with a contrived + shebang which allows the script to run either under Python or sh, using + suitable quoting. Thanks to Harald Nordgren for his input. + + See also: http://www.in-ulm.de/~mascheck/various/shebang/#length + https://hg.mozilla.org/mozilla-central/file/tip/mach + """ + if os.name != 'posix': + simple_shebang = True + else: + # Add 3 for '#!' prefix and newline suffix. + shebang_length = len(executable) + len(post_interp) + 3 + if sys.platform == 'darwin': + max_shebang_length = 512 + else: + max_shebang_length = 127 + simple_shebang = ((b' ' not in executable) + and (shebang_length <= max_shebang_length)) + + if simple_shebang: + result = b'#!' + executable + post_interp + b'\n' + else: + result = b'#!/bin/sh\n' + result += b"'''exec' " + executable + post_interp + b' "$0" "$@"\n' + result += b"' '''" + return result + + def _get_shebang(self, encoding, post_interp=b'', options=None): + enquote = True + if self.executable: + executable = self.executable + enquote = False # assume this will be taken care of + elif not sysconfig.is_python_build(): + executable = get_executable() + elif in_venv(): # pragma: no cover + executable = os.path.join( + sysconfig.get_path('scripts'), + 'python%s' % sysconfig.get_config_var('EXE')) + else: # pragma: no cover + if os.name == 'nt': + # for Python builds from source on Windows, no Python executables with + # a version suffix are created, so we use python.exe + executable = os.path.join( + sysconfig.get_config_var('BINDIR'), + 'python%s' % (sysconfig.get_config_var('EXE'))) + else: + executable = os.path.join( + sysconfig.get_config_var('BINDIR'), + 'python%s%s' % (sysconfig.get_config_var('VERSION'), + sysconfig.get_config_var('EXE'))) + if options: + executable = self._get_alternate_executable(executable, options) + + if sys.platform.startswith('java'): # pragma: no cover + executable = self._fix_jython_executable(executable) + + # Normalise case for Windows - COMMENTED OUT + # executable = os.path.normcase(executable) + # N.B. The normalising operation above has been commented out: See + # issue #124. Although paths in Windows are generally case-insensitive, + # they aren't always. For example, a path containing a ẞ (which is a + # LATIN CAPITAL LETTER SHARP S - U+1E9E) is normcased to ß (which is a + # LATIN SMALL LETTER SHARP S' - U+00DF). The two are not considered by + # Windows as equivalent in path names. + + # If the user didn't specify an executable, it may be necessary to + # cater for executable paths with spaces (not uncommon on Windows) + if enquote: + executable = enquote_executable(executable) + # Issue #51: don't use fsencode, since we later try to + # check that the shebang is decodable using utf-8. + executable = executable.encode('utf-8') + # in case of IronPython, play safe and enable frames support + if (sys.platform == 'cli' and '-X:Frames' not in post_interp + and '-X:FullFrames' not in post_interp): # pragma: no cover + post_interp += b' -X:Frames' + shebang = self._build_shebang(executable, post_interp) + # Python parser starts to read a script using UTF-8 until + # it gets a #coding:xxx cookie. The shebang has to be the + # first line of a file, the #coding:xxx cookie cannot be + # written before. So the shebang has to be decodable from + # UTF-8. + try: + shebang.decode('utf-8') + except UnicodeDecodeError: # pragma: no cover + raise ValueError('The shebang (%r) is not decodable from utf-8' % + shebang) + # If the script is encoded to a custom encoding (use a + # #coding:xxx cookie), the shebang has to be decodable from + # the script encoding too. + if encoding != 'utf-8': + try: + shebang.decode(encoding) + except UnicodeDecodeError: # pragma: no cover + raise ValueError('The shebang (%r) is not decodable ' + 'from the script encoding (%r)' % + (shebang, encoding)) + return shebang + + def _get_script_text(self, entry): + return self.script_template % dict( + module=entry.prefix, + import_name=entry.suffix.split('.')[0], + func=entry.suffix) + + manifest = _DEFAULT_MANIFEST + + def get_manifest(self, exename): + base = os.path.basename(exename) + return self.manifest % base + + def _write_script(self, names, shebang, script_bytes, filenames, ext): + use_launcher = self.add_launchers and self._is_nt + linesep = os.linesep.encode('utf-8') + if not shebang.endswith(linesep): + shebang += linesep + if not use_launcher: + script_bytes = shebang + script_bytes + else: # pragma: no cover + if ext == 'py': + launcher = self._get_launcher('t') + else: + launcher = self._get_launcher('w') + stream = BytesIO() + with ZipFile(stream, 'w') as zf: + source_date_epoch = os.environ.get('SOURCE_DATE_EPOCH') + if source_date_epoch: + date_time = time.gmtime(int(source_date_epoch))[:6] + zinfo = ZipInfo(filename='__main__.py', + date_time=date_time) + zf.writestr(zinfo, script_bytes) + else: + zf.writestr('__main__.py', script_bytes) + zip_data = stream.getvalue() + script_bytes = launcher + shebang + zip_data + for name in names: + outname = os.path.join(self.target_dir, name) + if use_launcher: # pragma: no cover + n, e = os.path.splitext(outname) + if e.startswith('.py'): + outname = n + outname = '%s.exe' % outname + try: + self._fileop.write_binary_file(outname, script_bytes) + except Exception: + # Failed writing an executable - it might be in use. + logger.warning('Failed to write executable - trying to ' + 'use .deleteme logic') + dfname = '%s.deleteme' % outname + if os.path.exists(dfname): + os.remove(dfname) # Not allowed to fail here + os.rename(outname, dfname) # nor here + self._fileop.write_binary_file(outname, script_bytes) + logger.debug('Able to replace executable using ' + '.deleteme logic') + try: + os.remove(dfname) + except Exception: + pass # still in use - ignore error + else: + if self._is_nt and not outname.endswith( + '.' + ext): # pragma: no cover + outname = '%s.%s' % (outname, ext) + if os.path.exists(outname) and not self.clobber: + logger.warning('Skipping existing file %s', outname) + continue + self._fileop.write_binary_file(outname, script_bytes) + if self.set_mode: + self._fileop.set_executable_mode([outname]) + filenames.append(outname) + + variant_separator = '-' + + def get_script_filenames(self, name): + result = set() + if '' in self.variants: + result.add(name) + if 'X' in self.variants: + result.add('%s%s' % (name, self.version_info[0])) + if 'X.Y' in self.variants: + result.add('%s%s%s.%s' % + (name, self.variant_separator, self.version_info[0], + self.version_info[1])) + return result + + def _make_script(self, entry, filenames, options=None): + post_interp = b'' + if options: + args = options.get('interpreter_args', []) + if args: + args = ' %s' % ' '.join(args) + post_interp = args.encode('utf-8') + shebang = self._get_shebang('utf-8', post_interp, options=options) + script = self._get_script_text(entry).encode('utf-8') + scriptnames = self.get_script_filenames(entry.name) + if options and options.get('gui', False): + ext = 'pyw' + else: + ext = 'py' + self._write_script(scriptnames, shebang, script, filenames, ext) + + def _copy_script(self, script, filenames): + adjust = False + script = os.path.join(self.source_dir, convert_path(script)) + outname = os.path.join(self.target_dir, os.path.basename(script)) + if not self.force and not self._fileop.newer(script, outname): + logger.debug('not copying %s (up-to-date)', script) + return + + # Always open the file, but ignore failures in dry-run mode -- + # that way, we'll get accurate feedback if we can read the + # script. + try: + f = open(script, 'rb') + except IOError: # pragma: no cover + if not self.dry_run: + raise + f = None + else: + first_line = f.readline() + if not first_line: # pragma: no cover + logger.warning('%s is an empty file (skipping)', script) + return + + match = FIRST_LINE_RE.match(first_line.replace(b'\r\n', b'\n')) + if match: + adjust = True + post_interp = match.group(1) or b'' + + if not adjust: + if f: + f.close() + self._fileop.copy_file(script, outname) + if self.set_mode: + self._fileop.set_executable_mode([outname]) + filenames.append(outname) + else: + logger.info('copying and adjusting %s -> %s', script, + self.target_dir) + if not self._fileop.dry_run: + encoding, lines = detect_encoding(f.readline) + f.seek(0) + shebang = self._get_shebang(encoding, post_interp) + if b'pythonw' in first_line: # pragma: no cover + ext = 'pyw' + else: + ext = 'py' + n = os.path.basename(outname) + self._write_script([n], shebang, f.read(), filenames, ext) + if f: + f.close() + + @property + def dry_run(self): + return self._fileop.dry_run + + @dry_run.setter + def dry_run(self, value): + self._fileop.dry_run = value + + if os.name == 'nt' or (os.name == 'java' + and os._name == 'nt'): # pragma: no cover + # Executable launcher support. + # Launchers are from https://bitbucket.org/vinay.sajip/simple_launcher/ + + def _get_launcher(self, kind): + if struct.calcsize('P') == 8: # 64-bit + bits = '64' + else: + bits = '32' + platform_suffix = '-arm' if get_platform() == 'win-arm64' else '' + name = '%s%s%s.exe' % (kind, bits, platform_suffix) + if name not in WRAPPERS: + msg = ('Unable to find resource %s in package %s' % + (name, distlib_package)) + raise ValueError(msg) + return WRAPPERS[name] + + # Public API follows + + def make(self, specification, options=None): + """ + Make a script. + + :param specification: The specification, which is either a valid export + entry specification (to make a script from a + callable) or a filename (to make a script by + copying from a source location). + :param options: A dictionary of options controlling script generation. + :return: A list of all absolute pathnames written to. + """ + filenames = [] + entry = get_export_entry(specification) + if entry is None: + self._copy_script(specification, filenames) + else: + self._make_script(entry, filenames, options=options) + return filenames + + def make_multiple(self, specifications, options=None): + """ + Take a list of specifications and make scripts from them, + :param specifications: A list of specifications. + :return: A list of all absolute pathnames written to, + """ + filenames = [] + for specification in specifications: + filenames.extend(self.make(specification, options)) + return filenames diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/t32.exe b/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/t32.exe new file mode 100644 index 0000000000000000000000000000000000000000..52154f0be32cc2bdbf98af131d477900667d0abd GIT binary patch literal 97792 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

XMwe#*Lv$g8jIpIBEV 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 w+IyK^N3WCD*(>mhAj=irKyR>D9b+D<@QBhV6U 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

qx{CqlSNQ_YhQ()VtG-D; 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 z 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 bB!6W7g#4-b3-g!cLzth+PZapSNrC?c%T_@< literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/wheel.py b/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/wheel.py new file mode 100644 index 0000000..4a5a30e --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/wheel.py @@ -0,0 +1,1099 @@ +# -*- coding: utf-8 -*- +# +# Copyright (C) 2013-2023 Vinay Sajip. +# Licensed to the Python Software Foundation under a contributor agreement. +# See LICENSE.txt and CONTRIBUTORS.txt. +# +from __future__ import unicode_literals + +import base64 +import codecs +import datetime +from email import message_from_file +import hashlib +import json +import logging +import os +import posixpath +import re +import shutil +import sys +import tempfile +import zipfile + +from . import __version__, DistlibException +from .compat import sysconfig, ZipFile, fsdecode, text_type, filter +from .database import InstalledDistribution +from .metadata import Metadata, WHEEL_METADATA_FILENAME, LEGACY_METADATA_FILENAME +from .util import (FileOperator, convert_path, CSVReader, CSVWriter, Cache, + cached_property, get_cache_base, read_exports, tempdir, + get_platform) +from .version import NormalizedVersion, UnsupportedVersionError + +logger = logging.getLogger(__name__) + +cache = None # created when needed + +if hasattr(sys, 'pypy_version_info'): # pragma: no cover + IMP_PREFIX = 'pp' +elif sys.platform.startswith('java'): # pragma: no cover + IMP_PREFIX = 'jy' +elif sys.platform == 'cli': # pragma: no cover + IMP_PREFIX = 'ip' +else: + IMP_PREFIX = 'cp' + +VER_SUFFIX = sysconfig.get_config_var('py_version_nodot') +if not VER_SUFFIX: # pragma: no cover + VER_SUFFIX = '%s%s' % sys.version_info[:2] +PYVER = 'py' + VER_SUFFIX +IMPVER = IMP_PREFIX + VER_SUFFIX + +ARCH = get_platform().replace('-', '_').replace('.', '_') + +ABI = sysconfig.get_config_var('SOABI') +if ABI and ABI.startswith('cpython-'): + ABI = ABI.replace('cpython-', 'cp').split('-')[0] +else: + + def _derive_abi(): + parts = ['cp', VER_SUFFIX] + if sysconfig.get_config_var('Py_DEBUG'): + parts.append('d') + if IMP_PREFIX == 'cp': + vi = sys.version_info[:2] + if vi < (3, 8): + wpm = sysconfig.get_config_var('WITH_PYMALLOC') + if wpm is None: + wpm = True + if wpm: + parts.append('m') + if vi < (3, 3): + us = sysconfig.get_config_var('Py_UNICODE_SIZE') + if us == 4 or (us is None and sys.maxunicode == 0x10FFFF): + parts.append('u') + return ''.join(parts) + + ABI = _derive_abi() + del _derive_abi + +FILENAME_RE = re.compile( + r''' +(?P[^-]+) +-(?P\d+[^-]*) +(-(?P\d+[^-]*))? +-(?P\w+\d+(\.\w+\d+)*) +-(?P\w+) +-(?P\w+(\.\w+)*) +\.whl$ +''', re.IGNORECASE | re.VERBOSE) + +NAME_VERSION_RE = re.compile( + r''' +(?P[^-]+) +-(?P\d+[^-]*) +(-(?P\d+[^-]*))?$ +''', re.IGNORECASE | re.VERBOSE) + +SHEBANG_RE = re.compile(br'\s*#![^\r\n]*') +SHEBANG_DETAIL_RE = re.compile(br'^(\s*#!("[^"]+"|\S+))\s+(.*)$') +SHEBANG_PYTHON = b'#!python' +SHEBANG_PYTHONW = b'#!pythonw' + +if os.sep == '/': + to_posix = lambda o: o +else: + to_posix = lambda o: o.replace(os.sep, '/') + +if sys.version_info[0] < 3: + import imp +else: + imp = None + import importlib.machinery + import importlib.util + + +def _get_suffixes(): + if imp: + return [s[0] for s in imp.get_suffixes()] + else: + return importlib.machinery.EXTENSION_SUFFIXES + + +def _load_dynamic(name, path): + # https://docs.python.org/3/library/importlib.html#importing-a-source-file-directly + if imp: + return imp.load_dynamic(name, path) + else: + spec = importlib.util.spec_from_file_location(name, path) + module = importlib.util.module_from_spec(spec) + sys.modules[name] = module + spec.loader.exec_module(module) + return module + + +class Mounter(object): + + def __init__(self): + self.impure_wheels = {} + self.libs = {} + + def add(self, pathname, extensions): + self.impure_wheels[pathname] = extensions + self.libs.update(extensions) + + def remove(self, pathname): + extensions = self.impure_wheels.pop(pathname) + for k, v in extensions: + if k in self.libs: + del self.libs[k] + + def find_module(self, fullname, path=None): + if fullname in self.libs: + result = self + else: + result = None + return result + + def load_module(self, fullname): + if fullname in sys.modules: + result = sys.modules[fullname] + else: + if fullname not in self.libs: + raise ImportError('unable to find extension for %s' % fullname) + result = _load_dynamic(fullname, self.libs[fullname]) + result.__loader__ = self + parts = fullname.rsplit('.', 1) + if len(parts) > 1: + result.__package__ = parts[0] + return result + + +_hook = Mounter() + + +class Wheel(object): + """ + Class to build and install from Wheel files (PEP 427). + """ + + wheel_version = (1, 1) + hash_kind = 'sha256' + + def __init__(self, filename=None, sign=False, verify=False): + """ + Initialise an instance using a (valid) filename. + """ + self.sign = sign + self.should_verify = verify + self.buildver = '' + self.pyver = [PYVER] + self.abi = ['none'] + self.arch = ['any'] + self.dirname = os.getcwd() + if filename is None: + self.name = 'dummy' + self.version = '0.1' + self._filename = self.filename + else: + m = NAME_VERSION_RE.match(filename) + if m: + info = m.groupdict('') + self.name = info['nm'] + # Reinstate the local version separator + self.version = info['vn'].replace('_', '-') + self.buildver = info['bn'] + self._filename = self.filename + else: + dirname, filename = os.path.split(filename) + m = FILENAME_RE.match(filename) + if not m: + raise DistlibException('Invalid name or ' + 'filename: %r' % filename) + if dirname: + self.dirname = os.path.abspath(dirname) + self._filename = filename + info = m.groupdict('') + self.name = info['nm'] + self.version = info['vn'] + self.buildver = info['bn'] + self.pyver = info['py'].split('.') + self.abi = info['bi'].split('.') + self.arch = info['ar'].split('.') + + @property + def filename(self): + """ + Build and return a filename from the various components. + """ + if self.buildver: + buildver = '-' + self.buildver + else: + buildver = '' + pyver = '.'.join(self.pyver) + abi = '.'.join(self.abi) + arch = '.'.join(self.arch) + # replace - with _ as a local version separator + version = self.version.replace('-', '_') + return '%s-%s%s-%s-%s-%s.whl' % (self.name, version, buildver, pyver, + abi, arch) + + @property + def exists(self): + path = os.path.join(self.dirname, self.filename) + return os.path.isfile(path) + + @property + def tags(self): + for pyver in self.pyver: + for abi in self.abi: + for arch in self.arch: + yield pyver, abi, arch + + @cached_property + def metadata(self): + pathname = os.path.join(self.dirname, self.filename) + name_ver = '%s-%s' % (self.name, self.version) + info_dir = '%s.dist-info' % name_ver + wrapper = codecs.getreader('utf-8') + with ZipFile(pathname, 'r') as zf: + self.get_wheel_metadata(zf) + # wv = wheel_metadata['Wheel-Version'].split('.', 1) + # file_version = tuple([int(i) for i in wv]) + # if file_version < (1, 1): + # fns = [WHEEL_METADATA_FILENAME, METADATA_FILENAME, + # LEGACY_METADATA_FILENAME] + # else: + # fns = [WHEEL_METADATA_FILENAME, METADATA_FILENAME] + fns = [WHEEL_METADATA_FILENAME, LEGACY_METADATA_FILENAME] + result = None + for fn in fns: + try: + metadata_filename = posixpath.join(info_dir, fn) + with zf.open(metadata_filename) as bf: + wf = wrapper(bf) + result = Metadata(fileobj=wf) + if result: + break + except KeyError: + pass + if not result: + raise ValueError('Invalid wheel, because metadata is ' + 'missing: looked in %s' % ', '.join(fns)) + return result + + def get_wheel_metadata(self, zf): + name_ver = '%s-%s' % (self.name, self.version) + info_dir = '%s.dist-info' % name_ver + metadata_filename = posixpath.join(info_dir, 'WHEEL') + with zf.open(metadata_filename) as bf: + wf = codecs.getreader('utf-8')(bf) + message = message_from_file(wf) + return dict(message) + + @cached_property + def info(self): + pathname = os.path.join(self.dirname, self.filename) + with ZipFile(pathname, 'r') as zf: + result = self.get_wheel_metadata(zf) + return result + + def process_shebang(self, data): + m = SHEBANG_RE.match(data) + if m: + end = m.end() + shebang, data_after_shebang = data[:end], data[end:] + # Preserve any arguments after the interpreter + if b'pythonw' in shebang.lower(): + shebang_python = SHEBANG_PYTHONW + else: + shebang_python = SHEBANG_PYTHON + m = SHEBANG_DETAIL_RE.match(shebang) + if m: + args = b' ' + m.groups()[-1] + else: + args = b'' + shebang = shebang_python + args + data = shebang + data_after_shebang + else: + cr = data.find(b'\r') + lf = data.find(b'\n') + if cr < 0 or cr > lf: + term = b'\n' + else: + if data[cr:cr + 2] == b'\r\n': + term = b'\r\n' + else: + term = b'\r' + data = SHEBANG_PYTHON + term + data + return data + + def get_hash(self, data, hash_kind=None): + if hash_kind is None: + hash_kind = self.hash_kind + try: + hasher = getattr(hashlib, hash_kind) + except AttributeError: + raise DistlibException('Unsupported hash algorithm: %r' % + hash_kind) + result = hasher(data).digest() + result = base64.urlsafe_b64encode(result).rstrip(b'=').decode('ascii') + return hash_kind, result + + def write_record(self, records, record_path, archive_record_path): + records = list(records) # make a copy, as mutated + records.append((archive_record_path, '', '')) + with CSVWriter(record_path) as writer: + for row in records: + writer.writerow(row) + + def write_records(self, info, libdir, archive_paths): + records = [] + distinfo, info_dir = info + # hasher = getattr(hashlib, self.hash_kind) + for ap, p in archive_paths: + with open(p, 'rb') as f: + data = f.read() + digest = '%s=%s' % self.get_hash(data) + size = os.path.getsize(p) + records.append((ap, digest, size)) + + p = os.path.join(distinfo, 'RECORD') + ap = to_posix(os.path.join(info_dir, 'RECORD')) + self.write_record(records, p, ap) + archive_paths.append((ap, p)) + + def build_zip(self, pathname, archive_paths): + with ZipFile(pathname, 'w', zipfile.ZIP_DEFLATED) as zf: + for ap, p in archive_paths: + logger.debug('Wrote %s to %s in wheel', p, ap) + zf.write(p, ap) + + def build(self, paths, tags=None, wheel_version=None): + """ + Build a wheel from files in specified paths, and use any specified tags + when determining the name of the wheel. + """ + if tags is None: + tags = {} + + libkey = list(filter(lambda o: o in paths, ('purelib', 'platlib')))[0] + if libkey == 'platlib': + is_pure = 'false' + default_pyver = [IMPVER] + default_abi = [ABI] + default_arch = [ARCH] + else: + is_pure = 'true' + default_pyver = [PYVER] + default_abi = ['none'] + default_arch = ['any'] + + self.pyver = tags.get('pyver', default_pyver) + self.abi = tags.get('abi', default_abi) + self.arch = tags.get('arch', default_arch) + + libdir = paths[libkey] + + name_ver = '%s-%s' % (self.name, self.version) + data_dir = '%s.data' % name_ver + info_dir = '%s.dist-info' % name_ver + + archive_paths = [] + + # First, stuff which is not in site-packages + for key in ('data', 'headers', 'scripts'): + if key not in paths: + continue + path = paths[key] + if os.path.isdir(path): + for root, dirs, files in os.walk(path): + for fn in files: + p = fsdecode(os.path.join(root, fn)) + rp = os.path.relpath(p, path) + ap = to_posix(os.path.join(data_dir, key, rp)) + archive_paths.append((ap, p)) + if key == 'scripts' and not p.endswith('.exe'): + with open(p, 'rb') as f: + data = f.read() + data = self.process_shebang(data) + with open(p, 'wb') as f: + f.write(data) + + # Now, stuff which is in site-packages, other than the + # distinfo stuff. + path = libdir + distinfo = None + for root, dirs, files in os.walk(path): + if root == path: + # At the top level only, save distinfo for later + # and skip it for now + for i, dn in enumerate(dirs): + dn = fsdecode(dn) + if dn.endswith('.dist-info'): + distinfo = os.path.join(root, dn) + del dirs[i] + break + assert distinfo, '.dist-info directory expected, not found' + + for fn in files: + # comment out next suite to leave .pyc files in + if fsdecode(fn).endswith(('.pyc', '.pyo')): + continue + p = os.path.join(root, fn) + rp = to_posix(os.path.relpath(p, path)) + archive_paths.append((rp, p)) + + # Now distinfo. Assumed to be flat, i.e. os.listdir is enough. + files = os.listdir(distinfo) + for fn in files: + if fn not in ('RECORD', 'INSTALLER', 'SHARED', 'WHEEL'): + p = fsdecode(os.path.join(distinfo, fn)) + ap = to_posix(os.path.join(info_dir, fn)) + archive_paths.append((ap, p)) + + wheel_metadata = [ + 'Wheel-Version: %d.%d' % (wheel_version or self.wheel_version), + 'Generator: distlib %s' % __version__, + 'Root-Is-Purelib: %s' % is_pure, + ] + for pyver, abi, arch in self.tags: + wheel_metadata.append('Tag: %s-%s-%s' % (pyver, abi, arch)) + p = os.path.join(distinfo, 'WHEEL') + with open(p, 'w') as f: + f.write('\n'.join(wheel_metadata)) + ap = to_posix(os.path.join(info_dir, 'WHEEL')) + archive_paths.append((ap, p)) + + # sort the entries by archive path. Not needed by any spec, but it + # keeps the archive listing and RECORD tidier than they would otherwise + # be. Use the number of path segments to keep directory entries together, + # and keep the dist-info stuff at the end. + def sorter(t): + ap = t[0] + n = ap.count('/') + if '.dist-info' in ap: + n += 10000 + return (n, ap) + + archive_paths = sorted(archive_paths, key=sorter) + + # Now, at last, RECORD. + # Paths in here are archive paths - nothing else makes sense. + self.write_records((distinfo, info_dir), libdir, archive_paths) + # Now, ready to build the zip file + pathname = os.path.join(self.dirname, self.filename) + self.build_zip(pathname, archive_paths) + return pathname + + def skip_entry(self, arcname): + """ + Determine whether an archive entry should be skipped when verifying + or installing. + """ + # The signature file won't be in RECORD, + # and we don't currently don't do anything with it + # We also skip directories, as they won't be in RECORD + # either. See: + # + # https://github.com/pypa/wheel/issues/294 + # https://github.com/pypa/wheel/issues/287 + # https://github.com/pypa/wheel/pull/289 + # + return arcname.endswith(('/', '/RECORD.jws')) + + def install(self, paths, maker, **kwargs): + """ + Install a wheel to the specified paths. If kwarg ``warner`` is + specified, it should be a callable, which will be called with two + tuples indicating the wheel version of this software and the wheel + version in the file, if there is a discrepancy in the versions. + This can be used to issue any warnings to raise any exceptions. + If kwarg ``lib_only`` is True, only the purelib/platlib files are + installed, and the headers, scripts, data and dist-info metadata are + not written. If kwarg ``bytecode_hashed_invalidation`` is True, written + bytecode will try to use file-hash based invalidation (PEP-552) on + supported interpreter versions (CPython 2.7+). + + The return value is a :class:`InstalledDistribution` instance unless + ``options.lib_only`` is True, in which case the return value is ``None``. + """ + + dry_run = maker.dry_run + warner = kwargs.get('warner') + lib_only = kwargs.get('lib_only', False) + bc_hashed_invalidation = kwargs.get('bytecode_hashed_invalidation', + False) + + pathname = os.path.join(self.dirname, self.filename) + name_ver = '%s-%s' % (self.name, self.version) + data_dir = '%s.data' % name_ver + info_dir = '%s.dist-info' % name_ver + + metadata_name = posixpath.join(info_dir, LEGACY_METADATA_FILENAME) + wheel_metadata_name = posixpath.join(info_dir, 'WHEEL') + record_name = posixpath.join(info_dir, 'RECORD') + + wrapper = codecs.getreader('utf-8') + + with ZipFile(pathname, 'r') as zf: + with zf.open(wheel_metadata_name) as bwf: + wf = wrapper(bwf) + message = message_from_file(wf) + wv = message['Wheel-Version'].split('.', 1) + file_version = tuple([int(i) for i in wv]) + if (file_version != self.wheel_version) and warner: + warner(self.wheel_version, file_version) + + if message['Root-Is-Purelib'] == 'true': + libdir = paths['purelib'] + else: + libdir = paths['platlib'] + + records = {} + with zf.open(record_name) as bf: + with CSVReader(stream=bf) as reader: + for row in reader: + p = row[0] + records[p] = row + + data_pfx = posixpath.join(data_dir, '') + info_pfx = posixpath.join(info_dir, '') + script_pfx = posixpath.join(data_dir, 'scripts', '') + + # make a new instance rather than a copy of maker's, + # as we mutate it + fileop = FileOperator(dry_run=dry_run) + fileop.record = True # so we can rollback if needed + + bc = not sys.dont_write_bytecode # Double negatives. Lovely! + + outfiles = [] # for RECORD writing + + # for script copying/shebang processing + workdir = tempfile.mkdtemp() + # set target dir later + # we default add_launchers to False, as the + # Python Launcher should be used instead + maker.source_dir = workdir + maker.target_dir = None + try: + for zinfo in zf.infolist(): + arcname = zinfo.filename + if isinstance(arcname, text_type): + u_arcname = arcname + else: + u_arcname = arcname.decode('utf-8') + if self.skip_entry(u_arcname): + continue + row = records[u_arcname] + if row[2] and str(zinfo.file_size) != row[2]: + raise DistlibException('size mismatch for ' + '%s' % u_arcname) + if row[1]: + kind, value = row[1].split('=', 1) + with zf.open(arcname) as bf: + data = bf.read() + _, digest = self.get_hash(data, kind) + if digest != value: + raise DistlibException('digest mismatch for ' + '%s' % arcname) + + if lib_only and u_arcname.startswith((info_pfx, data_pfx)): + logger.debug('lib_only: skipping %s', u_arcname) + continue + is_script = (u_arcname.startswith(script_pfx) + and not u_arcname.endswith('.exe')) + + if u_arcname.startswith(data_pfx): + _, where, rp = u_arcname.split('/', 2) + outfile = os.path.join(paths[where], convert_path(rp)) + else: + # meant for site-packages. + if u_arcname in (wheel_metadata_name, record_name): + continue + outfile = os.path.join(libdir, convert_path(u_arcname)) + if not is_script: + with zf.open(arcname) as bf: + fileop.copy_stream(bf, outfile) + # Issue #147: permission bits aren't preserved. Using + # zf.extract(zinfo, libdir) should have worked, but didn't, + # see https://www.thetopsites.net/article/53834422.shtml + # So ... manually preserve permission bits as given in zinfo + if os.name == 'posix': + # just set the normal permission bits + os.chmod(outfile, + (zinfo.external_attr >> 16) & 0x1FF) + outfiles.append(outfile) + # Double check the digest of the written file + if not dry_run and row[1]: + with open(outfile, 'rb') as bf: + data = bf.read() + _, newdigest = self.get_hash(data, kind) + if newdigest != digest: + raise DistlibException('digest mismatch ' + 'on write for ' + '%s' % outfile) + if bc and outfile.endswith('.py'): + try: + pyc = fileop.byte_compile( + outfile, + hashed_invalidation=bc_hashed_invalidation) + outfiles.append(pyc) + except Exception: + # Don't give up if byte-compilation fails, + # but log it and perhaps warn the user + logger.warning('Byte-compilation failed', + exc_info=True) + else: + fn = os.path.basename(convert_path(arcname)) + workname = os.path.join(workdir, fn) + with zf.open(arcname) as bf: + fileop.copy_stream(bf, workname) + + dn, fn = os.path.split(outfile) + maker.target_dir = dn + filenames = maker.make(fn) + fileop.set_executable_mode(filenames) + outfiles.extend(filenames) + + if lib_only: + logger.debug('lib_only: returning None') + dist = None + else: + # Generate scripts + + # Try to get pydist.json so we can see if there are + # any commands to generate. If this fails (e.g. because + # of a legacy wheel), log a warning but don't give up. + commands = None + file_version = self.info['Wheel-Version'] + if file_version == '1.0': + # Use legacy info + ep = posixpath.join(info_dir, 'entry_points.txt') + try: + with zf.open(ep) as bwf: + epdata = read_exports(bwf) + commands = {} + for key in ('console', 'gui'): + k = '%s_scripts' % key + if k in epdata: + commands['wrap_%s' % key] = d = {} + for v in epdata[k].values(): + s = '%s:%s' % (v.prefix, v.suffix) + if v.flags: + s += ' [%s]' % ','.join(v.flags) + d[v.name] = s + except Exception: + logger.warning('Unable to read legacy script ' + 'metadata, so cannot generate ' + 'scripts') + else: + try: + with zf.open(metadata_name) as bwf: + wf = wrapper(bwf) + commands = json.load(wf).get('extensions') + if commands: + commands = commands.get('python.commands') + except Exception: + logger.warning('Unable to read JSON metadata, so ' + 'cannot generate scripts') + if commands: + console_scripts = commands.get('wrap_console', {}) + gui_scripts = commands.get('wrap_gui', {}) + if console_scripts or gui_scripts: + script_dir = paths.get('scripts', '') + if not os.path.isdir(script_dir): + raise ValueError('Valid script path not ' + 'specified') + maker.target_dir = script_dir + for k, v in console_scripts.items(): + script = '%s = %s' % (k, v) + filenames = maker.make(script) + fileop.set_executable_mode(filenames) + + if gui_scripts: + options = {'gui': True} + for k, v in gui_scripts.items(): + script = '%s = %s' % (k, v) + filenames = maker.make(script, options) + fileop.set_executable_mode(filenames) + + p = os.path.join(libdir, info_dir) + dist = InstalledDistribution(p) + + # Write SHARED + paths = dict(paths) # don't change passed in dict + del paths['purelib'] + del paths['platlib'] + paths['lib'] = libdir + p = dist.write_shared_locations(paths, dry_run) + if p: + outfiles.append(p) + + # Write RECORD + dist.write_installed_files(outfiles, paths['prefix'], + dry_run) + return dist + except Exception: # pragma: no cover + logger.exception('installation failed.') + fileop.rollback() + raise + finally: + shutil.rmtree(workdir) + + def _get_dylib_cache(self): + global cache + if cache is None: + # Use native string to avoid issues on 2.x: see Python #20140. + base = os.path.join(get_cache_base(), str('dylib-cache'), + '%s.%s' % sys.version_info[:2]) + cache = Cache(base) + return cache + + def _get_extensions(self): + pathname = os.path.join(self.dirname, self.filename) + name_ver = '%s-%s' % (self.name, self.version) + info_dir = '%s.dist-info' % name_ver + arcname = posixpath.join(info_dir, 'EXTENSIONS') + wrapper = codecs.getreader('utf-8') + result = [] + with ZipFile(pathname, 'r') as zf: + try: + with zf.open(arcname) as bf: + wf = wrapper(bf) + extensions = json.load(wf) + cache = self._get_dylib_cache() + prefix = cache.prefix_to_dir(pathname) + cache_base = os.path.join(cache.base, prefix) + if not os.path.isdir(cache_base): + os.makedirs(cache_base) + for name, relpath in extensions.items(): + dest = os.path.join(cache_base, convert_path(relpath)) + if not os.path.exists(dest): + extract = True + else: + file_time = os.stat(dest).st_mtime + file_time = datetime.datetime.fromtimestamp( + file_time) + info = zf.getinfo(relpath) + wheel_time = datetime.datetime(*info.date_time) + extract = wheel_time > file_time + if extract: + zf.extract(relpath, cache_base) + result.append((name, dest)) + except KeyError: + pass + return result + + def is_compatible(self): + """ + Determine if a wheel is compatible with the running system. + """ + return is_compatible(self) + + def is_mountable(self): + """ + Determine if a wheel is asserted as mountable by its metadata. + """ + return True # for now - metadata details TBD + + def mount(self, append=False): + pathname = os.path.abspath(os.path.join(self.dirname, self.filename)) + if not self.is_compatible(): + msg = 'Wheel %s not compatible with this Python.' % pathname + raise DistlibException(msg) + if not self.is_mountable(): + msg = 'Wheel %s is marked as not mountable.' % pathname + raise DistlibException(msg) + if pathname in sys.path: + logger.debug('%s already in path', pathname) + else: + if append: + sys.path.append(pathname) + else: + sys.path.insert(0, pathname) + extensions = self._get_extensions() + if extensions: + if _hook not in sys.meta_path: + sys.meta_path.append(_hook) + _hook.add(pathname, extensions) + + def unmount(self): + pathname = os.path.abspath(os.path.join(self.dirname, self.filename)) + if pathname not in sys.path: + logger.debug('%s not in path', pathname) + else: + sys.path.remove(pathname) + if pathname in _hook.impure_wheels: + _hook.remove(pathname) + if not _hook.impure_wheels: + if _hook in sys.meta_path: + sys.meta_path.remove(_hook) + + def verify(self): + pathname = os.path.join(self.dirname, self.filename) + name_ver = '%s-%s' % (self.name, self.version) + # data_dir = '%s.data' % name_ver + info_dir = '%s.dist-info' % name_ver + + # metadata_name = posixpath.join(info_dir, LEGACY_METADATA_FILENAME) + wheel_metadata_name = posixpath.join(info_dir, 'WHEEL') + record_name = posixpath.join(info_dir, 'RECORD') + + wrapper = codecs.getreader('utf-8') + + with ZipFile(pathname, 'r') as zf: + with zf.open(wheel_metadata_name) as bwf: + wf = wrapper(bwf) + message_from_file(wf) + # wv = message['Wheel-Version'].split('.', 1) + # file_version = tuple([int(i) for i in wv]) + # TODO version verification + + records = {} + with zf.open(record_name) as bf: + with CSVReader(stream=bf) as reader: + for row in reader: + p = row[0] + records[p] = row + + for zinfo in zf.infolist(): + arcname = zinfo.filename + if isinstance(arcname, text_type): + u_arcname = arcname + else: + u_arcname = arcname.decode('utf-8') + # See issue #115: some wheels have .. in their entries, but + # in the filename ... e.g. __main__..py ! So the check is + # updated to look for .. in the directory portions + p = u_arcname.split('/') + if '..' in p: + raise DistlibException('invalid entry in ' + 'wheel: %r' % u_arcname) + + if self.skip_entry(u_arcname): + continue + row = records[u_arcname] + if row[2] and str(zinfo.file_size) != row[2]: + raise DistlibException('size mismatch for ' + '%s' % u_arcname) + if row[1]: + kind, value = row[1].split('=', 1) + with zf.open(arcname) as bf: + data = bf.read() + _, digest = self.get_hash(data, kind) + if digest != value: + raise DistlibException('digest mismatch for ' + '%s' % arcname) + + def update(self, modifier, dest_dir=None, **kwargs): + """ + Update the contents of a wheel in a generic way. The modifier should + be a callable which expects a dictionary argument: its keys are + archive-entry paths, and its values are absolute filesystem paths + where the contents the corresponding archive entries can be found. The + modifier is free to change the contents of the files pointed to, add + new entries and remove entries, before returning. This method will + extract the entire contents of the wheel to a temporary location, call + the modifier, and then use the passed (and possibly updated) + dictionary to write a new wheel. If ``dest_dir`` is specified, the new + wheel is written there -- otherwise, the original wheel is overwritten. + + The modifier should return True if it updated the wheel, else False. + This method returns the same value the modifier returns. + """ + + def get_version(path_map, info_dir): + version = path = None + key = '%s/%s' % (info_dir, LEGACY_METADATA_FILENAME) + if key not in path_map: + key = '%s/PKG-INFO' % info_dir + if key in path_map: + path = path_map[key] + version = Metadata(path=path).version + return version, path + + def update_version(version, path): + updated = None + try: + NormalizedVersion(version) + i = version.find('-') + if i < 0: + updated = '%s+1' % version + else: + parts = [int(s) for s in version[i + 1:].split('.')] + parts[-1] += 1 + updated = '%s+%s' % (version[:i], '.'.join( + str(i) for i in parts)) + except UnsupportedVersionError: + logger.debug( + 'Cannot update non-compliant (PEP-440) ' + 'version %r', version) + if updated: + md = Metadata(path=path) + md.version = updated + legacy = path.endswith(LEGACY_METADATA_FILENAME) + md.write(path=path, legacy=legacy) + logger.debug('Version updated from %r to %r', version, updated) + + pathname = os.path.join(self.dirname, self.filename) + name_ver = '%s-%s' % (self.name, self.version) + info_dir = '%s.dist-info' % name_ver + record_name = posixpath.join(info_dir, 'RECORD') + with tempdir() as workdir: + with ZipFile(pathname, 'r') as zf: + path_map = {} + for zinfo in zf.infolist(): + arcname = zinfo.filename + if isinstance(arcname, text_type): + u_arcname = arcname + else: + u_arcname = arcname.decode('utf-8') + if u_arcname == record_name: + continue + if '..' in u_arcname: + raise DistlibException('invalid entry in ' + 'wheel: %r' % u_arcname) + zf.extract(zinfo, workdir) + path = os.path.join(workdir, convert_path(u_arcname)) + path_map[u_arcname] = path + + # Remember the version. + original_version, _ = get_version(path_map, info_dir) + # Files extracted. Call the modifier. + modified = modifier(path_map, **kwargs) + if modified: + # Something changed - need to build a new wheel. + current_version, path = get_version(path_map, info_dir) + if current_version and (current_version == original_version): + # Add or update local version to signify changes. + update_version(current_version, path) + # Decide where the new wheel goes. + if dest_dir is None: + fd, newpath = tempfile.mkstemp(suffix='.whl', + prefix='wheel-update-', + dir=workdir) + os.close(fd) + else: + if not os.path.isdir(dest_dir): + raise DistlibException('Not a directory: %r' % + dest_dir) + newpath = os.path.join(dest_dir, self.filename) + archive_paths = list(path_map.items()) + distinfo = os.path.join(workdir, info_dir) + info = distinfo, info_dir + self.write_records(info, workdir, archive_paths) + self.build_zip(newpath, archive_paths) + if dest_dir is None: + shutil.copyfile(newpath, pathname) + return modified + + +def _get_glibc_version(): + import platform + ver = platform.libc_ver() + result = [] + if ver[0] == 'glibc': + for s in ver[1].split('.'): + result.append(int(s) if s.isdigit() else 0) + result = tuple(result) + return result + + +def compatible_tags(): + """ + Return (pyver, abi, arch) tuples compatible with this Python. + """ + versions = [VER_SUFFIX] + major = VER_SUFFIX[0] + for minor in range(sys.version_info[1] - 1, -1, -1): + versions.append(''.join([major, str(minor)])) + + abis = [] + for suffix in _get_suffixes(): + if suffix.startswith('.abi'): + abis.append(suffix.split('.', 2)[1]) + abis.sort() + if ABI != 'none': + abis.insert(0, ABI) + abis.append('none') + result = [] + + arches = [ARCH] + if sys.platform == 'darwin': + m = re.match(r'(\w+)_(\d+)_(\d+)_(\w+)$', ARCH) + if m: + name, major, minor, arch = m.groups() + minor = int(minor) + matches = [arch] + if arch in ('i386', 'ppc'): + matches.append('fat') + if arch in ('i386', 'ppc', 'x86_64'): + matches.append('fat3') + if arch in ('ppc64', 'x86_64'): + matches.append('fat64') + if arch in ('i386', 'x86_64'): + matches.append('intel') + if arch in ('i386', 'x86_64', 'intel', 'ppc', 'ppc64'): + matches.append('universal') + while minor >= 0: + for match in matches: + s = '%s_%s_%s_%s' % (name, major, minor, match) + if s != ARCH: # already there + arches.append(s) + minor -= 1 + + # Most specific - our Python version, ABI and arch + for abi in abis: + for arch in arches: + result.append((''.join((IMP_PREFIX, versions[0])), abi, arch)) + # manylinux + if abi != 'none' and sys.platform.startswith('linux'): + arch = arch.replace('linux_', '') + parts = _get_glibc_version() + if len(parts) == 2: + if parts >= (2, 5): + result.append((''.join((IMP_PREFIX, versions[0])), abi, + 'manylinux1_%s' % arch)) + if parts >= (2, 12): + result.append((''.join((IMP_PREFIX, versions[0])), abi, + 'manylinux2010_%s' % arch)) + if parts >= (2, 17): + result.append((''.join((IMP_PREFIX, versions[0])), abi, + 'manylinux2014_%s' % arch)) + result.append( + (''.join((IMP_PREFIX, versions[0])), abi, + 'manylinux_%s_%s_%s' % (parts[0], parts[1], arch))) + + # where no ABI / arch dependency, but IMP_PREFIX dependency + for i, version in enumerate(versions): + result.append((''.join((IMP_PREFIX, version)), 'none', 'any')) + if i == 0: + result.append((''.join((IMP_PREFIX, version[0])), 'none', 'any')) + + # no IMP_PREFIX, ABI or arch dependency + for i, version in enumerate(versions): + result.append((''.join(('py', version)), 'none', 'any')) + if i == 0: + result.append((''.join(('py', version[0])), 'none', 'any')) + + return set(result) + + +COMPATIBLE_TAGS = compatible_tags() + +del compatible_tags + + +def is_compatible(wheel, tags=None): + if not isinstance(wheel, Wheel): + wheel = Wheel(wheel) # assume it's a filename + result = False + if tags is None: + tags = COMPATIBLE_TAGS + for ver, abi, arch in tags: + if ver in wheel.pyver and abi in wheel.abi and arch in wheel.arch: + result = True + break + return result diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/distro/__init__.py b/.venv/lib/python3.12/site-packages/pip/_vendor/distro/__init__.py new file mode 100644 index 0000000..7686fe8 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/distro/__init__.py @@ -0,0 +1,54 @@ +from .distro import ( + NORMALIZED_DISTRO_ID, + NORMALIZED_LSB_ID, + NORMALIZED_OS_ID, + LinuxDistribution, + __version__, + build_number, + codename, + distro_release_attr, + distro_release_info, + id, + info, + like, + linux_distribution, + lsb_release_attr, + lsb_release_info, + major_version, + minor_version, + name, + os_release_attr, + os_release_info, + uname_attr, + uname_info, + version, + version_parts, +) + +__all__ = [ + "NORMALIZED_DISTRO_ID", + "NORMALIZED_LSB_ID", + "NORMALIZED_OS_ID", + "LinuxDistribution", + "build_number", + "codename", + "distro_release_attr", + "distro_release_info", + "id", + "info", + "like", + "linux_distribution", + "lsb_release_attr", + "lsb_release_info", + "major_version", + "minor_version", + "name", + "os_release_attr", + "os_release_info", + "uname_attr", + "uname_info", + "version", + "version_parts", +] + +__version__ = __version__ diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/distro/__main__.py b/.venv/lib/python3.12/site-packages/pip/_vendor/distro/__main__.py new file mode 100644 index 0000000..0c01d5b --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/distro/__main__.py @@ -0,0 +1,4 @@ +from .distro import main + +if __name__ == "__main__": + main() diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/distro/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/distro/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..90b30755bb05ec97ccb00413a720438231160532 GIT binary patch literal 959 zcmcJNzi-n(6vxkwo1{tH{A`nSK&%<4#Se8tNT4uO>JQN{Jt3W(_}X6UXIp0{YB%^R z*x3+&3Ny>COl*Y=l{#_HZKOoN$PFL8`}*E5zxUO3E6kjqZ@!#-D=_w*E{kK|8}mzJ zd}IL&tdOAv7TREA0Sf4VgKMycMJQqkN?3+6uERQ3pn_GXVhw8Of{Polfpw^30~*+b zCbpo3ZD?Z$I=Bg&xCL9-g)a7>XR%Wj*q7>E%$SnUdpaCgVs~IiCrY8k2Kf8&72z@Mwx- zp>%l?2O{!O=ypIZF;^lKek!=1W$F)6MklehWuTqhazc3_bStEcJojIuY=r4}HPnid zd%NhL$7)fUc2P!4S0}Hk9;d5emW4b@Wl9h4%DuO9y>#EQb{D-TzRJ=;SDD!}Fe*X$*F_dYyEAOr|k8>HxjPsr3>bCqG<6s(!7wVx&Mq8ck8eA7F%et}q dmVLwifjNEnwcD%O?@QOuSbh6LRXs4SzX90E1Y-aI literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/distro/__pycache__/__main__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/distro/__pycache__/__main__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..1d42e96ea88d88e19a0c93c395dcea0121c41f88 GIT binary patch literal 291 zcmXv}u}Z{15S_^eSx&Ck`vN1FL2X5>>=bN8SYmcH%O%-m69cgq`~$y1?o;gS3{c}1AiS*3({hh^4lyRXlmZ2v3fFP94j@x*aIUIX)WP9*>U literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/distro/__pycache__/distro.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/distro/__pycache__/distro.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..addc537fbf630649ae0920765e6f71e94af638a0 GIT binary patch literal 53844 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/distro/distro.py b/.venv/lib/python3.12/site-packages/pip/_vendor/distro/distro.py new file mode 100644 index 0000000..78ccdfa --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/distro/distro.py @@ -0,0 +1,1403 @@ +#!/usr/bin/env python +# 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. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +""" +The ``distro`` package (``distro`` stands for Linux Distribution) provides +information about the Linux distribution it runs on, such as a reliable +machine-readable distro ID, or version information. + +It is the recommended replacement for Python's original +:py:func:`platform.linux_distribution` function, but it provides much more +functionality. An alternative implementation became necessary because Python +3.5 deprecated this function, and Python 3.8 removed it altogether. Its +predecessor function :py:func:`platform.dist` was already deprecated since +Python 2.6 and removed in Python 3.8. Still, there are many cases in which +access to OS distribution information is needed. See `Python issue 1322 +`_ for more information. +""" + +import argparse +import json +import logging +import os +import re +import shlex +import subprocess +import sys +import warnings +from typing import ( + Any, + Callable, + Dict, + Iterable, + Optional, + Sequence, + TextIO, + Tuple, + Type, +) + +try: + from typing import TypedDict +except ImportError: + # Python 3.7 + TypedDict = dict + +__version__ = "1.9.0" + + +class VersionDict(TypedDict): + major: str + minor: str + build_number: str + + +class InfoDict(TypedDict): + id: str + version: str + version_parts: VersionDict + like: str + codename: str + + +_UNIXCONFDIR = os.environ.get("UNIXCONFDIR", "/etc") +_UNIXUSRLIBDIR = os.environ.get("UNIXUSRLIBDIR", "/usr/lib") +_OS_RELEASE_BASENAME = "os-release" + +#: Translation table for normalizing the "ID" attribute defined in os-release +#: files, for use by the :func:`distro.id` method. +#: +#: * Key: Value as defined in the os-release file, translated to lower case, +#: with blanks translated to underscores. +#: +#: * Value: Normalized value. +NORMALIZED_OS_ID = { + "ol": "oracle", # Oracle Linux + "opensuse-leap": "opensuse", # Newer versions of OpenSuSE report as opensuse-leap +} + +#: Translation table for normalizing the "Distributor ID" attribute returned by +#: the lsb_release command, for use by the :func:`distro.id` method. +#: +#: * Key: Value as returned by the lsb_release command, translated to lower +#: case, with blanks translated to underscores. +#: +#: * Value: Normalized value. +NORMALIZED_LSB_ID = { + "enterpriseenterpriseas": "oracle", # Oracle Enterprise Linux 4 + "enterpriseenterpriseserver": "oracle", # Oracle Linux 5 + "redhatenterpriseworkstation": "rhel", # RHEL 6, 7 Workstation + "redhatenterpriseserver": "rhel", # RHEL 6, 7 Server + "redhatenterprisecomputenode": "rhel", # RHEL 6 ComputeNode +} + +#: Translation table for normalizing the distro ID derived from the file name +#: of distro release files, for use by the :func:`distro.id` method. +#: +#: * Key: Value as derived from the file name of a distro release file, +#: translated to lower case, with blanks translated to underscores. +#: +#: * Value: Normalized value. +NORMALIZED_DISTRO_ID = { + "redhat": "rhel", # RHEL 6.x, 7.x +} + +# Pattern for content of distro release file (reversed) +_DISTRO_RELEASE_CONTENT_REVERSED_PATTERN = re.compile( + r"(?:[^)]*\)(.*)\()? *(?:STL )?([\d.+\-a-z]*\d) *(?:esaeler *)?(.+)" +) + +# Pattern for base file name of distro release file +_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", + "fedora-release", + "gentoo-release", + "mageia-release", + "mandrake-release", + "mandriva-release", + "mandrivalinux-release", + "manjaro-release", + "oracle-release", + "redhat-release", + "rocky-release", + "sl-release", + "slackware-version", +] + +# Base file names to be ignored when searching for distro release file +_DISTRO_RELEASE_IGNORE_BASENAMES = ( + "debian_version", + "lsb-release", + "oem-release", + _OS_RELEASE_BASENAME, + "system-release", + "plesk-release", + "iredmail-release", + "board-release", + "ec2_version", +) + + +def linux_distribution(full_distribution_name: bool = True) -> Tuple[str, str, str]: + """ + .. deprecated:: 1.6.0 + + :func:`distro.linux_distribution()` is deprecated. It should only be + used as a compatibility shim with Python's + :py:func:`platform.linux_distribution()`. Please use :func:`distro.id`, + :func:`distro.version` and :func:`distro.name` instead. + + Return information about the current OS distribution as a tuple + ``(id_name, version, codename)`` with items as follows: + + * ``id_name``: If *full_distribution_name* is false, the result of + :func:`distro.id`. Otherwise, the result of :func:`distro.name`. + + * ``version``: The result of :func:`distro.version`. + + * ``codename``: The extra item (usually in parentheses) after the + os-release version number, or the result of :func:`distro.codename`. + + The interface of this function is compatible with the original + :py:func:`platform.linux_distribution` function, supporting a subset of + its parameters. + + The data it returns may not exactly be the same, because it uses more data + sources than the original function, and that may lead to different data if + the OS distribution is not consistent across multiple data sources it + provides (there are indeed such distributions ...). + + Another reason for differences is the fact that the :func:`distro.id` + method normalizes the distro ID string to a reliable machine-readable value + for a number of popular OS distributions. + """ + warnings.warn( + "distro.linux_distribution() is deprecated. It should only be used as a " + "compatibility shim with Python's platform.linux_distribution(). Please use " + "distro.id(), distro.version() and distro.name() instead.", + DeprecationWarning, + stacklevel=2, + ) + return _distro.linux_distribution(full_distribution_name) + + +def id() -> str: + """ + Return the distro ID of the current distribution, as a + machine-readable string. + + For a number of OS distributions, the returned distro ID value is + *reliable*, in the sense that it is documented and that it does not change + across releases of the distribution. + + This package maintains the following reliable distro ID values: + + ============== ========================================= + Distro ID Distribution + ============== ========================================= + "ubuntu" Ubuntu + "debian" Debian + "rhel" RedHat Enterprise Linux + "centos" CentOS + "fedora" Fedora + "sles" SUSE Linux Enterprise Server + "opensuse" openSUSE + "amzn" Amazon Linux + "arch" Arch Linux + "buildroot" Buildroot + "cloudlinux" CloudLinux OS + "exherbo" Exherbo Linux + "gentoo" GenToo Linux + "ibm_powerkvm" IBM PowerKVM + "kvmibm" KVM for IBM z Systems + "linuxmint" Linux Mint + "mageia" Mageia + "mandriva" Mandriva Linux + "parallels" Parallels + "pidora" Pidora + "raspbian" Raspbian + "oracle" Oracle Linux (and Oracle Enterprise Linux) + "scientific" Scientific Linux + "slackware" Slackware + "xenserver" XenServer + "openbsd" OpenBSD + "netbsd" NetBSD + "freebsd" FreeBSD + "midnightbsd" MidnightBSD + "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, + or if you find that the :func:`distro.id` function returns a different + distro ID for one of the listed distros, please create an issue in the + `distro issue tracker`_. + + **Lookup hierarchy and transformations:** + + First, the ID is obtained from the following sources, in the specified + order. The first available and non-empty value is used: + + * the value of the "ID" attribute of the os-release file, + + * the value of the "Distributor ID" attribute returned by the lsb_release + command, + + * the first part of the file name of the distro release file, + + The so determined ID value then passes the following transformations, + before it is returned by this method: + + * it is translated to lower case, + + * blanks (which should not be there anyway) are translated to underscores, + + * a normalization of the ID is performed, based upon + `normalization tables`_. The purpose of this normalization is to ensure + that the ID is as reliable as possible, even across incompatible changes + in the OS distributions. A common reason for an incompatible change is + the addition of an os-release file, or the addition of the lsb_release + command, with ID values that differ from what was previously determined + from the distro release file name. + """ + return _distro.id() + + +def name(pretty: bool = False) -> str: + """ + Return the name of the current OS distribution, as a human-readable + string. + + If *pretty* is false, the name is returned without version or codename. + (e.g. "CentOS Linux") + + If *pretty* is true, the version and codename are appended. + (e.g. "CentOS Linux 7.1.1503 (Core)") + + **Lookup hierarchy:** + + The name is obtained from the following sources, in the specified order. + The first available and non-empty value is used: + + * If *pretty* is false: + + - the value of the "NAME" attribute of the os-release file, + + - the value of the "Distributor ID" attribute returned by the lsb_release + command, + + - the value of the "" field of the distro release file. + + * If *pretty* is true: + + - the value of the "PRETTY_NAME" attribute of the os-release file, + + - the value of the "Description" attribute returned by the lsb_release + command, + + - the value of the "" field of the distro release file, appended + with the value of the pretty version ("" and "" + fields) of the distro release file, if available. + """ + return _distro.name(pretty) + + +def version(pretty: bool = False, best: bool = False) -> str: + """ + Return the version of the current OS distribution, as a human-readable + string. + + If *pretty* is false, the version is returned without codename (e.g. + "7.0"). + + If *pretty* is true, the codename in parenthesis is appended, if the + codename is non-empty (e.g. "7.0 (Maipo)"). + + Some distributions provide version numbers with different precisions in + the different sources of distribution information. Examining the different + sources in a fixed priority order does not always yield the most precise + version (e.g. for Debian 8.2, or CentOS 7.1). + + Some other distributions may not provide this kind of information. In these + cases, an empty string would be returned. This behavior can be observed + with rolling releases distributions (e.g. Arch Linux). + + The *best* parameter can be used to control the approach for the returned + version: + + If *best* is false, the first non-empty version number in priority order of + the examined sources is returned. + + If *best* is true, the most precise version number out of all examined + sources is returned. + + **Lookup hierarchy:** + + In all cases, the version number is obtained from the following sources. + If *best* is false, this order represents the priority order: + + * the value of the "VERSION_ID" attribute of the os-release file, + * the value of the "Release" attribute returned by the lsb_release + command, + * the version number parsed from the "" field of the first line + of the distro release file, + * the version number parsed from the "PRETTY_NAME" attribute of the + os-release file, if it follows the format of the distro release files. + * the version number parsed from the "Description" attribute returned by + the lsb_release command, if it follows the format of the distro release + files. + """ + return _distro.version(pretty, best) + + +def version_parts(best: bool = False) -> Tuple[str, str, str]: + """ + Return the version of the current OS distribution as a tuple + ``(major, minor, build_number)`` with items as follows: + + * ``major``: The result of :func:`distro.major_version`. + + * ``minor``: The result of :func:`distro.minor_version`. + + * ``build_number``: The result of :func:`distro.build_number`. + + For a description of the *best* parameter, see the :func:`distro.version` + method. + """ + return _distro.version_parts(best) + + +def major_version(best: bool = False) -> str: + """ + Return the major version of the current OS distribution, as a string, + if provided. + Otherwise, the empty string is returned. The major version is the first + part of the dot-separated version string. + + For a description of the *best* parameter, see the :func:`distro.version` + method. + """ + return _distro.major_version(best) + + +def minor_version(best: bool = False) -> str: + """ + Return the minor version of the current OS distribution, as a string, + if provided. + Otherwise, the empty string is returned. The minor version is the second + part of the dot-separated version string. + + For a description of the *best* parameter, see the :func:`distro.version` + method. + """ + return _distro.minor_version(best) + + +def build_number(best: bool = False) -> str: + """ + Return the build number of the current OS distribution, as a string, + if provided. + Otherwise, the empty string is returned. The build number is the third part + of the dot-separated version string. + + For a description of the *best* parameter, see the :func:`distro.version` + method. + """ + return _distro.build_number(best) + + +def like() -> str: + """ + Return a space-separated list of distro IDs of distributions that are + closely related to the current OS distribution in regards to packaging + and programming interfaces, for example distributions the current + distribution is a derivative from. + + **Lookup hierarchy:** + + This information item is only provided by the os-release file. + For details, see the description of the "ID_LIKE" attribute in the + `os-release man page + `_. + """ + return _distro.like() + + +def codename() -> str: + """ + Return the codename for the release of the current OS distribution, + as a string. + + If the distribution does not have a codename, an empty string is returned. + + Note that the returned codename is not always really a codename. For + example, openSUSE returns "x86_64". This function does not handle such + cases in any special way and just returns the string it finds, if any. + + **Lookup hierarchy:** + + * the codename within the "VERSION" attribute of the os-release file, if + provided, + + * the value of the "Codename" attribute returned by the lsb_release + command, + + * the value of the "" field of the distro release file. + """ + return _distro.codename() + + +def info(pretty: bool = False, best: bool = False) -> InfoDict: + """ + Return certain machine-readable information items about the current OS + distribution in a dictionary, as shown in the following example: + + .. sourcecode:: python + + { + 'id': 'rhel', + 'version': '7.0', + 'version_parts': { + 'major': '7', + 'minor': '0', + 'build_number': '' + }, + 'like': 'fedora', + 'codename': 'Maipo' + } + + The dictionary structure and keys are always the same, regardless of which + information items are available in the underlying data sources. The values + for the various keys are as follows: + + * ``id``: The result of :func:`distro.id`. + + * ``version``: The result of :func:`distro.version`. + + * ``version_parts -> major``: The result of :func:`distro.major_version`. + + * ``version_parts -> minor``: The result of :func:`distro.minor_version`. + + * ``version_parts -> build_number``: The result of + :func:`distro.build_number`. + + * ``like``: The result of :func:`distro.like`. + + * ``codename``: The result of :func:`distro.codename`. + + For a description of the *pretty* and *best* parameters, see the + :func:`distro.version` method. + """ + return _distro.info(pretty, best) + + +def os_release_info() -> Dict[str, str]: + """ + Return a dictionary containing key-value pairs for the information items + from the os-release file data source of the current OS distribution. + + See `os-release file`_ for details about these information items. + """ + return _distro.os_release_info() + + +def lsb_release_info() -> Dict[str, str]: + """ + Return a dictionary containing key-value pairs for the information items + from the lsb_release command data source of the current OS distribution. + + See `lsb_release command output`_ for details about these information + items. + """ + return _distro.lsb_release_info() + + +def distro_release_info() -> Dict[str, str]: + """ + Return a dictionary containing key-value pairs for the information items + from the distro release file data source of the current OS distribution. + + See `distro release file`_ for details about these information items. + """ + return _distro.distro_release_info() + + +def uname_info() -> Dict[str, str]: + """ + Return a dictionary containing key-value pairs for the information items + from the distro release file data source of the current OS distribution. + """ + return _distro.uname_info() + + +def os_release_attr(attribute: str) -> str: + """ + Return a single named information item from the os-release file data source + of the current OS distribution. + + Parameters: + + * ``attribute`` (string): Key of the information item. + + Returns: + + * (string): Value of the information item, if the item exists. + The empty string, if the item does not exist. + + See `os-release file`_ for details about these information items. + """ + return _distro.os_release_attr(attribute) + + +def lsb_release_attr(attribute: str) -> str: + """ + Return a single named information item from the lsb_release command output + data source of the current OS distribution. + + Parameters: + + * ``attribute`` (string): Key of the information item. + + Returns: + + * (string): Value of the information item, if the item exists. + The empty string, if the item does not exist. + + See `lsb_release command output`_ for details about these information + items. + """ + return _distro.lsb_release_attr(attribute) + + +def distro_release_attr(attribute: str) -> str: + """ + Return a single named information item from the distro release file + data source of the current OS distribution. + + Parameters: + + * ``attribute`` (string): Key of the information item. + + Returns: + + * (string): Value of the information item, if the item exists. + The empty string, if the item does not exist. + + See `distro release file`_ for details about these information items. + """ + return _distro.distro_release_attr(attribute) + + +def uname_attr(attribute: str) -> str: + """ + Return a single named information item from the distro release file + data source of the current OS distribution. + + Parameters: + + * ``attribute`` (string): Key of the information item. + + Returns: + + * (string): Value of the information item, if the item exists. + The empty string, if the item does not exist. + """ + return _distro.uname_attr(attribute) + + +try: + from functools import cached_property +except ImportError: + # Python < 3.8 + class cached_property: # type: ignore + """A version of @property which caches the value. On access, it calls the + underlying function and sets the value in `__dict__` so future accesses + will not re-call the property. + """ + + def __init__(self, f: Callable[[Any], Any]) -> None: + self._fname = f.__name__ + self._f = f + + def __get__(self, obj: Any, owner: Type[Any]) -> Any: + assert obj is not None, f"call {self._fname} on an instance" + ret = obj.__dict__[self._fname] = self._f(obj) + return ret + + +class LinuxDistribution: + """ + Provides information about a OS distribution. + + This package creates a private module-global instance of this class with + default initialization arguments, that is used by the + `consolidated accessor functions`_ and `single source accessor functions`_. + By using default initialization arguments, that module-global instance + returns data about the current OS distribution (i.e. the distro this + package runs on). + + Normally, it is not necessary to create additional instances of this class. + However, in situations where control is needed over the exact data sources + that are used, instances of this class can be created with a specific + distro release file, or a specific os-release file, or without invoking the + lsb_release command. + """ + + def __init__( + self, + include_lsb: Optional[bool] = None, + os_release_file: str = "", + distro_release_file: str = "", + include_uname: Optional[bool] = None, + root_dir: Optional[str] = None, + include_oslevel: Optional[bool] = None, + ) -> None: + """ + The initialization method of this class gathers information from the + available data sources, and stores that in private instance attributes. + Subsequent access to the information items uses these private instance + attributes, so that the data sources are read only once. + + Parameters: + + * ``include_lsb`` (bool): Controls whether the + `lsb_release command output`_ is included as a data source. + + If the lsb_release command is not available in the program execution + path, the data source for the lsb_release command will be empty. + + * ``os_release_file`` (string): The path name of the + `os-release file`_ that is to be used as a data source. + + An empty string (the default) will cause the default path name to + be used (see `os-release file`_ for details). + + If the specified or defaulted os-release file does not exist, the + data source for the os-release file will be empty. + + * ``distro_release_file`` (string): The path name of the + `distro release file`_ that is to be used as a data source. + + An empty string (the default) will cause a default search algorithm + to be used (see `distro release file`_ for details). + + If the specified distro release file does not exist, or if no default + distro release file can be found, the data source for the distro + release file will be empty. + + * ``include_uname`` (bool): Controls whether uname command output is + included as a data source. If the uname command is not available in + the program execution path the data source for the uname command will + be empty. + + * ``root_dir`` (string): The absolute path to the root directory to use + to find distro-related information files. Note that ``include_*`` + parameters must not be enabled in combination with ``root_dir``. + + * ``include_oslevel`` (bool): Controls whether (AIX) oslevel command + output is included as a data source. If the oslevel command is not + available in the program execution path the data source will be + empty. + + Public instance attributes: + + * ``os_release_file`` (string): The path name of the + `os-release file`_ that is actually used as a data source. The + empty string if no distro release file is used as a data source. + + * ``distro_release_file`` (string): The path name of the + `distro release file`_ that is actually used as a data source. The + empty string if no distro release file is used as a data source. + + * ``include_lsb`` (bool): The result of the ``include_lsb`` parameter. + This controls whether the lsb information will be loaded. + + * ``include_uname`` (bool): The result of the ``include_uname`` + parameter. This controls whether the uname information will + be loaded. + + * ``include_oslevel`` (bool): The result of the ``include_oslevel`` + parameter. This controls whether (AIX) oslevel information will be + loaded. + + * ``root_dir`` (string): The result of the ``root_dir`` parameter. + The absolute path to the root directory to use to find distro-related + information files. + + Raises: + + * :py:exc:`ValueError`: Initialization parameters combination is not + supported. + + * :py:exc:`OSError`: Some I/O issue with an os-release file or distro + release file. + + * :py:exc:`UnicodeError`: A data source has unexpected characters or + uses an unexpected encoding. + """ + self.root_dir = root_dir + self.etc_dir = os.path.join(root_dir, "etc") if root_dir else _UNIXCONFDIR + self.usr_lib_dir = ( + os.path.join(root_dir, "usr/lib") if root_dir else _UNIXUSRLIBDIR + ) + + if os_release_file: + self.os_release_file = os_release_file + else: + etc_dir_os_release_file = os.path.join(self.etc_dir, _OS_RELEASE_BASENAME) + usr_lib_os_release_file = os.path.join( + self.usr_lib_dir, _OS_RELEASE_BASENAME + ) + + # NOTE: The idea is to respect order **and** have it set + # at all times for API backwards compatibility. + if os.path.isfile(etc_dir_os_release_file) or not os.path.isfile( + usr_lib_os_release_file + ): + self.os_release_file = etc_dir_os_release_file + else: + self.os_release_file = usr_lib_os_release_file + + self.distro_release_file = distro_release_file or "" # updated later + + is_root_dir_defined = root_dir is not None + if is_root_dir_defined and (include_lsb or include_uname or include_oslevel): + raise ValueError( + "Including subprocess data sources from specific root_dir is disallowed" + " to prevent false information" + ) + self.include_lsb = ( + include_lsb if include_lsb is not None else not is_root_dir_defined + ) + self.include_uname = ( + include_uname if include_uname is not None else not is_root_dir_defined + ) + self.include_oslevel = ( + include_oslevel if include_oslevel is not None else not is_root_dir_defined + ) + + def __repr__(self) -> str: + """Return repr of all info""" + return ( + "LinuxDistribution(" + "os_release_file={self.os_release_file!r}, " + "distro_release_file={self.distro_release_file!r}, " + "include_lsb={self.include_lsb!r}, " + "include_uname={self.include_uname!r}, " + "include_oslevel={self.include_oslevel!r}, " + "root_dir={self.root_dir!r}, " + "_os_release_info={self._os_release_info!r}, " + "_lsb_release_info={self._lsb_release_info!r}, " + "_distro_release_info={self._distro_release_info!r}, " + "_uname_info={self._uname_info!r}, " + "_oslevel_info={self._oslevel_info!r})".format(self=self) + ) + + def linux_distribution( + self, full_distribution_name: bool = True + ) -> Tuple[str, str, str]: + """ + Return information about the OS distribution that is compatible + with Python's :func:`platform.linux_distribution`, supporting a subset + of its parameters. + + For details, see :func:`distro.linux_distribution`. + """ + return ( + self.name() if full_distribution_name else self.id(), + self.version(), + self._os_release_info.get("release_codename") or self.codename(), + ) + + def id(self) -> str: + """Return the distro ID of the OS distribution, as a string. + + For details, see :func:`distro.id`. + """ + + def normalize(distro_id: str, table: Dict[str, str]) -> str: + distro_id = distro_id.lower().replace(" ", "_") + return table.get(distro_id, distro_id) + + distro_id = self.os_release_attr("id") + if distro_id: + return normalize(distro_id, NORMALIZED_OS_ID) + + distro_id = self.lsb_release_attr("distributor_id") + if distro_id: + return normalize(distro_id, NORMALIZED_LSB_ID) + + distro_id = self.distro_release_attr("id") + if distro_id: + return normalize(distro_id, NORMALIZED_DISTRO_ID) + + distro_id = self.uname_attr("id") + if distro_id: + return normalize(distro_id, NORMALIZED_DISTRO_ID) + + return "" + + def name(self, pretty: bool = False) -> str: + """ + Return the name of the OS distribution, as a string. + + For details, see :func:`distro.name`. + """ + name = ( + self.os_release_attr("name") + or self.lsb_release_attr("distributor_id") + or self.distro_release_attr("name") + or self.uname_attr("name") + ) + if pretty: + name = self.os_release_attr("pretty_name") or self.lsb_release_attr( + "description" + ) + if not name: + name = self.distro_release_attr("name") or self.uname_attr("name") + version = self.version(pretty=True) + if version: + name = f"{name} {version}" + return name or "" + + def version(self, pretty: bool = False, best: bool = False) -> str: + """ + Return the version of the OS distribution, as a string. + + For details, see :func:`distro.version`. + """ + versions = [ + self.os_release_attr("version_id"), + self.lsb_release_attr("release"), + self.distro_release_attr("version_id"), + self._parse_distro_release_content(self.os_release_attr("pretty_name")).get( + "version_id", "" + ), + self._parse_distro_release_content( + self.lsb_release_attr("description") + ).get("version_id", ""), + self.uname_attr("release"), + ] + if self.uname_attr("id").startswith("aix"): + # On AIX platforms, prefer oslevel command output. + versions.insert(0, self.oslevel_info()) + elif self.id() == "debian" or "debian" in self.like().split(): + # On Debian-like, add debian_version file content to candidates list. + versions.append(self._debian_version) + version = "" + if best: + # This algorithm uses the last version in priority order that has + # the best precision. If the versions are not in conflict, that + # does not matter; otherwise, using the last one instead of the + # first one might be considered a surprise. + for v in versions: + if v.count(".") > version.count(".") or version == "": + version = v + else: + for v in versions: + if v != "": + version = v + break + if pretty and version and self.codename(): + version = f"{version} ({self.codename()})" + return version + + def version_parts(self, best: bool = False) -> Tuple[str, str, str]: + """ + Return the version of the OS distribution, as a tuple of version + numbers. + + For details, see :func:`distro.version_parts`. + """ + version_str = self.version(best=best) + if version_str: + version_regex = re.compile(r"(\d+)\.?(\d+)?\.?(\d+)?") + matches = version_regex.match(version_str) + if matches: + major, minor, build_number = matches.groups() + return major, minor or "", build_number or "" + return "", "", "" + + def major_version(self, best: bool = False) -> str: + """ + Return the major version number of the current distribution. + + For details, see :func:`distro.major_version`. + """ + return self.version_parts(best)[0] + + def minor_version(self, best: bool = False) -> str: + """ + Return the minor version number of the current distribution. + + For details, see :func:`distro.minor_version`. + """ + return self.version_parts(best)[1] + + def build_number(self, best: bool = False) -> str: + """ + Return the build number of the current distribution. + + For details, see :func:`distro.build_number`. + """ + return self.version_parts(best)[2] + + def like(self) -> str: + """ + Return the IDs of distributions that are like the OS distribution. + + For details, see :func:`distro.like`. + """ + return self.os_release_attr("id_like") or "" + + def codename(self) -> str: + """ + Return the codename of the OS distribution. + + For details, see :func:`distro.codename`. + """ + try: + # Handle os_release specially since distros might purposefully set + # this to empty string to have no codename + return self._os_release_info["codename"] + except KeyError: + return ( + self.lsb_release_attr("codename") + or self.distro_release_attr("codename") + or "" + ) + + def info(self, pretty: bool = False, best: bool = False) -> InfoDict: + """ + Return certain machine-readable information about the OS + distribution. + + For details, see :func:`distro.info`. + """ + return InfoDict( + id=self.id(), + version=self.version(pretty, best), + version_parts=VersionDict( + major=self.major_version(best), + minor=self.minor_version(best), + build_number=self.build_number(best), + ), + like=self.like(), + codename=self.codename(), + ) + + def os_release_info(self) -> Dict[str, str]: + """ + Return a dictionary containing key-value pairs for the information + items from the os-release file data source of the OS distribution. + + For details, see :func:`distro.os_release_info`. + """ + return self._os_release_info + + def lsb_release_info(self) -> Dict[str, str]: + """ + Return a dictionary containing key-value pairs for the information + items from the lsb_release command data source of the OS + distribution. + + For details, see :func:`distro.lsb_release_info`. + """ + return self._lsb_release_info + + def distro_release_info(self) -> Dict[str, str]: + """ + Return a dictionary containing key-value pairs for the information + items from the distro release file data source of the OS + distribution. + + For details, see :func:`distro.distro_release_info`. + """ + return self._distro_release_info + + def uname_info(self) -> Dict[str, str]: + """ + Return a dictionary containing key-value pairs for the information + items from the uname command data source of the OS distribution. + + For details, see :func:`distro.uname_info`. + """ + return self._uname_info + + def oslevel_info(self) -> str: + """ + Return AIX' oslevel command output. + """ + return self._oslevel_info + + def os_release_attr(self, attribute: str) -> str: + """ + Return a single named information item from the os-release file data + source of the OS distribution. + + For details, see :func:`distro.os_release_attr`. + """ + return self._os_release_info.get(attribute, "") + + def lsb_release_attr(self, attribute: str) -> str: + """ + Return a single named information item from the lsb_release command + output data source of the OS distribution. + + For details, see :func:`distro.lsb_release_attr`. + """ + return self._lsb_release_info.get(attribute, "") + + def distro_release_attr(self, attribute: str) -> str: + """ + Return a single named information item from the distro release file + data source of the OS distribution. + + For details, see :func:`distro.distro_release_attr`. + """ + return self._distro_release_info.get(attribute, "") + + def uname_attr(self, attribute: str) -> str: + """ + Return a single named information item from the uname command + output data source of the OS distribution. + + For details, see :func:`distro.uname_attr`. + """ + return self._uname_info.get(attribute, "") + + @cached_property + def _os_release_info(self) -> Dict[str, str]: + """ + Get the information items from the specified os-release file. + + Returns: + A dictionary containing all information items. + """ + if os.path.isfile(self.os_release_file): + with open(self.os_release_file, encoding="utf-8") as release_file: + return self._parse_os_release_content(release_file) + return {} + + @staticmethod + def _parse_os_release_content(lines: TextIO) -> Dict[str, str]: + """ + Parse the lines of an os-release file. + + Parameters: + + * lines: Iterable through the lines in the os-release file. + Each line must be a unicode string or a UTF-8 encoded byte + string. + + Returns: + A dictionary containing all information items. + """ + props = {} + lexer = shlex.shlex(lines, posix=True) + lexer.whitespace_split = True + + tokens = list(lexer) + for token in tokens: + # At this point, all shell-like parsing has been done (i.e. + # comments processed, quotes and backslash escape sequences + # processed, multi-line values assembled, trailing newlines + # stripped, etc.), so the tokens are now either: + # * variable assignments: var=value + # * commands or their arguments (not allowed in os-release) + # Ignore any tokens that are not variable assignments + if "=" in token: + k, v = token.split("=", 1) + props[k.lower()] = v + + if "version" in props: + # extract release codename (if any) from version attribute + match = re.search(r"\((\D+)\)|,\s*(\D+)", props["version"]) + if match: + release_codename = match.group(1) or match.group(2) + props["codename"] = props["release_codename"] = release_codename + + if "version_codename" in props: + # os-release added a version_codename field. Use that in + # preference to anything else Note that some distros purposefully + # do not have code names. They should be setting + # version_codename="" + props["codename"] = props["version_codename"] + elif "ubuntu_codename" in props: + # Same as above but a non-standard field name used on older Ubuntus + props["codename"] = props["ubuntu_codename"] + + return props + + @cached_property + def _lsb_release_info(self) -> Dict[str, str]: + """ + Get the information items from the lsb_release command output. + + Returns: + A dictionary containing all information items. + """ + if not self.include_lsb: + return {} + try: + cmd = ("lsb_release", "-a") + stdout = subprocess.check_output(cmd, stderr=subprocess.DEVNULL) + # Command not found or lsb_release returned error + except (OSError, subprocess.CalledProcessError): + return {} + content = self._to_str(stdout).splitlines() + return self._parse_lsb_release_content(content) + + @staticmethod + def _parse_lsb_release_content(lines: Iterable[str]) -> Dict[str, str]: + """ + Parse the output of the lsb_release command. + + Parameters: + + * lines: Iterable through the lines of the lsb_release output. + Each line must be a unicode string or a UTF-8 encoded byte + string. + + Returns: + A dictionary containing all information items. + """ + props = {} + for line in lines: + kv = line.strip("\n").split(":", 1) + if len(kv) != 2: + # Ignore lines without colon. + continue + k, v = kv + props.update({k.replace(" ", "_").lower(): v.strip()}) + return props + + @cached_property + def _uname_info(self) -> Dict[str, str]: + if not self.include_uname: + return {} + try: + cmd = ("uname", "-rs") + stdout = subprocess.check_output(cmd, stderr=subprocess.DEVNULL) + except OSError: + return {} + content = self._to_str(stdout).splitlines() + return self._parse_uname_content(content) + + @cached_property + def _oslevel_info(self) -> str: + if not self.include_oslevel: + return "" + try: + stdout = subprocess.check_output("oslevel", stderr=subprocess.DEVNULL) + except (OSError, subprocess.CalledProcessError): + return "" + return self._to_str(stdout).strip() + + @cached_property + def _debian_version(self) -> str: + try: + with open( + os.path.join(self.etc_dir, "debian_version"), encoding="ascii" + ) as fp: + return fp.readline().rstrip() + except FileNotFoundError: + return "" + + @staticmethod + def _parse_uname_content(lines: Sequence[str]) -> Dict[str, str]: + if not lines: + return {} + props = {} + match = re.search(r"^([^\s]+)\s+([\d\.]+)", lines[0].strip()) + if match: + name, version = match.groups() + + # This is to prevent the Linux kernel version from + # appearing as the 'best' version on otherwise + # identifiable distributions. + if name == "Linux": + return {} + props["id"] = name.lower() + props["name"] = name + props["release"] = version + return props + + @staticmethod + def _to_str(bytestring: bytes) -> str: + encoding = sys.getfilesystemencoding() + return bytestring.decode(encoding) + + @cached_property + def _distro_release_info(self) -> Dict[str, str]: + """ + Get the information items from the specified distro release file. + + Returns: + A dictionary containing all information items. + """ + if self.distro_release_file: + # If it was specified, we use it and parse what we can, even if + # its file name or content does not match the expected pattern. + distro_info = self._parse_distro_release_file(self.distro_release_file) + basename = os.path.basename(self.distro_release_file) + # The file name pattern for user-specified distro release files + # is somewhat more tolerant (compared to when searching for the + # file), because we want to use what was specified as best as + # possible. + match = _DISTRO_RELEASE_BASENAME_PATTERN.match(basename) + else: + try: + basenames = [ + basename + for basename in os.listdir(self.etc_dir) + if basename not in _DISTRO_RELEASE_IGNORE_BASENAMES + and os.path.isfile(os.path.join(self.etc_dir, basename)) + ] + # We sort for repeatability in cases where there are multiple + # distro specific files; e.g. CentOS, Oracle, Enterprise all + # containing `redhat-release` on top of their own. + basenames.sort() + except OSError: + # This may occur when /etc is not readable but we can't be + # sure about the *-release files. Check common entries of + # /etc for information. If they turn out to not be there the + # error is handled in `_parse_distro_release_file()`. + basenames = _DISTRO_RELEASE_BASENAMES + for basename in basenames: + match = _DISTRO_RELEASE_BASENAME_PATTERN.match(basename) + if match is None: + continue + filepath = os.path.join(self.etc_dir, basename) + distro_info = self._parse_distro_release_file(filepath) + # The name is always present if the pattern matches. + if "name" not in distro_info: + continue + self.distro_release_file = filepath + break + else: # the loop didn't "break": no candidate. + return {} + + if match is not None: + distro_info["id"] = match.group(1) + + # CloudLinux < 7: manually enrich info with proper id. + if "cloudlinux" in distro_info.get("name", "").lower(): + distro_info["id"] = "cloudlinux" + + return distro_info + + def _parse_distro_release_file(self, filepath: str) -> Dict[str, str]: + """ + Parse a distro release file. + + Parameters: + + * filepath: Path name of the distro release file. + + Returns: + A dictionary containing all information items. + """ + try: + with open(filepath, encoding="utf-8") as fp: + # Only parse the first line. For instance, on SLES there + # are multiple lines. We don't want them... + return self._parse_distro_release_content(fp.readline()) + except OSError: + # Ignore not being able to read a specific, seemingly version + # related file. + # See https://github.com/python-distro/distro/issues/162 + return {} + + @staticmethod + def _parse_distro_release_content(line: str) -> Dict[str, str]: + """ + Parse a line from a distro release file. + + Parameters: + * line: Line from the distro release file. Must be a unicode string + or a UTF-8 encoded byte string. + + Returns: + A dictionary containing all information items. + """ + matches = _DISTRO_RELEASE_CONTENT_REVERSED_PATTERN.match(line.strip()[::-1]) + distro_info = {} + if matches: + # regexp ensures non-None + distro_info["name"] = matches.group(3)[::-1] + if matches.group(2): + distro_info["version_id"] = matches.group(2)[::-1] + if matches.group(1): + distro_info["codename"] = matches.group(1)[::-1] + elif line: + distro_info["name"] = line.strip() + return distro_info + + +_distro = LinuxDistribution() + + +def main() -> None: + logger = logging.getLogger(__name__) + logger.setLevel(logging.DEBUG) + logger.addHandler(logging.StreamHandler(sys.stdout)) + + parser = argparse.ArgumentParser(description="OS distro info tool") + parser.add_argument( + "--json", "-j", help="Output in machine readable format", action="store_true" + ) + + parser.add_argument( + "--root-dir", + "-r", + type=str, + dest="root_dir", + help="Path to the root filesystem directory (defaults to /)", + ) + + args = parser.parse_args() + + if args.root_dir: + dist = LinuxDistribution( + include_lsb=False, + include_uname=False, + include_oslevel=False, + root_dir=args.root_dir, + ) + else: + dist = _distro + + if args.json: + logger.info(json.dumps(dist.info(), indent=4, sort_keys=True)) + else: + logger.info("Name: %s", dist.name(pretty=True)) + distribution_version = dist.version(pretty=True) + logger.info("Version: %s", distribution_version) + distribution_codename = dist.codename() + logger.info("Codename: %s", distribution_codename) + + +if __name__ == "__main__": + main() diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/distro/py.typed b/.venv/lib/python3.12/site-packages/pip/_vendor/distro/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__init__.py b/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__init__.py new file mode 100644 index 0000000..a40eeaf --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__init__.py @@ -0,0 +1,44 @@ +from .package_data import __version__ +from .core import ( + IDNABidiError, + IDNAError, + InvalidCodepoint, + InvalidCodepointContext, + alabel, + check_bidi, + check_hyphen_ok, + check_initial_combiner, + check_label, + check_nfc, + decode, + encode, + ulabel, + uts46_remap, + valid_contextj, + valid_contexto, + valid_label_length, + valid_string_length, +) +from .intranges import intranges_contain + +__all__ = [ + "IDNABidiError", + "IDNAError", + "InvalidCodepoint", + "InvalidCodepointContext", + "alabel", + "check_bidi", + "check_hyphen_ok", + "check_initial_combiner", + "check_label", + "check_nfc", + "decode", + "encode", + "intranges_contain", + "ulabel", + "uts46_remap", + "valid_contextj", + "valid_contexto", + "valid_label_length", + "valid_string_length", +] diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..302151088344a35794c4431fb9144beefd12b0d3 GIT binary patch literal 880 zcmbu7zmL-}6vyo}O`E3auk?Bhhz*Gh*N7itLP&5h+`vhNZ*O-g#$Vn?Y@>j64 zA^sHp14~RyY`_VfbQ5+`7!HXA51+jEV!!Wu_WKlu17OzovybOz9RR*q=l62<#$|1c zcOU~9EC7cHLTfvP!#k+MUF7mE>T(ZxyoY+ckNVt4J|Ca~4^Y5|Xvjkp@(~*GF&gs; zn(!%_@)?@(2t|C3=1sm%aljX70l^w%?t6$1ciq_g3XOCOb%61fs)|X0aXi!E$&1rx z&soM^DkYWnt=pQD6R{-)%Z_D6OUXp74{t_}rKstfT6?4*D_ZD5n$z?GuS_~UZtZ+m z=2T#Lp%-m{305;w;8gMz6IAJ-jkg*6))D8a_A;6pY3)(bemCuwU{hC*9%Ds0DfOr+ z(IjgMd40o|de;7LPU3=!b)D;|ja9W`V!aQVisaNZFaJjtstaAcUX6 b-76=8&K39@Kkoq;|8VDl^R}mMn-jkPtorc( literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/codec.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/codec.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e9f1d2e68d8e2f67a44022387fd6df5a22f22001 GIT binary patch literal 4985 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 TU64LKH1wHI`{wU*FK74z$xq88 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/core.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/core.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..bce3cee854ba40c675c7d921acf6dcd765b5c9ad GIT binary patch literal 15847 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 O-C!(UdW>nZK>sf$I?f;f literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/idnadata.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/idnadata.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5c9760060b8f3490b1eef5e13fd586f03244bbb2 GIT binary patch literal 99475 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/intranges.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/intranges.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..525bd9926868f3a17e9625bc0fdf6353aeb563c8 GIT binary patch literal 2637 zcmZuyO>7fK6rTNaf*t42A_;+#388Hkf=yyTs0yuAP>_I7g+H~S)v|cU$&&T1nOzf{ zIwh@oNLr*uDiY>q4wa0!q&JQ|R_Y}`NVQf`duT7YnT8V=`exQn2x6q&d2im&ym|Az zH-AKM}}aCmM|{BELmbk8kaKixGW$;CK6Hh zfS#ccnJ7jmEix`G8x7yf;~}FF)^@?C5G5Tl!m!q0L^u!HuvXV@0!gD01xfRpe!y-Q z*tLK(oEOzreV2ex_^f${*jUGw>3Y~nW7GD?1flK#&gcfgxhz}kpLDV$owKaG3aV~K zw=8VuGB*ijQp>R?FwNO+7?_k}yCjwK!0j8pQcfnD^9UGIlBL8Ywx@fhV>5GalHjyM zGvWSz*VCytIDm<545|Y-;DV&Vbsxbf-jwXnR2@$P6584sS17T`l;0AYw2z-}%z33sh~J1(4isiPU| zlwfjKPkB}zv>cZJQnu|l?lcn*pMvFK20vf`lh}0tDrP*)on7ML1+MIrV-SNK!8Pp( zYa8n|(Bk1?oE*Xh<_ki!9gpdH3{-BMd)s&oV}k*OvfQd6Kjb>pBZjZ=Jou7DY(J!D zv*5yyYLFz@QVV1X_oRj>1Ct*K3^kTvz$y>Z4_i7wcbb|W@deY5rgD@**#!<<)|XhC zF@AMDF$t$k&@Az&bH_|gCfG)aQPWK&;?NxKBrNl0BAbV_*~$3eP{IY5N3wcqN{8D@ zWX)_s12w~;3DdCk1mrvjA)d|qu`NzZQzyeiq#dw1Lyh|j{N~WhRutP)-2L;Bx$~81 z%iKt%EjD*tx%l;3tZyxP@IMq%I_HH-q-lO^A^9M-czvy{cQw*mY3VKwE__qk zTOKRlesX!GcW|k9r8l|SlB~3LRl530=gPMqUs!5e8vHf3+;x0DT4`+lDY_7SkSUFV z=D}l2ncqHLIdS&)-jx&Q*E%jdZyc@c?pO#{qp%-@)zr4w@#CpwxoZ;wMZUsu;!AMY zRIMJ^I$|{M1nodPL)`=y2R#pFt4|FXQFcEYMJ&>cO9?aFs%DXr}cl?)MxGXSl$2)j!c>0XdpOz-u* z*Y_ku_W`L2^gWndhQJ^S0GUCyK}LH((#KSoa~4l@v3=p};_c$-O6Q^F$l+!Aa1fLX zm#k41^^UYKZ1Uj#0%B)_G=zFXnH9HN<1HB!-x|=w#4TM38k#V51`^imZ8fo4n}f#3 z()yI02ga9>-dP#iom_yZ?ut|0V5Jlk-af^=1Px4jqv>t6VlMC8>HQskL(Ff`X!BBD zR+X7kXNX5=#L;7$%-}Kg9ci=1W<}^<}0AUBsN2^n5{cS*BQ}!{BK1 z+qR1mo@-AxZK{IKhw!=I!fy`!8|^M0E48gf`{qX0!>xaY_pOBY6|a@9t%V2XPFF*y zF)}~)-Sm1#UumSAgxWj)cyz5}XdyB$&yz}|W%1baNKf(o)ksez)>)NM6XrJeFGD?D zUv21GZ|^CEO77#xTKm940~qPt=!aoYuS8lotkj6#plODa(lmMiqJl%_v(RiQ!xUvu z@g;T;hR&dX7+`(*rsG)rJRIiS6+iZ?#^H=(dum`X`Lm6Mx{tA+$&VDU0r t8Yo^ZCCgIjHlCAPc{|B&sqQ?LL literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/package_data.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/idna/__pycache__/package_data.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4b871f89a82bcb920bb48692c02db124bd61da0a GIT binary patch literal 215 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 U>8s4_kNK|2DxU6H#6Bbbe;I*P;s5{u literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/idna/codec.py b/.venv/lib/python3.12/site-packages/pip/_vendor/idna/codec.py new file mode 100644 index 0000000..c855a4d --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/idna/codec.py @@ -0,0 +1,118 @@ +from .core import encode, decode, alabel, ulabel, IDNAError +import codecs +import re +from typing import Any, Tuple, Optional + +_unicode_dots_re = re.compile('[\u002e\u3002\uff0e\uff61]') + +class Codec(codecs.Codec): + + def encode(self, data: str, errors: str = 'strict') -> Tuple[bytes, int]: + if errors != 'strict': + raise IDNAError('Unsupported error handling \"{}\"'.format(errors)) + + if not data: + return b"", 0 + + return encode(data), len(data) + + def decode(self, data: bytes, errors: str = 'strict') -> Tuple[str, int]: + if errors != 'strict': + raise IDNAError('Unsupported error handling \"{}\"'.format(errors)) + + if not data: + return '', 0 + + return decode(data), len(data) + +class IncrementalEncoder(codecs.BufferedIncrementalEncoder): + def _buffer_encode(self, data: str, errors: str, final: bool) -> Tuple[bytes, int]: + if errors != 'strict': + raise IDNAError('Unsupported error handling \"{}\"'.format(errors)) + + if not data: + return b'', 0 + + labels = _unicode_dots_re.split(data) + trailing_dot = b'' + if labels: + if not labels[-1]: + trailing_dot = b'.' + del labels[-1] + elif not final: + # Keep potentially unfinished label until the next call + del labels[-1] + if labels: + trailing_dot = b'.' + + result = [] + size = 0 + for label in labels: + result.append(alabel(label)) + if size: + size += 1 + size += len(label) + + # Join with U+002E + result_bytes = b'.'.join(result) + trailing_dot + size += len(trailing_dot) + return result_bytes, size + +class IncrementalDecoder(codecs.BufferedIncrementalDecoder): + def _buffer_decode(self, data: Any, errors: str, final: bool) -> Tuple[str, int]: + if errors != 'strict': + raise IDNAError('Unsupported error handling \"{}\"'.format(errors)) + + if not data: + return ('', 0) + + if not isinstance(data, str): + data = str(data, 'ascii') + + labels = _unicode_dots_re.split(data) + trailing_dot = '' + if labels: + if not labels[-1]: + trailing_dot = '.' + del labels[-1] + elif not final: + # Keep potentially unfinished label until the next call + del labels[-1] + if labels: + trailing_dot = '.' + + result = [] + size = 0 + for label in labels: + result.append(ulabel(label)) + if size: + size += 1 + size += len(label) + + result_str = '.'.join(result) + trailing_dot + size += len(trailing_dot) + return (result_str, size) + + +class StreamWriter(Codec, codecs.StreamWriter): + pass + + +class StreamReader(Codec, codecs.StreamReader): + pass + + +def search_function(name: str) -> Optional[codecs.CodecInfo]: + if name != 'idna2008': + return None + return codecs.CodecInfo( + name=name, + encode=Codec().encode, + decode=Codec().decode, + incrementalencoder=IncrementalEncoder, + incrementaldecoder=IncrementalDecoder, + streamwriter=StreamWriter, + streamreader=StreamReader, + ) + +codecs.register(search_function) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/idna/compat.py b/.venv/lib/python3.12/site-packages/pip/_vendor/idna/compat.py new file mode 100644 index 0000000..786e6bd --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/idna/compat.py @@ -0,0 +1,13 @@ +from .core import * +from .codec import * +from typing import Any, Union + +def ToASCII(label: str) -> bytes: + return encode(label) + +def ToUnicode(label: Union[bytes, bytearray]) -> str: + return decode(label) + +def nameprep(s: Any) -> None: + raise NotImplementedError('IDNA 2008 does not utilise nameprep protocol') + diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/idna/core.py b/.venv/lib/python3.12/site-packages/pip/_vendor/idna/core.py new file mode 100644 index 0000000..0dae61a --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/idna/core.py @@ -0,0 +1,395 @@ +from . import idnadata +import bisect +import unicodedata +import re +from typing import Union, Optional +from .intranges import intranges_contain + +_virama_combining_class = 9 +_alabel_prefix = b'xn--' +_unicode_dots_re = re.compile('[\u002e\u3002\uff0e\uff61]') + +class IDNAError(UnicodeError): + """ Base exception for all IDNA-encoding related problems """ + pass + + +class IDNABidiError(IDNAError): + """ Exception when bidirectional requirements are not satisfied """ + pass + + +class InvalidCodepoint(IDNAError): + """ Exception when a disallowed or unallocated codepoint is used """ + pass + + +class InvalidCodepointContext(IDNAError): + """ Exception when the codepoint is not valid in the context it is used """ + pass + + +def _combining_class(cp: int) -> int: + v = unicodedata.combining(chr(cp)) + if v == 0: + if not unicodedata.name(chr(cp)): + raise ValueError('Unknown character in unicodedata') + return v + +def _is_script(cp: str, script: str) -> bool: + return intranges_contain(ord(cp), idnadata.scripts[script]) + +def _punycode(s: str) -> bytes: + return s.encode('punycode') + +def _unot(s: int) -> str: + return 'U+{:04X}'.format(s) + + +def valid_label_length(label: Union[bytes, str]) -> bool: + if len(label) > 63: + return False + return True + + +def valid_string_length(label: Union[bytes, str], trailing_dot: bool) -> bool: + if len(label) > (254 if trailing_dot else 253): + return False + return True + + +def check_bidi(label: str, check_ltr: bool = False) -> bool: + # Bidi rules should only be applied if string contains RTL characters + bidi_label = False + for (idx, cp) in enumerate(label, 1): + direction = unicodedata.bidirectional(cp) + if direction == '': + # String likely comes from a newer version of Unicode + raise IDNABidiError('Unknown directionality in label {} at position {}'.format(repr(label), idx)) + if direction in ['R', 'AL', 'AN']: + bidi_label = True + if not bidi_label and not check_ltr: + return True + + # Bidi rule 1 + direction = unicodedata.bidirectional(label[0]) + if direction in ['R', 'AL']: + rtl = True + elif direction == 'L': + rtl = False + else: + raise IDNABidiError('First codepoint in label {} must be directionality L, R or AL'.format(repr(label))) + + valid_ending = False + number_type = None # type: Optional[str] + for (idx, cp) in enumerate(label, 1): + direction = unicodedata.bidirectional(cp) + + if rtl: + # Bidi rule 2 + if not direction in ['R', 'AL', 'AN', 'EN', 'ES', 'CS', 'ET', 'ON', 'BN', 'NSM']: + raise IDNABidiError('Invalid direction for codepoint at position {} in a right-to-left label'.format(idx)) + # Bidi rule 3 + if direction in ['R', 'AL', 'EN', 'AN']: + valid_ending = True + elif direction != 'NSM': + valid_ending = False + # Bidi rule 4 + if direction in ['AN', 'EN']: + if not number_type: + number_type = direction + else: + if number_type != direction: + raise IDNABidiError('Can not mix numeral types in a right-to-left label') + else: + # Bidi rule 5 + if not direction in ['L', 'EN', 'ES', 'CS', 'ET', 'ON', 'BN', 'NSM']: + raise IDNABidiError('Invalid direction for codepoint at position {} in a left-to-right label'.format(idx)) + # Bidi rule 6 + if direction in ['L', 'EN']: + valid_ending = True + elif direction != 'NSM': + valid_ending = False + + if not valid_ending: + raise IDNABidiError('Label ends with illegal codepoint directionality') + + return True + + +def check_initial_combiner(label: str) -> bool: + if unicodedata.category(label[0])[0] == 'M': + raise IDNAError('Label begins with an illegal combining character') + return True + + +def check_hyphen_ok(label: str) -> bool: + if label[2:4] == '--': + raise IDNAError('Label has disallowed hyphens in 3rd and 4th position') + if label[0] == '-' or label[-1] == '-': + raise IDNAError('Label must not start or end with a hyphen') + return True + + +def check_nfc(label: str) -> None: + if unicodedata.normalize('NFC', label) != label: + raise IDNAError('Label must be in Normalization Form C') + + +def valid_contextj(label: str, pos: int) -> bool: + cp_value = ord(label[pos]) + + if cp_value == 0x200c: + + if pos > 0: + if _combining_class(ord(label[pos - 1])) == _virama_combining_class: + return True + + ok = False + for i in range(pos-1, -1, -1): + joining_type = idnadata.joining_types.get(ord(label[i])) + if joining_type == ord('T'): + continue + elif joining_type in [ord('L'), ord('D')]: + ok = True + break + else: + break + + if not ok: + return False + + ok = False + for i in range(pos+1, len(label)): + joining_type = idnadata.joining_types.get(ord(label[i])) + if joining_type == ord('T'): + continue + elif joining_type in [ord('R'), ord('D')]: + ok = True + break + else: + break + return ok + + if cp_value == 0x200d: + + if pos > 0: + if _combining_class(ord(label[pos - 1])) == _virama_combining_class: + return True + return False + + else: + + return False + + +def valid_contexto(label: str, pos: int, exception: bool = False) -> bool: + cp_value = ord(label[pos]) + + if cp_value == 0x00b7: + if 0 < pos < len(label)-1: + if ord(label[pos - 1]) == 0x006c and ord(label[pos + 1]) == 0x006c: + return True + return False + + elif cp_value == 0x0375: + if pos < len(label)-1 and len(label) > 1: + return _is_script(label[pos + 1], 'Greek') + return False + + elif cp_value == 0x05f3 or cp_value == 0x05f4: + if pos > 0: + return _is_script(label[pos - 1], 'Hebrew') + return False + + elif cp_value == 0x30fb: + for cp in label: + if cp == '\u30fb': + continue + if _is_script(cp, 'Hiragana') or _is_script(cp, 'Katakana') or _is_script(cp, 'Han'): + return True + return False + + elif 0x660 <= cp_value <= 0x669: + for cp in label: + if 0x6f0 <= ord(cp) <= 0x06f9: + return False + return True + + elif 0x6f0 <= cp_value <= 0x6f9: + for cp in label: + if 0x660 <= ord(cp) <= 0x0669: + return False + return True + + return False + + +def check_label(label: Union[str, bytes, bytearray]) -> None: + if isinstance(label, (bytes, bytearray)): + label = label.decode('utf-8') + if len(label) == 0: + raise IDNAError('Empty Label') + + check_nfc(label) + check_hyphen_ok(label) + check_initial_combiner(label) + + for (pos, cp) in enumerate(label): + cp_value = ord(cp) + if intranges_contain(cp_value, idnadata.codepoint_classes['PVALID']): + continue + elif intranges_contain(cp_value, idnadata.codepoint_classes['CONTEXTJ']): + if not valid_contextj(label, pos): + raise InvalidCodepointContext('Joiner {} not allowed at position {} in {}'.format( + _unot(cp_value), pos+1, repr(label))) + elif intranges_contain(cp_value, idnadata.codepoint_classes['CONTEXTO']): + if not valid_contexto(label, pos): + raise InvalidCodepointContext('Codepoint {} not allowed at position {} in {}'.format(_unot(cp_value), pos+1, repr(label))) + else: + raise InvalidCodepoint('Codepoint {} at position {} of {} not allowed'.format(_unot(cp_value), pos+1, repr(label))) + + check_bidi(label) + + +def alabel(label: str) -> bytes: + try: + label_bytes = label.encode('ascii') + ulabel(label_bytes) + if not valid_label_length(label_bytes): + raise IDNAError('Label too long') + return label_bytes + except UnicodeEncodeError: + pass + + check_label(label) + label_bytes = _alabel_prefix + _punycode(label) + + if not valid_label_length(label_bytes): + raise IDNAError('Label too long') + + return label_bytes + + +def ulabel(label: Union[str, bytes, bytearray]) -> str: + if not isinstance(label, (bytes, bytearray)): + try: + label_bytes = label.encode('ascii') + except UnicodeEncodeError: + check_label(label) + return label + else: + label_bytes = label + + label_bytes = label_bytes.lower() + if label_bytes.startswith(_alabel_prefix): + label_bytes = label_bytes[len(_alabel_prefix):] + if not label_bytes: + raise IDNAError('Malformed A-label, no Punycode eligible content found') + if label_bytes.decode('ascii')[-1] == '-': + raise IDNAError('A-label must not end with a hyphen') + else: + check_label(label_bytes) + return label_bytes.decode('ascii') + + try: + label = label_bytes.decode('punycode') + except UnicodeError: + raise IDNAError('Invalid A-label') + check_label(label) + return label + + +def uts46_remap(domain: str, std3_rules: bool = True, transitional: bool = False) -> str: + """Re-map the characters in the string according to UTS46 processing.""" + from .uts46data import uts46data + output = '' + + for pos, char in enumerate(domain): + code_point = ord(char) + try: + uts46row = uts46data[code_point if code_point < 256 else + bisect.bisect_left(uts46data, (code_point, 'Z')) - 1] + status = uts46row[1] + replacement = None # type: Optional[str] + if len(uts46row) == 3: + replacement = uts46row[2] + if (status == 'V' or + (status == 'D' and not transitional) or + (status == '3' and not std3_rules and replacement is None)): + output += char + elif replacement is not None and (status == 'M' or + (status == '3' and not std3_rules) or + (status == 'D' and transitional)): + output += replacement + elif status != 'I': + raise IndexError() + except IndexError: + raise InvalidCodepoint( + 'Codepoint {} not allowed at position {} in {}'.format( + _unot(code_point), pos + 1, repr(domain))) + + return unicodedata.normalize('NFC', output) + + +def encode(s: Union[str, bytes, bytearray], strict: bool = False, uts46: bool = False, std3_rules: bool = False, transitional: bool = False) -> bytes: + if not isinstance(s, str): + try: + s = str(s, 'ascii') + except UnicodeDecodeError: + raise IDNAError('should pass a unicode string to the function rather than a byte string.') + if uts46: + s = uts46_remap(s, std3_rules, transitional) + trailing_dot = False + result = [] + if strict: + labels = s.split('.') + else: + labels = _unicode_dots_re.split(s) + if not labels or labels == ['']: + raise IDNAError('Empty domain') + if labels[-1] == '': + del labels[-1] + trailing_dot = True + for label in labels: + s = alabel(label) + if s: + result.append(s) + else: + raise IDNAError('Empty label') + if trailing_dot: + result.append(b'') + s = b'.'.join(result) + if not valid_string_length(s, trailing_dot): + raise IDNAError('Domain too long') + return s + + +def decode(s: Union[str, bytes, bytearray], strict: bool = False, uts46: bool = False, std3_rules: bool = False) -> str: + try: + if not isinstance(s, str): + s = str(s, 'ascii') + except UnicodeDecodeError: + raise IDNAError('Invalid ASCII in A-label') + if uts46: + s = uts46_remap(s, std3_rules, False) + trailing_dot = False + result = [] + if not strict: + labels = _unicode_dots_re.split(s) + else: + labels = s.split('.') + if not labels or labels == ['']: + raise IDNAError('Empty domain') + if not labels[-1]: + del labels[-1] + trailing_dot = True + for label in labels: + s = ulabel(label) + if s: + result.append(s) + else: + raise IDNAError('Empty label') + if trailing_dot: + result.append('') + return '.'.join(result) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/idna/idnadata.py b/.venv/lib/python3.12/site-packages/pip/_vendor/idna/idnadata.py new file mode 100644 index 0000000..c61dcf9 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/idna/idnadata.py @@ -0,0 +1,4245 @@ +# This file is automatically generated by tools/idna-data + +__version__ = '15.1.0' +scripts = { + 'Greek': ( + 0x37000000374, + 0x37500000378, + 0x37a0000037e, + 0x37f00000380, + 0x38400000385, + 0x38600000387, + 0x3880000038b, + 0x38c0000038d, + 0x38e000003a2, + 0x3a3000003e2, + 0x3f000000400, + 0x1d2600001d2b, + 0x1d5d00001d62, + 0x1d6600001d6b, + 0x1dbf00001dc0, + 0x1f0000001f16, + 0x1f1800001f1e, + 0x1f2000001f46, + 0x1f4800001f4e, + 0x1f5000001f58, + 0x1f5900001f5a, + 0x1f5b00001f5c, + 0x1f5d00001f5e, + 0x1f5f00001f7e, + 0x1f8000001fb5, + 0x1fb600001fc5, + 0x1fc600001fd4, + 0x1fd600001fdc, + 0x1fdd00001ff0, + 0x1ff200001ff5, + 0x1ff600001fff, + 0x212600002127, + 0xab650000ab66, + 0x101400001018f, + 0x101a0000101a1, + 0x1d2000001d246, + ), + 'Han': ( + 0x2e8000002e9a, + 0x2e9b00002ef4, + 0x2f0000002fd6, + 0x300500003006, + 0x300700003008, + 0x30210000302a, + 0x30380000303c, + 0x340000004dc0, + 0x4e000000a000, + 0xf9000000fa6e, + 0xfa700000fada, + 0x16fe200016fe4, + 0x16ff000016ff2, + 0x200000002a6e0, + 0x2a7000002b73a, + 0x2b7400002b81e, + 0x2b8200002cea2, + 0x2ceb00002ebe1, + 0x2ebf00002ee5e, + 0x2f8000002fa1e, + 0x300000003134b, + 0x31350000323b0, + ), + 'Hebrew': ( + 0x591000005c8, + 0x5d0000005eb, + 0x5ef000005f5, + 0xfb1d0000fb37, + 0xfb380000fb3d, + 0xfb3e0000fb3f, + 0xfb400000fb42, + 0xfb430000fb45, + 0xfb460000fb50, + ), + 'Hiragana': ( + 0x304100003097, + 0x309d000030a0, + 0x1b0010001b120, + 0x1b1320001b133, + 0x1b1500001b153, + 0x1f2000001f201, + ), + 'Katakana': ( + 0x30a1000030fb, + 0x30fd00003100, + 0x31f000003200, + 0x32d0000032ff, + 0x330000003358, + 0xff660000ff70, + 0xff710000ff9e, + 0x1aff00001aff4, + 0x1aff50001affc, + 0x1affd0001afff, + 0x1b0000001b001, + 0x1b1200001b123, + 0x1b1550001b156, + 0x1b1640001b168, + ), +} +joining_types = { + 0xad: 84, + 0x300: 84, + 0x301: 84, + 0x302: 84, + 0x303: 84, + 0x304: 84, + 0x305: 84, + 0x306: 84, + 0x307: 84, + 0x308: 84, + 0x309: 84, + 0x30a: 84, + 0x30b: 84, + 0x30c: 84, + 0x30d: 84, + 0x30e: 84, + 0x30f: 84, + 0x310: 84, + 0x311: 84, + 0x312: 84, + 0x313: 84, + 0x314: 84, + 0x315: 84, + 0x316: 84, + 0x317: 84, + 0x318: 84, + 0x319: 84, + 0x31a: 84, + 0x31b: 84, + 0x31c: 84, + 0x31d: 84, + 0x31e: 84, + 0x31f: 84, + 0x320: 84, + 0x321: 84, + 0x322: 84, + 0x323: 84, + 0x324: 84, + 0x325: 84, + 0x326: 84, + 0x327: 84, + 0x328: 84, + 0x329: 84, + 0x32a: 84, + 0x32b: 84, + 0x32c: 84, + 0x32d: 84, + 0x32e: 84, + 0x32f: 84, + 0x330: 84, + 0x331: 84, + 0x332: 84, + 0x333: 84, + 0x334: 84, + 0x335: 84, + 0x336: 84, + 0x337: 84, + 0x338: 84, + 0x339: 84, + 0x33a: 84, + 0x33b: 84, + 0x33c: 84, + 0x33d: 84, + 0x33e: 84, + 0x33f: 84, + 0x340: 84, + 0x341: 84, + 0x342: 84, + 0x343: 84, + 0x344: 84, + 0x345: 84, + 0x346: 84, + 0x347: 84, + 0x348: 84, + 0x349: 84, + 0x34a: 84, + 0x34b: 84, + 0x34c: 84, + 0x34d: 84, + 0x34e: 84, + 0x34f: 84, + 0x350: 84, + 0x351: 84, + 0x352: 84, + 0x353: 84, + 0x354: 84, + 0x355: 84, + 0x356: 84, + 0x357: 84, + 0x358: 84, + 0x359: 84, + 0x35a: 84, + 0x35b: 84, + 0x35c: 84, + 0x35d: 84, + 0x35e: 84, + 0x35f: 84, + 0x360: 84, + 0x361: 84, + 0x362: 84, + 0x363: 84, + 0x364: 84, + 0x365: 84, + 0x366: 84, + 0x367: 84, + 0x368: 84, + 0x369: 84, + 0x36a: 84, + 0x36b: 84, + 0x36c: 84, + 0x36d: 84, + 0x36e: 84, + 0x36f: 84, + 0x483: 84, + 0x484: 84, + 0x485: 84, + 0x486: 84, + 0x487: 84, + 0x488: 84, + 0x489: 84, + 0x591: 84, + 0x592: 84, + 0x593: 84, + 0x594: 84, + 0x595: 84, + 0x596: 84, + 0x597: 84, + 0x598: 84, + 0x599: 84, + 0x59a: 84, + 0x59b: 84, + 0x59c: 84, + 0x59d: 84, + 0x59e: 84, + 0x59f: 84, + 0x5a0: 84, + 0x5a1: 84, + 0x5a2: 84, + 0x5a3: 84, + 0x5a4: 84, + 0x5a5: 84, + 0x5a6: 84, + 0x5a7: 84, + 0x5a8: 84, + 0x5a9: 84, + 0x5aa: 84, + 0x5ab: 84, + 0x5ac: 84, + 0x5ad: 84, + 0x5ae: 84, + 0x5af: 84, + 0x5b0: 84, + 0x5b1: 84, + 0x5b2: 84, + 0x5b3: 84, + 0x5b4: 84, + 0x5b5: 84, + 0x5b6: 84, + 0x5b7: 84, + 0x5b8: 84, + 0x5b9: 84, + 0x5ba: 84, + 0x5bb: 84, + 0x5bc: 84, + 0x5bd: 84, + 0x5bf: 84, + 0x5c1: 84, + 0x5c2: 84, + 0x5c4: 84, + 0x5c5: 84, + 0x5c7: 84, + 0x610: 84, + 0x611: 84, + 0x612: 84, + 0x613: 84, + 0x614: 84, + 0x615: 84, + 0x616: 84, + 0x617: 84, + 0x618: 84, + 0x619: 84, + 0x61a: 84, + 0x61c: 84, + 0x620: 68, + 0x622: 82, + 0x623: 82, + 0x624: 82, + 0x625: 82, + 0x626: 68, + 0x627: 82, + 0x628: 68, + 0x629: 82, + 0x62a: 68, + 0x62b: 68, + 0x62c: 68, + 0x62d: 68, + 0x62e: 68, + 0x62f: 82, + 0x630: 82, + 0x631: 82, + 0x632: 82, + 0x633: 68, + 0x634: 68, + 0x635: 68, + 0x636: 68, + 0x637: 68, + 0x638: 68, + 0x639: 68, + 0x63a: 68, + 0x63b: 68, + 0x63c: 68, + 0x63d: 68, + 0x63e: 68, + 0x63f: 68, + 0x640: 67, + 0x641: 68, + 0x642: 68, + 0x643: 68, + 0x644: 68, + 0x645: 68, + 0x646: 68, + 0x647: 68, + 0x648: 82, + 0x649: 68, + 0x64a: 68, + 0x64b: 84, + 0x64c: 84, + 0x64d: 84, + 0x64e: 84, + 0x64f: 84, + 0x650: 84, + 0x651: 84, + 0x652: 84, + 0x653: 84, + 0x654: 84, + 0x655: 84, + 0x656: 84, + 0x657: 84, + 0x658: 84, + 0x659: 84, + 0x65a: 84, + 0x65b: 84, + 0x65c: 84, + 0x65d: 84, + 0x65e: 84, + 0x65f: 84, + 0x66e: 68, + 0x66f: 68, + 0x670: 84, + 0x671: 82, + 0x672: 82, + 0x673: 82, + 0x675: 82, + 0x676: 82, + 0x677: 82, + 0x678: 68, + 0x679: 68, + 0x67a: 68, + 0x67b: 68, + 0x67c: 68, + 0x67d: 68, + 0x67e: 68, + 0x67f: 68, + 0x680: 68, + 0x681: 68, + 0x682: 68, + 0x683: 68, + 0x684: 68, + 0x685: 68, + 0x686: 68, + 0x687: 68, + 0x688: 82, + 0x689: 82, + 0x68a: 82, + 0x68b: 82, + 0x68c: 82, + 0x68d: 82, + 0x68e: 82, + 0x68f: 82, + 0x690: 82, + 0x691: 82, + 0x692: 82, + 0x693: 82, + 0x694: 82, + 0x695: 82, + 0x696: 82, + 0x697: 82, + 0x698: 82, + 0x699: 82, + 0x69a: 68, + 0x69b: 68, + 0x69c: 68, + 0x69d: 68, + 0x69e: 68, + 0x69f: 68, + 0x6a0: 68, + 0x6a1: 68, + 0x6a2: 68, + 0x6a3: 68, + 0x6a4: 68, + 0x6a5: 68, + 0x6a6: 68, + 0x6a7: 68, + 0x6a8: 68, + 0x6a9: 68, + 0x6aa: 68, + 0x6ab: 68, + 0x6ac: 68, + 0x6ad: 68, + 0x6ae: 68, + 0x6af: 68, + 0x6b0: 68, + 0x6b1: 68, + 0x6b2: 68, + 0x6b3: 68, + 0x6b4: 68, + 0x6b5: 68, + 0x6b6: 68, + 0x6b7: 68, + 0x6b8: 68, + 0x6b9: 68, + 0x6ba: 68, + 0x6bb: 68, + 0x6bc: 68, + 0x6bd: 68, + 0x6be: 68, + 0x6bf: 68, + 0x6c0: 82, + 0x6c1: 68, + 0x6c2: 68, + 0x6c3: 82, + 0x6c4: 82, + 0x6c5: 82, + 0x6c6: 82, + 0x6c7: 82, + 0x6c8: 82, + 0x6c9: 82, + 0x6ca: 82, + 0x6cb: 82, + 0x6cc: 68, + 0x6cd: 82, + 0x6ce: 68, + 0x6cf: 82, + 0x6d0: 68, + 0x6d1: 68, + 0x6d2: 82, + 0x6d3: 82, + 0x6d5: 82, + 0x6d6: 84, + 0x6d7: 84, + 0x6d8: 84, + 0x6d9: 84, + 0x6da: 84, + 0x6db: 84, + 0x6dc: 84, + 0x6df: 84, + 0x6e0: 84, + 0x6e1: 84, + 0x6e2: 84, + 0x6e3: 84, + 0x6e4: 84, + 0x6e7: 84, + 0x6e8: 84, + 0x6ea: 84, + 0x6eb: 84, + 0x6ec: 84, + 0x6ed: 84, + 0x6ee: 82, + 0x6ef: 82, + 0x6fa: 68, + 0x6fb: 68, + 0x6fc: 68, + 0x6ff: 68, + 0x70f: 84, + 0x710: 82, + 0x711: 84, + 0x712: 68, + 0x713: 68, + 0x714: 68, + 0x715: 82, + 0x716: 82, + 0x717: 82, + 0x718: 82, + 0x719: 82, + 0x71a: 68, + 0x71b: 68, + 0x71c: 68, + 0x71d: 68, + 0x71e: 82, + 0x71f: 68, + 0x720: 68, + 0x721: 68, + 0x722: 68, + 0x723: 68, + 0x724: 68, + 0x725: 68, + 0x726: 68, + 0x727: 68, + 0x728: 82, + 0x729: 68, + 0x72a: 82, + 0x72b: 68, + 0x72c: 82, + 0x72d: 68, + 0x72e: 68, + 0x72f: 82, + 0x730: 84, + 0x731: 84, + 0x732: 84, + 0x733: 84, + 0x734: 84, + 0x735: 84, + 0x736: 84, + 0x737: 84, + 0x738: 84, + 0x739: 84, + 0x73a: 84, + 0x73b: 84, + 0x73c: 84, + 0x73d: 84, + 0x73e: 84, + 0x73f: 84, + 0x740: 84, + 0x741: 84, + 0x742: 84, + 0x743: 84, + 0x744: 84, + 0x745: 84, + 0x746: 84, + 0x747: 84, + 0x748: 84, + 0x749: 84, + 0x74a: 84, + 0x74d: 82, + 0x74e: 68, + 0x74f: 68, + 0x750: 68, + 0x751: 68, + 0x752: 68, + 0x753: 68, + 0x754: 68, + 0x755: 68, + 0x756: 68, + 0x757: 68, + 0x758: 68, + 0x759: 82, + 0x75a: 82, + 0x75b: 82, + 0x75c: 68, + 0x75d: 68, + 0x75e: 68, + 0x75f: 68, + 0x760: 68, + 0x761: 68, + 0x762: 68, + 0x763: 68, + 0x764: 68, + 0x765: 68, + 0x766: 68, + 0x767: 68, + 0x768: 68, + 0x769: 68, + 0x76a: 68, + 0x76b: 82, + 0x76c: 82, + 0x76d: 68, + 0x76e: 68, + 0x76f: 68, + 0x770: 68, + 0x771: 82, + 0x772: 68, + 0x773: 82, + 0x774: 82, + 0x775: 68, + 0x776: 68, + 0x777: 68, + 0x778: 82, + 0x779: 82, + 0x77a: 68, + 0x77b: 68, + 0x77c: 68, + 0x77d: 68, + 0x77e: 68, + 0x77f: 68, + 0x7a6: 84, + 0x7a7: 84, + 0x7a8: 84, + 0x7a9: 84, + 0x7aa: 84, + 0x7ab: 84, + 0x7ac: 84, + 0x7ad: 84, + 0x7ae: 84, + 0x7af: 84, + 0x7b0: 84, + 0x7ca: 68, + 0x7cb: 68, + 0x7cc: 68, + 0x7cd: 68, + 0x7ce: 68, + 0x7cf: 68, + 0x7d0: 68, + 0x7d1: 68, + 0x7d2: 68, + 0x7d3: 68, + 0x7d4: 68, + 0x7d5: 68, + 0x7d6: 68, + 0x7d7: 68, + 0x7d8: 68, + 0x7d9: 68, + 0x7da: 68, + 0x7db: 68, + 0x7dc: 68, + 0x7dd: 68, + 0x7de: 68, + 0x7df: 68, + 0x7e0: 68, + 0x7e1: 68, + 0x7e2: 68, + 0x7e3: 68, + 0x7e4: 68, + 0x7e5: 68, + 0x7e6: 68, + 0x7e7: 68, + 0x7e8: 68, + 0x7e9: 68, + 0x7ea: 68, + 0x7eb: 84, + 0x7ec: 84, + 0x7ed: 84, + 0x7ee: 84, + 0x7ef: 84, + 0x7f0: 84, + 0x7f1: 84, + 0x7f2: 84, + 0x7f3: 84, + 0x7fa: 67, + 0x7fd: 84, + 0x816: 84, + 0x817: 84, + 0x818: 84, + 0x819: 84, + 0x81b: 84, + 0x81c: 84, + 0x81d: 84, + 0x81e: 84, + 0x81f: 84, + 0x820: 84, + 0x821: 84, + 0x822: 84, + 0x823: 84, + 0x825: 84, + 0x826: 84, + 0x827: 84, + 0x829: 84, + 0x82a: 84, + 0x82b: 84, + 0x82c: 84, + 0x82d: 84, + 0x840: 82, + 0x841: 68, + 0x842: 68, + 0x843: 68, + 0x844: 68, + 0x845: 68, + 0x846: 82, + 0x847: 82, + 0x848: 68, + 0x849: 82, + 0x84a: 68, + 0x84b: 68, + 0x84c: 68, + 0x84d: 68, + 0x84e: 68, + 0x84f: 68, + 0x850: 68, + 0x851: 68, + 0x852: 68, + 0x853: 68, + 0x854: 82, + 0x855: 68, + 0x856: 82, + 0x857: 82, + 0x858: 82, + 0x859: 84, + 0x85a: 84, + 0x85b: 84, + 0x860: 68, + 0x862: 68, + 0x863: 68, + 0x864: 68, + 0x865: 68, + 0x867: 82, + 0x868: 68, + 0x869: 82, + 0x86a: 82, + 0x870: 82, + 0x871: 82, + 0x872: 82, + 0x873: 82, + 0x874: 82, + 0x875: 82, + 0x876: 82, + 0x877: 82, + 0x878: 82, + 0x879: 82, + 0x87a: 82, + 0x87b: 82, + 0x87c: 82, + 0x87d: 82, + 0x87e: 82, + 0x87f: 82, + 0x880: 82, + 0x881: 82, + 0x882: 82, + 0x883: 67, + 0x884: 67, + 0x885: 67, + 0x886: 68, + 0x889: 68, + 0x88a: 68, + 0x88b: 68, + 0x88c: 68, + 0x88d: 68, + 0x88e: 82, + 0x898: 84, + 0x899: 84, + 0x89a: 84, + 0x89b: 84, + 0x89c: 84, + 0x89d: 84, + 0x89e: 84, + 0x89f: 84, + 0x8a0: 68, + 0x8a1: 68, + 0x8a2: 68, + 0x8a3: 68, + 0x8a4: 68, + 0x8a5: 68, + 0x8a6: 68, + 0x8a7: 68, + 0x8a8: 68, + 0x8a9: 68, + 0x8aa: 82, + 0x8ab: 82, + 0x8ac: 82, + 0x8ae: 82, + 0x8af: 68, + 0x8b0: 68, + 0x8b1: 82, + 0x8b2: 82, + 0x8b3: 68, + 0x8b4: 68, + 0x8b5: 68, + 0x8b6: 68, + 0x8b7: 68, + 0x8b8: 68, + 0x8b9: 82, + 0x8ba: 68, + 0x8bb: 68, + 0x8bc: 68, + 0x8bd: 68, + 0x8be: 68, + 0x8bf: 68, + 0x8c0: 68, + 0x8c1: 68, + 0x8c2: 68, + 0x8c3: 68, + 0x8c4: 68, + 0x8c5: 68, + 0x8c6: 68, + 0x8c7: 68, + 0x8c8: 68, + 0x8ca: 84, + 0x8cb: 84, + 0x8cc: 84, + 0x8cd: 84, + 0x8ce: 84, + 0x8cf: 84, + 0x8d0: 84, + 0x8d1: 84, + 0x8d2: 84, + 0x8d3: 84, + 0x8d4: 84, + 0x8d5: 84, + 0x8d6: 84, + 0x8d7: 84, + 0x8d8: 84, + 0x8d9: 84, + 0x8da: 84, + 0x8db: 84, + 0x8dc: 84, + 0x8dd: 84, + 0x8de: 84, + 0x8df: 84, + 0x8e0: 84, + 0x8e1: 84, + 0x8e3: 84, + 0x8e4: 84, + 0x8e5: 84, + 0x8e6: 84, + 0x8e7: 84, + 0x8e8: 84, + 0x8e9: 84, + 0x8ea: 84, + 0x8eb: 84, + 0x8ec: 84, + 0x8ed: 84, + 0x8ee: 84, + 0x8ef: 84, + 0x8f0: 84, + 0x8f1: 84, + 0x8f2: 84, + 0x8f3: 84, + 0x8f4: 84, + 0x8f5: 84, + 0x8f6: 84, + 0x8f7: 84, + 0x8f8: 84, + 0x8f9: 84, + 0x8fa: 84, + 0x8fb: 84, + 0x8fc: 84, + 0x8fd: 84, + 0x8fe: 84, + 0x8ff: 84, + 0x900: 84, + 0x901: 84, + 0x902: 84, + 0x93a: 84, + 0x93c: 84, + 0x941: 84, + 0x942: 84, + 0x943: 84, + 0x944: 84, + 0x945: 84, + 0x946: 84, + 0x947: 84, + 0x948: 84, + 0x94d: 84, + 0x951: 84, + 0x952: 84, + 0x953: 84, + 0x954: 84, + 0x955: 84, + 0x956: 84, + 0x957: 84, + 0x962: 84, + 0x963: 84, + 0x981: 84, + 0x9bc: 84, + 0x9c1: 84, + 0x9c2: 84, + 0x9c3: 84, + 0x9c4: 84, + 0x9cd: 84, + 0x9e2: 84, + 0x9e3: 84, + 0x9fe: 84, + 0xa01: 84, + 0xa02: 84, + 0xa3c: 84, + 0xa41: 84, + 0xa42: 84, + 0xa47: 84, + 0xa48: 84, + 0xa4b: 84, + 0xa4c: 84, + 0xa4d: 84, + 0xa51: 84, + 0xa70: 84, + 0xa71: 84, + 0xa75: 84, + 0xa81: 84, + 0xa82: 84, + 0xabc: 84, + 0xac1: 84, + 0xac2: 84, + 0xac3: 84, + 0xac4: 84, + 0xac5: 84, + 0xac7: 84, + 0xac8: 84, + 0xacd: 84, + 0xae2: 84, + 0xae3: 84, + 0xafa: 84, + 0xafb: 84, + 0xafc: 84, + 0xafd: 84, + 0xafe: 84, + 0xaff: 84, + 0xb01: 84, + 0xb3c: 84, + 0xb3f: 84, + 0xb41: 84, + 0xb42: 84, + 0xb43: 84, + 0xb44: 84, + 0xb4d: 84, + 0xb55: 84, + 0xb56: 84, + 0xb62: 84, + 0xb63: 84, + 0xb82: 84, + 0xbc0: 84, + 0xbcd: 84, + 0xc00: 84, + 0xc04: 84, + 0xc3c: 84, + 0xc3e: 84, + 0xc3f: 84, + 0xc40: 84, + 0xc46: 84, + 0xc47: 84, + 0xc48: 84, + 0xc4a: 84, + 0xc4b: 84, + 0xc4c: 84, + 0xc4d: 84, + 0xc55: 84, + 0xc56: 84, + 0xc62: 84, + 0xc63: 84, + 0xc81: 84, + 0xcbc: 84, + 0xcbf: 84, + 0xcc6: 84, + 0xccc: 84, + 0xccd: 84, + 0xce2: 84, + 0xce3: 84, + 0xd00: 84, + 0xd01: 84, + 0xd3b: 84, + 0xd3c: 84, + 0xd41: 84, + 0xd42: 84, + 0xd43: 84, + 0xd44: 84, + 0xd4d: 84, + 0xd62: 84, + 0xd63: 84, + 0xd81: 84, + 0xdca: 84, + 0xdd2: 84, + 0xdd3: 84, + 0xdd4: 84, + 0xdd6: 84, + 0xe31: 84, + 0xe34: 84, + 0xe35: 84, + 0xe36: 84, + 0xe37: 84, + 0xe38: 84, + 0xe39: 84, + 0xe3a: 84, + 0xe47: 84, + 0xe48: 84, + 0xe49: 84, + 0xe4a: 84, + 0xe4b: 84, + 0xe4c: 84, + 0xe4d: 84, + 0xe4e: 84, + 0xeb1: 84, + 0xeb4: 84, + 0xeb5: 84, + 0xeb6: 84, + 0xeb7: 84, + 0xeb8: 84, + 0xeb9: 84, + 0xeba: 84, + 0xebb: 84, + 0xebc: 84, + 0xec8: 84, + 0xec9: 84, + 0xeca: 84, + 0xecb: 84, + 0xecc: 84, + 0xecd: 84, + 0xece: 84, + 0xf18: 84, + 0xf19: 84, + 0xf35: 84, + 0xf37: 84, + 0xf39: 84, + 0xf71: 84, + 0xf72: 84, + 0xf73: 84, + 0xf74: 84, + 0xf75: 84, + 0xf76: 84, + 0xf77: 84, + 0xf78: 84, + 0xf79: 84, + 0xf7a: 84, + 0xf7b: 84, + 0xf7c: 84, + 0xf7d: 84, + 0xf7e: 84, + 0xf80: 84, + 0xf81: 84, + 0xf82: 84, + 0xf83: 84, + 0xf84: 84, + 0xf86: 84, + 0xf87: 84, + 0xf8d: 84, + 0xf8e: 84, + 0xf8f: 84, + 0xf90: 84, + 0xf91: 84, + 0xf92: 84, + 0xf93: 84, + 0xf94: 84, + 0xf95: 84, + 0xf96: 84, + 0xf97: 84, + 0xf99: 84, + 0xf9a: 84, + 0xf9b: 84, + 0xf9c: 84, + 0xf9d: 84, + 0xf9e: 84, + 0xf9f: 84, + 0xfa0: 84, + 0xfa1: 84, + 0xfa2: 84, + 0xfa3: 84, + 0xfa4: 84, + 0xfa5: 84, + 0xfa6: 84, + 0xfa7: 84, + 0xfa8: 84, + 0xfa9: 84, + 0xfaa: 84, + 0xfab: 84, + 0xfac: 84, + 0xfad: 84, + 0xfae: 84, + 0xfaf: 84, + 0xfb0: 84, + 0xfb1: 84, + 0xfb2: 84, + 0xfb3: 84, + 0xfb4: 84, + 0xfb5: 84, + 0xfb6: 84, + 0xfb7: 84, + 0xfb8: 84, + 0xfb9: 84, + 0xfba: 84, + 0xfbb: 84, + 0xfbc: 84, + 0xfc6: 84, + 0x102d: 84, + 0x102e: 84, + 0x102f: 84, + 0x1030: 84, + 0x1032: 84, + 0x1033: 84, + 0x1034: 84, + 0x1035: 84, + 0x1036: 84, + 0x1037: 84, + 0x1039: 84, + 0x103a: 84, + 0x103d: 84, + 0x103e: 84, + 0x1058: 84, + 0x1059: 84, + 0x105e: 84, + 0x105f: 84, + 0x1060: 84, + 0x1071: 84, + 0x1072: 84, + 0x1073: 84, + 0x1074: 84, + 0x1082: 84, + 0x1085: 84, + 0x1086: 84, + 0x108d: 84, + 0x109d: 84, + 0x135d: 84, + 0x135e: 84, + 0x135f: 84, + 0x1712: 84, + 0x1713: 84, + 0x1714: 84, + 0x1732: 84, + 0x1733: 84, + 0x1752: 84, + 0x1753: 84, + 0x1772: 84, + 0x1773: 84, + 0x17b4: 84, + 0x17b5: 84, + 0x17b7: 84, + 0x17b8: 84, + 0x17b9: 84, + 0x17ba: 84, + 0x17bb: 84, + 0x17bc: 84, + 0x17bd: 84, + 0x17c6: 84, + 0x17c9: 84, + 0x17ca: 84, + 0x17cb: 84, + 0x17cc: 84, + 0x17cd: 84, + 0x17ce: 84, + 0x17cf: 84, + 0x17d0: 84, + 0x17d1: 84, + 0x17d2: 84, + 0x17d3: 84, + 0x17dd: 84, + 0x1807: 68, + 0x180a: 67, + 0x180b: 84, + 0x180c: 84, + 0x180d: 84, + 0x180f: 84, + 0x1820: 68, + 0x1821: 68, + 0x1822: 68, + 0x1823: 68, + 0x1824: 68, + 0x1825: 68, + 0x1826: 68, + 0x1827: 68, + 0x1828: 68, + 0x1829: 68, + 0x182a: 68, + 0x182b: 68, + 0x182c: 68, + 0x182d: 68, + 0x182e: 68, + 0x182f: 68, + 0x1830: 68, + 0x1831: 68, + 0x1832: 68, + 0x1833: 68, + 0x1834: 68, + 0x1835: 68, + 0x1836: 68, + 0x1837: 68, + 0x1838: 68, + 0x1839: 68, + 0x183a: 68, + 0x183b: 68, + 0x183c: 68, + 0x183d: 68, + 0x183e: 68, + 0x183f: 68, + 0x1840: 68, + 0x1841: 68, + 0x1842: 68, + 0x1843: 68, + 0x1844: 68, + 0x1845: 68, + 0x1846: 68, + 0x1847: 68, + 0x1848: 68, + 0x1849: 68, + 0x184a: 68, + 0x184b: 68, + 0x184c: 68, + 0x184d: 68, + 0x184e: 68, + 0x184f: 68, + 0x1850: 68, + 0x1851: 68, + 0x1852: 68, + 0x1853: 68, + 0x1854: 68, + 0x1855: 68, + 0x1856: 68, + 0x1857: 68, + 0x1858: 68, + 0x1859: 68, + 0x185a: 68, + 0x185b: 68, + 0x185c: 68, + 0x185d: 68, + 0x185e: 68, + 0x185f: 68, + 0x1860: 68, + 0x1861: 68, + 0x1862: 68, + 0x1863: 68, + 0x1864: 68, + 0x1865: 68, + 0x1866: 68, + 0x1867: 68, + 0x1868: 68, + 0x1869: 68, + 0x186a: 68, + 0x186b: 68, + 0x186c: 68, + 0x186d: 68, + 0x186e: 68, + 0x186f: 68, + 0x1870: 68, + 0x1871: 68, + 0x1872: 68, + 0x1873: 68, + 0x1874: 68, + 0x1875: 68, + 0x1876: 68, + 0x1877: 68, + 0x1878: 68, + 0x1885: 84, + 0x1886: 84, + 0x1887: 68, + 0x1888: 68, + 0x1889: 68, + 0x188a: 68, + 0x188b: 68, + 0x188c: 68, + 0x188d: 68, + 0x188e: 68, + 0x188f: 68, + 0x1890: 68, + 0x1891: 68, + 0x1892: 68, + 0x1893: 68, + 0x1894: 68, + 0x1895: 68, + 0x1896: 68, + 0x1897: 68, + 0x1898: 68, + 0x1899: 68, + 0x189a: 68, + 0x189b: 68, + 0x189c: 68, + 0x189d: 68, + 0x189e: 68, + 0x189f: 68, + 0x18a0: 68, + 0x18a1: 68, + 0x18a2: 68, + 0x18a3: 68, + 0x18a4: 68, + 0x18a5: 68, + 0x18a6: 68, + 0x18a7: 68, + 0x18a8: 68, + 0x18a9: 84, + 0x18aa: 68, + 0x1920: 84, + 0x1921: 84, + 0x1922: 84, + 0x1927: 84, + 0x1928: 84, + 0x1932: 84, + 0x1939: 84, + 0x193a: 84, + 0x193b: 84, + 0x1a17: 84, + 0x1a18: 84, + 0x1a1b: 84, + 0x1a56: 84, + 0x1a58: 84, + 0x1a59: 84, + 0x1a5a: 84, + 0x1a5b: 84, + 0x1a5c: 84, + 0x1a5d: 84, + 0x1a5e: 84, + 0x1a60: 84, + 0x1a62: 84, + 0x1a65: 84, + 0x1a66: 84, + 0x1a67: 84, + 0x1a68: 84, + 0x1a69: 84, + 0x1a6a: 84, + 0x1a6b: 84, + 0x1a6c: 84, + 0x1a73: 84, + 0x1a74: 84, + 0x1a75: 84, + 0x1a76: 84, + 0x1a77: 84, + 0x1a78: 84, + 0x1a79: 84, + 0x1a7a: 84, + 0x1a7b: 84, + 0x1a7c: 84, + 0x1a7f: 84, + 0x1ab0: 84, + 0x1ab1: 84, + 0x1ab2: 84, + 0x1ab3: 84, + 0x1ab4: 84, + 0x1ab5: 84, + 0x1ab6: 84, + 0x1ab7: 84, + 0x1ab8: 84, + 0x1ab9: 84, + 0x1aba: 84, + 0x1abb: 84, + 0x1abc: 84, + 0x1abd: 84, + 0x1abe: 84, + 0x1abf: 84, + 0x1ac0: 84, + 0x1ac1: 84, + 0x1ac2: 84, + 0x1ac3: 84, + 0x1ac4: 84, + 0x1ac5: 84, + 0x1ac6: 84, + 0x1ac7: 84, + 0x1ac8: 84, + 0x1ac9: 84, + 0x1aca: 84, + 0x1acb: 84, + 0x1acc: 84, + 0x1acd: 84, + 0x1ace: 84, + 0x1b00: 84, + 0x1b01: 84, + 0x1b02: 84, + 0x1b03: 84, + 0x1b34: 84, + 0x1b36: 84, + 0x1b37: 84, + 0x1b38: 84, + 0x1b39: 84, + 0x1b3a: 84, + 0x1b3c: 84, + 0x1b42: 84, + 0x1b6b: 84, + 0x1b6c: 84, + 0x1b6d: 84, + 0x1b6e: 84, + 0x1b6f: 84, + 0x1b70: 84, + 0x1b71: 84, + 0x1b72: 84, + 0x1b73: 84, + 0x1b80: 84, + 0x1b81: 84, + 0x1ba2: 84, + 0x1ba3: 84, + 0x1ba4: 84, + 0x1ba5: 84, + 0x1ba8: 84, + 0x1ba9: 84, + 0x1bab: 84, + 0x1bac: 84, + 0x1bad: 84, + 0x1be6: 84, + 0x1be8: 84, + 0x1be9: 84, + 0x1bed: 84, + 0x1bef: 84, + 0x1bf0: 84, + 0x1bf1: 84, + 0x1c2c: 84, + 0x1c2d: 84, + 0x1c2e: 84, + 0x1c2f: 84, + 0x1c30: 84, + 0x1c31: 84, + 0x1c32: 84, + 0x1c33: 84, + 0x1c36: 84, + 0x1c37: 84, + 0x1cd0: 84, + 0x1cd1: 84, + 0x1cd2: 84, + 0x1cd4: 84, + 0x1cd5: 84, + 0x1cd6: 84, + 0x1cd7: 84, + 0x1cd8: 84, + 0x1cd9: 84, + 0x1cda: 84, + 0x1cdb: 84, + 0x1cdc: 84, + 0x1cdd: 84, + 0x1cde: 84, + 0x1cdf: 84, + 0x1ce0: 84, + 0x1ce2: 84, + 0x1ce3: 84, + 0x1ce4: 84, + 0x1ce5: 84, + 0x1ce6: 84, + 0x1ce7: 84, + 0x1ce8: 84, + 0x1ced: 84, + 0x1cf4: 84, + 0x1cf8: 84, + 0x1cf9: 84, + 0x1dc0: 84, + 0x1dc1: 84, + 0x1dc2: 84, + 0x1dc3: 84, + 0x1dc4: 84, + 0x1dc5: 84, + 0x1dc6: 84, + 0x1dc7: 84, + 0x1dc8: 84, + 0x1dc9: 84, + 0x1dca: 84, + 0x1dcb: 84, + 0x1dcc: 84, + 0x1dcd: 84, + 0x1dce: 84, + 0x1dcf: 84, + 0x1dd0: 84, + 0x1dd1: 84, + 0x1dd2: 84, + 0x1dd3: 84, + 0x1dd4: 84, + 0x1dd5: 84, + 0x1dd6: 84, + 0x1dd7: 84, + 0x1dd8: 84, + 0x1dd9: 84, + 0x1dda: 84, + 0x1ddb: 84, + 0x1ddc: 84, + 0x1ddd: 84, + 0x1dde: 84, + 0x1ddf: 84, + 0x1de0: 84, + 0x1de1: 84, + 0x1de2: 84, + 0x1de3: 84, + 0x1de4: 84, + 0x1de5: 84, + 0x1de6: 84, + 0x1de7: 84, + 0x1de8: 84, + 0x1de9: 84, + 0x1dea: 84, + 0x1deb: 84, + 0x1dec: 84, + 0x1ded: 84, + 0x1dee: 84, + 0x1def: 84, + 0x1df0: 84, + 0x1df1: 84, + 0x1df2: 84, + 0x1df3: 84, + 0x1df4: 84, + 0x1df5: 84, + 0x1df6: 84, + 0x1df7: 84, + 0x1df8: 84, + 0x1df9: 84, + 0x1dfa: 84, + 0x1dfb: 84, + 0x1dfc: 84, + 0x1dfd: 84, + 0x1dfe: 84, + 0x1dff: 84, + 0x200b: 84, + 0x200d: 67, + 0x200e: 84, + 0x200f: 84, + 0x202a: 84, + 0x202b: 84, + 0x202c: 84, + 0x202d: 84, + 0x202e: 84, + 0x2060: 84, + 0x2061: 84, + 0x2062: 84, + 0x2063: 84, + 0x2064: 84, + 0x206a: 84, + 0x206b: 84, + 0x206c: 84, + 0x206d: 84, + 0x206e: 84, + 0x206f: 84, + 0x20d0: 84, + 0x20d1: 84, + 0x20d2: 84, + 0x20d3: 84, + 0x20d4: 84, + 0x20d5: 84, + 0x20d6: 84, + 0x20d7: 84, + 0x20d8: 84, + 0x20d9: 84, + 0x20da: 84, + 0x20db: 84, + 0x20dc: 84, + 0x20dd: 84, + 0x20de: 84, + 0x20df: 84, + 0x20e0: 84, + 0x20e1: 84, + 0x20e2: 84, + 0x20e3: 84, + 0x20e4: 84, + 0x20e5: 84, + 0x20e6: 84, + 0x20e7: 84, + 0x20e8: 84, + 0x20e9: 84, + 0x20ea: 84, + 0x20eb: 84, + 0x20ec: 84, + 0x20ed: 84, + 0x20ee: 84, + 0x20ef: 84, + 0x20f0: 84, + 0x2cef: 84, + 0x2cf0: 84, + 0x2cf1: 84, + 0x2d7f: 84, + 0x2de0: 84, + 0x2de1: 84, + 0x2de2: 84, + 0x2de3: 84, + 0x2de4: 84, + 0x2de5: 84, + 0x2de6: 84, + 0x2de7: 84, + 0x2de8: 84, + 0x2de9: 84, + 0x2dea: 84, + 0x2deb: 84, + 0x2dec: 84, + 0x2ded: 84, + 0x2dee: 84, + 0x2def: 84, + 0x2df0: 84, + 0x2df1: 84, + 0x2df2: 84, + 0x2df3: 84, + 0x2df4: 84, + 0x2df5: 84, + 0x2df6: 84, + 0x2df7: 84, + 0x2df8: 84, + 0x2df9: 84, + 0x2dfa: 84, + 0x2dfb: 84, + 0x2dfc: 84, + 0x2dfd: 84, + 0x2dfe: 84, + 0x2dff: 84, + 0x302a: 84, + 0x302b: 84, + 0x302c: 84, + 0x302d: 84, + 0x3099: 84, + 0x309a: 84, + 0xa66f: 84, + 0xa670: 84, + 0xa671: 84, + 0xa672: 84, + 0xa674: 84, + 0xa675: 84, + 0xa676: 84, + 0xa677: 84, + 0xa678: 84, + 0xa679: 84, + 0xa67a: 84, + 0xa67b: 84, + 0xa67c: 84, + 0xa67d: 84, + 0xa69e: 84, + 0xa69f: 84, + 0xa6f0: 84, + 0xa6f1: 84, + 0xa802: 84, + 0xa806: 84, + 0xa80b: 84, + 0xa825: 84, + 0xa826: 84, + 0xa82c: 84, + 0xa840: 68, + 0xa841: 68, + 0xa842: 68, + 0xa843: 68, + 0xa844: 68, + 0xa845: 68, + 0xa846: 68, + 0xa847: 68, + 0xa848: 68, + 0xa849: 68, + 0xa84a: 68, + 0xa84b: 68, + 0xa84c: 68, + 0xa84d: 68, + 0xa84e: 68, + 0xa84f: 68, + 0xa850: 68, + 0xa851: 68, + 0xa852: 68, + 0xa853: 68, + 0xa854: 68, + 0xa855: 68, + 0xa856: 68, + 0xa857: 68, + 0xa858: 68, + 0xa859: 68, + 0xa85a: 68, + 0xa85b: 68, + 0xa85c: 68, + 0xa85d: 68, + 0xa85e: 68, + 0xa85f: 68, + 0xa860: 68, + 0xa861: 68, + 0xa862: 68, + 0xa863: 68, + 0xa864: 68, + 0xa865: 68, + 0xa866: 68, + 0xa867: 68, + 0xa868: 68, + 0xa869: 68, + 0xa86a: 68, + 0xa86b: 68, + 0xa86c: 68, + 0xa86d: 68, + 0xa86e: 68, + 0xa86f: 68, + 0xa870: 68, + 0xa871: 68, + 0xa872: 76, + 0xa8c4: 84, + 0xa8c5: 84, + 0xa8e0: 84, + 0xa8e1: 84, + 0xa8e2: 84, + 0xa8e3: 84, + 0xa8e4: 84, + 0xa8e5: 84, + 0xa8e6: 84, + 0xa8e7: 84, + 0xa8e8: 84, + 0xa8e9: 84, + 0xa8ea: 84, + 0xa8eb: 84, + 0xa8ec: 84, + 0xa8ed: 84, + 0xa8ee: 84, + 0xa8ef: 84, + 0xa8f0: 84, + 0xa8f1: 84, + 0xa8ff: 84, + 0xa926: 84, + 0xa927: 84, + 0xa928: 84, + 0xa929: 84, + 0xa92a: 84, + 0xa92b: 84, + 0xa92c: 84, + 0xa92d: 84, + 0xa947: 84, + 0xa948: 84, + 0xa949: 84, + 0xa94a: 84, + 0xa94b: 84, + 0xa94c: 84, + 0xa94d: 84, + 0xa94e: 84, + 0xa94f: 84, + 0xa950: 84, + 0xa951: 84, + 0xa980: 84, + 0xa981: 84, + 0xa982: 84, + 0xa9b3: 84, + 0xa9b6: 84, + 0xa9b7: 84, + 0xa9b8: 84, + 0xa9b9: 84, + 0xa9bc: 84, + 0xa9bd: 84, + 0xa9e5: 84, + 0xaa29: 84, + 0xaa2a: 84, + 0xaa2b: 84, + 0xaa2c: 84, + 0xaa2d: 84, + 0xaa2e: 84, + 0xaa31: 84, + 0xaa32: 84, + 0xaa35: 84, + 0xaa36: 84, + 0xaa43: 84, + 0xaa4c: 84, + 0xaa7c: 84, + 0xaab0: 84, + 0xaab2: 84, + 0xaab3: 84, + 0xaab4: 84, + 0xaab7: 84, + 0xaab8: 84, + 0xaabe: 84, + 0xaabf: 84, + 0xaac1: 84, + 0xaaec: 84, + 0xaaed: 84, + 0xaaf6: 84, + 0xabe5: 84, + 0xabe8: 84, + 0xabed: 84, + 0xfb1e: 84, + 0xfe00: 84, + 0xfe01: 84, + 0xfe02: 84, + 0xfe03: 84, + 0xfe04: 84, + 0xfe05: 84, + 0xfe06: 84, + 0xfe07: 84, + 0xfe08: 84, + 0xfe09: 84, + 0xfe0a: 84, + 0xfe0b: 84, + 0xfe0c: 84, + 0xfe0d: 84, + 0xfe0e: 84, + 0xfe0f: 84, + 0xfe20: 84, + 0xfe21: 84, + 0xfe22: 84, + 0xfe23: 84, + 0xfe24: 84, + 0xfe25: 84, + 0xfe26: 84, + 0xfe27: 84, + 0xfe28: 84, + 0xfe29: 84, + 0xfe2a: 84, + 0xfe2b: 84, + 0xfe2c: 84, + 0xfe2d: 84, + 0xfe2e: 84, + 0xfe2f: 84, + 0xfeff: 84, + 0xfff9: 84, + 0xfffa: 84, + 0xfffb: 84, + 0x101fd: 84, + 0x102e0: 84, + 0x10376: 84, + 0x10377: 84, + 0x10378: 84, + 0x10379: 84, + 0x1037a: 84, + 0x10a01: 84, + 0x10a02: 84, + 0x10a03: 84, + 0x10a05: 84, + 0x10a06: 84, + 0x10a0c: 84, + 0x10a0d: 84, + 0x10a0e: 84, + 0x10a0f: 84, + 0x10a38: 84, + 0x10a39: 84, + 0x10a3a: 84, + 0x10a3f: 84, + 0x10ac0: 68, + 0x10ac1: 68, + 0x10ac2: 68, + 0x10ac3: 68, + 0x10ac4: 68, + 0x10ac5: 82, + 0x10ac7: 82, + 0x10ac9: 82, + 0x10aca: 82, + 0x10acd: 76, + 0x10ace: 82, + 0x10acf: 82, + 0x10ad0: 82, + 0x10ad1: 82, + 0x10ad2: 82, + 0x10ad3: 68, + 0x10ad4: 68, + 0x10ad5: 68, + 0x10ad6: 68, + 0x10ad7: 76, + 0x10ad8: 68, + 0x10ad9: 68, + 0x10ada: 68, + 0x10adb: 68, + 0x10adc: 68, + 0x10add: 82, + 0x10ade: 68, + 0x10adf: 68, + 0x10ae0: 68, + 0x10ae1: 82, + 0x10ae4: 82, + 0x10ae5: 84, + 0x10ae6: 84, + 0x10aeb: 68, + 0x10aec: 68, + 0x10aed: 68, + 0x10aee: 68, + 0x10aef: 82, + 0x10b80: 68, + 0x10b81: 82, + 0x10b82: 68, + 0x10b83: 82, + 0x10b84: 82, + 0x10b85: 82, + 0x10b86: 68, + 0x10b87: 68, + 0x10b88: 68, + 0x10b89: 82, + 0x10b8a: 68, + 0x10b8b: 68, + 0x10b8c: 82, + 0x10b8d: 68, + 0x10b8e: 82, + 0x10b8f: 82, + 0x10b90: 68, + 0x10b91: 82, + 0x10ba9: 82, + 0x10baa: 82, + 0x10bab: 82, + 0x10bac: 82, + 0x10bad: 68, + 0x10bae: 68, + 0x10d00: 76, + 0x10d01: 68, + 0x10d02: 68, + 0x10d03: 68, + 0x10d04: 68, + 0x10d05: 68, + 0x10d06: 68, + 0x10d07: 68, + 0x10d08: 68, + 0x10d09: 68, + 0x10d0a: 68, + 0x10d0b: 68, + 0x10d0c: 68, + 0x10d0d: 68, + 0x10d0e: 68, + 0x10d0f: 68, + 0x10d10: 68, + 0x10d11: 68, + 0x10d12: 68, + 0x10d13: 68, + 0x10d14: 68, + 0x10d15: 68, + 0x10d16: 68, + 0x10d17: 68, + 0x10d18: 68, + 0x10d19: 68, + 0x10d1a: 68, + 0x10d1b: 68, + 0x10d1c: 68, + 0x10d1d: 68, + 0x10d1e: 68, + 0x10d1f: 68, + 0x10d20: 68, + 0x10d21: 68, + 0x10d22: 82, + 0x10d23: 68, + 0x10d24: 84, + 0x10d25: 84, + 0x10d26: 84, + 0x10d27: 84, + 0x10eab: 84, + 0x10eac: 84, + 0x10efd: 84, + 0x10efe: 84, + 0x10eff: 84, + 0x10f30: 68, + 0x10f31: 68, + 0x10f32: 68, + 0x10f33: 82, + 0x10f34: 68, + 0x10f35: 68, + 0x10f36: 68, + 0x10f37: 68, + 0x10f38: 68, + 0x10f39: 68, + 0x10f3a: 68, + 0x10f3b: 68, + 0x10f3c: 68, + 0x10f3d: 68, + 0x10f3e: 68, + 0x10f3f: 68, + 0x10f40: 68, + 0x10f41: 68, + 0x10f42: 68, + 0x10f43: 68, + 0x10f44: 68, + 0x10f46: 84, + 0x10f47: 84, + 0x10f48: 84, + 0x10f49: 84, + 0x10f4a: 84, + 0x10f4b: 84, + 0x10f4c: 84, + 0x10f4d: 84, + 0x10f4e: 84, + 0x10f4f: 84, + 0x10f50: 84, + 0x10f51: 68, + 0x10f52: 68, + 0x10f53: 68, + 0x10f54: 82, + 0x10f70: 68, + 0x10f71: 68, + 0x10f72: 68, + 0x10f73: 68, + 0x10f74: 82, + 0x10f75: 82, + 0x10f76: 68, + 0x10f77: 68, + 0x10f78: 68, + 0x10f79: 68, + 0x10f7a: 68, + 0x10f7b: 68, + 0x10f7c: 68, + 0x10f7d: 68, + 0x10f7e: 68, + 0x10f7f: 68, + 0x10f80: 68, + 0x10f81: 68, + 0x10f82: 84, + 0x10f83: 84, + 0x10f84: 84, + 0x10f85: 84, + 0x10fb0: 68, + 0x10fb2: 68, + 0x10fb3: 68, + 0x10fb4: 82, + 0x10fb5: 82, + 0x10fb6: 82, + 0x10fb8: 68, + 0x10fb9: 82, + 0x10fba: 82, + 0x10fbb: 68, + 0x10fbc: 68, + 0x10fbd: 82, + 0x10fbe: 68, + 0x10fbf: 68, + 0x10fc1: 68, + 0x10fc2: 82, + 0x10fc3: 82, + 0x10fc4: 68, + 0x10fc9: 82, + 0x10fca: 68, + 0x10fcb: 76, + 0x11001: 84, + 0x11038: 84, + 0x11039: 84, + 0x1103a: 84, + 0x1103b: 84, + 0x1103c: 84, + 0x1103d: 84, + 0x1103e: 84, + 0x1103f: 84, + 0x11040: 84, + 0x11041: 84, + 0x11042: 84, + 0x11043: 84, + 0x11044: 84, + 0x11045: 84, + 0x11046: 84, + 0x11070: 84, + 0x11073: 84, + 0x11074: 84, + 0x1107f: 84, + 0x11080: 84, + 0x11081: 84, + 0x110b3: 84, + 0x110b4: 84, + 0x110b5: 84, + 0x110b6: 84, + 0x110b9: 84, + 0x110ba: 84, + 0x110c2: 84, + 0x11100: 84, + 0x11101: 84, + 0x11102: 84, + 0x11127: 84, + 0x11128: 84, + 0x11129: 84, + 0x1112a: 84, + 0x1112b: 84, + 0x1112d: 84, + 0x1112e: 84, + 0x1112f: 84, + 0x11130: 84, + 0x11131: 84, + 0x11132: 84, + 0x11133: 84, + 0x11134: 84, + 0x11173: 84, + 0x11180: 84, + 0x11181: 84, + 0x111b6: 84, + 0x111b7: 84, + 0x111b8: 84, + 0x111b9: 84, + 0x111ba: 84, + 0x111bb: 84, + 0x111bc: 84, + 0x111bd: 84, + 0x111be: 84, + 0x111c9: 84, + 0x111ca: 84, + 0x111cb: 84, + 0x111cc: 84, + 0x111cf: 84, + 0x1122f: 84, + 0x11230: 84, + 0x11231: 84, + 0x11234: 84, + 0x11236: 84, + 0x11237: 84, + 0x1123e: 84, + 0x11241: 84, + 0x112df: 84, + 0x112e3: 84, + 0x112e4: 84, + 0x112e5: 84, + 0x112e6: 84, + 0x112e7: 84, + 0x112e8: 84, + 0x112e9: 84, + 0x112ea: 84, + 0x11300: 84, + 0x11301: 84, + 0x1133b: 84, + 0x1133c: 84, + 0x11340: 84, + 0x11366: 84, + 0x11367: 84, + 0x11368: 84, + 0x11369: 84, + 0x1136a: 84, + 0x1136b: 84, + 0x1136c: 84, + 0x11370: 84, + 0x11371: 84, + 0x11372: 84, + 0x11373: 84, + 0x11374: 84, + 0x11438: 84, + 0x11439: 84, + 0x1143a: 84, + 0x1143b: 84, + 0x1143c: 84, + 0x1143d: 84, + 0x1143e: 84, + 0x1143f: 84, + 0x11442: 84, + 0x11443: 84, + 0x11444: 84, + 0x11446: 84, + 0x1145e: 84, + 0x114b3: 84, + 0x114b4: 84, + 0x114b5: 84, + 0x114b6: 84, + 0x114b7: 84, + 0x114b8: 84, + 0x114ba: 84, + 0x114bf: 84, + 0x114c0: 84, + 0x114c2: 84, + 0x114c3: 84, + 0x115b2: 84, + 0x115b3: 84, + 0x115b4: 84, + 0x115b5: 84, + 0x115bc: 84, + 0x115bd: 84, + 0x115bf: 84, + 0x115c0: 84, + 0x115dc: 84, + 0x115dd: 84, + 0x11633: 84, + 0x11634: 84, + 0x11635: 84, + 0x11636: 84, + 0x11637: 84, + 0x11638: 84, + 0x11639: 84, + 0x1163a: 84, + 0x1163d: 84, + 0x1163f: 84, + 0x11640: 84, + 0x116ab: 84, + 0x116ad: 84, + 0x116b0: 84, + 0x116b1: 84, + 0x116b2: 84, + 0x116b3: 84, + 0x116b4: 84, + 0x116b5: 84, + 0x116b7: 84, + 0x1171d: 84, + 0x1171e: 84, + 0x1171f: 84, + 0x11722: 84, + 0x11723: 84, + 0x11724: 84, + 0x11725: 84, + 0x11727: 84, + 0x11728: 84, + 0x11729: 84, + 0x1172a: 84, + 0x1172b: 84, + 0x1182f: 84, + 0x11830: 84, + 0x11831: 84, + 0x11832: 84, + 0x11833: 84, + 0x11834: 84, + 0x11835: 84, + 0x11836: 84, + 0x11837: 84, + 0x11839: 84, + 0x1183a: 84, + 0x1193b: 84, + 0x1193c: 84, + 0x1193e: 84, + 0x11943: 84, + 0x119d4: 84, + 0x119d5: 84, + 0x119d6: 84, + 0x119d7: 84, + 0x119da: 84, + 0x119db: 84, + 0x119e0: 84, + 0x11a01: 84, + 0x11a02: 84, + 0x11a03: 84, + 0x11a04: 84, + 0x11a05: 84, + 0x11a06: 84, + 0x11a07: 84, + 0x11a08: 84, + 0x11a09: 84, + 0x11a0a: 84, + 0x11a33: 84, + 0x11a34: 84, + 0x11a35: 84, + 0x11a36: 84, + 0x11a37: 84, + 0x11a38: 84, + 0x11a3b: 84, + 0x11a3c: 84, + 0x11a3d: 84, + 0x11a3e: 84, + 0x11a47: 84, + 0x11a51: 84, + 0x11a52: 84, + 0x11a53: 84, + 0x11a54: 84, + 0x11a55: 84, + 0x11a56: 84, + 0x11a59: 84, + 0x11a5a: 84, + 0x11a5b: 84, + 0x11a8a: 84, + 0x11a8b: 84, + 0x11a8c: 84, + 0x11a8d: 84, + 0x11a8e: 84, + 0x11a8f: 84, + 0x11a90: 84, + 0x11a91: 84, + 0x11a92: 84, + 0x11a93: 84, + 0x11a94: 84, + 0x11a95: 84, + 0x11a96: 84, + 0x11a98: 84, + 0x11a99: 84, + 0x11c30: 84, + 0x11c31: 84, + 0x11c32: 84, + 0x11c33: 84, + 0x11c34: 84, + 0x11c35: 84, + 0x11c36: 84, + 0x11c38: 84, + 0x11c39: 84, + 0x11c3a: 84, + 0x11c3b: 84, + 0x11c3c: 84, + 0x11c3d: 84, + 0x11c3f: 84, + 0x11c92: 84, + 0x11c93: 84, + 0x11c94: 84, + 0x11c95: 84, + 0x11c96: 84, + 0x11c97: 84, + 0x11c98: 84, + 0x11c99: 84, + 0x11c9a: 84, + 0x11c9b: 84, + 0x11c9c: 84, + 0x11c9d: 84, + 0x11c9e: 84, + 0x11c9f: 84, + 0x11ca0: 84, + 0x11ca1: 84, + 0x11ca2: 84, + 0x11ca3: 84, + 0x11ca4: 84, + 0x11ca5: 84, + 0x11ca6: 84, + 0x11ca7: 84, + 0x11caa: 84, + 0x11cab: 84, + 0x11cac: 84, + 0x11cad: 84, + 0x11cae: 84, + 0x11caf: 84, + 0x11cb0: 84, + 0x11cb2: 84, + 0x11cb3: 84, + 0x11cb5: 84, + 0x11cb6: 84, + 0x11d31: 84, + 0x11d32: 84, + 0x11d33: 84, + 0x11d34: 84, + 0x11d35: 84, + 0x11d36: 84, + 0x11d3a: 84, + 0x11d3c: 84, + 0x11d3d: 84, + 0x11d3f: 84, + 0x11d40: 84, + 0x11d41: 84, + 0x11d42: 84, + 0x11d43: 84, + 0x11d44: 84, + 0x11d45: 84, + 0x11d47: 84, + 0x11d90: 84, + 0x11d91: 84, + 0x11d95: 84, + 0x11d97: 84, + 0x11ef3: 84, + 0x11ef4: 84, + 0x11f00: 84, + 0x11f01: 84, + 0x11f36: 84, + 0x11f37: 84, + 0x11f38: 84, + 0x11f39: 84, + 0x11f3a: 84, + 0x11f40: 84, + 0x11f42: 84, + 0x13430: 84, + 0x13431: 84, + 0x13432: 84, + 0x13433: 84, + 0x13434: 84, + 0x13435: 84, + 0x13436: 84, + 0x13437: 84, + 0x13438: 84, + 0x13439: 84, + 0x1343a: 84, + 0x1343b: 84, + 0x1343c: 84, + 0x1343d: 84, + 0x1343e: 84, + 0x1343f: 84, + 0x13440: 84, + 0x13447: 84, + 0x13448: 84, + 0x13449: 84, + 0x1344a: 84, + 0x1344b: 84, + 0x1344c: 84, + 0x1344d: 84, + 0x1344e: 84, + 0x1344f: 84, + 0x13450: 84, + 0x13451: 84, + 0x13452: 84, + 0x13453: 84, + 0x13454: 84, + 0x13455: 84, + 0x16af0: 84, + 0x16af1: 84, + 0x16af2: 84, + 0x16af3: 84, + 0x16af4: 84, + 0x16b30: 84, + 0x16b31: 84, + 0x16b32: 84, + 0x16b33: 84, + 0x16b34: 84, + 0x16b35: 84, + 0x16b36: 84, + 0x16f4f: 84, + 0x16f8f: 84, + 0x16f90: 84, + 0x16f91: 84, + 0x16f92: 84, + 0x16fe4: 84, + 0x1bc9d: 84, + 0x1bc9e: 84, + 0x1bca0: 84, + 0x1bca1: 84, + 0x1bca2: 84, + 0x1bca3: 84, + 0x1cf00: 84, + 0x1cf01: 84, + 0x1cf02: 84, + 0x1cf03: 84, + 0x1cf04: 84, + 0x1cf05: 84, + 0x1cf06: 84, + 0x1cf07: 84, + 0x1cf08: 84, + 0x1cf09: 84, + 0x1cf0a: 84, + 0x1cf0b: 84, + 0x1cf0c: 84, + 0x1cf0d: 84, + 0x1cf0e: 84, + 0x1cf0f: 84, + 0x1cf10: 84, + 0x1cf11: 84, + 0x1cf12: 84, + 0x1cf13: 84, + 0x1cf14: 84, + 0x1cf15: 84, + 0x1cf16: 84, + 0x1cf17: 84, + 0x1cf18: 84, + 0x1cf19: 84, + 0x1cf1a: 84, + 0x1cf1b: 84, + 0x1cf1c: 84, + 0x1cf1d: 84, + 0x1cf1e: 84, + 0x1cf1f: 84, + 0x1cf20: 84, + 0x1cf21: 84, + 0x1cf22: 84, + 0x1cf23: 84, + 0x1cf24: 84, + 0x1cf25: 84, + 0x1cf26: 84, + 0x1cf27: 84, + 0x1cf28: 84, + 0x1cf29: 84, + 0x1cf2a: 84, + 0x1cf2b: 84, + 0x1cf2c: 84, + 0x1cf2d: 84, + 0x1cf30: 84, + 0x1cf31: 84, + 0x1cf32: 84, + 0x1cf33: 84, + 0x1cf34: 84, + 0x1cf35: 84, + 0x1cf36: 84, + 0x1cf37: 84, + 0x1cf38: 84, + 0x1cf39: 84, + 0x1cf3a: 84, + 0x1cf3b: 84, + 0x1cf3c: 84, + 0x1cf3d: 84, + 0x1cf3e: 84, + 0x1cf3f: 84, + 0x1cf40: 84, + 0x1cf41: 84, + 0x1cf42: 84, + 0x1cf43: 84, + 0x1cf44: 84, + 0x1cf45: 84, + 0x1cf46: 84, + 0x1d167: 84, + 0x1d168: 84, + 0x1d169: 84, + 0x1d173: 84, + 0x1d174: 84, + 0x1d175: 84, + 0x1d176: 84, + 0x1d177: 84, + 0x1d178: 84, + 0x1d179: 84, + 0x1d17a: 84, + 0x1d17b: 84, + 0x1d17c: 84, + 0x1d17d: 84, + 0x1d17e: 84, + 0x1d17f: 84, + 0x1d180: 84, + 0x1d181: 84, + 0x1d182: 84, + 0x1d185: 84, + 0x1d186: 84, + 0x1d187: 84, + 0x1d188: 84, + 0x1d189: 84, + 0x1d18a: 84, + 0x1d18b: 84, + 0x1d1aa: 84, + 0x1d1ab: 84, + 0x1d1ac: 84, + 0x1d1ad: 84, + 0x1d242: 84, + 0x1d243: 84, + 0x1d244: 84, + 0x1da00: 84, + 0x1da01: 84, + 0x1da02: 84, + 0x1da03: 84, + 0x1da04: 84, + 0x1da05: 84, + 0x1da06: 84, + 0x1da07: 84, + 0x1da08: 84, + 0x1da09: 84, + 0x1da0a: 84, + 0x1da0b: 84, + 0x1da0c: 84, + 0x1da0d: 84, + 0x1da0e: 84, + 0x1da0f: 84, + 0x1da10: 84, + 0x1da11: 84, + 0x1da12: 84, + 0x1da13: 84, + 0x1da14: 84, + 0x1da15: 84, + 0x1da16: 84, + 0x1da17: 84, + 0x1da18: 84, + 0x1da19: 84, + 0x1da1a: 84, + 0x1da1b: 84, + 0x1da1c: 84, + 0x1da1d: 84, + 0x1da1e: 84, + 0x1da1f: 84, + 0x1da20: 84, + 0x1da21: 84, + 0x1da22: 84, + 0x1da23: 84, + 0x1da24: 84, + 0x1da25: 84, + 0x1da26: 84, + 0x1da27: 84, + 0x1da28: 84, + 0x1da29: 84, + 0x1da2a: 84, + 0x1da2b: 84, + 0x1da2c: 84, + 0x1da2d: 84, + 0x1da2e: 84, + 0x1da2f: 84, + 0x1da30: 84, + 0x1da31: 84, + 0x1da32: 84, + 0x1da33: 84, + 0x1da34: 84, + 0x1da35: 84, + 0x1da36: 84, + 0x1da3b: 84, + 0x1da3c: 84, + 0x1da3d: 84, + 0x1da3e: 84, + 0x1da3f: 84, + 0x1da40: 84, + 0x1da41: 84, + 0x1da42: 84, + 0x1da43: 84, + 0x1da44: 84, + 0x1da45: 84, + 0x1da46: 84, + 0x1da47: 84, + 0x1da48: 84, + 0x1da49: 84, + 0x1da4a: 84, + 0x1da4b: 84, + 0x1da4c: 84, + 0x1da4d: 84, + 0x1da4e: 84, + 0x1da4f: 84, + 0x1da50: 84, + 0x1da51: 84, + 0x1da52: 84, + 0x1da53: 84, + 0x1da54: 84, + 0x1da55: 84, + 0x1da56: 84, + 0x1da57: 84, + 0x1da58: 84, + 0x1da59: 84, + 0x1da5a: 84, + 0x1da5b: 84, + 0x1da5c: 84, + 0x1da5d: 84, + 0x1da5e: 84, + 0x1da5f: 84, + 0x1da60: 84, + 0x1da61: 84, + 0x1da62: 84, + 0x1da63: 84, + 0x1da64: 84, + 0x1da65: 84, + 0x1da66: 84, + 0x1da67: 84, + 0x1da68: 84, + 0x1da69: 84, + 0x1da6a: 84, + 0x1da6b: 84, + 0x1da6c: 84, + 0x1da75: 84, + 0x1da84: 84, + 0x1da9b: 84, + 0x1da9c: 84, + 0x1da9d: 84, + 0x1da9e: 84, + 0x1da9f: 84, + 0x1daa1: 84, + 0x1daa2: 84, + 0x1daa3: 84, + 0x1daa4: 84, + 0x1daa5: 84, + 0x1daa6: 84, + 0x1daa7: 84, + 0x1daa8: 84, + 0x1daa9: 84, + 0x1daaa: 84, + 0x1daab: 84, + 0x1daac: 84, + 0x1daad: 84, + 0x1daae: 84, + 0x1daaf: 84, + 0x1e000: 84, + 0x1e001: 84, + 0x1e002: 84, + 0x1e003: 84, + 0x1e004: 84, + 0x1e005: 84, + 0x1e006: 84, + 0x1e008: 84, + 0x1e009: 84, + 0x1e00a: 84, + 0x1e00b: 84, + 0x1e00c: 84, + 0x1e00d: 84, + 0x1e00e: 84, + 0x1e00f: 84, + 0x1e010: 84, + 0x1e011: 84, + 0x1e012: 84, + 0x1e013: 84, + 0x1e014: 84, + 0x1e015: 84, + 0x1e016: 84, + 0x1e017: 84, + 0x1e018: 84, + 0x1e01b: 84, + 0x1e01c: 84, + 0x1e01d: 84, + 0x1e01e: 84, + 0x1e01f: 84, + 0x1e020: 84, + 0x1e021: 84, + 0x1e023: 84, + 0x1e024: 84, + 0x1e026: 84, + 0x1e027: 84, + 0x1e028: 84, + 0x1e029: 84, + 0x1e02a: 84, + 0x1e08f: 84, + 0x1e130: 84, + 0x1e131: 84, + 0x1e132: 84, + 0x1e133: 84, + 0x1e134: 84, + 0x1e135: 84, + 0x1e136: 84, + 0x1e2ae: 84, + 0x1e2ec: 84, + 0x1e2ed: 84, + 0x1e2ee: 84, + 0x1e2ef: 84, + 0x1e4ec: 84, + 0x1e4ed: 84, + 0x1e4ee: 84, + 0x1e4ef: 84, + 0x1e8d0: 84, + 0x1e8d1: 84, + 0x1e8d2: 84, + 0x1e8d3: 84, + 0x1e8d4: 84, + 0x1e8d5: 84, + 0x1e8d6: 84, + 0x1e900: 68, + 0x1e901: 68, + 0x1e902: 68, + 0x1e903: 68, + 0x1e904: 68, + 0x1e905: 68, + 0x1e906: 68, + 0x1e907: 68, + 0x1e908: 68, + 0x1e909: 68, + 0x1e90a: 68, + 0x1e90b: 68, + 0x1e90c: 68, + 0x1e90d: 68, + 0x1e90e: 68, + 0x1e90f: 68, + 0x1e910: 68, + 0x1e911: 68, + 0x1e912: 68, + 0x1e913: 68, + 0x1e914: 68, + 0x1e915: 68, + 0x1e916: 68, + 0x1e917: 68, + 0x1e918: 68, + 0x1e919: 68, + 0x1e91a: 68, + 0x1e91b: 68, + 0x1e91c: 68, + 0x1e91d: 68, + 0x1e91e: 68, + 0x1e91f: 68, + 0x1e920: 68, + 0x1e921: 68, + 0x1e922: 68, + 0x1e923: 68, + 0x1e924: 68, + 0x1e925: 68, + 0x1e926: 68, + 0x1e927: 68, + 0x1e928: 68, + 0x1e929: 68, + 0x1e92a: 68, + 0x1e92b: 68, + 0x1e92c: 68, + 0x1e92d: 68, + 0x1e92e: 68, + 0x1e92f: 68, + 0x1e930: 68, + 0x1e931: 68, + 0x1e932: 68, + 0x1e933: 68, + 0x1e934: 68, + 0x1e935: 68, + 0x1e936: 68, + 0x1e937: 68, + 0x1e938: 68, + 0x1e939: 68, + 0x1e93a: 68, + 0x1e93b: 68, + 0x1e93c: 68, + 0x1e93d: 68, + 0x1e93e: 68, + 0x1e93f: 68, + 0x1e940: 68, + 0x1e941: 68, + 0x1e942: 68, + 0x1e943: 68, + 0x1e944: 84, + 0x1e945: 84, + 0x1e946: 84, + 0x1e947: 84, + 0x1e948: 84, + 0x1e949: 84, + 0x1e94a: 84, + 0x1e94b: 84, + 0xe0001: 84, + 0xe0020: 84, + 0xe0021: 84, + 0xe0022: 84, + 0xe0023: 84, + 0xe0024: 84, + 0xe0025: 84, + 0xe0026: 84, + 0xe0027: 84, + 0xe0028: 84, + 0xe0029: 84, + 0xe002a: 84, + 0xe002b: 84, + 0xe002c: 84, + 0xe002d: 84, + 0xe002e: 84, + 0xe002f: 84, + 0xe0030: 84, + 0xe0031: 84, + 0xe0032: 84, + 0xe0033: 84, + 0xe0034: 84, + 0xe0035: 84, + 0xe0036: 84, + 0xe0037: 84, + 0xe0038: 84, + 0xe0039: 84, + 0xe003a: 84, + 0xe003b: 84, + 0xe003c: 84, + 0xe003d: 84, + 0xe003e: 84, + 0xe003f: 84, + 0xe0040: 84, + 0xe0041: 84, + 0xe0042: 84, + 0xe0043: 84, + 0xe0044: 84, + 0xe0045: 84, + 0xe0046: 84, + 0xe0047: 84, + 0xe0048: 84, + 0xe0049: 84, + 0xe004a: 84, + 0xe004b: 84, + 0xe004c: 84, + 0xe004d: 84, + 0xe004e: 84, + 0xe004f: 84, + 0xe0050: 84, + 0xe0051: 84, + 0xe0052: 84, + 0xe0053: 84, + 0xe0054: 84, + 0xe0055: 84, + 0xe0056: 84, + 0xe0057: 84, + 0xe0058: 84, + 0xe0059: 84, + 0xe005a: 84, + 0xe005b: 84, + 0xe005c: 84, + 0xe005d: 84, + 0xe005e: 84, + 0xe005f: 84, + 0xe0060: 84, + 0xe0061: 84, + 0xe0062: 84, + 0xe0063: 84, + 0xe0064: 84, + 0xe0065: 84, + 0xe0066: 84, + 0xe0067: 84, + 0xe0068: 84, + 0xe0069: 84, + 0xe006a: 84, + 0xe006b: 84, + 0xe006c: 84, + 0xe006d: 84, + 0xe006e: 84, + 0xe006f: 84, + 0xe0070: 84, + 0xe0071: 84, + 0xe0072: 84, + 0xe0073: 84, + 0xe0074: 84, + 0xe0075: 84, + 0xe0076: 84, + 0xe0077: 84, + 0xe0078: 84, + 0xe0079: 84, + 0xe007a: 84, + 0xe007b: 84, + 0xe007c: 84, + 0xe007d: 84, + 0xe007e: 84, + 0xe007f: 84, + 0xe0100: 84, + 0xe0101: 84, + 0xe0102: 84, + 0xe0103: 84, + 0xe0104: 84, + 0xe0105: 84, + 0xe0106: 84, + 0xe0107: 84, + 0xe0108: 84, + 0xe0109: 84, + 0xe010a: 84, + 0xe010b: 84, + 0xe010c: 84, + 0xe010d: 84, + 0xe010e: 84, + 0xe010f: 84, + 0xe0110: 84, + 0xe0111: 84, + 0xe0112: 84, + 0xe0113: 84, + 0xe0114: 84, + 0xe0115: 84, + 0xe0116: 84, + 0xe0117: 84, + 0xe0118: 84, + 0xe0119: 84, + 0xe011a: 84, + 0xe011b: 84, + 0xe011c: 84, + 0xe011d: 84, + 0xe011e: 84, + 0xe011f: 84, + 0xe0120: 84, + 0xe0121: 84, + 0xe0122: 84, + 0xe0123: 84, + 0xe0124: 84, + 0xe0125: 84, + 0xe0126: 84, + 0xe0127: 84, + 0xe0128: 84, + 0xe0129: 84, + 0xe012a: 84, + 0xe012b: 84, + 0xe012c: 84, + 0xe012d: 84, + 0xe012e: 84, + 0xe012f: 84, + 0xe0130: 84, + 0xe0131: 84, + 0xe0132: 84, + 0xe0133: 84, + 0xe0134: 84, + 0xe0135: 84, + 0xe0136: 84, + 0xe0137: 84, + 0xe0138: 84, + 0xe0139: 84, + 0xe013a: 84, + 0xe013b: 84, + 0xe013c: 84, + 0xe013d: 84, + 0xe013e: 84, + 0xe013f: 84, + 0xe0140: 84, + 0xe0141: 84, + 0xe0142: 84, + 0xe0143: 84, + 0xe0144: 84, + 0xe0145: 84, + 0xe0146: 84, + 0xe0147: 84, + 0xe0148: 84, + 0xe0149: 84, + 0xe014a: 84, + 0xe014b: 84, + 0xe014c: 84, + 0xe014d: 84, + 0xe014e: 84, + 0xe014f: 84, + 0xe0150: 84, + 0xe0151: 84, + 0xe0152: 84, + 0xe0153: 84, + 0xe0154: 84, + 0xe0155: 84, + 0xe0156: 84, + 0xe0157: 84, + 0xe0158: 84, + 0xe0159: 84, + 0xe015a: 84, + 0xe015b: 84, + 0xe015c: 84, + 0xe015d: 84, + 0xe015e: 84, + 0xe015f: 84, + 0xe0160: 84, + 0xe0161: 84, + 0xe0162: 84, + 0xe0163: 84, + 0xe0164: 84, + 0xe0165: 84, + 0xe0166: 84, + 0xe0167: 84, + 0xe0168: 84, + 0xe0169: 84, + 0xe016a: 84, + 0xe016b: 84, + 0xe016c: 84, + 0xe016d: 84, + 0xe016e: 84, + 0xe016f: 84, + 0xe0170: 84, + 0xe0171: 84, + 0xe0172: 84, + 0xe0173: 84, + 0xe0174: 84, + 0xe0175: 84, + 0xe0176: 84, + 0xe0177: 84, + 0xe0178: 84, + 0xe0179: 84, + 0xe017a: 84, + 0xe017b: 84, + 0xe017c: 84, + 0xe017d: 84, + 0xe017e: 84, + 0xe017f: 84, + 0xe0180: 84, + 0xe0181: 84, + 0xe0182: 84, + 0xe0183: 84, + 0xe0184: 84, + 0xe0185: 84, + 0xe0186: 84, + 0xe0187: 84, + 0xe0188: 84, + 0xe0189: 84, + 0xe018a: 84, + 0xe018b: 84, + 0xe018c: 84, + 0xe018d: 84, + 0xe018e: 84, + 0xe018f: 84, + 0xe0190: 84, + 0xe0191: 84, + 0xe0192: 84, + 0xe0193: 84, + 0xe0194: 84, + 0xe0195: 84, + 0xe0196: 84, + 0xe0197: 84, + 0xe0198: 84, + 0xe0199: 84, + 0xe019a: 84, + 0xe019b: 84, + 0xe019c: 84, + 0xe019d: 84, + 0xe019e: 84, + 0xe019f: 84, + 0xe01a0: 84, + 0xe01a1: 84, + 0xe01a2: 84, + 0xe01a3: 84, + 0xe01a4: 84, + 0xe01a5: 84, + 0xe01a6: 84, + 0xe01a7: 84, + 0xe01a8: 84, + 0xe01a9: 84, + 0xe01aa: 84, + 0xe01ab: 84, + 0xe01ac: 84, + 0xe01ad: 84, + 0xe01ae: 84, + 0xe01af: 84, + 0xe01b0: 84, + 0xe01b1: 84, + 0xe01b2: 84, + 0xe01b3: 84, + 0xe01b4: 84, + 0xe01b5: 84, + 0xe01b6: 84, + 0xe01b7: 84, + 0xe01b8: 84, + 0xe01b9: 84, + 0xe01ba: 84, + 0xe01bb: 84, + 0xe01bc: 84, + 0xe01bd: 84, + 0xe01be: 84, + 0xe01bf: 84, + 0xe01c0: 84, + 0xe01c1: 84, + 0xe01c2: 84, + 0xe01c3: 84, + 0xe01c4: 84, + 0xe01c5: 84, + 0xe01c6: 84, + 0xe01c7: 84, + 0xe01c8: 84, + 0xe01c9: 84, + 0xe01ca: 84, + 0xe01cb: 84, + 0xe01cc: 84, + 0xe01cd: 84, + 0xe01ce: 84, + 0xe01cf: 84, + 0xe01d0: 84, + 0xe01d1: 84, + 0xe01d2: 84, + 0xe01d3: 84, + 0xe01d4: 84, + 0xe01d5: 84, + 0xe01d6: 84, + 0xe01d7: 84, + 0xe01d8: 84, + 0xe01d9: 84, + 0xe01da: 84, + 0xe01db: 84, + 0xe01dc: 84, + 0xe01dd: 84, + 0xe01de: 84, + 0xe01df: 84, + 0xe01e0: 84, + 0xe01e1: 84, + 0xe01e2: 84, + 0xe01e3: 84, + 0xe01e4: 84, + 0xe01e5: 84, + 0xe01e6: 84, + 0xe01e7: 84, + 0xe01e8: 84, + 0xe01e9: 84, + 0xe01ea: 84, + 0xe01eb: 84, + 0xe01ec: 84, + 0xe01ed: 84, + 0xe01ee: 84, + 0xe01ef: 84, +} +codepoint_classes = { + 'PVALID': ( + 0x2d0000002e, + 0x300000003a, + 0x610000007b, + 0xdf000000f7, + 0xf800000100, + 0x10100000102, + 0x10300000104, + 0x10500000106, + 0x10700000108, + 0x1090000010a, + 0x10b0000010c, + 0x10d0000010e, + 0x10f00000110, + 0x11100000112, + 0x11300000114, + 0x11500000116, + 0x11700000118, + 0x1190000011a, + 0x11b0000011c, + 0x11d0000011e, + 0x11f00000120, + 0x12100000122, + 0x12300000124, + 0x12500000126, + 0x12700000128, + 0x1290000012a, + 0x12b0000012c, + 0x12d0000012e, + 0x12f00000130, + 0x13100000132, + 0x13500000136, + 0x13700000139, + 0x13a0000013b, + 0x13c0000013d, + 0x13e0000013f, + 0x14200000143, + 0x14400000145, + 0x14600000147, + 0x14800000149, + 0x14b0000014c, + 0x14d0000014e, + 0x14f00000150, + 0x15100000152, + 0x15300000154, + 0x15500000156, + 0x15700000158, + 0x1590000015a, + 0x15b0000015c, + 0x15d0000015e, + 0x15f00000160, + 0x16100000162, + 0x16300000164, + 0x16500000166, + 0x16700000168, + 0x1690000016a, + 0x16b0000016c, + 0x16d0000016e, + 0x16f00000170, + 0x17100000172, + 0x17300000174, + 0x17500000176, + 0x17700000178, + 0x17a0000017b, + 0x17c0000017d, + 0x17e0000017f, + 0x18000000181, + 0x18300000184, + 0x18500000186, + 0x18800000189, + 0x18c0000018e, + 0x19200000193, + 0x19500000196, + 0x1990000019c, + 0x19e0000019f, + 0x1a1000001a2, + 0x1a3000001a4, + 0x1a5000001a6, + 0x1a8000001a9, + 0x1aa000001ac, + 0x1ad000001ae, + 0x1b0000001b1, + 0x1b4000001b5, + 0x1b6000001b7, + 0x1b9000001bc, + 0x1bd000001c4, + 0x1ce000001cf, + 0x1d0000001d1, + 0x1d2000001d3, + 0x1d4000001d5, + 0x1d6000001d7, + 0x1d8000001d9, + 0x1da000001db, + 0x1dc000001de, + 0x1df000001e0, + 0x1e1000001e2, + 0x1e3000001e4, + 0x1e5000001e6, + 0x1e7000001e8, + 0x1e9000001ea, + 0x1eb000001ec, + 0x1ed000001ee, + 0x1ef000001f1, + 0x1f5000001f6, + 0x1f9000001fa, + 0x1fb000001fc, + 0x1fd000001fe, + 0x1ff00000200, + 0x20100000202, + 0x20300000204, + 0x20500000206, + 0x20700000208, + 0x2090000020a, + 0x20b0000020c, + 0x20d0000020e, + 0x20f00000210, + 0x21100000212, + 0x21300000214, + 0x21500000216, + 0x21700000218, + 0x2190000021a, + 0x21b0000021c, + 0x21d0000021e, + 0x21f00000220, + 0x22100000222, + 0x22300000224, + 0x22500000226, + 0x22700000228, + 0x2290000022a, + 0x22b0000022c, + 0x22d0000022e, + 0x22f00000230, + 0x23100000232, + 0x2330000023a, + 0x23c0000023d, + 0x23f00000241, + 0x24200000243, + 0x24700000248, + 0x2490000024a, + 0x24b0000024c, + 0x24d0000024e, + 0x24f000002b0, + 0x2b9000002c2, + 0x2c6000002d2, + 0x2ec000002ed, + 0x2ee000002ef, + 0x30000000340, + 0x34200000343, + 0x3460000034f, + 0x35000000370, + 0x37100000372, + 0x37300000374, + 0x37700000378, + 0x37b0000037e, + 0x39000000391, + 0x3ac000003cf, + 0x3d7000003d8, + 0x3d9000003da, + 0x3db000003dc, + 0x3dd000003de, + 0x3df000003e0, + 0x3e1000003e2, + 0x3e3000003e4, + 0x3e5000003e6, + 0x3e7000003e8, + 0x3e9000003ea, + 0x3eb000003ec, + 0x3ed000003ee, + 0x3ef000003f0, + 0x3f3000003f4, + 0x3f8000003f9, + 0x3fb000003fd, + 0x43000000460, + 0x46100000462, + 0x46300000464, + 0x46500000466, + 0x46700000468, + 0x4690000046a, + 0x46b0000046c, + 0x46d0000046e, + 0x46f00000470, + 0x47100000472, + 0x47300000474, + 0x47500000476, + 0x47700000478, + 0x4790000047a, + 0x47b0000047c, + 0x47d0000047e, + 0x47f00000480, + 0x48100000482, + 0x48300000488, + 0x48b0000048c, + 0x48d0000048e, + 0x48f00000490, + 0x49100000492, + 0x49300000494, + 0x49500000496, + 0x49700000498, + 0x4990000049a, + 0x49b0000049c, + 0x49d0000049e, + 0x49f000004a0, + 0x4a1000004a2, + 0x4a3000004a4, + 0x4a5000004a6, + 0x4a7000004a8, + 0x4a9000004aa, + 0x4ab000004ac, + 0x4ad000004ae, + 0x4af000004b0, + 0x4b1000004b2, + 0x4b3000004b4, + 0x4b5000004b6, + 0x4b7000004b8, + 0x4b9000004ba, + 0x4bb000004bc, + 0x4bd000004be, + 0x4bf000004c0, + 0x4c2000004c3, + 0x4c4000004c5, + 0x4c6000004c7, + 0x4c8000004c9, + 0x4ca000004cb, + 0x4cc000004cd, + 0x4ce000004d0, + 0x4d1000004d2, + 0x4d3000004d4, + 0x4d5000004d6, + 0x4d7000004d8, + 0x4d9000004da, + 0x4db000004dc, + 0x4dd000004de, + 0x4df000004e0, + 0x4e1000004e2, + 0x4e3000004e4, + 0x4e5000004e6, + 0x4e7000004e8, + 0x4e9000004ea, + 0x4eb000004ec, + 0x4ed000004ee, + 0x4ef000004f0, + 0x4f1000004f2, + 0x4f3000004f4, + 0x4f5000004f6, + 0x4f7000004f8, + 0x4f9000004fa, + 0x4fb000004fc, + 0x4fd000004fe, + 0x4ff00000500, + 0x50100000502, + 0x50300000504, + 0x50500000506, + 0x50700000508, + 0x5090000050a, + 0x50b0000050c, + 0x50d0000050e, + 0x50f00000510, + 0x51100000512, + 0x51300000514, + 0x51500000516, + 0x51700000518, + 0x5190000051a, + 0x51b0000051c, + 0x51d0000051e, + 0x51f00000520, + 0x52100000522, + 0x52300000524, + 0x52500000526, + 0x52700000528, + 0x5290000052a, + 0x52b0000052c, + 0x52d0000052e, + 0x52f00000530, + 0x5590000055a, + 0x56000000587, + 0x58800000589, + 0x591000005be, + 0x5bf000005c0, + 0x5c1000005c3, + 0x5c4000005c6, + 0x5c7000005c8, + 0x5d0000005eb, + 0x5ef000005f3, + 0x6100000061b, + 0x62000000640, + 0x64100000660, + 0x66e00000675, + 0x679000006d4, + 0x6d5000006dd, + 0x6df000006e9, + 0x6ea000006f0, + 0x6fa00000700, + 0x7100000074b, + 0x74d000007b2, + 0x7c0000007f6, + 0x7fd000007fe, + 0x8000000082e, + 0x8400000085c, + 0x8600000086b, + 0x87000000888, + 0x8890000088f, + 0x898000008e2, + 0x8e300000958, + 0x96000000964, + 0x96600000970, + 0x97100000984, + 0x9850000098d, + 0x98f00000991, + 0x993000009a9, + 0x9aa000009b1, + 0x9b2000009b3, + 0x9b6000009ba, + 0x9bc000009c5, + 0x9c7000009c9, + 0x9cb000009cf, + 0x9d7000009d8, + 0x9e0000009e4, + 0x9e6000009f2, + 0x9fc000009fd, + 0x9fe000009ff, + 0xa0100000a04, + 0xa0500000a0b, + 0xa0f00000a11, + 0xa1300000a29, + 0xa2a00000a31, + 0xa3200000a33, + 0xa3500000a36, + 0xa3800000a3a, + 0xa3c00000a3d, + 0xa3e00000a43, + 0xa4700000a49, + 0xa4b00000a4e, + 0xa5100000a52, + 0xa5c00000a5d, + 0xa6600000a76, + 0xa8100000a84, + 0xa8500000a8e, + 0xa8f00000a92, + 0xa9300000aa9, + 0xaaa00000ab1, + 0xab200000ab4, + 0xab500000aba, + 0xabc00000ac6, + 0xac700000aca, + 0xacb00000ace, + 0xad000000ad1, + 0xae000000ae4, + 0xae600000af0, + 0xaf900000b00, + 0xb0100000b04, + 0xb0500000b0d, + 0xb0f00000b11, + 0xb1300000b29, + 0xb2a00000b31, + 0xb3200000b34, + 0xb3500000b3a, + 0xb3c00000b45, + 0xb4700000b49, + 0xb4b00000b4e, + 0xb5500000b58, + 0xb5f00000b64, + 0xb6600000b70, + 0xb7100000b72, + 0xb8200000b84, + 0xb8500000b8b, + 0xb8e00000b91, + 0xb9200000b96, + 0xb9900000b9b, + 0xb9c00000b9d, + 0xb9e00000ba0, + 0xba300000ba5, + 0xba800000bab, + 0xbae00000bba, + 0xbbe00000bc3, + 0xbc600000bc9, + 0xbca00000bce, + 0xbd000000bd1, + 0xbd700000bd8, + 0xbe600000bf0, + 0xc0000000c0d, + 0xc0e00000c11, + 0xc1200000c29, + 0xc2a00000c3a, + 0xc3c00000c45, + 0xc4600000c49, + 0xc4a00000c4e, + 0xc5500000c57, + 0xc5800000c5b, + 0xc5d00000c5e, + 0xc6000000c64, + 0xc6600000c70, + 0xc8000000c84, + 0xc8500000c8d, + 0xc8e00000c91, + 0xc9200000ca9, + 0xcaa00000cb4, + 0xcb500000cba, + 0xcbc00000cc5, + 0xcc600000cc9, + 0xcca00000cce, + 0xcd500000cd7, + 0xcdd00000cdf, + 0xce000000ce4, + 0xce600000cf0, + 0xcf100000cf4, + 0xd0000000d0d, + 0xd0e00000d11, + 0xd1200000d45, + 0xd4600000d49, + 0xd4a00000d4f, + 0xd5400000d58, + 0xd5f00000d64, + 0xd6600000d70, + 0xd7a00000d80, + 0xd8100000d84, + 0xd8500000d97, + 0xd9a00000db2, + 0xdb300000dbc, + 0xdbd00000dbe, + 0xdc000000dc7, + 0xdca00000dcb, + 0xdcf00000dd5, + 0xdd600000dd7, + 0xdd800000de0, + 0xde600000df0, + 0xdf200000df4, + 0xe0100000e33, + 0xe3400000e3b, + 0xe4000000e4f, + 0xe5000000e5a, + 0xe8100000e83, + 0xe8400000e85, + 0xe8600000e8b, + 0xe8c00000ea4, + 0xea500000ea6, + 0xea700000eb3, + 0xeb400000ebe, + 0xec000000ec5, + 0xec600000ec7, + 0xec800000ecf, + 0xed000000eda, + 0xede00000ee0, + 0xf0000000f01, + 0xf0b00000f0c, + 0xf1800000f1a, + 0xf2000000f2a, + 0xf3500000f36, + 0xf3700000f38, + 0xf3900000f3a, + 0xf3e00000f43, + 0xf4400000f48, + 0xf4900000f4d, + 0xf4e00000f52, + 0xf5300000f57, + 0xf5800000f5c, + 0xf5d00000f69, + 0xf6a00000f6d, + 0xf7100000f73, + 0xf7400000f75, + 0xf7a00000f81, + 0xf8200000f85, + 0xf8600000f93, + 0xf9400000f98, + 0xf9900000f9d, + 0xf9e00000fa2, + 0xfa300000fa7, + 0xfa800000fac, + 0xfad00000fb9, + 0xfba00000fbd, + 0xfc600000fc7, + 0x10000000104a, + 0x10500000109e, + 0x10d0000010fb, + 0x10fd00001100, + 0x120000001249, + 0x124a0000124e, + 0x125000001257, + 0x125800001259, + 0x125a0000125e, + 0x126000001289, + 0x128a0000128e, + 0x1290000012b1, + 0x12b2000012b6, + 0x12b8000012bf, + 0x12c0000012c1, + 0x12c2000012c6, + 0x12c8000012d7, + 0x12d800001311, + 0x131200001316, + 0x13180000135b, + 0x135d00001360, + 0x138000001390, + 0x13a0000013f6, + 0x14010000166d, + 0x166f00001680, + 0x16810000169b, + 0x16a0000016eb, + 0x16f1000016f9, + 0x170000001716, + 0x171f00001735, + 0x174000001754, + 0x17600000176d, + 0x176e00001771, + 0x177200001774, + 0x1780000017b4, + 0x17b6000017d4, + 0x17d7000017d8, + 0x17dc000017de, + 0x17e0000017ea, + 0x18100000181a, + 0x182000001879, + 0x1880000018ab, + 0x18b0000018f6, + 0x19000000191f, + 0x19200000192c, + 0x19300000193c, + 0x19460000196e, + 0x197000001975, + 0x1980000019ac, + 0x19b0000019ca, + 0x19d0000019da, + 0x1a0000001a1c, + 0x1a2000001a5f, + 0x1a6000001a7d, + 0x1a7f00001a8a, + 0x1a9000001a9a, + 0x1aa700001aa8, + 0x1ab000001abe, + 0x1abf00001acf, + 0x1b0000001b4d, + 0x1b5000001b5a, + 0x1b6b00001b74, + 0x1b8000001bf4, + 0x1c0000001c38, + 0x1c4000001c4a, + 0x1c4d00001c7e, + 0x1cd000001cd3, + 0x1cd400001cfb, + 0x1d0000001d2c, + 0x1d2f00001d30, + 0x1d3b00001d3c, + 0x1d4e00001d4f, + 0x1d6b00001d78, + 0x1d7900001d9b, + 0x1dc000001e00, + 0x1e0100001e02, + 0x1e0300001e04, + 0x1e0500001e06, + 0x1e0700001e08, + 0x1e0900001e0a, + 0x1e0b00001e0c, + 0x1e0d00001e0e, + 0x1e0f00001e10, + 0x1e1100001e12, + 0x1e1300001e14, + 0x1e1500001e16, + 0x1e1700001e18, + 0x1e1900001e1a, + 0x1e1b00001e1c, + 0x1e1d00001e1e, + 0x1e1f00001e20, + 0x1e2100001e22, + 0x1e2300001e24, + 0x1e2500001e26, + 0x1e2700001e28, + 0x1e2900001e2a, + 0x1e2b00001e2c, + 0x1e2d00001e2e, + 0x1e2f00001e30, + 0x1e3100001e32, + 0x1e3300001e34, + 0x1e3500001e36, + 0x1e3700001e38, + 0x1e3900001e3a, + 0x1e3b00001e3c, + 0x1e3d00001e3e, + 0x1e3f00001e40, + 0x1e4100001e42, + 0x1e4300001e44, + 0x1e4500001e46, + 0x1e4700001e48, + 0x1e4900001e4a, + 0x1e4b00001e4c, + 0x1e4d00001e4e, + 0x1e4f00001e50, + 0x1e5100001e52, + 0x1e5300001e54, + 0x1e5500001e56, + 0x1e5700001e58, + 0x1e5900001e5a, + 0x1e5b00001e5c, + 0x1e5d00001e5e, + 0x1e5f00001e60, + 0x1e6100001e62, + 0x1e6300001e64, + 0x1e6500001e66, + 0x1e6700001e68, + 0x1e6900001e6a, + 0x1e6b00001e6c, + 0x1e6d00001e6e, + 0x1e6f00001e70, + 0x1e7100001e72, + 0x1e7300001e74, + 0x1e7500001e76, + 0x1e7700001e78, + 0x1e7900001e7a, + 0x1e7b00001e7c, + 0x1e7d00001e7e, + 0x1e7f00001e80, + 0x1e8100001e82, + 0x1e8300001e84, + 0x1e8500001e86, + 0x1e8700001e88, + 0x1e8900001e8a, + 0x1e8b00001e8c, + 0x1e8d00001e8e, + 0x1e8f00001e90, + 0x1e9100001e92, + 0x1e9300001e94, + 0x1e9500001e9a, + 0x1e9c00001e9e, + 0x1e9f00001ea0, + 0x1ea100001ea2, + 0x1ea300001ea4, + 0x1ea500001ea6, + 0x1ea700001ea8, + 0x1ea900001eaa, + 0x1eab00001eac, + 0x1ead00001eae, + 0x1eaf00001eb0, + 0x1eb100001eb2, + 0x1eb300001eb4, + 0x1eb500001eb6, + 0x1eb700001eb8, + 0x1eb900001eba, + 0x1ebb00001ebc, + 0x1ebd00001ebe, + 0x1ebf00001ec0, + 0x1ec100001ec2, + 0x1ec300001ec4, + 0x1ec500001ec6, + 0x1ec700001ec8, + 0x1ec900001eca, + 0x1ecb00001ecc, + 0x1ecd00001ece, + 0x1ecf00001ed0, + 0x1ed100001ed2, + 0x1ed300001ed4, + 0x1ed500001ed6, + 0x1ed700001ed8, + 0x1ed900001eda, + 0x1edb00001edc, + 0x1edd00001ede, + 0x1edf00001ee0, + 0x1ee100001ee2, + 0x1ee300001ee4, + 0x1ee500001ee6, + 0x1ee700001ee8, + 0x1ee900001eea, + 0x1eeb00001eec, + 0x1eed00001eee, + 0x1eef00001ef0, + 0x1ef100001ef2, + 0x1ef300001ef4, + 0x1ef500001ef6, + 0x1ef700001ef8, + 0x1ef900001efa, + 0x1efb00001efc, + 0x1efd00001efe, + 0x1eff00001f08, + 0x1f1000001f16, + 0x1f2000001f28, + 0x1f3000001f38, + 0x1f4000001f46, + 0x1f5000001f58, + 0x1f6000001f68, + 0x1f7000001f71, + 0x1f7200001f73, + 0x1f7400001f75, + 0x1f7600001f77, + 0x1f7800001f79, + 0x1f7a00001f7b, + 0x1f7c00001f7d, + 0x1fb000001fb2, + 0x1fb600001fb7, + 0x1fc600001fc7, + 0x1fd000001fd3, + 0x1fd600001fd8, + 0x1fe000001fe3, + 0x1fe400001fe8, + 0x1ff600001ff7, + 0x214e0000214f, + 0x218400002185, + 0x2c3000002c60, + 0x2c6100002c62, + 0x2c6500002c67, + 0x2c6800002c69, + 0x2c6a00002c6b, + 0x2c6c00002c6d, + 0x2c7100002c72, + 0x2c7300002c75, + 0x2c7600002c7c, + 0x2c8100002c82, + 0x2c8300002c84, + 0x2c8500002c86, + 0x2c8700002c88, + 0x2c8900002c8a, + 0x2c8b00002c8c, + 0x2c8d00002c8e, + 0x2c8f00002c90, + 0x2c9100002c92, + 0x2c9300002c94, + 0x2c9500002c96, + 0x2c9700002c98, + 0x2c9900002c9a, + 0x2c9b00002c9c, + 0x2c9d00002c9e, + 0x2c9f00002ca0, + 0x2ca100002ca2, + 0x2ca300002ca4, + 0x2ca500002ca6, + 0x2ca700002ca8, + 0x2ca900002caa, + 0x2cab00002cac, + 0x2cad00002cae, + 0x2caf00002cb0, + 0x2cb100002cb2, + 0x2cb300002cb4, + 0x2cb500002cb6, + 0x2cb700002cb8, + 0x2cb900002cba, + 0x2cbb00002cbc, + 0x2cbd00002cbe, + 0x2cbf00002cc0, + 0x2cc100002cc2, + 0x2cc300002cc4, + 0x2cc500002cc6, + 0x2cc700002cc8, + 0x2cc900002cca, + 0x2ccb00002ccc, + 0x2ccd00002cce, + 0x2ccf00002cd0, + 0x2cd100002cd2, + 0x2cd300002cd4, + 0x2cd500002cd6, + 0x2cd700002cd8, + 0x2cd900002cda, + 0x2cdb00002cdc, + 0x2cdd00002cde, + 0x2cdf00002ce0, + 0x2ce100002ce2, + 0x2ce300002ce5, + 0x2cec00002ced, + 0x2cee00002cf2, + 0x2cf300002cf4, + 0x2d0000002d26, + 0x2d2700002d28, + 0x2d2d00002d2e, + 0x2d3000002d68, + 0x2d7f00002d97, + 0x2da000002da7, + 0x2da800002daf, + 0x2db000002db7, + 0x2db800002dbf, + 0x2dc000002dc7, + 0x2dc800002dcf, + 0x2dd000002dd7, + 0x2dd800002ddf, + 0x2de000002e00, + 0x2e2f00002e30, + 0x300500003008, + 0x302a0000302e, + 0x303c0000303d, + 0x304100003097, + 0x30990000309b, + 0x309d0000309f, + 0x30a1000030fb, + 0x30fc000030ff, + 0x310500003130, + 0x31a0000031c0, + 0x31f000003200, + 0x340000004dc0, + 0x4e000000a48d, + 0xa4d00000a4fe, + 0xa5000000a60d, + 0xa6100000a62c, + 0xa6410000a642, + 0xa6430000a644, + 0xa6450000a646, + 0xa6470000a648, + 0xa6490000a64a, + 0xa64b0000a64c, + 0xa64d0000a64e, + 0xa64f0000a650, + 0xa6510000a652, + 0xa6530000a654, + 0xa6550000a656, + 0xa6570000a658, + 0xa6590000a65a, + 0xa65b0000a65c, + 0xa65d0000a65e, + 0xa65f0000a660, + 0xa6610000a662, + 0xa6630000a664, + 0xa6650000a666, + 0xa6670000a668, + 0xa6690000a66a, + 0xa66b0000a66c, + 0xa66d0000a670, + 0xa6740000a67e, + 0xa67f0000a680, + 0xa6810000a682, + 0xa6830000a684, + 0xa6850000a686, + 0xa6870000a688, + 0xa6890000a68a, + 0xa68b0000a68c, + 0xa68d0000a68e, + 0xa68f0000a690, + 0xa6910000a692, + 0xa6930000a694, + 0xa6950000a696, + 0xa6970000a698, + 0xa6990000a69a, + 0xa69b0000a69c, + 0xa69e0000a6e6, + 0xa6f00000a6f2, + 0xa7170000a720, + 0xa7230000a724, + 0xa7250000a726, + 0xa7270000a728, + 0xa7290000a72a, + 0xa72b0000a72c, + 0xa72d0000a72e, + 0xa72f0000a732, + 0xa7330000a734, + 0xa7350000a736, + 0xa7370000a738, + 0xa7390000a73a, + 0xa73b0000a73c, + 0xa73d0000a73e, + 0xa73f0000a740, + 0xa7410000a742, + 0xa7430000a744, + 0xa7450000a746, + 0xa7470000a748, + 0xa7490000a74a, + 0xa74b0000a74c, + 0xa74d0000a74e, + 0xa74f0000a750, + 0xa7510000a752, + 0xa7530000a754, + 0xa7550000a756, + 0xa7570000a758, + 0xa7590000a75a, + 0xa75b0000a75c, + 0xa75d0000a75e, + 0xa75f0000a760, + 0xa7610000a762, + 0xa7630000a764, + 0xa7650000a766, + 0xa7670000a768, + 0xa7690000a76a, + 0xa76b0000a76c, + 0xa76d0000a76e, + 0xa76f0000a770, + 0xa7710000a779, + 0xa77a0000a77b, + 0xa77c0000a77d, + 0xa77f0000a780, + 0xa7810000a782, + 0xa7830000a784, + 0xa7850000a786, + 0xa7870000a789, + 0xa78c0000a78d, + 0xa78e0000a790, + 0xa7910000a792, + 0xa7930000a796, + 0xa7970000a798, + 0xa7990000a79a, + 0xa79b0000a79c, + 0xa79d0000a79e, + 0xa79f0000a7a0, + 0xa7a10000a7a2, + 0xa7a30000a7a4, + 0xa7a50000a7a6, + 0xa7a70000a7a8, + 0xa7a90000a7aa, + 0xa7af0000a7b0, + 0xa7b50000a7b6, + 0xa7b70000a7b8, + 0xa7b90000a7ba, + 0xa7bb0000a7bc, + 0xa7bd0000a7be, + 0xa7bf0000a7c0, + 0xa7c10000a7c2, + 0xa7c30000a7c4, + 0xa7c80000a7c9, + 0xa7ca0000a7cb, + 0xa7d10000a7d2, + 0xa7d30000a7d4, + 0xa7d50000a7d6, + 0xa7d70000a7d8, + 0xa7d90000a7da, + 0xa7f60000a7f8, + 0xa7fa0000a828, + 0xa82c0000a82d, + 0xa8400000a874, + 0xa8800000a8c6, + 0xa8d00000a8da, + 0xa8e00000a8f8, + 0xa8fb0000a8fc, + 0xa8fd0000a92e, + 0xa9300000a954, + 0xa9800000a9c1, + 0xa9cf0000a9da, + 0xa9e00000a9ff, + 0xaa000000aa37, + 0xaa400000aa4e, + 0xaa500000aa5a, + 0xaa600000aa77, + 0xaa7a0000aac3, + 0xaadb0000aade, + 0xaae00000aaf0, + 0xaaf20000aaf7, + 0xab010000ab07, + 0xab090000ab0f, + 0xab110000ab17, + 0xab200000ab27, + 0xab280000ab2f, + 0xab300000ab5b, + 0xab600000ab69, + 0xabc00000abeb, + 0xabec0000abee, + 0xabf00000abfa, + 0xac000000d7a4, + 0xfa0e0000fa10, + 0xfa110000fa12, + 0xfa130000fa15, + 0xfa1f0000fa20, + 0xfa210000fa22, + 0xfa230000fa25, + 0xfa270000fa2a, + 0xfb1e0000fb1f, + 0xfe200000fe30, + 0xfe730000fe74, + 0x100000001000c, + 0x1000d00010027, + 0x100280001003b, + 0x1003c0001003e, + 0x1003f0001004e, + 0x100500001005e, + 0x10080000100fb, + 0x101fd000101fe, + 0x102800001029d, + 0x102a0000102d1, + 0x102e0000102e1, + 0x1030000010320, + 0x1032d00010341, + 0x103420001034a, + 0x103500001037b, + 0x103800001039e, + 0x103a0000103c4, + 0x103c8000103d0, + 0x104280001049e, + 0x104a0000104aa, + 0x104d8000104fc, + 0x1050000010528, + 0x1053000010564, + 0x10597000105a2, + 0x105a3000105b2, + 0x105b3000105ba, + 0x105bb000105bd, + 0x1060000010737, + 0x1074000010756, + 0x1076000010768, + 0x1078000010781, + 0x1080000010806, + 0x1080800010809, + 0x1080a00010836, + 0x1083700010839, + 0x1083c0001083d, + 0x1083f00010856, + 0x1086000010877, + 0x108800001089f, + 0x108e0000108f3, + 0x108f4000108f6, + 0x1090000010916, + 0x109200001093a, + 0x10980000109b8, + 0x109be000109c0, + 0x10a0000010a04, + 0x10a0500010a07, + 0x10a0c00010a14, + 0x10a1500010a18, + 0x10a1900010a36, + 0x10a3800010a3b, + 0x10a3f00010a40, + 0x10a6000010a7d, + 0x10a8000010a9d, + 0x10ac000010ac8, + 0x10ac900010ae7, + 0x10b0000010b36, + 0x10b4000010b56, + 0x10b6000010b73, + 0x10b8000010b92, + 0x10c0000010c49, + 0x10cc000010cf3, + 0x10d0000010d28, + 0x10d3000010d3a, + 0x10e8000010eaa, + 0x10eab00010ead, + 0x10eb000010eb2, + 0x10efd00010f1d, + 0x10f2700010f28, + 0x10f3000010f51, + 0x10f7000010f86, + 0x10fb000010fc5, + 0x10fe000010ff7, + 0x1100000011047, + 0x1106600011076, + 0x1107f000110bb, + 0x110c2000110c3, + 0x110d0000110e9, + 0x110f0000110fa, + 0x1110000011135, + 0x1113600011140, + 0x1114400011148, + 0x1115000011174, + 0x1117600011177, + 0x11180000111c5, + 0x111c9000111cd, + 0x111ce000111db, + 0x111dc000111dd, + 0x1120000011212, + 0x1121300011238, + 0x1123e00011242, + 0x1128000011287, + 0x1128800011289, + 0x1128a0001128e, + 0x1128f0001129e, + 0x1129f000112a9, + 0x112b0000112eb, + 0x112f0000112fa, + 0x1130000011304, + 0x113050001130d, + 0x1130f00011311, + 0x1131300011329, + 0x1132a00011331, + 0x1133200011334, + 0x113350001133a, + 0x1133b00011345, + 0x1134700011349, + 0x1134b0001134e, + 0x1135000011351, + 0x1135700011358, + 0x1135d00011364, + 0x113660001136d, + 0x1137000011375, + 0x114000001144b, + 0x114500001145a, + 0x1145e00011462, + 0x11480000114c6, + 0x114c7000114c8, + 0x114d0000114da, + 0x11580000115b6, + 0x115b8000115c1, + 0x115d8000115de, + 0x1160000011641, + 0x1164400011645, + 0x116500001165a, + 0x11680000116b9, + 0x116c0000116ca, + 0x117000001171b, + 0x1171d0001172c, + 0x117300001173a, + 0x1174000011747, + 0x118000001183b, + 0x118c0000118ea, + 0x118ff00011907, + 0x119090001190a, + 0x1190c00011914, + 0x1191500011917, + 0x1191800011936, + 0x1193700011939, + 0x1193b00011944, + 0x119500001195a, + 0x119a0000119a8, + 0x119aa000119d8, + 0x119da000119e2, + 0x119e3000119e5, + 0x11a0000011a3f, + 0x11a4700011a48, + 0x11a5000011a9a, + 0x11a9d00011a9e, + 0x11ab000011af9, + 0x11c0000011c09, + 0x11c0a00011c37, + 0x11c3800011c41, + 0x11c5000011c5a, + 0x11c7200011c90, + 0x11c9200011ca8, + 0x11ca900011cb7, + 0x11d0000011d07, + 0x11d0800011d0a, + 0x11d0b00011d37, + 0x11d3a00011d3b, + 0x11d3c00011d3e, + 0x11d3f00011d48, + 0x11d5000011d5a, + 0x11d6000011d66, + 0x11d6700011d69, + 0x11d6a00011d8f, + 0x11d9000011d92, + 0x11d9300011d99, + 0x11da000011daa, + 0x11ee000011ef7, + 0x11f0000011f11, + 0x11f1200011f3b, + 0x11f3e00011f43, + 0x11f5000011f5a, + 0x11fb000011fb1, + 0x120000001239a, + 0x1248000012544, + 0x12f9000012ff1, + 0x1300000013430, + 0x1344000013456, + 0x1440000014647, + 0x1680000016a39, + 0x16a4000016a5f, + 0x16a6000016a6a, + 0x16a7000016abf, + 0x16ac000016aca, + 0x16ad000016aee, + 0x16af000016af5, + 0x16b0000016b37, + 0x16b4000016b44, + 0x16b5000016b5a, + 0x16b6300016b78, + 0x16b7d00016b90, + 0x16e6000016e80, + 0x16f0000016f4b, + 0x16f4f00016f88, + 0x16f8f00016fa0, + 0x16fe000016fe2, + 0x16fe300016fe5, + 0x16ff000016ff2, + 0x17000000187f8, + 0x1880000018cd6, + 0x18d0000018d09, + 0x1aff00001aff4, + 0x1aff50001affc, + 0x1affd0001afff, + 0x1b0000001b123, + 0x1b1320001b133, + 0x1b1500001b153, + 0x1b1550001b156, + 0x1b1640001b168, + 0x1b1700001b2fc, + 0x1bc000001bc6b, + 0x1bc700001bc7d, + 0x1bc800001bc89, + 0x1bc900001bc9a, + 0x1bc9d0001bc9f, + 0x1cf000001cf2e, + 0x1cf300001cf47, + 0x1da000001da37, + 0x1da3b0001da6d, + 0x1da750001da76, + 0x1da840001da85, + 0x1da9b0001daa0, + 0x1daa10001dab0, + 0x1df000001df1f, + 0x1df250001df2b, + 0x1e0000001e007, + 0x1e0080001e019, + 0x1e01b0001e022, + 0x1e0230001e025, + 0x1e0260001e02b, + 0x1e08f0001e090, + 0x1e1000001e12d, + 0x1e1300001e13e, + 0x1e1400001e14a, + 0x1e14e0001e14f, + 0x1e2900001e2af, + 0x1e2c00001e2fa, + 0x1e4d00001e4fa, + 0x1e7e00001e7e7, + 0x1e7e80001e7ec, + 0x1e7ed0001e7ef, + 0x1e7f00001e7ff, + 0x1e8000001e8c5, + 0x1e8d00001e8d7, + 0x1e9220001e94c, + 0x1e9500001e95a, + 0x200000002a6e0, + 0x2a7000002b73a, + 0x2b7400002b81e, + 0x2b8200002cea2, + 0x2ceb00002ebe1, + 0x2ebf00002ee5e, + 0x300000003134b, + 0x31350000323b0, + ), + 'CONTEXTJ': ( + 0x200c0000200e, + ), + 'CONTEXTO': ( + 0xb7000000b8, + 0x37500000376, + 0x5f3000005f5, + 0x6600000066a, + 0x6f0000006fa, + 0x30fb000030fc, + ), +} diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/idna/intranges.py b/.venv/lib/python3.12/site-packages/pip/_vendor/idna/intranges.py new file mode 100644 index 0000000..6a43b04 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/idna/intranges.py @@ -0,0 +1,54 @@ +""" +Given a list of integers, made up of (hopefully) a small number of long runs +of consecutive integers, compute a representation of the form +((start1, end1), (start2, end2) ...). Then answer the question "was x present +in the original list?" in time O(log(# runs)). +""" + +import bisect +from typing import List, Tuple + +def intranges_from_list(list_: List[int]) -> Tuple[int, ...]: + """Represent a list of integers as a sequence of ranges: + ((start_0, end_0), (start_1, end_1), ...), such that the original + integers are exactly those x such that start_i <= x < end_i for some i. + + Ranges are encoded as single integers (start << 32 | end), not as tuples. + """ + + sorted_list = sorted(list_) + ranges = [] + last_write = -1 + for i in range(len(sorted_list)): + if i+1 < len(sorted_list): + if sorted_list[i] == sorted_list[i+1]-1: + continue + current_range = sorted_list[last_write+1:i+1] + ranges.append(_encode_range(current_range[0], current_range[-1] + 1)) + last_write = i + + return tuple(ranges) + +def _encode_range(start: int, end: int) -> int: + return (start << 32) | end + +def _decode_range(r: int) -> Tuple[int, int]: + return (r >> 32), (r & ((1 << 32) - 1)) + + +def intranges_contain(int_: int, ranges: Tuple[int, ...]) -> bool: + """Determine if `int_` falls into one of the ranges in `ranges`.""" + tuple_ = _encode_range(int_, 0) + pos = bisect.bisect_left(ranges, tuple_) + # we could be immediately ahead of a tuple (start, end) + # with start < int_ <= end + if pos > 0: + left, right = _decode_range(ranges[pos-1]) + if left <= int_ < right: + return True + # or we could be immediately behind a tuple (int_, end) + if pos < len(ranges): + left, _ = _decode_range(ranges[pos]) + if left == int_: + return True + return False diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/idna/package_data.py b/.venv/lib/python3.12/site-packages/pip/_vendor/idna/package_data.py new file mode 100644 index 0000000..ed81113 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/idna/package_data.py @@ -0,0 +1,2 @@ +__version__ = '3.7' + diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/idna/py.typed b/.venv/lib/python3.12/site-packages/pip/_vendor/idna/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/idna/uts46data.py b/.venv/lib/python3.12/site-packages/pip/_vendor/idna/uts46data.py new file mode 100644 index 0000000..6a1eddb --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/idna/uts46data.py @@ -0,0 +1,8598 @@ +# This file is automatically generated by tools/idna-data +# vim: set fileencoding=utf-8 : + +from typing import List, Tuple, Union + + +"""IDNA Mapping Table from UTS46.""" + + +__version__ = '15.1.0' +def _seg_0() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x0, '3'), + (0x1, '3'), + (0x2, '3'), + (0x3, '3'), + (0x4, '3'), + (0x5, '3'), + (0x6, '3'), + (0x7, '3'), + (0x8, '3'), + (0x9, '3'), + (0xA, '3'), + (0xB, '3'), + (0xC, '3'), + (0xD, '3'), + (0xE, '3'), + (0xF, '3'), + (0x10, '3'), + (0x11, '3'), + (0x12, '3'), + (0x13, '3'), + (0x14, '3'), + (0x15, '3'), + (0x16, '3'), + (0x17, '3'), + (0x18, '3'), + (0x19, '3'), + (0x1A, '3'), + (0x1B, '3'), + (0x1C, '3'), + (0x1D, '3'), + (0x1E, '3'), + (0x1F, '3'), + (0x20, '3'), + (0x21, '3'), + (0x22, '3'), + (0x23, '3'), + (0x24, '3'), + (0x25, '3'), + (0x26, '3'), + (0x27, '3'), + (0x28, '3'), + (0x29, '3'), + (0x2A, '3'), + (0x2B, '3'), + (0x2C, '3'), + (0x2D, 'V'), + (0x2E, 'V'), + (0x2F, '3'), + (0x30, 'V'), + (0x31, 'V'), + (0x32, 'V'), + (0x33, 'V'), + (0x34, 'V'), + (0x35, 'V'), + (0x36, 'V'), + (0x37, 'V'), + (0x38, 'V'), + (0x39, 'V'), + (0x3A, '3'), + (0x3B, '3'), + (0x3C, '3'), + (0x3D, '3'), + (0x3E, '3'), + (0x3F, '3'), + (0x40, '3'), + (0x41, 'M', 'a'), + (0x42, 'M', 'b'), + (0x43, 'M', 'c'), + (0x44, 'M', 'd'), + (0x45, 'M', 'e'), + (0x46, 'M', 'f'), + (0x47, 'M', 'g'), + (0x48, 'M', 'h'), + (0x49, 'M', 'i'), + (0x4A, 'M', 'j'), + (0x4B, 'M', 'k'), + (0x4C, 'M', 'l'), + (0x4D, 'M', 'm'), + (0x4E, 'M', 'n'), + (0x4F, 'M', 'o'), + (0x50, 'M', 'p'), + (0x51, 'M', 'q'), + (0x52, 'M', 'r'), + (0x53, 'M', 's'), + (0x54, 'M', 't'), + (0x55, 'M', 'u'), + (0x56, 'M', 'v'), + (0x57, 'M', 'w'), + (0x58, 'M', 'x'), + (0x59, 'M', 'y'), + (0x5A, 'M', 'z'), + (0x5B, '3'), + (0x5C, '3'), + (0x5D, '3'), + (0x5E, '3'), + (0x5F, '3'), + (0x60, '3'), + (0x61, 'V'), + (0x62, 'V'), + (0x63, 'V'), + ] + +def _seg_1() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x64, 'V'), + (0x65, 'V'), + (0x66, 'V'), + (0x67, 'V'), + (0x68, 'V'), + (0x69, 'V'), + (0x6A, 'V'), + (0x6B, 'V'), + (0x6C, 'V'), + (0x6D, 'V'), + (0x6E, 'V'), + (0x6F, 'V'), + (0x70, 'V'), + (0x71, 'V'), + (0x72, 'V'), + (0x73, 'V'), + (0x74, 'V'), + (0x75, 'V'), + (0x76, 'V'), + (0x77, 'V'), + (0x78, 'V'), + (0x79, 'V'), + (0x7A, 'V'), + (0x7B, '3'), + (0x7C, '3'), + (0x7D, '3'), + (0x7E, '3'), + (0x7F, '3'), + (0x80, 'X'), + (0x81, 'X'), + (0x82, 'X'), + (0x83, 'X'), + (0x84, 'X'), + (0x85, 'X'), + (0x86, 'X'), + (0x87, 'X'), + (0x88, 'X'), + (0x89, 'X'), + (0x8A, 'X'), + (0x8B, 'X'), + (0x8C, 'X'), + (0x8D, 'X'), + (0x8E, 'X'), + (0x8F, 'X'), + (0x90, 'X'), + (0x91, 'X'), + (0x92, 'X'), + (0x93, 'X'), + (0x94, 'X'), + (0x95, 'X'), + (0x96, 'X'), + (0x97, 'X'), + (0x98, 'X'), + (0x99, 'X'), + (0x9A, 'X'), + (0x9B, 'X'), + (0x9C, 'X'), + (0x9D, 'X'), + (0x9E, 'X'), + (0x9F, 'X'), + (0xA0, '3', ' '), + (0xA1, 'V'), + (0xA2, 'V'), + (0xA3, 'V'), + (0xA4, 'V'), + (0xA5, 'V'), + (0xA6, 'V'), + (0xA7, 'V'), + (0xA8, '3', ' ̈'), + (0xA9, 'V'), + (0xAA, 'M', 'a'), + (0xAB, 'V'), + (0xAC, 'V'), + (0xAD, 'I'), + (0xAE, 'V'), + (0xAF, '3', ' ̄'), + (0xB0, 'V'), + (0xB1, 'V'), + (0xB2, 'M', '2'), + (0xB3, 'M', '3'), + (0xB4, '3', ' ́'), + (0xB5, 'M', 'μ'), + (0xB6, 'V'), + (0xB7, 'V'), + (0xB8, '3', ' ̧'), + (0xB9, 'M', '1'), + (0xBA, 'M', 'o'), + (0xBB, 'V'), + (0xBC, 'M', '1⁄4'), + (0xBD, 'M', '1⁄2'), + (0xBE, 'M', '3⁄4'), + (0xBF, 'V'), + (0xC0, 'M', 'à'), + (0xC1, 'M', 'á'), + (0xC2, 'M', 'â'), + (0xC3, 'M', 'ã'), + (0xC4, 'M', 'ä'), + (0xC5, 'M', 'å'), + (0xC6, 'M', 'æ'), + (0xC7, 'M', 'ç'), + ] + +def _seg_2() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xC8, 'M', 'è'), + (0xC9, 'M', 'é'), + (0xCA, 'M', 'ê'), + (0xCB, 'M', 'ë'), + (0xCC, 'M', 'ì'), + (0xCD, 'M', 'í'), + (0xCE, 'M', 'î'), + (0xCF, 'M', 'ï'), + (0xD0, 'M', 'ð'), + (0xD1, 'M', 'ñ'), + (0xD2, 'M', 'ò'), + (0xD3, 'M', 'ó'), + (0xD4, 'M', 'ô'), + (0xD5, 'M', 'õ'), + (0xD6, 'M', 'ö'), + (0xD7, 'V'), + (0xD8, 'M', 'ø'), + (0xD9, 'M', 'ù'), + (0xDA, 'M', 'ú'), + (0xDB, 'M', 'û'), + (0xDC, 'M', 'ü'), + (0xDD, 'M', 'ý'), + (0xDE, 'M', 'þ'), + (0xDF, 'D', 'ss'), + (0xE0, 'V'), + (0xE1, 'V'), + (0xE2, 'V'), + (0xE3, 'V'), + (0xE4, 'V'), + (0xE5, 'V'), + (0xE6, 'V'), + (0xE7, 'V'), + (0xE8, 'V'), + (0xE9, 'V'), + (0xEA, 'V'), + (0xEB, 'V'), + (0xEC, 'V'), + (0xED, 'V'), + (0xEE, 'V'), + (0xEF, 'V'), + (0xF0, 'V'), + (0xF1, 'V'), + (0xF2, 'V'), + (0xF3, 'V'), + (0xF4, 'V'), + (0xF5, 'V'), + (0xF6, 'V'), + (0xF7, 'V'), + (0xF8, 'V'), + (0xF9, 'V'), + (0xFA, 'V'), + (0xFB, 'V'), + (0xFC, 'V'), + (0xFD, 'V'), + (0xFE, 'V'), + (0xFF, 'V'), + (0x100, 'M', 'ā'), + (0x101, 'V'), + (0x102, 'M', 'ă'), + (0x103, 'V'), + (0x104, 'M', 'ą'), + (0x105, 'V'), + (0x106, 'M', 'ć'), + (0x107, 'V'), + (0x108, 'M', 'ĉ'), + (0x109, 'V'), + (0x10A, 'M', 'ċ'), + (0x10B, 'V'), + (0x10C, 'M', 'č'), + (0x10D, 'V'), + (0x10E, 'M', 'ď'), + (0x10F, 'V'), + (0x110, 'M', 'đ'), + (0x111, 'V'), + (0x112, 'M', 'ē'), + (0x113, 'V'), + (0x114, 'M', 'ĕ'), + (0x115, 'V'), + (0x116, 'M', 'ė'), + (0x117, 'V'), + (0x118, 'M', 'ę'), + (0x119, 'V'), + (0x11A, 'M', 'ě'), + (0x11B, 'V'), + (0x11C, 'M', 'ĝ'), + (0x11D, 'V'), + (0x11E, 'M', 'ğ'), + (0x11F, 'V'), + (0x120, 'M', 'ġ'), + (0x121, 'V'), + (0x122, 'M', 'ģ'), + (0x123, 'V'), + (0x124, 'M', 'ĥ'), + (0x125, 'V'), + (0x126, 'M', 'ħ'), + (0x127, 'V'), + (0x128, 'M', 'ĩ'), + (0x129, 'V'), + (0x12A, 'M', 'ī'), + (0x12B, 'V'), + ] + +def _seg_3() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x12C, 'M', 'ĭ'), + (0x12D, 'V'), + (0x12E, 'M', 'į'), + (0x12F, 'V'), + (0x130, 'M', 'i̇'), + (0x131, 'V'), + (0x132, 'M', 'ij'), + (0x134, 'M', 'ĵ'), + (0x135, 'V'), + (0x136, 'M', 'ķ'), + (0x137, 'V'), + (0x139, 'M', 'ĺ'), + (0x13A, 'V'), + (0x13B, 'M', 'ļ'), + (0x13C, 'V'), + (0x13D, 'M', 'ľ'), + (0x13E, 'V'), + (0x13F, 'M', 'l·'), + (0x141, 'M', 'ł'), + (0x142, 'V'), + (0x143, 'M', 'ń'), + (0x144, 'V'), + (0x145, 'M', 'ņ'), + (0x146, 'V'), + (0x147, 'M', 'ň'), + (0x148, 'V'), + (0x149, 'M', 'ʼn'), + (0x14A, 'M', 'ŋ'), + (0x14B, 'V'), + (0x14C, 'M', 'ō'), + (0x14D, 'V'), + (0x14E, 'M', 'ŏ'), + (0x14F, 'V'), + (0x150, 'M', 'ő'), + (0x151, 'V'), + (0x152, 'M', 'œ'), + (0x153, 'V'), + (0x154, 'M', 'ŕ'), + (0x155, 'V'), + (0x156, 'M', 'ŗ'), + (0x157, 'V'), + (0x158, 'M', 'ř'), + (0x159, 'V'), + (0x15A, 'M', 'ś'), + (0x15B, 'V'), + (0x15C, 'M', 'ŝ'), + (0x15D, 'V'), + (0x15E, 'M', 'ş'), + (0x15F, 'V'), + (0x160, 'M', 'š'), + (0x161, 'V'), + (0x162, 'M', 'ţ'), + (0x163, 'V'), + (0x164, 'M', 'ť'), + (0x165, 'V'), + (0x166, 'M', 'ŧ'), + (0x167, 'V'), + (0x168, 'M', 'ũ'), + (0x169, 'V'), + (0x16A, 'M', 'ū'), + (0x16B, 'V'), + (0x16C, 'M', 'ŭ'), + (0x16D, 'V'), + (0x16E, 'M', 'ů'), + (0x16F, 'V'), + (0x170, 'M', 'ű'), + (0x171, 'V'), + (0x172, 'M', 'ų'), + (0x173, 'V'), + (0x174, 'M', 'ŵ'), + (0x175, 'V'), + (0x176, 'M', 'ŷ'), + (0x177, 'V'), + (0x178, 'M', 'ÿ'), + (0x179, 'M', 'ź'), + (0x17A, 'V'), + (0x17B, 'M', 'ż'), + (0x17C, 'V'), + (0x17D, 'M', 'ž'), + (0x17E, 'V'), + (0x17F, 'M', 's'), + (0x180, 'V'), + (0x181, 'M', 'ɓ'), + (0x182, 'M', 'ƃ'), + (0x183, 'V'), + (0x184, 'M', 'ƅ'), + (0x185, 'V'), + (0x186, 'M', 'ɔ'), + (0x187, 'M', 'ƈ'), + (0x188, 'V'), + (0x189, 'M', 'ɖ'), + (0x18A, 'M', 'ɗ'), + (0x18B, 'M', 'ƌ'), + (0x18C, 'V'), + (0x18E, 'M', 'ǝ'), + (0x18F, 'M', 'ə'), + (0x190, 'M', 'ɛ'), + (0x191, 'M', 'ƒ'), + (0x192, 'V'), + (0x193, 'M', 'ɠ'), + ] + +def _seg_4() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x194, 'M', 'ɣ'), + (0x195, 'V'), + (0x196, 'M', 'ɩ'), + (0x197, 'M', 'ɨ'), + (0x198, 'M', 'ƙ'), + (0x199, 'V'), + (0x19C, 'M', 'ɯ'), + (0x19D, 'M', 'ɲ'), + (0x19E, 'V'), + (0x19F, 'M', 'ɵ'), + (0x1A0, 'M', 'ơ'), + (0x1A1, 'V'), + (0x1A2, 'M', 'ƣ'), + (0x1A3, 'V'), + (0x1A4, 'M', 'ƥ'), + (0x1A5, 'V'), + (0x1A6, 'M', 'ʀ'), + (0x1A7, 'M', 'ƨ'), + (0x1A8, 'V'), + (0x1A9, 'M', 'ʃ'), + (0x1AA, 'V'), + (0x1AC, 'M', 'ƭ'), + (0x1AD, 'V'), + (0x1AE, 'M', 'ʈ'), + (0x1AF, 'M', 'ư'), + (0x1B0, 'V'), + (0x1B1, 'M', 'ʊ'), + (0x1B2, 'M', 'ʋ'), + (0x1B3, 'M', 'ƴ'), + (0x1B4, 'V'), + (0x1B5, 'M', 'ƶ'), + (0x1B6, 'V'), + (0x1B7, 'M', 'ʒ'), + (0x1B8, 'M', 'ƹ'), + (0x1B9, 'V'), + (0x1BC, 'M', 'ƽ'), + (0x1BD, 'V'), + (0x1C4, 'M', 'dž'), + (0x1C7, 'M', 'lj'), + (0x1CA, 'M', 'nj'), + (0x1CD, 'M', 'ǎ'), + (0x1CE, 'V'), + (0x1CF, 'M', 'ǐ'), + (0x1D0, 'V'), + (0x1D1, 'M', 'ǒ'), + (0x1D2, 'V'), + (0x1D3, 'M', 'ǔ'), + (0x1D4, 'V'), + (0x1D5, 'M', 'ǖ'), + (0x1D6, 'V'), + (0x1D7, 'M', 'ǘ'), + (0x1D8, 'V'), + (0x1D9, 'M', 'ǚ'), + (0x1DA, 'V'), + (0x1DB, 'M', 'ǜ'), + (0x1DC, 'V'), + (0x1DE, 'M', 'ǟ'), + (0x1DF, 'V'), + (0x1E0, 'M', 'ǡ'), + (0x1E1, 'V'), + (0x1E2, 'M', 'ǣ'), + (0x1E3, 'V'), + (0x1E4, 'M', 'ǥ'), + (0x1E5, 'V'), + (0x1E6, 'M', 'ǧ'), + (0x1E7, 'V'), + (0x1E8, 'M', 'ǩ'), + (0x1E9, 'V'), + (0x1EA, 'M', 'ǫ'), + (0x1EB, 'V'), + (0x1EC, 'M', 'ǭ'), + (0x1ED, 'V'), + (0x1EE, 'M', 'ǯ'), + (0x1EF, 'V'), + (0x1F1, 'M', 'dz'), + (0x1F4, 'M', 'ǵ'), + (0x1F5, 'V'), + (0x1F6, 'M', 'ƕ'), + (0x1F7, 'M', 'ƿ'), + (0x1F8, 'M', 'ǹ'), + (0x1F9, 'V'), + (0x1FA, 'M', 'ǻ'), + (0x1FB, 'V'), + (0x1FC, 'M', 'ǽ'), + (0x1FD, 'V'), + (0x1FE, 'M', 'ǿ'), + (0x1FF, 'V'), + (0x200, 'M', 'ȁ'), + (0x201, 'V'), + (0x202, 'M', 'ȃ'), + (0x203, 'V'), + (0x204, 'M', 'ȅ'), + (0x205, 'V'), + (0x206, 'M', 'ȇ'), + (0x207, 'V'), + (0x208, 'M', 'ȉ'), + (0x209, 'V'), + (0x20A, 'M', 'ȋ'), + (0x20B, 'V'), + (0x20C, 'M', 'ȍ'), + ] + +def _seg_5() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x20D, 'V'), + (0x20E, 'M', 'ȏ'), + (0x20F, 'V'), + (0x210, 'M', 'ȑ'), + (0x211, 'V'), + (0x212, 'M', 'ȓ'), + (0x213, 'V'), + (0x214, 'M', 'ȕ'), + (0x215, 'V'), + (0x216, 'M', 'ȗ'), + (0x217, 'V'), + (0x218, 'M', 'ș'), + (0x219, 'V'), + (0x21A, 'M', 'ț'), + (0x21B, 'V'), + (0x21C, 'M', 'ȝ'), + (0x21D, 'V'), + (0x21E, 'M', 'ȟ'), + (0x21F, 'V'), + (0x220, 'M', 'ƞ'), + (0x221, 'V'), + (0x222, 'M', 'ȣ'), + (0x223, 'V'), + (0x224, 'M', 'ȥ'), + (0x225, 'V'), + (0x226, 'M', 'ȧ'), + (0x227, 'V'), + (0x228, 'M', 'ȩ'), + (0x229, 'V'), + (0x22A, 'M', 'ȫ'), + (0x22B, 'V'), + (0x22C, 'M', 'ȭ'), + (0x22D, 'V'), + (0x22E, 'M', 'ȯ'), + (0x22F, 'V'), + (0x230, 'M', 'ȱ'), + (0x231, 'V'), + (0x232, 'M', 'ȳ'), + (0x233, 'V'), + (0x23A, 'M', 'ⱥ'), + (0x23B, 'M', 'ȼ'), + (0x23C, 'V'), + (0x23D, 'M', 'ƚ'), + (0x23E, 'M', 'ⱦ'), + (0x23F, 'V'), + (0x241, 'M', 'ɂ'), + (0x242, 'V'), + (0x243, 'M', 'ƀ'), + (0x244, 'M', 'ʉ'), + (0x245, 'M', 'ʌ'), + (0x246, 'M', 'ɇ'), + (0x247, 'V'), + (0x248, 'M', 'ɉ'), + (0x249, 'V'), + (0x24A, 'M', 'ɋ'), + (0x24B, 'V'), + (0x24C, 'M', 'ɍ'), + (0x24D, 'V'), + (0x24E, 'M', 'ɏ'), + (0x24F, 'V'), + (0x2B0, 'M', 'h'), + (0x2B1, 'M', 'ɦ'), + (0x2B2, 'M', 'j'), + (0x2B3, 'M', 'r'), + (0x2B4, 'M', 'ɹ'), + (0x2B5, 'M', 'ɻ'), + (0x2B6, 'M', 'ʁ'), + (0x2B7, 'M', 'w'), + (0x2B8, 'M', 'y'), + (0x2B9, 'V'), + (0x2D8, '3', ' ̆'), + (0x2D9, '3', ' ̇'), + (0x2DA, '3', ' ̊'), + (0x2DB, '3', ' ̨'), + (0x2DC, '3', ' ̃'), + (0x2DD, '3', ' ̋'), + (0x2DE, 'V'), + (0x2E0, 'M', 'ɣ'), + (0x2E1, 'M', 'l'), + (0x2E2, 'M', 's'), + (0x2E3, 'M', 'x'), + (0x2E4, 'M', 'ʕ'), + (0x2E5, 'V'), + (0x340, 'M', '̀'), + (0x341, 'M', '́'), + (0x342, 'V'), + (0x343, 'M', '̓'), + (0x344, 'M', '̈́'), + (0x345, 'M', 'ι'), + (0x346, 'V'), + (0x34F, 'I'), + (0x350, 'V'), + (0x370, 'M', 'ͱ'), + (0x371, 'V'), + (0x372, 'M', 'ͳ'), + (0x373, 'V'), + (0x374, 'M', 'ʹ'), + (0x375, 'V'), + (0x376, 'M', 'ͷ'), + (0x377, 'V'), + ] + +def _seg_6() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x378, 'X'), + (0x37A, '3', ' ι'), + (0x37B, 'V'), + (0x37E, '3', ';'), + (0x37F, 'M', 'ϳ'), + (0x380, 'X'), + (0x384, '3', ' ́'), + (0x385, '3', ' ̈́'), + (0x386, 'M', 'ά'), + (0x387, 'M', '·'), + (0x388, 'M', 'έ'), + (0x389, 'M', 'ή'), + (0x38A, 'M', 'ί'), + (0x38B, 'X'), + (0x38C, 'M', 'ό'), + (0x38D, 'X'), + (0x38E, 'M', 'ύ'), + (0x38F, 'M', 'ώ'), + (0x390, 'V'), + (0x391, 'M', 'α'), + (0x392, 'M', 'β'), + (0x393, 'M', 'γ'), + (0x394, 'M', 'δ'), + (0x395, 'M', 'ε'), + (0x396, 'M', 'ζ'), + (0x397, 'M', 'η'), + (0x398, 'M', 'θ'), + (0x399, 'M', 'ι'), + (0x39A, 'M', 'κ'), + (0x39B, 'M', 'λ'), + (0x39C, 'M', 'μ'), + (0x39D, 'M', 'ν'), + (0x39E, 'M', 'ξ'), + (0x39F, 'M', 'ο'), + (0x3A0, 'M', 'π'), + (0x3A1, 'M', 'ρ'), + (0x3A2, 'X'), + (0x3A3, 'M', 'σ'), + (0x3A4, 'M', 'τ'), + (0x3A5, 'M', 'υ'), + (0x3A6, 'M', 'φ'), + (0x3A7, 'M', 'χ'), + (0x3A8, 'M', 'ψ'), + (0x3A9, 'M', 'ω'), + (0x3AA, 'M', 'ϊ'), + (0x3AB, 'M', 'ϋ'), + (0x3AC, 'V'), + (0x3C2, 'D', 'σ'), + (0x3C3, 'V'), + (0x3CF, 'M', 'ϗ'), + (0x3D0, 'M', 'β'), + (0x3D1, 'M', 'θ'), + (0x3D2, 'M', 'υ'), + (0x3D3, 'M', 'ύ'), + (0x3D4, 'M', 'ϋ'), + (0x3D5, 'M', 'φ'), + (0x3D6, 'M', 'π'), + (0x3D7, 'V'), + (0x3D8, 'M', 'ϙ'), + (0x3D9, 'V'), + (0x3DA, 'M', 'ϛ'), + (0x3DB, 'V'), + (0x3DC, 'M', 'ϝ'), + (0x3DD, 'V'), + (0x3DE, 'M', 'ϟ'), + (0x3DF, 'V'), + (0x3E0, 'M', 'ϡ'), + (0x3E1, 'V'), + (0x3E2, 'M', 'ϣ'), + (0x3E3, 'V'), + (0x3E4, 'M', 'ϥ'), + (0x3E5, 'V'), + (0x3E6, 'M', 'ϧ'), + (0x3E7, 'V'), + (0x3E8, 'M', 'ϩ'), + (0x3E9, 'V'), + (0x3EA, 'M', 'ϫ'), + (0x3EB, 'V'), + (0x3EC, 'M', 'ϭ'), + (0x3ED, 'V'), + (0x3EE, 'M', 'ϯ'), + (0x3EF, 'V'), + (0x3F0, 'M', 'κ'), + (0x3F1, 'M', 'ρ'), + (0x3F2, 'M', 'σ'), + (0x3F3, 'V'), + (0x3F4, 'M', 'θ'), + (0x3F5, 'M', 'ε'), + (0x3F6, 'V'), + (0x3F7, 'M', 'ϸ'), + (0x3F8, 'V'), + (0x3F9, 'M', 'σ'), + (0x3FA, 'M', 'ϻ'), + (0x3FB, 'V'), + (0x3FD, 'M', 'ͻ'), + (0x3FE, 'M', 'ͼ'), + (0x3FF, 'M', 'ͽ'), + (0x400, 'M', 'ѐ'), + (0x401, 'M', 'ё'), + (0x402, 'M', 'ђ'), + ] + +def _seg_7() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x403, 'M', 'ѓ'), + (0x404, 'M', 'є'), + (0x405, 'M', 'ѕ'), + (0x406, 'M', 'і'), + (0x407, 'M', 'ї'), + (0x408, 'M', 'ј'), + (0x409, 'M', 'љ'), + (0x40A, 'M', 'њ'), + (0x40B, 'M', 'ћ'), + (0x40C, 'M', 'ќ'), + (0x40D, 'M', 'ѝ'), + (0x40E, 'M', 'ў'), + (0x40F, 'M', 'џ'), + (0x410, 'M', 'а'), + (0x411, 'M', 'б'), + (0x412, 'M', 'в'), + (0x413, 'M', 'г'), + (0x414, 'M', 'д'), + (0x415, 'M', 'е'), + (0x416, 'M', 'ж'), + (0x417, 'M', 'з'), + (0x418, 'M', 'и'), + (0x419, 'M', 'й'), + (0x41A, 'M', 'к'), + (0x41B, 'M', 'л'), + (0x41C, 'M', 'м'), + (0x41D, 'M', 'н'), + (0x41E, 'M', 'о'), + (0x41F, 'M', 'п'), + (0x420, 'M', 'р'), + (0x421, 'M', 'с'), + (0x422, 'M', 'т'), + (0x423, 'M', 'у'), + (0x424, 'M', 'ф'), + (0x425, 'M', 'х'), + (0x426, 'M', 'ц'), + (0x427, 'M', 'ч'), + (0x428, 'M', 'ш'), + (0x429, 'M', 'щ'), + (0x42A, 'M', 'ъ'), + (0x42B, 'M', 'ы'), + (0x42C, 'M', 'ь'), + (0x42D, 'M', 'э'), + (0x42E, 'M', 'ю'), + (0x42F, 'M', 'я'), + (0x430, 'V'), + (0x460, 'M', 'ѡ'), + (0x461, 'V'), + (0x462, 'M', 'ѣ'), + (0x463, 'V'), + (0x464, 'M', 'ѥ'), + (0x465, 'V'), + (0x466, 'M', 'ѧ'), + (0x467, 'V'), + (0x468, 'M', 'ѩ'), + (0x469, 'V'), + (0x46A, 'M', 'ѫ'), + (0x46B, 'V'), + (0x46C, 'M', 'ѭ'), + (0x46D, 'V'), + (0x46E, 'M', 'ѯ'), + (0x46F, 'V'), + (0x470, 'M', 'ѱ'), + (0x471, 'V'), + (0x472, 'M', 'ѳ'), + (0x473, 'V'), + (0x474, 'M', 'ѵ'), + (0x475, 'V'), + (0x476, 'M', 'ѷ'), + (0x477, 'V'), + (0x478, 'M', 'ѹ'), + (0x479, 'V'), + (0x47A, 'M', 'ѻ'), + (0x47B, 'V'), + (0x47C, 'M', 'ѽ'), + (0x47D, 'V'), + (0x47E, 'M', 'ѿ'), + (0x47F, 'V'), + (0x480, 'M', 'ҁ'), + (0x481, 'V'), + (0x48A, 'M', 'ҋ'), + (0x48B, 'V'), + (0x48C, 'M', 'ҍ'), + (0x48D, 'V'), + (0x48E, 'M', 'ҏ'), + (0x48F, 'V'), + (0x490, 'M', 'ґ'), + (0x491, 'V'), + (0x492, 'M', 'ғ'), + (0x493, 'V'), + (0x494, 'M', 'ҕ'), + (0x495, 'V'), + (0x496, 'M', 'җ'), + (0x497, 'V'), + (0x498, 'M', 'ҙ'), + (0x499, 'V'), + (0x49A, 'M', 'қ'), + (0x49B, 'V'), + (0x49C, 'M', 'ҝ'), + (0x49D, 'V'), + ] + +def _seg_8() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x49E, 'M', 'ҟ'), + (0x49F, 'V'), + (0x4A0, 'M', 'ҡ'), + (0x4A1, 'V'), + (0x4A2, 'M', 'ң'), + (0x4A3, 'V'), + (0x4A4, 'M', 'ҥ'), + (0x4A5, 'V'), + (0x4A6, 'M', 'ҧ'), + (0x4A7, 'V'), + (0x4A8, 'M', 'ҩ'), + (0x4A9, 'V'), + (0x4AA, 'M', 'ҫ'), + (0x4AB, 'V'), + (0x4AC, 'M', 'ҭ'), + (0x4AD, 'V'), + (0x4AE, 'M', 'ү'), + (0x4AF, 'V'), + (0x4B0, 'M', 'ұ'), + (0x4B1, 'V'), + (0x4B2, 'M', 'ҳ'), + (0x4B3, 'V'), + (0x4B4, 'M', 'ҵ'), + (0x4B5, 'V'), + (0x4B6, 'M', 'ҷ'), + (0x4B7, 'V'), + (0x4B8, 'M', 'ҹ'), + (0x4B9, 'V'), + (0x4BA, 'M', 'һ'), + (0x4BB, 'V'), + (0x4BC, 'M', 'ҽ'), + (0x4BD, 'V'), + (0x4BE, 'M', 'ҿ'), + (0x4BF, 'V'), + (0x4C0, 'X'), + (0x4C1, 'M', 'ӂ'), + (0x4C2, 'V'), + (0x4C3, 'M', 'ӄ'), + (0x4C4, 'V'), + (0x4C5, 'M', 'ӆ'), + (0x4C6, 'V'), + (0x4C7, 'M', 'ӈ'), + (0x4C8, 'V'), + (0x4C9, 'M', 'ӊ'), + (0x4CA, 'V'), + (0x4CB, 'M', 'ӌ'), + (0x4CC, 'V'), + (0x4CD, 'M', 'ӎ'), + (0x4CE, 'V'), + (0x4D0, 'M', 'ӑ'), + (0x4D1, 'V'), + (0x4D2, 'M', 'ӓ'), + (0x4D3, 'V'), + (0x4D4, 'M', 'ӕ'), + (0x4D5, 'V'), + (0x4D6, 'M', 'ӗ'), + (0x4D7, 'V'), + (0x4D8, 'M', 'ә'), + (0x4D9, 'V'), + (0x4DA, 'M', 'ӛ'), + (0x4DB, 'V'), + (0x4DC, 'M', 'ӝ'), + (0x4DD, 'V'), + (0x4DE, 'M', 'ӟ'), + (0x4DF, 'V'), + (0x4E0, 'M', 'ӡ'), + (0x4E1, 'V'), + (0x4E2, 'M', 'ӣ'), + (0x4E3, 'V'), + (0x4E4, 'M', 'ӥ'), + (0x4E5, 'V'), + (0x4E6, 'M', 'ӧ'), + (0x4E7, 'V'), + (0x4E8, 'M', 'ө'), + (0x4E9, 'V'), + (0x4EA, 'M', 'ӫ'), + (0x4EB, 'V'), + (0x4EC, 'M', 'ӭ'), + (0x4ED, 'V'), + (0x4EE, 'M', 'ӯ'), + (0x4EF, 'V'), + (0x4F0, 'M', 'ӱ'), + (0x4F1, 'V'), + (0x4F2, 'M', 'ӳ'), + (0x4F3, 'V'), + (0x4F4, 'M', 'ӵ'), + (0x4F5, 'V'), + (0x4F6, 'M', 'ӷ'), + (0x4F7, 'V'), + (0x4F8, 'M', 'ӹ'), + (0x4F9, 'V'), + (0x4FA, 'M', 'ӻ'), + (0x4FB, 'V'), + (0x4FC, 'M', 'ӽ'), + (0x4FD, 'V'), + (0x4FE, 'M', 'ӿ'), + (0x4FF, 'V'), + (0x500, 'M', 'ԁ'), + (0x501, 'V'), + (0x502, 'M', 'ԃ'), + ] + +def _seg_9() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x503, 'V'), + (0x504, 'M', 'ԅ'), + (0x505, 'V'), + (0x506, 'M', 'ԇ'), + (0x507, 'V'), + (0x508, 'M', 'ԉ'), + (0x509, 'V'), + (0x50A, 'M', 'ԋ'), + (0x50B, 'V'), + (0x50C, 'M', 'ԍ'), + (0x50D, 'V'), + (0x50E, 'M', 'ԏ'), + (0x50F, 'V'), + (0x510, 'M', 'ԑ'), + (0x511, 'V'), + (0x512, 'M', 'ԓ'), + (0x513, 'V'), + (0x514, 'M', 'ԕ'), + (0x515, 'V'), + (0x516, 'M', 'ԗ'), + (0x517, 'V'), + (0x518, 'M', 'ԙ'), + (0x519, 'V'), + (0x51A, 'M', 'ԛ'), + (0x51B, 'V'), + (0x51C, 'M', 'ԝ'), + (0x51D, 'V'), + (0x51E, 'M', 'ԟ'), + (0x51F, 'V'), + (0x520, 'M', 'ԡ'), + (0x521, 'V'), + (0x522, 'M', 'ԣ'), + (0x523, 'V'), + (0x524, 'M', 'ԥ'), + (0x525, 'V'), + (0x526, 'M', 'ԧ'), + (0x527, 'V'), + (0x528, 'M', 'ԩ'), + (0x529, 'V'), + (0x52A, 'M', 'ԫ'), + (0x52B, 'V'), + (0x52C, 'M', 'ԭ'), + (0x52D, 'V'), + (0x52E, 'M', 'ԯ'), + (0x52F, 'V'), + (0x530, 'X'), + (0x531, 'M', 'ա'), + (0x532, 'M', 'բ'), + (0x533, 'M', 'գ'), + (0x534, 'M', 'դ'), + (0x535, 'M', 'ե'), + (0x536, 'M', 'զ'), + (0x537, 'M', 'է'), + (0x538, 'M', 'ը'), + (0x539, 'M', 'թ'), + (0x53A, 'M', 'ժ'), + (0x53B, 'M', 'ի'), + (0x53C, 'M', 'լ'), + (0x53D, 'M', 'խ'), + (0x53E, 'M', 'ծ'), + (0x53F, 'M', 'կ'), + (0x540, 'M', 'հ'), + (0x541, 'M', 'ձ'), + (0x542, 'M', 'ղ'), + (0x543, 'M', 'ճ'), + (0x544, 'M', 'մ'), + (0x545, 'M', 'յ'), + (0x546, 'M', 'ն'), + (0x547, 'M', 'շ'), + (0x548, 'M', 'ո'), + (0x549, 'M', 'չ'), + (0x54A, 'M', 'պ'), + (0x54B, 'M', 'ջ'), + (0x54C, 'M', 'ռ'), + (0x54D, 'M', 'ս'), + (0x54E, 'M', 'վ'), + (0x54F, 'M', 'տ'), + (0x550, 'M', 'ր'), + (0x551, 'M', 'ց'), + (0x552, 'M', 'ւ'), + (0x553, 'M', 'փ'), + (0x554, 'M', 'ք'), + (0x555, 'M', 'օ'), + (0x556, 'M', 'ֆ'), + (0x557, 'X'), + (0x559, 'V'), + (0x587, 'M', 'եւ'), + (0x588, 'V'), + (0x58B, 'X'), + (0x58D, 'V'), + (0x590, 'X'), + (0x591, 'V'), + (0x5C8, 'X'), + (0x5D0, 'V'), + (0x5EB, 'X'), + (0x5EF, 'V'), + (0x5F5, 'X'), + (0x606, 'V'), + (0x61C, 'X'), + (0x61D, 'V'), + ] + +def _seg_10() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x675, 'M', 'اٴ'), + (0x676, 'M', 'وٴ'), + (0x677, 'M', 'ۇٴ'), + (0x678, 'M', 'يٴ'), + (0x679, 'V'), + (0x6DD, 'X'), + (0x6DE, 'V'), + (0x70E, 'X'), + (0x710, 'V'), + (0x74B, 'X'), + (0x74D, 'V'), + (0x7B2, 'X'), + (0x7C0, 'V'), + (0x7FB, 'X'), + (0x7FD, 'V'), + (0x82E, 'X'), + (0x830, 'V'), + (0x83F, 'X'), + (0x840, 'V'), + (0x85C, 'X'), + (0x85E, 'V'), + (0x85F, 'X'), + (0x860, 'V'), + (0x86B, 'X'), + (0x870, 'V'), + (0x88F, 'X'), + (0x898, 'V'), + (0x8E2, 'X'), + (0x8E3, 'V'), + (0x958, 'M', 'क़'), + (0x959, 'M', 'ख़'), + (0x95A, 'M', 'ग़'), + (0x95B, 'M', 'ज़'), + (0x95C, 'M', 'ड़'), + (0x95D, 'M', 'ढ़'), + (0x95E, 'M', 'फ़'), + (0x95F, 'M', 'य़'), + (0x960, 'V'), + (0x984, 'X'), + (0x985, 'V'), + (0x98D, 'X'), + (0x98F, 'V'), + (0x991, 'X'), + (0x993, 'V'), + (0x9A9, 'X'), + (0x9AA, 'V'), + (0x9B1, 'X'), + (0x9B2, 'V'), + (0x9B3, 'X'), + (0x9B6, 'V'), + (0x9BA, 'X'), + (0x9BC, 'V'), + (0x9C5, 'X'), + (0x9C7, 'V'), + (0x9C9, 'X'), + (0x9CB, 'V'), + (0x9CF, 'X'), + (0x9D7, 'V'), + (0x9D8, 'X'), + (0x9DC, 'M', 'ড়'), + (0x9DD, 'M', 'ঢ়'), + (0x9DE, 'X'), + (0x9DF, 'M', 'য়'), + (0x9E0, 'V'), + (0x9E4, 'X'), + (0x9E6, 'V'), + (0x9FF, 'X'), + (0xA01, 'V'), + (0xA04, 'X'), + (0xA05, 'V'), + (0xA0B, 'X'), + (0xA0F, 'V'), + (0xA11, 'X'), + (0xA13, 'V'), + (0xA29, 'X'), + (0xA2A, 'V'), + (0xA31, 'X'), + (0xA32, 'V'), + (0xA33, 'M', 'ਲ਼'), + (0xA34, 'X'), + (0xA35, 'V'), + (0xA36, 'M', 'ਸ਼'), + (0xA37, 'X'), + (0xA38, 'V'), + (0xA3A, 'X'), + (0xA3C, 'V'), + (0xA3D, 'X'), + (0xA3E, 'V'), + (0xA43, 'X'), + (0xA47, 'V'), + (0xA49, 'X'), + (0xA4B, 'V'), + (0xA4E, 'X'), + (0xA51, 'V'), + (0xA52, 'X'), + (0xA59, 'M', 'ਖ਼'), + (0xA5A, 'M', 'ਗ਼'), + (0xA5B, 'M', 'ਜ਼'), + (0xA5C, 'V'), + (0xA5D, 'X'), + ] + +def _seg_11() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xA5E, 'M', 'ਫ਼'), + (0xA5F, 'X'), + (0xA66, 'V'), + (0xA77, 'X'), + (0xA81, 'V'), + (0xA84, 'X'), + (0xA85, 'V'), + (0xA8E, 'X'), + (0xA8F, 'V'), + (0xA92, 'X'), + (0xA93, 'V'), + (0xAA9, 'X'), + (0xAAA, 'V'), + (0xAB1, 'X'), + (0xAB2, 'V'), + (0xAB4, 'X'), + (0xAB5, 'V'), + (0xABA, 'X'), + (0xABC, 'V'), + (0xAC6, 'X'), + (0xAC7, 'V'), + (0xACA, 'X'), + (0xACB, 'V'), + (0xACE, 'X'), + (0xAD0, 'V'), + (0xAD1, 'X'), + (0xAE0, 'V'), + (0xAE4, 'X'), + (0xAE6, 'V'), + (0xAF2, 'X'), + (0xAF9, 'V'), + (0xB00, 'X'), + (0xB01, 'V'), + (0xB04, 'X'), + (0xB05, 'V'), + (0xB0D, 'X'), + (0xB0F, 'V'), + (0xB11, 'X'), + (0xB13, 'V'), + (0xB29, 'X'), + (0xB2A, 'V'), + (0xB31, 'X'), + (0xB32, 'V'), + (0xB34, 'X'), + (0xB35, 'V'), + (0xB3A, 'X'), + (0xB3C, 'V'), + (0xB45, 'X'), + (0xB47, 'V'), + (0xB49, 'X'), + (0xB4B, 'V'), + (0xB4E, 'X'), + (0xB55, 'V'), + (0xB58, 'X'), + (0xB5C, 'M', 'ଡ଼'), + (0xB5D, 'M', 'ଢ଼'), + (0xB5E, 'X'), + (0xB5F, 'V'), + (0xB64, 'X'), + (0xB66, 'V'), + (0xB78, 'X'), + (0xB82, 'V'), + (0xB84, 'X'), + (0xB85, 'V'), + (0xB8B, 'X'), + (0xB8E, 'V'), + (0xB91, 'X'), + (0xB92, 'V'), + (0xB96, 'X'), + (0xB99, 'V'), + (0xB9B, 'X'), + (0xB9C, 'V'), + (0xB9D, 'X'), + (0xB9E, 'V'), + (0xBA0, 'X'), + (0xBA3, 'V'), + (0xBA5, 'X'), + (0xBA8, 'V'), + (0xBAB, 'X'), + (0xBAE, 'V'), + (0xBBA, 'X'), + (0xBBE, 'V'), + (0xBC3, 'X'), + (0xBC6, 'V'), + (0xBC9, 'X'), + (0xBCA, 'V'), + (0xBCE, 'X'), + (0xBD0, 'V'), + (0xBD1, 'X'), + (0xBD7, 'V'), + (0xBD8, 'X'), + (0xBE6, 'V'), + (0xBFB, 'X'), + (0xC00, 'V'), + (0xC0D, 'X'), + (0xC0E, 'V'), + (0xC11, 'X'), + (0xC12, 'V'), + (0xC29, 'X'), + (0xC2A, 'V'), + ] + +def _seg_12() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xC3A, 'X'), + (0xC3C, 'V'), + (0xC45, 'X'), + (0xC46, 'V'), + (0xC49, 'X'), + (0xC4A, 'V'), + (0xC4E, 'X'), + (0xC55, 'V'), + (0xC57, 'X'), + (0xC58, 'V'), + (0xC5B, 'X'), + (0xC5D, 'V'), + (0xC5E, 'X'), + (0xC60, 'V'), + (0xC64, 'X'), + (0xC66, 'V'), + (0xC70, 'X'), + (0xC77, 'V'), + (0xC8D, 'X'), + (0xC8E, 'V'), + (0xC91, 'X'), + (0xC92, 'V'), + (0xCA9, 'X'), + (0xCAA, 'V'), + (0xCB4, 'X'), + (0xCB5, 'V'), + (0xCBA, 'X'), + (0xCBC, 'V'), + (0xCC5, 'X'), + (0xCC6, 'V'), + (0xCC9, 'X'), + (0xCCA, 'V'), + (0xCCE, 'X'), + (0xCD5, 'V'), + (0xCD7, 'X'), + (0xCDD, 'V'), + (0xCDF, 'X'), + (0xCE0, 'V'), + (0xCE4, 'X'), + (0xCE6, 'V'), + (0xCF0, 'X'), + (0xCF1, 'V'), + (0xCF4, 'X'), + (0xD00, 'V'), + (0xD0D, 'X'), + (0xD0E, 'V'), + (0xD11, 'X'), + (0xD12, 'V'), + (0xD45, 'X'), + (0xD46, 'V'), + (0xD49, 'X'), + (0xD4A, 'V'), + (0xD50, 'X'), + (0xD54, 'V'), + (0xD64, 'X'), + (0xD66, 'V'), + (0xD80, 'X'), + (0xD81, 'V'), + (0xD84, 'X'), + (0xD85, 'V'), + (0xD97, 'X'), + (0xD9A, 'V'), + (0xDB2, 'X'), + (0xDB3, 'V'), + (0xDBC, 'X'), + (0xDBD, 'V'), + (0xDBE, 'X'), + (0xDC0, 'V'), + (0xDC7, 'X'), + (0xDCA, 'V'), + (0xDCB, 'X'), + (0xDCF, 'V'), + (0xDD5, 'X'), + (0xDD6, 'V'), + (0xDD7, 'X'), + (0xDD8, 'V'), + (0xDE0, 'X'), + (0xDE6, 'V'), + (0xDF0, 'X'), + (0xDF2, 'V'), + (0xDF5, 'X'), + (0xE01, 'V'), + (0xE33, 'M', 'ํา'), + (0xE34, 'V'), + (0xE3B, 'X'), + (0xE3F, 'V'), + (0xE5C, 'X'), + (0xE81, 'V'), + (0xE83, 'X'), + (0xE84, 'V'), + (0xE85, 'X'), + (0xE86, 'V'), + (0xE8B, 'X'), + (0xE8C, 'V'), + (0xEA4, 'X'), + (0xEA5, 'V'), + (0xEA6, 'X'), + (0xEA7, 'V'), + (0xEB3, 'M', 'ໍາ'), + (0xEB4, 'V'), + ] + +def _seg_13() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xEBE, 'X'), + (0xEC0, 'V'), + (0xEC5, 'X'), + (0xEC6, 'V'), + (0xEC7, 'X'), + (0xEC8, 'V'), + (0xECF, 'X'), + (0xED0, 'V'), + (0xEDA, 'X'), + (0xEDC, 'M', 'ຫນ'), + (0xEDD, 'M', 'ຫມ'), + (0xEDE, 'V'), + (0xEE0, 'X'), + (0xF00, 'V'), + (0xF0C, 'M', '་'), + (0xF0D, 'V'), + (0xF43, 'M', 'གྷ'), + (0xF44, 'V'), + (0xF48, 'X'), + (0xF49, 'V'), + (0xF4D, 'M', 'ཌྷ'), + (0xF4E, 'V'), + (0xF52, 'M', 'དྷ'), + (0xF53, 'V'), + (0xF57, 'M', 'བྷ'), + (0xF58, 'V'), + (0xF5C, 'M', 'ཛྷ'), + (0xF5D, 'V'), + (0xF69, 'M', 'ཀྵ'), + (0xF6A, 'V'), + (0xF6D, 'X'), + (0xF71, 'V'), + (0xF73, 'M', 'ཱི'), + (0xF74, 'V'), + (0xF75, 'M', 'ཱུ'), + (0xF76, 'M', 'ྲྀ'), + (0xF77, 'M', 'ྲཱྀ'), + (0xF78, 'M', 'ླྀ'), + (0xF79, 'M', 'ླཱྀ'), + (0xF7A, 'V'), + (0xF81, 'M', 'ཱྀ'), + (0xF82, 'V'), + (0xF93, 'M', 'ྒྷ'), + (0xF94, 'V'), + (0xF98, 'X'), + (0xF99, 'V'), + (0xF9D, 'M', 'ྜྷ'), + (0xF9E, 'V'), + (0xFA2, 'M', 'ྡྷ'), + (0xFA3, 'V'), + (0xFA7, 'M', 'ྦྷ'), + (0xFA8, 'V'), + (0xFAC, 'M', 'ྫྷ'), + (0xFAD, 'V'), + (0xFB9, 'M', 'ྐྵ'), + (0xFBA, 'V'), + (0xFBD, 'X'), + (0xFBE, 'V'), + (0xFCD, 'X'), + (0xFCE, 'V'), + (0xFDB, 'X'), + (0x1000, 'V'), + (0x10A0, 'X'), + (0x10C7, 'M', 'ⴧ'), + (0x10C8, 'X'), + (0x10CD, 'M', 'ⴭ'), + (0x10CE, 'X'), + (0x10D0, 'V'), + (0x10FC, 'M', 'ნ'), + (0x10FD, 'V'), + (0x115F, 'X'), + (0x1161, 'V'), + (0x1249, 'X'), + (0x124A, 'V'), + (0x124E, 'X'), + (0x1250, 'V'), + (0x1257, 'X'), + (0x1258, 'V'), + (0x1259, 'X'), + (0x125A, 'V'), + (0x125E, 'X'), + (0x1260, 'V'), + (0x1289, 'X'), + (0x128A, 'V'), + (0x128E, 'X'), + (0x1290, 'V'), + (0x12B1, 'X'), + (0x12B2, 'V'), + (0x12B6, 'X'), + (0x12B8, 'V'), + (0x12BF, 'X'), + (0x12C0, 'V'), + (0x12C1, 'X'), + (0x12C2, 'V'), + (0x12C6, 'X'), + (0x12C8, 'V'), + (0x12D7, 'X'), + (0x12D8, 'V'), + (0x1311, 'X'), + (0x1312, 'V'), + ] + +def _seg_14() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1316, 'X'), + (0x1318, 'V'), + (0x135B, 'X'), + (0x135D, 'V'), + (0x137D, 'X'), + (0x1380, 'V'), + (0x139A, 'X'), + (0x13A0, 'V'), + (0x13F6, 'X'), + (0x13F8, 'M', 'Ᏸ'), + (0x13F9, 'M', 'Ᏹ'), + (0x13FA, 'M', 'Ᏺ'), + (0x13FB, 'M', 'Ᏻ'), + (0x13FC, 'M', 'Ᏼ'), + (0x13FD, 'M', 'Ᏽ'), + (0x13FE, 'X'), + (0x1400, 'V'), + (0x1680, 'X'), + (0x1681, 'V'), + (0x169D, 'X'), + (0x16A0, 'V'), + (0x16F9, 'X'), + (0x1700, 'V'), + (0x1716, 'X'), + (0x171F, 'V'), + (0x1737, 'X'), + (0x1740, 'V'), + (0x1754, 'X'), + (0x1760, 'V'), + (0x176D, 'X'), + (0x176E, 'V'), + (0x1771, 'X'), + (0x1772, 'V'), + (0x1774, 'X'), + (0x1780, 'V'), + (0x17B4, 'X'), + (0x17B6, 'V'), + (0x17DE, 'X'), + (0x17E0, 'V'), + (0x17EA, 'X'), + (0x17F0, 'V'), + (0x17FA, 'X'), + (0x1800, 'V'), + (0x1806, 'X'), + (0x1807, 'V'), + (0x180B, 'I'), + (0x180E, 'X'), + (0x180F, 'I'), + (0x1810, 'V'), + (0x181A, 'X'), + (0x1820, 'V'), + (0x1879, 'X'), + (0x1880, 'V'), + (0x18AB, 'X'), + (0x18B0, 'V'), + (0x18F6, 'X'), + (0x1900, 'V'), + (0x191F, 'X'), + (0x1920, 'V'), + (0x192C, 'X'), + (0x1930, 'V'), + (0x193C, 'X'), + (0x1940, 'V'), + (0x1941, 'X'), + (0x1944, 'V'), + (0x196E, 'X'), + (0x1970, 'V'), + (0x1975, 'X'), + (0x1980, 'V'), + (0x19AC, 'X'), + (0x19B0, 'V'), + (0x19CA, 'X'), + (0x19D0, 'V'), + (0x19DB, 'X'), + (0x19DE, 'V'), + (0x1A1C, 'X'), + (0x1A1E, 'V'), + (0x1A5F, 'X'), + (0x1A60, 'V'), + (0x1A7D, 'X'), + (0x1A7F, 'V'), + (0x1A8A, 'X'), + (0x1A90, 'V'), + (0x1A9A, 'X'), + (0x1AA0, 'V'), + (0x1AAE, 'X'), + (0x1AB0, 'V'), + (0x1ACF, 'X'), + (0x1B00, 'V'), + (0x1B4D, 'X'), + (0x1B50, 'V'), + (0x1B7F, 'X'), + (0x1B80, 'V'), + (0x1BF4, 'X'), + (0x1BFC, 'V'), + (0x1C38, 'X'), + (0x1C3B, 'V'), + (0x1C4A, 'X'), + (0x1C4D, 'V'), + (0x1C80, 'M', 'в'), + ] + +def _seg_15() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1C81, 'M', 'д'), + (0x1C82, 'M', 'о'), + (0x1C83, 'M', 'с'), + (0x1C84, 'M', 'т'), + (0x1C86, 'M', 'ъ'), + (0x1C87, 'M', 'ѣ'), + (0x1C88, 'M', 'ꙋ'), + (0x1C89, 'X'), + (0x1C90, 'M', 'ა'), + (0x1C91, 'M', 'ბ'), + (0x1C92, 'M', 'გ'), + (0x1C93, 'M', 'დ'), + (0x1C94, 'M', 'ე'), + (0x1C95, 'M', 'ვ'), + (0x1C96, 'M', 'ზ'), + (0x1C97, 'M', 'თ'), + (0x1C98, 'M', 'ი'), + (0x1C99, 'M', 'კ'), + (0x1C9A, 'M', 'ლ'), + (0x1C9B, 'M', 'მ'), + (0x1C9C, 'M', 'ნ'), + (0x1C9D, 'M', 'ო'), + (0x1C9E, 'M', 'პ'), + (0x1C9F, 'M', 'ჟ'), + (0x1CA0, 'M', 'რ'), + (0x1CA1, 'M', 'ს'), + (0x1CA2, 'M', 'ტ'), + (0x1CA3, 'M', 'უ'), + (0x1CA4, 'M', 'ფ'), + (0x1CA5, 'M', 'ქ'), + (0x1CA6, 'M', 'ღ'), + (0x1CA7, 'M', 'ყ'), + (0x1CA8, 'M', 'შ'), + (0x1CA9, 'M', 'ჩ'), + (0x1CAA, 'M', 'ც'), + (0x1CAB, 'M', 'ძ'), + (0x1CAC, 'M', 'წ'), + (0x1CAD, 'M', 'ჭ'), + (0x1CAE, 'M', 'ხ'), + (0x1CAF, 'M', 'ჯ'), + (0x1CB0, 'M', 'ჰ'), + (0x1CB1, 'M', 'ჱ'), + (0x1CB2, 'M', 'ჲ'), + (0x1CB3, 'M', 'ჳ'), + (0x1CB4, 'M', 'ჴ'), + (0x1CB5, 'M', 'ჵ'), + (0x1CB6, 'M', 'ჶ'), + (0x1CB7, 'M', 'ჷ'), + (0x1CB8, 'M', 'ჸ'), + (0x1CB9, 'M', 'ჹ'), + (0x1CBA, 'M', 'ჺ'), + (0x1CBB, 'X'), + (0x1CBD, 'M', 'ჽ'), + (0x1CBE, 'M', 'ჾ'), + (0x1CBF, 'M', 'ჿ'), + (0x1CC0, 'V'), + (0x1CC8, 'X'), + (0x1CD0, 'V'), + (0x1CFB, 'X'), + (0x1D00, 'V'), + (0x1D2C, 'M', 'a'), + (0x1D2D, 'M', 'æ'), + (0x1D2E, 'M', 'b'), + (0x1D2F, 'V'), + (0x1D30, 'M', 'd'), + (0x1D31, 'M', 'e'), + (0x1D32, 'M', 'ǝ'), + (0x1D33, 'M', 'g'), + (0x1D34, 'M', 'h'), + (0x1D35, 'M', 'i'), + (0x1D36, 'M', 'j'), + (0x1D37, 'M', 'k'), + (0x1D38, 'M', 'l'), + (0x1D39, 'M', 'm'), + (0x1D3A, 'M', 'n'), + (0x1D3B, 'V'), + (0x1D3C, 'M', 'o'), + (0x1D3D, 'M', 'ȣ'), + (0x1D3E, 'M', 'p'), + (0x1D3F, 'M', 'r'), + (0x1D40, 'M', 't'), + (0x1D41, 'M', 'u'), + (0x1D42, 'M', 'w'), + (0x1D43, 'M', 'a'), + (0x1D44, 'M', 'ɐ'), + (0x1D45, 'M', 'ɑ'), + (0x1D46, 'M', 'ᴂ'), + (0x1D47, 'M', 'b'), + (0x1D48, 'M', 'd'), + (0x1D49, 'M', 'e'), + (0x1D4A, 'M', 'ə'), + (0x1D4B, 'M', 'ɛ'), + (0x1D4C, 'M', 'ɜ'), + (0x1D4D, 'M', 'g'), + (0x1D4E, 'V'), + (0x1D4F, 'M', 'k'), + (0x1D50, 'M', 'm'), + (0x1D51, 'M', 'ŋ'), + (0x1D52, 'M', 'o'), + (0x1D53, 'M', 'ɔ'), + ] + +def _seg_16() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1D54, 'M', 'ᴖ'), + (0x1D55, 'M', 'ᴗ'), + (0x1D56, 'M', 'p'), + (0x1D57, 'M', 't'), + (0x1D58, 'M', 'u'), + (0x1D59, 'M', 'ᴝ'), + (0x1D5A, 'M', 'ɯ'), + (0x1D5B, 'M', 'v'), + (0x1D5C, 'M', 'ᴥ'), + (0x1D5D, 'M', 'β'), + (0x1D5E, 'M', 'γ'), + (0x1D5F, 'M', 'δ'), + (0x1D60, 'M', 'φ'), + (0x1D61, 'M', 'χ'), + (0x1D62, 'M', 'i'), + (0x1D63, 'M', 'r'), + (0x1D64, 'M', 'u'), + (0x1D65, 'M', 'v'), + (0x1D66, 'M', 'β'), + (0x1D67, 'M', 'γ'), + (0x1D68, 'M', 'ρ'), + (0x1D69, 'M', 'φ'), + (0x1D6A, 'M', 'χ'), + (0x1D6B, 'V'), + (0x1D78, 'M', 'н'), + (0x1D79, 'V'), + (0x1D9B, 'M', 'ɒ'), + (0x1D9C, 'M', 'c'), + (0x1D9D, 'M', 'ɕ'), + (0x1D9E, 'M', 'ð'), + (0x1D9F, 'M', 'ɜ'), + (0x1DA0, 'M', 'f'), + (0x1DA1, 'M', 'ɟ'), + (0x1DA2, 'M', 'ɡ'), + (0x1DA3, 'M', 'ɥ'), + (0x1DA4, 'M', 'ɨ'), + (0x1DA5, 'M', 'ɩ'), + (0x1DA6, 'M', 'ɪ'), + (0x1DA7, 'M', 'ᵻ'), + (0x1DA8, 'M', 'ʝ'), + (0x1DA9, 'M', 'ɭ'), + (0x1DAA, 'M', 'ᶅ'), + (0x1DAB, 'M', 'ʟ'), + (0x1DAC, 'M', 'ɱ'), + (0x1DAD, 'M', 'ɰ'), + (0x1DAE, 'M', 'ɲ'), + (0x1DAF, 'M', 'ɳ'), + (0x1DB0, 'M', 'ɴ'), + (0x1DB1, 'M', 'ɵ'), + (0x1DB2, 'M', 'ɸ'), + (0x1DB3, 'M', 'ʂ'), + (0x1DB4, 'M', 'ʃ'), + (0x1DB5, 'M', 'ƫ'), + (0x1DB6, 'M', 'ʉ'), + (0x1DB7, 'M', 'ʊ'), + (0x1DB8, 'M', 'ᴜ'), + (0x1DB9, 'M', 'ʋ'), + (0x1DBA, 'M', 'ʌ'), + (0x1DBB, 'M', 'z'), + (0x1DBC, 'M', 'ʐ'), + (0x1DBD, 'M', 'ʑ'), + (0x1DBE, 'M', 'ʒ'), + (0x1DBF, 'M', 'θ'), + (0x1DC0, 'V'), + (0x1E00, 'M', 'ḁ'), + (0x1E01, 'V'), + (0x1E02, 'M', 'ḃ'), + (0x1E03, 'V'), + (0x1E04, 'M', 'ḅ'), + (0x1E05, 'V'), + (0x1E06, 'M', 'ḇ'), + (0x1E07, 'V'), + (0x1E08, 'M', 'ḉ'), + (0x1E09, 'V'), + (0x1E0A, 'M', 'ḋ'), + (0x1E0B, 'V'), + (0x1E0C, 'M', 'ḍ'), + (0x1E0D, 'V'), + (0x1E0E, 'M', 'ḏ'), + (0x1E0F, 'V'), + (0x1E10, 'M', 'ḑ'), + (0x1E11, 'V'), + (0x1E12, 'M', 'ḓ'), + (0x1E13, 'V'), + (0x1E14, 'M', 'ḕ'), + (0x1E15, 'V'), + (0x1E16, 'M', 'ḗ'), + (0x1E17, 'V'), + (0x1E18, 'M', 'ḙ'), + (0x1E19, 'V'), + (0x1E1A, 'M', 'ḛ'), + (0x1E1B, 'V'), + (0x1E1C, 'M', 'ḝ'), + (0x1E1D, 'V'), + (0x1E1E, 'M', 'ḟ'), + (0x1E1F, 'V'), + (0x1E20, 'M', 'ḡ'), + (0x1E21, 'V'), + (0x1E22, 'M', 'ḣ'), + (0x1E23, 'V'), + ] + +def _seg_17() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1E24, 'M', 'ḥ'), + (0x1E25, 'V'), + (0x1E26, 'M', 'ḧ'), + (0x1E27, 'V'), + (0x1E28, 'M', 'ḩ'), + (0x1E29, 'V'), + (0x1E2A, 'M', 'ḫ'), + (0x1E2B, 'V'), + (0x1E2C, 'M', 'ḭ'), + (0x1E2D, 'V'), + (0x1E2E, 'M', 'ḯ'), + (0x1E2F, 'V'), + (0x1E30, 'M', 'ḱ'), + (0x1E31, 'V'), + (0x1E32, 'M', 'ḳ'), + (0x1E33, 'V'), + (0x1E34, 'M', 'ḵ'), + (0x1E35, 'V'), + (0x1E36, 'M', 'ḷ'), + (0x1E37, 'V'), + (0x1E38, 'M', 'ḹ'), + (0x1E39, 'V'), + (0x1E3A, 'M', 'ḻ'), + (0x1E3B, 'V'), + (0x1E3C, 'M', 'ḽ'), + (0x1E3D, 'V'), + (0x1E3E, 'M', 'ḿ'), + (0x1E3F, 'V'), + (0x1E40, 'M', 'ṁ'), + (0x1E41, 'V'), + (0x1E42, 'M', 'ṃ'), + (0x1E43, 'V'), + (0x1E44, 'M', 'ṅ'), + (0x1E45, 'V'), + (0x1E46, 'M', 'ṇ'), + (0x1E47, 'V'), + (0x1E48, 'M', 'ṉ'), + (0x1E49, 'V'), + (0x1E4A, 'M', 'ṋ'), + (0x1E4B, 'V'), + (0x1E4C, 'M', 'ṍ'), + (0x1E4D, 'V'), + (0x1E4E, 'M', 'ṏ'), + (0x1E4F, 'V'), + (0x1E50, 'M', 'ṑ'), + (0x1E51, 'V'), + (0x1E52, 'M', 'ṓ'), + (0x1E53, 'V'), + (0x1E54, 'M', 'ṕ'), + (0x1E55, 'V'), + (0x1E56, 'M', 'ṗ'), + (0x1E57, 'V'), + (0x1E58, 'M', 'ṙ'), + (0x1E59, 'V'), + (0x1E5A, 'M', 'ṛ'), + (0x1E5B, 'V'), + (0x1E5C, 'M', 'ṝ'), + (0x1E5D, 'V'), + (0x1E5E, 'M', 'ṟ'), + (0x1E5F, 'V'), + (0x1E60, 'M', 'ṡ'), + (0x1E61, 'V'), + (0x1E62, 'M', 'ṣ'), + (0x1E63, 'V'), + (0x1E64, 'M', 'ṥ'), + (0x1E65, 'V'), + (0x1E66, 'M', 'ṧ'), + (0x1E67, 'V'), + (0x1E68, 'M', 'ṩ'), + (0x1E69, 'V'), + (0x1E6A, 'M', 'ṫ'), + (0x1E6B, 'V'), + (0x1E6C, 'M', 'ṭ'), + (0x1E6D, 'V'), + (0x1E6E, 'M', 'ṯ'), + (0x1E6F, 'V'), + (0x1E70, 'M', 'ṱ'), + (0x1E71, 'V'), + (0x1E72, 'M', 'ṳ'), + (0x1E73, 'V'), + (0x1E74, 'M', 'ṵ'), + (0x1E75, 'V'), + (0x1E76, 'M', 'ṷ'), + (0x1E77, 'V'), + (0x1E78, 'M', 'ṹ'), + (0x1E79, 'V'), + (0x1E7A, 'M', 'ṻ'), + (0x1E7B, 'V'), + (0x1E7C, 'M', 'ṽ'), + (0x1E7D, 'V'), + (0x1E7E, 'M', 'ṿ'), + (0x1E7F, 'V'), + (0x1E80, 'M', 'ẁ'), + (0x1E81, 'V'), + (0x1E82, 'M', 'ẃ'), + (0x1E83, 'V'), + (0x1E84, 'M', 'ẅ'), + (0x1E85, 'V'), + (0x1E86, 'M', 'ẇ'), + (0x1E87, 'V'), + ] + +def _seg_18() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1E88, 'M', 'ẉ'), + (0x1E89, 'V'), + (0x1E8A, 'M', 'ẋ'), + (0x1E8B, 'V'), + (0x1E8C, 'M', 'ẍ'), + (0x1E8D, 'V'), + (0x1E8E, 'M', 'ẏ'), + (0x1E8F, 'V'), + (0x1E90, 'M', 'ẑ'), + (0x1E91, 'V'), + (0x1E92, 'M', 'ẓ'), + (0x1E93, 'V'), + (0x1E94, 'M', 'ẕ'), + (0x1E95, 'V'), + (0x1E9A, 'M', 'aʾ'), + (0x1E9B, 'M', 'ṡ'), + (0x1E9C, 'V'), + (0x1E9E, 'M', 'ß'), + (0x1E9F, 'V'), + (0x1EA0, 'M', 'ạ'), + (0x1EA1, 'V'), + (0x1EA2, 'M', 'ả'), + (0x1EA3, 'V'), + (0x1EA4, 'M', 'ấ'), + (0x1EA5, 'V'), + (0x1EA6, 'M', 'ầ'), + (0x1EA7, 'V'), + (0x1EA8, 'M', 'ẩ'), + (0x1EA9, 'V'), + (0x1EAA, 'M', 'ẫ'), + (0x1EAB, 'V'), + (0x1EAC, 'M', 'ậ'), + (0x1EAD, 'V'), + (0x1EAE, 'M', 'ắ'), + (0x1EAF, 'V'), + (0x1EB0, 'M', 'ằ'), + (0x1EB1, 'V'), + (0x1EB2, 'M', 'ẳ'), + (0x1EB3, 'V'), + (0x1EB4, 'M', 'ẵ'), + (0x1EB5, 'V'), + (0x1EB6, 'M', 'ặ'), + (0x1EB7, 'V'), + (0x1EB8, 'M', 'ẹ'), + (0x1EB9, 'V'), + (0x1EBA, 'M', 'ẻ'), + (0x1EBB, 'V'), + (0x1EBC, 'M', 'ẽ'), + (0x1EBD, 'V'), + (0x1EBE, 'M', 'ế'), + (0x1EBF, 'V'), + (0x1EC0, 'M', 'ề'), + (0x1EC1, 'V'), + (0x1EC2, 'M', 'ể'), + (0x1EC3, 'V'), + (0x1EC4, 'M', 'ễ'), + (0x1EC5, 'V'), + (0x1EC6, 'M', 'ệ'), + (0x1EC7, 'V'), + (0x1EC8, 'M', 'ỉ'), + (0x1EC9, 'V'), + (0x1ECA, 'M', 'ị'), + (0x1ECB, 'V'), + (0x1ECC, 'M', 'ọ'), + (0x1ECD, 'V'), + (0x1ECE, 'M', 'ỏ'), + (0x1ECF, 'V'), + (0x1ED0, 'M', 'ố'), + (0x1ED1, 'V'), + (0x1ED2, 'M', 'ồ'), + (0x1ED3, 'V'), + (0x1ED4, 'M', 'ổ'), + (0x1ED5, 'V'), + (0x1ED6, 'M', 'ỗ'), + (0x1ED7, 'V'), + (0x1ED8, 'M', 'ộ'), + (0x1ED9, 'V'), + (0x1EDA, 'M', 'ớ'), + (0x1EDB, 'V'), + (0x1EDC, 'M', 'ờ'), + (0x1EDD, 'V'), + (0x1EDE, 'M', 'ở'), + (0x1EDF, 'V'), + (0x1EE0, 'M', 'ỡ'), + (0x1EE1, 'V'), + (0x1EE2, 'M', 'ợ'), + (0x1EE3, 'V'), + (0x1EE4, 'M', 'ụ'), + (0x1EE5, 'V'), + (0x1EE6, 'M', 'ủ'), + (0x1EE7, 'V'), + (0x1EE8, 'M', 'ứ'), + (0x1EE9, 'V'), + (0x1EEA, 'M', 'ừ'), + (0x1EEB, 'V'), + (0x1EEC, 'M', 'ử'), + (0x1EED, 'V'), + (0x1EEE, 'M', 'ữ'), + (0x1EEF, 'V'), + (0x1EF0, 'M', 'ự'), + ] + +def _seg_19() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1EF1, 'V'), + (0x1EF2, 'M', 'ỳ'), + (0x1EF3, 'V'), + (0x1EF4, 'M', 'ỵ'), + (0x1EF5, 'V'), + (0x1EF6, 'M', 'ỷ'), + (0x1EF7, 'V'), + (0x1EF8, 'M', 'ỹ'), + (0x1EF9, 'V'), + (0x1EFA, 'M', 'ỻ'), + (0x1EFB, 'V'), + (0x1EFC, 'M', 'ỽ'), + (0x1EFD, 'V'), + (0x1EFE, 'M', 'ỿ'), + (0x1EFF, 'V'), + (0x1F08, 'M', 'ἀ'), + (0x1F09, 'M', 'ἁ'), + (0x1F0A, 'M', 'ἂ'), + (0x1F0B, 'M', 'ἃ'), + (0x1F0C, 'M', 'ἄ'), + (0x1F0D, 'M', 'ἅ'), + (0x1F0E, 'M', 'ἆ'), + (0x1F0F, 'M', 'ἇ'), + (0x1F10, 'V'), + (0x1F16, 'X'), + (0x1F18, 'M', 'ἐ'), + (0x1F19, 'M', 'ἑ'), + (0x1F1A, 'M', 'ἒ'), + (0x1F1B, 'M', 'ἓ'), + (0x1F1C, 'M', 'ἔ'), + (0x1F1D, 'M', 'ἕ'), + (0x1F1E, 'X'), + (0x1F20, 'V'), + (0x1F28, 'M', 'ἠ'), + (0x1F29, 'M', 'ἡ'), + (0x1F2A, 'M', 'ἢ'), + (0x1F2B, 'M', 'ἣ'), + (0x1F2C, 'M', 'ἤ'), + (0x1F2D, 'M', 'ἥ'), + (0x1F2E, 'M', 'ἦ'), + (0x1F2F, 'M', 'ἧ'), + (0x1F30, 'V'), + (0x1F38, 'M', 'ἰ'), + (0x1F39, 'M', 'ἱ'), + (0x1F3A, 'M', 'ἲ'), + (0x1F3B, 'M', 'ἳ'), + (0x1F3C, 'M', 'ἴ'), + (0x1F3D, 'M', 'ἵ'), + (0x1F3E, 'M', 'ἶ'), + (0x1F3F, 'M', 'ἷ'), + (0x1F40, 'V'), + (0x1F46, 'X'), + (0x1F48, 'M', 'ὀ'), + (0x1F49, 'M', 'ὁ'), + (0x1F4A, 'M', 'ὂ'), + (0x1F4B, 'M', 'ὃ'), + (0x1F4C, 'M', 'ὄ'), + (0x1F4D, 'M', 'ὅ'), + (0x1F4E, 'X'), + (0x1F50, 'V'), + (0x1F58, 'X'), + (0x1F59, 'M', 'ὑ'), + (0x1F5A, 'X'), + (0x1F5B, 'M', 'ὓ'), + (0x1F5C, 'X'), + (0x1F5D, 'M', 'ὕ'), + (0x1F5E, 'X'), + (0x1F5F, 'M', 'ὗ'), + (0x1F60, 'V'), + (0x1F68, 'M', 'ὠ'), + (0x1F69, 'M', 'ὡ'), + (0x1F6A, 'M', 'ὢ'), + (0x1F6B, 'M', 'ὣ'), + (0x1F6C, 'M', 'ὤ'), + (0x1F6D, 'M', 'ὥ'), + (0x1F6E, 'M', 'ὦ'), + (0x1F6F, 'M', 'ὧ'), + (0x1F70, 'V'), + (0x1F71, 'M', 'ά'), + (0x1F72, 'V'), + (0x1F73, 'M', 'έ'), + (0x1F74, 'V'), + (0x1F75, 'M', 'ή'), + (0x1F76, 'V'), + (0x1F77, 'M', 'ί'), + (0x1F78, 'V'), + (0x1F79, 'M', 'ό'), + (0x1F7A, 'V'), + (0x1F7B, 'M', 'ύ'), + (0x1F7C, 'V'), + (0x1F7D, 'M', 'ώ'), + (0x1F7E, 'X'), + (0x1F80, 'M', 'ἀι'), + (0x1F81, 'M', 'ἁι'), + (0x1F82, 'M', 'ἂι'), + (0x1F83, 'M', 'ἃι'), + (0x1F84, 'M', 'ἄι'), + (0x1F85, 'M', 'ἅι'), + (0x1F86, 'M', 'ἆι'), + (0x1F87, 'M', 'ἇι'), + ] + +def _seg_20() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1F88, 'M', 'ἀι'), + (0x1F89, 'M', 'ἁι'), + (0x1F8A, 'M', 'ἂι'), + (0x1F8B, 'M', 'ἃι'), + (0x1F8C, 'M', 'ἄι'), + (0x1F8D, 'M', 'ἅι'), + (0x1F8E, 'M', 'ἆι'), + (0x1F8F, 'M', 'ἇι'), + (0x1F90, 'M', 'ἠι'), + (0x1F91, 'M', 'ἡι'), + (0x1F92, 'M', 'ἢι'), + (0x1F93, 'M', 'ἣι'), + (0x1F94, 'M', 'ἤι'), + (0x1F95, 'M', 'ἥι'), + (0x1F96, 'M', 'ἦι'), + (0x1F97, 'M', 'ἧι'), + (0x1F98, 'M', 'ἠι'), + (0x1F99, 'M', 'ἡι'), + (0x1F9A, 'M', 'ἢι'), + (0x1F9B, 'M', 'ἣι'), + (0x1F9C, 'M', 'ἤι'), + (0x1F9D, 'M', 'ἥι'), + (0x1F9E, 'M', 'ἦι'), + (0x1F9F, 'M', 'ἧι'), + (0x1FA0, 'M', 'ὠι'), + (0x1FA1, 'M', 'ὡι'), + (0x1FA2, 'M', 'ὢι'), + (0x1FA3, 'M', 'ὣι'), + (0x1FA4, 'M', 'ὤι'), + (0x1FA5, 'M', 'ὥι'), + (0x1FA6, 'M', 'ὦι'), + (0x1FA7, 'M', 'ὧι'), + (0x1FA8, 'M', 'ὠι'), + (0x1FA9, 'M', 'ὡι'), + (0x1FAA, 'M', 'ὢι'), + (0x1FAB, 'M', 'ὣι'), + (0x1FAC, 'M', 'ὤι'), + (0x1FAD, 'M', 'ὥι'), + (0x1FAE, 'M', 'ὦι'), + (0x1FAF, 'M', 'ὧι'), + (0x1FB0, 'V'), + (0x1FB2, 'M', 'ὰι'), + (0x1FB3, 'M', 'αι'), + (0x1FB4, 'M', 'άι'), + (0x1FB5, 'X'), + (0x1FB6, 'V'), + (0x1FB7, 'M', 'ᾶι'), + (0x1FB8, 'M', 'ᾰ'), + (0x1FB9, 'M', 'ᾱ'), + (0x1FBA, 'M', 'ὰ'), + (0x1FBB, 'M', 'ά'), + (0x1FBC, 'M', 'αι'), + (0x1FBD, '3', ' ̓'), + (0x1FBE, 'M', 'ι'), + (0x1FBF, '3', ' ̓'), + (0x1FC0, '3', ' ͂'), + (0x1FC1, '3', ' ̈͂'), + (0x1FC2, 'M', 'ὴι'), + (0x1FC3, 'M', 'ηι'), + (0x1FC4, 'M', 'ήι'), + (0x1FC5, 'X'), + (0x1FC6, 'V'), + (0x1FC7, 'M', 'ῆι'), + (0x1FC8, 'M', 'ὲ'), + (0x1FC9, 'M', 'έ'), + (0x1FCA, 'M', 'ὴ'), + (0x1FCB, 'M', 'ή'), + (0x1FCC, 'M', 'ηι'), + (0x1FCD, '3', ' ̓̀'), + (0x1FCE, '3', ' ̓́'), + (0x1FCF, '3', ' ̓͂'), + (0x1FD0, 'V'), + (0x1FD3, 'M', 'ΐ'), + (0x1FD4, 'X'), + (0x1FD6, 'V'), + (0x1FD8, 'M', 'ῐ'), + (0x1FD9, 'M', 'ῑ'), + (0x1FDA, 'M', 'ὶ'), + (0x1FDB, 'M', 'ί'), + (0x1FDC, 'X'), + (0x1FDD, '3', ' ̔̀'), + (0x1FDE, '3', ' ̔́'), + (0x1FDF, '3', ' ̔͂'), + (0x1FE0, 'V'), + (0x1FE3, 'M', 'ΰ'), + (0x1FE4, 'V'), + (0x1FE8, 'M', 'ῠ'), + (0x1FE9, 'M', 'ῡ'), + (0x1FEA, 'M', 'ὺ'), + (0x1FEB, 'M', 'ύ'), + (0x1FEC, 'M', 'ῥ'), + (0x1FED, '3', ' ̈̀'), + (0x1FEE, '3', ' ̈́'), + (0x1FEF, '3', '`'), + (0x1FF0, 'X'), + (0x1FF2, 'M', 'ὼι'), + (0x1FF3, 'M', 'ωι'), + (0x1FF4, 'M', 'ώι'), + (0x1FF5, 'X'), + (0x1FF6, 'V'), + ] + +def _seg_21() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1FF7, 'M', 'ῶι'), + (0x1FF8, 'M', 'ὸ'), + (0x1FF9, 'M', 'ό'), + (0x1FFA, 'M', 'ὼ'), + (0x1FFB, 'M', 'ώ'), + (0x1FFC, 'M', 'ωι'), + (0x1FFD, '3', ' ́'), + (0x1FFE, '3', ' ̔'), + (0x1FFF, 'X'), + (0x2000, '3', ' '), + (0x200B, 'I'), + (0x200C, 'D', ''), + (0x200E, 'X'), + (0x2010, 'V'), + (0x2011, 'M', '‐'), + (0x2012, 'V'), + (0x2017, '3', ' ̳'), + (0x2018, 'V'), + (0x2024, 'X'), + (0x2027, 'V'), + (0x2028, 'X'), + (0x202F, '3', ' '), + (0x2030, 'V'), + (0x2033, 'M', '′′'), + (0x2034, 'M', '′′′'), + (0x2035, 'V'), + (0x2036, 'M', '‵‵'), + (0x2037, 'M', '‵‵‵'), + (0x2038, 'V'), + (0x203C, '3', '!!'), + (0x203D, 'V'), + (0x203E, '3', ' ̅'), + (0x203F, 'V'), + (0x2047, '3', '??'), + (0x2048, '3', '?!'), + (0x2049, '3', '!?'), + (0x204A, 'V'), + (0x2057, 'M', '′′′′'), + (0x2058, 'V'), + (0x205F, '3', ' '), + (0x2060, 'I'), + (0x2061, 'X'), + (0x2064, 'I'), + (0x2065, 'X'), + (0x2070, 'M', '0'), + (0x2071, 'M', 'i'), + (0x2072, 'X'), + (0x2074, 'M', '4'), + (0x2075, 'M', '5'), + (0x2076, 'M', '6'), + (0x2077, 'M', '7'), + (0x2078, 'M', '8'), + (0x2079, 'M', '9'), + (0x207A, '3', '+'), + (0x207B, 'M', '−'), + (0x207C, '3', '='), + (0x207D, '3', '('), + (0x207E, '3', ')'), + (0x207F, 'M', 'n'), + (0x2080, 'M', '0'), + (0x2081, 'M', '1'), + (0x2082, 'M', '2'), + (0x2083, 'M', '3'), + (0x2084, 'M', '4'), + (0x2085, 'M', '5'), + (0x2086, 'M', '6'), + (0x2087, 'M', '7'), + (0x2088, 'M', '8'), + (0x2089, 'M', '9'), + (0x208A, '3', '+'), + (0x208B, 'M', '−'), + (0x208C, '3', '='), + (0x208D, '3', '('), + (0x208E, '3', ')'), + (0x208F, 'X'), + (0x2090, 'M', 'a'), + (0x2091, 'M', 'e'), + (0x2092, 'M', 'o'), + (0x2093, 'M', 'x'), + (0x2094, 'M', 'ə'), + (0x2095, 'M', 'h'), + (0x2096, 'M', 'k'), + (0x2097, 'M', 'l'), + (0x2098, 'M', 'm'), + (0x2099, 'M', 'n'), + (0x209A, 'M', 'p'), + (0x209B, 'M', 's'), + (0x209C, 'M', 't'), + (0x209D, 'X'), + (0x20A0, 'V'), + (0x20A8, 'M', 'rs'), + (0x20A9, 'V'), + (0x20C1, 'X'), + (0x20D0, 'V'), + (0x20F1, 'X'), + (0x2100, '3', 'a/c'), + (0x2101, '3', 'a/s'), + (0x2102, 'M', 'c'), + (0x2103, 'M', '°c'), + (0x2104, 'V'), + ] + +def _seg_22() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x2105, '3', 'c/o'), + (0x2106, '3', 'c/u'), + (0x2107, 'M', 'ɛ'), + (0x2108, 'V'), + (0x2109, 'M', '°f'), + (0x210A, 'M', 'g'), + (0x210B, 'M', 'h'), + (0x210F, 'M', 'ħ'), + (0x2110, 'M', 'i'), + (0x2112, 'M', 'l'), + (0x2114, 'V'), + (0x2115, 'M', 'n'), + (0x2116, 'M', 'no'), + (0x2117, 'V'), + (0x2119, 'M', 'p'), + (0x211A, 'M', 'q'), + (0x211B, 'M', 'r'), + (0x211E, 'V'), + (0x2120, 'M', 'sm'), + (0x2121, 'M', 'tel'), + (0x2122, 'M', 'tm'), + (0x2123, 'V'), + (0x2124, 'M', 'z'), + (0x2125, 'V'), + (0x2126, 'M', 'ω'), + (0x2127, 'V'), + (0x2128, 'M', 'z'), + (0x2129, 'V'), + (0x212A, 'M', 'k'), + (0x212B, 'M', 'å'), + (0x212C, 'M', 'b'), + (0x212D, 'M', 'c'), + (0x212E, 'V'), + (0x212F, 'M', 'e'), + (0x2131, 'M', 'f'), + (0x2132, 'X'), + (0x2133, 'M', 'm'), + (0x2134, 'M', 'o'), + (0x2135, 'M', 'א'), + (0x2136, 'M', 'ב'), + (0x2137, 'M', 'ג'), + (0x2138, 'M', 'ד'), + (0x2139, 'M', 'i'), + (0x213A, 'V'), + (0x213B, 'M', 'fax'), + (0x213C, 'M', 'π'), + (0x213D, 'M', 'γ'), + (0x213F, 'M', 'π'), + (0x2140, 'M', '∑'), + (0x2141, 'V'), + (0x2145, 'M', 'd'), + (0x2147, 'M', 'e'), + (0x2148, 'M', 'i'), + (0x2149, 'M', 'j'), + (0x214A, 'V'), + (0x2150, 'M', '1⁄7'), + (0x2151, 'M', '1⁄9'), + (0x2152, 'M', '1⁄10'), + (0x2153, 'M', '1⁄3'), + (0x2154, 'M', '2⁄3'), + (0x2155, 'M', '1⁄5'), + (0x2156, 'M', '2⁄5'), + (0x2157, 'M', '3⁄5'), + (0x2158, 'M', '4⁄5'), + (0x2159, 'M', '1⁄6'), + (0x215A, 'M', '5⁄6'), + (0x215B, 'M', '1⁄8'), + (0x215C, 'M', '3⁄8'), + (0x215D, 'M', '5⁄8'), + (0x215E, 'M', '7⁄8'), + (0x215F, 'M', '1⁄'), + (0x2160, 'M', 'i'), + (0x2161, 'M', 'ii'), + (0x2162, 'M', 'iii'), + (0x2163, 'M', 'iv'), + (0x2164, 'M', 'v'), + (0x2165, 'M', 'vi'), + (0x2166, 'M', 'vii'), + (0x2167, 'M', 'viii'), + (0x2168, 'M', 'ix'), + (0x2169, 'M', 'x'), + (0x216A, 'M', 'xi'), + (0x216B, 'M', 'xii'), + (0x216C, 'M', 'l'), + (0x216D, 'M', 'c'), + (0x216E, 'M', 'd'), + (0x216F, 'M', 'm'), + (0x2170, 'M', 'i'), + (0x2171, 'M', 'ii'), + (0x2172, 'M', 'iii'), + (0x2173, 'M', 'iv'), + (0x2174, 'M', 'v'), + (0x2175, 'M', 'vi'), + (0x2176, 'M', 'vii'), + (0x2177, 'M', 'viii'), + (0x2178, 'M', 'ix'), + (0x2179, 'M', 'x'), + (0x217A, 'M', 'xi'), + (0x217B, 'M', 'xii'), + (0x217C, 'M', 'l'), + ] + +def _seg_23() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x217D, 'M', 'c'), + (0x217E, 'M', 'd'), + (0x217F, 'M', 'm'), + (0x2180, 'V'), + (0x2183, 'X'), + (0x2184, 'V'), + (0x2189, 'M', '0⁄3'), + (0x218A, 'V'), + (0x218C, 'X'), + (0x2190, 'V'), + (0x222C, 'M', '∫∫'), + (0x222D, 'M', '∫∫∫'), + (0x222E, 'V'), + (0x222F, 'M', '∮∮'), + (0x2230, 'M', '∮∮∮'), + (0x2231, 'V'), + (0x2329, 'M', '〈'), + (0x232A, 'M', '〉'), + (0x232B, 'V'), + (0x2427, 'X'), + (0x2440, 'V'), + (0x244B, 'X'), + (0x2460, 'M', '1'), + (0x2461, 'M', '2'), + (0x2462, 'M', '3'), + (0x2463, 'M', '4'), + (0x2464, 'M', '5'), + (0x2465, 'M', '6'), + (0x2466, 'M', '7'), + (0x2467, 'M', '8'), + (0x2468, 'M', '9'), + (0x2469, 'M', '10'), + (0x246A, 'M', '11'), + (0x246B, 'M', '12'), + (0x246C, 'M', '13'), + (0x246D, 'M', '14'), + (0x246E, 'M', '15'), + (0x246F, 'M', '16'), + (0x2470, 'M', '17'), + (0x2471, 'M', '18'), + (0x2472, 'M', '19'), + (0x2473, 'M', '20'), + (0x2474, '3', '(1)'), + (0x2475, '3', '(2)'), + (0x2476, '3', '(3)'), + (0x2477, '3', '(4)'), + (0x2478, '3', '(5)'), + (0x2479, '3', '(6)'), + (0x247A, '3', '(7)'), + (0x247B, '3', '(8)'), + (0x247C, '3', '(9)'), + (0x247D, '3', '(10)'), + (0x247E, '3', '(11)'), + (0x247F, '3', '(12)'), + (0x2480, '3', '(13)'), + (0x2481, '3', '(14)'), + (0x2482, '3', '(15)'), + (0x2483, '3', '(16)'), + (0x2484, '3', '(17)'), + (0x2485, '3', '(18)'), + (0x2486, '3', '(19)'), + (0x2487, '3', '(20)'), + (0x2488, 'X'), + (0x249C, '3', '(a)'), + (0x249D, '3', '(b)'), + (0x249E, '3', '(c)'), + (0x249F, '3', '(d)'), + (0x24A0, '3', '(e)'), + (0x24A1, '3', '(f)'), + (0x24A2, '3', '(g)'), + (0x24A3, '3', '(h)'), + (0x24A4, '3', '(i)'), + (0x24A5, '3', '(j)'), + (0x24A6, '3', '(k)'), + (0x24A7, '3', '(l)'), + (0x24A8, '3', '(m)'), + (0x24A9, '3', '(n)'), + (0x24AA, '3', '(o)'), + (0x24AB, '3', '(p)'), + (0x24AC, '3', '(q)'), + (0x24AD, '3', '(r)'), + (0x24AE, '3', '(s)'), + (0x24AF, '3', '(t)'), + (0x24B0, '3', '(u)'), + (0x24B1, '3', '(v)'), + (0x24B2, '3', '(w)'), + (0x24B3, '3', '(x)'), + (0x24B4, '3', '(y)'), + (0x24B5, '3', '(z)'), + (0x24B6, 'M', 'a'), + (0x24B7, 'M', 'b'), + (0x24B8, 'M', 'c'), + (0x24B9, 'M', 'd'), + (0x24BA, 'M', 'e'), + (0x24BB, 'M', 'f'), + (0x24BC, 'M', 'g'), + (0x24BD, 'M', 'h'), + (0x24BE, 'M', 'i'), + (0x24BF, 'M', 'j'), + (0x24C0, 'M', 'k'), + ] + +def _seg_24() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x24C1, 'M', 'l'), + (0x24C2, 'M', 'm'), + (0x24C3, 'M', 'n'), + (0x24C4, 'M', 'o'), + (0x24C5, 'M', 'p'), + (0x24C6, 'M', 'q'), + (0x24C7, 'M', 'r'), + (0x24C8, 'M', 's'), + (0x24C9, 'M', 't'), + (0x24CA, 'M', 'u'), + (0x24CB, 'M', 'v'), + (0x24CC, 'M', 'w'), + (0x24CD, 'M', 'x'), + (0x24CE, 'M', 'y'), + (0x24CF, 'M', 'z'), + (0x24D0, 'M', 'a'), + (0x24D1, 'M', 'b'), + (0x24D2, 'M', 'c'), + (0x24D3, 'M', 'd'), + (0x24D4, 'M', 'e'), + (0x24D5, 'M', 'f'), + (0x24D6, 'M', 'g'), + (0x24D7, 'M', 'h'), + (0x24D8, 'M', 'i'), + (0x24D9, 'M', 'j'), + (0x24DA, 'M', 'k'), + (0x24DB, 'M', 'l'), + (0x24DC, 'M', 'm'), + (0x24DD, 'M', 'n'), + (0x24DE, 'M', 'o'), + (0x24DF, 'M', 'p'), + (0x24E0, 'M', 'q'), + (0x24E1, 'M', 'r'), + (0x24E2, 'M', 's'), + (0x24E3, 'M', 't'), + (0x24E4, 'M', 'u'), + (0x24E5, 'M', 'v'), + (0x24E6, 'M', 'w'), + (0x24E7, 'M', 'x'), + (0x24E8, 'M', 'y'), + (0x24E9, 'M', 'z'), + (0x24EA, 'M', '0'), + (0x24EB, 'V'), + (0x2A0C, 'M', '∫∫∫∫'), + (0x2A0D, 'V'), + (0x2A74, '3', '::='), + (0x2A75, '3', '=='), + (0x2A76, '3', '==='), + (0x2A77, 'V'), + (0x2ADC, 'M', '⫝̸'), + (0x2ADD, 'V'), + (0x2B74, 'X'), + (0x2B76, 'V'), + (0x2B96, 'X'), + (0x2B97, 'V'), + (0x2C00, 'M', 'ⰰ'), + (0x2C01, 'M', 'ⰱ'), + (0x2C02, 'M', 'ⰲ'), + (0x2C03, 'M', 'ⰳ'), + (0x2C04, 'M', 'ⰴ'), + (0x2C05, 'M', 'ⰵ'), + (0x2C06, 'M', 'ⰶ'), + (0x2C07, 'M', 'ⰷ'), + (0x2C08, 'M', 'ⰸ'), + (0x2C09, 'M', 'ⰹ'), + (0x2C0A, 'M', 'ⰺ'), + (0x2C0B, 'M', 'ⰻ'), + (0x2C0C, 'M', 'ⰼ'), + (0x2C0D, 'M', 'ⰽ'), + (0x2C0E, 'M', 'ⰾ'), + (0x2C0F, 'M', 'ⰿ'), + (0x2C10, 'M', 'ⱀ'), + (0x2C11, 'M', 'ⱁ'), + (0x2C12, 'M', 'ⱂ'), + (0x2C13, 'M', 'ⱃ'), + (0x2C14, 'M', 'ⱄ'), + (0x2C15, 'M', 'ⱅ'), + (0x2C16, 'M', 'ⱆ'), + (0x2C17, 'M', 'ⱇ'), + (0x2C18, 'M', 'ⱈ'), + (0x2C19, 'M', 'ⱉ'), + (0x2C1A, 'M', 'ⱊ'), + (0x2C1B, 'M', 'ⱋ'), + (0x2C1C, 'M', 'ⱌ'), + (0x2C1D, 'M', 'ⱍ'), + (0x2C1E, 'M', 'ⱎ'), + (0x2C1F, 'M', 'ⱏ'), + (0x2C20, 'M', 'ⱐ'), + (0x2C21, 'M', 'ⱑ'), + (0x2C22, 'M', 'ⱒ'), + (0x2C23, 'M', 'ⱓ'), + (0x2C24, 'M', 'ⱔ'), + (0x2C25, 'M', 'ⱕ'), + (0x2C26, 'M', 'ⱖ'), + (0x2C27, 'M', 'ⱗ'), + (0x2C28, 'M', 'ⱘ'), + (0x2C29, 'M', 'ⱙ'), + (0x2C2A, 'M', 'ⱚ'), + (0x2C2B, 'M', 'ⱛ'), + (0x2C2C, 'M', 'ⱜ'), + ] + +def _seg_25() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x2C2D, 'M', 'ⱝ'), + (0x2C2E, 'M', 'ⱞ'), + (0x2C2F, 'M', 'ⱟ'), + (0x2C30, 'V'), + (0x2C60, 'M', 'ⱡ'), + (0x2C61, 'V'), + (0x2C62, 'M', 'ɫ'), + (0x2C63, 'M', 'ᵽ'), + (0x2C64, 'M', 'ɽ'), + (0x2C65, 'V'), + (0x2C67, 'M', 'ⱨ'), + (0x2C68, 'V'), + (0x2C69, 'M', 'ⱪ'), + (0x2C6A, 'V'), + (0x2C6B, 'M', 'ⱬ'), + (0x2C6C, 'V'), + (0x2C6D, 'M', 'ɑ'), + (0x2C6E, 'M', 'ɱ'), + (0x2C6F, 'M', 'ɐ'), + (0x2C70, 'M', 'ɒ'), + (0x2C71, 'V'), + (0x2C72, 'M', 'ⱳ'), + (0x2C73, 'V'), + (0x2C75, 'M', 'ⱶ'), + (0x2C76, 'V'), + (0x2C7C, 'M', 'j'), + (0x2C7D, 'M', 'v'), + (0x2C7E, 'M', 'ȿ'), + (0x2C7F, 'M', 'ɀ'), + (0x2C80, 'M', 'ⲁ'), + (0x2C81, 'V'), + (0x2C82, 'M', 'ⲃ'), + (0x2C83, 'V'), + (0x2C84, 'M', 'ⲅ'), + (0x2C85, 'V'), + (0x2C86, 'M', 'ⲇ'), + (0x2C87, 'V'), + (0x2C88, 'M', 'ⲉ'), + (0x2C89, 'V'), + (0x2C8A, 'M', 'ⲋ'), + (0x2C8B, 'V'), + (0x2C8C, 'M', 'ⲍ'), + (0x2C8D, 'V'), + (0x2C8E, 'M', 'ⲏ'), + (0x2C8F, 'V'), + (0x2C90, 'M', 'ⲑ'), + (0x2C91, 'V'), + (0x2C92, 'M', 'ⲓ'), + (0x2C93, 'V'), + (0x2C94, 'M', 'ⲕ'), + (0x2C95, 'V'), + (0x2C96, 'M', 'ⲗ'), + (0x2C97, 'V'), + (0x2C98, 'M', 'ⲙ'), + (0x2C99, 'V'), + (0x2C9A, 'M', 'ⲛ'), + (0x2C9B, 'V'), + (0x2C9C, 'M', 'ⲝ'), + (0x2C9D, 'V'), + (0x2C9E, 'M', 'ⲟ'), + (0x2C9F, 'V'), + (0x2CA0, 'M', 'ⲡ'), + (0x2CA1, 'V'), + (0x2CA2, 'M', 'ⲣ'), + (0x2CA3, 'V'), + (0x2CA4, 'M', 'ⲥ'), + (0x2CA5, 'V'), + (0x2CA6, 'M', 'ⲧ'), + (0x2CA7, 'V'), + (0x2CA8, 'M', 'ⲩ'), + (0x2CA9, 'V'), + (0x2CAA, 'M', 'ⲫ'), + (0x2CAB, 'V'), + (0x2CAC, 'M', 'ⲭ'), + (0x2CAD, 'V'), + (0x2CAE, 'M', 'ⲯ'), + (0x2CAF, 'V'), + (0x2CB0, 'M', 'ⲱ'), + (0x2CB1, 'V'), + (0x2CB2, 'M', 'ⲳ'), + (0x2CB3, 'V'), + (0x2CB4, 'M', 'ⲵ'), + (0x2CB5, 'V'), + (0x2CB6, 'M', 'ⲷ'), + (0x2CB7, 'V'), + (0x2CB8, 'M', 'ⲹ'), + (0x2CB9, 'V'), + (0x2CBA, 'M', 'ⲻ'), + (0x2CBB, 'V'), + (0x2CBC, 'M', 'ⲽ'), + (0x2CBD, 'V'), + (0x2CBE, 'M', 'ⲿ'), + (0x2CBF, 'V'), + (0x2CC0, 'M', 'ⳁ'), + (0x2CC1, 'V'), + (0x2CC2, 'M', 'ⳃ'), + (0x2CC3, 'V'), + (0x2CC4, 'M', 'ⳅ'), + (0x2CC5, 'V'), + (0x2CC6, 'M', 'ⳇ'), + ] + +def _seg_26() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x2CC7, 'V'), + (0x2CC8, 'M', 'ⳉ'), + (0x2CC9, 'V'), + (0x2CCA, 'M', 'ⳋ'), + (0x2CCB, 'V'), + (0x2CCC, 'M', 'ⳍ'), + (0x2CCD, 'V'), + (0x2CCE, 'M', 'ⳏ'), + (0x2CCF, 'V'), + (0x2CD0, 'M', 'ⳑ'), + (0x2CD1, 'V'), + (0x2CD2, 'M', 'ⳓ'), + (0x2CD3, 'V'), + (0x2CD4, 'M', 'ⳕ'), + (0x2CD5, 'V'), + (0x2CD6, 'M', 'ⳗ'), + (0x2CD7, 'V'), + (0x2CD8, 'M', 'ⳙ'), + (0x2CD9, 'V'), + (0x2CDA, 'M', 'ⳛ'), + (0x2CDB, 'V'), + (0x2CDC, 'M', 'ⳝ'), + (0x2CDD, 'V'), + (0x2CDE, 'M', 'ⳟ'), + (0x2CDF, 'V'), + (0x2CE0, 'M', 'ⳡ'), + (0x2CE1, 'V'), + (0x2CE2, 'M', 'ⳣ'), + (0x2CE3, 'V'), + (0x2CEB, 'M', 'ⳬ'), + (0x2CEC, 'V'), + (0x2CED, 'M', 'ⳮ'), + (0x2CEE, 'V'), + (0x2CF2, 'M', 'ⳳ'), + (0x2CF3, 'V'), + (0x2CF4, 'X'), + (0x2CF9, 'V'), + (0x2D26, 'X'), + (0x2D27, 'V'), + (0x2D28, 'X'), + (0x2D2D, 'V'), + (0x2D2E, 'X'), + (0x2D30, 'V'), + (0x2D68, 'X'), + (0x2D6F, 'M', 'ⵡ'), + (0x2D70, 'V'), + (0x2D71, 'X'), + (0x2D7F, 'V'), + (0x2D97, 'X'), + (0x2DA0, 'V'), + (0x2DA7, 'X'), + (0x2DA8, 'V'), + (0x2DAF, 'X'), + (0x2DB0, 'V'), + (0x2DB7, 'X'), + (0x2DB8, 'V'), + (0x2DBF, 'X'), + (0x2DC0, 'V'), + (0x2DC7, 'X'), + (0x2DC8, 'V'), + (0x2DCF, 'X'), + (0x2DD0, 'V'), + (0x2DD7, 'X'), + (0x2DD8, 'V'), + (0x2DDF, 'X'), + (0x2DE0, 'V'), + (0x2E5E, 'X'), + (0x2E80, 'V'), + (0x2E9A, 'X'), + (0x2E9B, 'V'), + (0x2E9F, 'M', '母'), + (0x2EA0, 'V'), + (0x2EF3, 'M', '龟'), + (0x2EF4, 'X'), + (0x2F00, 'M', '一'), + (0x2F01, 'M', '丨'), + (0x2F02, 'M', '丶'), + (0x2F03, 'M', '丿'), + (0x2F04, 'M', '乙'), + (0x2F05, 'M', '亅'), + (0x2F06, 'M', '二'), + (0x2F07, 'M', '亠'), + (0x2F08, 'M', '人'), + (0x2F09, 'M', '儿'), + (0x2F0A, 'M', '入'), + (0x2F0B, 'M', '八'), + (0x2F0C, 'M', '冂'), + (0x2F0D, 'M', '冖'), + (0x2F0E, 'M', '冫'), + (0x2F0F, 'M', '几'), + (0x2F10, 'M', '凵'), + (0x2F11, 'M', '刀'), + (0x2F12, 'M', '力'), + (0x2F13, 'M', '勹'), + (0x2F14, 'M', '匕'), + (0x2F15, 'M', '匚'), + (0x2F16, 'M', '匸'), + (0x2F17, 'M', '十'), + (0x2F18, 'M', '卜'), + (0x2F19, 'M', '卩'), + ] + +def _seg_27() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x2F1A, 'M', '厂'), + (0x2F1B, 'M', '厶'), + (0x2F1C, 'M', '又'), + (0x2F1D, 'M', '口'), + (0x2F1E, 'M', '囗'), + (0x2F1F, 'M', '土'), + (0x2F20, 'M', '士'), + (0x2F21, 'M', '夂'), + (0x2F22, 'M', '夊'), + (0x2F23, 'M', '夕'), + (0x2F24, 'M', '大'), + (0x2F25, 'M', '女'), + (0x2F26, 'M', '子'), + (0x2F27, 'M', '宀'), + (0x2F28, 'M', '寸'), + (0x2F29, 'M', '小'), + (0x2F2A, 'M', '尢'), + (0x2F2B, 'M', '尸'), + (0x2F2C, 'M', '屮'), + (0x2F2D, 'M', '山'), + (0x2F2E, 'M', '巛'), + (0x2F2F, 'M', '工'), + (0x2F30, 'M', '己'), + (0x2F31, 'M', '巾'), + (0x2F32, 'M', '干'), + (0x2F33, 'M', '幺'), + (0x2F34, 'M', '广'), + (0x2F35, 'M', '廴'), + (0x2F36, 'M', '廾'), + (0x2F37, 'M', '弋'), + (0x2F38, 'M', '弓'), + (0x2F39, 'M', '彐'), + (0x2F3A, 'M', '彡'), + (0x2F3B, 'M', '彳'), + (0x2F3C, 'M', '心'), + (0x2F3D, 'M', '戈'), + (0x2F3E, 'M', '戶'), + (0x2F3F, 'M', '手'), + (0x2F40, 'M', '支'), + (0x2F41, 'M', '攴'), + (0x2F42, 'M', '文'), + (0x2F43, 'M', '斗'), + (0x2F44, 'M', '斤'), + (0x2F45, 'M', '方'), + (0x2F46, 'M', '无'), + (0x2F47, 'M', '日'), + (0x2F48, 'M', '曰'), + (0x2F49, 'M', '月'), + (0x2F4A, 'M', '木'), + (0x2F4B, 'M', '欠'), + (0x2F4C, 'M', '止'), + (0x2F4D, 'M', '歹'), + (0x2F4E, 'M', '殳'), + (0x2F4F, 'M', '毋'), + (0x2F50, 'M', '比'), + (0x2F51, 'M', '毛'), + (0x2F52, 'M', '氏'), + (0x2F53, 'M', '气'), + (0x2F54, 'M', '水'), + (0x2F55, 'M', '火'), + (0x2F56, 'M', '爪'), + (0x2F57, 'M', '父'), + (0x2F58, 'M', '爻'), + (0x2F59, 'M', '爿'), + (0x2F5A, 'M', '片'), + (0x2F5B, 'M', '牙'), + (0x2F5C, 'M', '牛'), + (0x2F5D, 'M', '犬'), + (0x2F5E, 'M', '玄'), + (0x2F5F, 'M', '玉'), + (0x2F60, 'M', '瓜'), + (0x2F61, 'M', '瓦'), + (0x2F62, 'M', '甘'), + (0x2F63, 'M', '生'), + (0x2F64, 'M', '用'), + (0x2F65, 'M', '田'), + (0x2F66, 'M', '疋'), + (0x2F67, 'M', '疒'), + (0x2F68, 'M', '癶'), + (0x2F69, 'M', '白'), + (0x2F6A, 'M', '皮'), + (0x2F6B, 'M', '皿'), + (0x2F6C, 'M', '目'), + (0x2F6D, 'M', '矛'), + (0x2F6E, 'M', '矢'), + (0x2F6F, 'M', '石'), + (0x2F70, 'M', '示'), + (0x2F71, 'M', '禸'), + (0x2F72, 'M', '禾'), + (0x2F73, 'M', '穴'), + (0x2F74, 'M', '立'), + (0x2F75, 'M', '竹'), + (0x2F76, 'M', '米'), + (0x2F77, 'M', '糸'), + (0x2F78, 'M', '缶'), + (0x2F79, 'M', '网'), + (0x2F7A, 'M', '羊'), + (0x2F7B, 'M', '羽'), + (0x2F7C, 'M', '老'), + (0x2F7D, 'M', '而'), + ] + +def _seg_28() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x2F7E, 'M', '耒'), + (0x2F7F, 'M', '耳'), + (0x2F80, 'M', '聿'), + (0x2F81, 'M', '肉'), + (0x2F82, 'M', '臣'), + (0x2F83, 'M', '自'), + (0x2F84, 'M', '至'), + (0x2F85, 'M', '臼'), + (0x2F86, 'M', '舌'), + (0x2F87, 'M', '舛'), + (0x2F88, 'M', '舟'), + (0x2F89, 'M', '艮'), + (0x2F8A, 'M', '色'), + (0x2F8B, 'M', '艸'), + (0x2F8C, 'M', '虍'), + (0x2F8D, 'M', '虫'), + (0x2F8E, 'M', '血'), + (0x2F8F, 'M', '行'), + (0x2F90, 'M', '衣'), + (0x2F91, 'M', '襾'), + (0x2F92, 'M', '見'), + (0x2F93, 'M', '角'), + (0x2F94, 'M', '言'), + (0x2F95, 'M', '谷'), + (0x2F96, 'M', '豆'), + (0x2F97, 'M', '豕'), + (0x2F98, 'M', '豸'), + (0x2F99, 'M', '貝'), + (0x2F9A, 'M', '赤'), + (0x2F9B, 'M', '走'), + (0x2F9C, 'M', '足'), + (0x2F9D, 'M', '身'), + (0x2F9E, 'M', '車'), + (0x2F9F, 'M', '辛'), + (0x2FA0, 'M', '辰'), + (0x2FA1, 'M', '辵'), + (0x2FA2, 'M', '邑'), + (0x2FA3, 'M', '酉'), + (0x2FA4, 'M', '釆'), + (0x2FA5, 'M', '里'), + (0x2FA6, 'M', '金'), + (0x2FA7, 'M', '長'), + (0x2FA8, 'M', '門'), + (0x2FA9, 'M', '阜'), + (0x2FAA, 'M', '隶'), + (0x2FAB, 'M', '隹'), + (0x2FAC, 'M', '雨'), + (0x2FAD, 'M', '靑'), + (0x2FAE, 'M', '非'), + (0x2FAF, 'M', '面'), + (0x2FB0, 'M', '革'), + (0x2FB1, 'M', '韋'), + (0x2FB2, 'M', '韭'), + (0x2FB3, 'M', '音'), + (0x2FB4, 'M', '頁'), + (0x2FB5, 'M', '風'), + (0x2FB6, 'M', '飛'), + (0x2FB7, 'M', '食'), + (0x2FB8, 'M', '首'), + (0x2FB9, 'M', '香'), + (0x2FBA, 'M', '馬'), + (0x2FBB, 'M', '骨'), + (0x2FBC, 'M', '高'), + (0x2FBD, 'M', '髟'), + (0x2FBE, 'M', '鬥'), + (0x2FBF, 'M', '鬯'), + (0x2FC0, 'M', '鬲'), + (0x2FC1, 'M', '鬼'), + (0x2FC2, 'M', '魚'), + (0x2FC3, 'M', '鳥'), + (0x2FC4, 'M', '鹵'), + (0x2FC5, 'M', '鹿'), + (0x2FC6, 'M', '麥'), + (0x2FC7, 'M', '麻'), + (0x2FC8, 'M', '黃'), + (0x2FC9, 'M', '黍'), + (0x2FCA, 'M', '黑'), + (0x2FCB, 'M', '黹'), + (0x2FCC, 'M', '黽'), + (0x2FCD, 'M', '鼎'), + (0x2FCE, 'M', '鼓'), + (0x2FCF, 'M', '鼠'), + (0x2FD0, 'M', '鼻'), + (0x2FD1, 'M', '齊'), + (0x2FD2, 'M', '齒'), + (0x2FD3, 'M', '龍'), + (0x2FD4, 'M', '龜'), + (0x2FD5, 'M', '龠'), + (0x2FD6, 'X'), + (0x3000, '3', ' '), + (0x3001, 'V'), + (0x3002, 'M', '.'), + (0x3003, 'V'), + (0x3036, 'M', '〒'), + (0x3037, 'V'), + (0x3038, 'M', '十'), + (0x3039, 'M', '卄'), + (0x303A, 'M', '卅'), + (0x303B, 'V'), + (0x3040, 'X'), + ] + +def _seg_29() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x3041, 'V'), + (0x3097, 'X'), + (0x3099, 'V'), + (0x309B, '3', ' ゙'), + (0x309C, '3', ' ゚'), + (0x309D, 'V'), + (0x309F, 'M', 'より'), + (0x30A0, 'V'), + (0x30FF, 'M', 'コト'), + (0x3100, 'X'), + (0x3105, 'V'), + (0x3130, 'X'), + (0x3131, 'M', 'ᄀ'), + (0x3132, 'M', 'ᄁ'), + (0x3133, 'M', 'ᆪ'), + (0x3134, 'M', 'ᄂ'), + (0x3135, 'M', 'ᆬ'), + (0x3136, 'M', 'ᆭ'), + (0x3137, 'M', 'ᄃ'), + (0x3138, 'M', 'ᄄ'), + (0x3139, 'M', 'ᄅ'), + (0x313A, 'M', 'ᆰ'), + (0x313B, 'M', 'ᆱ'), + (0x313C, 'M', 'ᆲ'), + (0x313D, 'M', 'ᆳ'), + (0x313E, 'M', 'ᆴ'), + (0x313F, 'M', 'ᆵ'), + (0x3140, 'M', 'ᄚ'), + (0x3141, 'M', 'ᄆ'), + (0x3142, 'M', 'ᄇ'), + (0x3143, 'M', 'ᄈ'), + (0x3144, 'M', 'ᄡ'), + (0x3145, 'M', 'ᄉ'), + (0x3146, 'M', 'ᄊ'), + (0x3147, 'M', 'ᄋ'), + (0x3148, 'M', 'ᄌ'), + (0x3149, 'M', 'ᄍ'), + (0x314A, 'M', 'ᄎ'), + (0x314B, 'M', 'ᄏ'), + (0x314C, 'M', 'ᄐ'), + (0x314D, 'M', 'ᄑ'), + (0x314E, 'M', 'ᄒ'), + (0x314F, 'M', 'ᅡ'), + (0x3150, 'M', 'ᅢ'), + (0x3151, 'M', 'ᅣ'), + (0x3152, 'M', 'ᅤ'), + (0x3153, 'M', 'ᅥ'), + (0x3154, 'M', 'ᅦ'), + (0x3155, 'M', 'ᅧ'), + (0x3156, 'M', 'ᅨ'), + (0x3157, 'M', 'ᅩ'), + (0x3158, 'M', 'ᅪ'), + (0x3159, 'M', 'ᅫ'), + (0x315A, 'M', 'ᅬ'), + (0x315B, 'M', 'ᅭ'), + (0x315C, 'M', 'ᅮ'), + (0x315D, 'M', 'ᅯ'), + (0x315E, 'M', 'ᅰ'), + (0x315F, 'M', 'ᅱ'), + (0x3160, 'M', 'ᅲ'), + (0x3161, 'M', 'ᅳ'), + (0x3162, 'M', 'ᅴ'), + (0x3163, 'M', 'ᅵ'), + (0x3164, 'X'), + (0x3165, 'M', 'ᄔ'), + (0x3166, 'M', 'ᄕ'), + (0x3167, 'M', 'ᇇ'), + (0x3168, 'M', 'ᇈ'), + (0x3169, 'M', 'ᇌ'), + (0x316A, 'M', 'ᇎ'), + (0x316B, 'M', 'ᇓ'), + (0x316C, 'M', 'ᇗ'), + (0x316D, 'M', 'ᇙ'), + (0x316E, 'M', 'ᄜ'), + (0x316F, 'M', 'ᇝ'), + (0x3170, 'M', 'ᇟ'), + (0x3171, 'M', 'ᄝ'), + (0x3172, 'M', 'ᄞ'), + (0x3173, 'M', 'ᄠ'), + (0x3174, 'M', 'ᄢ'), + (0x3175, 'M', 'ᄣ'), + (0x3176, 'M', 'ᄧ'), + (0x3177, 'M', 'ᄩ'), + (0x3178, 'M', 'ᄫ'), + (0x3179, 'M', 'ᄬ'), + (0x317A, 'M', 'ᄭ'), + (0x317B, 'M', 'ᄮ'), + (0x317C, 'M', 'ᄯ'), + (0x317D, 'M', 'ᄲ'), + (0x317E, 'M', 'ᄶ'), + (0x317F, 'M', 'ᅀ'), + (0x3180, 'M', 'ᅇ'), + (0x3181, 'M', 'ᅌ'), + (0x3182, 'M', 'ᇱ'), + (0x3183, 'M', 'ᇲ'), + (0x3184, 'M', 'ᅗ'), + (0x3185, 'M', 'ᅘ'), + (0x3186, 'M', 'ᅙ'), + (0x3187, 'M', 'ᆄ'), + (0x3188, 'M', 'ᆅ'), + ] + +def _seg_30() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x3189, 'M', 'ᆈ'), + (0x318A, 'M', 'ᆑ'), + (0x318B, 'M', 'ᆒ'), + (0x318C, 'M', 'ᆔ'), + (0x318D, 'M', 'ᆞ'), + (0x318E, 'M', 'ᆡ'), + (0x318F, 'X'), + (0x3190, 'V'), + (0x3192, 'M', '一'), + (0x3193, 'M', '二'), + (0x3194, 'M', '三'), + (0x3195, 'M', '四'), + (0x3196, 'M', '上'), + (0x3197, 'M', '中'), + (0x3198, 'M', '下'), + (0x3199, 'M', '甲'), + (0x319A, 'M', '乙'), + (0x319B, 'M', '丙'), + (0x319C, 'M', '丁'), + (0x319D, 'M', '天'), + (0x319E, 'M', '地'), + (0x319F, 'M', '人'), + (0x31A0, 'V'), + (0x31E4, 'X'), + (0x31F0, 'V'), + (0x3200, '3', '(ᄀ)'), + (0x3201, '3', '(ᄂ)'), + (0x3202, '3', '(ᄃ)'), + (0x3203, '3', '(ᄅ)'), + (0x3204, '3', '(ᄆ)'), + (0x3205, '3', '(ᄇ)'), + (0x3206, '3', '(ᄉ)'), + (0x3207, '3', '(ᄋ)'), + (0x3208, '3', '(ᄌ)'), + (0x3209, '3', '(ᄎ)'), + (0x320A, '3', '(ᄏ)'), + (0x320B, '3', '(ᄐ)'), + (0x320C, '3', '(ᄑ)'), + (0x320D, '3', '(ᄒ)'), + (0x320E, '3', '(가)'), + (0x320F, '3', '(나)'), + (0x3210, '3', '(다)'), + (0x3211, '3', '(라)'), + (0x3212, '3', '(마)'), + (0x3213, '3', '(바)'), + (0x3214, '3', '(사)'), + (0x3215, '3', '(아)'), + (0x3216, '3', '(자)'), + (0x3217, '3', '(차)'), + (0x3218, '3', '(카)'), + (0x3219, '3', '(타)'), + (0x321A, '3', '(파)'), + (0x321B, '3', '(하)'), + (0x321C, '3', '(주)'), + (0x321D, '3', '(오전)'), + (0x321E, '3', '(오후)'), + (0x321F, 'X'), + (0x3220, '3', '(一)'), + (0x3221, '3', '(二)'), + (0x3222, '3', '(三)'), + (0x3223, '3', '(四)'), + (0x3224, '3', '(五)'), + (0x3225, '3', '(六)'), + (0x3226, '3', '(七)'), + (0x3227, '3', '(八)'), + (0x3228, '3', '(九)'), + (0x3229, '3', '(十)'), + (0x322A, '3', '(月)'), + (0x322B, '3', '(火)'), + (0x322C, '3', '(水)'), + (0x322D, '3', '(木)'), + (0x322E, '3', '(金)'), + (0x322F, '3', '(土)'), + (0x3230, '3', '(日)'), + (0x3231, '3', '(株)'), + (0x3232, '3', '(有)'), + (0x3233, '3', '(社)'), + (0x3234, '3', '(名)'), + (0x3235, '3', '(特)'), + (0x3236, '3', '(財)'), + (0x3237, '3', '(祝)'), + (0x3238, '3', '(労)'), + (0x3239, '3', '(代)'), + (0x323A, '3', '(呼)'), + (0x323B, '3', '(学)'), + (0x323C, '3', '(監)'), + (0x323D, '3', '(企)'), + (0x323E, '3', '(資)'), + (0x323F, '3', '(協)'), + (0x3240, '3', '(祭)'), + (0x3241, '3', '(休)'), + (0x3242, '3', '(自)'), + (0x3243, '3', '(至)'), + (0x3244, 'M', '問'), + (0x3245, 'M', '幼'), + (0x3246, 'M', '文'), + (0x3247, 'M', '箏'), + (0x3248, 'V'), + (0x3250, 'M', 'pte'), + (0x3251, 'M', '21'), + ] + +def _seg_31() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x3252, 'M', '22'), + (0x3253, 'M', '23'), + (0x3254, 'M', '24'), + (0x3255, 'M', '25'), + (0x3256, 'M', '26'), + (0x3257, 'M', '27'), + (0x3258, 'M', '28'), + (0x3259, 'M', '29'), + (0x325A, 'M', '30'), + (0x325B, 'M', '31'), + (0x325C, 'M', '32'), + (0x325D, 'M', '33'), + (0x325E, 'M', '34'), + (0x325F, 'M', '35'), + (0x3260, 'M', 'ᄀ'), + (0x3261, 'M', 'ᄂ'), + (0x3262, 'M', 'ᄃ'), + (0x3263, 'M', 'ᄅ'), + (0x3264, 'M', 'ᄆ'), + (0x3265, 'M', 'ᄇ'), + (0x3266, 'M', 'ᄉ'), + (0x3267, 'M', 'ᄋ'), + (0x3268, 'M', 'ᄌ'), + (0x3269, 'M', 'ᄎ'), + (0x326A, 'M', 'ᄏ'), + (0x326B, 'M', 'ᄐ'), + (0x326C, 'M', 'ᄑ'), + (0x326D, 'M', 'ᄒ'), + (0x326E, 'M', '가'), + (0x326F, 'M', '나'), + (0x3270, 'M', '다'), + (0x3271, 'M', '라'), + (0x3272, 'M', '마'), + (0x3273, 'M', '바'), + (0x3274, 'M', '사'), + (0x3275, 'M', '아'), + (0x3276, 'M', '자'), + (0x3277, 'M', '차'), + (0x3278, 'M', '카'), + (0x3279, 'M', '타'), + (0x327A, 'M', '파'), + (0x327B, 'M', '하'), + (0x327C, 'M', '참고'), + (0x327D, 'M', '주의'), + (0x327E, 'M', '우'), + (0x327F, 'V'), + (0x3280, 'M', '一'), + (0x3281, 'M', '二'), + (0x3282, 'M', '三'), + (0x3283, 'M', '四'), + (0x3284, 'M', '五'), + (0x3285, 'M', '六'), + (0x3286, 'M', '七'), + (0x3287, 'M', '八'), + (0x3288, 'M', '九'), + (0x3289, 'M', '十'), + (0x328A, 'M', '月'), + (0x328B, 'M', '火'), + (0x328C, 'M', '水'), + (0x328D, 'M', '木'), + (0x328E, 'M', '金'), + (0x328F, 'M', '土'), + (0x3290, 'M', '日'), + (0x3291, 'M', '株'), + (0x3292, 'M', '有'), + (0x3293, 'M', '社'), + (0x3294, 'M', '名'), + (0x3295, 'M', '特'), + (0x3296, 'M', '財'), + (0x3297, 'M', '祝'), + (0x3298, 'M', '労'), + (0x3299, 'M', '秘'), + (0x329A, 'M', '男'), + (0x329B, 'M', '女'), + (0x329C, 'M', '適'), + (0x329D, 'M', '優'), + (0x329E, 'M', '印'), + (0x329F, 'M', '注'), + (0x32A0, 'M', '項'), + (0x32A1, 'M', '休'), + (0x32A2, 'M', '写'), + (0x32A3, 'M', '正'), + (0x32A4, 'M', '上'), + (0x32A5, 'M', '中'), + (0x32A6, 'M', '下'), + (0x32A7, 'M', '左'), + (0x32A8, 'M', '右'), + (0x32A9, 'M', '医'), + (0x32AA, 'M', '宗'), + (0x32AB, 'M', '学'), + (0x32AC, 'M', '監'), + (0x32AD, 'M', '企'), + (0x32AE, 'M', '資'), + (0x32AF, 'M', '協'), + (0x32B0, 'M', '夜'), + (0x32B1, 'M', '36'), + (0x32B2, 'M', '37'), + (0x32B3, 'M', '38'), + (0x32B4, 'M', '39'), + (0x32B5, 'M', '40'), + ] + +def _seg_32() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x32B6, 'M', '41'), + (0x32B7, 'M', '42'), + (0x32B8, 'M', '43'), + (0x32B9, 'M', '44'), + (0x32BA, 'M', '45'), + (0x32BB, 'M', '46'), + (0x32BC, 'M', '47'), + (0x32BD, 'M', '48'), + (0x32BE, 'M', '49'), + (0x32BF, 'M', '50'), + (0x32C0, 'M', '1月'), + (0x32C1, 'M', '2月'), + (0x32C2, 'M', '3月'), + (0x32C3, 'M', '4月'), + (0x32C4, 'M', '5月'), + (0x32C5, 'M', '6月'), + (0x32C6, 'M', '7月'), + (0x32C7, 'M', '8月'), + (0x32C8, 'M', '9月'), + (0x32C9, 'M', '10月'), + (0x32CA, 'M', '11月'), + (0x32CB, 'M', '12月'), + (0x32CC, 'M', 'hg'), + (0x32CD, 'M', 'erg'), + (0x32CE, 'M', 'ev'), + (0x32CF, 'M', 'ltd'), + (0x32D0, 'M', 'ア'), + (0x32D1, 'M', 'イ'), + (0x32D2, 'M', 'ウ'), + (0x32D3, 'M', 'エ'), + (0x32D4, 'M', 'オ'), + (0x32D5, 'M', 'カ'), + (0x32D6, 'M', 'キ'), + (0x32D7, 'M', 'ク'), + (0x32D8, 'M', 'ケ'), + (0x32D9, 'M', 'コ'), + (0x32DA, 'M', 'サ'), + (0x32DB, 'M', 'シ'), + (0x32DC, 'M', 'ス'), + (0x32DD, 'M', 'セ'), + (0x32DE, 'M', 'ソ'), + (0x32DF, 'M', 'タ'), + (0x32E0, 'M', 'チ'), + (0x32E1, 'M', 'ツ'), + (0x32E2, 'M', 'テ'), + (0x32E3, 'M', 'ト'), + (0x32E4, 'M', 'ナ'), + (0x32E5, 'M', 'ニ'), + (0x32E6, 'M', 'ヌ'), + (0x32E7, 'M', 'ネ'), + (0x32E8, 'M', 'ノ'), + (0x32E9, 'M', 'ハ'), + (0x32EA, 'M', 'ヒ'), + (0x32EB, 'M', 'フ'), + (0x32EC, 'M', 'ヘ'), + (0x32ED, 'M', 'ホ'), + (0x32EE, 'M', 'マ'), + (0x32EF, 'M', 'ミ'), + (0x32F0, 'M', 'ム'), + (0x32F1, 'M', 'メ'), + (0x32F2, 'M', 'モ'), + (0x32F3, 'M', 'ヤ'), + (0x32F4, 'M', 'ユ'), + (0x32F5, 'M', 'ヨ'), + (0x32F6, 'M', 'ラ'), + (0x32F7, 'M', 'リ'), + (0x32F8, 'M', 'ル'), + (0x32F9, 'M', 'レ'), + (0x32FA, 'M', 'ロ'), + (0x32FB, 'M', 'ワ'), + (0x32FC, 'M', 'ヰ'), + (0x32FD, 'M', 'ヱ'), + (0x32FE, 'M', 'ヲ'), + (0x32FF, 'M', '令和'), + (0x3300, 'M', 'アパート'), + (0x3301, 'M', 'アルファ'), + (0x3302, 'M', 'アンペア'), + (0x3303, 'M', 'アール'), + (0x3304, 'M', 'イニング'), + (0x3305, 'M', 'インチ'), + (0x3306, 'M', 'ウォン'), + (0x3307, 'M', 'エスクード'), + (0x3308, 'M', 'エーカー'), + (0x3309, 'M', 'オンス'), + (0x330A, 'M', 'オーム'), + (0x330B, 'M', 'カイリ'), + (0x330C, 'M', 'カラット'), + (0x330D, 'M', 'カロリー'), + (0x330E, 'M', 'ガロン'), + (0x330F, 'M', 'ガンマ'), + (0x3310, 'M', 'ギガ'), + (0x3311, 'M', 'ギニー'), + (0x3312, 'M', 'キュリー'), + (0x3313, 'M', 'ギルダー'), + (0x3314, 'M', 'キロ'), + (0x3315, 'M', 'キログラム'), + (0x3316, 'M', 'キロメートル'), + (0x3317, 'M', 'キロワット'), + (0x3318, 'M', 'グラム'), + (0x3319, 'M', 'グラムトン'), + ] + +def _seg_33() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x331A, 'M', 'クルゼイロ'), + (0x331B, 'M', 'クローネ'), + (0x331C, 'M', 'ケース'), + (0x331D, 'M', 'コルナ'), + (0x331E, 'M', 'コーポ'), + (0x331F, 'M', 'サイクル'), + (0x3320, 'M', 'サンチーム'), + (0x3321, 'M', 'シリング'), + (0x3322, 'M', 'センチ'), + (0x3323, 'M', 'セント'), + (0x3324, 'M', 'ダース'), + (0x3325, 'M', 'デシ'), + (0x3326, 'M', 'ドル'), + (0x3327, 'M', 'トン'), + (0x3328, 'M', 'ナノ'), + (0x3329, 'M', 'ノット'), + (0x332A, 'M', 'ハイツ'), + (0x332B, 'M', 'パーセント'), + (0x332C, 'M', 'パーツ'), + (0x332D, 'M', 'バーレル'), + (0x332E, 'M', 'ピアストル'), + (0x332F, 'M', 'ピクル'), + (0x3330, 'M', 'ピコ'), + (0x3331, 'M', 'ビル'), + (0x3332, 'M', 'ファラッド'), + (0x3333, 'M', 'フィート'), + (0x3334, 'M', 'ブッシェル'), + (0x3335, 'M', 'フラン'), + (0x3336, 'M', 'ヘクタール'), + (0x3337, 'M', 'ペソ'), + (0x3338, 'M', 'ペニヒ'), + (0x3339, 'M', 'ヘルツ'), + (0x333A, 'M', 'ペンス'), + (0x333B, 'M', 'ページ'), + (0x333C, 'M', 'ベータ'), + (0x333D, 'M', 'ポイント'), + (0x333E, 'M', 'ボルト'), + (0x333F, 'M', 'ホン'), + (0x3340, 'M', 'ポンド'), + (0x3341, 'M', 'ホール'), + (0x3342, 'M', 'ホーン'), + (0x3343, 'M', 'マイクロ'), + (0x3344, 'M', 'マイル'), + (0x3345, 'M', 'マッハ'), + (0x3346, 'M', 'マルク'), + (0x3347, 'M', 'マンション'), + (0x3348, 'M', 'ミクロン'), + (0x3349, 'M', 'ミリ'), + (0x334A, 'M', 'ミリバール'), + (0x334B, 'M', 'メガ'), + (0x334C, 'M', 'メガトン'), + (0x334D, 'M', 'メートル'), + (0x334E, 'M', 'ヤード'), + (0x334F, 'M', 'ヤール'), + (0x3350, 'M', 'ユアン'), + (0x3351, 'M', 'リットル'), + (0x3352, 'M', 'リラ'), + (0x3353, 'M', 'ルピー'), + (0x3354, 'M', 'ルーブル'), + (0x3355, 'M', 'レム'), + (0x3356, 'M', 'レントゲン'), + (0x3357, 'M', 'ワット'), + (0x3358, 'M', '0点'), + (0x3359, 'M', '1点'), + (0x335A, 'M', '2点'), + (0x335B, 'M', '3点'), + (0x335C, 'M', '4点'), + (0x335D, 'M', '5点'), + (0x335E, 'M', '6点'), + (0x335F, 'M', '7点'), + (0x3360, 'M', '8点'), + (0x3361, 'M', '9点'), + (0x3362, 'M', '10点'), + (0x3363, 'M', '11点'), + (0x3364, 'M', '12点'), + (0x3365, 'M', '13点'), + (0x3366, 'M', '14点'), + (0x3367, 'M', '15点'), + (0x3368, 'M', '16点'), + (0x3369, 'M', '17点'), + (0x336A, 'M', '18点'), + (0x336B, 'M', '19点'), + (0x336C, 'M', '20点'), + (0x336D, 'M', '21点'), + (0x336E, 'M', '22点'), + (0x336F, 'M', '23点'), + (0x3370, 'M', '24点'), + (0x3371, 'M', 'hpa'), + (0x3372, 'M', 'da'), + (0x3373, 'M', 'au'), + (0x3374, 'M', 'bar'), + (0x3375, 'M', 'ov'), + (0x3376, 'M', 'pc'), + (0x3377, 'M', 'dm'), + (0x3378, 'M', 'dm2'), + (0x3379, 'M', 'dm3'), + (0x337A, 'M', 'iu'), + (0x337B, 'M', '平成'), + (0x337C, 'M', '昭和'), + (0x337D, 'M', '大正'), + ] + +def _seg_34() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x337E, 'M', '明治'), + (0x337F, 'M', '株式会社'), + (0x3380, 'M', 'pa'), + (0x3381, 'M', 'na'), + (0x3382, 'M', 'μa'), + (0x3383, 'M', 'ma'), + (0x3384, 'M', 'ka'), + (0x3385, 'M', 'kb'), + (0x3386, 'M', 'mb'), + (0x3387, 'M', 'gb'), + (0x3388, 'M', 'cal'), + (0x3389, 'M', 'kcal'), + (0x338A, 'M', 'pf'), + (0x338B, 'M', 'nf'), + (0x338C, 'M', 'μf'), + (0x338D, 'M', 'μg'), + (0x338E, 'M', 'mg'), + (0x338F, 'M', 'kg'), + (0x3390, 'M', 'hz'), + (0x3391, 'M', 'khz'), + (0x3392, 'M', 'mhz'), + (0x3393, 'M', 'ghz'), + (0x3394, 'M', 'thz'), + (0x3395, 'M', 'μl'), + (0x3396, 'M', 'ml'), + (0x3397, 'M', 'dl'), + (0x3398, 'M', 'kl'), + (0x3399, 'M', 'fm'), + (0x339A, 'M', 'nm'), + (0x339B, 'M', 'μm'), + (0x339C, 'M', 'mm'), + (0x339D, 'M', 'cm'), + (0x339E, 'M', 'km'), + (0x339F, 'M', 'mm2'), + (0x33A0, 'M', 'cm2'), + (0x33A1, 'M', 'm2'), + (0x33A2, 'M', 'km2'), + (0x33A3, 'M', 'mm3'), + (0x33A4, 'M', 'cm3'), + (0x33A5, 'M', 'm3'), + (0x33A6, 'M', 'km3'), + (0x33A7, 'M', 'm∕s'), + (0x33A8, 'M', 'm∕s2'), + (0x33A9, 'M', 'pa'), + (0x33AA, 'M', 'kpa'), + (0x33AB, 'M', 'mpa'), + (0x33AC, 'M', 'gpa'), + (0x33AD, 'M', 'rad'), + (0x33AE, 'M', 'rad∕s'), + (0x33AF, 'M', 'rad∕s2'), + (0x33B0, 'M', 'ps'), + (0x33B1, 'M', 'ns'), + (0x33B2, 'M', 'μs'), + (0x33B3, 'M', 'ms'), + (0x33B4, 'M', 'pv'), + (0x33B5, 'M', 'nv'), + (0x33B6, 'M', 'μv'), + (0x33B7, 'M', 'mv'), + (0x33B8, 'M', 'kv'), + (0x33B9, 'M', 'mv'), + (0x33BA, 'M', 'pw'), + (0x33BB, 'M', 'nw'), + (0x33BC, 'M', 'μw'), + (0x33BD, 'M', 'mw'), + (0x33BE, 'M', 'kw'), + (0x33BF, 'M', 'mw'), + (0x33C0, 'M', 'kω'), + (0x33C1, 'M', 'mω'), + (0x33C2, 'X'), + (0x33C3, 'M', 'bq'), + (0x33C4, 'M', 'cc'), + (0x33C5, 'M', 'cd'), + (0x33C6, 'M', 'c∕kg'), + (0x33C7, 'X'), + (0x33C8, 'M', 'db'), + (0x33C9, 'M', 'gy'), + (0x33CA, 'M', 'ha'), + (0x33CB, 'M', 'hp'), + (0x33CC, 'M', 'in'), + (0x33CD, 'M', 'kk'), + (0x33CE, 'M', 'km'), + (0x33CF, 'M', 'kt'), + (0x33D0, 'M', 'lm'), + (0x33D1, 'M', 'ln'), + (0x33D2, 'M', 'log'), + (0x33D3, 'M', 'lx'), + (0x33D4, 'M', 'mb'), + (0x33D5, 'M', 'mil'), + (0x33D6, 'M', 'mol'), + (0x33D7, 'M', 'ph'), + (0x33D8, 'X'), + (0x33D9, 'M', 'ppm'), + (0x33DA, 'M', 'pr'), + (0x33DB, 'M', 'sr'), + (0x33DC, 'M', 'sv'), + (0x33DD, 'M', 'wb'), + (0x33DE, 'M', 'v∕m'), + (0x33DF, 'M', 'a∕m'), + (0x33E0, 'M', '1日'), + (0x33E1, 'M', '2日'), + ] + +def _seg_35() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x33E2, 'M', '3日'), + (0x33E3, 'M', '4日'), + (0x33E4, 'M', '5日'), + (0x33E5, 'M', '6日'), + (0x33E6, 'M', '7日'), + (0x33E7, 'M', '8日'), + (0x33E8, 'M', '9日'), + (0x33E9, 'M', '10日'), + (0x33EA, 'M', '11日'), + (0x33EB, 'M', '12日'), + (0x33EC, 'M', '13日'), + (0x33ED, 'M', '14日'), + (0x33EE, 'M', '15日'), + (0x33EF, 'M', '16日'), + (0x33F0, 'M', '17日'), + (0x33F1, 'M', '18日'), + (0x33F2, 'M', '19日'), + (0x33F3, 'M', '20日'), + (0x33F4, 'M', '21日'), + (0x33F5, 'M', '22日'), + (0x33F6, 'M', '23日'), + (0x33F7, 'M', '24日'), + (0x33F8, 'M', '25日'), + (0x33F9, 'M', '26日'), + (0x33FA, 'M', '27日'), + (0x33FB, 'M', '28日'), + (0x33FC, 'M', '29日'), + (0x33FD, 'M', '30日'), + (0x33FE, 'M', '31日'), + (0x33FF, 'M', 'gal'), + (0x3400, 'V'), + (0xA48D, 'X'), + (0xA490, 'V'), + (0xA4C7, 'X'), + (0xA4D0, 'V'), + (0xA62C, 'X'), + (0xA640, 'M', 'ꙁ'), + (0xA641, 'V'), + (0xA642, 'M', 'ꙃ'), + (0xA643, 'V'), + (0xA644, 'M', 'ꙅ'), + (0xA645, 'V'), + (0xA646, 'M', 'ꙇ'), + (0xA647, 'V'), + (0xA648, 'M', 'ꙉ'), + (0xA649, 'V'), + (0xA64A, 'M', 'ꙋ'), + (0xA64B, 'V'), + (0xA64C, 'M', 'ꙍ'), + (0xA64D, 'V'), + (0xA64E, 'M', 'ꙏ'), + (0xA64F, 'V'), + (0xA650, 'M', 'ꙑ'), + (0xA651, 'V'), + (0xA652, 'M', 'ꙓ'), + (0xA653, 'V'), + (0xA654, 'M', 'ꙕ'), + (0xA655, 'V'), + (0xA656, 'M', 'ꙗ'), + (0xA657, 'V'), + (0xA658, 'M', 'ꙙ'), + (0xA659, 'V'), + (0xA65A, 'M', 'ꙛ'), + (0xA65B, 'V'), + (0xA65C, 'M', 'ꙝ'), + (0xA65D, 'V'), + (0xA65E, 'M', 'ꙟ'), + (0xA65F, 'V'), + (0xA660, 'M', 'ꙡ'), + (0xA661, 'V'), + (0xA662, 'M', 'ꙣ'), + (0xA663, 'V'), + (0xA664, 'M', 'ꙥ'), + (0xA665, 'V'), + (0xA666, 'M', 'ꙧ'), + (0xA667, 'V'), + (0xA668, 'M', 'ꙩ'), + (0xA669, 'V'), + (0xA66A, 'M', 'ꙫ'), + (0xA66B, 'V'), + (0xA66C, 'M', 'ꙭ'), + (0xA66D, 'V'), + (0xA680, 'M', 'ꚁ'), + (0xA681, 'V'), + (0xA682, 'M', 'ꚃ'), + (0xA683, 'V'), + (0xA684, 'M', 'ꚅ'), + (0xA685, 'V'), + (0xA686, 'M', 'ꚇ'), + (0xA687, 'V'), + (0xA688, 'M', 'ꚉ'), + (0xA689, 'V'), + (0xA68A, 'M', 'ꚋ'), + (0xA68B, 'V'), + (0xA68C, 'M', 'ꚍ'), + (0xA68D, 'V'), + (0xA68E, 'M', 'ꚏ'), + (0xA68F, 'V'), + (0xA690, 'M', 'ꚑ'), + (0xA691, 'V'), + ] + +def _seg_36() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xA692, 'M', 'ꚓ'), + (0xA693, 'V'), + (0xA694, 'M', 'ꚕ'), + (0xA695, 'V'), + (0xA696, 'M', 'ꚗ'), + (0xA697, 'V'), + (0xA698, 'M', 'ꚙ'), + (0xA699, 'V'), + (0xA69A, 'M', 'ꚛ'), + (0xA69B, 'V'), + (0xA69C, 'M', 'ъ'), + (0xA69D, 'M', 'ь'), + (0xA69E, 'V'), + (0xA6F8, 'X'), + (0xA700, 'V'), + (0xA722, 'M', 'ꜣ'), + (0xA723, 'V'), + (0xA724, 'M', 'ꜥ'), + (0xA725, 'V'), + (0xA726, 'M', 'ꜧ'), + (0xA727, 'V'), + (0xA728, 'M', 'ꜩ'), + (0xA729, 'V'), + (0xA72A, 'M', 'ꜫ'), + (0xA72B, 'V'), + (0xA72C, 'M', 'ꜭ'), + (0xA72D, 'V'), + (0xA72E, 'M', 'ꜯ'), + (0xA72F, 'V'), + (0xA732, 'M', 'ꜳ'), + (0xA733, 'V'), + (0xA734, 'M', 'ꜵ'), + (0xA735, 'V'), + (0xA736, 'M', 'ꜷ'), + (0xA737, 'V'), + (0xA738, 'M', 'ꜹ'), + (0xA739, 'V'), + (0xA73A, 'M', 'ꜻ'), + (0xA73B, 'V'), + (0xA73C, 'M', 'ꜽ'), + (0xA73D, 'V'), + (0xA73E, 'M', 'ꜿ'), + (0xA73F, 'V'), + (0xA740, 'M', 'ꝁ'), + (0xA741, 'V'), + (0xA742, 'M', 'ꝃ'), + (0xA743, 'V'), + (0xA744, 'M', 'ꝅ'), + (0xA745, 'V'), + (0xA746, 'M', 'ꝇ'), + (0xA747, 'V'), + (0xA748, 'M', 'ꝉ'), + (0xA749, 'V'), + (0xA74A, 'M', 'ꝋ'), + (0xA74B, 'V'), + (0xA74C, 'M', 'ꝍ'), + (0xA74D, 'V'), + (0xA74E, 'M', 'ꝏ'), + (0xA74F, 'V'), + (0xA750, 'M', 'ꝑ'), + (0xA751, 'V'), + (0xA752, 'M', 'ꝓ'), + (0xA753, 'V'), + (0xA754, 'M', 'ꝕ'), + (0xA755, 'V'), + (0xA756, 'M', 'ꝗ'), + (0xA757, 'V'), + (0xA758, 'M', 'ꝙ'), + (0xA759, 'V'), + (0xA75A, 'M', 'ꝛ'), + (0xA75B, 'V'), + (0xA75C, 'M', 'ꝝ'), + (0xA75D, 'V'), + (0xA75E, 'M', 'ꝟ'), + (0xA75F, 'V'), + (0xA760, 'M', 'ꝡ'), + (0xA761, 'V'), + (0xA762, 'M', 'ꝣ'), + (0xA763, 'V'), + (0xA764, 'M', 'ꝥ'), + (0xA765, 'V'), + (0xA766, 'M', 'ꝧ'), + (0xA767, 'V'), + (0xA768, 'M', 'ꝩ'), + (0xA769, 'V'), + (0xA76A, 'M', 'ꝫ'), + (0xA76B, 'V'), + (0xA76C, 'M', 'ꝭ'), + (0xA76D, 'V'), + (0xA76E, 'M', 'ꝯ'), + (0xA76F, 'V'), + (0xA770, 'M', 'ꝯ'), + (0xA771, 'V'), + (0xA779, 'M', 'ꝺ'), + (0xA77A, 'V'), + (0xA77B, 'M', 'ꝼ'), + (0xA77C, 'V'), + (0xA77D, 'M', 'ᵹ'), + (0xA77E, 'M', 'ꝿ'), + (0xA77F, 'V'), + ] + +def _seg_37() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xA780, 'M', 'ꞁ'), + (0xA781, 'V'), + (0xA782, 'M', 'ꞃ'), + (0xA783, 'V'), + (0xA784, 'M', 'ꞅ'), + (0xA785, 'V'), + (0xA786, 'M', 'ꞇ'), + (0xA787, 'V'), + (0xA78B, 'M', 'ꞌ'), + (0xA78C, 'V'), + (0xA78D, 'M', 'ɥ'), + (0xA78E, 'V'), + (0xA790, 'M', 'ꞑ'), + (0xA791, 'V'), + (0xA792, 'M', 'ꞓ'), + (0xA793, 'V'), + (0xA796, 'M', 'ꞗ'), + (0xA797, 'V'), + (0xA798, 'M', 'ꞙ'), + (0xA799, 'V'), + (0xA79A, 'M', 'ꞛ'), + (0xA79B, 'V'), + (0xA79C, 'M', 'ꞝ'), + (0xA79D, 'V'), + (0xA79E, 'M', 'ꞟ'), + (0xA79F, 'V'), + (0xA7A0, 'M', 'ꞡ'), + (0xA7A1, 'V'), + (0xA7A2, 'M', 'ꞣ'), + (0xA7A3, 'V'), + (0xA7A4, 'M', 'ꞥ'), + (0xA7A5, 'V'), + (0xA7A6, 'M', 'ꞧ'), + (0xA7A7, 'V'), + (0xA7A8, 'M', 'ꞩ'), + (0xA7A9, 'V'), + (0xA7AA, 'M', 'ɦ'), + (0xA7AB, 'M', 'ɜ'), + (0xA7AC, 'M', 'ɡ'), + (0xA7AD, 'M', 'ɬ'), + (0xA7AE, 'M', 'ɪ'), + (0xA7AF, 'V'), + (0xA7B0, 'M', 'ʞ'), + (0xA7B1, 'M', 'ʇ'), + (0xA7B2, 'M', 'ʝ'), + (0xA7B3, 'M', 'ꭓ'), + (0xA7B4, 'M', 'ꞵ'), + (0xA7B5, 'V'), + (0xA7B6, 'M', 'ꞷ'), + (0xA7B7, 'V'), + (0xA7B8, 'M', 'ꞹ'), + (0xA7B9, 'V'), + (0xA7BA, 'M', 'ꞻ'), + (0xA7BB, 'V'), + (0xA7BC, 'M', 'ꞽ'), + (0xA7BD, 'V'), + (0xA7BE, 'M', 'ꞿ'), + (0xA7BF, 'V'), + (0xA7C0, 'M', 'ꟁ'), + (0xA7C1, 'V'), + (0xA7C2, 'M', 'ꟃ'), + (0xA7C3, 'V'), + (0xA7C4, 'M', 'ꞔ'), + (0xA7C5, 'M', 'ʂ'), + (0xA7C6, 'M', 'ᶎ'), + (0xA7C7, 'M', 'ꟈ'), + (0xA7C8, 'V'), + (0xA7C9, 'M', 'ꟊ'), + (0xA7CA, 'V'), + (0xA7CB, 'X'), + (0xA7D0, 'M', 'ꟑ'), + (0xA7D1, 'V'), + (0xA7D2, 'X'), + (0xA7D3, 'V'), + (0xA7D4, 'X'), + (0xA7D5, 'V'), + (0xA7D6, 'M', 'ꟗ'), + (0xA7D7, 'V'), + (0xA7D8, 'M', 'ꟙ'), + (0xA7D9, 'V'), + (0xA7DA, 'X'), + (0xA7F2, 'M', 'c'), + (0xA7F3, 'M', 'f'), + (0xA7F4, 'M', 'q'), + (0xA7F5, 'M', 'ꟶ'), + (0xA7F6, 'V'), + (0xA7F8, 'M', 'ħ'), + (0xA7F9, 'M', 'œ'), + (0xA7FA, 'V'), + (0xA82D, 'X'), + (0xA830, 'V'), + (0xA83A, 'X'), + (0xA840, 'V'), + (0xA878, 'X'), + (0xA880, 'V'), + (0xA8C6, 'X'), + (0xA8CE, 'V'), + (0xA8DA, 'X'), + (0xA8E0, 'V'), + (0xA954, 'X'), + ] + +def _seg_38() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xA95F, 'V'), + (0xA97D, 'X'), + (0xA980, 'V'), + (0xA9CE, 'X'), + (0xA9CF, 'V'), + (0xA9DA, 'X'), + (0xA9DE, 'V'), + (0xA9FF, 'X'), + (0xAA00, 'V'), + (0xAA37, 'X'), + (0xAA40, 'V'), + (0xAA4E, 'X'), + (0xAA50, 'V'), + (0xAA5A, 'X'), + (0xAA5C, 'V'), + (0xAAC3, 'X'), + (0xAADB, 'V'), + (0xAAF7, 'X'), + (0xAB01, 'V'), + (0xAB07, 'X'), + (0xAB09, 'V'), + (0xAB0F, 'X'), + (0xAB11, 'V'), + (0xAB17, 'X'), + (0xAB20, 'V'), + (0xAB27, 'X'), + (0xAB28, 'V'), + (0xAB2F, 'X'), + (0xAB30, 'V'), + (0xAB5C, 'M', 'ꜧ'), + (0xAB5D, 'M', 'ꬷ'), + (0xAB5E, 'M', 'ɫ'), + (0xAB5F, 'M', 'ꭒ'), + (0xAB60, 'V'), + (0xAB69, 'M', 'ʍ'), + (0xAB6A, 'V'), + (0xAB6C, 'X'), + (0xAB70, 'M', 'Ꭰ'), + (0xAB71, 'M', 'Ꭱ'), + (0xAB72, 'M', 'Ꭲ'), + (0xAB73, 'M', 'Ꭳ'), + (0xAB74, 'M', 'Ꭴ'), + (0xAB75, 'M', 'Ꭵ'), + (0xAB76, 'M', 'Ꭶ'), + (0xAB77, 'M', 'Ꭷ'), + (0xAB78, 'M', 'Ꭸ'), + (0xAB79, 'M', 'Ꭹ'), + (0xAB7A, 'M', 'Ꭺ'), + (0xAB7B, 'M', 'Ꭻ'), + (0xAB7C, 'M', 'Ꭼ'), + (0xAB7D, 'M', 'Ꭽ'), + (0xAB7E, 'M', 'Ꭾ'), + (0xAB7F, 'M', 'Ꭿ'), + (0xAB80, 'M', 'Ꮀ'), + (0xAB81, 'M', 'Ꮁ'), + (0xAB82, 'M', 'Ꮂ'), + (0xAB83, 'M', 'Ꮃ'), + (0xAB84, 'M', 'Ꮄ'), + (0xAB85, 'M', 'Ꮅ'), + (0xAB86, 'M', 'Ꮆ'), + (0xAB87, 'M', 'Ꮇ'), + (0xAB88, 'M', 'Ꮈ'), + (0xAB89, 'M', 'Ꮉ'), + (0xAB8A, 'M', 'Ꮊ'), + (0xAB8B, 'M', 'Ꮋ'), + (0xAB8C, 'M', 'Ꮌ'), + (0xAB8D, 'M', 'Ꮍ'), + (0xAB8E, 'M', 'Ꮎ'), + (0xAB8F, 'M', 'Ꮏ'), + (0xAB90, 'M', 'Ꮐ'), + (0xAB91, 'M', 'Ꮑ'), + (0xAB92, 'M', 'Ꮒ'), + (0xAB93, 'M', 'Ꮓ'), + (0xAB94, 'M', 'Ꮔ'), + (0xAB95, 'M', 'Ꮕ'), + (0xAB96, 'M', 'Ꮖ'), + (0xAB97, 'M', 'Ꮗ'), + (0xAB98, 'M', 'Ꮘ'), + (0xAB99, 'M', 'Ꮙ'), + (0xAB9A, 'M', 'Ꮚ'), + (0xAB9B, 'M', 'Ꮛ'), + (0xAB9C, 'M', 'Ꮜ'), + (0xAB9D, 'M', 'Ꮝ'), + (0xAB9E, 'M', 'Ꮞ'), + (0xAB9F, 'M', 'Ꮟ'), + (0xABA0, 'M', 'Ꮠ'), + (0xABA1, 'M', 'Ꮡ'), + (0xABA2, 'M', 'Ꮢ'), + (0xABA3, 'M', 'Ꮣ'), + (0xABA4, 'M', 'Ꮤ'), + (0xABA5, 'M', 'Ꮥ'), + (0xABA6, 'M', 'Ꮦ'), + (0xABA7, 'M', 'Ꮧ'), + (0xABA8, 'M', 'Ꮨ'), + (0xABA9, 'M', 'Ꮩ'), + (0xABAA, 'M', 'Ꮪ'), + (0xABAB, 'M', 'Ꮫ'), + (0xABAC, 'M', 'Ꮬ'), + (0xABAD, 'M', 'Ꮭ'), + (0xABAE, 'M', 'Ꮮ'), + ] + +def _seg_39() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xABAF, 'M', 'Ꮯ'), + (0xABB0, 'M', 'Ꮰ'), + (0xABB1, 'M', 'Ꮱ'), + (0xABB2, 'M', 'Ꮲ'), + (0xABB3, 'M', 'Ꮳ'), + (0xABB4, 'M', 'Ꮴ'), + (0xABB5, 'M', 'Ꮵ'), + (0xABB6, 'M', 'Ꮶ'), + (0xABB7, 'M', 'Ꮷ'), + (0xABB8, 'M', 'Ꮸ'), + (0xABB9, 'M', 'Ꮹ'), + (0xABBA, 'M', 'Ꮺ'), + (0xABBB, 'M', 'Ꮻ'), + (0xABBC, 'M', 'Ꮼ'), + (0xABBD, 'M', 'Ꮽ'), + (0xABBE, 'M', 'Ꮾ'), + (0xABBF, 'M', 'Ꮿ'), + (0xABC0, 'V'), + (0xABEE, 'X'), + (0xABF0, 'V'), + (0xABFA, 'X'), + (0xAC00, 'V'), + (0xD7A4, 'X'), + (0xD7B0, 'V'), + (0xD7C7, 'X'), + (0xD7CB, 'V'), + (0xD7FC, 'X'), + (0xF900, 'M', '豈'), + (0xF901, 'M', '更'), + (0xF902, 'M', '車'), + (0xF903, 'M', '賈'), + (0xF904, 'M', '滑'), + (0xF905, 'M', '串'), + (0xF906, 'M', '句'), + (0xF907, 'M', '龜'), + (0xF909, 'M', '契'), + (0xF90A, 'M', '金'), + (0xF90B, 'M', '喇'), + (0xF90C, 'M', '奈'), + (0xF90D, 'M', '懶'), + (0xF90E, 'M', '癩'), + (0xF90F, 'M', '羅'), + (0xF910, 'M', '蘿'), + (0xF911, 'M', '螺'), + (0xF912, 'M', '裸'), + (0xF913, 'M', '邏'), + (0xF914, 'M', '樂'), + (0xF915, 'M', '洛'), + (0xF916, 'M', '烙'), + (0xF917, 'M', '珞'), + (0xF918, 'M', '落'), + (0xF919, 'M', '酪'), + (0xF91A, 'M', '駱'), + (0xF91B, 'M', '亂'), + (0xF91C, 'M', '卵'), + (0xF91D, 'M', '欄'), + (0xF91E, 'M', '爛'), + (0xF91F, 'M', '蘭'), + (0xF920, 'M', '鸞'), + (0xF921, 'M', '嵐'), + (0xF922, 'M', '濫'), + (0xF923, 'M', '藍'), + (0xF924, 'M', '襤'), + (0xF925, 'M', '拉'), + (0xF926, 'M', '臘'), + (0xF927, 'M', '蠟'), + (0xF928, 'M', '廊'), + (0xF929, 'M', '朗'), + (0xF92A, 'M', '浪'), + (0xF92B, 'M', '狼'), + (0xF92C, 'M', '郎'), + (0xF92D, 'M', '來'), + (0xF92E, 'M', '冷'), + (0xF92F, 'M', '勞'), + (0xF930, 'M', '擄'), + (0xF931, 'M', '櫓'), + (0xF932, 'M', '爐'), + (0xF933, 'M', '盧'), + (0xF934, 'M', '老'), + (0xF935, 'M', '蘆'), + (0xF936, 'M', '虜'), + (0xF937, 'M', '路'), + (0xF938, 'M', '露'), + (0xF939, 'M', '魯'), + (0xF93A, 'M', '鷺'), + (0xF93B, 'M', '碌'), + (0xF93C, 'M', '祿'), + (0xF93D, 'M', '綠'), + (0xF93E, 'M', '菉'), + (0xF93F, 'M', '錄'), + (0xF940, 'M', '鹿'), + (0xF941, 'M', '論'), + (0xF942, 'M', '壟'), + (0xF943, 'M', '弄'), + (0xF944, 'M', '籠'), + (0xF945, 'M', '聾'), + (0xF946, 'M', '牢'), + (0xF947, 'M', '磊'), + (0xF948, 'M', '賂'), + (0xF949, 'M', '雷'), + ] + +def _seg_40() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xF94A, 'M', '壘'), + (0xF94B, 'M', '屢'), + (0xF94C, 'M', '樓'), + (0xF94D, 'M', '淚'), + (0xF94E, 'M', '漏'), + (0xF94F, 'M', '累'), + (0xF950, 'M', '縷'), + (0xF951, 'M', '陋'), + (0xF952, 'M', '勒'), + (0xF953, 'M', '肋'), + (0xF954, 'M', '凜'), + (0xF955, 'M', '凌'), + (0xF956, 'M', '稜'), + (0xF957, 'M', '綾'), + (0xF958, 'M', '菱'), + (0xF959, 'M', '陵'), + (0xF95A, 'M', '讀'), + (0xF95B, 'M', '拏'), + (0xF95C, 'M', '樂'), + (0xF95D, 'M', '諾'), + (0xF95E, 'M', '丹'), + (0xF95F, 'M', '寧'), + (0xF960, 'M', '怒'), + (0xF961, 'M', '率'), + (0xF962, 'M', '異'), + (0xF963, 'M', '北'), + (0xF964, 'M', '磻'), + (0xF965, 'M', '便'), + (0xF966, 'M', '復'), + (0xF967, 'M', '不'), + (0xF968, 'M', '泌'), + (0xF969, 'M', '數'), + (0xF96A, 'M', '索'), + (0xF96B, 'M', '參'), + (0xF96C, 'M', '塞'), + (0xF96D, 'M', '省'), + (0xF96E, 'M', '葉'), + (0xF96F, 'M', '說'), + (0xF970, 'M', '殺'), + (0xF971, 'M', '辰'), + (0xF972, 'M', '沈'), + (0xF973, 'M', '拾'), + (0xF974, 'M', '若'), + (0xF975, 'M', '掠'), + (0xF976, 'M', '略'), + (0xF977, 'M', '亮'), + (0xF978, 'M', '兩'), + (0xF979, 'M', '凉'), + (0xF97A, 'M', '梁'), + (0xF97B, 'M', '糧'), + (0xF97C, 'M', '良'), + (0xF97D, 'M', '諒'), + (0xF97E, 'M', '量'), + (0xF97F, 'M', '勵'), + (0xF980, 'M', '呂'), + (0xF981, 'M', '女'), + (0xF982, 'M', '廬'), + (0xF983, 'M', '旅'), + (0xF984, 'M', '濾'), + (0xF985, 'M', '礪'), + (0xF986, 'M', '閭'), + (0xF987, 'M', '驪'), + (0xF988, 'M', '麗'), + (0xF989, 'M', '黎'), + (0xF98A, 'M', '力'), + (0xF98B, 'M', '曆'), + (0xF98C, 'M', '歷'), + (0xF98D, 'M', '轢'), + (0xF98E, 'M', '年'), + (0xF98F, 'M', '憐'), + (0xF990, 'M', '戀'), + (0xF991, 'M', '撚'), + (0xF992, 'M', '漣'), + (0xF993, 'M', '煉'), + (0xF994, 'M', '璉'), + (0xF995, 'M', '秊'), + (0xF996, 'M', '練'), + (0xF997, 'M', '聯'), + (0xF998, 'M', '輦'), + (0xF999, 'M', '蓮'), + (0xF99A, 'M', '連'), + (0xF99B, 'M', '鍊'), + (0xF99C, 'M', '列'), + (0xF99D, 'M', '劣'), + (0xF99E, 'M', '咽'), + (0xF99F, 'M', '烈'), + (0xF9A0, 'M', '裂'), + (0xF9A1, 'M', '說'), + (0xF9A2, 'M', '廉'), + (0xF9A3, 'M', '念'), + (0xF9A4, 'M', '捻'), + (0xF9A5, 'M', '殮'), + (0xF9A6, 'M', '簾'), + (0xF9A7, 'M', '獵'), + (0xF9A8, 'M', '令'), + (0xF9A9, 'M', '囹'), + (0xF9AA, 'M', '寧'), + (0xF9AB, 'M', '嶺'), + (0xF9AC, 'M', '怜'), + (0xF9AD, 'M', '玲'), + ] + +def _seg_41() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xF9AE, 'M', '瑩'), + (0xF9AF, 'M', '羚'), + (0xF9B0, 'M', '聆'), + (0xF9B1, 'M', '鈴'), + (0xF9B2, 'M', '零'), + (0xF9B3, 'M', '靈'), + (0xF9B4, 'M', '領'), + (0xF9B5, 'M', '例'), + (0xF9B6, 'M', '禮'), + (0xF9B7, 'M', '醴'), + (0xF9B8, 'M', '隸'), + (0xF9B9, 'M', '惡'), + (0xF9BA, 'M', '了'), + (0xF9BB, 'M', '僚'), + (0xF9BC, 'M', '寮'), + (0xF9BD, 'M', '尿'), + (0xF9BE, 'M', '料'), + (0xF9BF, 'M', '樂'), + (0xF9C0, 'M', '燎'), + (0xF9C1, 'M', '療'), + (0xF9C2, 'M', '蓼'), + (0xF9C3, 'M', '遼'), + (0xF9C4, 'M', '龍'), + (0xF9C5, 'M', '暈'), + (0xF9C6, 'M', '阮'), + (0xF9C7, 'M', '劉'), + (0xF9C8, 'M', '杻'), + (0xF9C9, 'M', '柳'), + (0xF9CA, 'M', '流'), + (0xF9CB, 'M', '溜'), + (0xF9CC, 'M', '琉'), + (0xF9CD, 'M', '留'), + (0xF9CE, 'M', '硫'), + (0xF9CF, 'M', '紐'), + (0xF9D0, 'M', '類'), + (0xF9D1, 'M', '六'), + (0xF9D2, 'M', '戮'), + (0xF9D3, 'M', '陸'), + (0xF9D4, 'M', '倫'), + (0xF9D5, 'M', '崙'), + (0xF9D6, 'M', '淪'), + (0xF9D7, 'M', '輪'), + (0xF9D8, 'M', '律'), + (0xF9D9, 'M', '慄'), + (0xF9DA, 'M', '栗'), + (0xF9DB, 'M', '率'), + (0xF9DC, 'M', '隆'), + (0xF9DD, 'M', '利'), + (0xF9DE, 'M', '吏'), + (0xF9DF, 'M', '履'), + (0xF9E0, 'M', '易'), + (0xF9E1, 'M', '李'), + (0xF9E2, 'M', '梨'), + (0xF9E3, 'M', '泥'), + (0xF9E4, 'M', '理'), + (0xF9E5, 'M', '痢'), + (0xF9E6, 'M', '罹'), + (0xF9E7, 'M', '裏'), + (0xF9E8, 'M', '裡'), + (0xF9E9, 'M', '里'), + (0xF9EA, 'M', '離'), + (0xF9EB, 'M', '匿'), + (0xF9EC, 'M', '溺'), + (0xF9ED, 'M', '吝'), + (0xF9EE, 'M', '燐'), + (0xF9EF, 'M', '璘'), + (0xF9F0, 'M', '藺'), + (0xF9F1, 'M', '隣'), + (0xF9F2, 'M', '鱗'), + (0xF9F3, 'M', '麟'), + (0xF9F4, 'M', '林'), + (0xF9F5, 'M', '淋'), + (0xF9F6, 'M', '臨'), + (0xF9F7, 'M', '立'), + (0xF9F8, 'M', '笠'), + (0xF9F9, 'M', '粒'), + (0xF9FA, 'M', '狀'), + (0xF9FB, 'M', '炙'), + (0xF9FC, 'M', '識'), + (0xF9FD, 'M', '什'), + (0xF9FE, 'M', '茶'), + (0xF9FF, 'M', '刺'), + (0xFA00, 'M', '切'), + (0xFA01, 'M', '度'), + (0xFA02, 'M', '拓'), + (0xFA03, 'M', '糖'), + (0xFA04, 'M', '宅'), + (0xFA05, 'M', '洞'), + (0xFA06, 'M', '暴'), + (0xFA07, 'M', '輻'), + (0xFA08, 'M', '行'), + (0xFA09, 'M', '降'), + (0xFA0A, 'M', '見'), + (0xFA0B, 'M', '廓'), + (0xFA0C, 'M', '兀'), + (0xFA0D, 'M', '嗀'), + (0xFA0E, 'V'), + (0xFA10, 'M', '塚'), + (0xFA11, 'V'), + (0xFA12, 'M', '晴'), + ] + +def _seg_42() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xFA13, 'V'), + (0xFA15, 'M', '凞'), + (0xFA16, 'M', '猪'), + (0xFA17, 'M', '益'), + (0xFA18, 'M', '礼'), + (0xFA19, 'M', '神'), + (0xFA1A, 'M', '祥'), + (0xFA1B, 'M', '福'), + (0xFA1C, 'M', '靖'), + (0xFA1D, 'M', '精'), + (0xFA1E, 'M', '羽'), + (0xFA1F, 'V'), + (0xFA20, 'M', '蘒'), + (0xFA21, 'V'), + (0xFA22, 'M', '諸'), + (0xFA23, 'V'), + (0xFA25, 'M', '逸'), + (0xFA26, 'M', '都'), + (0xFA27, 'V'), + (0xFA2A, 'M', '飯'), + (0xFA2B, 'M', '飼'), + (0xFA2C, 'M', '館'), + (0xFA2D, 'M', '鶴'), + (0xFA2E, 'M', '郞'), + (0xFA2F, 'M', '隷'), + (0xFA30, 'M', '侮'), + (0xFA31, 'M', '僧'), + (0xFA32, 'M', '免'), + (0xFA33, 'M', '勉'), + (0xFA34, 'M', '勤'), + (0xFA35, 'M', '卑'), + (0xFA36, 'M', '喝'), + (0xFA37, 'M', '嘆'), + (0xFA38, 'M', '器'), + (0xFA39, 'M', '塀'), + (0xFA3A, 'M', '墨'), + (0xFA3B, 'M', '層'), + (0xFA3C, 'M', '屮'), + (0xFA3D, 'M', '悔'), + (0xFA3E, 'M', '慨'), + (0xFA3F, 'M', '憎'), + (0xFA40, 'M', '懲'), + (0xFA41, 'M', '敏'), + (0xFA42, 'M', '既'), + (0xFA43, 'M', '暑'), + (0xFA44, 'M', '梅'), + (0xFA45, 'M', '海'), + (0xFA46, 'M', '渚'), + (0xFA47, 'M', '漢'), + (0xFA48, 'M', '煮'), + (0xFA49, 'M', '爫'), + (0xFA4A, 'M', '琢'), + (0xFA4B, 'M', '碑'), + (0xFA4C, 'M', '社'), + (0xFA4D, 'M', '祉'), + (0xFA4E, 'M', '祈'), + (0xFA4F, 'M', '祐'), + (0xFA50, 'M', '祖'), + (0xFA51, 'M', '祝'), + (0xFA52, 'M', '禍'), + (0xFA53, 'M', '禎'), + (0xFA54, 'M', '穀'), + (0xFA55, 'M', '突'), + (0xFA56, 'M', '節'), + (0xFA57, 'M', '練'), + (0xFA58, 'M', '縉'), + (0xFA59, 'M', '繁'), + (0xFA5A, 'M', '署'), + (0xFA5B, 'M', '者'), + (0xFA5C, 'M', '臭'), + (0xFA5D, 'M', '艹'), + (0xFA5F, 'M', '著'), + (0xFA60, 'M', '褐'), + (0xFA61, 'M', '視'), + (0xFA62, 'M', '謁'), + (0xFA63, 'M', '謹'), + (0xFA64, 'M', '賓'), + (0xFA65, 'M', '贈'), + (0xFA66, 'M', '辶'), + (0xFA67, 'M', '逸'), + (0xFA68, 'M', '難'), + (0xFA69, 'M', '響'), + (0xFA6A, 'M', '頻'), + (0xFA6B, 'M', '恵'), + (0xFA6C, 'M', '𤋮'), + (0xFA6D, 'M', '舘'), + (0xFA6E, 'X'), + (0xFA70, 'M', '並'), + (0xFA71, 'M', '况'), + (0xFA72, 'M', '全'), + (0xFA73, 'M', '侀'), + (0xFA74, 'M', '充'), + (0xFA75, 'M', '冀'), + (0xFA76, 'M', '勇'), + (0xFA77, 'M', '勺'), + (0xFA78, 'M', '喝'), + (0xFA79, 'M', '啕'), + (0xFA7A, 'M', '喙'), + (0xFA7B, 'M', '嗢'), + (0xFA7C, 'M', '塚'), + ] + +def _seg_43() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xFA7D, 'M', '墳'), + (0xFA7E, 'M', '奄'), + (0xFA7F, 'M', '奔'), + (0xFA80, 'M', '婢'), + (0xFA81, 'M', '嬨'), + (0xFA82, 'M', '廒'), + (0xFA83, 'M', '廙'), + (0xFA84, 'M', '彩'), + (0xFA85, 'M', '徭'), + (0xFA86, 'M', '惘'), + (0xFA87, 'M', '慎'), + (0xFA88, 'M', '愈'), + (0xFA89, 'M', '憎'), + (0xFA8A, 'M', '慠'), + (0xFA8B, 'M', '懲'), + (0xFA8C, 'M', '戴'), + (0xFA8D, 'M', '揄'), + (0xFA8E, 'M', '搜'), + (0xFA8F, 'M', '摒'), + (0xFA90, 'M', '敖'), + (0xFA91, 'M', '晴'), + (0xFA92, 'M', '朗'), + (0xFA93, 'M', '望'), + (0xFA94, 'M', '杖'), + (0xFA95, 'M', '歹'), + (0xFA96, 'M', '殺'), + (0xFA97, 'M', '流'), + (0xFA98, 'M', '滛'), + (0xFA99, 'M', '滋'), + (0xFA9A, 'M', '漢'), + (0xFA9B, 'M', '瀞'), + (0xFA9C, 'M', '煮'), + (0xFA9D, 'M', '瞧'), + (0xFA9E, 'M', '爵'), + (0xFA9F, 'M', '犯'), + (0xFAA0, 'M', '猪'), + (0xFAA1, 'M', '瑱'), + (0xFAA2, 'M', '甆'), + (0xFAA3, 'M', '画'), + (0xFAA4, 'M', '瘝'), + (0xFAA5, 'M', '瘟'), + (0xFAA6, 'M', '益'), + (0xFAA7, 'M', '盛'), + (0xFAA8, 'M', '直'), + (0xFAA9, 'M', '睊'), + (0xFAAA, 'M', '着'), + (0xFAAB, 'M', '磌'), + (0xFAAC, 'M', '窱'), + (0xFAAD, 'M', '節'), + (0xFAAE, 'M', '类'), + (0xFAAF, 'M', '絛'), + (0xFAB0, 'M', '練'), + (0xFAB1, 'M', '缾'), + (0xFAB2, 'M', '者'), + (0xFAB3, 'M', '荒'), + (0xFAB4, 'M', '華'), + (0xFAB5, 'M', '蝹'), + (0xFAB6, 'M', '襁'), + (0xFAB7, 'M', '覆'), + (0xFAB8, 'M', '視'), + (0xFAB9, 'M', '調'), + (0xFABA, 'M', '諸'), + (0xFABB, 'M', '請'), + (0xFABC, 'M', '謁'), + (0xFABD, 'M', '諾'), + (0xFABE, 'M', '諭'), + (0xFABF, 'M', '謹'), + (0xFAC0, 'M', '變'), + (0xFAC1, 'M', '贈'), + (0xFAC2, 'M', '輸'), + (0xFAC3, 'M', '遲'), + (0xFAC4, 'M', '醙'), + (0xFAC5, 'M', '鉶'), + (0xFAC6, 'M', '陼'), + (0xFAC7, 'M', '難'), + (0xFAC8, 'M', '靖'), + (0xFAC9, 'M', '韛'), + (0xFACA, 'M', '響'), + (0xFACB, 'M', '頋'), + (0xFACC, 'M', '頻'), + (0xFACD, 'M', '鬒'), + (0xFACE, 'M', '龜'), + (0xFACF, 'M', '𢡊'), + (0xFAD0, 'M', '𢡄'), + (0xFAD1, 'M', '𣏕'), + (0xFAD2, 'M', '㮝'), + (0xFAD3, 'M', '䀘'), + (0xFAD4, 'M', '䀹'), + (0xFAD5, 'M', '𥉉'), + (0xFAD6, 'M', '𥳐'), + (0xFAD7, 'M', '𧻓'), + (0xFAD8, 'M', '齃'), + (0xFAD9, 'M', '龎'), + (0xFADA, 'X'), + (0xFB00, 'M', 'ff'), + (0xFB01, 'M', 'fi'), + (0xFB02, 'M', 'fl'), + (0xFB03, 'M', 'ffi'), + (0xFB04, 'M', 'ffl'), + (0xFB05, 'M', 'st'), + ] + +def _seg_44() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xFB07, 'X'), + (0xFB13, 'M', 'մն'), + (0xFB14, 'M', 'մե'), + (0xFB15, 'M', 'մի'), + (0xFB16, 'M', 'վն'), + (0xFB17, 'M', 'մխ'), + (0xFB18, 'X'), + (0xFB1D, 'M', 'יִ'), + (0xFB1E, 'V'), + (0xFB1F, 'M', 'ײַ'), + (0xFB20, 'M', 'ע'), + (0xFB21, 'M', 'א'), + (0xFB22, 'M', 'ד'), + (0xFB23, 'M', 'ה'), + (0xFB24, 'M', 'כ'), + (0xFB25, 'M', 'ל'), + (0xFB26, 'M', 'ם'), + (0xFB27, 'M', 'ר'), + (0xFB28, 'M', 'ת'), + (0xFB29, '3', '+'), + (0xFB2A, 'M', 'שׁ'), + (0xFB2B, 'M', 'שׂ'), + (0xFB2C, 'M', 'שּׁ'), + (0xFB2D, 'M', 'שּׂ'), + (0xFB2E, 'M', 'אַ'), + (0xFB2F, 'M', 'אָ'), + (0xFB30, 'M', 'אּ'), + (0xFB31, 'M', 'בּ'), + (0xFB32, 'M', 'גּ'), + (0xFB33, 'M', 'דּ'), + (0xFB34, 'M', 'הּ'), + (0xFB35, 'M', 'וּ'), + (0xFB36, 'M', 'זּ'), + (0xFB37, 'X'), + (0xFB38, 'M', 'טּ'), + (0xFB39, 'M', 'יּ'), + (0xFB3A, 'M', 'ךּ'), + (0xFB3B, 'M', 'כּ'), + (0xFB3C, 'M', 'לּ'), + (0xFB3D, 'X'), + (0xFB3E, 'M', 'מּ'), + (0xFB3F, 'X'), + (0xFB40, 'M', 'נּ'), + (0xFB41, 'M', 'סּ'), + (0xFB42, 'X'), + (0xFB43, 'M', 'ףּ'), + (0xFB44, 'M', 'פּ'), + (0xFB45, 'X'), + (0xFB46, 'M', 'צּ'), + (0xFB47, 'M', 'קּ'), + (0xFB48, 'M', 'רּ'), + (0xFB49, 'M', 'שּ'), + (0xFB4A, 'M', 'תּ'), + (0xFB4B, 'M', 'וֹ'), + (0xFB4C, 'M', 'בֿ'), + (0xFB4D, 'M', 'כֿ'), + (0xFB4E, 'M', 'פֿ'), + (0xFB4F, 'M', 'אל'), + (0xFB50, 'M', 'ٱ'), + (0xFB52, 'M', 'ٻ'), + (0xFB56, 'M', 'پ'), + (0xFB5A, 'M', 'ڀ'), + (0xFB5E, 'M', 'ٺ'), + (0xFB62, 'M', 'ٿ'), + (0xFB66, 'M', 'ٹ'), + (0xFB6A, 'M', 'ڤ'), + (0xFB6E, 'M', 'ڦ'), + (0xFB72, 'M', 'ڄ'), + (0xFB76, 'M', 'ڃ'), + (0xFB7A, 'M', 'چ'), + (0xFB7E, 'M', 'ڇ'), + (0xFB82, 'M', 'ڍ'), + (0xFB84, 'M', 'ڌ'), + (0xFB86, 'M', 'ڎ'), + (0xFB88, 'M', 'ڈ'), + (0xFB8A, 'M', 'ژ'), + (0xFB8C, 'M', 'ڑ'), + (0xFB8E, 'M', 'ک'), + (0xFB92, 'M', 'گ'), + (0xFB96, 'M', 'ڳ'), + (0xFB9A, 'M', 'ڱ'), + (0xFB9E, 'M', 'ں'), + (0xFBA0, 'M', 'ڻ'), + (0xFBA4, 'M', 'ۀ'), + (0xFBA6, 'M', 'ہ'), + (0xFBAA, 'M', 'ھ'), + (0xFBAE, 'M', 'ے'), + (0xFBB0, 'M', 'ۓ'), + (0xFBB2, 'V'), + (0xFBC3, 'X'), + (0xFBD3, 'M', 'ڭ'), + (0xFBD7, 'M', 'ۇ'), + (0xFBD9, 'M', 'ۆ'), + (0xFBDB, 'M', 'ۈ'), + (0xFBDD, 'M', 'ۇٴ'), + (0xFBDE, 'M', 'ۋ'), + (0xFBE0, 'M', 'ۅ'), + (0xFBE2, 'M', 'ۉ'), + (0xFBE4, 'M', 'ې'), + (0xFBE8, 'M', 'ى'), + ] + +def _seg_45() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xFBEA, 'M', 'ئا'), + (0xFBEC, 'M', 'ئە'), + (0xFBEE, 'M', 'ئو'), + (0xFBF0, 'M', 'ئۇ'), + (0xFBF2, 'M', 'ئۆ'), + (0xFBF4, 'M', 'ئۈ'), + (0xFBF6, 'M', 'ئې'), + (0xFBF9, 'M', 'ئى'), + (0xFBFC, 'M', 'ی'), + (0xFC00, 'M', 'ئج'), + (0xFC01, 'M', 'ئح'), + (0xFC02, 'M', 'ئم'), + (0xFC03, 'M', 'ئى'), + (0xFC04, 'M', 'ئي'), + (0xFC05, 'M', 'بج'), + (0xFC06, 'M', 'بح'), + (0xFC07, 'M', 'بخ'), + (0xFC08, 'M', 'بم'), + (0xFC09, 'M', 'بى'), + (0xFC0A, 'M', 'بي'), + (0xFC0B, 'M', 'تج'), + (0xFC0C, 'M', 'تح'), + (0xFC0D, 'M', 'تخ'), + (0xFC0E, 'M', 'تم'), + (0xFC0F, 'M', 'تى'), + (0xFC10, 'M', 'تي'), + (0xFC11, 'M', 'ثج'), + (0xFC12, 'M', 'ثم'), + (0xFC13, 'M', 'ثى'), + (0xFC14, 'M', 'ثي'), + (0xFC15, 'M', 'جح'), + (0xFC16, 'M', 'جم'), + (0xFC17, 'M', 'حج'), + (0xFC18, 'M', 'حم'), + (0xFC19, 'M', 'خج'), + (0xFC1A, 'M', 'خح'), + (0xFC1B, 'M', 'خم'), + (0xFC1C, 'M', 'سج'), + (0xFC1D, 'M', 'سح'), + (0xFC1E, 'M', 'سخ'), + (0xFC1F, 'M', 'سم'), + (0xFC20, 'M', 'صح'), + (0xFC21, 'M', 'صم'), + (0xFC22, 'M', 'ضج'), + (0xFC23, 'M', 'ضح'), + (0xFC24, 'M', 'ضخ'), + (0xFC25, 'M', 'ضم'), + (0xFC26, 'M', 'طح'), + (0xFC27, 'M', 'طم'), + (0xFC28, 'M', 'ظم'), + (0xFC29, 'M', 'عج'), + (0xFC2A, 'M', 'عم'), + (0xFC2B, 'M', 'غج'), + (0xFC2C, 'M', 'غم'), + (0xFC2D, 'M', 'فج'), + (0xFC2E, 'M', 'فح'), + (0xFC2F, 'M', 'فخ'), + (0xFC30, 'M', 'فم'), + (0xFC31, 'M', 'فى'), + (0xFC32, 'M', 'في'), + (0xFC33, 'M', 'قح'), + (0xFC34, 'M', 'قم'), + (0xFC35, 'M', 'قى'), + (0xFC36, 'M', 'قي'), + (0xFC37, 'M', 'كا'), + (0xFC38, 'M', 'كج'), + (0xFC39, 'M', 'كح'), + (0xFC3A, 'M', 'كخ'), + (0xFC3B, 'M', 'كل'), + (0xFC3C, 'M', 'كم'), + (0xFC3D, 'M', 'كى'), + (0xFC3E, 'M', 'كي'), + (0xFC3F, 'M', 'لج'), + (0xFC40, 'M', 'لح'), + (0xFC41, 'M', 'لخ'), + (0xFC42, 'M', 'لم'), + (0xFC43, 'M', 'لى'), + (0xFC44, 'M', 'لي'), + (0xFC45, 'M', 'مج'), + (0xFC46, 'M', 'مح'), + (0xFC47, 'M', 'مخ'), + (0xFC48, 'M', 'مم'), + (0xFC49, 'M', 'مى'), + (0xFC4A, 'M', 'مي'), + (0xFC4B, 'M', 'نج'), + (0xFC4C, 'M', 'نح'), + (0xFC4D, 'M', 'نخ'), + (0xFC4E, 'M', 'نم'), + (0xFC4F, 'M', 'نى'), + (0xFC50, 'M', 'ني'), + (0xFC51, 'M', 'هج'), + (0xFC52, 'M', 'هم'), + (0xFC53, 'M', 'هى'), + (0xFC54, 'M', 'هي'), + (0xFC55, 'M', 'يج'), + (0xFC56, 'M', 'يح'), + (0xFC57, 'M', 'يخ'), + (0xFC58, 'M', 'يم'), + (0xFC59, 'M', 'يى'), + (0xFC5A, 'M', 'يي'), + ] + +def _seg_46() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xFC5B, 'M', 'ذٰ'), + (0xFC5C, 'M', 'رٰ'), + (0xFC5D, 'M', 'ىٰ'), + (0xFC5E, '3', ' ٌّ'), + (0xFC5F, '3', ' ٍّ'), + (0xFC60, '3', ' َّ'), + (0xFC61, '3', ' ُّ'), + (0xFC62, '3', ' ِّ'), + (0xFC63, '3', ' ّٰ'), + (0xFC64, 'M', 'ئر'), + (0xFC65, 'M', 'ئز'), + (0xFC66, 'M', 'ئم'), + (0xFC67, 'M', 'ئن'), + (0xFC68, 'M', 'ئى'), + (0xFC69, 'M', 'ئي'), + (0xFC6A, 'M', 'بر'), + (0xFC6B, 'M', 'بز'), + (0xFC6C, 'M', 'بم'), + (0xFC6D, 'M', 'بن'), + (0xFC6E, 'M', 'بى'), + (0xFC6F, 'M', 'بي'), + (0xFC70, 'M', 'تر'), + (0xFC71, 'M', 'تز'), + (0xFC72, 'M', 'تم'), + (0xFC73, 'M', 'تن'), + (0xFC74, 'M', 'تى'), + (0xFC75, 'M', 'تي'), + (0xFC76, 'M', 'ثر'), + (0xFC77, 'M', 'ثز'), + (0xFC78, 'M', 'ثم'), + (0xFC79, 'M', 'ثن'), + (0xFC7A, 'M', 'ثى'), + (0xFC7B, 'M', 'ثي'), + (0xFC7C, 'M', 'فى'), + (0xFC7D, 'M', 'في'), + (0xFC7E, 'M', 'قى'), + (0xFC7F, 'M', 'قي'), + (0xFC80, 'M', 'كا'), + (0xFC81, 'M', 'كل'), + (0xFC82, 'M', 'كم'), + (0xFC83, 'M', 'كى'), + (0xFC84, 'M', 'كي'), + (0xFC85, 'M', 'لم'), + (0xFC86, 'M', 'لى'), + (0xFC87, 'M', 'لي'), + (0xFC88, 'M', 'ما'), + (0xFC89, 'M', 'مم'), + (0xFC8A, 'M', 'نر'), + (0xFC8B, 'M', 'نز'), + (0xFC8C, 'M', 'نم'), + (0xFC8D, 'M', 'نن'), + (0xFC8E, 'M', 'نى'), + (0xFC8F, 'M', 'ني'), + (0xFC90, 'M', 'ىٰ'), + (0xFC91, 'M', 'ير'), + (0xFC92, 'M', 'يز'), + (0xFC93, 'M', 'يم'), + (0xFC94, 'M', 'ين'), + (0xFC95, 'M', 'يى'), + (0xFC96, 'M', 'يي'), + (0xFC97, 'M', 'ئج'), + (0xFC98, 'M', 'ئح'), + (0xFC99, 'M', 'ئخ'), + (0xFC9A, 'M', 'ئم'), + (0xFC9B, 'M', 'ئه'), + (0xFC9C, 'M', 'بج'), + (0xFC9D, 'M', 'بح'), + (0xFC9E, 'M', 'بخ'), + (0xFC9F, 'M', 'بم'), + (0xFCA0, 'M', 'به'), + (0xFCA1, 'M', 'تج'), + (0xFCA2, 'M', 'تح'), + (0xFCA3, 'M', 'تخ'), + (0xFCA4, 'M', 'تم'), + (0xFCA5, 'M', 'ته'), + (0xFCA6, 'M', 'ثم'), + (0xFCA7, 'M', 'جح'), + (0xFCA8, 'M', 'جم'), + (0xFCA9, 'M', 'حج'), + (0xFCAA, 'M', 'حم'), + (0xFCAB, 'M', 'خج'), + (0xFCAC, 'M', 'خم'), + (0xFCAD, 'M', 'سج'), + (0xFCAE, 'M', 'سح'), + (0xFCAF, 'M', 'سخ'), + (0xFCB0, 'M', 'سم'), + (0xFCB1, 'M', 'صح'), + (0xFCB2, 'M', 'صخ'), + (0xFCB3, 'M', 'صم'), + (0xFCB4, 'M', 'ضج'), + (0xFCB5, 'M', 'ضح'), + (0xFCB6, 'M', 'ضخ'), + (0xFCB7, 'M', 'ضم'), + (0xFCB8, 'M', 'طح'), + (0xFCB9, 'M', 'ظم'), + (0xFCBA, 'M', 'عج'), + (0xFCBB, 'M', 'عم'), + (0xFCBC, 'M', 'غج'), + (0xFCBD, 'M', 'غم'), + (0xFCBE, 'M', 'فج'), + ] + +def _seg_47() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xFCBF, 'M', 'فح'), + (0xFCC0, 'M', 'فخ'), + (0xFCC1, 'M', 'فم'), + (0xFCC2, 'M', 'قح'), + (0xFCC3, 'M', 'قم'), + (0xFCC4, 'M', 'كج'), + (0xFCC5, 'M', 'كح'), + (0xFCC6, 'M', 'كخ'), + (0xFCC7, 'M', 'كل'), + (0xFCC8, 'M', 'كم'), + (0xFCC9, 'M', 'لج'), + (0xFCCA, 'M', 'لح'), + (0xFCCB, 'M', 'لخ'), + (0xFCCC, 'M', 'لم'), + (0xFCCD, 'M', 'له'), + (0xFCCE, 'M', 'مج'), + (0xFCCF, 'M', 'مح'), + (0xFCD0, 'M', 'مخ'), + (0xFCD1, 'M', 'مم'), + (0xFCD2, 'M', 'نج'), + (0xFCD3, 'M', 'نح'), + (0xFCD4, 'M', 'نخ'), + (0xFCD5, 'M', 'نم'), + (0xFCD6, 'M', 'نه'), + (0xFCD7, 'M', 'هج'), + (0xFCD8, 'M', 'هم'), + (0xFCD9, 'M', 'هٰ'), + (0xFCDA, 'M', 'يج'), + (0xFCDB, 'M', 'يح'), + (0xFCDC, 'M', 'يخ'), + (0xFCDD, 'M', 'يم'), + (0xFCDE, 'M', 'يه'), + (0xFCDF, 'M', 'ئم'), + (0xFCE0, 'M', 'ئه'), + (0xFCE1, 'M', 'بم'), + (0xFCE2, 'M', 'به'), + (0xFCE3, 'M', 'تم'), + (0xFCE4, 'M', 'ته'), + (0xFCE5, 'M', 'ثم'), + (0xFCE6, 'M', 'ثه'), + (0xFCE7, 'M', 'سم'), + (0xFCE8, 'M', 'سه'), + (0xFCE9, 'M', 'شم'), + (0xFCEA, 'M', 'شه'), + (0xFCEB, 'M', 'كل'), + (0xFCEC, 'M', 'كم'), + (0xFCED, 'M', 'لم'), + (0xFCEE, 'M', 'نم'), + (0xFCEF, 'M', 'نه'), + (0xFCF0, 'M', 'يم'), + (0xFCF1, 'M', 'يه'), + (0xFCF2, 'M', 'ـَّ'), + (0xFCF3, 'M', 'ـُّ'), + (0xFCF4, 'M', 'ـِّ'), + (0xFCF5, 'M', 'طى'), + (0xFCF6, 'M', 'طي'), + (0xFCF7, 'M', 'عى'), + (0xFCF8, 'M', 'عي'), + (0xFCF9, 'M', 'غى'), + (0xFCFA, 'M', 'غي'), + (0xFCFB, 'M', 'سى'), + (0xFCFC, 'M', 'سي'), + (0xFCFD, 'M', 'شى'), + (0xFCFE, 'M', 'شي'), + (0xFCFF, 'M', 'حى'), + (0xFD00, 'M', 'حي'), + (0xFD01, 'M', 'جى'), + (0xFD02, 'M', 'جي'), + (0xFD03, 'M', 'خى'), + (0xFD04, 'M', 'خي'), + (0xFD05, 'M', 'صى'), + (0xFD06, 'M', 'صي'), + (0xFD07, 'M', 'ضى'), + (0xFD08, 'M', 'ضي'), + (0xFD09, 'M', 'شج'), + (0xFD0A, 'M', 'شح'), + (0xFD0B, 'M', 'شخ'), + (0xFD0C, 'M', 'شم'), + (0xFD0D, 'M', 'شر'), + (0xFD0E, 'M', 'سر'), + (0xFD0F, 'M', 'صر'), + (0xFD10, 'M', 'ضر'), + (0xFD11, 'M', 'طى'), + (0xFD12, 'M', 'طي'), + (0xFD13, 'M', 'عى'), + (0xFD14, 'M', 'عي'), + (0xFD15, 'M', 'غى'), + (0xFD16, 'M', 'غي'), + (0xFD17, 'M', 'سى'), + (0xFD18, 'M', 'سي'), + (0xFD19, 'M', 'شى'), + (0xFD1A, 'M', 'شي'), + (0xFD1B, 'M', 'حى'), + (0xFD1C, 'M', 'حي'), + (0xFD1D, 'M', 'جى'), + (0xFD1E, 'M', 'جي'), + (0xFD1F, 'M', 'خى'), + (0xFD20, 'M', 'خي'), + (0xFD21, 'M', 'صى'), + (0xFD22, 'M', 'صي'), + ] + +def _seg_48() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xFD23, 'M', 'ضى'), + (0xFD24, 'M', 'ضي'), + (0xFD25, 'M', 'شج'), + (0xFD26, 'M', 'شح'), + (0xFD27, 'M', 'شخ'), + (0xFD28, 'M', 'شم'), + (0xFD29, 'M', 'شر'), + (0xFD2A, 'M', 'سر'), + (0xFD2B, 'M', 'صر'), + (0xFD2C, 'M', 'ضر'), + (0xFD2D, 'M', 'شج'), + (0xFD2E, 'M', 'شح'), + (0xFD2F, 'M', 'شخ'), + (0xFD30, 'M', 'شم'), + (0xFD31, 'M', 'سه'), + (0xFD32, 'M', 'شه'), + (0xFD33, 'M', 'طم'), + (0xFD34, 'M', 'سج'), + (0xFD35, 'M', 'سح'), + (0xFD36, 'M', 'سخ'), + (0xFD37, 'M', 'شج'), + (0xFD38, 'M', 'شح'), + (0xFD39, 'M', 'شخ'), + (0xFD3A, 'M', 'طم'), + (0xFD3B, 'M', 'ظم'), + (0xFD3C, 'M', 'اً'), + (0xFD3E, 'V'), + (0xFD50, 'M', 'تجم'), + (0xFD51, 'M', 'تحج'), + (0xFD53, 'M', 'تحم'), + (0xFD54, 'M', 'تخم'), + (0xFD55, 'M', 'تمج'), + (0xFD56, 'M', 'تمح'), + (0xFD57, 'M', 'تمخ'), + (0xFD58, 'M', 'جمح'), + (0xFD5A, 'M', 'حمي'), + (0xFD5B, 'M', 'حمى'), + (0xFD5C, 'M', 'سحج'), + (0xFD5D, 'M', 'سجح'), + (0xFD5E, 'M', 'سجى'), + (0xFD5F, 'M', 'سمح'), + (0xFD61, 'M', 'سمج'), + (0xFD62, 'M', 'سمم'), + (0xFD64, 'M', 'صحح'), + (0xFD66, 'M', 'صمم'), + (0xFD67, 'M', 'شحم'), + (0xFD69, 'M', 'شجي'), + (0xFD6A, 'M', 'شمخ'), + (0xFD6C, 'M', 'شمم'), + (0xFD6E, 'M', 'ضحى'), + (0xFD6F, 'M', 'ضخم'), + (0xFD71, 'M', 'طمح'), + (0xFD73, 'M', 'طمم'), + (0xFD74, 'M', 'طمي'), + (0xFD75, 'M', 'عجم'), + (0xFD76, 'M', 'عمم'), + (0xFD78, 'M', 'عمى'), + (0xFD79, 'M', 'غمم'), + (0xFD7A, 'M', 'غمي'), + (0xFD7B, 'M', 'غمى'), + (0xFD7C, 'M', 'فخم'), + (0xFD7E, 'M', 'قمح'), + (0xFD7F, 'M', 'قمم'), + (0xFD80, 'M', 'لحم'), + (0xFD81, 'M', 'لحي'), + (0xFD82, 'M', 'لحى'), + (0xFD83, 'M', 'لجج'), + (0xFD85, 'M', 'لخم'), + (0xFD87, 'M', 'لمح'), + (0xFD89, 'M', 'محج'), + (0xFD8A, 'M', 'محم'), + (0xFD8B, 'M', 'محي'), + (0xFD8C, 'M', 'مجح'), + (0xFD8D, 'M', 'مجم'), + (0xFD8E, 'M', 'مخج'), + (0xFD8F, 'M', 'مخم'), + (0xFD90, 'X'), + (0xFD92, 'M', 'مجخ'), + (0xFD93, 'M', 'همج'), + (0xFD94, 'M', 'همم'), + (0xFD95, 'M', 'نحم'), + (0xFD96, 'M', 'نحى'), + (0xFD97, 'M', 'نجم'), + (0xFD99, 'M', 'نجى'), + (0xFD9A, 'M', 'نمي'), + (0xFD9B, 'M', 'نمى'), + (0xFD9C, 'M', 'يمم'), + (0xFD9E, 'M', 'بخي'), + (0xFD9F, 'M', 'تجي'), + (0xFDA0, 'M', 'تجى'), + (0xFDA1, 'M', 'تخي'), + (0xFDA2, 'M', 'تخى'), + (0xFDA3, 'M', 'تمي'), + (0xFDA4, 'M', 'تمى'), + (0xFDA5, 'M', 'جمي'), + (0xFDA6, 'M', 'جحى'), + (0xFDA7, 'M', 'جمى'), + (0xFDA8, 'M', 'سخى'), + (0xFDA9, 'M', 'صحي'), + (0xFDAA, 'M', 'شحي'), + ] + +def _seg_49() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xFDAB, 'M', 'ضحي'), + (0xFDAC, 'M', 'لجي'), + (0xFDAD, 'M', 'لمي'), + (0xFDAE, 'M', 'يحي'), + (0xFDAF, 'M', 'يجي'), + (0xFDB0, 'M', 'يمي'), + (0xFDB1, 'M', 'ممي'), + (0xFDB2, 'M', 'قمي'), + (0xFDB3, 'M', 'نحي'), + (0xFDB4, 'M', 'قمح'), + (0xFDB5, 'M', 'لحم'), + (0xFDB6, 'M', 'عمي'), + (0xFDB7, 'M', 'كمي'), + (0xFDB8, 'M', 'نجح'), + (0xFDB9, 'M', 'مخي'), + (0xFDBA, 'M', 'لجم'), + (0xFDBB, 'M', 'كمم'), + (0xFDBC, 'M', 'لجم'), + (0xFDBD, 'M', 'نجح'), + (0xFDBE, 'M', 'جحي'), + (0xFDBF, 'M', 'حجي'), + (0xFDC0, 'M', 'مجي'), + (0xFDC1, 'M', 'فمي'), + (0xFDC2, 'M', 'بحي'), + (0xFDC3, 'M', 'كمم'), + (0xFDC4, 'M', 'عجم'), + (0xFDC5, 'M', 'صمم'), + (0xFDC6, 'M', 'سخي'), + (0xFDC7, 'M', 'نجي'), + (0xFDC8, 'X'), + (0xFDCF, 'V'), + (0xFDD0, 'X'), + (0xFDF0, 'M', 'صلے'), + (0xFDF1, 'M', 'قلے'), + (0xFDF2, 'M', 'الله'), + (0xFDF3, 'M', 'اكبر'), + (0xFDF4, 'M', 'محمد'), + (0xFDF5, 'M', 'صلعم'), + (0xFDF6, 'M', 'رسول'), + (0xFDF7, 'M', 'عليه'), + (0xFDF8, 'M', 'وسلم'), + (0xFDF9, 'M', 'صلى'), + (0xFDFA, '3', 'صلى الله عليه وسلم'), + (0xFDFB, '3', 'جل جلاله'), + (0xFDFC, 'M', 'ریال'), + (0xFDFD, 'V'), + (0xFE00, 'I'), + (0xFE10, '3', ','), + (0xFE11, 'M', '、'), + (0xFE12, 'X'), + (0xFE13, '3', ':'), + (0xFE14, '3', ';'), + (0xFE15, '3', '!'), + (0xFE16, '3', '?'), + (0xFE17, 'M', '〖'), + (0xFE18, 'M', '〗'), + (0xFE19, 'X'), + (0xFE20, 'V'), + (0xFE30, 'X'), + (0xFE31, 'M', '—'), + (0xFE32, 'M', '–'), + (0xFE33, '3', '_'), + (0xFE35, '3', '('), + (0xFE36, '3', ')'), + (0xFE37, '3', '{'), + (0xFE38, '3', '}'), + (0xFE39, 'M', '〔'), + (0xFE3A, 'M', '〕'), + (0xFE3B, 'M', '【'), + (0xFE3C, 'M', '】'), + (0xFE3D, 'M', '《'), + (0xFE3E, 'M', '》'), + (0xFE3F, 'M', '〈'), + (0xFE40, 'M', '〉'), + (0xFE41, 'M', '「'), + (0xFE42, 'M', '」'), + (0xFE43, 'M', '『'), + (0xFE44, 'M', '』'), + (0xFE45, 'V'), + (0xFE47, '3', '['), + (0xFE48, '3', ']'), + (0xFE49, '3', ' ̅'), + (0xFE4D, '3', '_'), + (0xFE50, '3', ','), + (0xFE51, 'M', '、'), + (0xFE52, 'X'), + (0xFE54, '3', ';'), + (0xFE55, '3', ':'), + (0xFE56, '3', '?'), + (0xFE57, '3', '!'), + (0xFE58, 'M', '—'), + (0xFE59, '3', '('), + (0xFE5A, '3', ')'), + (0xFE5B, '3', '{'), + (0xFE5C, '3', '}'), + (0xFE5D, 'M', '〔'), + (0xFE5E, 'M', '〕'), + (0xFE5F, '3', '#'), + (0xFE60, '3', '&'), + (0xFE61, '3', '*'), + ] + +def _seg_50() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xFE62, '3', '+'), + (0xFE63, 'M', '-'), + (0xFE64, '3', '<'), + (0xFE65, '3', '>'), + (0xFE66, '3', '='), + (0xFE67, 'X'), + (0xFE68, '3', '\\'), + (0xFE69, '3', '$'), + (0xFE6A, '3', '%'), + (0xFE6B, '3', '@'), + (0xFE6C, 'X'), + (0xFE70, '3', ' ً'), + (0xFE71, 'M', 'ـً'), + (0xFE72, '3', ' ٌ'), + (0xFE73, 'V'), + (0xFE74, '3', ' ٍ'), + (0xFE75, 'X'), + (0xFE76, '3', ' َ'), + (0xFE77, 'M', 'ـَ'), + (0xFE78, '3', ' ُ'), + (0xFE79, 'M', 'ـُ'), + (0xFE7A, '3', ' ِ'), + (0xFE7B, 'M', 'ـِ'), + (0xFE7C, '3', ' ّ'), + (0xFE7D, 'M', 'ـّ'), + (0xFE7E, '3', ' ْ'), + (0xFE7F, 'M', 'ـْ'), + (0xFE80, 'M', 'ء'), + (0xFE81, 'M', 'آ'), + (0xFE83, 'M', 'أ'), + (0xFE85, 'M', 'ؤ'), + (0xFE87, 'M', 'إ'), + (0xFE89, 'M', 'ئ'), + (0xFE8D, 'M', 'ا'), + (0xFE8F, 'M', 'ب'), + (0xFE93, 'M', 'ة'), + (0xFE95, 'M', 'ت'), + (0xFE99, 'M', 'ث'), + (0xFE9D, 'M', 'ج'), + (0xFEA1, 'M', 'ح'), + (0xFEA5, 'M', 'خ'), + (0xFEA9, 'M', 'د'), + (0xFEAB, 'M', 'ذ'), + (0xFEAD, 'M', 'ر'), + (0xFEAF, 'M', 'ز'), + (0xFEB1, 'M', 'س'), + (0xFEB5, 'M', 'ش'), + (0xFEB9, 'M', 'ص'), + (0xFEBD, 'M', 'ض'), + (0xFEC1, 'M', 'ط'), + (0xFEC5, 'M', 'ظ'), + (0xFEC9, 'M', 'ع'), + (0xFECD, 'M', 'غ'), + (0xFED1, 'M', 'ف'), + (0xFED5, 'M', 'ق'), + (0xFED9, 'M', 'ك'), + (0xFEDD, 'M', 'ل'), + (0xFEE1, 'M', 'م'), + (0xFEE5, 'M', 'ن'), + (0xFEE9, 'M', 'ه'), + (0xFEED, 'M', 'و'), + (0xFEEF, 'M', 'ى'), + (0xFEF1, 'M', 'ي'), + (0xFEF5, 'M', 'لآ'), + (0xFEF7, 'M', 'لأ'), + (0xFEF9, 'M', 'لإ'), + (0xFEFB, 'M', 'لا'), + (0xFEFD, 'X'), + (0xFEFF, 'I'), + (0xFF00, 'X'), + (0xFF01, '3', '!'), + (0xFF02, '3', '"'), + (0xFF03, '3', '#'), + (0xFF04, '3', '$'), + (0xFF05, '3', '%'), + (0xFF06, '3', '&'), + (0xFF07, '3', '\''), + (0xFF08, '3', '('), + (0xFF09, '3', ')'), + (0xFF0A, '3', '*'), + (0xFF0B, '3', '+'), + (0xFF0C, '3', ','), + (0xFF0D, 'M', '-'), + (0xFF0E, 'M', '.'), + (0xFF0F, '3', '/'), + (0xFF10, 'M', '0'), + (0xFF11, 'M', '1'), + (0xFF12, 'M', '2'), + (0xFF13, 'M', '3'), + (0xFF14, 'M', '4'), + (0xFF15, 'M', '5'), + (0xFF16, 'M', '6'), + (0xFF17, 'M', '7'), + (0xFF18, 'M', '8'), + (0xFF19, 'M', '9'), + (0xFF1A, '3', ':'), + (0xFF1B, '3', ';'), + (0xFF1C, '3', '<'), + (0xFF1D, '3', '='), + (0xFF1E, '3', '>'), + ] + +def _seg_51() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xFF1F, '3', '?'), + (0xFF20, '3', '@'), + (0xFF21, 'M', 'a'), + (0xFF22, 'M', 'b'), + (0xFF23, 'M', 'c'), + (0xFF24, 'M', 'd'), + (0xFF25, 'M', 'e'), + (0xFF26, 'M', 'f'), + (0xFF27, 'M', 'g'), + (0xFF28, 'M', 'h'), + (0xFF29, 'M', 'i'), + (0xFF2A, 'M', 'j'), + (0xFF2B, 'M', 'k'), + (0xFF2C, 'M', 'l'), + (0xFF2D, 'M', 'm'), + (0xFF2E, 'M', 'n'), + (0xFF2F, 'M', 'o'), + (0xFF30, 'M', 'p'), + (0xFF31, 'M', 'q'), + (0xFF32, 'M', 'r'), + (0xFF33, 'M', 's'), + (0xFF34, 'M', 't'), + (0xFF35, 'M', 'u'), + (0xFF36, 'M', 'v'), + (0xFF37, 'M', 'w'), + (0xFF38, 'M', 'x'), + (0xFF39, 'M', 'y'), + (0xFF3A, 'M', 'z'), + (0xFF3B, '3', '['), + (0xFF3C, '3', '\\'), + (0xFF3D, '3', ']'), + (0xFF3E, '3', '^'), + (0xFF3F, '3', '_'), + (0xFF40, '3', '`'), + (0xFF41, 'M', 'a'), + (0xFF42, 'M', 'b'), + (0xFF43, 'M', 'c'), + (0xFF44, 'M', 'd'), + (0xFF45, 'M', 'e'), + (0xFF46, 'M', 'f'), + (0xFF47, 'M', 'g'), + (0xFF48, 'M', 'h'), + (0xFF49, 'M', 'i'), + (0xFF4A, 'M', 'j'), + (0xFF4B, 'M', 'k'), + (0xFF4C, 'M', 'l'), + (0xFF4D, 'M', 'm'), + (0xFF4E, 'M', 'n'), + (0xFF4F, 'M', 'o'), + (0xFF50, 'M', 'p'), + (0xFF51, 'M', 'q'), + (0xFF52, 'M', 'r'), + (0xFF53, 'M', 's'), + (0xFF54, 'M', 't'), + (0xFF55, 'M', 'u'), + (0xFF56, 'M', 'v'), + (0xFF57, 'M', 'w'), + (0xFF58, 'M', 'x'), + (0xFF59, 'M', 'y'), + (0xFF5A, 'M', 'z'), + (0xFF5B, '3', '{'), + (0xFF5C, '3', '|'), + (0xFF5D, '3', '}'), + (0xFF5E, '3', '~'), + (0xFF5F, 'M', '⦅'), + (0xFF60, 'M', '⦆'), + (0xFF61, 'M', '.'), + (0xFF62, 'M', '「'), + (0xFF63, 'M', '」'), + (0xFF64, 'M', '、'), + (0xFF65, 'M', '・'), + (0xFF66, 'M', 'ヲ'), + (0xFF67, 'M', 'ァ'), + (0xFF68, 'M', 'ィ'), + (0xFF69, 'M', 'ゥ'), + (0xFF6A, 'M', 'ェ'), + (0xFF6B, 'M', 'ォ'), + (0xFF6C, 'M', 'ャ'), + (0xFF6D, 'M', 'ュ'), + (0xFF6E, 'M', 'ョ'), + (0xFF6F, 'M', 'ッ'), + (0xFF70, 'M', 'ー'), + (0xFF71, 'M', 'ア'), + (0xFF72, 'M', 'イ'), + (0xFF73, 'M', 'ウ'), + (0xFF74, 'M', 'エ'), + (0xFF75, 'M', 'オ'), + (0xFF76, 'M', 'カ'), + (0xFF77, 'M', 'キ'), + (0xFF78, 'M', 'ク'), + (0xFF79, 'M', 'ケ'), + (0xFF7A, 'M', 'コ'), + (0xFF7B, 'M', 'サ'), + (0xFF7C, 'M', 'シ'), + (0xFF7D, 'M', 'ス'), + (0xFF7E, 'M', 'セ'), + (0xFF7F, 'M', 'ソ'), + (0xFF80, 'M', 'タ'), + (0xFF81, 'M', 'チ'), + (0xFF82, 'M', 'ツ'), + ] + +def _seg_52() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xFF83, 'M', 'テ'), + (0xFF84, 'M', 'ト'), + (0xFF85, 'M', 'ナ'), + (0xFF86, 'M', 'ニ'), + (0xFF87, 'M', 'ヌ'), + (0xFF88, 'M', 'ネ'), + (0xFF89, 'M', 'ノ'), + (0xFF8A, 'M', 'ハ'), + (0xFF8B, 'M', 'ヒ'), + (0xFF8C, 'M', 'フ'), + (0xFF8D, 'M', 'ヘ'), + (0xFF8E, 'M', 'ホ'), + (0xFF8F, 'M', 'マ'), + (0xFF90, 'M', 'ミ'), + (0xFF91, 'M', 'ム'), + (0xFF92, 'M', 'メ'), + (0xFF93, 'M', 'モ'), + (0xFF94, 'M', 'ヤ'), + (0xFF95, 'M', 'ユ'), + (0xFF96, 'M', 'ヨ'), + (0xFF97, 'M', 'ラ'), + (0xFF98, 'M', 'リ'), + (0xFF99, 'M', 'ル'), + (0xFF9A, 'M', 'レ'), + (0xFF9B, 'M', 'ロ'), + (0xFF9C, 'M', 'ワ'), + (0xFF9D, 'M', 'ン'), + (0xFF9E, 'M', '゙'), + (0xFF9F, 'M', '゚'), + (0xFFA0, 'X'), + (0xFFA1, 'M', 'ᄀ'), + (0xFFA2, 'M', 'ᄁ'), + (0xFFA3, 'M', 'ᆪ'), + (0xFFA4, 'M', 'ᄂ'), + (0xFFA5, 'M', 'ᆬ'), + (0xFFA6, 'M', 'ᆭ'), + (0xFFA7, 'M', 'ᄃ'), + (0xFFA8, 'M', 'ᄄ'), + (0xFFA9, 'M', 'ᄅ'), + (0xFFAA, 'M', 'ᆰ'), + (0xFFAB, 'M', 'ᆱ'), + (0xFFAC, 'M', 'ᆲ'), + (0xFFAD, 'M', 'ᆳ'), + (0xFFAE, 'M', 'ᆴ'), + (0xFFAF, 'M', 'ᆵ'), + (0xFFB0, 'M', 'ᄚ'), + (0xFFB1, 'M', 'ᄆ'), + (0xFFB2, 'M', 'ᄇ'), + (0xFFB3, 'M', 'ᄈ'), + (0xFFB4, 'M', 'ᄡ'), + (0xFFB5, 'M', 'ᄉ'), + (0xFFB6, 'M', 'ᄊ'), + (0xFFB7, 'M', 'ᄋ'), + (0xFFB8, 'M', 'ᄌ'), + (0xFFB9, 'M', 'ᄍ'), + (0xFFBA, 'M', 'ᄎ'), + (0xFFBB, 'M', 'ᄏ'), + (0xFFBC, 'M', 'ᄐ'), + (0xFFBD, 'M', 'ᄑ'), + (0xFFBE, 'M', 'ᄒ'), + (0xFFBF, 'X'), + (0xFFC2, 'M', 'ᅡ'), + (0xFFC3, 'M', 'ᅢ'), + (0xFFC4, 'M', 'ᅣ'), + (0xFFC5, 'M', 'ᅤ'), + (0xFFC6, 'M', 'ᅥ'), + (0xFFC7, 'M', 'ᅦ'), + (0xFFC8, 'X'), + (0xFFCA, 'M', 'ᅧ'), + (0xFFCB, 'M', 'ᅨ'), + (0xFFCC, 'M', 'ᅩ'), + (0xFFCD, 'M', 'ᅪ'), + (0xFFCE, 'M', 'ᅫ'), + (0xFFCF, 'M', 'ᅬ'), + (0xFFD0, 'X'), + (0xFFD2, 'M', 'ᅭ'), + (0xFFD3, 'M', 'ᅮ'), + (0xFFD4, 'M', 'ᅯ'), + (0xFFD5, 'M', 'ᅰ'), + (0xFFD6, 'M', 'ᅱ'), + (0xFFD7, 'M', 'ᅲ'), + (0xFFD8, 'X'), + (0xFFDA, 'M', 'ᅳ'), + (0xFFDB, 'M', 'ᅴ'), + (0xFFDC, 'M', 'ᅵ'), + (0xFFDD, 'X'), + (0xFFE0, 'M', '¢'), + (0xFFE1, 'M', '£'), + (0xFFE2, 'M', '¬'), + (0xFFE3, '3', ' ̄'), + (0xFFE4, 'M', '¦'), + (0xFFE5, 'M', '¥'), + (0xFFE6, 'M', '₩'), + (0xFFE7, 'X'), + (0xFFE8, 'M', '│'), + (0xFFE9, 'M', '←'), + (0xFFEA, 'M', '↑'), + (0xFFEB, 'M', '→'), + (0xFFEC, 'M', '↓'), + (0xFFED, 'M', '■'), + ] + +def _seg_53() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0xFFEE, 'M', '○'), + (0xFFEF, 'X'), + (0x10000, 'V'), + (0x1000C, 'X'), + (0x1000D, 'V'), + (0x10027, 'X'), + (0x10028, 'V'), + (0x1003B, 'X'), + (0x1003C, 'V'), + (0x1003E, 'X'), + (0x1003F, 'V'), + (0x1004E, 'X'), + (0x10050, 'V'), + (0x1005E, 'X'), + (0x10080, 'V'), + (0x100FB, 'X'), + (0x10100, 'V'), + (0x10103, 'X'), + (0x10107, 'V'), + (0x10134, 'X'), + (0x10137, 'V'), + (0x1018F, 'X'), + (0x10190, 'V'), + (0x1019D, 'X'), + (0x101A0, 'V'), + (0x101A1, 'X'), + (0x101D0, 'V'), + (0x101FE, 'X'), + (0x10280, 'V'), + (0x1029D, 'X'), + (0x102A0, 'V'), + (0x102D1, 'X'), + (0x102E0, 'V'), + (0x102FC, 'X'), + (0x10300, 'V'), + (0x10324, 'X'), + (0x1032D, 'V'), + (0x1034B, 'X'), + (0x10350, 'V'), + (0x1037B, 'X'), + (0x10380, 'V'), + (0x1039E, 'X'), + (0x1039F, 'V'), + (0x103C4, 'X'), + (0x103C8, 'V'), + (0x103D6, 'X'), + (0x10400, 'M', '𐐨'), + (0x10401, 'M', '𐐩'), + (0x10402, 'M', '𐐪'), + (0x10403, 'M', '𐐫'), + (0x10404, 'M', '𐐬'), + (0x10405, 'M', '𐐭'), + (0x10406, 'M', '𐐮'), + (0x10407, 'M', '𐐯'), + (0x10408, 'M', '𐐰'), + (0x10409, 'M', '𐐱'), + (0x1040A, 'M', '𐐲'), + (0x1040B, 'M', '𐐳'), + (0x1040C, 'M', '𐐴'), + (0x1040D, 'M', '𐐵'), + (0x1040E, 'M', '𐐶'), + (0x1040F, 'M', '𐐷'), + (0x10410, 'M', '𐐸'), + (0x10411, 'M', '𐐹'), + (0x10412, 'M', '𐐺'), + (0x10413, 'M', '𐐻'), + (0x10414, 'M', '𐐼'), + (0x10415, 'M', '𐐽'), + (0x10416, 'M', '𐐾'), + (0x10417, 'M', '𐐿'), + (0x10418, 'M', '𐑀'), + (0x10419, 'M', '𐑁'), + (0x1041A, 'M', '𐑂'), + (0x1041B, 'M', '𐑃'), + (0x1041C, 'M', '𐑄'), + (0x1041D, 'M', '𐑅'), + (0x1041E, 'M', '𐑆'), + (0x1041F, 'M', '𐑇'), + (0x10420, 'M', '𐑈'), + (0x10421, 'M', '𐑉'), + (0x10422, 'M', '𐑊'), + (0x10423, 'M', '𐑋'), + (0x10424, 'M', '𐑌'), + (0x10425, 'M', '𐑍'), + (0x10426, 'M', '𐑎'), + (0x10427, 'M', '𐑏'), + (0x10428, 'V'), + (0x1049E, 'X'), + (0x104A0, 'V'), + (0x104AA, 'X'), + (0x104B0, 'M', '𐓘'), + (0x104B1, 'M', '𐓙'), + (0x104B2, 'M', '𐓚'), + (0x104B3, 'M', '𐓛'), + (0x104B4, 'M', '𐓜'), + (0x104B5, 'M', '𐓝'), + (0x104B6, 'M', '𐓞'), + (0x104B7, 'M', '𐓟'), + (0x104B8, 'M', '𐓠'), + (0x104B9, 'M', '𐓡'), + ] + +def _seg_54() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x104BA, 'M', '𐓢'), + (0x104BB, 'M', '𐓣'), + (0x104BC, 'M', '𐓤'), + (0x104BD, 'M', '𐓥'), + (0x104BE, 'M', '𐓦'), + (0x104BF, 'M', '𐓧'), + (0x104C0, 'M', '𐓨'), + (0x104C1, 'M', '𐓩'), + (0x104C2, 'M', '𐓪'), + (0x104C3, 'M', '𐓫'), + (0x104C4, 'M', '𐓬'), + (0x104C5, 'M', '𐓭'), + (0x104C6, 'M', '𐓮'), + (0x104C7, 'M', '𐓯'), + (0x104C8, 'M', '𐓰'), + (0x104C9, 'M', '𐓱'), + (0x104CA, 'M', '𐓲'), + (0x104CB, 'M', '𐓳'), + (0x104CC, 'M', '𐓴'), + (0x104CD, 'M', '𐓵'), + (0x104CE, 'M', '𐓶'), + (0x104CF, 'M', '𐓷'), + (0x104D0, 'M', '𐓸'), + (0x104D1, 'M', '𐓹'), + (0x104D2, 'M', '𐓺'), + (0x104D3, 'M', '𐓻'), + (0x104D4, 'X'), + (0x104D8, 'V'), + (0x104FC, 'X'), + (0x10500, 'V'), + (0x10528, 'X'), + (0x10530, 'V'), + (0x10564, 'X'), + (0x1056F, 'V'), + (0x10570, 'M', '𐖗'), + (0x10571, 'M', '𐖘'), + (0x10572, 'M', '𐖙'), + (0x10573, 'M', '𐖚'), + (0x10574, 'M', '𐖛'), + (0x10575, 'M', '𐖜'), + (0x10576, 'M', '𐖝'), + (0x10577, 'M', '𐖞'), + (0x10578, 'M', '𐖟'), + (0x10579, 'M', '𐖠'), + (0x1057A, 'M', '𐖡'), + (0x1057B, 'X'), + (0x1057C, 'M', '𐖣'), + (0x1057D, 'M', '𐖤'), + (0x1057E, 'M', '𐖥'), + (0x1057F, 'M', '𐖦'), + (0x10580, 'M', '𐖧'), + (0x10581, 'M', '𐖨'), + (0x10582, 'M', '𐖩'), + (0x10583, 'M', '𐖪'), + (0x10584, 'M', '𐖫'), + (0x10585, 'M', '𐖬'), + (0x10586, 'M', '𐖭'), + (0x10587, 'M', '𐖮'), + (0x10588, 'M', '𐖯'), + (0x10589, 'M', '𐖰'), + (0x1058A, 'M', '𐖱'), + (0x1058B, 'X'), + (0x1058C, 'M', '𐖳'), + (0x1058D, 'M', '𐖴'), + (0x1058E, 'M', '𐖵'), + (0x1058F, 'M', '𐖶'), + (0x10590, 'M', '𐖷'), + (0x10591, 'M', '𐖸'), + (0x10592, 'M', '𐖹'), + (0x10593, 'X'), + (0x10594, 'M', '𐖻'), + (0x10595, 'M', '𐖼'), + (0x10596, 'X'), + (0x10597, 'V'), + (0x105A2, 'X'), + (0x105A3, 'V'), + (0x105B2, 'X'), + (0x105B3, 'V'), + (0x105BA, 'X'), + (0x105BB, 'V'), + (0x105BD, 'X'), + (0x10600, 'V'), + (0x10737, 'X'), + (0x10740, 'V'), + (0x10756, 'X'), + (0x10760, 'V'), + (0x10768, 'X'), + (0x10780, 'V'), + (0x10781, 'M', 'ː'), + (0x10782, 'M', 'ˑ'), + (0x10783, 'M', 'æ'), + (0x10784, 'M', 'ʙ'), + (0x10785, 'M', 'ɓ'), + (0x10786, 'X'), + (0x10787, 'M', 'ʣ'), + (0x10788, 'M', 'ꭦ'), + (0x10789, 'M', 'ʥ'), + (0x1078A, 'M', 'ʤ'), + (0x1078B, 'M', 'ɖ'), + (0x1078C, 'M', 'ɗ'), + ] + +def _seg_55() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1078D, 'M', 'ᶑ'), + (0x1078E, 'M', 'ɘ'), + (0x1078F, 'M', 'ɞ'), + (0x10790, 'M', 'ʩ'), + (0x10791, 'M', 'ɤ'), + (0x10792, 'M', 'ɢ'), + (0x10793, 'M', 'ɠ'), + (0x10794, 'M', 'ʛ'), + (0x10795, 'M', 'ħ'), + (0x10796, 'M', 'ʜ'), + (0x10797, 'M', 'ɧ'), + (0x10798, 'M', 'ʄ'), + (0x10799, 'M', 'ʪ'), + (0x1079A, 'M', 'ʫ'), + (0x1079B, 'M', 'ɬ'), + (0x1079C, 'M', '𝼄'), + (0x1079D, 'M', 'ꞎ'), + (0x1079E, 'M', 'ɮ'), + (0x1079F, 'M', '𝼅'), + (0x107A0, 'M', 'ʎ'), + (0x107A1, 'M', '𝼆'), + (0x107A2, 'M', 'ø'), + (0x107A3, 'M', 'ɶ'), + (0x107A4, 'M', 'ɷ'), + (0x107A5, 'M', 'q'), + (0x107A6, 'M', 'ɺ'), + (0x107A7, 'M', '𝼈'), + (0x107A8, 'M', 'ɽ'), + (0x107A9, 'M', 'ɾ'), + (0x107AA, 'M', 'ʀ'), + (0x107AB, 'M', 'ʨ'), + (0x107AC, 'M', 'ʦ'), + (0x107AD, 'M', 'ꭧ'), + (0x107AE, 'M', 'ʧ'), + (0x107AF, 'M', 'ʈ'), + (0x107B0, 'M', 'ⱱ'), + (0x107B1, 'X'), + (0x107B2, 'M', 'ʏ'), + (0x107B3, 'M', 'ʡ'), + (0x107B4, 'M', 'ʢ'), + (0x107B5, 'M', 'ʘ'), + (0x107B6, 'M', 'ǀ'), + (0x107B7, 'M', 'ǁ'), + (0x107B8, 'M', 'ǂ'), + (0x107B9, 'M', '𝼊'), + (0x107BA, 'M', '𝼞'), + (0x107BB, 'X'), + (0x10800, 'V'), + (0x10806, 'X'), + (0x10808, 'V'), + (0x10809, 'X'), + (0x1080A, 'V'), + (0x10836, 'X'), + (0x10837, 'V'), + (0x10839, 'X'), + (0x1083C, 'V'), + (0x1083D, 'X'), + (0x1083F, 'V'), + (0x10856, 'X'), + (0x10857, 'V'), + (0x1089F, 'X'), + (0x108A7, 'V'), + (0x108B0, 'X'), + (0x108E0, 'V'), + (0x108F3, 'X'), + (0x108F4, 'V'), + (0x108F6, 'X'), + (0x108FB, 'V'), + (0x1091C, 'X'), + (0x1091F, 'V'), + (0x1093A, 'X'), + (0x1093F, 'V'), + (0x10940, 'X'), + (0x10980, 'V'), + (0x109B8, 'X'), + (0x109BC, 'V'), + (0x109D0, 'X'), + (0x109D2, 'V'), + (0x10A04, 'X'), + (0x10A05, 'V'), + (0x10A07, 'X'), + (0x10A0C, 'V'), + (0x10A14, 'X'), + (0x10A15, 'V'), + (0x10A18, 'X'), + (0x10A19, 'V'), + (0x10A36, 'X'), + (0x10A38, 'V'), + (0x10A3B, 'X'), + (0x10A3F, 'V'), + (0x10A49, 'X'), + (0x10A50, 'V'), + (0x10A59, 'X'), + (0x10A60, 'V'), + (0x10AA0, 'X'), + (0x10AC0, 'V'), + (0x10AE7, 'X'), + (0x10AEB, 'V'), + (0x10AF7, 'X'), + (0x10B00, 'V'), + ] + +def _seg_56() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x10B36, 'X'), + (0x10B39, 'V'), + (0x10B56, 'X'), + (0x10B58, 'V'), + (0x10B73, 'X'), + (0x10B78, 'V'), + (0x10B92, 'X'), + (0x10B99, 'V'), + (0x10B9D, 'X'), + (0x10BA9, 'V'), + (0x10BB0, 'X'), + (0x10C00, 'V'), + (0x10C49, 'X'), + (0x10C80, 'M', '𐳀'), + (0x10C81, 'M', '𐳁'), + (0x10C82, 'M', '𐳂'), + (0x10C83, 'M', '𐳃'), + (0x10C84, 'M', '𐳄'), + (0x10C85, 'M', '𐳅'), + (0x10C86, 'M', '𐳆'), + (0x10C87, 'M', '𐳇'), + (0x10C88, 'M', '𐳈'), + (0x10C89, 'M', '𐳉'), + (0x10C8A, 'M', '𐳊'), + (0x10C8B, 'M', '𐳋'), + (0x10C8C, 'M', '𐳌'), + (0x10C8D, 'M', '𐳍'), + (0x10C8E, 'M', '𐳎'), + (0x10C8F, 'M', '𐳏'), + (0x10C90, 'M', '𐳐'), + (0x10C91, 'M', '𐳑'), + (0x10C92, 'M', '𐳒'), + (0x10C93, 'M', '𐳓'), + (0x10C94, 'M', '𐳔'), + (0x10C95, 'M', '𐳕'), + (0x10C96, 'M', '𐳖'), + (0x10C97, 'M', '𐳗'), + (0x10C98, 'M', '𐳘'), + (0x10C99, 'M', '𐳙'), + (0x10C9A, 'M', '𐳚'), + (0x10C9B, 'M', '𐳛'), + (0x10C9C, 'M', '𐳜'), + (0x10C9D, 'M', '𐳝'), + (0x10C9E, 'M', '𐳞'), + (0x10C9F, 'M', '𐳟'), + (0x10CA0, 'M', '𐳠'), + (0x10CA1, 'M', '𐳡'), + (0x10CA2, 'M', '𐳢'), + (0x10CA3, 'M', '𐳣'), + (0x10CA4, 'M', '𐳤'), + (0x10CA5, 'M', '𐳥'), + (0x10CA6, 'M', '𐳦'), + (0x10CA7, 'M', '𐳧'), + (0x10CA8, 'M', '𐳨'), + (0x10CA9, 'M', '𐳩'), + (0x10CAA, 'M', '𐳪'), + (0x10CAB, 'M', '𐳫'), + (0x10CAC, 'M', '𐳬'), + (0x10CAD, 'M', '𐳭'), + (0x10CAE, 'M', '𐳮'), + (0x10CAF, 'M', '𐳯'), + (0x10CB0, 'M', '𐳰'), + (0x10CB1, 'M', '𐳱'), + (0x10CB2, 'M', '𐳲'), + (0x10CB3, 'X'), + (0x10CC0, 'V'), + (0x10CF3, 'X'), + (0x10CFA, 'V'), + (0x10D28, 'X'), + (0x10D30, 'V'), + (0x10D3A, 'X'), + (0x10E60, 'V'), + (0x10E7F, 'X'), + (0x10E80, 'V'), + (0x10EAA, 'X'), + (0x10EAB, 'V'), + (0x10EAE, 'X'), + (0x10EB0, 'V'), + (0x10EB2, 'X'), + (0x10EFD, 'V'), + (0x10F28, 'X'), + (0x10F30, 'V'), + (0x10F5A, 'X'), + (0x10F70, 'V'), + (0x10F8A, 'X'), + (0x10FB0, 'V'), + (0x10FCC, 'X'), + (0x10FE0, 'V'), + (0x10FF7, 'X'), + (0x11000, 'V'), + (0x1104E, 'X'), + (0x11052, 'V'), + (0x11076, 'X'), + (0x1107F, 'V'), + (0x110BD, 'X'), + (0x110BE, 'V'), + (0x110C3, 'X'), + (0x110D0, 'V'), + (0x110E9, 'X'), + (0x110F0, 'V'), + ] + +def _seg_57() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x110FA, 'X'), + (0x11100, 'V'), + (0x11135, 'X'), + (0x11136, 'V'), + (0x11148, 'X'), + (0x11150, 'V'), + (0x11177, 'X'), + (0x11180, 'V'), + (0x111E0, 'X'), + (0x111E1, 'V'), + (0x111F5, 'X'), + (0x11200, 'V'), + (0x11212, 'X'), + (0x11213, 'V'), + (0x11242, 'X'), + (0x11280, 'V'), + (0x11287, 'X'), + (0x11288, 'V'), + (0x11289, 'X'), + (0x1128A, 'V'), + (0x1128E, 'X'), + (0x1128F, 'V'), + (0x1129E, 'X'), + (0x1129F, 'V'), + (0x112AA, 'X'), + (0x112B0, 'V'), + (0x112EB, 'X'), + (0x112F0, 'V'), + (0x112FA, 'X'), + (0x11300, 'V'), + (0x11304, 'X'), + (0x11305, 'V'), + (0x1130D, 'X'), + (0x1130F, 'V'), + (0x11311, 'X'), + (0x11313, 'V'), + (0x11329, 'X'), + (0x1132A, 'V'), + (0x11331, 'X'), + (0x11332, 'V'), + (0x11334, 'X'), + (0x11335, 'V'), + (0x1133A, 'X'), + (0x1133B, 'V'), + (0x11345, 'X'), + (0x11347, 'V'), + (0x11349, 'X'), + (0x1134B, 'V'), + (0x1134E, 'X'), + (0x11350, 'V'), + (0x11351, 'X'), + (0x11357, 'V'), + (0x11358, 'X'), + (0x1135D, 'V'), + (0x11364, 'X'), + (0x11366, 'V'), + (0x1136D, 'X'), + (0x11370, 'V'), + (0x11375, 'X'), + (0x11400, 'V'), + (0x1145C, 'X'), + (0x1145D, 'V'), + (0x11462, 'X'), + (0x11480, 'V'), + (0x114C8, 'X'), + (0x114D0, 'V'), + (0x114DA, 'X'), + (0x11580, 'V'), + (0x115B6, 'X'), + (0x115B8, 'V'), + (0x115DE, 'X'), + (0x11600, 'V'), + (0x11645, 'X'), + (0x11650, 'V'), + (0x1165A, 'X'), + (0x11660, 'V'), + (0x1166D, 'X'), + (0x11680, 'V'), + (0x116BA, 'X'), + (0x116C0, 'V'), + (0x116CA, 'X'), + (0x11700, 'V'), + (0x1171B, 'X'), + (0x1171D, 'V'), + (0x1172C, 'X'), + (0x11730, 'V'), + (0x11747, 'X'), + (0x11800, 'V'), + (0x1183C, 'X'), + (0x118A0, 'M', '𑣀'), + (0x118A1, 'M', '𑣁'), + (0x118A2, 'M', '𑣂'), + (0x118A3, 'M', '𑣃'), + (0x118A4, 'M', '𑣄'), + (0x118A5, 'M', '𑣅'), + (0x118A6, 'M', '𑣆'), + (0x118A7, 'M', '𑣇'), + (0x118A8, 'M', '𑣈'), + (0x118A9, 'M', '𑣉'), + (0x118AA, 'M', '𑣊'), + ] + +def _seg_58() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x118AB, 'M', '𑣋'), + (0x118AC, 'M', '𑣌'), + (0x118AD, 'M', '𑣍'), + (0x118AE, 'M', '𑣎'), + (0x118AF, 'M', '𑣏'), + (0x118B0, 'M', '𑣐'), + (0x118B1, 'M', '𑣑'), + (0x118B2, 'M', '𑣒'), + (0x118B3, 'M', '𑣓'), + (0x118B4, 'M', '𑣔'), + (0x118B5, 'M', '𑣕'), + (0x118B6, 'M', '𑣖'), + (0x118B7, 'M', '𑣗'), + (0x118B8, 'M', '𑣘'), + (0x118B9, 'M', '𑣙'), + (0x118BA, 'M', '𑣚'), + (0x118BB, 'M', '𑣛'), + (0x118BC, 'M', '𑣜'), + (0x118BD, 'M', '𑣝'), + (0x118BE, 'M', '𑣞'), + (0x118BF, 'M', '𑣟'), + (0x118C0, 'V'), + (0x118F3, 'X'), + (0x118FF, 'V'), + (0x11907, 'X'), + (0x11909, 'V'), + (0x1190A, 'X'), + (0x1190C, 'V'), + (0x11914, 'X'), + (0x11915, 'V'), + (0x11917, 'X'), + (0x11918, 'V'), + (0x11936, 'X'), + (0x11937, 'V'), + (0x11939, 'X'), + (0x1193B, 'V'), + (0x11947, 'X'), + (0x11950, 'V'), + (0x1195A, 'X'), + (0x119A0, 'V'), + (0x119A8, 'X'), + (0x119AA, 'V'), + (0x119D8, 'X'), + (0x119DA, 'V'), + (0x119E5, 'X'), + (0x11A00, 'V'), + (0x11A48, 'X'), + (0x11A50, 'V'), + (0x11AA3, 'X'), + (0x11AB0, 'V'), + (0x11AF9, 'X'), + (0x11B00, 'V'), + (0x11B0A, 'X'), + (0x11C00, 'V'), + (0x11C09, 'X'), + (0x11C0A, 'V'), + (0x11C37, 'X'), + (0x11C38, 'V'), + (0x11C46, 'X'), + (0x11C50, 'V'), + (0x11C6D, 'X'), + (0x11C70, 'V'), + (0x11C90, 'X'), + (0x11C92, 'V'), + (0x11CA8, 'X'), + (0x11CA9, 'V'), + (0x11CB7, 'X'), + (0x11D00, 'V'), + (0x11D07, 'X'), + (0x11D08, 'V'), + (0x11D0A, 'X'), + (0x11D0B, 'V'), + (0x11D37, 'X'), + (0x11D3A, 'V'), + (0x11D3B, 'X'), + (0x11D3C, 'V'), + (0x11D3E, 'X'), + (0x11D3F, 'V'), + (0x11D48, 'X'), + (0x11D50, 'V'), + (0x11D5A, 'X'), + (0x11D60, 'V'), + (0x11D66, 'X'), + (0x11D67, 'V'), + (0x11D69, 'X'), + (0x11D6A, 'V'), + (0x11D8F, 'X'), + (0x11D90, 'V'), + (0x11D92, 'X'), + (0x11D93, 'V'), + (0x11D99, 'X'), + (0x11DA0, 'V'), + (0x11DAA, 'X'), + (0x11EE0, 'V'), + (0x11EF9, 'X'), + (0x11F00, 'V'), + (0x11F11, 'X'), + (0x11F12, 'V'), + (0x11F3B, 'X'), + (0x11F3E, 'V'), + ] + +def _seg_59() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x11F5A, 'X'), + (0x11FB0, 'V'), + (0x11FB1, 'X'), + (0x11FC0, 'V'), + (0x11FF2, 'X'), + (0x11FFF, 'V'), + (0x1239A, 'X'), + (0x12400, 'V'), + (0x1246F, 'X'), + (0x12470, 'V'), + (0x12475, 'X'), + (0x12480, 'V'), + (0x12544, 'X'), + (0x12F90, 'V'), + (0x12FF3, 'X'), + (0x13000, 'V'), + (0x13430, 'X'), + (0x13440, 'V'), + (0x13456, 'X'), + (0x14400, 'V'), + (0x14647, 'X'), + (0x16800, 'V'), + (0x16A39, 'X'), + (0x16A40, 'V'), + (0x16A5F, 'X'), + (0x16A60, 'V'), + (0x16A6A, 'X'), + (0x16A6E, 'V'), + (0x16ABF, 'X'), + (0x16AC0, 'V'), + (0x16ACA, 'X'), + (0x16AD0, 'V'), + (0x16AEE, 'X'), + (0x16AF0, 'V'), + (0x16AF6, 'X'), + (0x16B00, 'V'), + (0x16B46, 'X'), + (0x16B50, 'V'), + (0x16B5A, 'X'), + (0x16B5B, 'V'), + (0x16B62, 'X'), + (0x16B63, 'V'), + (0x16B78, 'X'), + (0x16B7D, 'V'), + (0x16B90, 'X'), + (0x16E40, 'M', '𖹠'), + (0x16E41, 'M', '𖹡'), + (0x16E42, 'M', '𖹢'), + (0x16E43, 'M', '𖹣'), + (0x16E44, 'M', '𖹤'), + (0x16E45, 'M', '𖹥'), + (0x16E46, 'M', '𖹦'), + (0x16E47, 'M', '𖹧'), + (0x16E48, 'M', '𖹨'), + (0x16E49, 'M', '𖹩'), + (0x16E4A, 'M', '𖹪'), + (0x16E4B, 'M', '𖹫'), + (0x16E4C, 'M', '𖹬'), + (0x16E4D, 'M', '𖹭'), + (0x16E4E, 'M', '𖹮'), + (0x16E4F, 'M', '𖹯'), + (0x16E50, 'M', '𖹰'), + (0x16E51, 'M', '𖹱'), + (0x16E52, 'M', '𖹲'), + (0x16E53, 'M', '𖹳'), + (0x16E54, 'M', '𖹴'), + (0x16E55, 'M', '𖹵'), + (0x16E56, 'M', '𖹶'), + (0x16E57, 'M', '𖹷'), + (0x16E58, 'M', '𖹸'), + (0x16E59, 'M', '𖹹'), + (0x16E5A, 'M', '𖹺'), + (0x16E5B, 'M', '𖹻'), + (0x16E5C, 'M', '𖹼'), + (0x16E5D, 'M', '𖹽'), + (0x16E5E, 'M', '𖹾'), + (0x16E5F, 'M', '𖹿'), + (0x16E60, 'V'), + (0x16E9B, 'X'), + (0x16F00, 'V'), + (0x16F4B, 'X'), + (0x16F4F, 'V'), + (0x16F88, 'X'), + (0x16F8F, 'V'), + (0x16FA0, 'X'), + (0x16FE0, 'V'), + (0x16FE5, 'X'), + (0x16FF0, 'V'), + (0x16FF2, 'X'), + (0x17000, 'V'), + (0x187F8, 'X'), + (0x18800, 'V'), + (0x18CD6, 'X'), + (0x18D00, 'V'), + (0x18D09, 'X'), + (0x1AFF0, 'V'), + (0x1AFF4, 'X'), + (0x1AFF5, 'V'), + (0x1AFFC, 'X'), + (0x1AFFD, 'V'), + ] + +def _seg_60() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1AFFF, 'X'), + (0x1B000, 'V'), + (0x1B123, 'X'), + (0x1B132, 'V'), + (0x1B133, 'X'), + (0x1B150, 'V'), + (0x1B153, 'X'), + (0x1B155, 'V'), + (0x1B156, 'X'), + (0x1B164, 'V'), + (0x1B168, 'X'), + (0x1B170, 'V'), + (0x1B2FC, 'X'), + (0x1BC00, 'V'), + (0x1BC6B, 'X'), + (0x1BC70, 'V'), + (0x1BC7D, 'X'), + (0x1BC80, 'V'), + (0x1BC89, 'X'), + (0x1BC90, 'V'), + (0x1BC9A, 'X'), + (0x1BC9C, 'V'), + (0x1BCA0, 'I'), + (0x1BCA4, 'X'), + (0x1CF00, 'V'), + (0x1CF2E, 'X'), + (0x1CF30, 'V'), + (0x1CF47, 'X'), + (0x1CF50, 'V'), + (0x1CFC4, 'X'), + (0x1D000, 'V'), + (0x1D0F6, 'X'), + (0x1D100, 'V'), + (0x1D127, 'X'), + (0x1D129, 'V'), + (0x1D15E, 'M', '𝅗𝅥'), + (0x1D15F, 'M', '𝅘𝅥'), + (0x1D160, 'M', '𝅘𝅥𝅮'), + (0x1D161, 'M', '𝅘𝅥𝅯'), + (0x1D162, 'M', '𝅘𝅥𝅰'), + (0x1D163, 'M', '𝅘𝅥𝅱'), + (0x1D164, 'M', '𝅘𝅥𝅲'), + (0x1D165, 'V'), + (0x1D173, 'X'), + (0x1D17B, 'V'), + (0x1D1BB, 'M', '𝆹𝅥'), + (0x1D1BC, 'M', '𝆺𝅥'), + (0x1D1BD, 'M', '𝆹𝅥𝅮'), + (0x1D1BE, 'M', '𝆺𝅥𝅮'), + (0x1D1BF, 'M', '𝆹𝅥𝅯'), + (0x1D1C0, 'M', '𝆺𝅥𝅯'), + (0x1D1C1, 'V'), + (0x1D1EB, 'X'), + (0x1D200, 'V'), + (0x1D246, 'X'), + (0x1D2C0, 'V'), + (0x1D2D4, 'X'), + (0x1D2E0, 'V'), + (0x1D2F4, 'X'), + (0x1D300, 'V'), + (0x1D357, 'X'), + (0x1D360, 'V'), + (0x1D379, 'X'), + (0x1D400, 'M', 'a'), + (0x1D401, 'M', 'b'), + (0x1D402, 'M', 'c'), + (0x1D403, 'M', 'd'), + (0x1D404, 'M', 'e'), + (0x1D405, 'M', 'f'), + (0x1D406, 'M', 'g'), + (0x1D407, 'M', 'h'), + (0x1D408, 'M', 'i'), + (0x1D409, 'M', 'j'), + (0x1D40A, 'M', 'k'), + (0x1D40B, 'M', 'l'), + (0x1D40C, 'M', 'm'), + (0x1D40D, 'M', 'n'), + (0x1D40E, 'M', 'o'), + (0x1D40F, 'M', 'p'), + (0x1D410, 'M', 'q'), + (0x1D411, 'M', 'r'), + (0x1D412, 'M', 's'), + (0x1D413, 'M', 't'), + (0x1D414, 'M', 'u'), + (0x1D415, 'M', 'v'), + (0x1D416, 'M', 'w'), + (0x1D417, 'M', 'x'), + (0x1D418, 'M', 'y'), + (0x1D419, 'M', 'z'), + (0x1D41A, 'M', 'a'), + (0x1D41B, 'M', 'b'), + (0x1D41C, 'M', 'c'), + (0x1D41D, 'M', 'd'), + (0x1D41E, 'M', 'e'), + (0x1D41F, 'M', 'f'), + (0x1D420, 'M', 'g'), + (0x1D421, 'M', 'h'), + (0x1D422, 'M', 'i'), + (0x1D423, 'M', 'j'), + (0x1D424, 'M', 'k'), + ] + +def _seg_61() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1D425, 'M', 'l'), + (0x1D426, 'M', 'm'), + (0x1D427, 'M', 'n'), + (0x1D428, 'M', 'o'), + (0x1D429, 'M', 'p'), + (0x1D42A, 'M', 'q'), + (0x1D42B, 'M', 'r'), + (0x1D42C, 'M', 's'), + (0x1D42D, 'M', 't'), + (0x1D42E, 'M', 'u'), + (0x1D42F, 'M', 'v'), + (0x1D430, 'M', 'w'), + (0x1D431, 'M', 'x'), + (0x1D432, 'M', 'y'), + (0x1D433, 'M', 'z'), + (0x1D434, 'M', 'a'), + (0x1D435, 'M', 'b'), + (0x1D436, 'M', 'c'), + (0x1D437, 'M', 'd'), + (0x1D438, 'M', 'e'), + (0x1D439, 'M', 'f'), + (0x1D43A, 'M', 'g'), + (0x1D43B, 'M', 'h'), + (0x1D43C, 'M', 'i'), + (0x1D43D, 'M', 'j'), + (0x1D43E, 'M', 'k'), + (0x1D43F, 'M', 'l'), + (0x1D440, 'M', 'm'), + (0x1D441, 'M', 'n'), + (0x1D442, 'M', 'o'), + (0x1D443, 'M', 'p'), + (0x1D444, 'M', 'q'), + (0x1D445, 'M', 'r'), + (0x1D446, 'M', 's'), + (0x1D447, 'M', 't'), + (0x1D448, 'M', 'u'), + (0x1D449, 'M', 'v'), + (0x1D44A, 'M', 'w'), + (0x1D44B, 'M', 'x'), + (0x1D44C, 'M', 'y'), + (0x1D44D, 'M', 'z'), + (0x1D44E, 'M', 'a'), + (0x1D44F, 'M', 'b'), + (0x1D450, 'M', 'c'), + (0x1D451, 'M', 'd'), + (0x1D452, 'M', 'e'), + (0x1D453, 'M', 'f'), + (0x1D454, 'M', 'g'), + (0x1D455, 'X'), + (0x1D456, 'M', 'i'), + (0x1D457, 'M', 'j'), + (0x1D458, 'M', 'k'), + (0x1D459, 'M', 'l'), + (0x1D45A, 'M', 'm'), + (0x1D45B, 'M', 'n'), + (0x1D45C, 'M', 'o'), + (0x1D45D, 'M', 'p'), + (0x1D45E, 'M', 'q'), + (0x1D45F, 'M', 'r'), + (0x1D460, 'M', 's'), + (0x1D461, 'M', 't'), + (0x1D462, 'M', 'u'), + (0x1D463, 'M', 'v'), + (0x1D464, 'M', 'w'), + (0x1D465, 'M', 'x'), + (0x1D466, 'M', 'y'), + (0x1D467, 'M', 'z'), + (0x1D468, 'M', 'a'), + (0x1D469, 'M', 'b'), + (0x1D46A, 'M', 'c'), + (0x1D46B, 'M', 'd'), + (0x1D46C, 'M', 'e'), + (0x1D46D, 'M', 'f'), + (0x1D46E, 'M', 'g'), + (0x1D46F, 'M', 'h'), + (0x1D470, 'M', 'i'), + (0x1D471, 'M', 'j'), + (0x1D472, 'M', 'k'), + (0x1D473, 'M', 'l'), + (0x1D474, 'M', 'm'), + (0x1D475, 'M', 'n'), + (0x1D476, 'M', 'o'), + (0x1D477, 'M', 'p'), + (0x1D478, 'M', 'q'), + (0x1D479, 'M', 'r'), + (0x1D47A, 'M', 's'), + (0x1D47B, 'M', 't'), + (0x1D47C, 'M', 'u'), + (0x1D47D, 'M', 'v'), + (0x1D47E, 'M', 'w'), + (0x1D47F, 'M', 'x'), + (0x1D480, 'M', 'y'), + (0x1D481, 'M', 'z'), + (0x1D482, 'M', 'a'), + (0x1D483, 'M', 'b'), + (0x1D484, 'M', 'c'), + (0x1D485, 'M', 'd'), + (0x1D486, 'M', 'e'), + (0x1D487, 'M', 'f'), + (0x1D488, 'M', 'g'), + ] + +def _seg_62() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1D489, 'M', 'h'), + (0x1D48A, 'M', 'i'), + (0x1D48B, 'M', 'j'), + (0x1D48C, 'M', 'k'), + (0x1D48D, 'M', 'l'), + (0x1D48E, 'M', 'm'), + (0x1D48F, 'M', 'n'), + (0x1D490, 'M', 'o'), + (0x1D491, 'M', 'p'), + (0x1D492, 'M', 'q'), + (0x1D493, 'M', 'r'), + (0x1D494, 'M', 's'), + (0x1D495, 'M', 't'), + (0x1D496, 'M', 'u'), + (0x1D497, 'M', 'v'), + (0x1D498, 'M', 'w'), + (0x1D499, 'M', 'x'), + (0x1D49A, 'M', 'y'), + (0x1D49B, 'M', 'z'), + (0x1D49C, 'M', 'a'), + (0x1D49D, 'X'), + (0x1D49E, 'M', 'c'), + (0x1D49F, 'M', 'd'), + (0x1D4A0, 'X'), + (0x1D4A2, 'M', 'g'), + (0x1D4A3, 'X'), + (0x1D4A5, 'M', 'j'), + (0x1D4A6, 'M', 'k'), + (0x1D4A7, 'X'), + (0x1D4A9, 'M', 'n'), + (0x1D4AA, 'M', 'o'), + (0x1D4AB, 'M', 'p'), + (0x1D4AC, 'M', 'q'), + (0x1D4AD, 'X'), + (0x1D4AE, 'M', 's'), + (0x1D4AF, 'M', 't'), + (0x1D4B0, 'M', 'u'), + (0x1D4B1, 'M', 'v'), + (0x1D4B2, 'M', 'w'), + (0x1D4B3, 'M', 'x'), + (0x1D4B4, 'M', 'y'), + (0x1D4B5, 'M', 'z'), + (0x1D4B6, 'M', 'a'), + (0x1D4B7, 'M', 'b'), + (0x1D4B8, 'M', 'c'), + (0x1D4B9, 'M', 'd'), + (0x1D4BA, 'X'), + (0x1D4BB, 'M', 'f'), + (0x1D4BC, 'X'), + (0x1D4BD, 'M', 'h'), + (0x1D4BE, 'M', 'i'), + (0x1D4BF, 'M', 'j'), + (0x1D4C0, 'M', 'k'), + (0x1D4C1, 'M', 'l'), + (0x1D4C2, 'M', 'm'), + (0x1D4C3, 'M', 'n'), + (0x1D4C4, 'X'), + (0x1D4C5, 'M', 'p'), + (0x1D4C6, 'M', 'q'), + (0x1D4C7, 'M', 'r'), + (0x1D4C8, 'M', 's'), + (0x1D4C9, 'M', 't'), + (0x1D4CA, 'M', 'u'), + (0x1D4CB, 'M', 'v'), + (0x1D4CC, 'M', 'w'), + (0x1D4CD, 'M', 'x'), + (0x1D4CE, 'M', 'y'), + (0x1D4CF, 'M', 'z'), + (0x1D4D0, 'M', 'a'), + (0x1D4D1, 'M', 'b'), + (0x1D4D2, 'M', 'c'), + (0x1D4D3, 'M', 'd'), + (0x1D4D4, 'M', 'e'), + (0x1D4D5, 'M', 'f'), + (0x1D4D6, 'M', 'g'), + (0x1D4D7, 'M', 'h'), + (0x1D4D8, 'M', 'i'), + (0x1D4D9, 'M', 'j'), + (0x1D4DA, 'M', 'k'), + (0x1D4DB, 'M', 'l'), + (0x1D4DC, 'M', 'm'), + (0x1D4DD, 'M', 'n'), + (0x1D4DE, 'M', 'o'), + (0x1D4DF, 'M', 'p'), + (0x1D4E0, 'M', 'q'), + (0x1D4E1, 'M', 'r'), + (0x1D4E2, 'M', 's'), + (0x1D4E3, 'M', 't'), + (0x1D4E4, 'M', 'u'), + (0x1D4E5, 'M', 'v'), + (0x1D4E6, 'M', 'w'), + (0x1D4E7, 'M', 'x'), + (0x1D4E8, 'M', 'y'), + (0x1D4E9, 'M', 'z'), + (0x1D4EA, 'M', 'a'), + (0x1D4EB, 'M', 'b'), + (0x1D4EC, 'M', 'c'), + (0x1D4ED, 'M', 'd'), + (0x1D4EE, 'M', 'e'), + (0x1D4EF, 'M', 'f'), + ] + +def _seg_63() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1D4F0, 'M', 'g'), + (0x1D4F1, 'M', 'h'), + (0x1D4F2, 'M', 'i'), + (0x1D4F3, 'M', 'j'), + (0x1D4F4, 'M', 'k'), + (0x1D4F5, 'M', 'l'), + (0x1D4F6, 'M', 'm'), + (0x1D4F7, 'M', 'n'), + (0x1D4F8, 'M', 'o'), + (0x1D4F9, 'M', 'p'), + (0x1D4FA, 'M', 'q'), + (0x1D4FB, 'M', 'r'), + (0x1D4FC, 'M', 's'), + (0x1D4FD, 'M', 't'), + (0x1D4FE, 'M', 'u'), + (0x1D4FF, 'M', 'v'), + (0x1D500, 'M', 'w'), + (0x1D501, 'M', 'x'), + (0x1D502, 'M', 'y'), + (0x1D503, 'M', 'z'), + (0x1D504, 'M', 'a'), + (0x1D505, 'M', 'b'), + (0x1D506, 'X'), + (0x1D507, 'M', 'd'), + (0x1D508, 'M', 'e'), + (0x1D509, 'M', 'f'), + (0x1D50A, 'M', 'g'), + (0x1D50B, 'X'), + (0x1D50D, 'M', 'j'), + (0x1D50E, 'M', 'k'), + (0x1D50F, 'M', 'l'), + (0x1D510, 'M', 'm'), + (0x1D511, 'M', 'n'), + (0x1D512, 'M', 'o'), + (0x1D513, 'M', 'p'), + (0x1D514, 'M', 'q'), + (0x1D515, 'X'), + (0x1D516, 'M', 's'), + (0x1D517, 'M', 't'), + (0x1D518, 'M', 'u'), + (0x1D519, 'M', 'v'), + (0x1D51A, 'M', 'w'), + (0x1D51B, 'M', 'x'), + (0x1D51C, 'M', 'y'), + (0x1D51D, 'X'), + (0x1D51E, 'M', 'a'), + (0x1D51F, 'M', 'b'), + (0x1D520, 'M', 'c'), + (0x1D521, 'M', 'd'), + (0x1D522, 'M', 'e'), + (0x1D523, 'M', 'f'), + (0x1D524, 'M', 'g'), + (0x1D525, 'M', 'h'), + (0x1D526, 'M', 'i'), + (0x1D527, 'M', 'j'), + (0x1D528, 'M', 'k'), + (0x1D529, 'M', 'l'), + (0x1D52A, 'M', 'm'), + (0x1D52B, 'M', 'n'), + (0x1D52C, 'M', 'o'), + (0x1D52D, 'M', 'p'), + (0x1D52E, 'M', 'q'), + (0x1D52F, 'M', 'r'), + (0x1D530, 'M', 's'), + (0x1D531, 'M', 't'), + (0x1D532, 'M', 'u'), + (0x1D533, 'M', 'v'), + (0x1D534, 'M', 'w'), + (0x1D535, 'M', 'x'), + (0x1D536, 'M', 'y'), + (0x1D537, 'M', 'z'), + (0x1D538, 'M', 'a'), + (0x1D539, 'M', 'b'), + (0x1D53A, 'X'), + (0x1D53B, 'M', 'd'), + (0x1D53C, 'M', 'e'), + (0x1D53D, 'M', 'f'), + (0x1D53E, 'M', 'g'), + (0x1D53F, 'X'), + (0x1D540, 'M', 'i'), + (0x1D541, 'M', 'j'), + (0x1D542, 'M', 'k'), + (0x1D543, 'M', 'l'), + (0x1D544, 'M', 'm'), + (0x1D545, 'X'), + (0x1D546, 'M', 'o'), + (0x1D547, 'X'), + (0x1D54A, 'M', 's'), + (0x1D54B, 'M', 't'), + (0x1D54C, 'M', 'u'), + (0x1D54D, 'M', 'v'), + (0x1D54E, 'M', 'w'), + (0x1D54F, 'M', 'x'), + (0x1D550, 'M', 'y'), + (0x1D551, 'X'), + (0x1D552, 'M', 'a'), + (0x1D553, 'M', 'b'), + (0x1D554, 'M', 'c'), + (0x1D555, 'M', 'd'), + (0x1D556, 'M', 'e'), + ] + +def _seg_64() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1D557, 'M', 'f'), + (0x1D558, 'M', 'g'), + (0x1D559, 'M', 'h'), + (0x1D55A, 'M', 'i'), + (0x1D55B, 'M', 'j'), + (0x1D55C, 'M', 'k'), + (0x1D55D, 'M', 'l'), + (0x1D55E, 'M', 'm'), + (0x1D55F, 'M', 'n'), + (0x1D560, 'M', 'o'), + (0x1D561, 'M', 'p'), + (0x1D562, 'M', 'q'), + (0x1D563, 'M', 'r'), + (0x1D564, 'M', 's'), + (0x1D565, 'M', 't'), + (0x1D566, 'M', 'u'), + (0x1D567, 'M', 'v'), + (0x1D568, 'M', 'w'), + (0x1D569, 'M', 'x'), + (0x1D56A, 'M', 'y'), + (0x1D56B, 'M', 'z'), + (0x1D56C, 'M', 'a'), + (0x1D56D, 'M', 'b'), + (0x1D56E, 'M', 'c'), + (0x1D56F, 'M', 'd'), + (0x1D570, 'M', 'e'), + (0x1D571, 'M', 'f'), + (0x1D572, 'M', 'g'), + (0x1D573, 'M', 'h'), + (0x1D574, 'M', 'i'), + (0x1D575, 'M', 'j'), + (0x1D576, 'M', 'k'), + (0x1D577, 'M', 'l'), + (0x1D578, 'M', 'm'), + (0x1D579, 'M', 'n'), + (0x1D57A, 'M', 'o'), + (0x1D57B, 'M', 'p'), + (0x1D57C, 'M', 'q'), + (0x1D57D, 'M', 'r'), + (0x1D57E, 'M', 's'), + (0x1D57F, 'M', 't'), + (0x1D580, 'M', 'u'), + (0x1D581, 'M', 'v'), + (0x1D582, 'M', 'w'), + (0x1D583, 'M', 'x'), + (0x1D584, 'M', 'y'), + (0x1D585, 'M', 'z'), + (0x1D586, 'M', 'a'), + (0x1D587, 'M', 'b'), + (0x1D588, 'M', 'c'), + (0x1D589, 'M', 'd'), + (0x1D58A, 'M', 'e'), + (0x1D58B, 'M', 'f'), + (0x1D58C, 'M', 'g'), + (0x1D58D, 'M', 'h'), + (0x1D58E, 'M', 'i'), + (0x1D58F, 'M', 'j'), + (0x1D590, 'M', 'k'), + (0x1D591, 'M', 'l'), + (0x1D592, 'M', 'm'), + (0x1D593, 'M', 'n'), + (0x1D594, 'M', 'o'), + (0x1D595, 'M', 'p'), + (0x1D596, 'M', 'q'), + (0x1D597, 'M', 'r'), + (0x1D598, 'M', 's'), + (0x1D599, 'M', 't'), + (0x1D59A, 'M', 'u'), + (0x1D59B, 'M', 'v'), + (0x1D59C, 'M', 'w'), + (0x1D59D, 'M', 'x'), + (0x1D59E, 'M', 'y'), + (0x1D59F, 'M', 'z'), + (0x1D5A0, 'M', 'a'), + (0x1D5A1, 'M', 'b'), + (0x1D5A2, 'M', 'c'), + (0x1D5A3, 'M', 'd'), + (0x1D5A4, 'M', 'e'), + (0x1D5A5, 'M', 'f'), + (0x1D5A6, 'M', 'g'), + (0x1D5A7, 'M', 'h'), + (0x1D5A8, 'M', 'i'), + (0x1D5A9, 'M', 'j'), + (0x1D5AA, 'M', 'k'), + (0x1D5AB, 'M', 'l'), + (0x1D5AC, 'M', 'm'), + (0x1D5AD, 'M', 'n'), + (0x1D5AE, 'M', 'o'), + (0x1D5AF, 'M', 'p'), + (0x1D5B0, 'M', 'q'), + (0x1D5B1, 'M', 'r'), + (0x1D5B2, 'M', 's'), + (0x1D5B3, 'M', 't'), + (0x1D5B4, 'M', 'u'), + (0x1D5B5, 'M', 'v'), + (0x1D5B6, 'M', 'w'), + (0x1D5B7, 'M', 'x'), + (0x1D5B8, 'M', 'y'), + (0x1D5B9, 'M', 'z'), + (0x1D5BA, 'M', 'a'), + ] + +def _seg_65() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1D5BB, 'M', 'b'), + (0x1D5BC, 'M', 'c'), + (0x1D5BD, 'M', 'd'), + (0x1D5BE, 'M', 'e'), + (0x1D5BF, 'M', 'f'), + (0x1D5C0, 'M', 'g'), + (0x1D5C1, 'M', 'h'), + (0x1D5C2, 'M', 'i'), + (0x1D5C3, 'M', 'j'), + (0x1D5C4, 'M', 'k'), + (0x1D5C5, 'M', 'l'), + (0x1D5C6, 'M', 'm'), + (0x1D5C7, 'M', 'n'), + (0x1D5C8, 'M', 'o'), + (0x1D5C9, 'M', 'p'), + (0x1D5CA, 'M', 'q'), + (0x1D5CB, 'M', 'r'), + (0x1D5CC, 'M', 's'), + (0x1D5CD, 'M', 't'), + (0x1D5CE, 'M', 'u'), + (0x1D5CF, 'M', 'v'), + (0x1D5D0, 'M', 'w'), + (0x1D5D1, 'M', 'x'), + (0x1D5D2, 'M', 'y'), + (0x1D5D3, 'M', 'z'), + (0x1D5D4, 'M', 'a'), + (0x1D5D5, 'M', 'b'), + (0x1D5D6, 'M', 'c'), + (0x1D5D7, 'M', 'd'), + (0x1D5D8, 'M', 'e'), + (0x1D5D9, 'M', 'f'), + (0x1D5DA, 'M', 'g'), + (0x1D5DB, 'M', 'h'), + (0x1D5DC, 'M', 'i'), + (0x1D5DD, 'M', 'j'), + (0x1D5DE, 'M', 'k'), + (0x1D5DF, 'M', 'l'), + (0x1D5E0, 'M', 'm'), + (0x1D5E1, 'M', 'n'), + (0x1D5E2, 'M', 'o'), + (0x1D5E3, 'M', 'p'), + (0x1D5E4, 'M', 'q'), + (0x1D5E5, 'M', 'r'), + (0x1D5E6, 'M', 's'), + (0x1D5E7, 'M', 't'), + (0x1D5E8, 'M', 'u'), + (0x1D5E9, 'M', 'v'), + (0x1D5EA, 'M', 'w'), + (0x1D5EB, 'M', 'x'), + (0x1D5EC, 'M', 'y'), + (0x1D5ED, 'M', 'z'), + (0x1D5EE, 'M', 'a'), + (0x1D5EF, 'M', 'b'), + (0x1D5F0, 'M', 'c'), + (0x1D5F1, 'M', 'd'), + (0x1D5F2, 'M', 'e'), + (0x1D5F3, 'M', 'f'), + (0x1D5F4, 'M', 'g'), + (0x1D5F5, 'M', 'h'), + (0x1D5F6, 'M', 'i'), + (0x1D5F7, 'M', 'j'), + (0x1D5F8, 'M', 'k'), + (0x1D5F9, 'M', 'l'), + (0x1D5FA, 'M', 'm'), + (0x1D5FB, 'M', 'n'), + (0x1D5FC, 'M', 'o'), + (0x1D5FD, 'M', 'p'), + (0x1D5FE, 'M', 'q'), + (0x1D5FF, 'M', 'r'), + (0x1D600, 'M', 's'), + (0x1D601, 'M', 't'), + (0x1D602, 'M', 'u'), + (0x1D603, 'M', 'v'), + (0x1D604, 'M', 'w'), + (0x1D605, 'M', 'x'), + (0x1D606, 'M', 'y'), + (0x1D607, 'M', 'z'), + (0x1D608, 'M', 'a'), + (0x1D609, 'M', 'b'), + (0x1D60A, 'M', 'c'), + (0x1D60B, 'M', 'd'), + (0x1D60C, 'M', 'e'), + (0x1D60D, 'M', 'f'), + (0x1D60E, 'M', 'g'), + (0x1D60F, 'M', 'h'), + (0x1D610, 'M', 'i'), + (0x1D611, 'M', 'j'), + (0x1D612, 'M', 'k'), + (0x1D613, 'M', 'l'), + (0x1D614, 'M', 'm'), + (0x1D615, 'M', 'n'), + (0x1D616, 'M', 'o'), + (0x1D617, 'M', 'p'), + (0x1D618, 'M', 'q'), + (0x1D619, 'M', 'r'), + (0x1D61A, 'M', 's'), + (0x1D61B, 'M', 't'), + (0x1D61C, 'M', 'u'), + (0x1D61D, 'M', 'v'), + (0x1D61E, 'M', 'w'), + ] + +def _seg_66() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1D61F, 'M', 'x'), + (0x1D620, 'M', 'y'), + (0x1D621, 'M', 'z'), + (0x1D622, 'M', 'a'), + (0x1D623, 'M', 'b'), + (0x1D624, 'M', 'c'), + (0x1D625, 'M', 'd'), + (0x1D626, 'M', 'e'), + (0x1D627, 'M', 'f'), + (0x1D628, 'M', 'g'), + (0x1D629, 'M', 'h'), + (0x1D62A, 'M', 'i'), + (0x1D62B, 'M', 'j'), + (0x1D62C, 'M', 'k'), + (0x1D62D, 'M', 'l'), + (0x1D62E, 'M', 'm'), + (0x1D62F, 'M', 'n'), + (0x1D630, 'M', 'o'), + (0x1D631, 'M', 'p'), + (0x1D632, 'M', 'q'), + (0x1D633, 'M', 'r'), + (0x1D634, 'M', 's'), + (0x1D635, 'M', 't'), + (0x1D636, 'M', 'u'), + (0x1D637, 'M', 'v'), + (0x1D638, 'M', 'w'), + (0x1D639, 'M', 'x'), + (0x1D63A, 'M', 'y'), + (0x1D63B, 'M', 'z'), + (0x1D63C, 'M', 'a'), + (0x1D63D, 'M', 'b'), + (0x1D63E, 'M', 'c'), + (0x1D63F, 'M', 'd'), + (0x1D640, 'M', 'e'), + (0x1D641, 'M', 'f'), + (0x1D642, 'M', 'g'), + (0x1D643, 'M', 'h'), + (0x1D644, 'M', 'i'), + (0x1D645, 'M', 'j'), + (0x1D646, 'M', 'k'), + (0x1D647, 'M', 'l'), + (0x1D648, 'M', 'm'), + (0x1D649, 'M', 'n'), + (0x1D64A, 'M', 'o'), + (0x1D64B, 'M', 'p'), + (0x1D64C, 'M', 'q'), + (0x1D64D, 'M', 'r'), + (0x1D64E, 'M', 's'), + (0x1D64F, 'M', 't'), + (0x1D650, 'M', 'u'), + (0x1D651, 'M', 'v'), + (0x1D652, 'M', 'w'), + (0x1D653, 'M', 'x'), + (0x1D654, 'M', 'y'), + (0x1D655, 'M', 'z'), + (0x1D656, 'M', 'a'), + (0x1D657, 'M', 'b'), + (0x1D658, 'M', 'c'), + (0x1D659, 'M', 'd'), + (0x1D65A, 'M', 'e'), + (0x1D65B, 'M', 'f'), + (0x1D65C, 'M', 'g'), + (0x1D65D, 'M', 'h'), + (0x1D65E, 'M', 'i'), + (0x1D65F, 'M', 'j'), + (0x1D660, 'M', 'k'), + (0x1D661, 'M', 'l'), + (0x1D662, 'M', 'm'), + (0x1D663, 'M', 'n'), + (0x1D664, 'M', 'o'), + (0x1D665, 'M', 'p'), + (0x1D666, 'M', 'q'), + (0x1D667, 'M', 'r'), + (0x1D668, 'M', 's'), + (0x1D669, 'M', 't'), + (0x1D66A, 'M', 'u'), + (0x1D66B, 'M', 'v'), + (0x1D66C, 'M', 'w'), + (0x1D66D, 'M', 'x'), + (0x1D66E, 'M', 'y'), + (0x1D66F, 'M', 'z'), + (0x1D670, 'M', 'a'), + (0x1D671, 'M', 'b'), + (0x1D672, 'M', 'c'), + (0x1D673, 'M', 'd'), + (0x1D674, 'M', 'e'), + (0x1D675, 'M', 'f'), + (0x1D676, 'M', 'g'), + (0x1D677, 'M', 'h'), + (0x1D678, 'M', 'i'), + (0x1D679, 'M', 'j'), + (0x1D67A, 'M', 'k'), + (0x1D67B, 'M', 'l'), + (0x1D67C, 'M', 'm'), + (0x1D67D, 'M', 'n'), + (0x1D67E, 'M', 'o'), + (0x1D67F, 'M', 'p'), + (0x1D680, 'M', 'q'), + (0x1D681, 'M', 'r'), + (0x1D682, 'M', 's'), + ] + +def _seg_67() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1D683, 'M', 't'), + (0x1D684, 'M', 'u'), + (0x1D685, 'M', 'v'), + (0x1D686, 'M', 'w'), + (0x1D687, 'M', 'x'), + (0x1D688, 'M', 'y'), + (0x1D689, 'M', 'z'), + (0x1D68A, 'M', 'a'), + (0x1D68B, 'M', 'b'), + (0x1D68C, 'M', 'c'), + (0x1D68D, 'M', 'd'), + (0x1D68E, 'M', 'e'), + (0x1D68F, 'M', 'f'), + (0x1D690, 'M', 'g'), + (0x1D691, 'M', 'h'), + (0x1D692, 'M', 'i'), + (0x1D693, 'M', 'j'), + (0x1D694, 'M', 'k'), + (0x1D695, 'M', 'l'), + (0x1D696, 'M', 'm'), + (0x1D697, 'M', 'n'), + (0x1D698, 'M', 'o'), + (0x1D699, 'M', 'p'), + (0x1D69A, 'M', 'q'), + (0x1D69B, 'M', 'r'), + (0x1D69C, 'M', 's'), + (0x1D69D, 'M', 't'), + (0x1D69E, 'M', 'u'), + (0x1D69F, 'M', 'v'), + (0x1D6A0, 'M', 'w'), + (0x1D6A1, 'M', 'x'), + (0x1D6A2, 'M', 'y'), + (0x1D6A3, 'M', 'z'), + (0x1D6A4, 'M', 'ı'), + (0x1D6A5, 'M', 'ȷ'), + (0x1D6A6, 'X'), + (0x1D6A8, 'M', 'α'), + (0x1D6A9, 'M', 'β'), + (0x1D6AA, 'M', 'γ'), + (0x1D6AB, 'M', 'δ'), + (0x1D6AC, 'M', 'ε'), + (0x1D6AD, 'M', 'ζ'), + (0x1D6AE, 'M', 'η'), + (0x1D6AF, 'M', 'θ'), + (0x1D6B0, 'M', 'ι'), + (0x1D6B1, 'M', 'κ'), + (0x1D6B2, 'M', 'λ'), + (0x1D6B3, 'M', 'μ'), + (0x1D6B4, 'M', 'ν'), + (0x1D6B5, 'M', 'ξ'), + (0x1D6B6, 'M', 'ο'), + (0x1D6B7, 'M', 'π'), + (0x1D6B8, 'M', 'ρ'), + (0x1D6B9, 'M', 'θ'), + (0x1D6BA, 'M', 'σ'), + (0x1D6BB, 'M', 'τ'), + (0x1D6BC, 'M', 'υ'), + (0x1D6BD, 'M', 'φ'), + (0x1D6BE, 'M', 'χ'), + (0x1D6BF, 'M', 'ψ'), + (0x1D6C0, 'M', 'ω'), + (0x1D6C1, 'M', '∇'), + (0x1D6C2, 'M', 'α'), + (0x1D6C3, 'M', 'β'), + (0x1D6C4, 'M', 'γ'), + (0x1D6C5, 'M', 'δ'), + (0x1D6C6, 'M', 'ε'), + (0x1D6C7, 'M', 'ζ'), + (0x1D6C8, 'M', 'η'), + (0x1D6C9, 'M', 'θ'), + (0x1D6CA, 'M', 'ι'), + (0x1D6CB, 'M', 'κ'), + (0x1D6CC, 'M', 'λ'), + (0x1D6CD, 'M', 'μ'), + (0x1D6CE, 'M', 'ν'), + (0x1D6CF, 'M', 'ξ'), + (0x1D6D0, 'M', 'ο'), + (0x1D6D1, 'M', 'π'), + (0x1D6D2, 'M', 'ρ'), + (0x1D6D3, 'M', 'σ'), + (0x1D6D5, 'M', 'τ'), + (0x1D6D6, 'M', 'υ'), + (0x1D6D7, 'M', 'φ'), + (0x1D6D8, 'M', 'χ'), + (0x1D6D9, 'M', 'ψ'), + (0x1D6DA, 'M', 'ω'), + (0x1D6DB, 'M', '∂'), + (0x1D6DC, 'M', 'ε'), + (0x1D6DD, 'M', 'θ'), + (0x1D6DE, 'M', 'κ'), + (0x1D6DF, 'M', 'φ'), + (0x1D6E0, 'M', 'ρ'), + (0x1D6E1, 'M', 'π'), + (0x1D6E2, 'M', 'α'), + (0x1D6E3, 'M', 'β'), + (0x1D6E4, 'M', 'γ'), + (0x1D6E5, 'M', 'δ'), + (0x1D6E6, 'M', 'ε'), + (0x1D6E7, 'M', 'ζ'), + (0x1D6E8, 'M', 'η'), + ] + +def _seg_68() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1D6E9, 'M', 'θ'), + (0x1D6EA, 'M', 'ι'), + (0x1D6EB, 'M', 'κ'), + (0x1D6EC, 'M', 'λ'), + (0x1D6ED, 'M', 'μ'), + (0x1D6EE, 'M', 'ν'), + (0x1D6EF, 'M', 'ξ'), + (0x1D6F0, 'M', 'ο'), + (0x1D6F1, 'M', 'π'), + (0x1D6F2, 'M', 'ρ'), + (0x1D6F3, 'M', 'θ'), + (0x1D6F4, 'M', 'σ'), + (0x1D6F5, 'M', 'τ'), + (0x1D6F6, 'M', 'υ'), + (0x1D6F7, 'M', 'φ'), + (0x1D6F8, 'M', 'χ'), + (0x1D6F9, 'M', 'ψ'), + (0x1D6FA, 'M', 'ω'), + (0x1D6FB, 'M', '∇'), + (0x1D6FC, 'M', 'α'), + (0x1D6FD, 'M', 'β'), + (0x1D6FE, 'M', 'γ'), + (0x1D6FF, 'M', 'δ'), + (0x1D700, 'M', 'ε'), + (0x1D701, 'M', 'ζ'), + (0x1D702, 'M', 'η'), + (0x1D703, 'M', 'θ'), + (0x1D704, 'M', 'ι'), + (0x1D705, 'M', 'κ'), + (0x1D706, 'M', 'λ'), + (0x1D707, 'M', 'μ'), + (0x1D708, 'M', 'ν'), + (0x1D709, 'M', 'ξ'), + (0x1D70A, 'M', 'ο'), + (0x1D70B, 'M', 'π'), + (0x1D70C, 'M', 'ρ'), + (0x1D70D, 'M', 'σ'), + (0x1D70F, 'M', 'τ'), + (0x1D710, 'M', 'υ'), + (0x1D711, 'M', 'φ'), + (0x1D712, 'M', 'χ'), + (0x1D713, 'M', 'ψ'), + (0x1D714, 'M', 'ω'), + (0x1D715, 'M', '∂'), + (0x1D716, 'M', 'ε'), + (0x1D717, 'M', 'θ'), + (0x1D718, 'M', 'κ'), + (0x1D719, 'M', 'φ'), + (0x1D71A, 'M', 'ρ'), + (0x1D71B, 'M', 'π'), + (0x1D71C, 'M', 'α'), + (0x1D71D, 'M', 'β'), + (0x1D71E, 'M', 'γ'), + (0x1D71F, 'M', 'δ'), + (0x1D720, 'M', 'ε'), + (0x1D721, 'M', 'ζ'), + (0x1D722, 'M', 'η'), + (0x1D723, 'M', 'θ'), + (0x1D724, 'M', 'ι'), + (0x1D725, 'M', 'κ'), + (0x1D726, 'M', 'λ'), + (0x1D727, 'M', 'μ'), + (0x1D728, 'M', 'ν'), + (0x1D729, 'M', 'ξ'), + (0x1D72A, 'M', 'ο'), + (0x1D72B, 'M', 'π'), + (0x1D72C, 'M', 'ρ'), + (0x1D72D, 'M', 'θ'), + (0x1D72E, 'M', 'σ'), + (0x1D72F, 'M', 'τ'), + (0x1D730, 'M', 'υ'), + (0x1D731, 'M', 'φ'), + (0x1D732, 'M', 'χ'), + (0x1D733, 'M', 'ψ'), + (0x1D734, 'M', 'ω'), + (0x1D735, 'M', '∇'), + (0x1D736, 'M', 'α'), + (0x1D737, 'M', 'β'), + (0x1D738, 'M', 'γ'), + (0x1D739, 'M', 'δ'), + (0x1D73A, 'M', 'ε'), + (0x1D73B, 'M', 'ζ'), + (0x1D73C, 'M', 'η'), + (0x1D73D, 'M', 'θ'), + (0x1D73E, 'M', 'ι'), + (0x1D73F, 'M', 'κ'), + (0x1D740, 'M', 'λ'), + (0x1D741, 'M', 'μ'), + (0x1D742, 'M', 'ν'), + (0x1D743, 'M', 'ξ'), + (0x1D744, 'M', 'ο'), + (0x1D745, 'M', 'π'), + (0x1D746, 'M', 'ρ'), + (0x1D747, 'M', 'σ'), + (0x1D749, 'M', 'τ'), + (0x1D74A, 'M', 'υ'), + (0x1D74B, 'M', 'φ'), + (0x1D74C, 'M', 'χ'), + (0x1D74D, 'M', 'ψ'), + (0x1D74E, 'M', 'ω'), + ] + +def _seg_69() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1D74F, 'M', '∂'), + (0x1D750, 'M', 'ε'), + (0x1D751, 'M', 'θ'), + (0x1D752, 'M', 'κ'), + (0x1D753, 'M', 'φ'), + (0x1D754, 'M', 'ρ'), + (0x1D755, 'M', 'π'), + (0x1D756, 'M', 'α'), + (0x1D757, 'M', 'β'), + (0x1D758, 'M', 'γ'), + (0x1D759, 'M', 'δ'), + (0x1D75A, 'M', 'ε'), + (0x1D75B, 'M', 'ζ'), + (0x1D75C, 'M', 'η'), + (0x1D75D, 'M', 'θ'), + (0x1D75E, 'M', 'ι'), + (0x1D75F, 'M', 'κ'), + (0x1D760, 'M', 'λ'), + (0x1D761, 'M', 'μ'), + (0x1D762, 'M', 'ν'), + (0x1D763, 'M', 'ξ'), + (0x1D764, 'M', 'ο'), + (0x1D765, 'M', 'π'), + (0x1D766, 'M', 'ρ'), + (0x1D767, 'M', 'θ'), + (0x1D768, 'M', 'σ'), + (0x1D769, 'M', 'τ'), + (0x1D76A, 'M', 'υ'), + (0x1D76B, 'M', 'φ'), + (0x1D76C, 'M', 'χ'), + (0x1D76D, 'M', 'ψ'), + (0x1D76E, 'M', 'ω'), + (0x1D76F, 'M', '∇'), + (0x1D770, 'M', 'α'), + (0x1D771, 'M', 'β'), + (0x1D772, 'M', 'γ'), + (0x1D773, 'M', 'δ'), + (0x1D774, 'M', 'ε'), + (0x1D775, 'M', 'ζ'), + (0x1D776, 'M', 'η'), + (0x1D777, 'M', 'θ'), + (0x1D778, 'M', 'ι'), + (0x1D779, 'M', 'κ'), + (0x1D77A, 'M', 'λ'), + (0x1D77B, 'M', 'μ'), + (0x1D77C, 'M', 'ν'), + (0x1D77D, 'M', 'ξ'), + (0x1D77E, 'M', 'ο'), + (0x1D77F, 'M', 'π'), + (0x1D780, 'M', 'ρ'), + (0x1D781, 'M', 'σ'), + (0x1D783, 'M', 'τ'), + (0x1D784, 'M', 'υ'), + (0x1D785, 'M', 'φ'), + (0x1D786, 'M', 'χ'), + (0x1D787, 'M', 'ψ'), + (0x1D788, 'M', 'ω'), + (0x1D789, 'M', '∂'), + (0x1D78A, 'M', 'ε'), + (0x1D78B, 'M', 'θ'), + (0x1D78C, 'M', 'κ'), + (0x1D78D, 'M', 'φ'), + (0x1D78E, 'M', 'ρ'), + (0x1D78F, 'M', 'π'), + (0x1D790, 'M', 'α'), + (0x1D791, 'M', 'β'), + (0x1D792, 'M', 'γ'), + (0x1D793, 'M', 'δ'), + (0x1D794, 'M', 'ε'), + (0x1D795, 'M', 'ζ'), + (0x1D796, 'M', 'η'), + (0x1D797, 'M', 'θ'), + (0x1D798, 'M', 'ι'), + (0x1D799, 'M', 'κ'), + (0x1D79A, 'M', 'λ'), + (0x1D79B, 'M', 'μ'), + (0x1D79C, 'M', 'ν'), + (0x1D79D, 'M', 'ξ'), + (0x1D79E, 'M', 'ο'), + (0x1D79F, 'M', 'π'), + (0x1D7A0, 'M', 'ρ'), + (0x1D7A1, 'M', 'θ'), + (0x1D7A2, 'M', 'σ'), + (0x1D7A3, 'M', 'τ'), + (0x1D7A4, 'M', 'υ'), + (0x1D7A5, 'M', 'φ'), + (0x1D7A6, 'M', 'χ'), + (0x1D7A7, 'M', 'ψ'), + (0x1D7A8, 'M', 'ω'), + (0x1D7A9, 'M', '∇'), + (0x1D7AA, 'M', 'α'), + (0x1D7AB, 'M', 'β'), + (0x1D7AC, 'M', 'γ'), + (0x1D7AD, 'M', 'δ'), + (0x1D7AE, 'M', 'ε'), + (0x1D7AF, 'M', 'ζ'), + (0x1D7B0, 'M', 'η'), + (0x1D7B1, 'M', 'θ'), + (0x1D7B2, 'M', 'ι'), + (0x1D7B3, 'M', 'κ'), + ] + +def _seg_70() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1D7B4, 'M', 'λ'), + (0x1D7B5, 'M', 'μ'), + (0x1D7B6, 'M', 'ν'), + (0x1D7B7, 'M', 'ξ'), + (0x1D7B8, 'M', 'ο'), + (0x1D7B9, 'M', 'π'), + (0x1D7BA, 'M', 'ρ'), + (0x1D7BB, 'M', 'σ'), + (0x1D7BD, 'M', 'τ'), + (0x1D7BE, 'M', 'υ'), + (0x1D7BF, 'M', 'φ'), + (0x1D7C0, 'M', 'χ'), + (0x1D7C1, 'M', 'ψ'), + (0x1D7C2, 'M', 'ω'), + (0x1D7C3, 'M', '∂'), + (0x1D7C4, 'M', 'ε'), + (0x1D7C5, 'M', 'θ'), + (0x1D7C6, 'M', 'κ'), + (0x1D7C7, 'M', 'φ'), + (0x1D7C8, 'M', 'ρ'), + (0x1D7C9, 'M', 'π'), + (0x1D7CA, 'M', 'ϝ'), + (0x1D7CC, 'X'), + (0x1D7CE, 'M', '0'), + (0x1D7CF, 'M', '1'), + (0x1D7D0, 'M', '2'), + (0x1D7D1, 'M', '3'), + (0x1D7D2, 'M', '4'), + (0x1D7D3, 'M', '5'), + (0x1D7D4, 'M', '6'), + (0x1D7D5, 'M', '7'), + (0x1D7D6, 'M', '8'), + (0x1D7D7, 'M', '9'), + (0x1D7D8, 'M', '0'), + (0x1D7D9, 'M', '1'), + (0x1D7DA, 'M', '2'), + (0x1D7DB, 'M', '3'), + (0x1D7DC, 'M', '4'), + (0x1D7DD, 'M', '5'), + (0x1D7DE, 'M', '6'), + (0x1D7DF, 'M', '7'), + (0x1D7E0, 'M', '8'), + (0x1D7E1, 'M', '9'), + (0x1D7E2, 'M', '0'), + (0x1D7E3, 'M', '1'), + (0x1D7E4, 'M', '2'), + (0x1D7E5, 'M', '3'), + (0x1D7E6, 'M', '4'), + (0x1D7E7, 'M', '5'), + (0x1D7E8, 'M', '6'), + (0x1D7E9, 'M', '7'), + (0x1D7EA, 'M', '8'), + (0x1D7EB, 'M', '9'), + (0x1D7EC, 'M', '0'), + (0x1D7ED, 'M', '1'), + (0x1D7EE, 'M', '2'), + (0x1D7EF, 'M', '3'), + (0x1D7F0, 'M', '4'), + (0x1D7F1, 'M', '5'), + (0x1D7F2, 'M', '6'), + (0x1D7F3, 'M', '7'), + (0x1D7F4, 'M', '8'), + (0x1D7F5, 'M', '9'), + (0x1D7F6, 'M', '0'), + (0x1D7F7, 'M', '1'), + (0x1D7F8, 'M', '2'), + (0x1D7F9, 'M', '3'), + (0x1D7FA, 'M', '4'), + (0x1D7FB, 'M', '5'), + (0x1D7FC, 'M', '6'), + (0x1D7FD, 'M', '7'), + (0x1D7FE, 'M', '8'), + (0x1D7FF, 'M', '9'), + (0x1D800, 'V'), + (0x1DA8C, 'X'), + (0x1DA9B, 'V'), + (0x1DAA0, 'X'), + (0x1DAA1, 'V'), + (0x1DAB0, 'X'), + (0x1DF00, 'V'), + (0x1DF1F, 'X'), + (0x1DF25, 'V'), + (0x1DF2B, 'X'), + (0x1E000, 'V'), + (0x1E007, 'X'), + (0x1E008, 'V'), + (0x1E019, 'X'), + (0x1E01B, 'V'), + (0x1E022, 'X'), + (0x1E023, 'V'), + (0x1E025, 'X'), + (0x1E026, 'V'), + (0x1E02B, 'X'), + (0x1E030, 'M', 'а'), + (0x1E031, 'M', 'б'), + (0x1E032, 'M', 'в'), + (0x1E033, 'M', 'г'), + (0x1E034, 'M', 'д'), + (0x1E035, 'M', 'е'), + (0x1E036, 'M', 'ж'), + ] + +def _seg_71() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1E037, 'M', 'з'), + (0x1E038, 'M', 'и'), + (0x1E039, 'M', 'к'), + (0x1E03A, 'M', 'л'), + (0x1E03B, 'M', 'м'), + (0x1E03C, 'M', 'о'), + (0x1E03D, 'M', 'п'), + (0x1E03E, 'M', 'р'), + (0x1E03F, 'M', 'с'), + (0x1E040, 'M', 'т'), + (0x1E041, 'M', 'у'), + (0x1E042, 'M', 'ф'), + (0x1E043, 'M', 'х'), + (0x1E044, 'M', 'ц'), + (0x1E045, 'M', 'ч'), + (0x1E046, 'M', 'ш'), + (0x1E047, 'M', 'ы'), + (0x1E048, 'M', 'э'), + (0x1E049, 'M', 'ю'), + (0x1E04A, 'M', 'ꚉ'), + (0x1E04B, 'M', 'ә'), + (0x1E04C, 'M', 'і'), + (0x1E04D, 'M', 'ј'), + (0x1E04E, 'M', 'ө'), + (0x1E04F, 'M', 'ү'), + (0x1E050, 'M', 'ӏ'), + (0x1E051, 'M', 'а'), + (0x1E052, 'M', 'б'), + (0x1E053, 'M', 'в'), + (0x1E054, 'M', 'г'), + (0x1E055, 'M', 'д'), + (0x1E056, 'M', 'е'), + (0x1E057, 'M', 'ж'), + (0x1E058, 'M', 'з'), + (0x1E059, 'M', 'и'), + (0x1E05A, 'M', 'к'), + (0x1E05B, 'M', 'л'), + (0x1E05C, 'M', 'о'), + (0x1E05D, 'M', 'п'), + (0x1E05E, 'M', 'с'), + (0x1E05F, 'M', 'у'), + (0x1E060, 'M', 'ф'), + (0x1E061, 'M', 'х'), + (0x1E062, 'M', 'ц'), + (0x1E063, 'M', 'ч'), + (0x1E064, 'M', 'ш'), + (0x1E065, 'M', 'ъ'), + (0x1E066, 'M', 'ы'), + (0x1E067, 'M', 'ґ'), + (0x1E068, 'M', 'і'), + (0x1E069, 'M', 'ѕ'), + (0x1E06A, 'M', 'џ'), + (0x1E06B, 'M', 'ҫ'), + (0x1E06C, 'M', 'ꙑ'), + (0x1E06D, 'M', 'ұ'), + (0x1E06E, 'X'), + (0x1E08F, 'V'), + (0x1E090, 'X'), + (0x1E100, 'V'), + (0x1E12D, 'X'), + (0x1E130, 'V'), + (0x1E13E, 'X'), + (0x1E140, 'V'), + (0x1E14A, 'X'), + (0x1E14E, 'V'), + (0x1E150, 'X'), + (0x1E290, 'V'), + (0x1E2AF, 'X'), + (0x1E2C0, 'V'), + (0x1E2FA, 'X'), + (0x1E2FF, 'V'), + (0x1E300, 'X'), + (0x1E4D0, 'V'), + (0x1E4FA, 'X'), + (0x1E7E0, 'V'), + (0x1E7E7, 'X'), + (0x1E7E8, 'V'), + (0x1E7EC, 'X'), + (0x1E7ED, 'V'), + (0x1E7EF, 'X'), + (0x1E7F0, 'V'), + (0x1E7FF, 'X'), + (0x1E800, 'V'), + (0x1E8C5, 'X'), + (0x1E8C7, 'V'), + (0x1E8D7, 'X'), + (0x1E900, 'M', '𞤢'), + (0x1E901, 'M', '𞤣'), + (0x1E902, 'M', '𞤤'), + (0x1E903, 'M', '𞤥'), + (0x1E904, 'M', '𞤦'), + (0x1E905, 'M', '𞤧'), + (0x1E906, 'M', '𞤨'), + (0x1E907, 'M', '𞤩'), + (0x1E908, 'M', '𞤪'), + (0x1E909, 'M', '𞤫'), + (0x1E90A, 'M', '𞤬'), + (0x1E90B, 'M', '𞤭'), + (0x1E90C, 'M', '𞤮'), + (0x1E90D, 'M', '𞤯'), + ] + +def _seg_72() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1E90E, 'M', '𞤰'), + (0x1E90F, 'M', '𞤱'), + (0x1E910, 'M', '𞤲'), + (0x1E911, 'M', '𞤳'), + (0x1E912, 'M', '𞤴'), + (0x1E913, 'M', '𞤵'), + (0x1E914, 'M', '𞤶'), + (0x1E915, 'M', '𞤷'), + (0x1E916, 'M', '𞤸'), + (0x1E917, 'M', '𞤹'), + (0x1E918, 'M', '𞤺'), + (0x1E919, 'M', '𞤻'), + (0x1E91A, 'M', '𞤼'), + (0x1E91B, 'M', '𞤽'), + (0x1E91C, 'M', '𞤾'), + (0x1E91D, 'M', '𞤿'), + (0x1E91E, 'M', '𞥀'), + (0x1E91F, 'M', '𞥁'), + (0x1E920, 'M', '𞥂'), + (0x1E921, 'M', '𞥃'), + (0x1E922, 'V'), + (0x1E94C, 'X'), + (0x1E950, 'V'), + (0x1E95A, 'X'), + (0x1E95E, 'V'), + (0x1E960, 'X'), + (0x1EC71, 'V'), + (0x1ECB5, 'X'), + (0x1ED01, 'V'), + (0x1ED3E, 'X'), + (0x1EE00, 'M', 'ا'), + (0x1EE01, 'M', 'ب'), + (0x1EE02, 'M', 'ج'), + (0x1EE03, 'M', 'د'), + (0x1EE04, 'X'), + (0x1EE05, 'M', 'و'), + (0x1EE06, 'M', 'ز'), + (0x1EE07, 'M', 'ح'), + (0x1EE08, 'M', 'ط'), + (0x1EE09, 'M', 'ي'), + (0x1EE0A, 'M', 'ك'), + (0x1EE0B, 'M', 'ل'), + (0x1EE0C, 'M', 'م'), + (0x1EE0D, 'M', 'ن'), + (0x1EE0E, 'M', 'س'), + (0x1EE0F, 'M', 'ع'), + (0x1EE10, 'M', 'ف'), + (0x1EE11, 'M', 'ص'), + (0x1EE12, 'M', 'ق'), + (0x1EE13, 'M', 'ر'), + (0x1EE14, 'M', 'ش'), + (0x1EE15, 'M', 'ت'), + (0x1EE16, 'M', 'ث'), + (0x1EE17, 'M', 'خ'), + (0x1EE18, 'M', 'ذ'), + (0x1EE19, 'M', 'ض'), + (0x1EE1A, 'M', 'ظ'), + (0x1EE1B, 'M', 'غ'), + (0x1EE1C, 'M', 'ٮ'), + (0x1EE1D, 'M', 'ں'), + (0x1EE1E, 'M', 'ڡ'), + (0x1EE1F, 'M', 'ٯ'), + (0x1EE20, 'X'), + (0x1EE21, 'M', 'ب'), + (0x1EE22, 'M', 'ج'), + (0x1EE23, 'X'), + (0x1EE24, 'M', 'ه'), + (0x1EE25, 'X'), + (0x1EE27, 'M', 'ح'), + (0x1EE28, 'X'), + (0x1EE29, 'M', 'ي'), + (0x1EE2A, 'M', 'ك'), + (0x1EE2B, 'M', 'ل'), + (0x1EE2C, 'M', 'م'), + (0x1EE2D, 'M', 'ن'), + (0x1EE2E, 'M', 'س'), + (0x1EE2F, 'M', 'ع'), + (0x1EE30, 'M', 'ف'), + (0x1EE31, 'M', 'ص'), + (0x1EE32, 'M', 'ق'), + (0x1EE33, 'X'), + (0x1EE34, 'M', 'ش'), + (0x1EE35, 'M', 'ت'), + (0x1EE36, 'M', 'ث'), + (0x1EE37, 'M', 'خ'), + (0x1EE38, 'X'), + (0x1EE39, 'M', 'ض'), + (0x1EE3A, 'X'), + (0x1EE3B, 'M', 'غ'), + (0x1EE3C, 'X'), + (0x1EE42, 'M', 'ج'), + (0x1EE43, 'X'), + (0x1EE47, 'M', 'ح'), + (0x1EE48, 'X'), + (0x1EE49, 'M', 'ي'), + (0x1EE4A, 'X'), + (0x1EE4B, 'M', 'ل'), + (0x1EE4C, 'X'), + (0x1EE4D, 'M', 'ن'), + (0x1EE4E, 'M', 'س'), + ] + +def _seg_73() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1EE4F, 'M', 'ع'), + (0x1EE50, 'X'), + (0x1EE51, 'M', 'ص'), + (0x1EE52, 'M', 'ق'), + (0x1EE53, 'X'), + (0x1EE54, 'M', 'ش'), + (0x1EE55, 'X'), + (0x1EE57, 'M', 'خ'), + (0x1EE58, 'X'), + (0x1EE59, 'M', 'ض'), + (0x1EE5A, 'X'), + (0x1EE5B, 'M', 'غ'), + (0x1EE5C, 'X'), + (0x1EE5D, 'M', 'ں'), + (0x1EE5E, 'X'), + (0x1EE5F, 'M', 'ٯ'), + (0x1EE60, 'X'), + (0x1EE61, 'M', 'ب'), + (0x1EE62, 'M', 'ج'), + (0x1EE63, 'X'), + (0x1EE64, 'M', 'ه'), + (0x1EE65, 'X'), + (0x1EE67, 'M', 'ح'), + (0x1EE68, 'M', 'ط'), + (0x1EE69, 'M', 'ي'), + (0x1EE6A, 'M', 'ك'), + (0x1EE6B, 'X'), + (0x1EE6C, 'M', 'م'), + (0x1EE6D, 'M', 'ن'), + (0x1EE6E, 'M', 'س'), + (0x1EE6F, 'M', 'ع'), + (0x1EE70, 'M', 'ف'), + (0x1EE71, 'M', 'ص'), + (0x1EE72, 'M', 'ق'), + (0x1EE73, 'X'), + (0x1EE74, 'M', 'ش'), + (0x1EE75, 'M', 'ت'), + (0x1EE76, 'M', 'ث'), + (0x1EE77, 'M', 'خ'), + (0x1EE78, 'X'), + (0x1EE79, 'M', 'ض'), + (0x1EE7A, 'M', 'ظ'), + (0x1EE7B, 'M', 'غ'), + (0x1EE7C, 'M', 'ٮ'), + (0x1EE7D, 'X'), + (0x1EE7E, 'M', 'ڡ'), + (0x1EE7F, 'X'), + (0x1EE80, 'M', 'ا'), + (0x1EE81, 'M', 'ب'), + (0x1EE82, 'M', 'ج'), + (0x1EE83, 'M', 'د'), + (0x1EE84, 'M', 'ه'), + (0x1EE85, 'M', 'و'), + (0x1EE86, 'M', 'ز'), + (0x1EE87, 'M', 'ح'), + (0x1EE88, 'M', 'ط'), + (0x1EE89, 'M', 'ي'), + (0x1EE8A, 'X'), + (0x1EE8B, 'M', 'ل'), + (0x1EE8C, 'M', 'م'), + (0x1EE8D, 'M', 'ن'), + (0x1EE8E, 'M', 'س'), + (0x1EE8F, 'M', 'ع'), + (0x1EE90, 'M', 'ف'), + (0x1EE91, 'M', 'ص'), + (0x1EE92, 'M', 'ق'), + (0x1EE93, 'M', 'ر'), + (0x1EE94, 'M', 'ش'), + (0x1EE95, 'M', 'ت'), + (0x1EE96, 'M', 'ث'), + (0x1EE97, 'M', 'خ'), + (0x1EE98, 'M', 'ذ'), + (0x1EE99, 'M', 'ض'), + (0x1EE9A, 'M', 'ظ'), + (0x1EE9B, 'M', 'غ'), + (0x1EE9C, 'X'), + (0x1EEA1, 'M', 'ب'), + (0x1EEA2, 'M', 'ج'), + (0x1EEA3, 'M', 'د'), + (0x1EEA4, 'X'), + (0x1EEA5, 'M', 'و'), + (0x1EEA6, 'M', 'ز'), + (0x1EEA7, 'M', 'ح'), + (0x1EEA8, 'M', 'ط'), + (0x1EEA9, 'M', 'ي'), + (0x1EEAA, 'X'), + (0x1EEAB, 'M', 'ل'), + (0x1EEAC, 'M', 'م'), + (0x1EEAD, 'M', 'ن'), + (0x1EEAE, 'M', 'س'), + (0x1EEAF, 'M', 'ع'), + (0x1EEB0, 'M', 'ف'), + (0x1EEB1, 'M', 'ص'), + (0x1EEB2, 'M', 'ق'), + (0x1EEB3, 'M', 'ر'), + (0x1EEB4, 'M', 'ش'), + (0x1EEB5, 'M', 'ت'), + (0x1EEB6, 'M', 'ث'), + (0x1EEB7, 'M', 'خ'), + (0x1EEB8, 'M', 'ذ'), + ] + +def _seg_74() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1EEB9, 'M', 'ض'), + (0x1EEBA, 'M', 'ظ'), + (0x1EEBB, 'M', 'غ'), + (0x1EEBC, 'X'), + (0x1EEF0, 'V'), + (0x1EEF2, 'X'), + (0x1F000, 'V'), + (0x1F02C, 'X'), + (0x1F030, 'V'), + (0x1F094, 'X'), + (0x1F0A0, 'V'), + (0x1F0AF, 'X'), + (0x1F0B1, 'V'), + (0x1F0C0, 'X'), + (0x1F0C1, 'V'), + (0x1F0D0, 'X'), + (0x1F0D1, 'V'), + (0x1F0F6, 'X'), + (0x1F101, '3', '0,'), + (0x1F102, '3', '1,'), + (0x1F103, '3', '2,'), + (0x1F104, '3', '3,'), + (0x1F105, '3', '4,'), + (0x1F106, '3', '5,'), + (0x1F107, '3', '6,'), + (0x1F108, '3', '7,'), + (0x1F109, '3', '8,'), + (0x1F10A, '3', '9,'), + (0x1F10B, 'V'), + (0x1F110, '3', '(a)'), + (0x1F111, '3', '(b)'), + (0x1F112, '3', '(c)'), + (0x1F113, '3', '(d)'), + (0x1F114, '3', '(e)'), + (0x1F115, '3', '(f)'), + (0x1F116, '3', '(g)'), + (0x1F117, '3', '(h)'), + (0x1F118, '3', '(i)'), + (0x1F119, '3', '(j)'), + (0x1F11A, '3', '(k)'), + (0x1F11B, '3', '(l)'), + (0x1F11C, '3', '(m)'), + (0x1F11D, '3', '(n)'), + (0x1F11E, '3', '(o)'), + (0x1F11F, '3', '(p)'), + (0x1F120, '3', '(q)'), + (0x1F121, '3', '(r)'), + (0x1F122, '3', '(s)'), + (0x1F123, '3', '(t)'), + (0x1F124, '3', '(u)'), + (0x1F125, '3', '(v)'), + (0x1F126, '3', '(w)'), + (0x1F127, '3', '(x)'), + (0x1F128, '3', '(y)'), + (0x1F129, '3', '(z)'), + (0x1F12A, 'M', '〔s〕'), + (0x1F12B, 'M', 'c'), + (0x1F12C, 'M', 'r'), + (0x1F12D, 'M', 'cd'), + (0x1F12E, 'M', 'wz'), + (0x1F12F, 'V'), + (0x1F130, 'M', 'a'), + (0x1F131, 'M', 'b'), + (0x1F132, 'M', 'c'), + (0x1F133, 'M', 'd'), + (0x1F134, 'M', 'e'), + (0x1F135, 'M', 'f'), + (0x1F136, 'M', 'g'), + (0x1F137, 'M', 'h'), + (0x1F138, 'M', 'i'), + (0x1F139, 'M', 'j'), + (0x1F13A, 'M', 'k'), + (0x1F13B, 'M', 'l'), + (0x1F13C, 'M', 'm'), + (0x1F13D, 'M', 'n'), + (0x1F13E, 'M', 'o'), + (0x1F13F, 'M', 'p'), + (0x1F140, 'M', 'q'), + (0x1F141, 'M', 'r'), + (0x1F142, 'M', 's'), + (0x1F143, 'M', 't'), + (0x1F144, 'M', 'u'), + (0x1F145, 'M', 'v'), + (0x1F146, 'M', 'w'), + (0x1F147, 'M', 'x'), + (0x1F148, 'M', 'y'), + (0x1F149, 'M', 'z'), + (0x1F14A, 'M', 'hv'), + (0x1F14B, 'M', 'mv'), + (0x1F14C, 'M', 'sd'), + (0x1F14D, 'M', 'ss'), + (0x1F14E, 'M', 'ppv'), + (0x1F14F, 'M', 'wc'), + (0x1F150, 'V'), + (0x1F16A, 'M', 'mc'), + (0x1F16B, 'M', 'md'), + (0x1F16C, 'M', 'mr'), + (0x1F16D, 'V'), + (0x1F190, 'M', 'dj'), + (0x1F191, 'V'), + ] + +def _seg_75() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1F1AE, 'X'), + (0x1F1E6, 'V'), + (0x1F200, 'M', 'ほか'), + (0x1F201, 'M', 'ココ'), + (0x1F202, 'M', 'サ'), + (0x1F203, 'X'), + (0x1F210, 'M', '手'), + (0x1F211, 'M', '字'), + (0x1F212, 'M', '双'), + (0x1F213, 'M', 'デ'), + (0x1F214, 'M', '二'), + (0x1F215, 'M', '多'), + (0x1F216, 'M', '解'), + (0x1F217, 'M', '天'), + (0x1F218, 'M', '交'), + (0x1F219, 'M', '映'), + (0x1F21A, 'M', '無'), + (0x1F21B, 'M', '料'), + (0x1F21C, 'M', '前'), + (0x1F21D, 'M', '後'), + (0x1F21E, 'M', '再'), + (0x1F21F, 'M', '新'), + (0x1F220, 'M', '初'), + (0x1F221, 'M', '終'), + (0x1F222, 'M', '生'), + (0x1F223, 'M', '販'), + (0x1F224, 'M', '声'), + (0x1F225, 'M', '吹'), + (0x1F226, 'M', '演'), + (0x1F227, 'M', '投'), + (0x1F228, 'M', '捕'), + (0x1F229, 'M', '一'), + (0x1F22A, 'M', '三'), + (0x1F22B, 'M', '遊'), + (0x1F22C, 'M', '左'), + (0x1F22D, 'M', '中'), + (0x1F22E, 'M', '右'), + (0x1F22F, 'M', '指'), + (0x1F230, 'M', '走'), + (0x1F231, 'M', '打'), + (0x1F232, 'M', '禁'), + (0x1F233, 'M', '空'), + (0x1F234, 'M', '合'), + (0x1F235, 'M', '満'), + (0x1F236, 'M', '有'), + (0x1F237, 'M', '月'), + (0x1F238, 'M', '申'), + (0x1F239, 'M', '割'), + (0x1F23A, 'M', '営'), + (0x1F23B, 'M', '配'), + (0x1F23C, 'X'), + (0x1F240, 'M', '〔本〕'), + (0x1F241, 'M', '〔三〕'), + (0x1F242, 'M', '〔二〕'), + (0x1F243, 'M', '〔安〕'), + (0x1F244, 'M', '〔点〕'), + (0x1F245, 'M', '〔打〕'), + (0x1F246, 'M', '〔盗〕'), + (0x1F247, 'M', '〔勝〕'), + (0x1F248, 'M', '〔敗〕'), + (0x1F249, 'X'), + (0x1F250, 'M', '得'), + (0x1F251, 'M', '可'), + (0x1F252, 'X'), + (0x1F260, 'V'), + (0x1F266, 'X'), + (0x1F300, 'V'), + (0x1F6D8, 'X'), + (0x1F6DC, 'V'), + (0x1F6ED, 'X'), + (0x1F6F0, 'V'), + (0x1F6FD, 'X'), + (0x1F700, 'V'), + (0x1F777, 'X'), + (0x1F77B, 'V'), + (0x1F7DA, 'X'), + (0x1F7E0, 'V'), + (0x1F7EC, 'X'), + (0x1F7F0, 'V'), + (0x1F7F1, 'X'), + (0x1F800, 'V'), + (0x1F80C, 'X'), + (0x1F810, 'V'), + (0x1F848, 'X'), + (0x1F850, 'V'), + (0x1F85A, 'X'), + (0x1F860, 'V'), + (0x1F888, 'X'), + (0x1F890, 'V'), + (0x1F8AE, 'X'), + (0x1F8B0, 'V'), + (0x1F8B2, 'X'), + (0x1F900, 'V'), + (0x1FA54, 'X'), + (0x1FA60, 'V'), + (0x1FA6E, 'X'), + (0x1FA70, 'V'), + (0x1FA7D, 'X'), + (0x1FA80, 'V'), + (0x1FA89, 'X'), + ] + +def _seg_76() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x1FA90, 'V'), + (0x1FABE, 'X'), + (0x1FABF, 'V'), + (0x1FAC6, 'X'), + (0x1FACE, 'V'), + (0x1FADC, 'X'), + (0x1FAE0, 'V'), + (0x1FAE9, 'X'), + (0x1FAF0, 'V'), + (0x1FAF9, 'X'), + (0x1FB00, 'V'), + (0x1FB93, 'X'), + (0x1FB94, 'V'), + (0x1FBCB, 'X'), + (0x1FBF0, 'M', '0'), + (0x1FBF1, 'M', '1'), + (0x1FBF2, 'M', '2'), + (0x1FBF3, 'M', '3'), + (0x1FBF4, 'M', '4'), + (0x1FBF5, 'M', '5'), + (0x1FBF6, 'M', '6'), + (0x1FBF7, 'M', '7'), + (0x1FBF8, 'M', '8'), + (0x1FBF9, 'M', '9'), + (0x1FBFA, 'X'), + (0x20000, 'V'), + (0x2A6E0, 'X'), + (0x2A700, 'V'), + (0x2B73A, 'X'), + (0x2B740, 'V'), + (0x2B81E, 'X'), + (0x2B820, 'V'), + (0x2CEA2, 'X'), + (0x2CEB0, 'V'), + (0x2EBE1, 'X'), + (0x2EBF0, 'V'), + (0x2EE5E, 'X'), + (0x2F800, 'M', '丽'), + (0x2F801, 'M', '丸'), + (0x2F802, 'M', '乁'), + (0x2F803, 'M', '𠄢'), + (0x2F804, 'M', '你'), + (0x2F805, 'M', '侮'), + (0x2F806, 'M', '侻'), + (0x2F807, 'M', '倂'), + (0x2F808, 'M', '偺'), + (0x2F809, 'M', '備'), + (0x2F80A, 'M', '僧'), + (0x2F80B, 'M', '像'), + (0x2F80C, 'M', '㒞'), + (0x2F80D, 'M', '𠘺'), + (0x2F80E, 'M', '免'), + (0x2F80F, 'M', '兔'), + (0x2F810, 'M', '兤'), + (0x2F811, 'M', '具'), + (0x2F812, 'M', '𠔜'), + (0x2F813, 'M', '㒹'), + (0x2F814, 'M', '內'), + (0x2F815, 'M', '再'), + (0x2F816, 'M', '𠕋'), + (0x2F817, 'M', '冗'), + (0x2F818, 'M', '冤'), + (0x2F819, 'M', '仌'), + (0x2F81A, 'M', '冬'), + (0x2F81B, 'M', '况'), + (0x2F81C, 'M', '𩇟'), + (0x2F81D, 'M', '凵'), + (0x2F81E, 'M', '刃'), + (0x2F81F, 'M', '㓟'), + (0x2F820, 'M', '刻'), + (0x2F821, 'M', '剆'), + (0x2F822, 'M', '割'), + (0x2F823, 'M', '剷'), + (0x2F824, 'M', '㔕'), + (0x2F825, 'M', '勇'), + (0x2F826, 'M', '勉'), + (0x2F827, 'M', '勤'), + (0x2F828, 'M', '勺'), + (0x2F829, 'M', '包'), + (0x2F82A, 'M', '匆'), + (0x2F82B, 'M', '北'), + (0x2F82C, 'M', '卉'), + (0x2F82D, 'M', '卑'), + (0x2F82E, 'M', '博'), + (0x2F82F, 'M', '即'), + (0x2F830, 'M', '卽'), + (0x2F831, 'M', '卿'), + (0x2F834, 'M', '𠨬'), + (0x2F835, 'M', '灰'), + (0x2F836, 'M', '及'), + (0x2F837, 'M', '叟'), + (0x2F838, 'M', '𠭣'), + (0x2F839, 'M', '叫'), + (0x2F83A, 'M', '叱'), + (0x2F83B, 'M', '吆'), + (0x2F83C, 'M', '咞'), + (0x2F83D, 'M', '吸'), + (0x2F83E, 'M', '呈'), + (0x2F83F, 'M', '周'), + (0x2F840, 'M', '咢'), + ] + +def _seg_77() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x2F841, 'M', '哶'), + (0x2F842, 'M', '唐'), + (0x2F843, 'M', '啓'), + (0x2F844, 'M', '啣'), + (0x2F845, 'M', '善'), + (0x2F847, 'M', '喙'), + (0x2F848, 'M', '喫'), + (0x2F849, 'M', '喳'), + (0x2F84A, 'M', '嗂'), + (0x2F84B, 'M', '圖'), + (0x2F84C, 'M', '嘆'), + (0x2F84D, 'M', '圗'), + (0x2F84E, 'M', '噑'), + (0x2F84F, 'M', '噴'), + (0x2F850, 'M', '切'), + (0x2F851, 'M', '壮'), + (0x2F852, 'M', '城'), + (0x2F853, 'M', '埴'), + (0x2F854, 'M', '堍'), + (0x2F855, 'M', '型'), + (0x2F856, 'M', '堲'), + (0x2F857, 'M', '報'), + (0x2F858, 'M', '墬'), + (0x2F859, 'M', '𡓤'), + (0x2F85A, 'M', '売'), + (0x2F85B, 'M', '壷'), + (0x2F85C, 'M', '夆'), + (0x2F85D, 'M', '多'), + (0x2F85E, 'M', '夢'), + (0x2F85F, 'M', '奢'), + (0x2F860, 'M', '𡚨'), + (0x2F861, 'M', '𡛪'), + (0x2F862, 'M', '姬'), + (0x2F863, 'M', '娛'), + (0x2F864, 'M', '娧'), + (0x2F865, 'M', '姘'), + (0x2F866, 'M', '婦'), + (0x2F867, 'M', '㛮'), + (0x2F868, 'X'), + (0x2F869, 'M', '嬈'), + (0x2F86A, 'M', '嬾'), + (0x2F86C, 'M', '𡧈'), + (0x2F86D, 'M', '寃'), + (0x2F86E, 'M', '寘'), + (0x2F86F, 'M', '寧'), + (0x2F870, 'M', '寳'), + (0x2F871, 'M', '𡬘'), + (0x2F872, 'M', '寿'), + (0x2F873, 'M', '将'), + (0x2F874, 'X'), + (0x2F875, 'M', '尢'), + (0x2F876, 'M', '㞁'), + (0x2F877, 'M', '屠'), + (0x2F878, 'M', '屮'), + (0x2F879, 'M', '峀'), + (0x2F87A, 'M', '岍'), + (0x2F87B, 'M', '𡷤'), + (0x2F87C, 'M', '嵃'), + (0x2F87D, 'M', '𡷦'), + (0x2F87E, 'M', '嵮'), + (0x2F87F, 'M', '嵫'), + (0x2F880, 'M', '嵼'), + (0x2F881, 'M', '巡'), + (0x2F882, 'M', '巢'), + (0x2F883, 'M', '㠯'), + (0x2F884, 'M', '巽'), + (0x2F885, 'M', '帨'), + (0x2F886, 'M', '帽'), + (0x2F887, 'M', '幩'), + (0x2F888, 'M', '㡢'), + (0x2F889, 'M', '𢆃'), + (0x2F88A, 'M', '㡼'), + (0x2F88B, 'M', '庰'), + (0x2F88C, 'M', '庳'), + (0x2F88D, 'M', '庶'), + (0x2F88E, 'M', '廊'), + (0x2F88F, 'M', '𪎒'), + (0x2F890, 'M', '廾'), + (0x2F891, 'M', '𢌱'), + (0x2F893, 'M', '舁'), + (0x2F894, 'M', '弢'), + (0x2F896, 'M', '㣇'), + (0x2F897, 'M', '𣊸'), + (0x2F898, 'M', '𦇚'), + (0x2F899, 'M', '形'), + (0x2F89A, 'M', '彫'), + (0x2F89B, 'M', '㣣'), + (0x2F89C, 'M', '徚'), + (0x2F89D, 'M', '忍'), + (0x2F89E, 'M', '志'), + (0x2F89F, 'M', '忹'), + (0x2F8A0, 'M', '悁'), + (0x2F8A1, 'M', '㤺'), + (0x2F8A2, 'M', '㤜'), + (0x2F8A3, 'M', '悔'), + (0x2F8A4, 'M', '𢛔'), + (0x2F8A5, 'M', '惇'), + (0x2F8A6, 'M', '慈'), + (0x2F8A7, 'M', '慌'), + (0x2F8A8, 'M', '慎'), + ] + +def _seg_78() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x2F8A9, 'M', '慌'), + (0x2F8AA, 'M', '慺'), + (0x2F8AB, 'M', '憎'), + (0x2F8AC, 'M', '憲'), + (0x2F8AD, 'M', '憤'), + (0x2F8AE, 'M', '憯'), + (0x2F8AF, 'M', '懞'), + (0x2F8B0, 'M', '懲'), + (0x2F8B1, 'M', '懶'), + (0x2F8B2, 'M', '成'), + (0x2F8B3, 'M', '戛'), + (0x2F8B4, 'M', '扝'), + (0x2F8B5, 'M', '抱'), + (0x2F8B6, 'M', '拔'), + (0x2F8B7, 'M', '捐'), + (0x2F8B8, 'M', '𢬌'), + (0x2F8B9, 'M', '挽'), + (0x2F8BA, 'M', '拼'), + (0x2F8BB, 'M', '捨'), + (0x2F8BC, 'M', '掃'), + (0x2F8BD, 'M', '揤'), + (0x2F8BE, 'M', '𢯱'), + (0x2F8BF, 'M', '搢'), + (0x2F8C0, 'M', '揅'), + (0x2F8C1, 'M', '掩'), + (0x2F8C2, 'M', '㨮'), + (0x2F8C3, 'M', '摩'), + (0x2F8C4, 'M', '摾'), + (0x2F8C5, 'M', '撝'), + (0x2F8C6, 'M', '摷'), + (0x2F8C7, 'M', '㩬'), + (0x2F8C8, 'M', '敏'), + (0x2F8C9, 'M', '敬'), + (0x2F8CA, 'M', '𣀊'), + (0x2F8CB, 'M', '旣'), + (0x2F8CC, 'M', '書'), + (0x2F8CD, 'M', '晉'), + (0x2F8CE, 'M', '㬙'), + (0x2F8CF, 'M', '暑'), + (0x2F8D0, 'M', '㬈'), + (0x2F8D1, 'M', '㫤'), + (0x2F8D2, 'M', '冒'), + (0x2F8D3, 'M', '冕'), + (0x2F8D4, 'M', '最'), + (0x2F8D5, 'M', '暜'), + (0x2F8D6, 'M', '肭'), + (0x2F8D7, 'M', '䏙'), + (0x2F8D8, 'M', '朗'), + (0x2F8D9, 'M', '望'), + (0x2F8DA, 'M', '朡'), + (0x2F8DB, 'M', '杞'), + (0x2F8DC, 'M', '杓'), + (0x2F8DD, 'M', '𣏃'), + (0x2F8DE, 'M', '㭉'), + (0x2F8DF, 'M', '柺'), + (0x2F8E0, 'M', '枅'), + (0x2F8E1, 'M', '桒'), + (0x2F8E2, 'M', '梅'), + (0x2F8E3, 'M', '𣑭'), + (0x2F8E4, 'M', '梎'), + (0x2F8E5, 'M', '栟'), + (0x2F8E6, 'M', '椔'), + (0x2F8E7, 'M', '㮝'), + (0x2F8E8, 'M', '楂'), + (0x2F8E9, 'M', '榣'), + (0x2F8EA, 'M', '槪'), + (0x2F8EB, 'M', '檨'), + (0x2F8EC, 'M', '𣚣'), + (0x2F8ED, 'M', '櫛'), + (0x2F8EE, 'M', '㰘'), + (0x2F8EF, 'M', '次'), + (0x2F8F0, 'M', '𣢧'), + (0x2F8F1, 'M', '歔'), + (0x2F8F2, 'M', '㱎'), + (0x2F8F3, 'M', '歲'), + (0x2F8F4, 'M', '殟'), + (0x2F8F5, 'M', '殺'), + (0x2F8F6, 'M', '殻'), + (0x2F8F7, 'M', '𣪍'), + (0x2F8F8, 'M', '𡴋'), + (0x2F8F9, 'M', '𣫺'), + (0x2F8FA, 'M', '汎'), + (0x2F8FB, 'M', '𣲼'), + (0x2F8FC, 'M', '沿'), + (0x2F8FD, 'M', '泍'), + (0x2F8FE, 'M', '汧'), + (0x2F8FF, 'M', '洖'), + (0x2F900, 'M', '派'), + (0x2F901, 'M', '海'), + (0x2F902, 'M', '流'), + (0x2F903, 'M', '浩'), + (0x2F904, 'M', '浸'), + (0x2F905, 'M', '涅'), + (0x2F906, 'M', '𣴞'), + (0x2F907, 'M', '洴'), + (0x2F908, 'M', '港'), + (0x2F909, 'M', '湮'), + (0x2F90A, 'M', '㴳'), + (0x2F90B, 'M', '滋'), + (0x2F90C, 'M', '滇'), + ] + +def _seg_79() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x2F90D, 'M', '𣻑'), + (0x2F90E, 'M', '淹'), + (0x2F90F, 'M', '潮'), + (0x2F910, 'M', '𣽞'), + (0x2F911, 'M', '𣾎'), + (0x2F912, 'M', '濆'), + (0x2F913, 'M', '瀹'), + (0x2F914, 'M', '瀞'), + (0x2F915, 'M', '瀛'), + (0x2F916, 'M', '㶖'), + (0x2F917, 'M', '灊'), + (0x2F918, 'M', '災'), + (0x2F919, 'M', '灷'), + (0x2F91A, 'M', '炭'), + (0x2F91B, 'M', '𠔥'), + (0x2F91C, 'M', '煅'), + (0x2F91D, 'M', '𤉣'), + (0x2F91E, 'M', '熜'), + (0x2F91F, 'X'), + (0x2F920, 'M', '爨'), + (0x2F921, 'M', '爵'), + (0x2F922, 'M', '牐'), + (0x2F923, 'M', '𤘈'), + (0x2F924, 'M', '犀'), + (0x2F925, 'M', '犕'), + (0x2F926, 'M', '𤜵'), + (0x2F927, 'M', '𤠔'), + (0x2F928, 'M', '獺'), + (0x2F929, 'M', '王'), + (0x2F92A, 'M', '㺬'), + (0x2F92B, 'M', '玥'), + (0x2F92C, 'M', '㺸'), + (0x2F92E, 'M', '瑇'), + (0x2F92F, 'M', '瑜'), + (0x2F930, 'M', '瑱'), + (0x2F931, 'M', '璅'), + (0x2F932, 'M', '瓊'), + (0x2F933, 'M', '㼛'), + (0x2F934, 'M', '甤'), + (0x2F935, 'M', '𤰶'), + (0x2F936, 'M', '甾'), + (0x2F937, 'M', '𤲒'), + (0x2F938, 'M', '異'), + (0x2F939, 'M', '𢆟'), + (0x2F93A, 'M', '瘐'), + (0x2F93B, 'M', '𤾡'), + (0x2F93C, 'M', '𤾸'), + (0x2F93D, 'M', '𥁄'), + (0x2F93E, 'M', '㿼'), + (0x2F93F, 'M', '䀈'), + (0x2F940, 'M', '直'), + (0x2F941, 'M', '𥃳'), + (0x2F942, 'M', '𥃲'), + (0x2F943, 'M', '𥄙'), + (0x2F944, 'M', '𥄳'), + (0x2F945, 'M', '眞'), + (0x2F946, 'M', '真'), + (0x2F948, 'M', '睊'), + (0x2F949, 'M', '䀹'), + (0x2F94A, 'M', '瞋'), + (0x2F94B, 'M', '䁆'), + (0x2F94C, 'M', '䂖'), + (0x2F94D, 'M', '𥐝'), + (0x2F94E, 'M', '硎'), + (0x2F94F, 'M', '碌'), + (0x2F950, 'M', '磌'), + (0x2F951, 'M', '䃣'), + (0x2F952, 'M', '𥘦'), + (0x2F953, 'M', '祖'), + (0x2F954, 'M', '𥚚'), + (0x2F955, 'M', '𥛅'), + (0x2F956, 'M', '福'), + (0x2F957, 'M', '秫'), + (0x2F958, 'M', '䄯'), + (0x2F959, 'M', '穀'), + (0x2F95A, 'M', '穊'), + (0x2F95B, 'M', '穏'), + (0x2F95C, 'M', '𥥼'), + (0x2F95D, 'M', '𥪧'), + (0x2F95F, 'X'), + (0x2F960, 'M', '䈂'), + (0x2F961, 'M', '𥮫'), + (0x2F962, 'M', '篆'), + (0x2F963, 'M', '築'), + (0x2F964, 'M', '䈧'), + (0x2F965, 'M', '𥲀'), + (0x2F966, 'M', '糒'), + (0x2F967, 'M', '䊠'), + (0x2F968, 'M', '糨'), + (0x2F969, 'M', '糣'), + (0x2F96A, 'M', '紀'), + (0x2F96B, 'M', '𥾆'), + (0x2F96C, 'M', '絣'), + (0x2F96D, 'M', '䌁'), + (0x2F96E, 'M', '緇'), + (0x2F96F, 'M', '縂'), + (0x2F970, 'M', '繅'), + (0x2F971, 'M', '䌴'), + (0x2F972, 'M', '𦈨'), + (0x2F973, 'M', '𦉇'), + ] + +def _seg_80() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x2F974, 'M', '䍙'), + (0x2F975, 'M', '𦋙'), + (0x2F976, 'M', '罺'), + (0x2F977, 'M', '𦌾'), + (0x2F978, 'M', '羕'), + (0x2F979, 'M', '翺'), + (0x2F97A, 'M', '者'), + (0x2F97B, 'M', '𦓚'), + (0x2F97C, 'M', '𦔣'), + (0x2F97D, 'M', '聠'), + (0x2F97E, 'M', '𦖨'), + (0x2F97F, 'M', '聰'), + (0x2F980, 'M', '𣍟'), + (0x2F981, 'M', '䏕'), + (0x2F982, 'M', '育'), + (0x2F983, 'M', '脃'), + (0x2F984, 'M', '䐋'), + (0x2F985, 'M', '脾'), + (0x2F986, 'M', '媵'), + (0x2F987, 'M', '𦞧'), + (0x2F988, 'M', '𦞵'), + (0x2F989, 'M', '𣎓'), + (0x2F98A, 'M', '𣎜'), + (0x2F98B, 'M', '舁'), + (0x2F98C, 'M', '舄'), + (0x2F98D, 'M', '辞'), + (0x2F98E, 'M', '䑫'), + (0x2F98F, 'M', '芑'), + (0x2F990, 'M', '芋'), + (0x2F991, 'M', '芝'), + (0x2F992, 'M', '劳'), + (0x2F993, 'M', '花'), + (0x2F994, 'M', '芳'), + (0x2F995, 'M', '芽'), + (0x2F996, 'M', '苦'), + (0x2F997, 'M', '𦬼'), + (0x2F998, 'M', '若'), + (0x2F999, 'M', '茝'), + (0x2F99A, 'M', '荣'), + (0x2F99B, 'M', '莭'), + (0x2F99C, 'M', '茣'), + (0x2F99D, 'M', '莽'), + (0x2F99E, 'M', '菧'), + (0x2F99F, 'M', '著'), + (0x2F9A0, 'M', '荓'), + (0x2F9A1, 'M', '菊'), + (0x2F9A2, 'M', '菌'), + (0x2F9A3, 'M', '菜'), + (0x2F9A4, 'M', '𦰶'), + (0x2F9A5, 'M', '𦵫'), + (0x2F9A6, 'M', '𦳕'), + (0x2F9A7, 'M', '䔫'), + (0x2F9A8, 'M', '蓱'), + (0x2F9A9, 'M', '蓳'), + (0x2F9AA, 'M', '蔖'), + (0x2F9AB, 'M', '𧏊'), + (0x2F9AC, 'M', '蕤'), + (0x2F9AD, 'M', '𦼬'), + (0x2F9AE, 'M', '䕝'), + (0x2F9AF, 'M', '䕡'), + (0x2F9B0, 'M', '𦾱'), + (0x2F9B1, 'M', '𧃒'), + (0x2F9B2, 'M', '䕫'), + (0x2F9B3, 'M', '虐'), + (0x2F9B4, 'M', '虜'), + (0x2F9B5, 'M', '虧'), + (0x2F9B6, 'M', '虩'), + (0x2F9B7, 'M', '蚩'), + (0x2F9B8, 'M', '蚈'), + (0x2F9B9, 'M', '蜎'), + (0x2F9BA, 'M', '蛢'), + (0x2F9BB, 'M', '蝹'), + (0x2F9BC, 'M', '蜨'), + (0x2F9BD, 'M', '蝫'), + (0x2F9BE, 'M', '螆'), + (0x2F9BF, 'X'), + (0x2F9C0, 'M', '蟡'), + (0x2F9C1, 'M', '蠁'), + (0x2F9C2, 'M', '䗹'), + (0x2F9C3, 'M', '衠'), + (0x2F9C4, 'M', '衣'), + (0x2F9C5, 'M', '𧙧'), + (0x2F9C6, 'M', '裗'), + (0x2F9C7, 'M', '裞'), + (0x2F9C8, 'M', '䘵'), + (0x2F9C9, 'M', '裺'), + (0x2F9CA, 'M', '㒻'), + (0x2F9CB, 'M', '𧢮'), + (0x2F9CC, 'M', '𧥦'), + (0x2F9CD, 'M', '䚾'), + (0x2F9CE, 'M', '䛇'), + (0x2F9CF, 'M', '誠'), + (0x2F9D0, 'M', '諭'), + (0x2F9D1, 'M', '變'), + (0x2F9D2, 'M', '豕'), + (0x2F9D3, 'M', '𧲨'), + (0x2F9D4, 'M', '貫'), + (0x2F9D5, 'M', '賁'), + (0x2F9D6, 'M', '贛'), + (0x2F9D7, 'M', '起'), + ] + +def _seg_81() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: + return [ + (0x2F9D8, 'M', '𧼯'), + (0x2F9D9, 'M', '𠠄'), + (0x2F9DA, 'M', '跋'), + (0x2F9DB, 'M', '趼'), + (0x2F9DC, 'M', '跰'), + (0x2F9DD, 'M', '𠣞'), + (0x2F9DE, 'M', '軔'), + (0x2F9DF, 'M', '輸'), + (0x2F9E0, 'M', '𨗒'), + (0x2F9E1, 'M', '𨗭'), + (0x2F9E2, 'M', '邔'), + (0x2F9E3, 'M', '郱'), + (0x2F9E4, 'M', '鄑'), + (0x2F9E5, 'M', '𨜮'), + (0x2F9E6, 'M', '鄛'), + (0x2F9E7, 'M', '鈸'), + (0x2F9E8, 'M', '鋗'), + (0x2F9E9, 'M', '鋘'), + (0x2F9EA, 'M', '鉼'), + (0x2F9EB, 'M', '鏹'), + (0x2F9EC, 'M', '鐕'), + (0x2F9ED, 'M', '𨯺'), + (0x2F9EE, 'M', '開'), + (0x2F9EF, 'M', '䦕'), + (0x2F9F0, 'M', '閷'), + (0x2F9F1, 'M', '𨵷'), + (0x2F9F2, 'M', '䧦'), + (0x2F9F3, 'M', '雃'), + (0x2F9F4, 'M', '嶲'), + (0x2F9F5, 'M', '霣'), + (0x2F9F6, 'M', '𩅅'), + (0x2F9F7, 'M', '𩈚'), + (0x2F9F8, 'M', '䩮'), + (0x2F9F9, 'M', '䩶'), + (0x2F9FA, 'M', '韠'), + (0x2F9FB, 'M', '𩐊'), + (0x2F9FC, 'M', '䪲'), + (0x2F9FD, 'M', '𩒖'), + (0x2F9FE, 'M', '頋'), + (0x2FA00, 'M', '頩'), + (0x2FA01, 'M', '𩖶'), + (0x2FA02, 'M', '飢'), + (0x2FA03, 'M', '䬳'), + (0x2FA04, 'M', '餩'), + (0x2FA05, 'M', '馧'), + (0x2FA06, 'M', '駂'), + (0x2FA07, 'M', '駾'), + (0x2FA08, 'M', '䯎'), + (0x2FA09, 'M', '𩬰'), + (0x2FA0A, 'M', '鬒'), + (0x2FA0B, 'M', '鱀'), + (0x2FA0C, 'M', '鳽'), + (0x2FA0D, 'M', '䳎'), + (0x2FA0E, 'M', '䳭'), + (0x2FA0F, 'M', '鵧'), + (0x2FA10, 'M', '𪃎'), + (0x2FA11, 'M', '䳸'), + (0x2FA12, 'M', '𪄅'), + (0x2FA13, 'M', '𪈎'), + (0x2FA14, 'M', '𪊑'), + (0x2FA15, 'M', '麻'), + (0x2FA16, 'M', '䵖'), + (0x2FA17, 'M', '黹'), + (0x2FA18, 'M', '黾'), + (0x2FA19, 'M', '鼅'), + (0x2FA1A, 'M', '鼏'), + (0x2FA1B, 'M', '鼖'), + (0x2FA1C, 'M', '鼻'), + (0x2FA1D, 'M', '𪘀'), + (0x2FA1E, 'X'), + (0x30000, 'V'), + (0x3134B, 'X'), + (0x31350, 'V'), + (0x323B0, 'X'), + (0xE0100, 'I'), + (0xE01F0, 'X'), + ] + +uts46data = tuple( + _seg_0() + + _seg_1() + + _seg_2() + + _seg_3() + + _seg_4() + + _seg_5() + + _seg_6() + + _seg_7() + + _seg_8() + + _seg_9() + + _seg_10() + + _seg_11() + + _seg_12() + + _seg_13() + + _seg_14() + + _seg_15() + + _seg_16() + + _seg_17() + + _seg_18() + + _seg_19() + + _seg_20() + + _seg_21() + + _seg_22() + + _seg_23() + + _seg_24() + + _seg_25() + + _seg_26() + + _seg_27() + + _seg_28() + + _seg_29() + + _seg_30() + + _seg_31() + + _seg_32() + + _seg_33() + + _seg_34() + + _seg_35() + + _seg_36() + + _seg_37() + + _seg_38() + + _seg_39() + + _seg_40() + + _seg_41() + + _seg_42() + + _seg_43() + + _seg_44() + + _seg_45() + + _seg_46() + + _seg_47() + + _seg_48() + + _seg_49() + + _seg_50() + + _seg_51() + + _seg_52() + + _seg_53() + + _seg_54() + + _seg_55() + + _seg_56() + + _seg_57() + + _seg_58() + + _seg_59() + + _seg_60() + + _seg_61() + + _seg_62() + + _seg_63() + + _seg_64() + + _seg_65() + + _seg_66() + + _seg_67() + + _seg_68() + + _seg_69() + + _seg_70() + + _seg_71() + + _seg_72() + + _seg_73() + + _seg_74() + + _seg_75() + + _seg_76() + + _seg_77() + + _seg_78() + + _seg_79() + + _seg_80() + + _seg_81() +) # type: Tuple[Union[Tuple[int, str], Tuple[int, str, str]], ...] diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/__init__.py b/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/__init__.py new file mode 100644 index 0000000..919b86f --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/__init__.py @@ -0,0 +1,55 @@ +from .exceptions import * +from .ext import ExtType, Timestamp + +import os + + +version = (1, 0, 8) +__version__ = "1.0.8" + + +if os.environ.get("MSGPACK_PUREPYTHON"): + from .fallback import Packer, unpackb, Unpacker +else: + try: + from ._cmsgpack import Packer, unpackb, Unpacker + except ImportError: + from .fallback import Packer, unpackb, Unpacker + + +def pack(o, stream, **kwargs): + """ + Pack object `o` and write it to `stream` + + See :class:`Packer` for options. + """ + packer = Packer(**kwargs) + stream.write(packer.pack(o)) + + +def packb(o, **kwargs): + """ + Pack object `o` and return packed bytes + + See :class:`Packer` for options. + """ + return Packer(**kwargs).pack(o) + + +def unpack(stream, **kwargs): + """ + Unpack an object from `stream`. + + Raises `ExtraData` when `stream` contains extra bytes. + See :class:`Unpacker` for options. + """ + data = stream.read() + return unpackb(data, **kwargs) + + +# alias for compatibility to simplejson/marshal/pickle. +load = unpack +loads = unpackb + +dump = pack +dumps = packb diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c29d811218104c6d73f1c3822d0c4a6c118f893a GIT binary patch literal 1740 zcmb7E&2Jk;6rb4-d+oKI#w0CK)Uwot%0YN3fi_AZQbbcg^doIjK~_Tc+B;6x^?I$@ z&4+_4ITBKYs33?#dgQ7 z-tX;?$z&Ws`~A*F`ArF-r+m<9Fb>+m4s`3tLKd!~?*+^)p^6>B5FF7EVJuowRWc+? zHe@SeM2J*L9qm2VReFyNj!Y}MfkTt3aH>*`IdLQIsD|n!j08qCHO6mKs>x^Pt=Ol? z=&|B}rz{n)m-HHGq8iVU9;1((GWr`*29eYSM3X_h|2laFJ6=sUPL99xL4NYy z-HFMW>Gy7fFN;i?rTc`k=zOgXR*@<90)x;JKc>@UFjV*s41jgy9}$9pWE(YwZ}AuS zf!M?qv9satzA0At?tio<>X6#$F>2tfxcpIEgT|xM++u~4e68RXG_z)Di`4dsX8W4& zY6Z`y#B>Vrz%yjec4=ks>W_Vf8%y+M26o&fs5@LmFF zp+6ER)wh*AyH*BhUEh}Ct2b6|tesvT{A%#gov+XRB54QUh)UgLz@VF`%P@E*Q5X`1 zd7@5CQa2q_C@U;~_@7Cj#Gj`%EuhEJiVdH5|04%92~lN*APd2B!9E33G!5W!!D$-h z6fl|JP^4$TKF8P20tA#K(p&1_+I4_mRc%YvzUh6UW;Ue^?FWyOsThTob<{+a<3zz6 zZyRBU9teI{yG^0oB@5`l%MSxO!omP4c7$1`uG3XwE~MeEX?w)e3Q(TZyk`1lL0g<7 zwXU01a%;Y6*F24IkC4GopvP6*DZ&$U48<>j_ASbPilAuz#|rpkk_Gp9{28Fwkj6+@ z)^rdiFT&@&0MJ716iTGOy!zSI&);rc+fmbNZ)~aOA6*96l+FiCW>2#?St^mRf|$so z<;6g`z?k5AEV=;o0p-QiJSaOb^LZA9Qm`q^inGLLO4+Pdi;&4M<2+)@elXQXZtori8K2M^KDn2C|BT8 ZdF0UJdHEqeK7bw%^o+kEJ|4n=e*xLsp{4); literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/__pycache__/exceptions.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/__pycache__/exceptions.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a2a61f192dead00eb9a1f4d2443d4d82f6e5ee23 GIT binary patch literal 2024 zcmb7FKX2Pc6hBg=MA4FMxpvyxg?k=agh3;w?bM>^5Y#C$RBlnHgBF4&PZkl1ryeOe z6g(KHhYT&?%^CUyjC_c2fb=vI`GNT(~vRi^}@5$c|kp*9JN!v7q$e9%h{THm>e z+YqbhbtzH}F(gvBhC7)CLbnI`mkM2Z#6`zV_VLXJcOFN5Hw=6_xmPSv5H=T`DlRA5kEe5xSN^Ap((IdFZPM6I91C zIwQjm=yUD&>TqlOx%P)C@7bbJ+i1^9t-*~=ww#;^~w6O z6tM#)F*=*%1mgp42vVvorX(Q?Rk89QqcvNm(XfikO=^IGz_%B>NR~S3eZ-KUFvk8l zCvQ|uH{MoMeP?7S`h&c#P^V#4u|y`*JRdZ&>CrATe{sVelQk?GLzZZ^o{!!I8G6d9 zKQ8_;WUIKH>txk~J`=5wpGbFE4aGO0rE|P9zRAb$x8hT9FDG9J%ymIgl(AY=jEi7Q z;4|J(l=8*LV*;PCf&AKx-@CZ?g5z!vC0iHUFC5%$U7KWc_cd7`7c0tx*Xwjl;CoF; VZTqY`tnHkw4mbDyA~ktW{{Wpv(hmRt literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/__pycache__/ext.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/__pycache__/ext.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4c68fc5d915734126ded6a01643ae63764460d27 GIT binary patch literal 8169 zcmb_hYitzP6`q-Wcx|se>-F0ZbHPBo0e1aPY#=XQr4Sc_NzsOMJ>D7PCA+iB%q+nh z)6fd3CTSZ}sj^8@)oCNe5tYi%RI1ddKdP!#q+OQQ?#7iWHGlYL9#SIIDm~}UV`tY3 zQKXLSvvKLKjeczxQ__KWFC|jir1b zGpuH=hB0@c)@s;;J|cVFX!}Ff){E2JW{ZlwxMDBSF~df=3*4(645RR(6MxlKt=jAl zlC@@FnaX^P>J)oiam+A3X@_;g%4axJ7a$||XvP;!iV{hrRgFxbFtm(c6g0u&OiXK% zs^E5SzX2rUFKOTN{ocMO1675Zm>QE+O^~Bf!2yF5s!{L<6eXz?Ty%&+%}YW&ZL-vK zN>U0{k%%n47KsF$1xGZl7MwVC!HM%1sw0tTTu{|WM0LWvgpf-QPKBnD2`QwcBuz=4 zk42|K*dg>nOpS(u=Oy`kC?1;#rKYv1q}(6u?F*?fP1=R370yU%C>2YEBG61sDj`GV zA%H#Bc4c4IK_4`sa}o$I>AZ>QXz zyuUZ=?Oox0bNg@cn-=!nqnS8t26>t5TBGF3{@YHFE2CyaQ1%TtaA0NF+h|ivq`3!>KRp0*$U^NWvLB{oai{i zg`J{bbY2D<6kV5@up4bXTqRZk^@tvz)l!XEeVMrq{qYIciZ#IX0=L%2trNY#tp{$M zjmwMm!1akd&<3dU+3Nh$4S`0$T`VC15ECikCD^+4W;cCpN+QJyK!7Bxv824t9n{nS z>d1GeB$-U4V{whV7SpE4J_@g$rqdv4RZ_`5l8^v(qDr(RLBJ6~7D-yB#c^x0@nCVt zG+4|Tl1eMmu48mabHtrwWHK#BN5-{egqqGc9n4@(D#?V!RwSHWv`LM)L;Yr;fa8X^0WL{4fXd0tYK7&rt~iY8^)4sJsht zZI*h^EEN7PzVp!@x72rXCB74Sg72(CwBb|cJ1g?RPcjkQ1AS&Vc(c6wv^!8G{0YEy zSdM8iAs)*}M6dxWIdN8sYC#=6h@g>_pa=={t)^HvYYy0WF(UD zTmA+jnaAThi*f~ zdo%Sr?e1*v12*sxSCr^StU_Qu8Z?Vy#YxJ=s`Cc1aTkzF%)c7C7WaR6^!=lYPv7YL z#JT+JvD~xAvdLafkf~zcuG@}eajpd)9yYbAh zmAJ2VGmsT4?JQ(~XRRF6?1TAiB`)?l!A!FOF4MDbN`jaMCPyU9KVsUn9t>LTm!&sDKMD+D%1inD})^BGNe!v#+Q@oihxL)Te=5Vm`0s=Ui{? zUfBA};I&|`wtJDXc5?=+#+<|K5UFW3sdICxv}}vS5GevEO+(iy85$C19^Th z>lu8+R-S^1O1EN~g2*Bum5my1nLd@Ej=sY@T!{`i^Dq}#(Q%QJCEG!avBq@LF}Hrr zn67nWI%XWAI|FOI$U>o%C)wnrN&${94RqG z(1#x943`4xs};b+nUi|fNmEA*IS{AGxMfu1hK1T9>`6=^(Y7ljqec!3zSh>kNN6TT z$T49$o)n-rWTj^QN{`l%gsX7q(!B&dO6=;bG1HL|dhmwsbd9z|Ns+X)BC8|o{E4v) zTxa=ADSZjW!4(|cHiT7k8x7_GxA~|ZwlUhm+wnL8>Z>=tdV^asChDSOJ4F=?NyQk)5v)e}+Iv!Qa%-k?Xf@rkaI)MDZsWAwC z>rI?=Yv%czT1>z)z7fMLb(1$efieX8qvjYl&sYDUmZZK+_;+-Z`N*IX>MO` z-j-|Lw&c%&HHg2Be-zI(kAOw+&Dpjma{LoZ!c9K(dFx~IuU~x~jHV^u+B4@|t7m*o zv$glDnYPZ-3XfjlV46Dgz`iIhZy(BSANtt&2k-B^`NjjY`&anJ+1mB?fo=Evwz~^;9G(H#Yw~dfsXCT)TxeQ3wYQYu5P+9PBWZvCJT^fXoBAlqZg)>v^f`0PC zn-u_;d7!d^%Loc-Id&m32|+;v#5|&(i2ywo*n8nQ86ZZ-u;6nWx2WJTCcx=OB8r;rmBrX7}w_Y5vl`t;N1l&w%$m-1DC(NGCC6eVb| zegN&&P9R`LUcmUyf%T}ya|o4{o_!ZlZ9^zv*z~_Y z)#Wn(4KQjuk=sR7yp5sI!E~bnP)j;nV0~zAVL}s83E?|-9{;^sW~vhN`cH9{>#;LS+zI@caHl z;D_5mM4}5Qk&q2vW)4?|z_Kp34tl-@aJG0ls=vK`Ryc1V(^!2vGg0lx|cye}D@%yHreL&RW-vRx`W_v0z>_gR_{QmOY>~ za1!N@d6oVf>nLaF(UE!aA$r6cM2PAV>e6l-2ENCwII{nk7hm5^*C_C=+u&Mni3o!x9kC}n8}N+#?;DnBRJE`gX0f#U*_KQ z1Cy4C$&<+nim~KjsRL3V^f}4_Ai9vLyutTyqGoqHR3DZMGp*K8dMq>-@GBTc#SuZc z;LqEa`7Jqq%VOV$d*0vk>!3ohW$4qdbQM_d-#k9Kq5HNXC%hC+LqDI=%i$i*6lB zBmApq_LrGET$RhS=4bpH7GB8up15@Qp0mmI_}!hHYmB|?ak`rCdO6qjyB^jxwB}~q z{ySWoD|F8Rr8O+w9cXkltvx|2JXQsi?l!qygODm>54Wq&=mDj>KDX;hBqD26yIlRW z`VI#reYvp0DM|`1$c-j x6@|FwU|IH`%$Cm>{xhcTzPpC)xpH=)eep=XzUMvzZ(nqr~21ZTle+d$GPX8d+xdCp6^F_dAS^(pB=t7c=>gX``;-b zKQ_s8f1{q`E^|EB$MHH|Kdc+k_33rwHw+v44D8p~XVi0kli$D_uOT-*LMc*A!&xKQ zec3uLhw^6)n@4i`a`CRY&#LF1;rN`db9}D+Mql2jg}3xsk<&VC8?pE0A!pv#xxQ@P z#@mM-Bl&&#BL#g0BhEhOh^x;vQrK6B95&uDTr}eDbB`4F6;r$VN_bmeDWBh0#uxOJ zBV2)SCBjt*dw6GGHSg+M#TWL~_-p;E2laf>*L8h$yc;#u^Tlu*_>w+vfa6Pfo8RlN z9yGkGe0=<6p({RPzP=D#>5NyZBnkznZT@3H5vfTrZV5sE4nS zZ-U#*uYudbx58b^uY~}lAgZ=L0cd=h; zu?OkYTKc7y%Hc{WOuv*~C57qt>Gv)Fv#zg^jY>O4Ww$aaO)Rbhah*zB^EpEe=eN{y zLJmQk&&J5+(#XERz4@QdaAyrKaA$PhJ&~5ZzTx2$zJXJov2nrgdG=iRWN_3I7#SP( zkN8K!zHk7+;GkzD^wJn|EfL~)bxAYt3;V-?5r0oIf9%}Yx&G6BA%v{`fziPr(ygQZ zGsA&Uxc_8eG)&>$=feKb?(x7d?-vlxI~o=Oqc2Gjy#rLN{7C4@-S;5oGUw;|bU6(;5Tk1LPs;G0Y#j*l{?>zm&_HX; zY5(Zy*5Sa3)-g7I8(P+_Zw&>){xvjazL)%=*0I1?D+Xzl4+^c)ShfyIL*FuXE@|$^ z&;`Q%{gHeboGo&c6Dg>#*?gjNh^@I9!*lm#p)Snz*B8 zrv0{~?x$7F@4Yr<{0-}Uyu+o83PF>N%J0H+Sp%o2F04RZMq(j9svDwlOnYRQPUuF< zR7j(QEIFf6f+d_I$EhPUp~JW`vMQ&Eze9PcVG5~l(YOj0M0vB5xq(n%G!*uY4)~L~ zBmR+~aPD-#ezi-aou;41Z+;yqz-2<0&i}_{K?eCwP%l9t2ko@kxDcyqA@pkux z?s;of+*&oGyKP-1xKO}=g7*jzl-USuf(P@08^Uk;Go;K9HARN{Q3(oq)+Kb0Q1_}% za3E`lYVwG^GQZ>xpY{!p`!yIPM^#haLOAES1*iM+_DkF6ovY){)d^>P%v#SH-Q(4< zUz*_k{iD7Se}8{6x4(ZR$d3<`-`d~*^0;qUOc4l2g)(xg;9TX{yR0DsVE}Uo*r9wl zU+3=YO*yUiY^I!=`!-!pgP5B#?geqmX2c5gL<=|aGq@3wUFKfmBsd5)2;(JVC=l^$ z`u~M_`>=211n=7^)FVd&{zCNXd2U93UToeHmFYDlb9avq4*G??K@)SX7B)8ocd0bxuUf+vQO zx^U7MrdFB4<5)^URIvw-h#Cd`11J3hr}`;Je+VnVKv>v{9J}xrYJ>wqlWm!7|J5^7 ztK-@3&+N{rj&GiuZl8QLX0G^2N{EeI%0MaodKLwxkQk*WAON}{h1?*U^zgbVZC?mB4zR}TO*fTy#B-S%11V=n0Ge5mxv7bM%96q$_5E;8)1dPzahX<#q zSr`>)1<>=4bib~f&`0%|$Z=H3Nn9lIWLO?$;xS=BI!(c}M@|!!> z;DXqgibH*zM%~XJZ^>nuj`#v0f5>zExH4srANQO&=^ynpiWwU{13_?8STsC-n$;e* zD72)$tm4M9w*w(hV00izY+2Z!_L_z^WO|RV6m&Si%RF4#>nb%__O{aIa4_f@1#$87 z;>(A^C;b9?GT>203XQ^!xc_ zcKYW9 zU$HS>u`yAxDPh|jGjCq7*v{|&`R93@weTLNGi_%Sp)FzC7Bg>Kw3JXBqY~!gy9Ri_ z2+=IL>S$lheQ$NmZnGiDEqxy`OaC0s7y6z1mi|oibS?ckJW2iT6H7mUCt}#S@5Is% zMPJv6rN4mBs~6T&gnsAX(vMhpiKZmN{L){-v-B@mq(H2saEK!Qr5HhP35O}-Ux^W4 z!4F|7o@XXLWr z*N$H+??76f-!`b@^AWc51qeHMC)|90eqRCag3rkp!gcXQa0}Tkx`^$f-RJb)QlTA< z^}U7(1NPJJ8&M~&Uy$Z)yYSLDZ3aVaBDHH9^9jBY&mbma|8U@xzm1VGB9?m*wT7Z( zVtLYcnhHGLf};6`QSWijh#xyliHy)IU4x#`n13KJ81VDW63GBD_=LK^)mq9P*tQ261Gqk=lseCo7845w)Gih)VfDu$4ZD4WwFG zR`2l^PXq5C^kGSF^Bf0M8rE%UT(@@p#%50%b@Cqfrc`+%7##MDhX^#Guv#Vh85YL< zau;P{>|vV(PdF%Vz3DBH4ia=2p*;hls=TM>WSo_@nY}1KLt6yjnMXGRnKX^itWJ+= z1=u$%W***;?I;cPnLzlY=UDIFHCsG>tXM2ghNO4-;E)V~F|BG7JFrp;fZ@p?nj|NC zh*zYMmdGtH;UYDUp0%De9)$r`@R3s1A!Tql=nH#14M)++QQ#G0*RY0p_B?y2W1lxA z|9a#nwDC0b_(p@F6}+(lZvZ`+JfubT;QeF09cevgxFIsU{Ug4y{!{*QYQH56QSi>& z>*umuTi3 z=2PfoaD14j6?_0P0dX1;?C3ehR!>YxN&*`a7Khm9p-Rynkv4dIgJI+mM~Co05;9Qx zRCLAwp!vh0peMvcOhcjIXe!1^Egtg)gwU7NZkk~v(gL{Funnq*)%K)%K*KdY8X)OR zzn?a2Ae$m2J)T~m9E zWle#9#yV07ld{&Q0kySteP*~~Pmo&4FE_~Y>_M??sl$YMRIm4(g{)_o%{d^3#Jcf* zg=Z31IpT1%ELodo;gn{l;Mt*2`38j}QYjAGp#eqZ*(|7-P1A8q2oCr|p@yIYsFk%V z6vPHP{HWHbjR5UJUx~#@tsTM-T=ovowf7} zJOc&F){5hd@H27cZ^MP$I`_Pu*G=R`b?42z9;Yix*3lM?5KEWo{N@^DJM@GsVMSEM z8{}9L^r1Yek3GCmTe>P#x+bL~HB0hxya^$-ObRJNsi-BS=d&g((L6r;6gISiK5CiB zi`q0HThy)z*`p3AWQtmNa|Ga-a76PpIr5_x)Iefu_CSEk4QXK}#h>a#ZI-YiO5<}h zebt}Ug&+wGlc174nafZQfl;F(LJO0`U3|+Zmx**mq^3#F(xlS~i1=16a?>_k3>grT zH_-%3(}4c0{uB;E1Uqk`-;i6=3#(k>8#=UK?VTn*N+X~^B$|VeDqhS+h>l0Zy3GhF zWkjtA6)9k)KpDN73ijvl&|JJ$9W5Sl3Bz? z4upFn)oFWdNC3b=X}21C*~AZE!oMbr13pYX6k!{3wij1k2#sI|0`@En<~f}c2yjp1 z&2@M^QlxGg<*L@Uv}}l!9T!ieu^Cci2J&_%QgK|fS6ZH2BPXjHljWJVEZe*=L4~GZ zwtX8J598bl8#~BPhsQ&K)BZ^5abhQEo3^Y}Zw1c3NYVjzI%$^Mn>3QB0%tzh6*C!T zGDlgs1wu!NJ+W}%R7vvm2a#mg5Z^s4(vfw1g)ZU)BtG*PTCY%2t;HMX(WyP zkP)B|abV@`Dwe=JSz9t%jl3lWi{RW$Vx4?v0JMe>hH z`*`J8|KA}xgfl+wJa@N&vzEpz)e9A?CwuN#Tro@eLb+$M^R0tFb(T$ceb95IXU^HQ zSX34BbR>#8V~);+in__pH+vS!tMPO2^DM5o`rTJ1jc;1-xQprMZUN`1o;1#x%YS08 zT&S#{JhWgbnqGAa1($j!52OW(r+447R4$Y^O&-*w%pQ)Hwxs2~<7uT*D;6xSsqnnJ zIqq)0Woce4D34VfOceCQtUU{*HMdH;KMKumoNszM-t_dR-b8&jnq*&e6;C_g?SeOF zv8raKCsDP5HE^M7jrd!F2ES=raO6+DFb7qJ>RXN)R`64af=w~&rn?3%zg8Q8ny6g) zr@WquDOp&>imh6Zij$+|-^wP+R<5A_v7?Tvq&gP zH4}REEEVr6jFMbDr<@%kRbiFX)JQJJX-ZH|V|pF#tkV9iJBW{ zy~Gyn%G@fRO3(1tujzLn<*Y7KTQk2A0pl>B*RYesTq-PL=GrrzkVcihlOoDhy~r+m zbA+?#6FVDbhhD-21z#oSJUL!+UW1d&0;z!h56-07xkv6Okq#zQ6m}pzM9ej)he$GZ zBM`|`NCvGxyMX|q4-gNX4ZHL0iHj34bNS@NqP=#eFJWIhXFGLfT^6Bsg z(JRror3oiowbuf1%jTQ4^KFOXZHI1I4$&O4mfy|dtd4n0RoqgAsb;B>^oU{=8>Yka zRU6_}8{myOHZrA_i`~4ii{NoxN%z0m}vltyb$kYAui(_TVp^mOM3-B-G&dt&ycn7K)8 zu@(;r`&f&+Mg%l9xQD55>7b>-bXoRZ)g|rh(7r!79u5wYq!T(t zCdT{;AETD561mWg3i}aEp%Tel#x^k;5^*Y{q(;6-on3|3&{n9BhX6xH|7xJ)v+6yLg#eP#ifH5s(A*rR_h|0n7juByLcDCE_At1>v*TB(j&EQ0#R$ zNnJpMAn6t{E={Dgzk^`JrT~vY-bZljKmwb&1f?n8Y}I7moO!FH;y0-yfDT_6o?bWo z^31v`<1yQ6fYe?5{)Xw$ds{AHD!*xc6kz`Y&`hfUlo@#P#LWysB7^`TTmTsgM5kUv ze|6_*ATliWf*bJ}mU%3R3d)C3miVxxJ40^G(yhEDzr#TdK64$)(oKk!_GErTTDp}w z_!PNN)L>zK)@Yz+L_QgQ63ar!k@iR|i^6W8-vr4{Kr$Fs}B=|;DORT+jUOhlDEa@it-#}-Zn8gd?tze!pO)k$K|K*gj$ z04@<6J++<(zztYKC!j6 z5$P(^lr&)LCA>j#v_%wX_yiIO2?QN)R{Hd|3jPu3cZnQTGA|qyH_(hYO8ZNqu1p7% zO@E2g`dyT!UA!f75+D-L0|$zJ?$YUvA8fy}J>hPc-T2A&tJ~x5%{Qy#?roD+Vxo$t z*U`4hT5!i=e|yKp9Sdbu^JT5^vR3TOXge@@=n1h}C99_}n=fvP7dOow zOcb|Gc75h7UvLyIIxD6F*9+&ItubqB%-JgQd|h$tYH)kj;`cjda^CBSTN@|4@7g(g z+4SLrt@85%&T3a#&X;F4e!Ts|?eVJCTb9;uA6h6YR{>z+p6b-aEEyOAqEc*m-Hw?F zYKWltOkhc!(DQ_`85dJksgNx@nW;(!8b}k3<|>%b45_?cnoG)37{y(O2oM1jfuzR9 zsBywDWg7ic#2Z<>k;UgizG&pLBIt!kjgjZuN*+<-ybobBy@PF;LRX;-OYDL|b>;qJ zX3;Dy3xmxSpQ!#lTnNgX7b&^Fr7W6^aw}3^`F&6dWfQ~t;6r;XtPfV!hfN6QN$pdl z!czM(&^~J4lu6i`)ANs8FFW++aZo7 z;n$RLbP+wzmtqQ7Oad`ZDaOTO{(>)z8WoASi7#T3@gI)js@LeBg;j~PkudB<;Ln6< zA`3mph`mvTDnoXz$f%==lwMkYTEi7`pNELgO?#qQD1F74e@((^UdQHuezfFq-WK0^ z(7aLBAa&jlR(sMKj9^BrCcY#?-eu#)4Lu604Woa<7pII<2^*&m**N|7FEvhI!dSeB z^>QMcHVm2RQ3kl;++=9g3gDUz=#^&9yF$1sryRh4!{~m#ECsIR46bi6xL#ZaSLzq= zAN4C3p|<(&0rngI4%m;CXr-exr62uWz9I!)l?-0L$>8voHA-IwHnNd;FfOKJ;X}{#zn8{+ ztdR5JYf|7<`~Nw3W#GWrs_#vM*9y6{@M?MG;8#bD5peDDOa`Az+_Pa27m&PlqDY?I z4_i8qSC;O;VMp3azo6g@IaP2Xg-ln`4^3pv$zQ`4I`7h5$}>d{F&YtfN=D@%upzAk z=}53)=~H_1PvGob`ct^Q!a=ygvvAVhkPa9dgd>#U*zye0!D55(9A)s4bAp^rC2uUwC#;f7ii-dpf(?d-n*m z^;PAlNi$16(*C^g7A0&a=Xc;Fb6Ga+=|I&EjE*0ovulClvb>Iln?q9h{_L za3q}6b%$uTB<|YfJB(Iwe=l}1QkW{h>ldTHiOC-NH3yb zo_C?ZHLaWOykfr8nwEfL%>9>alkJNIrIQ^CcE{Ald1r0hS$oS~yIACzX`k5;tJ`+7 zbAJ25`1XUbZ9PBm#j2l86djH^4lfiGU2eS8IDPotH4iMbTq(3J?yO7L>y$!w+~ntX z9**xk9NTducI0TRx;IgDEao_t((DJdF0q2vq5HKLUqBFSHoMOW#(t1j-Un+eT! ze$sul`)2KTo4?bXa6R(_UEH<*lJ1VH_;UB9?its|z3R(&*4)Ejg3Ds7y}ztS*g ztywHAn=h=77uL@jW_v$*@#>2=H-2~fceW=A_g&ZvxG|hyErBq7U));zsMb6Hh1?bM zZg1S}ovoP-e-gbKz1jQS7r*mj!oB~J@lyWZd;B@99S;ScX@1{Y(foec@M!_|FdWX@ zh7}U7pB7ZaDmUJEIbJDgHQ)$js(mUn`AW=Oy8LL3G$)A%y#LRzrhfy{zYE+DNOt-o zYkD%73U(5Z-f65=Fd0ozR3BF4Akrmr<&d9O)FDW+e-!5>s`O2HTamvlds~s2NpEXw zB8lKfC=XIU@nPlFh3#?}=L1rYI=Qcr{N02;DrX9EE+|YFQ^$m=RUOh7)I8Nz=ZOdT0?EyUpJMlQMeE>8vjY12J0`g~&zrDU1@x)Q4 zJ(JuZj6Z$doVl$sKFg4Xlmsvda1R{S%jjG716sUn{3guE=}Bu4g2Lu-jT{?Q^ijjL za$J}gF7^!SPwSxNsm>px%7JGpL+(c^XC5Zi7xqNWYAy1KmQWaOlGBGUcIl7WLe`&5 zGiF)OAq_PX*ZSrahPN&0WpW(D+t%grDi(@ku?*|zL{%SNE5FHR`DVa*y&R+d3VGpr zIixw~!?^)4+&DxGZrZ~WP1uwciJ%NC&^vlpAKoJ8Vf9-w)x+|&rR4i9oMvXRHzvY6 z?IHMEoGw1~xp`>-sSNb~+^&IUza;&4*Ye?!_)+TlRY#%0Rmz-ys5ntqNf5{Ie zwJ~95q(-eR$m!U)%Ber3glr@n zJ<#=R(j@psU-C0B2{dG)y{H8FE|BvLa%d6?-z4YP$k_}hX~0&OolCP5Y6Q=Pl37sk z_6wuJMauQ(=dCOryc11tA=3v#Za-o5(2q860n}xUJ6ipM{|fwBlb-in_o4Jqi+H3%B7U4Fq3( zI20lt=(xPimd?isXCjXD@&Av&$^K$N`T=5Y9x;0Vu)NKc}iIH{(ij=Qicr9jcL?F9l}?5=D(@ zere?gE&o%?)P|UK%XR;aj%!2kz_Q1;8os$}S%VBI4VrU#7sP$4*tl#Y-!-FgP}-cg z*TwC1G5dN3vNiFdHTP+jEI#+u*o$9FJohV~)09AzyI{(2x14jiC->hiRmFAD4iPDWz9SiQVd3Vz-chm11Zyf!-obT6sfBe((_}YVul?^fPzQ5e? zm*H6N^FKQGqn&Z@3yI3USaIK?yLzVPqtKkYX|b~UgP|)!v(EQ|(*{Wk@p^ZnYU@?rcoG$)l09=_^ubu zhOU(++#5*&76>{DsZGpW8?)CUBx}oQDLnZN_`9D4hqUFi=E*XsjrPMNl|a`1)R`qk zJwKJ}#YxL@9ZK5hu)2Pq)dibR8MjT#R}gj>O@uA&k(Wv+QozO*EICmp*aI6) zZl+%G(6`j>6tvKZh{*4feJ6#bR_!}UX8c4#%gF1;c!L=TBFmJ)u`U3InZ6V{DS=j% zt9nu6hsainwJx$wN5axnSc*|w2$qNN2Ci7>%{dh$SZlu2{C+f1&$|5W~Ko zFWQN^4E1#YLm-{ z=Fvcwtsfdhuq9DE(-2*TT*lC;z?epPoPv7@5ZHbaQju`;g7sU^(=85B2lOrbLy+t& z>&Igv8Nny*S%zeU#_W*{fhkCrjwmJ#qA2(v_Wl1r0V&v!CGsZ`yE3oDh%N#Eu>ph$ zhIC8-b%Gwdstx<|&$Bs4-SqkuOGG3<`54;b}lkz?hfzOo4^P8Vt17f`_i`kv1; zf5k%zNiJThfMHqMVS)(lT}9-d^cvv$VDfm@tkqsFc ziJ!NxirZJk%;N1IuddfyEO?M8RFks`4(<^4^TC1seu4J1qOHx{L}c$@I7)qC+Ba-`8hc?K61W+ztBI0 z^L6fL`mgCs=DWKMoYRdnk%j!i1#3Qe+-2Z?z$1XtlE2uykYBvuDx&{IlIQ;F7j&k! zd#Ckzrd9VU4W{OMxjNI@ds#a8vJ58Y{oE`#4v(q)UZ?I?bf&VqPaC+Zru*DJoymEx zSFbaR@eE?dq%yf_?{W>+;iaVd%3I#ovB9b0yTU9f67DHOV9m(1Si!> zSPtwbs{dfC+5nqgM!(6Q<M>~NjTZkP);!(b5%R=}LetY^ufq2SvJ%9%?n_(7O-faPF{ z_K0bst&L+8t2Nue?BS6K2{BiLYAnGgUbt*w=4>0pd@c0T;Pb8|*9qieZ4pbZhnYcK zc43Elu$prc_PatbiA;8U&IAS81ZOl;CR_GkB~i~F)BaIMa1`48u=EKvf6)pROmLCW zTNt>J!Y5%|N^GMiG(I*K#8n>Ecu5A6N9YNr6SJw7YOhJL9R~BlFTuJRvsp};~T$O*6jA8-d!on7@EP{0gdrhq4DOPE;HovHC8go!GSb~yi zIF=0aTEoNaemvR8MN4ZhR(}-kdH2on3shN2q+4Kvwm9;V?7Dm?b zP=uU}*J&`NdXysQb~F`SBMVaKy<&}?ET4^oF;~07m~^EFG$x`2bg}mt zutXMCs2Gwy2yzaz9#)sa5wd7cf+3m&=sTn;LDkY6t49SwPY`W`c>=O11&{JB&?W%G z?hNf%ifq%127z?7?cy6aa_5EzGK62+4`4sTTtOUQqT@n%J{iLGh~Xn zz6@x++zeUgAy3btUeB?kdpy1Sx{g*?lXWwINwQ1^-zgZWV{;1R6ISd*BaZ_ZV=N%j z$gIp%&_9?k!m9NTCXAS!i%h1E{$5x(CeET~fHr9ILyR8%-T#+xz`c_#8aWN8DG2H0 zAg&>5ZooxxJEUJ`6FKz@2J#LTsfsv6qtT}5?jxP#H|&XK!@dvu7z|>S)7tz6s`p!%mK)b^k@LgC3(TOOK`>G*8}5@Wt;hySyw+r%Y$}8;YcK!;>Mn9L z@GIO0vQfOea*NjbCs4NVt8iclM5f0~VlAAblvgOl+%MHFD{*B@;iQ8K)N)YC9JM;D zwzi~|DDyy=F%2PsU@p7|XSu!?+w?^2BA2I_(D;ZpQaoP3uHMB}Hj)L0(uGp|s%9Z7 zyexLnUG;8+Ze=c(R7{_IuM%DxEKl63+Ij;9GhinJGR&BzauN16o|$t(MGLkz+7dQS&st!+rb5jBoiZkn)<2jIf3Dw2~=x`ZwGKFi~jso*-! z$X4DGm(p)1@5)$rVM@R449}i)zl(Tx#<~kq`d$2`^t%N2e=@o{V)@r}Vq*OX>G2X!mF6H*R@XV;(Cv8&yj5dLiPKRbP!q zDH2`6O<4VeY0B`XO|=rp*UG7H=bi>Bo4Xg0r^*$k-G z==;=#6`dwE?~q3>U;Rzh_(4Bv)HK-_Rj58Y<5=OUrPiyg6}57S*FY=i5eD!XnR?N$ zb@_U&XB1R%NYUC-bFeq*)GF;a{VKryje6O_~z^7$t0e>=L$UN_Zb7h}_(|mBZl?xVn{Zi{_@!1>8a( zL|q~W_2lZpXEZa`_2g!D3BNs44NnYO7U+^nD~38QD=%H07i9QNoafLNmDiv>4_HgM zAv$?Vd$emsxI<1$<}&F+;;x&8l&-NqY$Y2LavPxPS5B&a5)GoGK=#P# z!WxvABKy=|l^*~%)Cz7W`_13@C3z~bl$(G}rXG|(um^Sxr?exgdr!~r{4GT@9||zX z?Z>%JM*jLU{thaRi4+$U%ANpPjxnwfnH}A|?Dc)P!I5m|4Qh>~3PDvw^i%OpKJ+on)7y2Wl*12X&#Ca5QAe=TpY^|ob4=P{w zOie(02HCwxY8fv)kFr(8PzJL(X2h6zZ?lhLG4Efok54i0yzmmP|9xcB4#fY zMFSYg?+`yQs2tjOA_a6Xg73eG=L$P|f}?(Klkk5bchX1)DxzvAE!X0$O1fk&O3@5B zwGe*9GSV@IV89qB^A15UkK@8KOt31dkJ9uOEhN!wU}^xkUP@p=)DE_XS<6V(g4qsEn%IXH1;{%|a@dKJqF$V|B(p?_CG(h8t0GW*1qFJo zqFUEeR5)y6;*-T}IwVc(6P3yQWnZdHS|vFn$u0S0F0=B>M4Y0AYb`1lR+ICusJp)h zCqz1EBp{X_QL&*OnIcwMq)1))Ls0dQkj3PQHm;lTbQ!Ha;U>M;&+M+Lqwm+w z*{eQt7Qsps*_4_uTN5u^Gy77aY*Wm&=^?Mxy!9INVy6w?+BMDp#;%mNuMd85>guVR zH8(?vmX1VOXUx^P03FJXIVX(h-geeJIq^(PmP}rBwF?-$_~U_ z2Oe4W>Q7ytqA3RwW!*7XH&isIYv!EwGex&aM^n>lsom+>OQ#3soZgu|x1CVke025_ z>gbx8w%g7%E6H9tgT}PZX5WUDs}+=9F=Lo>ZjIG%z3tq(lKgeED1O@w%WdbjM`!=c zT{CO^B=2fotbytDuDP;i){rP|hE{D&{Z#j7uJXmAnpo}AiK6zHqg_Owr#|w=N}K2G zYZhJj{2=@4FwnyEPTOK>ZEW?XKXTn1_+Lxrw;qV&|LOyYQZ@t**SuqO+_8GbH|J!^@npW>j zlxMaZbIj2kb2p1& z(;S0o%-uq8Grrp;c31b#CP_71y61f6uUxGQg+v{5aQp9?u6C zAD#aAl@DLJ@zl-QPj!j<-M3vG)RMY)zWRtB3B@>Oxis*g5(yzRqn zv!NTEiJGl*j<%G>tjv@yAX~GQ^$q1wB&(;-|G zK0On;(f;A9w_T*opTGHzR2U<%z;bBC$K6fWJD@GT@5aC%1il^ky;GmI#hyL6^DZNL-W1Coi)6`$ybm}0(r7RO1{AkGrJ1a4x6 z1O|9^%v(i4!UWkexry;|8O#ma2=MH~6D&uhP%|ECbUTgAZj{GV&F9VKadY|mM`sG( z>zgf{Gq-}FTJhK{pA!UE2L1m99zY*9BAN6$D~z!C;Iurm%`ruu{y!f6WG>zb*u!io z+aA=>IAj3{4y^-7pYV+*Dw{pLM(Y5SK4ZMbhOow}X~vor zO$10u6so1QNy=_2cVcd6&oz|uBeK6B-54ghG|{oNCzEwZ^=n&9E?ti@a+yT;amui$ zl0(S0O(;XOm`bwkm9|6qniM3pKSc>PMXtQk5|r;np@ct038D?t$7zG|ohX#>k5Phj z-u@W9a6Upd?NTjbM=&}n+(w5`U!i!;{TTHXJ)%DM1M6G=7_}5XqLz{e)w1$B9#I2n zC`kN)3bU1$uFfKoQhQ5#BIP6#A-RtD{Vw)3T8N=UjaepxTzU-y6e(8nsb3*pyJp?` z&5;t42Wj4BvLg1rkPm7avGvMgJoeF9W_V3-(b7f-ghClJAF%J!Gw%=Cm+5h(xrmA?qiiHN5*Jd?D~X|DybP1Lk(^B+ zhS6&juR)vT9;#v?cI}*`L5#gj<}t!fw+Ja~#HA(ca%>+F^>3kA7!!lkr{SZHIeP>9 zf=^qbU|Y<(jjpNgo3q!<7;f3c4;M+S{at+8NBnS+6hZITeq@@1Q6KuikQ{5ZPZ_`2 z1@mKMaO~nvTDvROBnnz$))rdMbr&}=`#=}E=dG1-YvuHrzp~boQLpNY&#g4!_JiJ# z5>{P&KCLJzfsA~CtL|1Szh3l7+10WeM{iaqyfFH`{kC-nHKy+3S2Jhqy}2&o-4U8UXqmo{&4Dx%|!jMC95S$b6n{~c;G@mZh{5(gkt z2v$?}6Rye3bmNxQr0T)qTay%w9IZmHQX4r0fkJS17SAV4$OQObuuo}$xZ+noqBO>q7($1O`{(N55t-Pw4_F30I?n>e8r2J3asJ*F6 zRJGj(2b_Wb%bct6V*ew``YCb0t%-uQG3(lg%&jSLZe_&eQ2qlbjv@(U{F6@MpR{xl zV4`P8k$H$=a#c?c!9)i5dr z25#Qj5O>15Zo=6Vvo;Y1(^lt^jGc_?E6PaN{>Y5W5gxr!9@=7{1KfSmFlEcMlB9Yv zk?w0!GECO#BCSWH3*^i+nGe^T#k=OxW%3Z+CKq@4;^&mH@~US9X_hUR!iu6k!QT3q zKuoIa_--DK*6>Bhd3$Z#UJL8gF>{?bi!*j=72eUxFy%($#7W7|KHm9)ctsv^4476^ z+ArN^rTsj+13TgmpA6!%uX3R|IEv4GLwRS^qg+JW!S3a&_kVlPS2_g|JDk>6Scapk z`ATnDh^BamCct^_^IWdjL)XjRvM%o>%|JGEbVi~5!j({>o}GbGDH2*_lO7ok@_q|* zJL7l#9(F>+2EIxf_|pOZ8B)wj2cXxKbRIj})$>e0>;mFv_pz>SSaN4tM51OA;XyJ7 zx1&XrNw+#A9HF`AkXT_Q+wT&Lym<9I_iyQPT?IZ|276=g4U5z5jyx;8ai>>|V({~3 zLr<=E@7^A75z~PZs!;?pg(Cb{@;Rw7g`Io$wjb;6h0(u`V@Hne>F@43*wrhFiMCQM zcGgIOAYl_ZTgll@P6s*c42JQQ>{N`A8X_QKcMp+|`jl=B<-b$Og8p>|6 zhSII)Ub}inYG&|a4f3uL zfkU_^G*Q!kOuiq%NoK=Zhc6r!aBH)F?A+Knn35rMOXkbL7P6>;j|DL8Cr+SMFKOu- zAzK=vdfH(skS0h{9|#Jy7;8`+)YI{*hNXg!De_Z~WOu)Vh* zci}sQzo4Xca@a`Kkk3U<0h}+)+ecu4V%Wb^coD_oKNq5X4Acj7y3e?cKjs?$n#=ub zF7IbqoY69g&mY&!8EXGa7H6uvYc!ZP{@C0BQ&DAAF{Ar$jSf@8Jr2&@I(PK ze&SqpzWZ;pINcH5ZSL^D<7$xGVm+S?(cpP2z787WT+p(JaRqns3(niHhMdoZ%;CH_ z&AC%t7UK%>?rQH16NX<`dCz9lIquntbao(;v+%tAuD-&hUoe^{*G&ee&&F~a?ivtr zhehyH`(n8jcTI>u8KxZMk)pCG%A69FLs7Y6lz-|gvE0hL7K*Z_MCDPGjiS7F?c{fe z{(SNmh*^X5u9G5MVqziri$uSh{KcZbg#4xCZ@61V{&F$Cg8Y@Dzl!`G(O*seRpehc zDK)W%qG~yO&q0g;05kaVCQnZRHaKasN>C!72#a*z{#b667^nIOjB37nTTy9@bNubo zx?|b8nxApx{_U9UD<)m@J&xR;-yOgw5#9GVooVC0F>e4?nKphA$_JKxnAMrXeLu(2 M={9`7NC)@-1|h4P#Q*>R literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/exceptions.py b/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/exceptions.py new file mode 100644 index 0000000..d6d2615 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/exceptions.py @@ -0,0 +1,48 @@ +class UnpackException(Exception): + """Base class for some exceptions raised while unpacking. + + NOTE: unpack may raise exception other than subclass of + UnpackException. If you want to catch all error, catch + Exception instead. + """ + + +class BufferFull(UnpackException): + pass + + +class OutOfData(UnpackException): + pass + + +class FormatError(ValueError, UnpackException): + """Invalid msgpack format""" + + +class StackError(ValueError, UnpackException): + """Too nested""" + + +# Deprecated. Use ValueError instead +UnpackValueError = ValueError + + +class ExtraData(UnpackValueError): + """ExtraData is raised when there is trailing data. + + This exception is raised while only one-shot (not streaming) + unpack. + """ + + def __init__(self, unpacked, extra): + self.unpacked = unpacked + self.extra = extra + + def __str__(self): + return "unpack(b) received extra data." + + +# Deprecated. Use Exception instead to catch all exception during packing. +PackException = Exception +PackValueError = ValueError +PackOverflowError = OverflowError diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/ext.py b/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/ext.py new file mode 100644 index 0000000..02c2c43 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/ext.py @@ -0,0 +1,168 @@ +from collections import namedtuple +import datetime +import struct + + +class ExtType(namedtuple("ExtType", "code data")): + """ExtType represents ext type in msgpack.""" + + def __new__(cls, code, data): + if not isinstance(code, int): + raise TypeError("code must be int") + if not isinstance(data, bytes): + raise TypeError("data must be bytes") + if not 0 <= code <= 127: + raise ValueError("code must be 0~127") + return super().__new__(cls, code, data) + + +class Timestamp: + """Timestamp represents the Timestamp extension type in msgpack. + + When built with Cython, msgpack uses C methods to pack and unpack `Timestamp`. + When using pure-Python msgpack, :func:`to_bytes` and :func:`from_bytes` are used to pack and + unpack `Timestamp`. + + This class is immutable: Do not override seconds and nanoseconds. + """ + + __slots__ = ["seconds", "nanoseconds"] + + def __init__(self, seconds, nanoseconds=0): + """Initialize a Timestamp object. + + :param int seconds: + Number of seconds since the UNIX epoch (00:00:00 UTC Jan 1 1970, minus leap seconds). + May be negative. + + :param int nanoseconds: + Number of nanoseconds to add to `seconds` to get fractional time. + Maximum is 999_999_999. Default is 0. + + Note: Negative times (before the UNIX epoch) are represented as neg. seconds + pos. ns. + """ + if not isinstance(seconds, int): + raise TypeError("seconds must be an integer") + if not isinstance(nanoseconds, int): + raise TypeError("nanoseconds must be an integer") + if not (0 <= nanoseconds < 10**9): + raise ValueError("nanoseconds must be a non-negative integer less than 999999999.") + self.seconds = seconds + self.nanoseconds = nanoseconds + + def __repr__(self): + """String representation of Timestamp.""" + return f"Timestamp(seconds={self.seconds}, nanoseconds={self.nanoseconds})" + + def __eq__(self, other): + """Check for equality with another Timestamp object""" + if type(other) is self.__class__: + return self.seconds == other.seconds and self.nanoseconds == other.nanoseconds + return False + + def __ne__(self, other): + """not-equals method (see :func:`__eq__()`)""" + return not self.__eq__(other) + + def __hash__(self): + return hash((self.seconds, self.nanoseconds)) + + @staticmethod + def from_bytes(b): + """Unpack bytes into a `Timestamp` object. + + Used for pure-Python msgpack unpacking. + + :param b: Payload from msgpack ext message with code -1 + :type b: bytes + + :returns: Timestamp object unpacked from msgpack ext payload + :rtype: Timestamp + """ + if len(b) == 4: + seconds = struct.unpack("!L", b)[0] + nanoseconds = 0 + elif len(b) == 8: + data64 = struct.unpack("!Q", b)[0] + seconds = data64 & 0x00000003FFFFFFFF + nanoseconds = data64 >> 34 + elif len(b) == 12: + nanoseconds, seconds = struct.unpack("!Iq", b) + else: + raise ValueError( + "Timestamp type can only be created from 32, 64, or 96-bit byte objects" + ) + return Timestamp(seconds, nanoseconds) + + def to_bytes(self): + """Pack this Timestamp object into bytes. + + Used for pure-Python msgpack packing. + + :returns data: Payload for EXT message with code -1 (timestamp type) + :rtype: bytes + """ + if (self.seconds >> 34) == 0: # seconds is non-negative and fits in 34 bits + data64 = self.nanoseconds << 34 | self.seconds + if data64 & 0xFFFFFFFF00000000 == 0: + # nanoseconds is zero and seconds < 2**32, so timestamp 32 + data = struct.pack("!L", data64) + else: + # timestamp 64 + data = struct.pack("!Q", data64) + else: + # timestamp 96 + data = struct.pack("!Iq", self.nanoseconds, self.seconds) + return data + + @staticmethod + def from_unix(unix_sec): + """Create a Timestamp from posix timestamp in seconds. + + :param unix_float: Posix timestamp in seconds. + :type unix_float: int or float + """ + seconds = int(unix_sec // 1) + nanoseconds = int((unix_sec % 1) * 10**9) + return Timestamp(seconds, nanoseconds) + + def to_unix(self): + """Get the timestamp as a floating-point value. + + :returns: posix timestamp + :rtype: float + """ + return self.seconds + self.nanoseconds / 1e9 + + @staticmethod + def from_unix_nano(unix_ns): + """Create a Timestamp from posix timestamp in nanoseconds. + + :param int unix_ns: Posix timestamp in nanoseconds. + :rtype: Timestamp + """ + return Timestamp(*divmod(unix_ns, 10**9)) + + def to_unix_nano(self): + """Get the timestamp as a unixtime in nanoseconds. + + :returns: posix timestamp in nanoseconds + :rtype: int + """ + return self.seconds * 10**9 + self.nanoseconds + + def to_datetime(self): + """Get the timestamp as a UTC datetime. + + :rtype: `datetime.datetime` + """ + utc = datetime.timezone.utc + return datetime.datetime.fromtimestamp(0, utc) + datetime.timedelta(seconds=self.to_unix()) + + @staticmethod + def from_datetime(dt): + """Create a Timestamp from datetime with tzinfo. + + :rtype: Timestamp + """ + return Timestamp.from_unix(dt.timestamp()) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/fallback.py b/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/fallback.py new file mode 100644 index 0000000..a174162 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/msgpack/fallback.py @@ -0,0 +1,951 @@ +"""Fallback pure Python implementation of msgpack""" +from datetime import datetime as _DateTime +import sys +import struct + + +if hasattr(sys, "pypy_version_info"): + # StringIO is slow on PyPy, StringIO is faster. However: PyPy's own + # StringBuilder is fastest. + from __pypy__ import newlist_hint + + try: + from __pypy__.builders import BytesBuilder as StringBuilder + except ImportError: + from __pypy__.builders import StringBuilder + USING_STRINGBUILDER = True + + class StringIO: + def __init__(self, s=b""): + if s: + self.builder = StringBuilder(len(s)) + self.builder.append(s) + else: + self.builder = StringBuilder() + + def write(self, s): + if isinstance(s, memoryview): + s = s.tobytes() + elif isinstance(s, bytearray): + s = bytes(s) + self.builder.append(s) + + def getvalue(self): + return self.builder.build() + +else: + USING_STRINGBUILDER = False + from io import BytesIO as StringIO + + newlist_hint = lambda size: [] + + +from .exceptions import BufferFull, OutOfData, ExtraData, FormatError, StackError + +from .ext import ExtType, Timestamp + + +EX_SKIP = 0 +EX_CONSTRUCT = 1 +EX_READ_ARRAY_HEADER = 2 +EX_READ_MAP_HEADER = 3 + +TYPE_IMMEDIATE = 0 +TYPE_ARRAY = 1 +TYPE_MAP = 2 +TYPE_RAW = 3 +TYPE_BIN = 4 +TYPE_EXT = 5 + +DEFAULT_RECURSE_LIMIT = 511 + + +def _check_type_strict(obj, t, type=type, tuple=tuple): + if type(t) is tuple: + return type(obj) in t + else: + return type(obj) is t + + +def _get_data_from_buffer(obj): + view = memoryview(obj) + if view.itemsize != 1: + raise ValueError("cannot unpack from multi-byte object") + return view + + +def unpackb(packed, **kwargs): + """ + Unpack an object from `packed`. + + Raises ``ExtraData`` when *packed* contains extra bytes. + Raises ``ValueError`` when *packed* is incomplete. + Raises ``FormatError`` when *packed* is not valid msgpack. + Raises ``StackError`` when *packed* contains too nested. + Other exceptions can be raised during unpacking. + + See :class:`Unpacker` for options. + """ + unpacker = Unpacker(None, max_buffer_size=len(packed), **kwargs) + unpacker.feed(packed) + try: + ret = unpacker._unpack() + except OutOfData: + raise ValueError("Unpack failed: incomplete input") + except RecursionError: + raise StackError + if unpacker._got_extradata(): + raise ExtraData(ret, unpacker._get_extradata()) + return ret + + +_NO_FORMAT_USED = "" +_MSGPACK_HEADERS = { + 0xC4: (1, _NO_FORMAT_USED, TYPE_BIN), + 0xC5: (2, ">H", TYPE_BIN), + 0xC6: (4, ">I", TYPE_BIN), + 0xC7: (2, "Bb", TYPE_EXT), + 0xC8: (3, ">Hb", TYPE_EXT), + 0xC9: (5, ">Ib", TYPE_EXT), + 0xCA: (4, ">f"), + 0xCB: (8, ">d"), + 0xCC: (1, _NO_FORMAT_USED), + 0xCD: (2, ">H"), + 0xCE: (4, ">I"), + 0xCF: (8, ">Q"), + 0xD0: (1, "b"), + 0xD1: (2, ">h"), + 0xD2: (4, ">i"), + 0xD3: (8, ">q"), + 0xD4: (1, "b1s", TYPE_EXT), + 0xD5: (2, "b2s", TYPE_EXT), + 0xD6: (4, "b4s", TYPE_EXT), + 0xD7: (8, "b8s", TYPE_EXT), + 0xD8: (16, "b16s", TYPE_EXT), + 0xD9: (1, _NO_FORMAT_USED, TYPE_RAW), + 0xDA: (2, ">H", TYPE_RAW), + 0xDB: (4, ">I", TYPE_RAW), + 0xDC: (2, ">H", TYPE_ARRAY), + 0xDD: (4, ">I", TYPE_ARRAY), + 0xDE: (2, ">H", TYPE_MAP), + 0xDF: (4, ">I", TYPE_MAP), +} + + +class Unpacker: + """Streaming unpacker. + + Arguments: + + :param file_like: + File-like object having `.read(n)` method. + If specified, unpacker reads serialized data from it and `.feed()` is not usable. + + :param int read_size: + Used as `file_like.read(read_size)`. (default: `min(16*1024, max_buffer_size)`) + + :param bool use_list: + If true, unpack msgpack array to Python list. + Otherwise, unpack to Python tuple. (default: True) + + :param bool raw: + If true, unpack msgpack raw to Python bytes. + Otherwise, unpack to Python str by decoding with UTF-8 encoding (default). + + :param int timestamp: + Control how timestamp type is unpacked: + + 0 - Timestamp + 1 - float (Seconds from the EPOCH) + 2 - int (Nanoseconds from the EPOCH) + 3 - datetime.datetime (UTC). + + :param bool strict_map_key: + If true (default), only str or bytes are accepted for map (dict) keys. + + :param object_hook: + When specified, it should be callable. + Unpacker calls it with a dict argument after unpacking msgpack map. + (See also simplejson) + + :param object_pairs_hook: + When specified, it should be callable. + Unpacker calls it with a list of key-value pairs after unpacking msgpack map. + (See also simplejson) + + :param str unicode_errors: + The error handler for decoding unicode. (default: 'strict') + This option should be used only when you have msgpack data which + contains invalid UTF-8 string. + + :param int max_buffer_size: + Limits size of data waiting unpacked. 0 means 2**32-1. + The default value is 100*1024*1024 (100MiB). + Raises `BufferFull` exception when it is insufficient. + You should set this parameter when unpacking data from untrusted source. + + :param int max_str_len: + Deprecated, use *max_buffer_size* instead. + Limits max length of str. (default: max_buffer_size) + + :param int max_bin_len: + Deprecated, use *max_buffer_size* instead. + Limits max length of bin. (default: max_buffer_size) + + :param int max_array_len: + Limits max length of array. + (default: max_buffer_size) + + :param int max_map_len: + Limits max length of map. + (default: max_buffer_size//2) + + :param int max_ext_len: + Deprecated, use *max_buffer_size* instead. + Limits max size of ext type. (default: max_buffer_size) + + Example of streaming deserialize from file-like object:: + + unpacker = Unpacker(file_like) + for o in unpacker: + process(o) + + Example of streaming deserialize from socket:: + + unpacker = Unpacker() + while True: + buf = sock.recv(1024**2) + if not buf: + break + unpacker.feed(buf) + for o in unpacker: + process(o) + + Raises ``ExtraData`` when *packed* contains extra bytes. + Raises ``OutOfData`` when *packed* is incomplete. + Raises ``FormatError`` when *packed* is not valid msgpack. + Raises ``StackError`` when *packed* contains too nested. + Other exceptions can be raised during unpacking. + """ + + def __init__( + self, + file_like=None, + read_size=0, + use_list=True, + raw=False, + timestamp=0, + strict_map_key=True, + object_hook=None, + object_pairs_hook=None, + list_hook=None, + unicode_errors=None, + max_buffer_size=100 * 1024 * 1024, + ext_hook=ExtType, + max_str_len=-1, + max_bin_len=-1, + max_array_len=-1, + max_map_len=-1, + max_ext_len=-1, + ): + if unicode_errors is None: + unicode_errors = "strict" + + if file_like is None: + self._feeding = True + else: + if not callable(file_like.read): + raise TypeError("`file_like.read` must be callable") + self.file_like = file_like + self._feeding = False + + #: array of bytes fed. + self._buffer = bytearray() + #: Which position we currently reads + self._buff_i = 0 + + # When Unpacker is used as an iterable, between the calls to next(), + # the buffer is not "consumed" completely, for efficiency sake. + # Instead, it is done sloppily. To make sure we raise BufferFull at + # the correct moments, we have to keep track of how sloppy we were. + # Furthermore, when the buffer is incomplete (that is: in the case + # we raise an OutOfData) we need to rollback the buffer to the correct + # state, which _buf_checkpoint records. + self._buf_checkpoint = 0 + + if not max_buffer_size: + max_buffer_size = 2**31 - 1 + if max_str_len == -1: + max_str_len = max_buffer_size + if max_bin_len == -1: + max_bin_len = max_buffer_size + if max_array_len == -1: + max_array_len = max_buffer_size + if max_map_len == -1: + max_map_len = max_buffer_size // 2 + if max_ext_len == -1: + max_ext_len = max_buffer_size + + self._max_buffer_size = max_buffer_size + if read_size > self._max_buffer_size: + raise ValueError("read_size must be smaller than max_buffer_size") + self._read_size = read_size or min(self._max_buffer_size, 16 * 1024) + self._raw = bool(raw) + self._strict_map_key = bool(strict_map_key) + self._unicode_errors = unicode_errors + self._use_list = use_list + if not (0 <= timestamp <= 3): + raise ValueError("timestamp must be 0..3") + self._timestamp = timestamp + self._list_hook = list_hook + self._object_hook = object_hook + self._object_pairs_hook = object_pairs_hook + self._ext_hook = ext_hook + self._max_str_len = max_str_len + self._max_bin_len = max_bin_len + self._max_array_len = max_array_len + self._max_map_len = max_map_len + self._max_ext_len = max_ext_len + self._stream_offset = 0 + + if list_hook is not None and not callable(list_hook): + raise TypeError("`list_hook` is not callable") + if object_hook is not None and not callable(object_hook): + raise TypeError("`object_hook` is not callable") + if object_pairs_hook is not None and not callable(object_pairs_hook): + raise TypeError("`object_pairs_hook` is not callable") + if object_hook is not None and object_pairs_hook is not None: + raise TypeError("object_pairs_hook and object_hook are mutually exclusive") + if not callable(ext_hook): + raise TypeError("`ext_hook` is not callable") + + def feed(self, next_bytes): + assert self._feeding + view = _get_data_from_buffer(next_bytes) + if len(self._buffer) - self._buff_i + len(view) > self._max_buffer_size: + raise BufferFull + + # Strip buffer before checkpoint before reading file. + if self._buf_checkpoint > 0: + del self._buffer[: self._buf_checkpoint] + self._buff_i -= self._buf_checkpoint + self._buf_checkpoint = 0 + + # Use extend here: INPLACE_ADD += doesn't reliably typecast memoryview in jython + self._buffer.extend(view) + + def _consume(self): + """Gets rid of the used parts of the buffer.""" + self._stream_offset += self._buff_i - self._buf_checkpoint + self._buf_checkpoint = self._buff_i + + def _got_extradata(self): + return self._buff_i < len(self._buffer) + + def _get_extradata(self): + return self._buffer[self._buff_i :] + + def read_bytes(self, n): + ret = self._read(n, raise_outofdata=False) + self._consume() + return ret + + def _read(self, n, raise_outofdata=True): + # (int) -> bytearray + self._reserve(n, raise_outofdata=raise_outofdata) + i = self._buff_i + ret = self._buffer[i : i + n] + self._buff_i = i + len(ret) + return ret + + def _reserve(self, n, raise_outofdata=True): + remain_bytes = len(self._buffer) - self._buff_i - n + + # Fast path: buffer has n bytes already + if remain_bytes >= 0: + return + + if self._feeding: + self._buff_i = self._buf_checkpoint + raise OutOfData + + # Strip buffer before checkpoint before reading file. + if self._buf_checkpoint > 0: + del self._buffer[: self._buf_checkpoint] + self._buff_i -= self._buf_checkpoint + self._buf_checkpoint = 0 + + # Read from file + remain_bytes = -remain_bytes + if remain_bytes + len(self._buffer) > self._max_buffer_size: + raise BufferFull + while remain_bytes > 0: + to_read_bytes = max(self._read_size, remain_bytes) + read_data = self.file_like.read(to_read_bytes) + if not read_data: + break + assert isinstance(read_data, bytes) + self._buffer += read_data + remain_bytes -= len(read_data) + + if len(self._buffer) < n + self._buff_i and raise_outofdata: + self._buff_i = 0 # rollback + raise OutOfData + + def _read_header(self): + typ = TYPE_IMMEDIATE + n = 0 + obj = None + self._reserve(1) + b = self._buffer[self._buff_i] + self._buff_i += 1 + if b & 0b10000000 == 0: + obj = b + elif b & 0b11100000 == 0b11100000: + obj = -1 - (b ^ 0xFF) + elif b & 0b11100000 == 0b10100000: + n = b & 0b00011111 + typ = TYPE_RAW + if n > self._max_str_len: + raise ValueError(f"{n} exceeds max_str_len({self._max_str_len})") + obj = self._read(n) + elif b & 0b11110000 == 0b10010000: + n = b & 0b00001111 + typ = TYPE_ARRAY + if n > self._max_array_len: + raise ValueError(f"{n} exceeds max_array_len({self._max_array_len})") + elif b & 0b11110000 == 0b10000000: + n = b & 0b00001111 + typ = TYPE_MAP + if n > self._max_map_len: + raise ValueError(f"{n} exceeds max_map_len({self._max_map_len})") + elif b == 0xC0: + obj = None + elif b == 0xC2: + obj = False + elif b == 0xC3: + obj = True + elif 0xC4 <= b <= 0xC6: + size, fmt, typ = _MSGPACK_HEADERS[b] + self._reserve(size) + if len(fmt) > 0: + n = struct.unpack_from(fmt, self._buffer, self._buff_i)[0] + else: + n = self._buffer[self._buff_i] + self._buff_i += size + if n > self._max_bin_len: + raise ValueError(f"{n} exceeds max_bin_len({self._max_bin_len})") + obj = self._read(n) + elif 0xC7 <= b <= 0xC9: + size, fmt, typ = _MSGPACK_HEADERS[b] + self._reserve(size) + L, n = struct.unpack_from(fmt, self._buffer, self._buff_i) + self._buff_i += size + if L > self._max_ext_len: + raise ValueError(f"{L} exceeds max_ext_len({self._max_ext_len})") + obj = self._read(L) + elif 0xCA <= b <= 0xD3: + size, fmt = _MSGPACK_HEADERS[b] + self._reserve(size) + if len(fmt) > 0: + obj = struct.unpack_from(fmt, self._buffer, self._buff_i)[0] + else: + obj = self._buffer[self._buff_i] + self._buff_i += size + elif 0xD4 <= b <= 0xD8: + size, fmt, typ = _MSGPACK_HEADERS[b] + if self._max_ext_len < size: + raise ValueError(f"{size} exceeds max_ext_len({self._max_ext_len})") + self._reserve(size + 1) + n, obj = struct.unpack_from(fmt, self._buffer, self._buff_i) + self._buff_i += size + 1 + elif 0xD9 <= b <= 0xDB: + size, fmt, typ = _MSGPACK_HEADERS[b] + self._reserve(size) + if len(fmt) > 0: + (n,) = struct.unpack_from(fmt, self._buffer, self._buff_i) + else: + n = self._buffer[self._buff_i] + self._buff_i += size + if n > self._max_str_len: + raise ValueError(f"{n} exceeds max_str_len({self._max_str_len})") + obj = self._read(n) + elif 0xDC <= b <= 0xDD: + size, fmt, typ = _MSGPACK_HEADERS[b] + self._reserve(size) + (n,) = struct.unpack_from(fmt, self._buffer, self._buff_i) + self._buff_i += size + if n > self._max_array_len: + raise ValueError(f"{n} exceeds max_array_len({self._max_array_len})") + elif 0xDE <= b <= 0xDF: + size, fmt, typ = _MSGPACK_HEADERS[b] + self._reserve(size) + (n,) = struct.unpack_from(fmt, self._buffer, self._buff_i) + self._buff_i += size + if n > self._max_map_len: + raise ValueError(f"{n} exceeds max_map_len({self._max_map_len})") + else: + raise FormatError("Unknown header: 0x%x" % b) + return typ, n, obj + + def _unpack(self, execute=EX_CONSTRUCT): + typ, n, obj = self._read_header() + + if execute == EX_READ_ARRAY_HEADER: + if typ != TYPE_ARRAY: + raise ValueError("Expected array") + return n + if execute == EX_READ_MAP_HEADER: + if typ != TYPE_MAP: + raise ValueError("Expected map") + return n + # TODO should we eliminate the recursion? + if typ == TYPE_ARRAY: + if execute == EX_SKIP: + for i in range(n): + # TODO check whether we need to call `list_hook` + self._unpack(EX_SKIP) + return + ret = newlist_hint(n) + for i in range(n): + ret.append(self._unpack(EX_CONSTRUCT)) + if self._list_hook is not None: + ret = self._list_hook(ret) + # TODO is the interaction between `list_hook` and `use_list` ok? + return ret if self._use_list else tuple(ret) + if typ == TYPE_MAP: + if execute == EX_SKIP: + for i in range(n): + # TODO check whether we need to call hooks + self._unpack(EX_SKIP) + self._unpack(EX_SKIP) + return + if self._object_pairs_hook is not None: + ret = self._object_pairs_hook( + (self._unpack(EX_CONSTRUCT), self._unpack(EX_CONSTRUCT)) for _ in range(n) + ) + else: + ret = {} + for _ in range(n): + key = self._unpack(EX_CONSTRUCT) + if self._strict_map_key and type(key) not in (str, bytes): + raise ValueError("%s is not allowed for map key" % str(type(key))) + if isinstance(key, str): + key = sys.intern(key) + ret[key] = self._unpack(EX_CONSTRUCT) + if self._object_hook is not None: + ret = self._object_hook(ret) + return ret + if execute == EX_SKIP: + return + if typ == TYPE_RAW: + if self._raw: + obj = bytes(obj) + else: + obj = obj.decode("utf_8", self._unicode_errors) + return obj + if typ == TYPE_BIN: + return bytes(obj) + if typ == TYPE_EXT: + if n == -1: # timestamp + ts = Timestamp.from_bytes(bytes(obj)) + if self._timestamp == 1: + return ts.to_unix() + elif self._timestamp == 2: + return ts.to_unix_nano() + elif self._timestamp == 3: + return ts.to_datetime() + else: + return ts + else: + return self._ext_hook(n, bytes(obj)) + assert typ == TYPE_IMMEDIATE + return obj + + def __iter__(self): + return self + + def __next__(self): + try: + ret = self._unpack(EX_CONSTRUCT) + self._consume() + return ret + except OutOfData: + self._consume() + raise StopIteration + except RecursionError: + raise StackError + + next = __next__ + + def skip(self): + self._unpack(EX_SKIP) + self._consume() + + def unpack(self): + try: + ret = self._unpack(EX_CONSTRUCT) + except RecursionError: + raise StackError + self._consume() + return ret + + def read_array_header(self): + ret = self._unpack(EX_READ_ARRAY_HEADER) + self._consume() + return ret + + def read_map_header(self): + ret = self._unpack(EX_READ_MAP_HEADER) + self._consume() + return ret + + def tell(self): + return self._stream_offset + + +class Packer: + """ + MessagePack Packer + + Usage:: + + packer = Packer() + astream.write(packer.pack(a)) + astream.write(packer.pack(b)) + + Packer's constructor has some keyword arguments: + + :param default: + When specified, it should be callable. + Convert user type to builtin type that Packer supports. + See also simplejson's document. + + :param bool use_single_float: + Use single precision float type for float. (default: False) + + :param bool autoreset: + Reset buffer after each pack and return its content as `bytes`. (default: True). + If set this to false, use `bytes()` to get content and `.reset()` to clear buffer. + + :param bool use_bin_type: + Use bin type introduced in msgpack spec 2.0 for bytes. + It also enables str8 type for unicode. (default: True) + + :param bool strict_types: + If set to true, types will be checked to be exact. Derived classes + from serializable types will not be serialized and will be + treated as unsupported type and forwarded to default. + Additionally tuples will not be serialized as lists. + This is useful when trying to implement accurate serialization + for python types. + + :param bool datetime: + If set to true, datetime with tzinfo is packed into Timestamp type. + Note that the tzinfo is stripped in the timestamp. + You can get UTC datetime with `timestamp=3` option of the Unpacker. + + :param str unicode_errors: + The error handler for encoding unicode. (default: 'strict') + DO NOT USE THIS!! This option is kept for very specific usage. + + Example of streaming deserialize from file-like object:: + + unpacker = Unpacker(file_like) + for o in unpacker: + process(o) + + Example of streaming deserialize from socket:: + + unpacker = Unpacker() + while True: + buf = sock.recv(1024**2) + if not buf: + break + unpacker.feed(buf) + for o in unpacker: + process(o) + + Raises ``ExtraData`` when *packed* contains extra bytes. + Raises ``OutOfData`` when *packed* is incomplete. + Raises ``FormatError`` when *packed* is not valid msgpack. + Raises ``StackError`` when *packed* contains too nested. + Other exceptions can be raised during unpacking. + """ + + def __init__( + self, + default=None, + use_single_float=False, + autoreset=True, + use_bin_type=True, + strict_types=False, + datetime=False, + unicode_errors=None, + ): + self._strict_types = strict_types + self._use_float = use_single_float + self._autoreset = autoreset + self._use_bin_type = use_bin_type + self._buffer = StringIO() + self._datetime = bool(datetime) + self._unicode_errors = unicode_errors or "strict" + if default is not None: + if not callable(default): + raise TypeError("default must be callable") + self._default = default + + def _pack( + self, + obj, + nest_limit=DEFAULT_RECURSE_LIMIT, + check=isinstance, + check_type_strict=_check_type_strict, + ): + default_used = False + if self._strict_types: + check = check_type_strict + list_types = list + else: + list_types = (list, tuple) + while True: + if nest_limit < 0: + raise ValueError("recursion limit exceeded") + if obj is None: + return self._buffer.write(b"\xc0") + if check(obj, bool): + if obj: + return self._buffer.write(b"\xc3") + return self._buffer.write(b"\xc2") + if check(obj, int): + if 0 <= obj < 0x80: + return self._buffer.write(struct.pack("B", obj)) + if -0x20 <= obj < 0: + return self._buffer.write(struct.pack("b", obj)) + if 0x80 <= obj <= 0xFF: + return self._buffer.write(struct.pack("BB", 0xCC, obj)) + if -0x80 <= obj < 0: + return self._buffer.write(struct.pack(">Bb", 0xD0, obj)) + if 0xFF < obj <= 0xFFFF: + return self._buffer.write(struct.pack(">BH", 0xCD, obj)) + if -0x8000 <= obj < -0x80: + return self._buffer.write(struct.pack(">Bh", 0xD1, obj)) + if 0xFFFF < obj <= 0xFFFFFFFF: + return self._buffer.write(struct.pack(">BI", 0xCE, obj)) + if -0x80000000 <= obj < -0x8000: + return self._buffer.write(struct.pack(">Bi", 0xD2, obj)) + if 0xFFFFFFFF < obj <= 0xFFFFFFFFFFFFFFFF: + return self._buffer.write(struct.pack(">BQ", 0xCF, obj)) + if -0x8000000000000000 <= obj < -0x80000000: + return self._buffer.write(struct.pack(">Bq", 0xD3, obj)) + if not default_used and self._default is not None: + obj = self._default(obj) + default_used = True + continue + raise OverflowError("Integer value out of range") + if check(obj, (bytes, bytearray)): + n = len(obj) + if n >= 2**32: + raise ValueError("%s is too large" % type(obj).__name__) + self._pack_bin_header(n) + return self._buffer.write(obj) + if check(obj, str): + obj = obj.encode("utf-8", self._unicode_errors) + n = len(obj) + if n >= 2**32: + raise ValueError("String is too large") + self._pack_raw_header(n) + return self._buffer.write(obj) + if check(obj, memoryview): + n = obj.nbytes + if n >= 2**32: + raise ValueError("Memoryview is too large") + self._pack_bin_header(n) + return self._buffer.write(obj) + if check(obj, float): + if self._use_float: + return self._buffer.write(struct.pack(">Bf", 0xCA, obj)) + return self._buffer.write(struct.pack(">Bd", 0xCB, obj)) + if check(obj, (ExtType, Timestamp)): + if check(obj, Timestamp): + code = -1 + data = obj.to_bytes() + else: + code = obj.code + data = obj.data + assert isinstance(code, int) + assert isinstance(data, bytes) + L = len(data) + if L == 1: + self._buffer.write(b"\xd4") + elif L == 2: + self._buffer.write(b"\xd5") + elif L == 4: + self._buffer.write(b"\xd6") + elif L == 8: + self._buffer.write(b"\xd7") + elif L == 16: + self._buffer.write(b"\xd8") + elif L <= 0xFF: + self._buffer.write(struct.pack(">BB", 0xC7, L)) + elif L <= 0xFFFF: + self._buffer.write(struct.pack(">BH", 0xC8, L)) + else: + self._buffer.write(struct.pack(">BI", 0xC9, L)) + self._buffer.write(struct.pack("b", code)) + self._buffer.write(data) + return + if check(obj, list_types): + n = len(obj) + self._pack_array_header(n) + for i in range(n): + self._pack(obj[i], nest_limit - 1) + return + if check(obj, dict): + return self._pack_map_pairs(len(obj), obj.items(), nest_limit - 1) + + if self._datetime and check(obj, _DateTime) and obj.tzinfo is not None: + obj = Timestamp.from_datetime(obj) + default_used = 1 + continue + + if not default_used and self._default is not None: + obj = self._default(obj) + default_used = 1 + continue + + if self._datetime and check(obj, _DateTime): + raise ValueError(f"Cannot serialize {obj!r} where tzinfo=None") + + raise TypeError(f"Cannot serialize {obj!r}") + + def pack(self, obj): + try: + self._pack(obj) + except: + self._buffer = StringIO() # force reset + raise + if self._autoreset: + ret = self._buffer.getvalue() + self._buffer = StringIO() + return ret + + def pack_map_pairs(self, pairs): + self._pack_map_pairs(len(pairs), pairs) + if self._autoreset: + ret = self._buffer.getvalue() + self._buffer = StringIO() + return ret + + def pack_array_header(self, n): + if n >= 2**32: + raise ValueError + self._pack_array_header(n) + if self._autoreset: + ret = self._buffer.getvalue() + self._buffer = StringIO() + return ret + + def pack_map_header(self, n): + if n >= 2**32: + raise ValueError + self._pack_map_header(n) + if self._autoreset: + ret = self._buffer.getvalue() + self._buffer = StringIO() + return ret + + def pack_ext_type(self, typecode, data): + if not isinstance(typecode, int): + raise TypeError("typecode must have int type.") + if not 0 <= typecode <= 127: + raise ValueError("typecode should be 0-127") + if not isinstance(data, bytes): + raise TypeError("data must have bytes type") + L = len(data) + if L > 0xFFFFFFFF: + raise ValueError("Too large data") + if L == 1: + self._buffer.write(b"\xd4") + elif L == 2: + self._buffer.write(b"\xd5") + elif L == 4: + self._buffer.write(b"\xd6") + elif L == 8: + self._buffer.write(b"\xd7") + elif L == 16: + self._buffer.write(b"\xd8") + elif L <= 0xFF: + self._buffer.write(b"\xc7" + struct.pack("B", L)) + elif L <= 0xFFFF: + self._buffer.write(b"\xc8" + struct.pack(">H", L)) + else: + self._buffer.write(b"\xc9" + struct.pack(">I", L)) + self._buffer.write(struct.pack("B", typecode)) + self._buffer.write(data) + + def _pack_array_header(self, n): + if n <= 0x0F: + return self._buffer.write(struct.pack("B", 0x90 + n)) + if n <= 0xFFFF: + return self._buffer.write(struct.pack(">BH", 0xDC, n)) + if n <= 0xFFFFFFFF: + return self._buffer.write(struct.pack(">BI", 0xDD, n)) + raise ValueError("Array is too large") + + def _pack_map_header(self, n): + if n <= 0x0F: + return self._buffer.write(struct.pack("B", 0x80 + n)) + if n <= 0xFFFF: + return self._buffer.write(struct.pack(">BH", 0xDE, n)) + if n <= 0xFFFFFFFF: + return self._buffer.write(struct.pack(">BI", 0xDF, n)) + raise ValueError("Dict is too large") + + def _pack_map_pairs(self, n, pairs, nest_limit=DEFAULT_RECURSE_LIMIT): + self._pack_map_header(n) + for k, v in pairs: + self._pack(k, nest_limit - 1) + self._pack(v, nest_limit - 1) + + def _pack_raw_header(self, n): + if n <= 0x1F: + self._buffer.write(struct.pack("B", 0xA0 + n)) + elif self._use_bin_type and n <= 0xFF: + self._buffer.write(struct.pack(">BB", 0xD9, n)) + elif n <= 0xFFFF: + self._buffer.write(struct.pack(">BH", 0xDA, n)) + elif n <= 0xFFFFFFFF: + self._buffer.write(struct.pack(">BI", 0xDB, n)) + else: + raise ValueError("Raw is too large") + + def _pack_bin_header(self, n): + if not self._use_bin_type: + return self._pack_raw_header(n) + elif n <= 0xFF: + return self._buffer.write(struct.pack(">BB", 0xC4, n)) + elif n <= 0xFFFF: + return self._buffer.write(struct.pack(">BH", 0xC5, n)) + elif n <= 0xFFFFFFFF: + return self._buffer.write(struct.pack(">BI", 0xC6, n)) + else: + raise ValueError("Bin is too large") + + def bytes(self): + """Return internal buffer contents as bytes object""" + return self._buffer.getvalue() + + def reset(self): + """Reset internal buffer. + + This method is useful only when autoreset=False. + """ + self._buffer = StringIO() + + def getbuffer(self): + """Return view of internal buffer.""" + if USING_STRINGBUILDER: + return memoryview(self.bytes()) + else: + return self._buffer.getbuffer() diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__init__.py b/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__init__.py new file mode 100644 index 0000000..9ba41d8 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__init__.py @@ -0,0 +1,15 @@ +# This file is dual licensed under the terms of the Apache License, Version +# 2.0, and the BSD License. See the LICENSE file in the root of this repository +# for complete details. + +__title__ = "packaging" +__summary__ = "Core utilities for Python packages" +__uri__ = "https://github.com/pypa/packaging" + +__version__ = "24.1" + +__author__ = "Donald Stufft and individual contributors" +__email__ = "donald@stufft.io" + +__license__ = "BSD-2-Clause or Apache-2.0" +__copyright__ = "2014 %s" % __author__ diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..211b38f84f66b479d96fec92cbdbcf3ff5d22820 GIT binary patch literal 557 zcmYLGF^|(Q7nZbAZqZp&h&vDgb zMG>M_WYJF4q1~uUdr^-bMMtzB^{LHzO&_7it_Krm;}mi7HC_QWM3I>UGcIxQDLB63{RMU3xldf_~nHIoa$i)lDL&*D-s-(2IJu}|4F3{D$6Je|$` z=jzjBuyF{{pfg6uW=M!C^E{TdAvPhUgu`ydqyoVWaS4e_^Bifg>125f*+G**!noSo zc!VUPs3ojYO~?;)y$|+=;8f%c%YtbsDo9eC2+HtBPzeqy#w(n`!sM{e>SZtsu>#Ge zccI||3QUZQ3VELsCImQ`Awf~!3|{AgmKl2^M`oV+U8Lq_*>x?;+PTPk*gES`*bdk3 lw6(XR2kmg{y=vX{@srlsj!w+M_|f+dzsE1GJb7#y{{d%Aw2=S+ literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/_elffile.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/_elffile.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..3dcd4f9a55da4f4190be2a9d720511a0afff69f9 GIT binary patch literal 4973 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 H%!B=3UaZLg literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/_musllinux.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/_musllinux.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..6804a85fa5418912aee4363554712c92ef773a3f GIT binary patch literal 4568 zcmai1Z)_CD6`$GN`+tXhoQ;i5&^i#z1#^c@a0np=BWyyNxJ1xYxrD5j+c|sfz1w4U z58Ib>;u6|A5h|`)C8lYGX_0V5Dp9pksrsQwKJ-h!*f9;TAhlImseCh#Dh>V6zL~o{ z8yB^6x|!LTd9!ccyx;r1{X--YL{RR$cq#K8=zY!}+`?xN!uLMI2)&0iltLQT1OsP< zlz>@ZG{lt1TPY>+)|2w^)|>J|D;d75KjqH`Qh{tR6$BZN<~2gua4L+EfDRzdcM55K z61XImUz&<&Yqh{BDYc4-L+f2dmRhYz3!aiLRR&VETC)~{)lsrq3lDEbh`!6;9!tdp zL}EiQva(cV>q-64)|ImeX^~5CT2?IIb4Xj|u0M%k#|Ev2)L#omNOhwbdWS9vF+l9@0?9a@lfUtJ9dCJ03E#M)SCPXbo#&fontet^3i@FhZ$j zrX^|C8kfKG^ePFBiDP1XU2*DA∓UN2hER@_CcmiD2-^pl-=oQ!5xm*0XtoWJ%7p zWWyZL)3R;K8nH>*mi3Hm4-z?DpcLkfF_{)}IXyQZ9~!d<&77=TK|{|C6HQhJR6S?e za<*U@ZL*rv^D(D#6G+3~kC<1#n<8p7a;C3Li|Y^?uf_5o3G`{>-kIam(Q^%F8_unrZ`}KpCBf9mrgiu>dktmPZ8qdc%;}1C6{yIY zU)8q6Urq3af*+u`K$-7RX8E|!30iqWx4}t?<%kB!IRYgNT6TJ{?6K^&9M1qX3wgkp z*DToif=$^KJD#!_&T?gBDEzQa>>($ln?Rxg{?402?N+>x5vv+t=n5_HR(f- z%RJ+v&4LOq05#@^D~hY>VYC6YBMXlJR9*%gfNwuPD!zU#6uhA8mE{h&d=DCtJ@Fmv4aPnE!C91Gdx59FdQW$>~9o z9%dZIn9a(Qw4Tv{z{n^`7i{&IL0Vz$7{qp9LPl<|l<%YGGA0El2C^y>oSr*jRyQ(C zRU?#9Cr6^J1DlrpS_Uy$b(P{DHg-OKbYPOSym@qIr_%XEoWFxjxqxj?bR;^eqx&m|J4DR^s%GWqx$1lx zkb10-J^~kV1Y(ZYvf)hBk!&(*$3u=}=1GpS8*@UymW1Xh+y`}hUq9SKDez|C$XK3~ zyTO-Kqu}sg}u~G8W-HJq~9-r10A{!PF4s4z|eknv~_admm-WV z`jJ04QJi{drenVTF%I$iGhJ_YO?OOhyimOO=J_|T9Jw0WH?jX#X#KQ(?)9^;FNC(t zNn5_GVZv=REZ;ulqc{QE+NPc zA*&o0Y!;$1$;*=m2|UsvEmHva`r)2Hc--+TYJlsPy;C0E&!0+9s0(AiTf7jLH7~2X*_e z^^i)-s$~@*>xCBL1#Ckh@6}mS$V14(ECq+CY6c3kP{8%rx@2V6m;luR&4D4iA#Jau z*(+>W73UXKR=Dr>zo9t6>YUHD|k`<_qxJFf&gV1i+a3}n&L8y49^2Hid+j1dxasB!A3pLv&p1tm?ne#PV_piEM zTYnb`o;{P&t@@_vo#(pFcFlIo(uMjC0Ayg#WY6`w_0yy0-Z=Zl-1@|120fcN1nwe-^%G6s71bTeBE|&lE-mh0&siDZ8ua zVFrPQX}s$`mLXRYAy+R-uOzk}rBB0V_wiQx6tqQO<%;4G1#Ba*noS*V`9AK)mVboE zCAkm$6&5n1(q2{_VAZow!DtsW#fXc9S74u`e7+btSh-O?7GLN16h$-B<5g-qXFF$FXSZLLejWTp x@XGd&@WQrzA9c)c>s@F*un>8cF-prMzTuBds#B@Y{4zMJr)4pQq$X~Z{{TH5ey9Kd literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/_parser.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/_parser.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f14f94df578722b41c7aa66878fbb0d74d8a0704 GIT binary patch literal 13999 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 GjQ$@8#YSTQ literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/_structures.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/_structures.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..edc00ecbfdadf15b31cf72f3b7b0ae4c4e361f8e GIT binary patch literal 3240 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 EKZAW;kN^Mx literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/metadata.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/metadata.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..3e2097f0ddd74167bcdd0bb127fc5adf6ab769f5 GIT binary patch literal 24991 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/requirements.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/requirements.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5c344ae2da4ba2260d3fa45c4ebad139f94373d7 GIT binary patch literal 4409 zcmaJETWl29_1>AC@xHv?UE4T78jrCZv#s%l*lAD<4unVLP+Wprq;48bhn+DVvpZw% z%;F~%P5A%|2|FLPtq7U4kpd!7s8p%RS5)!YpEXN`HF8v>s%rCRY^tX2PtU!xv%5B{ zT+;h%7_b;`zK?LpTJNJfu6GG_k^uud{i{OnJK<1H(RGdLsoWhvmT!zc? zDL(5<`QV#ZeHkGurfL{2Wc=AcD!_0t6U>HEp=>x6X5TfL+H52hVYok2myM>P7;)%F zNDW*?YEX;a;zpW9) zHpw^G6^e~2#L{GX~@hOYNwQg^;?oPZ00g5$P8&j zvQ6pq@zc_4uN>%NgA62mj$fAPvSir_%5v6Ja~X<Ml4e{=X7qE((FuFlG`hR?znZjkTiZ9Pq%SDv zH7hx)k0xahQ%#a|iMnwIH5|T|C#xNq*NNaE69xK zan9?orAoeJ*#tHQ=LB}wZA$`2v#n0a%B6=TI45dc`0^a4la2PXGe7Q>6hoDmV_99& z8AZ1=OM2cBB-4QPoKw`y#J(Z$M~$9x$%ols?gHGiP8aP1#z9DgKTrKG4<0y=0?00U zB0|&nUJ<{{O>-lDCcgztBiZK>K!W85@7wLivBg3BB9JWR2!!lfPX=`8*=}pD&Uxg` z4!ZQrS+ipv2D)(%FZUHX0guXNFRcyqsMl<3zdmX=d8CmSJgnT?J3PE%hSHe!ZjW1i z^s-L1x#f}#CeQ?GMRw_Y+7Q`wnYYW9E7@V1_r~=4Y5sjqMVI+s@nd)ljq^W8WB4u} zNYpuT8Qg7aUL*7{Sx7lNxQ64S9_a8nl7Vl{c0||b2;_O>1WJzSh*_5R2(_&PxxmoI zWSLMqK=yEX7Gx5irDcYkc!d+nt^+zETZ-yn&7z(|^A~A!)n(n#ZCRddsED>Mxk%ju zGS(jfTtRCbALv9+mh9k^uOYV5A4#N`vv2 z5O^mMhJc*Lzs2(yLja8cb9*D5DjtFG-QLPBQ(ez<8n3_1sSx5H!sUF6FU?0&!?s46 z>{3|4$W~ViO&R|gz9eg z&h)M{?^zmO9RF0jV}Cw%cdD?rx6phrAAWJAp)tSX<$Pnu?Th(%;$b*J<@;v(R^yGc z>bx;$6yogdetd3xc4RjBFx;|ISATPAW@=@}&JP0KL`-CAZfZ80 zkGB=VZEHLVH~rV52mStAoo{vFbm@8k67^Shd7K3V%04_&$psp1a2{1W6sV=E!bZrw(OCvo$ZlkX}ZU01aZRM;$dz4z+~iL#dLc+ zCi#v;AE^gX(gUD!flyu%ZIrHXTZVI~C#X2R-C&8a=G(r7OScE}b&0$`@%)--_GW9k z0myvim5oM9mj|$lt(v9J!#+kz*NG_C0 zPC%B^8O5?-m_8j5ZNUQf;FoYNSXvR;wqm3;La#@RBbfFuyld!5dPRgN%i2ZopLj(~LJ2`>?|_(f0|51& zoeS+B?|xLbZ?zt7>6T|As(ooeUD6lzLU`|^&O={lUyXb@Qt0eo4)?DkUv1|KI9q5g zw2)hxUYuTz{$QO4V$lO{w||oSD7hTnzb*iAO+>NAdH3NIvg#q?T%>XMa;gwPNpyC^9r+vWw$fX6mr1*}t3EIC;{>XxCwQn6~e z)vJ)R^^C<_$_bvOuXFZ@cORA1`?l?H(|^!?`}UDjz@;~gMN>JHav1;Hk8tZhk@OFA j@N1O#8|wKQwZZS1$YcM)u4f3k|AbFq99%~fvRw0j_3x-L literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/specifiers.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/specifiers.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f893478a3c2b7de5ef94c83dd17a1d8f880ebd9d GIT binary patch literal 38763 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 Xh$kR=Zg>6zm)Jbl{}X|pY;6A<5H{eD literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/tags.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/tags.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..95789725e4ad912908cc0284de71b47fc2d4c819 GIT binary patch literal 21452 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/utils.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/__pycache__/utils.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..7a7382700a5bf20b497e8e6813e723b2d0c39eb5 GIT binary patch literal 7338 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 None: + self._f = f + + try: + ident = self._read("16B") + except struct.error: + raise ELFInvalid("unable to parse identification") + magic = bytes(ident[:4]) + if magic != b"\x7fELF": + raise ELFInvalid(f"invalid magic: {magic!r}") + + self.capacity = ident[4] # Format for program header (bitness). + self.encoding = ident[5] # Data structure encoding (endianness). + + try: + # e_fmt: Format for program header. + # p_fmt: Format for section header. + # p_idx: Indexes to find p_type, p_offset, and p_filesz. + e_fmt, self._p_fmt, self._p_idx = { + (1, 1): ("HHIIIIIHHH", ">IIIIIIII", (0, 1, 4)), # 32-bit MSB. + (2, 1): ("HHIQQQIHHH", ">IIQQQQQQ", (0, 2, 5)), # 64-bit MSB. + }[(self.capacity, self.encoding)] + except KeyError: + raise ELFInvalid( + f"unrecognized capacity ({self.capacity}) or " + f"encoding ({self.encoding})" + ) + + try: + ( + _, + self.machine, # Architecture type. + _, + _, + self._e_phoff, # Offset of program header. + _, + self.flags, # Processor-specific flags. + _, + self._e_phentsize, # Size of section. + self._e_phnum, # Number of sections. + ) = self._read(e_fmt) + except struct.error as e: + raise ELFInvalid("unable to parse machine and section information") from e + + def _read(self, fmt: str) -> tuple[int, ...]: + return struct.unpack(fmt, self._f.read(struct.calcsize(fmt))) + + @property + def interpreter(self) -> str | None: + """ + The path recorded in the ``PT_INTERP`` section header. + """ + for index in range(self._e_phnum): + self._f.seek(self._e_phoff + self._e_phentsize * index) + try: + data = self._read(self._p_fmt) + except struct.error: + continue + if data[self._p_idx[0]] != 3: # Not PT_INTERP. + continue + self._f.seek(data[self._p_idx[1]]) + return os.fsdecode(self._f.read(data[self._p_idx[2]])).strip("\0") + return None diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/_manylinux.py b/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/_manylinux.py new file mode 100644 index 0000000..08f651f --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/_manylinux.py @@ -0,0 +1,262 @@ +from __future__ import annotations + +import collections +import contextlib +import functools +import os +import re +import sys +import warnings +from typing import Generator, Iterator, NamedTuple, Sequence + +from ._elffile import EIClass, EIData, ELFFile, EMachine + +EF_ARM_ABIMASK = 0xFF000000 +EF_ARM_ABI_VER5 = 0x05000000 +EF_ARM_ABI_FLOAT_HARD = 0x00000400 + + +# `os.PathLike` not a generic type until Python 3.9, so sticking with `str` +# as the type for `path` until then. +@contextlib.contextmanager +def _parse_elf(path: str) -> Generator[ELFFile | None, None, None]: + try: + with open(path, "rb") as f: + yield ELFFile(f) + except (OSError, TypeError, ValueError): + yield None + + +def _is_linux_armhf(executable: str) -> bool: + # hard-float ABI can be detected from the ELF header of the running + # process + # https://static.docs.arm.com/ihi0044/g/aaelf32.pdf + with _parse_elf(executable) as f: + return ( + f is not None + and f.capacity == EIClass.C32 + and f.encoding == EIData.Lsb + and f.machine == EMachine.Arm + and f.flags & EF_ARM_ABIMASK == EF_ARM_ABI_VER5 + and f.flags & EF_ARM_ABI_FLOAT_HARD == EF_ARM_ABI_FLOAT_HARD + ) + + +def _is_linux_i686(executable: str) -> bool: + with _parse_elf(executable) as f: + return ( + f is not None + and f.capacity == EIClass.C32 + and f.encoding == EIData.Lsb + and f.machine == EMachine.I386 + ) + + +def _have_compatible_abi(executable: str, archs: Sequence[str]) -> bool: + if "armv7l" in archs: + return _is_linux_armhf(executable) + if "i686" in archs: + return _is_linux_i686(executable) + allowed_archs = { + "x86_64", + "aarch64", + "ppc64", + "ppc64le", + "s390x", + "loongarch64", + "riscv64", + } + return any(arch in allowed_archs for arch in archs) + + +# If glibc ever changes its major version, we need to know what the last +# minor version was, so we can build the complete list of all versions. +# For now, guess what the highest minor version might be, assume it will +# be 50 for testing. Once this actually happens, update the dictionary +# with the actual value. +_LAST_GLIBC_MINOR: dict[int, int] = collections.defaultdict(lambda: 50) + + +class _GLibCVersion(NamedTuple): + major: int + minor: int + + +def _glibc_version_string_confstr() -> str | None: + """ + Primary implementation of glibc_version_string using os.confstr. + """ + # os.confstr is quite a bit faster than ctypes.DLL. It's also less likely + # to be broken or missing. This strategy is used in the standard library + # platform module. + # https://github.com/python/cpython/blob/fcf1d003bf4f0100c/Lib/platform.py#L175-L183 + try: + # Should be a string like "glibc 2.17". + version_string: str | None = os.confstr("CS_GNU_LIBC_VERSION") + assert version_string is not None + _, version = version_string.rsplit() + except (AssertionError, AttributeError, OSError, ValueError): + # os.confstr() or CS_GNU_LIBC_VERSION not available (or a bad value)... + return None + return version + + +def _glibc_version_string_ctypes() -> str | None: + """ + Fallback implementation of glibc_version_string using ctypes. + """ + try: + import ctypes + except ImportError: + return None + + # ctypes.CDLL(None) internally calls dlopen(NULL), and as the dlopen + # manpage says, "If filename is NULL, then the returned handle is for the + # main program". This way we can let the linker do the work to figure out + # which libc our process is actually using. + # + # We must also handle the special case where the executable is not a + # dynamically linked executable. This can occur when using musl libc, + # for example. In this situation, dlopen() will error, leading to an + # OSError. Interestingly, at least in the case of musl, there is no + # errno set on the OSError. The single string argument used to construct + # OSError comes from libc itself and is therefore not portable to + # hard code here. In any case, failure to call dlopen() means we + # can proceed, so we bail on our attempt. + try: + process_namespace = ctypes.CDLL(None) + except OSError: + return None + + try: + gnu_get_libc_version = process_namespace.gnu_get_libc_version + except AttributeError: + # Symbol doesn't exist -> therefore, we are not linked to + # glibc. + return None + + # Call gnu_get_libc_version, which returns a string like "2.5" + gnu_get_libc_version.restype = ctypes.c_char_p + version_str: str = gnu_get_libc_version() + # py2 / py3 compatibility: + if not isinstance(version_str, str): + version_str = version_str.decode("ascii") + + return version_str + + +def _glibc_version_string() -> str | None: + """Returns glibc version string, or None if not using glibc.""" + return _glibc_version_string_confstr() or _glibc_version_string_ctypes() + + +def _parse_glibc_version(version_str: str) -> tuple[int, int]: + """Parse glibc version. + + We use a regexp instead of str.split because we want to discard any + random junk that might come after the minor version -- this might happen + in patched/forked versions of glibc (e.g. Linaro's version of glibc + uses version strings like "2.20-2014.11"). See gh-3588. + """ + m = re.match(r"(?P[0-9]+)\.(?P[0-9]+)", version_str) + if not m: + warnings.warn( + f"Expected glibc version with 2 components major.minor," + f" got: {version_str}", + RuntimeWarning, + ) + return -1, -1 + return int(m.group("major")), int(m.group("minor")) + + +@functools.lru_cache +def _get_glibc_version() -> tuple[int, int]: + version_str = _glibc_version_string() + if version_str is None: + return (-1, -1) + return _parse_glibc_version(version_str) + + +# From PEP 513, PEP 600 +def _is_compatible(arch: str, version: _GLibCVersion) -> bool: + sys_glibc = _get_glibc_version() + if sys_glibc < version: + return False + # Check for presence of _manylinux module. + try: + import _manylinux + except ImportError: + return True + if hasattr(_manylinux, "manylinux_compatible"): + result = _manylinux.manylinux_compatible(version[0], version[1], arch) + if result is not None: + return bool(result) + return True + if version == _GLibCVersion(2, 5): + if hasattr(_manylinux, "manylinux1_compatible"): + return bool(_manylinux.manylinux1_compatible) + if version == _GLibCVersion(2, 12): + if hasattr(_manylinux, "manylinux2010_compatible"): + return bool(_manylinux.manylinux2010_compatible) + if version == _GLibCVersion(2, 17): + if hasattr(_manylinux, "manylinux2014_compatible"): + return bool(_manylinux.manylinux2014_compatible) + return True + + +_LEGACY_MANYLINUX_MAP = { + # CentOS 7 w/ glibc 2.17 (PEP 599) + (2, 17): "manylinux2014", + # CentOS 6 w/ glibc 2.12 (PEP 571) + (2, 12): "manylinux2010", + # CentOS 5 w/ glibc 2.5 (PEP 513) + (2, 5): "manylinux1", +} + + +def platform_tags(archs: Sequence[str]) -> Iterator[str]: + """Generate manylinux tags compatible to the current platform. + + :param archs: Sequence of compatible architectures. + The first one shall be the closest to the actual architecture and be the part of + platform tag after the ``linux_`` prefix, e.g. ``x86_64``. + The ``linux_`` prefix is assumed as a prerequisite for the current platform to + be manylinux-compatible. + + :returns: An iterator of compatible manylinux tags. + """ + if not _have_compatible_abi(sys.executable, archs): + return + # Oldest glibc to be supported regardless of architecture is (2, 17). + too_old_glibc2 = _GLibCVersion(2, 16) + if set(archs) & {"x86_64", "i686"}: + # On x86/i686 also oldest glibc to be supported is (2, 5). + too_old_glibc2 = _GLibCVersion(2, 4) + current_glibc = _GLibCVersion(*_get_glibc_version()) + glibc_max_list = [current_glibc] + # We can assume compatibility across glibc major versions. + # https://sourceware.org/bugzilla/show_bug.cgi?id=24636 + # + # Build a list of maximum glibc versions so that we can + # output the canonical list of all glibc from current_glibc + # down to too_old_glibc2, including all intermediary versions. + for glibc_major in range(current_glibc.major - 1, 1, -1): + glibc_minor = _LAST_GLIBC_MINOR[glibc_major] + glibc_max_list.append(_GLibCVersion(glibc_major, glibc_minor)) + for arch in archs: + for glibc_max in glibc_max_list: + if glibc_max.major == too_old_glibc2.major: + min_minor = too_old_glibc2.minor + else: + # For other glibc major versions oldest supported is (x, 0). + min_minor = -1 + for glibc_minor in range(glibc_max.minor, min_minor, -1): + glibc_version = _GLibCVersion(glibc_max.major, glibc_minor) + tag = "manylinux_{}_{}".format(*glibc_version) + if _is_compatible(arch, glibc_version): + yield f"{tag}_{arch}" + # Handle the legacy manylinux1, manylinux2010, manylinux2014 tags. + if glibc_version in _LEGACY_MANYLINUX_MAP: + legacy_tag = _LEGACY_MANYLINUX_MAP[glibc_version] + if _is_compatible(arch, glibc_version): + yield f"{legacy_tag}_{arch}" diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/_musllinux.py b/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/_musllinux.py new file mode 100644 index 0000000..d2bf30b --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/_musllinux.py @@ -0,0 +1,85 @@ +"""PEP 656 support. + +This module implements logic to detect if the currently running Python is +linked against musl, and what musl version is used. +""" + +from __future__ import annotations + +import functools +import re +import subprocess +import sys +from typing import Iterator, NamedTuple, Sequence + +from ._elffile import ELFFile + + +class _MuslVersion(NamedTuple): + major: int + minor: int + + +def _parse_musl_version(output: str) -> _MuslVersion | None: + lines = [n for n in (n.strip() for n in output.splitlines()) if n] + if len(lines) < 2 or lines[0][:4] != "musl": + return None + m = re.match(r"Version (\d+)\.(\d+)", lines[1]) + if not m: + return None + return _MuslVersion(major=int(m.group(1)), minor=int(m.group(2))) + + +@functools.lru_cache +def _get_musl_version(executable: str) -> _MuslVersion | None: + """Detect currently-running musl runtime version. + + This is done by checking the specified executable's dynamic linking + information, and invoking the loader to parse its output for a version + string. If the loader is musl, the output would be something like:: + + musl libc (x86_64) + Version 1.2.2 + Dynamic Program Loader + """ + try: + with open(executable, "rb") as f: + ld = ELFFile(f).interpreter + except (OSError, TypeError, ValueError): + return None + if ld is None or "musl" not in ld: + return None + proc = subprocess.run([ld], stderr=subprocess.PIPE, text=True) + return _parse_musl_version(proc.stderr) + + +def platform_tags(archs: Sequence[str]) -> Iterator[str]: + """Generate musllinux tags compatible to the current platform. + + :param archs: Sequence of compatible architectures. + The first one shall be the closest to the actual architecture and be the part of + platform tag after the ``linux_`` prefix, e.g. ``x86_64``. + The ``linux_`` prefix is assumed as a prerequisite for the current platform to + be musllinux-compatible. + + :returns: An iterator of compatible musllinux tags. + """ + sys_musl = _get_musl_version(sys.executable) + if sys_musl is None: # Python not dynamically linked against musl. + return + for arch in archs: + for minor in range(sys_musl.minor, -1, -1): + yield f"musllinux_{sys_musl.major}_{minor}_{arch}" + + +if __name__ == "__main__": # pragma: no cover + import sysconfig + + plat = sysconfig.get_platform() + assert plat.startswith("linux-"), "not linux" + + print("plat:", plat) + print("musl:", _get_musl_version(sys.executable)) + print("tags:", end=" ") + for t in platform_tags(re.sub(r"[.-]", "_", plat.split("-", 1)[-1])): + print(t, end="\n ") diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/_parser.py b/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/_parser.py new file mode 100644 index 0000000..c1238c0 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/_parser.py @@ -0,0 +1,354 @@ +"""Handwritten parser of dependency specifiers. + +The docstring for each __parse_* function contains EBNF-inspired grammar representing +the implementation. +""" + +from __future__ import annotations + +import ast +from typing import NamedTuple, Sequence, Tuple, Union + +from ._tokenizer import DEFAULT_RULES, Tokenizer + + +class Node: + def __init__(self, value: str) -> None: + self.value = value + + def __str__(self) -> str: + return self.value + + def __repr__(self) -> str: + return f"<{self.__class__.__name__}('{self}')>" + + def serialize(self) -> str: + raise NotImplementedError + + +class Variable(Node): + def serialize(self) -> str: + return str(self) + + +class Value(Node): + def serialize(self) -> str: + return f'"{self}"' + + +class Op(Node): + def serialize(self) -> str: + return str(self) + + +MarkerVar = Union[Variable, Value] +MarkerItem = Tuple[MarkerVar, Op, MarkerVar] +MarkerAtom = Union[MarkerItem, Sequence["MarkerAtom"]] +MarkerList = Sequence[Union["MarkerList", MarkerAtom, str]] + + +class ParsedRequirement(NamedTuple): + name: str + url: str + extras: list[str] + specifier: str + marker: MarkerList | None + + +# -------------------------------------------------------------------------------------- +# Recursive descent parser for dependency specifier +# -------------------------------------------------------------------------------------- +def parse_requirement(source: str) -> ParsedRequirement: + return _parse_requirement(Tokenizer(source, rules=DEFAULT_RULES)) + + +def _parse_requirement(tokenizer: Tokenizer) -> ParsedRequirement: + """ + requirement = WS? IDENTIFIER WS? extras WS? requirement_details + """ + tokenizer.consume("WS") + + name_token = tokenizer.expect( + "IDENTIFIER", expected="package name at the start of dependency specifier" + ) + name = name_token.text + tokenizer.consume("WS") + + extras = _parse_extras(tokenizer) + tokenizer.consume("WS") + + url, specifier, marker = _parse_requirement_details(tokenizer) + tokenizer.expect("END", expected="end of dependency specifier") + + return ParsedRequirement(name, url, extras, specifier, marker) + + +def _parse_requirement_details( + tokenizer: Tokenizer, +) -> tuple[str, str, MarkerList | None]: + """ + requirement_details = AT URL (WS requirement_marker?)? + | specifier WS? (requirement_marker)? + """ + + specifier = "" + url = "" + marker = None + + if tokenizer.check("AT"): + tokenizer.read() + tokenizer.consume("WS") + + url_start = tokenizer.position + url = tokenizer.expect("URL", expected="URL after @").text + if tokenizer.check("END", peek=True): + return (url, specifier, marker) + + tokenizer.expect("WS", expected="whitespace after URL") + + # The input might end after whitespace. + if tokenizer.check("END", peek=True): + return (url, specifier, marker) + + marker = _parse_requirement_marker( + tokenizer, span_start=url_start, after="URL and whitespace" + ) + else: + specifier_start = tokenizer.position + specifier = _parse_specifier(tokenizer) + tokenizer.consume("WS") + + if tokenizer.check("END", peek=True): + return (url, specifier, marker) + + marker = _parse_requirement_marker( + tokenizer, + span_start=specifier_start, + after=( + "version specifier" + if specifier + else "name and no valid version specifier" + ), + ) + + return (url, specifier, marker) + + +def _parse_requirement_marker( + tokenizer: Tokenizer, *, span_start: int, after: str +) -> MarkerList: + """ + requirement_marker = SEMICOLON marker WS? + """ + + if not tokenizer.check("SEMICOLON"): + tokenizer.raise_syntax_error( + f"Expected end or semicolon (after {after})", + span_start=span_start, + ) + tokenizer.read() + + marker = _parse_marker(tokenizer) + tokenizer.consume("WS") + + return marker + + +def _parse_extras(tokenizer: Tokenizer) -> list[str]: + """ + extras = (LEFT_BRACKET wsp* extras_list? wsp* RIGHT_BRACKET)? + """ + if not tokenizer.check("LEFT_BRACKET", peek=True): + return [] + + with tokenizer.enclosing_tokens( + "LEFT_BRACKET", + "RIGHT_BRACKET", + around="extras", + ): + tokenizer.consume("WS") + extras = _parse_extras_list(tokenizer) + tokenizer.consume("WS") + + return extras + + +def _parse_extras_list(tokenizer: Tokenizer) -> list[str]: + """ + extras_list = identifier (wsp* ',' wsp* identifier)* + """ + extras: list[str] = [] + + if not tokenizer.check("IDENTIFIER"): + return extras + + extras.append(tokenizer.read().text) + + while True: + tokenizer.consume("WS") + if tokenizer.check("IDENTIFIER", peek=True): + tokenizer.raise_syntax_error("Expected comma between extra names") + elif not tokenizer.check("COMMA"): + break + + tokenizer.read() + tokenizer.consume("WS") + + extra_token = tokenizer.expect("IDENTIFIER", expected="extra name after comma") + extras.append(extra_token.text) + + return extras + + +def _parse_specifier(tokenizer: Tokenizer) -> str: + """ + specifier = LEFT_PARENTHESIS WS? version_many WS? RIGHT_PARENTHESIS + | WS? version_many WS? + """ + with tokenizer.enclosing_tokens( + "LEFT_PARENTHESIS", + "RIGHT_PARENTHESIS", + around="version specifier", + ): + tokenizer.consume("WS") + parsed_specifiers = _parse_version_many(tokenizer) + tokenizer.consume("WS") + + return parsed_specifiers + + +def _parse_version_many(tokenizer: Tokenizer) -> str: + """ + version_many = (SPECIFIER (WS? COMMA WS? SPECIFIER)*)? + """ + parsed_specifiers = "" + while tokenizer.check("SPECIFIER"): + span_start = tokenizer.position + parsed_specifiers += tokenizer.read().text + if tokenizer.check("VERSION_PREFIX_TRAIL", peek=True): + tokenizer.raise_syntax_error( + ".* suffix can only be used with `==` or `!=` operators", + span_start=span_start, + span_end=tokenizer.position + 1, + ) + if tokenizer.check("VERSION_LOCAL_LABEL_TRAIL", peek=True): + tokenizer.raise_syntax_error( + "Local version label can only be used with `==` or `!=` operators", + span_start=span_start, + span_end=tokenizer.position, + ) + tokenizer.consume("WS") + if not tokenizer.check("COMMA"): + break + parsed_specifiers += tokenizer.read().text + tokenizer.consume("WS") + + return parsed_specifiers + + +# -------------------------------------------------------------------------------------- +# Recursive descent parser for marker expression +# -------------------------------------------------------------------------------------- +def parse_marker(source: str) -> MarkerList: + return _parse_full_marker(Tokenizer(source, rules=DEFAULT_RULES)) + + +def _parse_full_marker(tokenizer: Tokenizer) -> MarkerList: + retval = _parse_marker(tokenizer) + tokenizer.expect("END", expected="end of marker expression") + return retval + + +def _parse_marker(tokenizer: Tokenizer) -> MarkerList: + """ + marker = marker_atom (BOOLOP marker_atom)+ + """ + expression = [_parse_marker_atom(tokenizer)] + while tokenizer.check("BOOLOP"): + token = tokenizer.read() + expr_right = _parse_marker_atom(tokenizer) + expression.extend((token.text, expr_right)) + return expression + + +def _parse_marker_atom(tokenizer: Tokenizer) -> MarkerAtom: + """ + marker_atom = WS? LEFT_PARENTHESIS WS? marker WS? RIGHT_PARENTHESIS WS? + | WS? marker_item WS? + """ + + tokenizer.consume("WS") + if tokenizer.check("LEFT_PARENTHESIS", peek=True): + with tokenizer.enclosing_tokens( + "LEFT_PARENTHESIS", + "RIGHT_PARENTHESIS", + around="marker expression", + ): + tokenizer.consume("WS") + marker: MarkerAtom = _parse_marker(tokenizer) + tokenizer.consume("WS") + else: + marker = _parse_marker_item(tokenizer) + tokenizer.consume("WS") + return marker + + +def _parse_marker_item(tokenizer: Tokenizer) -> MarkerItem: + """ + marker_item = WS? marker_var WS? marker_op WS? marker_var WS? + """ + tokenizer.consume("WS") + marker_var_left = _parse_marker_var(tokenizer) + tokenizer.consume("WS") + marker_op = _parse_marker_op(tokenizer) + tokenizer.consume("WS") + marker_var_right = _parse_marker_var(tokenizer) + tokenizer.consume("WS") + return (marker_var_left, marker_op, marker_var_right) + + +def _parse_marker_var(tokenizer: Tokenizer) -> MarkerVar: + """ + marker_var = VARIABLE | QUOTED_STRING + """ + if tokenizer.check("VARIABLE"): + return process_env_var(tokenizer.read().text.replace(".", "_")) + elif tokenizer.check("QUOTED_STRING"): + return process_python_str(tokenizer.read().text) + else: + tokenizer.raise_syntax_error( + message="Expected a marker variable or quoted string" + ) + + +def process_env_var(env_var: str) -> Variable: + if env_var in ("platform_python_implementation", "python_implementation"): + return Variable("platform_python_implementation") + else: + return Variable(env_var) + + +def process_python_str(python_str: str) -> Value: + value = ast.literal_eval(python_str) + return Value(str(value)) + + +def _parse_marker_op(tokenizer: Tokenizer) -> Op: + """ + marker_op = IN | NOT IN | OP + """ + if tokenizer.check("IN"): + tokenizer.read() + return Op("in") + elif tokenizer.check("NOT"): + tokenizer.read() + tokenizer.expect("WS", expected="whitespace after 'not'") + tokenizer.expect("IN", expected="'in' after 'not'") + return Op("not in") + elif tokenizer.check("OP"): + return Op(tokenizer.read().text) + else: + return tokenizer.raise_syntax_error( + "Expected marker operator, one of " + "<=, <, !=, ==, >=, >, ~=, ===, in, not in" + ) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/_structures.py b/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/_structures.py new file mode 100644 index 0000000..90a6465 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/_structures.py @@ -0,0 +1,61 @@ +# This file is dual licensed under the terms of the Apache License, Version +# 2.0, and the BSD License. See the LICENSE file in the root of this repository +# for complete details. + + +class InfinityType: + def __repr__(self) -> str: + return "Infinity" + + def __hash__(self) -> int: + return hash(repr(self)) + + def __lt__(self, other: object) -> bool: + return False + + def __le__(self, other: object) -> bool: + return False + + def __eq__(self, other: object) -> bool: + return isinstance(other, self.__class__) + + def __gt__(self, other: object) -> bool: + return True + + def __ge__(self, other: object) -> bool: + return True + + def __neg__(self: object) -> "NegativeInfinityType": + return NegativeInfinity + + +Infinity = InfinityType() + + +class NegativeInfinityType: + def __repr__(self) -> str: + return "-Infinity" + + def __hash__(self) -> int: + return hash(repr(self)) + + def __lt__(self, other: object) -> bool: + return True + + def __le__(self, other: object) -> bool: + return True + + def __eq__(self, other: object) -> bool: + return isinstance(other, self.__class__) + + def __gt__(self, other: object) -> bool: + return False + + def __ge__(self, other: object) -> bool: + return False + + def __neg__(self: object) -> InfinityType: + return Infinity + + +NegativeInfinity = NegativeInfinityType() diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/_tokenizer.py b/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/_tokenizer.py new file mode 100644 index 0000000..89d0416 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/_tokenizer.py @@ -0,0 +1,194 @@ +from __future__ import annotations + +import contextlib +import re +from dataclasses import dataclass +from typing import Iterator, NoReturn + +from .specifiers import Specifier + + +@dataclass +class Token: + name: str + text: str + position: int + + +class ParserSyntaxError(Exception): + """The provided source text could not be parsed correctly.""" + + def __init__( + self, + message: str, + *, + source: str, + span: tuple[int, int], + ) -> None: + self.span = span + self.message = message + self.source = source + + super().__init__() + + def __str__(self) -> str: + marker = " " * self.span[0] + "~" * (self.span[1] - self.span[0]) + "^" + return "\n ".join([self.message, self.source, marker]) + + +DEFAULT_RULES: dict[str, str | re.Pattern[str]] = { + "LEFT_PARENTHESIS": r"\(", + "RIGHT_PARENTHESIS": r"\)", + "LEFT_BRACKET": r"\[", + "RIGHT_BRACKET": r"\]", + "SEMICOLON": r";", + "COMMA": r",", + "QUOTED_STRING": re.compile( + r""" + ( + ('[^']*') + | + ("[^"]*") + ) + """, + re.VERBOSE, + ), + "OP": r"(===|==|~=|!=|<=|>=|<|>)", + "BOOLOP": r"\b(or|and)\b", + "IN": r"\bin\b", + "NOT": r"\bnot\b", + "VARIABLE": re.compile( + r""" + \b( + python_version + |python_full_version + |os[._]name + |sys[._]platform + |platform_(release|system) + |platform[._](version|machine|python_implementation) + |python_implementation + |implementation_(name|version) + |extra + )\b + """, + re.VERBOSE, + ), + "SPECIFIER": re.compile( + Specifier._operator_regex_str + Specifier._version_regex_str, + re.VERBOSE | re.IGNORECASE, + ), + "AT": r"\@", + "URL": r"[^ \t]+", + "IDENTIFIER": r"\b[a-zA-Z0-9][a-zA-Z0-9._-]*\b", + "VERSION_PREFIX_TRAIL": r"\.\*", + "VERSION_LOCAL_LABEL_TRAIL": r"\+[a-z0-9]+(?:[-_\.][a-z0-9]+)*", + "WS": r"[ \t]+", + "END": r"$", +} + + +class Tokenizer: + """Context-sensitive token parsing. + + Provides methods to examine the input stream to check whether the next token + matches. + """ + + def __init__( + self, + source: str, + *, + rules: dict[str, str | re.Pattern[str]], + ) -> None: + self.source = source + self.rules: dict[str, re.Pattern[str]] = { + name: re.compile(pattern) for name, pattern in rules.items() + } + self.next_token: Token | None = None + self.position = 0 + + def consume(self, name: str) -> None: + """Move beyond provided token name, if at current position.""" + if self.check(name): + self.read() + + def check(self, name: str, *, peek: bool = False) -> bool: + """Check whether the next token has the provided name. + + By default, if the check succeeds, the token *must* be read before + another check. If `peek` is set to `True`, the token is not loaded and + would need to be checked again. + """ + assert ( + self.next_token is None + ), f"Cannot check for {name!r}, already have {self.next_token!r}" + assert name in self.rules, f"Unknown token name: {name!r}" + + expression = self.rules[name] + + match = expression.match(self.source, self.position) + if match is None: + return False + if not peek: + self.next_token = Token(name, match[0], self.position) + return True + + def expect(self, name: str, *, expected: str) -> Token: + """Expect a certain token name next, failing with a syntax error otherwise. + + The token is *not* read. + """ + if not self.check(name): + raise self.raise_syntax_error(f"Expected {expected}") + return self.read() + + def read(self) -> Token: + """Consume the next token and return it.""" + token = self.next_token + assert token is not None + + self.position += len(token.text) + self.next_token = None + + return token + + def raise_syntax_error( + self, + message: str, + *, + span_start: int | None = None, + span_end: int | None = None, + ) -> NoReturn: + """Raise ParserSyntaxError at the given position.""" + span = ( + self.position if span_start is None else span_start, + self.position if span_end is None else span_end, + ) + raise ParserSyntaxError( + message, + source=self.source, + span=span, + ) + + @contextlib.contextmanager + def enclosing_tokens( + self, open_token: str, close_token: str, *, around: str + ) -> Iterator[None]: + if self.check(open_token): + open_position = self.position + self.read() + else: + open_position = None + + yield + + if open_position is None: + return + + if not self.check(close_token): + self.raise_syntax_error( + f"Expected matching {close_token} for {open_token}, after {around}", + span_start=open_position, + ) + + self.read() diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/markers.py b/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/markers.py new file mode 100644 index 0000000..7ac7bb6 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/markers.py @@ -0,0 +1,325 @@ +# This file is dual licensed under the terms of the Apache License, Version +# 2.0, and the BSD License. See the LICENSE file in the root of this repository +# for complete details. + +from __future__ import annotations + +import operator +import os +import platform +import sys +from typing import Any, Callable, TypedDict, cast + +from ._parser import MarkerAtom, MarkerList, Op, Value, Variable +from ._parser import parse_marker as _parse_marker +from ._tokenizer import ParserSyntaxError +from .specifiers import InvalidSpecifier, Specifier +from .utils import canonicalize_name + +__all__ = [ + "InvalidMarker", + "UndefinedComparison", + "UndefinedEnvironmentName", + "Marker", + "default_environment", +] + +Operator = Callable[[str, str], bool] + + +class InvalidMarker(ValueError): + """ + An invalid marker was found, users should refer to PEP 508. + """ + + +class UndefinedComparison(ValueError): + """ + An invalid operation was attempted on a value that doesn't support it. + """ + + +class UndefinedEnvironmentName(ValueError): + """ + A name was attempted to be used that does not exist inside of the + environment. + """ + + +class Environment(TypedDict): + implementation_name: str + """The implementation's identifier, e.g. ``'cpython'``.""" + + implementation_version: str + """ + The implementation's version, e.g. ``'3.13.0a2'`` for CPython 3.13.0a2, or + ``'7.3.13'`` for PyPy3.10 v7.3.13. + """ + + os_name: str + """ + The value of :py:data:`os.name`. The name of the operating system dependent module + imported, e.g. ``'posix'``. + """ + + platform_machine: str + """ + Returns the machine type, e.g. ``'i386'``. + + An empty string if the value cannot be determined. + """ + + platform_release: str + """ + The system's release, e.g. ``'2.2.0'`` or ``'NT'``. + + An empty string if the value cannot be determined. + """ + + platform_system: str + """ + The system/OS name, e.g. ``'Linux'``, ``'Windows'`` or ``'Java'``. + + An empty string if the value cannot be determined. + """ + + platform_version: str + """ + The system's release version, e.g. ``'#3 on degas'``. + + An empty string if the value cannot be determined. + """ + + python_full_version: str + """ + The Python version as string ``'major.minor.patchlevel'``. + + Note that unlike the Python :py:data:`sys.version`, this value will always include + the patchlevel (it defaults to 0). + """ + + platform_python_implementation: str + """ + A string identifying the Python implementation, e.g. ``'CPython'``. + """ + + python_version: str + """The Python version as string ``'major.minor'``.""" + + sys_platform: str + """ + This string contains a platform identifier that can be used to append + platform-specific components to :py:data:`sys.path`, for instance. + + For Unix systems, except on Linux and AIX, this is the lowercased OS name as + returned by ``uname -s`` with the first part of the version as returned by + ``uname -r`` appended, e.g. ``'sunos5'`` or ``'freebsd8'``, at the time when Python + was built. + """ + + +def _normalize_extra_values(results: Any) -> Any: + """ + Normalize extra values. + """ + if isinstance(results[0], tuple): + lhs, op, rhs = results[0] + if isinstance(lhs, Variable) and lhs.value == "extra": + normalized_extra = canonicalize_name(rhs.value) + rhs = Value(normalized_extra) + elif isinstance(rhs, Variable) and rhs.value == "extra": + normalized_extra = canonicalize_name(lhs.value) + lhs = Value(normalized_extra) + results[0] = lhs, op, rhs + return results + + +def _format_marker( + marker: list[str] | MarkerAtom | str, first: bool | None = True +) -> str: + assert isinstance(marker, (list, tuple, str)) + + # Sometimes we have a structure like [[...]] which is a single item list + # where the single item is itself it's own list. In that case we want skip + # the rest of this function so that we don't get extraneous () on the + # outside. + if ( + isinstance(marker, list) + and len(marker) == 1 + and isinstance(marker[0], (list, tuple)) + ): + return _format_marker(marker[0]) + + if isinstance(marker, list): + inner = (_format_marker(m, first=False) for m in marker) + if first: + return " ".join(inner) + else: + return "(" + " ".join(inner) + ")" + elif isinstance(marker, tuple): + return " ".join([m.serialize() for m in marker]) + else: + return marker + + +_operators: dict[str, Operator] = { + "in": lambda lhs, rhs: lhs in rhs, + "not in": lambda lhs, rhs: lhs not in rhs, + "<": operator.lt, + "<=": operator.le, + "==": operator.eq, + "!=": operator.ne, + ">=": operator.ge, + ">": operator.gt, +} + + +def _eval_op(lhs: str, op: Op, rhs: str) -> bool: + try: + spec = Specifier("".join([op.serialize(), rhs])) + except InvalidSpecifier: + pass + else: + return spec.contains(lhs, prereleases=True) + + oper: Operator | None = _operators.get(op.serialize()) + if oper is None: + raise UndefinedComparison(f"Undefined {op!r} on {lhs!r} and {rhs!r}.") + + return oper(lhs, rhs) + + +def _normalize(*values: str, key: str) -> tuple[str, ...]: + # PEP 685 – Comparison of extra names for optional distribution dependencies + # https://peps.python.org/pep-0685/ + # > When comparing extra names, tools MUST normalize the names being + # > compared using the semantics outlined in PEP 503 for names + if key == "extra": + return tuple(canonicalize_name(v) for v in values) + + # other environment markers don't have such standards + return values + + +def _evaluate_markers(markers: MarkerList, environment: dict[str, str]) -> bool: + groups: list[list[bool]] = [[]] + + for marker in markers: + assert isinstance(marker, (list, tuple, str)) + + if isinstance(marker, list): + groups[-1].append(_evaluate_markers(marker, environment)) + elif isinstance(marker, tuple): + lhs, op, rhs = marker + + if isinstance(lhs, Variable): + environment_key = lhs.value + lhs_value = environment[environment_key] + rhs_value = rhs.value + else: + lhs_value = lhs.value + environment_key = rhs.value + rhs_value = environment[environment_key] + + lhs_value, rhs_value = _normalize(lhs_value, rhs_value, key=environment_key) + groups[-1].append(_eval_op(lhs_value, op, rhs_value)) + else: + assert marker in ["and", "or"] + if marker == "or": + groups.append([]) + + return any(all(item) for item in groups) + + +def format_full_version(info: sys._version_info) -> str: + version = "{0.major}.{0.minor}.{0.micro}".format(info) + kind = info.releaselevel + if kind != "final": + version += kind[0] + str(info.serial) + return version + + +def default_environment() -> Environment: + iver = format_full_version(sys.implementation.version) + implementation_name = sys.implementation.name + return { + "implementation_name": implementation_name, + "implementation_version": iver, + "os_name": os.name, + "platform_machine": platform.machine(), + "platform_release": platform.release(), + "platform_system": platform.system(), + "platform_version": platform.version(), + "python_full_version": platform.python_version(), + "platform_python_implementation": platform.python_implementation(), + "python_version": ".".join(platform.python_version_tuple()[:2]), + "sys_platform": sys.platform, + } + + +class Marker: + def __init__(self, marker: str) -> None: + # Note: We create a Marker object without calling this constructor in + # packaging.requirements.Requirement. If any additional logic is + # added here, make sure to mirror/adapt Requirement. + try: + self._markers = _normalize_extra_values(_parse_marker(marker)) + # The attribute `_markers` can be described in terms of a recursive type: + # MarkerList = List[Union[Tuple[Node, ...], str, MarkerList]] + # + # For example, the following expression: + # python_version > "3.6" or (python_version == "3.6" and os_name == "unix") + # + # is parsed into: + # [ + # (, ')>, ), + # 'and', + # [ + # (, , ), + # 'or', + # (, , ) + # ] + # ] + except ParserSyntaxError as e: + raise InvalidMarker(str(e)) from e + + def __str__(self) -> str: + return _format_marker(self._markers) + + def __repr__(self) -> str: + return f"" + + def __hash__(self) -> int: + return hash((self.__class__.__name__, str(self))) + + def __eq__(self, other: Any) -> bool: + if not isinstance(other, Marker): + return NotImplemented + + return str(self) == str(other) + + def evaluate(self, environment: dict[str, str] | None = None) -> bool: + """Evaluate a marker. + + Return the boolean from evaluating the given marker against the + environment. environment is an optional argument to override all or + part of the determined environment. + + The environment is determined from the current Python process. + """ + current_environment = cast("dict[str, str]", default_environment()) + current_environment["extra"] = "" + # Work around platform.python_version() returning something that is not PEP 440 + # compliant for non-tagged Python builds. We preserve default_environment()'s + # behavior of returning platform.python_version() verbatim, and leave it to the + # caller to provide a syntactically valid version if they want to override it. + if current_environment["python_full_version"].endswith("+"): + current_environment["python_full_version"] += "local" + if environment is not None: + current_environment.update(environment) + # The API used to allow setting extra to None. We need to handle this + # case for backwards compatibility. + if current_environment["extra"] is None: + current_environment["extra"] = "" + + return _evaluate_markers(self._markers, current_environment) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/metadata.py b/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/metadata.py new file mode 100644 index 0000000..eb8dc84 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/metadata.py @@ -0,0 +1,804 @@ +from __future__ import annotations + +import email.feedparser +import email.header +import email.message +import email.parser +import email.policy +import typing +from typing import ( + Any, + Callable, + Generic, + Literal, + TypedDict, + cast, +) + +from . import requirements, specifiers, utils +from . import version as version_module + +T = typing.TypeVar("T") + + +try: + ExceptionGroup +except NameError: # pragma: no cover + + class ExceptionGroup(Exception): + """A minimal implementation of :external:exc:`ExceptionGroup` from Python 3.11. + + If :external:exc:`ExceptionGroup` is already defined by Python itself, + that version is used instead. + """ + + message: str + exceptions: list[Exception] + + def __init__(self, message: str, exceptions: list[Exception]) -> None: + self.message = message + self.exceptions = exceptions + + def __repr__(self) -> str: + return f"{self.__class__.__name__}({self.message!r}, {self.exceptions!r})" + +else: # pragma: no cover + ExceptionGroup = ExceptionGroup + + +class InvalidMetadata(ValueError): + """A metadata field contains invalid data.""" + + field: str + """The name of the field that contains invalid data.""" + + def __init__(self, field: str, message: str) -> None: + self.field = field + super().__init__(message) + + +# The RawMetadata class attempts to make as few assumptions about the underlying +# serialization formats as possible. The idea is that as long as a serialization +# formats offer some very basic primitives in *some* way then we can support +# serializing to and from that format. +class RawMetadata(TypedDict, total=False): + """A dictionary of raw core metadata. + + Each field in core metadata maps to a key of this dictionary (when data is + provided). The key is lower-case and underscores are used instead of dashes + compared to the equivalent core metadata field. Any core metadata field that + can be specified multiple times or can hold multiple values in a single + field have a key with a plural name. See :class:`Metadata` whose attributes + match the keys of this dictionary. + + Core metadata fields that can be specified multiple times are stored as a + list or dict depending on which is appropriate for the field. Any fields + which hold multiple values in a single field are stored as a list. + + """ + + # Metadata 1.0 - PEP 241 + metadata_version: str + name: str + version: str + platforms: list[str] + summary: str + description: str + keywords: list[str] + home_page: str + author: str + author_email: str + license: str + + # Metadata 1.1 - PEP 314 + supported_platforms: list[str] + download_url: str + classifiers: list[str] + requires: list[str] + provides: list[str] + obsoletes: list[str] + + # Metadata 1.2 - PEP 345 + maintainer: str + maintainer_email: str + requires_dist: list[str] + provides_dist: list[str] + obsoletes_dist: list[str] + requires_python: str + requires_external: list[str] + project_urls: dict[str, str] + + # Metadata 2.0 + # PEP 426 attempted to completely revamp the metadata format + # but got stuck without ever being able to build consensus on + # it and ultimately ended up withdrawn. + # + # However, a number of tools had started emitting METADATA with + # `2.0` Metadata-Version, so for historical reasons, this version + # was skipped. + + # Metadata 2.1 - PEP 566 + description_content_type: str + provides_extra: list[str] + + # Metadata 2.2 - PEP 643 + dynamic: list[str] + + # Metadata 2.3 - PEP 685 + # No new fields were added in PEP 685, just some edge case were + # tightened up to provide better interoptability. + + +_STRING_FIELDS = { + "author", + "author_email", + "description", + "description_content_type", + "download_url", + "home_page", + "license", + "maintainer", + "maintainer_email", + "metadata_version", + "name", + "requires_python", + "summary", + "version", +} + +_LIST_FIELDS = { + "classifiers", + "dynamic", + "obsoletes", + "obsoletes_dist", + "platforms", + "provides", + "provides_dist", + "provides_extra", + "requires", + "requires_dist", + "requires_external", + "supported_platforms", +} + +_DICT_FIELDS = { + "project_urls", +} + + +def _parse_keywords(data: str) -> list[str]: + """Split a string of comma-separate keyboards into a list of keywords.""" + return [k.strip() for k in data.split(",")] + + +def _parse_project_urls(data: list[str]) -> dict[str, str]: + """Parse a list of label/URL string pairings separated by a comma.""" + urls = {} + for pair in data: + # Our logic is slightly tricky here as we want to try and do + # *something* reasonable with malformed data. + # + # The main thing that we have to worry about, is data that does + # not have a ',' at all to split the label from the Value. There + # isn't a singular right answer here, and we will fail validation + # later on (if the caller is validating) so it doesn't *really* + # matter, but since the missing value has to be an empty str + # and our return value is dict[str, str], if we let the key + # be the missing value, then they'd have multiple '' values that + # overwrite each other in a accumulating dict. + # + # The other potentional issue is that it's possible to have the + # same label multiple times in the metadata, with no solid "right" + # answer with what to do in that case. As such, we'll do the only + # thing we can, which is treat the field as unparseable and add it + # to our list of unparsed fields. + parts = [p.strip() for p in pair.split(",", 1)] + parts.extend([""] * (max(0, 2 - len(parts)))) # Ensure 2 items + + # TODO: The spec doesn't say anything about if the keys should be + # considered case sensitive or not... logically they should + # be case-preserving and case-insensitive, but doing that + # would open up more cases where we might have duplicate + # entries. + label, url = parts + if label in urls: + # The label already exists in our set of urls, so this field + # is unparseable, and we can just add the whole thing to our + # unparseable data and stop processing it. + raise KeyError("duplicate labels in project urls") + urls[label] = url + + return urls + + +def _get_payload(msg: email.message.Message, source: bytes | str) -> str: + """Get the body of the message.""" + # If our source is a str, then our caller has managed encodings for us, + # and we don't need to deal with it. + if isinstance(source, str): + payload: str = msg.get_payload() + return payload + # If our source is a bytes, then we're managing the encoding and we need + # to deal with it. + else: + bpayload: bytes = msg.get_payload(decode=True) + try: + return bpayload.decode("utf8", "strict") + except UnicodeDecodeError: + raise ValueError("payload in an invalid encoding") + + +# The various parse_FORMAT functions here are intended to be as lenient as +# possible in their parsing, while still returning a correctly typed +# RawMetadata. +# +# To aid in this, we also generally want to do as little touching of the +# data as possible, except where there are possibly some historic holdovers +# that make valid data awkward to work with. +# +# While this is a lower level, intermediate format than our ``Metadata`` +# class, some light touch ups can make a massive difference in usability. + +# Map METADATA fields to RawMetadata. +_EMAIL_TO_RAW_MAPPING = { + "author": "author", + "author-email": "author_email", + "classifier": "classifiers", + "description": "description", + "description-content-type": "description_content_type", + "download-url": "download_url", + "dynamic": "dynamic", + "home-page": "home_page", + "keywords": "keywords", + "license": "license", + "maintainer": "maintainer", + "maintainer-email": "maintainer_email", + "metadata-version": "metadata_version", + "name": "name", + "obsoletes": "obsoletes", + "obsoletes-dist": "obsoletes_dist", + "platform": "platforms", + "project-url": "project_urls", + "provides": "provides", + "provides-dist": "provides_dist", + "provides-extra": "provides_extra", + "requires": "requires", + "requires-dist": "requires_dist", + "requires-external": "requires_external", + "requires-python": "requires_python", + "summary": "summary", + "supported-platform": "supported_platforms", + "version": "version", +} +_RAW_TO_EMAIL_MAPPING = {raw: email for email, raw in _EMAIL_TO_RAW_MAPPING.items()} + + +def parse_email(data: bytes | str) -> tuple[RawMetadata, dict[str, list[str]]]: + """Parse a distribution's metadata stored as email headers (e.g. from ``METADATA``). + + This function returns a two-item tuple of dicts. The first dict is of + recognized fields from the core metadata specification. Fields that can be + parsed and translated into Python's built-in types are converted + appropriately. All other fields are left as-is. Fields that are allowed to + appear multiple times are stored as lists. + + The second dict contains all other fields from the metadata. This includes + any unrecognized fields. It also includes any fields which are expected to + be parsed into a built-in type but were not formatted appropriately. Finally, + any fields that are expected to appear only once but are repeated are + included in this dict. + + """ + raw: dict[str, str | list[str] | dict[str, str]] = {} + unparsed: dict[str, list[str]] = {} + + if isinstance(data, str): + parsed = email.parser.Parser(policy=email.policy.compat32).parsestr(data) + else: + parsed = email.parser.BytesParser(policy=email.policy.compat32).parsebytes(data) + + # We have to wrap parsed.keys() in a set, because in the case of multiple + # values for a key (a list), the key will appear multiple times in the + # list of keys, but we're avoiding that by using get_all(). + for name in frozenset(parsed.keys()): + # Header names in RFC are case insensitive, so we'll normalize to all + # lower case to make comparisons easier. + name = name.lower() + + # We use get_all() here, even for fields that aren't multiple use, + # because otherwise someone could have e.g. two Name fields, and we + # would just silently ignore it rather than doing something about it. + headers = parsed.get_all(name) or [] + + # The way the email module works when parsing bytes is that it + # unconditionally decodes the bytes as ascii using the surrogateescape + # handler. When you pull that data back out (such as with get_all() ), + # it looks to see if the str has any surrogate escapes, and if it does + # it wraps it in a Header object instead of returning the string. + # + # As such, we'll look for those Header objects, and fix up the encoding. + value = [] + # Flag if we have run into any issues processing the headers, thus + # signalling that the data belongs in 'unparsed'. + valid_encoding = True + for h in headers: + # It's unclear if this can return more types than just a Header or + # a str, so we'll just assert here to make sure. + assert isinstance(h, (email.header.Header, str)) + + # If it's a header object, we need to do our little dance to get + # the real data out of it. In cases where there is invalid data + # we're going to end up with mojibake, but there's no obvious, good + # way around that without reimplementing parts of the Header object + # ourselves. + # + # That should be fine since, if mojibacked happens, this key is + # going into the unparsed dict anyways. + if isinstance(h, email.header.Header): + # The Header object stores it's data as chunks, and each chunk + # can be independently encoded, so we'll need to check each + # of them. + chunks: list[tuple[bytes, str | None]] = [] + for bin, encoding in email.header.decode_header(h): + try: + bin.decode("utf8", "strict") + except UnicodeDecodeError: + # Enable mojibake. + encoding = "latin1" + valid_encoding = False + else: + encoding = "utf8" + chunks.append((bin, encoding)) + + # Turn our chunks back into a Header object, then let that + # Header object do the right thing to turn them into a + # string for us. + value.append(str(email.header.make_header(chunks))) + # This is already a string, so just add it. + else: + value.append(h) + + # We've processed all of our values to get them into a list of str, + # but we may have mojibake data, in which case this is an unparsed + # field. + if not valid_encoding: + unparsed[name] = value + continue + + raw_name = _EMAIL_TO_RAW_MAPPING.get(name) + if raw_name is None: + # This is a bit of a weird situation, we've encountered a key that + # we don't know what it means, so we don't know whether it's meant + # to be a list or not. + # + # Since we can't really tell one way or another, we'll just leave it + # as a list, even though it may be a single item list, because that's + # what makes the most sense for email headers. + unparsed[name] = value + continue + + # If this is one of our string fields, then we'll check to see if our + # value is a list of a single item. If it is then we'll assume that + # it was emitted as a single string, and unwrap the str from inside + # the list. + # + # If it's any other kind of data, then we haven't the faintest clue + # what we should parse it as, and we have to just add it to our list + # of unparsed stuff. + if raw_name in _STRING_FIELDS and len(value) == 1: + raw[raw_name] = value[0] + # If this is one of our list of string fields, then we can just assign + # the value, since email *only* has strings, and our get_all() call + # above ensures that this is a list. + elif raw_name in _LIST_FIELDS: + raw[raw_name] = value + # Special Case: Keywords + # The keywords field is implemented in the metadata spec as a str, + # but it conceptually is a list of strings, and is serialized using + # ", ".join(keywords), so we'll do some light data massaging to turn + # this into what it logically is. + elif raw_name == "keywords" and len(value) == 1: + raw[raw_name] = _parse_keywords(value[0]) + # Special Case: Project-URL + # The project urls is implemented in the metadata spec as a list of + # specially-formatted strings that represent a key and a value, which + # is fundamentally a mapping, however the email format doesn't support + # mappings in a sane way, so it was crammed into a list of strings + # instead. + # + # We will do a little light data massaging to turn this into a map as + # it logically should be. + elif raw_name == "project_urls": + try: + raw[raw_name] = _parse_project_urls(value) + except KeyError: + unparsed[name] = value + # Nothing that we've done has managed to parse this, so it'll just + # throw it in our unparseable data and move on. + else: + unparsed[name] = value + + # We need to support getting the Description from the message payload in + # addition to getting it from the the headers. This does mean, though, there + # is the possibility of it being set both ways, in which case we put both + # in 'unparsed' since we don't know which is right. + try: + payload = _get_payload(parsed, data) + except ValueError: + unparsed.setdefault("description", []).append( + parsed.get_payload(decode=isinstance(data, bytes)) + ) + else: + if payload: + # Check to see if we've already got a description, if so then both + # it, and this body move to unparseable. + if "description" in raw: + description_header = cast(str, raw.pop("description")) + unparsed.setdefault("description", []).extend( + [description_header, payload] + ) + elif "description" in unparsed: + unparsed["description"].append(payload) + else: + raw["description"] = payload + + # We need to cast our `raw` to a metadata, because a TypedDict only support + # literal key names, but we're computing our key names on purpose, but the + # way this function is implemented, our `TypedDict` can only have valid key + # names. + return cast(RawMetadata, raw), unparsed + + +_NOT_FOUND = object() + + +# Keep the two values in sync. +_VALID_METADATA_VERSIONS = ["1.0", "1.1", "1.2", "2.1", "2.2", "2.3"] +_MetadataVersion = Literal["1.0", "1.1", "1.2", "2.1", "2.2", "2.3"] + +_REQUIRED_ATTRS = frozenset(["metadata_version", "name", "version"]) + + +class _Validator(Generic[T]): + """Validate a metadata field. + + All _process_*() methods correspond to a core metadata field. The method is + called with the field's raw value. If the raw value is valid it is returned + in its "enriched" form (e.g. ``version.Version`` for the ``Version`` field). + If the raw value is invalid, :exc:`InvalidMetadata` is raised (with a cause + as appropriate). + """ + + name: str + raw_name: str + added: _MetadataVersion + + def __init__( + self, + *, + added: _MetadataVersion = "1.0", + ) -> None: + self.added = added + + def __set_name__(self, _owner: Metadata, name: str) -> None: + self.name = name + self.raw_name = _RAW_TO_EMAIL_MAPPING[name] + + def __get__(self, instance: Metadata, _owner: type[Metadata]) -> T: + # With Python 3.8, the caching can be replaced with functools.cached_property(). + # No need to check the cache as attribute lookup will resolve into the + # instance's __dict__ before __get__ is called. + cache = instance.__dict__ + value = instance._raw.get(self.name) + + # To make the _process_* methods easier, we'll check if the value is None + # and if this field is NOT a required attribute, and if both of those + # things are true, we'll skip the the converter. This will mean that the + # converters never have to deal with the None union. + if self.name in _REQUIRED_ATTRS or value is not None: + try: + converter: Callable[[Any], T] = getattr(self, f"_process_{self.name}") + except AttributeError: + pass + else: + value = converter(value) + + cache[self.name] = value + try: + del instance._raw[self.name] # type: ignore[misc] + except KeyError: + pass + + return cast(T, value) + + def _invalid_metadata( + self, msg: str, cause: Exception | None = None + ) -> InvalidMetadata: + exc = InvalidMetadata( + self.raw_name, msg.format_map({"field": repr(self.raw_name)}) + ) + exc.__cause__ = cause + return exc + + def _process_metadata_version(self, value: str) -> _MetadataVersion: + # Implicitly makes Metadata-Version required. + if value not in _VALID_METADATA_VERSIONS: + raise self._invalid_metadata(f"{value!r} is not a valid metadata version") + return cast(_MetadataVersion, value) + + def _process_name(self, value: str) -> str: + if not value: + raise self._invalid_metadata("{field} is a required field") + # Validate the name as a side-effect. + try: + utils.canonicalize_name(value, validate=True) + except utils.InvalidName as exc: + raise self._invalid_metadata( + f"{value!r} is invalid for {{field}}", cause=exc + ) + else: + return value + + def _process_version(self, value: str) -> version_module.Version: + if not value: + raise self._invalid_metadata("{field} is a required field") + try: + return version_module.parse(value) + except version_module.InvalidVersion as exc: + raise self._invalid_metadata( + f"{value!r} is invalid for {{field}}", cause=exc + ) + + def _process_summary(self, value: str) -> str: + """Check the field contains no newlines.""" + if "\n" in value: + raise self._invalid_metadata("{field} must be a single line") + return value + + def _process_description_content_type(self, value: str) -> str: + content_types = {"text/plain", "text/x-rst", "text/markdown"} + message = email.message.EmailMessage() + message["content-type"] = value + + content_type, parameters = ( + # Defaults to `text/plain` if parsing failed. + message.get_content_type().lower(), + message["content-type"].params, + ) + # Check if content-type is valid or defaulted to `text/plain` and thus was + # not parseable. + if content_type not in content_types or content_type not in value.lower(): + raise self._invalid_metadata( + f"{{field}} must be one of {list(content_types)}, not {value!r}" + ) + + charset = parameters.get("charset", "UTF-8") + if charset != "UTF-8": + raise self._invalid_metadata( + f"{{field}} can only specify the UTF-8 charset, not {list(charset)}" + ) + + markdown_variants = {"GFM", "CommonMark"} + variant = parameters.get("variant", "GFM") # Use an acceptable default. + if content_type == "text/markdown" and variant not in markdown_variants: + raise self._invalid_metadata( + f"valid Markdown variants for {{field}} are {list(markdown_variants)}, " + f"not {variant!r}", + ) + return value + + def _process_dynamic(self, value: list[str]) -> list[str]: + for dynamic_field in map(str.lower, value): + if dynamic_field in {"name", "version", "metadata-version"}: + raise self._invalid_metadata( + f"{value!r} is not allowed as a dynamic field" + ) + elif dynamic_field not in _EMAIL_TO_RAW_MAPPING: + raise self._invalid_metadata(f"{value!r} is not a valid dynamic field") + return list(map(str.lower, value)) + + def _process_provides_extra( + self, + value: list[str], + ) -> list[utils.NormalizedName]: + normalized_names = [] + try: + for name in value: + normalized_names.append(utils.canonicalize_name(name, validate=True)) + except utils.InvalidName as exc: + raise self._invalid_metadata( + f"{name!r} is invalid for {{field}}", cause=exc + ) + else: + return normalized_names + + def _process_requires_python(self, value: str) -> specifiers.SpecifierSet: + try: + return specifiers.SpecifierSet(value) + except specifiers.InvalidSpecifier as exc: + raise self._invalid_metadata( + f"{value!r} is invalid for {{field}}", cause=exc + ) + + def _process_requires_dist( + self, + value: list[str], + ) -> list[requirements.Requirement]: + reqs = [] + try: + for req in value: + reqs.append(requirements.Requirement(req)) + except requirements.InvalidRequirement as exc: + raise self._invalid_metadata(f"{req!r} is invalid for {{field}}", cause=exc) + else: + return reqs + + +class Metadata: + """Representation of distribution metadata. + + Compared to :class:`RawMetadata`, this class provides objects representing + metadata fields instead of only using built-in types. Any invalid metadata + will cause :exc:`InvalidMetadata` to be raised (with a + :py:attr:`~BaseException.__cause__` attribute as appropriate). + """ + + _raw: RawMetadata + + @classmethod + def from_raw(cls, data: RawMetadata, *, validate: bool = True) -> Metadata: + """Create an instance from :class:`RawMetadata`. + + If *validate* is true, all metadata will be validated. All exceptions + related to validation will be gathered and raised as an :class:`ExceptionGroup`. + """ + ins = cls() + ins._raw = data.copy() # Mutations occur due to caching enriched values. + + if validate: + exceptions: list[Exception] = [] + try: + metadata_version = ins.metadata_version + metadata_age = _VALID_METADATA_VERSIONS.index(metadata_version) + except InvalidMetadata as metadata_version_exc: + exceptions.append(metadata_version_exc) + metadata_version = None + + # Make sure to check for the fields that are present, the required + # fields (so their absence can be reported). + fields_to_check = frozenset(ins._raw) | _REQUIRED_ATTRS + # Remove fields that have already been checked. + fields_to_check -= {"metadata_version"} + + for key in fields_to_check: + try: + if metadata_version: + # Can't use getattr() as that triggers descriptor protocol which + # will fail due to no value for the instance argument. + try: + field_metadata_version = cls.__dict__[key].added + except KeyError: + exc = InvalidMetadata(key, f"unrecognized field: {key!r}") + exceptions.append(exc) + continue + field_age = _VALID_METADATA_VERSIONS.index( + field_metadata_version + ) + if field_age > metadata_age: + field = _RAW_TO_EMAIL_MAPPING[key] + exc = InvalidMetadata( + field, + "{field} introduced in metadata version " + "{field_metadata_version}, not {metadata_version}", + ) + exceptions.append(exc) + continue + getattr(ins, key) + except InvalidMetadata as exc: + exceptions.append(exc) + + if exceptions: + raise ExceptionGroup("invalid metadata", exceptions) + + return ins + + @classmethod + def from_email(cls, data: bytes | str, *, validate: bool = True) -> Metadata: + """Parse metadata from email headers. + + If *validate* is true, the metadata will be validated. All exceptions + related to validation will be gathered and raised as an :class:`ExceptionGroup`. + """ + raw, unparsed = parse_email(data) + + if validate: + exceptions: list[Exception] = [] + for unparsed_key in unparsed: + if unparsed_key in _EMAIL_TO_RAW_MAPPING: + message = f"{unparsed_key!r} has invalid data" + else: + message = f"unrecognized field: {unparsed_key!r}" + exceptions.append(InvalidMetadata(unparsed_key, message)) + + if exceptions: + raise ExceptionGroup("unparsed", exceptions) + + try: + return cls.from_raw(raw, validate=validate) + except ExceptionGroup as exc_group: + raise ExceptionGroup( + "invalid or unparsed metadata", exc_group.exceptions + ) from None + + metadata_version: _Validator[_MetadataVersion] = _Validator() + """:external:ref:`core-metadata-metadata-version` + (required; validated to be a valid metadata version)""" + name: _Validator[str] = _Validator() + """:external:ref:`core-metadata-name` + (required; validated using :func:`~packaging.utils.canonicalize_name` and its + *validate* parameter)""" + version: _Validator[version_module.Version] = _Validator() + """:external:ref:`core-metadata-version` (required)""" + dynamic: _Validator[list[str] | None] = _Validator( + added="2.2", + ) + """:external:ref:`core-metadata-dynamic` + (validated against core metadata field names and lowercased)""" + platforms: _Validator[list[str] | None] = _Validator() + """:external:ref:`core-metadata-platform`""" + supported_platforms: _Validator[list[str] | None] = _Validator(added="1.1") + """:external:ref:`core-metadata-supported-platform`""" + summary: _Validator[str | None] = _Validator() + """:external:ref:`core-metadata-summary` (validated to contain no newlines)""" + description: _Validator[str | None] = _Validator() # TODO 2.1: can be in body + """:external:ref:`core-metadata-description`""" + description_content_type: _Validator[str | None] = _Validator(added="2.1") + """:external:ref:`core-metadata-description-content-type` (validated)""" + keywords: _Validator[list[str] | None] = _Validator() + """:external:ref:`core-metadata-keywords`""" + home_page: _Validator[str | None] = _Validator() + """:external:ref:`core-metadata-home-page`""" + download_url: _Validator[str | None] = _Validator(added="1.1") + """:external:ref:`core-metadata-download-url`""" + author: _Validator[str | None] = _Validator() + """:external:ref:`core-metadata-author`""" + author_email: _Validator[str | None] = _Validator() + """:external:ref:`core-metadata-author-email`""" + maintainer: _Validator[str | None] = _Validator(added="1.2") + """:external:ref:`core-metadata-maintainer`""" + maintainer_email: _Validator[str | None] = _Validator(added="1.2") + """:external:ref:`core-metadata-maintainer-email`""" + license: _Validator[str | None] = _Validator() + """:external:ref:`core-metadata-license`""" + classifiers: _Validator[list[str] | None] = _Validator(added="1.1") + """:external:ref:`core-metadata-classifier`""" + requires_dist: _Validator[list[requirements.Requirement] | None] = _Validator( + added="1.2" + ) + """:external:ref:`core-metadata-requires-dist`""" + requires_python: _Validator[specifiers.SpecifierSet | None] = _Validator( + added="1.2" + ) + """:external:ref:`core-metadata-requires-python`""" + # Because `Requires-External` allows for non-PEP 440 version specifiers, we + # don't do any processing on the values. + requires_external: _Validator[list[str] | None] = _Validator(added="1.2") + """:external:ref:`core-metadata-requires-external`""" + project_urls: _Validator[dict[str, str] | None] = _Validator(added="1.2") + """:external:ref:`core-metadata-project-url`""" + # PEP 685 lets us raise an error if an extra doesn't pass `Name` validation + # regardless of metadata version. + provides_extra: _Validator[list[utils.NormalizedName] | None] = _Validator( + added="2.1", + ) + """:external:ref:`core-metadata-provides-extra`""" + provides_dist: _Validator[list[str] | None] = _Validator(added="1.2") + """:external:ref:`core-metadata-provides-dist`""" + obsoletes_dist: _Validator[list[str] | None] = _Validator(added="1.2") + """:external:ref:`core-metadata-obsoletes-dist`""" + requires: _Validator[list[str] | None] = _Validator(added="1.1") + """``Requires`` (deprecated)""" + provides: _Validator[list[str] | None] = _Validator(added="1.1") + """``Provides`` (deprecated)""" + obsoletes: _Validator[list[str] | None] = _Validator(added="1.1") + """``Obsoletes`` (deprecated)""" diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/py.typed b/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/requirements.py b/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/requirements.py new file mode 100644 index 0000000..4e068c9 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/requirements.py @@ -0,0 +1,91 @@ +# This file is dual licensed under the terms of the Apache License, Version +# 2.0, and the BSD License. See the LICENSE file in the root of this repository +# for complete details. +from __future__ import annotations + +from typing import Any, Iterator + +from ._parser import parse_requirement as _parse_requirement +from ._tokenizer import ParserSyntaxError +from .markers import Marker, _normalize_extra_values +from .specifiers import SpecifierSet +from .utils import canonicalize_name + + +class InvalidRequirement(ValueError): + """ + An invalid requirement was found, users should refer to PEP 508. + """ + + +class Requirement: + """Parse a requirement. + + Parse a given requirement string into its parts, such as name, specifier, + URL, and extras. Raises InvalidRequirement on a badly-formed requirement + string. + """ + + # TODO: Can we test whether something is contained within a requirement? + # If so how do we do that? Do we need to test against the _name_ of + # the thing as well as the version? What about the markers? + # TODO: Can we normalize the name and extra name? + + def __init__(self, requirement_string: str) -> None: + try: + parsed = _parse_requirement(requirement_string) + except ParserSyntaxError as e: + raise InvalidRequirement(str(e)) from e + + self.name: str = parsed.name + self.url: str | None = parsed.url or None + self.extras: set[str] = set(parsed.extras or []) + self.specifier: SpecifierSet = SpecifierSet(parsed.specifier) + self.marker: Marker | None = None + if parsed.marker is not None: + self.marker = Marker.__new__(Marker) + self.marker._markers = _normalize_extra_values(parsed.marker) + + def _iter_parts(self, name: str) -> Iterator[str]: + yield name + + if self.extras: + formatted_extras = ",".join(sorted(self.extras)) + yield f"[{formatted_extras}]" + + if self.specifier: + yield str(self.specifier) + + if self.url: + yield f"@ {self.url}" + if self.marker: + yield " " + + if self.marker: + yield f"; {self.marker}" + + def __str__(self) -> str: + return "".join(self._iter_parts(self.name)) + + def __repr__(self) -> str: + return f"" + + def __hash__(self) -> int: + return hash( + ( + self.__class__.__name__, + *self._iter_parts(canonicalize_name(self.name)), + ) + ) + + def __eq__(self, other: Any) -> bool: + if not isinstance(other, Requirement): + return NotImplemented + + return ( + canonicalize_name(self.name) == canonicalize_name(other.name) + and self.extras == other.extras + and self.specifier == other.specifier + and self.url == other.url + and self.marker == other.marker + ) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/specifiers.py b/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/specifiers.py new file mode 100644 index 0000000..f3ac480 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/specifiers.py @@ -0,0 +1,1009 @@ +# This file is dual licensed under the terms of the Apache License, Version +# 2.0, and the BSD License. See the LICENSE file in the root of this repository +# for complete details. +""" +.. testsetup:: + + from pip._vendor.packaging.specifiers import Specifier, SpecifierSet, InvalidSpecifier + from pip._vendor.packaging.version import Version +""" + +from __future__ import annotations + +import abc +import itertools +import re +from typing import Callable, Iterable, Iterator, TypeVar, Union + +from .utils import canonicalize_version +from .version import Version + +UnparsedVersion = Union[Version, str] +UnparsedVersionVar = TypeVar("UnparsedVersionVar", bound=UnparsedVersion) +CallableOperator = Callable[[Version, str], bool] + + +def _coerce_version(version: UnparsedVersion) -> Version: + if not isinstance(version, Version): + version = Version(version) + return version + + +class InvalidSpecifier(ValueError): + """ + Raised when attempting to create a :class:`Specifier` with a specifier + string that is invalid. + + >>> Specifier("lolwat") + Traceback (most recent call last): + ... + packaging.specifiers.InvalidSpecifier: Invalid specifier: 'lolwat' + """ + + +class BaseSpecifier(metaclass=abc.ABCMeta): + @abc.abstractmethod + def __str__(self) -> str: + """ + Returns the str representation of this Specifier-like object. This + should be representative of the Specifier itself. + """ + + @abc.abstractmethod + def __hash__(self) -> int: + """ + Returns a hash value for this Specifier-like object. + """ + + @abc.abstractmethod + def __eq__(self, other: object) -> bool: + """ + Returns a boolean representing whether or not the two Specifier-like + objects are equal. + + :param other: The other object to check against. + """ + + @property + @abc.abstractmethod + def prereleases(self) -> bool | None: + """Whether or not pre-releases as a whole are allowed. + + This can be set to either ``True`` or ``False`` to explicitly enable or disable + prereleases or it can be set to ``None`` (the default) to use default semantics. + """ + + @prereleases.setter + def prereleases(self, value: bool) -> None: + """Setter for :attr:`prereleases`. + + :param value: The value to set. + """ + + @abc.abstractmethod + def contains(self, item: str, prereleases: bool | None = None) -> bool: + """ + Determines if the given item is contained within this specifier. + """ + + @abc.abstractmethod + def filter( + self, iterable: Iterable[UnparsedVersionVar], prereleases: bool | None = None + ) -> Iterator[UnparsedVersionVar]: + """ + Takes an iterable of items and filters them so that only items which + are contained within this specifier are allowed in it. + """ + + +class Specifier(BaseSpecifier): + """This class abstracts handling of version specifiers. + + .. tip:: + + It is generally not required to instantiate this manually. You should instead + prefer to work with :class:`SpecifierSet` instead, which can parse + comma-separated version specifiers (which is what package metadata contains). + """ + + _operator_regex_str = r""" + (?P(~=|==|!=|<=|>=|<|>|===)) + """ + _version_regex_str = r""" + (?P + (?: + # The identity operators allow for an escape hatch that will + # do an exact string match of the version you wish to install. + # This will not be parsed by PEP 440 and we cannot determine + # any semantic meaning from it. This operator is discouraged + # but included entirely as an escape hatch. + (?<====) # Only match for the identity operator + \s* + [^\s;)]* # The arbitrary version can be just about anything, + # we match everything except for whitespace, a + # semi-colon for marker support, and a closing paren + # since versions can be enclosed in them. + ) + | + (?: + # The (non)equality operators allow for wild card and local + # versions to be specified so we have to define these two + # operators separately to enable that. + (?<===|!=) # Only match for equals and not equals + + \s* + v? + (?:[0-9]+!)? # epoch + [0-9]+(?:\.[0-9]+)* # release + + # You cannot use a wild card and a pre-release, post-release, a dev or + # local version together so group them with a | and make them optional. + (?: + \.\* # Wild card syntax of .* + | + (?: # pre release + [-_\.]? + (alpha|beta|preview|pre|a|b|c|rc) + [-_\.]? + [0-9]* + )? + (?: # post release + (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*) + )? + (?:[-_\.]?dev[-_\.]?[0-9]*)? # dev release + (?:\+[a-z0-9]+(?:[-_\.][a-z0-9]+)*)? # local + )? + ) + | + (?: + # The compatible operator requires at least two digits in the + # release segment. + (?<=~=) # Only match for the compatible operator + + \s* + v? + (?:[0-9]+!)? # epoch + [0-9]+(?:\.[0-9]+)+ # release (We have a + instead of a *) + (?: # pre release + [-_\.]? + (alpha|beta|preview|pre|a|b|c|rc) + [-_\.]? + [0-9]* + )? + (?: # post release + (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*) + )? + (?:[-_\.]?dev[-_\.]?[0-9]*)? # dev release + ) + | + (?: + # All other operators only allow a sub set of what the + # (non)equality operators do. Specifically they do not allow + # local versions to be specified nor do they allow the prefix + # matching wild cards. + (?=": "greater_than_equal", + "<": "less_than", + ">": "greater_than", + "===": "arbitrary", + } + + def __init__(self, spec: str = "", prereleases: bool | None = None) -> None: + """Initialize a Specifier instance. + + :param spec: + The string representation of a specifier which will be parsed and + normalized before use. + :param prereleases: + This tells the specifier if it should accept prerelease versions if + applicable or not. The default of ``None`` will autodetect it from the + given specifiers. + :raises InvalidSpecifier: + If the given specifier is invalid (i.e. bad syntax). + """ + match = self._regex.search(spec) + if not match: + raise InvalidSpecifier(f"Invalid specifier: '{spec}'") + + self._spec: tuple[str, str] = ( + match.group("operator").strip(), + match.group("version").strip(), + ) + + # Store whether or not this Specifier should accept prereleases + self._prereleases = prereleases + + # https://github.com/python/mypy/pull/13475#pullrequestreview-1079784515 + @property # type: ignore[override] + def prereleases(self) -> bool: + # If there is an explicit prereleases set for this, then we'll just + # blindly use that. + if self._prereleases is not None: + return self._prereleases + + # Look at all of our specifiers and determine if they are inclusive + # operators, and if they are if they are including an explicit + # prerelease. + operator, version = self._spec + if operator in ["==", ">=", "<=", "~=", "==="]: + # The == specifier can include a trailing .*, if it does we + # want to remove before parsing. + if operator == "==" and version.endswith(".*"): + version = version[:-2] + + # Parse the version, and if it is a pre-release than this + # specifier allows pre-releases. + if Version(version).is_prerelease: + return True + + return False + + @prereleases.setter + def prereleases(self, value: bool) -> None: + self._prereleases = value + + @property + def operator(self) -> str: + """The operator of this specifier. + + >>> Specifier("==1.2.3").operator + '==' + """ + return self._spec[0] + + @property + def version(self) -> str: + """The version of this specifier. + + >>> Specifier("==1.2.3").version + '1.2.3' + """ + return self._spec[1] + + def __repr__(self) -> str: + """A representation of the Specifier that shows all internal state. + + >>> Specifier('>=1.0.0') + =1.0.0')> + >>> Specifier('>=1.0.0', prereleases=False) + =1.0.0', prereleases=False)> + >>> Specifier('>=1.0.0', prereleases=True) + =1.0.0', prereleases=True)> + """ + pre = ( + f", prereleases={self.prereleases!r}" + if self._prereleases is not None + else "" + ) + + return f"<{self.__class__.__name__}({str(self)!r}{pre})>" + + def __str__(self) -> str: + """A string representation of the Specifier that can be round-tripped. + + >>> str(Specifier('>=1.0.0')) + '>=1.0.0' + >>> str(Specifier('>=1.0.0', prereleases=False)) + '>=1.0.0' + """ + return "{}{}".format(*self._spec) + + @property + def _canonical_spec(self) -> tuple[str, str]: + canonical_version = canonicalize_version( + self._spec[1], + strip_trailing_zero=(self._spec[0] != "~="), + ) + return self._spec[0], canonical_version + + def __hash__(self) -> int: + return hash(self._canonical_spec) + + def __eq__(self, other: object) -> bool: + """Whether or not the two Specifier-like objects are equal. + + :param other: The other object to check against. + + The value of :attr:`prereleases` is ignored. + + >>> Specifier("==1.2.3") == Specifier("== 1.2.3.0") + True + >>> (Specifier("==1.2.3", prereleases=False) == + ... Specifier("==1.2.3", prereleases=True)) + True + >>> Specifier("==1.2.3") == "==1.2.3" + True + >>> Specifier("==1.2.3") == Specifier("==1.2.4") + False + >>> Specifier("==1.2.3") == Specifier("~=1.2.3") + False + """ + if isinstance(other, str): + try: + other = self.__class__(str(other)) + except InvalidSpecifier: + return NotImplemented + elif not isinstance(other, self.__class__): + return NotImplemented + + return self._canonical_spec == other._canonical_spec + + def _get_operator(self, op: str) -> CallableOperator: + operator_callable: CallableOperator = getattr( + self, f"_compare_{self._operators[op]}" + ) + return operator_callable + + def _compare_compatible(self, prospective: Version, spec: str) -> bool: + # Compatible releases have an equivalent combination of >= and ==. That + # is that ~=2.2 is equivalent to >=2.2,==2.*. This allows us to + # implement this in terms of the other specifiers instead of + # implementing it ourselves. The only thing we need to do is construct + # the other specifiers. + + # We want everything but the last item in the version, but we want to + # ignore suffix segments. + prefix = _version_join( + list(itertools.takewhile(_is_not_suffix, _version_split(spec)))[:-1] + ) + + # Add the prefix notation to the end of our string + prefix += ".*" + + return self._get_operator(">=")(prospective, spec) and self._get_operator("==")( + prospective, prefix + ) + + def _compare_equal(self, prospective: Version, spec: str) -> bool: + # We need special logic to handle prefix matching + if spec.endswith(".*"): + # In the case of prefix matching we want to ignore local segment. + normalized_prospective = canonicalize_version( + prospective.public, strip_trailing_zero=False + ) + # Get the normalized version string ignoring the trailing .* + normalized_spec = canonicalize_version(spec[:-2], strip_trailing_zero=False) + # Split the spec out by bangs and dots, and pretend that there is + # an implicit dot in between a release segment and a pre-release segment. + split_spec = _version_split(normalized_spec) + + # Split the prospective version out by bangs and dots, and pretend + # that there is an implicit dot in between a release segment and + # a pre-release segment. + split_prospective = _version_split(normalized_prospective) + + # 0-pad the prospective version before shortening it to get the correct + # shortened version. + padded_prospective, _ = _pad_version(split_prospective, split_spec) + + # Shorten the prospective version to be the same length as the spec + # so that we can determine if the specifier is a prefix of the + # prospective version or not. + shortened_prospective = padded_prospective[: len(split_spec)] + + return shortened_prospective == split_spec + else: + # Convert our spec string into a Version + spec_version = Version(spec) + + # If the specifier does not have a local segment, then we want to + # act as if the prospective version also does not have a local + # segment. + if not spec_version.local: + prospective = Version(prospective.public) + + return prospective == spec_version + + def _compare_not_equal(self, prospective: Version, spec: str) -> bool: + return not self._compare_equal(prospective, spec) + + def _compare_less_than_equal(self, prospective: Version, spec: str) -> bool: + # NB: Local version identifiers are NOT permitted in the version + # specifier, so local version labels can be universally removed from + # the prospective version. + return Version(prospective.public) <= Version(spec) + + def _compare_greater_than_equal(self, prospective: Version, spec: str) -> bool: + # NB: Local version identifiers are NOT permitted in the version + # specifier, so local version labels can be universally removed from + # the prospective version. + return Version(prospective.public) >= Version(spec) + + def _compare_less_than(self, prospective: Version, spec_str: str) -> bool: + # Convert our spec to a Version instance, since we'll want to work with + # it as a version. + spec = Version(spec_str) + + # Check to see if the prospective version is less than the spec + # version. If it's not we can short circuit and just return False now + # instead of doing extra unneeded work. + if not prospective < spec: + return False + + # This special case is here so that, unless the specifier itself + # includes is a pre-release version, that we do not accept pre-release + # versions for the version mentioned in the specifier (e.g. <3.1 should + # not match 3.1.dev0, but should match 3.0.dev0). + if not spec.is_prerelease and prospective.is_prerelease: + if Version(prospective.base_version) == Version(spec.base_version): + return False + + # If we've gotten to here, it means that prospective version is both + # less than the spec version *and* it's not a pre-release of the same + # version in the spec. + return True + + def _compare_greater_than(self, prospective: Version, spec_str: str) -> bool: + # Convert our spec to a Version instance, since we'll want to work with + # it as a version. + spec = Version(spec_str) + + # Check to see if the prospective version is greater than the spec + # version. If it's not we can short circuit and just return False now + # instead of doing extra unneeded work. + if not prospective > spec: + return False + + # This special case is here so that, unless the specifier itself + # includes is a post-release version, that we do not accept + # post-release versions for the version mentioned in the specifier + # (e.g. >3.1 should not match 3.0.post0, but should match 3.2.post0). + if not spec.is_postrelease and prospective.is_postrelease: + if Version(prospective.base_version) == Version(spec.base_version): + return False + + # Ensure that we do not allow a local version of the version mentioned + # in the specifier, which is technically greater than, to match. + if prospective.local is not None: + if Version(prospective.base_version) == Version(spec.base_version): + return False + + # If we've gotten to here, it means that prospective version is both + # greater than the spec version *and* it's not a pre-release of the + # same version in the spec. + return True + + def _compare_arbitrary(self, prospective: Version, spec: str) -> bool: + return str(prospective).lower() == str(spec).lower() + + def __contains__(self, item: str | Version) -> bool: + """Return whether or not the item is contained in this specifier. + + :param item: The item to check for. + + This is used for the ``in`` operator and behaves the same as + :meth:`contains` with no ``prereleases`` argument passed. + + >>> "1.2.3" in Specifier(">=1.2.3") + True + >>> Version("1.2.3") in Specifier(">=1.2.3") + True + >>> "1.0.0" in Specifier(">=1.2.3") + False + >>> "1.3.0a1" in Specifier(">=1.2.3") + False + >>> "1.3.0a1" in Specifier(">=1.2.3", prereleases=True) + True + """ + return self.contains(item) + + def contains(self, item: UnparsedVersion, prereleases: bool | None = None) -> bool: + """Return whether or not the item is contained in this specifier. + + :param item: + The item to check for, which can be a version string or a + :class:`Version` instance. + :param prereleases: + Whether or not to match prereleases with this Specifier. If set to + ``None`` (the default), it uses :attr:`prereleases` to determine + whether or not prereleases are allowed. + + >>> Specifier(">=1.2.3").contains("1.2.3") + True + >>> Specifier(">=1.2.3").contains(Version("1.2.3")) + True + >>> Specifier(">=1.2.3").contains("1.0.0") + False + >>> Specifier(">=1.2.3").contains("1.3.0a1") + False + >>> Specifier(">=1.2.3", prereleases=True).contains("1.3.0a1") + True + >>> Specifier(">=1.2.3").contains("1.3.0a1", prereleases=True) + True + """ + + # Determine if prereleases are to be allowed or not. + if prereleases is None: + prereleases = self.prereleases + + # Normalize item to a Version, this allows us to have a shortcut for + # "2.0" in Specifier(">=2") + normalized_item = _coerce_version(item) + + # Determine if we should be supporting prereleases in this specifier + # or not, if we do not support prereleases than we can short circuit + # logic if this version is a prereleases. + if normalized_item.is_prerelease and not prereleases: + return False + + # Actually do the comparison to determine if this item is contained + # within this Specifier or not. + operator_callable: CallableOperator = self._get_operator(self.operator) + return operator_callable(normalized_item, self.version) + + def filter( + self, iterable: Iterable[UnparsedVersionVar], prereleases: bool | None = None + ) -> Iterator[UnparsedVersionVar]: + """Filter items in the given iterable, that match the specifier. + + :param iterable: + An iterable that can contain version strings and :class:`Version` instances. + The items in the iterable will be filtered according to the specifier. + :param prereleases: + Whether or not to allow prereleases in the returned iterator. If set to + ``None`` (the default), it will be intelligently decide whether to allow + prereleases or not (based on the :attr:`prereleases` attribute, and + whether the only versions matching are prereleases). + + This method is smarter than just ``filter(Specifier().contains, [...])`` + because it implements the rule from :pep:`440` that a prerelease item + SHOULD be accepted if no other versions match the given specifier. + + >>> list(Specifier(">=1.2.3").filter(["1.2", "1.3", "1.5a1"])) + ['1.3'] + >>> list(Specifier(">=1.2.3").filter(["1.2", "1.2.3", "1.3", Version("1.4")])) + ['1.2.3', '1.3', ] + >>> list(Specifier(">=1.2.3").filter(["1.2", "1.5a1"])) + ['1.5a1'] + >>> list(Specifier(">=1.2.3").filter(["1.3", "1.5a1"], prereleases=True)) + ['1.3', '1.5a1'] + >>> list(Specifier(">=1.2.3", prereleases=True).filter(["1.3", "1.5a1"])) + ['1.3', '1.5a1'] + """ + + yielded = False + found_prereleases = [] + + kw = {"prereleases": prereleases if prereleases is not None else True} + + # Attempt to iterate over all the values in the iterable and if any of + # them match, yield them. + for version in iterable: + parsed_version = _coerce_version(version) + + if self.contains(parsed_version, **kw): + # If our version is a prerelease, and we were not set to allow + # prereleases, then we'll store it for later in case nothing + # else matches this specifier. + if parsed_version.is_prerelease and not ( + prereleases or self.prereleases + ): + found_prereleases.append(version) + # Either this is not a prerelease, or we should have been + # accepting prereleases from the beginning. + else: + yielded = True + yield version + + # Now that we've iterated over everything, determine if we've yielded + # any values, and if we have not and we have any prereleases stored up + # then we will go ahead and yield the prereleases. + if not yielded and found_prereleases: + for version in found_prereleases: + yield version + + +_prefix_regex = re.compile(r"^([0-9]+)((?:a|b|c|rc)[0-9]+)$") + + +def _version_split(version: str) -> list[str]: + """Split version into components. + + The split components are intended for version comparison. The logic does + not attempt to retain the original version string, so joining the + components back with :func:`_version_join` may not produce the original + version string. + """ + result: list[str] = [] + + epoch, _, rest = version.rpartition("!") + result.append(epoch or "0") + + for item in rest.split("."): + match = _prefix_regex.search(item) + if match: + result.extend(match.groups()) + else: + result.append(item) + return result + + +def _version_join(components: list[str]) -> str: + """Join split version components into a version string. + + This function assumes the input came from :func:`_version_split`, where the + first component must be the epoch (either empty or numeric), and all other + components numeric. + """ + epoch, *rest = components + return f"{epoch}!{'.'.join(rest)}" + + +def _is_not_suffix(segment: str) -> bool: + return not any( + segment.startswith(prefix) for prefix in ("dev", "a", "b", "rc", "post") + ) + + +def _pad_version(left: list[str], right: list[str]) -> tuple[list[str], list[str]]: + left_split, right_split = [], [] + + # Get the release segment of our versions + left_split.append(list(itertools.takewhile(lambda x: x.isdigit(), left))) + right_split.append(list(itertools.takewhile(lambda x: x.isdigit(), right))) + + # Get the rest of our versions + left_split.append(left[len(left_split[0]) :]) + right_split.append(right[len(right_split[0]) :]) + + # Insert our padding + left_split.insert(1, ["0"] * max(0, len(right_split[0]) - len(left_split[0]))) + right_split.insert(1, ["0"] * max(0, len(left_split[0]) - len(right_split[0]))) + + return ( + list(itertools.chain.from_iterable(left_split)), + list(itertools.chain.from_iterable(right_split)), + ) + + +class SpecifierSet(BaseSpecifier): + """This class abstracts handling of a set of version specifiers. + + It can be passed a single specifier (``>=3.0``), a comma-separated list of + specifiers (``>=3.0,!=3.1``), or no specifier at all. + """ + + def __init__(self, specifiers: str = "", prereleases: bool | None = None) -> None: + """Initialize a SpecifierSet instance. + + :param specifiers: + The string representation of a specifier or a comma-separated list of + specifiers which will be parsed and normalized before use. + :param prereleases: + This tells the SpecifierSet if it should accept prerelease versions if + applicable or not. The default of ``None`` will autodetect it from the + given specifiers. + + :raises InvalidSpecifier: + If the given ``specifiers`` are not parseable than this exception will be + raised. + """ + + # Split on `,` to break each individual specifier into it's own item, and + # strip each item to remove leading/trailing whitespace. + split_specifiers = [s.strip() for s in specifiers.split(",") if s.strip()] + + # Make each individual specifier a Specifier and save in a frozen set for later. + self._specs = frozenset(map(Specifier, split_specifiers)) + + # Store our prereleases value so we can use it later to determine if + # we accept prereleases or not. + self._prereleases = prereleases + + @property + def prereleases(self) -> bool | None: + # If we have been given an explicit prerelease modifier, then we'll + # pass that through here. + if self._prereleases is not None: + return self._prereleases + + # If we don't have any specifiers, and we don't have a forced value, + # then we'll just return None since we don't know if this should have + # pre-releases or not. + if not self._specs: + return None + + # Otherwise we'll see if any of the given specifiers accept + # prereleases, if any of them do we'll return True, otherwise False. + return any(s.prereleases for s in self._specs) + + @prereleases.setter + def prereleases(self, value: bool) -> None: + self._prereleases = value + + def __repr__(self) -> str: + """A representation of the specifier set that shows all internal state. + + Note that the ordering of the individual specifiers within the set may not + match the input string. + + >>> SpecifierSet('>=1.0.0,!=2.0.0') + =1.0.0')> + >>> SpecifierSet('>=1.0.0,!=2.0.0', prereleases=False) + =1.0.0', prereleases=False)> + >>> SpecifierSet('>=1.0.0,!=2.0.0', prereleases=True) + =1.0.0', prereleases=True)> + """ + pre = ( + f", prereleases={self.prereleases!r}" + if self._prereleases is not None + else "" + ) + + return f"" + + def __str__(self) -> str: + """A string representation of the specifier set that can be round-tripped. + + Note that the ordering of the individual specifiers within the set may not + match the input string. + + >>> str(SpecifierSet(">=1.0.0,!=1.0.1")) + '!=1.0.1,>=1.0.0' + >>> str(SpecifierSet(">=1.0.0,!=1.0.1", prereleases=False)) + '!=1.0.1,>=1.0.0' + """ + return ",".join(sorted(str(s) for s in self._specs)) + + def __hash__(self) -> int: + return hash(self._specs) + + def __and__(self, other: SpecifierSet | str) -> SpecifierSet: + """Return a SpecifierSet which is a combination of the two sets. + + :param other: The other object to combine with. + + >>> SpecifierSet(">=1.0.0,!=1.0.1") & '<=2.0.0,!=2.0.1' + =1.0.0')> + >>> SpecifierSet(">=1.0.0,!=1.0.1") & SpecifierSet('<=2.0.0,!=2.0.1') + =1.0.0')> + """ + if isinstance(other, str): + other = SpecifierSet(other) + elif not isinstance(other, SpecifierSet): + return NotImplemented + + specifier = SpecifierSet() + specifier._specs = frozenset(self._specs | other._specs) + + if self._prereleases is None and other._prereleases is not None: + specifier._prereleases = other._prereleases + elif self._prereleases is not None and other._prereleases is None: + specifier._prereleases = self._prereleases + elif self._prereleases == other._prereleases: + specifier._prereleases = self._prereleases + else: + raise ValueError( + "Cannot combine SpecifierSets with True and False prerelease " + "overrides." + ) + + return specifier + + def __eq__(self, other: object) -> bool: + """Whether or not the two SpecifierSet-like objects are equal. + + :param other: The other object to check against. + + The value of :attr:`prereleases` is ignored. + + >>> SpecifierSet(">=1.0.0,!=1.0.1") == SpecifierSet(">=1.0.0,!=1.0.1") + True + >>> (SpecifierSet(">=1.0.0,!=1.0.1", prereleases=False) == + ... SpecifierSet(">=1.0.0,!=1.0.1", prereleases=True)) + True + >>> SpecifierSet(">=1.0.0,!=1.0.1") == ">=1.0.0,!=1.0.1" + True + >>> SpecifierSet(">=1.0.0,!=1.0.1") == SpecifierSet(">=1.0.0") + False + >>> SpecifierSet(">=1.0.0,!=1.0.1") == SpecifierSet(">=1.0.0,!=1.0.2") + False + """ + if isinstance(other, (str, Specifier)): + other = SpecifierSet(str(other)) + elif not isinstance(other, SpecifierSet): + return NotImplemented + + return self._specs == other._specs + + def __len__(self) -> int: + """Returns the number of specifiers in this specifier set.""" + return len(self._specs) + + def __iter__(self) -> Iterator[Specifier]: + """ + Returns an iterator over all the underlying :class:`Specifier` instances + in this specifier set. + + >>> sorted(SpecifierSet(">=1.0.0,!=1.0.1"), key=str) + [, =1.0.0')>] + """ + return iter(self._specs) + + def __contains__(self, item: UnparsedVersion) -> bool: + """Return whether or not the item is contained in this specifier. + + :param item: The item to check for. + + This is used for the ``in`` operator and behaves the same as + :meth:`contains` with no ``prereleases`` argument passed. + + >>> "1.2.3" in SpecifierSet(">=1.0.0,!=1.0.1") + True + >>> Version("1.2.3") in SpecifierSet(">=1.0.0,!=1.0.1") + True + >>> "1.0.1" in SpecifierSet(">=1.0.0,!=1.0.1") + False + >>> "1.3.0a1" in SpecifierSet(">=1.0.0,!=1.0.1") + False + >>> "1.3.0a1" in SpecifierSet(">=1.0.0,!=1.0.1", prereleases=True) + True + """ + return self.contains(item) + + def contains( + self, + item: UnparsedVersion, + prereleases: bool | None = None, + installed: bool | None = None, + ) -> bool: + """Return whether or not the item is contained in this SpecifierSet. + + :param item: + The item to check for, which can be a version string or a + :class:`Version` instance. + :param prereleases: + Whether or not to match prereleases with this SpecifierSet. If set to + ``None`` (the default), it uses :attr:`prereleases` to determine + whether or not prereleases are allowed. + + >>> SpecifierSet(">=1.0.0,!=1.0.1").contains("1.2.3") + True + >>> SpecifierSet(">=1.0.0,!=1.0.1").contains(Version("1.2.3")) + True + >>> SpecifierSet(">=1.0.0,!=1.0.1").contains("1.0.1") + False + >>> SpecifierSet(">=1.0.0,!=1.0.1").contains("1.3.0a1") + False + >>> SpecifierSet(">=1.0.0,!=1.0.1", prereleases=True).contains("1.3.0a1") + True + >>> SpecifierSet(">=1.0.0,!=1.0.1").contains("1.3.0a1", prereleases=True) + True + """ + # Ensure that our item is a Version instance. + if not isinstance(item, Version): + item = Version(item) + + # Determine if we're forcing a prerelease or not, if we're not forcing + # one for this particular filter call, then we'll use whatever the + # SpecifierSet thinks for whether or not we should support prereleases. + if prereleases is None: + prereleases = self.prereleases + + # We can determine if we're going to allow pre-releases by looking to + # see if any of the underlying items supports them. If none of them do + # and this item is a pre-release then we do not allow it and we can + # short circuit that here. + # Note: This means that 1.0.dev1 would not be contained in something + # like >=1.0.devabc however it would be in >=1.0.debabc,>0.0.dev0 + if not prereleases and item.is_prerelease: + return False + + if installed and item.is_prerelease: + item = Version(item.base_version) + + # We simply dispatch to the underlying specs here to make sure that the + # given version is contained within all of them. + # Note: This use of all() here means that an empty set of specifiers + # will always return True, this is an explicit design decision. + return all(s.contains(item, prereleases=prereleases) for s in self._specs) + + def filter( + self, iterable: Iterable[UnparsedVersionVar], prereleases: bool | None = None + ) -> Iterator[UnparsedVersionVar]: + """Filter items in the given iterable, that match the specifiers in this set. + + :param iterable: + An iterable that can contain version strings and :class:`Version` instances. + The items in the iterable will be filtered according to the specifier. + :param prereleases: + Whether or not to allow prereleases in the returned iterator. If set to + ``None`` (the default), it will be intelligently decide whether to allow + prereleases or not (based on the :attr:`prereleases` attribute, and + whether the only versions matching are prereleases). + + This method is smarter than just ``filter(SpecifierSet(...).contains, [...])`` + because it implements the rule from :pep:`440` that a prerelease item + SHOULD be accepted if no other versions match the given specifier. + + >>> list(SpecifierSet(">=1.2.3").filter(["1.2", "1.3", "1.5a1"])) + ['1.3'] + >>> list(SpecifierSet(">=1.2.3").filter(["1.2", "1.3", Version("1.4")])) + ['1.3', ] + >>> list(SpecifierSet(">=1.2.3").filter(["1.2", "1.5a1"])) + [] + >>> list(SpecifierSet(">=1.2.3").filter(["1.3", "1.5a1"], prereleases=True)) + ['1.3', '1.5a1'] + >>> list(SpecifierSet(">=1.2.3", prereleases=True).filter(["1.3", "1.5a1"])) + ['1.3', '1.5a1'] + + An "empty" SpecifierSet will filter items based on the presence of prerelease + versions in the set. + + >>> list(SpecifierSet("").filter(["1.3", "1.5a1"])) + ['1.3'] + >>> list(SpecifierSet("").filter(["1.5a1"])) + ['1.5a1'] + >>> list(SpecifierSet("", prereleases=True).filter(["1.3", "1.5a1"])) + ['1.3', '1.5a1'] + >>> list(SpecifierSet("").filter(["1.3", "1.5a1"], prereleases=True)) + ['1.3', '1.5a1'] + """ + # Determine if we're forcing a prerelease or not, if we're not forcing + # one for this particular filter call, then we'll use whatever the + # SpecifierSet thinks for whether or not we should support prereleases. + if prereleases is None: + prereleases = self.prereleases + + # If we have any specifiers, then we want to wrap our iterable in the + # filter method for each one, this will act as a logical AND amongst + # each specifier. + if self._specs: + for spec in self._specs: + iterable = spec.filter(iterable, prereleases=bool(prereleases)) + return iter(iterable) + # If we do not have any specifiers, then we need to have a rough filter + # which will filter out any pre-releases, unless there are no final + # releases. + else: + filtered: list[UnparsedVersionVar] = [] + found_prereleases: list[UnparsedVersionVar] = [] + + for item in iterable: + parsed_version = _coerce_version(item) + + # Store any item which is a pre-release for later unless we've + # already found a final version or we are accepting prereleases + if parsed_version.is_prerelease and not prereleases: + if not filtered: + found_prereleases.append(item) + else: + filtered.append(item) + + # If we've found no items except for pre-releases, then we'll go + # ahead and use the pre-releases + if not filtered and found_prereleases and prereleases is None: + return iter(found_prereleases) + + return iter(filtered) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/tags.py b/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/tags.py new file mode 100644 index 0000000..6667d29 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/tags.py @@ -0,0 +1,568 @@ +# This file is dual licensed under the terms of the Apache License, Version +# 2.0, and the BSD License. See the LICENSE file in the root of this repository +# for complete details. + +from __future__ import annotations + +import logging +import platform +import re +import struct +import subprocess +import sys +import sysconfig +from importlib.machinery import EXTENSION_SUFFIXES +from typing import ( + Iterable, + Iterator, + Sequence, + Tuple, + cast, +) + +from . import _manylinux, _musllinux + +logger = logging.getLogger(__name__) + +PythonVersion = Sequence[int] +MacVersion = Tuple[int, int] + +INTERPRETER_SHORT_NAMES: dict[str, str] = { + "python": "py", # Generic. + "cpython": "cp", + "pypy": "pp", + "ironpython": "ip", + "jython": "jy", +} + + +_32_BIT_INTERPRETER = struct.calcsize("P") == 4 + + +class Tag: + """ + A representation of the tag triple for a wheel. + + Instances are considered immutable and thus are hashable. Equality checking + is also supported. + """ + + __slots__ = ["_interpreter", "_abi", "_platform", "_hash"] + + def __init__(self, interpreter: str, abi: str, platform: str) -> None: + self._interpreter = interpreter.lower() + self._abi = abi.lower() + self._platform = platform.lower() + # The __hash__ of every single element in a Set[Tag] will be evaluated each time + # that a set calls its `.disjoint()` method, which may be called hundreds of + # times when scanning a page of links for packages with tags matching that + # Set[Tag]. Pre-computing the value here produces significant speedups for + # downstream consumers. + self._hash = hash((self._interpreter, self._abi, self._platform)) + + @property + def interpreter(self) -> str: + return self._interpreter + + @property + def abi(self) -> str: + return self._abi + + @property + def platform(self) -> str: + return self._platform + + def __eq__(self, other: object) -> bool: + if not isinstance(other, Tag): + return NotImplemented + + return ( + (self._hash == other._hash) # Short-circuit ASAP for perf reasons. + and (self._platform == other._platform) + and (self._abi == other._abi) + and (self._interpreter == other._interpreter) + ) + + def __hash__(self) -> int: + return self._hash + + def __str__(self) -> str: + return f"{self._interpreter}-{self._abi}-{self._platform}" + + def __repr__(self) -> str: + return f"<{self} @ {id(self)}>" + + +def parse_tag(tag: str) -> frozenset[Tag]: + """ + Parses the provided tag (e.g. `py3-none-any`) into a frozenset of Tag instances. + + Returning a set is required due to the possibility that the tag is a + compressed tag set. + """ + tags = set() + interpreters, abis, platforms = tag.split("-") + for interpreter in interpreters.split("."): + for abi in abis.split("."): + for platform_ in platforms.split("."): + tags.add(Tag(interpreter, abi, platform_)) + return frozenset(tags) + + +def _get_config_var(name: str, warn: bool = False) -> int | str | None: + value: int | str | None = sysconfig.get_config_var(name) + if value is None and warn: + logger.debug( + "Config variable '%s' is unset, Python ABI tag may be incorrect", name + ) + return value + + +def _normalize_string(string: str) -> str: + return string.replace(".", "_").replace("-", "_").replace(" ", "_") + + +def _is_threaded_cpython(abis: list[str]) -> bool: + """ + Determine if the ABI corresponds to a threaded (`--disable-gil`) build. + + The threaded builds are indicated by a "t" in the abiflags. + """ + if len(abis) == 0: + return False + # expect e.g., cp313 + m = re.match(r"cp\d+(.*)", abis[0]) + if not m: + return False + abiflags = m.group(1) + return "t" in abiflags + + +def _abi3_applies(python_version: PythonVersion, threading: bool) -> bool: + """ + Determine if the Python version supports abi3. + + PEP 384 was first implemented in Python 3.2. The threaded (`--disable-gil`) + builds do not support abi3. + """ + return len(python_version) > 1 and tuple(python_version) >= (3, 2) and not threading + + +def _cpython_abis(py_version: PythonVersion, warn: bool = False) -> list[str]: + py_version = tuple(py_version) # To allow for version comparison. + abis = [] + version = _version_nodot(py_version[:2]) + threading = debug = pymalloc = ucs4 = "" + with_debug = _get_config_var("Py_DEBUG", warn) + has_refcount = hasattr(sys, "gettotalrefcount") + # Windows doesn't set Py_DEBUG, so checking for support of debug-compiled + # extension modules is the best option. + # https://github.com/pypa/pip/issues/3383#issuecomment-173267692 + has_ext = "_d.pyd" in EXTENSION_SUFFIXES + if with_debug or (with_debug is None and (has_refcount or has_ext)): + debug = "d" + if py_version >= (3, 13) and _get_config_var("Py_GIL_DISABLED", warn): + threading = "t" + if py_version < (3, 8): + with_pymalloc = _get_config_var("WITH_PYMALLOC", warn) + if with_pymalloc or with_pymalloc is None: + pymalloc = "m" + if py_version < (3, 3): + unicode_size = _get_config_var("Py_UNICODE_SIZE", warn) + if unicode_size == 4 or ( + unicode_size is None and sys.maxunicode == 0x10FFFF + ): + ucs4 = "u" + elif debug: + # Debug builds can also load "normal" extension modules. + # We can also assume no UCS-4 or pymalloc requirement. + abis.append(f"cp{version}{threading}") + abis.insert(0, f"cp{version}{threading}{debug}{pymalloc}{ucs4}") + return abis + + +def cpython_tags( + python_version: PythonVersion | None = None, + abis: Iterable[str] | None = None, + platforms: Iterable[str] | None = None, + *, + warn: bool = False, +) -> Iterator[Tag]: + """ + Yields the tags for a CPython interpreter. + + The tags consist of: + - cp-- + - cp-abi3- + - cp-none- + - cp-abi3- # Older Python versions down to 3.2. + + If python_version only specifies a major version then user-provided ABIs and + the 'none' ABItag will be used. + + If 'abi3' or 'none' are specified in 'abis' then they will be yielded at + their normal position and not at the beginning. + """ + if not python_version: + python_version = sys.version_info[:2] + + interpreter = f"cp{_version_nodot(python_version[:2])}" + + if abis is None: + if len(python_version) > 1: + abis = _cpython_abis(python_version, warn) + else: + abis = [] + abis = list(abis) + # 'abi3' and 'none' are explicitly handled later. + for explicit_abi in ("abi3", "none"): + try: + abis.remove(explicit_abi) + except ValueError: + pass + + platforms = list(platforms or platform_tags()) + for abi in abis: + for platform_ in platforms: + yield Tag(interpreter, abi, platform_) + + threading = _is_threaded_cpython(abis) + use_abi3 = _abi3_applies(python_version, threading) + if use_abi3: + yield from (Tag(interpreter, "abi3", platform_) for platform_ in platforms) + yield from (Tag(interpreter, "none", platform_) for platform_ in platforms) + + if use_abi3: + for minor_version in range(python_version[1] - 1, 1, -1): + for platform_ in platforms: + interpreter = "cp{version}".format( + version=_version_nodot((python_version[0], minor_version)) + ) + yield Tag(interpreter, "abi3", platform_) + + +def _generic_abi() -> list[str]: + """ + Return the ABI tag based on EXT_SUFFIX. + """ + # The following are examples of `EXT_SUFFIX`. + # We want to keep the parts which are related to the ABI and remove the + # parts which are related to the platform: + # - linux: '.cpython-310-x86_64-linux-gnu.so' => cp310 + # - mac: '.cpython-310-darwin.so' => cp310 + # - win: '.cp310-win_amd64.pyd' => cp310 + # - win: '.pyd' => cp37 (uses _cpython_abis()) + # - pypy: '.pypy38-pp73-x86_64-linux-gnu.so' => pypy38_pp73 + # - graalpy: '.graalpy-38-native-x86_64-darwin.dylib' + # => graalpy_38_native + + ext_suffix = _get_config_var("EXT_SUFFIX", warn=True) + if not isinstance(ext_suffix, str) or ext_suffix[0] != ".": + raise SystemError("invalid sysconfig.get_config_var('EXT_SUFFIX')") + parts = ext_suffix.split(".") + if len(parts) < 3: + # CPython3.7 and earlier uses ".pyd" on Windows. + return _cpython_abis(sys.version_info[:2]) + soabi = parts[1] + if soabi.startswith("cpython"): + # non-windows + abi = "cp" + soabi.split("-")[1] + elif soabi.startswith("cp"): + # windows + abi = soabi.split("-")[0] + elif soabi.startswith("pypy"): + abi = "-".join(soabi.split("-")[:2]) + elif soabi.startswith("graalpy"): + abi = "-".join(soabi.split("-")[:3]) + elif soabi: + # pyston, ironpython, others? + abi = soabi + else: + return [] + return [_normalize_string(abi)] + + +def generic_tags( + interpreter: str | None = None, + abis: Iterable[str] | None = None, + platforms: Iterable[str] | None = None, + *, + warn: bool = False, +) -> Iterator[Tag]: + """ + Yields the tags for a generic interpreter. + + The tags consist of: + - -- + + The "none" ABI will be added if it was not explicitly provided. + """ + if not interpreter: + interp_name = interpreter_name() + interp_version = interpreter_version(warn=warn) + interpreter = "".join([interp_name, interp_version]) + if abis is None: + abis = _generic_abi() + else: + abis = list(abis) + platforms = list(platforms or platform_tags()) + if "none" not in abis: + abis.append("none") + for abi in abis: + for platform_ in platforms: + yield Tag(interpreter, abi, platform_) + + +def _py_interpreter_range(py_version: PythonVersion) -> Iterator[str]: + """ + Yields Python versions in descending order. + + After the latest version, the major-only version will be yielded, and then + all previous versions of that major version. + """ + if len(py_version) > 1: + yield f"py{_version_nodot(py_version[:2])}" + yield f"py{py_version[0]}" + if len(py_version) > 1: + for minor in range(py_version[1] - 1, -1, -1): + yield f"py{_version_nodot((py_version[0], minor))}" + + +def compatible_tags( + python_version: PythonVersion | None = None, + interpreter: str | None = None, + platforms: Iterable[str] | None = None, +) -> Iterator[Tag]: + """ + Yields the sequence of tags that are compatible with a specific version of Python. + + The tags consist of: + - py*-none- + - -none-any # ... if `interpreter` is provided. + - py*-none-any + """ + if not python_version: + python_version = sys.version_info[:2] + platforms = list(platforms or platform_tags()) + for version in _py_interpreter_range(python_version): + for platform_ in platforms: + yield Tag(version, "none", platform_) + if interpreter: + yield Tag(interpreter, "none", "any") + for version in _py_interpreter_range(python_version): + yield Tag(version, "none", "any") + + +def _mac_arch(arch: str, is_32bit: bool = _32_BIT_INTERPRETER) -> str: + if not is_32bit: + return arch + + if arch.startswith("ppc"): + return "ppc" + + return "i386" + + +def _mac_binary_formats(version: MacVersion, cpu_arch: str) -> list[str]: + formats = [cpu_arch] + if cpu_arch == "x86_64": + if version < (10, 4): + return [] + formats.extend(["intel", "fat64", "fat32"]) + + elif cpu_arch == "i386": + if version < (10, 4): + return [] + formats.extend(["intel", "fat32", "fat"]) + + elif cpu_arch == "ppc64": + # TODO: Need to care about 32-bit PPC for ppc64 through 10.2? + if version > (10, 5) or version < (10, 4): + return [] + formats.append("fat64") + + elif cpu_arch == "ppc": + if version > (10, 6): + return [] + formats.extend(["fat32", "fat"]) + + if cpu_arch in {"arm64", "x86_64"}: + formats.append("universal2") + + if cpu_arch in {"x86_64", "i386", "ppc64", "ppc", "intel"}: + formats.append("universal") + + return formats + + +def mac_platforms( + version: MacVersion | None = None, arch: str | None = None +) -> Iterator[str]: + """ + Yields the platform tags for a macOS system. + + The `version` parameter is a two-item tuple specifying the macOS version to + generate platform tags for. The `arch` parameter is the CPU architecture to + generate platform tags for. Both parameters default to the appropriate value + for the current system. + """ + version_str, _, cpu_arch = platform.mac_ver() + if version is None: + version = cast("MacVersion", tuple(map(int, version_str.split(".")[:2]))) + if version == (10, 16): + # When built against an older macOS SDK, Python will report macOS 10.16 + # instead of the real version. + version_str = subprocess.run( + [ + sys.executable, + "-sS", + "-c", + "import platform; print(platform.mac_ver()[0])", + ], + check=True, + env={"SYSTEM_VERSION_COMPAT": "0"}, + stdout=subprocess.PIPE, + text=True, + ).stdout + version = cast("MacVersion", tuple(map(int, version_str.split(".")[:2]))) + else: + version = version + if arch is None: + arch = _mac_arch(cpu_arch) + else: + arch = arch + + if (10, 0) <= version and version < (11, 0): + # Prior to Mac OS 11, each yearly release of Mac OS bumped the + # "minor" version number. The major version was always 10. + for minor_version in range(version[1], -1, -1): + compat_version = 10, minor_version + binary_formats = _mac_binary_formats(compat_version, arch) + for binary_format in binary_formats: + yield "macosx_{major}_{minor}_{binary_format}".format( + major=10, minor=minor_version, binary_format=binary_format + ) + + if version >= (11, 0): + # Starting with Mac OS 11, each yearly release bumps the major version + # number. The minor versions are now the midyear updates. + for major_version in range(version[0], 10, -1): + compat_version = major_version, 0 + binary_formats = _mac_binary_formats(compat_version, arch) + for binary_format in binary_formats: + yield "macosx_{major}_{minor}_{binary_format}".format( + major=major_version, minor=0, binary_format=binary_format + ) + + if version >= (11, 0): + # Mac OS 11 on x86_64 is compatible with binaries from previous releases. + # Arm64 support was introduced in 11.0, so no Arm binaries from previous + # releases exist. + # + # However, the "universal2" binary format can have a + # macOS version earlier than 11.0 when the x86_64 part of the binary supports + # that version of macOS. + if arch == "x86_64": + for minor_version in range(16, 3, -1): + compat_version = 10, minor_version + binary_formats = _mac_binary_formats(compat_version, arch) + for binary_format in binary_formats: + yield "macosx_{major}_{minor}_{binary_format}".format( + major=compat_version[0], + minor=compat_version[1], + binary_format=binary_format, + ) + else: + for minor_version in range(16, 3, -1): + compat_version = 10, minor_version + binary_format = "universal2" + yield "macosx_{major}_{minor}_{binary_format}".format( + major=compat_version[0], + minor=compat_version[1], + binary_format=binary_format, + ) + + +def _linux_platforms(is_32bit: bool = _32_BIT_INTERPRETER) -> Iterator[str]: + linux = _normalize_string(sysconfig.get_platform()) + if not linux.startswith("linux_"): + # we should never be here, just yield the sysconfig one and return + yield linux + return + if is_32bit: + if linux == "linux_x86_64": + linux = "linux_i686" + elif linux == "linux_aarch64": + linux = "linux_armv8l" + _, arch = linux.split("_", 1) + archs = {"armv8l": ["armv8l", "armv7l"]}.get(arch, [arch]) + yield from _manylinux.platform_tags(archs) + yield from _musllinux.platform_tags(archs) + for arch in archs: + yield f"linux_{arch}" + + +def _generic_platforms() -> Iterator[str]: + yield _normalize_string(sysconfig.get_platform()) + + +def platform_tags() -> Iterator[str]: + """ + Provides the platform tags for this installation. + """ + if platform.system() == "Darwin": + return mac_platforms() + elif platform.system() == "Linux": + return _linux_platforms() + else: + return _generic_platforms() + + +def interpreter_name() -> str: + """ + Returns the name of the running interpreter. + + Some implementations have a reserved, two-letter abbreviation which will + be returned when appropriate. + """ + name = sys.implementation.name + return INTERPRETER_SHORT_NAMES.get(name) or name + + +def interpreter_version(*, warn: bool = False) -> str: + """ + Returns the version of the running interpreter. + """ + version = _get_config_var("py_version_nodot", warn=warn) + if version: + version = str(version) + else: + version = _version_nodot(sys.version_info[:2]) + return version + + +def _version_nodot(version: PythonVersion) -> str: + return "".join(map(str, version)) + + +def sys_tags(*, warn: bool = False) -> Iterator[Tag]: + """ + Returns the sequence of tag triples for the running interpreter. + + The order of the sequence corresponds to priority order for the + interpreter, from most to least important. + """ + + interp_name = interpreter_name() + if interp_name == "cp": + yield from cpython_tags(warn=warn) + else: + yield from generic_tags() + + if interp_name == "pp": + interp = "pp3" + elif interp_name == "cp": + interp = "cp" + interpreter_version(warn=warn) + else: + interp = None + yield from compatible_tags(interpreter=interp) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/utils.py b/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/utils.py new file mode 100644 index 0000000..d33da5b --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/utils.py @@ -0,0 +1,174 @@ +# This file is dual licensed under the terms of the Apache License, Version +# 2.0, and the BSD License. See the LICENSE file in the root of this repository +# for complete details. + +from __future__ import annotations + +import re +from typing import NewType, Tuple, Union, cast + +from .tags import Tag, parse_tag +from .version import InvalidVersion, Version + +BuildTag = Union[Tuple[()], Tuple[int, str]] +NormalizedName = NewType("NormalizedName", str) + + +class InvalidName(ValueError): + """ + An invalid distribution name; users should refer to the packaging user guide. + """ + + +class InvalidWheelFilename(ValueError): + """ + An invalid wheel filename was found, users should refer to PEP 427. + """ + + +class InvalidSdistFilename(ValueError): + """ + An invalid sdist filename was found, users should refer to the packaging user guide. + """ + + +# Core metadata spec for `Name` +_validate_regex = re.compile( + r"^([A-Z0-9]|[A-Z0-9][A-Z0-9._-]*[A-Z0-9])$", re.IGNORECASE +) +_canonicalize_regex = re.compile(r"[-_.]+") +_normalized_regex = re.compile(r"^([a-z0-9]|[a-z0-9]([a-z0-9-](?!--))*[a-z0-9])$") +# PEP 427: The build number must start with a digit. +_build_tag_regex = re.compile(r"(\d+)(.*)") + + +def canonicalize_name(name: str, *, validate: bool = False) -> NormalizedName: + if validate and not _validate_regex.match(name): + raise InvalidName(f"name is invalid: {name!r}") + # This is taken from PEP 503. + value = _canonicalize_regex.sub("-", name).lower() + return cast(NormalizedName, value) + + +def is_normalized_name(name: str) -> bool: + return _normalized_regex.match(name) is not None + + +def canonicalize_version( + version: Version | str, *, strip_trailing_zero: bool = True +) -> str: + """ + This is very similar to Version.__str__, but has one subtle difference + with the way it handles the release segment. + """ + if isinstance(version, str): + try: + parsed = Version(version) + except InvalidVersion: + # Legacy versions cannot be normalized + return version + else: + parsed = version + + parts = [] + + # Epoch + if parsed.epoch != 0: + parts.append(f"{parsed.epoch}!") + + # Release segment + release_segment = ".".join(str(x) for x in parsed.release) + if strip_trailing_zero: + # NB: This strips trailing '.0's to normalize + release_segment = re.sub(r"(\.0)+$", "", release_segment) + parts.append(release_segment) + + # Pre-release + if parsed.pre is not None: + parts.append("".join(str(x) for x in parsed.pre)) + + # Post-release + if parsed.post is not None: + parts.append(f".post{parsed.post}") + + # Development release + if parsed.dev is not None: + parts.append(f".dev{parsed.dev}") + + # Local version segment + if parsed.local is not None: + parts.append(f"+{parsed.local}") + + return "".join(parts) + + +def parse_wheel_filename( + filename: str, +) -> tuple[NormalizedName, Version, BuildTag, frozenset[Tag]]: + if not filename.endswith(".whl"): + raise InvalidWheelFilename( + f"Invalid wheel filename (extension must be '.whl'): {filename}" + ) + + filename = filename[:-4] + dashes = filename.count("-") + if dashes not in (4, 5): + raise InvalidWheelFilename( + f"Invalid wheel filename (wrong number of parts): {filename}" + ) + + parts = filename.split("-", dashes - 2) + name_part = parts[0] + # See PEP 427 for the rules on escaping the project name. + if "__" in name_part or re.match(r"^[\w\d._]*$", name_part, re.UNICODE) is None: + raise InvalidWheelFilename(f"Invalid project name: {filename}") + name = canonicalize_name(name_part) + + try: + version = Version(parts[1]) + except InvalidVersion as e: + raise InvalidWheelFilename( + f"Invalid wheel filename (invalid version): {filename}" + ) from e + + if dashes == 5: + build_part = parts[2] + build_match = _build_tag_regex.match(build_part) + if build_match is None: + raise InvalidWheelFilename( + f"Invalid build number: {build_part} in '{filename}'" + ) + build = cast(BuildTag, (int(build_match.group(1)), build_match.group(2))) + else: + build = () + tags = parse_tag(parts[-1]) + return (name, version, build, tags) + + +def parse_sdist_filename(filename: str) -> tuple[NormalizedName, Version]: + if filename.endswith(".tar.gz"): + file_stem = filename[: -len(".tar.gz")] + elif filename.endswith(".zip"): + file_stem = filename[: -len(".zip")] + else: + raise InvalidSdistFilename( + f"Invalid sdist filename (extension must be '.tar.gz' or '.zip'):" + f" {filename}" + ) + + # We are requiring a PEP 440 version, which cannot contain dashes, + # so we split on the last dash. + name_part, sep, version_part = file_stem.rpartition("-") + if not sep: + raise InvalidSdistFilename(f"Invalid sdist filename: {filename}") + + name = canonicalize_name(name_part) + + try: + version = Version(version_part) + except InvalidVersion as e: + raise InvalidSdistFilename( + f"Invalid sdist filename (invalid version): {filename}" + ) from e + + return (name, version) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/version.py b/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/version.py new file mode 100644 index 0000000..8b0a040 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/packaging/version.py @@ -0,0 +1,563 @@ +# This file is dual licensed under the terms of the Apache License, Version +# 2.0, and the BSD License. See the LICENSE file in the root of this repository +# for complete details. +""" +.. testsetup:: + + from pip._vendor.packaging.version import parse, Version +""" + +from __future__ import annotations + +import itertools +import re +from typing import Any, Callable, NamedTuple, SupportsInt, Tuple, Union + +from ._structures import Infinity, InfinityType, NegativeInfinity, NegativeInfinityType + +__all__ = ["VERSION_PATTERN", "parse", "Version", "InvalidVersion"] + +LocalType = Tuple[Union[int, str], ...] + +CmpPrePostDevType = Union[InfinityType, NegativeInfinityType, Tuple[str, int]] +CmpLocalType = Union[ + NegativeInfinityType, + Tuple[Union[Tuple[int, str], Tuple[NegativeInfinityType, Union[int, str]]], ...], +] +CmpKey = Tuple[ + int, + Tuple[int, ...], + CmpPrePostDevType, + CmpPrePostDevType, + CmpPrePostDevType, + CmpLocalType, +] +VersionComparisonMethod = Callable[[CmpKey, CmpKey], bool] + + +class _Version(NamedTuple): + epoch: int + release: tuple[int, ...] + dev: tuple[str, int] | None + pre: tuple[str, int] | None + post: tuple[str, int] | None + local: LocalType | None + + +def parse(version: str) -> Version: + """Parse the given version string. + + >>> parse('1.0.dev1') + + + :param version: The version string to parse. + :raises InvalidVersion: When the version string is not a valid version. + """ + return Version(version) + + +class InvalidVersion(ValueError): + """Raised when a version string is not a valid version. + + >>> Version("invalid") + Traceback (most recent call last): + ... + packaging.version.InvalidVersion: Invalid version: 'invalid' + """ + + +class _BaseVersion: + _key: tuple[Any, ...] + + def __hash__(self) -> int: + return hash(self._key) + + # Please keep the duplicated `isinstance` check + # in the six comparisons hereunder + # unless you find a way to avoid adding overhead function calls. + def __lt__(self, other: _BaseVersion) -> bool: + if not isinstance(other, _BaseVersion): + return NotImplemented + + return self._key < other._key + + def __le__(self, other: _BaseVersion) -> bool: + if not isinstance(other, _BaseVersion): + return NotImplemented + + return self._key <= other._key + + def __eq__(self, other: object) -> bool: + if not isinstance(other, _BaseVersion): + return NotImplemented + + return self._key == other._key + + def __ge__(self, other: _BaseVersion) -> bool: + if not isinstance(other, _BaseVersion): + return NotImplemented + + return self._key >= other._key + + def __gt__(self, other: _BaseVersion) -> bool: + if not isinstance(other, _BaseVersion): + return NotImplemented + + return self._key > other._key + + def __ne__(self, other: object) -> bool: + if not isinstance(other, _BaseVersion): + return NotImplemented + + return self._key != other._key + + +# Deliberately not anchored to the start and end of the string, to make it +# easier for 3rd party code to reuse +_VERSION_PATTERN = r""" + v? + (?: + (?:(?P[0-9]+)!)? # epoch + (?P[0-9]+(?:\.[0-9]+)*) # release segment + (?P

!I7S{BS4i1|@R7s@ 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/t64.exe b/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/t64.exe new file mode 100644 index 0000000000000000000000000000000000000000..e8bebdba6d8f242244bf397ab067965d47c5093e GIT binary patch literal 108032 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%0AHbpwE%ZM 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 H#ex3;_fXA_ literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/util.py b/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/util.py new file mode 100644 index 0000000..ba58858 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/util.py @@ -0,0 +1,2025 @@ +# +# Copyright (C) 2012-2023 The Python Software Foundation. +# See LICENSE.txt and CONTRIBUTORS.txt. +# +import codecs +from collections import deque +import contextlib +import csv +from glob import iglob as std_iglob +import io +import json +import logging +import os +import py_compile +import re +import socket +try: + import ssl +except ImportError: # pragma: no cover + ssl = None +import subprocess +import sys +import tarfile +import tempfile +import textwrap + +try: + import threading +except ImportError: # pragma: no cover + import dummy_threading as threading +import time + +from . import DistlibException +from .compat import (string_types, text_type, shutil, raw_input, StringIO, + cache_from_source, urlopen, urljoin, httplib, xmlrpclib, + HTTPHandler, BaseConfigurator, valid_ident, + Container, configparser, URLError, ZipFile, fsdecode, + unquote, urlparse) + +logger = logging.getLogger(__name__) + +# +# Requirement parsing code as per PEP 508 +# + +IDENTIFIER = re.compile(r'^([\w\.-]+)\s*') +VERSION_IDENTIFIER = re.compile(r'^([\w\.*+-]+)\s*') +COMPARE_OP = re.compile(r'^(<=?|>=?|={2,3}|[~!]=)\s*') +MARKER_OP = re.compile(r'^((<=?)|(>=?)|={2,3}|[~!]=|in|not\s+in)\s*') +OR = re.compile(r'^or\b\s*') +AND = re.compile(r'^and\b\s*') +NON_SPACE = re.compile(r'(\S+)\s*') +STRING_CHUNK = re.compile(r'([\s\w\.{}()*+#:;,/?!~`@$%^&=|<>\[\]-]+)') + + +def parse_marker(marker_string): + """ + Parse a marker string and return a dictionary containing a marker expression. + + The dictionary will contain keys "op", "lhs" and "rhs" for non-terminals in + the expression grammar, or strings. A string contained in quotes is to be + interpreted as a literal string, and a string not contained in quotes is a + variable (such as os_name). + """ + + def marker_var(remaining): + # either identifier, or literal string + m = IDENTIFIER.match(remaining) + if m: + result = m.groups()[0] + remaining = remaining[m.end():] + elif not remaining: + raise SyntaxError('unexpected end of input') + else: + q = remaining[0] + if q not in '\'"': + raise SyntaxError('invalid expression: %s' % remaining) + oq = '\'"'.replace(q, '') + remaining = remaining[1:] + parts = [q] + while remaining: + # either a string chunk, or oq, or q to terminate + if remaining[0] == q: + break + elif remaining[0] == oq: + parts.append(oq) + remaining = remaining[1:] + else: + m = STRING_CHUNK.match(remaining) + if not m: + raise SyntaxError('error in string literal: %s' % + remaining) + parts.append(m.groups()[0]) + remaining = remaining[m.end():] + else: + s = ''.join(parts) + raise SyntaxError('unterminated string: %s' % s) + parts.append(q) + result = ''.join(parts) + remaining = remaining[1:].lstrip() # skip past closing quote + return result, remaining + + def marker_expr(remaining): + if remaining and remaining[0] == '(': + result, remaining = marker(remaining[1:].lstrip()) + if remaining[0] != ')': + raise SyntaxError('unterminated parenthesis: %s' % remaining) + remaining = remaining[1:].lstrip() + else: + lhs, remaining = marker_var(remaining) + while remaining: + m = MARKER_OP.match(remaining) + if not m: + break + op = m.groups()[0] + remaining = remaining[m.end():] + rhs, remaining = marker_var(remaining) + lhs = {'op': op, 'lhs': lhs, 'rhs': rhs} + result = lhs + return result, remaining + + def marker_and(remaining): + lhs, remaining = marker_expr(remaining) + while remaining: + m = AND.match(remaining) + if not m: + break + remaining = remaining[m.end():] + rhs, remaining = marker_expr(remaining) + lhs = {'op': 'and', 'lhs': lhs, 'rhs': rhs} + return lhs, remaining + + def marker(remaining): + lhs, remaining = marker_and(remaining) + while remaining: + m = OR.match(remaining) + if not m: + break + remaining = remaining[m.end():] + rhs, remaining = marker_and(remaining) + lhs = {'op': 'or', 'lhs': lhs, 'rhs': rhs} + return lhs, remaining + + return marker(marker_string) + + +def parse_requirement(req): + """ + Parse a requirement passed in as a string. Return a Container + whose attributes contain the various parts of the requirement. + """ + remaining = req.strip() + if not remaining or remaining.startswith('#'): + return None + m = IDENTIFIER.match(remaining) + if not m: + raise SyntaxError('name expected: %s' % remaining) + distname = m.groups()[0] + remaining = remaining[m.end():] + extras = mark_expr = versions = uri = None + if remaining and remaining[0] == '[': + i = remaining.find(']', 1) + if i < 0: + raise SyntaxError('unterminated extra: %s' % remaining) + s = remaining[1:i] + remaining = remaining[i + 1:].lstrip() + extras = [] + while s: + m = IDENTIFIER.match(s) + if not m: + raise SyntaxError('malformed extra: %s' % s) + extras.append(m.groups()[0]) + s = s[m.end():] + if not s: + break + if s[0] != ',': + raise SyntaxError('comma expected in extras: %s' % s) + s = s[1:].lstrip() + if not extras: + extras = None + if remaining: + if remaining[0] == '@': + # it's a URI + remaining = remaining[1:].lstrip() + m = NON_SPACE.match(remaining) + if not m: + raise SyntaxError('invalid URI: %s' % remaining) + uri = m.groups()[0] + t = urlparse(uri) + # there are issues with Python and URL parsing, so this test + # is a bit crude. See bpo-20271, bpo-23505. Python doesn't + # always parse invalid URLs correctly - it should raise + # exceptions for malformed URLs + if not (t.scheme and t.netloc): + raise SyntaxError('Invalid URL: %s' % uri) + remaining = remaining[m.end():].lstrip() + else: + + def get_versions(ver_remaining): + """ + Return a list of operator, version tuples if any are + specified, else None. + """ + m = COMPARE_OP.match(ver_remaining) + versions = None + if m: + versions = [] + while True: + op = m.groups()[0] + ver_remaining = ver_remaining[m.end():] + m = VERSION_IDENTIFIER.match(ver_remaining) + if not m: + raise SyntaxError('invalid version: %s' % + ver_remaining) + v = m.groups()[0] + versions.append((op, v)) + ver_remaining = ver_remaining[m.end():] + if not ver_remaining or ver_remaining[0] != ',': + break + ver_remaining = ver_remaining[1:].lstrip() + # Some packages have a trailing comma which would break things + # See issue #148 + if not ver_remaining: + break + m = COMPARE_OP.match(ver_remaining) + if not m: + raise SyntaxError('invalid constraint: %s' % + ver_remaining) + if not versions: + versions = None + return versions, ver_remaining + + if remaining[0] != '(': + versions, remaining = get_versions(remaining) + else: + i = remaining.find(')', 1) + if i < 0: + raise SyntaxError('unterminated parenthesis: %s' % + remaining) + s = remaining[1:i] + remaining = remaining[i + 1:].lstrip() + # As a special diversion from PEP 508, allow a version number + # a.b.c in parentheses as a synonym for ~= a.b.c (because this + # is allowed in earlier PEPs) + if COMPARE_OP.match(s): + versions, _ = get_versions(s) + else: + m = VERSION_IDENTIFIER.match(s) + if not m: + raise SyntaxError('invalid constraint: %s' % s) + v = m.groups()[0] + s = s[m.end():].lstrip() + if s: + raise SyntaxError('invalid constraint: %s' % s) + versions = [('~=', v)] + + if remaining: + if remaining[0] != ';': + raise SyntaxError('invalid requirement: %s' % remaining) + remaining = remaining[1:].lstrip() + + mark_expr, remaining = parse_marker(remaining) + + if remaining and remaining[0] != '#': + raise SyntaxError('unexpected trailing data: %s' % remaining) + + if not versions: + rs = distname + else: + rs = '%s %s' % (distname, ', '.join( + ['%s %s' % con for con in versions])) + return Container(name=distname, + extras=extras, + constraints=versions, + marker=mark_expr, + url=uri, + requirement=rs) + + +def get_resources_dests(resources_root, rules): + """Find destinations for resources files""" + + def get_rel_path(root, path): + # normalizes and returns a lstripped-/-separated path + root = root.replace(os.path.sep, '/') + path = path.replace(os.path.sep, '/') + assert path.startswith(root) + return path[len(root):].lstrip('/') + + destinations = {} + for base, suffix, dest in rules: + prefix = os.path.join(resources_root, base) + for abs_base in iglob(prefix): + abs_glob = os.path.join(abs_base, suffix) + for abs_path in iglob(abs_glob): + resource_file = get_rel_path(resources_root, abs_path) + if dest is None: # remove the entry if it was here + destinations.pop(resource_file, None) + else: + rel_path = get_rel_path(abs_base, abs_path) + rel_dest = dest.replace(os.path.sep, '/').rstrip('/') + destinations[resource_file] = rel_dest + '/' + rel_path + return destinations + + +def in_venv(): + if hasattr(sys, 'real_prefix'): + # virtualenv venvs + result = True + else: + # PEP 405 venvs + result = sys.prefix != getattr(sys, 'base_prefix', sys.prefix) + return result + + +def get_executable(): + # The __PYVENV_LAUNCHER__ dance is apparently no longer needed, as + # changes to the stub launcher mean that sys.executable always points + # to the stub on OS X + # if sys.platform == 'darwin' and ('__PYVENV_LAUNCHER__' + # in os.environ): + # result = os.environ['__PYVENV_LAUNCHER__'] + # else: + # result = sys.executable + # return result + # Avoid normcasing: see issue #143 + # result = os.path.normcase(sys.executable) + result = sys.executable + if not isinstance(result, text_type): + result = fsdecode(result) + return result + + +def proceed(prompt, allowed_chars, error_prompt=None, default=None): + p = prompt + while True: + s = raw_input(p) + p = prompt + if not s and default: + s = default + if s: + c = s[0].lower() + if c in allowed_chars: + break + if error_prompt: + p = '%c: %s\n%s' % (c, error_prompt, prompt) + return c + + +def extract_by_key(d, keys): + if isinstance(keys, string_types): + keys = keys.split() + result = {} + for key in keys: + if key in d: + result[key] = d[key] + return result + + +def read_exports(stream): + if sys.version_info[0] >= 3: + # needs to be a text stream + stream = codecs.getreader('utf-8')(stream) + # Try to load as JSON, falling back on legacy format + data = stream.read() + stream = StringIO(data) + try: + jdata = json.load(stream) + result = jdata['extensions']['python.exports']['exports'] + for group, entries in result.items(): + for k, v in entries.items(): + s = '%s = %s' % (k, v) + entry = get_export_entry(s) + assert entry is not None + entries[k] = entry + return result + except Exception: + stream.seek(0, 0) + + def read_stream(cp, stream): + if hasattr(cp, 'read_file'): + cp.read_file(stream) + else: + cp.readfp(stream) + + cp = configparser.ConfigParser() + try: + read_stream(cp, stream) + except configparser.MissingSectionHeaderError: + stream.close() + data = textwrap.dedent(data) + stream = StringIO(data) + read_stream(cp, stream) + + result = {} + for key in cp.sections(): + result[key] = entries = {} + for name, value in cp.items(key): + s = '%s = %s' % (name, value) + entry = get_export_entry(s) + assert entry is not None + # entry.dist = self + entries[name] = entry + return result + + +def write_exports(exports, stream): + if sys.version_info[0] >= 3: + # needs to be a text stream + stream = codecs.getwriter('utf-8')(stream) + cp = configparser.ConfigParser() + for k, v in exports.items(): + # TODO check k, v for valid values + cp.add_section(k) + for entry in v.values(): + if entry.suffix is None: + s = entry.prefix + else: + s = '%s:%s' % (entry.prefix, entry.suffix) + if entry.flags: + s = '%s [%s]' % (s, ', '.join(entry.flags)) + cp.set(k, entry.name, s) + cp.write(stream) + + +@contextlib.contextmanager +def tempdir(): + td = tempfile.mkdtemp() + try: + yield td + finally: + shutil.rmtree(td) + + +@contextlib.contextmanager +def chdir(d): + cwd = os.getcwd() + try: + os.chdir(d) + yield + finally: + os.chdir(cwd) + + +@contextlib.contextmanager +def socket_timeout(seconds=15): + cto = socket.getdefaulttimeout() + try: + socket.setdefaulttimeout(seconds) + yield + finally: + socket.setdefaulttimeout(cto) + + +class cached_property(object): + + def __init__(self, func): + self.func = func + # for attr in ('__name__', '__module__', '__doc__'): + # setattr(self, attr, getattr(func, attr, None)) + + def __get__(self, obj, cls=None): + if obj is None: + return self + value = self.func(obj) + object.__setattr__(obj, self.func.__name__, value) + # obj.__dict__[self.func.__name__] = value = self.func(obj) + return value + + +def convert_path(pathname): + """Return 'pathname' as a name that will work on the native filesystem. + + The path is split on '/' and put back together again using the current + directory separator. Needed because filenames in the setup script are + always supplied in Unix style, and have to be converted to the local + convention before we can actually use them in the filesystem. Raises + ValueError on non-Unix-ish systems if 'pathname' either starts or + ends with a slash. + """ + if os.sep == '/': + return pathname + if not pathname: + return pathname + if pathname[0] == '/': + raise ValueError("path '%s' cannot be absolute" % pathname) + if pathname[-1] == '/': + raise ValueError("path '%s' cannot end with '/'" % pathname) + + paths = pathname.split('/') + while os.curdir in paths: + paths.remove(os.curdir) + if not paths: + return os.curdir + return os.path.join(*paths) + + +class FileOperator(object): + + def __init__(self, dry_run=False): + self.dry_run = dry_run + self.ensured = set() + self._init_record() + + def _init_record(self): + self.record = False + self.files_written = set() + self.dirs_created = set() + + def record_as_written(self, path): + if self.record: + self.files_written.add(path) + + def newer(self, source, target): + """Tell if the target is newer than the source. + + Returns true if 'source' exists and is more recently modified than + 'target', or if 'source' exists and 'target' doesn't. + + Returns false if both exist and 'target' is the same age or younger + than 'source'. Raise PackagingFileError if 'source' does not exist. + + Note that this test is not very accurate: files created in the same + second will have the same "age". + """ + if not os.path.exists(source): + raise DistlibException("file '%r' does not exist" % + os.path.abspath(source)) + if not os.path.exists(target): + return True + + return os.stat(source).st_mtime > os.stat(target).st_mtime + + def copy_file(self, infile, outfile, check=True): + """Copy a file respecting dry-run and force flags. + """ + self.ensure_dir(os.path.dirname(outfile)) + logger.info('Copying %s to %s', infile, outfile) + if not self.dry_run: + msg = None + if check: + if os.path.islink(outfile): + msg = '%s is a symlink' % outfile + elif os.path.exists(outfile) and not os.path.isfile(outfile): + msg = '%s is a non-regular file' % outfile + if msg: + raise ValueError(msg + ' which would be overwritten') + shutil.copyfile(infile, outfile) + self.record_as_written(outfile) + + def copy_stream(self, instream, outfile, encoding=None): + assert not os.path.isdir(outfile) + self.ensure_dir(os.path.dirname(outfile)) + logger.info('Copying stream %s to %s', instream, outfile) + if not self.dry_run: + if encoding is None: + outstream = open(outfile, 'wb') + else: + outstream = codecs.open(outfile, 'w', encoding=encoding) + try: + shutil.copyfileobj(instream, outstream) + finally: + outstream.close() + self.record_as_written(outfile) + + def write_binary_file(self, path, data): + self.ensure_dir(os.path.dirname(path)) + if not self.dry_run: + if os.path.exists(path): + os.remove(path) + with open(path, 'wb') as f: + f.write(data) + self.record_as_written(path) + + def write_text_file(self, path, data, encoding): + self.write_binary_file(path, data.encode(encoding)) + + def set_mode(self, bits, mask, files): + if os.name == 'posix' or (os.name == 'java' and os._name == 'posix'): + # Set the executable bits (owner, group, and world) on + # all the files specified. + for f in files: + if self.dry_run: + logger.info("changing mode of %s", f) + else: + mode = (os.stat(f).st_mode | bits) & mask + logger.info("changing mode of %s to %o", f, mode) + os.chmod(f, mode) + + set_executable_mode = lambda s, f: s.set_mode(0o555, 0o7777, f) + + def ensure_dir(self, path): + path = os.path.abspath(path) + if path not in self.ensured and not os.path.exists(path): + self.ensured.add(path) + d, f = os.path.split(path) + self.ensure_dir(d) + logger.info('Creating %s' % path) + if not self.dry_run: + os.mkdir(path) + if self.record: + self.dirs_created.add(path) + + def byte_compile(self, + path, + optimize=False, + force=False, + prefix=None, + hashed_invalidation=False): + dpath = cache_from_source(path, not optimize) + logger.info('Byte-compiling %s to %s', path, dpath) + if not self.dry_run: + if force or self.newer(path, dpath): + if not prefix: + diagpath = None + else: + assert path.startswith(prefix) + diagpath = path[len(prefix):] + compile_kwargs = {} + if hashed_invalidation and hasattr(py_compile, + 'PycInvalidationMode'): + compile_kwargs[ + 'invalidation_mode'] = py_compile.PycInvalidationMode.CHECKED_HASH + py_compile.compile(path, dpath, diagpath, True, + **compile_kwargs) # raise error + self.record_as_written(dpath) + return dpath + + def ensure_removed(self, path): + if os.path.exists(path): + if os.path.isdir(path) and not os.path.islink(path): + logger.debug('Removing directory tree at %s', path) + if not self.dry_run: + shutil.rmtree(path) + if self.record: + if path in self.dirs_created: + self.dirs_created.remove(path) + else: + if os.path.islink(path): + s = 'link' + else: + s = 'file' + logger.debug('Removing %s %s', s, path) + if not self.dry_run: + os.remove(path) + if self.record: + if path in self.files_written: + self.files_written.remove(path) + + def is_writable(self, path): + result = False + while not result: + if os.path.exists(path): + result = os.access(path, os.W_OK) + break + parent = os.path.dirname(path) + if parent == path: + break + path = parent + return result + + def commit(self): + """ + Commit recorded changes, turn off recording, return + changes. + """ + assert self.record + result = self.files_written, self.dirs_created + self._init_record() + return result + + def rollback(self): + if not self.dry_run: + for f in list(self.files_written): + if os.path.exists(f): + os.remove(f) + # dirs should all be empty now, except perhaps for + # __pycache__ subdirs + # reverse so that subdirs appear before their parents + dirs = sorted(self.dirs_created, reverse=True) + for d in dirs: + flist = os.listdir(d) + if flist: + assert flist == ['__pycache__'] + sd = os.path.join(d, flist[0]) + os.rmdir(sd) + os.rmdir(d) # should fail if non-empty + self._init_record() + + +def resolve(module_name, dotted_path): + if module_name in sys.modules: + mod = sys.modules[module_name] + else: + mod = __import__(module_name) + if dotted_path is None: + result = mod + else: + parts = dotted_path.split('.') + result = getattr(mod, parts.pop(0)) + for p in parts: + result = getattr(result, p) + return result + + +class ExportEntry(object): + + def __init__(self, name, prefix, suffix, flags): + self.name = name + self.prefix = prefix + self.suffix = suffix + self.flags = flags + + @cached_property + def value(self): + return resolve(self.prefix, self.suffix) + + def __repr__(self): # pragma: no cover + return '' % (self.name, self.prefix, + self.suffix, self.flags) + + def __eq__(self, other): + if not isinstance(other, ExportEntry): + result = False + else: + result = (self.name == other.name and self.prefix == other.prefix + and self.suffix == other.suffix + and self.flags == other.flags) + return result + + __hash__ = object.__hash__ + + +ENTRY_RE = re.compile( + r'''(?P([^\[]\S*)) + \s*=\s*(?P(\w+)([:\.]\w+)*) + \s*(\[\s*(?P[\w-]+(=\w+)?(,\s*\w+(=\w+)?)*)\s*\])? + ''', re.VERBOSE) + + +def get_export_entry(specification): + m = ENTRY_RE.search(specification) + if not m: + result = None + if '[' in specification or ']' in specification: + raise DistlibException("Invalid specification " + "'%s'" % specification) + else: + d = m.groupdict() + name = d['name'] + path = d['callable'] + colons = path.count(':') + if colons == 0: + prefix, suffix = path, None + else: + if colons != 1: + raise DistlibException("Invalid specification " + "'%s'" % specification) + prefix, suffix = path.split(':') + flags = d['flags'] + if flags is None: + if '[' in specification or ']' in specification: + raise DistlibException("Invalid specification " + "'%s'" % specification) + flags = [] + else: + flags = [f.strip() for f in flags.split(',')] + result = ExportEntry(name, prefix, suffix, flags) + return result + + +def get_cache_base(suffix=None): + """ + Return the default base location for distlib caches. If the directory does + not exist, it is created. Use the suffix provided for the base directory, + and default to '.distlib' if it isn't provided. + + On Windows, if LOCALAPPDATA is defined in the environment, then it is + assumed to be a directory, and will be the parent directory of the result. + On POSIX, and on Windows if LOCALAPPDATA is not defined, the user's home + directory - using os.expanduser('~') - will be the parent directory of + the result. + + The result is just the directory '.distlib' in the parent directory as + determined above, or with the name specified with ``suffix``. + """ + if suffix is None: + suffix = '.distlib' + if os.name == 'nt' and 'LOCALAPPDATA' in os.environ: + result = os.path.expandvars('$localappdata') + else: + # Assume posix, or old Windows + result = os.path.expanduser('~') + # we use 'isdir' instead of 'exists', because we want to + # fail if there's a file with that name + if os.path.isdir(result): + usable = os.access(result, os.W_OK) + if not usable: + logger.warning('Directory exists but is not writable: %s', result) + else: + try: + os.makedirs(result) + usable = True + except OSError: + logger.warning('Unable to create %s', result, exc_info=True) + usable = False + if not usable: + result = tempfile.mkdtemp() + logger.warning('Default location unusable, using %s', result) + return os.path.join(result, suffix) + + +def path_to_cache_dir(path): + """ + Convert an absolute path to a directory name for use in a cache. + + The algorithm used is: + + #. On Windows, any ``':'`` in the drive is replaced with ``'---'``. + #. Any occurrence of ``os.sep`` is replaced with ``'--'``. + #. ``'.cache'`` is appended. + """ + d, p = os.path.splitdrive(os.path.abspath(path)) + if d: + d = d.replace(':', '---') + p = p.replace(os.sep, '--') + return d + p + '.cache' + + +def ensure_slash(s): + if not s.endswith('/'): + return s + '/' + return s + + +def parse_credentials(netloc): + username = password = None + if '@' in netloc: + prefix, netloc = netloc.rsplit('@', 1) + if ':' not in prefix: + username = prefix + else: + username, password = prefix.split(':', 1) + if username: + username = unquote(username) + if password: + password = unquote(password) + return username, password, netloc + + +def get_process_umask(): + result = os.umask(0o22) + os.umask(result) + return result + + +def is_string_sequence(seq): + result = True + i = None + for i, s in enumerate(seq): + if not isinstance(s, string_types): + result = False + break + assert i is not None + return result + + +PROJECT_NAME_AND_VERSION = re.compile( + '([a-z0-9_]+([.-][a-z_][a-z0-9_]*)*)-' + '([a-z0-9_.+-]+)', re.I) +PYTHON_VERSION = re.compile(r'-py(\d\.?\d?)') + + +def split_filename(filename, project_name=None): + """ + Extract name, version, python version from a filename (no extension) + + Return name, version, pyver or None + """ + result = None + pyver = None + filename = unquote(filename).replace(' ', '-') + m = PYTHON_VERSION.search(filename) + if m: + pyver = m.group(1) + filename = filename[:m.start()] + if project_name and len(filename) > len(project_name) + 1: + m = re.match(re.escape(project_name) + r'\b', filename) + if m: + n = m.end() + result = filename[:n], filename[n + 1:], pyver + if result is None: + m = PROJECT_NAME_AND_VERSION.match(filename) + if m: + result = m.group(1), m.group(3), pyver + return result + + +# Allow spaces in name because of legacy dists like "Twisted Core" +NAME_VERSION_RE = re.compile(r'(?P[\w .-]+)\s*' + r'\(\s*(?P[^\s)]+)\)$') + + +def parse_name_and_version(p): + """ + A utility method used to get name and version from a string. + + From e.g. a Provides-Dist value. + + :param p: A value in a form 'foo (1.0)' + :return: The name and version as a tuple. + """ + m = NAME_VERSION_RE.match(p) + if not m: + raise DistlibException('Ill-formed name/version string: \'%s\'' % p) + d = m.groupdict() + return d['name'].strip().lower(), d['ver'] + + +def get_extras(requested, available): + result = set() + requested = set(requested or []) + available = set(available or []) + if '*' in requested: + requested.remove('*') + result |= available + for r in requested: + if r == '-': + result.add(r) + elif r.startswith('-'): + unwanted = r[1:] + if unwanted not in available: + logger.warning('undeclared extra: %s' % unwanted) + if unwanted in result: + result.remove(unwanted) + else: + if r not in available: + logger.warning('undeclared extra: %s' % r) + result.add(r) + return result + + +# +# Extended metadata functionality +# + + +def _get_external_data(url): + result = {} + try: + # urlopen might fail if it runs into redirections, + # because of Python issue #13696. Fixed in locators + # using a custom redirect handler. + resp = urlopen(url) + headers = resp.info() + ct = headers.get('Content-Type') + if not ct.startswith('application/json'): + logger.debug('Unexpected response for JSON request: %s', ct) + else: + reader = codecs.getreader('utf-8')(resp) + # data = reader.read().decode('utf-8') + # result = json.loads(data) + result = json.load(reader) + except Exception as e: + logger.exception('Failed to get external data for %s: %s', url, e) + return result + + +_external_data_base_url = 'https://www.red-dove.com/pypi/projects/' + + +def get_project_data(name): + url = '%s/%s/project.json' % (name[0].upper(), name) + url = urljoin(_external_data_base_url, url) + result = _get_external_data(url) + return result + + +def get_package_data(name, version): + url = '%s/%s/package-%s.json' % (name[0].upper(), name, version) + url = urljoin(_external_data_base_url, url) + return _get_external_data(url) + + +class Cache(object): + """ + A class implementing a cache for resources that need to live in the file system + e.g. shared libraries. This class was moved from resources to here because it + could be used by other modules, e.g. the wheel module. + """ + + def __init__(self, base): + """ + Initialise an instance. + + :param base: The base directory where the cache should be located. + """ + # we use 'isdir' instead of 'exists', because we want to + # fail if there's a file with that name + if not os.path.isdir(base): # pragma: no cover + os.makedirs(base) + if (os.stat(base).st_mode & 0o77) != 0: + logger.warning('Directory \'%s\' is not private', base) + self.base = os.path.abspath(os.path.normpath(base)) + + def prefix_to_dir(self, prefix): + """ + Converts a resource prefix to a directory name in the cache. + """ + return path_to_cache_dir(prefix) + + def clear(self): + """ + Clear the cache. + """ + not_removed = [] + for fn in os.listdir(self.base): + fn = os.path.join(self.base, fn) + try: + if os.path.islink(fn) or os.path.isfile(fn): + os.remove(fn) + elif os.path.isdir(fn): + shutil.rmtree(fn) + except Exception: + not_removed.append(fn) + return not_removed + + +class EventMixin(object): + """ + A very simple publish/subscribe system. + """ + + def __init__(self): + self._subscribers = {} + + def add(self, event, subscriber, append=True): + """ + Add a subscriber for an event. + + :param event: The name of an event. + :param subscriber: The subscriber to be added (and called when the + event is published). + :param append: Whether to append or prepend the subscriber to an + existing subscriber list for the event. + """ + subs = self._subscribers + if event not in subs: + subs[event] = deque([subscriber]) + else: + sq = subs[event] + if append: + sq.append(subscriber) + else: + sq.appendleft(subscriber) + + def remove(self, event, subscriber): + """ + Remove a subscriber for an event. + + :param event: The name of an event. + :param subscriber: The subscriber to be removed. + """ + subs = self._subscribers + if event not in subs: + raise ValueError('No subscribers: %r' % event) + subs[event].remove(subscriber) + + def get_subscribers(self, event): + """ + Return an iterator for the subscribers for an event. + :param event: The event to return subscribers for. + """ + return iter(self._subscribers.get(event, ())) + + def publish(self, event, *args, **kwargs): + """ + Publish a event and return a list of values returned by its + subscribers. + + :param event: The event to publish. + :param args: The positional arguments to pass to the event's + subscribers. + :param kwargs: The keyword arguments to pass to the event's + subscribers. + """ + result = [] + for subscriber in self.get_subscribers(event): + try: + value = subscriber(event, *args, **kwargs) + except Exception: + logger.exception('Exception during event publication') + value = None + result.append(value) + logger.debug('publish %s: args = %s, kwargs = %s, result = %s', event, + args, kwargs, result) + return result + + +# +# Simple sequencing +# +class Sequencer(object): + + def __init__(self): + self._preds = {} + self._succs = {} + self._nodes = set() # nodes with no preds/succs + + def add_node(self, node): + self._nodes.add(node) + + def remove_node(self, node, edges=False): + if node in self._nodes: + self._nodes.remove(node) + if edges: + for p in set(self._preds.get(node, ())): + self.remove(p, node) + for s in set(self._succs.get(node, ())): + self.remove(node, s) + # Remove empties + for k, v in list(self._preds.items()): + if not v: + del self._preds[k] + for k, v in list(self._succs.items()): + if not v: + del self._succs[k] + + def add(self, pred, succ): + assert pred != succ + self._preds.setdefault(succ, set()).add(pred) + self._succs.setdefault(pred, set()).add(succ) + + def remove(self, pred, succ): + assert pred != succ + try: + preds = self._preds[succ] + succs = self._succs[pred] + except KeyError: # pragma: no cover + raise ValueError('%r not a successor of anything' % succ) + try: + preds.remove(pred) + succs.remove(succ) + except KeyError: # pragma: no cover + raise ValueError('%r not a successor of %r' % (succ, pred)) + + def is_step(self, step): + return (step in self._preds or step in self._succs + or step in self._nodes) + + def get_steps(self, final): + if not self.is_step(final): + raise ValueError('Unknown: %r' % final) + result = [] + todo = [] + seen = set() + todo.append(final) + while todo: + step = todo.pop(0) + if step in seen: + # if a step was already seen, + # move it to the end (so it will appear earlier + # when reversed on return) ... but not for the + # final step, as that would be confusing for + # users + if step != final: + result.remove(step) + result.append(step) + else: + seen.add(step) + result.append(step) + preds = self._preds.get(step, ()) + todo.extend(preds) + return reversed(result) + + @property + def strong_connections(self): + # http://en.wikipedia.org/wiki/Tarjan%27s_strongly_connected_components_algorithm + index_counter = [0] + stack = [] + lowlinks = {} + index = {} + result = [] + + graph = self._succs + + def strongconnect(node): + # set the depth index for this node to the smallest unused index + index[node] = index_counter[0] + lowlinks[node] = index_counter[0] + index_counter[0] += 1 + stack.append(node) + + # Consider successors + try: + successors = graph[node] + except Exception: + successors = [] + for successor in successors: + if successor not in lowlinks: + # Successor has not yet been visited + strongconnect(successor) + lowlinks[node] = min(lowlinks[node], lowlinks[successor]) + elif successor in stack: + # the successor is in the stack and hence in the current + # strongly connected component (SCC) + lowlinks[node] = min(lowlinks[node], index[successor]) + + # If `node` is a root node, pop the stack and generate an SCC + if lowlinks[node] == index[node]: + connected_component = [] + + while True: + successor = stack.pop() + connected_component.append(successor) + if successor == node: + break + component = tuple(connected_component) + # storing the result + result.append(component) + + for node in graph: + if node not in lowlinks: + strongconnect(node) + + return result + + @property + def dot(self): + result = ['digraph G {'] + for succ in self._preds: + preds = self._preds[succ] + for pred in preds: + result.append(' %s -> %s;' % (pred, succ)) + for node in self._nodes: + result.append(' %s;' % node) + result.append('}') + return '\n'.join(result) + + +# +# Unarchiving functionality for zip, tar, tgz, tbz, whl +# + +ARCHIVE_EXTENSIONS = ('.tar.gz', '.tar.bz2', '.tar', '.zip', '.tgz', '.tbz', + '.whl') + + +def unarchive(archive_filename, dest_dir, format=None, check=True): + + def check_path(path): + if not isinstance(path, text_type): + path = path.decode('utf-8') + p = os.path.abspath(os.path.join(dest_dir, path)) + if not p.startswith(dest_dir) or p[plen] != os.sep: + raise ValueError('path outside destination: %r' % p) + + dest_dir = os.path.abspath(dest_dir) + plen = len(dest_dir) + archive = None + if format is None: + if archive_filename.endswith(('.zip', '.whl')): + format = 'zip' + elif archive_filename.endswith(('.tar.gz', '.tgz')): + format = 'tgz' + mode = 'r:gz' + elif archive_filename.endswith(('.tar.bz2', '.tbz')): + format = 'tbz' + mode = 'r:bz2' + elif archive_filename.endswith('.tar'): + format = 'tar' + mode = 'r' + else: # pragma: no cover + raise ValueError('Unknown format for %r' % archive_filename) + try: + if format == 'zip': + archive = ZipFile(archive_filename, 'r') + if check: + names = archive.namelist() + for name in names: + check_path(name) + else: + archive = tarfile.open(archive_filename, mode) + if check: + names = archive.getnames() + for name in names: + check_path(name) + if format != 'zip' and sys.version_info[0] < 3: + # See Python issue 17153. If the dest path contains Unicode, + # tarfile extraction fails on Python 2.x if a member path name + # contains non-ASCII characters - it leads to an implicit + # bytes -> unicode conversion using ASCII to decode. + for tarinfo in archive.getmembers(): + if not isinstance(tarinfo.name, text_type): + tarinfo.name = tarinfo.name.decode('utf-8') + + # Limit extraction of dangerous items, if this Python + # allows it easily. If not, just trust the input. + # See: https://docs.python.org/3/library/tarfile.html#extraction-filters + def extraction_filter(member, path): + """Run tarfile.tar_filter, but raise the expected ValueError""" + # This is only called if the current Python has tarfile filters + try: + return tarfile.tar_filter(member, path) + except tarfile.FilterError as exc: + raise ValueError(str(exc)) + + archive.extraction_filter = extraction_filter + + archive.extractall(dest_dir) + + finally: + if archive: + archive.close() + + +def zip_dir(directory): + """zip a directory tree into a BytesIO object""" + result = io.BytesIO() + dlen = len(directory) + with ZipFile(result, "w") as zf: + for root, dirs, files in os.walk(directory): + for name in files: + full = os.path.join(root, name) + rel = root[dlen:] + dest = os.path.join(rel, name) + zf.write(full, dest) + return result + + +# +# Simple progress bar +# + +UNITS = ('', 'K', 'M', 'G', 'T', 'P') + + +class Progress(object): + unknown = 'UNKNOWN' + + def __init__(self, minval=0, maxval=100): + assert maxval is None or maxval >= minval + self.min = self.cur = minval + self.max = maxval + self.started = None + self.elapsed = 0 + self.done = False + + def update(self, curval): + assert self.min <= curval + assert self.max is None or curval <= self.max + self.cur = curval + now = time.time() + if self.started is None: + self.started = now + else: + self.elapsed = now - self.started + + def increment(self, incr): + assert incr >= 0 + self.update(self.cur + incr) + + def start(self): + self.update(self.min) + return self + + def stop(self): + if self.max is not None: + self.update(self.max) + self.done = True + + @property + def maximum(self): + return self.unknown if self.max is None else self.max + + @property + def percentage(self): + if self.done: + result = '100 %' + elif self.max is None: + result = ' ?? %' + else: + v = 100.0 * (self.cur - self.min) / (self.max - self.min) + result = '%3d %%' % v + return result + + def format_duration(self, duration): + if (duration <= 0) and self.max is None or self.cur == self.min: + result = '??:??:??' + # elif duration < 1: + # result = '--:--:--' + else: + result = time.strftime('%H:%M:%S', time.gmtime(duration)) + return result + + @property + def ETA(self): + if self.done: + prefix = 'Done' + t = self.elapsed + # import pdb; pdb.set_trace() + else: + prefix = 'ETA ' + if self.max is None: + t = -1 + elif self.elapsed == 0 or (self.cur == self.min): + t = 0 + else: + # import pdb; pdb.set_trace() + t = float(self.max - self.min) + t /= self.cur - self.min + t = (t - 1) * self.elapsed + return '%s: %s' % (prefix, self.format_duration(t)) + + @property + def speed(self): + if self.elapsed == 0: + result = 0.0 + else: + result = (self.cur - self.min) / self.elapsed + for unit in UNITS: + if result < 1000: + break + result /= 1000.0 + return '%d %sB/s' % (result, unit) + + +# +# Glob functionality +# + +RICH_GLOB = re.compile(r'\{([^}]*)\}') +_CHECK_RECURSIVE_GLOB = re.compile(r'[^/\\,{]\*\*|\*\*[^/\\,}]') +_CHECK_MISMATCH_SET = re.compile(r'^[^{]*\}|\{[^}]*$') + + +def iglob(path_glob): + """Extended globbing function that supports ** and {opt1,opt2,opt3}.""" + if _CHECK_RECURSIVE_GLOB.search(path_glob): + msg = """invalid glob %r: recursive glob "**" must be used alone""" + raise ValueError(msg % path_glob) + if _CHECK_MISMATCH_SET.search(path_glob): + msg = """invalid glob %r: mismatching set marker '{' or '}'""" + raise ValueError(msg % path_glob) + return _iglob(path_glob) + + +def _iglob(path_glob): + rich_path_glob = RICH_GLOB.split(path_glob, 1) + if len(rich_path_glob) > 1: + assert len(rich_path_glob) == 3, rich_path_glob + prefix, set, suffix = rich_path_glob + for item in set.split(','): + for path in _iglob(''.join((prefix, item, suffix))): + yield path + else: + if '**' not in path_glob: + for item in std_iglob(path_glob): + yield item + else: + prefix, radical = path_glob.split('**', 1) + if prefix == '': + prefix = '.' + if radical == '': + radical = '*' + else: + # we support both + radical = radical.lstrip('/') + radical = radical.lstrip('\\') + for path, dir, files in os.walk(prefix): + path = os.path.normpath(path) + for fn in _iglob(os.path.join(path, radical)): + yield fn + + +if ssl: + from .compat import (HTTPSHandler as BaseHTTPSHandler, match_hostname, + CertificateError) + + # + # HTTPSConnection which verifies certificates/matches domains + # + + class HTTPSConnection(httplib.HTTPSConnection): + ca_certs = None # set this to the path to the certs file (.pem) + check_domain = True # only used if ca_certs is not None + + # noinspection PyPropertyAccess + def connect(self): + sock = socket.create_connection((self.host, self.port), + self.timeout) + if getattr(self, '_tunnel_host', False): + self.sock = sock + self._tunnel() + + context = ssl.SSLContext(ssl.PROTOCOL_SSLv23) + if hasattr(ssl, 'OP_NO_SSLv2'): + context.options |= ssl.OP_NO_SSLv2 + if getattr(self, 'cert_file', None): + context.load_cert_chain(self.cert_file, self.key_file) + kwargs = {} + if self.ca_certs: + context.verify_mode = ssl.CERT_REQUIRED + context.load_verify_locations(cafile=self.ca_certs) + if getattr(ssl, 'HAS_SNI', False): + kwargs['server_hostname'] = self.host + + self.sock = context.wrap_socket(sock, **kwargs) + if self.ca_certs and self.check_domain: + try: + match_hostname(self.sock.getpeercert(), self.host) + logger.debug('Host verified: %s', self.host) + except CertificateError: # pragma: no cover + self.sock.shutdown(socket.SHUT_RDWR) + self.sock.close() + raise + + class HTTPSHandler(BaseHTTPSHandler): + + def __init__(self, ca_certs, check_domain=True): + BaseHTTPSHandler.__init__(self) + self.ca_certs = ca_certs + self.check_domain = check_domain + + def _conn_maker(self, *args, **kwargs): + """ + This is called to create a connection instance. Normally you'd + pass a connection class to do_open, but it doesn't actually check for + a class, and just expects a callable. As long as we behave just as a + constructor would have, we should be OK. If it ever changes so that + we *must* pass a class, we'll create an UnsafeHTTPSConnection class + which just sets check_domain to False in the class definition, and + choose which one to pass to do_open. + """ + result = HTTPSConnection(*args, **kwargs) + if self.ca_certs: + result.ca_certs = self.ca_certs + result.check_domain = self.check_domain + return result + + def https_open(self, req): + try: + return self.do_open(self._conn_maker, req) + except URLError as e: + if 'certificate verify failed' in str(e.reason): + raise CertificateError( + 'Unable to verify server certificate ' + 'for %s' % req.host) + else: + raise + + # + # To prevent against mixing HTTP traffic with HTTPS (examples: A Man-In-The- + # Middle proxy using HTTP listens on port 443, or an index mistakenly serves + # HTML containing a http://xyz link when it should be https://xyz), + # you can use the following handler class, which does not allow HTTP traffic. + # + # It works by inheriting from HTTPHandler - so build_opener won't add a + # handler for HTTP itself. + # + class HTTPSOnlyHandler(HTTPSHandler, HTTPHandler): + + def http_open(self, req): + raise URLError( + 'Unexpected HTTP request on what should be a secure ' + 'connection: %s' % req) + + +# +# XML-RPC with timeouts +# +class Transport(xmlrpclib.Transport): + + def __init__(self, timeout, use_datetime=0): + self.timeout = timeout + xmlrpclib.Transport.__init__(self, use_datetime) + + def make_connection(self, host): + h, eh, x509 = self.get_host_info(host) + if not self._connection or host != self._connection[0]: + self._extra_headers = eh + self._connection = host, httplib.HTTPConnection(h) + return self._connection[1] + + +if ssl: + + class SafeTransport(xmlrpclib.SafeTransport): + + def __init__(self, timeout, use_datetime=0): + self.timeout = timeout + xmlrpclib.SafeTransport.__init__(self, use_datetime) + + def make_connection(self, host): + h, eh, kwargs = self.get_host_info(host) + if not kwargs: + kwargs = {} + kwargs['timeout'] = self.timeout + if not self._connection or host != self._connection[0]: + self._extra_headers = eh + self._connection = host, httplib.HTTPSConnection( + h, None, **kwargs) + return self._connection[1] + + +class ServerProxy(xmlrpclib.ServerProxy): + + def __init__(self, uri, **kwargs): + self.timeout = timeout = kwargs.pop('timeout', None) + # The above classes only come into play if a timeout + # is specified + if timeout is not None: + # scheme = splittype(uri) # deprecated as of Python 3.8 + scheme = urlparse(uri)[0] + use_datetime = kwargs.get('use_datetime', 0) + if scheme == 'https': + tcls = SafeTransport + else: + tcls = Transport + kwargs['transport'] = t = tcls(timeout, use_datetime=use_datetime) + self.transport = t + xmlrpclib.ServerProxy.__init__(self, uri, **kwargs) + + +# +# CSV functionality. This is provided because on 2.x, the csv module can't +# handle Unicode. However, we need to deal with Unicode in e.g. RECORD files. +# + + +def _csv_open(fn, mode, **kwargs): + if sys.version_info[0] < 3: + mode += 'b' + else: + kwargs['newline'] = '' + # Python 3 determines encoding from locale. Force 'utf-8' + # file encoding to match other forced utf-8 encoding + kwargs['encoding'] = 'utf-8' + return open(fn, mode, **kwargs) + + +class CSVBase(object): + defaults = { + 'delimiter': str(','), # The strs are used because we need native + 'quotechar': str('"'), # str in the csv API (2.x won't take + 'lineterminator': str('\n') # Unicode) + } + + def __enter__(self): + return self + + def __exit__(self, *exc_info): + self.stream.close() + + +class CSVReader(CSVBase): + + def __init__(self, **kwargs): + if 'stream' in kwargs: + stream = kwargs['stream'] + if sys.version_info[0] >= 3: + # needs to be a text stream + stream = codecs.getreader('utf-8')(stream) + self.stream = stream + else: + self.stream = _csv_open(kwargs['path'], 'r') + self.reader = csv.reader(self.stream, **self.defaults) + + def __iter__(self): + return self + + def next(self): + result = next(self.reader) + if sys.version_info[0] < 3: + for i, item in enumerate(result): + if not isinstance(item, text_type): + result[i] = item.decode('utf-8') + return result + + __next__ = next + + +class CSVWriter(CSVBase): + + def __init__(self, fn, **kwargs): + self.stream = _csv_open(fn, 'w') + self.writer = csv.writer(self.stream, **self.defaults) + + def writerow(self, row): + if sys.version_info[0] < 3: + r = [] + for item in row: + if isinstance(item, text_type): + item = item.encode('utf-8') + r.append(item) + row = r + self.writer.writerow(row) + + +# +# Configurator functionality +# + + +class Configurator(BaseConfigurator): + + value_converters = dict(BaseConfigurator.value_converters) + value_converters['inc'] = 'inc_convert' + + def __init__(self, config, base=None): + super(Configurator, self).__init__(config) + self.base = base or os.getcwd() + + def configure_custom(self, config): + + def convert(o): + if isinstance(o, (list, tuple)): + result = type(o)([convert(i) for i in o]) + elif isinstance(o, dict): + if '()' in o: + result = self.configure_custom(o) + else: + result = {} + for k in o: + result[k] = convert(o[k]) + else: + result = self.convert(o) + return result + + c = config.pop('()') + if not callable(c): + c = self.resolve(c) + props = config.pop('.', None) + # Check for valid identifiers + args = config.pop('[]', ()) + if args: + args = tuple([convert(o) for o in args]) + items = [(k, convert(config[k])) for k in config if valid_ident(k)] + kwargs = dict(items) + result = c(*args, **kwargs) + if props: + for n, v in props.items(): + setattr(result, n, convert(v)) + return result + + def __getitem__(self, key): + result = self.config[key] + if isinstance(result, dict) and '()' in result: + self.config[key] = result = self.configure_custom(result) + return result + + def inc_convert(self, value): + """Default converter for the inc:// protocol.""" + if not os.path.isabs(value): + value = os.path.join(self.base, value) + with codecs.open(value, 'r', encoding='utf-8') as f: + result = json.load(f) + return result + + +class SubprocessMixin(object): + """ + Mixin for running subprocesses and capturing their output + """ + + def __init__(self, verbose=False, progress=None): + self.verbose = verbose + self.progress = progress + + def reader(self, stream, context): + """ + Read lines from a subprocess' output stream and either pass to a progress + callable (if specified) or write progress information to sys.stderr. + """ + progress = self.progress + verbose = self.verbose + while True: + s = stream.readline() + if not s: + break + if progress is not None: + progress(s, context) + else: + if not verbose: + sys.stderr.write('.') + else: + sys.stderr.write(s.decode('utf-8')) + sys.stderr.flush() + stream.close() + + def run_command(self, cmd, **kwargs): + p = subprocess.Popen(cmd, + stdout=subprocess.PIPE, + stderr=subprocess.PIPE, + **kwargs) + t1 = threading.Thread(target=self.reader, args=(p.stdout, 'stdout')) + t1.start() + t2 = threading.Thread(target=self.reader, args=(p.stderr, 'stderr')) + t2.start() + p.wait() + t1.join() + t2.join() + if self.progress is not None: + self.progress('done.', 'main') + elif self.verbose: + sys.stderr.write('done.\n') + return p + + +def normalize_name(name): + """Normalize a python package name a la PEP 503""" + # https://www.python.org/dev/peps/pep-0503/#normalized-names + return re.sub('[-_.]+', '-', name).lower() + + +# def _get_pypirc_command(): +# """ +# Get the distutils command for interacting with PyPI configurations. +# :return: the command. +# """ +# from distutils.core import Distribution +# from distutils.config import PyPIRCCommand +# d = Distribution() +# return PyPIRCCommand(d) + + +class PyPIRCFile(object): + + DEFAULT_REPOSITORY = 'https://upload.pypi.org/legacy/' + DEFAULT_REALM = 'pypi' + + def __init__(self, fn=None, url=None): + if fn is None: + fn = os.path.join(os.path.expanduser('~'), '.pypirc') + self.filename = fn + self.url = url + + def read(self): + result = {} + + if os.path.exists(self.filename): + repository = self.url or self.DEFAULT_REPOSITORY + + config = configparser.RawConfigParser() + config.read(self.filename) + sections = config.sections() + if 'distutils' in sections: + # let's get the list of servers + index_servers = config.get('distutils', 'index-servers') + _servers = [ + server.strip() for server in index_servers.split('\n') + if server.strip() != '' + ] + if _servers == []: + # nothing set, let's try to get the default pypi + if 'pypi' in sections: + _servers = ['pypi'] + else: + for server in _servers: + result = {'server': server} + result['username'] = config.get(server, 'username') + + # optional params + for key, default in (('repository', + self.DEFAULT_REPOSITORY), + ('realm', self.DEFAULT_REALM), + ('password', None)): + if config.has_option(server, key): + result[key] = config.get(server, key) + else: + result[key] = default + + # work around people having "repository" for the "pypi" + # section of their config set to the HTTP (rather than + # HTTPS) URL + if (server == 'pypi' and repository + in (self.DEFAULT_REPOSITORY, 'pypi')): + result['repository'] = self.DEFAULT_REPOSITORY + elif (result['server'] != repository + and result['repository'] != repository): + result = {} + elif 'server-login' in sections: + # old format + server = 'server-login' + if config.has_option(server, 'repository'): + repository = config.get(server, 'repository') + else: + repository = self.DEFAULT_REPOSITORY + result = { + 'username': config.get(server, 'username'), + 'password': config.get(server, 'password'), + 'repository': repository, + 'server': server, + 'realm': self.DEFAULT_REALM + } + return result + + def update(self, username, password): + # import pdb; pdb.set_trace() + config = configparser.RawConfigParser() + fn = self.filename + config.read(fn) + if not config.has_section('pypi'): + config.add_section('pypi') + config.set('pypi', 'username', username) + config.set('pypi', 'password', password) + with open(fn, 'w') as f: + config.write(f) + + +def _load_pypirc(index): + """ + Read the PyPI access configuration as supported by distutils. + """ + return PyPIRCFile(url=index.url).read() + + +def _store_pypirc(index): + PyPIRCFile().update(index.username, index.password) + + +# +# get_platform()/get_host_platform() copied from Python 3.10.a0 source, with some minor +# tweaks +# + + +def get_host_platform(): + """Return a string that identifies the current platform. This is used mainly to + distinguish platform-specific build directories and platform-specific built + distributions. Typically includes the OS name and version and the + architecture (as supplied by 'os.uname()'), although the exact information + included depends on the OS; eg. on Linux, the kernel version isn't + particularly important. + + Examples of returned values: + linux-i586 + linux-alpha (?) + solaris-2.6-sun4u + + Windows will return one of: + win-amd64 (64bit Windows on AMD64 (aka x86_64, Intel64, EM64T, etc) + win32 (all others - specifically, sys.platform is returned) + + For other non-POSIX platforms, currently just returns 'sys.platform'. + + """ + if os.name == 'nt': + if 'amd64' in sys.version.lower(): + return 'win-amd64' + if '(arm)' in sys.version.lower(): + return 'win-arm32' + if '(arm64)' in sys.version.lower(): + return 'win-arm64' + return sys.platform + + # Set for cross builds explicitly + if "_PYTHON_HOST_PLATFORM" in os.environ: + return os.environ["_PYTHON_HOST_PLATFORM"] + + if os.name != 'posix' or not hasattr(os, 'uname'): + # XXX what about the architecture? NT is Intel or Alpha, + # Mac OS is M68k or PPC, etc. + return sys.platform + + # Try to distinguish various flavours of Unix + + (osname, host, release, version, machine) = os.uname() + + # Convert the OS name to lowercase, remove '/' characters, and translate + # spaces (for "Power Macintosh") + osname = osname.lower().replace('/', '') + machine = machine.replace(' ', '_').replace('/', '-') + + if osname[:5] == 'linux': + # At least on Linux/Intel, 'machine' is the processor -- + # i386, etc. + # XXX what about Alpha, SPARC, etc? + return "%s-%s" % (osname, machine) + + elif osname[:5] == 'sunos': + if release[0] >= '5': # SunOS 5 == Solaris 2 + osname = 'solaris' + release = '%d.%s' % (int(release[0]) - 3, release[2:]) + # We can't use 'platform.architecture()[0]' because a + # bootstrap problem. We use a dict to get an error + # if some suspicious happens. + bitness = {2147483647: '32bit', 9223372036854775807: '64bit'} + machine += '.%s' % bitness[sys.maxsize] + # fall through to standard osname-release-machine representation + elif osname[:3] == 'aix': + from _aix_support import aix_platform + return aix_platform() + elif osname[:6] == 'cygwin': + osname = 'cygwin' + rel_re = re.compile(r'[\d.]+', re.ASCII) + m = rel_re.match(release) + if m: + release = m.group() + elif osname[:6] == 'darwin': + import _osx_support + try: + from distutils import sysconfig + except ImportError: + import sysconfig + osname, release, machine = _osx_support.get_platform_osx( + sysconfig.get_config_vars(), osname, release, machine) + + return '%s-%s-%s' % (osname, release, machine) + + +_TARGET_TO_PLAT = { + 'x86': 'win32', + 'x64': 'win-amd64', + 'arm': 'win-arm32', +} + + +def get_platform(): + if os.name != 'nt': + return get_host_platform() + cross_compilation_target = os.environ.get('VSCMD_ARG_TGT_ARCH') + if cross_compilation_target not in _TARGET_TO_PLAT: + return get_host_platform() + return _TARGET_TO_PLAT[cross_compilation_target] diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/version.py b/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/version.py new file mode 100644 index 0000000..14171ac --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/version.py @@ -0,0 +1,751 @@ +# -*- coding: utf-8 -*- +# +# Copyright (C) 2012-2023 The Python Software Foundation. +# See LICENSE.txt and CONTRIBUTORS.txt. +# +""" +Implementation of a flexible versioning scheme providing support for PEP-440, +setuptools-compatible and semantic versioning. +""" + +import logging +import re + +from .compat import string_types +from .util import parse_requirement + +__all__ = ['NormalizedVersion', 'NormalizedMatcher', + 'LegacyVersion', 'LegacyMatcher', + 'SemanticVersion', 'SemanticMatcher', + 'UnsupportedVersionError', 'get_scheme'] + +logger = logging.getLogger(__name__) + + +class UnsupportedVersionError(ValueError): + """This is an unsupported version.""" + pass + + +class Version(object): + def __init__(self, s): + self._string = s = s.strip() + self._parts = parts = self.parse(s) + assert isinstance(parts, tuple) + assert len(parts) > 0 + + def parse(self, s): + raise NotImplementedError('please implement in a subclass') + + def _check_compatible(self, other): + if type(self) != type(other): + raise TypeError('cannot compare %r and %r' % (self, other)) + + def __eq__(self, other): + self._check_compatible(other) + return self._parts == other._parts + + def __ne__(self, other): + return not self.__eq__(other) + + def __lt__(self, other): + self._check_compatible(other) + return self._parts < other._parts + + def __gt__(self, other): + return not (self.__lt__(other) or self.__eq__(other)) + + def __le__(self, other): + return self.__lt__(other) or self.__eq__(other) + + def __ge__(self, other): + return self.__gt__(other) or self.__eq__(other) + + # See http://docs.python.org/reference/datamodel#object.__hash__ + def __hash__(self): + return hash(self._parts) + + def __repr__(self): + return "%s('%s')" % (self.__class__.__name__, self._string) + + def __str__(self): + return self._string + + @property + def is_prerelease(self): + raise NotImplementedError('Please implement in subclasses.') + + +class Matcher(object): + version_class = None + + # value is either a callable or the name of a method + _operators = { + '<': lambda v, c, p: v < c, + '>': lambda v, c, p: v > c, + '<=': lambda v, c, p: v == c or v < c, + '>=': lambda v, c, p: v == c or v > c, + '==': lambda v, c, p: v == c, + '===': lambda v, c, p: v == c, + # by default, compatible => >=. + '~=': lambda v, c, p: v == c or v > c, + '!=': lambda v, c, p: v != c, + } + + # this is a method only to support alternative implementations + # via overriding + def parse_requirement(self, s): + return parse_requirement(s) + + def __init__(self, s): + if self.version_class is None: + raise ValueError('Please specify a version class') + self._string = s = s.strip() + r = self.parse_requirement(s) + if not r: + raise ValueError('Not valid: %r' % s) + self.name = r.name + self.key = self.name.lower() # for case-insensitive comparisons + clist = [] + if r.constraints: + # import pdb; pdb.set_trace() + for op, s in r.constraints: + if s.endswith('.*'): + if op not in ('==', '!='): + raise ValueError('\'.*\' not allowed for ' + '%r constraints' % op) + # Could be a partial version (e.g. for '2.*') which + # won't parse as a version, so keep it as a string + vn, prefix = s[:-2], True + # Just to check that vn is a valid version + self.version_class(vn) + else: + # Should parse as a version, so we can create an + # instance for the comparison + vn, prefix = self.version_class(s), False + clist.append((op, vn, prefix)) + self._parts = tuple(clist) + + def match(self, version): + """ + Check if the provided version matches the constraints. + + :param version: The version to match against this instance. + :type version: String or :class:`Version` instance. + """ + if isinstance(version, string_types): + version = self.version_class(version) + for operator, constraint, prefix in self._parts: + f = self._operators.get(operator) + if isinstance(f, string_types): + f = getattr(self, f) + if not f: + msg = ('%r not implemented ' + 'for %s' % (operator, self.__class__.__name__)) + raise NotImplementedError(msg) + if not f(version, constraint, prefix): + return False + return True + + @property + def exact_version(self): + result = None + if len(self._parts) == 1 and self._parts[0][0] in ('==', '==='): + result = self._parts[0][1] + return result + + def _check_compatible(self, other): + if type(self) != type(other) or self.name != other.name: + raise TypeError('cannot compare %s and %s' % (self, other)) + + def __eq__(self, other): + self._check_compatible(other) + return self.key == other.key and self._parts == other._parts + + def __ne__(self, other): + return not self.__eq__(other) + + # See http://docs.python.org/reference/datamodel#object.__hash__ + def __hash__(self): + return hash(self.key) + hash(self._parts) + + def __repr__(self): + return "%s(%r)" % (self.__class__.__name__, self._string) + + def __str__(self): + return self._string + + +PEP440_VERSION_RE = re.compile(r'^v?(\d+!)?(\d+(\.\d+)*)((a|alpha|b|beta|c|rc|pre|preview)(\d+)?)?' + r'(\.(post|r|rev)(\d+)?)?([._-]?(dev)(\d+)?)?' + r'(\+([a-zA-Z\d]+(\.[a-zA-Z\d]+)?))?$', re.I) + + +def _pep_440_key(s): + s = s.strip() + m = PEP440_VERSION_RE.match(s) + if not m: + raise UnsupportedVersionError('Not a valid version: %s' % s) + groups = m.groups() + nums = tuple(int(v) for v in groups[1].split('.')) + while len(nums) > 1 and nums[-1] == 0: + nums = nums[:-1] + + if not groups[0]: + epoch = 0 + else: + epoch = int(groups[0][:-1]) + pre = groups[4:6] + post = groups[7:9] + dev = groups[10:12] + local = groups[13] + if pre == (None, None): + pre = () + else: + if pre[1] is None: + pre = pre[0], 0 + else: + pre = pre[0], int(pre[1]) + if post == (None, None): + post = () + else: + if post[1] is None: + post = post[0], 0 + else: + post = post[0], int(post[1]) + if dev == (None, None): + dev = () + else: + if dev[1] is None: + dev = dev[0], 0 + else: + dev = dev[0], int(dev[1]) + if local is None: + local = () + else: + parts = [] + for part in local.split('.'): + # to ensure that numeric compares as > lexicographic, avoid + # comparing them directly, but encode a tuple which ensures + # correct sorting + if part.isdigit(): + part = (1, int(part)) + else: + part = (0, part) + parts.append(part) + local = tuple(parts) + if not pre: + # either before pre-release, or final release and after + if not post and dev: + # before pre-release + pre = ('a', -1) # to sort before a0 + else: + pre = ('z',) # to sort after all pre-releases + # now look at the state of post and dev. + if not post: + post = ('_',) # sort before 'a' + if not dev: + dev = ('final',) + + return epoch, nums, pre, post, dev, local + + +_normalized_key = _pep_440_key + + +class NormalizedVersion(Version): + """A rational version. + + Good: + 1.2 # equivalent to "1.2.0" + 1.2.0 + 1.2a1 + 1.2.3a2 + 1.2.3b1 + 1.2.3c1 + 1.2.3.4 + TODO: fill this out + + Bad: + 1 # minimum two numbers + 1.2a # release level must have a release serial + 1.2.3b + """ + def parse(self, s): + result = _normalized_key(s) + # _normalized_key loses trailing zeroes in the release + # clause, since that's needed to ensure that X.Y == X.Y.0 == X.Y.0.0 + # However, PEP 440 prefix matching needs it: for example, + # (~= 1.4.5.0) matches differently to (~= 1.4.5.0.0). + m = PEP440_VERSION_RE.match(s) # must succeed + groups = m.groups() + self._release_clause = tuple(int(v) for v in groups[1].split('.')) + return result + + PREREL_TAGS = set(['a', 'b', 'c', 'rc', 'dev']) + + @property + def is_prerelease(self): + return any(t[0] in self.PREREL_TAGS for t in self._parts if t) + + +def _match_prefix(x, y): + x = str(x) + y = str(y) + if x == y: + return True + if not x.startswith(y): + return False + n = len(y) + return x[n] == '.' + + +class NormalizedMatcher(Matcher): + version_class = NormalizedVersion + + # value is either a callable or the name of a method + _operators = { + '~=': '_match_compatible', + '<': '_match_lt', + '>': '_match_gt', + '<=': '_match_le', + '>=': '_match_ge', + '==': '_match_eq', + '===': '_match_arbitrary', + '!=': '_match_ne', + } + + def _adjust_local(self, version, constraint, prefix): + if prefix: + strip_local = '+' not in constraint and version._parts[-1] + else: + # both constraint and version are + # NormalizedVersion instances. + # If constraint does not have a local component, + # ensure the version doesn't, either. + strip_local = not constraint._parts[-1] and version._parts[-1] + if strip_local: + s = version._string.split('+', 1)[0] + version = self.version_class(s) + return version, constraint + + def _match_lt(self, version, constraint, prefix): + version, constraint = self._adjust_local(version, constraint, prefix) + if version >= constraint: + return False + release_clause = constraint._release_clause + pfx = '.'.join([str(i) for i in release_clause]) + return not _match_prefix(version, pfx) + + def _match_gt(self, version, constraint, prefix): + version, constraint = self._adjust_local(version, constraint, prefix) + if version <= constraint: + return False + release_clause = constraint._release_clause + pfx = '.'.join([str(i) for i in release_clause]) + return not _match_prefix(version, pfx) + + def _match_le(self, version, constraint, prefix): + version, constraint = self._adjust_local(version, constraint, prefix) + return version <= constraint + + def _match_ge(self, version, constraint, prefix): + version, constraint = self._adjust_local(version, constraint, prefix) + return version >= constraint + + def _match_eq(self, version, constraint, prefix): + version, constraint = self._adjust_local(version, constraint, prefix) + if not prefix: + result = (version == constraint) + else: + result = _match_prefix(version, constraint) + return result + + def _match_arbitrary(self, version, constraint, prefix): + return str(version) == str(constraint) + + def _match_ne(self, version, constraint, prefix): + version, constraint = self._adjust_local(version, constraint, prefix) + if not prefix: + result = (version != constraint) + else: + result = not _match_prefix(version, constraint) + return result + + def _match_compatible(self, version, constraint, prefix): + version, constraint = self._adjust_local(version, constraint, prefix) + if version == constraint: + return True + if version < constraint: + return False +# if not prefix: +# return True + release_clause = constraint._release_clause + if len(release_clause) > 1: + release_clause = release_clause[:-1] + pfx = '.'.join([str(i) for i in release_clause]) + return _match_prefix(version, pfx) + + +_REPLACEMENTS = ( + (re.compile('[.+-]$'), ''), # remove trailing puncts + (re.compile(r'^[.](\d)'), r'0.\1'), # .N -> 0.N at start + (re.compile('^[.-]'), ''), # remove leading puncts + (re.compile(r'^\((.*)\)$'), r'\1'), # remove parentheses + (re.compile(r'^v(ersion)?\s*(\d+)'), r'\2'), # remove leading v(ersion) + (re.compile(r'^r(ev)?\s*(\d+)'), r'\2'), # remove leading v(ersion) + (re.compile('[.]{2,}'), '.'), # multiple runs of '.' + (re.compile(r'\b(alfa|apha)\b'), 'alpha'), # misspelt alpha + (re.compile(r'\b(pre-alpha|prealpha)\b'), + 'pre.alpha'), # standardise + (re.compile(r'\(beta\)$'), 'beta'), # remove parentheses +) + +_SUFFIX_REPLACEMENTS = ( + (re.compile('^[:~._+-]+'), ''), # remove leading puncts + (re.compile('[,*")([\\]]'), ''), # remove unwanted chars + (re.compile('[~:+_ -]'), '.'), # replace illegal chars + (re.compile('[.]{2,}'), '.'), # multiple runs of '.' + (re.compile(r'\.$'), ''), # trailing '.' +) + +_NUMERIC_PREFIX = re.compile(r'(\d+(\.\d+)*)') + + +def _suggest_semantic_version(s): + """ + Try to suggest a semantic form for a version for which + _suggest_normalized_version couldn't come up with anything. + """ + result = s.strip().lower() + for pat, repl in _REPLACEMENTS: + result = pat.sub(repl, result) + if not result: + result = '0.0.0' + + # Now look for numeric prefix, and separate it out from + # the rest. + # import pdb; pdb.set_trace() + m = _NUMERIC_PREFIX.match(result) + if not m: + prefix = '0.0.0' + suffix = result + else: + prefix = m.groups()[0].split('.') + prefix = [int(i) for i in prefix] + while len(prefix) < 3: + prefix.append(0) + if len(prefix) == 3: + suffix = result[m.end():] + else: + suffix = '.'.join([str(i) for i in prefix[3:]]) + result[m.end():] + prefix = prefix[:3] + prefix = '.'.join([str(i) for i in prefix]) + suffix = suffix.strip() + if suffix: + # import pdb; pdb.set_trace() + # massage the suffix. + for pat, repl in _SUFFIX_REPLACEMENTS: + suffix = pat.sub(repl, suffix) + + if not suffix: + result = prefix + else: + sep = '-' if 'dev' in suffix else '+' + result = prefix + sep + suffix + if not is_semver(result): + result = None + return result + + +def _suggest_normalized_version(s): + """Suggest a normalized version close to the given version string. + + If you have a version string that isn't rational (i.e. NormalizedVersion + doesn't like it) then you might be able to get an equivalent (or close) + rational version from this function. + + This does a number of simple normalizations to the given string, based + on observation of versions currently in use on PyPI. Given a dump of + those version during PyCon 2009, 4287 of them: + - 2312 (53.93%) match NormalizedVersion without change + with the automatic suggestion + - 3474 (81.04%) match when using this suggestion method + + @param s {str} An irrational version string. + @returns A rational version string, or None, if couldn't determine one. + """ + try: + _normalized_key(s) + return s # already rational + except UnsupportedVersionError: + pass + + rs = s.lower() + + # part of this could use maketrans + for orig, repl in (('-alpha', 'a'), ('-beta', 'b'), ('alpha', 'a'), + ('beta', 'b'), ('rc', 'c'), ('-final', ''), + ('-pre', 'c'), + ('-release', ''), ('.release', ''), ('-stable', ''), + ('+', '.'), ('_', '.'), (' ', ''), ('.final', ''), + ('final', '')): + rs = rs.replace(orig, repl) + + # if something ends with dev or pre, we add a 0 + rs = re.sub(r"pre$", r"pre0", rs) + rs = re.sub(r"dev$", r"dev0", rs) + + # if we have something like "b-2" or "a.2" at the end of the + # version, that is probably beta, alpha, etc + # let's remove the dash or dot + rs = re.sub(r"([abc]|rc)[\-\.](\d+)$", r"\1\2", rs) + + # 1.0-dev-r371 -> 1.0.dev371 + # 0.1-dev-r79 -> 0.1.dev79 + rs = re.sub(r"[\-\.](dev)[\-\.]?r?(\d+)$", r".\1\2", rs) + + # Clean: 2.0.a.3, 2.0.b1, 0.9.0~c1 + rs = re.sub(r"[.~]?([abc])\.?", r"\1", rs) + + # Clean: v0.3, v1.0 + if rs.startswith('v'): + rs = rs[1:] + + # Clean leading '0's on numbers. + # TODO: unintended side-effect on, e.g., "2003.05.09" + # PyPI stats: 77 (~2%) better + rs = re.sub(r"\b0+(\d+)(?!\d)", r"\1", rs) + + # Clean a/b/c with no version. E.g. "1.0a" -> "1.0a0". Setuptools infers + # zero. + # PyPI stats: 245 (7.56%) better + rs = re.sub(r"(\d+[abc])$", r"\g<1>0", rs) + + # the 'dev-rNNN' tag is a dev tag + rs = re.sub(r"\.?(dev-r|dev\.r)\.?(\d+)$", r".dev\2", rs) + + # clean the - when used as a pre delimiter + rs = re.sub(r"-(a|b|c)(\d+)$", r"\1\2", rs) + + # a terminal "dev" or "devel" can be changed into ".dev0" + rs = re.sub(r"[\.\-](dev|devel)$", r".dev0", rs) + + # a terminal "dev" can be changed into ".dev0" + rs = re.sub(r"(?![\.\-])dev$", r".dev0", rs) + + # a terminal "final" or "stable" can be removed + rs = re.sub(r"(final|stable)$", "", rs) + + # The 'r' and the '-' tags are post release tags + # 0.4a1.r10 -> 0.4a1.post10 + # 0.9.33-17222 -> 0.9.33.post17222 + # 0.9.33-r17222 -> 0.9.33.post17222 + rs = re.sub(r"\.?(r|-|-r)\.?(\d+)$", r".post\2", rs) + + # Clean 'r' instead of 'dev' usage: + # 0.9.33+r17222 -> 0.9.33.dev17222 + # 1.0dev123 -> 1.0.dev123 + # 1.0.git123 -> 1.0.dev123 + # 1.0.bzr123 -> 1.0.dev123 + # 0.1a0dev.123 -> 0.1a0.dev123 + # PyPI stats: ~150 (~4%) better + rs = re.sub(r"\.?(dev|git|bzr)\.?(\d+)$", r".dev\2", rs) + + # Clean '.pre' (normalized from '-pre' above) instead of 'c' usage: + # 0.2.pre1 -> 0.2c1 + # 0.2-c1 -> 0.2c1 + # 1.0preview123 -> 1.0c123 + # PyPI stats: ~21 (0.62%) better + rs = re.sub(r"\.?(pre|preview|-c)(\d+)$", r"c\g<2>", rs) + + # Tcl/Tk uses "px" for their post release markers + rs = re.sub(r"p(\d+)$", r".post\1", rs) + + try: + _normalized_key(rs) + except UnsupportedVersionError: + rs = None + return rs + +# +# Legacy version processing (distribute-compatible) +# + + +_VERSION_PART = re.compile(r'([a-z]+|\d+|[\.-])', re.I) +_VERSION_REPLACE = { + 'pre': 'c', + 'preview': 'c', + '-': 'final-', + 'rc': 'c', + 'dev': '@', + '': None, + '.': None, +} + + +def _legacy_key(s): + def get_parts(s): + result = [] + for p in _VERSION_PART.split(s.lower()): + p = _VERSION_REPLACE.get(p, p) + if p: + if '0' <= p[:1] <= '9': + p = p.zfill(8) + else: + p = '*' + p + result.append(p) + result.append('*final') + return result + + result = [] + for p in get_parts(s): + if p.startswith('*'): + if p < '*final': + while result and result[-1] == '*final-': + result.pop() + while result and result[-1] == '00000000': + result.pop() + result.append(p) + return tuple(result) + + +class LegacyVersion(Version): + def parse(self, s): + return _legacy_key(s) + + @property + def is_prerelease(self): + result = False + for x in self._parts: + if (isinstance(x, string_types) and x.startswith('*') and + x < '*final'): + result = True + break + return result + + +class LegacyMatcher(Matcher): + version_class = LegacyVersion + + _operators = dict(Matcher._operators) + _operators['~='] = '_match_compatible' + + numeric_re = re.compile(r'^(\d+(\.\d+)*)') + + def _match_compatible(self, version, constraint, prefix): + if version < constraint: + return False + m = self.numeric_re.match(str(constraint)) + if not m: + logger.warning('Cannot compute compatible match for version %s ' + ' and constraint %s', version, constraint) + return True + s = m.groups()[0] + if '.' in s: + s = s.rsplit('.', 1)[0] + return _match_prefix(version, s) + +# +# Semantic versioning +# + + +_SEMVER_RE = re.compile(r'^(\d+)\.(\d+)\.(\d+)' + r'(-[a-z0-9]+(\.[a-z0-9-]+)*)?' + r'(\+[a-z0-9]+(\.[a-z0-9-]+)*)?$', re.I) + + +def is_semver(s): + return _SEMVER_RE.match(s) + + +def _semantic_key(s): + def make_tuple(s, absent): + if s is None: + result = (absent,) + else: + parts = s[1:].split('.') + # We can't compare ints and strings on Python 3, so fudge it + # by zero-filling numeric values so simulate a numeric comparison + result = tuple([p.zfill(8) if p.isdigit() else p for p in parts]) + return result + + m = is_semver(s) + if not m: + raise UnsupportedVersionError(s) + groups = m.groups() + major, minor, patch = [int(i) for i in groups[:3]] + # choose the '|' and '*' so that versions sort correctly + pre, build = make_tuple(groups[3], '|'), make_tuple(groups[5], '*') + return (major, minor, patch), pre, build + + +class SemanticVersion(Version): + def parse(self, s): + return _semantic_key(s) + + @property + def is_prerelease(self): + return self._parts[1][0] != '|' + + +class SemanticMatcher(Matcher): + version_class = SemanticVersion + + +class VersionScheme(object): + def __init__(self, key, matcher, suggester=None): + self.key = key + self.matcher = matcher + self.suggester = suggester + + def is_valid_version(self, s): + try: + self.matcher.version_class(s) + result = True + except UnsupportedVersionError: + result = False + return result + + def is_valid_matcher(self, s): + try: + self.matcher(s) + result = True + except UnsupportedVersionError: + result = False + return result + + def is_valid_constraint_list(self, s): + """ + Used for processing some metadata fields + """ + # See issue #140. Be tolerant of a single trailing comma. + if s.endswith(','): + s = s[:-1] + return self.is_valid_matcher('dummy_name (%s)' % s) + + def suggest(self, s): + if self.suggester is None: + result = None + else: + result = self.suggester(s) + return result + + +_SCHEMES = { + 'normalized': VersionScheme(_normalized_key, NormalizedMatcher, + _suggest_normalized_version), + 'legacy': VersionScheme(_legacy_key, LegacyMatcher, lambda self, s: s), + 'semantic': VersionScheme(_semantic_key, SemanticMatcher, + _suggest_semantic_version), +} + +_SCHEMES['default'] = _SCHEMES['normalized'] + + +def get_scheme(name): + if name not in _SCHEMES: + raise ValueError('unknown scheme name: %r' % name) + return _SCHEMES[name] diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/w32.exe b/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/w32.exe new file mode 100644 index 0000000000000000000000000000000000000000..4ee2d3a31b59e8b50f433ecdf0be9e496e8cc3b8 GIT binary patch literal 91648 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/w64-arm.exe b/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/w64-arm.exe new file mode 100644 index 0000000000000000000000000000000000000000..951d5817c9e6d81c94a173a0d9fead7f1f143331 GIT binary patch literal 168448 zcmeFa3wTvmo%g@?IY~Gt7a%vTZIjSePY$J)a*bAV5?UKBwnK>3sWUGD+VKS1+Hg_Q zT9eSxIW+2U07dCLZ$fJ|iFSrgL7N#J0(E9WQKx{`%cxDD)r3@q0wt#{&HMT8OL7u| zc4nOS|NNh4@;oPd@3q(Ew|@8aTbKQTJGU9XF(!rI;Gi+jaMfSL{{IL5S;mYn_=oXk zU-0`y&sfX8UsM&X*-&`@`j35d{i=Hl*Q~nlzK?AzTzz-p`c3y0*4$Tk^X)4N@BP?a zcVC~Cm41y|^~q)bvgd2FT3_{kPrv``XP@Bt>GwZ*c8-1h#@TOhJ^$e+&;F%-{l?jE z+Sjk2{agEe+u0VbUz^qT>JhFvA8tAORr~s(S9Sf`tWx`$^WkwV$?=!s_N^t+WeI}A-%-%^pqt}=Fn>g8L z7CN9iSz0VJ;D9=2k?S|!y?G;V?)fx@1d#gf_QNYsXiW9>>+f2%ag{MI#7U)2vz_ZB zT$BDH#zd}nvYCo&c@d%EOs-dq1b}><*Wd4CwEIY3?R=q2@sfq{vZIX%&5;uC$5M1h&uUuH~Ir+?)O7a#nm zwu^q!-S^pCXU}l*%_i^ZTdlSy17@c&@B5(;Iry+S>im39t3r`P#FPThE#$qKGK(l%P90@!XIK17tLpymsMCYjZ>%Hr#@GLBx~Y2BGW&{5 zLtf`sx&k5Dxy|Z&$ZezRfUBwF1vgRq7IDHJ97ELrq*YGPWtOmD*S&xC+q5x_93Jqzd(82MWD;KVQvtZ%na4fu@bnz=Z z7oC1|K=}28>ty_Pg5M%z(OzVkuGi>#de=bF=^X=Wc&;uq%XGbqtMK(0_?iH&f&Zv* zEL?-jqr$uJ@0Asfg=^uw8r*xhehgfz9o4BeRsUn)yr_Xb@+)j1twm{t^NS*+@hiNa zwELAdWqwg1Y5Yio7AEsQi?hLJt)mwow2&nqGUZ3MQjoD!WG$_&$V3u7ev>#0ub=Z< z?dScz_SgLW_7nV41_yU_`*YiS{CPa*x1aP+YF~l;eh~Tn5c2z{$nQsx-#WY_|UJWM!>Zw-*%pf7G(^#i4hP z4GzxZ-O+ETLv(QIYx9oifNe?6dm@<*!2FntV~-B%lgAJ0(_`cp z4H^c9Y4FQYG#FfDj@q^xn|)@@>?3E!nM5*u^zQVyNW!-1Yi>AF;LGlB#O6@WmOaTx zw|`>05B`8xh}n5o{n#@;a&Zw=WN@px)!Ur*?=sinJUZt#s7)nq6BMJFAM~OO~xvCAv`JP zimCb8S=SU@HGN9n#LVJ%jQSH0Nq>>r=FCXZfviZ8$x?em&sO1x=Q7K&)6VnX0z}ISp9pO{Uf?i||ug5*YSvptGTJr3v((LIxJUdCQLCRC6Y>r+L};z(x7Q z$o4G*gZsxSmt0RpR^-(da2hBxM|=H&BjqM=BvKn&w)oBW?+~p<|Liu3+&1ze+soe= z+$a3bJU>{awq+j=o^xoC+>Up@6287?im6(3m6;fgu3oq%5I9n83WoaT4;^d`U30Lt z!1DK7SD30LS)D&C<`=Po{oUi5r#Id^bm) z3Go}s7a(77jC}Bah~FjU|Jd!I4@3Ow1*hOn0iM+V@8P)|9G?FDkK%jH+FhuYCE4{5*HslV2=aOqo>c|_nq~pw4cZKV}zaf75-l;_WmV& zz?1b2$9xS9$9nJu3#OZ$0n?CEV9pxKN)IsvfbuM+CD+MJ@}n3(WY;VHZSBx63#gB zpOf0Xe7_D1wJ~y<(5a*%Q}4yMFYKhap3LfX}q znIgYjxzx??dQ!b-SA56e zbK)Hye@m8L1I8(qd46(kZ^GnhU*p{FB4o{`B_yK4NyBBi~N=VvC&)J#$0x zD;P69l4jzqzVstOYf_VBY(};@y2H0)_ZfUY@rLL<93y$wjgh!;Aa55R{Em$`(a%?u z8XrW?;i1z-jm2@vUN`>TWZH~pnw_fOrgK?pynAxtzM_!aV4;uy+M=I|?4X}V)@GZIIhJW6Zk%Vfv>dySvcWAam0NwmrD{hw zRl9TT_VU7l<=@;kedKrA%x}M8sLlNLFVm*ow}Yv1jZf=+=8Sxihe(gU!+~RMPNbt7 z`UsYo4NJZYOK#J7bWZQrZZ1|^YCB{FGB%Wlj;OzT$LMc1ZJ!6{dse5#!RwjsUCq;0 z)7ClC8jqzBhjH-oIQ&y>%)ATWbR2c54Yegc*-AStj9oXRnWOc-N&PeML*?gR;GNpL9r}0sC&N$Awhrsk%k$I0 z)P~Bz2__+0 z_N2vo9yW3D<16Ui9`reV3k$YSf%_GHGf($t!QZMGo&8sJb`}Nr+c536R&{3{W%SlMHV`|E+@yvPcV{LJkfMWKNZrx zEP1IYt!7ecMZe`gx^)* zw>~ZMss(QCJo%Bt4BA4*D?QsN8hSWPu79YV6|~{fO!5){ALiincnUl(y{mdwz;g{| zV8O%aHsw*B=;-a;*w)uGBpZ&dJ-Z@_PGjhM;pmstaS~aSYzVHO@%*A>pXUhAFYx^D zJRe9iPpK{O&;egw|5tKWyxx#$s+vhxTC*>||1U}F&JYfqw0hF+%BgxiLYj?_E3tEy zLs##4K<$i5yFgmCn^w61*c77z@lak&cZIMRvr-=QRbh83!;nILX)`)H$;WUv66=JeW)R zYViJX@@!mf;^LWR@UWWxs|en$EH=yBOB z(ecmVDZ3BFb}TpEQs~GlI9*9!ZFfI^F;Cx2+A}-eiw?1R#>G4DNMWAIv9q#s(ucX|L%V!d zB++@t&54)L3(}1zkT2;+)zgBV>b*MBA-*gq^VLRxTl{L*TNa3Kqpm2nTIE!SS2mcM zccWc5y0s?9(XDowgMs+Nl<9rk#0wrWZQb_OYAbli$Is6%gj^zwMi%Og4W_($?B`usD#oDEA^FkTHT;?Yho?O-te5j!on{U5!w zRq63N1T!$4KR&MQ?5!pdu%_JD`%%-Oe)N9CwAtTG%jK8S#_6JK@w;bQNG4P+d`?4L=kW)k6quY%y@y_-%0Ja&|kYQWV|yi3AXq0 zOx>dv@9W?`~rO1vn4AodfEB8 zZor@T5inQhMC$Nm<`%?EZ3J1g;LU5$k=^(at#_6sRIVBs^vdnPm)Jo}U2=II+Aehc z8tY(Ie2XPtFR%SmQ}H1s8)f6=6V_@>D?j_^Zw~JI!fF$5@kQ!7;eE9gq^)Z1B?GcW zL;SyL0(8i0|2N7!ozB?c`p9PbWS8mo2f}Xz@rjs^h*H;C_>T65-kswebLzih*c&%BqmW0Wn}YHAz7joQ*XJ=5N4%gVOL z4__spSLaUZ-OtZ{Uz8I+;o_tOoZu_XjlIvQ&x}>y!JN2!_3hLrm^%+KPSx|7f*+FlLF|>QLx2b*t%R=$XCl_OlG%rtvz^044?W%f*p z7kt_&^CtE$xlDLenVv=X;Thtc-1dG)KR<6ZP9BmA^`oCU1{g!wxG9?wFYr5d?`6`J zW?Y`vnB6>OXyj8r4^azLrz5VJ*3Gi=kDT&PvC}Ku^j`8Vv!)#BL;ok|?;?GsHJSXAM&z$x3?IB$wj-R{ z)Kmt4ElvGw)5g@#H8r3c7c)-m75|h?9fDnOKkDMiUo z|2MBY^U6O(-;Xz1lQKLW`|TvNvyb0+?2po!*E))ylZc>0t696kvmNvFY=MDCkfEL4 z*vrk|(e00PB>!p`76fwZCu6AU%txh%r(aLS#XGU2CgtGTK#73 zyP#D-ws6&r@jJ=e%x^DajZW-w3-{mR*8mOdJU#D>|Bkwk!NW)SZRg#s)T^uNt03Px z#{Hk=`QP}ppvw*L2!3ze)6Mf<-l_jyKeyS>!(&V@y_@tpes|D@hXa)xjuSfTf(ohg z({7(a%N$KXMYU5{1!N?*7;seBjq`mf#cQDCa3{O!;b-+N~+zI+a_ z5PJ?Qt{|TX8QF_{ir)o)iRSl{Pjm@DXB^ad3n@#!O5y7tsaG%u>4WmBUFGcs&elbd zk_z&N$geyXA3QW7W-b~M|JkYQdvztx0ypo~Ts`{zfHuAWEFSH=^namDwGSWKpVOWR zZ5}BqiD%%0Ra{)z6}8O%r5A%;ZIX9jtG5FE)#w)GvEO66y!Qv*iL$c1g(z;QPM#pMHa1n^)E5Z3RwR%uSO%OHij> zcXAvgY22Pi8!_JlCBkKtSP@qO@f3w7JidrIPac~&0v zBa8Nx9v~la(7naHPiLH;UToUJ{L+Ia0nrlT-+B_2%PxW9#T@gZV@d^z&bzPPDU zyg_~OkcEF>rLVJCe{|h@BOT#`*EMCd$0{o<#u8S>x-!NR6|>1RD^N>3v?{{{j}((9 zR2-=bSiz?BRoL?^?o%6%T~{1m&%(#q_QK%>Q3k&gPZ;{M06&lSN)N6-pp==ouu zm+Zms1c&tH*ji|)zRLHgxR%(e8JMqUt@}`aSn8RlXV0$`|0!0Itmh=xbHQyVa`Ci_ z%Ro^HetUD5_##>7B$u;s3oodAF~17RBir-D!#{%#x_%gX3y$PEgwN!9M4M3Yt#*tF zz4Fv5`WU9XU{{=}5c*Z{ES{_ODONYE13fulea;V#4QnFAJK5=8?7n=nVk_{R zU6%QoKHjUWUCw>q{V=rk^6VLzr;jlU3n=2f_@(KM!RPuYQ(*<43s@P?1-}#7UJ7h6 z%X~OsZQUKikL~k^+J)<2s$%@lwtD^5Su%pEf;tL-pIw2Zx_!dzJU%gU>i~7vRMnx7*jT$L$WyjN1oja(kqs z?{UeZSzjR^G&{!JWS7n7-yWsE?6Rwz{(~!GUBn<52hy*)He|cN3a%?6ZWFjE(ji$+ z?+i69MxINN=T*q1C(oAdKTUs2Of7s;RgsYFjU2;`z>oZbJ=Z(O+~a>Gb7Sb!4h)jB$gHgO)auh)yuqKsTEk)0vw{hEgx>| z^6!!BTxhj}@%DcAJ{4J7v*F(E!qgp8P2|g#BPYxkvVPa2e=mMpVAb{UKCbf`uaD;z znRtL-ftBB{@xwQfjg7>s_F-4MK2?S-X8Zy!8?d{ITVBmLLU1_qw8`_sW3&Ta>~;?R z@!Aoe1&VKR_z|CTh##Tzteeb=-=q>F8ILcqv5vNmY3+H`E`vG;TTbe8Y7O!}~mJ_LbZ_AN*7e}2P#m9(w) zZ=c?W>Swdd~SB91TNXSaJ`;<<5>Qk2s%Q|RVSquABMhVAU+e zHi>sOWX0^cyO7(bCG@Gnn()YCYy2bdWPjJ|gH?yXm)F0gcA2K8$+Xi1&hK||HW7Gp zu6pXW<={?mRe(FeU%@^7wQ(nVP%#QGHQ;3?cv*`rUTI~mtG1eVi`GNy5WMy1R}asR zUSRD(?_V$vNL=XrRgr{Z=>6#MbZhF7R^(1LG*}neKF^xk)OTZ9Nd@z;=axtZnA$t7 z*zUl%NXOw!;+0l#?ZJSl8fdcGRIb?h?XpGTbHqVX2NuZo-HSgFV7yX1 z-b|5hI7t5Jv9g4Ct9r}$_=FYMTKPw$wMu^Ri{&FrE{o6$-Hfs17pq;(tDME|6xwa& zwx`jK(oc}bPaD|o_LpZw5-&|6o=2YOpkx31FYo*XKd1d+`|Q{m#}C@W7^@-0?CVQ0Q?PqBjx6!k6z;Jzd%%65 z5T8@;t)OjZ0!o_#uCSFsXn?++8@Ph`qJzavCNGkhM4MVS&o~{QJJJ!e3g-t&pKIx7 z_QkMkxxt|^o6VczOT|jXlcW6_&ps6zXHBBl&m7t@th4fLtCyas^p@fDPILw~U|Ya? z5AoMPe*_*F%r$wQ9q`JbYc)pQ=hb%)<3PybjEj@(A@kkax@3n_&20In2H#;JeT8qH z5A3mqd=dM(CslFga3}dazff}rngf)Ke<8)}xAR$PaW4;J$?b*U16bxMPB)#pt%>+2 z++V3F*=0Tx-_3<@WIMLcqc$Yt|B&m}y~puM zphsA6c(Kz|ekM4rWSnqXU zZ*x#VY?0qou_mYqAgU3gc$`bd<(U?(u zth~3`W%9zmasBCJzg6v@WgOa+RDOoj_V#7eq4FQkF*~E!7u8pReXVECPBsX>*L+F% zP0Ie7dOrHr;J2caA{`oc7NkyF-w0eP*WDR9QbJu?tFsne5@ft_oi&cRp!e^{%8zW1 z)vX&CA8a_*Ry6+6D8BBDmpe;tw*p6M+`39r&3gR&s+B2@AFce#8$KT?X=e{okAIxK zHUNZaoS8TDzNfR~5#U|ri?scYcN5HnrjLT>ZvTY#eDZm)2735B;lYFTzT)i z*f(~9GG053*LT9_d4i{mKK|}v+3{{`T$9bOBi0?b>nTV0F~fA%y2AwPDX#**%+ZE> z?X^s1?|Z<_G;k9HH_-<8mG=IN`DkRacnWa&ETkDoT;6UPa_;h?Xi1ayJ!}~ zPZJ*TcaPM7??%#lJX51JjitewC3;6DznAGol_&weP@!}?8p z8~($D!iHn*Tn9J2>xg7X^OWDncH{(~H0;o0Qu|_Hu9*>On+6Sq3;eh+v4tbyi;J5A z^;$<~_RfLc`OrI0^nPH|z=w#*Z=Esi(IV!ut_5dGV^LB2Bcv@Rt<)dvFT?k0mHp~T zi$_>%BfZQTpJOM1&u6w&_FV16LJTx=XfO#HObKUGUvbRgWH9Bv+l^XvXb4iM8l_P%@7Cgtilg7{Z>$dM!kxCkKPzRBNC8;JZKR*CJ z96sE;a0&hezFWNBn%u8wQJe{+l8Dk+h!Fg5D<3aP00PCl0;=xszQl6n-LGj&1Y>n(A3g)PQfc>5z$k zh}Z{fcD8@>kmf=r;X0#Vv1cE;+U$I0OThr}RUY_E%0O%7pDjG#yJGXVW?ZrGTQ~A6 zzhYq^`^ucw$}1Lj9SS!s#@5M?El8M>(tK092H0Dvv%t#hF9QGS>pj3Ey>8p5p?$l_ z^Q$Ar`QqApwi3cZP6T7g5@;eN+aQ_S|u60tvo7(vk+EZJX_#@uB6&r7k zUc}c5A4reXuA%N<;m?J@O8|TLkYbVCOI}B>qs87;cJouegyRF~O4jl2oy@QA&@CMY z@a<<(-y}cl=N{NFPywAq|Lw%YIv6TH-OxRk=tVAHc+>AAOo5g7G*s8b#PKsmKJy7js?T(8WtW`02pGm@h9rxJQ z4)WlWT)LJSu`q87FRLzx7l;0$!Rv))Cq8Zt0@DFKD-TRI9inHw&sX~h{mg@oU;NpI zf%$&3zX%#O{0ti6Puuew;88SNd@!|R(_c(m0Z)c^lBX4%rpu;Mb|$pKj#fr{n6KiR zV$(d|p5GbGTjKd2Bdh0-$$i9`n^^l?XL_0v-hlc z*DPrDZ`1>SWGgoiYlnt;ZQDF}Esu65(Prxd8wV!S z?sGFHKe`y(y47#ySHN=x@LVB0w*`OYKf!Z*11`_WZxqj|9rW6Ec&hR+ZG~OF>t%hf zC-?u({RqArV?BsBE?^z%>>hak2X2`clIocv-uDgnAHR9sW5|cgvy3$_mF1bpat-~j z!T+nK|LCE-Z@G0JNUHk|%l6f`OD>%F)whTC7w9|%4?g_t)6o;R+rC;L;>_=`CbG6h zbbTr|jkOTRq9-PF82q;%Gxvr-o;DZ8u~)m{*r4X(F5IfQ)csNNdwHvQ_dVWu`Odrf zqUbcrX}^!XZacS;m^-vzAe}-Pt?S%KJ@QLR$miLcYHZOzAP;J*?XCCkXrC0>etd0c zp!b2AfyG7B9-RpuqCxCq(446N*L955_M;nLVBUYjYAa4WW%<5~gY!gF;bUa{#M#%; zOTPkwhq;*a4C&1DM;*M4v^(#|_La@B$GCen?vid7%&$?t>$O`G)oY^zrR33l4fpNX zpu&SD9)Y(u0FPk#;ah|AI(h$h;N`{F#@X{8qwP>D`+x$j?3zybO-|gxPIu)tIeqlJ zJL4kuMcI4t!&T5{A-v&@EB<>psoYuQxMh)v z7tz1RiBCNYJ!kMf;BTlL;N1aq5o<}p_F8WA&j+q?{EVkbm#@)6nJ{H_{Q>$$*moyuqo zR!xkv8hcKVb!Yt~XYJ1`cK$r{IdhF8#$#GvK0N;N#@*jbf^Cfpo9N}09U6q&94JYA&zIU3s8Swq!)uygzDf}tfg0|2>>u>7}d57r$+-}T7^_h#~ zhW3^Z*@YxOM7(<*`o9MKiLHkR{3-2!cCE8tBlqWJ3Hg2S=HBFZ^h?Bdb-eMAb z!+Iw8&xr$G>K6!xAaTTguF;FPCeZOYnp>SS>$%-4E)MP=tFBYbUmE^2o^kgq9FxtE z9Ld(H&J61O4cAucTuYtzP-h^3uV|$&4PM9m2=lS6^u2+0q+3+qXt@>diwD&IbADfV z1+u$1i5I$|BW>o4mfdE2t1jk!#0zIwXU6(4b4l+*#7g zdJG?He#A?{=QjEp@eh1U^?vrP`s2aQ(2*t|>l`lDGoEr{?@{|cuulHvIb!H*8OsK( z^dqH=C+u-MWt$H%j>MK$FrJR0A8JSwkA|$grBPxR zShs}^smv#yq31Q&yeKgb#kTA|xUr`Yu_1h>xkGJjx@tsQl2MON#Ww#1(+g6qTKOSf zdccig$mU09m=2G29-P-h2gOCyuL$M1+WIuvUWk8-7{bB%L zzmR$&+$YmdvILC#BU)R)d~7ec33Gh~Ue??YKKR^zu6_Ot=4k@!8h~x7DD}kP3Dpy&9>G^| zjoDma())oe5n)f5;Pmix0(e&>;pY@`365EdZ}Q5RtE}dI1^wy8CLgBHo*$>ZUEcl? z#eWq0$^IQNpJ#K9YHyCqr`Udf`+z^ywx3!j?eXdJPCGfJv;$H1&7-Xz^sCmFO!t|c zKlatXI=I7n<}2xu*9VVVn|oOoJ6LZ@de@kezQ|un&U0*1aF{CA7A+Z!o28 zaGmKGd^T-haM8GdLBCZuxP#{vzLLS)$+N**0}YajFhO&R_J;P-@Kx2QAe;28ENxt9x@EB;@|u2;I5Hz9mfyc2rT$?IT}-Y z^(#g(hqP8-UQ@xDf`uA~k41;Sqt4$)haaFOX$#n@BYW31Na~J`)P6R zzfOy~OK9;xXtQW>f${m&r{w92f!TZI^@d+^60aocCP@&Yfex`PaV( zPWb?uYg?IVYHyyh>;c8qR?c3+I3xQu2emCec-;{V(lHe=W_K1ZzxYdul>PlD~=7r zCnJV=U3nrv+*NBKGl>yLiP2_WV-i`GsbpTgJ+RR6RSJI+d7uTD0?dsC7MhN7^tR?7 z!hu867Ju3|y$4$nI%u*pt~9yzFPqxW0Z%kPD}y|hCLZ>gI)1>WK6ihs|`0-!7aRda0~CtT)fA)AB}hEt=8Xz_n~o7QoKy#foAr; z$j&c-w{_+TwyN@8WJ!BCoHHRNwQu0O%~l`0&f0_s7n|V~`e&C;lU6heL&H}DXVEWswkp$_?X+;;7e!;5kq>irxXD09{z2>LU z&258|7Yya;vFv%_%mDphPgyC?853i>Tj}Gy=qine1sXxFf$ZxJ&T`XS;|^r||FDNf^xOdrHo=4JC+aB2?#9NmuXvHO7s}ATSD+nw zp`(Ga;AQ_d$~90XVBp)W%yYrhDxhTU zJcKMn*WawQ9@#bPQ#wk6teGBf&x7sFV;xO>rRk`@-gK-cA9>cfP#Fs-=yp7_r`9qd7Wr>O;pL$uaS0&Dv*V*8|8*Fe{M3p2!a3B^hDfFRj`5 z%sT3>FTyu?W3a0JN>dxg%HLkecXO+}fS|xKySJ@vC$9Na_&27$n(yC+5zOIij zJ}M@iGguP6e$Kl|jcgBF=}k+EOnhCAN!-)8@|k<)n~v`>c8J~>>0sU9(zQGXt*dUV zxzTilfNdJ(>)&lUowkx6?2N|Ewe*e!~#|EP;R4eTMxeZ#Gv(;fEmh zt`r{X0(VjPCmsIS3jZvtsj>Md6FjSbTRBqG5={`tlb|43hp zSJuK0_zYq3%um@5_=kArE|+KONAb+-jKBVvJfr&m7(DYU;PrUsTE=FQmEIwqiPY76 z#?*;t4vS}?#b}gpa0uutwJ>=?nU|U_bTtN4G|-spJ+ z=^W{lQr7wr|E-FqNfu@MB8jCxU9~xCW#@RhPH`kpKV1c{*>a0*bmSJFAKP;xZ&;q{ z*k6i1w#PuSQ^`Jsr_+PryL75$uUEm=C1ROV7W9!fc%A9^F|;?(8$QY_EwSvma^;C; zOj!`bhAPj$B(?YFZhOQ}^0dDsgq<#Jvua-9zO;(6e;5Wskv1ms_ZoQ4BoqrOw4%-@~<4Qh_SkgsBuwcK8>1z!Z1|E)EF8psP(k_BagDk9sak zKi(zNk8@`{`dv$1f%DCkte)?@-c$e6}E3t2EH|qt#Y^f?Y&cZHM|dLts;JF$eMa%6d#1S^GeO#+4CUy zcjvfQIqjDX@*L%T&5UuyikYjf|3$mDAH|;PsE<7*8D`!+)Z2@XjsH-mHD}C+m&CGD zR*^S}S6_3lLYQe9278-V1I{F@9;)_yze?Tt;#e zbK$-o*d#aOx!QTaqw?c-rQe2LY-dkxAFu?{fW4-8;el0FZ3E>Gq*}Fs37mJqeISFi zJ-5ogEMB-ywrsxUSu(=WO6G4;uUe0fuyn4Kzw{t^*I@fKH(>#zZ2v;$O71G>%u_p^ zIcM5ZdQ~c8J>fUYZ_klvuA~cihROqv@`Whx`J}%Fmr;DG5HV+)c9b~`K8DJ;ZBD0* z^n>~>JwJL54q6S?p(~gtx37BkeoBA4KlWwV<&*PIaLZp9%)auGo2w7SuS@PSm)RFGUQeD)QrRXSGT9+hC(PUZjn>zf~ zWA}iYzBigHW5^Nvhio~Dx^gtj<>OOu#4Ht~JX;_`At9l)e= z>#4(&qg#Kk969Z(%-xhpmZKVYXn1|Cv*uGgyBU6yEa{re%X)shKk@SDypkoQNtQ;x z^PZF2C+j8cE6vO6U8j)d$mwJ%xn(j-g6_GoylHZ;x*jvT*kYFs&Rp1H4m_^SK3 zu6|#nLw;;EF|A4XfE(Xo5^X-lVd7zQeF$EP;^P)SWUY|z)6Vi>&Q*y=$+wtmh!_;( z+IdPt#~zVCTvIvh`y|g<{FmW`_XX!$_&Wc+a4K%%*!DrrZcz+Mx_mCUSo`i_d%VOV z29Q=}+qNL`CcAc+Jo1sk?DJmB_+2;)BYW}>3jW5iTj+qwf-CXKu|*rngIrfuY)Z|x zh?P{c#;ltD3I8FLyU~u>><>hoIDhndXI>(>DRsHx12yCirIs_-Y0iYSR|2|Rj`sIA zu6%P9^_|W&7ioKcN>ZIE%ysM`%}3fQ>Rhur7}s2!+9M{}esxMk(+u)_l=Tss-#wRM zI_{=Ve*r$wZHbo)v3uYsh%S=7i;^Bg@2rB)s^1YwybNy*;p$2US3UIKE3-8z?>_Rb zrOZ;s6ZMQ6y?k1?zLx$4t!cJDr1#NlU4Q=z_+8Z3=X3o1s4)xb8TWW)*NtzeTt|!~ z$XW`;X;hZ^{C4#1T#tv@YkVZ?@-B2|AK&mADcgTX){1O-`w#F3JbOxd_z&?1`Q9#n z{Dk#G|G(gm^kM$^^FP2J8h^^}+qn7z{BhlX7k>~B`J?d1sQHLw9s3<Ad*ENGI*C{s@#fyl{wc!>acY*@lCDOPSyw4p%2EYKic@> z!Wgl6N4F2_5ZTdWJ(3)AfbEm)%<#Bp9%VM6^M`cKsJ_^JclGv0`t{fJUofiwUFbLI zu5*kNT zXL8=pIpyem?MbwG3;U#cLg?Hw`Vu3L>|5&v&Y6U_g@<6>v>cU{-|*rLedBHl>n;Gcxp@hsVDe*?TM$JIJ+Wg{rmKh>-)yyp_>2U zp`rN`c=v7b5Nq};*TP42m*JtZF?gu%_wdk!Bp%vJ*~{|~F}cw^#GIYWLv>^E(8dYF zJd}~dLy75}O+2*!%vlq*w{hFvukd&ND|^2(dL6lR!&vf*-W-_9`tNRZz4%MI30bPD z@sHF^Yr_p4>>o-5;cLYpByZyJXk}*|_jR@nd91U9dq?-9Po*=JXHilge#SW(hV5)C`8Hzz$>4ZOdX>gbNHM82b!?0P~O)+y}^S$TJaGlk=#aiXi%yb{7XZn?}#T#Twg^4DQ8KQJ(dlwOK>! zmi`~KPpmSjeZ?@6+8>HHX&nr4i94Xh(D<&htfZCm6D8mH549g)z0M|VNFIH8{2lt< zB72nlrbE70&()eMHu3kfu9-Oy&QFbWtcFfr+(Yjb7rdExli(>N$Zca zHb`rXck(Tc!{~>w&7Ha*alieIapHeVp4hG*Lk7-K)) ze`h})d%ga+N$yALe`i0E{FtPDd^&SV`@Nux`z@>#&T&X>f8C$fzF?f$w;w$%{rkf- z=X}Q!@W#5ZeO3JQtq5>e^>^%Jdf7jXZ?Z%>Uh+?6?})vpru{MY(rHiEDr`&v`xy@+ zXI~*Ny2f6svxhmm7M_VAcg&#Pzj5oCG^!rr_pDK49)xJ=Ur@;nNUbsipP z^UlNL_1t@S{O4ES4jzZ&D*6tazWuh3JpqN#{v)SFXPteH9$=q{_NDh~-T|n zzp?t&gN``ke3z<&1#?67Xbfij0}E_8*mJBsxB8Z};PYS`y?@?=ZwY%9dRNGf_=}~J zd$CC;*Dx>jF!Hg%#J_|71=c(caxXdZ#J9)r$HHgnoA%tC2S=-bUu!$B zq`vkOoCU@{A*EFmEt36Tp#5H=cZF51b&2z3drnebb|u1nH}}X&e>e6^`@Me7b4+U} zEoYCt_Bs>P)}ECS=S@+baa>+_r}Cq#+kDQMIO)(U#2Gi4&}?y0=A)%OrUZR5SG1_7 zpOUxXd9h2^y?g5)92mw8?K|(KuO=IxQ*f|P*4vM6r?dB3{gNDOK3;UT(;1_WcrF`$ z9=5YiTwQDSJ-x`e1C;^JLjk}0Hv+TA=NZuEICHGhUHEZ{6|A=dcZqZCz0rI{F+3@M zb1r*O`gmp?L0y!-<0QwKCz#BhGJE~>e0--ed=9ONy^1|KE!5FTTYpMhF_({bIM+N! z7fx#bd)ltXA5ohhC%KkWu*m)}4JQb`{K9Cmcp8>yBlQ*z=)8>Nn&b~Eg z-Em&~uh^qo4Nhu49~t;9IEj)kh#f2hM=oC+6CIQ179b}}K{W^6aO`TXamsmo(hc4+ zl4$hU8AlgM*PAKMKEq_b7;8Vyksi*~_Y?O92i|_tbJWZJz9HIwmU^`>jrnlJDzJHZ z?blGQz~uL@LEf4fgJ~|li~g9ui6lDNllBO6E$D)|{THDYj;D;mO^$IgPk zCxF4@=f}90zktok>jFnF`zMEA!p3|36wcJwZ_rn0I#=Iy@bG*V_@PZ$?QT=Q-2PW_ zrJa3I-^yp&fPt~kI_bXZa&zpC{HhzK!VqG4yxu01{oY|j`a?{7?aQc?Fsf2y7>)l ztOiG-yT)McocA-6Z^>3LmrwwYEQUXrBVN9&aqF}i?v)nhzJaw44e$YcIJcbrkL7$5 zMmo-uhhFCJv=%;!uIQ%zo57c-zy2LvjT+5SOh9`FU!)(B6KHS@|JXj~#?zN0{b1+( zM(Iec-?qP_O5L-P>i(`fYe?P5xsKwqAJ50+0QiZykl!UA%W_th1f++c__J zSBShZVg!>9PL8)QE-Nr8wdL?-<`t3Sy?lctSa;9nt(rq;O?zI=JqtC)$|IgDzUYBI zW$=#b&%4R2===lagKqg?Qu*0#`5@&Rd_fz}8^JUF@6jD^4DSDZG#|ZJ;`f~ctMjm= zX9nP}H^7a)fja;n|2w}9^u~|*PR9%A8u?-O*?83%43|IC^J&U4&eT}`=~8P53#L9?YYqkj6MrzqdY znKq~X&T4y|I<=p=Dc$T7oL>11d;fRF+Cu#NPvj`xZsuM{*Z#}}{pHlj_hiB=7cF3G zENiCG0Vh5cIlcv*lFm=xC`ESnJ@d=KU83s=#utM7v%t(A0ox~?2`-4qckC=*aAYmz z?_9KiZC(q%Q?fI@y9978EoboH0kjDhZ=WII}AM+BR|?( z)SG^ITJRUa=@+22;98_JWrzVN&gAW-{tMRs_P|q$TOYvA6mlk6ggxmy4;3B>;0xaQ zY~hhU&cr!I9_^=A+1ueG{Il5&)b|hcP49>k9KCa#IT}LNBE(XJU*R*I_2;KJ_u}07 zLC*G@-u@YE$XK*n0v?uwhYDAxKR~{rech}f^Y)NSwujTN97@;T@?OTf0qnSePwt_- z;qN8*?<9P90)7PF+Z`LMaZmC-A7@U;8PD@gEAnekk@!|;5U{Xg-zI*Xx3C}o^Qi`# z@339a?+W0)8n`_j^bhzu=sftDv#>^uzlA&Px0PKu36JSpV9xn_liIICKS(bt&tdXN z59^GIoAMofIuc&Tr<2W)zWOn1Ddpd67;pB8Zl%<7 z&Rg$iPk9ycbgVbi?91ny7W=s#n8bJO$xD3G_BG+vyil1r%Gwao>kQ9T^eg8hq<;b) z`god2fFaq{jDIa zieD5NMZfQL&f{>-TZ6t~gCE<%S-hOpNnDcs@Ze{3KG|~R`2=|Vs?EEOzdxFX;>L8c z53}?0{QjEXHh$ar?clf1XFB;9DQhj^H^H1-)Ho{f~giw)t$IX7GUU2UIFJo4NL z)tL@l8JyR!7?^6<+Zed+@NUiydCq~=fn`M8B558=XQU*MUHqbibWw<_VDjwx$I-#Z z8DHp3B)+j(8JpC((Ec_Q{5?o4@dA5oKZp*(HsuBUP8>K$9pHCg?9~?+;s=&sFXLa} zey2}k;Qa9KnBOSG556QnF>o(G`Y}F_JiFc`cDKdZBXQsz>?goJsqXq$3l>T@Nsn>{ z6yHth)EQ-SwMU>@a(S&Y&WKUZIo7lUm@m}#UU~y&ZgQVOz`Tp~q>5h`1Gnm79V=_U z9bS!HWuKv#T~Nz`ddvoZTLxeevxJc!AHp?(Y)_VVry-n|H|g%b}Sb}Vd+xvk{=5drh&cAee38oh*`+>ULx z_v!|Mhjy2e{uuZw{-p2G-U)^6nvW>vxiHH#6~S-MV?(8jWdjs%kv?~9j%>p4_f>|+ z=R>|{coXX`TR9gC{ZQKn{y)clQqQhjgH6!bdkMK% zQ*K*`*s-p2viT+pIEaG73h1zd_b)xn-ortwP4OCMY~Y+%E&KD@UzN4Z0B()j<*!O^ zSfj9i9dLN#9QEs2`la#v4ZyNx{G=w;srnpSmfJp+ve*p!yBhl5i{y4A@oSY0z&EFO zt_YeAtryqY3Fo_TdF?;NuK;)9v+!XzczgHSN26e z7a1sqXSz5mMQznkx61T#pYFE%Map~a?BHJU1!zP3?AZ}#Uk=m7v9YQnwLG z<$O2nYelNr$J*|l5n}!udH$gtQ^4mZE;4d_8)%o0K))+rfo7BNr#?=eG8f0U0EfmL zI{#w}^}LMD(YM+(X7tMal5!E`P0t!f{B5BfV>-5)vN2)|u{Q_z3pUv#z4v(SPTte5 z6KhD?3!1FIe~7M)eUF2SVXjeS{Zu@$Uwx1UFyH(jRfJI8AKN!o57Zu?5N?dfB* zeHs6$UHb79wn#h`kiI3JQ=Gb$^*hWhdh0{ER-n^#t{?t!{Kt$7g`eZl{Wbc!l{&V< z3#z9kxg5UeWb&6%r~Hf}o9>g_|CREhyL?I~{x!M%FIh8O%^6TXLSKn)vQK^FJIDM0 zYgFwx(mC2{g;so%vHb+^ME_QJUikhc&nowGu8L3S{-@mQo%GIVKVq!-+1ZyBKTGzD zhx|>mkM0D}AF12a5&XW+XhT~|N?sp4K{IjX)O)<+pN6*GxHMocYlW;c& z84~VPZ!fqDyqB{N*f%*=Tux^)ETHU47mtqoOm0VCUV_J#-w;O}g~wgw+nF}G>E$u- zsCY{<9zV;oaQ6sT508Jv{eJ|Hdu%*{J9qzb7jhDKitjX-h<&C?HN3C_+DDQ3WSZVP z3YHq4ZJTk)Ie89U?0TR4!}We>RJ|NFa!I|1+;fwY^@Hk{?o;2thfc4CC%d`Y>GWr; zKHM~_t%W?>`GIq+{5Oosf88k9I3v;?$0ft{1h!6f2C;9?ajn>sO1#gUkq*k`+g>%k zNJ%MvQxqFojK8rFel2xfS`%_;Bubqnz=F#uN?Me&ti$@OGu@AAQcIgI{MHthrOo zX>06TNKEr0<6HUb`0+cdeT?C38V#>6HvEkhcL$c!ttW0N=}j~9ifLCg3p}OoSv1Eq zUXQ{5j6s;Q=9^K>d&uu!iqC(Te4!4Vft7CeZLvL`II>&c+<`WV|1p)J7 zZTq}3Xc#{6SH9xa=qt4ySmk`{L;cabR11DV!2EH(p9T+y=Rm(+{50aUCB2jJ5t+m5 z#sBKN+TT_|e-`uWd)!}qk~zE+kK@lhjJ&fitqwf&PPW&?&%OBIcZbffRGs)6c7K!o zXZ7nd_$|bUYP;c0eM2)a8$5o8Z#i<_9%Buszh%SoUrzs>XXeJk>c8s8ui0t8+vCjF zDNXN^`IYy3tvyq1KT`AzH9GYuK5~NoiRV?upbPB0*0i|%OQ+4@c|ge&zUMwWJ?R@y z8k>v1RHnsy-!oh;d98hyc(7x5yo^819zVwiBk_ z)DuGnym9b4#=(+@J@9n!x+8oqE&aJi+;%?dbH3%EdZTVVp6%(zUwe@GFK--?)9=jl z$X^t!f#4GRtjYkfSivNIPL8(+CPtPQY?`>f2s#$r5UHg;Tc!dpW}D&mPBI>fxes_T2Z(m-T&-sX3jDy-Eus zwS`=LJlcT(X z(R=5WSxK3XA=|J`B{;}iXWz%{IiPxU$X3%*8REy9Zd;Cr^{_W?^S5(Qo~nxj1?Z`Be`DBAou?*UeRxZHJc=&T*s%qC9^@ImZl6^s{mL1^EO`K(cveNZSlV54Kz0q0~cHQ^?uD)%sH)`qj>4} zN+q{vZ?amGj^tikv;#go6O0fWYuv%NR&u|d&i6<^ zh~IR;m)n0e{OMzy9Kz%4p2orU=wGV=)LkOR`54TdA?1aJl0u# zetd3|V0;Z3_}uvXCXE|@=O5qRYKj>r*DzG@@X@`xukZ?SY>;$y<6#5 zIpG51+5_2f)eX~%u>@fM%=1kgDTT$VF{88He z0C^9vHc`(@xv#c9{CYQW$_xH1=0&n-H^ZJEJAsZO&hu0Qa;ezEd!fDRR3AmB>nwN8 zBKMp_m{6Nx?w5f_(NZ|P+;{xgd)p3QJTHGvF@0}clk{3Q`quVOT;10DFn$dFjQp1h ze$sJQ*g9^QF4Zo+)2S;MV4jGvnDnpgDedeH09T;Uv~ebw4V!e2^o7<_T=Wy)QoG}P zZ6}@`)~RZ@?{V6G=dk~zwmDx8{pzflx9e_9j~}Klp))D=+)A=u^ZNJ`;I;4ZRXMj~ zSD}laVK^Kf`jWf%-qUHxewW(Hr5~~-z3e5{bw0AG>zCYXCi~Cy{KCcIHj?$P=QoHx z2Tr2PnLqa05B?>s6q4+g!a%402vI?|ukOvGR%bw*ni$^*+wG z(sT4J2N$Y)#JDPH|C#EqK6P{AYm})!m6EWZe|vM{aXtUmea07W)-z|O+3z_M=utg$ zhLnfHvHBOo;G42(9AS|Xe*#~1bU!^jXs=f?^EZw^rFAJ$ z^u&4AReu89)876g!21*0pMsCN8hF1zpZU#gO(#~)xITcclfICj^9}slI?D46jmqB= zd!9AU#OL}uOYTJvzJl)RLO!-$#d(!Kt=asXnKJ(y*qwdMrThk+dJlPo!{%?A+FoD5 zjTdra({!&G7dWVD{#$2Ec^zfuQbzfEc_-L50ndSQ=1tJgoE6v}EB8C!USr-SO4-;U zvs}Ju>{C7`{cbn?e_6}z`LVZ#(__Ch%NJ8dz7l2URuF5)2g&;!Z8p)i&KFrn+sS8= zXq=^angDt4Vc*z(U>AJ9A@&iYT!Ftq_)W)-{|%yKwngk%B%ek z;ty*rL3;2<)0XbZpZ>?{7jqo5Blwei_j(=Y-dDZoOJDaaebzPITKYf@_gm?U=2u^s zkv~1iz4&5*H94FKym>CXKZjm1`pX2 z@{L~CRD-WUn|4f2^Ct%WnN8b0#N_pTyb5%(tqYjbdS{aSe1bKo@LG=OqxyGQf%$K* z{=N2`^xMpvqy4cTLbhJ>Pg;7pbvmQ_fNzGM`fTf1d$}$re~Kx^z%$>R2yb%bub(qW zegt3S!#7*N<;N_O_eF5nHHQ3s51;(Yl-Jzq9Dk&aGeqn)0je{XHDK7Da10s{ORp@V zt_b#`63*9(ruJX2MF$kaZ|*?jePmhBYlpWK4Yb<`z$s;-hNY|Q? zz+3-Yd7U+((t+rnfbZc-eQ#s&Nry&ue(2S&{K$}Wg4SF_)0{PeHJ`DTw^3&)x>EW; zc{J}7-C~w2ExH9A^$W9HGQ>P@t@Pvz@Q}Uk1AfyPGWgnc%mKz9fq$Z_oO5S71q*pq zM){eGJSzTTJc0h;ECVZJT{U@T!S~|%fBu!TW{Z6B6}(qD7Z2kzichD*r$2G+oW^~Ui_vy&t83>}-$*;Bed|-gpU0Q;?A*Q7 zTjBbNo3V4~^dUR4;fg7KY5Gem$jfDG*%3p_AM_cF}3MD zA4c9I@vZh*{9CDq^S$DQHPL6}-zNL{ile>CoC&nq-$na@gDLj9@xV65kl4Rm%XIt< ze?s|K_dA^LDK{VAVOJh|Y~-HB?fK(BPs(rHdKt-F^4<1h$@$!RP15(>N8A553Un5L z7r!#$r&+t{?iC0#wzBsTX+1Ueq2t$FL*OI8{dM5zY1WI<&%NHa3ukDZDeLto6XQKh z`ajPdd&+0{1|#@joXOnX_7U&kx9=yl)9JRYF&E#q3On(s z+%V%GJ3gg)Zlxa0Qvp}rJ~zMCv3RhqU|tr#Zo6W4ZxlolWBWzkcaMf~A)iR&k?&K# z_9Y!e=2)XQRIlpPT9zo|)xaKS?t%54_S}Q_4bN`ugY$m)oAw*1;|#K`c?H$m$sVN| z@Mhx@oQ>XprEea#7I3xzd&G!OrALWrt1ss%@6A6wLVbomzAI;6$6lxH^zC){uY&I! zdo&WgL?_Wfd(zbJ;;Slc0%`-X^#IXodrk@RZJi{x-xEOvEhd4}(}}6ABeb?~ zPQ#^_B-T?cP)Th|(6%Rt_DJy3_FPOr>x5`qib#TDzVFX|=1C?YSkL)>fB*gRdd+Jl z&$BOUuf6u#Yp>h3bId(AMut!HvjjRTMR({?KYV8s3#&RG=6}^QIPD&5;-%!%AU%z2 zEb=Rozp?B-Vf+hZzw*h?ATc(L%jYN86|k?geN|z2!STi9p{HN%{mt|np&y4PiOcJ; ziZbalP8s2#!c%?*nX$Z-a^rcPu^ZKyL35P1%PC3D^|J`@k#TIER>js^Un8JXTIIJ*1T^-R&K$sL-XB*yvsQ~dA`?c-mYa_L-Re{cV`rFAgF+LF!Ix0<=I>ZngpPT&k0d#fezcXEYVRZU%bc>3?>SN8zfA)+w z#oV7)VeDab%U3f-#bAk7jJ%IleEpeeQ@1U7jr;8IVe~zn-cY*yrixQsdTAM9CJh@P;LXHDtg@1dK|>|(7%-dnlwtL)1`?kVToJ@*T=qk1jW zOQR0$%)1U9YiS}*3jUk%5!#PXCt#1S*1BA?=(0wg14>y>+~I4^lbY{OFrU?|qb5J+ zN6P7*+e&l>vOkzHFuzR`oE**PykoA{lw5X5dk}h`GUdF}x|jU%UEo>cnOt^^eTbN6 z{P?Ee-#^*-|K2mA$j>v?#!`U+T?)z-SeibLR1e7^EjxF`glXB`l) z*_4MLM5ywV<8yF6z4-^(*X0YX{mk9hdw@av`U$>+(6o==a~b1q?j$yQQQ}VGX`CTH z(7sN-YU%rk*Qn{~h1bUrJY^{W_btHTf4hye}aWuN@+r?o?Gg z)!@F5%$gZmLOZh219#R>66Jr9)W(g{W7E(3@B5?KZ5-V{cAHQ)^3f~EK{s+=PB&xv zr$j&BP3i}y&8)i$hH&-@<3E~jm3Ji8%~g_v*kdQN$1b^deV^`+PQ7%(wlZk+k-%`A z{X?StuktONp^(bD@nUQ4%!_>s3Wz_`ozLcAVp5Sexef-DabUU6W|z z-b5Rk*9>rRgtp#7K9R0fa?6YFja$%spS>c$8f<{p=FW=ZAC=Ym&)9R2QCq=X=dU>n z>-!{jmZ$m68D#J0Xg8Xmmz(+RmhtBiiM7vclHOl{6&O}~R)PVe-8 z=uKxIH}$2%pl%gyxb@w-!kMYhn(t=MAFO{OsXosm=c#Y%!V@&kF7lCVN4_v^Ft7gU ze)x8KQECc#HYFDx7#Hip?_6=+@~e?tk`K&gT#KzD&D#O^Qzd1C-9u%KOtadGZDf9w zGs5_>z%xyoJBDOQ>~jyF%nkSdE%@)*wWx6J7++dCzvb)Wv^jRLf79j~Cy%t-W;}pj zmu1zYrr&r^2Rf%7^1bXa+(p#82^m_vLU5--3%Vmch%8l#EETbH z%|1DoeNwqtxF^cMyBivP0UkUOr-3X7o=3o~%NM_sz;iP+q4i|=7i|UhI5|<}gXrb| zFHuhKG$-(=*0(vQh)3y6$vRTqtVYU+?`}?NKScf%-ovYYd0yM7vyUg`KQZwy`;48^ zjKOyD2gn{GdWru4A6&^qSK@1p-))xiP+0%4Je%`tQ);+o^N$-?@0p=ZuNWJoImhjJ zYHp+SemMs==e-1-YTws6PVMIsUnbr&1-hui=TK*teCCgQ6OZdm-GcvR3;d_SLg&uC z-o)uDjr3J=Z+WO-%C?4$EBls^+n|~9njfvpy?kC`UEf4bhO_r}jH;Upe{a}B2vtNZCb^pB4hZ-0zn$7t;SMc0Jc^`QT z1yeINL_c;(#<(ZA{;s~fDVCG7X(DTxad!7P{-o!X7n1C)UBI*vI%RH+f7-x*4Ln?j z%*(56lkLLb|G_NqFB+++TH6Pn_H@!#ZPnbqHO3F>f)k6; zx8&2-IriTX`5U%VH||9@;BVimdn`A>GkjmNw-wU%i}bU7;$9x42Jo3#GEUW|Z?#Fydy!%u1Aze_6?@anh z*82?kn+?+TgIOiH!tHX6KW9u`CoX$#x{!Bk}n?0p%tf_SFbE@$p z87JZv>CB=zo3_ki%KA2Sc$Y*U-0r!%Uv9Ta~m}LiEviKX# z51JPb9-;3ez@T;nug09cV{9y!wt#6_3%IUWp1Vyr>7Xp|EjtK&bFc>qKEX3GW&B1d%tlXa3NoGUSeIPV$Js}IV|!Rvjp#^qe>pLT&*bAT zBtBPxJ&DiWS3Hw@EzY)#>v_NZAv3@$CIN@r<{R)p%}XWoBA+e!a;dxzxP8n~8h6Xj zOw@y}S+D2ME8x&C>nahaAsl*UU9Gu%-Y&V?l7Fyt zeB0??J{-d5c6`6h8cxJ*1oFKva)(vB=`V@jn*MfN<@9&ps+juHT3nXs>!k2JqA#}( zca043-_hvZ;Tgz)hdJ*VU75%J2!5$1b|7TNS@4nA+g@*IaXzvFeV^vs&wbe;C@&w`#6`)uagTl|uI zAH)Ooe=j`8jLY^LUY%Umtta{bZll*e-`+Lq{H^+kgU|YpIP=H2D(LrJWKxYAz4|#g z)mcY)HMT`Vs}9c=49W92YJUe3{dF6>8a&o%oQ@2v_{pUHvJBq9L8y-YB&QlY9B}&6 z^O1cf@2i?GkNr_+d<7rXJevNt)88-uJN?zaUw^Lt+o2uP=PIW!=?C?{UH{RT=%t;0 zzfZrCbLI^j=V0tR@^z+(YnPvi8S4(G??kNV;CPewR0q$%Ve&*eaL6CQz;eLAqSzOQ ze!Cr5!km#eC1AO66j&UafkThm!TlgSC4=xdw3?XnbK_$^;QCtivEl2h{$qpds}2}P zuCJSb`TzC$LWbC4a9!~KVttK54+oqvVjoJ(!N(kWV0_aObU1g|95{53&BowZw68Og zc)@J)EE(A&Nv6{LA7qaX9heqtW*?TnY-veK?0Wo^(be~|M|Hlj>8o1{(b<*ZGputT zI(H-2xc-tOWs_ zC%ue*2YxrFZx4A~BoFHDF~RpJ?{p?LHl!rkPxyZyzxe)b|H(Z7*pVab!}9YjBo3B5 zhQ?<<2;9xmYmBinbf%Fmws=h59q0ne{hpiWNATCAPEn6^q15Mm-|u(pa%T|2&|E#Y zc#h0u^2{(dwdmrv%a%#o&CE?J-@vzL5MIVw3cMr7 z+6}x1t(&po48f~&kNjL(8Gj37X{N15(Ca)ho%8Rd+*>n~_OIkOK8wt4e=~ZvU7M`f zPOlx?vCE2WXD{5wUaXvQjJ54*;68irug{6&bN!V~enxaZ=)C%Ss2gAH#CiFc_kjUV zp`Y*3V!dQHmCi=`ALSB`PYt)_b03WB&z!s;X+Pz>?96*&z6-#Y=DUk?8h4zwWZ7wD z@>OiYXGS@PF6a4@HwGSF1rCUP4!z15jCa+XSIUR-`V8g!ksN9<$Fi|S5`Fo&mn_a1 ze6T!mCT@P9M0vAThtWZj+$Ff7EtVxYTo|w9OYtJ)Ta$xuu%FA*RzMr(tau?XujbC! z3g}k#B{U+w!Qcez@K0D@vU9bg+uaTCT_M@h#RvEaa?TJO_5U&Oa5eadfD7VOW>=m~ zjkYGvAUz8rp$4zDK;<@2PUiwUjdLn{!=E@uZ-;j?Kb?~qQ!{!d#=pn#3dXAc-LtX< z?|hB5w3}yx^h96Dcvl~vrH{?vQ1cGGqSMO)Pou@ry8ERwCyKB16T@lnO)4{sc znpM7;cFwiB`?gLxy~h)G;ilU)oF~fz+)E^W99V+B6TAMu5xcv_bK&d^U|HjtGTZnq zdh+hr!8v!0CvWy_o?lA8I`e*>IN(e8J!h=4hafeO4HJ*&wI*a^~{+6!K%8(rLHT|};XX`FU!Bk7%It!?d_OCUbbf+z1c_lZl zu`1?6OGbyX#*<~<3CG3MYrddq>jZm3W6xXowW3EHK&QS3-Bc8NxaK=bK1_pS=KBZ8 zBYIv+4xbF}b&#FMhyJGpTI+`I$}hz1%}KIRgni!bzB+a*^C%j;k2^r}-y4|MkY~k$ z%&YncUOv=^@>vw16Q2t#qrqU>vx{Rp6YYH;|M@!b5%El%y@dEK&8sO>QXF&Qy|P;W zd9ci++4w+q`rR`1#Rl>JN zYPD7L6zkaHZ%BS~bT*1X>q^)y6`Otuyt;e3)fV3rF6v@$2F7{PH{jczbrjsCe3(4I ztPyk0U=1!J-@OIzXoVk@p17f{7kh`1B~DCg8(Q~iq2zT>KDjpW+gkLk;=PePtIgq$ zq|8jU7UPTe5J&*5l{ag_>RY^Ya!ogZinPm_-4ZYYGnNV zMbbecFG$u3UCTWP+8ZPXo%KbV6a26OnV^Vr=gL1r?T(CZ97p*G?Pk($#Zr^gb+Pl*$k6lOeM zqptdl^PP;tv-dt}4?#F52T6-^7u#ck=1kl~PE%fA$gk+w(NF6+SWb=l`V&YN*5|85<4CC0aP0qu8T2eTH2 z`{(i-U#x!X@^Jqw_xG%D{}t}p{=|+M4(s zG1Qw`6KgnA3cm=L=8QW`9vxxlfF2%9wh16Jh7eGn-~P~|HqNE9@>zo$SPy~?UFaU{ zPmdp9KjggGDL)sLL%;UWgOsVjXU1Od$U;BlK1S8i`xlUTDbx8C%1Aak%sctxi$`wc zSv%_@(N5=m{IC5*zWn;W8hokFFRA0e>g1|md`5>u+l)0K6D9G+FPePs!|@CJ&(|f! zCEoIJ`jU){Om1}KVfK5CNo6#q&+vXbXG(WWcLRgU>-~|$n3hvU@ck3-v}ef{{Ry6F zOo?_nm+-&l!x>X%t3NTOuTy7tVy=vAozUAB1N+cE-iHm+7kh(z ztQDNEH1Bt_j-j{V_CD%Z)M-!H`yL~Q^ZVKR+&#K$oZV6a&E#8F|8&~W9G!`PzOrQwG}(TS-y+2t@@wtM|L7-!vpla-{Y+=<2xUCfcL~}$mGg_ ztK4S=oI7U_PpdlZj44RH{Z9pZk5N84w!NsC`O4>67c{0lFS)+(ZqcUOPA2VaKQl0| zm^my>@(nyp-DYSd(4B%CmFVe8R%`z4+CvFX-&&U_~{2j5K%pAqlj zTwA_E{EEErYI6a25Y7x;^DItYX8hlJdnh**cwE{3$G>C!BInOEbC%ND#eOt^ystg6 zkU7(M6q_Kse>eW3N5Sg=a);LK<;<7*gudH2hu3_8Ggb<1Tj;UUY0t;p`BJdsQ7>@T zTXT@}j^O@oUiggQ9mG<@e8rC?a=v4y8=mw1m&4@UwZL$v$$4lM z>FmzBTn?SINssaxGPiuXUS|*H4BGiBaBH59vOeJD%bz7Kp$nag@y8|?syiOxP;*== z`6&N?X4KiuHdYF+3if8{xZcwThi?m z?PsluW|X5^w(5TDbuSU8dB!^~v}b!$-tEv*^a?9|fHf3n9A8SpO=bc&k26owWtR4@ zJrXz@II#-;8s8RfdmX=3?g=B8WZm-Dq?^Nsl{+n4Ik&LJl&f0)UD>Tal6=k_3ZC!K z){gPa9q%?=!dW!a+S75dm5Cg?JXAS#MOlfRo@QA^f$>(+L+Y11H=Cg~=%q+7$mgfS zV=d3S$jV$2n7U&AMOJ!WZC&Sjp06yt{x4Ix2eX@T+)Mdp${*xi;JNT$7N$3C)!9AB zd$mR0!qN+@W%4QXkhf4{D0ugpBl1Vwd3Ip_ zt=y|~415Y#7jWK_?SV1Q#qap=o5XJ44lGf8nf+6Am-GZfZ}*-GEYv<)OWqC9WE1^$ z9JkWL^cm%>M^3rSO52GCh@5z3p^s;g6M=<-{W;1=mufQ}Bj0pjcUUyHG0r~mD7Z%V zR8v|#bwzc?x3~J4549uQ-;Pc|G~l-KkX2Aq%r5H8dH>c z_F*Y|re!TIDy*6m}{W=)UT-so1Xk3wX^{Bh(b zfnVGWOwF9B#Y38nE`m6v1IR<1LHNII0)9zf;4arUy%Wmr84Lf7*)`R`;UiCc^M>Fy z|JjNokyK(sHjK%K~u> z=onvFB%{5^XHQ6rWLQPT_}Gf~`7HdQfvKL~()-ydR_qe+72lQEuQ_ie@7G!%o8cw$ z^F^+~R-rp!oSd-tJdYhQ-}_?V%e~8P`~2rWKe!%Nd(c0*G~?vb=!Pz2ch_AA4?`a> z{(j)$R&X*IK65v6St+<7hNs#FAH(MUK&Y`48edsCXW?Xcl>1KbHz#<%c&6|x-gFuJ zPX~P4#eWc(H3#B-K7K#U97Xu7rH-)!!Pk12M?D*&r_4ioFPf69q`m4te>Lzh`7Vm2 z6J7gMu<;dW=sD&!YU(HMe;TC6tOPw~wX()zzoD+=&CUFF_Ylz;apa+~41Lh%NxMSP6CDfC;j{>Oz@z=sSUTRp_bkQGB(gOby< zp69ThUx9a#&v;pf$A9R6$5~5nIX1DmP2fdmc9lo3x~w?en)RU_H{SCMv@t+FhWnYz z2)Xv-=qqcF1{S`yAl&~U=2kpYeK~O*S*?G|+0yVr-pf|t@WLtZLfx%BRPL9YbHxis zi{Z5RbA7rB8DkJX=i~6_T6C9P;AJPUaONqhpiLjoIk!9>xDag>s9(co}!WMWKu1?2V$wQa5L`J^qmTi+=^a%X*$k z**JA{SCEG~KJvL&K=WFw^6MRKt$zLA9R0)FEA2raHSz5zd$(eEKJ`(_SvmKIkXOoP zyu5V{a>*vzteu98xS%O7#C&{_oa%Mt7j2|YgtC%-LX^FpvP}h!Op^}`;3I1n>o5qP z@D;qgl{q{dveWKgiL7N~s~C97iDT@@D7&9Lo~Dg5WEja{wa96`oariTD?_#w^kX$U zz#YDFa|LVM>U)Bi;auH!Bp$E^Jn4Dqy8};X{F;NeS1N`vSs(7&?H#(7Ec_;8*M2NL zaxZv1OQ_34+K^A&tOtDHEQnS4_C>`!s*Y0X*WfWR+7`)nz&h{itd zoxI?O=$)epd02jyQO3QB_reYGYu2;Kt$t)hBlRL0mVh%<2iNAxUS5P*7!8J$5QznkQFks#LmmFfc_Wy%jL!O@U<`m#spLfT0 z+TNc9ti)jKpKRCYOch5ic-=cb^fq$1&R56Czos*|p!9W!KcP_6F;EN2xo`srx2tN$1h+@QwH;hff6H6G!RC=u7EyDSkTf>Bu_BBu3Vu zoZ%0bI{ZQU$b5Ld$IecR!XN744{zdw3XPj{LMH9M#yFt!< z`;7BJY_*PzN8EFg&q}k-aLi!~=exq!t|6CQ_{YU|YOkAr*X0M4dmi7-whnA>UC_?l zB-%OjqR!HfW%z-m1e(zqex=qhKGV-~m$7JFdIG+UK3BS~A$@_fcWQkqZeF$)=o}Rl zF~-z;i{Dd{`g$zU*L2?9nCJ_?Ak&w7pIATgm-Zm*+eSB%xKGTvo39yoloQB_H}oV?vuCk~?oE!_Y z(7l-duh#$EW7|dhdVdxFv&Nv4%+>|`jzVY5Sv9C$~(S2>m$FZ<&bg2F07thuF*CoCKmfd?Rc;<=mLD2tQ4?DTS9XfIMKWEK} zuW0X+JdSVW-pEew0SA_f)NubwbUd{?kz4Mwrvm-$F%skK@OeEU6qbMJQYm_i8{w{xfXJJ>QtgR#YPE{qob zDE|u>U-SAy@M?3%sC3MN3w^~F<)H>|dzS#0;wyg7IDE<<2j0Z1C5t5QD=vROjSkk` zL)^JQ2Y1d~yvzAHc`lZlxd^X6-(37TQ9hr!IB=eEjy4y_2ku-HX)eT9#ZyPl3Fkh> zo*Vk&`^?EQ=HrgUoLu@obMmVMtm4t%JP)j+%}F?EPFy(MxpCpUZj`wpC+azKa~j^7 z?0YeKK7+xyZFHpEL&Ufm%-scW-qLV7D*jo}Lw) z2TqN1Y&$0xE6&%~dg|j=(LkA1G#}omI$g9adB#0st4t;Gfn>vO)~x>5z1ST*6W>~! zf)6tHwnWYj>^=FZMJ+ApD1zi<&VpA2xi_L0zUJrdh*~?l_svZWTc-fecs`G^7gc>Z z+;=`*3Nea}t4p;kd>1*8Y1U&d5oBMn6flvMG`}f57=pGW~ z5I#*TM;E;J-+^nRWOQ^7J?!lfc+JpR+jEFD6I-)Q*w zbIiRyaqnE>nDIwvk8sbDqn$_N+~G4Be34%Z`K+$@)Sm!0xnKly|{rTZgisH^24ghnnEK{9pb}c&yIf^6zRT=08lEYU3bn2qwY1 z86K)L%-769G}%#G0kf6kI!k;yGr(tpQ&Hu19*SGWCwo%eRHQFYs}>S8*NTr zJfySylbru-e6>B~wDGoJRP8_OwPF`OjV$Y!(B9a_Ixt-9~x zhqNC|YP*?o5!$AY`Gt%{G9R{6^aWXm25QGKCsxfst*@mEnBfoo@U_l?)t;jManY^g zIFrW5IrcrDvB~F`nh! zPuoTp_9ka0e7gI!H)v0H=b$Syy0ujMbG_rYc65`+*yvvp5pAOv3F&DW2@*U(3a4xrYN@zKCt{Rx!31w zFN%X}jrl0NQ@$~$sIT$PL7s~5Dk+NaUhBe!)(!r4IQZ)Ze_G?h-}ci3^PZU&Zt$W zC<8wXu|{IIJVh+g^l<<1yTBd)FPo07d;lN3Pw5ve=o8M7X(V6jtSVWIzUL;(G7Et( ziodFl{oKfv2|3g)w+bKm(uD0G%(tnF+&GhZ3AwRI@e8gDFuJUg6Ix83YsDQGjv_x^ zLLVRJVt0|Kt_x9lr3y;JX+r&Y3o?PKEyyD~v zZ_5C@ZeY4yboK@4{eQqGs-eUGD?WjI(gp1IvaUJL_A|!VuNmvf6(#5$6ZeD+#?iPo zGY`Dj+xin|D4)4l3mrza-`I|iY6<@S&Cq)Gj!R?Pd7h8_vV;9@8hARr-?_`u2QK(u zwu$A>(BENjbcFLGx}vto;oW zB0R6%P~Th&O&s9a&uCNam8(7NM}m*f`Eu5~W%4N#l`le)kLZ}h7}I#yKwD}jf}d%r zjUOaq)c)(9-LTXA#Vk?Pc(l2ffpv$w8Mu=P2X3? z0>7OI&x&sKGd4Z5?5pvsNc<)aPv=|noH#?Hk1~E&gLa&d>~rGFpNF(|V^OYlKcE`waXNo`2p%VcjmpKeJ!O8TWC zKQH91MBKIZ_RY6SK0>a8K12`KK@Y-z8u*VuOHGTczNQSjzmWG$Pg#AbcIKg`9M0I4 zYZexA-j3v03tO-)G<-fK7J*jMZ2zHD%0?6OQg;GvyiU7+*yW2IBoA#5a!(~W)ygVwTNqrWoG2I04z99_M3+6}Yjxgz zKJjjmGD>%!Eo@c->r9;%Y z&d0j<>ppaBU8|T^@%qWYU|n0+dFYfQ@1I0wI0gSw9nZDUId%5@f;a}A@AoLSAS?7x z;+%*+eO5hV{3`j>I}&jroSQPVMvifobzeFc;F+jF$5b>9puDx-68Hh$+l{MK5Ok5s5-aob9KqzT%hStSxZlCP$RolU76yNIzynpj` z;r@%j?RNTm37GYNGyGTj^X>4`-QbuUf@bWI_lErbTkZz z>aV08{3N~dy`k6&^>dUmN9bGSjgBZuMwmw)`((ZD9{6lDBO>2P$?XqjvIn}j#wWnw zy|Cn>n1RKf5{q17wd})>?+FBvLSVugQc&Ey&(mEYW3=O=y zmiQTR(X40xX{&{Y6ITPxqjvz7zh^#8TP}|UUeUObrO91&r`aE}2lt0xFqXI%xg*iG zYDBBJ;=w_9a3S~*Ei^B!Tv&`hrO&>Ia)k?5!>23Yzv;lOG8K%?Jr8mQZX=E~S99XC zm$v!P(^fmRE{m2{oSf|6gs<@xU zhYyMWbKxTBuSzt8E@-Y~4B7bnzpGjova?f#bJ1)S>stNm|9rmBCxb}-NY)*S-va~Y zxw_6xrat_HG3j~pKYq*X{Zaake)(IR^L=H38P46XJ>_-FgEKnvBIp?c&72$IIg(j) zX7?T0YU*vLUhu_j=65B(BQH6>H5a~wTv5SqSH>uT7Zq3+WtcUv%FXK+cu8eV-?Fg) zQxE8s)q~C~V zenq~4HGjzb$E}sj$H(D^1IX5|qyIB-mpJlKKJjmZc0*#>U0!9%)Ta#QD3A{9M*J|F zIaBts2ZHOlJ=mOm_*6z{f9Ou>w81;2tGQD;LY!lV>|Qo^?c&3@fcv4*l_8f7*MVbW zZWZjJjei*!cv$zZlb{D4p40jV>$eVILDbiX~<-`vqZj>M5*T+4Y}{mNDxHMq+9AK;1{ z!Qg5hxY~}s@B55ja_*W$+mcCl8a<$6lmFV!%$n}((3xI5esD}#i7}nK53+2A>s5^( zqH|u9UiCC~;+N>}Q`|k|$~4SP#%}sP$(-y!*M1UNT=R1~K2f3%?dvH=$dFr*wWAJm{W#!z=h5rQP5KPFu3aNe8QP zf5W>lZK&LOeygvyCR%%5;3GZv6!6a+;?GTW6YNU`JMBq^73~c$FWztMH6>IL$V>{0E_hF^}N?wEBFog!}bv5&aalS zzQ$7R!6hj%Y&`@lI*ECEkljkL^XMGlgO@onc6Mtj@TStf%8ui= z-m6colOIsWrC+CfX6t*v#+W(d;*&OtudJ(cb@j}`aV|cbL+1@={cBAkXYSQ|BWEW0 zxI{!3JUKHGTQizm;}~=Z_tHjxj=?mC#}X_A8ZZcgEey zorRBYQA78*%_Q51v*Vahjubxfg86WrAU3zv2&-l2{ zYV>SA&-l2{Zr8J`c*e(lcAK7E%`-mkvs?9S5zqLz&;Cx&uHzXW_u0*Q#<@vnC->P3 zo+Y0pEdG+uF9u(%{Xu+rsL#i(zgTUK& z_t}*^I~She`=V&NVWQm_{B!sr@ekRqPHl>AeUWughmG)J+K^9iZNf%q)(&gd)#DD2 z+kqa)gWF9z*v=o;cg0cs-uPV)@2YqTyMg$JHjHHIzi;fm!Y{cqAn#Z4vs zz54!iNq>*NKU>oOI^PCANqJ^&b$A3hKCG-I_^2Y&?Mb!5>r>h5f_zKv*S?6qSFC^! zeBv@DbU^Xr?oa;D!Cur4?em8|+v>~^-*dp%=|zw)IYPda+l-pvvjp%`&#N{-$tk6R}Ld${e_p6j03#KUVC!j;df^0o{wv=i7v)A z>Yk~7ZO-^wx2a+5@T25|Nd5b8|1brIC^KR|?ysJC^JMoGM1sB9pyPUIQslBp~ zJ12WB=InZ8jc0+SApvJYl3u*D{xH)*5y1;4E8l*YJ1a z67QbSJKFIk{l@9uY-4W)jD+Bldi3c^&0uCbFX_8`2Go83ZBOj@VIt?zXHcFUFK+T zbaD51>d=~4mYgGH#F`lXZupuQ{%-i182)bfni%$uaemM>vFrn^iD6|%u8AKbe~pxT zZo{wC?3<1*mAKa>ZLEi?3g%+-(s2I@&MkG&+LuK~$WylRTP*U#(x6GLCB6GD?{-61 znychJx{tGznfDdRa+ckCgf%99on`54mf5?CzEoGbkxWZxyUf-j%>7z?o^?jp!rq76 z)h3&V@TD9xI@4948`1l*yjSi63x1v4|46x6<4oLF)_Nnf7dJV>UnFOEPVZB|@Ka>a zDEpBQ8DDK>0T1Ux14DX-GhTOJ*n3~jHubG@(Z#$|+r+n=_+rM5XLi!oPULCr8Fik_ z#((;$k^3E;aFVQ^r1N;tS1_dW5T30GV~~BU6J5kiXiSRu6(JqaTp(0_TH@CdfL%*;Y;w2#!p6@AKA)9 z6Ls`^6L8;2zv{2Uz&U>pnXza);Yf)A>b6aFF6Lb7Yt(rk-3h+nS=GXCVTt6@)ZSIt z0CW~Vh#bBPKXg|gaMi(qhZXCz0DL23F5l0XCR1(=v{u3YA?EaL`T$>#O|h*Qymf96 z888i+ddA~><|gKzIJ*-StnZgNvud1i#_5|@zuY(Dg}f;DYM}q>-v?jVk6)eerFf+` z&_hloC)bnYUg+U>G#y??u152o`Wln}^2NqZmYVKwEaU&mS&REi`Q3^SC+CIUcE-1I zjMcxCG3u^%!4=1!(1pDK*ae$-I(U>$HCOFRKmRO!YR?e=3Bt>?-o%Gi!P_nPuK1Ds z21dSTEr#??01EKxrgW4HqM>ZiV2aAk$Gm1JLj&&Lhf1&b%%?>c3y_oNhqnk109aN z!{yx;e}nRsJ;gdS}% z{#@f6pKIyc;J3?9a%N4{8QnX%_xPpcAq`mOjxxcaI2s@G9RI=CmYLX|?!^~cz9lQU z6Z>n>)I#dp-0wJZeWY&!zb8Qhkpq`E_Dq|!E!0nZG;=Mx<9=+#W$;MsvHkne&5g%j z=Q;A#XlyFm!F_(Ae(vTwczod%lz+*dP}X!{es3ds{`hK7EP_v|${pu-uXjS|vVMGM zDvuj`Z7IGskD$Ml?e7)z441Q(SebtTtd99u~*wU)zO263#)+xKa@`OE&mU4 zF*F{(WRh%}v6cN+(I;q2eGcsMwv?((?m;W$dm(xYPi^?fv17_pfKJE@4G^bb@`Pu@ zpIMvGZC0fxT%_^ja5rHG>$K@Wu$P>1<>cC}8Thx9mJn?%;d66(gVWx0a`fSEr}nVL zn)bRfkj0*w-x#7jb3Yn*?Y$&*+wI%|7_~3XP+OZAXPjqM%*i6gBY#srIFE2wV3d0T zkAKBe6ybiro=u)21e&as=%!Sb{243!zm2bJv58s72jedEWUnA&d$`NQv;*!0%YJyQ za?RCElx&&PDt#7I?d189F79xjqu-x5K`LXlP!9Ifiw~D*wlM9)V|%8t7x8{6|2F`4 z5AF7b(zZpQ4f!r;&NWvfd21JOw8CS2@uH$;*5&cy5xORHb)0eV9rnbQKJos#rqTRK z=27R$U|r`8d`tf(-U_dfZ1cPiK7!4tZR8!sIs@qJw06<7M(rDt@fX0;b`sC<_G)-7 zpGTP26B{>n9$!6+93olfPT)%DSTt2kK8V`_9@p7M?N@l%Bha${{m<8!PgAt+r`!4b8rBw*yDLFsaqy1LnDw30i=R+i5%`;iol@hS3{N@(9-f5exQ8;- z%kSgfsj)bEZk3mR4g7r&pOSs2691Tt%cmui*=dKo*wO}hVr%{KSEo;n9i=_ddp>*V z1Esnk$rXK{jeWT>gTFN-;&3iJ6;qYKm2~!1GJ-a zhL18=B+AcEYU4RXf-Ohh6{QJ@6$-U5{*EaH;_?!HhUd*xP&f&b7k?1dvZ}*J& zc%r|50iJ~X_t;0^mwCutlK&$2-qSZ3zJEHGoWIj1Z!3R|d|~f-l>=-=G4{|>=KRL9 z;}+=7)MhIzjWoI&0;kR(yL4XV<~^ z^nnA6DX*Llssl}#drR|KFWOthGc9sJmSe9+A68TM%%XdKh%B&v(Y!|a2Z*L~_z*wI zd`}^kFtc?d=kZgQgx7J-32m5QZP`C9zq)|EyN~(6IXL|-0{!+FK$F`sB zo5wjN<4){#+sVuNIb@gGwYhhc!29+y&-#Vl24M)upwj-b64z?Kt^e|RaD^#x9xrk9~k-;9O54@ zgNI@KG0DFPT~nwB-sZNgJ7%;eu}+HAkIu=G<&?LF+#n(6%uL>(jK2AIW?7Tb%T^UI ze_g<@bJ~OCYUE5HU+p%(on2MJn$g__m7eU>;`DG0_n0ofnNJc|E_k0*B~$j-46$6XOV0$T!}X8W=O)$W!0qz2;Z&)}~%?M?PnO4(K92 z;lm4F#Md>|YF>`Mi`bmHC@%JUHUFt>O1(XjnY<6nNS} zKCxSo7lf}&c#k=^^$(P15psd-T0NdKgmiS;(>|y_(n;*!R(PECrziIh>9dUe!Ck{X z?EU1?VtmoD)*aYeLW&oBnf05mIbj?Yc+oiW`Tjd_mka+m#s2GKJ^LBU9&7UaCg`hz zar&SYjn4;diT1cNetARc(-?~RjFg*`U5$GD4HoCMH>IsHIzU9Nce-UGW zR`+jo?m^lAlyeWtevfVPD(&}pYTAM4Ly7i&mKdXSTz<12{ME{x0UynZ(5B>*Qoc3b zV4^P{-+uCuM80nq$`^i%wb1Zl#nxb>F4|+STTnXAn%v~^Rf#Ud8}28s4f&l6UkDV0 zjqW=FE%{b)M=^D>?C^ZUgO)69>me^y$j(WvvKB5-pX9jUEDgUWpGlR*ZjYT^Nx$Ua zU~jo#w(uU}JXtkSuvE;Cpt~hE=xpUO*?dGwz9vQIA-aIWkU~4@R+&X%l}&cIlw;+xQN4C@9?0^(7UYH_;lqD zV&46qzUKh=H+P93TYiQ-(^_v9`_a%E&kRkcKk=3@JiuLhuFi7wJQdEJ-Pna#M^2va ze&UNHzaC|O>-MIEBuiX0F!1nkzE2f1PcyL*?GNDN_{YgpHq+|w;Jw~; zZ@#WDUS@Ic!vXU{Pk9b@NOy)j=eFy% zr#+y7{oT+$d%NgF^kVeW&`R?DJ`?yVksY)DPIwI4*?ZWTq3M!Db z%=09fQ@U#p^+xO0-SeeuNbXyG7SeyvMt7HxsgL|+U|t68G$a3R2L|nN_0U^_6G=!0}aNn`mPE`#jcc;h=A|RpjD9Yew(KgP(=K zaz8jLGkB`zE_SV{@!N`Dvx?@}zWHkVLTC>=hVG)6tN*i}*ZCqlbQ}F2hYt0OxQ`-3 zmz!)um&X=MzRe7E^S?`tvP?<#?5B&?V5t^plbuw=#3kaV2z0`x)|5j%Bh6rEVW>#vgRv&No0Uvs2(M$*Mh z@KFi>2-;I;N5Dr1a*f}}Fzo-x7x)P}^q810S9fG+;ebOU2kx;lMB6T%ibh@f6h9Dc zj-;Kn|KZHn`@)1QDwu@hJD6Yg^xX4}L-U%SZOQMPJ-?&*e0S!?kw3fHv&jjH+?=9Z ze()P#>kR5;o^|i7b7OSKv&CF~it{RaL%L#CJ4Ba*aX4$%<=g2QqDA%lesMRhe~;rQ z}sCZy}%k2_JJM8LuZHf3@&kSRc(>fsa6?$6BvFWw4!5^QJrP5@*nQ61$an zs&Y6hPx^dpsc)gv{sw-Z>)|C^`Mg8>+B+khzu^C!KE@Fl>-@in|Fy40$nDEHu4bBd z>sIvJ=8PenTql^BTl6gD@CL19n|fo;ocph^aMM>zhqa#k)3GglGOf%;mA~MK0 zH|=-&65|dd$96F~%4qd}aOTG_vomVi9Rp6YxhbyZF za*Hdb+`<3lHvjkO|G&w;qn`gmlueuL#8nl4^nyFI#|fW7#bTWe)bxPkr7D9>RdZJy zOuM6mXYsT9*-z|h-62t>_ZQbKe}g>J!7TO@4u8J zvIha9WHo(1N?z;XxJ|m>WbmE{$JWbUfNX4sr2E;$*o5D}i^%m)H051Fd*jDiTf)kl zk$C{0W{WS!WLK za##~}_%+-`8+U>e&8Lq%EfMw#i+tBwCqBwF6X(Au#agERbjI0Fc@MVzdU)h9WTvC= zv~RO#$@i%gytc5Ggj>bS%(u;czcBC`IHRr)ID}4!z#E6Dc!fp6o z7#)s}-vMwezD&JXvftAi_?YVbQfQ;jy7~pb|Czktj?}5*QN9#pGja%mJL>w+sf!(| zQ+Cj%F-|_kKe8sG#QHMcSn9gUeP#7&t)FC$)NaK8o2{&mWoeI2+{PY#WJ3LfM%9z= zSA?ABY1^$r^%;bY%J@X!(@wt=&gqvt|JBhPtNZ~wt&H4c)#OSJ^@@Jk`_*?T-&fGT zeox~26?;i0Z;3nt|i zcqYC5)4uGbWkzobtmWyAc|M-!*jZ)L2en-CQeH>F3wc){v+kYtLf!y!*FoBkk9XRd zNn4Q_FXd(1*&*@W?*Ye*34IHm1|Q$I#-+VtjjwK|dlVEbCV;HD!1Ls|j`?vyk> zw|}C};=~;N(f{<;b|{AI{Ca&9wW- zec>ZNqFmL6iQC@PyLx}Ce1A0VO3U9^jL$Z9&BIHvXB4tVCbD0OW^|Y6rPwXv)YVu+ zjH~o=+CYv=gC64cm^A2_@!r1gPt1?zt<;`SRz0I}t8d+9`v&ZB)zg{7+L90TYHyTH z^mTARyPeI{#rAnb^-KBqX=CQP$UfsoK)qne%*IrEQe!IZ+(2Klfe6Mo;I$pp%dF3A z{2uuJHJ{I&9AK*tw>1L8ac^3Pu~mB*H#BD84y-HOr}xknF#4(&Ge-Pfi9NFBiq0y{ z7%KNwvA*;i-vQ${J#rnwKReHTro7|lw_o+ZBL+5Ird(zr{FKSjE?a@O_3f9vEnTbe zxk6TXiu`N3b9n*y@ugcC`u zK71m`-5p)Khz;{tZ4Xes^32*Jh3H;ue-r*og=l0ZK8RNP{8DUSp2ug!UV+~!e|s_a z!5l#DjZjYgnzh99BO~%(N9jj8@W^{Z`L847wtks*qz96YMtUGi-xCr(iuf>e^S|k{ zU^eGC*=nY?{^})o=SFMZ9NL7}XPNi*?3iQ$^SgUi?3DZaz^uV~Pf#yhXYT!6{ueK> zoC!Y!-%gL??_$}veJAzo+9N&4T+->REDZmp$7>ah_jGj%_dfEV_jtcbUVC4o#&|uS zDDh)U3$2WD+n4qoaCSla|GF5RRL1S^RUGMOpX%T3FZ?uk_IuV{93*}wus(netRb%n z-g1gHt$s@R%%q)O&dE)k7u2lAPb5C)V%ZxzHLS<-AJOKs__{Q~m+O#OqO5Cpz_I{7K^viw+UzakE+Xc;{|4;x z)O(Y)sj(H`65OXfI{lfoBAv50|b)Z%Y$& zC3svq6fH#(bSSzhT_4SKo)zvZRDIfV>FbRIeTjZL{t=lLnPBaGV^(au@4h4Ap5HZQDuQN!J=*Y~_c?ortiO zx+(YbA961a;}Cy{rhhw6>rm@bYw^4|fp`9Yijxf=3@6Rt?1NzNEw^`E+OsB~|t#X<84^D$dJjBF^Hbf&)+7x}vV;nx}xH$GR?hC+iDR|>~ z+Yf#|gy%W^19NL>y9;~!%M*siG&G*f^N#0P=CPRZ4LmufEzWw=?_T=XxK_`)f2;YQ z-@@~)iT^(|>)|~1teV#{8j$PB1;gjN*y=ui^B4DVr}ey7Y+v;O=)C7-POJl*6yI{i zzBujAVmy)+-}FvYK8@v{!&hKGc(i0oQ60t}r%vFO%lE~tiD~R3={?lD{^r~Eb@P1Y z&0pB}I(}UP)|l$(hVO6lmt5Hx{n*&4A!I=OHq(wz#pm_r%lG{W-Ld4u_>3#ydpUsUL{0k^cti zdMERdOxLW<^f>hT(zK*@;isP<9y)5)%LGGT_Yba@oWb={SU|h%*=D^29C^U37oM4R z;j!p2va~ki(Bc_yc3Ej{^R~(0KbLXe?eL4|JD~f4t>PCC|F`(XN5FZ4Uzqr@k^JH_ z%+YB4!rg1W2hECKRKPE88p$uf!RY*AX#Cj6hQ=>`K^=GeIp9@$Oe1|rUUB=>nu_ua zx!drtx8WBmHz&a_j!LH@enDH5GyI}(1g)Kgf21VQ+BR%yZ{N10a77ZYcqy4z431?a zuNWH3bB0&sB=L$IhgVS7;T8PP?;&21Q~jY?-!#19SMUmrPrTxn!+1qbb+`O#SuZbv zj{v;lZPvVebdq_+mxu9+oc|WD==jnP;T1C*J1!d!uecIkG3gv$@pgh&+>qcE%4@bC zpW@MYMK7>c!Yg#%)jm-LztGuJZHQlxQ`qo}eB>UNU(~}dG>1$+h-{PBm*U0J4-8cj6-$&U; z^sFA)LG+70bW8VYU#tte$VcD7CJVm{1kty#PZpxndxL$olCzn7ve%Hi<=K=W9;E&4 zlkgyC4Ne@f$BiH2L5%r)d$!BlqB;KJEcVjiHWnKX5EljD*hHzIH1e zKdU0ah5vZ}arFG;>Tlaat`eOMr9*h|p{Bf4Pik5my*vBa;o_1|uk;Otv!Yw)+Ea}W z^E|%s$1DFMI3s87(i>o_{*ve z5D(6soQ*u!`A_=l*R7^Jo&O@_o@0G1+mEc>&A#01$vmX?$enhgka-Lqh;GfaGYw9< zPZJ;F#dePlSF*-Q;$h>P!baySJx3#XPNg44XA;{9?|VOgv(bDDiua&bcxEeUB`oW? zXPo0 zc)9NSl1^iP3%G@k>P{ocxtoC<8|U6{C)$(Vq=`7#jo@bs&!ivEMBbZ89~!UDzOLPb z{bNfeA2-%)v^X>AmX$xR$z#>X9?qQ?vO|!cIfZeJ36U48ydFOa#hU#H9whw}IIq!j z=bomV))t=2p1p^)FFzysG0T@nJ)1F3#{Qn$dW`!ZWt(pFWL8Hu z1Ty{W0~w(S&<10+?ECYi9~0a|b|}Zk+ss2!d@Z`R=SxrA&?Z|$0sToPw5*MtOHNE` z`x1U|73jC5Z~Gp`?jy>EH;cYzwy&M3heCD$Qy9n#B?FnMTDHl6Q z`S+t;a&hjtg-@~1Iw9R=kbEw}{X49I$(1?VPEGg4PW{Phksfw|VpF|&|DSR~G&Fk%%VwE59SK8vD}U?dBT6CHQ!tO6843fwNGu?dW0Bu zl~-QEUgr2XHqIvgM_w!cs%P>c**-WQ9d01@Dq0y@xP({>bfSAFdvgw{&nR}lUUbrr zf%DR{B}XzhNvWCIsw)H`9a1uC98GL2-w$QJG%PbQ! zFuWfpr=E-V=fJgWOD^t%)ctGaVPX%SX6^089=zX^)r%}&9;sElfAZXtZ!j^pKctWS z@E9*=1!qjz#4}_Y{M_!zKJUB|W6--LWAj$g*)#B=cd!pOd2)Mq(%)(N9-wdJ1N6es zAu+zg`^Q&?{@dRhm^*>-8JJC-Jab3Nx$rvWyC|=I{NBt%y`KuV#65Y3(1G?IqMw!C zT;ub7H|qg9jNLokiv9E-tv;;>_N{)=u3$ypDnA4NEdpje)Bd!9!Hlymrkvv0uf_ipD?!n)UXu{tw={`_3=e!>~DEv&0X~i%kX_U2(m20^6&xn-;?h0`*ReXQ34? zsszS2D0eyKx$ojg&~If_R^Gm_6}=gG=0b%Rh8IREFI$LBX`Vk(ekNsAM`a7CQ$^Vz zb&#p5>Vex&9hDdF2bS0lU~>1tipOMcwJG)^l?>Cg|+K+ENav=N8Va==VZ5Mqsafe4Ua7Apz-HkW- zX_r7g5fAxE?eIfY9{(YH2oA@0CGItWrjv6!Der*m5BPrj%Sz#%J^c(Yo%E)Jt~GRS z)v#~3Dkc~oLH2j-M&7X@-9!E+Fgg2pcI&^8b20h8#k(0t6dKN*fR15J82?Umnc&^c z$0fO|gt%1QBdNVz{=_B62Oj4Bm(V)uincd_17B_JX1~dO;N;|LAjj5rbXxD1murc} zL0sTljAJc(V*|D*`Br=-;g|UWbgR5vQJ!xhM~UP|`KY{*rhKfEkvWuy)qxASfE-=9 zp*&z~C+~i;eBzG9i9c1|mMO?5Q(HG9FUa5QM)cN2p1+wtpYQ#ioa$$h!>?gYC%2)z zUnA>pO4Pp-`+O0wHQzTJ2Y+q+{>1oCGX6D;-_1+*amFuM=SX7w$RES|8B>edP4}0GNS5?vOJ!=EHLDcOX zuWav#qIk*33vNIS6cG`X%7P7S1?A=j6nw4FZm4CLW@Z=Bte4D+N(+0tU|L~WAzD(I zqGDlMQCVT7e*b69Gkb4#TAlAb=XcKc`_Aa%zyI^hJTvpmWvw+cYc2R)>78UTm`A`f z7jft_JMr$RX74O3!nb_OPASLNSKx-xER~9)&ME&zh-|wPvMvaSi;~f~Zw}kpl z9qyIXc%8C{`|ISu@d)ogXw&fTf86Sxo?@@r#O^GCay;)9)&eLv94Pqho$!!wMIHdfjJO72Sew%4&Y^M zM-zT`fQkr&$UT#kH@ALSQ&QQ~NQ49|VOjPqZd%Fi8$OXaj6ZOTXQm-YFk zMx#}>Gpchl=B<9gw{TQ?vK^}Tjmz)5oQ9n4N59e0vRkG>?`-T8xBzL;Ju21pmG0|Q zdwuSo@*GC(-554#?d^Eq)dExTCcRyH55;?f#rH$O2?J0U*YoeTrp=qMw|JKsdl_#+ z86#WcySf;&-p4r?^K5u8eaN-bF-D!mdOEIi7S*-fylDo)rFnP9o!Cb2K@B>3hjEf_uu2O=mehgyBB^9IOu$c^ZC>OTz}x+bH-q;mCrZWqlEn* z9i!V>u4|1o^Qju%9dLo4!Nj^{>BC`5_hN1QP0e@V3LRUXJ!8Ia)4Q7XKFZkf9lVF) zEA0QN^6Z9u85UV_-BgABhpoD{3cM`5&wAjxgZA3cb!wS5XzEmyC)!&S(q5&g)}j#m z|GLm#$28h!fW40C)Skj7F6sj`;+YW|-@L_g?1e0iJM)AXRO~GdVt>QhfWowj+c76~ z3VL1bl&I0W*Y4Y-?`_2I#i-jzmwlr&{zakA)EMOcK0kbWFEFgYw>_>Uea;w!AFj_A zP`iH#b%FjCN7o71z_>mM=dwiTR^#8#XoIv*kmd<6R_zStFx1zBXgokXN>kl?*Ztmz z#}zRCxy%pHx$-dPu1L25&-UTEjK-U0@!aRWYRD|oPuaOtZJC*-R`rC+kk9%MGuBK{G^aFGcq@li#<6HDe$WNU|o9*ij zqT{!%n_ljZ>vd0z8GT9D<;yjZbY9tl@AuV2eJ{%l7TX%db?m5(%_dY(J3FtHQa%WXkH*&Xm+Eua%hFBP6F+4)8G?Z{T=f@SPW*m3F2TPO_>u4g z|E90={ktK4T&r7q6;8d`|AzUu_$T4OePTx=_T?PcjAv=S*|@Z>#^f#LB469vLI3@D zFZ}Q^IlYD&<~>e!qcwx753&x8Fp9aYF#prel+mkdSLUHxTZp+C*t>HZaGjRiYya&< zH4U&?Kv48cCg|CJA@9&&t?ktGi*08VV}3RSVOne2LD;U`7&c;UzK^|E`@+oMb-sMe z+KyxLd&PP|*X$Yovw(|mJlrj}S01qY)Oi1EQLdlEXZd$RoI{i6`2XxF=H~e<>GjaO z8~lF>%BpXhu?Yi;fEhyiD8pmwTHx_3CC`^TlWvU z{?oDH2sek+Ko8_~;X}WiFs|^L@2>kbD^z&;>F?|`P8|EOPu;q>ws=;e;np@YTWX!# zH+cEjOJRS1EmnV4&Rc9pSgS+nWeS zVb0K8@U1==cfIkfQTO%>fK#=Wfk|4MK(b)~^8YQ?W{+$Bc5kHf9^R3o(k+J0_qCpm zbfS>T|Jv}>PuazI$#gpxVXApI}_%8DH zE3G-*VWmECR=%188=iDwmSrt0af+(db!Ji~^1-Xc*}$~Wq3JLPQ^c)A{T)uzjoH_ZL3 zyi=YAar#M@FGDN@&RyFBFxQB&v8D>wgY-T0BG_2q9BNEE6H<(M0LriHc_A0`Hc6Kz zUhp^Kc`~$H>bGJKo~uH~2-qX9dFZ}~?txNq(ArNjP{Z@4bS;#0$@2nTFX0+Ozm9hu z=hL8DT!e04@j@B$VWjIA$1_|0pHN;X-;Vis{W)1VH>8IR^H@vQmAL;dsY4#=`kSAZ z#kvxnm&5$0e18DuACVWF;{w;=+XZ@DmuJlAJ&$`ZCXRuOzSQo%8p`Wu7yA(4QjlO(cKO#Xc2#9@FsbsK4lJUx43{*bC|}I8o%4={zgw9J6%IuX}qCx)*dJTX04|qUz@cac)qx}TeJwlR;|_}RJ~H$ z7wDtV{Q$ndvnl}XmF`#7^{o-lTqok&ZwRZ#(mIc}fxB_8KjSe3&)y23GR@Z~ z24fBS??N-K6RTh|pG?YMml4Mu`RI(_Du12uTjjeWehbcbJN#~~=ex?wkL~uy@krXu zhwbLWcJm%VHaqTRw4Z^ksD2tWZyyWtWyE-Z^6BHjYUEp8|M`0u^>d5+dKuksy@Wk+ zbPx8i@Eg5TSVrSIre+(iYjT(NXx{<#^sz9(KXSAM{*UYaG^UWhfPd`hBKU9A{rxc} zlD`rD38VAz46(pCffwdLSFiTFz}MqBWML?(xmWk=-k#R2)P1+>vnv;`@crn9f#Tvt zTobR}hI^5{hJ%Ghk$`t%T@0`!^}_s?{yiF+8xXJo-pPRHcj!4>nqO!Un2hvt4D%ny z^IdpH7TsHR4s67};n!fJI$Y@72Z1pY?{%^O*Lz7AhZAwV zSBEy8i0i%H@YnNz`(AG^F@n~s0?{^T9G(KCdJcdr(o2lQ`qgf_w|0cj$F~gNcMf5S zDSjtE-S&fny0_P#&4o-4+nd`&Z#;j2uxa44(I>n!ySGn=ABAZ&SYD59Ctla(RvA9s z%JGRKY!ves5O&54@j8t`bWb19+J9sk^iW=*=VGw8xTvSgdMF<0rLbx6)5F7$!b8`^ z;e*7*8&Mzn`EpMS`R*R{>ploi_q^2q=-jRAMEfa2dndbkUs&=0?$<9w>VAIgx7fwc z#D4iMen$4obNCgb9Y}q-(oaKqy@cJ2x|u-xdr)Vzhq@AVhW@sQu7ULMUJG8N`45z< zhIoM2f|oGItUuQn1wVS`QV;i2nyz;PuD4=mSYF3m-0K(=I?fnmx%h$sV<)}C!SM{K zJojT9ue=|}Ivi_ptie%&L!B2fHt220h-aQ?PhA7@b`$0nBXR#px)bm_0KbixUsC59 z0jJKlKFD7nUmKFYI=8k#pFQKzJ1|IVvue;X%ON8jn)j+_a4qSL@jG4fe$N~6=pLEI zGScURH7m@kY#;2RPo<;AJL5RZZmg@v`BVn1jv8bsjK+KuzJ` znqV1p_6d|FlIlS7ZbkeQIM#)*ci4BKD8)M&wurS)V15tRAvH?BT$hs9g*1;5fBAAr zkwL8ONb?!IzC!25V)$7N#`j6~InFVV?SdZty&=YacqaPxG_*C*p86m8>vJY9-!aB~ zV&T(KtK(?y!isjFmuq{mEEn=jd*`=M{)gk+FNp6SWL#tcCtZ|RRexzc(0&nqF#2#n z)xxF)upzG3-w)KZ)t27kU}Y)hhB+8nKN zywSJkOkd3975A^&)NYeGW`vJ9CMwhzgL{FmQO5YFc9oyeKC8%3zZh@)9;9jQq6~On z39h}8T1T$N^>atx##$50KstYer>}K0A&fh(DclXnxmHxhZc`kk?3Hkmj?h6%Mrf zjsd;#4%$UMXHMzAAJ6->T@|hQuA;pi^nB*sZT06}b}dBxV=Z{sM_6MkraU4~RQKEQ z8?v40KZgfjtSO_tzD0G>(GudX^o-BTS>o0*_t-#6kw|2iMv;?>^5up0I_YZu~ugaNZc{Y8ISZnvL9Dfeqp3Fp>$yzSfc3Lw!D;Vu}F!;6jJq7bb z@jyQuyL-J7Q_`yWebvpzTdT`)NnIRQvNnILP~8 z{+IUd?8RC{4%+sW%2bN_q%tM7E?#{Nm49q`RvM*+`q&A5#rT~DyOpEv==^-nqxJSi z{PxE05|tk0=P)Lgz@O^l9G(j{wKB&TIWE~x-{(l}7QdDuikE3WSpb>eur*2zeNZZ#52utV2g}AqVdjCtJLLHM0qq zHWw3`FC8z|$AA9D1eKe@q~vDSnZ4F^?Tw=k4rQ}aT+fWceu=Buv<~BWAl~b8HF+7{ z_fd?oi1aMOehLalzy1G2XBp%Ic07q^TCS!y3G;Tof0i!m@c5H3)E+3Eez-@vS~_Kz zzo0PR;~QmH3sZ{qfLHz`uedLbJMky+xx5!X!!y2DOQQ_?hbbQ){fVAZ)Wy4hA}@mc z%|DR~$Y1#rIrRb5<)|ctd-l)5!5)#g7B9oP$TL*`xE4y+C(?U_=-onr zco$F93A{%~y+0Ap@kYip#sbC?#;uGmGwx&jgt4CS2gY}X%k*AmEMt6>aSdYu zV=7}DV+dm}Mo-3lSllCbjPX39&rs>#k8uoR0%Hc_QpQz`8yL4SzR36*<6*{gj6QfE zj9eeaQH&PGIL2ET?TmLbKFV0m_!eUg<1xms8QWuFlUy&xA&g@fCo;}vOk*ryT*bJ7 zaXaIyj0YG$VLZwBEu)?|{@l%W-oUtnQOTp3k6|3Z*qL!IV+Ny&*Em2}G(~{MQO&s$ zg^ZN`jf|BuByY;s^!UYnC93cWOLxd{4a=pxDelVpRd|J_DF$6{Iio4OdA#!NQlF6{ zR5Hi>neM9G=>sUO!qy7ObM;`d{Ybu--syU8tXJeIl2UjlQL zej0OJck8aeE&dATEEab%$2FerN|-DC8=0%ReU!Ou%|evA@ojG5%iQEU+<3VguVAj~ zW1pM6in+?q0XKQI8$aw8zSfN&b>nr+aV@O7dN+B48$aj98<{KnoOhEqxygTblZzd) zy{Pz}%vE`fZrs<6o801ebmM+*yoVb%yYYT*Jiv_)VXo{I?8ZmAg%5G#EG zIermyJQuIKQs!pnRm}aFH!vT--1MAGPsI;r-j?MS=F0vPnd3f3cd>5albEag-N{^y zKPAkS{Y#m*VSVMyReq|OtMWH8@6X}=o|pN@UPRqlm@9c2^T90N$Xw~KU~Xo49rHfS zjpb5*0P_&$fy~pGV?UhkikYkNcq8+6EH7uS#!vV0veGSlEpw&6iMeWDrWa)XlzoDk zcjffl^}CO6?&Fht|8^e_+{Y*P_8-gXcjELD6O*mEwp3+4k(ij0YD>ug=2&x6tQi~( zJU1^DTzMoW=B1@m0QN{soM+9=bLER|DS6p;sy2 zM>u#+o_+Kvq;I$7=GoIzFwsLUF)=^Onvp&~%a*EhC8dIxvuv0al+K)L%dq9y#CXt9 z?3NifPKe(4JsuvtaolvX440i_vs;m0VnGN;?Po9=Wl#_f`i+D7WKd|J7zU*F3sqtq zbkHW8P~Z??z#t)R1KxsT8IA#nvt*2*)rS{c(gM(l{s>fZxk-+=3%%@w_~1 za)xan;*v{Rob1NQq60-zUSW&+x5IAQCqOuuO6TEyGBpX zlQyR;IMa7%cNIJ2GW%E4LVD8edHJwJYI<%?hBd{OY0JtpXIgVqIc;g?zsQQTyEB~A zR%U0GlAQ8C%~DcIc242dj7H_oPt7yiZF%|jEWMhNCPj**xcK-eJr|J6dUdpl=KRWv zsr{>VEi1&Ps7T7r%t|*?8_G?mR*~d1lI$t2l}h<@m)~@Avk*y{)-3CMTk2mK)jix5 zjY{b`?fM7HIj!F;oU*^0on1pCd}?8qH4|MUJu5vg9V5q5o83Gw+iq6vLdmUpwu1CL zm*(#p3VIxk=TDP!g!@~WqjLYjj(?%QS%1$Gf5+;|$rFm}dcTrp3y<)+xvbDYD2Fo)By5s_id&2^EQt$Aj7>Ts2Z+3nUswkt=8 zOh;F@r=%6SMAk!?BeFAdXoNOTPhNmChB+GJm`l1z)~xKT!p!XaTr=v=mYahv&8qeM z(jU5ZF*0*ScYnHuR&oyR0Cjy$9&{~5;oRdZPS@s255-gWPU@PAko>NM6p#Gf5nj4K zp{rBZbqZCwDlNqc)o&Hwm8(1xw#1>zsPqt$ziS*&-I2d?6i>w`Kb0?6J>>72AJ_OK zBS-llr}CxJRqszY6!icy$W|h%AvWGVl)#(gQ1aH^kqODZx&u1FEt!Y*w1H&mqR zHV`5r+dc{BuULC_iY+%+h~O8S&v%u$@wCsSyo^zd;qZ((HIkbSNemb&?`IMiIXj|` z_12!_aNkI*u9oO`P@-jxM3s)8pVX)HI8fz-J(6DHcq)M69Ik-Vk5uJje;S`VSHeUR|py($hOoc$>vl?gycs^^J^rdwxndFm*NuA{W$40;UGV{pQL+0 zI>^5_4)Vu3tOBw4J&9AYXv6QiqG4^#SFJ)|GG`=DI&5Xf}1&mf$ zEFE`r)PI7+68z2rs-6^teq%GB2cW_x+%A0G1nA=9Vz@( zd2?VX%CQZ)a-kZ{ge&$N(+S$vhFzm8uBYo#C`Ds{4$iv8F1 zmn#a9b81!dP%c*;(&~SezHE_pltRU&miPD5FVL+h+c0U6_3hMf<@6~%XCKG{%ZDCn z#j1~_qBKjckf$r_qqr&1K{b&Fiv&R%*@fCkCM=V$+nD+owaw-=?JO%bBAX~cEcgD} zJcp^!LoGgA%txEdMvN=l?(gc8bs$Sjc_wQ%??ui!p_aNBA!t+>>C#gd>ekD`-;8Gd zlyh~iru9)*jx6RaNk0uoe4SwW5IU_eL1NWZzsXG_{$#$E~HQe>KyxG=_e4Bf? znXdkHP9?ojj@$AGJ8sZ1K`|3|gX!5>NShp;w<%n7#58M;BUdi|H2r0Z!7XBZc63D4 zM2gcMM_5iyY<5O^N+EK?7e(4uWPsNJ$m-?H}~$- zw_pDO0|N#H4jvLTbXf545hF)kGy2+)>&A@5oYw@4H5m&Y^X8|eFIbq7nU$Th$ex>* zzj#SO;nJJt-h4}9($(evSa$1exBqvS|Gzu^f7||H;Sm!jO};)dYRc5;X))7dXT;5n zpEY|S{@yZ?Y{}Otac?A7Tdmr};nV&~K`s2f2lR{`~x0UeJTiJX>b6%}xS1=+7pGG+ezY zJqHh)CPXX_a?_>_OHCbCsOu%33OB?&4bDtI3gO6GL`IIu%p5~A%+k%&?@tk5zoUoU zz$ue+@Rx3|;xVI=51g#e2?#M$zpEys`&ycHlX_)*CzpD19U-JXy03QnQ4XYjnssx= zC4ZTo(@&;LGZRif3O5Bg$kM~xFo!_pup$g>i~Ddw;*`TFTuwr&i!k7P;7sHw2RI$~ zkyI5iu)|{DMEFz9O8xn|R?;&W{>jkn^noXwOqb@Lq?75V>uHgXOkdtpE1to&BQEnp zvjMU}$b89p7dbCUp;SI;4v%JeRDNl8M)~N$IRDN4!;njIv5fS48vYG~O;ho=&?P_Q zL;r^0Oiy9xpV{FOx5Sn$w$iL(GCS{y-)^n`K!j=#xLY}L37;XnwZnPgYJ$=Ii|gJXJqch+>g0h ze>5|v`3-Ub%xUd_TrhKQNks^An!6`wVNP@HzS7^k78cVdk@EzDaok7bVMTXmPj9M2BwPF>HmVxGftU*<*3TQe_V z-iCQ8^R~>(nVXnbGH=H`iSyr{c@gst%&R#(K5nYJI_902H!|-UmU&O+Nz8jO&tZ=D59qFlxtVzh^WMx$nfGB{&b%-4O6L8TS2OR= zypH(*=8en;G8ZRh`3EsKF%M*JW%*QZqU_O?46Z25!##6HV6PWukw=fT29>zR`c?9!F z<`bDGF`vXdhxugYMa-{fUcx+zc`5TL%*&ZiWnRfVnt3(z80K}%r!#M49?M+R%ksuC zH!+{h+{}Cq^I+yTGPf|dF^^@wka-gG4CXn^moqP7uJHv(33E^8IozLHGB0JhH}i7l zKFlkb`!cU)Zem`?yaV$_<{g=f)6yQDnVXp7V{*DPGw;bfg!vHWk<7<3PhuX*JcoG% z^CIR8nQvsS@dZ^Gb5G_K%v&)V%r(Bit7PuUyqbAS=5@@y znKv@`VJ^Os<@IH5V&09pnfX}eAwq>9fxLB(gD zrs6X%Q1Js~{9+ZK`9>9=d6^17M24?W;h9&d@XTvf_+S~nL4{}Dq{1^do{{C(M#=Dg z%)OZhF!x~|qQZyB@R3T+JVD9FNqL%*GcQnbi9o2nlB;UEp)n&}5u$Gb8gZzNow^eQIYxU@APd zH{vRNYIl?$6`tB3*-w?9+F=l^sr2W<$|P6zpmrIA+;X=@>ZC8;p^w@ry9CKDF;4__dL(o^N5b{~Y$ z>OPj*Kb4QCUlDq#&TquuXs|qPchoOj+YR-PAjDGTqHsZIMXKEu=yq}PrFwiPr+(!c zp88i1TB$0R+`Ts0QE$}Ws2nQanR+>=Im$^pzFgad++R7(VMpqpG%u&xIrUTGs$Wol zC9cw^eoOV@ZU^eeuI(pTFSj#a)W2QxN&VcFQ-5#HW&cp+qW7PbiGAnX-zXE`24i5Z-}98V$~{YB2NI`c>8A4)BO!^`m`+)*!bd~n8>9#|$#&-K|FWHhJM8V+Zd~IjyG_DaOHSHllB4~} z^L3=7KS?`udM&@g# zBcC!~(JuL*_U24i=IeS#zE!@|_$bHQaF={$;@ZL4b7lGy9qmV^Kg}@?sPvuVA*JtZ zZ!-M|$9N~xcjlM&3{&e3!(Z3&Ef;58%7?01nU86Xd`kOAIohF2C)OdC=}hC=rE#0u z*_G3w5kR$2nNGZ;{m68j{Yj=X(NTU^z0K=2Qy&SM=YKkSl5|q<6cp`Qhch3=JC}iLf2I!4R_S5vY#4nWqMN_<&@#$9qmYl4|CM3 z3?J>1AJTuLzRp4=mf=-zQ~hnKi=4v8x{O0q`UtcM>7@QJm-3T*mZM)tdAM8rSU33$ zNBfZZQKP2H-%Q7OTgoF{+5x3Udp)I-@>oato!9sBOi%5CoSG+A<9#g8BM*^kgr!N| zC&{a8d|ZjwnOH1hSzgN?Nz6ZEp2PeF=0(g)nU^rXpLr?skC>M;|Co6t^BU&W%%5gn z$9y;QM&|pNiwm+mN12Nd zSe~NfY+sFe3Cq>>Un%ojSzgZk73PB1fz-NS70Xq>@ng9shp%P1x~^$pehr_OPD7Z##PUeyg+zUn$Lf#s`N9?a>tWS+)y zwJsCFawE$NSpEd_V&)$(-^hFi^D^f9nO87>fO!@3SDDu`f17y&^PS9_n190D_?xs> zHFH1a>N+`qc_qt3m>*(p;qrMik7W5l<_XNdV4lYO2=fBw?=dfCzKi)r=6jfzF+a?_ zg84S)Rm`7dUd#MA^9JVYm^U%6V{ZIi+T&l${g{8qJb?KL<{`{KXCBG?81n??pE6Hl z{tj~^x39j;3s`PrZeh7v2Q6lK2FuMXAHaMg%hQ-ga{c%)FJpN$^CXTxlz9cqbD76- z{8r4XSiYWlE%PUtH!y#Wc@uMWUN>Hp_I;V0qZj{Z(zB)-%jBC2C=+} zhlem=|&S?U<`|RH@_x+IST1MHP(J2sSRTpY2Qx2bc_#CX%T)}iTPsYMj`h>Jj%S1 z)9cFIkL5Qp7o1)n<^e2EWgf!(4d#)|_cBjlUd}v?c?I(V=I=8vX8tboD$ZXw<{Mc) zm${n9KgGO^>sWd1tyTINqNZ)E;3^J-47J9B&!%A(=-Cgy(3Z)RT1_8G}MfaOb> zH?rKqJcQ+|n3uCWgn1;(iqvGjCx1y_i?9Jc)S;>mS9uisg?puVelX<^ddjAoC`cr!zMi zWc_3__has%;xj+VJcM}(^GN1fm?toQk$D>P?aT|9Pi9`sJcqfQm!&7SrIYu$R@_g! z@?^~Jy7E+BMEyMPFJpGxmEgwF6E`!PB|Nx;xZ2?edON^$dv|KhYCXOm43PYqE_cS%{@zJ*$w3QzMf^mMl?PeGkE=kD_6 z@#&dv*YI+0Hu=c(ob@gFd`JCBp5|ybl4s&sb60&?j{1{wwc4ok=eXFD$|LudJJZi` zv|AaUX2o6g=ex-lyXd2Nc6t|#3Qy}Eq(wTp4wde(r(8EwtIV{{OzU)NbycoAlf9Kb zIlt;`KZ>hyNOJnC(xds;3`cvE@=UCEN+;JrocWXMG|ql0*Dam<-sSp}tDN*xzm-nT zYpYdkS|6tJtJQMi)L*TR_AA!`)#|lePp5G~*-Nf-IQy&Q^jA8$4}F2Y=bwD!`q_Mk zz2th=LP!6Q>q^f2t92jcLp%stl>OxT*h0rRF4q;+DmtyF)4HQtU8nVGTAy?FN4Y+z zR?$gL>rN^);xrD@U+Lt!maAO$H>aF}IyA9<21K0K=*NN1w1d>zw zuHi|)b3Bmic+ULDb!N4Tf!=#V?VX;WkWO;7y8#~*<#jSOVkoY9yyB`y%5`eBD?;vz zkZ)a(`sF&GGe2@2$Ju`*ca}$T`m5s8`ls4mq1Kh@O(9Ay*AJ8in$M?mlG32oM_lE! zUg9bzi>e%{^#muUb#!`5hDuNMAA0)@?O~7-xxVqo^P%+5h25_dUi!P9KjnI!N}b9} z?N#NLIIZ{6TQXFBC=V1up1I{Zt<&D}4KuEs*8SD46xzQ*rFXU;xetK;N+;Ki)ovI0 zEJzUAh#EiSK7ky^`CG0d%D=AmarJjCuUyw(j9f@3*WaD_k?RFCp2!i#$z=~xT*a3> z&5<9;>5U-LNuKK%A0*FnoImAyzcYP~CPaO!c!N$%DM7cqi_eqk&hqs)d6TOj9kSV% zsP(7a&%C*9?%wYQrO502)Lj=xdF`vYXWj!BI*rYkDC3wuEwQa15}tfSo787hmjMH( z(><%j@LlTd-rDEsPsf|ay>9>U^xC{mH&nKMs^__kPXkSdzJxZ@UA=CyPR~jY{D)tU zld+zIM}0Bu+kvqu4=>vPROd5O)&vYScFE3)>Xy}&tZf-F!1AnTti9KTj}NXN^sf(Y znzv!-*sY)6`m1fn%wtO)*=jDIdEw1>p6S1S>a>yPo&W-#gpvzkbZ>(cX_3 z({o;b!?xIbcHe+U9&4E2Da*UlV}pMfv8cn0$TvRRdU{ga?Q}P6`d7jFUksIb-R~7Q zH64J{`DVo4n}eDnjqSeeaYN~^0gdNBnDFG#uBD4UdF`Hw>9=ZG7fg@M z?pBz;?S3InytsQ@e({QRohN*-aLmq?$L@LDIC;{vG~cH_zqoc?zvCUwr3DY1xbxv} z!W`F+u}nWX;h78BOQsF@@_8R>Wv1b?p7E|p@O|q2 z0oK{~+|gsfp7ZzQFK(DP>#EN`I2LnvW!kJQH>bb2a$NgMrp!F$k)}BhJ>zrfIqe@$4VjYu;G4Y$_1O3B_L`4t z7r#6Dpzo~D)|EW=?xwQ$r}p<-+}PT?xa^lalmD3C+eMy!c1_9+rmx;-XqU0KfB5PP`yX4|D);$i zm%Z)^iYQOd9~?B~&N)w+zVpZ1{+7ObI=P}@L2<3=^u`aW-k!D6H0$LXst>>MTf*=a z6&_tDMSEPge_Gca;%)zvmC=P;iuR8^81%xKraqasY+4!ekJ_$B1O~ z_4WGDA;gw5hv#Nw-&+63SD%i(uq8Wr$&68}-)XpE@Uetr<338bJh@M&Wpm1I$p31< z%=t^Yq`dOw*+idQ#Ah*E?$7<)yZ+H{r_XP_xzp31?ArBnn++kkYu}1Gd*GqLi4RT)Y5Vg_ zYt0?6EjV~Q{NSEreL_3UIsW{r#M3`5S^eHuPuvtY%wzoYuflzxSD3yyALl*k<`dyN zpBp;rr6;nV_+UcT(tw@6EZH-)x~gV=T~pa}^T+Og_NCcX8Lb|B>_M?7@}}{t-k5TJ z^rvyt8a`k2cJCe+yq8a!vY>YRk!8^*jE_F~NWLf@S1;%EEDszueed~(J=M>5&**!8 zd#0e{pyy}&e%(W7`*#W+9Nnso$Ck0xaq9HYVrY-?n$x z&!2nwiJ>ocjNN|UGuM3`K5D~5Pai+7T{`q*O_8Cn^jc(Hd*spB@1H&T?vQ84hg>`D zo!sjAnP0akdt^q_4<7rro`@?Q)7Nz5>D;>}zWQnVk39VD$$4bV(YS`V7f;9h)}`gJ zr>4De;>a^T)4xf+_aEnWf7shH@36R|)0QvuPaXJS(6Bp~lWpp|EJ^+Cr$dXzFD^YZ ztmCcoqR)>U`hCTZYg)JMkiI@Tx2)}eBufWvoKNwh1HFTuy!N~OpRL+C{9oZ=(HB0+ z@LF9}p?RHL_RT|a`>cDDx7U7l&#|vZR#?*-*T25$K!*h%@3}8XZ!o3~4WpO7^Z207 z=Y1wb{rJ&SPcC_)?;G1z+_d$;FuUoR+b2HuMn#9W%3?-D?|*jWG(+o|frd4jQ^$`hHjFbIyJ+Le(XKN(YM#k_;PsB?7eHs5{8Wm@8!9=ljJa2LAiQUO9U^i>|{BAy4P2~x%>an@)Kc6sk^Ajf@d(nFGXiDH~o&(lD@^OxJ zL;q86?apu2vG`^3ZLtDtPNFCYS^Al#UDRBB;wO(A;Q709 zCip*gC^M+R*YDOY+3VA9IWc5SYUFiW9&A_Fc2vT+E<4x%969jyIRlmr{cLr9X-U!8 z4ljQmR1*17=53z!{T`0h(^P*9s7eo92YGr6&9k-8yxI$`g`Y6A=p_s-`wN3HNO%~p z5gy*5!ow$0c>2T%&sH}JPv3Om<(n_OTCWgZZAye!+s&dy+vh|J(;K2iyN^W6c6Fj< z`yWKh4qlqEgP&&X6r>qDM`+%iZ_vEEp(l|nMn2G1%vM9gl>)q+?Cv%Q|L0@T!h22fm@>ZAU5zi{c)9 zOXq{9?b9*%^4mJDeCAzUeq-Ezo$vqgJ)Qq@{{fx19QdJ*e!D*+tnBwhwJx7K|Devp z2G!{NWP^^D=%)_p{;RErb^m9(eXQf_2Xz!xcYmVGk6d?zP&9q5W6{V>wK`va{inLT z?~ghboqO~%;+9_~eok04?W~TKzubRR_rEma3qrBru#T4Sykolm{q2wI;S-+Mu{5rK zo$eoM*Rjt2hK@x)dY>Tw%DwSAmVWuTj+Vp*=^s4&B+11sg*w)qsnpSYq~$4He?W|m zm38ZMOfr0`W8M8d>vg@WtvXtow&^HpztYhh6nI*fUs$N4#qz9`8{Zd&N$?-Xyo>783bA0BofeuyCz5b>P{SPG03yqDuFUq*-#?U2+lV7<0%goT8cmMK_?*F_wH0h!8yVDkg zhNga3{&l{{4t-?fZ!6lj92r{k#`k+8&L)N4IrpV=EuK#dO-p=f{FmRygg&{b+iwvM zO%B~KC&qHTM@Hx^$)EXbUvCLLck1GX=%B37QTIQ6=Hv6pp>NDRkhOn)YUqvU##dW% zvO-56TM_=|8}maa6rAn$!ph{(ke}>bdak@NbnPzxH%!x0Lf4(`eCWiZnW5qPp6(hr zJ0&#Q82Qt)C*wnx?ys7A`rcT!LvZMu0}cNQEzbOy}&V(BvLr z5C8a*Ep*n*pKl0Vm=M~2$BD0pM8<`VE4=2r>we7&&B&fVoW>7&lOgSer1u>51JBR3 z*+-5TnyS9*G7WE$#`hh(zDFb*8HrLG`z3Gj=3FjldX6=WvV$Z+l((7 zWSMORwv>GRgDAQb?`O=SuceTD9$s5ywq}{FIS81FIP}((^u@NJdPrwD{Ywe+?Ae)! zk)cmN^zBXWvY@@bk;rp`zUNV`XUAebA{ymso@;vFN4y?`-UUf+N_Mh21*++-lID4O zrXBuxA5*qHQ;HVl+w6t(eH9Kv@m%G(w!AzSvB~>}2UbDB^IlFoR)*?dh$)X4GUh{-&TdYVb3-f%Ccv!3VM@=(qA1V>7Cs?D4|&zz&)Wloxg zA}0knlpCg}Z^v6llJzz=46-c8tho@A3UcrsQQ3lI3xVEDd~74tj8;OXgEJ)=S(1hijOd@EFk9#0LpJ7t!}4?O!;;gphS{_=cZ;JnsWL^5JUS7`H73u*d)8E1>`@L%s z^s05*AsgRf(VK#67;}Cu)!nT4$w6}E+cmtN^1!|W>FXqVDX0~>#zqQ%4BvYoOp90B zE+NGf+pRh1+4^I=t5?Mz$|2jIeSSVwc&<6XwiqK?`aH8OGbgWb&|jyQY%{CD4&U#g z@1)oqjhPy(In$Pzjdw?p>%+aTkE0)&ui&Q#75?47)dyQ#2kZO8i~J0th^~s^l#J#D zJK{JB*-+i@U#r|5xS5k-)$Aqb%mi z<@&o?<7Q5rS^4PphI_|%j9UHuJx8{6pEa0@95H6@ES%bN=g!8fj|=DGRmk+Uo!q&( z>Gb)X#0);~&JBy3HhR?DID9k>-}{-nWb~*Yt37jQPO9EOpyx0jl%GR5u8)Y1#!DE5 zu?@y%d^(9{vyIri5t*w=-Y+wY!p5%E1ih<657Q5;rlp!_LYoP!+5D`XtjBbA9X=?6wBZc#8<`<>MHM{wdXMmd@oy~*c=La0B zryHf8;3J!d)6bZKfbnQvovgS4kTFQs2pn69t1nct1NzA{(8cp0u7 zetJ15ZoCXvN#QUM3@wo9Rt+@h-@xNK96@FE3^3^91pAF7KR@`n)b%Lxqwi$DgLw@O zH=6vgcpyx;@f|AF3w*m*gkU4p&}4qkT#i9BV7eR4Q7<Pf;3pV)?042R*A+1lBK?aO%{l&Z4~Q3E(~Tl||Y;^`~m@)kMYR z%a>jJEw298iD1)-synL;cge6-2wM(QoHT@2t|YAk>Q8+Ge!^0jw_nmzn1e8$SYCgs zg|HaCghkZX>)+Zip17kPYg-mm0Q^oYKdjXwA88`iG?(}t)hqhJL*Nb%rVz2PZUK4| z^*6$D9F;EI2fDGOB9P3fQ6h(Q>v1*sC13)uBTlCUh)dYYC2V*6?xLq(e`+9p_tAg% zsqc;7o%r`q5o^@*cvqi#$`9#G4TnA)+bBQ4aD=~((nm2`;^c052OMjWj&b|0;iFI<=)YSS4@y1PqU2&**#rR$7!iPEHIok*2Dj**E zah&7ypxa1uP1GKGUZG6ovxImJhbq%xv_n7LzOo#!g9-K3tQ}H1<+vZ*heO3n7O{SD z@IN6fi5_&y(T7qXn|T%42 zy{w_oflrj9KUFpBKL^&JKCo0Zk>eEOcc}}%LvIgyYiL#mFJU%P#|(sC-9C57POkdF z#En8E;ZXK?T3Gx#Qu=q*a5E3Ap90%X(DNkY#(`h&!m&rwr279gkOhLq3I>5ZmCFkonoiv1v=U^Y_Q65v5&EM0&{#NG7(9PvvDt9p0sdL#2byW|`Jgz4ACe7JRfzJr6~j z4%B&{`c7_nD){C==^rOBW$1gG~NH8 z2c>c!;uYy>I{Q&7{Ny=FwVG3>KEoJ;Di$XW{&6f1*U!}koC)QaREzO_ik?Qbp7u8C z^9TRf=SQH=;k=CeH}7-nyJ+G(js&h}oTp6~H(?jq9x#SrOlzLr>?^dn9_=&{(q41a z&jFOHlJwl+v=KgYX2LnoF^*-6VDpI@A9coBt;)0!W$KRcU7o|8V`S|RO`O9~z8(;s}%-M+Jwyb0p&7P`smC8;XYBG#si8VoxNl zNu2p>9HohjYcO_kzq{IakT*dS*y<7&n5mz8l%xReD%6& z-ZqLOkWU7GdrQQcajkpR_;wMjkL@aa48l*O@JGE}dZ+A*bgk8u+Qf2ao3J3AJ8@VZlt|a9 zM#M)J_}aNhXt;QWzX{jUqFy^km(l{))F#{}X}AWj4~GYxW5_>+@jN5E^m`UUa>gKo ze!p592xPYuewDait#I+HfL|&6uH@)`hg=`VF^utyIgGb4ZeT29tYAFM_%-9NjHV&1 zpK%0ZIOC0sX^aJoC5&4cUuN9L_z7b@;}4AQ443J>%vi?wDB~K&0>)IvIK~jhUW}fM z`^eUC#~9Bu`V5u+{TRnECNO3&E@fQBxPfsS1F&<_-$LKSR?Z`Na(ZU$VcnhPQ z@ovUP8Os^pVyt02#`ra3`(T+~FUBE^V;Cng&Sp$wEMQ#4xPfsy8M8IDoM;<6OoJMisBxfDdoYq^acmoG7e=%n@fi@d2<1d__Jx z!xoWe&xn*O0%E8a{3!@8m0)E=eiB-QdCs6!lPk(J31{PTR3d_Y8(X-Sy!m^#oi#!TDEju+oL;qG<3_dc3JDZ=$ zHy(4hGHI;TPs`89OAjy1!zak*q^H^<(yVszv^H5U5U-aZo|WQ7TXXaDMK2-#W{?!RNUVYbGY5Gi=fZ_zK!e5s{IdYvT-0rIOCfbL8KfctpP4j;ZB| z>2}QRVI~-qv^=ZP$K5!OVmj%h zug1~0!o_%E6g>j#H5^5VsgvSjCPk~2#Agh#Hrqm{4UT$n8Kbgt^7EpwA|$Y8Bl9%} z>v-8qCKb#PyYQ8QT&x-uN-y!eAvQZVf4)vANenmH*>r8izsrJ%yG97A<=zs}<@ zJ-%44!kJhUnj@xb_>dg_MQT-4t-i+;iO#gP@NNp08((MC$_y(*;w9UHM_6Pq&mvXoXk)QV3M9d=R{UO>7o^jUn zT$`hS*l*z(2Lq6K(E8naYM5x>Vh+|k^=cDcT`aAd+Pz-!yp-f@eM{V}Ma@a{B@0n9 zvDxWVP-IeElIiKA5zLDm%-3_n0~BIS^g#9G$d4XI>c4ekiCeB-`mn6jnK|iMdaDtS zd&N7xnOI7{9rdtwqPI5vYmL+^;j=`W zjE13)8RAy`_vCbZ+ls+Jz#bC;wyyl3zJfd>ZBGOa!evCDLv6E~Q7J=EQhe-SM zNz>@}Ufp7`G`@;UUTUC=&vuM{B7{Oua;|O4&o$;EPdoH+R`6J}DGe+VuQ9j4G7Z4|zL*RSCdRVb^1ICi7y_@Hs@>v>U8#(IAZJZpoa$w@xjgJnt6wD@d`&*goIa%teLMS z`S<({(0k>p(SKjBylVNs*F*7f{jIN0{NHQ&pBMA5zD8zna~|yeqa~sCL{7yk5u=(J=8O{!mOl&s-z|5~du-H|^P96*+M{uw#JVbp z?(zSMmxfFICbmn&Uq$%0<)*7TsoH#1_irctKSIIPKg=n!cl8fP{*TE1e_1B3+AK^m z$*VRC^M6^E{yP=_Ki*6ECQ}4 z#HNKufpx%bK-x^R16T?4?Q0OruvpL$nABN_9zZPUhH;2jQ9@b_vE}U=Lv95FvsL zHiH?9g+st=F(iy5e_&TpB#a{o>x5ayA`t>iAUXRRM+wmr@&I5O{Hw6INa5>%wcxSX zSw#6N2i6n67WM#|Lxi{v`AYy!0+s@!fDJ&>N1If>5Xpv+F+yBJ@qsspBu^7IhTjTa z25f|$;BoYBk9ut*Bdz0ZF{FEzh0)qdooE2|2b#jMMvm~+K+0bOqd5ZghWfPtJ8AV= z!bE``=T@y6Ncr-cME0u_IlxR|Gt>ba5I$)#($$i+s_QYnYiB%)qp-#e|MIE0_eA{^ zMaz6O0AqV0UF;1xP4yOoCIU`-Oum7>;2A=!h5kxlZ>_=56i3g-*K4ISv1b6`lH%!| zJXWm|_#o;rVHVmC=>ryu6I#M-A?m;raChGbtOd44z8Vrxui7cid?VInpg$6)hA?0; z(9ho>OgCd499VjbY-f>)5_3|xoQ$!lLOh1_jq@-IDN+p;jA`>xFNS2TEM15}z={lN zmsZV^Da0HzQGJ}!ENiIV(Y}CXB*)&9UGPsUk?pV)SO@=# z2lRerFs;LLPv8Z>X^2+^3`2i3K8U?OX7q=Lgb=`jjY4>%pNU7PKO}3#z!@k{?PK(= z467FTxDXF(^@h65ScgOXSC&#cPu473sGeb8;5g{1+loC-z<_PCUl%df0oNj2!IMJV z2Q)rKdToXR;LXri3oJ!Ezkg!i63~LZC~3r>7Gf^282B(gidME=wvz_n43tOg!1x4t zDR8(*(yD>?A-_4;Z$jm*2G*0F=dky%H`*)kb&NB#02!sFdlbB&_d~4_7$%YokuRcM zB3=QI`e6xh8uZlxso#s2qfYh!VfRW&lyTCoZ@~Eo7 z%x{aYJp3wUzbOC?Lby`KDqt+a*X^P9lVT`;ONj5$e@piveZv`#%6DLYE-|nVRzFZ*`LaQ{V^_8 ze@x>7>h%*E&#c-;;7=mmqvQyMOV&g!)myTb!&nEri`w6(WcPZl2}t1^KcjKtlvegR z=|j3lvEK{%X#h3=%fG-l-v{+}jPjFY5XY$SJbaI-=pj|lo$RvzoQ=k(=MW2 z8!)b2rux8n0<$n*pxlkXwKR@vns^=Muo$qPgu;7jVkPX<=!HEK;3X|Jkpryq##%Tq zp%wO95O1T2Dqv$(F(RwS>RGp zQ$dS`ZBn^Vk-z`ys18~3oQk?lj8I5x* z-=MyShe^vp8p?iv%YpI$?gw0M!aM-JTxn7RP4S(guQFl2`OIYYG^sn--V5-c4C-%! zT*jIlD6heMP&>e+?Ly)}6ZHBsQ#s1FK)0GfCS^hWw86NK{ycD6Jp%WwIFqsk_ucV@ zZrYzTls3qp&rlQWK)p&txf}My2WL~_a6c2}G}LQAS&4T3I8$OC2zf+FyWu~~q&~-e zo<-sO?SXS8PlLWSD1%Th4QEVju){v1Ov;YyrZMOTrT;jn1j^X)pbN_S2__ZG=QwMU zhSDblXVeFEg41VGQ&2WcGO2MWVrNbsx6q4VnT3Jc7mor0zkzfVkQC}UC2 zf0_yM0)OL1mYwcy68vzM`z0XHv^hCf;e%cFThD6~G@p-=ycq29z)3 zxk>__DC)9bE?zK1+>HA?3vwN2_=`3=f4T=QJe7R-O4DEXY{hWqs1aPfMeOhM_6G99G{N=$(k6fUV7v>x*v?sEi~ zUJKhdqU?gw4XV-=r5WXUC<9P-Lm7<{g-aqYFu%5QKLPhG?cC?MneE(Xr)7M2N@}@L zd7Aq*r@3E$n){8Xxvzdh=9Y@?r@0R|piOG2-{zX;ONM>h!d`F()~mv#a7K&M^c ziM_Xza=4xB)@?I%kW6ry25q)+1)r=M*C#JkI+EEZ)!&dkhId3ky2 z>8GDom6et1z4zWzCr+GTY>J(t68_=>^2XrI<~^1RRnON}u7t~h%W65?Y`L&`<;vBo zS>dqkX|9$%$MN_zT)W}oFxujJyz0DO zS?$)u_6Z5-pDC5~_f#h&RAYR7t@}?%Sb+Pelgj>^@tg^DbbYpGT5ufK%^1J>Reg;? z*nb_z*XcOM7kRK6@S(Sa1j5%`{Zk#TjrDb6Vaiu-zut3guPJ+~QDY;jqyPLzhXu4$(AQ0GRolIa z_UO8Nj&|P!kCP@ezfjk&-t%_$&3l@ft1Xqh27Tn$=@m`Q`Z4Q+zK6CniGHl<&n_BT z9ut;VPog)FU^@M^`&a|tW2%%YzegBSfESpjL#-yEgGjO`JDA!+p(Ya zaw_hNMVXL0BX>jYiR>wqb9ZDj^4a8k#E20pDk@6dbkj`=Uv|>4LBO?)r>Cc@f`S6I zW5*6HPAVwE9oxTl~AElD-KsA%wMch!J>o;k<^N> zV;~9hQ@=YJvkM|ggGF4<}jI6!iyW;lgF)CHE zD|Sw2e@|~>|EVJ19zR~Dv=rZ^)LKtZaqs3SsnP zuG^-80|zQ!Utjn_{%ZXA@hUhtSVcrcXxdGiHcic#F+<&Y>#gd~fBv&tJ7|ubs^pcxfJipgZ)^uW{t8f4^)MJ9j~5TJ67F2H%x7uAEF*w9IPH&8l;|GH%1j( zBGjYnW~rw#lhmu5uU9qM^OesFqON{X)Ua1Y1->k5XAntQCqfbQC6!}<>cgO{+5-M zshvA_YFqZ)bI+;$FO{kF-;3JWDC(70UQw^V{9U z17+{g2sxFD)p!}EZkK6ll`K)2lA(6Wc6C7Z(u8VOT!Qvq(U|{}um(+szh4F)AMNKh z!WWQU>H)Ohg7zh7Uy1hn(Ef9m_Jh!#`!u&D;r)i`N^L5`-UZsf*odzypnWace~k8@ zq5UDWKaBRrT-y5$!u%EtS-%}V2lhY8Hes(G>+HstpoIH+DXAT%I@g7#i$?~nEq&^`+7(O2U2nJ`Sr9n+Njb%~OPGnDMwuH?YplkHUx6|FAA8wdKq zXYz&Gj#AZ-{6=`t((5)Q!;+LtyI0AQElM(;P_n&B$=*7b_GYvnh4xd>eiquNp#3Ja zx1;@&X#WD*zlQc0Gvhmi zSs^q6kMTbOA3{T8du*g7k9~KfEI59ZpYE~FH(5s*Gc|=rDaAa^u zXb9R9vY}V|`c81d$SRRhkw%(yxyNNOLs5Y}4Djk_?hha%*nebXL||mhmA(6T;5jPz zI4cZ_LHod9b`TO7b9wLHeOjJt7zcQn0c1pL|1pvDZroohv*>;s>O`+ z00_JS{dE7s#zuj}QDKo$8VL=fL4Uv>6FMx2AVfw*#q^ytsdw+*K%(_|%&7BXg8afT z#0_|U)uc%p%PU%+hxF{)GoXimSY&7vs65G2V|nEyr+5U82@bxtbI-2+fiY1rQ4wKL zEl|RQw4{iT5felFx|q(t!TEr+iU@_daz2l_&d_wfr1@U=E zAjCD&Xb$?3J`k{=3wrgK8WR!~I2N+j`WVlR6z<;Zx~O2#F~a3B=^v_V;Qr|0A!DH` zu8(#9;BRCo1Ti9PN7b*t z{;D#Li`oufVec<4cGj;SCc4p>=%APBvoX=F!bG>VQLHqmAekE3^Ity& z8n~&-@bjJM2N}s;orU<1O5E`hVYZQZ(onT{f2nD_vmpI{NX-cJ_84O z5A^Hh-gEFpxbEApzqdE)_Hy_1^Y!ypS9lHa@w@VTzh0=& z!)*2$;^*dep%2;&zPQIleLXH4;&*|Y+xgwQcD-r+Z@lq_V2@M)pOlxEYq+t8Bwu{-h1As4 z2=)|oJ+^_5!26%0&9?2^x378Xsi)S!?F+m6?z^WZB_)M!+O#Peel=kmjO=^aWtR=d z-o|a$UVANR=Mfqj>cf8V`FFwpN2k?+6%z6o;o3;JyM`RAYIhaZ0U@tt?xc^Y4j zufteBu?_J22lQ1t&1#K?r7v|?#|<~6f{2TQ_ZWWX#& z2G7OF#yz7v7x-U#>7|X}qZedi195rr#TPXWln?AT33-5hCM_?7kvah#*5&^F`-Pdh zL4L5Leo%MV=FKYwABz*Wy zu$KaUXdGyB$OF=q_>dQbouA47k3arcXMQHlNpHeSSs*TioAjrQW_=?P`mRXOK9RB5 zf**~T!SE{J@UqAd;4tWU5wB-NHhqZLKy&k!jsTB38h+S%F*4ydvcU_ZJQqEo9#CFx z`B-Fftw_i_pg(Z{4@SKyaxHLJ^d90J&DihWE8_ox7Ax#5b}041J}G5+V74TpG?-m>;;`>w+0P7gwfc<1i z0$zlF-hPn*&$XyUhoA@jF=vQj|0(~NkA&Ia2TQ_l$T{Vo{GeP>HVj;-)vX?!5_MSeRA=s(A8;2JCZc~u*DhJ;~xn=Y@(jg zwzP)_<=vGhhFq~E{rQ~p0^8EgxTYDOLr00jMa|RCo%;vg#(9HeI^c0eI81i z1e-b#HmM(Q@GNh!t>|W58yqzJUS3|U_8)UR=lS38gZj()z~Be0BAqP0vmbJj2 zd{`v*Yv9lzatm;vKGP;e!X_E|OdJe-CJu%^(mtKmQ17Jlj(=NI@{t(iC&xh)=s zuDIgC&%}Z0snqM_iPdAI4o(H@-%SRxps_{tsW~yz@e=^ z{}VPTV_~ptoIg?0=7q@Jb3-I`PN+P%{5JXcy&547u0Dp=XV@gB_TY!T*YXc|HW7Bh z#gZ@)Zt4T+Z199O-qk;*KSUfU|1YIYkmrFzIdIsq1~@<$sL#ZK`b?Yj2<$3xNGA?= zPL%r+fkQ&5teq34aUh)ZF*rXPKE_DQZ%Dt9f7%Sr!So}T9S(;S78VNqQX?DuV0k7z z!M?22JRT>z?;b7Btpg6wg(rbSsZ*b6lWfZ;$kwG3Br_>c9$FM6n->JjgTUcl;IJMz ztN{*8ZGDWtKsS(nV}A%gWI@Y6T{cRXY_vvKY1S>9!@?;ety38 zz39_me?V5OSka2ZneaFhPY4ff(hl0Bv*|N%U}}ff?cM4_I^nF%ZrD!o_V$*Tm>9v? z4543_oSZDnmMxQw8#ijb#+Hw^JM@Lx!-cfx+(27JUx@xF*8@z{=jz<$()=^l8`&%L z{OsyuJmS>nbm#(8d%zm^uvgI&zW&X)*6?3*%{8NNv}e(rIdi^-AFcV2m6at^r%n}| zEt0?e?QepZl05X#LmD2g?@4dsz`20)1m%jEYZ&4{drCRvTu2(d{9vf;%Om{99!A?w!cJJpBjR9W-Xpy!dtB$xw<9m857cR`&)@^+XG5Q9lU((A&r{pz2R>%d z`b_0@*IoAz&h+Sg5RUECWx*Lm!I>n%o|X(AJXqjcYgh;e{SDVl9E@z>!IJ$kQ>Ki* zXa>BwkRd|^XV)|zIA>7i>H8RX5MIJh znJ1oH8?dB4P)Dc_22WU02I-p^a}U?vTt7oze%Jmdb&K*3S+e20*a7M(BI2@o^=i!r z;y}BKy=9p>bEdve9uNm369;46%QYo^Y|1_1WJwt!ZiamEK7A_s+^{8o$KKN@oHN|a zHN?5VPq}BNEOEb?I1x7PIpge|*58nj5D5wj5}Z!aeBg7oF>qjM$d$npLrc?di<2o+ zrfAthOkTrJT9f9)g>X|3Xn%O0YXr&cfZqan(=xz0igaduW?mBq+ELP! z_Wy||o{*A~5*;8erT0j5%^OV1E(!?gP+_dvr8@(}(cV|DpYdK5pVQ z^^GNAA>U~iAg9`wK%7L|R_MB(-)L(n-;_DRPd%Vsk|&fC@__qUd~PIuX20YS`N8=d z_~rm^+D*m@JDN27hMcl=m0{vwWWq+gC_~hR`|i6>V6%ktv}+=4MrIq@8QLNy$`98> z%!HkIZQHhudyH1Rj_3EnP8>D-hW`(GZy*kaT{Lhpa9~M#(>7u5*6Rey6z5u3`Vv-N z6Mpi>@F5u2q1;oJNOS5CY(^&FI2YJk;dhmP+6Y&Ew8s8P3K-i7=2-ZmW*6BIJuHokx#`+g?&nC(x=OE%i9VDG-KWOVXAGz{`wB5C9 zmpuCDqgtLxZzB_L$_{mheiN@LGwhFZ0c>U-UfFc6bSLageF%^1yh!+sOdO1SCZ4bl zoQc-`P{!DXxDj5;Rt0P)aWPA>?x!9SL5TE)^3_*g)pnOOpuSSx2|x7!@@U8Ke^h2%G3Y~j8vCEH6RrC{#DQ}s{TJFl z$^qvi&Yh$&*PNt1`9NR5-~+E|^J!~o$FQc*aSh=7pN5@yX!&=Qjka=bTpN1pT2j_| z%{t@-Wu9~f!o6Fab4*w>;FiZ z>V#8TN|Uqf>@2%E%bw2C(^&>O%T#A6Ev1R258yE)2O*#1Ijt^eO8=Ib@_brf5u9F! zj9qX!hU}Vn&4^0d{XlfrZsJ%TSPS}N&X0_bkDmsAKNNfZ!MN{_OrQHw$ zit!!B{TX9pIvw)3@5wa))}V{9UbvIkXwt-qzxJJ4dTja2c-d{(yJftO zv9cYFu20+j%pjJlJm~Sc9;A=JOc6p?v35ne^nGg7s@0{M;FY!+?eSrw>e6IR8BR$U?oR z&6qRymd&`!0*{{kuCk zH!~YB(B~jc=v$Yp4biba#%H*X$i%Uk8GB{?m@z+BdE{9Z#%LJpV~mON==;2GddwJ~ zevlDglZ!a#YP(MBF|eqZYZ&(csH+r;TS zIX>bkaoAUw;R*-Grkt~6V!Vwp62=P|r`q*!(ph7MU;Qkyv<@*(z`*l7)CtCHnGF2t zSFBpKYEf!x>YemKnGHC&Z$eryaetk$CdN1zD`T9A@eRhw7-M2=gE2D3msZbi$^TkE zPY8pSN5ox?*f;xg9iKLUnZ6CPD;$J{{NH_FpfKL`1YqEvCilh}W1&1U&c*l&V~sk- zx3bX<3R_cR{qmBLmVOw-@BYaTfp@`{d3|?SV#kw`?BZhxFO?JjNLM3 z$k_8XXS|R)!T1Pcg%-r93>t7SR~yaPEmEueQ@8Nl-bJwgcTyK=cepO#+Kx1#?IAsm zG`ufw{3BY&3AjH^d1MTqd((zaFwVqSALC@HP8c{?bX`jv{|=1(;c?z+wLzZrFDZl6 zL;CzI2?sOj!Av+vC-UJ;Y5$9*I%djP-3GwGcxjvT8~excAAIn^xW^xVdl(qH>Px{!{uULfrmW8Cl=FOY6-J{** z{73swSs*y_LhaJO9JB(%<&v_=rV(5*SFY zZl#V*P|vUUm?CQO(x9Q(bihzH`Bi)YQ6^%}mvE%WEk*ZaUYBdPZ;jI|GGPI{33T;EX^ zNDso_HnC6C+XvZlooi1SpBIRWO^4p=bs*<@#$^~=f}bTg_pR|Z)?b8!ne-qWZFxiZ zIB(H*a9xV-MCW+) z>66h%GfK==KZBlkp|5R-SA2`HxfD2C((*?gWMA~{NN?`tQUuIHj{8xR8(xnz&*}3IG$_$NBlMp-=mwsvDqj2Oc?N<0Kt0&FIy!4kDQ=#7u9JXN4j*d-Tj%EuaOm30ZX@v!2n$6HS-{anH!9_{=PpcHY5a z`OWus&FXXsXSLXOy9x3bvTfV89f;8!gN^zQ=R*FTo11%z-9ZfCF#1?rP*9-nqfVFX z?Cc2aXTMNfT&($N%wgm+Z2G&dgE5|l^UvI8{RMs0L;j9X54kp`yp~`MaufVIo@)%m z+UhZ^1CgFG`e0qkG<`V3pD}cbwk!tgCa#&dhp-QB%?O<9L^Awi#rOfoqOQ>{F;iaI zmMIR)6Rv@uYH`W*J?EdJD0k5|QI7~KeFw^R&2x6iSlr?p&UUWfxPIjNm1_mARs6A5 zdIWGW*2*+Q<13Yp}-vGyC9LoNF)cMR486b!Pz9o!q0QPer(Cx0tww z;Tr16e=ZUB;hMgNiRGRS_Yt^eBmKxH&O!8pn4Y~iO#540e{k)=wGVw=t~ZLd+%N2d z>+o>ELH^<0Gdj*q8%8?Rzig9TmhpN$N#C7*JJ$_dJFSVItjD;iPQ-zAExzY1si~>@ zj0odun?Hs@}{Voqtxe%5v?3U)_Uot;^sJY6>Gus(B7)-_=x(`@GZF1zSA zu$l0yz%5sN{~F%xXJ#EY{r0uac-C^ocdvE98;y8n)^A?x>a2+?)H%;t)2!dR)(!7g zqq{dl-K1jhHw^D#xe0HNnW}EUbp-xS!e^%EyBvmZXwv^^kobvZARi)i!9Rd?N=kqi zX+nR?)KYx+dXbuo-sY(Vc=uiet`hhPVl`3M@mB%ZF2!%c!}*-0H%=qrj+j&k>MX?D zUE)xG6`+aZJD&9zH=!p!VQ*%H$@&v3{{>%dHMNc%iu=i^ zNtluV+dPc1s6%~*;r%%AXt^A%;s7VdX1Z2&cjglK0kV^P@7|@X%ecUlg$v9p@LO5H zU{UgT@8wGujY*!J7{4$s`I?3EW-ncwyf|UmHM18l921wkaOjF*-e&yD;=Ba>a^DQs z(a@FIJZ{<2<;nU-9-X~;ou#+oUb-DxCdbcSj^BY><-Eq7rSVIaW0d$g(M#v8z|VHg zjZbcU==wM;1x@)=dQ;+8#4j)};NS7yamf*jRxF+$ztr2jd|vSE+4yb5@!kn>3zFl# z&3>)@jPpDFDC7K2foYsyD{^Q)&d;D5F2J4trvFbUV8wifiJ~dXE!&*!lkJ}!kR6mg zGdngrF*`jwGuxV7mR*@$lU<+Pn62#YcC+2z9%PTU$J&$Z7JItgYA>@_+H36f_C~wP zanCX5_~!)WMCZijB;{Cg(sQgiWjU2OH97S;jX5gUJ=dJ;pBt1Log15*lxxXN&$Z^3 z?JWF1Bo;9y5uQIPDuRgCa4-=-t?C^I4Iiel0 zjwFZ0k?ycM${dxB8b`gO(V_C)^UeAG`9b;7`LX#)`Ih|jd~1GLer0}5etmvpzAA7p zFck24LiHj6D;hCt~~*K#&F)GV{@SrAgJJfO`NeJb;G}FbM!I z;lO4l@JR$lDZrxvm^1;Gj`eKKcL2k3;8+DLYk_A2Fl_>^Zot+9`1)v!!-4ZmV4VoO zQ-FCIaL)wxj)Jm+@`B2Os)Cw=+JgFmhJwa|rUF&yR_I>nQD`poDfBN4C=4nLFN`jn zSr}WGSeR6pQfMhmD@-rUEG#drDy=PTC~YcLc!_QmFSi`L|t%=qYYnnCF z>adnutE{!w25Xbm&E{eAu?5(|Z8L3&wiH{MEz{<(mD{RpwYCOZlg%y5Bg-c%AS*m; zW>#WWN>*A{W|kwXJgX|J7Qfd+DfNJq24sgrMiaABveO`=j_mU6s_feAhU}(nH@k=3 z#~xr0x6iaE+EeUl_Ds9OUT&|l*V-HGO?I~&j~t(zfSmB0nK_9$DLH95nK_P}@|>!i z+MI@*rX06ik6fSJfZXuhnYoF%DY4F^vX!Ot{DCYE~Tjw(kjINRiKgS7ZSQoorAROFE1gFx#B?mZE1@1I}Gj8CD4>%GIZX|*eY2bpRu)MIUu(q(Fu&L0k z$fL-oD4;03Xl7AjQA$x-QD%{&sJy7EsJ5t~sHw=U*rV8|IG{MZcxG{8aY}Joab~fj zxV*TkxVE^V81h*UK2lEG)s-?xN)4o>5fb7K>F|eSL_;c)AQ9<>*21#F%EFq$`ohLS zRpee|F7hu5DvBdWp59tfaD}rlh{4u|$=+mzqocOM^|8`%I0n}+x%@owrE?dEy-rFrQ58wGFzps##V1@w5crjEOVBBR!~-SR%}*MmL)4a z%bHb|Rhdrov08xj~c&yT#wK;LD`LQKSKz h256NJG%69gR0dtDgdQn-dv>g?tw9I>P5-MY@IO(Q*TVn+ literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/w64.exe b/.venv/lib/python3.12/site-packages/pip/_vendor/distlib/w64.exe new file mode 100644 index 0000000000000000000000000000000000000000..5763076d2878093971a0ef9870e1cde7f556b18b GIT binary patch literal 101888 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

                                          # pre-release
+            [-_\.]?
+            (?Palpha|a|beta|b|preview|pre|c|rc)
+            [-_\.]?
+            (?P[0-9]+)?
+        )?
+        (?P                                         # post release
+            (?:-(?P[0-9]+))
+            |
+            (?:
+                [-_\.]?
+                (?Ppost|rev|r)
+                [-_\.]?
+                (?P[0-9]+)?
+            )
+        )?
+        (?P                                          # dev release
+            [-_\.]?
+            (?Pdev)
+            [-_\.]?
+            (?P[0-9]+)?
+        )?
+    )
+    (?:\+(?P[a-z0-9]+(?:[-_\.][a-z0-9]+)*))?       # local version
+"""
+
+VERSION_PATTERN = _VERSION_PATTERN
+"""
+A string containing the regular expression used to match a valid version.
+
+The pattern is not anchored at either end, and is intended for embedding in larger
+expressions (for example, matching a version number as part of a file name). The
+regular expression should be compiled with the ``re.VERBOSE`` and ``re.IGNORECASE``
+flags set.
+
+:meta hide-value:
+"""
+
+
+class Version(_BaseVersion):
+    """This class abstracts handling of a project's versions.
+
+    A :class:`Version` instance is comparison aware and can be compared and
+    sorted using the standard Python interfaces.
+
+    >>> v1 = Version("1.0a5")
+    >>> v2 = Version("1.0")
+    >>> v1
+    
+    >>> v2
+    
+    >>> v1 < v2
+    True
+    >>> v1 == v2
+    False
+    >>> v1 > v2
+    False
+    >>> v1 >= v2
+    False
+    >>> v1 <= v2
+    True
+    """
+
+    _regex = re.compile(r"^\s*" + VERSION_PATTERN + r"\s*$", re.VERBOSE | re.IGNORECASE)
+    _key: CmpKey
+
+    def __init__(self, version: str) -> None:
+        """Initialize a Version object.
+
+        :param version:
+            The string representation of a version which will be parsed and normalized
+            before use.
+        :raises InvalidVersion:
+            If the ``version`` does not conform to PEP 440 in any way then this
+            exception will be raised.
+        """
+
+        # Validate the version and parse it into pieces
+        match = self._regex.search(version)
+        if not match:
+            raise InvalidVersion(f"Invalid version: '{version}'")
+
+        # Store the parsed out pieces of the version
+        self._version = _Version(
+            epoch=int(match.group("epoch")) if match.group("epoch") else 0,
+            release=tuple(int(i) for i in match.group("release").split(".")),
+            pre=_parse_letter_version(match.group("pre_l"), match.group("pre_n")),
+            post=_parse_letter_version(
+                match.group("post_l"), match.group("post_n1") or match.group("post_n2")
+            ),
+            dev=_parse_letter_version(match.group("dev_l"), match.group("dev_n")),
+            local=_parse_local_version(match.group("local")),
+        )
+
+        # Generate a key which will be used for sorting
+        self._key = _cmpkey(
+            self._version.epoch,
+            self._version.release,
+            self._version.pre,
+            self._version.post,
+            self._version.dev,
+            self._version.local,
+        )
+
+    def __repr__(self) -> str:
+        """A representation of the Version that shows all internal state.
+
+        >>> Version('1.0.0')
+        
+        """
+        return f""
+
+    def __str__(self) -> str:
+        """A string representation of the version that can be rounded-tripped.
+
+        >>> str(Version("1.0a5"))
+        '1.0a5'
+        """
+        parts = []
+
+        # Epoch
+        if self.epoch != 0:
+            parts.append(f"{self.epoch}!")
+
+        # Release segment
+        parts.append(".".join(str(x) for x in self.release))
+
+        # Pre-release
+        if self.pre is not None:
+            parts.append("".join(str(x) for x in self.pre))
+
+        # Post-release
+        if self.post is not None:
+            parts.append(f".post{self.post}")
+
+        # Development release
+        if self.dev is not None:
+            parts.append(f".dev{self.dev}")
+
+        # Local version segment
+        if self.local is not None:
+            parts.append(f"+{self.local}")
+
+        return "".join(parts)
+
+    @property
+    def epoch(self) -> int:
+        """The epoch of the version.
+
+        >>> Version("2.0.0").epoch
+        0
+        >>> Version("1!2.0.0").epoch
+        1
+        """
+        return self._version.epoch
+
+    @property
+    def release(self) -> tuple[int, ...]:
+        """The components of the "release" segment of the version.
+
+        >>> Version("1.2.3").release
+        (1, 2, 3)
+        >>> Version("2.0.0").release
+        (2, 0, 0)
+        >>> Version("1!2.0.0.post0").release
+        (2, 0, 0)
+
+        Includes trailing zeroes but not the epoch or any pre-release / development /
+        post-release suffixes.
+        """
+        return self._version.release
+
+    @property
+    def pre(self) -> tuple[str, int] | None:
+        """The pre-release segment of the version.
+
+        >>> print(Version("1.2.3").pre)
+        None
+        >>> Version("1.2.3a1").pre
+        ('a', 1)
+        >>> Version("1.2.3b1").pre
+        ('b', 1)
+        >>> Version("1.2.3rc1").pre
+        ('rc', 1)
+        """
+        return self._version.pre
+
+    @property
+    def post(self) -> int | None:
+        """The post-release number of the version.
+
+        >>> print(Version("1.2.3").post)
+        None
+        >>> Version("1.2.3.post1").post
+        1
+        """
+        return self._version.post[1] if self._version.post else None
+
+    @property
+    def dev(self) -> int | None:
+        """The development number of the version.
+
+        >>> print(Version("1.2.3").dev)
+        None
+        >>> Version("1.2.3.dev1").dev
+        1
+        """
+        return self._version.dev[1] if self._version.dev else None
+
+    @property
+    def local(self) -> str | None:
+        """The local version segment of the version.
+
+        >>> print(Version("1.2.3").local)
+        None
+        >>> Version("1.2.3+abc").local
+        'abc'
+        """
+        if self._version.local:
+            return ".".join(str(x) for x in self._version.local)
+        else:
+            return None
+
+    @property
+    def public(self) -> str:
+        """The public portion of the version.
+
+        >>> Version("1.2.3").public
+        '1.2.3'
+        >>> Version("1.2.3+abc").public
+        '1.2.3'
+        >>> Version("1.2.3+abc.dev1").public
+        '1.2.3'
+        """
+        return str(self).split("+", 1)[0]
+
+    @property
+    def base_version(self) -> str:
+        """The "base version" of the version.
+
+        >>> Version("1.2.3").base_version
+        '1.2.3'
+        >>> Version("1.2.3+abc").base_version
+        '1.2.3'
+        >>> Version("1!1.2.3+abc.dev1").base_version
+        '1!1.2.3'
+
+        The "base version" is the public version of the project without any pre or post
+        release markers.
+        """
+        parts = []
+
+        # Epoch
+        if self.epoch != 0:
+            parts.append(f"{self.epoch}!")
+
+        # Release segment
+        parts.append(".".join(str(x) for x in self.release))
+
+        return "".join(parts)
+
+    @property
+    def is_prerelease(self) -> bool:
+        """Whether this version is a pre-release.
+
+        >>> Version("1.2.3").is_prerelease
+        False
+        >>> Version("1.2.3a1").is_prerelease
+        True
+        >>> Version("1.2.3b1").is_prerelease
+        True
+        >>> Version("1.2.3rc1").is_prerelease
+        True
+        >>> Version("1.2.3dev1").is_prerelease
+        True
+        """
+        return self.dev is not None or self.pre is not None
+
+    @property
+    def is_postrelease(self) -> bool:
+        """Whether this version is a post-release.
+
+        >>> Version("1.2.3").is_postrelease
+        False
+        >>> Version("1.2.3.post1").is_postrelease
+        True
+        """
+        return self.post is not None
+
+    @property
+    def is_devrelease(self) -> bool:
+        """Whether this version is a development release.
+
+        >>> Version("1.2.3").is_devrelease
+        False
+        >>> Version("1.2.3.dev1").is_devrelease
+        True
+        """
+        return self.dev is not None
+
+    @property
+    def major(self) -> int:
+        """The first item of :attr:`release` or ``0`` if unavailable.
+
+        >>> Version("1.2.3").major
+        1
+        """
+        return self.release[0] if len(self.release) >= 1 else 0
+
+    @property
+    def minor(self) -> int:
+        """The second item of :attr:`release` or ``0`` if unavailable.
+
+        >>> Version("1.2.3").minor
+        2
+        >>> Version("1").minor
+        0
+        """
+        return self.release[1] if len(self.release) >= 2 else 0
+
+    @property
+    def micro(self) -> int:
+        """The third item of :attr:`release` or ``0`` if unavailable.
+
+        >>> Version("1.2.3").micro
+        3
+        >>> Version("1").micro
+        0
+        """
+        return self.release[2] if len(self.release) >= 3 else 0
+
+
+def _parse_letter_version(
+    letter: str | None, number: str | bytes | SupportsInt | None
+) -> tuple[str, int] | None:
+    if letter:
+        # We consider there to be an implicit 0 in a pre-release if there is
+        # not a numeral associated with it.
+        if number is None:
+            number = 0
+
+        # We normalize any letters to their lower case form
+        letter = letter.lower()
+
+        # We consider some words to be alternate spellings of other words and
+        # in those cases we want to normalize the spellings to our preferred
+        # spelling.
+        if letter == "alpha":
+            letter = "a"
+        elif letter == "beta":
+            letter = "b"
+        elif letter in ["c", "pre", "preview"]:
+            letter = "rc"
+        elif letter in ["rev", "r"]:
+            letter = "post"
+
+        return letter, int(number)
+    if not letter and number:
+        # We assume if we are given a number, but we are not given a letter
+        # then this is using the implicit post release syntax (e.g. 1.0-1)
+        letter = "post"
+
+        return letter, int(number)
+
+    return None
+
+
+_local_version_separators = re.compile(r"[\._-]")
+
+
+def _parse_local_version(local: str | None) -> LocalType | None:
+    """
+    Takes a string like abc.1.twelve and turns it into ("abc", 1, "twelve").
+    """
+    if local is not None:
+        return tuple(
+            part.lower() if not part.isdigit() else int(part)
+            for part in _local_version_separators.split(local)
+        )
+    return None
+
+
+def _cmpkey(
+    epoch: int,
+    release: tuple[int, ...],
+    pre: tuple[str, int] | None,
+    post: tuple[str, int] | None,
+    dev: tuple[str, int] | None,
+    local: LocalType | None,
+) -> CmpKey:
+    # When we compare a release version, we want to compare it with all of the
+    # trailing zeros removed. So we'll use a reverse the list, drop all the now
+    # leading zeros until we come to something non zero, then take the rest
+    # re-reverse it back into the correct order and make it a tuple and use
+    # that for our sorting key.
+    _release = tuple(
+        reversed(list(itertools.dropwhile(lambda x: x == 0, reversed(release))))
+    )
+
+    # We need to "trick" the sorting algorithm to put 1.0.dev0 before 1.0a0.
+    # We'll do this by abusing the pre segment, but we _only_ want to do this
+    # if there is not a pre or a post segment. If we have one of those then
+    # the normal sorting rules will handle this case correctly.
+    if pre is None and post is None and dev is not None:
+        _pre: CmpPrePostDevType = NegativeInfinity
+    # Versions without a pre-release (except as noted above) should sort after
+    # those with one.
+    elif pre is None:
+        _pre = Infinity
+    else:
+        _pre = pre
+
+    # Versions without a post segment should sort before those with one.
+    if post is None:
+        _post: CmpPrePostDevType = NegativeInfinity
+
+    else:
+        _post = post
+
+    # Versions without a development segment should sort after those with one.
+    if dev is None:
+        _dev: CmpPrePostDevType = Infinity
+
+    else:
+        _dev = dev
+
+    if local is None:
+        # Versions without a local segment should sort before those with one.
+        _local: CmpLocalType = NegativeInfinity
+    else:
+        # Versions with a local segment need that segment parsed to implement
+        # the sorting rules in PEP440.
+        # - Alpha numeric segments sort before numeric segments
+        # - Alpha numeric segments sort lexicographically
+        # - Numeric segments sort numerically
+        # - Shorter versions sort before longer versions when the prefixes
+        #   match exactly
+        _local = tuple(
+            (i, "") if isinstance(i, int) else (NegativeInfinity, i) for i in local
+        )
+
+    return epoch, _release, _pre, _post, _dev, _local
diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/pkg_resources/__init__.py b/.venv/lib/python3.12/site-packages/pip/_vendor/pkg_resources/__init__.py
new file mode 100644
index 0000000..57ce7f1
--- /dev/null
+++ b/.venv/lib/python3.12/site-packages/pip/_vendor/pkg_resources/__init__.py
@@ -0,0 +1,3676 @@
+# TODO: Add Generic type annotations to initialized collections.
+# For now we'd simply use implicit Any/Unknown which would add redundant annotations
+# mypy: disable-error-code="var-annotated"
+"""
+Package resource API
+--------------------
+
+A resource is a logical file contained within a package, or a logical
+subdirectory thereof.  The package resource API expects resource names
+to have their path parts separated with ``/``, *not* whatever the local
+path separator is.  Do not use os.path operations to manipulate resource
+names being passed into the API.
+
+The package resource API is designed to work with normal filesystem packages,
+.egg files, and unpacked .egg files.  It can also work in a limited way with
+.zip files and with custom PEP 302 loaders that support the ``get_data()``
+method.
+
+This module is deprecated. Users are directed to :mod:`importlib.resources`,
+:mod:`importlib.metadata` and :pypi:`packaging` instead.
+"""
+
+from __future__ import annotations
+
+import sys
+
+if sys.version_info < (3, 8):  # noqa: UP036 # Check for unsupported versions
+    raise RuntimeError("Python 3.8 or later is required")
+
+import os
+import io
+import time
+import re
+import types
+from typing import (
+    Any,
+    Literal,
+    Dict,
+    Iterator,
+    Mapping,
+    MutableSequence,
+    NamedTuple,
+    NoReturn,
+    Tuple,
+    Union,
+    TYPE_CHECKING,
+    Protocol,
+    Callable,
+    Iterable,
+    TypeVar,
+    overload,
+)
+import zipfile
+import zipimport
+import warnings
+import stat
+import functools
+import pkgutil
+import operator
+import platform
+import collections
+import plistlib
+import email.parser
+import errno
+import tempfile
+import textwrap
+import inspect
+import ntpath
+import posixpath
+import importlib
+import importlib.abc
+import importlib.machinery
+from pkgutil import get_importer
+
+import _imp
+
+# capture these to bypass sandboxing
+from os import utime
+from os import open as os_open
+from os.path import isdir, split
+
+try:
+    from os import mkdir, rename, unlink
+
+    WRITE_SUPPORT = True
+except ImportError:
+    # no write support, probably under GAE
+    WRITE_SUPPORT = False
+
+from pip._internal.utils._jaraco_text import (
+    yield_lines,
+    drop_comment,
+    join_continuation,
+)
+from pip._vendor.packaging import markers as _packaging_markers
+from pip._vendor.packaging import requirements as _packaging_requirements
+from pip._vendor.packaging import utils as _packaging_utils
+from pip._vendor.packaging import version as _packaging_version
+from pip._vendor.platformdirs import user_cache_dir as _user_cache_dir
+
+if TYPE_CHECKING:
+    from _typeshed import BytesPath, StrPath, StrOrBytesPath
+    from pip._vendor.typing_extensions import Self
+
+
+# Patch: Remove deprecation warning from vendored pkg_resources.
+# Setting PYTHONWARNINGS=error to verify builds produce no warnings
+# causes immediate exceptions.
+# See https://github.com/pypa/pip/issues/12243
+
+
+_T = TypeVar("_T")
+_DistributionT = TypeVar("_DistributionT", bound="Distribution")
+# Type aliases
+_NestedStr = Union[str, Iterable[Union[str, Iterable["_NestedStr"]]]]
+_InstallerTypeT = Callable[["Requirement"], "_DistributionT"]
+_InstallerType = Callable[["Requirement"], Union["Distribution", None]]
+_PkgReqType = Union[str, "Requirement"]
+_EPDistType = Union["Distribution", _PkgReqType]
+_MetadataType = Union["IResourceProvider", None]
+_ResolvedEntryPoint = Any  # Can be any attribute in the module
+_ResourceStream = Any  # TODO / Incomplete: A readable file-like object
+# Any object works, but let's indicate we expect something like a module (optionally has __loader__ or __file__)
+_ModuleLike = Union[object, types.ModuleType]
+# Any: Should be _ModuleLike but we end up with issues where _ModuleLike doesn't have _ZipLoaderModule's __loader__
+_ProviderFactoryType = Callable[[Any], "IResourceProvider"]
+_DistFinderType = Callable[[_T, str, bool], Iterable["Distribution"]]
+_NSHandlerType = Callable[[_T, str, str, types.ModuleType], Union[str, None]]
+_AdapterT = TypeVar(
+    "_AdapterT", _DistFinderType[Any], _ProviderFactoryType, _NSHandlerType[Any]
+)
+
+
+# Use _typeshed.importlib.LoaderProtocol once available https://github.com/python/typeshed/pull/11890
+class _LoaderProtocol(Protocol):
+    def load_module(self, fullname: str, /) -> types.ModuleType: ...
+
+
+class _ZipLoaderModule(Protocol):
+    __loader__: zipimport.zipimporter
+
+
+_PEP440_FALLBACK = re.compile(r"^v?(?P(?:[0-9]+!)?[0-9]+(?:\.[0-9]+)*)", re.I)
+
+
+class PEP440Warning(RuntimeWarning):
+    """
+    Used when there is an issue with a version or specifier not complying with
+    PEP 440.
+    """
+
+
+parse_version = _packaging_version.Version
+
+
+_state_vars: dict[str, str] = {}
+
+
+def _declare_state(vartype: str, varname: str, initial_value: _T) -> _T:
+    _state_vars[varname] = vartype
+    return initial_value
+
+
+def __getstate__() -> dict[str, Any]:
+    state = {}
+    g = globals()
+    for k, v in _state_vars.items():
+        state[k] = g['_sget_' + v](g[k])
+    return state
+
+
+def __setstate__(state: dict[str, Any]) -> dict[str, Any]:
+    g = globals()
+    for k, v in state.items():
+        g['_sset_' + _state_vars[k]](k, g[k], v)
+    return state
+
+
+def _sget_dict(val):
+    return val.copy()
+
+
+def _sset_dict(key, ob, state):
+    ob.clear()
+    ob.update(state)
+
+
+def _sget_object(val):
+    return val.__getstate__()
+
+
+def _sset_object(key, ob, state):
+    ob.__setstate__(state)
+
+
+_sget_none = _sset_none = lambda *args: None
+
+
+def get_supported_platform():
+    """Return this platform's maximum compatible version.
+
+    distutils.util.get_platform() normally reports the minimum version
+    of macOS that would be required to *use* extensions produced by
+    distutils.  But what we want when checking compatibility is to know the
+    version of macOS that we are *running*.  To allow usage of packages that
+    explicitly require a newer version of macOS, we must also know the
+    current version of the OS.
+
+    If this condition occurs for any other platform with a version in its
+    platform strings, this function should be extended accordingly.
+    """
+    plat = get_build_platform()
+    m = macosVersionString.match(plat)
+    if m is not None and sys.platform == "darwin":
+        try:
+            plat = 'macosx-%s-%s' % ('.'.join(_macos_vers()[:2]), m.group(3))
+        except ValueError:
+            # not macOS
+            pass
+    return plat
+
+
+__all__ = [
+    # Basic resource access and distribution/entry point discovery
+    'require',
+    'run_script',
+    'get_provider',
+    'get_distribution',
+    'load_entry_point',
+    'get_entry_map',
+    'get_entry_info',
+    'iter_entry_points',
+    'resource_string',
+    'resource_stream',
+    'resource_filename',
+    'resource_listdir',
+    'resource_exists',
+    'resource_isdir',
+    # Environmental control
+    'declare_namespace',
+    'working_set',
+    'add_activation_listener',
+    'find_distributions',
+    'set_extraction_path',
+    'cleanup_resources',
+    'get_default_cache',
+    # Primary implementation classes
+    'Environment',
+    'WorkingSet',
+    'ResourceManager',
+    'Distribution',
+    'Requirement',
+    'EntryPoint',
+    # Exceptions
+    'ResolutionError',
+    'VersionConflict',
+    'DistributionNotFound',
+    'UnknownExtra',
+    'ExtractionError',
+    # Warnings
+    'PEP440Warning',
+    # Parsing functions and string utilities
+    'parse_requirements',
+    'parse_version',
+    'safe_name',
+    'safe_version',
+    'get_platform',
+    'compatible_platforms',
+    'yield_lines',
+    'split_sections',
+    'safe_extra',
+    'to_filename',
+    'invalid_marker',
+    'evaluate_marker',
+    # filesystem utilities
+    'ensure_directory',
+    'normalize_path',
+    # Distribution "precedence" constants
+    'EGG_DIST',
+    'BINARY_DIST',
+    'SOURCE_DIST',
+    'CHECKOUT_DIST',
+    'DEVELOP_DIST',
+    # "Provider" interfaces, implementations, and registration/lookup APIs
+    'IMetadataProvider',
+    'IResourceProvider',
+    'FileMetadata',
+    'PathMetadata',
+    'EggMetadata',
+    'EmptyProvider',
+    'empty_provider',
+    'NullProvider',
+    'EggProvider',
+    'DefaultProvider',
+    'ZipProvider',
+    'register_finder',
+    'register_namespace_handler',
+    'register_loader_type',
+    'fixup_namespace_packages',
+    'get_importer',
+    # Warnings
+    'PkgResourcesDeprecationWarning',
+    # Deprecated/backward compatibility only
+    'run_main',
+    'AvailableDistributions',
+]
+
+
+class ResolutionError(Exception):
+    """Abstract base for dependency resolution errors"""
+
+    def __repr__(self):
+        return self.__class__.__name__ + repr(self.args)
+
+
+class VersionConflict(ResolutionError):
+    """
+    An already-installed version conflicts with the requested version.
+
+    Should be initialized with the installed Distribution and the requested
+    Requirement.
+    """
+
+    _template = "{self.dist} is installed but {self.req} is required"
+
+    @property
+    def dist(self) -> Distribution:
+        return self.args[0]
+
+    @property
+    def req(self) -> Requirement:
+        return self.args[1]
+
+    def report(self):
+        return self._template.format(**locals())
+
+    def with_context(self, required_by: set[Distribution | str]):
+        """
+        If required_by is non-empty, return a version of self that is a
+        ContextualVersionConflict.
+        """
+        if not required_by:
+            return self
+        args = self.args + (required_by,)
+        return ContextualVersionConflict(*args)
+
+
+class ContextualVersionConflict(VersionConflict):
+    """
+    A VersionConflict that accepts a third parameter, the set of the
+    requirements that required the installed Distribution.
+    """
+
+    _template = VersionConflict._template + ' by {self.required_by}'
+
+    @property
+    def required_by(self) -> set[str]:
+        return self.args[2]
+
+
+class DistributionNotFound(ResolutionError):
+    """A requested distribution was not found"""
+
+    _template = (
+        "The '{self.req}' distribution was not found "
+        "and is required by {self.requirers_str}"
+    )
+
+    @property
+    def req(self) -> Requirement:
+        return self.args[0]
+
+    @property
+    def requirers(self) -> set[str] | None:
+        return self.args[1]
+
+    @property
+    def requirers_str(self):
+        if not self.requirers:
+            return 'the application'
+        return ', '.join(self.requirers)
+
+    def report(self):
+        return self._template.format(**locals())
+
+    def __str__(self):
+        return self.report()
+
+
+class UnknownExtra(ResolutionError):
+    """Distribution doesn't have an "extra feature" of the given name"""
+
+
+_provider_factories: dict[type[_ModuleLike], _ProviderFactoryType] = {}
+
+PY_MAJOR = '{}.{}'.format(*sys.version_info)
+EGG_DIST = 3
+BINARY_DIST = 2
+SOURCE_DIST = 1
+CHECKOUT_DIST = 0
+DEVELOP_DIST = -1
+
+
+def register_loader_type(
+    loader_type: type[_ModuleLike], provider_factory: _ProviderFactoryType
+):
+    """Register `provider_factory` to make providers for `loader_type`
+
+    `loader_type` is the type or class of a PEP 302 ``module.__loader__``,
+    and `provider_factory` is a function that, passed a *module* object,
+    returns an ``IResourceProvider`` for that module.
+    """
+    _provider_factories[loader_type] = provider_factory
+
+
+@overload
+def get_provider(moduleOrReq: str) -> IResourceProvider: ...
+@overload
+def get_provider(moduleOrReq: Requirement) -> Distribution: ...
+def get_provider(moduleOrReq: str | Requirement) -> IResourceProvider | Distribution:
+    """Return an IResourceProvider for the named module or requirement"""
+    if isinstance(moduleOrReq, Requirement):
+        return working_set.find(moduleOrReq) or require(str(moduleOrReq))[0]
+    try:
+        module = sys.modules[moduleOrReq]
+    except KeyError:
+        __import__(moduleOrReq)
+        module = sys.modules[moduleOrReq]
+    loader = getattr(module, '__loader__', None)
+    return _find_adapter(_provider_factories, loader)(module)
+
+
+@functools.lru_cache(maxsize=None)
+def _macos_vers():
+    version = platform.mac_ver()[0]
+    # fallback for MacPorts
+    if version == '':
+        plist = '/System/Library/CoreServices/SystemVersion.plist'
+        if os.path.exists(plist):
+            with open(plist, 'rb') as fh:
+                plist_content = plistlib.load(fh)
+            if 'ProductVersion' in plist_content:
+                version = plist_content['ProductVersion']
+    return version.split('.')
+
+
+def _macos_arch(machine):
+    return {'PowerPC': 'ppc', 'Power_Macintosh': 'ppc'}.get(machine, machine)
+
+
+def get_build_platform():
+    """Return this platform's string for platform-specific distributions
+
+    XXX Currently this is the same as ``distutils.util.get_platform()``, but it
+    needs some hacks for Linux and macOS.
+    """
+    from sysconfig import get_platform
+
+    plat = get_platform()
+    if sys.platform == "darwin" and not plat.startswith('macosx-'):
+        try:
+            version = _macos_vers()
+            machine = os.uname()[4].replace(" ", "_")
+            return "macosx-%d.%d-%s" % (
+                int(version[0]),
+                int(version[1]),
+                _macos_arch(machine),
+            )
+        except ValueError:
+            # if someone is running a non-Mac darwin system, this will fall
+            # through to the default implementation
+            pass
+    return plat
+
+
+macosVersionString = re.compile(r"macosx-(\d+)\.(\d+)-(.*)")
+darwinVersionString = re.compile(r"darwin-(\d+)\.(\d+)\.(\d+)-(.*)")
+# XXX backward compat
+get_platform = get_build_platform
+
+
+def compatible_platforms(provided: str | None, required: str | None):
+    """Can code for the `provided` platform run on the `required` platform?
+
+    Returns true if either platform is ``None``, or the platforms are equal.
+
+    XXX Needs compatibility checks for Linux and other unixy OSes.
+    """
+    if provided is None or required is None or provided == required:
+        # easy case
+        return True
+
+    # macOS special cases
+    reqMac = macosVersionString.match(required)
+    if reqMac:
+        provMac = macosVersionString.match(provided)
+
+        # is this a Mac package?
+        if not provMac:
+            # this is backwards compatibility for packages built before
+            # setuptools 0.6. All packages built after this point will
+            # use the new macOS designation.
+            provDarwin = darwinVersionString.match(provided)
+            if provDarwin:
+                dversion = int(provDarwin.group(1))
+                macosversion = "%s.%s" % (reqMac.group(1), reqMac.group(2))
+                if (
+                    dversion == 7
+                    and macosversion >= "10.3"
+                    or dversion == 8
+                    and macosversion >= "10.4"
+                ):
+                    return True
+            # egg isn't macOS or legacy darwin
+            return False
+
+        # are they the same major version and machine type?
+        if provMac.group(1) != reqMac.group(1) or provMac.group(3) != reqMac.group(3):
+            return False
+
+        # is the required OS major update >= the provided one?
+        if int(provMac.group(2)) > int(reqMac.group(2)):
+            return False
+
+        return True
+
+    # XXX Linux and other platforms' special cases should go here
+    return False
+
+
+@overload
+def get_distribution(dist: _DistributionT) -> _DistributionT: ...
+@overload
+def get_distribution(dist: _PkgReqType) -> Distribution: ...
+def get_distribution(dist: Distribution | _PkgReqType) -> Distribution:
+    """Return a current distribution object for a Requirement or string"""
+    if isinstance(dist, str):
+        dist = Requirement.parse(dist)
+    if isinstance(dist, Requirement):
+        # Bad type narrowing, dist has to be a Requirement here, so get_provider has to return Distribution
+        dist = get_provider(dist)  # type: ignore[assignment]
+    if not isinstance(dist, Distribution):
+        raise TypeError("Expected str, Requirement, or Distribution", dist)
+    return dist
+
+
+def load_entry_point(dist: _EPDistType, group: str, name: str) -> _ResolvedEntryPoint:
+    """Return `name` entry point of `group` for `dist` or raise ImportError"""
+    return get_distribution(dist).load_entry_point(group, name)
+
+
+@overload
+def get_entry_map(
+    dist: _EPDistType, group: None = None
+) -> dict[str, dict[str, EntryPoint]]: ...
+@overload
+def get_entry_map(dist: _EPDistType, group: str) -> dict[str, EntryPoint]: ...
+def get_entry_map(dist: _EPDistType, group: str | None = None):
+    """Return the entry point map for `group`, or the full entry map"""
+    return get_distribution(dist).get_entry_map(group)
+
+
+def get_entry_info(dist: _EPDistType, group: str, name: str):
+    """Return the EntryPoint object for `group`+`name`, or ``None``"""
+    return get_distribution(dist).get_entry_info(group, name)
+
+
+class IMetadataProvider(Protocol):
+    def has_metadata(self, name: str) -> bool:
+        """Does the package's distribution contain the named metadata?"""
+
+    def get_metadata(self, name: str) -> str:
+        """The named metadata resource as a string"""
+
+    def get_metadata_lines(self, name: str) -> Iterator[str]:
+        """Yield named metadata resource as list of non-blank non-comment lines
+
+        Leading and trailing whitespace is stripped from each line, and lines
+        with ``#`` as the first non-blank character are omitted."""
+
+    def metadata_isdir(self, name: str) -> bool:
+        """Is the named metadata a directory?  (like ``os.path.isdir()``)"""
+
+    def metadata_listdir(self, name: str) -> list[str]:
+        """List of metadata names in the directory (like ``os.listdir()``)"""
+
+    def run_script(self, script_name: str, namespace: dict[str, Any]) -> None:
+        """Execute the named script in the supplied namespace dictionary"""
+
+
+class IResourceProvider(IMetadataProvider, Protocol):
+    """An object that provides access to package resources"""
+
+    def get_resource_filename(
+        self, manager: ResourceManager, resource_name: str
+    ) -> str:
+        """Return a true filesystem path for `resource_name`
+
+        `manager` must be a ``ResourceManager``"""
+
+    def get_resource_stream(
+        self, manager: ResourceManager, resource_name: str
+    ) -> _ResourceStream:
+        """Return a readable file-like object for `resource_name`
+
+        `manager` must be a ``ResourceManager``"""
+
+    def get_resource_string(
+        self, manager: ResourceManager, resource_name: str
+    ) -> bytes:
+        """Return the contents of `resource_name` as :obj:`bytes`
+
+        `manager` must be a ``ResourceManager``"""
+
+    def has_resource(self, resource_name: str) -> bool:
+        """Does the package contain the named resource?"""
+
+    def resource_isdir(self, resource_name: str) -> bool:
+        """Is the named resource a directory?  (like ``os.path.isdir()``)"""
+
+    def resource_listdir(self, resource_name: str) -> list[str]:
+        """List of resource names in the directory (like ``os.listdir()``)"""
+
+
+class WorkingSet:
+    """A collection of active distributions on sys.path (or a similar list)"""
+
+    def __init__(self, entries: Iterable[str] | None = None):
+        """Create working set from list of path entries (default=sys.path)"""
+        self.entries: list[str] = []
+        self.entry_keys = {}
+        self.by_key = {}
+        self.normalized_to_canonical_keys = {}
+        self.callbacks = []
+
+        if entries is None:
+            entries = sys.path
+
+        for entry in entries:
+            self.add_entry(entry)
+
+    @classmethod
+    def _build_master(cls):
+        """
+        Prepare the master working set.
+        """
+        ws = cls()
+        try:
+            from __main__ import __requires__
+        except ImportError:
+            # The main program does not list any requirements
+            return ws
+
+        # ensure the requirements are met
+        try:
+            ws.require(__requires__)
+        except VersionConflict:
+            return cls._build_from_requirements(__requires__)
+
+        return ws
+
+    @classmethod
+    def _build_from_requirements(cls, req_spec):
+        """
+        Build a working set from a requirement spec. Rewrites sys.path.
+        """
+        # try it without defaults already on sys.path
+        # by starting with an empty path
+        ws = cls([])
+        reqs = parse_requirements(req_spec)
+        dists = ws.resolve(reqs, Environment())
+        for dist in dists:
+            ws.add(dist)
+
+        # add any missing entries from sys.path
+        for entry in sys.path:
+            if entry not in ws.entries:
+                ws.add_entry(entry)
+
+        # then copy back to sys.path
+        sys.path[:] = ws.entries
+        return ws
+
+    def add_entry(self, entry: str):
+        """Add a path item to ``.entries``, finding any distributions on it
+
+        ``find_distributions(entry, True)`` is used to find distributions
+        corresponding to the path entry, and they are added.  `entry` is
+        always appended to ``.entries``, even if it is already present.
+        (This is because ``sys.path`` can contain the same value more than
+        once, and the ``.entries`` of the ``sys.path`` WorkingSet should always
+        equal ``sys.path``.)
+        """
+        self.entry_keys.setdefault(entry, [])
+        self.entries.append(entry)
+        for dist in find_distributions(entry, True):
+            self.add(dist, entry, False)
+
+    def __contains__(self, dist: Distribution) -> bool:
+        """True if `dist` is the active distribution for its project"""
+        return self.by_key.get(dist.key) == dist
+
+    def find(self, req: Requirement) -> Distribution | None:
+        """Find a distribution matching requirement `req`
+
+        If there is an active distribution for the requested project, this
+        returns it as long as it meets the version requirement specified by
+        `req`.  But, if there is an active distribution for the project and it
+        does *not* meet the `req` requirement, ``VersionConflict`` is raised.
+        If there is no active distribution for the requested project, ``None``
+        is returned.
+        """
+        dist = self.by_key.get(req.key)
+
+        if dist is None:
+            canonical_key = self.normalized_to_canonical_keys.get(req.key)
+
+            if canonical_key is not None:
+                req.key = canonical_key
+                dist = self.by_key.get(canonical_key)
+
+        if dist is not None and dist not in req:
+            # XXX add more info
+            raise VersionConflict(dist, req)
+        return dist
+
+    def iter_entry_points(self, group: str, name: str | None = None):
+        """Yield entry point objects from `group` matching `name`
+
+        If `name` is None, yields all entry points in `group` from all
+        distributions in the working set, otherwise only ones matching
+        both `group` and `name` are yielded (in distribution order).
+        """
+        return (
+            entry
+            for dist in self
+            for entry in dist.get_entry_map(group).values()
+            if name is None or name == entry.name
+        )
+
+    def run_script(self, requires: str, script_name: str):
+        """Locate distribution for `requires` and run `script_name` script"""
+        ns = sys._getframe(1).f_globals
+        name = ns['__name__']
+        ns.clear()
+        ns['__name__'] = name
+        self.require(requires)[0].run_script(script_name, ns)
+
+    def __iter__(self) -> Iterator[Distribution]:
+        """Yield distributions for non-duplicate projects in the working set
+
+        The yield order is the order in which the items' path entries were
+        added to the working set.
+        """
+        seen = set()
+        for item in self.entries:
+            if item not in self.entry_keys:
+                # workaround a cache issue
+                continue
+
+            for key in self.entry_keys[item]:
+                if key not in seen:
+                    seen.add(key)
+                    yield self.by_key[key]
+
+    def add(
+        self,
+        dist: Distribution,
+        entry: str | None = None,
+        insert: bool = True,
+        replace: bool = False,
+    ):
+        """Add `dist` to working set, associated with `entry`
+
+        If `entry` is unspecified, it defaults to the ``.location`` of `dist`.
+        On exit from this routine, `entry` is added to the end of the working
+        set's ``.entries`` (if it wasn't already present).
+
+        `dist` is only added to the working set if it's for a project that
+        doesn't already have a distribution in the set, unless `replace=True`.
+        If it's added, any callbacks registered with the ``subscribe()`` method
+        will be called.
+        """
+        if insert:
+            dist.insert_on(self.entries, entry, replace=replace)
+
+        if entry is None:
+            entry = dist.location
+        keys = self.entry_keys.setdefault(entry, [])
+        keys2 = self.entry_keys.setdefault(dist.location, [])
+        if not replace and dist.key in self.by_key:
+            # ignore hidden distros
+            return
+
+        self.by_key[dist.key] = dist
+        normalized_name = _packaging_utils.canonicalize_name(dist.key)
+        self.normalized_to_canonical_keys[normalized_name] = dist.key
+        if dist.key not in keys:
+            keys.append(dist.key)
+        if dist.key not in keys2:
+            keys2.append(dist.key)
+        self._added_new(dist)
+
+    @overload
+    def resolve(
+        self,
+        requirements: Iterable[Requirement],
+        env: Environment | None,
+        installer: _InstallerTypeT[_DistributionT],
+        replace_conflicting: bool = False,
+        extras: tuple[str, ...] | None = None,
+    ) -> list[_DistributionT]: ...
+    @overload
+    def resolve(
+        self,
+        requirements: Iterable[Requirement],
+        env: Environment | None = None,
+        *,
+        installer: _InstallerTypeT[_DistributionT],
+        replace_conflicting: bool = False,
+        extras: tuple[str, ...] | None = None,
+    ) -> list[_DistributionT]: ...
+    @overload
+    def resolve(
+        self,
+        requirements: Iterable[Requirement],
+        env: Environment | None = None,
+        installer: _InstallerType | None = None,
+        replace_conflicting: bool = False,
+        extras: tuple[str, ...] | None = None,
+    ) -> list[Distribution]: ...
+    def resolve(
+        self,
+        requirements: Iterable[Requirement],
+        env: Environment | None = None,
+        installer: _InstallerType | None | _InstallerTypeT[_DistributionT] = None,
+        replace_conflicting: bool = False,
+        extras: tuple[str, ...] | None = None,
+    ) -> list[Distribution] | list[_DistributionT]:
+        """List all distributions needed to (recursively) meet `requirements`
+
+        `requirements` must be a sequence of ``Requirement`` objects.  `env`,
+        if supplied, should be an ``Environment`` instance.  If
+        not supplied, it defaults to all distributions available within any
+        entry or distribution in the working set.  `installer`, if supplied,
+        will be invoked with each requirement that cannot be met by an
+        already-installed distribution; it should return a ``Distribution`` or
+        ``None``.
+
+        Unless `replace_conflicting=True`, raises a VersionConflict exception
+        if
+        any requirements are found on the path that have the correct name but
+        the wrong version.  Otherwise, if an `installer` is supplied it will be
+        invoked to obtain the correct version of the requirement and activate
+        it.
+
+        `extras` is a list of the extras to be used with these requirements.
+        This is important because extra requirements may look like `my_req;
+        extra = "my_extra"`, which would otherwise be interpreted as a purely
+        optional requirement.  Instead, we want to be able to assert that these
+        requirements are truly required.
+        """
+
+        # set up the stack
+        requirements = list(requirements)[::-1]
+        # set of processed requirements
+        processed = set()
+        # key -> dist
+        best = {}
+        to_activate = []
+
+        req_extras = _ReqExtras()
+
+        # Mapping of requirement to set of distributions that required it;
+        # useful for reporting info about conflicts.
+        required_by = collections.defaultdict(set)
+
+        while requirements:
+            # process dependencies breadth-first
+            req = requirements.pop(0)
+            if req in processed:
+                # Ignore cyclic or redundant dependencies
+                continue
+
+            if not req_extras.markers_pass(req, extras):
+                continue
+
+            dist = self._resolve_dist(
+                req, best, replace_conflicting, env, installer, required_by, to_activate
+            )
+
+            # push the new requirements onto the stack
+            new_requirements = dist.requires(req.extras)[::-1]
+            requirements.extend(new_requirements)
+
+            # Register the new requirements needed by req
+            for new_requirement in new_requirements:
+                required_by[new_requirement].add(req.project_name)
+                req_extras[new_requirement] = req.extras
+
+            processed.add(req)
+
+        # return list of distros to activate
+        return to_activate
+
+    def _resolve_dist(
+        self, req, best, replace_conflicting, env, installer, required_by, to_activate
+    ) -> Distribution:
+        dist = best.get(req.key)
+        if dist is None:
+            # Find the best distribution and add it to the map
+            dist = self.by_key.get(req.key)
+            if dist is None or (dist not in req and replace_conflicting):
+                ws = self
+                if env is None:
+                    if dist is None:
+                        env = Environment(self.entries)
+                    else:
+                        # Use an empty environment and workingset to avoid
+                        # any further conflicts with the conflicting
+                        # distribution
+                        env = Environment([])
+                        ws = WorkingSet([])
+                dist = best[req.key] = env.best_match(
+                    req, ws, installer, replace_conflicting=replace_conflicting
+                )
+                if dist is None:
+                    requirers = required_by.get(req, None)
+                    raise DistributionNotFound(req, requirers)
+            to_activate.append(dist)
+        if dist not in req:
+            # Oops, the "best" so far conflicts with a dependency
+            dependent_req = required_by[req]
+            raise VersionConflict(dist, req).with_context(dependent_req)
+        return dist
+
+    @overload
+    def find_plugins(
+        self,
+        plugin_env: Environment,
+        full_env: Environment | None,
+        installer: _InstallerTypeT[_DistributionT],
+        fallback: bool = True,
+    ) -> tuple[list[_DistributionT], dict[Distribution, Exception]]: ...
+    @overload
+    def find_plugins(
+        self,
+        plugin_env: Environment,
+        full_env: Environment | None = None,
+        *,
+        installer: _InstallerTypeT[_DistributionT],
+        fallback: bool = True,
+    ) -> tuple[list[_DistributionT], dict[Distribution, Exception]]: ...
+    @overload
+    def find_plugins(
+        self,
+        plugin_env: Environment,
+        full_env: Environment | None = None,
+        installer: _InstallerType | None = None,
+        fallback: bool = True,
+    ) -> tuple[list[Distribution], dict[Distribution, Exception]]: ...
+    def find_plugins(
+        self,
+        plugin_env: Environment,
+        full_env: Environment | None = None,
+        installer: _InstallerType | None | _InstallerTypeT[_DistributionT] = None,
+        fallback: bool = True,
+    ) -> tuple[
+        list[Distribution] | list[_DistributionT],
+        dict[Distribution, Exception],
+    ]:
+        """Find all activatable distributions in `plugin_env`
+
+        Example usage::
+
+            distributions, errors = working_set.find_plugins(
+                Environment(plugin_dirlist)
+            )
+            # add plugins+libs to sys.path
+            map(working_set.add, distributions)
+            # display errors
+            print('Could not load', errors)
+
+        The `plugin_env` should be an ``Environment`` instance that contains
+        only distributions that are in the project's "plugin directory" or
+        directories. The `full_env`, if supplied, should be an ``Environment``
+        contains all currently-available distributions.  If `full_env` is not
+        supplied, one is created automatically from the ``WorkingSet`` this
+        method is called on, which will typically mean that every directory on
+        ``sys.path`` will be scanned for distributions.
+
+        `installer` is a standard installer callback as used by the
+        ``resolve()`` method. The `fallback` flag indicates whether we should
+        attempt to resolve older versions of a plugin if the newest version
+        cannot be resolved.
+
+        This method returns a 2-tuple: (`distributions`, `error_info`), where
+        `distributions` is a list of the distributions found in `plugin_env`
+        that were loadable, along with any other distributions that are needed
+        to resolve their dependencies.  `error_info` is a dictionary mapping
+        unloadable plugin distributions to an exception instance describing the
+        error that occurred. Usually this will be a ``DistributionNotFound`` or
+        ``VersionConflict`` instance.
+        """
+
+        plugin_projects = list(plugin_env)
+        # scan project names in alphabetic order
+        plugin_projects.sort()
+
+        error_info: dict[Distribution, Exception] = {}
+        distributions: dict[Distribution, Exception | None] = {}
+
+        if full_env is None:
+            env = Environment(self.entries)
+            env += plugin_env
+        else:
+            env = full_env + plugin_env
+
+        shadow_set = self.__class__([])
+        # put all our entries in shadow_set
+        list(map(shadow_set.add, self))
+
+        for project_name in plugin_projects:
+            for dist in plugin_env[project_name]:
+                req = [dist.as_requirement()]
+
+                try:
+                    resolvees = shadow_set.resolve(req, env, installer)
+
+                except ResolutionError as v:
+                    # save error info
+                    error_info[dist] = v
+                    if fallback:
+                        # try the next older version of project
+                        continue
+                    else:
+                        # give up on this project, keep going
+                        break
+
+                else:
+                    list(map(shadow_set.add, resolvees))
+                    distributions.update(dict.fromkeys(resolvees))
+
+                    # success, no need to try any more versions of this project
+                    break
+
+        sorted_distributions = list(distributions)
+        sorted_distributions.sort()
+
+        return sorted_distributions, error_info
+
+    def require(self, *requirements: _NestedStr):
+        """Ensure that distributions matching `requirements` are activated
+
+        `requirements` must be a string or a (possibly-nested) sequence
+        thereof, specifying the distributions and versions required.  The
+        return value is a sequence of the distributions that needed to be
+        activated to fulfill the requirements; all relevant distributions are
+        included, even if they were already activated in this working set.
+        """
+        needed = self.resolve(parse_requirements(requirements))
+
+        for dist in needed:
+            self.add(dist)
+
+        return needed
+
+    def subscribe(
+        self, callback: Callable[[Distribution], object], existing: bool = True
+    ):
+        """Invoke `callback` for all distributions
+
+        If `existing=True` (default),
+        call on all existing ones, as well.
+        """
+        if callback in self.callbacks:
+            return
+        self.callbacks.append(callback)
+        if not existing:
+            return
+        for dist in self:
+            callback(dist)
+
+    def _added_new(self, dist):
+        for callback in self.callbacks:
+            callback(dist)
+
+    def __getstate__(self):
+        return (
+            self.entries[:],
+            self.entry_keys.copy(),
+            self.by_key.copy(),
+            self.normalized_to_canonical_keys.copy(),
+            self.callbacks[:],
+        )
+
+    def __setstate__(self, e_k_b_n_c):
+        entries, keys, by_key, normalized_to_canonical_keys, callbacks = e_k_b_n_c
+        self.entries = entries[:]
+        self.entry_keys = keys.copy()
+        self.by_key = by_key.copy()
+        self.normalized_to_canonical_keys = normalized_to_canonical_keys.copy()
+        self.callbacks = callbacks[:]
+
+
+class _ReqExtras(Dict["Requirement", Tuple[str, ...]]):
+    """
+    Map each requirement to the extras that demanded it.
+    """
+
+    def markers_pass(self, req: Requirement, extras: tuple[str, ...] | None = None):
+        """
+        Evaluate markers for req against each extra that
+        demanded it.
+
+        Return False if the req has a marker and fails
+        evaluation. Otherwise, return True.
+        """
+        extra_evals = (
+            req.marker.evaluate({'extra': extra})
+            for extra in self.get(req, ()) + (extras or (None,))
+        )
+        return not req.marker or any(extra_evals)
+
+
+class Environment:
+    """Searchable snapshot of distributions on a search path"""
+
+    def __init__(
+        self,
+        search_path: Iterable[str] | None = None,
+        platform: str | None = get_supported_platform(),
+        python: str | None = PY_MAJOR,
+    ):
+        """Snapshot distributions available on a search path
+
+        Any distributions found on `search_path` are added to the environment.
+        `search_path` should be a sequence of ``sys.path`` items.  If not
+        supplied, ``sys.path`` is used.
+
+        `platform` is an optional string specifying the name of the platform
+        that platform-specific distributions must be compatible with.  If
+        unspecified, it defaults to the current platform.  `python` is an
+        optional string naming the desired version of Python (e.g. ``'3.6'``);
+        it defaults to the current version.
+
+        You may explicitly set `platform` (and/or `python`) to ``None`` if you
+        wish to map *all* distributions, not just those compatible with the
+        running platform or Python version.
+        """
+        self._distmap = {}
+        self.platform = platform
+        self.python = python
+        self.scan(search_path)
+
+    def can_add(self, dist: Distribution):
+        """Is distribution `dist` acceptable for this environment?
+
+        The distribution must match the platform and python version
+        requirements specified when this environment was created, or False
+        is returned.
+        """
+        py_compat = (
+            self.python is None
+            or dist.py_version is None
+            or dist.py_version == self.python
+        )
+        return py_compat and compatible_platforms(dist.platform, self.platform)
+
+    def remove(self, dist: Distribution):
+        """Remove `dist` from the environment"""
+        self._distmap[dist.key].remove(dist)
+
+    def scan(self, search_path: Iterable[str] | None = None):
+        """Scan `search_path` for distributions usable in this environment
+
+        Any distributions found are added to the environment.
+        `search_path` should be a sequence of ``sys.path`` items.  If not
+        supplied, ``sys.path`` is used.  Only distributions conforming to
+        the platform/python version defined at initialization are added.
+        """
+        if search_path is None:
+            search_path = sys.path
+
+        for item in search_path:
+            for dist in find_distributions(item):
+                self.add(dist)
+
+    def __getitem__(self, project_name: str) -> list[Distribution]:
+        """Return a newest-to-oldest list of distributions for `project_name`
+
+        Uses case-insensitive `project_name` comparison, assuming all the
+        project's distributions use their project's name converted to all
+        lowercase as their key.
+
+        """
+        distribution_key = project_name.lower()
+        return self._distmap.get(distribution_key, [])
+
+    def add(self, dist: Distribution):
+        """Add `dist` if we ``can_add()`` it and it has not already been added"""
+        if self.can_add(dist) and dist.has_version():
+            dists = self._distmap.setdefault(dist.key, [])
+            if dist not in dists:
+                dists.append(dist)
+                dists.sort(key=operator.attrgetter('hashcmp'), reverse=True)
+
+    @overload
+    def best_match(
+        self,
+        req: Requirement,
+        working_set: WorkingSet,
+        installer: _InstallerTypeT[_DistributionT],
+        replace_conflicting: bool = False,
+    ) -> _DistributionT: ...
+    @overload
+    def best_match(
+        self,
+        req: Requirement,
+        working_set: WorkingSet,
+        installer: _InstallerType | None = None,
+        replace_conflicting: bool = False,
+    ) -> Distribution | None: ...
+    def best_match(
+        self,
+        req: Requirement,
+        working_set: WorkingSet,
+        installer: _InstallerType | None | _InstallerTypeT[_DistributionT] = None,
+        replace_conflicting: bool = False,
+    ) -> Distribution | None:
+        """Find distribution best matching `req` and usable on `working_set`
+
+        This calls the ``find(req)`` method of the `working_set` to see if a
+        suitable distribution is already active.  (This may raise
+        ``VersionConflict`` if an unsuitable version of the project is already
+        active in the specified `working_set`.)  If a suitable distribution
+        isn't active, this method returns the newest distribution in the
+        environment that meets the ``Requirement`` in `req`.  If no suitable
+        distribution is found, and `installer` is supplied, then the result of
+        calling the environment's ``obtain(req, installer)`` method will be
+        returned.
+        """
+        try:
+            dist = working_set.find(req)
+        except VersionConflict:
+            if not replace_conflicting:
+                raise
+            dist = None
+        if dist is not None:
+            return dist
+        for dist in self[req.key]:
+            if dist in req:
+                return dist
+        # try to download/install
+        return self.obtain(req, installer)
+
+    @overload
+    def obtain(
+        self,
+        requirement: Requirement,
+        installer: _InstallerTypeT[_DistributionT],
+    ) -> _DistributionT: ...
+    @overload
+    def obtain(
+        self,
+        requirement: Requirement,
+        installer: Callable[[Requirement], None] | None = None,
+    ) -> None: ...
+    @overload
+    def obtain(
+        self,
+        requirement: Requirement,
+        installer: _InstallerType | None = None,
+    ) -> Distribution | None: ...
+    def obtain(
+        self,
+        requirement: Requirement,
+        installer: Callable[[Requirement], None]
+        | _InstallerType
+        | None
+        | _InstallerTypeT[_DistributionT] = None,
+    ) -> Distribution | None:
+        """Obtain a distribution matching `requirement` (e.g. via download)
+
+        Obtain a distro that matches requirement (e.g. via download).  In the
+        base ``Environment`` class, this routine just returns
+        ``installer(requirement)``, unless `installer` is None, in which case
+        None is returned instead.  This method is a hook that allows subclasses
+        to attempt other ways of obtaining a distribution before falling back
+        to the `installer` argument."""
+        return installer(requirement) if installer else None
+
+    def __iter__(self) -> Iterator[str]:
+        """Yield the unique project names of the available distributions"""
+        for key in self._distmap.keys():
+            if self[key]:
+                yield key
+
+    def __iadd__(self, other: Distribution | Environment):
+        """In-place addition of a distribution or environment"""
+        if isinstance(other, Distribution):
+            self.add(other)
+        elif isinstance(other, Environment):
+            for project in other:
+                for dist in other[project]:
+                    self.add(dist)
+        else:
+            raise TypeError("Can't add %r to environment" % (other,))
+        return self
+
+    def __add__(self, other: Distribution | Environment):
+        """Add an environment or distribution to an environment"""
+        new = self.__class__([], platform=None, python=None)
+        for env in self, other:
+            new += env
+        return new
+
+
+# XXX backward compatibility
+AvailableDistributions = Environment
+
+
+class ExtractionError(RuntimeError):
+    """An error occurred extracting a resource
+
+    The following attributes are available from instances of this exception:
+
+    manager
+        The resource manager that raised this exception
+
+    cache_path
+        The base directory for resource extraction
+
+    original_error
+        The exception instance that caused extraction to fail
+    """
+
+    manager: ResourceManager
+    cache_path: str
+    original_error: BaseException | None
+
+
+class ResourceManager:
+    """Manage resource extraction and packages"""
+
+    extraction_path: str | None = None
+
+    def __init__(self):
+        self.cached_files = {}
+
+    def resource_exists(self, package_or_requirement: _PkgReqType, resource_name: str):
+        """Does the named resource exist?"""
+        return get_provider(package_or_requirement).has_resource(resource_name)
+
+    def resource_isdir(self, package_or_requirement: _PkgReqType, resource_name: str):
+        """Is the named resource an existing directory?"""
+        return get_provider(package_or_requirement).resource_isdir(resource_name)
+
+    def resource_filename(
+        self, package_or_requirement: _PkgReqType, resource_name: str
+    ):
+        """Return a true filesystem path for specified resource"""
+        return get_provider(package_or_requirement).get_resource_filename(
+            self, resource_name
+        )
+
+    def resource_stream(self, package_or_requirement: _PkgReqType, resource_name: str):
+        """Return a readable file-like object for specified resource"""
+        return get_provider(package_or_requirement).get_resource_stream(
+            self, resource_name
+        )
+
+    def resource_string(
+        self, package_or_requirement: _PkgReqType, resource_name: str
+    ) -> bytes:
+        """Return specified resource as :obj:`bytes`"""
+        return get_provider(package_or_requirement).get_resource_string(
+            self, resource_name
+        )
+
+    def resource_listdir(self, package_or_requirement: _PkgReqType, resource_name: str):
+        """List the contents of the named resource directory"""
+        return get_provider(package_or_requirement).resource_listdir(resource_name)
+
+    def extraction_error(self) -> NoReturn:
+        """Give an error message for problems extracting file(s)"""
+
+        old_exc = sys.exc_info()[1]
+        cache_path = self.extraction_path or get_default_cache()
+
+        tmpl = textwrap.dedent(
+            """
+            Can't extract file(s) to egg cache
+
+            The following error occurred while trying to extract file(s)
+            to the Python egg cache:
+
+              {old_exc}
+
+            The Python egg cache directory is currently set to:
+
+              {cache_path}
+
+            Perhaps your account does not have write access to this directory?
+            You can change the cache directory by setting the PYTHON_EGG_CACHE
+            environment variable to point to an accessible directory.
+            """
+        ).lstrip()
+        err = ExtractionError(tmpl.format(**locals()))
+        err.manager = self
+        err.cache_path = cache_path
+        err.original_error = old_exc
+        raise err
+
+    def get_cache_path(self, archive_name: str, names: Iterable[StrPath] = ()):
+        """Return absolute location in cache for `archive_name` and `names`
+
+        The parent directory of the resulting path will be created if it does
+        not already exist.  `archive_name` should be the base filename of the
+        enclosing egg (which may not be the name of the enclosing zipfile!),
+        including its ".egg" extension.  `names`, if provided, should be a
+        sequence of path name parts "under" the egg's extraction location.
+
+        This method should only be called by resource providers that need to
+        obtain an extraction location, and only for names they intend to
+        extract, as it tracks the generated names for possible cleanup later.
+        """
+        extract_path = self.extraction_path or get_default_cache()
+        target_path = os.path.join(extract_path, archive_name + '-tmp', *names)
+        try:
+            _bypass_ensure_directory(target_path)
+        except Exception:
+            self.extraction_error()
+
+        self._warn_unsafe_extraction_path(extract_path)
+
+        self.cached_files[target_path] = True
+        return target_path
+
+    @staticmethod
+    def _warn_unsafe_extraction_path(path):
+        """
+        If the default extraction path is overridden and set to an insecure
+        location, such as /tmp, it opens up an opportunity for an attacker to
+        replace an extracted file with an unauthorized payload. Warn the user
+        if a known insecure location is used.
+
+        See Distribute #375 for more details.
+        """
+        if os.name == 'nt' and not path.startswith(os.environ['windir']):
+            # On Windows, permissions are generally restrictive by default
+            #  and temp directories are not writable by other users, so
+            #  bypass the warning.
+            return
+        mode = os.stat(path).st_mode
+        if mode & stat.S_IWOTH or mode & stat.S_IWGRP:
+            msg = (
+                "Extraction path is writable by group/others "
+                "and vulnerable to attack when "
+                "used with get_resource_filename ({path}). "
+                "Consider a more secure "
+                "location (set with .set_extraction_path or the "
+                "PYTHON_EGG_CACHE environment variable)."
+            ).format(**locals())
+            warnings.warn(msg, UserWarning)
+
+    def postprocess(self, tempname: StrOrBytesPath, filename: StrOrBytesPath):
+        """Perform any platform-specific postprocessing of `tempname`
+
+        This is where Mac header rewrites should be done; other platforms don't
+        have anything special they should do.
+
+        Resource providers should call this method ONLY after successfully
+        extracting a compressed resource.  They must NOT call it on resources
+        that are already in the filesystem.
+
+        `tempname` is the current (temporary) name of the file, and `filename`
+        is the name it will be renamed to by the caller after this routine
+        returns.
+        """
+
+        if os.name == 'posix':
+            # Make the resource executable
+            mode = ((os.stat(tempname).st_mode) | 0o555) & 0o7777
+            os.chmod(tempname, mode)
+
+    def set_extraction_path(self, path: str):
+        """Set the base path where resources will be extracted to, if needed.
+
+        If you do not call this routine before any extractions take place, the
+        path defaults to the return value of ``get_default_cache()``.  (Which
+        is based on the ``PYTHON_EGG_CACHE`` environment variable, with various
+        platform-specific fallbacks.  See that routine's documentation for more
+        details.)
+
+        Resources are extracted to subdirectories of this path based upon
+        information given by the ``IResourceProvider``.  You may set this to a
+        temporary directory, but then you must call ``cleanup_resources()`` to
+        delete the extracted files when done.  There is no guarantee that
+        ``cleanup_resources()`` will be able to remove all extracted files.
+
+        (Note: you may not change the extraction path for a given resource
+        manager once resources have been extracted, unless you first call
+        ``cleanup_resources()``.)
+        """
+        if self.cached_files:
+            raise ValueError("Can't change extraction path, files already extracted")
+
+        self.extraction_path = path
+
+    def cleanup_resources(self, force: bool = False) -> list[str]:
+        """
+        Delete all extracted resource files and directories, returning a list
+        of the file and directory names that could not be successfully removed.
+        This function does not have any concurrency protection, so it should
+        generally only be called when the extraction path is a temporary
+        directory exclusive to a single process.  This method is not
+        automatically called; you must call it explicitly or register it as an
+        ``atexit`` function if you wish to ensure cleanup of a temporary
+        directory used for extractions.
+        """
+        # XXX
+        return []
+
+
+def get_default_cache() -> str:
+    """
+    Return the ``PYTHON_EGG_CACHE`` environment variable
+    or a platform-relevant user cache dir for an app
+    named "Python-Eggs".
+    """
+    return os.environ.get('PYTHON_EGG_CACHE') or _user_cache_dir(appname='Python-Eggs')
+
+
+def safe_name(name: str):
+    """Convert an arbitrary string to a standard distribution name
+
+    Any runs of non-alphanumeric/. characters are replaced with a single '-'.
+    """
+    return re.sub('[^A-Za-z0-9.]+', '-', name)
+
+
+def safe_version(version: str):
+    """
+    Convert an arbitrary string to a standard version string
+    """
+    try:
+        # normalize the version
+        return str(_packaging_version.Version(version))
+    except _packaging_version.InvalidVersion:
+        version = version.replace(' ', '.')
+        return re.sub('[^A-Za-z0-9.]+', '-', version)
+
+
+def _forgiving_version(version):
+    """Fallback when ``safe_version`` is not safe enough
+    >>> parse_version(_forgiving_version('0.23ubuntu1'))
+    
+    >>> parse_version(_forgiving_version('0.23-'))
+    
+    >>> parse_version(_forgiving_version('0.-_'))
+    
+    >>> parse_version(_forgiving_version('42.+?1'))
+    
+    >>> parse_version(_forgiving_version('hello world'))
+    
+    """
+    version = version.replace(' ', '.')
+    match = _PEP440_FALLBACK.search(version)
+    if match:
+        safe = match["safe"]
+        rest = version[len(safe) :]
+    else:
+        safe = "0"
+        rest = version
+    local = f"sanitized.{_safe_segment(rest)}".strip(".")
+    return f"{safe}.dev0+{local}"
+
+
+def _safe_segment(segment):
+    """Convert an arbitrary string into a safe segment"""
+    segment = re.sub('[^A-Za-z0-9.]+', '-', segment)
+    segment = re.sub('-[^A-Za-z0-9]+', '-', segment)
+    return re.sub(r'\.[^A-Za-z0-9]+', '.', segment).strip(".-")
+
+
+def safe_extra(extra: str):
+    """Convert an arbitrary string to a standard 'extra' name
+
+    Any runs of non-alphanumeric characters are replaced with a single '_',
+    and the result is always lowercased.
+    """
+    return re.sub('[^A-Za-z0-9.-]+', '_', extra).lower()
+
+
+def to_filename(name: str):
+    """Convert a project or version name to its filename-escaped form
+
+    Any '-' characters are currently replaced with '_'.
+    """
+    return name.replace('-', '_')
+
+
+def invalid_marker(text: str):
+    """
+    Validate text as a PEP 508 environment marker; return an exception
+    if invalid or False otherwise.
+    """
+    try:
+        evaluate_marker(text)
+    except SyntaxError as e:
+        e.filename = None
+        e.lineno = None
+        return e
+    return False
+
+
+def evaluate_marker(text: str, extra: str | None = None) -> bool:
+    """
+    Evaluate a PEP 508 environment marker.
+    Return a boolean indicating the marker result in this environment.
+    Raise SyntaxError if marker is invalid.
+
+    This implementation uses the 'pyparsing' module.
+    """
+    try:
+        marker = _packaging_markers.Marker(text)
+        return marker.evaluate()
+    except _packaging_markers.InvalidMarker as e:
+        raise SyntaxError(e) from e
+
+
+class NullProvider:
+    """Try to implement resources and metadata for arbitrary PEP 302 loaders"""
+
+    egg_name: str | None = None
+    egg_info: str | None = None
+    loader: _LoaderProtocol | None = None
+
+    def __init__(self, module: _ModuleLike):
+        self.loader = getattr(module, '__loader__', None)
+        self.module_path = os.path.dirname(getattr(module, '__file__', ''))
+
+    def get_resource_filename(self, manager: ResourceManager, resource_name: str):
+        return self._fn(self.module_path, resource_name)
+
+    def get_resource_stream(self, manager: ResourceManager, resource_name: str):
+        return io.BytesIO(self.get_resource_string(manager, resource_name))
+
+    def get_resource_string(
+        self, manager: ResourceManager, resource_name: str
+    ) -> bytes:
+        return self._get(self._fn(self.module_path, resource_name))
+
+    def has_resource(self, resource_name: str):
+        return self._has(self._fn(self.module_path, resource_name))
+
+    def _get_metadata_path(self, name):
+        return self._fn(self.egg_info, name)
+
+    def has_metadata(self, name: str) -> bool:
+        if not self.egg_info:
+            return False
+
+        path = self._get_metadata_path(name)
+        return self._has(path)
+
+    def get_metadata(self, name: str):
+        if not self.egg_info:
+            return ""
+        path = self._get_metadata_path(name)
+        value = self._get(path)
+        try:
+            return value.decode('utf-8')
+        except UnicodeDecodeError as exc:
+            # Include the path in the error message to simplify
+            # troubleshooting, and without changing the exception type.
+            exc.reason += ' in {} file at path: {}'.format(name, path)
+            raise
+
+    def get_metadata_lines(self, name: str) -> Iterator[str]:
+        return yield_lines(self.get_metadata(name))
+
+    def resource_isdir(self, resource_name: str):
+        return self._isdir(self._fn(self.module_path, resource_name))
+
+    def metadata_isdir(self, name: str) -> bool:
+        return bool(self.egg_info and self._isdir(self._fn(self.egg_info, name)))
+
+    def resource_listdir(self, resource_name: str):
+        return self._listdir(self._fn(self.module_path, resource_name))
+
+    def metadata_listdir(self, name: str) -> list[str]:
+        if self.egg_info:
+            return self._listdir(self._fn(self.egg_info, name))
+        return []
+
+    def run_script(self, script_name: str, namespace: dict[str, Any]):
+        script = 'scripts/' + script_name
+        if not self.has_metadata(script):
+            raise ResolutionError(
+                "Script {script!r} not found in metadata at {self.egg_info!r}".format(
+                    **locals()
+                ),
+            )
+
+        script_text = self.get_metadata(script).replace('\r\n', '\n')
+        script_text = script_text.replace('\r', '\n')
+        script_filename = self._fn(self.egg_info, script)
+        namespace['__file__'] = script_filename
+        if os.path.exists(script_filename):
+            source = _read_utf8_with_fallback(script_filename)
+            code = compile(source, script_filename, 'exec')
+            exec(code, namespace, namespace)
+        else:
+            from linecache import cache
+
+            cache[script_filename] = (
+                len(script_text),
+                0,
+                script_text.split('\n'),
+                script_filename,
+            )
+            script_code = compile(script_text, script_filename, 'exec')
+            exec(script_code, namespace, namespace)
+
+    def _has(self, path) -> bool:
+        raise NotImplementedError(
+            "Can't perform this operation for unregistered loader type"
+        )
+
+    def _isdir(self, path) -> bool:
+        raise NotImplementedError(
+            "Can't perform this operation for unregistered loader type"
+        )
+
+    def _listdir(self, path) -> list[str]:
+        raise NotImplementedError(
+            "Can't perform this operation for unregistered loader type"
+        )
+
+    def _fn(self, base: str | None, resource_name: str):
+        if base is None:
+            raise TypeError(
+                "`base` parameter in `_fn` is `None`. Either override this method or check the parameter first."
+            )
+        self._validate_resource_path(resource_name)
+        if resource_name:
+            return os.path.join(base, *resource_name.split('/'))
+        return base
+
+    @staticmethod
+    def _validate_resource_path(path):
+        """
+        Validate the resource paths according to the docs.
+        https://setuptools.pypa.io/en/latest/pkg_resources.html#basic-resource-access
+
+        >>> warned = getfixture('recwarn')
+        >>> warnings.simplefilter('always')
+        >>> vrp = NullProvider._validate_resource_path
+        >>> vrp('foo/bar.txt')
+        >>> bool(warned)
+        False
+        >>> vrp('../foo/bar.txt')
+        >>> bool(warned)
+        True
+        >>> warned.clear()
+        >>> vrp('/foo/bar.txt')
+        >>> bool(warned)
+        True
+        >>> vrp('foo/../../bar.txt')
+        >>> bool(warned)
+        True
+        >>> warned.clear()
+        >>> vrp('foo/f../bar.txt')
+        >>> bool(warned)
+        False
+
+        Windows path separators are straight-up disallowed.
+        >>> vrp(r'\\foo/bar.txt')
+        Traceback (most recent call last):
+        ...
+        ValueError: Use of .. or absolute path in a resource path \
+is not allowed.
+
+        >>> vrp(r'C:\\foo/bar.txt')
+        Traceback (most recent call last):
+        ...
+        ValueError: Use of .. or absolute path in a resource path \
+is not allowed.
+
+        Blank values are allowed
+
+        >>> vrp('')
+        >>> bool(warned)
+        False
+
+        Non-string values are not.
+
+        >>> vrp(None)
+        Traceback (most recent call last):
+        ...
+        AttributeError: ...
+        """
+        invalid = (
+            os.path.pardir in path.split(posixpath.sep)
+            or posixpath.isabs(path)
+            or ntpath.isabs(path)
+            or path.startswith("\\")
+        )
+        if not invalid:
+            return
+
+        msg = "Use of .. or absolute path in a resource path is not allowed."
+
+        # Aggressively disallow Windows absolute paths
+        if (path.startswith("\\") or ntpath.isabs(path)) and not posixpath.isabs(path):
+            raise ValueError(msg)
+
+        # for compatibility, warn; in future
+        # raise ValueError(msg)
+        issue_warning(
+            msg[:-1] + " and will raise exceptions in a future release.",
+            DeprecationWarning,
+        )
+
+    def _get(self, path) -> bytes:
+        if hasattr(self.loader, 'get_data') and self.loader:
+            # Already checked get_data exists
+            return self.loader.get_data(path)  # type: ignore[attr-defined]
+        raise NotImplementedError(
+            "Can't perform this operation for loaders without 'get_data()'"
+        )
+
+
+register_loader_type(object, NullProvider)
+
+
+def _parents(path):
+    """
+    yield all parents of path including path
+    """
+    last = None
+    while path != last:
+        yield path
+        last = path
+        path, _ = os.path.split(path)
+
+
+class EggProvider(NullProvider):
+    """Provider based on a virtual filesystem"""
+
+    def __init__(self, module: _ModuleLike):
+        super().__init__(module)
+        self._setup_prefix()
+
+    def _setup_prefix(self):
+        # Assume that metadata may be nested inside a "basket"
+        # of multiple eggs and use module_path instead of .archive.
+        eggs = filter(_is_egg_path, _parents(self.module_path))
+        egg = next(eggs, None)
+        egg and self._set_egg(egg)
+
+    def _set_egg(self, path: str):
+        self.egg_name = os.path.basename(path)
+        self.egg_info = os.path.join(path, 'EGG-INFO')
+        self.egg_root = path
+
+
+class DefaultProvider(EggProvider):
+    """Provides access to package resources in the filesystem"""
+
+    def _has(self, path) -> bool:
+        return os.path.exists(path)
+
+    def _isdir(self, path) -> bool:
+        return os.path.isdir(path)
+
+    def _listdir(self, path):
+        return os.listdir(path)
+
+    def get_resource_stream(self, manager: object, resource_name: str):
+        return open(self._fn(self.module_path, resource_name), 'rb')
+
+    def _get(self, path) -> bytes:
+        with open(path, 'rb') as stream:
+            return stream.read()
+
+    @classmethod
+    def _register(cls):
+        loader_names = (
+            'SourceFileLoader',
+            'SourcelessFileLoader',
+        )
+        for name in loader_names:
+            loader_cls = getattr(importlib.machinery, name, type(None))
+            register_loader_type(loader_cls, cls)
+
+
+DefaultProvider._register()
+
+
+class EmptyProvider(NullProvider):
+    """Provider that returns nothing for all requests"""
+
+    # A special case, we don't want all Providers inheriting from NullProvider to have a potentially None module_path
+    module_path: str | None = None  # type: ignore[assignment]
+
+    _isdir = _has = lambda self, path: False
+
+    def _get(self, path) -> bytes:
+        return b''
+
+    def _listdir(self, path):
+        return []
+
+    def __init__(self):
+        pass
+
+
+empty_provider = EmptyProvider()
+
+
+class ZipManifests(Dict[str, "MemoizedZipManifests.manifest_mod"]):
+    """
+    zip manifest builder
+    """
+
+    # `path` could be `StrPath | IO[bytes]` but that violates the LSP for `MemoizedZipManifests.load`
+    @classmethod
+    def build(cls, path: str):
+        """
+        Build a dictionary similar to the zipimport directory
+        caches, except instead of tuples, store ZipInfo objects.
+
+        Use a platform-specific path separator (os.sep) for the path keys
+        for compatibility with pypy on Windows.
+        """
+        with zipfile.ZipFile(path) as zfile:
+            items = (
+                (
+                    name.replace('/', os.sep),
+                    zfile.getinfo(name),
+                )
+                for name in zfile.namelist()
+            )
+            return dict(items)
+
+    load = build
+
+
+class MemoizedZipManifests(ZipManifests):
+    """
+    Memoized zipfile manifests.
+    """
+
+    class manifest_mod(NamedTuple):
+        manifest: dict[str, zipfile.ZipInfo]
+        mtime: float
+
+    def load(self, path: str) -> dict[str, zipfile.ZipInfo]:  # type: ignore[override] # ZipManifests.load is a classmethod
+        """
+        Load a manifest at path or return a suitable manifest already loaded.
+        """
+        path = os.path.normpath(path)
+        mtime = os.stat(path).st_mtime
+
+        if path not in self or self[path].mtime != mtime:
+            manifest = self.build(path)
+            self[path] = self.manifest_mod(manifest, mtime)
+
+        return self[path].manifest
+
+
+class ZipProvider(EggProvider):
+    """Resource support for zips and eggs"""
+
+    eagers: list[str] | None = None
+    _zip_manifests = MemoizedZipManifests()
+    # ZipProvider's loader should always be a zipimporter or equivalent
+    loader: zipimport.zipimporter
+
+    def __init__(self, module: _ZipLoaderModule):
+        super().__init__(module)
+        self.zip_pre = self.loader.archive + os.sep
+
+    def _zipinfo_name(self, fspath):
+        # Convert a virtual filename (full path to file) into a zipfile subpath
+        # usable with the zipimport directory cache for our target archive
+        fspath = fspath.rstrip(os.sep)
+        if fspath == self.loader.archive:
+            return ''
+        if fspath.startswith(self.zip_pre):
+            return fspath[len(self.zip_pre) :]
+        raise AssertionError("%s is not a subpath of %s" % (fspath, self.zip_pre))
+
+    def _parts(self, zip_path):
+        # Convert a zipfile subpath into an egg-relative path part list.
+        # pseudo-fs path
+        fspath = self.zip_pre + zip_path
+        if fspath.startswith(self.egg_root + os.sep):
+            return fspath[len(self.egg_root) + 1 :].split(os.sep)
+        raise AssertionError("%s is not a subpath of %s" % (fspath, self.egg_root))
+
+    @property
+    def zipinfo(self):
+        return self._zip_manifests.load(self.loader.archive)
+
+    def get_resource_filename(self, manager: ResourceManager, resource_name: str):
+        if not self.egg_name:
+            raise NotImplementedError(
+                "resource_filename() only supported for .egg, not .zip"
+            )
+        # no need to lock for extraction, since we use temp names
+        zip_path = self._resource_to_zip(resource_name)
+        eagers = self._get_eager_resources()
+        if '/'.join(self._parts(zip_path)) in eagers:
+            for name in eagers:
+                self._extract_resource(manager, self._eager_to_zip(name))
+        return self._extract_resource(manager, zip_path)
+
+    @staticmethod
+    def _get_date_and_size(zip_stat):
+        size = zip_stat.file_size
+        # ymdhms+wday, yday, dst
+        date_time = zip_stat.date_time + (0, 0, -1)
+        # 1980 offset already done
+        timestamp = time.mktime(date_time)
+        return timestamp, size
+
+    # FIXME: 'ZipProvider._extract_resource' is too complex (12)
+    def _extract_resource(self, manager: ResourceManager, zip_path) -> str:  # noqa: C901
+        if zip_path in self._index():
+            for name in self._index()[zip_path]:
+                last = self._extract_resource(manager, os.path.join(zip_path, name))
+            # return the extracted directory name
+            return os.path.dirname(last)
+
+        timestamp, size = self._get_date_and_size(self.zipinfo[zip_path])
+
+        if not WRITE_SUPPORT:
+            raise OSError(
+                '"os.rename" and "os.unlink" are not supported on this platform'
+            )
+        try:
+            if not self.egg_name:
+                raise OSError(
+                    '"egg_name" is empty. This likely means no egg could be found from the "module_path".'
+                )
+            real_path = manager.get_cache_path(self.egg_name, self._parts(zip_path))
+
+            if self._is_current(real_path, zip_path):
+                return real_path
+
+            outf, tmpnam = _mkstemp(
+                ".$extract",
+                dir=os.path.dirname(real_path),
+            )
+            os.write(outf, self.loader.get_data(zip_path))
+            os.close(outf)
+            utime(tmpnam, (timestamp, timestamp))
+            manager.postprocess(tmpnam, real_path)
+
+            try:
+                rename(tmpnam, real_path)
+
+            except OSError:
+                if os.path.isfile(real_path):
+                    if self._is_current(real_path, zip_path):
+                        # the file became current since it was checked above,
+                        #  so proceed.
+                        return real_path
+                    # Windows, del old file and retry
+                    elif os.name == 'nt':
+                        unlink(real_path)
+                        rename(tmpnam, real_path)
+                        return real_path
+                raise
+
+        except OSError:
+            # report a user-friendly error
+            manager.extraction_error()
+
+        return real_path
+
+    def _is_current(self, file_path, zip_path):
+        """
+        Return True if the file_path is current for this zip_path
+        """
+        timestamp, size = self._get_date_and_size(self.zipinfo[zip_path])
+        if not os.path.isfile(file_path):
+            return False
+        stat = os.stat(file_path)
+        if stat.st_size != size or stat.st_mtime != timestamp:
+            return False
+        # check that the contents match
+        zip_contents = self.loader.get_data(zip_path)
+        with open(file_path, 'rb') as f:
+            file_contents = f.read()
+        return zip_contents == file_contents
+
+    def _get_eager_resources(self):
+        if self.eagers is None:
+            eagers = []
+            for name in ('native_libs.txt', 'eager_resources.txt'):
+                if self.has_metadata(name):
+                    eagers.extend(self.get_metadata_lines(name))
+            self.eagers = eagers
+        return self.eagers
+
+    def _index(self):
+        try:
+            return self._dirindex
+        except AttributeError:
+            ind = {}
+            for path in self.zipinfo:
+                parts = path.split(os.sep)
+                while parts:
+                    parent = os.sep.join(parts[:-1])
+                    if parent in ind:
+                        ind[parent].append(parts[-1])
+                        break
+                    else:
+                        ind[parent] = [parts.pop()]
+            self._dirindex = ind
+            return ind
+
+    def _has(self, fspath) -> bool:
+        zip_path = self._zipinfo_name(fspath)
+        return zip_path in self.zipinfo or zip_path in self._index()
+
+    def _isdir(self, fspath) -> bool:
+        return self._zipinfo_name(fspath) in self._index()
+
+    def _listdir(self, fspath):
+        return list(self._index().get(self._zipinfo_name(fspath), ()))
+
+    def _eager_to_zip(self, resource_name: str):
+        return self._zipinfo_name(self._fn(self.egg_root, resource_name))
+
+    def _resource_to_zip(self, resource_name: str):
+        return self._zipinfo_name(self._fn(self.module_path, resource_name))
+
+
+register_loader_type(zipimport.zipimporter, ZipProvider)
+
+
+class FileMetadata(EmptyProvider):
+    """Metadata handler for standalone PKG-INFO files
+
+    Usage::
+
+        metadata = FileMetadata("/path/to/PKG-INFO")
+
+    This provider rejects all data and metadata requests except for PKG-INFO,
+    which is treated as existing, and will be the contents of the file at
+    the provided location.
+    """
+
+    def __init__(self, path: StrPath):
+        self.path = path
+
+    def _get_metadata_path(self, name):
+        return self.path
+
+    def has_metadata(self, name: str) -> bool:
+        return name == 'PKG-INFO' and os.path.isfile(self.path)
+
+    def get_metadata(self, name: str):
+        if name != 'PKG-INFO':
+            raise KeyError("No metadata except PKG-INFO is available")
+
+        with open(self.path, encoding='utf-8', errors="replace") as f:
+            metadata = f.read()
+        self._warn_on_replacement(metadata)
+        return metadata
+
+    def _warn_on_replacement(self, metadata):
+        replacement_char = '�'
+        if replacement_char in metadata:
+            tmpl = "{self.path} could not be properly decoded in UTF-8"
+            msg = tmpl.format(**locals())
+            warnings.warn(msg)
+
+    def get_metadata_lines(self, name: str) -> Iterator[str]:
+        return yield_lines(self.get_metadata(name))
+
+
+class PathMetadata(DefaultProvider):
+    """Metadata provider for egg directories
+
+    Usage::
+
+        # Development eggs:
+
+        egg_info = "/path/to/PackageName.egg-info"
+        base_dir = os.path.dirname(egg_info)
+        metadata = PathMetadata(base_dir, egg_info)
+        dist_name = os.path.splitext(os.path.basename(egg_info))[0]
+        dist = Distribution(basedir, project_name=dist_name, metadata=metadata)
+
+        # Unpacked egg directories:
+
+        egg_path = "/path/to/PackageName-ver-pyver-etc.egg"
+        metadata = PathMetadata(egg_path, os.path.join(egg_path,'EGG-INFO'))
+        dist = Distribution.from_filename(egg_path, metadata=metadata)
+    """
+
+    def __init__(self, path: str, egg_info: str):
+        self.module_path = path
+        self.egg_info = egg_info
+
+
+class EggMetadata(ZipProvider):
+    """Metadata provider for .egg files"""
+
+    def __init__(self, importer: zipimport.zipimporter):
+        """Create a metadata provider from a zipimporter"""
+
+        self.zip_pre = importer.archive + os.sep
+        self.loader = importer
+        if importer.prefix:
+            self.module_path = os.path.join(importer.archive, importer.prefix)
+        else:
+            self.module_path = importer.archive
+        self._setup_prefix()
+
+
+_distribution_finders: dict[type, _DistFinderType[Any]] = _declare_state(
+    'dict', '_distribution_finders', {}
+)
+
+
+def register_finder(importer_type: type[_T], distribution_finder: _DistFinderType[_T]):
+    """Register `distribution_finder` to find distributions in sys.path items
+
+    `importer_type` is the type or class of a PEP 302 "Importer" (sys.path item
+    handler), and `distribution_finder` is a callable that, passed a path
+    item and the importer instance, yields ``Distribution`` instances found on
+    that path item.  See ``pkg_resources.find_on_path`` for an example."""
+    _distribution_finders[importer_type] = distribution_finder
+
+
+def find_distributions(path_item: str, only: bool = False):
+    """Yield distributions accessible via `path_item`"""
+    importer = get_importer(path_item)
+    finder = _find_adapter(_distribution_finders, importer)
+    return finder(importer, path_item, only)
+
+
+def find_eggs_in_zip(
+    importer: zipimport.zipimporter, path_item: str, only: bool = False
+) -> Iterator[Distribution]:
+    """
+    Find eggs in zip files; possibly multiple nested eggs.
+    """
+    if importer.archive.endswith('.whl'):
+        # wheels are not supported with this finder
+        # they don't have PKG-INFO metadata, and won't ever contain eggs
+        return
+    metadata = EggMetadata(importer)
+    if metadata.has_metadata('PKG-INFO'):
+        yield Distribution.from_filename(path_item, metadata=metadata)
+    if only:
+        # don't yield nested distros
+        return
+    for subitem in metadata.resource_listdir(''):
+        if _is_egg_path(subitem):
+            subpath = os.path.join(path_item, subitem)
+            dists = find_eggs_in_zip(zipimport.zipimporter(subpath), subpath)
+            yield from dists
+        elif subitem.lower().endswith(('.dist-info', '.egg-info')):
+            subpath = os.path.join(path_item, subitem)
+            submeta = EggMetadata(zipimport.zipimporter(subpath))
+            submeta.egg_info = subpath
+            yield Distribution.from_location(path_item, subitem, submeta)
+
+
+register_finder(zipimport.zipimporter, find_eggs_in_zip)
+
+
+def find_nothing(
+    importer: object | None, path_item: str | None, only: bool | None = False
+):
+    return ()
+
+
+register_finder(object, find_nothing)
+
+
+def find_on_path(importer: object | None, path_item, only=False):
+    """Yield distributions accessible on a sys.path directory"""
+    path_item = _normalize_cached(path_item)
+
+    if _is_unpacked_egg(path_item):
+        yield Distribution.from_filename(
+            path_item,
+            metadata=PathMetadata(path_item, os.path.join(path_item, 'EGG-INFO')),
+        )
+        return
+
+    entries = (os.path.join(path_item, child) for child in safe_listdir(path_item))
+
+    # scan for .egg and .egg-info in directory
+    for entry in sorted(entries):
+        fullpath = os.path.join(path_item, entry)
+        factory = dist_factory(path_item, entry, only)
+        yield from factory(fullpath)
+
+
+def dist_factory(path_item, entry, only):
+    """Return a dist_factory for the given entry."""
+    lower = entry.lower()
+    is_egg_info = lower.endswith('.egg-info')
+    is_dist_info = lower.endswith('.dist-info') and os.path.isdir(
+        os.path.join(path_item, entry)
+    )
+    is_meta = is_egg_info or is_dist_info
+    return (
+        distributions_from_metadata
+        if is_meta
+        else find_distributions
+        if not only and _is_egg_path(entry)
+        else resolve_egg_link
+        if not only and lower.endswith('.egg-link')
+        else NoDists()
+    )
+
+
+class NoDists:
+    """
+    >>> bool(NoDists())
+    False
+
+    >>> list(NoDists()('anything'))
+    []
+    """
+
+    def __bool__(self):
+        return False
+
+    def __call__(self, fullpath):
+        return iter(())
+
+
+def safe_listdir(path: StrOrBytesPath):
+    """
+    Attempt to list contents of path, but suppress some exceptions.
+    """
+    try:
+        return os.listdir(path)
+    except (PermissionError, NotADirectoryError):
+        pass
+    except OSError as e:
+        # Ignore the directory if does not exist, not a directory or
+        # permission denied
+        if e.errno not in (errno.ENOTDIR, errno.EACCES, errno.ENOENT):
+            raise
+    return ()
+
+
+def distributions_from_metadata(path: str):
+    root = os.path.dirname(path)
+    if os.path.isdir(path):
+        if len(os.listdir(path)) == 0:
+            # empty metadata dir; skip
+            return
+        metadata: _MetadataType = PathMetadata(root, path)
+    else:
+        metadata = FileMetadata(path)
+    entry = os.path.basename(path)
+    yield Distribution.from_location(
+        root,
+        entry,
+        metadata,
+        precedence=DEVELOP_DIST,
+    )
+
+
+def non_empty_lines(path):
+    """
+    Yield non-empty lines from file at path
+    """
+    for line in _read_utf8_with_fallback(path).splitlines():
+        line = line.strip()
+        if line:
+            yield line
+
+
+def resolve_egg_link(path):
+    """
+    Given a path to an .egg-link, resolve distributions
+    present in the referenced path.
+    """
+    referenced_paths = non_empty_lines(path)
+    resolved_paths = (
+        os.path.join(os.path.dirname(path), ref) for ref in referenced_paths
+    )
+    dist_groups = map(find_distributions, resolved_paths)
+    return next(dist_groups, ())
+
+
+if hasattr(pkgutil, 'ImpImporter'):
+    register_finder(pkgutil.ImpImporter, find_on_path)
+
+register_finder(importlib.machinery.FileFinder, find_on_path)
+
+_namespace_handlers: dict[type, _NSHandlerType[Any]] = _declare_state(
+    'dict', '_namespace_handlers', {}
+)
+_namespace_packages: dict[str | None, list[str]] = _declare_state(
+    'dict', '_namespace_packages', {}
+)
+
+
+def register_namespace_handler(
+    importer_type: type[_T], namespace_handler: _NSHandlerType[_T]
+):
+    """Register `namespace_handler` to declare namespace packages
+
+    `importer_type` is the type or class of a PEP 302 "Importer" (sys.path item
+    handler), and `namespace_handler` is a callable like this::
+
+        def namespace_handler(importer, path_entry, moduleName, module):
+            # return a path_entry to use for child packages
+
+    Namespace handlers are only called if the importer object has already
+    agreed that it can handle the relevant path item, and they should only
+    return a subpath if the module __path__ does not already contain an
+    equivalent subpath.  For an example namespace handler, see
+    ``pkg_resources.file_ns_handler``.
+    """
+    _namespace_handlers[importer_type] = namespace_handler
+
+
+def _handle_ns(packageName, path_item):
+    """Ensure that named package includes a subpath of path_item (if needed)"""
+
+    importer = get_importer(path_item)
+    if importer is None:
+        return None
+
+    # use find_spec (PEP 451) and fall-back to find_module (PEP 302)
+    try:
+        spec = importer.find_spec(packageName)
+    except AttributeError:
+        # capture warnings due to #1111
+        with warnings.catch_warnings():
+            warnings.simplefilter("ignore")
+            loader = importer.find_module(packageName)
+    else:
+        loader = spec.loader if spec else None
+
+    if loader is None:
+        return None
+    module = sys.modules.get(packageName)
+    if module is None:
+        module = sys.modules[packageName] = types.ModuleType(packageName)
+        module.__path__ = []
+        _set_parent_ns(packageName)
+    elif not hasattr(module, '__path__'):
+        raise TypeError("Not a package:", packageName)
+    handler = _find_adapter(_namespace_handlers, importer)
+    subpath = handler(importer, path_item, packageName, module)
+    if subpath is not None:
+        path = module.__path__
+        path.append(subpath)
+        importlib.import_module(packageName)
+        _rebuild_mod_path(path, packageName, module)
+    return subpath
+
+
+def _rebuild_mod_path(orig_path, package_name, module: types.ModuleType):
+    """
+    Rebuild module.__path__ ensuring that all entries are ordered
+    corresponding to their sys.path order
+    """
+    sys_path = [_normalize_cached(p) for p in sys.path]
+
+    def safe_sys_path_index(entry):
+        """
+        Workaround for #520 and #513.
+        """
+        try:
+            return sys_path.index(entry)
+        except ValueError:
+            return float('inf')
+
+    def position_in_sys_path(path):
+        """
+        Return the ordinal of the path based on its position in sys.path
+        """
+        path_parts = path.split(os.sep)
+        module_parts = package_name.count('.') + 1
+        parts = path_parts[:-module_parts]
+        return safe_sys_path_index(_normalize_cached(os.sep.join(parts)))
+
+    new_path = sorted(orig_path, key=position_in_sys_path)
+    new_path = [_normalize_cached(p) for p in new_path]
+
+    if isinstance(module.__path__, list):
+        module.__path__[:] = new_path
+    else:
+        module.__path__ = new_path
+
+
+def declare_namespace(packageName: str):
+    """Declare that package 'packageName' is a namespace package"""
+
+    msg = (
+        f"Deprecated call to `pkg_resources.declare_namespace({packageName!r})`.\n"
+        "Implementing implicit namespace packages (as specified in PEP 420) "
+        "is preferred to `pkg_resources.declare_namespace`. "
+        "See https://setuptools.pypa.io/en/latest/references/"
+        "keywords.html#keyword-namespace-packages"
+    )
+    warnings.warn(msg, DeprecationWarning, stacklevel=2)
+
+    _imp.acquire_lock()
+    try:
+        if packageName in _namespace_packages:
+            return
+
+        path: MutableSequence[str] = sys.path
+        parent, _, _ = packageName.rpartition('.')
+
+        if parent:
+            declare_namespace(parent)
+            if parent not in _namespace_packages:
+                __import__(parent)
+            try:
+                path = sys.modules[parent].__path__
+            except AttributeError as e:
+                raise TypeError("Not a package:", parent) from e
+
+        # Track what packages are namespaces, so when new path items are added,
+        # they can be updated
+        _namespace_packages.setdefault(parent or None, []).append(packageName)
+        _namespace_packages.setdefault(packageName, [])
+
+        for path_item in path:
+            # Ensure all the parent's path items are reflected in the child,
+            # if they apply
+            _handle_ns(packageName, path_item)
+
+    finally:
+        _imp.release_lock()
+
+
+def fixup_namespace_packages(path_item: str, parent: str | None = None):
+    """Ensure that previously-declared namespace packages include path_item"""
+    _imp.acquire_lock()
+    try:
+        for package in _namespace_packages.get(parent, ()):
+            subpath = _handle_ns(package, path_item)
+            if subpath:
+                fixup_namespace_packages(subpath, package)
+    finally:
+        _imp.release_lock()
+
+
+def file_ns_handler(
+    importer: object,
+    path_item: StrPath,
+    packageName: str,
+    module: types.ModuleType,
+):
+    """Compute an ns-package subpath for a filesystem or zipfile importer"""
+
+    subpath = os.path.join(path_item, packageName.split('.')[-1])
+    normalized = _normalize_cached(subpath)
+    for item in module.__path__:
+        if _normalize_cached(item) == normalized:
+            break
+    else:
+        # Only return the path if it's not already there
+        return subpath
+
+
+if hasattr(pkgutil, 'ImpImporter'):
+    register_namespace_handler(pkgutil.ImpImporter, file_ns_handler)
+
+register_namespace_handler(zipimport.zipimporter, file_ns_handler)
+register_namespace_handler(importlib.machinery.FileFinder, file_ns_handler)
+
+
+def null_ns_handler(
+    importer: object,
+    path_item: str | None,
+    packageName: str | None,
+    module: _ModuleLike | None,
+):
+    return None
+
+
+register_namespace_handler(object, null_ns_handler)
+
+
+@overload
+def normalize_path(filename: StrPath) -> str: ...
+@overload
+def normalize_path(filename: BytesPath) -> bytes: ...
+def normalize_path(filename: StrOrBytesPath):
+    """Normalize a file/dir name for comparison purposes"""
+    return os.path.normcase(os.path.realpath(os.path.normpath(_cygwin_patch(filename))))
+
+
+def _cygwin_patch(filename: StrOrBytesPath):  # pragma: nocover
+    """
+    Contrary to POSIX 2008, on Cygwin, getcwd (3) contains
+    symlink components. Using
+    os.path.abspath() works around this limitation. A fix in os.getcwd()
+    would probably better, in Cygwin even more so, except
+    that this seems to be by design...
+    """
+    return os.path.abspath(filename) if sys.platform == 'cygwin' else filename
+
+
+if TYPE_CHECKING:
+    # https://github.com/python/mypy/issues/16261
+    # https://github.com/python/typeshed/issues/6347
+    @overload
+    def _normalize_cached(filename: StrPath) -> str: ...
+    @overload
+    def _normalize_cached(filename: BytesPath) -> bytes: ...
+    def _normalize_cached(filename: StrOrBytesPath) -> str | bytes: ...
+else:
+
+    @functools.lru_cache(maxsize=None)
+    def _normalize_cached(filename):
+        return normalize_path(filename)
+
+
+def _is_egg_path(path):
+    """
+    Determine if given path appears to be an egg.
+    """
+    return _is_zip_egg(path) or _is_unpacked_egg(path)
+
+
+def _is_zip_egg(path):
+    return (
+        path.lower().endswith('.egg')
+        and os.path.isfile(path)
+        and zipfile.is_zipfile(path)
+    )
+
+
+def _is_unpacked_egg(path):
+    """
+    Determine if given path appears to be an unpacked egg.
+    """
+    return path.lower().endswith('.egg') and os.path.isfile(
+        os.path.join(path, 'EGG-INFO', 'PKG-INFO')
+    )
+
+
+def _set_parent_ns(packageName):
+    parts = packageName.split('.')
+    name = parts.pop()
+    if parts:
+        parent = '.'.join(parts)
+        setattr(sys.modules[parent], name, sys.modules[packageName])
+
+
+MODULE = re.compile(r"\w+(\.\w+)*$").match
+EGG_NAME = re.compile(
+    r"""
+    (?P[^-]+) (
+        -(?P[^-]+) (
+            -py(?P[^-]+) (
+                -(?P.+)
+            )?
+        )?
+    )?
+    """,
+    re.VERBOSE | re.IGNORECASE,
+).match
+
+
+class EntryPoint:
+    """Object representing an advertised importable object"""
+
+    def __init__(
+        self,
+        name: str,
+        module_name: str,
+        attrs: Iterable[str] = (),
+        extras: Iterable[str] = (),
+        dist: Distribution | None = None,
+    ):
+        if not MODULE(module_name):
+            raise ValueError("Invalid module name", module_name)
+        self.name = name
+        self.module_name = module_name
+        self.attrs = tuple(attrs)
+        self.extras = tuple(extras)
+        self.dist = dist
+
+    def __str__(self):
+        s = "%s = %s" % (self.name, self.module_name)
+        if self.attrs:
+            s += ':' + '.'.join(self.attrs)
+        if self.extras:
+            s += ' [%s]' % ','.join(self.extras)
+        return s
+
+    def __repr__(self):
+        return "EntryPoint.parse(%r)" % str(self)
+
+    @overload
+    def load(
+        self,
+        require: Literal[True] = True,
+        env: Environment | None = None,
+        installer: _InstallerType | None = None,
+    ) -> _ResolvedEntryPoint: ...
+    @overload
+    def load(
+        self,
+        require: Literal[False],
+        *args: Any,
+        **kwargs: Any,
+    ) -> _ResolvedEntryPoint: ...
+    def load(
+        self,
+        require: bool = True,
+        *args: Environment | _InstallerType | None,
+        **kwargs: Environment | _InstallerType | None,
+    ) -> _ResolvedEntryPoint:
+        """
+        Require packages for this EntryPoint, then resolve it.
+        """
+        if not require or args or kwargs:
+            warnings.warn(
+                "Parameters to load are deprecated.  Call .resolve and "
+                ".require separately.",
+                PkgResourcesDeprecationWarning,
+                stacklevel=2,
+            )
+        if require:
+            # We could pass `env` and `installer` directly,
+            # but keeping `*args` and `**kwargs` for backwards compatibility
+            self.require(*args, **kwargs)  # type: ignore
+        return self.resolve()
+
+    def resolve(self) -> _ResolvedEntryPoint:
+        """
+        Resolve the entry point from its module and attrs.
+        """
+        module = __import__(self.module_name, fromlist=['__name__'], level=0)
+        try:
+            return functools.reduce(getattr, self.attrs, module)
+        except AttributeError as exc:
+            raise ImportError(str(exc)) from exc
+
+    def require(
+        self,
+        env: Environment | None = None,
+        installer: _InstallerType | None = None,
+    ):
+        if not self.dist:
+            error_cls = UnknownExtra if self.extras else AttributeError
+            raise error_cls("Can't require() without a distribution", self)
+
+        # Get the requirements for this entry point with all its extras and
+        # then resolve them. We have to pass `extras` along when resolving so
+        # that the working set knows what extras we want. Otherwise, for
+        # dist-info distributions, the working set will assume that the
+        # requirements for that extra are purely optional and skip over them.
+        reqs = self.dist.requires(self.extras)
+        items = working_set.resolve(reqs, env, installer, extras=self.extras)
+        list(map(working_set.add, items))
+
+    pattern = re.compile(
+        r'\s*'
+        r'(?P.+?)\s*'
+        r'=\s*'
+        r'(?P[\w.]+)\s*'
+        r'(:\s*(?P[\w.]+))?\s*'
+        r'(?P\[.*\])?\s*$'
+    )
+
+    @classmethod
+    def parse(cls, src: str, dist: Distribution | None = None):
+        """Parse a single entry point from string `src`
+
+        Entry point syntax follows the form::
+
+            name = some.module:some.attr [extra1, extra2]
+
+        The entry name and module name are required, but the ``:attrs`` and
+        ``[extras]`` parts are optional
+        """
+        m = cls.pattern.match(src)
+        if not m:
+            msg = "EntryPoint must be in 'name=module:attrs [extras]' format"
+            raise ValueError(msg, src)
+        res = m.groupdict()
+        extras = cls._parse_extras(res['extras'])
+        attrs = res['attr'].split('.') if res['attr'] else ()
+        return cls(res['name'], res['module'], attrs, extras, dist)
+
+    @classmethod
+    def _parse_extras(cls, extras_spec):
+        if not extras_spec:
+            return ()
+        req = Requirement.parse('x' + extras_spec)
+        if req.specs:
+            raise ValueError
+        return req.extras
+
+    @classmethod
+    def parse_group(
+        cls,
+        group: str,
+        lines: _NestedStr,
+        dist: Distribution | None = None,
+    ):
+        """Parse an entry point group"""
+        if not MODULE(group):
+            raise ValueError("Invalid group name", group)
+        this: dict[str, Self] = {}
+        for line in yield_lines(lines):
+            ep = cls.parse(line, dist)
+            if ep.name in this:
+                raise ValueError("Duplicate entry point", group, ep.name)
+            this[ep.name] = ep
+        return this
+
+    @classmethod
+    def parse_map(
+        cls,
+        data: str | Iterable[str] | dict[str, str | Iterable[str]],
+        dist: Distribution | None = None,
+    ):
+        """Parse a map of entry point groups"""
+        _data: Iterable[tuple[str | None, str | Iterable[str]]]
+        if isinstance(data, dict):
+            _data = data.items()
+        else:
+            _data = split_sections(data)
+        maps: dict[str, dict[str, Self]] = {}
+        for group, lines in _data:
+            if group is None:
+                if not lines:
+                    continue
+                raise ValueError("Entry points must be listed in groups")
+            group = group.strip()
+            if group in maps:
+                raise ValueError("Duplicate group name", group)
+            maps[group] = cls.parse_group(group, lines, dist)
+        return maps
+
+
+def _version_from_file(lines):
+    """
+    Given an iterable of lines from a Metadata file, return
+    the value of the Version field, if present, or None otherwise.
+    """
+
+    def is_version_line(line):
+        return line.lower().startswith('version:')
+
+    version_lines = filter(is_version_line, lines)
+    line = next(iter(version_lines), '')
+    _, _, value = line.partition(':')
+    return safe_version(value.strip()) or None
+
+
+class Distribution:
+    """Wrap an actual or potential sys.path entry w/metadata"""
+
+    PKG_INFO = 'PKG-INFO'
+
+    def __init__(
+        self,
+        location: str | None = None,
+        metadata: _MetadataType = None,
+        project_name: str | None = None,
+        version: str | None = None,
+        py_version: str | None = PY_MAJOR,
+        platform: str | None = None,
+        precedence: int = EGG_DIST,
+    ):
+        self.project_name = safe_name(project_name or 'Unknown')
+        if version is not None:
+            self._version = safe_version(version)
+        self.py_version = py_version
+        self.platform = platform
+        self.location = location
+        self.precedence = precedence
+        self._provider = metadata or empty_provider
+
+    @classmethod
+    def from_location(
+        cls,
+        location: str,
+        basename: StrPath,
+        metadata: _MetadataType = None,
+        **kw: int,  # We could set `precedence` explicitly, but keeping this as `**kw` for full backwards and subclassing compatibility
+    ) -> Distribution:
+        project_name, version, py_version, platform = [None] * 4
+        basename, ext = os.path.splitext(basename)
+        if ext.lower() in _distributionImpl:
+            cls = _distributionImpl[ext.lower()]
+
+            match = EGG_NAME(basename)
+            if match:
+                project_name, version, py_version, platform = match.group(
+                    'name', 'ver', 'pyver', 'plat'
+                )
+        return cls(
+            location,
+            metadata,
+            project_name=project_name,
+            version=version,
+            py_version=py_version,
+            platform=platform,
+            **kw,
+        )._reload_version()
+
+    def _reload_version(self):
+        return self
+
+    @property
+    def hashcmp(self):
+        return (
+            self._forgiving_parsed_version,
+            self.precedence,
+            self.key,
+            self.location,
+            self.py_version or '',
+            self.platform or '',
+        )
+
+    def __hash__(self):
+        return hash(self.hashcmp)
+
+    def __lt__(self, other: Distribution):
+        return self.hashcmp < other.hashcmp
+
+    def __le__(self, other: Distribution):
+        return self.hashcmp <= other.hashcmp
+
+    def __gt__(self, other: Distribution):
+        return self.hashcmp > other.hashcmp
+
+    def __ge__(self, other: Distribution):
+        return self.hashcmp >= other.hashcmp
+
+    def __eq__(self, other: object):
+        if not isinstance(other, self.__class__):
+            # It's not a Distribution, so they are not equal
+            return False
+        return self.hashcmp == other.hashcmp
+
+    def __ne__(self, other: object):
+        return not self == other
+
+    # These properties have to be lazy so that we don't have to load any
+    # metadata until/unless it's actually needed.  (i.e., some distributions
+    # may not know their name or version without loading PKG-INFO)
+
+    @property
+    def key(self):
+        try:
+            return self._key
+        except AttributeError:
+            self._key = key = self.project_name.lower()
+            return key
+
+    @property
+    def parsed_version(self):
+        if not hasattr(self, "_parsed_version"):
+            try:
+                self._parsed_version = parse_version(self.version)
+            except _packaging_version.InvalidVersion as ex:
+                info = f"(package: {self.project_name})"
+                if hasattr(ex, "add_note"):
+                    ex.add_note(info)  # PEP 678
+                    raise
+                raise _packaging_version.InvalidVersion(f"{str(ex)} {info}") from None
+
+        return self._parsed_version
+
+    @property
+    def _forgiving_parsed_version(self):
+        try:
+            return self.parsed_version
+        except _packaging_version.InvalidVersion as ex:
+            self._parsed_version = parse_version(_forgiving_version(self.version))
+
+            notes = "\n".join(getattr(ex, "__notes__", []))  # PEP 678
+            msg = f"""!!\n\n
+            *************************************************************************
+            {str(ex)}\n{notes}
+
+            This is a long overdue deprecation.
+            For the time being, `pkg_resources` will use `{self._parsed_version}`
+            as a replacement to avoid breaking existing environments,
+            but no future compatibility is guaranteed.
+
+            If you maintain package {self.project_name} you should implement
+            the relevant changes to adequate the project to PEP 440 immediately.
+            *************************************************************************
+            \n\n!!
+            """
+            warnings.warn(msg, DeprecationWarning)
+
+            return self._parsed_version
+
+    @property
+    def version(self):
+        try:
+            return self._version
+        except AttributeError as e:
+            version = self._get_version()
+            if version is None:
+                path = self._get_metadata_path_for_display(self.PKG_INFO)
+                msg = ("Missing 'Version:' header and/or {} file at path: {}").format(
+                    self.PKG_INFO, path
+                )
+                raise ValueError(msg, self) from e
+
+            return version
+
+    @property
+    def _dep_map(self):
+        """
+        A map of extra to its list of (direct) requirements
+        for this distribution, including the null extra.
+        """
+        try:
+            return self.__dep_map
+        except AttributeError:
+            self.__dep_map = self._filter_extras(self._build_dep_map())
+        return self.__dep_map
+
+    @staticmethod
+    def _filter_extras(dm: dict[str | None, list[Requirement]]):
+        """
+        Given a mapping of extras to dependencies, strip off
+        environment markers and filter out any dependencies
+        not matching the markers.
+        """
+        for extra in list(filter(None, dm)):
+            new_extra: str | None = extra
+            reqs = dm.pop(extra)
+            new_extra, _, marker = extra.partition(':')
+            fails_marker = marker and (
+                invalid_marker(marker) or not evaluate_marker(marker)
+            )
+            if fails_marker:
+                reqs = []
+            new_extra = safe_extra(new_extra) or None
+
+            dm.setdefault(new_extra, []).extend(reqs)
+        return dm
+
+    def _build_dep_map(self):
+        dm = {}
+        for name in 'requires.txt', 'depends.txt':
+            for extra, reqs in split_sections(self._get_metadata(name)):
+                dm.setdefault(extra, []).extend(parse_requirements(reqs))
+        return dm
+
+    def requires(self, extras: Iterable[str] = ()):
+        """List of Requirements needed for this distro if `extras` are used"""
+        dm = self._dep_map
+        deps: list[Requirement] = []
+        deps.extend(dm.get(None, ()))
+        for ext in extras:
+            try:
+                deps.extend(dm[safe_extra(ext)])
+            except KeyError as e:
+                raise UnknownExtra(
+                    "%s has no such extra feature %r" % (self, ext)
+                ) from e
+        return deps
+
+    def _get_metadata_path_for_display(self, name):
+        """
+        Return the path to the given metadata file, if available.
+        """
+        try:
+            # We need to access _get_metadata_path() on the provider object
+            # directly rather than through this class's __getattr__()
+            # since _get_metadata_path() is marked private.
+            path = self._provider._get_metadata_path(name)
+
+        # Handle exceptions e.g. in case the distribution's metadata
+        # provider doesn't support _get_metadata_path().
+        except Exception:
+            return '[could not detect]'
+
+        return path
+
+    def _get_metadata(self, name):
+        if self.has_metadata(name):
+            yield from self.get_metadata_lines(name)
+
+    def _get_version(self):
+        lines = self._get_metadata(self.PKG_INFO)
+        return _version_from_file(lines)
+
+    def activate(self, path: list[str] | None = None, replace: bool = False):
+        """Ensure distribution is importable on `path` (default=sys.path)"""
+        if path is None:
+            path = sys.path
+        self.insert_on(path, replace=replace)
+        if path is sys.path and self.location is not None:
+            fixup_namespace_packages(self.location)
+            for pkg in self._get_metadata('namespace_packages.txt'):
+                if pkg in sys.modules:
+                    declare_namespace(pkg)
+
+    def egg_name(self):
+        """Return what this distribution's standard .egg filename should be"""
+        filename = "%s-%s-py%s" % (
+            to_filename(self.project_name),
+            to_filename(self.version),
+            self.py_version or PY_MAJOR,
+        )
+
+        if self.platform:
+            filename += '-' + self.platform
+        return filename
+
+    def __repr__(self):
+        if self.location:
+            return "%s (%s)" % (self, self.location)
+        else:
+            return str(self)
+
+    def __str__(self):
+        try:
+            version = getattr(self, 'version', None)
+        except ValueError:
+            version = None
+        version = version or "[unknown version]"
+        return "%s %s" % (self.project_name, version)
+
+    def __getattr__(self, attr):
+        """Delegate all unrecognized public attributes to .metadata provider"""
+        if attr.startswith('_'):
+            raise AttributeError(attr)
+        return getattr(self._provider, attr)
+
+    def __dir__(self):
+        return list(
+            set(super().__dir__())
+            | set(attr for attr in self._provider.__dir__() if not attr.startswith('_'))
+        )
+
+    @classmethod
+    def from_filename(
+        cls,
+        filename: StrPath,
+        metadata: _MetadataType = None,
+        **kw: int,  # We could set `precedence` explicitly, but keeping this as `**kw` for full backwards and subclassing compatibility
+    ):
+        return cls.from_location(
+            _normalize_cached(filename), os.path.basename(filename), metadata, **kw
+        )
+
+    def as_requirement(self):
+        """Return a ``Requirement`` that matches this distribution exactly"""
+        if isinstance(self.parsed_version, _packaging_version.Version):
+            spec = "%s==%s" % (self.project_name, self.parsed_version)
+        else:
+            spec = "%s===%s" % (self.project_name, self.parsed_version)
+
+        return Requirement.parse(spec)
+
+    def load_entry_point(self, group: str, name: str) -> _ResolvedEntryPoint:
+        """Return the `name` entry point of `group` or raise ImportError"""
+        ep = self.get_entry_info(group, name)
+        if ep is None:
+            raise ImportError("Entry point %r not found" % ((group, name),))
+        return ep.load()
+
+    @overload
+    def get_entry_map(self, group: None = None) -> dict[str, dict[str, EntryPoint]]: ...
+    @overload
+    def get_entry_map(self, group: str) -> dict[str, EntryPoint]: ...
+    def get_entry_map(self, group: str | None = None):
+        """Return the entry point map for `group`, or the full entry map"""
+        if not hasattr(self, "_ep_map"):
+            self._ep_map = EntryPoint.parse_map(
+                self._get_metadata('entry_points.txt'), self
+            )
+        if group is not None:
+            return self._ep_map.get(group, {})
+        return self._ep_map
+
+    def get_entry_info(self, group: str, name: str):
+        """Return the EntryPoint object for `group`+`name`, or ``None``"""
+        return self.get_entry_map(group).get(name)
+
+    # FIXME: 'Distribution.insert_on' is too complex (13)
+    def insert_on(  # noqa: C901
+        self,
+        path: list[str],
+        loc=None,
+        replace: bool = False,
+    ):
+        """Ensure self.location is on path
+
+        If replace=False (default):
+            - If location is already in path anywhere, do nothing.
+            - Else:
+              - If it's an egg and its parent directory is on path,
+                insert just ahead of the parent.
+              - Else: add to the end of path.
+        If replace=True:
+            - If location is already on path anywhere (not eggs)
+              or higher priority than its parent (eggs)
+              do nothing.
+            - Else:
+              - If it's an egg and its parent directory is on path,
+                insert just ahead of the parent,
+                removing any lower-priority entries.
+              - Else: add it to the front of path.
+        """
+
+        loc = loc or self.location
+        if not loc:
+            return
+
+        nloc = _normalize_cached(loc)
+        bdir = os.path.dirname(nloc)
+        npath = [(p and _normalize_cached(p) or p) for p in path]
+
+        for p, item in enumerate(npath):
+            if item == nloc:
+                if replace:
+                    break
+                else:
+                    # don't modify path (even removing duplicates) if
+                    # found and not replace
+                    return
+            elif item == bdir and self.precedence == EGG_DIST:
+                # if it's an .egg, give it precedence over its directory
+                # UNLESS it's already been added to sys.path and replace=False
+                if (not replace) and nloc in npath[p:]:
+                    return
+                if path is sys.path:
+                    self.check_version_conflict()
+                path.insert(p, loc)
+                npath.insert(p, nloc)
+                break
+        else:
+            if path is sys.path:
+                self.check_version_conflict()
+            if replace:
+                path.insert(0, loc)
+            else:
+                path.append(loc)
+            return
+
+        # p is the spot where we found or inserted loc; now remove duplicates
+        while True:
+            try:
+                np = npath.index(nloc, p + 1)
+            except ValueError:
+                break
+            else:
+                del npath[np], path[np]
+                # ha!
+                p = np
+
+        return
+
+    def check_version_conflict(self):
+        if self.key == 'setuptools':
+            # ignore the inevitable setuptools self-conflicts  :(
+            return
+
+        nsp = dict.fromkeys(self._get_metadata('namespace_packages.txt'))
+        loc = normalize_path(self.location)
+        for modname in self._get_metadata('top_level.txt'):
+            if (
+                modname not in sys.modules
+                or modname in nsp
+                or modname in _namespace_packages
+            ):
+                continue
+            if modname in ('pkg_resources', 'setuptools', 'site'):
+                continue
+            fn = getattr(sys.modules[modname], '__file__', None)
+            if fn and (
+                normalize_path(fn).startswith(loc) or fn.startswith(self.location)
+            ):
+                continue
+            issue_warning(
+                "Module %s was already imported from %s, but %s is being added"
+                " to sys.path" % (modname, fn, self.location),
+            )
+
+    def has_version(self):
+        try:
+            self.version
+        except ValueError:
+            issue_warning("Unbuilt egg for " + repr(self))
+            return False
+        except SystemError:
+            # TODO: remove this except clause when python/cpython#103632 is fixed.
+            return False
+        return True
+
+    def clone(self, **kw: str | int | IResourceProvider | None):
+        """Copy this distribution, substituting in any changed keyword args"""
+        names = 'project_name version py_version platform location precedence'
+        for attr in names.split():
+            kw.setdefault(attr, getattr(self, attr, None))
+        kw.setdefault('metadata', self._provider)
+        # Unsafely unpacking. But keeping **kw for backwards and subclassing compatibility
+        return self.__class__(**kw)  # type:ignore[arg-type]
+
+    @property
+    def extras(self):
+        return [dep for dep in self._dep_map if dep]
+
+
+class EggInfoDistribution(Distribution):
+    def _reload_version(self):
+        """
+        Packages installed by distutils (e.g. numpy or scipy),
+        which uses an old safe_version, and so
+        their version numbers can get mangled when
+        converted to filenames (e.g., 1.11.0.dev0+2329eae to
+        1.11.0.dev0_2329eae). These distributions will not be
+        parsed properly
+        downstream by Distribution and safe_version, so
+        take an extra step and try to get the version number from
+        the metadata file itself instead of the filename.
+        """
+        md_version = self._get_version()
+        if md_version:
+            self._version = md_version
+        return self
+
+
+class DistInfoDistribution(Distribution):
+    """
+    Wrap an actual or potential sys.path entry
+    w/metadata, .dist-info style.
+    """
+
+    PKG_INFO = 'METADATA'
+    EQEQ = re.compile(r"([\(,])\s*(\d.*?)\s*([,\)])")
+
+    @property
+    def _parsed_pkg_info(self):
+        """Parse and cache metadata"""
+        try:
+            return self._pkg_info
+        except AttributeError:
+            metadata = self.get_metadata(self.PKG_INFO)
+            self._pkg_info = email.parser.Parser().parsestr(metadata)
+            return self._pkg_info
+
+    @property
+    def _dep_map(self):
+        try:
+            return self.__dep_map
+        except AttributeError:
+            self.__dep_map = self._compute_dependencies()
+            return self.__dep_map
+
+    def _compute_dependencies(self) -> dict[str | None, list[Requirement]]:
+        """Recompute this distribution's dependencies."""
+        self.__dep_map: dict[str | None, list[Requirement]] = {None: []}
+
+        reqs: list[Requirement] = []
+        # Including any condition expressions
+        for req in self._parsed_pkg_info.get_all('Requires-Dist') or []:
+            reqs.extend(parse_requirements(req))
+
+        def reqs_for_extra(extra):
+            for req in reqs:
+                if not req.marker or req.marker.evaluate({'extra': extra}):
+                    yield req
+
+        common = types.MappingProxyType(dict.fromkeys(reqs_for_extra(None)))
+        self.__dep_map[None].extend(common)
+
+        for extra in self._parsed_pkg_info.get_all('Provides-Extra') or []:
+            s_extra = safe_extra(extra.strip())
+            self.__dep_map[s_extra] = [
+                r for r in reqs_for_extra(extra) if r not in common
+            ]
+
+        return self.__dep_map
+
+
+_distributionImpl = {
+    '.egg': Distribution,
+    '.egg-info': EggInfoDistribution,
+    '.dist-info': DistInfoDistribution,
+}
+
+
+def issue_warning(*args, **kw):
+    level = 1
+    g = globals()
+    try:
+        # find the first stack frame that is *not* code in
+        # the pkg_resources module, to use for the warning
+        while sys._getframe(level).f_globals is g:
+            level += 1
+    except ValueError:
+        pass
+    warnings.warn(stacklevel=level + 1, *args, **kw)
+
+
+def parse_requirements(strs: _NestedStr):
+    """
+    Yield ``Requirement`` objects for each specification in `strs`.
+
+    `strs` must be a string, or a (possibly-nested) iterable thereof.
+    """
+    return map(Requirement, join_continuation(map(drop_comment, yield_lines(strs))))
+
+
+class RequirementParseError(_packaging_requirements.InvalidRequirement):
+    "Compatibility wrapper for InvalidRequirement"
+
+
+class Requirement(_packaging_requirements.Requirement):
+    def __init__(self, requirement_string: str):
+        """DO NOT CALL THIS UNDOCUMENTED METHOD; use Requirement.parse()!"""
+        super().__init__(requirement_string)
+        self.unsafe_name = self.name
+        project_name = safe_name(self.name)
+        self.project_name, self.key = project_name, project_name.lower()
+        self.specs = [(spec.operator, spec.version) for spec in self.specifier]
+        # packaging.requirements.Requirement uses a set for its extras. We use a variable-length tuple
+        self.extras: tuple[str] = tuple(map(safe_extra, self.extras))
+        self.hashCmp = (
+            self.key,
+            self.url,
+            self.specifier,
+            frozenset(self.extras),
+            str(self.marker) if self.marker else None,
+        )
+        self.__hash = hash(self.hashCmp)
+
+    def __eq__(self, other: object):
+        return isinstance(other, Requirement) and self.hashCmp == other.hashCmp
+
+    def __ne__(self, other):
+        return not self == other
+
+    def __contains__(self, item: Distribution | str | tuple[str, ...]) -> bool:
+        if isinstance(item, Distribution):
+            if item.key != self.key:
+                return False
+
+            item = item.version
+
+        # Allow prereleases always in order to match the previous behavior of
+        # this method. In the future this should be smarter and follow PEP 440
+        # more accurately.
+        return self.specifier.contains(item, prereleases=True)
+
+    def __hash__(self):
+        return self.__hash
+
+    def __repr__(self):
+        return "Requirement.parse(%r)" % str(self)
+
+    @staticmethod
+    def parse(s: str | Iterable[str]):
+        (req,) = parse_requirements(s)
+        return req
+
+
+def _always_object(classes):
+    """
+    Ensure object appears in the mro even
+    for old-style classes.
+    """
+    if object not in classes:
+        return classes + (object,)
+    return classes
+
+
+def _find_adapter(registry: Mapping[type, _AdapterT], ob: object) -> _AdapterT:
+    """Return an adapter factory for `ob` from `registry`"""
+    types = _always_object(inspect.getmro(getattr(ob, '__class__', type(ob))))
+    for t in types:
+        if t in registry:
+            return registry[t]
+    # _find_adapter would previously return None, and immediately be called.
+    # So we're raising a TypeError to keep backward compatibility if anyone depended on that behaviour.
+    raise TypeError(f"Could not find adapter for {registry} and {ob}")
+
+
+def ensure_directory(path: StrOrBytesPath):
+    """Ensure that the parent directory of `path` exists"""
+    dirname = os.path.dirname(path)
+    os.makedirs(dirname, exist_ok=True)
+
+
+def _bypass_ensure_directory(path):
+    """Sandbox-bypassing version of ensure_directory()"""
+    if not WRITE_SUPPORT:
+        raise OSError('"os.mkdir" not supported on this platform.')
+    dirname, filename = split(path)
+    if dirname and filename and not isdir(dirname):
+        _bypass_ensure_directory(dirname)
+        try:
+            mkdir(dirname, 0o755)
+        except FileExistsError:
+            pass
+
+
+def split_sections(s: _NestedStr) -> Iterator[tuple[str | None, list[str]]]:
+    """Split a string or iterable thereof into (section, content) pairs
+
+    Each ``section`` is a stripped version of the section header ("[section]")
+    and each ``content`` is a list of stripped lines excluding blank lines and
+    comment-only lines.  If there are any such lines before the first section
+    header, they're returned in a first ``section`` of ``None``.
+    """
+    section = None
+    content = []
+    for line in yield_lines(s):
+        if line.startswith("["):
+            if line.endswith("]"):
+                if section or content:
+                    yield section, content
+                section = line[1:-1].strip()
+                content = []
+            else:
+                raise ValueError("Invalid section heading", line)
+        else:
+            content.append(line)
+
+    # wrap up last segment
+    yield section, content
+
+
+def _mkstemp(*args, **kw):
+    old_open = os.open
+    try:
+        # temporarily bypass sandboxing
+        os.open = os_open
+        return tempfile.mkstemp(*args, **kw)
+    finally:
+        # and then put it back
+        os.open = old_open
+
+
+# Silence the PEP440Warning by default, so that end users don't get hit by it
+# randomly just because they use pkg_resources. We want to append the rule
+# because we want earlier uses of filterwarnings to take precedence over this
+# one.
+warnings.filterwarnings("ignore", category=PEP440Warning, append=True)
+
+
+class PkgResourcesDeprecationWarning(Warning):
+    """
+    Base class for warning about deprecations in ``pkg_resources``
+
+    This class is not derived from ``DeprecationWarning``, and as such is
+    visible by default.
+    """
+
+
+# Ported from ``setuptools`` to avoid introducing an import inter-dependency:
+_LOCALE_ENCODING = "locale" if sys.version_info >= (3, 10) else None
+
+
+def _read_utf8_with_fallback(file: str, fallback_encoding=_LOCALE_ENCODING) -> str:
+    """See setuptools.unicode_utils._read_utf8_with_fallback"""
+    try:
+        with open(file, "r", encoding="utf-8") as f:
+            return f.read()
+    except UnicodeDecodeError:  # pragma: no cover
+        msg = f"""\
+        ********************************************************************************
+        `encoding="utf-8"` fails with {file!r}, trying `encoding={fallback_encoding!r}`.
+
+        This fallback behaviour is considered **deprecated** and future versions of
+        `setuptools/pkg_resources` may not implement it.
+
+        Please encode {file!r} with "utf-8" to ensure future builds will succeed.
+
+        If this file was produced by `setuptools` itself, cleaning up the cached files
+        and re-building/re-installing the package with a newer version of `setuptools`
+        (e.g. by updating `build-system.requires` in its `pyproject.toml`)
+        might solve the problem.
+        ********************************************************************************
+        """
+        # TODO: Add a deadline?
+        #       See comment in setuptools.unicode_utils._Utf8EncodingNeeded
+        warnings.warn(msg, PkgResourcesDeprecationWarning, stacklevel=2)
+        with open(file, "r", encoding=fallback_encoding) as f:
+            return f.read()
+
+
+# from jaraco.functools 1.3
+def _call_aside(f, *args, **kwargs):
+    f(*args, **kwargs)
+    return f
+
+
+@_call_aside
+def _initialize(g=globals()):
+    "Set up global resource manager (deliberately not state-saved)"
+    manager = ResourceManager()
+    g['_manager'] = manager
+    g.update(
+        (name, getattr(manager, name))
+        for name in dir(manager)
+        if not name.startswith('_')
+    )
+
+
+@_call_aside
+def _initialize_master_working_set():
+    """
+    Prepare the master working set and make the ``require()``
+    API available.
+
+    This function has explicit effects on the global state
+    of pkg_resources. It is intended to be invoked once at
+    the initialization of this module.
+
+    Invocation by other packages is unsupported and done
+    at their own risk.
+    """
+    working_set = _declare_state('object', 'working_set', WorkingSet._build_master())
+
+    require = working_set.require
+    iter_entry_points = working_set.iter_entry_points
+    add_activation_listener = working_set.subscribe
+    run_script = working_set.run_script
+    # backward compatibility
+    run_main = run_script
+    # Activate all distributions already on sys.path with replace=False and
+    # ensure that all distributions added to the working set in the future
+    # (e.g. by calling ``require()``) will get activated as well,
+    # with higher priority (replace=True).
+    tuple(dist.activate(replace=False) for dist in working_set)
+    add_activation_listener(
+        lambda dist: dist.activate(replace=True),
+        existing=False,
+    )
+    working_set.entries = []
+    # match order
+    list(map(working_set.add_entry, sys.path))
+    globals().update(locals())
+
+
+if TYPE_CHECKING:
+    # All of these are set by the @_call_aside methods above
+    __resource_manager = ResourceManager()  # Won't exist at runtime
+    resource_exists = __resource_manager.resource_exists
+    resource_isdir = __resource_manager.resource_isdir
+    resource_filename = __resource_manager.resource_filename
+    resource_stream = __resource_manager.resource_stream
+    resource_string = __resource_manager.resource_string
+    resource_listdir = __resource_manager.resource_listdir
+    set_extraction_path = __resource_manager.set_extraction_path
+    cleanup_resources = __resource_manager.cleanup_resources
+
+    working_set = WorkingSet()
+    require = working_set.require
+    iter_entry_points = working_set.iter_entry_points
+    add_activation_listener = working_set.subscribe
+    run_script = working_set.run_script
+    run_main = run_script
diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/pkg_resources/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/pkg_resources/__pycache__/__init__.cpython-312.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a2c0f42d91919801826e597ccc75cd3d72c96194
GIT binary patch
literal 161524
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

' : '\U0001d507', + '\\' : '\U0001d508', + '\\' : '\U0001d509', + '\\' : '\U0001d50a', + '\\' : '\U0000210c', + '\\' : '\U00002111', + '\\' : '\U0001d50d', + '\\' : '\U0001d50e', + '\\' : '\U0001d50f', + '\\' : '\U0001d510', + '\\' : '\U0001d511', + '\\' : '\U0001d512', + '\\' : '\U0001d513', + '\\' : '\U0001d514', + '\\' : '\U0000211c', + '\\' : '\U0001d516', + '\\' : '\U0001d517', + '\\' : '\U0001d518', + '\\' : '\U0001d519', + '\\' : '\U0001d51a', + '\\' : '\U0001d51b', + '\\' : '\U0001d51c', + '\\' : '\U00002128', + '\\' : '\U0001d51e', + '\\' : '\U0001d51f', + '\\' : '\U0001d520', + '\\
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

ae@F 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 ZLc__tPSE}tkMA1n+=%Sn4xdjD=sy`duo(aV literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__init__.py b/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__init__.py new file mode 100644 index 0000000..d58dd2b --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__init__.py @@ -0,0 +1,627 @@ +""" +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 + from typing import Literal + + +def _set_platform_dir_class() -> type[PlatformDirsABC]: + if sys.platform == "win32": + from pip._vendor.platformdirs.windows import Windows as Result # noqa: PLC0415 + elif sys.platform == "darwin": + from pip._vendor.platformdirs.macos import MacOS as Result # noqa: PLC0415 + else: + from pip._vendor.platformdirs.unix import Unix as Result # noqa: PLC0415 + + if os.getenv("ANDROID_DATA") == "/data" and os.getenv("ANDROID_ROOT") == "/system": + if os.getenv("SHELL") or os.getenv("PREFIX"): + return Result + + from pip._vendor.platformdirs.android import _android_folder # noqa: PLC0415 + + if _android_folder() is not None: + from pip._vendor.platformdirs.android import Android # noqa: PLC0415 + + return Android # return to avoid redefinition of a 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 a 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__ = [ + "AppDirs", + "PlatformDirs", + "PlatformDirsABC", + "__version__", + "__version_info__", + "site_cache_dir", + "site_cache_path", + "site_config_dir", + "site_config_path", + "site_data_dir", + "site_data_path", + "site_runtime_dir", + "site_runtime_path", + "user_cache_dir", + "user_cache_path", + "user_config_dir", + "user_config_path", + "user_data_dir", + "user_data_path", + "user_desktop_dir", + "user_desktop_path", + "user_documents_dir", + "user_documents_path", + "user_downloads_dir", + "user_downloads_path", + "user_log_dir", + "user_log_path", + "user_music_dir", + "user_music_path", + "user_pictures_dir", + "user_pictures_path", + "user_runtime_dir", + "user_runtime_path", + "user_state_dir", + "user_state_path", + "user_videos_dir", + "user_videos_path", +] diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__main__.py b/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__main__.py new file mode 100644 index 0000000..fa8a677 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__main__.py @@ -0,0 +1,55 @@ +"""Main entry point.""" + +from __future__ import annotations + +from pip._vendor.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 the 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/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..856b41b580d739ffee65f36ef7725e8b28244ba9 GIT binary patch literal 19828 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 T_LPT~_V=M(0sE|n&O`qTboq>B literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/__main__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/__main__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..8e4fd500e0187c3cb8885f57a9ab6f5d3427ec5d GIT binary patch literal 1967 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

22i1i)MPP z9-7XI&n{k=zI6HG>=Tg*mRHrlQ_mn2Sp5?Is})ZjYwoGN1Et>aLhtx50;P!`7AAgJ z?7dRzT`Bag6no|EAbKkJgeK+`J;1E#JQ^y{EpRkWv*qbTAreR;rj&6A6 zkw(Z@xZhe2w>N!zEiP8NnKVoJ82MD%oKlZw`C(XeoNS5Iz0rjndd+VQjG& zeWw%^3Q?gLO>Va!>^(cKa0T}9-SF7mmM;Tgpd#$!-z(S$E!b%y@*Dblq!H@#m>{jk zJ5<4Y{_@g==_dj1x3Z!&c)yBxWA$Hlyhoek9pOrmR|=6=K7F@zda-bNu^4%$6oH6R zC`OXoe#9G)?XKWGy4%g)^?w=Y1}fq`YTzAnkT>C-8!hlRG2AA-_mB%fh=s`l{9sln zmB+6L@i=h;fttdhDAta#QEX2QUfV<<) r8!>yJ_3-%vbsV-v9JY_>u{wI}9bu~@yvH%_wmqjK;P_K7&CC2BKk4A9 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/api.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/api.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a1ab5b1b0c095c5921d1f6117ebfec3a4f44945b GIT binary patch literal 12930 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 bA28u>-nI{Y!#4s?`?&6f^uHLEB=LU%I(EH1 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/macos.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/macos.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d1805fb27d0771b74ed5d4473c8444d25df5525a GIT binary patch literal 8006 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 Q`05rtTpjnV03G?i0Ljno5C8xG literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/version.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/version.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..98b12e551f1590c9bbb8577659d38618d600c848 GIT binary patch literal 596 zcmYLGzi-n(6h8Z6$N6D3RZ~Q(O05J88R}Ehj#ZZ`Km`efCP-LFmg~DD2K#KCuMuGi zVqt^{5KBf7e+o-bmT(J^n6edh>%=*v@O1j#_ul(X?>^l()64@IzaM^We^LPWl@?c# zS&$1Z$$QWO7}$USwu%+321=;fY6xwp0HP8|GDK^uYf_2f-)!qtC0Sc18ZmHYUry#s zn=@VZ^nWayGHkq1?3|s)IhhM~v7fILZqMWZR8*lg&*FdxtwsHaS|ZycERjqU9A`lt zM=bv@cq*4I^J+S8ywvurs#UGPS?X=3N?@t~M#U6n^T~0|IlNmtym!>NBXr)6ecE9# z)ud_xeaZz)I1}dM+M|=B2Mwp$I=){MdUX1Xcw8(wj!S98T`pgiI1ba(yIKm_6buPp zz=cF`>7s5F62xM{S=95rF7hHwP~A^FWc3K`p};>yai4c1x@+xJQQ~v59lPFhw?h&X z`!SNnDUKM51DCfW7Gj?zXkpii`1XD~q`daw)({R)hQ>$qd3UsKeJ`U|^=Wy1P@m?CuZt72GzO)~%GMZcO_nysU}JiH Ya|AXAg*Tna&FvA8XZc;7t;hv`011Mq3jhEB literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/windows.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/__pycache__/windows.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..6bf138d2d8e5b3d64537b41d71ae95c420e3092a GIT binary patch literal 13672 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 jYi4%MRcxIN{2&`Rn5{T8`_. + + 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.,``/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: # noqa: C901, PLR0912 + """:return: base folder for the Android OS or None if it cannot be found""" + result: str | None = None + # type checker isn't happy with our "import android", just don't do this when type checking see + # https://stackoverflow.com/a/61394121 + if not TYPE_CHECKING: + try: + # First try to get a path to android app using python4android (if available)... + from android import mActivity # noqa: PLC0415 + + context = cast("android.content.Context", mActivity.getApplicationContext()) # noqa: F821 + result = context.getFilesDir().getParentFile().getAbsolutePath() + except Exception: # noqa: BLE001 + result = None + if result is None: + try: + # ...and fall back to using plain pyjnius, if python4android isn't available or doesn't deliver any useful + # result... + from jnius import autoclass # noqa: PLC0415 + + context = autoclass("android.content.Context") + result = context.getFilesDir().getParentFile().getAbsolutePath() + except Exception: # noqa: BLE001 + result = None + if result is None: + # and if that fails, too, find an android folder looking at path on the sys.path + # warning: only works for apps installed under /data, not adopted storage etc. + 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 + if result is None: + # one last try: find an android folder looking at path on the sys.path taking adopted storage paths into + # account + pattern = re.compile(r"/mnt/expand/[a-fA-F0-9-]{36}/(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 # noqa: PLC0415 + + 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 # noqa: PLC0415 + + 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 # noqa: PLC0415 + + 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 # noqa: PLC0415 + + 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 # noqa: PLC0415 + + 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/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/api.py b/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/api.py new file mode 100644 index 0000000..c50caa6 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/api.py @@ -0,0 +1,292 @@ +"""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: + from typing import Iterator, Literal + + +class PlatformDirsABC(ABC): # noqa: PLR0904 + """Abstract base class for platform directories.""" + + def __init__( # noqa: PLR0913, PLR0917 + 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 a 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) + + 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/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/macos.py b/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/macos.py new file mode 100644 index 0000000..eb1ba5d --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/macos.py @@ -0,0 +1,130 @@ +"""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/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/py.typed b/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/unix.py b/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/unix.py new file mode 100644 index 0000000..9500ade --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/unix.py @@ -0,0 +1,275 @@ +"""Unix.""" + +from __future__ import annotations + +import os +import sys +from configparser import ConfigParser +from pathlib import Path +from typing import Iterator, NoReturn + +from .api import PlatformDirsABC + +if sys.platform == "win32": + + def getuid() -> NoReturn: + msg = "should only be used on Unix" + raise RuntimeError(msg) + +else: + from os import getuid + + +class Unix(PlatformDirsABC): # noqa: PLR0904 + """ + On Unix/Linux, we follow the `XDG Basedir Spec `_. + + The spec allows overriding directories with environment variables. The examples shown 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_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._append_app_name_and_version(p) for p in 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: + return dirs[0] + return os.pathsep.join(dirs) + + @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_dirs(self) -> list[str]: + path = os.environ.get("XDG_CONFIG_DIRS", "") + if not path.strip(): + path = "/etc/xdg" + 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: + """ + :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/cache/$appname/$version``""" + return self._append_app_name_and_version("/var/cache") + + @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 the 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, returns the 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 the 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 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) + 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/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/version.py b/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/version.py new file mode 100644 index 0000000..6483ddc --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/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 = '4.2.2' +__version_tuple__ = version_tuple = (4, 2, 2) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/windows.py b/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/windows.py new file mode 100644 index 0000000..d7bc960 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/platformdirs/windows.py @@ -0,0 +1,272 @@ +"""Windows.""" + +from __future__ import annotations + +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 a 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 # noqa: PLC0415 + + 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 + + import ctypes # noqa: PLC0415 + + 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]: + try: + import ctypes # noqa: PLC0415 + except ImportError: + pass + else: + if hasattr(ctypes, "windll"): + return get_win_folder_via_ctypes + try: + import winreg # noqa: PLC0415, 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/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__init__.py b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__init__.py new file mode 100644 index 0000000..60ae9bb --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__init__.py @@ -0,0 +1,82 @@ +""" + Pygments + ~~~~~~~~ + + Pygments is a syntax highlighting package written in Python. + + It is a generic syntax highlighter for general use in all kinds of software + such as forum systems, wikis or other applications that need to prettify + source code. Highlights are: + + * a wide range of common languages and markup formats is supported + * special attention is paid to details, increasing quality by a fair amount + * support for new languages and formats are added easily + * a number of output formats, presently HTML, LaTeX, RTF, SVG, all image + formats that PIL supports, and ANSI sequences + * it is usable as a command-line tool and as a library + * ... and it highlights even Brainfuck! + + The `Pygments master branch`_ is installable with ``easy_install Pygments==dev``. + + .. _Pygments master branch: + https://github.com/pygments/pygments/archive/master.zip#egg=Pygments-dev + + :copyright: Copyright 2006-2024 by the Pygments team, see AUTHORS. + :license: BSD, see LICENSE for details. +""" +from io import StringIO, BytesIO + +__version__ = '2.18.0' +__docformat__ = 'restructuredtext' + +__all__ = ['lex', 'format', 'highlight'] + + +def lex(code, lexer): + """ + Lex `code` with the `lexer` (must be a `Lexer` instance) + and return an iterable of tokens. Currently, this only calls + `lexer.get_tokens()`. + """ + try: + return lexer.get_tokens(code) + except TypeError: + # Heuristic to catch a common mistake. + from pip._vendor.pygments.lexer import RegexLexer + if isinstance(lexer, type) and issubclass(lexer, RegexLexer): + raise TypeError('lex() argument must be a lexer instance, ' + 'not a class') + raise + + +def format(tokens, formatter, outfile=None): # pylint: disable=redefined-builtin + """ + Format ``tokens`` (an iterable of tokens) with the formatter ``formatter`` + (a `Formatter` instance). + + If ``outfile`` is given and a valid file object (an object with a + ``write`` method), the result will be written to it, otherwise it + is returned as a string. + """ + try: + if not outfile: + realoutfile = getattr(formatter, 'encoding', None) and BytesIO() or StringIO() + formatter.format(tokens, realoutfile) + return realoutfile.getvalue() + else: + formatter.format(tokens, outfile) + except TypeError: + # Heuristic to catch a common mistake. + from pip._vendor.pygments.formatter import Formatter + if isinstance(formatter, type) and issubclass(formatter, Formatter): + raise TypeError('format() argument must be a formatter instance, ' + 'not a class') + raise + + +def highlight(code, lexer, formatter, outfile=None): + """ + This is the most high-level highlighting function. It combines `lex` and + `format` in one function. + """ + return format(lex(code, lexer), formatter, outfile) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__main__.py b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__main__.py new file mode 100644 index 0000000..dcc6e5a --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__main__.py @@ -0,0 +1,17 @@ +""" + pygments.__main__ + ~~~~~~~~~~~~~~~~~ + + Main entry point for ``python -m pygments``. + + :copyright: Copyright 2006-2024 by the Pygments team, see AUTHORS. + :license: BSD, see LICENSE for details. +""" + +import sys +from pip._vendor.pygments.cmdline import main + +try: + sys.exit(main(sys.argv)) +except KeyboardInterrupt: + sys.exit(1) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..0314f4262af2804561909fb196c7b7a451d5231c GIT binary patch literal 3488 zcmaJ@Uu+b|8Q;A-+vhv~p*B#(p)f!RKCth=MTNKl2?z;RjG@>~)2r0G_3rp?@!sxb zX4dvura~wWeN5F#Qpzx}PgLf+b!F^n8TyV0sOxUZys z_-VW4{$q)`l37f)d}Xb%x?8Jz_*br9V@=CmwrZTM3RfxaGuMYbRS*1PY+**ldu!b1 z!nOa)1{Z885KJ#y9t$NW6PD+(W!HBk3znD+mei^xxb{efcAZ(0HiZpXlZrRw1Y32N z;UWwLst%J@v+23ErQE=mOw}#Le9j%F0@f5Dc`f z2z%9aI1`qSDB+DAG#Y`=JUoX8954G0Ygl4AY?4zAOG%1YhRtRm6nFGNCzxz<+eLsD zWr_TvmztKVopQLcTn}NmzAd;VDY5T{mglM#TWrCFCCf!njUe<@VlTF@ljrl*ulbWW zfUiR5JZ6bj<-y4t1*F`b9V6u3sra=krOFqpm&A%S6&(2)FGB03=F;wh9Gz6kk(?bd>h^TGSgO zFY51n8#_@gvf6|HH2!x!M0d~VH#W>$CWc>Y8^&gPcHTH@sE&ni8=?e_Bh7=}-AQAFtdIqR-@*H|^y(myg*%|d4VBb~HazQ(E~ z5LM^^5JHKrB2q4@Y`hUl#TJ2JR>gZXrI7=m7xZR=F!UxAP&5!8@Y7HO>r}9ePf=u- zLm@QVCSaKq%m?voU@~S(d{VK-RVCgrUH}S7v;~D&Fr(Z}UgK-}^z}3FYrFvUs)Z!z ztm~e3xZ~Ue^8-bk^DHR~eNnD!Kk8p-HTe}G0uhZh-Da@@VmW~*Ch#q4Q-V?*O%&HyvdtZ&6Qohor2-`R6|=)q@5vi6&PfSaI!oiC!&TbERD>;>48_ zNDrpaMe?2E>8X-L@+RANjV!^jQrodEohqQMt11<^Dtd8_?v7$0Z=$q&m^mqu^T(BHGKKFRNUpMSWpoj>yN`lrV}8{0nq`je5D zpBd)2PV5-w=t+zQPd?2KJ{!dQ&m}?c?w(QO7w0bK({nb(mb4Der+{OP^OSs3b&$Sc z5{5V1JJw8*1Cl%YH``X$OiA-(OSfeHb{eedOJ=*j8^%UDLAZ(WtqwQ3?<6+niFv!* z=&-~zS}Cxv!>Ts>(oV+fZS>vFz_)KCmchP}WSsZ__U%jNHq4DoXFjh`*~HE1*_D00 z)&V3-1N{wsr$U)y0#re}UAa`~@-x;T68mbkGp<&(xp8ncHi`8Y_?na}OW1=eamn>K zjshcVkZ7VWE+e*rE7@VR#)8FL+*aC`_E5`%r4OlAsT?8$4Gsu91!6a92rffU!B12- zP>rNyLRI3biMVoEb*TV~FL@juiwCZ6eGx)(p~o@*qb%;zz`^reA_e`OxYoZHhrPQP zbW-v^1R)>wK@d==2!RsO5Clv?Sc$TjM-DMA?k*y+k>vq6ZOU) zGV1TV81=O?9_3N}c?hFR<=jcG}k-?s!zYOnxGIscW;gj-b zd$-0ed_Fe&$FqNU_4Bdv_KkP8Zj^ua*5iSFj|L7r960d7+xLIGJ#hN*=)p&$#~+R! z-x@7E7$`h_VflxD9+-SV7hWS>a6jI=oqy%G)1SJ(dujXRTmMfNhzNHtW-lHzexDzq z{@}Sw`_ne%GHIkwl-8Y7=aRC7%ogazz#n0&5#TDK zOLx*kE#!4;BdR5rLf@vEv&c}6qZnC4ktOvtRwZP|n2kRNQ3AIR@9xp7g;bn+a=efc z#Ct(;ikGQ7fKF0;-4B(edFrmw+8DY!##cFGVC0ua-*-N^vNdw#{>&$M_r0bN>bkiOik= literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/__main__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/__main__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d0600e5a7bfa692b617134d7420ac34925a3847a GIT binary patch literal 734 zcmZ`$J8u&~5Z?7&uyF_^5(tVED?$-V_|`Fq!a_*FM6wkU2o6PDAtVG<8vX!E#ZRE7L`cy|R8;8_+#px%`H@7Cm||vj9^ZU3`+Z^}3$z@q>}@y@ zfZxeuBx6IT`&m1?fPgw6kfc0VhuRum$~Wo;1m{5tQ1~n}YCEwyZs<&Z!bvpo_VldN z7J?`>1L(OMKwN?U#UtjZ4}vw_u?=>NHLwkHW6ytNk(MxO`7}_{vTfgCfo=DrFV0G~ zA70WGNLPypg`5QnZE%4ajWAMe9-zE`jMivagN~BR!$`1JTa{3G1yTClbY2ZT=JMp14&Ehe(k{^|FBwKSgtMfDG;h0=1D7i zkX&dv2V*l?<{&v)E*+LD(_Z5&g{;9nti|i)13ahpT717z*FhBE3X$5h{>M3q|rWH Pp95d7&W{`4vQX=P=kLVN literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/cmdline.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/cmdline.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..934669a1bfb47271d0230193460badc1b08249fa GIT binary patch literal 26668 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/filter.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/filter.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..89c945f2522fedff221bccbf27d21715dffa9923 GIT binary patch literal 3226 zcmaJ@-)|d99iLh6+OE$@+N4b(mp0SuA!4qzb2%t#xP&{dEmuLqkFtxHu zYi8C7Hf|M_2wJH?`vA_tAtKR-t0E+L;*UT`=>@69^q~?jJT~U_p~#m!KXke5yV_eavhzaV zRDG9)OIFCd<%;i0H~4m$HE!SeHOab@(Ctfm%VxE;@jW&_FP^rJLP+}TNdsV`^wxIHU9PUZ=Ic;JIhJ|howWy z^F=;0Ye&(^7%^A)-JXQ%r&^O-*Gkl(>**_r20cT*`vM_Xbd59;4ZT6)Y+WHY`*hME zb0nwL@5t3J35?hiY}pN$0*8eGvnmz8#;h{)AYIl1q$DUskqa1?ZWa?Ehj{Yre2Mw) z4_(e+jzw?9MYqoi-1@4;9aqi>DU@C+eJ5A|9emZ3OS{q3jJviA{({ZV24#0%CC84= zS;nkG{Tjx64ys?$uMr9;X^_iQj`mbHv<8i%J_|_t5#;JuT2uRpVSrbSe39HV{*YLu zcj;`7wvuXNxkM|aT4pP$;%gZ)IDx5VZ0+fH3QNJVTi_KpiG!GUlj4pHzld~swWPeLUSQH;$q#`i(1)z`BJ-Uod+rx=F{R{bbT zjaMHHjXWXL$X!qU{lMXk)aLNcf$4?oN{B};ONoZKds!O9=^QTj;hcL4SZMEez_*MXh)_8-rMM0{!rl;471XK7*{~O+f%(Cz%WX@zi6V{ zzqtSmwd^p02Vld&OS=~vcq2w=P?(XfF{fg5Fc1!WD3ttKo?V2-o=H03lHOJ|43@3X z167BcR?RM$h#(7BAY8azxCN!?SyZqJAX{CnUZ{XM+at4>Vu{R~GAZ3M`%F5;OJN5_ zAft%ZJ>@c9413CNG)McbwiWT<8VwPhvRsxgyZB4}H%N(kz>GWe=M?YVTw<0ZTk4}o zMTf0=a8p)8wh&ayPDg`t$yRE~5~xJ2eHTHpBv4!XOj8osG!@DuXe6YLz?9vLl0d5; z?p3!AslJTXUxEtoJ1~4J+$jESVEp0WiyPtZuD*Bm{@AH|W2d%{p58uvX?ygYoxyjv zv+q7k_y1zx#=wStFFn4Q+DVW9FAXv0$Kls5LiI^+6VM6m`PW_ie*L5ui=wh7vnZ8> zzXa<&hqH(FM6bAe28|h1^6l_w=x}rT_VnhV50Zb>|D63(c4uh%etP=D^t5_GTs!s( z{XNa;capErTgIji>qld5vt7lsg3tfma6d+Az|Ovt<9lwYQ(>2_x6eXvU19 zx3otj0#i{1Alv-- literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/formatter.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/formatter.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..88b9b6ba4b17a31be40e08ecdf1a6ef51a1c3656 GIT binary patch literal 4720 zcmb7IOK%*<5uVuxcli=UJ!r|6?FRjzHX)ZX6Fbh@GGI%71tOh<^dYOm?CebM?ntvU z>z*D`OE3lxIxv9~$3OrgK!C_6+t5Wh#i#s%Tx>Hygn!`^nALv(uXP4|+(iLUObJ7H)PmTdQlfZs%ORuH$ds z&2{tjyiRikx6m!ti?}bg_44W4L<#c9(lH zsJ493HKpW2O~3!pHKyiYGXu^tQD(Vj5LDw=HOueyh12fH8oQ9*vZZt9URYQ@(Tn?8nK5Omee3&jQZbtM9J8_0CUMt7?au>sZ_ic#XZbdNF=~>Fo=zudKdK`!btL z({ZuqH*}bliXKh0xip%-?;3tj;(3~$1KD@E(d-+Z+2zsb8|mRJJ@$bb$+LO<_Fu-Z ztI6!$mL?NlX{{kMe;Og7m|nqB16+ z73^DMvEz67qUdoc{B_6bELy(J7nhyDTCA>fZ++2qnv1=@?D*dIs?RMg29D$lJ=3~s zwt2AFb9##g#B5(cC=T6X7LRJLA59vr?_Ujju?xfmc0G`)b-{iOGrJns0649lv-Nu3&eaQTtzN`$#Lm}C zb^%Z;+hx0WU9XQS;EfUJ>f?ags36CgGZV5x>dH;;Q?1WnS!&x={l|{ly<<+ z@`d0*&-ZLvP*VV|HQrBsS#|j}E~=MkY{WXU4HLtvRc40L&kU*67=cU)BcW=Zzp!q) zA+N=0afrC-I!L47|5(v-Tuz((&ow{uLuQ#C>meT*^1$&u_%~ozd4IzfHZw&#RCzw| z1E4BGOZpQeM|Xho;g(>tD<9>z)ZL2a*5M% zx3ysT9w^9zP3Z!HoD<-Y2i}}iIL&M{Js93<0icS$0wn*yieTu}Ez=EnB|U+3q|1kn z@OF!($70wDk%N2bL`o2MrcBcW4p$zNerAMaDnzISsnJ7Q&&_4~au0NbP#xU5?SOLT zSvL$Mqj-8Ol~d49&cERRLWk`h=eyedUC$xDgZq=j$6hLvn|<=Hf=R#}kAySx<3Lpz zoZv`0{_HG4X~p;8gj8d?Hnn0yIH+b`ri9o9{z`&Q2{q3)Iv`-y^>HkkSa6-IkZ4{( zv?!d+^JTU^2zxzW$RW4U{+Z*TH}%Po@7@8?3C9LmH5!B0%xN*@(u7e~)((`V5wPVr ze*2eDG7gj_{YoD54_qkxxwJ^#Ov=)hW~A(`$x^yt3+;kkxS8mHOxjv#TZd~d+9RoE zNDs>2;nF3$oJwEQgB;qBGFH)P)U~Bup&2~(~-gy{e=EZcfh6dnKIL} zDX4w0u%Cn+P@Pv3N%d+u0x;_d-{PQXNDAg}cqyr>WFCOkGLcFIS1>PX7Ij(7Arc}E zH;LT`{3NJ#j7kY8LXqv3?wE~zolSs+#vr!gB4<`@$M-l%LCj^{|j*gQ7i=X7qB zq<1iEYyY0mW}dq7gHK-i_@z%bJ|EqC>b1R-7j_CCjD3BA-FW2FXKy{Tcj84nkKR6c zX7}<(moYcHcXELwZl8Mc597ZZzwx76g}qbHe|75o=O-{dd3${7!}Gs5|HYYeUyh%< zbLOd?iythfqRV@ymcBZ5;gm`e3cs2VlQ720at04{(aHBINp`iqUdfpS z2xKu=oZsbW)a;lU1(%_qZpM@tg6br?J%pX8sIl}LDDWzO^=%CryD{(nxE3zbR4QNrLv9Q``uo?IEuxQmk161V$CSF@*8V=PAc3 z$Wiwue3y0n4aTpTmULrmCpOX-14QWigxiCFe?!i#6k_fhp$^6hqLKJRD>@pRXoQ}k zT5ebJF)qf3&KZ>w69ZC(wlZePk$COq(ahT9LtH>Apzl&3NDD zPyVSAO2<|8GkWaM_loHQ^^bxGCkCJ4#MC9lwjQ+q+w#k?vtAJ|K!idWEMT~s*LD3~ quB;dKPiXp)e`-sA*M4|sd}e21yL5jfuTTGHqND4_?`t$F%l`{^KNB+m literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/lexer.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/lexer.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..26004eb8c07daa8e24e42cd8f9dee228eae64dca GIT binary patch literal 38465 zcmch=33waVohMj@8w5!3zDX4+UXUmrIxLBnWKp7SiLxU(i50s^hyW=_BtREHNrXXL zaXcN;QLo8%5T`Nbcd~8u_RK`i>FM6D7ZBwkgjMgbXR|wX#>eaiC|NZ{;*SWbl0U;PO^e)YqK5#tHti0On$q;!U1^N8hyh20y6ts^-naz<B6NMv1CyGXjPZW=ooG4-M&BLW5Whcr+ zVMuUW{zN=ct`j`s>Gf(OQ@?KOdm?{2QHiuUNLz)p)o$Bsg7&6HC+rj4_SXb=uBY}r zy^?+vi_Jr-!!gsc7(p4BjFky9~$xaf`PVS&v}o` zqF&Cpa#-9hSHL5&B+|gJD-iGm+W3pE0srW@>>WB4?2>k?x6=BKjwjZw?^wT4Iyo){ zPkE%Lm1?A*$2HO_1w0<9``P3BkAC4;8!NwS*gN3y1w38Su46s?{ow<<_w*jyBMtgx z$?XZcyu+yT7c@k@PF*tBH99&x-Z$tS4tnH3(zKV|IK^b)kSC}__njQ?^SMSmPGi!z zN0$9^(s0~!KA1EfMU&)Y&X-PkgPy>sYrvDt={xQ}54m zIZmTf7oZ*aU;pw4A>&wZaNQO}&{F)}KMF#~L@^uID^Y^*kG~69c+^P`B5BM0?jL!o z&L@-zHBILeCp`lSa6meKQB_M+{3T&rbn1HlixMwf7cfrZ`2b~*9)6|$lz+t2E{}SG zvj41i;8Z(}Wcv|sV4%J2tjBk@eb{@leRMo{%J19I*15htfVo_Uxjf?<@&wvPy`$}Y zNaps-NW_hZTk9r>!TgisiuK)uxFFO?$ZlHd^l zg$07ZfWA8HJ;S)(X-Hbx%pAcg4ZX_N^KlHkG=gWgTO`+5&_CiD@(#F$hsUJ>zwfL^ z4hE$De!g@(eKe!}{gmUB-yM*!+Wf4XKoIjkpv9j%g^`e4!{=P%0ZH~?srjVAVZSRV zoplXk#qrHFpa2rq2SO)o%%5i+aEoF6SwSucsvQ%;KqD1+_ns0%&)e`ERKTeqoHpWd z#T6F9Vptc}t3d0RfVoWC)BEGp%X!F!Rft`cH23xSJm>oQFk1SNfk4tgJ2PoK3BVFa zif*>z2q4L;kwf?=#B7HII=rh937i=%{w|`mJYcI`Fa5hEGP_h_w`}d_l@}7W5aZB@9TSU%r&gM zL2KRqfxbT05V;OHS$5vI7J8(h5q|+Yg4cxmI=#`dl%qFx@`Us{V+l(;ZZ9!Pzwz;jZi6;u( zIe01pc(==isK!-q76i7A*hn%^>XHJZo&oP5R@Jb}H#COrqJZ*a0Lrf6fM4oD*Sq@J zZgG3gdWQX@gd+M|C6{yxkbd1TMM^_sUbjaI`lWM#J%Bc>9+pYP4ZKnXUr481XHkAI zD0@$i0qja+0gs!tXyBCJPvD9niV=SxC;_(1{!!WM3VKqdO0-nmlHZ55E_?lB0cijg z1Ms<&_P4dMeWq2>)g{qvvJ$Ycx_th1Y?pMgm@KJX!(LjApFIPxkB6%G99dW$grCwf zW@*ZZ7oY&!=5v&c@$zFp#yMVQV^4sD;RrWwQaCtp%0D*j<`WV;=a*b=H)hZeES5Gu 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 F{};Hyt^EK1 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/modeline.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/modeline.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4af2e94d507531ebcdb603621dd18a89fab8eef0 GIT binary patch literal 1569 zcmZWp-A~(A6u;MY5|f1Qm6nW2SKF9kwkDK)NQ+t!rAXVYiv=`_bkFEGq_CklWF^h*ud*WeIO8V57?bwN-Vn_11=ic+X=iKwI^g#Pw60dZZSy#&HGl2IPXSY}k5$1+>Sd4@q0SHl7PY?V1U=g;_VprDmv<1Ylx_ zrbSJXEQ%JDiLQaYKqsU+mok!W)J>&au`^^Y5Xsc!CZ|3k#X7Molzi2F2(hVH z`+!)KlG$$-KD%{0m-2mQR7IkiMKk1j?nXy{^Ygj+Y;K;Ebd$)`78TV>MUTCZv+kub zwF@OhrFPw*g_5b)3dQA8iJFa0gvpr0n*5dm_h)Osp0<2JI|7$ORu#N0fRn^m+BM0qu z@2+A8n}ZInhR#7?E8_r_LvJ|OYnIm* zguGfxSM(Z9n+CN_eMONfX$hJj{iR|_>C_6~Hnb-rFDqXD+P?wYMh>dJo^v?!Xs@%NRmNdt z$Y%`6Oan$x#y_&7pu2$?Si&fzTlc+lY_2BRF}kbPPS2g7LMz3wfr zG7eTkPRNdQ9U_Mb?A(J_gPoz*d@xSP^By3&p58h0RA&XQaWm?TXigF}e?&SB?6-T6 zW{ZfLOiXGoo7!1#DkT_2N)!vQ%bMI7pyPjmOfP_}z`0S&P!-!NhvnD94Vj`=rY@^e zO$fUz_;Pz{;=_UuaYLPj^A?u{e=b%m?@#1CkPtHlqUj~WXJa5(KLBf@7LR%dHnZ#5 zgZNl;{&3*JR&htzN$k!(8QU%Hk0hTD2q%aQU0mai`rh4LIOv;LgC6cX93J`ki&g{_ zFL~5Ay!Gi$arfVu~Q1a=8r}v*-IvAQ-n{)ez4lgEt ziMDzG*NUU~fY}T05b&`VxWK!SLP6H0LcwKVJYXZLDr_Q>UNhil;YPllzkU5yZr=1_ z^AqC-^bGlC{4ihfS0Ve$DxEe7fV`fwW`VU>jPVPG$6Wgjgrk4O#`mM|H6yJs>K|Pz kZdTW;EyN}`*oXO_^55s%5w?G@89RxyIPo&xk2^2@57Rh@<^TWy literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/plugin.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/plugin.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..45aaabcb9d4079a10e9f3fb28f81cc76025faa62 GIT binary patch literal 2628 zcmd5;&u<$=6rQmi+i`xojY$O}3kWq1iS2}{sHUxyHjWyRIwdwzV<^^UcWf`Ly{nl` z8e0ji5Qjt{l@l!|dW{1A0{;LPOYR|B^?<|$Zb>X8+7oYPZ6|i4w8xILZ{NQ8=Dm5} zdo%VQeSHB0_1FaFUSu7*;-2FgREq6|{8>e6x1m2qLDx-)LolkuosnJ(3v z@v6S>P{ybFLHgBhklktkWI*i!*;DQf_sPG5%YX#KEa!`)WU+{;ujaLquzk}$0>XH! z0hAn|q?If}bFxAr&b&_632jWWc-%4a2%on?2nf3)-0_*Ru}Ym~SAViJUutODV0Clj&$u4WY^S<;EDYNfoybeRlGjhqmsw?yK$6p?J-0;-bKs-cN zYi<|5`Pjr3pBG~Tt9Z9@U}rrF~~p}i3I19;da5ckp3zH{Gyd4KMyuYYUp$Mq*ZY2S+mLk~8$ zHy_8hHfsZssz0*t=cdYb<JQgpF;ci_4xasc@YHXE_ypm$+E|SmAk<`f z7Tq}uwL%-{q?$Bq`4fJKG5R6oL1pxt`!3$W$*^0bU=J-MZYP$qiDY_dIeTkyKAE;X zx*@AO*baz?2fzXJAg``HJh!-Xb0(ecq=)w(9RdUmf?&s}2_2{A=xovvz+L9pDG*2WT&abw za(bp(^gOEka_{GRwb59$KUVX{I8Rg0>Vl^W7hhMNhEnO}g~ag|qHjQ+CsWkcJssBK+>CvL%ZvmkvS@8sg$jF5c#Xp968YMGK2Ui4E-_+Q+B( zh49>e+4+-mmGX1Tj|1b?+;?M)4_xnH&%d)6;fX)bzF$Q{dn1!oG`#2N!{@6gc(^b literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/regexopt.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/regexopt.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f1716a9ef8646423e1a0c2a702079bfb954837b0 GIT binary patch literal 4081 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 kvMfJMzi7udV*mgE literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/sphinxext.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/sphinxext.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..680b5a4901a57618dd41ed2bb174bbd2cb907072 GIT binary patch literal 12141 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 B?jisH literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/style.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/style.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..32fd4169bda4a41bec04b6ff75b7439c5ec67e15 GIT binary patch literal 6717 zcmb_gT~HfWmcA`@>mP)W1PBBOu(5?Pe>OJpPaNAgj_m}`1ZO6rtXC^^8xR%}?iR+< zG*hlAKQJ|}N|U4p*_kcl*{KO0&+al+`;doy-j{umAXU+H@sO>3S>9ww?N9b)&$%rL zVUwAcZHl9FzkBYv=iHxjPWQjo)Yu3-FMs%A(&HoK-?34Cgc7sc#u2hYCC6`)Jf}rx@bL6H}wGZ(gvW7v zHUn*;exR+i4QM+J0PUcipK>7{=IEkEXdj{i(8JUWw3}Li9-(%iM`;bvAaw%mp)R1u zs2gZ6^#VOk8-eywAJBf<0(5}30v)97K!<1t%pn+vXcGAs;3qyIvw>VC^u$9#Pl}co z#u92}=rEwCMC%_;S8!W;B=|<=pKJkm=F(HMVj?B?$*FW)WYEv{JvN42ipa5OfXM`s z6Ek8o)u(ryi6-aLQfz8EbtZ7R%m#)A22LFx8W=hmm`Ddw(_-KUrD*~wF*4g5kVP?Y z@q=6M+(eSOG{NT#CW{o7|*hD-My`z~1*rS;dl0>SRPER7D%S=fk3h|Qz)=t6$J+*s16Y;Xmlarcj53g8`1E8yF zNZEc=rmxS!bSwp)BQQCcv2`&uxULxo<7q^?114u`D=lVeSyDZp>fVX|)l zT3aQnqc;F0w5FL*C+l+>h++b)23O}r>GFUTbxg+ulXii0{XS{eE7EQzod#)7l^tG& zJ_NL(3Ux8`V?Z0L&?bgH(XFYn!@}_2@o;`0jWH_nMB&Ft&^M-$X!*9|&f`UN!~d=Y z&=t6ZdzTarh(RIafMF2$2$AU{$uCcF$r(vHm=lnT-P>+oNaV=8(|4fCee)dB9g{OBk^d)y&xqMQ-NqQ4yhW_^=u>+ z2paXQ%0O8&#v$F>C|*GaiVWiXn1 zw6k{~pIW{6_{^Gd?c#IOy6d?u-!im5{-x`WKl(EA$56iILe6uc;PPhcKWQ#B`hZ($ zUv6LZe&sr{cJd!DJiqYesjrS*(k*a|=A*GfB|OHizwA6~PTV zs6(?RlCi|JD8*75Kaq@6sRtxAQzFS4xGkC~mWn`eCiP*%0`jb>S?3c}l;W|3C>_Th zdm>puGRBFiGuxP5w#`5?=82>P!e_Se#A3_3L9Y!oymBD10s%yqxvRhX~`2 z+yKk=fNa&)e;ofsJbPl5UlrHJH){u%j9cEW9b&K^S-Mhida{?FUVnUj!`WRp)U6s< zY|FOn@J3xnQ2>D*OO5r7VjJn`%2_&>%xc$X$G-74t%R0CyX1&<1jhT?p0+%0`Mh

?p6&F3Atmfq#j zZ(7=)aoN-AXrbe}7q(}%FKVCFuFbDcYzE%=I&dK$xUdyx?r|2z=d@b&ML_-Mm7un)Ms;Tzfq zbgm9&{cGM0U*DfPkFQOy-(8p1;+vgk_ome)d@%6)B!0Z%>)ogHHPiP2|ArH7cAnO! z*ck@rcYLrlMI-E2@qLcextDCx2%L{7-m3D0rwh;R?mv{$&rG?e>Q`ZjViA%K)NRH^ zUV*|CQv=q6sfsp8SJu6jB2*;s2C)Yu?252xOjRn#ij+Z5KZ_>Cw5Q`0jVv88iTxT) zP^s=|EK3RZIoZHL{gkqn=LfruXjM4@?d##cw}*LB9;2AbdO;hTtK8nF&0MYRKncrV zl&~Hop%@jO+J0?^TB4LBrMJK(7B^XlWYJK%gcwFR=^~Q1fduWEz*38J1|bX;(wjgu z^TZUxHIp7DrOVhgisTCRvv*ou!agyDFJi0_6!Z|*5T@dsBt|1Ck%lY1vNVWeEex5B z%wc#>#)D?aw{ck-$38A4{S{7f8_7?Qgn-Bxu}i^@#X8N&Vqq9EXPAZ0jBhXQz0&nF zRPet*AYVG1AK&=JjjWJ&v@LOk&hDJ0d&#QaDAc*sj%9vHDA?=1^7Q2GJzJihwc)&H z5TcsB?z8K8dt0HYb?Mrc$DjRR`6i(CkZhL^Etw1U`mY*#^Y-4YhTgRw=NpEXt^)Mg zOx_+SGm6sIwJ`!&sdtV|&gC$*oH_u(Bc`f;B=H{O^7Uxno4ymd`V*Uu6EBU>`9CrbV}5?LhkNZ^gl!E5j{WCk zrV{3%tMrsZVtJzs(h&6ME=>VfeSV;vf&v_z*jKYK=yxcp@6DF8UOlmLcKPh4vpr{N zXL~aSB^j&%)>GlIW($XBlXO0gydxaGJ0FSbJ**;PD=AH*6}Vwi97zJmbHa4#wNp2u zNH7k{oj@Lv9sVs&aPN#7{DN)g94Gj8Oq_6N$7B#r!kd{8(1+t7+^ot|J~z830jmCP zgI{g%n+<-k!S6NrwI*bVk&u;|L$)arvQtaQk+ueHn!vU-W9}+_>(ZHMR5O<=V|z-1 zxT;r~Ag6y|<96 zaA6G{PR!3vz$w#Z{MFEF8hq8g@|+lrMdGD_hYsp`Re^L3&AW-_nW3_0C9-cpoY2Ed zcq$T)i&8o)-jBxTp=y^<8VeVF_wfB#Lh^g~m)`~QkU+R?>d5gP_-zb4xCuYL&K&QB z-$R2rJ^;TRJvqJ=etU;={89L=t$Xlx(Lx;F2czErf3@f!9o>1pRi6meLol??;s>>O zM3%=OdBPE<$taw=W_Zu*E4}Bzi(TpSwO-ld^MFBYQMW|i6Uo<0c zAwnJCR^)9&aH&U&cH|vIaH^JK4f3@_s8>gdPUP!!+=YC-&byIsAVPzBzu1U;6A?V> zheaRq%{tzKyq^e-Sxd1M`8FbW)#+k8@&O_=Wt)l}$am^^7xIU6+YST&z*6jSH-i&( z>M?MlnK|KBuYnW5gA-o$4mbfkbD|fV03Mw1s3C9yc;>`;Z~}O6qE2ltx{wDayy{HR zjXXHv$$7iM3uu5BPSpus01sZca`j!s7HohU^*Q%p@BU G>;C|r-J{t6 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/token.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/__pycache__/token.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..7a4fdf2000d978489840d0dda800e75ad145d793 GIT binary patch literal 8194 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 is one of "lexer", "formatter" or "filter".') + special_modes.add_argument( + '-V', action='store_true', + help='Print the package version.') + special_modes.add_argument( + '-h', '--help', action='store_true', + help='Print this help.') + special_modes_group.add_argument( + '-a', metavar='ARG', + help='Formatter-specific additional argument for the -S (print ' + 'style sheet) mode.') + + argns = parser.parse_args(args[1:]) + + try: + return main_inner(parser, argns) + except BrokenPipeError: + # someone closed our stdout, e.g. by quitting a pager. + return 0 + except Exception: + if argns.v: + print(file=sys.stderr) + print('*' * 65, file=sys.stderr) + print('An unhandled exception occurred while highlighting.', + file=sys.stderr) + print('Please report the whole traceback to the issue tracker at', + file=sys.stderr) + print('.', + file=sys.stderr) + print('*' * 65, file=sys.stderr) + print(file=sys.stderr) + raise + import traceback + info = traceback.format_exception(*sys.exc_info()) + msg = info[-1].strip() + if len(info) >= 3: + # extract relevant file and position info + msg += '\n (f{})'.format(info[-2].split('\n')[0].strip()[1:]) + print(file=sys.stderr) + print('*** Error while highlighting:', file=sys.stderr) + print(msg, file=sys.stderr) + print('*** If this is a bug you want to report, please rerun with -v.', + file=sys.stderr) + return 1 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/console.py b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/console.py new file mode 100644 index 0000000..4c1a062 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/console.py @@ -0,0 +1,70 @@ +""" + pygments.console + ~~~~~~~~~~~~~~~~ + + Format colored console output. + + :copyright: Copyright 2006-2024 by the Pygments team, see AUTHORS. + :license: BSD, see LICENSE for details. +""" + +esc = "\x1b[" + +codes = {} +codes[""] = "" +codes["reset"] = esc + "39;49;00m" + +codes["bold"] = esc + "01m" +codes["faint"] = esc + "02m" +codes["standout"] = esc + "03m" +codes["underline"] = esc + "04m" +codes["blink"] = esc + "05m" +codes["overline"] = esc + "06m" + +dark_colors = ["black", "red", "green", "yellow", "blue", + "magenta", "cyan", "gray"] +light_colors = ["brightblack", "brightred", "brightgreen", "brightyellow", "brightblue", + "brightmagenta", "brightcyan", "white"] + +x = 30 +for dark, light in zip(dark_colors, light_colors): + codes[dark] = esc + "%im" % x + codes[light] = esc + "%im" % (60 + x) + x += 1 + +del dark, light, x + +codes["white"] = codes["bold"] + + +def reset_color(): + return codes["reset"] + + +def colorize(color_key, text): + return codes[color_key] + text + codes["reset"] + + +def ansiformat(attr, text): + """ + Format ``text`` with a color and/or some attributes:: + + color normal color + *color* bold color + _color_ underlined color + +color+ blinking color + """ + result = [] + if attr[:1] == attr[-1:] == '+': + result.append(codes['blink']) + attr = attr[1:-1] + if attr[:1] == attr[-1:] == '*': + result.append(codes['bold']) + attr = attr[1:-1] + if attr[:1] == attr[-1:] == '_': + result.append(codes['underline']) + attr = attr[1:-1] + result.append(codes[attr]) + result.append(text) + result.append(codes['reset']) + return ''.join(result) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/filter.py b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/filter.py new file mode 100644 index 0000000..aa6f760 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/filter.py @@ -0,0 +1,70 @@ +""" + pygments.filter + ~~~~~~~~~~~~~~~ + + Module that implements the default filter. + + :copyright: Copyright 2006-2024 by the Pygments team, see AUTHORS. + :license: BSD, see LICENSE for details. +""" + + +def apply_filters(stream, filters, lexer=None): + """ + Use this method to apply an iterable of filters to + a stream. If lexer is given it's forwarded to the + filter, otherwise the filter receives `None`. + """ + def _apply(filter_, stream): + yield from filter_.filter(lexer, stream) + for filter_ in filters: + stream = _apply(filter_, stream) + return stream + + +def simplefilter(f): + """ + Decorator that converts a function into a filter:: + + @simplefilter + def lowercase(self, lexer, stream, options): + for ttype, value in stream: + yield ttype, value.lower() + """ + return type(f.__name__, (FunctionFilter,), { + '__module__': getattr(f, '__module__'), + '__doc__': f.__doc__, + 'function': f, + }) + + +class Filter: + """ + Default filter. Subclass this class or use the `simplefilter` + decorator to create own filters. + """ + + def __init__(self, **options): + self.options = options + + def filter(self, lexer, stream): + raise NotImplementedError() + + +class FunctionFilter(Filter): + """ + Abstract class used by `simplefilter` to create simple + function filters on the fly. The `simplefilter` decorator + automatically creates subclasses of this class for + functions passed to it. + """ + function = None + + def __init__(self, **options): + if not hasattr(self, 'function'): + raise TypeError(f'{self.__class__.__name__!r} used without bound function') + Filter.__init__(self, **options) + + def filter(self, lexer, stream): + # pylint: disable=not-callable + yield from self.function(lexer, stream, self.options) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/filters/__init__.py b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/filters/__init__.py new file mode 100644 index 0000000..9255ca2 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/filters/__init__.py @@ -0,0 +1,940 @@ +""" + pygments.filters + ~~~~~~~~~~~~~~~~ + + Module containing filter lookup functions and default + filters. + + :copyright: Copyright 2006-2024 by the Pygments team, see AUTHORS. + :license: BSD, see LICENSE for details. +""" + +import re + +from pip._vendor.pygments.token import String, Comment, Keyword, Name, Error, Whitespace, \ + string_to_tokentype +from pip._vendor.pygments.filter import Filter +from pip._vendor.pygments.util import get_list_opt, get_int_opt, get_bool_opt, \ + get_choice_opt, ClassNotFound, OptionError +from pip._vendor.pygments.plugin import find_plugin_filters + + +def find_filter_class(filtername): + """Lookup a filter by name. Return None if not found.""" + if filtername in FILTERS: + return FILTERS[filtername] + for name, cls in find_plugin_filters(): + if name == filtername: + return cls + return None + + +def get_filter_by_name(filtername, **options): + """Return an instantiated filter. + + Options are passed to the filter initializer if wanted. + Raise a ClassNotFound if not found. + """ + cls = find_filter_class(filtername) + if cls: + return cls(**options) + else: + raise ClassNotFound(f'filter {filtername!r} not found') + + +def get_all_filters(): + """Return a generator of all filter names.""" + yield from FILTERS + for name, _ in find_plugin_filters(): + yield name + + +def _replace_special(ttype, value, regex, specialttype, + replacefunc=lambda x: x): + last = 0 + for match in regex.finditer(value): + start, end = match.start(), match.end() + if start != last: + yield ttype, value[last:start] + yield specialttype, replacefunc(value[start:end]) + last = end + if last != len(value): + yield ttype, value[last:] + + +class CodeTagFilter(Filter): + """Highlight special code tags in comments and docstrings. + + Options accepted: + + `codetags` : list of strings + A list of strings that are flagged as code tags. The default is to + highlight ``XXX``, ``TODO``, ``FIXME``, ``BUG`` and ``NOTE``. + + .. versionchanged:: 2.13 + Now recognizes ``FIXME`` by default. + """ + + def __init__(self, **options): + Filter.__init__(self, **options) + tags = get_list_opt(options, 'codetags', + ['XXX', 'TODO', 'FIXME', 'BUG', 'NOTE']) + self.tag_re = re.compile(r'\b({})\b'.format('|'.join([ + re.escape(tag) for tag in tags if tag + ]))) + + def filter(self, lexer, stream): + regex = self.tag_re + for ttype, value in stream: + if ttype in String.Doc or \ + ttype in Comment and \ + ttype not in Comment.Preproc: + yield from _replace_special(ttype, value, regex, Comment.Special) + else: + yield ttype, value + + +class SymbolFilter(Filter): + """Convert mathematical symbols such as \\ in Isabelle + or \\longrightarrow in LaTeX into Unicode characters. + + This is mostly useful for HTML or console output when you want to + approximate the source rendering you'd see in an IDE. + + Options accepted: + + `lang` : string + The symbol language. Must be one of ``'isabelle'`` or + ``'latex'``. The default is ``'isabelle'``. + """ + + latex_symbols = { + '\\alpha' : '\U000003b1', + '\\beta' : '\U000003b2', + '\\gamma' : '\U000003b3', + '\\delta' : '\U000003b4', + '\\varepsilon' : '\U000003b5', + '\\zeta' : '\U000003b6', + '\\eta' : '\U000003b7', + '\\vartheta' : '\U000003b8', + '\\iota' : '\U000003b9', + '\\kappa' : '\U000003ba', + '\\lambda' : '\U000003bb', + '\\mu' : '\U000003bc', + '\\nu' : '\U000003bd', + '\\xi' : '\U000003be', + '\\pi' : '\U000003c0', + '\\varrho' : '\U000003c1', + '\\sigma' : '\U000003c3', + '\\tau' : '\U000003c4', + '\\upsilon' : '\U000003c5', + '\\varphi' : '\U000003c6', + '\\chi' : '\U000003c7', + '\\psi' : '\U000003c8', + '\\omega' : '\U000003c9', + '\\Gamma' : '\U00000393', + '\\Delta' : '\U00000394', + '\\Theta' : '\U00000398', + '\\Lambda' : '\U0000039b', + '\\Xi' : '\U0000039e', + '\\Pi' : '\U000003a0', + '\\Sigma' : '\U000003a3', + '\\Upsilon' : '\U000003a5', + '\\Phi' : '\U000003a6', + '\\Psi' : '\U000003a8', + '\\Omega' : '\U000003a9', + '\\leftarrow' : '\U00002190', + '\\longleftarrow' : '\U000027f5', + '\\rightarrow' : '\U00002192', + '\\longrightarrow' : '\U000027f6', + '\\Leftarrow' : '\U000021d0', + '\\Longleftarrow' : '\U000027f8', + '\\Rightarrow' : '\U000021d2', + '\\Longrightarrow' : '\U000027f9', + '\\leftrightarrow' : '\U00002194', + '\\longleftrightarrow' : '\U000027f7', + '\\Leftrightarrow' : '\U000021d4', + '\\Longleftrightarrow' : '\U000027fa', + '\\mapsto' : '\U000021a6', + '\\longmapsto' : '\U000027fc', + '\\relbar' : '\U00002500', + '\\Relbar' : '\U00002550', + '\\hookleftarrow' : '\U000021a9', + '\\hookrightarrow' : '\U000021aa', + '\\leftharpoondown' : '\U000021bd', + '\\rightharpoondown' : '\U000021c1', + '\\leftharpoonup' : '\U000021bc', + '\\rightharpoonup' : '\U000021c0', + '\\rightleftharpoons' : '\U000021cc', + '\\leadsto' : '\U0000219d', + '\\downharpoonleft' : '\U000021c3', + '\\downharpoonright' : '\U000021c2', + '\\upharpoonleft' : '\U000021bf', + '\\upharpoonright' : '\U000021be', + '\\restriction' : '\U000021be', + '\\uparrow' : '\U00002191', + '\\Uparrow' : '\U000021d1', + '\\downarrow' : '\U00002193', + '\\Downarrow' : '\U000021d3', + '\\updownarrow' : '\U00002195', + '\\Updownarrow' : '\U000021d5', + '\\langle' : '\U000027e8', + '\\rangle' : '\U000027e9', + '\\lceil' : '\U00002308', + '\\rceil' : '\U00002309', + '\\lfloor' : '\U0000230a', + '\\rfloor' : '\U0000230b', + '\\flqq' : '\U000000ab', + '\\frqq' : '\U000000bb', + '\\bot' : '\U000022a5', + '\\top' : '\U000022a4', + '\\wedge' : '\U00002227', + '\\bigwedge' : '\U000022c0', + '\\vee' : '\U00002228', + '\\bigvee' : '\U000022c1', + '\\forall' : '\U00002200', + '\\exists' : '\U00002203', + '\\nexists' : '\U00002204', + '\\neg' : '\U000000ac', + '\\Box' : '\U000025a1', + '\\Diamond' : '\U000025c7', + '\\vdash' : '\U000022a2', + '\\models' : '\U000022a8', + '\\dashv' : '\U000022a3', + '\\surd' : '\U0000221a', + '\\le' : '\U00002264', + '\\ge' : '\U00002265', + '\\ll' : '\U0000226a', + '\\gg' : '\U0000226b', + '\\lesssim' : '\U00002272', + '\\gtrsim' : '\U00002273', + '\\lessapprox' : '\U00002a85', + '\\gtrapprox' : '\U00002a86', + '\\in' : '\U00002208', + '\\notin' : '\U00002209', + '\\subset' : '\U00002282', + '\\supset' : '\U00002283', + '\\subseteq' : '\U00002286', + '\\supseteq' : '\U00002287', + '\\sqsubset' : '\U0000228f', + '\\sqsupset' : '\U00002290', + '\\sqsubseteq' : '\U00002291', + '\\sqsupseteq' : '\U00002292', + '\\cap' : '\U00002229', + '\\bigcap' : '\U000022c2', + '\\cup' : '\U0000222a', + '\\bigcup' : '\U000022c3', + '\\sqcup' : '\U00002294', + '\\bigsqcup' : '\U00002a06', + '\\sqcap' : '\U00002293', + '\\Bigsqcap' : '\U00002a05', + '\\setminus' : '\U00002216', + '\\propto' : '\U0000221d', + '\\uplus' : '\U0000228e', + '\\bigplus' : '\U00002a04', + '\\sim' : '\U0000223c', + '\\doteq' : '\U00002250', + '\\simeq' : '\U00002243', + '\\approx' : '\U00002248', + '\\asymp' : '\U0000224d', + '\\cong' : '\U00002245', + '\\equiv' : '\U00002261', + '\\Join' : '\U000022c8', + '\\bowtie' : '\U00002a1d', + '\\prec' : '\U0000227a', + '\\succ' : '\U0000227b', + '\\preceq' : '\U0000227c', + '\\succeq' : '\U0000227d', + '\\parallel' : '\U00002225', + '\\mid' : '\U000000a6', + '\\pm' : '\U000000b1', + '\\mp' : '\U00002213', + '\\times' : '\U000000d7', + '\\div' : '\U000000f7', + '\\cdot' : '\U000022c5', + '\\star' : '\U000022c6', + '\\circ' : '\U00002218', + '\\dagger' : '\U00002020', + '\\ddagger' : '\U00002021', + '\\lhd' : '\U000022b2', + '\\rhd' : '\U000022b3', + '\\unlhd' : '\U000022b4', + '\\unrhd' : '\U000022b5', + '\\triangleleft' : '\U000025c3', + '\\triangleright' : '\U000025b9', + '\\triangle' : '\U000025b3', + '\\triangleq' : '\U0000225c', + '\\oplus' : '\U00002295', + '\\bigoplus' : '\U00002a01', + '\\otimes' : '\U00002297', + '\\bigotimes' : '\U00002a02', + '\\odot' : '\U00002299', + '\\bigodot' : '\U00002a00', + '\\ominus' : '\U00002296', + '\\oslash' : '\U00002298', + '\\dots' : '\U00002026', + '\\cdots' : '\U000022ef', + '\\sum' : '\U00002211', + '\\prod' : '\U0000220f', + '\\coprod' : '\U00002210', + '\\infty' : '\U0000221e', + '\\int' : '\U0000222b', + '\\oint' : '\U0000222e', + '\\clubsuit' : '\U00002663', + '\\diamondsuit' : '\U00002662', + '\\heartsuit' : '\U00002661', + '\\spadesuit' : '\U00002660', + '\\aleph' : '\U00002135', + '\\emptyset' : '\U00002205', + '\\nabla' : '\U00002207', + '\\partial' : '\U00002202', + '\\flat' : '\U0000266d', + '\\natural' : '\U0000266e', + '\\sharp' : '\U0000266f', + '\\angle' : '\U00002220', + '\\copyright' : '\U000000a9', + '\\textregistered' : '\U000000ae', + '\\textonequarter' : '\U000000bc', + '\\textonehalf' : '\U000000bd', + '\\textthreequarters' : '\U000000be', + '\\textordfeminine' : '\U000000aa', + '\\textordmasculine' : '\U000000ba', + '\\euro' : '\U000020ac', + '\\pounds' : '\U000000a3', + '\\yen' : '\U000000a5', + '\\textcent' : '\U000000a2', + '\\textcurrency' : '\U000000a4', + '\\textdegree' : '\U000000b0', + } + + isabelle_symbols = { + '\\' : '\U0001d7ec', + '\\' : '\U0001d7ed', + '\\' : '\U0001d7ee', + '\\' : '\U0001d7ef', + '\\' : '\U0001d7f0', + '\\' : '\U0001d7f1', + '\\' : '\U0001d7f2', + '\\' : '\U0001d7f3', + '\\' : '\U0001d7f4', + '\\' : '\U0001d7f5', + '\\' : '\U0001d49c', + '\\' : '\U0000212c', + '\\' : '\U0001d49e', + '\\' : '\U0001d49f', + '\\' : '\U00002130', + '\\' : '\U00002131', + '\\' : '\U0001d4a2', + '\\' : '\U0000210b', + '\\' : '\U00002110', + '\\' : '\U0001d4a5', + '\\' : '\U0001d4a6', + '\\' : '\U00002112', + '\\' : '\U00002133', + '\\' : '\U0001d4a9', + '\\' : '\U0001d4aa', + '\\

' : '\U0001d4ab', + '\\' : '\U0001d4ac', + '\\' : '\U0000211b', + '\\' : '\U0001d4ae', + '\\' : '\U0001d4af', + '\\' : '\U0001d4b0', + '\\' : '\U0001d4b1', + '\\' : '\U0001d4b2', + '\\' : '\U0001d4b3', + '\\' : '\U0001d4b4', + '\\' : '\U0001d4b5', + '\\' : '\U0001d5ba', + '\\' : '\U0001d5bb', + '\\' : '\U0001d5bc', + '\\' : '\U0001d5bd', + '\\' : '\U0001d5be', + '\\' : '\U0001d5bf', + '\\' : '\U0001d5c0', + '\\' : '\U0001d5c1', + '\\' : '\U0001d5c2', + '\\' : '\U0001d5c3', + '\\' : '\U0001d5c4', + '\\' : '\U0001d5c5', + '\\' : '\U0001d5c6', + '\\' : '\U0001d5c7', + '\\' : '\U0001d5c8', + '\\

' : '\U0001d5c9', + '\\' : '\U0001d5ca', + '\\' : '\U0001d5cb', + '\\' : '\U0001d5cc', + '\\' : '\U0001d5cd', + '\\' : '\U0001d5ce', + '\\' : '\U0001d5cf', + '\\' : '\U0001d5d0', + '\\' : '\U0001d5d1', + '\\' : '\U0001d5d2', + '\\' : '\U0001d5d3', + '\\' : '\U0001d504', + '\\' : '\U0001d505', + '\\' : '\U0000212d', + '\\

' : '\U0001d521', + '\\' : '\U0001d522', + '\\' : '\U0001d523', + '\\' : '\U0001d524', + '\\' : '\U0001d525', + '\\' : '\U0001d526', + '\\' : '\U0001d527', + '\\' : '\U0001d528', + '\\' : '\U0001d529', + '\\' : '\U0001d52a', + '\\' : '\U0001d52b', + '\\' : '\U0001d52c', + '\\' : '\U0001d52d', + '\\' : '\U0001d52e', + '\\' : '\U0001d52f', + '\\' : '\U0001d530', + '\\' : '\U0001d531', + '\\' : '\U0001d532', + '\\' : '\U0001d533', + '\\' : '\U0001d534', + '\\' : '\U0001d535', + '\\' : '\U0001d536', + '\\' : '\U0001d537', + '\\' : '\U000003b1', + '\\' : '\U000003b2', + '\\' : '\U000003b3', + '\\' : '\U000003b4', + '\\' : '\U000003b5', + '\\' : '\U000003b6', + '\\' : '\U000003b7', + '\\' : '\U000003b8', + '\\' : '\U000003b9', + '\\' : '\U000003ba', + '\\' : '\U000003bb', + '\\' : '\U000003bc', + '\\' : '\U000003bd', + '\\' : '\U000003be', + '\\' : '\U000003c0', + '\\' : '\U000003c1', + '\\' : '\U000003c3', + '\\' : '\U000003c4', + '\\' : '\U000003c5', + '\\' : '\U000003c6', + '\\' : '\U000003c7', + '\\' : '\U000003c8', + '\\' : '\U000003c9', + '\\' : '\U00000393', + '\\' : '\U00000394', + '\\' : '\U00000398', + '\\' : '\U0000039b', + '\\' : '\U0000039e', + '\\' : '\U000003a0', + '\\' : '\U000003a3', + '\\' : '\U000003a5', + '\\' : '\U000003a6', + '\\' : '\U000003a8', + '\\' : '\U000003a9', + '\\' : '\U0001d539', + '\\' : '\U00002102', + '\\' : '\U00002115', + '\\' : '\U0000211a', + '\\' : '\U0000211d', + '\\' : '\U00002124', + '\\' : '\U00002190', + '\\' : '\U000027f5', + '\\' : '\U00002192', + '\\' : '\U000027f6', + '\\' : '\U000021d0', + '\\' : '\U000027f8', + '\\' : '\U000021d2', + '\\' : '\U000027f9', + '\\' : '\U00002194', + '\\' : '\U000027f7', + '\\' : '\U000021d4', + '\\' : '\U000027fa', + '\\' : '\U000021a6', + '\\' : '\U000027fc', + '\\' : '\U00002500', + '\\' : '\U00002550', + '\\' : '\U000021a9', + '\\' : '\U000021aa', + '\\' : '\U000021bd', + '\\' : '\U000021c1', + '\\' : '\U000021bc', + '\\' : '\U000021c0', + '\\' : '\U000021cc', + '\\' : '\U0000219d', + '\\' : '\U000021c3', + '\\' : '\U000021c2', + '\\' : '\U000021bf', + '\\' : '\U000021be', + '\\' : '\U000021be', + '\\' : '\U00002237', + '\\' : '\U00002191', + '\\' : '\U000021d1', + '\\' : '\U00002193', + '\\' : '\U000021d3', + '\\' : '\U00002195', + '\\' : '\U000021d5', + '\\' : '\U000027e8', + '\\' : '\U000027e9', + '\\' : '\U00002308', + '\\' : '\U00002309', + '\\' : '\U0000230a', + '\\' : '\U0000230b', + '\\' : '\U00002987', + '\\' : '\U00002988', + '\\' : '\U000027e6', + '\\' : '\U000027e7', + '\\' : '\U00002983', + '\\' : '\U00002984', + '\\' : '\U000000ab', + '\\' : '\U000000bb', + '\\' : '\U000022a5', + '\\' : '\U000022a4', + '\\' : '\U00002227', + '\\' : '\U000022c0', + '\\' : '\U00002228', + '\\' : '\U000022c1', + '\\' : '\U00002200', + '\\' : '\U00002203', + '\\' : '\U00002204', + '\\' : '\U000000ac', + '\\' : '\U000025a1', + '\\' : '\U000025c7', + '\\' : '\U000022a2', + '\\' : '\U000022a8', + '\\' : '\U000022a9', + '\\' : '\U000022ab', + '\\' : '\U000022a3', + '\\' : '\U0000221a', + '\\' : '\U00002264', + '\\' : '\U00002265', + '\\' : '\U0000226a', + '\\' : '\U0000226b', + '\\' : '\U00002272', + '\\' : '\U00002273', + '\\' : '\U00002a85', + '\\' : '\U00002a86', + '\\' : '\U00002208', + '\\' : '\U00002209', + '\\' : '\U00002282', + '\\' : '\U00002283', + '\\' : '\U00002286', + '\\' : '\U00002287', + '\\' : '\U0000228f', + '\\' : '\U00002290', + '\\' : '\U00002291', + '\\' : '\U00002292', + '\\' : '\U00002229', + '\\' : '\U000022c2', + '\\' : '\U0000222a', + '\\' : '\U000022c3', + '\\' : '\U00002294', + '\\' : '\U00002a06', + '\\' : '\U00002293', + '\\' : '\U00002a05', + '\\' : '\U00002216', + '\\' : '\U0000221d', + '\\' : '\U0000228e', + '\\' : '\U00002a04', + '\\' : '\U00002260', + '\\' : '\U0000223c', + '\\' : '\U00002250', + '\\' : '\U00002243', + '\\' : '\U00002248', + '\\' : '\U0000224d', + '\\' : '\U00002245', + '\\' : '\U00002323', + '\\' : '\U00002261', + '\\' : '\U00002322', + '\\' : '\U000022c8', + '\\' : '\U00002a1d', + '\\' : '\U0000227a', + '\\' : '\U0000227b', + '\\' : '\U0000227c', + '\\' : '\U0000227d', + '\\' : '\U00002225', + '\\' : '\U000000a6', + '\\' : '\U000000b1', + '\\' : '\U00002213', + '\\' : '\U000000d7', + '\\
' : '\U000000f7', + '\\' : '\U000022c5', + '\\' : '\U000022c6', + '\\' : '\U00002219', + '\\' : '\U00002218', + '\\' : '\U00002020', + '\\' : '\U00002021', + '\\' : '\U000022b2', + '\\' : '\U000022b3', + '\\' : '\U000022b4', + '\\' : '\U000022b5', + '\\' : '\U000025c3', + '\\' : '\U000025b9', + '\\' : '\U000025b3', + '\\' : '\U0000225c', + '\\' : '\U00002295', + '\\' : '\U00002a01', + '\\' : '\U00002297', + '\\' : '\U00002a02', + '\\' : '\U00002299', + '\\' : '\U00002a00', + '\\' : '\U00002296', + '\\' : '\U00002298', + '\\' : '\U00002026', + '\\' : '\U000022ef', + '\\' : '\U00002211', + '\\' : '\U0000220f', + '\\' : '\U00002210', + '\\' : '\U0000221e', + '\\' : '\U0000222b', + '\\' : '\U0000222e', + '\\' : '\U00002663', + '\\' : '\U00002662', + '\\' : '\U00002661', + '\\' : '\U00002660', + '\\' : '\U00002135', + '\\' : '\U00002205', + '\\' : '\U00002207', + '\\' : '\U00002202', + '\\' : '\U0000266d', + '\\' : '\U0000266e', + '\\' : '\U0000266f', + '\\' : '\U00002220', + '\\' : '\U000000a9', + '\\' : '\U000000ae', + '\\' : '\U000000ad', + '\\' : '\U000000af', + '\\' : '\U000000bc', + '\\' : '\U000000bd', + '\\' : '\U000000be', + '\\' : '\U000000aa', + '\\' : '\U000000ba', + '\\
' : '\U000000a7', + '\\' : '\U000000b6', + '\\' : '\U000000a1', + '\\' : '\U000000bf', + '\\' : '\U000020ac', + '\\' : '\U000000a3', + '\\' : '\U000000a5', + '\\' : '\U000000a2', + '\\' : '\U000000a4', + '\\' : '\U000000b0', + '\\' : '\U00002a3f', + '\\' : '\U00002127', + '\\' : '\U000025ca', + '\\' : '\U00002118', + '\\' : '\U00002240', + '\\' : '\U000022c4', + '\\' : '\U000000b4', + '\\' : '\U00000131', + '\\' : '\U000000a8', + '\\' : '\U000000b8', + '\\' : '\U000002dd', + '\\' : '\U000003f5', + '\\' : '\U000023ce', + '\\' : '\U00002039', + '\\' : '\U0000203a', + '\\' : '\U00002302', + '\\<^sub>' : '\U000021e9', + '\\<^sup>' : '\U000021e7', + '\\<^bold>' : '\U00002759', + '\\<^bsub>' : '\U000021d8', + '\\<^esub>' : '\U000021d9', + '\\<^bsup>' : '\U000021d7', + '\\<^esup>' : '\U000021d6', + } + + lang_map = {'isabelle' : isabelle_symbols, 'latex' : latex_symbols} + + def __init__(self, **options): + Filter.__init__(self, **options) + lang = get_choice_opt(options, 'lang', + ['isabelle', 'latex'], 'isabelle') + self.symbols = self.lang_map[lang] + + def filter(self, lexer, stream): + for ttype, value in stream: + if value in self.symbols: + yield ttype, self.symbols[value] + else: + yield ttype, value + + +class KeywordCaseFilter(Filter): + """Convert keywords to lowercase or uppercase or capitalize them, which + means first letter uppercase, rest lowercase. + + This can be useful e.g. if you highlight Pascal code and want to adapt the + code to your styleguide. + + Options accepted: + + `case` : string + The casing to convert keywords to. Must be one of ``'lower'``, + ``'upper'`` or ``'capitalize'``. The default is ``'lower'``. + """ + + def __init__(self, **options): + Filter.__init__(self, **options) + case = get_choice_opt(options, 'case', + ['lower', 'upper', 'capitalize'], 'lower') + self.convert = getattr(str, case) + + def filter(self, lexer, stream): + for ttype, value in stream: + if ttype in Keyword: + yield ttype, self.convert(value) + else: + yield ttype, value + + +class NameHighlightFilter(Filter): + """Highlight a normal Name (and Name.*) token with a different token type. + + Example:: + + filter = NameHighlightFilter( + names=['foo', 'bar', 'baz'], + tokentype=Name.Function, + ) + + This would highlight the names "foo", "bar" and "baz" + as functions. `Name.Function` is the default token type. + + Options accepted: + + `names` : list of strings + A list of names that should be given the different token type. + There is no default. + `tokentype` : TokenType or string + A token type or a string containing a token type name that is + used for highlighting the strings in `names`. The default is + `Name.Function`. + """ + + def __init__(self, **options): + Filter.__init__(self, **options) + self.names = set(get_list_opt(options, 'names', [])) + tokentype = options.get('tokentype') + if tokentype: + self.tokentype = string_to_tokentype(tokentype) + else: + self.tokentype = Name.Function + + def filter(self, lexer, stream): + for ttype, value in stream: + if ttype in Name and value in self.names: + yield self.tokentype, value + else: + yield ttype, value + + +class ErrorToken(Exception): + pass + + +class RaiseOnErrorTokenFilter(Filter): + """Raise an exception when the lexer generates an error token. + + Options accepted: + + `excclass` : Exception class + The exception class to raise. + The default is `pygments.filters.ErrorToken`. + + .. versionadded:: 0.8 + """ + + def __init__(self, **options): + Filter.__init__(self, **options) + self.exception = options.get('excclass', ErrorToken) + try: + # issubclass() will raise TypeError if first argument is not a class + if not issubclass(self.exception, Exception): + raise TypeError + except TypeError: + raise OptionError('excclass option is not an exception class') + + def filter(self, lexer, stream): + for ttype, value in stream: + if ttype is Error: + raise self.exception(value) + yield ttype, value + + +class VisibleWhitespaceFilter(Filter): + """Convert tabs, newlines and/or spaces to visible characters. + + Options accepted: + + `spaces` : string or bool + If this is a one-character string, spaces will be replaces by this string. + If it is another true value, spaces will be replaced by ``·`` (unicode + MIDDLE DOT). If it is a false value, spaces will not be replaced. The + default is ``False``. + `tabs` : string or bool + The same as for `spaces`, but the default replacement character is ``»`` + (unicode RIGHT-POINTING DOUBLE ANGLE QUOTATION MARK). The default value + is ``False``. Note: this will not work if the `tabsize` option for the + lexer is nonzero, as tabs will already have been expanded then. + `tabsize` : int + If tabs are to be replaced by this filter (see the `tabs` option), this + is the total number of characters that a tab should be expanded to. + The default is ``8``. + `newlines` : string or bool + The same as for `spaces`, but the default replacement character is ``¶`` + (unicode PILCROW SIGN). The default value is ``False``. + `wstokentype` : bool + If true, give whitespace the special `Whitespace` token type. This allows + styling the visible whitespace differently (e.g. greyed out), but it can + disrupt background colors. The default is ``True``. + + .. versionadded:: 0.8 + """ + + def __init__(self, **options): + Filter.__init__(self, **options) + for name, default in [('spaces', '·'), + ('tabs', '»'), + ('newlines', '¶')]: + opt = options.get(name, False) + if isinstance(opt, str) and len(opt) == 1: + setattr(self, name, opt) + else: + setattr(self, name, (opt and default or '')) + tabsize = get_int_opt(options, 'tabsize', 8) + if self.tabs: + self.tabs += ' ' * (tabsize - 1) + if self.newlines: + self.newlines += '\n' + self.wstt = get_bool_opt(options, 'wstokentype', True) + + def filter(self, lexer, stream): + if self.wstt: + spaces = self.spaces or ' ' + tabs = self.tabs or '\t' + newlines = self.newlines or '\n' + regex = re.compile(r'\s') + + def replacefunc(wschar): + if wschar == ' ': + return spaces + elif wschar == '\t': + return tabs + elif wschar == '\n': + return newlines + return wschar + + for ttype, value in stream: + yield from _replace_special(ttype, value, regex, Whitespace, + replacefunc) + else: + spaces, tabs, newlines = self.spaces, self.tabs, self.newlines + # simpler processing + for ttype, value in stream: + if spaces: + value = value.replace(' ', spaces) + if tabs: + value = value.replace('\t', tabs) + if newlines: + value = value.replace('\n', newlines) + yield ttype, value + + +class GobbleFilter(Filter): + """Gobbles source code lines (eats initial characters). + + This filter drops the first ``n`` characters off every line of code. This + may be useful when the source code fed to the lexer is indented by a fixed + amount of space that isn't desired in the output. + + Options accepted: + + `n` : int + The number of characters to gobble. + + .. versionadded:: 1.2 + """ + def __init__(self, **options): + Filter.__init__(self, **options) + self.n = get_int_opt(options, 'n', 0) + + def gobble(self, value, left): + if left < len(value): + return value[left:], 0 + else: + return '', left - len(value) + + def filter(self, lexer, stream): + n = self.n + left = n # How many characters left to gobble. + for ttype, value in stream: + # Remove ``left`` tokens from first line, ``n`` from all others. + parts = value.split('\n') + (parts[0], left) = self.gobble(parts[0], left) + for i in range(1, len(parts)): + (parts[i], left) = self.gobble(parts[i], n) + value = '\n'.join(parts) + + if value != '': + yield ttype, value + + +class TokenMergeFilter(Filter): + """Merges consecutive tokens with the same token type in the output + stream of a lexer. + + .. versionadded:: 1.2 + """ + def __init__(self, **options): + Filter.__init__(self, **options) + + def filter(self, lexer, stream): + current_type = None + current_value = None + for ttype, value in stream: + if ttype is current_type: + current_value += value + else: + if current_type is not None: + yield current_type, current_value + current_type = ttype + current_value = value + if current_type is not None: + yield current_type, current_value + + +FILTERS = { + 'codetagify': CodeTagFilter, + 'keywordcase': KeywordCaseFilter, + 'highlight': NameHighlightFilter, + 'raiseonerror': RaiseOnErrorTokenFilter, + 'whitespace': VisibleWhitespaceFilter, + 'gobble': GobbleFilter, + 'tokenmerge': TokenMergeFilter, + 'symbols': SymbolFilter, +} diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/filters/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/filters/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..7786f8956d03606fd9b52b8b821ce7edce791607 GIT binary patch literal 37979 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 ZEaJbJLpgJXa%Nr`mz-*QAd&O`{{d05wZZ@Z literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatter.py b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatter.py new file mode 100644 index 0000000..d266603 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatter.py @@ -0,0 +1,129 @@ +""" + pygments.formatter + ~~~~~~~~~~~~~~~~~~ + + Base formatter class. + + :copyright: Copyright 2006-2024 by the Pygments team, see AUTHORS. + :license: BSD, see LICENSE for details. +""" + +import codecs + +from pip._vendor.pygments.util import get_bool_opt +from pip._vendor.pygments.styles import get_style_by_name + +__all__ = ['Formatter'] + + +def _lookup_style(style): + if isinstance(style, str): + return get_style_by_name(style) + return style + + +class Formatter: + """ + Converts a token stream to text. + + Formatters should have attributes to help selecting them. These + are similar to the corresponding :class:`~pygments.lexer.Lexer` + attributes. + + .. autoattribute:: name + :no-value: + + .. autoattribute:: aliases + :no-value: + + .. autoattribute:: filenames + :no-value: + + You can pass options as keyword arguments to the constructor. + All formatters accept these basic options: + + ``style`` + The style to use, can be a string or a Style subclass + (default: "default"). Not used by e.g. the + TerminalFormatter. + ``full`` + Tells the formatter to output a "full" document, i.e. + a complete self-contained document. This doesn't have + any effect for some formatters (default: false). + ``title`` + If ``full`` is true, the title that should be used to + caption the document (default: ''). + ``encoding`` + If given, must be an encoding name. This will be used to + convert the Unicode token strings to byte strings in the + output. If it is "" or None, Unicode strings will be written + to the output file, which most file-like objects do not + support (default: None). + ``outencoding`` + Overrides ``encoding`` if given. + + """ + + #: Full name for the formatter, in human-readable form. + name = None + + #: A list of short, unique identifiers that can be used to lookup + #: the formatter from a list, e.g. using :func:`.get_formatter_by_name()`. + aliases = [] + + #: A list of fnmatch patterns that match filenames for which this + #: formatter can produce output. The patterns in this list should be unique + #: among all formatters. + filenames = [] + + #: If True, this formatter outputs Unicode strings when no encoding + #: option is given. + unicodeoutput = True + + def __init__(self, **options): + """ + As with lexers, this constructor takes arbitrary optional arguments, + and if you override it, you should first process your own options, then + call the base class implementation. + """ + self.style = _lookup_style(options.get('style', 'default')) + self.full = get_bool_opt(options, 'full', False) + self.title = options.get('title', '') + self.encoding = options.get('encoding', None) or None + if self.encoding in ('guess', 'chardet'): + # can happen for e.g. pygmentize -O encoding=guess + self.encoding = 'utf-8' + self.encoding = options.get('outencoding') or self.encoding + self.options = options + + def get_style_defs(self, arg=''): + """ + This method must return statements or declarations suitable to define + the current style for subsequent highlighted text (e.g. CSS classes + in the `HTMLFormatter`). + + The optional argument `arg` can be used to modify the generation and + is formatter dependent (it is standardized because it can be given on + the command line). + + This method is called by the ``-S`` :doc:`command-line option `, + the `arg` is then given by the ``-a`` option. + """ + return '' + + def format(self, tokensource, outfile): + """ + This method must format the tokens from the `tokensource` iterable and + write the formatted version to the file object `outfile`. + + Formatter options can control how exactly the tokens are converted. + """ + if self.encoding: + # wrap the outfile in a StreamWriter + outfile = codecs.lookup(self.encoding)[3](outfile) + return self.format_unencoded(tokensource, outfile) + + # Allow writing Formatter[str] or Formatter[bytes]. That's equivalent to + # Formatter. This helps when using third-party type stubs from typeshed. + def __class_getitem__(cls, name): + return cls diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__init__.py b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__init__.py new file mode 100644 index 0000000..f19e993 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__init__.py @@ -0,0 +1,157 @@ +""" + pygments.formatters + ~~~~~~~~~~~~~~~~~~~ + + Pygments formatters. + + :copyright: Copyright 2006-2024 by the Pygments team, see AUTHORS. + :license: BSD, see LICENSE for details. +""" + +import re +import sys +import types +import fnmatch +from os.path import basename + +from pip._vendor.pygments.formatters._mapping import FORMATTERS +from pip._vendor.pygments.plugin import find_plugin_formatters +from pip._vendor.pygments.util import ClassNotFound + +__all__ = ['get_formatter_by_name', 'get_formatter_for_filename', + 'get_all_formatters', 'load_formatter_from_file'] + list(FORMATTERS) + +_formatter_cache = {} # classes by name +_pattern_cache = {} + + +def _fn_matches(fn, glob): + """Return whether the supplied file name fn matches pattern filename.""" + if glob not in _pattern_cache: + pattern = _pattern_cache[glob] = re.compile(fnmatch.translate(glob)) + return pattern.match(fn) + return _pattern_cache[glob].match(fn) + + +def _load_formatters(module_name): + """Load a formatter (and all others in the module too).""" + mod = __import__(module_name, None, None, ['__all__']) + for formatter_name in mod.__all__: + cls = getattr(mod, formatter_name) + _formatter_cache[cls.name] = cls + + +def get_all_formatters(): + """Return a generator for all formatter classes.""" + # NB: this returns formatter classes, not info like get_all_lexers(). + for info in FORMATTERS.values(): + if info[1] not in _formatter_cache: + _load_formatters(info[0]) + yield _formatter_cache[info[1]] + for _, formatter in find_plugin_formatters(): + yield formatter + + +def find_formatter_class(alias): + """Lookup a formatter by alias. + + Returns None if not found. + """ + for module_name, name, aliases, _, _ in FORMATTERS.values(): + if alias in aliases: + if name not in _formatter_cache: + _load_formatters(module_name) + return _formatter_cache[name] + for _, cls in find_plugin_formatters(): + if alias in cls.aliases: + return cls + + +def get_formatter_by_name(_alias, **options): + """ + Return an instance of a :class:`.Formatter` subclass that has `alias` in its + aliases list. The formatter is given the `options` at its instantiation. + + Will raise :exc:`pygments.util.ClassNotFound` if no formatter with that + alias is found. + """ + cls = find_formatter_class(_alias) + if cls is None: + raise ClassNotFound(f"no formatter found for name {_alias!r}") + return cls(**options) + + +def load_formatter_from_file(filename, formattername="CustomFormatter", **options): + """ + Return a `Formatter` subclass instance loaded from the provided file, relative + to the current directory. + + The file is expected to contain a Formatter class named ``formattername`` + (by default, CustomFormatter). Users should be very careful with the input, because + this method is equivalent to running ``eval()`` on the input file. The formatter is + given the `options` at its instantiation. + + :exc:`pygments.util.ClassNotFound` is raised if there are any errors loading + the formatter. + + .. versionadded:: 2.2 + """ + try: + # This empty dict will contain the namespace for the exec'd file + custom_namespace = {} + with open(filename, 'rb') as f: + exec(f.read(), custom_namespace) + # Retrieve the class `formattername` from that namespace + if formattername not in custom_namespace: + raise ClassNotFound(f'no valid {formattername} class found in {filename}') + formatter_class = custom_namespace[formattername] + # And finally instantiate it with the options + return formatter_class(**options) + except OSError as err: + raise ClassNotFound(f'cannot read {filename}: {err}') + except ClassNotFound: + raise + except Exception as err: + raise ClassNotFound(f'error when loading custom formatter: {err}') + + +def get_formatter_for_filename(fn, **options): + """ + Return a :class:`.Formatter` subclass instance that has a filename pattern + matching `fn`. The formatter is given the `options` at its instantiation. + + Will raise :exc:`pygments.util.ClassNotFound` if no formatter for that filename + is found. + """ + fn = basename(fn) + for modname, name, _, filenames, _ in FORMATTERS.values(): + for filename in filenames: + if _fn_matches(fn, filename): + if name not in _formatter_cache: + _load_formatters(modname) + return _formatter_cache[name](**options) + for _name, cls in find_plugin_formatters(): + for filename in cls.filenames: + if _fn_matches(fn, filename): + return cls(**options) + raise ClassNotFound(f"no formatter found for file name {fn!r}") + + +class _automodule(types.ModuleType): + """Automatically import formatters.""" + + def __getattr__(self, name): + info = FORMATTERS.get(name) + if info: + _load_formatters(info[0]) + cls = _formatter_cache[info[1]] + setattr(self, name, cls) + return cls + raise AttributeError(name) + + +oldmod = sys.modules[__name__] +newmod = _automodule(__name__) +newmod.__dict__.update(oldmod.__dict__) +sys.modules[__name__] = newmod +del newmod.newmod, newmod.oldmod, newmod.sys, newmod.types diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..0e0fc14add49271fd7f5b7e2bf30adabb476df47 GIT binary patch literal 6953 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 F{1w`c#Q6XK literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/_mapping.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/_mapping.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..8cb124764e42a263c1fc14321ff9a0eb584d5a5a GIT binary patch literal 4215 zcmd5mDFhJi!YY3oxEG*T^DhNP$xlNPy{!`<2CM9ban z>`)SUDA3Q)Lr(>I>7nSy=rKL?SnMf4zQ6{#>6G7_SrV(5rvNo7K(q5^-h1=jZ{DBb z*UQTb75sho+kg6p*DIB8iJ1I3#pL@_O#V`l6|dq||6KKIo`bROH89S3S1`_dS1~Sl zix`)@WsED{HH_E28yMg6Zem>ZZehIbtzlgE?qJ;T?qa;>-N*R0_W&dF9%6jQdnBuW zuYOq>z1w`8UEAE;iaoI%s{z+qsAgllk&J?Yh;-WWC#z|z*K@&^%~|$lEt@M=YQ5e+ zD&xOd1x&{$B1+kr)P1(ONg`>Bb^0O|tWYMSfSGm1m0-hEc&s;K10Ic7Zy1I`%ZT-2 zuDtXKOJg>Qhs@;>>&u`Y;$PE>!p=~+g7nz4CML6Fg z10IxJy;z&bm0gvCAiIL$Rd0~MQ3oG*EA@aU&FZ-EK?@7xvn?gK7K}5y!zAfuzKREh zamGt>UZ&(`N`|n*k?zM4BSXl%J=s%SjQ|@9L?o2en81b7ipI2QHUs5exV0p*{1bbHub@j z)n9b>_kd-csAg?E_d$zh1S-DcZ!TNJQ%3ykm#o|UI8Au;Nw>>14-o#FBjyR84@3RL z#DEKXkX{UNAtE=7DFqPpoFo$^3c)9c-Bg4=J5xMKN-Ul{Em+w5y&*gk#%0!xVq)#G zIMFhWnkMf^rxo~F%C?S=nH%ynH5t`IU8|SJv3$ z9r1fO(6F?FMGH74Pu?PtzW zXPcT3=EeEiAOGvM^TCC_Pq40T?J!HJ>ox7eXjzHqhiaw|?ohVhW6Xyh^i)cev^aT@#j{i7!P zU93F%PEP{_$EShy!*;Zp5TvI;=HSK%0?aK0n2f)D4FY?$EI{4vOBWtWG%5CDGyn}= zGw@xUCqhZ`oQEy;oV$G%%1E%-H&H|##dHx0ed-Y+6vS*%f^aBZJczp8bLI0P54Cr`*l)}7ci^@QNMq})7X3oRN6%QcI{8C{Eg!0J9$68qdE;0iO& zVs%1rD}{IrN67Bij>1#?-mD@tF*%!`h#=|br>j>AH!Mbf{mB@a`Zwn|*#>9n= z8VYm96zOI|J)`D71!l@pj*h3#2H7M!XzpOJp8xx&dk$Ov55ptXE>FupUrh0*D6l)I zH;4i|w-EgNG6YoflSIXdl1O%w6r6$;t3iZ zfoQ8l;B9^?-F};Xe6{yw>b6^_B06n{ve!<`&zoPgo_^F$r4}Df`g}W)N&6MpyjX$B z{=97alX{=FU*QK&Lj5=yUCe(xh`nJbK2a}mauxsSV~n{|tyc5-n=7^d)^FvN%KF&J z9Z=uY*FbH2>EsPi`CO&3PV|A3Um<$F(je}&pq5`HdZE%-1%3OE^?Z@&rAp)Ge^zzA zOvFmT+;Q@2L|-qIec|Lch<>Zs*R}j6(W`~B<63@;=-ZXXT`0eQUdz{rUN7YPwfqjz z8#oO6w>tIwF46Z2TG#XYM893gzi8wSh-QWSZ|eC&qTi`B9zy=n=Z*Xk(eD=fFKgdD M2K}c6^#XAH062KDYybcN literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/bbcode.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/bbcode.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..45fb4f75912d1b640978458a5bcd713961b9fb1d GIT binary patch literal 4232 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/html.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/html.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..82f3bfa95a29bf782594fc1c65fbf020fe6e585e GIT binary patch literal 41097 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⩔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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/img.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/img.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..de0d735bc7d6388680f6a8c0fe41e08954cbf4cd GIT binary patch literal 28653 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 YyvN$sV*dUi1BH+96mBt6_%TZTztQw!F#rGn literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/irc.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/irc.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f8b2372a6bb8c1cc84a624d16f0081850e91cadc GIT binary patch literal 6065 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/other.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/other.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..92c6fdca93642e2211136f6418b4220f7a6c0bc6 GIT binary patch literal 6899 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/pangomarkup.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/pangomarkup.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d9e94fabfd1fcb16abdc27c25d063915d6d952fa GIT binary patch literal 2968 zcmcIm%~Ko674P|yMnV`2GRA=IHqPRe@yALjRy2jUm++yT5|PI?_=J>734++#H|cIiw3Y zE+z1Yh`RWc3uJYPeTSOgVS`UeM9Olye4k5&cytZvk^8Wh@K1$cPbyrBCR)n>jA9st zQf`jqT}R1U_MGOr#CDW|md{ypnmt=AFqwP*dqkPg)y94dn($4k0tY&4m#{lS@Xfkk*d^NBIqVRE-~Z`PKK$X2rxa#x z#56J_?~oDv!PJ$2|MB(9<2RJ->4<8ddW6$l={T3*Lv zdjb;}SEygEt>qn4b4h~tMVH)heaY3PP2y1N7{4~v8EcNHc7eFIHE(2Q)QqJQb<%J$ zsxnXV^Qvh~tA&y~W92U>-yc#P!zFJOw9KrQBaT`y3Thg}bjt>zAlE8nsGe(ePp*|h z$&VA}a@r}7jG>w7%#3C`b_`rO3XgLbrbV>X()KX9oUFX@q6I$}@h%WihE9#q2;A;D zpsXW;QXGJp*8#pdpAvOJ7jpp997=_B={`z@^$^T*DV&gP5w?_P_dp7})+}TiYfc?i zLGUmQgMzQSIHTn$Wb$~LU>i+lH0bbe-rUBX~%;#H^HK z0aydIzQiKpx9kZ_W^bxP;9mAbPhV`!>O6L!tq|aw}+nM&U_i;4%#o z(+~v>p*lCbhbuR^kvccJhuhNR#_HVGCKqgEc{mNt+`i%QV?bE}RtY5z-SCkwWh~RO z%keP>0*tdc_W54_>AMU4$#Qs1rR1b9PFtp47RIKNWpPZMPWmCk)u7^mWH6GE^dm)@ zYSYLQpcWamm`q4Etx{i3r;WVfrqh1NaZ6B5zQo>sD8POq^Gnm=* zoK#k`U0(n&IW$MmCt=t$?KZ80^6{IrzwK)wO2g(E5OMwl(<1stKK!-ZQO>y!YbR)oT0IRjJl>a^v)xwJK1_PaZ6QWaY@(A_iuJLgw zh8r5a=Kqm_S6I3133lRO+nz`vz&s2u$OoUv3wr`BD^I5Lcjr6E;)38w3*w3=LW%xA zY#!{PE_~+|l%9CQ?f_4rm|Qnmmc~?gB}8AkZNtyP?go}0DrnF=UDoRp5xbYtT7uSV z73~axN-4To!-R#YIqtk>`Z8U(r2>KC30^=g5puQC_9(V0Z40QgJ0Nd%oZV`RSLDq$Tx&o2vR8d3z33gTwhym` z|K8bC8&tm>{e1MA|amR>aJI+jlVx~Q3TPB@*`tqhPwO7O$b zD>Vn2UW6u$k{s5z>_Ldx=ZL8ex*6@+?3dd|LrNRheYC@ilDr*5v7W^%wYIKG>+?ec zi`Q!H9gEjriE&BUJ=Z0jth*=MD(vx3z%@guUo+quvHwaL^ki^SGfi+(ux#CLP1mm) z?6$*T#~iUQP?u=WVIIDg$AU8_?RSAj|F+HqOxps-aXY-siQmQ%cX2y}V*Ssf{fprp u8A>!=0>L`WC^9+4>KIw)VgP literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/rtf.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/rtf.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..497e47a923b2c816de7e0a0b2b381e5fb1b922ce GIT binary patch literal 13824 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/svg.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/svg.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..bd6151c77ff595bc74e7c4bb2949f4f3fea1c11e GIT binary patch literal 9151 zcmb_CZEPD?a=ZNgv?z&^XxUaav@Kh*L`wcVE0P??mOn1BlZzE65#pm(+!eL*l1uL{ zC6S>L|Hu#74Qi=}LJAH+bhx5WngXW+{o(sj)NOHSiWWH1R4QWO;tcec|0!_}DEy=8 z%-da(Qs~^_&`j7n6>?6!qWuVHUg5czPWg%M?eA zQ5?-#L^^31v(VVKiq@oU%tqQa(VldSIg-vXCw$uz^q7ltd_;}81!~M=p)OLK^CRfz zEnir5ykp+1tIM7H4-W$+olPY9l&VA~B{|8eDlaP$WhOz!KB!+jWblFs&%jLP+VzW! zlu^?eHKGp>#HDmr77|nH0CUc4GDrLRPWB${J9?a%$TI2_&%9wQ&!{|`>|qq1XU@Jg zdg=8yuSLiz1ELV;Qwl%8ymIZlKK|O}b0b%;jgVzIUS$PQiFlqMYhASFu8;*E&T~={ znd`D>z67tvCL~FWNoiH{;+K$8$%pUSOrkO?PU|uvwGC>N+0(y3UJ8tD{KR9mZ96vbjXusYy|8goT^nPZ@#gHuc!saBuL=;EHwS?UMK4?*eU0PH0~*1rF3}zf%fyn*DE= z0tdI;Hhbq&Kt#o{GK;AKPme;+GR0G4G#pS1M~_)K%b1O`!U42%HmDt(9gd-s97Y!& z!Z9}StzzjZZP6km4C>l0lgxFw2aO5900&kB>9F$m0ZNR#2x90URf(|lb3%$mC5cP0hL8dsBDj<^o2o$uT87y0Pzxzem=U-PE9z_krCE`O zQ%X?2l4Ur4lFf)}4?u5YO1B_L>|_R5L!-h;@eH9=NX5krkdnYIHJj!MGLDantjwx{ zlp>Vl^1vu42a+aBl4>$*tR9IlGhpKYp5-{68yH~vBByo2&T^c9h=6P`63_rb;&DE$ z0+Mp+2$nyFjQ->4xf%-aI00SNnXm)nHeEfU(_!_+g z>J(nZO=20HCME?}L4OY;rNk`5!x6|bDLAgRYr;`X%Wx}#Y8dLSlR7JK>Qt4~E9{(* z%p~EsLpSW+4BQ|bE>(kTy9ADPXB8F514${F$w@FaV0s4~Ep`cMY^#MGK?=YMo^Km@l zJJqkRs&v^u0@J(C!$kHDG#{?q9GtjG2G|1m;*m*JI0sVF!W=Iuuq`rZ%28My%$0)X z{xGrkFeSyuc|~Dizu@+c!+`@E4xCraas`{rPl8N9jJP&|ngFSxEPI#~*g?`Qr5T<} z@R2TKhxLuA;CP(~kLV4kw1Mm0n&pUM@_4~0nF)ozmBDKS*D!A=WlGA3Rih?LnZy)m z+=Ol^2w6lVX)&WPC(x9s+bn=O#j1vh0jZg+R0!0?X$TVca=QRem;yA|BZg!OT#Bkb zoRdnvQrQw$3>GbN>ZCqNBvf+kgoAt-&$%5gV|i02W4N6F{57Oo1I2 zd9DXp1;mn^HEjNPTILmAo&o!#i>rbxjvIgi&nWu2yvg%vhK2jIW*JuL6%?TSk~E9P zpodAasVo!E$TDsy@KZrIBk;3m()8;|n&8oKhdq)rA}E%E>IQV`7ba3{$N_FKyvJuH z`6dfWP;<}W&9vR->t|ko|D2{N)r_j32cs!78p=~KYh?yK4Q|=a!qs^209}KpE_97Q570<4 zDQbh+g7wj-H&z80S7n5n_L=SK?{ssuZMMEJ8uOOCWxB=et^RWEFAUkp&3Ow)ah`VS zhw->6wauKLx0ti%t=s7K<*hYz`%U<5F#f!i+m(Z%8pvH0$QtQ!4P2lGrXrthJJq;t zrveo`6=;xV6W3gW2ZI1owow(_27^Ju_hDMNR*3N+8sAxRKy}RumHhziqGCZ4I!o=R z)R6ggfRgPHk9+5>?@}NCa+aEd-&wk=?W*R`y~qoir|P(A?uy@|xlFfBv!NHFIgL9_ zMjh8I>A5HW``vfnJ;8M~r*TVZc4En±TR#q5o0PBhNoxoBRaf!E;^)D6vJ_V8(Q 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 Ob@BA?Awr~euKy3#3nShD literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/terminal.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/__pycache__/terminal.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..755c320b5bdd0f5fada5407af99d55ea3163fa33 GIT binary patch literal 5829 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 XAxD2d?6$S=UHtsUoxkQN!PfsDuE3vu literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/_mapping.py b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/_mapping.py new file mode 100644 index 0000000..72ca840 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/_mapping.py @@ -0,0 +1,23 @@ +# Automatically generated by scripts/gen_mapfiles.py. +# DO NOT EDIT BY HAND; run `tox -e mapfiles` instead. + +FORMATTERS = { + 'BBCodeFormatter': ('pygments.formatters.bbcode', 'BBCode', ('bbcode', 'bb'), (), 'Format tokens with BBcodes. These formatting codes are used by many bulletin boards, so you can highlight your sourcecode with pygments before posting it there.'), + 'BmpImageFormatter': ('pygments.formatters.img', 'img_bmp', ('bmp', 'bitmap'), ('*.bmp',), 'Create a bitmap image from source code. This uses the Python Imaging Library to generate a pixmap from the source code.'), + 'GifImageFormatter': ('pygments.formatters.img', 'img_gif', ('gif',), ('*.gif',), 'Create a GIF image from source code. This uses the Python Imaging Library to generate a pixmap from the source code.'), + 'GroffFormatter': ('pygments.formatters.groff', 'groff', ('groff', 'troff', 'roff'), (), 'Format tokens with groff escapes to change their color and font style.'), + 'HtmlFormatter': ('pygments.formatters.html', 'HTML', ('html',), ('*.html', '*.htm'), "Format tokens as HTML 4 ```` tags. By default, the content is enclosed in a ``
`` tag, itself wrapped in a ``
`` tag (but see the `nowrap` option). The ``
``'s CSS class can be set by the `cssclass` option."), + 'IRCFormatter': ('pygments.formatters.irc', 'IRC', ('irc', 'IRC'), (), 'Format tokens with IRC color sequences'), + 'ImageFormatter': ('pygments.formatters.img', 'img', ('img', 'IMG', 'png'), ('*.png',), 'Create a PNG image from source code. This uses the Python Imaging Library to generate a pixmap from the source code.'), + 'JpgImageFormatter': ('pygments.formatters.img', 'img_jpg', ('jpg', 'jpeg'), ('*.jpg',), 'Create a JPEG image from source code. This uses the Python Imaging Library to generate a pixmap from the source code.'), + 'LatexFormatter': ('pygments.formatters.latex', 'LaTeX', ('latex', 'tex'), ('*.tex',), 'Format tokens as LaTeX code. This needs the `fancyvrb` and `color` standard packages.'), + 'NullFormatter': ('pygments.formatters.other', 'Text only', ('text', 'null'), ('*.txt',), 'Output the text unchanged without any formatting.'), + 'PangoMarkupFormatter': ('pygments.formatters.pangomarkup', 'Pango Markup', ('pango', 'pangomarkup'), (), 'Format tokens as Pango Markup code. It can then be rendered to an SVG.'), + 'RawTokenFormatter': ('pygments.formatters.other', 'Raw tokens', ('raw', 'tokens'), ('*.raw',), 'Format tokens as a raw representation for storing token streams.'), + 'RtfFormatter': ('pygments.formatters.rtf', 'RTF', ('rtf',), ('*.rtf',), 'Format tokens as RTF markup. This formatter automatically outputs full RTF documents with color information and other useful stuff. Perfect for Copy and Paste into Microsoft(R) Word(R) documents.'), + 'SvgFormatter': ('pygments.formatters.svg', 'SVG', ('svg',), ('*.svg',), 'Format tokens as an SVG graphics file. This formatter is still experimental. Each line of code is a ```` element with explicit ``x`` and ``y`` coordinates containing ```` elements with the individual token styles.'), + 'Terminal256Formatter': ('pygments.formatters.terminal256', 'Terminal256', ('terminal256', 'console256', '256'), (), 'Format tokens with ANSI color sequences, for output in a 256-color terminal or console. Like in `TerminalFormatter` color sequences are terminated at newlines, so that paging the output works correctly.'), + 'TerminalFormatter': ('pygments.formatters.terminal', 'Terminal', ('terminal', 'console'), (), 'Format tokens with ANSI color sequences, for output in a text console. Color sequences are terminated at newlines, so that paging the output works correctly.'), + 'TerminalTrueColorFormatter': ('pygments.formatters.terminal256', 'TerminalTrueColor', ('terminal16m', 'console16m', '16m'), (), 'Format tokens with ANSI color sequences, for output in a true-color terminal or console. Like in `TerminalFormatter` color sequences are terminated at newlines, so that paging the output works correctly.'), + 'TestcaseFormatter': ('pygments.formatters.other', 'Testcase', ('testcase',), (), 'Format tokens as appropriate for a new testcase.'), +} diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/bbcode.py b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/bbcode.py new file mode 100644 index 0000000..5a05bd9 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/bbcode.py @@ -0,0 +1,108 @@ +""" + pygments.formatters.bbcode + ~~~~~~~~~~~~~~~~~~~~~~~~~~ + + BBcode formatter. + + :copyright: Copyright 2006-2024 by the Pygments team, see AUTHORS. + :license: BSD, see LICENSE for details. +""" + + +from pip._vendor.pygments.formatter import Formatter +from pip._vendor.pygments.util import get_bool_opt + +__all__ = ['BBCodeFormatter'] + + +class BBCodeFormatter(Formatter): + """ + Format tokens with BBcodes. These formatting codes are used by many + bulletin boards, so you can highlight your sourcecode with pygments before + posting it there. + + This formatter has no support for background colors and borders, as there + are no common BBcode tags for that. + + Some board systems (e.g. phpBB) don't support colors in their [code] tag, + so you can't use the highlighting together with that tag. + Text in a [code] tag usually is shown with a monospace font (which this + formatter can do with the ``monofont`` option) and no spaces (which you + need for indentation) are removed. + + Additional options accepted: + + `style` + The style to use, can be a string or a Style subclass (default: + ``'default'``). + + `codetag` + If set to true, put the output into ``[code]`` tags (default: + ``false``) + + `monofont` + If set to true, add a tag to show the code with a monospace font + (default: ``false``). + """ + name = 'BBCode' + aliases = ['bbcode', 'bb'] + filenames = [] + + def __init__(self, **options): + Formatter.__init__(self, **options) + self._code = get_bool_opt(options, 'codetag', False) + self._mono = get_bool_opt(options, 'monofont', False) + + self.styles = {} + self._make_styles() + + def _make_styles(self): + for ttype, ndef in self.style: + start = end = '' + if ndef['color']: + start += '[color=#{}]'.format(ndef['color']) + end = '[/color]' + end + if ndef['bold']: + start += '[b]' + end = '[/b]' + end + if ndef['italic']: + start += '[i]' + end = '[/i]' + end + if ndef['underline']: + start += '[u]' + end = '[/u]' + end + # there are no common BBcodes for background-color and border + + self.styles[ttype] = start, end + + def format_unencoded(self, tokensource, outfile): + if self._code: + outfile.write('[code]') + if self._mono: + outfile.write('[font=monospace]') + + lastval = '' + lasttype = None + + for ttype, value in tokensource: + while ttype not in self.styles: + ttype = ttype.parent + if ttype == lasttype: + lastval += value + else: + if lastval: + start, end = self.styles[lasttype] + outfile.write(''.join((start, lastval, end))) + lastval = value + lasttype = ttype + + if lastval: + start, end = self.styles[lasttype] + outfile.write(''.join((start, lastval, end))) + + if self._mono: + outfile.write('[/font]') + if self._code: + outfile.write('[/code]') + if self._code or self._mono: + outfile.write('\n') diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/groff.py b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/groff.py new file mode 100644 index 0000000..5c8a958 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/groff.py @@ -0,0 +1,170 @@ +""" + pygments.formatters.groff + ~~~~~~~~~~~~~~~~~~~~~~~~~ + + Formatter for groff output. + + :copyright: Copyright 2006-2024 by the Pygments team, see AUTHORS. + :license: BSD, see LICENSE for details. +""" + +import math +from pip._vendor.pygments.formatter import Formatter +from pip._vendor.pygments.util import get_bool_opt, get_int_opt + +__all__ = ['GroffFormatter'] + + +class GroffFormatter(Formatter): + """ + Format tokens with groff escapes to change their color and font style. + + .. versionadded:: 2.11 + + Additional options accepted: + + `style` + The style to use, can be a string or a Style subclass (default: + ``'default'``). + + `monospaced` + If set to true, monospace font will be used (default: ``true``). + + `linenos` + If set to true, print the line numbers (default: ``false``). + + `wrap` + Wrap lines to the specified number of characters. Disabled if set to 0 + (default: ``0``). + """ + + name = 'groff' + aliases = ['groff','troff','roff'] + filenames = [] + + def __init__(self, **options): + Formatter.__init__(self, **options) + + self.monospaced = get_bool_opt(options, 'monospaced', True) + self.linenos = get_bool_opt(options, 'linenos', False) + self._lineno = 0 + self.wrap = get_int_opt(options, 'wrap', 0) + self._linelen = 0 + + self.styles = {} + self._make_styles() + + + def _make_styles(self): + regular = '\\f[CR]' if self.monospaced else '\\f[R]' + bold = '\\f[CB]' if self.monospaced else '\\f[B]' + italic = '\\f[CI]' if self.monospaced else '\\f[I]' + + for ttype, ndef in self.style: + start = end = '' + if ndef['color']: + start += '\\m[{}]'.format(ndef['color']) + end = '\\m[]' + end + if ndef['bold']: + start += bold + end = regular + end + if ndef['italic']: + start += italic + end = regular + end + if ndef['bgcolor']: + start += '\\M[{}]'.format(ndef['bgcolor']) + end = '\\M[]' + end + + self.styles[ttype] = start, end + + + def _define_colors(self, outfile): + colors = set() + for _, ndef in self.style: + if ndef['color'] is not None: + colors.add(ndef['color']) + + for color in sorted(colors): + outfile.write('.defcolor ' + color + ' rgb #' + color + '\n') + + + def _write_lineno(self, outfile): + self._lineno += 1 + outfile.write("%s% 4d " % (self._lineno != 1 and '\n' or '', self._lineno)) + + + def _wrap_line(self, line): + length = len(line.rstrip('\n')) + space = ' ' if self.linenos else '' + newline = '' + + if length > self.wrap: + for i in range(0, math.floor(length / self.wrap)): + chunk = line[i*self.wrap:i*self.wrap+self.wrap] + newline += (chunk + '\n' + space) + remainder = length % self.wrap + if remainder > 0: + newline += line[-remainder-1:] + self._linelen = remainder + elif self._linelen + length > self.wrap: + newline = ('\n' + space) + line + self._linelen = length + else: + newline = line + self._linelen += length + + return newline + + + def _escape_chars(self, text): + text = text.replace('\\', '\\[u005C]'). \ + replace('.', '\\[char46]'). \ + replace('\'', '\\[u0027]'). \ + replace('`', '\\[u0060]'). \ + replace('~', '\\[u007E]') + copy = text + + for char in copy: + if len(char) != len(char.encode()): + uni = char.encode('unicode_escape') \ + .decode()[1:] \ + .replace('x', 'u00') \ + .upper() + text = text.replace(char, '\\[u' + uni[1:] + ']') + + return text + + + def format_unencoded(self, tokensource, outfile): + self._define_colors(outfile) + + outfile.write('.nf\n\\f[CR]\n') + + if self.linenos: + self._write_lineno(outfile) + + for ttype, value in tokensource: + while ttype not in self.styles: + ttype = ttype.parent + start, end = self.styles[ttype] + + for line in value.splitlines(True): + if self.wrap > 0: + line = self._wrap_line(line) + + if start and end: + text = self._escape_chars(line.rstrip('\n')) + if text != '': + outfile.write(''.join((start, text, end))) + else: + outfile.write(self._escape_chars(line.rstrip('\n'))) + + if line.endswith('\n'): + if self.linenos: + self._write_lineno(outfile) + self._linelen = 0 + else: + outfile.write('\n') + self._linelen = 0 + + outfile.write('\n.fi') diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/html.py b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/html.py new file mode 100644 index 0000000..7aa938f --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/pygments/formatters/html.py @@ -0,0 +1,987 @@ +""" + pygments.formatters.html + ~~~~~~~~~~~~~~~~~~~~~~~~ + + Formatter for HTML output. + + :copyright: Copyright 2006-2024 by the Pygments team, see AUTHORS. + :license: BSD, see LICENSE for details. +""" + +import functools +import os +import sys +import os.path +from io import StringIO + +from pip._vendor.pygments.formatter import Formatter +from pip._vendor.pygments.token import Token, Text, STANDARD_TYPES +from pip._vendor.pygments.util import get_bool_opt, get_int_opt, get_list_opt + +try: + import ctags +except ImportError: + ctags = None + +__all__ = ['HtmlFormatter'] + + +_escape_html_table = { + ord('&'): '&', + ord('<'): '<', + ord('>'): '>', + ord('"'): '"', + ord("'"): ''', +} + + +def escape_html(text, table=_escape_html_table): + """Escape &, <, > as well as single and double quotes for HTML.""" + return text.translate(table) + + +def webify(color): + if color.startswith('calc') or color.startswith('var'): + return color + else: + return '#' + color + + +def _get_ttype_class(ttype): + fname = STANDARD_TYPES.get(ttype) + if fname: + return fname + aname = '' + while fname is None: + aname = '-' + ttype[-1] + aname + ttype = ttype.parent + fname = STANDARD_TYPES.get(ttype) + return fname + aname + + +CSSFILE_TEMPLATE = '''\ +/* +generated by Pygments +Copyright 2006-2024 by the Pygments team. +Licensed under the BSD license, see LICENSE for details. +*/ +%(styledefs)s +''' + +DOC_HEADER = '''\ + + + + + %(title)s + + + + +

%(title)s

+ +''' + +DOC_HEADER_EXTERNALCSS = '''\ + + + + + %(title)s + + + + +

%(title)s

+ +''' + +DOC_FOOTER = '''\ + + +''' + + +class HtmlFormatter(Formatter): + r""" + Format tokens as HTML 4 ```` tags. By default, the content is enclosed + in a ``
`` tag, itself wrapped in a ``
`` tag (but see the `nowrap` option). + The ``
``'s CSS class can be set by the `cssclass` option. + + If the `linenos` option is set to ``"table"``, the ``
`` is
+    additionally wrapped inside a ```` which has one row and two
+    cells: one containing the line numbers and one containing the code.
+    Example:
+
+    .. sourcecode:: html
+
+        
+
+ + +
+
1
+            2
+
+
def foo(bar):
+              pass
+            
+
+ + (whitespace added to improve clarity). + + A list of lines can be specified using the `hl_lines` option to make these + lines highlighted (as of Pygments 0.11). + + With the `full` option, a complete HTML 4 document is output, including + the style definitions inside a `` + + +
{code}
+ + +""" + +CONSOLE_SVG_FORMAT = """\ + + + + + + + + + {lines} + + + {chrome} + + {backgrounds} + + {matrix} + + + +""" + +_SVG_FONT_FAMILY = "Rich Fira Code" +_SVG_CLASSES_PREFIX = "rich-svg" diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_extension.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_extension.py new file mode 100644 index 0000000..cbd6da9 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_extension.py @@ -0,0 +1,10 @@ +from typing import Any + + +def load_ipython_extension(ip: Any) -> None: # pragma: no cover + # prevent circular import + from pip._vendor.rich.pretty import install + from pip._vendor.rich.traceback import install as tr_install + + install() + tr_install() diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_fileno.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_fileno.py new file mode 100644 index 0000000..b17ee65 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_fileno.py @@ -0,0 +1,24 @@ +from __future__ import annotations + +from typing import IO, Callable + + +def get_fileno(file_like: IO[str]) -> int | None: + """Get fileno() from a file, accounting for poorly implemented file-like objects. + + Args: + file_like (IO): A file-like object. + + Returns: + int | None: The result of fileno if available, or None if operation failed. + """ + fileno: Callable[[], int] | None = getattr(file_like, "fileno", None) + if fileno is not None: + try: + return fileno() + except Exception: + # `fileno` is documented as potentially raising a OSError + # Alas, from the issues, there are so many poorly implemented file-like objects, + # that `fileno()` can raise just about anything. + return None + return None diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_inspect.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_inspect.py new file mode 100644 index 0000000..30446ce --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_inspect.py @@ -0,0 +1,270 @@ +from __future__ import absolute_import + +import inspect +from inspect import cleandoc, getdoc, getfile, isclass, ismodule, signature +from typing import Any, Collection, Iterable, Optional, Tuple, Type, Union + +from .console import Group, RenderableType +from .control import escape_control_codes +from .highlighter import ReprHighlighter +from .jupyter import JupyterMixin +from .panel import Panel +from .pretty import Pretty +from .table import Table +from .text import Text, TextType + + +def _first_paragraph(doc: str) -> str: + """Get the first paragraph from a docstring.""" + paragraph, _, _ = doc.partition("\n\n") + return paragraph + + +class Inspect(JupyterMixin): + """A renderable to inspect any Python Object. + + Args: + obj (Any): An object to inspect. + title (str, optional): Title to display over inspect result, or None use type. Defaults to None. + help (bool, optional): Show full help text rather than just first paragraph. Defaults to False. + methods (bool, optional): Enable inspection of callables. Defaults to False. + docs (bool, optional): Also render doc strings. Defaults to True. + private (bool, optional): Show private attributes (beginning with underscore). Defaults to False. + dunder (bool, optional): Show attributes starting with double underscore. Defaults to False. + sort (bool, optional): Sort attributes alphabetically. Defaults to True. + all (bool, optional): Show all attributes. Defaults to False. + value (bool, optional): Pretty print value of object. Defaults to True. + """ + + def __init__( + self, + obj: Any, + *, + title: Optional[TextType] = None, + help: bool = False, + methods: bool = False, + docs: bool = True, + private: bool = False, + dunder: bool = False, + sort: bool = True, + all: bool = True, + value: bool = True, + ) -> None: + self.highlighter = ReprHighlighter() + self.obj = obj + self.title = title or self._make_title(obj) + if all: + methods = private = dunder = True + self.help = help + self.methods = methods + self.docs = docs or help + self.private = private or dunder + self.dunder = dunder + self.sort = sort + self.value = value + + def _make_title(self, obj: Any) -> Text: + """Make a default title.""" + title_str = ( + str(obj) + if (isclass(obj) or callable(obj) or ismodule(obj)) + else str(type(obj)) + ) + title_text = self.highlighter(title_str) + return title_text + + def __rich__(self) -> Panel: + return Panel.fit( + Group(*self._render()), + title=self.title, + border_style="scope.border", + padding=(0, 1), + ) + + def _get_signature(self, name: str, obj: Any) -> Optional[Text]: + """Get a signature for a callable.""" + try: + _signature = str(signature(obj)) + ":" + except ValueError: + _signature = "(...)" + except TypeError: + return None + + source_filename: Optional[str] = None + try: + source_filename = getfile(obj) + except (OSError, TypeError): + # OSError is raised if obj has no source file, e.g. when defined in REPL. + pass + + callable_name = Text(name, style="inspect.callable") + if source_filename: + callable_name.stylize(f"link file://{source_filename}") + signature_text = self.highlighter(_signature) + + qualname = name or getattr(obj, "__qualname__", name) + + # If obj is a module, there may be classes (which are callable) to display + if inspect.isclass(obj): + prefix = "class" + elif inspect.iscoroutinefunction(obj): + prefix = "async def" + else: + prefix = "def" + + qual_signature = Text.assemble( + (f"{prefix} ", f"inspect.{prefix.replace(' ', '_')}"), + (qualname, "inspect.callable"), + signature_text, + ) + + return qual_signature + + def _render(self) -> Iterable[RenderableType]: + """Render object.""" + + def sort_items(item: Tuple[str, Any]) -> Tuple[bool, str]: + key, (_error, value) = item + return (callable(value), key.strip("_").lower()) + + def safe_getattr(attr_name: str) -> Tuple[Any, Any]: + """Get attribute or any exception.""" + try: + return (None, getattr(obj, attr_name)) + except Exception as error: + return (error, None) + + obj = self.obj + keys = dir(obj) + total_items = len(keys) + if not self.dunder: + keys = [key for key in keys if not key.startswith("__")] + if not self.private: + keys = [key for key in keys if not key.startswith("_")] + not_shown_count = total_items - len(keys) + items = [(key, safe_getattr(key)) for key in keys] + if self.sort: + items.sort(key=sort_items) + + items_table = Table.grid(padding=(0, 1), expand=False) + items_table.add_column(justify="right") + add_row = items_table.add_row + highlighter = self.highlighter + + if callable(obj): + signature = self._get_signature("", obj) + if signature is not None: + yield signature + yield "" + + if self.docs: + _doc = self._get_formatted_doc(obj) + if _doc is not None: + doc_text = Text(_doc, style="inspect.help") + doc_text = highlighter(doc_text) + yield doc_text + yield "" + + if self.value and not (isclass(obj) or callable(obj) or ismodule(obj)): + yield Panel( + Pretty(obj, indent_guides=True, max_length=10, max_string=60), + border_style="inspect.value.border", + ) + yield "" + + for key, (error, value) in items: + key_text = Text.assemble( + ( + key, + "inspect.attr.dunder" if key.startswith("__") else "inspect.attr", + ), + (" =", "inspect.equals"), + ) + if error is not None: + warning = key_text.copy() + warning.stylize("inspect.error") + add_row(warning, highlighter(repr(error))) + continue + + if callable(value): + if not self.methods: + continue + + _signature_text = self._get_signature(key, value) + if _signature_text is None: + add_row(key_text, Pretty(value, highlighter=highlighter)) + else: + if self.docs: + docs = self._get_formatted_doc(value) + if docs is not None: + _signature_text.append("\n" if "\n" in docs else " ") + doc = highlighter(docs) + doc.stylize("inspect.doc") + _signature_text.append(doc) + + add_row(key_text, _signature_text) + else: + add_row(key_text, Pretty(value, highlighter=highlighter)) + if items_table.row_count: + yield items_table + elif not_shown_count: + yield Text.from_markup( + f"[b cyan]{not_shown_count}[/][i] attribute(s) not shown.[/i] " + f"Run [b][magenta]inspect[/]([not b]inspect[/])[/b] for options." + ) + + def _get_formatted_doc(self, object_: Any) -> Optional[str]: + """ + Extract the docstring of an object, process it and returns it. + The processing consists in cleaning up the doctring's indentation, + taking only its 1st paragraph if `self.help` is not True, + and escape its control codes. + + Args: + object_ (Any): the object to get the docstring from. + + Returns: + Optional[str]: the processed docstring, or None if no docstring was found. + """ + docs = getdoc(object_) + if docs is None: + return None + docs = cleandoc(docs).strip() + if not self.help: + docs = _first_paragraph(docs) + return escape_control_codes(docs) + + +def get_object_types_mro(obj: Union[object, Type[Any]]) -> Tuple[type, ...]: + """Returns the MRO of an object's class, or of the object itself if it's a class.""" + if not hasattr(obj, "__mro__"): + # N.B. we cannot use `if type(obj) is type` here because it doesn't work with + # some types of classes, such as the ones that use abc.ABCMeta. + obj = type(obj) + return getattr(obj, "__mro__", ()) + + +def get_object_types_mro_as_strings(obj: object) -> Collection[str]: + """ + Returns the MRO of an object's class as full qualified names, or of the object itself if it's a class. + + Examples: + `object_types_mro_as_strings(JSONDecoder)` will return `['json.decoder.JSONDecoder', 'builtins.object']` + """ + return [ + f'{getattr(type_, "__module__", "")}.{getattr(type_, "__qualname__", "")}' + for type_ in get_object_types_mro(obj) + ] + + +def is_object_one_of_types( + obj: object, fully_qualified_types_names: Collection[str] +) -> bool: + """ + Returns `True` if the given object's class (or the object itself, if it's a class) has one of the + fully qualified names in its MRO. + """ + for type_name in get_object_types_mro_as_strings(obj): + if type_name in fully_qualified_types_names: + return True + return False diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_log_render.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_log_render.py new file mode 100644 index 0000000..fc16c84 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_log_render.py @@ -0,0 +1,94 @@ +from datetime import datetime +from typing import Iterable, List, Optional, TYPE_CHECKING, Union, Callable + + +from .text import Text, TextType + +if TYPE_CHECKING: + from .console import Console, ConsoleRenderable, RenderableType + from .table import Table + +FormatTimeCallable = Callable[[datetime], Text] + + +class LogRender: + def __init__( + self, + show_time: bool = True, + show_level: bool = False, + show_path: bool = True, + time_format: Union[str, FormatTimeCallable] = "[%x %X]", + omit_repeated_times: bool = True, + level_width: Optional[int] = 8, + ) -> None: + self.show_time = show_time + self.show_level = show_level + self.show_path = show_path + self.time_format = time_format + self.omit_repeated_times = omit_repeated_times + self.level_width = level_width + self._last_time: Optional[Text] = None + + def __call__( + self, + console: "Console", + renderables: Iterable["ConsoleRenderable"], + log_time: Optional[datetime] = None, + time_format: Optional[Union[str, FormatTimeCallable]] = None, + level: TextType = "", + path: Optional[str] = None, + line_no: Optional[int] = None, + link_path: Optional[str] = None, + ) -> "Table": + from .containers import Renderables + from .table import Table + + output = Table.grid(padding=(0, 1)) + output.expand = True + if self.show_time: + output.add_column(style="log.time") + if self.show_level: + output.add_column(style="log.level", width=self.level_width) + output.add_column(ratio=1, style="log.message", overflow="fold") + if self.show_path and path: + output.add_column(style="log.path") + row: List["RenderableType"] = [] + if self.show_time: + log_time = log_time or console.get_datetime() + time_format = time_format or self.time_format + if callable(time_format): + log_time_display = time_format(log_time) + else: + log_time_display = Text(log_time.strftime(time_format)) + if log_time_display == self._last_time and self.omit_repeated_times: + row.append(Text(" " * len(log_time_display))) + else: + row.append(log_time_display) + self._last_time = log_time_display + if self.show_level: + row.append(level) + + row.append(Renderables(renderables)) + if self.show_path and path: + path_text = Text() + path_text.append( + path, style=f"link file://{link_path}" if link_path else "" + ) + if line_no: + path_text.append(":") + path_text.append( + f"{line_no}", + style=f"link file://{link_path}#{line_no}" if link_path else "", + ) + row.append(path_text) + + output.add_row(*row) + return output + + +if __name__ == "__main__": # pragma: no cover + from pip._vendor.rich.console import Console + + c = Console() + c.print("[on blue]Hello", justify="right") + c.log("[on blue]hello", justify="right") diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_loop.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_loop.py new file mode 100644 index 0000000..01c6caf --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_loop.py @@ -0,0 +1,43 @@ +from typing import Iterable, Tuple, TypeVar + +T = TypeVar("T") + + +def loop_first(values: Iterable[T]) -> Iterable[Tuple[bool, T]]: + """Iterate and generate a tuple with a flag for first value.""" + iter_values = iter(values) + try: + value = next(iter_values) + except StopIteration: + return + yield True, value + for value in iter_values: + yield False, value + + +def loop_last(values: Iterable[T]) -> Iterable[Tuple[bool, T]]: + """Iterate and generate a tuple with a flag for last value.""" + iter_values = iter(values) + try: + previous_value = next(iter_values) + except StopIteration: + return + for value in iter_values: + yield False, previous_value + previous_value = value + yield True, previous_value + + +def loop_first_last(values: Iterable[T]) -> Iterable[Tuple[bool, bool, T]]: + """Iterate and generate a tuple with a flag for first and last value.""" + iter_values = iter(values) + try: + previous_value = next(iter_values) + except StopIteration: + return + first = True + for value in iter_values: + yield first, False, previous_value + first = False + previous_value = value + yield first, True, previous_value diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_null_file.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_null_file.py new file mode 100644 index 0000000..b659673 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_null_file.py @@ -0,0 +1,69 @@ +from types import TracebackType +from typing import IO, Iterable, Iterator, List, Optional, Type + + +class NullFile(IO[str]): + def close(self) -> None: + pass + + def isatty(self) -> bool: + return False + + def read(self, __n: int = 1) -> str: + return "" + + def readable(self) -> bool: + return False + + def readline(self, __limit: int = 1) -> str: + return "" + + def readlines(self, __hint: int = 1) -> List[str]: + return [] + + def seek(self, __offset: int, __whence: int = 1) -> int: + return 0 + + def seekable(self) -> bool: + return False + + def tell(self) -> int: + return 0 + + def truncate(self, __size: Optional[int] = 1) -> int: + return 0 + + def writable(self) -> bool: + return False + + def writelines(self, __lines: Iterable[str]) -> None: + pass + + def __next__(self) -> str: + return "" + + def __iter__(self) -> Iterator[str]: + return iter([""]) + + def __enter__(self) -> IO[str]: + pass + + def __exit__( + self, + __t: Optional[Type[BaseException]], + __value: Optional[BaseException], + __traceback: Optional[TracebackType], + ) -> None: + pass + + def write(self, text: str) -> int: + return 0 + + def flush(self) -> None: + pass + + def fileno(self) -> int: + return -1 + + +NULL_FILE = NullFile() diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_palettes.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_palettes.py new file mode 100644 index 0000000..3c748d3 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_palettes.py @@ -0,0 +1,309 @@ +from .palette import Palette + + +# Taken from https://en.wikipedia.org/wiki/ANSI_escape_code (Windows 10 column) +WINDOWS_PALETTE = Palette( + [ + (12, 12, 12), + (197, 15, 31), + (19, 161, 14), + (193, 156, 0), + (0, 55, 218), + (136, 23, 152), + (58, 150, 221), + (204, 204, 204), + (118, 118, 118), + (231, 72, 86), + (22, 198, 12), + (249, 241, 165), + (59, 120, 255), + (180, 0, 158), + (97, 214, 214), + (242, 242, 242), + ] +) + +# # The standard ansi colors (including bright variants) +STANDARD_PALETTE = Palette( + [ + (0, 0, 0), + (170, 0, 0), + (0, 170, 0), + (170, 85, 0), + (0, 0, 170), + (170, 0, 170), + (0, 170, 170), + (170, 170, 170), + (85, 85, 85), + (255, 85, 85), + (85, 255, 85), + (255, 255, 85), + (85, 85, 255), + (255, 85, 255), + (85, 255, 255), + (255, 255, 255), + ] +) + + +# The 256 color palette +EIGHT_BIT_PALETTE = Palette( + [ + (0, 0, 0), + (128, 0, 0), + (0, 128, 0), + (128, 128, 0), + (0, 0, 128), + (128, 0, 128), + (0, 128, 128), + (192, 192, 192), + (128, 128, 128), + (255, 0, 0), + (0, 255, 0), + (255, 255, 0), + (0, 0, 255), + (255, 0, 255), + (0, 255, 255), + (255, 255, 255), + (0, 0, 0), + (0, 0, 95), + (0, 0, 135), + (0, 0, 175), + (0, 0, 215), + (0, 0, 255), + (0, 95, 0), + (0, 95, 95), + (0, 95, 135), + (0, 95, 175), + (0, 95, 215), + (0, 95, 255), + (0, 135, 0), + (0, 135, 95), + (0, 135, 135), + (0, 135, 175), + (0, 135, 215), + (0, 135, 255), + (0, 175, 0), + (0, 175, 95), + (0, 175, 135), + (0, 175, 175), + (0, 175, 215), + (0, 175, 255), + (0, 215, 0), + (0, 215, 95), + (0, 215, 135), + (0, 215, 175), + (0, 215, 215), + (0, 215, 255), + (0, 255, 0), + (0, 255, 95), + (0, 255, 135), + (0, 255, 175), + (0, 255, 215), + (0, 255, 255), + (95, 0, 0), + (95, 0, 95), + (95, 0, 135), + (95, 0, 175), + (95, 0, 215), + (95, 0, 255), + (95, 95, 0), + (95, 95, 95), + (95, 95, 135), + (95, 95, 175), + (95, 95, 215), + (95, 95, 255), + (95, 135, 0), + (95, 135, 95), + (95, 135, 135), + (95, 135, 175), + (95, 135, 215), + (95, 135, 255), + (95, 175, 0), + (95, 175, 95), + (95, 175, 135), + (95, 175, 175), + (95, 175, 215), + (95, 175, 255), + (95, 215, 0), + (95, 215, 95), + (95, 215, 135), + (95, 215, 175), + (95, 215, 215), + (95, 215, 255), + (95, 255, 0), + (95, 255, 95), + (95, 255, 135), + (95, 255, 175), + (95, 255, 215), + (95, 255, 255), + (135, 0, 0), + (135, 0, 95), + (135, 0, 135), + (135, 0, 175), + (135, 0, 215), + (135, 0, 255), + (135, 95, 0), + (135, 95, 95), + (135, 95, 135), + (135, 95, 175), + (135, 95, 215), + (135, 95, 255), + (135, 135, 0), + (135, 135, 95), + (135, 135, 135), + (135, 135, 175), + (135, 135, 215), + (135, 135, 255), + (135, 175, 0), + (135, 175, 95), + (135, 175, 135), + (135, 175, 175), + (135, 175, 215), + (135, 175, 255), + (135, 215, 0), + (135, 215, 95), + (135, 215, 135), + (135, 215, 175), + (135, 215, 215), + (135, 215, 255), + (135, 255, 0), + (135, 255, 95), + (135, 255, 135), + (135, 255, 175), + (135, 255, 215), + (135, 255, 255), + (175, 0, 0), + (175, 0, 95), + (175, 0, 135), + (175, 0, 175), + (175, 0, 215), + (175, 0, 255), + (175, 95, 0), + (175, 95, 95), + (175, 95, 135), + (175, 95, 175), + (175, 95, 215), + (175, 95, 255), + (175, 135, 0), + (175, 135, 95), + (175, 135, 135), + (175, 135, 175), + (175, 135, 215), + (175, 135, 255), + (175, 175, 0), + (175, 175, 95), + (175, 175, 135), + (175, 175, 175), + (175, 175, 215), + (175, 175, 255), + (175, 215, 0), + (175, 215, 95), + (175, 215, 135), + (175, 215, 175), + (175, 215, 215), + (175, 215, 255), + (175, 255, 0), + (175, 255, 95), + (175, 255, 135), + (175, 255, 175), + (175, 255, 215), + (175, 255, 255), + (215, 0, 0), + (215, 0, 95), + (215, 0, 135), + (215, 0, 175), + (215, 0, 215), + (215, 0, 255), + (215, 95, 0), + (215, 95, 95), + (215, 95, 135), + (215, 95, 175), + (215, 95, 215), + (215, 95, 255), + (215, 135, 0), + (215, 135, 95), + (215, 135, 135), + (215, 135, 175), + (215, 135, 215), + (215, 135, 255), + (215, 175, 0), + (215, 175, 95), + (215, 175, 135), + (215, 175, 175), + (215, 175, 215), + (215, 175, 255), + (215, 215, 0), + (215, 215, 95), + (215, 215, 135), + (215, 215, 175), + (215, 215, 215), + (215, 215, 255), + (215, 255, 0), + (215, 255, 95), + (215, 255, 135), + (215, 255, 175), + (215, 255, 215), + (215, 255, 255), + (255, 0, 0), + (255, 0, 95), + (255, 0, 135), + (255, 0, 175), + (255, 0, 215), + (255, 0, 255), + (255, 95, 0), + (255, 95, 95), + (255, 95, 135), + (255, 95, 175), + (255, 95, 215), + (255, 95, 255), + (255, 135, 0), + (255, 135, 95), + (255, 135, 135), + (255, 135, 175), + (255, 135, 215), + (255, 135, 255), + (255, 175, 0), + (255, 175, 95), + (255, 175, 135), + (255, 175, 175), + (255, 175, 215), + (255, 175, 255), + (255, 215, 0), + (255, 215, 95), + (255, 215, 135), + (255, 215, 175), + (255, 215, 215), + (255, 215, 255), + (255, 255, 0), + (255, 255, 95), + (255, 255, 135), + (255, 255, 175), + (255, 255, 215), + (255, 255, 255), + (8, 8, 8), + (18, 18, 18), + (28, 28, 28), + (38, 38, 38), + (48, 48, 48), + (58, 58, 58), + (68, 68, 68), + (78, 78, 78), + (88, 88, 88), + (98, 98, 98), + (108, 108, 108), + (118, 118, 118), + (128, 128, 128), + (138, 138, 138), + (148, 148, 148), + (158, 158, 158), + (168, 168, 168), + (178, 178, 178), + (188, 188, 188), + (198, 198, 198), + (208, 208, 208), + (218, 218, 218), + (228, 228, 228), + (238, 238, 238), + ] +) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_pick.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_pick.py new file mode 100644 index 0000000..4f6d8b2 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_pick.py @@ -0,0 +1,17 @@ +from typing import Optional + + +def pick_bool(*values: Optional[bool]) -> bool: + """Pick the first non-none bool or return the last value. + + Args: + *values (bool): Any number of boolean or None values. + + Returns: + bool: First non-none boolean. + """ + assert values, "1 or more values required" + for value in values: + if value is not None: + return value + return bool(value) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_ratio.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_ratio.py new file mode 100644 index 0000000..95267b0 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_ratio.py @@ -0,0 +1,159 @@ +import sys +from fractions import Fraction +from math import ceil +from typing import cast, List, Optional, Sequence + +if sys.version_info >= (3, 8): + from typing import Protocol +else: + from pip._vendor.typing_extensions import Protocol # pragma: no cover + + +class Edge(Protocol): + """Any object that defines an edge (such as Layout).""" + + size: Optional[int] = None + ratio: int = 1 + minimum_size: int = 1 + + +def ratio_resolve(total: int, edges: Sequence[Edge]) -> List[int]: + """Divide total space to satisfy size, ratio, and minimum_size, constraints. + + The returned list of integers should add up to total in most cases, unless it is + impossible to satisfy all the constraints. For instance, if there are two edges + with a minimum size of 20 each and `total` is 30 then the returned list will be + greater than total. In practice, this would mean that a Layout object would + clip the rows that would overflow the screen height. + + Args: + total (int): Total number of characters. + edges (List[Edge]): Edges within total space. + + Returns: + List[int]: Number of characters for each edge. + """ + # Size of edge or None for yet to be determined + sizes = [(edge.size or None) for edge in edges] + + _Fraction = Fraction + + # While any edges haven't been calculated + while None in sizes: + # Get flexible edges and index to map these back on to sizes list + flexible_edges = [ + (index, edge) + for index, (size, edge) in enumerate(zip(sizes, edges)) + if size is None + ] + # Remaining space in total + remaining = total - sum(size or 0 for size in sizes) + if remaining <= 0: + # No room for flexible edges + return [ + ((edge.minimum_size or 1) if size is None else size) + for size, edge in zip(sizes, edges) + ] + # Calculate number of characters in a ratio portion + portion = _Fraction( + remaining, sum((edge.ratio or 1) for _, edge in flexible_edges) + ) + + # If any edges will be less than their minimum, replace size with the minimum + for index, edge in flexible_edges: + if portion * edge.ratio <= edge.minimum_size: + sizes[index] = edge.minimum_size + # New fixed size will invalidate calculations, so we need to repeat the process + break + else: + # Distribute flexible space and compensate for rounding error + # Since edge sizes can only be integers we need to add the remainder + # to the following line + remainder = _Fraction(0) + for index, edge in flexible_edges: + size, remainder = divmod(portion * edge.ratio + remainder, 1) + sizes[index] = size + break + # Sizes now contains integers only + return cast(List[int], sizes) + + +def ratio_reduce( + total: int, ratios: List[int], maximums: List[int], values: List[int] +) -> List[int]: + """Divide an integer total in to parts based on ratios. + + Args: + total (int): The total to divide. + ratios (List[int]): A list of integer ratios. + maximums (List[int]): List of maximums values for each slot. + values (List[int]): List of values + + Returns: + List[int]: A list of integers guaranteed to sum to total. + """ + ratios = [ratio if _max else 0 for ratio, _max in zip(ratios, maximums)] + total_ratio = sum(ratios) + if not total_ratio: + return values[:] + total_remaining = total + result: List[int] = [] + append = result.append + for ratio, maximum, value in zip(ratios, maximums, values): + if ratio and total_ratio > 0: + distributed = min(maximum, round(ratio * total_remaining / total_ratio)) + append(value - distributed) + total_remaining -= distributed + total_ratio -= ratio + else: + append(value) + return result + + +def ratio_distribute( + total: int, ratios: List[int], minimums: Optional[List[int]] = None +) -> List[int]: + """Distribute an integer total in to parts based on ratios. + + Args: + total (int): The total to divide. + ratios (List[int]): A list of integer ratios. + minimums (List[int]): List of minimum values for each slot. + + Returns: + List[int]: A list of integers guaranteed to sum to total. + """ + if minimums: + ratios = [ratio if _min else 0 for ratio, _min in zip(ratios, minimums)] + total_ratio = sum(ratios) + assert total_ratio > 0, "Sum of ratios must be > 0" + + total_remaining = total + distributed_total: List[int] = [] + append = distributed_total.append + if minimums is None: + _minimums = [0] * len(ratios) + else: + _minimums = minimums + for ratio, minimum in zip(ratios, _minimums): + if total_ratio > 0: + distributed = max(minimum, ceil(ratio * total_remaining / total_ratio)) + else: + distributed = total_remaining + append(distributed) + total_ratio -= ratio + total_remaining -= distributed + return distributed_total + + +if __name__ == "__main__": + from dataclasses import dataclass + + @dataclass + class E: + size: Optional[int] = None + ratio: int = 1 + minimum_size: int = 1 + + resolved = ratio_resolve(110, [E(None, 1, 1), E(None, 1, 1), E(None, 1, 1)]) + print(sum(resolved)) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_spinners.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_spinners.py new file mode 100644 index 0000000..d0bb1fe --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_spinners.py @@ -0,0 +1,482 @@ +""" +Spinners are from: +* cli-spinners: + MIT License + Copyright (c) Sindre Sorhus (sindresorhus.com) + Permission is hereby granted, free of charge, to any person obtaining a copy + of this software and associated documentation files (the "Software"), to deal + in the Software without restriction, including without limitation the rights to + use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of + the Software, and to permit persons to whom the Software is furnished to do so, + subject to the following conditions: + The above copyright notice and this permission notice shall be included + in all copies or substantial portions of the Software. + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, + INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR + PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE + FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, + ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS + IN THE SOFTWARE. +""" + +SPINNERS = { + "dots": { + "interval": 80, + "frames": "⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏", + }, + "dots2": {"interval": 80, "frames": "⣾⣽⣻⢿⡿⣟⣯⣷"}, + "dots3": { + "interval": 80, + "frames": "⠋⠙⠚⠞⠖⠦⠴⠲⠳⠓", + }, + "dots4": { + "interval": 80, + "frames": "⠄⠆⠇⠋⠙⠸⠰⠠⠰⠸⠙⠋⠇⠆", + }, + "dots5": { + "interval": 80, + "frames": "⠋⠙⠚⠒⠂⠂⠒⠲⠴⠦⠖⠒⠐⠐⠒⠓⠋", + }, + "dots6": { + "interval": 80, + "frames": "⠁⠉⠙⠚⠒⠂⠂⠒⠲⠴⠤⠄⠄⠤⠴⠲⠒⠂⠂⠒⠚⠙⠉⠁", + }, + "dots7": { + "interval": 80, + "frames": "⠈⠉⠋⠓⠒⠐⠐⠒⠖⠦⠤⠠⠠⠤⠦⠖⠒⠐⠐⠒⠓⠋⠉⠈", + }, + "dots8": { + "interval": 80, + "frames": "⠁⠁⠉⠙⠚⠒⠂⠂⠒⠲⠴⠤⠄⠄⠤⠠⠠⠤⠦⠖⠒⠐⠐⠒⠓⠋⠉⠈⠈", + }, + "dots9": {"interval": 80, "frames": "⢹⢺⢼⣸⣇⡧⡗⡏"}, + "dots10": {"interval": 80, "frames": "⢄⢂⢁⡁⡈⡐⡠"}, + "dots11": {"interval": 100, "frames": "⠁⠂⠄⡀⢀⠠⠐⠈"}, + "dots12": { + "interval": 80, + "frames": [ + "⢀⠀", + "⡀⠀", + "⠄⠀", + "⢂⠀", + "⡂⠀", + "⠅⠀", + "⢃⠀", + "⡃⠀", + "⠍⠀", + "⢋⠀", + "⡋⠀", + "⠍⠁", + "⢋⠁", + "⡋⠁", + "⠍⠉", + "⠋⠉", + "⠋⠉", + "⠉⠙", + "⠉⠙", + "⠉⠩", + "⠈⢙", + "⠈⡙", + "⢈⠩", + "⡀⢙", + "⠄⡙", + "⢂⠩", + "⡂⢘", + "⠅⡘", + "⢃⠨", + "⡃⢐", + "⠍⡐", + "⢋⠠", + "⡋⢀", + "⠍⡁", + "⢋⠁", + "⡋⠁", + "⠍⠉", + "⠋⠉", + "⠋⠉", + "⠉⠙", + "⠉⠙", + "⠉⠩", + "⠈⢙", + "⠈⡙", + "⠈⠩", + "⠀⢙", + "⠀⡙", + "⠀⠩", + "⠀⢘", + "⠀⡘", + "⠀⠨", + "⠀⢐", + "⠀⡐", + "⠀⠠", + "⠀⢀", + "⠀⡀", + ], + }, + "dots8Bit": { + "interval": 80, + "frames": "⠀⠁⠂⠃⠄⠅⠆⠇⡀⡁⡂⡃⡄⡅⡆⡇⠈⠉⠊⠋⠌⠍⠎⠏⡈⡉⡊⡋⡌⡍⡎⡏⠐⠑⠒⠓⠔⠕⠖⠗⡐⡑⡒⡓⡔⡕⡖⡗⠘⠙⠚⠛⠜⠝⠞⠟⡘⡙" + "⡚⡛⡜⡝⡞⡟⠠⠡⠢⠣⠤⠥⠦⠧⡠⡡⡢⡣⡤⡥⡦⡧⠨⠩⠪⠫⠬⠭⠮⠯⡨⡩⡪⡫⡬⡭⡮⡯⠰⠱⠲⠳⠴⠵⠶⠷⡰⡱⡲⡳⡴⡵⡶⡷⠸⠹⠺⠻" + "⠼⠽⠾⠿⡸⡹⡺⡻⡼⡽⡾⡿⢀⢁⢂⢃⢄⢅⢆⢇⣀⣁⣂⣃⣄⣅⣆⣇⢈⢉⢊⢋⢌⢍⢎⢏⣈⣉⣊⣋⣌⣍⣎⣏⢐⢑⢒⢓⢔⢕⢖⢗⣐⣑⣒⣓⣔⣕" + "⣖⣗⢘⢙⢚⢛⢜⢝⢞⢟⣘⣙⣚⣛⣜⣝⣞⣟⢠⢡⢢⢣⢤⢥⢦⢧⣠⣡⣢⣣⣤⣥⣦⣧⢨⢩⢪⢫⢬⢭⢮⢯⣨⣩⣪⣫⣬⣭⣮⣯⢰⢱⢲⢳⢴⢵⢶⢷" + "⣰⣱⣲⣳⣴⣵⣶⣷⢸⢹⢺⢻⢼⢽⢾⢿⣸⣹⣺⣻⣼⣽⣾⣿", + }, + "line": {"interval": 130, "frames": ["-", "\\", "|", "/"]}, + "line2": {"interval": 100, "frames": "⠂-–—–-"}, + "pipe": {"interval": 100, "frames": "┤┘┴└├┌┬┐"}, + "simpleDots": {"interval": 400, "frames": [". ", ".. ", "...", " "]}, + "simpleDotsScrolling": { + "interval": 200, + "frames": [". ", ".. ", "...", " ..", " .", " "], + }, + "star": {"interval": 70, "frames": "✶✸✹✺✹✷"}, + "star2": {"interval": 80, "frames": "+x*"}, + "flip": { + "interval": 70, + "frames": "___-``'´-___", + }, + "hamburger": {"interval": 100, "frames": "☱☲☴"}, + "growVertical": { + "interval": 120, + "frames": "▁▃▄▅▆▇▆▅▄▃", + }, + "growHorizontal": { + "interval": 120, + "frames": "▏▎▍▌▋▊▉▊▋▌▍▎", + }, + "balloon": {"interval": 140, "frames": " .oO@* "}, + "balloon2": {"interval": 120, "frames": ".oO°Oo."}, + "noise": {"interval": 100, "frames": "▓▒░"}, + "bounce": {"interval": 120, "frames": "⠁⠂⠄⠂"}, + "boxBounce": {"interval": 120, "frames": "▖▘▝▗"}, + "boxBounce2": {"interval": 100, "frames": "▌▀▐▄"}, + "triangle": {"interval": 50, "frames": "◢◣◤◥"}, + "arc": {"interval": 100, "frames": "◜◠◝◞◡◟"}, + "circle": {"interval": 120, "frames": "◡⊙◠"}, + "squareCorners": {"interval": 180, "frames": "◰◳◲◱"}, + "circleQuarters": {"interval": 120, "frames": "◴◷◶◵"}, + "circleHalves": {"interval": 50, "frames": "◐◓◑◒"}, + "squish": {"interval": 100, "frames": "╫╪"}, + "toggle": {"interval": 250, "frames": "⊶⊷"}, + "toggle2": {"interval": 80, "frames": "▫▪"}, + "toggle3": {"interval": 120, "frames": "□■"}, + "toggle4": {"interval": 100, "frames": "■□▪▫"}, + "toggle5": {"interval": 100, "frames": "▮▯"}, + "toggle6": {"interval": 300, "frames": "ဝ၀"}, + "toggle7": {"interval": 80, "frames": "⦾⦿"}, + "toggle8": {"interval": 100, "frames": "◍◌"}, + "toggle9": {"interval": 100, "frames": "◉◎"}, + "toggle10": {"interval": 100, "frames": "㊂㊀㊁"}, + "toggle11": {"interval": 50, "frames": "⧇⧆"}, + "toggle12": {"interval": 120, "frames": "☗☖"}, + "toggle13": {"interval": 80, "frames": "=*-"}, + "arrow": {"interval": 100, "frames": "←↖↑↗→↘↓↙"}, + "arrow2": { + "interval": 80, + "frames": ["⬆️ ", "↗️ ", "➡️ ", "↘️ ", "⬇️ ", "↙️ ", "⬅️ ", "↖️ "], + }, + "arrow3": { + "interval": 120, + "frames": ["▹▹▹▹▹", "▸▹▹▹▹", "▹▸▹▹▹", "▹▹▸▹▹", "▹▹▹▸▹", "▹▹▹▹▸"], + }, + "bouncingBar": { + "interval": 80, + "frames": [ + "[ ]", + "[= ]", + "[== ]", + "[=== ]", + "[ ===]", + "[ ==]", + "[ =]", + "[ ]", + "[ =]", + "[ ==]", + "[ ===]", + "[====]", + "[=== ]", + "[== ]", + "[= ]", + ], + }, + "bouncingBall": { + "interval": 80, + "frames": [ + "( ● )", + "( ● )", + "( ● )", + "( ● )", + "( ●)", + "( ● )", + "( ● )", + "( ● )", + "( ● )", + "(● )", + ], + }, + "smiley": {"interval": 200, "frames": ["😄 ", "😝 "]}, + "monkey": {"interval": 300, "frames": ["🙈 ", "🙈 ", "🙉 ", "🙊 "]}, + "hearts": {"interval": 100, "frames": ["💛 ", "💙 ", "💜 ", "💚 ", "❤️ "]}, + "clock": { + "interval": 100, + "frames": [ + "🕛 ", + "🕐 ", + "🕑 ", + "🕒 ", + "🕓 ", + "🕔 ", + "🕕 ", + "🕖 ", + "🕗 ", + "🕘 ", + "🕙 ", + "🕚 ", + ], + }, + "earth": {"interval": 180, "frames": ["🌍 ", "🌎 ", "🌏 "]}, + "material": { + "interval": 17, + "frames": [ + "█▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁", + "██▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁", + "███▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁", + "████▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁", + "██████▁▁▁▁▁▁▁▁▁▁▁▁▁▁", + "██████▁▁▁▁▁▁▁▁▁▁▁▁▁▁", + "███████▁▁▁▁▁▁▁▁▁▁▁▁▁", + "████████▁▁▁▁▁▁▁▁▁▁▁▁", + "█████████▁▁▁▁▁▁▁▁▁▁▁", + "█████████▁▁▁▁▁▁▁▁▁▁▁", + "██████████▁▁▁▁▁▁▁▁▁▁", + "███████████▁▁▁▁▁▁▁▁▁", + "█████████████▁▁▁▁▁▁▁", + "██████████████▁▁▁▁▁▁", + "██████████████▁▁▁▁▁▁", + "▁██████████████▁▁▁▁▁", + "▁██████████████▁▁▁▁▁", + "▁██████████████▁▁▁▁▁", + "▁▁██████████████▁▁▁▁", + "▁▁▁██████████████▁▁▁", + "▁▁▁▁█████████████▁▁▁", + "▁▁▁▁██████████████▁▁", + "▁▁▁▁██████████████▁▁", + "▁▁▁▁▁██████████████▁", + "▁▁▁▁▁██████████████▁", + "▁▁▁▁▁██████████████▁", + "▁▁▁▁▁▁██████████████", + "▁▁▁▁▁▁██████████████", + "▁▁▁▁▁▁▁█████████████", + "▁▁▁▁▁▁▁█████████████", + "▁▁▁▁▁▁▁▁████████████", + "▁▁▁▁▁▁▁▁████████████", + "▁▁▁▁▁▁▁▁▁███████████", + "▁▁▁▁▁▁▁▁▁███████████", + "▁▁▁▁▁▁▁▁▁▁██████████", + "▁▁▁▁▁▁▁▁▁▁██████████", + "▁▁▁▁▁▁▁▁▁▁▁▁████████", + "▁▁▁▁▁▁▁▁▁▁▁▁▁███████", + "▁▁▁▁▁▁▁▁▁▁▁▁▁▁██████", + "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁█████", + "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁█████", + "█▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁████", + "██▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁███", + "██▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁███", + "███▁▁▁▁▁▁▁▁▁▁▁▁▁▁███", + "████▁▁▁▁▁▁▁▁▁▁▁▁▁▁██", + "█████▁▁▁▁▁▁▁▁▁▁▁▁▁▁█", + "█████▁▁▁▁▁▁▁▁▁▁▁▁▁▁█", + "██████▁▁▁▁▁▁▁▁▁▁▁▁▁█", + "████████▁▁▁▁▁▁▁▁▁▁▁▁", + "█████████▁▁▁▁▁▁▁▁▁▁▁", + "█████████▁▁▁▁▁▁▁▁▁▁▁", + "█████████▁▁▁▁▁▁▁▁▁▁▁", + "█████████▁▁▁▁▁▁▁▁▁▁▁", + "███████████▁▁▁▁▁▁▁▁▁", + "████████████▁▁▁▁▁▁▁▁", + "████████████▁▁▁▁▁▁▁▁", + "██████████████▁▁▁▁▁▁", + "██████████████▁▁▁▁▁▁", + "▁██████████████▁▁▁▁▁", + "▁██████████████▁▁▁▁▁", + "▁▁▁█████████████▁▁▁▁", + "▁▁▁▁▁████████████▁▁▁", + "▁▁▁▁▁████████████▁▁▁", + "▁▁▁▁▁▁███████████▁▁▁", + "▁▁▁▁▁▁▁▁█████████▁▁▁", + "▁▁▁▁▁▁▁▁█████████▁▁▁", + "▁▁▁▁▁▁▁▁▁█████████▁▁", + "▁▁▁▁▁▁▁▁▁█████████▁▁", + "▁▁▁▁▁▁▁▁▁▁█████████▁", + "▁▁▁▁▁▁▁▁▁▁▁████████▁", + "▁▁▁▁▁▁▁▁▁▁▁████████▁", + "▁▁▁▁▁▁▁▁▁▁▁▁███████▁", + "▁▁▁▁▁▁▁▁▁▁▁▁███████▁", + "▁▁▁▁▁▁▁▁▁▁▁▁▁███████", + "▁▁▁▁▁▁▁▁▁▁▁▁▁███████", + "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁█████", + "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁████", + "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁████", + "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁████", + "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁███", + "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁███", + "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁██", + "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁██", + "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁██", + "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁█", + "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁█", + "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁█", + "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁", + "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁", + "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁", + "▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁", + ], + }, + "moon": { + "interval": 80, + "frames": ["🌑 ", "🌒 ", "🌓 ", "🌔 ", "🌕 ", "🌖 ", "🌗 ", "🌘 "], + }, + "runner": {"interval": 140, "frames": ["🚶 ", "🏃 "]}, + "pong": { + "interval": 80, + "frames": [ + "▐⠂ ▌", + "▐⠈ ▌", + "▐ ⠂ ▌", + "▐ ⠠ ▌", + "▐ ⡀ ▌", + "▐ ⠠ ▌", + "▐ ⠂ ▌", + "▐ ⠈ ▌", + "▐ ⠂ ▌", + "▐ ⠠ ▌", + "▐ ⡀ ▌", + "▐ ⠠ ▌", + "▐ ⠂ ▌", + "▐ ⠈ ▌", + "▐ ⠂▌", + "▐ ⠠▌", + "▐ ⡀▌", + "▐ ⠠ ▌", + "▐ ⠂ ▌", + "▐ ⠈ ▌", + "▐ ⠂ ▌", + "▐ ⠠ ▌", + "▐ ⡀ ▌", + "▐ ⠠ ▌", + "▐ ⠂ ▌", + "▐ ⠈ ▌", + "▐ ⠂ ▌", + "▐ ⠠ ▌", + "▐ ⡀ ▌", + "▐⠠ ▌", + ], + }, + "shark": { + "interval": 120, + "frames": [ + "▐|\\____________▌", + "▐_|\\___________▌", + "▐__|\\__________▌", + "▐___|\\_________▌", + "▐____|\\________▌", + "▐_____|\\_______▌", + "▐______|\\______▌", + "▐_______|\\_____▌", + "▐________|\\____▌", + "▐_________|\\___▌", + "▐__________|\\__▌", + "▐___________|\\_▌", + "▐____________|\\▌", + "▐____________/|▌", + "▐___________/|_▌", + "▐__________/|__▌", + "▐_________/|___▌", + "▐________/|____▌", + "▐_______/|_____▌", + "▐______/|______▌", + "▐_____/|_______▌", + "▐____/|________▌", + "▐___/|_________▌", + "▐__/|__________▌", + "▐_/|___________▌", + "▐/|____________▌", + ], + }, + "dqpb": {"interval": 100, "frames": "dqpb"}, + "weather": { + "interval": 100, + "frames": [ + "☀️ ", + "☀️ ", + "☀️ ", + "🌤 ", + "⛅️ ", + "🌥 ", + "☁️ ", + "🌧 ", + "🌨 ", + "🌧 ", + "🌨 ", + "🌧 ", + "🌨 ", + "⛈ ", + "🌨 ", + "🌧 ", + "🌨 ", + "☁️ ", + "🌥 ", + "⛅️ ", + "🌤 ", + "☀️ ", + "☀️ ", + ], + }, + "christmas": {"interval": 400, "frames": "🌲🎄"}, + "grenade": { + "interval": 80, + "frames": [ + "، ", + "′ ", + " ´ ", + " ‾ ", + " ⸌", + " ⸊", + " |", + " ⁎", + " ⁕", + " ෴ ", + " ⁓", + " ", + " ", + " ", + ], + }, + "point": {"interval": 125, "frames": ["∙∙∙", "●∙∙", "∙●∙", "∙∙●", "∙∙∙"]}, + "layer": {"interval": 150, "frames": "-=≡"}, + "betaWave": { + "interval": 80, + "frames": [ + "ρββββββ", + "βρβββββ", + "ββρββββ", + "βββρβββ", + "ββββρββ", + "βββββρβ", + "ββββββρ", + ], + }, + "aesthetic": { + "interval": 80, + "frames": [ + "▰▱▱▱▱▱▱", + "▰▰▱▱▱▱▱", + "▰▰▰▱▱▱▱", + "▰▰▰▰▱▱▱", + "▰▰▰▰▰▱▱", + "▰▰▰▰▰▰▱", + "▰▰▰▰▰▰▰", + "▰▱▱▱▱▱▱", + ], + }, +} diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_stack.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_stack.py new file mode 100644 index 0000000..194564e --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_stack.py @@ -0,0 +1,16 @@ +from typing import List, TypeVar + +T = TypeVar("T") + + +class Stack(List[T]): + """A small shim over builtin list.""" + + @property + def top(self) -> T: + """Get top of stack.""" + return self[-1] + + def push(self, item: T) -> None: + """Push an item on to the stack (append in stack nomenclature).""" + self.append(item) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_timer.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_timer.py new file mode 100644 index 0000000..a2ca6be --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_timer.py @@ -0,0 +1,19 @@ +""" +Timer context manager, only used in debug. + +""" + +from time import time + +import contextlib +from typing import Generator + + +@contextlib.contextmanager +def timer(subject: str = "time") -> Generator[None, None, None]: + """print the elapsed time. (only used in debugging)""" + start = time() + yield + elapsed = time() - start + elapsed_ms = elapsed * 1000 + print(f"{subject} elapsed {elapsed_ms:.1f}ms") diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_win32_console.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_win32_console.py new file mode 100644 index 0000000..81b1082 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_win32_console.py @@ -0,0 +1,662 @@ +"""Light wrapper around the Win32 Console API - this module should only be imported on Windows + +The API that this module wraps is documented at https://docs.microsoft.com/en-us/windows/console/console-functions +""" +import ctypes +import sys +from typing import Any + +windll: Any = None +if sys.platform == "win32": + windll = ctypes.LibraryLoader(ctypes.WinDLL) +else: + raise ImportError(f"{__name__} can only be imported on Windows") + +import time +from ctypes import Structure, byref, wintypes +from typing import IO, NamedTuple, Type, cast + +from pip._vendor.rich.color import ColorSystem +from pip._vendor.rich.style import Style + +STDOUT = -11 +ENABLE_VIRTUAL_TERMINAL_PROCESSING = 4 + +COORD = wintypes._COORD + + +class LegacyWindowsError(Exception): + pass + + +class WindowsCoordinates(NamedTuple): + """Coordinates in the Windows Console API are (y, x), not (x, y). + This class is intended to prevent that confusion. + Rows and columns are indexed from 0. + This class can be used in place of wintypes._COORD in arguments and argtypes. + """ + + row: int + col: int + + @classmethod + def from_param(cls, value: "WindowsCoordinates") -> COORD: + """Converts a WindowsCoordinates into a wintypes _COORD structure. + This classmethod is internally called by ctypes to perform the conversion. + + Args: + value (WindowsCoordinates): The input coordinates to convert. + + Returns: + wintypes._COORD: The converted coordinates struct. + """ + return COORD(value.col, value.row) + + +class CONSOLE_SCREEN_BUFFER_INFO(Structure): + _fields_ = [ + ("dwSize", COORD), + ("dwCursorPosition", COORD), + ("wAttributes", wintypes.WORD), + ("srWindow", wintypes.SMALL_RECT), + ("dwMaximumWindowSize", COORD), + ] + + +class CONSOLE_CURSOR_INFO(ctypes.Structure): + _fields_ = [("dwSize", wintypes.DWORD), ("bVisible", wintypes.BOOL)] + + +_GetStdHandle = windll.kernel32.GetStdHandle +_GetStdHandle.argtypes = [ + wintypes.DWORD, +] +_GetStdHandle.restype = wintypes.HANDLE + + +def GetStdHandle(handle: int = STDOUT) -> wintypes.HANDLE: + """Retrieves a handle to the specified standard device (standard input, standard output, or standard error). + + Args: + handle (int): Integer identifier for the handle. Defaults to -11 (stdout). + + Returns: + wintypes.HANDLE: The handle + """ + return cast(wintypes.HANDLE, _GetStdHandle(handle)) + + +_GetConsoleMode = windll.kernel32.GetConsoleMode +_GetConsoleMode.argtypes = [wintypes.HANDLE, wintypes.LPDWORD] +_GetConsoleMode.restype = wintypes.BOOL + + +def GetConsoleMode(std_handle: wintypes.HANDLE) -> int: + """Retrieves the current input mode of a console's input buffer + or the current output mode of a console screen buffer. + + Args: + std_handle (wintypes.HANDLE): A handle to the console input buffer or the console screen buffer. + + Raises: + LegacyWindowsError: If any error occurs while calling the Windows console API. + + Returns: + int: Value representing the current console mode as documented at + https://docs.microsoft.com/en-us/windows/console/getconsolemode#parameters + """ + + console_mode = wintypes.DWORD() + success = bool(_GetConsoleMode(std_handle, console_mode)) + if not success: + raise LegacyWindowsError("Unable to get legacy Windows Console Mode") + return console_mode.value + + +_FillConsoleOutputCharacterW = windll.kernel32.FillConsoleOutputCharacterW +_FillConsoleOutputCharacterW.argtypes = [ + wintypes.HANDLE, + ctypes.c_char, + wintypes.DWORD, + cast(Type[COORD], WindowsCoordinates), + ctypes.POINTER(wintypes.DWORD), +] +_FillConsoleOutputCharacterW.restype = wintypes.BOOL + + +def FillConsoleOutputCharacter( + std_handle: wintypes.HANDLE, + char: str, + length: int, + start: WindowsCoordinates, +) -> int: + """Writes a character to the console screen buffer a specified number of times, beginning at the specified coordinates. + + Args: + std_handle (wintypes.HANDLE): A handle to the console input buffer or the console screen buffer. + char (str): The character to write. Must be a string of length 1. + length (int): The number of times to write the character. + start (WindowsCoordinates): The coordinates to start writing at. + + Returns: + int: The number of characters written. + """ + character = ctypes.c_char(char.encode()) + num_characters = wintypes.DWORD(length) + num_written = wintypes.DWORD(0) + _FillConsoleOutputCharacterW( + std_handle, + character, + num_characters, + start, + byref(num_written), + ) + return num_written.value + + +_FillConsoleOutputAttribute = windll.kernel32.FillConsoleOutputAttribute +_FillConsoleOutputAttribute.argtypes = [ + wintypes.HANDLE, + wintypes.WORD, + wintypes.DWORD, + cast(Type[COORD], WindowsCoordinates), + ctypes.POINTER(wintypes.DWORD), +] +_FillConsoleOutputAttribute.restype = wintypes.BOOL + + +def FillConsoleOutputAttribute( + std_handle: wintypes.HANDLE, + attributes: int, + length: int, + start: WindowsCoordinates, +) -> int: + """Sets the character attributes for a specified number of character cells, + beginning at the specified coordinates in a screen buffer. + + Args: + std_handle (wintypes.HANDLE): A handle to the console input buffer or the console screen buffer. + attributes (int): Integer value representing the foreground and background colours of the cells. + length (int): The number of cells to set the output attribute of. + start (WindowsCoordinates): The coordinates of the first cell whose attributes are to be set. + + Returns: + int: The number of cells whose attributes were actually set. + """ + num_cells = wintypes.DWORD(length) + style_attrs = wintypes.WORD(attributes) + num_written = wintypes.DWORD(0) + _FillConsoleOutputAttribute( + std_handle, style_attrs, num_cells, start, byref(num_written) + ) + return num_written.value + + +_SetConsoleTextAttribute = windll.kernel32.SetConsoleTextAttribute +_SetConsoleTextAttribute.argtypes = [ + wintypes.HANDLE, + wintypes.WORD, +] +_SetConsoleTextAttribute.restype = wintypes.BOOL + + +def SetConsoleTextAttribute( + std_handle: wintypes.HANDLE, attributes: wintypes.WORD +) -> bool: + """Set the colour attributes for all text written after this function is called. + + Args: + std_handle (wintypes.HANDLE): A handle to the console input buffer or the console screen buffer. + attributes (int): Integer value representing the foreground and background colours. + + + Returns: + bool: True if the attribute was set successfully, otherwise False. + """ + return bool(_SetConsoleTextAttribute(std_handle, attributes)) + + +_GetConsoleScreenBufferInfo = windll.kernel32.GetConsoleScreenBufferInfo +_GetConsoleScreenBufferInfo.argtypes = [ + wintypes.HANDLE, + ctypes.POINTER(CONSOLE_SCREEN_BUFFER_INFO), +] +_GetConsoleScreenBufferInfo.restype = wintypes.BOOL + + +def GetConsoleScreenBufferInfo( + std_handle: wintypes.HANDLE, +) -> CONSOLE_SCREEN_BUFFER_INFO: + """Retrieves information about the specified console screen buffer. + + Args: + std_handle (wintypes.HANDLE): A handle to the console input buffer or the console screen buffer. + + Returns: + CONSOLE_SCREEN_BUFFER_INFO: A CONSOLE_SCREEN_BUFFER_INFO ctype struct contain information about + screen size, cursor position, colour attributes, and more.""" + console_screen_buffer_info = CONSOLE_SCREEN_BUFFER_INFO() + _GetConsoleScreenBufferInfo(std_handle, byref(console_screen_buffer_info)) + return console_screen_buffer_info + + +_SetConsoleCursorPosition = windll.kernel32.SetConsoleCursorPosition +_SetConsoleCursorPosition.argtypes = [ + wintypes.HANDLE, + cast(Type[COORD], WindowsCoordinates), +] +_SetConsoleCursorPosition.restype = wintypes.BOOL + + +def SetConsoleCursorPosition( + std_handle: wintypes.HANDLE, coords: WindowsCoordinates +) -> bool: + """Set the position of the cursor in the console screen + + Args: + std_handle (wintypes.HANDLE): A handle to the console input buffer or the console screen buffer. + coords (WindowsCoordinates): The coordinates to move the cursor to. + + Returns: + bool: True if the function succeeds, otherwise False. + """ + return bool(_SetConsoleCursorPosition(std_handle, coords)) + + +_GetConsoleCursorInfo = windll.kernel32.GetConsoleCursorInfo +_GetConsoleCursorInfo.argtypes = [ + wintypes.HANDLE, + ctypes.POINTER(CONSOLE_CURSOR_INFO), +] +_GetConsoleCursorInfo.restype = wintypes.BOOL + + +def GetConsoleCursorInfo( + std_handle: wintypes.HANDLE, cursor_info: CONSOLE_CURSOR_INFO +) -> bool: + """Get the cursor info - used to get cursor visibility and width + + Args: + std_handle (wintypes.HANDLE): A handle to the console input buffer or the console screen buffer. + cursor_info (CONSOLE_CURSOR_INFO): CONSOLE_CURSOR_INFO ctype struct that receives information + about the console's cursor. + + Returns: + bool: True if the function succeeds, otherwise False. + """ + return bool(_GetConsoleCursorInfo(std_handle, byref(cursor_info))) + + +_SetConsoleCursorInfo = windll.kernel32.SetConsoleCursorInfo +_SetConsoleCursorInfo.argtypes = [ + wintypes.HANDLE, + ctypes.POINTER(CONSOLE_CURSOR_INFO), +] +_SetConsoleCursorInfo.restype = wintypes.BOOL + + +def SetConsoleCursorInfo( + std_handle: wintypes.HANDLE, cursor_info: CONSOLE_CURSOR_INFO +) -> bool: + """Set the cursor info - used for adjusting cursor visibility and width + + Args: + std_handle (wintypes.HANDLE): A handle to the console input buffer or the console screen buffer. + cursor_info (CONSOLE_CURSOR_INFO): CONSOLE_CURSOR_INFO ctype struct containing the new cursor info. + + Returns: + bool: True if the function succeeds, otherwise False. + """ + return bool(_SetConsoleCursorInfo(std_handle, byref(cursor_info))) + + +_SetConsoleTitle = windll.kernel32.SetConsoleTitleW +_SetConsoleTitle.argtypes = [wintypes.LPCWSTR] +_SetConsoleTitle.restype = wintypes.BOOL + + +def SetConsoleTitle(title: str) -> bool: + """Sets the title of the current console window + + Args: + title (str): The new title of the console window. + + Returns: + bool: True if the function succeeds, otherwise False. + """ + return bool(_SetConsoleTitle(title)) + + +class LegacyWindowsTerm: + """This class allows interaction with the legacy Windows Console API. It should only be used in the context + of environments where virtual terminal processing is not available. However, if it is used in a Windows environment, + the entire API should work. + + Args: + file (IO[str]): The file which the Windows Console API HANDLE is retrieved from, defaults to sys.stdout. + """ + + BRIGHT_BIT = 8 + + # Indices are ANSI color numbers, values are the corresponding Windows Console API color numbers + ANSI_TO_WINDOWS = [ + 0, # black The Windows colours are defined in wincon.h as follows: + 4, # red define FOREGROUND_BLUE 0x0001 -- 0000 0001 + 2, # green define FOREGROUND_GREEN 0x0002 -- 0000 0010 + 6, # yellow define FOREGROUND_RED 0x0004 -- 0000 0100 + 1, # blue define FOREGROUND_INTENSITY 0x0008 -- 0000 1000 + 5, # magenta define BACKGROUND_BLUE 0x0010 -- 0001 0000 + 3, # cyan define BACKGROUND_GREEN 0x0020 -- 0010 0000 + 7, # white define BACKGROUND_RED 0x0040 -- 0100 0000 + 8, # bright black (grey) define BACKGROUND_INTENSITY 0x0080 -- 1000 0000 + 12, # bright red + 10, # bright green + 14, # bright yellow + 9, # bright blue + 13, # bright magenta + 11, # bright cyan + 15, # bright white + ] + + def __init__(self, file: "IO[str]") -> None: + handle = GetStdHandle(STDOUT) + self._handle = handle + default_text = GetConsoleScreenBufferInfo(handle).wAttributes + self._default_text = default_text + + self._default_fore = default_text & 7 + self._default_back = (default_text >> 4) & 7 + self._default_attrs = self._default_fore | (self._default_back << 4) + + self._file = file + self.write = file.write + self.flush = file.flush + + @property + def cursor_position(self) -> WindowsCoordinates: + """Returns the current position of the cursor (0-based) + + Returns: + WindowsCoordinates: The current cursor position. + """ + coord: COORD = GetConsoleScreenBufferInfo(self._handle).dwCursorPosition + return WindowsCoordinates(row=cast(int, coord.Y), col=cast(int, coord.X)) + + @property + def screen_size(self) -> WindowsCoordinates: + """Returns the current size of the console screen buffer, in character columns and rows + + Returns: + WindowsCoordinates: The width and height of the screen as WindowsCoordinates. + """ + screen_size: COORD = GetConsoleScreenBufferInfo(self._handle).dwSize + return WindowsCoordinates( + row=cast(int, screen_size.Y), col=cast(int, screen_size.X) + ) + + def write_text(self, text: str) -> None: + """Write text directly to the terminal without any modification of styles + + Args: + text (str): The text to write to the console + """ + self.write(text) + self.flush() + + def write_styled(self, text: str, style: Style) -> None: + """Write styled text to the terminal. + + Args: + text (str): The text to write + style (Style): The style of the text + """ + color = style.color + bgcolor = style.bgcolor + if style.reverse: + color, bgcolor = bgcolor, color + + if color: + fore = color.downgrade(ColorSystem.WINDOWS).number + fore = fore if fore is not None else 7 # Default to ANSI 7: White + if style.bold: + fore = fore | self.BRIGHT_BIT + if style.dim: + fore = fore & ~self.BRIGHT_BIT + fore = self.ANSI_TO_WINDOWS[fore] + else: + fore = self._default_fore + + if bgcolor: + back = bgcolor.downgrade(ColorSystem.WINDOWS).number + back = back if back is not None else 0 # Default to ANSI 0: Black + back = self.ANSI_TO_WINDOWS[back] + else: + back = self._default_back + + assert fore is not None + assert back is not None + + SetConsoleTextAttribute( + self._handle, attributes=ctypes.c_ushort(fore | (back << 4)) + ) + self.write_text(text) + SetConsoleTextAttribute(self._handle, attributes=self._default_text) + + def move_cursor_to(self, new_position: WindowsCoordinates) -> None: + """Set the position of the cursor + + Args: + new_position (WindowsCoordinates): The WindowsCoordinates representing the new position of the cursor. + """ + if new_position.col < 0 or new_position.row < 0: + return + SetConsoleCursorPosition(self._handle, coords=new_position) + + def erase_line(self) -> None: + """Erase all content on the line the cursor is currently located at""" + screen_size = self.screen_size + cursor_position = self.cursor_position + cells_to_erase = screen_size.col + start_coordinates = WindowsCoordinates(row=cursor_position.row, col=0) + FillConsoleOutputCharacter( + self._handle, " ", length=cells_to_erase, start=start_coordinates + ) + FillConsoleOutputAttribute( + self._handle, + self._default_attrs, + length=cells_to_erase, + start=start_coordinates, + ) + + def erase_end_of_line(self) -> None: + """Erase all content from the cursor position to the end of that line""" + cursor_position = self.cursor_position + cells_to_erase = self.screen_size.col - cursor_position.col + FillConsoleOutputCharacter( + self._handle, " ", length=cells_to_erase, start=cursor_position + ) + FillConsoleOutputAttribute( + self._handle, + self._default_attrs, + length=cells_to_erase, + start=cursor_position, + ) + + def erase_start_of_line(self) -> None: + """Erase all content from the cursor position to the start of that line""" + row, col = self.cursor_position + start = WindowsCoordinates(row, 0) + FillConsoleOutputCharacter(self._handle, " ", length=col, start=start) + FillConsoleOutputAttribute( + self._handle, self._default_attrs, length=col, start=start + ) + + def move_cursor_up(self) -> None: + """Move the cursor up a single cell""" + cursor_position = self.cursor_position + SetConsoleCursorPosition( + self._handle, + coords=WindowsCoordinates( + row=cursor_position.row - 1, col=cursor_position.col + ), + ) + + def move_cursor_down(self) -> None: + """Move the cursor down a single cell""" + cursor_position = self.cursor_position + SetConsoleCursorPosition( + self._handle, + coords=WindowsCoordinates( + row=cursor_position.row + 1, + col=cursor_position.col, + ), + ) + + def move_cursor_forward(self) -> None: + """Move the cursor forward a single cell. Wrap to the next line if required.""" + row, col = self.cursor_position + if col == self.screen_size.col - 1: + row += 1 + col = 0 + else: + col += 1 + SetConsoleCursorPosition( + self._handle, coords=WindowsCoordinates(row=row, col=col) + ) + + def move_cursor_to_column(self, column: int) -> None: + """Move cursor to the column specified by the zero-based column index, staying on the same row + + Args: + column (int): The zero-based column index to move the cursor to. + """ + row, _ = self.cursor_position + SetConsoleCursorPosition(self._handle, coords=WindowsCoordinates(row, column)) + + def move_cursor_backward(self) -> None: + """Move the cursor backward a single cell. Wrap to the previous line if required.""" + row, col = self.cursor_position + if col == 0: + row -= 1 + col = self.screen_size.col - 1 + else: + col -= 1 + SetConsoleCursorPosition( + self._handle, coords=WindowsCoordinates(row=row, col=col) + ) + + def hide_cursor(self) -> None: + """Hide the cursor""" + current_cursor_size = self._get_cursor_size() + invisible_cursor = CONSOLE_CURSOR_INFO(dwSize=current_cursor_size, bVisible=0) + SetConsoleCursorInfo(self._handle, cursor_info=invisible_cursor) + + def show_cursor(self) -> None: + """Show the cursor""" + current_cursor_size = self._get_cursor_size() + visible_cursor = CONSOLE_CURSOR_INFO(dwSize=current_cursor_size, bVisible=1) + SetConsoleCursorInfo(self._handle, cursor_info=visible_cursor) + + def set_title(self, title: str) -> None: + """Set the title of the terminal window + + Args: + title (str): The new title of the console window + """ + assert len(title) < 255, "Console title must be less than 255 characters" + SetConsoleTitle(title) + + def _get_cursor_size(self) -> int: + """Get the percentage of the character cell that is filled by the cursor""" + cursor_info = CONSOLE_CURSOR_INFO() + GetConsoleCursorInfo(self._handle, cursor_info=cursor_info) + return int(cursor_info.dwSize) + + +if __name__ == "__main__": + handle = GetStdHandle() + + from pip._vendor.rich.console import Console + + console = Console() + + term = LegacyWindowsTerm(sys.stdout) + term.set_title("Win32 Console Examples") + + style = Style(color="black", bgcolor="red") + + heading = Style.parse("black on green") + + # Check colour output + console.rule("Checking colour output") + console.print("[on red]on red!") + console.print("[blue]blue!") + console.print("[yellow]yellow!") + console.print("[bold yellow]bold yellow!") + console.print("[bright_yellow]bright_yellow!") + console.print("[dim bright_yellow]dim bright_yellow!") + console.print("[italic cyan]italic cyan!") + console.print("[bold white on blue]bold white on blue!") + console.print("[reverse bold white on blue]reverse bold white on blue!") + console.print("[bold black on cyan]bold black on cyan!") + console.print("[black on green]black on green!") + console.print("[blue on green]blue on green!") + console.print("[white on black]white on black!") + console.print("[black on white]black on white!") + console.print("[#1BB152 on #DA812D]#1BB152 on #DA812D!") + + # Check cursor movement + console.rule("Checking cursor movement") + console.print() + term.move_cursor_backward() + term.move_cursor_backward() + term.write_text("went back and wrapped to prev line") + time.sleep(1) + term.move_cursor_up() + term.write_text("we go up") + time.sleep(1) + term.move_cursor_down() + term.write_text("and down") + time.sleep(1) + term.move_cursor_up() + term.move_cursor_backward() + term.move_cursor_backward() + term.write_text("we went up and back 2") + time.sleep(1) + term.move_cursor_down() + term.move_cursor_backward() + term.move_cursor_backward() + term.write_text("we went down and back 2") + time.sleep(1) + + # Check erasing of lines + term.hide_cursor() + console.print() + console.rule("Checking line erasing") + console.print("\n...Deleting to the start of the line...") + term.write_text("The red arrow shows the cursor location, and direction of erase") + time.sleep(1) + term.move_cursor_to_column(16) + term.write_styled("<", Style.parse("black on red")) + term.move_cursor_backward() + time.sleep(1) + term.erase_start_of_line() + time.sleep(1) + + console.print("\n\n...And to the end of the line...") + term.write_text("The red arrow shows the cursor location, and direction of erase") + time.sleep(1) + + term.move_cursor_to_column(16) + term.write_styled(">", Style.parse("black on red")) + time.sleep(1) + term.erase_end_of_line() + time.sleep(1) + + console.print("\n\n...Now the whole line will be erased...") + term.write_styled("I'm going to disappear!", style=Style.parse("black on cyan")) + time.sleep(1) + term.erase_line() + + term.show_cursor() + print("\n") diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_windows.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_windows.py new file mode 100644 index 0000000..7520a9f --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_windows.py @@ -0,0 +1,71 @@ +import sys +from dataclasses import dataclass + + +@dataclass +class WindowsConsoleFeatures: + """Windows features available.""" + + vt: bool = False + """The console supports VT codes.""" + truecolor: bool = False + """The console supports truecolor.""" + + +try: + import ctypes + from ctypes import LibraryLoader + + if sys.platform == "win32": + windll = LibraryLoader(ctypes.WinDLL) + else: + windll = None + raise ImportError("Not windows") + + from pip._vendor.rich._win32_console import ( + ENABLE_VIRTUAL_TERMINAL_PROCESSING, + GetConsoleMode, + GetStdHandle, + LegacyWindowsError, + ) + +except (AttributeError, ImportError, ValueError): + # Fallback if we can't load the Windows DLL + def get_windows_console_features() -> WindowsConsoleFeatures: + features = WindowsConsoleFeatures() + return features + +else: + + def get_windows_console_features() -> WindowsConsoleFeatures: + """Get windows console features. + + Returns: + WindowsConsoleFeatures: An instance of WindowsConsoleFeatures. + """ + handle = GetStdHandle() + try: + console_mode = GetConsoleMode(handle) + success = True + except LegacyWindowsError: + console_mode = 0 + success = False + vt = bool(success and console_mode & ENABLE_VIRTUAL_TERMINAL_PROCESSING) + truecolor = False + if vt: + win_version = sys.getwindowsversion() + truecolor = win_version.major > 10 or ( + win_version.major == 10 and win_version.build >= 15063 + ) + features = WindowsConsoleFeatures(vt=vt, truecolor=truecolor) + return features + + +if __name__ == "__main__": + import platform + + features = get_windows_console_features() + from pip._vendor.rich import print + + print(f'platform="{platform.system()}"') + print(repr(features)) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_windows_renderer.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_windows_renderer.py new file mode 100644 index 0000000..5ece056 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_windows_renderer.py @@ -0,0 +1,56 @@ +from typing import Iterable, Sequence, Tuple, cast + +from pip._vendor.rich._win32_console import LegacyWindowsTerm, WindowsCoordinates +from pip._vendor.rich.segment import ControlCode, ControlType, Segment + + +def legacy_windows_render(buffer: Iterable[Segment], term: LegacyWindowsTerm) -> None: + """Makes appropriate Windows Console API calls based on the segments in the buffer. + + Args: + buffer (Iterable[Segment]): Iterable of Segments to convert to Win32 API calls. + term (LegacyWindowsTerm): Used to call the Windows Console API. + """ + for text, style, control in buffer: + if not control: + if style: + term.write_styled(text, style) + else: + term.write_text(text) + else: + control_codes: Sequence[ControlCode] = control + for control_code in control_codes: + control_type = control_code[0] + if control_type == ControlType.CURSOR_MOVE_TO: + _, x, y = cast(Tuple[ControlType, int, int], control_code) + term.move_cursor_to(WindowsCoordinates(row=y - 1, col=x - 1)) + elif control_type == ControlType.CARRIAGE_RETURN: + term.write_text("\r") + elif control_type == ControlType.HOME: + term.move_cursor_to(WindowsCoordinates(0, 0)) + elif control_type == ControlType.CURSOR_UP: + term.move_cursor_up() + elif control_type == ControlType.CURSOR_DOWN: + term.move_cursor_down() + elif control_type == ControlType.CURSOR_FORWARD: + term.move_cursor_forward() + elif control_type == ControlType.CURSOR_BACKWARD: + term.move_cursor_backward() + elif control_type == ControlType.CURSOR_MOVE_TO_COLUMN: + _, column = cast(Tuple[ControlType, int], control_code) + term.move_cursor_to_column(column - 1) + elif control_type == ControlType.HIDE_CURSOR: + term.hide_cursor() + elif control_type == ControlType.SHOW_CURSOR: + term.show_cursor() + elif control_type == ControlType.ERASE_IN_LINE: + _, mode = cast(Tuple[ControlType, int], control_code) + if mode == 0: + term.erase_end_of_line() + elif mode == 1: + term.erase_start_of_line() + elif mode == 2: + term.erase_line() + elif control_type == ControlType.SET_WINDOW_TITLE: + _, title = cast(Tuple[ControlType, str], control_code) + term.set_title(title) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_wrap.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_wrap.py new file mode 100644 index 0000000..2e94ff6 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/_wrap.py @@ -0,0 +1,93 @@ +from __future__ import annotations + +import re +from typing import Iterable + +from ._loop import loop_last +from .cells import cell_len, chop_cells + +re_word = re.compile(r"\s*\S+\s*") + + +def words(text: str) -> Iterable[tuple[int, int, str]]: + """Yields each word from the text as a tuple + containing (start_index, end_index, word). A "word" in this context may + include the actual word and any whitespace to the right. + """ + position = 0 + word_match = re_word.match(text, position) + while word_match is not None: + start, end = word_match.span() + word = word_match.group(0) + yield start, end, word + word_match = re_word.match(text, end) + + +def divide_line(text: str, width: int, fold: bool = True) -> list[int]: + """Given a string of text, and a width (measured in cells), return a list + of cell offsets which the string should be split at in order for it to fit + within the given width. + + Args: + text: The text to examine. + width: The available cell width. + fold: If True, words longer than `width` will be folded onto a new line. + + Returns: + A list of indices to break the line at. + """ + break_positions: list[int] = [] # offsets to insert the breaks at + append = break_positions.append + cell_offset = 0 + _cell_len = cell_len + + for start, _end, word in words(text): + word_length = _cell_len(word.rstrip()) + remaining_space = width - cell_offset + word_fits_remaining_space = remaining_space >= word_length + + if word_fits_remaining_space: + # Simplest case - the word fits within the remaining width for this line. + cell_offset += _cell_len(word) + else: + # Not enough space remaining for this word on the current line. + if word_length > width: + # The word doesn't fit on any line, so we can't simply + # place it on the next line... + if fold: + # Fold the word across multiple lines. + folded_word = chop_cells(word, width=width) + for last, line in loop_last(folded_word): + if start: + append(start) + if last: + cell_offset = _cell_len(line) + else: + start += len(line) + else: + # Folding isn't allowed, so crop the word. + if start: + append(start) + cell_offset = _cell_len(word) + elif cell_offset and start: + # The word doesn't fit within the remaining space on the current + # line, but it *can* fit on to the next (empty) line. + append(start) + cell_offset = _cell_len(word) + + return break_positions + + +if __name__ == "__main__": # pragma: no cover + from .console import Console + + console = Console(width=10) + console.print("12345 abcdefghijklmnopqrstuvwyxzABCDEFGHIJKLMNOPQRSTUVWXYZ 12345") + print(chop_cells("abcdefghijklmnopqrstuvwxyz", 10)) + + console = Console(width=20) + console.rule() + console.print("TextualはPythonの高速アプリケーション開発フレームワークです") + + console.rule() + console.print("アプリケーションは1670万色を使用でき") diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/abc.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/abc.py new file mode 100644 index 0000000..e6e498e --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/abc.py @@ -0,0 +1,33 @@ +from abc import ABC + + +class RichRenderable(ABC): + """An abstract base class for Rich renderables. + + Note that there is no need to extend this class, the intended use is to check if an + object supports the Rich renderable protocol. For example:: + + if isinstance(my_object, RichRenderable): + console.print(my_object) + + """ + + @classmethod + def __subclasshook__(cls, other: type) -> bool: + """Check if this class supports the rich render protocol.""" + return hasattr(other, "__rich_console__") or hasattr(other, "__rich__") + + +if __name__ == "__main__": # pragma: no cover + from pip._vendor.rich.text import Text + + t = Text() + print(isinstance(Text, RichRenderable)) + print(isinstance(t, RichRenderable)) + + class Foo: + pass + + f = Foo() + print(isinstance(f, RichRenderable)) + print(isinstance("", RichRenderable)) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/align.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/align.py new file mode 100644 index 0000000..f7b734f --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/align.py @@ -0,0 +1,311 @@ +import sys +from itertools import chain +from typing import TYPE_CHECKING, Iterable, Optional + +if sys.version_info >= (3, 8): + from typing import Literal +else: + from pip._vendor.typing_extensions import Literal # pragma: no cover + +from .constrain import Constrain +from .jupyter import JupyterMixin +from .measure import Measurement +from .segment import Segment +from .style import StyleType + +if TYPE_CHECKING: + from .console import Console, ConsoleOptions, RenderableType, RenderResult + +AlignMethod = Literal["left", "center", "right"] +VerticalAlignMethod = Literal["top", "middle", "bottom"] + + +class Align(JupyterMixin): + """Align a renderable by adding spaces if necessary. + + Args: + renderable (RenderableType): A console renderable. + align (AlignMethod): One of "left", "center", or "right"" + style (StyleType, optional): An optional style to apply to the background. + vertical (Optional[VerticalAlignMethod], optional): Optional vertical align, one of "top", "middle", or "bottom". Defaults to None. + pad (bool, optional): Pad the right with spaces. Defaults to True. + width (int, optional): Restrict contents to given width, or None to use default width. Defaults to None. + height (int, optional): Set height of align renderable, or None to fit to contents. Defaults to None. + + Raises: + ValueError: if ``align`` is not one of the expected values. + """ + + def __init__( + self, + renderable: "RenderableType", + align: AlignMethod = "left", + style: Optional[StyleType] = None, + *, + vertical: Optional[VerticalAlignMethod] = None, + pad: bool = True, + width: Optional[int] = None, + height: Optional[int] = None, + ) -> None: + if align not in ("left", "center", "right"): + raise ValueError( + f'invalid value for align, expected "left", "center", or "right" (not {align!r})' + ) + if vertical is not None and vertical not in ("top", "middle", "bottom"): + raise ValueError( + f'invalid value for vertical, expected "top", "middle", or "bottom" (not {vertical!r})' + ) + self.renderable = renderable + self.align = align + self.style = style + self.vertical = vertical + self.pad = pad + self.width = width + self.height = height + + def __repr__(self) -> str: + return f"Align({self.renderable!r}, {self.align!r})" + + @classmethod + def left( + cls, + renderable: "RenderableType", + style: Optional[StyleType] = None, + *, + vertical: Optional[VerticalAlignMethod] = None, + pad: bool = True, + width: Optional[int] = None, + height: Optional[int] = None, + ) -> "Align": + """Align a renderable to the left.""" + return cls( + renderable, + "left", + style=style, + vertical=vertical, + pad=pad, + width=width, + height=height, + ) + + @classmethod + def center( + cls, + renderable: "RenderableType", + style: Optional[StyleType] = None, + *, + vertical: Optional[VerticalAlignMethod] = None, + pad: bool = True, + width: Optional[int] = None, + height: Optional[int] = None, + ) -> "Align": + """Align a renderable to the center.""" + return cls( + renderable, + "center", + style=style, + vertical=vertical, + pad=pad, + width=width, + height=height, + ) + + @classmethod + def right( + cls, + renderable: "RenderableType", + style: Optional[StyleType] = None, + *, + vertical: Optional[VerticalAlignMethod] = None, + pad: bool = True, + width: Optional[int] = None, + height: Optional[int] = None, + ) -> "Align": + """Align a renderable to the right.""" + return cls( + renderable, + "right", + style=style, + vertical=vertical, + pad=pad, + width=width, + height=height, + ) + + def __rich_console__( + self, console: "Console", options: "ConsoleOptions" + ) -> "RenderResult": + align = self.align + width = console.measure(self.renderable, options=options).maximum + rendered = console.render( + Constrain( + self.renderable, width if self.width is None else min(width, self.width) + ), + options.update(height=None), + ) + lines = list(Segment.split_lines(rendered)) + width, height = Segment.get_shape(lines) + lines = Segment.set_shape(lines, width, height) + new_line = Segment.line() + excess_space = options.max_width - width + style = console.get_style(self.style) if self.style is not None else None + + def generate_segments() -> Iterable[Segment]: + if excess_space <= 0: + # Exact fit + for line in lines: + yield from line + yield new_line + + elif align == "left": + # Pad on the right + pad = Segment(" " * excess_space, style) if self.pad else None + for line in lines: + yield from line + if pad: + yield pad + yield new_line + + elif align == "center": + # Pad left and right + left = excess_space // 2 + pad = Segment(" " * left, style) + pad_right = ( + Segment(" " * (excess_space - left), style) if self.pad else None + ) + for line in lines: + if left: + yield pad + yield from line + if pad_right: + yield pad_right + yield new_line + + elif align == "right": + # Padding on left + pad = Segment(" " * excess_space, style) + for line in lines: + yield pad + yield from line + yield new_line + + blank_line = ( + Segment(f"{' ' * (self.width or options.max_width)}\n", style) + if self.pad + else Segment("\n") + ) + + def blank_lines(count: int) -> Iterable[Segment]: + if count > 0: + for _ in range(count): + yield blank_line + + vertical_height = self.height or options.height + iter_segments: Iterable[Segment] + if self.vertical and vertical_height is not None: + if self.vertical == "top": + bottom_space = vertical_height - height + iter_segments = chain(generate_segments(), blank_lines(bottom_space)) + elif self.vertical == "middle": + top_space = (vertical_height - height) // 2 + bottom_space = vertical_height - top_space - height + iter_segments = chain( + blank_lines(top_space), + generate_segments(), + blank_lines(bottom_space), + ) + else: # self.vertical == "bottom": + top_space = vertical_height - height + iter_segments = chain(blank_lines(top_space), generate_segments()) + else: + iter_segments = generate_segments() + if self.style: + style = console.get_style(self.style) + iter_segments = Segment.apply_style(iter_segments, style) + yield from iter_segments + + def __rich_measure__( + self, console: "Console", options: "ConsoleOptions" + ) -> Measurement: + measurement = Measurement.get(console, options, self.renderable) + return measurement + + +class VerticalCenter(JupyterMixin): + """Vertically aligns a renderable. + + Warn: + This class is deprecated and may be removed in a future version. Use Align class with + `vertical="middle"`. + + Args: + renderable (RenderableType): A renderable object. + """ + + def __init__( + self, + renderable: "RenderableType", + style: Optional[StyleType] = None, + ) -> None: + self.renderable = renderable + self.style = style + + def __repr__(self) -> str: + return f"VerticalCenter({self.renderable!r})" + + def __rich_console__( + self, console: "Console", options: "ConsoleOptions" + ) -> "RenderResult": + style = console.get_style(self.style) if self.style is not None else None + lines = console.render_lines( + self.renderable, options.update(height=None), pad=False + ) + width, _height = Segment.get_shape(lines) + new_line = Segment.line() + height = options.height or options.size.height + top_space = (height - len(lines)) // 2 + bottom_space = height - top_space - len(lines) + blank_line = Segment(f"{' ' * width}", style) + + def blank_lines(count: int) -> Iterable[Segment]: + for _ in range(count): + yield blank_line + yield new_line + + if top_space > 0: + yield from blank_lines(top_space) + for line in lines: + yield from line + yield new_line + if bottom_space > 0: + yield from blank_lines(bottom_space) + + def __rich_measure__( + self, console: "Console", options: "ConsoleOptions" + ) -> Measurement: + measurement = Measurement.get(console, options, self.renderable) + return measurement + + +if __name__ == "__main__": # pragma: no cover + from pip._vendor.rich.console import Console, Group + from pip._vendor.rich.highlighter import ReprHighlighter + from pip._vendor.rich.panel import Panel + + highlighter = ReprHighlighter() + console = Console() + + panel = Panel( + Group( + Align.left(highlighter("align='left'")), + Align.center(highlighter("align='center'")), + Align.right(highlighter("align='right'")), + ), + width=60, + style="on dark_blue", + title="Align", + ) + + console.print( + Align.center(panel, vertical="middle", style="on red", height=console.height) + ) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/ansi.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/ansi.py new file mode 100644 index 0000000..66365e6 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/ansi.py @@ -0,0 +1,240 @@ +import re +import sys +from contextlib import suppress +from typing import Iterable, NamedTuple, Optional + +from .color import Color +from .style import Style +from .text import Text + +re_ansi = re.compile( + r""" +(?:\x1b\](.*?)\x1b\\)| +(?:\x1b([(@-Z\\-_]|\[[0-?]*[ -/]*[@-~])) +""", + re.VERBOSE, +) + + +class _AnsiToken(NamedTuple): + """Result of ansi tokenized string.""" + + plain: str = "" + sgr: Optional[str] = "" + osc: Optional[str] = "" + + +def _ansi_tokenize(ansi_text: str) -> Iterable[_AnsiToken]: + """Tokenize a string in to plain text and ANSI codes. + + Args: + ansi_text (str): A String containing ANSI codes. + + Yields: + AnsiToken: A named tuple of (plain, sgr, osc) + """ + + position = 0 + sgr: Optional[str] + osc: Optional[str] + for match in re_ansi.finditer(ansi_text): + start, end = match.span(0) + osc, sgr = match.groups() + if start > position: + yield _AnsiToken(ansi_text[position:start]) + if sgr: + if sgr == "(": + position = end + 1 + continue + if sgr.endswith("m"): + yield _AnsiToken("", sgr[1:-1], osc) + else: + yield _AnsiToken("", sgr, osc) + position = end + if position < len(ansi_text): + yield _AnsiToken(ansi_text[position:]) + + +SGR_STYLE_MAP = { + 1: "bold", + 2: "dim", + 3: "italic", + 4: "underline", + 5: "blink", + 6: "blink2", + 7: "reverse", + 8: "conceal", + 9: "strike", + 21: "underline2", + 22: "not dim not bold", + 23: "not italic", + 24: "not underline", + 25: "not blink", + 26: "not blink2", + 27: "not reverse", + 28: "not conceal", + 29: "not strike", + 30: "color(0)", + 31: "color(1)", + 32: "color(2)", + 33: "color(3)", + 34: "color(4)", + 35: "color(5)", + 36: "color(6)", + 37: "color(7)", + 39: "default", + 40: "on color(0)", + 41: "on color(1)", + 42: "on color(2)", + 43: "on color(3)", + 44: "on color(4)", + 45: "on color(5)", + 46: "on color(6)", + 47: "on color(7)", + 49: "on default", + 51: "frame", + 52: "encircle", + 53: "overline", + 54: "not frame not encircle", + 55: "not overline", + 90: "color(8)", + 91: "color(9)", + 92: "color(10)", + 93: "color(11)", + 94: "color(12)", + 95: "color(13)", + 96: "color(14)", + 97: "color(15)", + 100: "on color(8)", + 101: "on color(9)", + 102: "on color(10)", + 103: "on color(11)", + 104: "on color(12)", + 105: "on color(13)", + 106: "on color(14)", + 107: "on color(15)", +} + + +class AnsiDecoder: + """Translate ANSI code in to styled Text.""" + + def __init__(self) -> None: + self.style = Style.null() + + def decode(self, terminal_text: str) -> Iterable[Text]: + """Decode ANSI codes in an iterable of lines. + + Args: + lines (Iterable[str]): An iterable of lines of terminal output. + + Yields: + Text: Marked up Text. + """ + for line in terminal_text.splitlines(): + yield self.decode_line(line) + + def decode_line(self, line: str) -> Text: + """Decode a line containing ansi codes. + + Args: + line (str): A line of terminal output. + + Returns: + Text: A Text instance marked up according to ansi codes. + """ + from_ansi = Color.from_ansi + from_rgb = Color.from_rgb + _Style = Style + text = Text() + append = text.append + line = line.rsplit("\r", 1)[-1] + for plain_text, sgr, osc in _ansi_tokenize(line): + if plain_text: + append(plain_text, self.style or None) + elif osc is not None: + if osc.startswith("8;"): + _params, semicolon, link = osc[2:].partition(";") + if semicolon: + self.style = self.style.update_link(link or None) + elif sgr is not None: + # Translate in to semi-colon separated codes + # Ignore invalid codes, because we want to be lenient + codes = [ + min(255, int(_code) if _code else 0) + for _code in sgr.split(";") + if _code.isdigit() or _code == "" + ] + iter_codes = iter(codes) + for code in iter_codes: + if code == 0: + # reset + self.style = _Style.null() + elif code in SGR_STYLE_MAP: + # styles + self.style += _Style.parse(SGR_STYLE_MAP[code]) + elif code == 38: + #  Foreground + with suppress(StopIteration): + color_type = next(iter_codes) + if color_type == 5: + self.style += _Style.from_color( + from_ansi(next(iter_codes)) + ) + elif color_type == 2: + self.style += _Style.from_color( + from_rgb( + next(iter_codes), + next(iter_codes), + next(iter_codes), + ) + ) + elif code == 48: + # Background + with suppress(StopIteration): + color_type = next(iter_codes) + if color_type == 5: + self.style += _Style.from_color( + None, from_ansi(next(iter_codes)) + ) + elif color_type == 2: + self.style += _Style.from_color( + None, + from_rgb( + next(iter_codes), + next(iter_codes), + next(iter_codes), + ), + ) + + return text + + +if sys.platform != "win32" and __name__ == "__main__": # pragma: no cover + import io + import os + import pty + import sys + + decoder = AnsiDecoder() + + stdout = io.BytesIO() + + def read(fd: int) -> bytes: + data = os.read(fd, 1024) + stdout.write(data) + return data + + pty.spawn(sys.argv[1:], read) + + from .console import Console + + console = Console(record=True) + + stdout_result = stdout.getvalue().decode("utf-8") + print(stdout_result) + + for line in decoder.decode(stdout_result): + console.print(line) + + console.save_html("stdout.html") diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/bar.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/bar.py new file mode 100644 index 0000000..022284b --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/bar.py @@ -0,0 +1,93 @@ +from typing import Optional, Union + +from .color import Color +from .console import Console, ConsoleOptions, RenderResult +from .jupyter import JupyterMixin +from .measure import Measurement +from .segment import Segment +from .style import Style + +# There are left-aligned characters for 1/8 to 7/8, but +# the right-aligned characters exist only for 1/8 and 4/8. +BEGIN_BLOCK_ELEMENTS = ["█", "█", "█", "▐", "▐", "▐", "▕", "▕"] +END_BLOCK_ELEMENTS = [" ", "▏", "▎", "▍", "▌", "▋", "▊", "▉"] +FULL_BLOCK = "█" + + +class Bar(JupyterMixin): + """Renders a solid block bar. + + Args: + size (float): Value for the end of the bar. + begin (float): Begin point (between 0 and size, inclusive). + end (float): End point (between 0 and size, inclusive). + width (int, optional): Width of the bar, or ``None`` for maximum width. Defaults to None. + color (Union[Color, str], optional): Color of the bar. Defaults to "default". + bgcolor (Union[Color, str], optional): Color of bar background. Defaults to "default". + """ + + def __init__( + self, + size: float, + begin: float, + end: float, + *, + width: Optional[int] = None, + color: Union[Color, str] = "default", + bgcolor: Union[Color, str] = "default", + ): + self.size = size + self.begin = max(begin, 0) + self.end = min(end, size) + self.width = width + self.style = Style(color=color, bgcolor=bgcolor) + + def __repr__(self) -> str: + return f"Bar({self.size}, {self.begin}, {self.end})" + + def __rich_console__( + self, console: Console, options: ConsoleOptions + ) -> RenderResult: + width = min( + self.width if self.width is not None else options.max_width, + options.max_width, + ) + + if self.begin >= self.end: + yield Segment(" " * width, self.style) + yield Segment.line() + return + + prefix_complete_eights = int(width * 8 * self.begin / self.size) + prefix_bar_count = prefix_complete_eights // 8 + prefix_eights_count = prefix_complete_eights % 8 + + body_complete_eights = int(width * 8 * self.end / self.size) + body_bar_count = body_complete_eights // 8 + body_eights_count = body_complete_eights % 8 + + # When start and end fall into the same cell, we ideally should render + # a symbol that's "center-aligned", but there is no good symbol in Unicode. + # In this case, we fall back to right-aligned block symbol for simplicity. + + prefix = " " * prefix_bar_count + if prefix_eights_count: + prefix += BEGIN_BLOCK_ELEMENTS[prefix_eights_count] + + body = FULL_BLOCK * body_bar_count + if body_eights_count: + body += END_BLOCK_ELEMENTS[body_eights_count] + + suffix = " " * (width - len(body)) + + yield Segment(prefix + body[len(prefix) :] + suffix, self.style) + yield Segment.line() + + def __rich_measure__( + self, console: Console, options: ConsoleOptions + ) -> Measurement: + return ( + Measurement(self.width, self.width) + if self.width is not None + else Measurement(4, options.max_width) + ) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/box.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/box.py new file mode 100644 index 0000000..0511a9e --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/box.py @@ -0,0 +1,480 @@ +import sys +from typing import TYPE_CHECKING, Iterable, List + +if sys.version_info >= (3, 8): + from typing import Literal +else: + from pip._vendor.typing_extensions import Literal # pragma: no cover + + +from ._loop import loop_last + +if TYPE_CHECKING: + from pip._vendor.rich.console import ConsoleOptions + + +class Box: + """Defines characters to render boxes. + + ┌─┬┐ top + │ ││ head + ├─┼┤ head_row + │ ││ mid + ├─┼┤ row + ├─┼┤ foot_row + │ ││ foot + └─┴┘ bottom + + Args: + box (str): Characters making up box. + ascii (bool, optional): True if this box uses ascii characters only. Default is False. + """ + + def __init__(self, box: str, *, ascii: bool = False) -> None: + self._box = box + self.ascii = ascii + line1, line2, line3, line4, line5, line6, line7, line8 = box.splitlines() + # top + self.top_left, self.top, self.top_divider, self.top_right = iter(line1) + # head + self.head_left, _, self.head_vertical, self.head_right = iter(line2) + # head_row + ( + self.head_row_left, + self.head_row_horizontal, + self.head_row_cross, + self.head_row_right, + ) = iter(line3) + + # mid + self.mid_left, _, self.mid_vertical, self.mid_right = iter(line4) + # row + self.row_left, self.row_horizontal, self.row_cross, self.row_right = iter(line5) + # foot_row + ( + self.foot_row_left, + self.foot_row_horizontal, + self.foot_row_cross, + self.foot_row_right, + ) = iter(line6) + # foot + self.foot_left, _, self.foot_vertical, self.foot_right = iter(line7) + # bottom + self.bottom_left, self.bottom, self.bottom_divider, self.bottom_right = iter( + line8 + ) + + def __repr__(self) -> str: + return "Box(...)" + + def __str__(self) -> str: + return self._box + + def substitute(self, options: "ConsoleOptions", safe: bool = True) -> "Box": + """Substitute this box for another if it won't render due to platform issues. + + Args: + options (ConsoleOptions): Console options used in rendering. + safe (bool, optional): Substitute this for another Box if there are known problems + displaying on the platform (currently only relevant on Windows). Default is True. + + Returns: + Box: A different Box or the same Box. + """ + box = self + if options.legacy_windows and safe: + box = LEGACY_WINDOWS_SUBSTITUTIONS.get(box, box) + if options.ascii_only and not box.ascii: + box = ASCII + return box + + def get_plain_headed_box(self) -> "Box": + """If this box uses special characters for the borders of the header, then + return the equivalent box that does not. + + Returns: + Box: The most similar Box that doesn't use header-specific box characters. + If the current Box already satisfies this criterion, then it's returned. + """ + return PLAIN_HEADED_SUBSTITUTIONS.get(self, self) + + def get_top(self, widths: Iterable[int]) -> str: + """Get the top of a simple box. + + Args: + widths (List[int]): Widths of columns. + + Returns: + str: A string of box characters. + """ + + parts: List[str] = [] + append = parts.append + append(self.top_left) + for last, width in loop_last(widths): + append(self.top * width) + if not last: + append(self.top_divider) + append(self.top_right) + return "".join(parts) + + def get_row( + self, + widths: Iterable[int], + level: Literal["head", "row", "foot", "mid"] = "row", + edge: bool = True, + ) -> str: + """Get the top of a simple box. + + Args: + width (List[int]): Widths of columns. + + Returns: + str: A string of box characters. + """ + if level == "head": + left = self.head_row_left + horizontal = self.head_row_horizontal + cross = self.head_row_cross + right = self.head_row_right + elif level == "row": + left = self.row_left + horizontal = self.row_horizontal + cross = self.row_cross + right = self.row_right + elif level == "mid": + left = self.mid_left + horizontal = " " + cross = self.mid_vertical + right = self.mid_right + elif level == "foot": + left = self.foot_row_left + horizontal = self.foot_row_horizontal + cross = self.foot_row_cross + right = self.foot_row_right + else: + raise ValueError("level must be 'head', 'row' or 'foot'") + + parts: List[str] = [] + append = parts.append + if edge: + append(left) + for last, width in loop_last(widths): + append(horizontal * width) + if not last: + append(cross) + if edge: + append(right) + return "".join(parts) + + def get_bottom(self, widths: Iterable[int]) -> str: + """Get the bottom of a simple box. + + Args: + widths (List[int]): Widths of columns. + + Returns: + str: A string of box characters. + """ + + parts: List[str] = [] + append = parts.append + append(self.bottom_left) + for last, width in loop_last(widths): + append(self.bottom * width) + if not last: + append(self.bottom_divider) + append(self.bottom_right) + return "".join(parts) + + +# fmt: off +ASCII: Box = Box( + "+--+\n" + "| ||\n" + "|-+|\n" + "| ||\n" + "|-+|\n" + "|-+|\n" + "| ||\n" + "+--+\n", + ascii=True, +) + +ASCII2: Box = Box( + "+-++\n" + "| ||\n" + "+-++\n" + "| ||\n" + "+-++\n" + "+-++\n" + "| ||\n" + "+-++\n", + ascii=True, +) + +ASCII_DOUBLE_HEAD: Box = Box( + "+-++\n" + "| ||\n" + "+=++\n" + "| ||\n" + "+-++\n" + "+-++\n" + "| ||\n" + "+-++\n", + ascii=True, +) + +SQUARE: Box = Box( + "┌─┬┐\n" + "│ ││\n" + "├─┼┤\n" + "│ ││\n" + "├─┼┤\n" + "├─┼┤\n" + "│ ││\n" + "└─┴┘\n" +) + +SQUARE_DOUBLE_HEAD: Box = Box( + "┌─┬┐\n" + "│ ││\n" + "╞═╪╡\n" + "│ ││\n" + "├─┼┤\n" + "├─┼┤\n" + "│ ││\n" + "└─┴┘\n" +) + +MINIMAL: Box = Box( + " ╷ \n" + " │ \n" + "╶─┼╴\n" + " │ \n" + "╶─┼╴\n" + "╶─┼╴\n" + " │ \n" + " ╵ \n" +) + + +MINIMAL_HEAVY_HEAD: Box = Box( + " ╷ \n" + " │ \n" + "╺━┿╸\n" + " │ \n" + "╶─┼╴\n" + "╶─┼╴\n" + " │ \n" + " ╵ \n" +) + +MINIMAL_DOUBLE_HEAD: Box = Box( + " ╷ \n" + " │ \n" + " ═╪ \n" + " │ \n" + " ─┼ \n" + " ─┼ \n" + " │ \n" + " ╵ \n" +) + + +SIMPLE: Box = Box( + " \n" + " \n" + " ── \n" + " \n" + " \n" + " ── \n" + " \n" + " \n" +) + +SIMPLE_HEAD: Box = Box( + " \n" + " \n" + " ── \n" + " \n" + " \n" + " \n" + " \n" + " \n" +) + + +SIMPLE_HEAVY: Box = Box( + " \n" + " \n" + " ━━ \n" + " \n" + " \n" + " ━━ \n" + " \n" + " \n" +) + + +HORIZONTALS: Box = Box( + " ── \n" + " \n" + " ── \n" + " \n" + " ── \n" + " ── \n" + " \n" + " ── \n" +) + +ROUNDED: Box = Box( + "╭─┬╮\n" + "│ ││\n" + "├─┼┤\n" + "│ ││\n" + "├─┼┤\n" + "├─┼┤\n" + "│ ││\n" + "╰─┴╯\n" +) + +HEAVY: Box = Box( + "┏━┳┓\n" + "┃ ┃┃\n" + "┣━╋┫\n" + "┃ ┃┃\n" + "┣━╋┫\n" + "┣━╋┫\n" + "┃ ┃┃\n" + "┗━┻┛\n" +) + +HEAVY_EDGE: Box = Box( + "┏━┯┓\n" + "┃ │┃\n" + "┠─┼┨\n" + "┃ │┃\n" + "┠─┼┨\n" + "┠─┼┨\n" + "┃ │┃\n" + "┗━┷┛\n" +) + +HEAVY_HEAD: Box = Box( + "┏━┳┓\n" + "┃ ┃┃\n" + "┡━╇┩\n" + "│ ││\n" + "├─┼┤\n" + "├─┼┤\n" + "│ ││\n" + "└─┴┘\n" +) + +DOUBLE: Box = Box( + "╔═╦╗\n" + "║ ║║\n" + "╠═╬╣\n" + "║ ║║\n" + "╠═╬╣\n" + "╠═╬╣\n" + "║ ║║\n" + "╚═╩╝\n" +) + +DOUBLE_EDGE: Box = Box( + "╔═╤╗\n" + "║ │║\n" + "╟─┼╢\n" + "║ │║\n" + "╟─┼╢\n" + "╟─┼╢\n" + "║ │║\n" + "╚═╧╝\n" +) + +MARKDOWN: Box = Box( + " \n" + "| ||\n" + "|-||\n" + "| ||\n" + "|-||\n" + "|-||\n" + "| ||\n" + " \n", + ascii=True, +) +# fmt: on + +# Map Boxes that don't render with raster fonts on to equivalent that do +LEGACY_WINDOWS_SUBSTITUTIONS = { + ROUNDED: SQUARE, + MINIMAL_HEAVY_HEAD: MINIMAL, + SIMPLE_HEAVY: SIMPLE, + HEAVY: SQUARE, + HEAVY_EDGE: SQUARE, + HEAVY_HEAD: SQUARE, +} + +# Map headed boxes to their headerless equivalents +PLAIN_HEADED_SUBSTITUTIONS = { + HEAVY_HEAD: SQUARE, + SQUARE_DOUBLE_HEAD: SQUARE, + MINIMAL_DOUBLE_HEAD: MINIMAL, + MINIMAL_HEAVY_HEAD: MINIMAL, + ASCII_DOUBLE_HEAD: ASCII2, +} + + +if __name__ == "__main__": # pragma: no cover + from pip._vendor.rich.columns import Columns + from pip._vendor.rich.panel import Panel + + from . import box as box + from .console import Console + from .table import Table + from .text import Text + + console = Console(record=True) + + BOXES = [ + "ASCII", + "ASCII2", + "ASCII_DOUBLE_HEAD", + "SQUARE", + "SQUARE_DOUBLE_HEAD", + "MINIMAL", + "MINIMAL_HEAVY_HEAD", + "MINIMAL_DOUBLE_HEAD", + "SIMPLE", + "SIMPLE_HEAD", + "SIMPLE_HEAVY", + "HORIZONTALS", + "ROUNDED", + "HEAVY", + "HEAVY_EDGE", + "HEAVY_HEAD", + "DOUBLE", + "DOUBLE_EDGE", + "MARKDOWN", + ] + + console.print(Panel("[bold green]Box Constants", style="green"), justify="center") + console.print() + + columns = Columns(expand=True, padding=2) + for box_name in sorted(BOXES): + table = Table( + show_footer=True, style="dim", border_style="not dim", expand=True + ) + table.add_column("Header 1", "Footer 1") + table.add_column("Header 2", "Footer 2") + table.add_row("Cell", "Cell") + table.add_row("Cell", "Cell") + table.box = getattr(box, box_name) + table.title = Text(f"box.{box_name}", style="magenta") + columns.add_renderable(table) + console.print(columns) + + # console.save_svg("box.svg") diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/cells.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/cells.py new file mode 100644 index 0000000..f85f928 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/cells.py @@ -0,0 +1,167 @@ +from __future__ import annotations + +import re +from functools import lru_cache +from typing import Callable + +from ._cell_widths import CELL_WIDTHS + +# Regex to match sequence of the most common character ranges +_is_single_cell_widths = re.compile("^[\u0020-\u006f\u00a0\u02ff\u0370-\u0482]*$").match + + +@lru_cache(4096) +def cached_cell_len(text: str) -> int: + """Get the number of cells required to display text. + + This method always caches, which may use up a lot of memory. It is recommended to use + `cell_len` over this method. + + Args: + text (str): Text to display. + + Returns: + int: Get the number of cells required to display text. + """ + _get_size = get_character_cell_size + total_size = sum(_get_size(character) for character in text) + return total_size + + +def cell_len(text: str, _cell_len: Callable[[str], int] = cached_cell_len) -> int: + """Get the number of cells required to display text. + + Args: + text (str): Text to display. + + Returns: + int: Get the number of cells required to display text. + """ + if len(text) < 512: + return _cell_len(text) + _get_size = get_character_cell_size + total_size = sum(_get_size(character) for character in text) + return total_size + + +@lru_cache(maxsize=4096) +def get_character_cell_size(character: str) -> int: + """Get the cell size of a character. + + Args: + character (str): A single character. + + Returns: + int: Number of cells (0, 1 or 2) occupied by that character. + """ + return _get_codepoint_cell_size(ord(character)) + + +@lru_cache(maxsize=4096) +def _get_codepoint_cell_size(codepoint: int) -> int: + """Get the cell size of a character. + + Args: + codepoint (int): Codepoint of a character. + + Returns: + int: Number of cells (0, 1 or 2) occupied by that character. + """ + + _table = CELL_WIDTHS + lower_bound = 0 + upper_bound = len(_table) - 1 + index = (lower_bound + upper_bound) // 2 + while True: + start, end, width = _table[index] + if codepoint < start: + upper_bound = index - 1 + elif codepoint > end: + lower_bound = index + 1 + else: + return 0 if width == -1 else width + if upper_bound < lower_bound: + break + index = (lower_bound + upper_bound) // 2 + return 1 + + +def set_cell_size(text: str, total: int) -> str: + """Set the length of a string to fit within given number of cells.""" + + if _is_single_cell_widths(text): + size = len(text) + if size < total: + return text + " " * (total - size) + return text[:total] + + if total <= 0: + return "" + cell_size = cell_len(text) + if cell_size == total: + return text + if cell_size < total: + return text + " " * (total - cell_size) + + start = 0 + end = len(text) + + # Binary search until we find the right size + while True: + pos = (start + end) // 2 + before = text[: pos + 1] + before_len = cell_len(before) + if before_len == total + 1 and cell_len(before[-1]) == 2: + return before[:-1] + " " + if before_len == total: + return before + if before_len > total: + end = pos + else: + start = pos + + +def chop_cells( + text: str, + width: int, +) -> list[str]: + """Split text into lines such that each line fits within the available (cell) width. + + Args: + text: The text to fold such that it fits in the given width. + width: The width available (number of cells). + + Returns: + A list of strings such that each string in the list has cell width + less than or equal to the available width. + """ + _get_character_cell_size = get_character_cell_size + lines: list[list[str]] = [[]] + + append_new_line = lines.append + append_to_last_line = lines[-1].append + + total_width = 0 + + for character in text: + cell_width = _get_character_cell_size(character) + char_doesnt_fit = total_width + cell_width > width + + if char_doesnt_fit: + append_new_line([character]) + append_to_last_line = lines[-1].append + total_width = cell_width + else: + append_to_last_line(character) + total_width += cell_width + + return ["".join(line) for line in lines] + + +if __name__ == "__main__": # pragma: no cover + print(get_character_cell_size("😽")) + for line in chop_cells("""这是对亚洲语言支持的测试。面对模棱两可的想法,拒绝猜测的诱惑。""", 8): + print(line) + for n in range(80, 1, -1): + print(set_cell_size("""这是对亚洲语言支持的测试。面对模棱两可的想法,拒绝猜测的诱惑。""", n) + "|") + print("x" * n) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/color.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/color.py new file mode 100644 index 0000000..4270a27 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/color.py @@ -0,0 +1,621 @@ +import platform +import re +from colorsys import rgb_to_hls +from enum import IntEnum +from functools import lru_cache +from typing import TYPE_CHECKING, NamedTuple, Optional, Tuple + +from ._palettes import EIGHT_BIT_PALETTE, STANDARD_PALETTE, WINDOWS_PALETTE +from .color_triplet import ColorTriplet +from .repr import Result, rich_repr +from .terminal_theme import DEFAULT_TERMINAL_THEME + +if TYPE_CHECKING: # pragma: no cover + from .terminal_theme import TerminalTheme + from .text import Text + + +WINDOWS = platform.system() == "Windows" + + +class ColorSystem(IntEnum): + """One of the 3 color system supported by terminals.""" + + STANDARD = 1 + EIGHT_BIT = 2 + TRUECOLOR = 3 + WINDOWS = 4 + + def __repr__(self) -> str: + return f"ColorSystem.{self.name}" + + def __str__(self) -> str: + return repr(self) + + +class ColorType(IntEnum): + """Type of color stored in Color class.""" + + DEFAULT = 0 + STANDARD = 1 + EIGHT_BIT = 2 + TRUECOLOR = 3 + WINDOWS = 4 + + def __repr__(self) -> str: + return f"ColorType.{self.name}" + + +ANSI_COLOR_NAMES = { + "black": 0, + "red": 1, + "green": 2, + "yellow": 3, + "blue": 4, + "magenta": 5, + "cyan": 6, + "white": 7, + "bright_black": 8, + "bright_red": 9, + "bright_green": 10, + "bright_yellow": 11, + "bright_blue": 12, + "bright_magenta": 13, + "bright_cyan": 14, + "bright_white": 15, + "grey0": 16, + "gray0": 16, + "navy_blue": 17, + "dark_blue": 18, + "blue3": 20, + "blue1": 21, + "dark_green": 22, + "deep_sky_blue4": 25, + "dodger_blue3": 26, + "dodger_blue2": 27, + "green4": 28, + "spring_green4": 29, + "turquoise4": 30, + "deep_sky_blue3": 32, + "dodger_blue1": 33, + "green3": 40, + "spring_green3": 41, + "dark_cyan": 36, + "light_sea_green": 37, + "deep_sky_blue2": 38, + "deep_sky_blue1": 39, + "spring_green2": 47, + "cyan3": 43, + "dark_turquoise": 44, + "turquoise2": 45, + "green1": 46, + "spring_green1": 48, + "medium_spring_green": 49, + "cyan2": 50, + "cyan1": 51, + "dark_red": 88, + "deep_pink4": 125, + "purple4": 55, + "purple3": 56, + "blue_violet": 57, + "orange4": 94, + "grey37": 59, + "gray37": 59, + "medium_purple4": 60, + "slate_blue3": 62, + "royal_blue1": 63, + "chartreuse4": 64, + "dark_sea_green4": 71, + "pale_turquoise4": 66, + "steel_blue": 67, + "steel_blue3": 68, + "cornflower_blue": 69, + "chartreuse3": 76, + "cadet_blue": 73, + "sky_blue3": 74, + "steel_blue1": 81, + "pale_green3": 114, + "sea_green3": 78, + "aquamarine3": 79, + "medium_turquoise": 80, + "chartreuse2": 112, + "sea_green2": 83, + "sea_green1": 85, + "aquamarine1": 122, + "dark_slate_gray2": 87, + "dark_magenta": 91, + "dark_violet": 128, + "purple": 129, + "light_pink4": 95, + "plum4": 96, + "medium_purple3": 98, + "slate_blue1": 99, + "yellow4": 106, + "wheat4": 101, + "grey53": 102, + "gray53": 102, + "light_slate_grey": 103, + "light_slate_gray": 103, + "medium_purple": 104, + "light_slate_blue": 105, + "dark_olive_green3": 149, + "dark_sea_green": 108, + "light_sky_blue3": 110, + "sky_blue2": 111, + "dark_sea_green3": 150, + "dark_slate_gray3": 116, + "sky_blue1": 117, + "chartreuse1": 118, + "light_green": 120, + "pale_green1": 156, + "dark_slate_gray1": 123, + "red3": 160, + "medium_violet_red": 126, + "magenta3": 164, + "dark_orange3": 166, + "indian_red": 167, + "hot_pink3": 168, + "medium_orchid3": 133, + "medium_orchid": 134, + "medium_purple2": 140, + "dark_goldenrod": 136, + "light_salmon3": 173, + "rosy_brown": 138, + "grey63": 139, + "gray63": 139, + "medium_purple1": 141, + "gold3": 178, + "dark_khaki": 143, + "navajo_white3": 144, + "grey69": 145, + "gray69": 145, + "light_steel_blue3": 146, + "light_steel_blue": 147, + "yellow3": 184, + "dark_sea_green2": 157, + "light_cyan3": 152, + "light_sky_blue1": 153, + "green_yellow": 154, + "dark_olive_green2": 155, + "dark_sea_green1": 193, + "pale_turquoise1": 159, + "deep_pink3": 162, + "magenta2": 200, + "hot_pink2": 169, + "orchid": 170, + "medium_orchid1": 207, + "orange3": 172, + "light_pink3": 174, + "pink3": 175, + "plum3": 176, + "violet": 177, + "light_goldenrod3": 179, + "tan": 180, + "misty_rose3": 181, + "thistle3": 182, + "plum2": 183, + "khaki3": 185, + "light_goldenrod2": 222, + "light_yellow3": 187, + "grey84": 188, + "gray84": 188, + "light_steel_blue1": 189, + "yellow2": 190, + "dark_olive_green1": 192, + "honeydew2": 194, + "light_cyan1": 195, + "red1": 196, + "deep_pink2": 197, + "deep_pink1": 199, + "magenta1": 201, + "orange_red1": 202, + "indian_red1": 204, + "hot_pink": 206, + "dark_orange": 208, + "salmon1": 209, + "light_coral": 210, + "pale_violet_red1": 211, + "orchid2": 212, + "orchid1": 213, + "orange1": 214, + "sandy_brown": 215, + "light_salmon1": 216, + "light_pink1": 217, + "pink1": 218, + "plum1": 219, + "gold1": 220, + "navajo_white1": 223, + "misty_rose1": 224, + "thistle1": 225, + "yellow1": 226, + "light_goldenrod1": 227, + "khaki1": 228, + "wheat1": 229, + "cornsilk1": 230, + "grey100": 231, + "gray100": 231, + "grey3": 232, + "gray3": 232, + "grey7": 233, + "gray7": 233, + "grey11": 234, + "gray11": 234, + "grey15": 235, + "gray15": 235, + "grey19": 236, + "gray19": 236, + "grey23": 237, + "gray23": 237, + "grey27": 238, + "gray27": 238, + "grey30": 239, + "gray30": 239, + "grey35": 240, + "gray35": 240, + "grey39": 241, + "gray39": 241, + "grey42": 242, + "gray42": 242, + "grey46": 243, + "gray46": 243, + "grey50": 244, + "gray50": 244, + "grey54": 245, + "gray54": 245, + "grey58": 246, + "gray58": 246, + "grey62": 247, + "gray62": 247, + "grey66": 248, + "gray66": 248, + "grey70": 249, + "gray70": 249, + "grey74": 250, + "gray74": 250, + "grey78": 251, + "gray78": 251, + "grey82": 252, + "gray82": 252, + "grey85": 253, + "gray85": 253, + "grey89": 254, + "gray89": 254, + "grey93": 255, + "gray93": 255, +} + + +class ColorParseError(Exception): + """The color could not be parsed.""" + + +RE_COLOR = re.compile( + r"""^ +\#([0-9a-f]{6})$| +color\(([0-9]{1,3})\)$| +rgb\(([\d\s,]+)\)$ +""", + re.VERBOSE, +) + + +@rich_repr +class Color(NamedTuple): + """Terminal color definition.""" + + name: str + """The name of the color (typically the input to Color.parse).""" + type: ColorType + """The type of the color.""" + number: Optional[int] = None + """The color number, if a standard color, or None.""" + triplet: Optional[ColorTriplet] = None + """A triplet of color components, if an RGB color.""" + + def __rich__(self) -> "Text": + """Displays the actual color if Rich printed.""" + from .style import Style + from .text import Text + + return Text.assemble( + f"", + ) + + def __rich_repr__(self) -> Result: + yield self.name + yield self.type + yield "number", self.number, None + yield "triplet", self.triplet, None + + @property + def system(self) -> ColorSystem: + """Get the native color system for this color.""" + if self.type == ColorType.DEFAULT: + return ColorSystem.STANDARD + return ColorSystem(int(self.type)) + + @property + def is_system_defined(self) -> bool: + """Check if the color is ultimately defined by the system.""" + return self.system not in (ColorSystem.EIGHT_BIT, ColorSystem.TRUECOLOR) + + @property + def is_default(self) -> bool: + """Check if the color is a default color.""" + return self.type == ColorType.DEFAULT + + def get_truecolor( + self, theme: Optional["TerminalTheme"] = None, foreground: bool = True + ) -> ColorTriplet: + """Get an equivalent color triplet for this color. + + Args: + theme (TerminalTheme, optional): Optional terminal theme, or None to use default. Defaults to None. + foreground (bool, optional): True for a foreground color, or False for background. Defaults to True. + + Returns: + ColorTriplet: A color triplet containing RGB components. + """ + + if theme is None: + theme = DEFAULT_TERMINAL_THEME + if self.type == ColorType.TRUECOLOR: + assert self.triplet is not None + return self.triplet + elif self.type == ColorType.EIGHT_BIT: + assert self.number is not None + return EIGHT_BIT_PALETTE[self.number] + elif self.type == ColorType.STANDARD: + assert self.number is not None + return theme.ansi_colors[self.number] + elif self.type == ColorType.WINDOWS: + assert self.number is not None + return WINDOWS_PALETTE[self.number] + else: # self.type == ColorType.DEFAULT: + assert self.number is None + return theme.foreground_color if foreground else theme.background_color + + @classmethod + def from_ansi(cls, number: int) -> "Color": + """Create a Color number from it's 8-bit ansi number. + + Args: + number (int): A number between 0-255 inclusive. + + Returns: + Color: A new Color instance. + """ + return cls( + name=f"color({number})", + type=(ColorType.STANDARD if number < 16 else ColorType.EIGHT_BIT), + number=number, + ) + + @classmethod + def from_triplet(cls, triplet: "ColorTriplet") -> "Color": + """Create a truecolor RGB color from a triplet of values. + + Args: + triplet (ColorTriplet): A color triplet containing red, green and blue components. + + Returns: + Color: A new color object. + """ + return cls(name=triplet.hex, type=ColorType.TRUECOLOR, triplet=triplet) + + @classmethod + def from_rgb(cls, red: float, green: float, blue: float) -> "Color": + """Create a truecolor from three color components in the range(0->255). + + Args: + red (float): Red component in range 0-255. + green (float): Green component in range 0-255. + blue (float): Blue component in range 0-255. + + Returns: + Color: A new color object. + """ + return cls.from_triplet(ColorTriplet(int(red), int(green), int(blue))) + + @classmethod + def default(cls) -> "Color": + """Get a Color instance representing the default color. + + Returns: + Color: Default color. + """ + return cls(name="default", type=ColorType.DEFAULT) + + @classmethod + @lru_cache(maxsize=1024) + def parse(cls, color: str) -> "Color": + """Parse a color definition.""" + original_color = color + color = color.lower().strip() + + if color == "default": + return cls(color, type=ColorType.DEFAULT) + + color_number = ANSI_COLOR_NAMES.get(color) + if color_number is not None: + return cls( + color, + type=(ColorType.STANDARD if color_number < 16 else ColorType.EIGHT_BIT), + number=color_number, + ) + + color_match = RE_COLOR.match(color) + if color_match is None: + raise ColorParseError(f"{original_color!r} is not a valid color") + + color_24, color_8, color_rgb = color_match.groups() + if color_24: + triplet = ColorTriplet( + int(color_24[0:2], 16), int(color_24[2:4], 16), int(color_24[4:6], 16) + ) + return cls(color, ColorType.TRUECOLOR, triplet=triplet) + + elif color_8: + number = int(color_8) + if number > 255: + raise ColorParseError(f"color number must be <= 255 in {color!r}") + return cls( + color, + type=(ColorType.STANDARD if number < 16 else ColorType.EIGHT_BIT), + number=number, + ) + + else: # color_rgb: + components = color_rgb.split(",") + if len(components) != 3: + raise ColorParseError( + f"expected three components in {original_color!r}" + ) + red, green, blue = components + triplet = ColorTriplet(int(red), int(green), int(blue)) + if not all(component <= 255 for component in triplet): + raise ColorParseError( + f"color components must be <= 255 in {original_color!r}" + ) + return cls(color, ColorType.TRUECOLOR, triplet=triplet) + + @lru_cache(maxsize=1024) + def get_ansi_codes(self, foreground: bool = True) -> Tuple[str, ...]: + """Get the ANSI escape codes for this color.""" + _type = self.type + if _type == ColorType.DEFAULT: + return ("39" if foreground else "49",) + + elif _type == ColorType.WINDOWS: + number = self.number + assert number is not None + fore, back = (30, 40) if number < 8 else (82, 92) + return (str(fore + number if foreground else back + number),) + + elif _type == ColorType.STANDARD: + number = self.number + assert number is not None + fore, back = (30, 40) if number < 8 else (82, 92) + return (str(fore + number if foreground else back + number),) + + elif _type == ColorType.EIGHT_BIT: + assert self.number is not None + return ("38" if foreground else "48", "5", str(self.number)) + + else: # self.standard == ColorStandard.TRUECOLOR: + assert self.triplet is not None + red, green, blue = self.triplet + return ("38" if foreground else "48", "2", str(red), str(green), str(blue)) + + @lru_cache(maxsize=1024) + def downgrade(self, system: ColorSystem) -> "Color": + """Downgrade a color system to a system with fewer colors.""" + + if self.type in (ColorType.DEFAULT, system): + return self + # Convert to 8-bit color from truecolor color + if system == ColorSystem.EIGHT_BIT and self.system == ColorSystem.TRUECOLOR: + assert self.triplet is not None + _h, l, s = rgb_to_hls(*self.triplet.normalized) + # If saturation is under 15% assume it is grayscale + if s < 0.15: + gray = round(l * 25.0) + if gray == 0: + color_number = 16 + elif gray == 25: + color_number = 231 + else: + color_number = 231 + gray + return Color(self.name, ColorType.EIGHT_BIT, number=color_number) + + red, green, blue = self.triplet + six_red = red / 95 if red < 95 else 1 + (red - 95) / 40 + six_green = green / 95 if green < 95 else 1 + (green - 95) / 40 + six_blue = blue / 95 if blue < 95 else 1 + (blue - 95) / 40 + + color_number = ( + 16 + 36 * round(six_red) + 6 * round(six_green) + round(six_blue) + ) + return Color(self.name, ColorType.EIGHT_BIT, number=color_number) + + # Convert to standard from truecolor or 8-bit + elif system == ColorSystem.STANDARD: + if self.system == ColorSystem.TRUECOLOR: + assert self.triplet is not None + triplet = self.triplet + else: # self.system == ColorSystem.EIGHT_BIT + assert self.number is not None + triplet = ColorTriplet(*EIGHT_BIT_PALETTE[self.number]) + + color_number = STANDARD_PALETTE.match(triplet) + return Color(self.name, ColorType.STANDARD, number=color_number) + + elif system == ColorSystem.WINDOWS: + if self.system == ColorSystem.TRUECOLOR: + assert self.triplet is not None + triplet = self.triplet + else: # self.system == ColorSystem.EIGHT_BIT + assert self.number is not None + if self.number < 16: + return Color(self.name, ColorType.WINDOWS, number=self.number) + triplet = ColorTriplet(*EIGHT_BIT_PALETTE[self.number]) + + color_number = WINDOWS_PALETTE.match(triplet) + return Color(self.name, ColorType.WINDOWS, number=color_number) + + return self + + +def parse_rgb_hex(hex_color: str) -> ColorTriplet: + """Parse six hex characters in to RGB triplet.""" + assert len(hex_color) == 6, "must be 6 characters" + color = ColorTriplet( + int(hex_color[0:2], 16), int(hex_color[2:4], 16), int(hex_color[4:6], 16) + ) + return color + + +def blend_rgb( + color1: ColorTriplet, color2: ColorTriplet, cross_fade: float = 0.5 +) -> ColorTriplet: + """Blend one RGB color in to another.""" + r1, g1, b1 = color1 + r2, g2, b2 = color2 + new_color = ColorTriplet( + int(r1 + (r2 - r1) * cross_fade), + int(g1 + (g2 - g1) * cross_fade), + int(b1 + (b2 - b1) * cross_fade), + ) + return new_color + + +if __name__ == "__main__": # pragma: no cover + from .console import Console + from .table import Table + from .text import Text + + console = Console() + + table = Table(show_footer=False, show_edge=True) + table.add_column("Color", width=10, overflow="ellipsis") + table.add_column("Number", justify="right", style="yellow") + table.add_column("Name", style="green") + table.add_column("Hex", style="blue") + table.add_column("RGB", style="magenta") + + colors = sorted((v, k) for k, v in ANSI_COLOR_NAMES.items()) + for color_number, name in colors: + if "grey" in name: + continue + color_cell = Text(" " * 10, style=f"on {name}") + if color_number < 16: + table.add_row(color_cell, f"{color_number}", Text(f'"{name}"')) + else: + color = EIGHT_BIT_PALETTE[color_number] # type: ignore[has-type] + table.add_row( + color_cell, str(color_number), Text(f'"{name}"'), color.hex, color.rgb + ) + + console.print(table) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/color_triplet.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/color_triplet.py new file mode 100644 index 0000000..02cab32 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/color_triplet.py @@ -0,0 +1,38 @@ +from typing import NamedTuple, Tuple + + +class ColorTriplet(NamedTuple): + """The red, green, and blue components of a color.""" + + red: int + """Red component in 0 to 255 range.""" + green: int + """Green component in 0 to 255 range.""" + blue: int + """Blue component in 0 to 255 range.""" + + @property + def hex(self) -> str: + """get the color triplet in CSS style.""" + red, green, blue = self + return f"#{red:02x}{green:02x}{blue:02x}" + + @property + def rgb(self) -> str: + """The color in RGB format. + + Returns: + str: An rgb color, e.g. ``"rgb(100,23,255)"``. + """ + red, green, blue = self + return f"rgb({red},{green},{blue})" + + @property + def normalized(self) -> Tuple[float, float, float]: + """Convert components into floats between 0 and 1. + + Returns: + Tuple[float, float, float]: A tuple of three normalized colour components. + """ + red, green, blue = self + return red / 255.0, green / 255.0, blue / 255.0 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/columns.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/columns.py new file mode 100644 index 0000000..669a3a7 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/columns.py @@ -0,0 +1,187 @@ +from collections import defaultdict +from itertools import chain +from operator import itemgetter +from typing import Dict, Iterable, List, Optional, Tuple + +from .align import Align, AlignMethod +from .console import Console, ConsoleOptions, RenderableType, RenderResult +from .constrain import Constrain +from .measure import Measurement +from .padding import Padding, PaddingDimensions +from .table import Table +from .text import TextType +from .jupyter import JupyterMixin + + +class Columns(JupyterMixin): + """Display renderables in neat columns. + + Args: + renderables (Iterable[RenderableType]): Any number of Rich renderables (including str). + width (int, optional): The desired width of the columns, or None to auto detect. Defaults to None. + padding (PaddingDimensions, optional): Optional padding around cells. Defaults to (0, 1). + expand (bool, optional): Expand columns to full width. Defaults to False. + equal (bool, optional): Arrange in to equal sized columns. Defaults to False. + column_first (bool, optional): Align items from top to bottom (rather than left to right). Defaults to False. + right_to_left (bool, optional): Start column from right hand side. Defaults to False. + align (str, optional): Align value ("left", "right", or "center") or None for default. Defaults to None. + title (TextType, optional): Optional title for Columns. + """ + + def __init__( + self, + renderables: Optional[Iterable[RenderableType]] = None, + padding: PaddingDimensions = (0, 1), + *, + width: Optional[int] = None, + expand: bool = False, + equal: bool = False, + column_first: bool = False, + right_to_left: bool = False, + align: Optional[AlignMethod] = None, + title: Optional[TextType] = None, + ) -> None: + self.renderables = list(renderables or []) + self.width = width + self.padding = padding + self.expand = expand + self.equal = equal + self.column_first = column_first + self.right_to_left = right_to_left + self.align: Optional[AlignMethod] = align + self.title = title + + def add_renderable(self, renderable: RenderableType) -> None: + """Add a renderable to the columns. + + Args: + renderable (RenderableType): Any renderable object. + """ + self.renderables.append(renderable) + + def __rich_console__( + self, console: Console, options: ConsoleOptions + ) -> RenderResult: + render_str = console.render_str + renderables = [ + render_str(renderable) if isinstance(renderable, str) else renderable + for renderable in self.renderables + ] + if not renderables: + return + _top, right, _bottom, left = Padding.unpack(self.padding) + width_padding = max(left, right) + max_width = options.max_width + widths: Dict[int, int] = defaultdict(int) + column_count = len(renderables) + + get_measurement = Measurement.get + renderable_widths = [ + get_measurement(console, options, renderable).maximum + for renderable in renderables + ] + if self.equal: + renderable_widths = [max(renderable_widths)] * len(renderable_widths) + + def iter_renderables( + column_count: int, + ) -> Iterable[Tuple[int, Optional[RenderableType]]]: + item_count = len(renderables) + if self.column_first: + width_renderables = list(zip(renderable_widths, renderables)) + + column_lengths: List[int] = [item_count // column_count] * column_count + for col_no in range(item_count % column_count): + column_lengths[col_no] += 1 + + row_count = (item_count + column_count - 1) // column_count + cells = [[-1] * column_count for _ in range(row_count)] + row = col = 0 + for index in range(item_count): + cells[row][col] = index + column_lengths[col] -= 1 + if column_lengths[col]: + row += 1 + else: + col += 1 + row = 0 + for index in chain.from_iterable(cells): + if index == -1: + break + yield width_renderables[index] + else: + yield from zip(renderable_widths, renderables) + # Pad odd elements with spaces + if item_count % column_count: + for _ in range(column_count - (item_count % column_count)): + yield 0, None + + table = Table.grid(padding=self.padding, collapse_padding=True, pad_edge=False) + table.expand = self.expand + table.title = self.title + + if self.width is not None: + column_count = (max_width) // (self.width + width_padding) + for _ in range(column_count): + table.add_column(width=self.width) + else: + while column_count > 1: + widths.clear() + column_no = 0 + for renderable_width, _ in iter_renderables(column_count): + widths[column_no] = max(widths[column_no], renderable_width) + total_width = sum(widths.values()) + width_padding * ( + len(widths) - 1 + ) + if total_width > max_width: + column_count = len(widths) - 1 + break + else: + column_no = (column_no + 1) % column_count + else: + break + + get_renderable = itemgetter(1) + _renderables = [ + get_renderable(_renderable) + for _renderable in iter_renderables(column_count) + ] + if self.equal: + _renderables = [ + None + if renderable is None + else Constrain(renderable, renderable_widths[0]) + for renderable in _renderables + ] + if self.align: + align = self.align + _Align = Align + _renderables = [ + None if renderable is None else _Align(renderable, align) + for renderable in _renderables + ] + + right_to_left = self.right_to_left + add_row = table.add_row + for start in range(0, len(_renderables), column_count): + row = _renderables[start : start + column_count] + if right_to_left: + row = row[::-1] + add_row(*row) + yield table + + +if __name__ == "__main__": # pragma: no cover + import os + + console = Console() + + files = [f"{i} {s}" for i, s in enumerate(sorted(os.listdir()))] + columns = Columns(files, padding=(0, 1), expand=False, equal=False) + console.print(columns) + console.rule() + columns.column_first = True + console.print(columns) + columns.right_to_left = True + console.rule() + console.print(columns) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/console.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/console.py new file mode 100644 index 0000000..a11c7c1 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/console.py @@ -0,0 +1,2633 @@ +import inspect +import os +import platform +import sys +import threading +import zlib +from abc import ABC, abstractmethod +from dataclasses import dataclass, field +from datetime import datetime +from functools import wraps +from getpass import getpass +from html import escape +from inspect import isclass +from itertools import islice +from math import ceil +from time import monotonic +from types import FrameType, ModuleType, TracebackType +from typing import ( + IO, + TYPE_CHECKING, + Any, + Callable, + Dict, + Iterable, + List, + Mapping, + NamedTuple, + Optional, + TextIO, + Tuple, + Type, + Union, + cast, +) + +from pip._vendor.rich._null_file import NULL_FILE + +if sys.version_info >= (3, 8): + from typing import Literal, Protocol, runtime_checkable +else: + from pip._vendor.typing_extensions import ( + Literal, + Protocol, + runtime_checkable, + ) # pragma: no cover + +from . import errors, themes +from ._emoji_replace import _emoji_replace +from ._export_format import CONSOLE_HTML_FORMAT, CONSOLE_SVG_FORMAT +from ._fileno import get_fileno +from ._log_render import FormatTimeCallable, LogRender +from .align import Align, AlignMethod +from .color import ColorSystem, blend_rgb +from .control import Control +from .emoji import EmojiVariant +from .highlighter import NullHighlighter, ReprHighlighter +from .markup import render as render_markup +from .measure import Measurement, measure_renderables +from .pager import Pager, SystemPager +from .pretty import Pretty, is_expandable +from .protocol import rich_cast +from .region import Region +from .scope import render_scope +from .screen import Screen +from .segment import Segment +from .style import Style, StyleType +from .styled import Styled +from .terminal_theme import DEFAULT_TERMINAL_THEME, SVG_EXPORT_THEME, TerminalTheme +from .text import Text, TextType +from .theme import Theme, ThemeStack + +if TYPE_CHECKING: + from ._windows import WindowsConsoleFeatures + from .live import Live + from .status import Status + +JUPYTER_DEFAULT_COLUMNS = 115 +JUPYTER_DEFAULT_LINES = 100 +WINDOWS = platform.system() == "Windows" + +HighlighterType = Callable[[Union[str, "Text"]], "Text"] +JustifyMethod = Literal["default", "left", "center", "right", "full"] +OverflowMethod = Literal["fold", "crop", "ellipsis", "ignore"] + + +class NoChange: + pass + + +NO_CHANGE = NoChange() + +try: + _STDIN_FILENO = sys.__stdin__.fileno() +except Exception: + _STDIN_FILENO = 0 +try: + _STDOUT_FILENO = sys.__stdout__.fileno() +except Exception: + _STDOUT_FILENO = 1 +try: + _STDERR_FILENO = sys.__stderr__.fileno() +except Exception: + _STDERR_FILENO = 2 + +_STD_STREAMS = (_STDIN_FILENO, _STDOUT_FILENO, _STDERR_FILENO) +_STD_STREAMS_OUTPUT = (_STDOUT_FILENO, _STDERR_FILENO) + + +_TERM_COLORS = { + "kitty": ColorSystem.EIGHT_BIT, + "256color": ColorSystem.EIGHT_BIT, + "16color": ColorSystem.STANDARD, +} + + +class ConsoleDimensions(NamedTuple): + """Size of the terminal.""" + + width: int + """The width of the console in 'cells'.""" + height: int + """The height of the console in lines.""" + + +@dataclass +class ConsoleOptions: + """Options for __rich_console__ method.""" + + size: ConsoleDimensions + """Size of console.""" + legacy_windows: bool + """legacy_windows: flag for legacy windows.""" + min_width: int + """Minimum width of renderable.""" + max_width: int + """Maximum width of renderable.""" + is_terminal: bool + """True if the target is a terminal, otherwise False.""" + encoding: str + """Encoding of terminal.""" + max_height: int + """Height of container (starts as terminal)""" + justify: Optional[JustifyMethod] = None + """Justify value override for renderable.""" + overflow: Optional[OverflowMethod] = None + """Overflow value override for renderable.""" + no_wrap: Optional[bool] = False + """Disable wrapping for text.""" + highlight: Optional[bool] = None + """Highlight override for render_str.""" + markup: Optional[bool] = None + """Enable markup when rendering strings.""" + height: Optional[int] = None + + @property + def ascii_only(self) -> bool: + """Check if renderables should use ascii only.""" + return not self.encoding.startswith("utf") + + def copy(self) -> "ConsoleOptions": + """Return a copy of the options. + + Returns: + ConsoleOptions: a copy of self. + """ + options: ConsoleOptions = ConsoleOptions.__new__(ConsoleOptions) + options.__dict__ = self.__dict__.copy() + return options + + def update( + self, + *, + width: Union[int, NoChange] = NO_CHANGE, + min_width: Union[int, NoChange] = NO_CHANGE, + max_width: Union[int, NoChange] = NO_CHANGE, + justify: Union[Optional[JustifyMethod], NoChange] = NO_CHANGE, + overflow: Union[Optional[OverflowMethod], NoChange] = NO_CHANGE, + no_wrap: Union[Optional[bool], NoChange] = NO_CHANGE, + highlight: Union[Optional[bool], NoChange] = NO_CHANGE, + markup: Union[Optional[bool], NoChange] = NO_CHANGE, + height: Union[Optional[int], NoChange] = NO_CHANGE, + ) -> "ConsoleOptions": + """Update values, return a copy.""" + options = self.copy() + if not isinstance(width, NoChange): + options.min_width = options.max_width = max(0, width) + if not isinstance(min_width, NoChange): + options.min_width = min_width + if not isinstance(max_width, NoChange): + options.max_width = max_width + if not isinstance(justify, NoChange): + options.justify = justify + if not isinstance(overflow, NoChange): + options.overflow = overflow + if not isinstance(no_wrap, NoChange): + options.no_wrap = no_wrap + if not isinstance(highlight, NoChange): + options.highlight = highlight + if not isinstance(markup, NoChange): + options.markup = markup + if not isinstance(height, NoChange): + if height is not None: + options.max_height = height + options.height = None if height is None else max(0, height) + return options + + def update_width(self, width: int) -> "ConsoleOptions": + """Update just the width, return a copy. + + Args: + width (int): New width (sets both min_width and max_width) + + Returns: + ~ConsoleOptions: New console options instance. + """ + options = self.copy() + options.min_width = options.max_width = max(0, width) + return options + + def update_height(self, height: int) -> "ConsoleOptions": + """Update the height, and return a copy. + + Args: + height (int): New height + + Returns: + ~ConsoleOptions: New Console options instance. + """ + options = self.copy() + options.max_height = options.height = height + return options + + def reset_height(self) -> "ConsoleOptions": + """Return a copy of the options with height set to ``None``. + + Returns: + ~ConsoleOptions: New console options instance. + """ + options = self.copy() + options.height = None + return options + + def update_dimensions(self, width: int, height: int) -> "ConsoleOptions": + """Update the width and height, and return a copy. + + Args: + width (int): New width (sets both min_width and max_width). + height (int): New height. + + Returns: + ~ConsoleOptions: New console options instance. + """ + options = self.copy() + options.min_width = options.max_width = max(0, width) + options.height = options.max_height = height + return options + + +@runtime_checkable +class RichCast(Protocol): + """An object that may be 'cast' to a console renderable.""" + + def __rich__( + self, + ) -> Union["ConsoleRenderable", "RichCast", str]: # pragma: no cover + ... + + +@runtime_checkable +class ConsoleRenderable(Protocol): + """An object that supports the console protocol.""" + + def __rich_console__( + self, console: "Console", options: "ConsoleOptions" + ) -> "RenderResult": # pragma: no cover + ... + + +# A type that may be rendered by Console. +RenderableType = Union[ConsoleRenderable, RichCast, str] +"""A string or any object that may be rendered by Rich.""" + +# The result of calling a __rich_console__ method. +RenderResult = Iterable[Union[RenderableType, Segment]] + +_null_highlighter = NullHighlighter() + + +class CaptureError(Exception): + """An error in the Capture context manager.""" + + +class NewLine: + """A renderable to generate new line(s)""" + + def __init__(self, count: int = 1) -> None: + self.count = count + + def __rich_console__( + self, console: "Console", options: "ConsoleOptions" + ) -> Iterable[Segment]: + yield Segment("\n" * self.count) + + +class ScreenUpdate: + """Render a list of lines at a given offset.""" + + def __init__(self, lines: List[List[Segment]], x: int, y: int) -> None: + self._lines = lines + self.x = x + self.y = y + + def __rich_console__( + self, console: "Console", options: ConsoleOptions + ) -> RenderResult: + x = self.x + move_to = Control.move_to + for offset, line in enumerate(self._lines, self.y): + yield move_to(x, offset) + yield from line + + +class Capture: + """Context manager to capture the result of printing to the console. + See :meth:`~rich.console.Console.capture` for how to use. + + Args: + console (Console): A console instance to capture output. + """ + + def __init__(self, console: "Console") -> None: + self._console = console + self._result: Optional[str] = None + + def __enter__(self) -> "Capture": + self._console.begin_capture() + return self + + def __exit__( + self, + exc_type: Optional[Type[BaseException]], + exc_val: Optional[BaseException], + exc_tb: Optional[TracebackType], + ) -> None: + self._result = self._console.end_capture() + + def get(self) -> str: + """Get the result of the capture.""" + if self._result is None: + raise CaptureError( + "Capture result is not available until context manager exits." + ) + return self._result + + +class ThemeContext: + """A context manager to use a temporary theme. See :meth:`~rich.console.Console.use_theme` for usage.""" + + def __init__(self, console: "Console", theme: Theme, inherit: bool = True) -> None: + self.console = console + self.theme = theme + self.inherit = inherit + + def __enter__(self) -> "ThemeContext": + self.console.push_theme(self.theme) + return self + + def __exit__( + self, + exc_type: Optional[Type[BaseException]], + exc_val: Optional[BaseException], + exc_tb: Optional[TracebackType], + ) -> None: + self.console.pop_theme() + + +class PagerContext: + """A context manager that 'pages' content. See :meth:`~rich.console.Console.pager` for usage.""" + + def __init__( + self, + console: "Console", + pager: Optional[Pager] = None, + styles: bool = False, + links: bool = False, + ) -> None: + self._console = console + self.pager = SystemPager() if pager is None else pager + self.styles = styles + self.links = links + + def __enter__(self) -> "PagerContext": + self._console._enter_buffer() + return self + + def __exit__( + self, + exc_type: Optional[Type[BaseException]], + exc_val: Optional[BaseException], + exc_tb: Optional[TracebackType], + ) -> None: + if exc_type is None: + with self._console._lock: + buffer: List[Segment] = self._console._buffer[:] + del self._console._buffer[:] + segments: Iterable[Segment] = buffer + if not self.styles: + segments = Segment.strip_styles(segments) + elif not self.links: + segments = Segment.strip_links(segments) + content = self._console._render_buffer(segments) + self.pager.show(content) + self._console._exit_buffer() + + +class ScreenContext: + """A context manager that enables an alternative screen. See :meth:`~rich.console.Console.screen` for usage.""" + + def __init__( + self, console: "Console", hide_cursor: bool, style: StyleType = "" + ) -> None: + self.console = console + self.hide_cursor = hide_cursor + self.screen = Screen(style=style) + self._changed = False + + def update( + self, *renderables: RenderableType, style: Optional[StyleType] = None + ) -> None: + """Update the screen. + + Args: + renderable (RenderableType, optional): Optional renderable to replace current renderable, + or None for no change. Defaults to None. + style: (Style, optional): Replacement style, or None for no change. Defaults to None. + """ + if renderables: + self.screen.renderable = ( + Group(*renderables) if len(renderables) > 1 else renderables[0] + ) + if style is not None: + self.screen.style = style + self.console.print(self.screen, end="") + + def __enter__(self) -> "ScreenContext": + self._changed = self.console.set_alt_screen(True) + if self._changed and self.hide_cursor: + self.console.show_cursor(False) + return self + + def __exit__( + self, + exc_type: Optional[Type[BaseException]], + exc_val: Optional[BaseException], + exc_tb: Optional[TracebackType], + ) -> None: + if self._changed: + self.console.set_alt_screen(False) + if self.hide_cursor: + self.console.show_cursor(True) + + +class Group: + """Takes a group of renderables and returns a renderable object that renders the group. + + Args: + renderables (Iterable[RenderableType]): An iterable of renderable objects. + fit (bool, optional): Fit dimension of group to contents, or fill available space. Defaults to True. + """ + + def __init__(self, *renderables: "RenderableType", fit: bool = True) -> None: + self._renderables = renderables + self.fit = fit + self._render: Optional[List[RenderableType]] = None + + @property + def renderables(self) -> List["RenderableType"]: + if self._render is None: + self._render = list(self._renderables) + return self._render + + def __rich_measure__( + self, console: "Console", options: "ConsoleOptions" + ) -> "Measurement": + if self.fit: + return measure_renderables(console, options, self.renderables) + else: + return Measurement(options.max_width, options.max_width) + + def __rich_console__( + self, console: "Console", options: "ConsoleOptions" + ) -> RenderResult: + yield from self.renderables + + +def group(fit: bool = True) -> Callable[..., Callable[..., Group]]: + """A decorator that turns an iterable of renderables in to a group. + + Args: + fit (bool, optional): Fit dimension of group to contents, or fill available space. Defaults to True. + """ + + def decorator( + method: Callable[..., Iterable[RenderableType]] + ) -> Callable[..., Group]: + """Convert a method that returns an iterable of renderables in to a Group.""" + + @wraps(method) + def _replace(*args: Any, **kwargs: Any) -> Group: + renderables = method(*args, **kwargs) + return Group(*renderables, fit=fit) + + return _replace + + return decorator + + +def _is_jupyter() -> bool: # pragma: no cover + """Check if we're running in a Jupyter notebook.""" + try: + get_ipython # type: ignore[name-defined] + except NameError: + return False + ipython = get_ipython() # type: ignore[name-defined] + shell = ipython.__class__.__name__ + if ( + "google.colab" in str(ipython.__class__) + or os.getenv("DATABRICKS_RUNTIME_VERSION") + or shell == "ZMQInteractiveShell" + ): + return True # Jupyter notebook or qtconsole + elif shell == "TerminalInteractiveShell": + return False # Terminal running IPython + else: + return False # Other type (?) + + +COLOR_SYSTEMS = { + "standard": ColorSystem.STANDARD, + "256": ColorSystem.EIGHT_BIT, + "truecolor": ColorSystem.TRUECOLOR, + "windows": ColorSystem.WINDOWS, +} + +_COLOR_SYSTEMS_NAMES = {system: name for name, system in COLOR_SYSTEMS.items()} + + +@dataclass +class ConsoleThreadLocals(threading.local): + """Thread local values for Console context.""" + + theme_stack: ThemeStack + buffer: List[Segment] = field(default_factory=list) + buffer_index: int = 0 + + +class RenderHook(ABC): + """Provides hooks in to the render process.""" + + @abstractmethod + def process_renderables( + self, renderables: List[ConsoleRenderable] + ) -> List[ConsoleRenderable]: + """Called with a list of objects to render. + + This method can return a new list of renderables, or modify and return the same list. + + Args: + renderables (List[ConsoleRenderable]): A number of renderable objects. + + Returns: + List[ConsoleRenderable]: A replacement list of renderables. + """ + + +_windows_console_features: Optional["WindowsConsoleFeatures"] = None + + +def get_windows_console_features() -> "WindowsConsoleFeatures": # pragma: no cover + global _windows_console_features + if _windows_console_features is not None: + return _windows_console_features + from ._windows import get_windows_console_features + + _windows_console_features = get_windows_console_features() + return _windows_console_features + + +def detect_legacy_windows() -> bool: + """Detect legacy Windows.""" + return WINDOWS and not get_windows_console_features().vt + + +class Console: + """A high level console interface. + + Args: + color_system (str, optional): The color system supported by your terminal, + either ``"standard"``, ``"256"`` or ``"truecolor"``. Leave as ``"auto"`` to autodetect. + force_terminal (Optional[bool], optional): Enable/disable terminal control codes, or None to auto-detect terminal. Defaults to None. + force_jupyter (Optional[bool], optional): Enable/disable Jupyter rendering, or None to auto-detect Jupyter. Defaults to None. + force_interactive (Optional[bool], optional): Enable/disable interactive mode, or None to auto detect. Defaults to None. + soft_wrap (Optional[bool], optional): Set soft wrap default on print method. Defaults to False. + theme (Theme, optional): An optional style theme object, or ``None`` for default theme. + stderr (bool, optional): Use stderr rather than stdout if ``file`` is not specified. Defaults to False. + file (IO, optional): A file object where the console should write to. Defaults to stdout. + quiet (bool, Optional): Boolean to suppress all output. Defaults to False. + width (int, optional): The width of the terminal. Leave as default to auto-detect width. + height (int, optional): The height of the terminal. Leave as default to auto-detect height. + style (StyleType, optional): Style to apply to all output, or None for no style. Defaults to None. + no_color (Optional[bool], optional): Enabled no color mode, or None to auto detect. Defaults to None. + tab_size (int, optional): Number of spaces used to replace a tab character. Defaults to 8. + record (bool, optional): Boolean to enable recording of terminal output, + required to call :meth:`export_html`, :meth:`export_svg`, and :meth:`export_text`. Defaults to False. + markup (bool, optional): Boolean to enable :ref:`console_markup`. Defaults to True. + emoji (bool, optional): Enable emoji code. Defaults to True. + emoji_variant (str, optional): Optional emoji variant, either "text" or "emoji". Defaults to None. + highlight (bool, optional): Enable automatic highlighting. Defaults to True. + log_time (bool, optional): Boolean to enable logging of time by :meth:`log` methods. Defaults to True. + log_path (bool, optional): Boolean to enable the logging of the caller by :meth:`log`. Defaults to True. + log_time_format (Union[str, TimeFormatterCallable], optional): If ``log_time`` is enabled, either string for strftime or callable that formats the time. Defaults to "[%X] ". + highlighter (HighlighterType, optional): Default highlighter. + legacy_windows (bool, optional): Enable legacy Windows mode, or ``None`` to auto detect. Defaults to ``None``. + safe_box (bool, optional): Restrict box options that don't render on legacy Windows. + get_datetime (Callable[[], datetime], optional): Callable that gets the current time as a datetime.datetime object (used by Console.log), + or None for datetime.now. + get_time (Callable[[], time], optional): Callable that gets the current time in seconds, default uses time.monotonic. + """ + + _environ: Mapping[str, str] = os.environ + + def __init__( + self, + *, + color_system: Optional[ + Literal["auto", "standard", "256", "truecolor", "windows"] + ] = "auto", + force_terminal: Optional[bool] = None, + force_jupyter: Optional[bool] = None, + force_interactive: Optional[bool] = None, + soft_wrap: bool = False, + theme: Optional[Theme] = None, + stderr: bool = False, + file: Optional[IO[str]] = None, + quiet: bool = False, + width: Optional[int] = None, + height: Optional[int] = None, + style: Optional[StyleType] = None, + no_color: Optional[bool] = None, + tab_size: int = 8, + record: bool = False, + markup: bool = True, + emoji: bool = True, + emoji_variant: Optional[EmojiVariant] = None, + highlight: bool = True, + log_time: bool = True, + log_path: bool = True, + log_time_format: Union[str, FormatTimeCallable] = "[%X]", + highlighter: Optional["HighlighterType"] = ReprHighlighter(), + legacy_windows: Optional[bool] = None, + safe_box: bool = True, + get_datetime: Optional[Callable[[], datetime]] = None, + get_time: Optional[Callable[[], float]] = None, + _environ: Optional[Mapping[str, str]] = None, + ): + # Copy of os.environ allows us to replace it for testing + if _environ is not None: + self._environ = _environ + + self.is_jupyter = _is_jupyter() if force_jupyter is None else force_jupyter + if self.is_jupyter: + if width is None: + jupyter_columns = self._environ.get("JUPYTER_COLUMNS") + if jupyter_columns is not None and jupyter_columns.isdigit(): + width = int(jupyter_columns) + else: + width = JUPYTER_DEFAULT_COLUMNS + if height is None: + jupyter_lines = self._environ.get("JUPYTER_LINES") + if jupyter_lines is not None and jupyter_lines.isdigit(): + height = int(jupyter_lines) + else: + height = JUPYTER_DEFAULT_LINES + + self.tab_size = tab_size + self.record = record + self._markup = markup + self._emoji = emoji + self._emoji_variant: Optional[EmojiVariant] = emoji_variant + self._highlight = highlight + self.legacy_windows: bool = ( + (detect_legacy_windows() and not self.is_jupyter) + if legacy_windows is None + else legacy_windows + ) + + if width is None: + columns = self._environ.get("COLUMNS") + if columns is not None and columns.isdigit(): + width = int(columns) - self.legacy_windows + if height is None: + lines = self._environ.get("LINES") + if lines is not None and lines.isdigit(): + height = int(lines) + + self.soft_wrap = soft_wrap + self._width = width + self._height = height + + self._color_system: Optional[ColorSystem] + + self._force_terminal = None + if force_terminal is not None: + self._force_terminal = force_terminal + + self._file = file + self.quiet = quiet + self.stderr = stderr + + if color_system is None: + self._color_system = None + elif color_system == "auto": + self._color_system = self._detect_color_system() + else: + self._color_system = COLOR_SYSTEMS[color_system] + + self._lock = threading.RLock() + self._log_render = LogRender( + show_time=log_time, + show_path=log_path, + time_format=log_time_format, + ) + self.highlighter: HighlighterType = highlighter or _null_highlighter + self.safe_box = safe_box + self.get_datetime = get_datetime or datetime.now + self.get_time = get_time or monotonic + self.style = style + self.no_color = ( + no_color if no_color is not None else "NO_COLOR" in self._environ + ) + self.is_interactive = ( + (self.is_terminal and not self.is_dumb_terminal) + if force_interactive is None + else force_interactive + ) + + self._record_buffer_lock = threading.RLock() + self._thread_locals = ConsoleThreadLocals( + theme_stack=ThemeStack(themes.DEFAULT if theme is None else theme) + ) + self._record_buffer: List[Segment] = [] + self._render_hooks: List[RenderHook] = [] + self._live: Optional["Live"] = None + self._is_alt_screen = False + + def __repr__(self) -> str: + return f"" + + @property + def file(self) -> IO[str]: + """Get the file object to write to.""" + file = self._file or (sys.stderr if self.stderr else sys.stdout) + file = getattr(file, "rich_proxied_file", file) + if file is None: + file = NULL_FILE + return file + + @file.setter + def file(self, new_file: IO[str]) -> None: + """Set a new file object.""" + self._file = new_file + + @property + def _buffer(self) -> List[Segment]: + """Get a thread local buffer.""" + return self._thread_locals.buffer + + @property + def _buffer_index(self) -> int: + """Get a thread local buffer.""" + return self._thread_locals.buffer_index + + @_buffer_index.setter + def _buffer_index(self, value: int) -> None: + self._thread_locals.buffer_index = value + + @property + def _theme_stack(self) -> ThemeStack: + """Get the thread local theme stack.""" + return self._thread_locals.theme_stack + + def _detect_color_system(self) -> Optional[ColorSystem]: + """Detect color system from env vars.""" + if self.is_jupyter: + return ColorSystem.TRUECOLOR + if not self.is_terminal or self.is_dumb_terminal: + return None + if WINDOWS: # pragma: no cover + if self.legacy_windows: # pragma: no cover + return ColorSystem.WINDOWS + windows_console_features = get_windows_console_features() + return ( + ColorSystem.TRUECOLOR + if windows_console_features.truecolor + else ColorSystem.EIGHT_BIT + ) + else: + color_term = self._environ.get("COLORTERM", "").strip().lower() + if color_term in ("truecolor", "24bit"): + return ColorSystem.TRUECOLOR + term = self._environ.get("TERM", "").strip().lower() + _term_name, _hyphen, colors = term.rpartition("-") + color_system = _TERM_COLORS.get(colors, ColorSystem.STANDARD) + return color_system + + def _enter_buffer(self) -> None: + """Enter in to a buffer context, and buffer all output.""" + self._buffer_index += 1 + + def _exit_buffer(self) -> None: + """Leave buffer context, and render content if required.""" + self._buffer_index -= 1 + self._check_buffer() + + def set_live(self, live: "Live") -> None: + """Set Live instance. Used by Live context manager. + + Args: + live (Live): Live instance using this Console. + + Raises: + errors.LiveError: If this Console has a Live context currently active. + """ + with self._lock: + if self._live is not None: + raise errors.LiveError("Only one live display may be active at once") + self._live = live + + def clear_live(self) -> None: + """Clear the Live instance.""" + with self._lock: + self._live = None + + def push_render_hook(self, hook: RenderHook) -> None: + """Add a new render hook to the stack. + + Args: + hook (RenderHook): Render hook instance. + """ + with self._lock: + self._render_hooks.append(hook) + + def pop_render_hook(self) -> None: + """Pop the last renderhook from the stack.""" + with self._lock: + self._render_hooks.pop() + + def __enter__(self) -> "Console": + """Own context manager to enter buffer context.""" + self._enter_buffer() + return self + + def __exit__(self, exc_type: Any, exc_value: Any, traceback: Any) -> None: + """Exit buffer context.""" + self._exit_buffer() + + def begin_capture(self) -> None: + """Begin capturing console output. Call :meth:`end_capture` to exit capture mode and return output.""" + self._enter_buffer() + + def end_capture(self) -> str: + """End capture mode and return captured string. + + Returns: + str: Console output. + """ + render_result = self._render_buffer(self._buffer) + del self._buffer[:] + self._exit_buffer() + return render_result + + def push_theme(self, theme: Theme, *, inherit: bool = True) -> None: + """Push a new theme on to the top of the stack, replacing the styles from the previous theme. + Generally speaking, you should call :meth:`~rich.console.Console.use_theme` to get a context manager, rather + than calling this method directly. + + Args: + theme (Theme): A theme instance. + inherit (bool, optional): Inherit existing styles. Defaults to True. + """ + self._theme_stack.push_theme(theme, inherit=inherit) + + def pop_theme(self) -> None: + """Remove theme from top of stack, restoring previous theme.""" + self._theme_stack.pop_theme() + + def use_theme(self, theme: Theme, *, inherit: bool = True) -> ThemeContext: + """Use a different theme for the duration of the context manager. + + Args: + theme (Theme): Theme instance to user. + inherit (bool, optional): Inherit existing console styles. Defaults to True. + + Returns: + ThemeContext: [description] + """ + return ThemeContext(self, theme, inherit) + + @property + def color_system(self) -> Optional[str]: + """Get color system string. + + Returns: + Optional[str]: "standard", "256" or "truecolor". + """ + + if self._color_system is not None: + return _COLOR_SYSTEMS_NAMES[self._color_system] + else: + return None + + @property + def encoding(self) -> str: + """Get the encoding of the console file, e.g. ``"utf-8"``. + + Returns: + str: A standard encoding string. + """ + return (getattr(self.file, "encoding", "utf-8") or "utf-8").lower() + + @property + def is_terminal(self) -> bool: + """Check if the console is writing to a terminal. + + Returns: + bool: True if the console writing to a device capable of + understanding terminal codes, otherwise False. + """ + if self._force_terminal is not None: + return self._force_terminal + + if hasattr(sys.stdin, "__module__") and sys.stdin.__module__.startswith( + "idlelib" + ): + # Return False for Idle which claims to be a tty but can't handle ansi codes + return False + + if self.is_jupyter: + # return False for Jupyter, which may have FORCE_COLOR set + return False + + # If FORCE_COLOR env var has any value at all, we assume a terminal. + force_color = self._environ.get("FORCE_COLOR") + if force_color is not None: + self._force_terminal = True + return True + + isatty: Optional[Callable[[], bool]] = getattr(self.file, "isatty", None) + try: + return False if isatty is None else isatty() + except ValueError: + # in some situation (at the end of a pytest run for example) isatty() can raise + # ValueError: I/O operation on closed file + # return False because we aren't in a terminal anymore + return False + + @property + def is_dumb_terminal(self) -> bool: + """Detect dumb terminal. + + Returns: + bool: True if writing to a dumb terminal, otherwise False. + + """ + _term = self._environ.get("TERM", "") + is_dumb = _term.lower() in ("dumb", "unknown") + return self.is_terminal and is_dumb + + @property + def options(self) -> ConsoleOptions: + """Get default console options.""" + return ConsoleOptions( + max_height=self.size.height, + size=self.size, + legacy_windows=self.legacy_windows, + min_width=1, + max_width=self.width, + encoding=self.encoding, + is_terminal=self.is_terminal, + ) + + @property + def size(self) -> ConsoleDimensions: + """Get the size of the console. + + Returns: + ConsoleDimensions: A named tuple containing the dimensions. + """ + + if self._width is not None and self._height is not None: + return ConsoleDimensions(self._width - self.legacy_windows, self._height) + + if self.is_dumb_terminal: + return ConsoleDimensions(80, 25) + + width: Optional[int] = None + height: Optional[int] = None + + if WINDOWS: # pragma: no cover + try: + width, height = os.get_terminal_size() + except (AttributeError, ValueError, OSError): # Probably not a terminal + pass + else: + for file_descriptor in _STD_STREAMS: + try: + width, height = os.get_terminal_size(file_descriptor) + except (AttributeError, ValueError, OSError): + pass + else: + break + + columns = self._environ.get("COLUMNS") + if columns is not None and columns.isdigit(): + width = int(columns) + lines = self._environ.get("LINES") + if lines is not None and lines.isdigit(): + height = int(lines) + + # get_terminal_size can report 0, 0 if run from pseudo-terminal + width = width or 80 + height = height or 25 + return ConsoleDimensions( + width - self.legacy_windows if self._width is None else self._width, + height if self._height is None else self._height, + ) + + @size.setter + def size(self, new_size: Tuple[int, int]) -> None: + """Set a new size for the terminal. + + Args: + new_size (Tuple[int, int]): New width and height. + """ + width, height = new_size + self._width = width + self._height = height + + @property + def width(self) -> int: + """Get the width of the console. + + Returns: + int: The width (in characters) of the console. + """ + return self.size.width + + @width.setter + def width(self, width: int) -> None: + """Set width. + + Args: + width (int): New width. + """ + self._width = width + + @property + def height(self) -> int: + """Get the height of the console. + + Returns: + int: The height (in lines) of the console. + """ + return self.size.height + + @height.setter + def height(self, height: int) -> None: + """Set height. + + Args: + height (int): new height. + """ + self._height = height + + def bell(self) -> None: + """Play a 'bell' sound (if supported by the terminal).""" + self.control(Control.bell()) + + def capture(self) -> Capture: + """A context manager to *capture* the result of print() or log() in a string, + rather than writing it to the console. + + Example: + >>> from rich.console import Console + >>> console = Console() + >>> with console.capture() as capture: + ... console.print("[bold magenta]Hello World[/]") + >>> print(capture.get()) + + Returns: + Capture: Context manager with disables writing to the terminal. + """ + capture = Capture(self) + return capture + + def pager( + self, pager: Optional[Pager] = None, styles: bool = False, links: bool = False + ) -> PagerContext: + """A context manager to display anything printed within a "pager". The pager application + is defined by the system and will typically support at least pressing a key to scroll. + + Args: + pager (Pager, optional): A pager object, or None to use :class:`~rich.pager.SystemPager`. Defaults to None. + styles (bool, optional): Show styles in pager. Defaults to False. + links (bool, optional): Show links in pager. Defaults to False. + + Example: + >>> from rich.console import Console + >>> from rich.__main__ import make_test_card + >>> console = Console() + >>> with console.pager(): + console.print(make_test_card()) + + Returns: + PagerContext: A context manager. + """ + return PagerContext(self, pager=pager, styles=styles, links=links) + + def line(self, count: int = 1) -> None: + """Write new line(s). + + Args: + count (int, optional): Number of new lines. Defaults to 1. + """ + + assert count >= 0, "count must be >= 0" + self.print(NewLine(count)) + + def clear(self, home: bool = True) -> None: + """Clear the screen. + + Args: + home (bool, optional): Also move the cursor to 'home' position. Defaults to True. + """ + if home: + self.control(Control.clear(), Control.home()) + else: + self.control(Control.clear()) + + def status( + self, + status: RenderableType, + *, + spinner: str = "dots", + spinner_style: StyleType = "status.spinner", + speed: float = 1.0, + refresh_per_second: float = 12.5, + ) -> "Status": + """Display a status and spinner. + + Args: + status (RenderableType): A status renderable (str or Text typically). + spinner (str, optional): Name of spinner animation (see python -m rich.spinner). Defaults to "dots". + spinner_style (StyleType, optional): Style of spinner. Defaults to "status.spinner". + speed (float, optional): Speed factor for spinner animation. Defaults to 1.0. + refresh_per_second (float, optional): Number of refreshes per second. Defaults to 12.5. + + Returns: + Status: A Status object that may be used as a context manager. + """ + from .status import Status + + status_renderable = Status( + status, + console=self, + spinner=spinner, + spinner_style=spinner_style, + speed=speed, + refresh_per_second=refresh_per_second, + ) + return status_renderable + + def show_cursor(self, show: bool = True) -> bool: + """Show or hide the cursor. + + Args: + show (bool, optional): Set visibility of the cursor. + """ + if self.is_terminal: + self.control(Control.show_cursor(show)) + return True + return False + + def set_alt_screen(self, enable: bool = True) -> bool: + """Enables alternative screen mode. + + Note, if you enable this mode, you should ensure that is disabled before + the application exits. See :meth:`~rich.Console.screen` for a context manager + that handles this for you. + + Args: + enable (bool, optional): Enable (True) or disable (False) alternate screen. Defaults to True. + + Returns: + bool: True if the control codes were written. + + """ + changed = False + if self.is_terminal and not self.legacy_windows: + self.control(Control.alt_screen(enable)) + changed = True + self._is_alt_screen = enable + return changed + + @property + def is_alt_screen(self) -> bool: + """Check if the alt screen was enabled. + + Returns: + bool: True if the alt screen was enabled, otherwise False. + """ + return self._is_alt_screen + + def set_window_title(self, title: str) -> bool: + """Set the title of the console terminal window. + + Warning: There is no means within Rich of "resetting" the window title to its + previous value, meaning the title you set will persist even after your application + exits. + + ``fish`` shell resets the window title before and after each command by default, + negating this issue. Windows Terminal and command prompt will also reset the title for you. + Most other shells and terminals, however, do not do this. + + Some terminals may require configuration changes before you can set the title. + Some terminals may not support setting the title at all. + + Other software (including the terminal itself, the shell, custom prompts, plugins, etc.) + may also set the terminal window title. This could result in whatever value you write + using this method being overwritten. + + Args: + title (str): The new title of the terminal window. + + Returns: + bool: True if the control code to change the terminal title was + written, otherwise False. Note that a return value of True + does not guarantee that the window title has actually changed, + since the feature may be unsupported/disabled in some terminals. + """ + if self.is_terminal: + self.control(Control.title(title)) + return True + return False + + def screen( + self, hide_cursor: bool = True, style: Optional[StyleType] = None + ) -> "ScreenContext": + """Context manager to enable and disable 'alternative screen' mode. + + Args: + hide_cursor (bool, optional): Also hide the cursor. Defaults to False. + style (Style, optional): Optional style for screen. Defaults to None. + + Returns: + ~ScreenContext: Context which enables alternate screen on enter, and disables it on exit. + """ + return ScreenContext(self, hide_cursor=hide_cursor, style=style or "") + + def measure( + self, renderable: RenderableType, *, options: Optional[ConsoleOptions] = None + ) -> Measurement: + """Measure a renderable. Returns a :class:`~rich.measure.Measurement` object which contains + information regarding the number of characters required to print the renderable. + + Args: + renderable (RenderableType): Any renderable or string. + options (Optional[ConsoleOptions], optional): Options to use when measuring, or None + to use default options. Defaults to None. + + Returns: + Measurement: A measurement of the renderable. + """ + measurement = Measurement.get(self, options or self.options, renderable) + return measurement + + def render( + self, renderable: RenderableType, options: Optional[ConsoleOptions] = None + ) -> Iterable[Segment]: + """Render an object in to an iterable of `Segment` instances. + + This method contains the logic for rendering objects with the console protocol. + You are unlikely to need to use it directly, unless you are extending the library. + + Args: + renderable (RenderableType): An object supporting the console protocol, or + an object that may be converted to a string. + options (ConsoleOptions, optional): An options object, or None to use self.options. Defaults to None. + + Returns: + Iterable[Segment]: An iterable of segments that may be rendered. + """ + + _options = options or self.options + if _options.max_width < 1: + # No space to render anything. This prevents potential recursion errors. + return + render_iterable: RenderResult + + renderable = rich_cast(renderable) + if hasattr(renderable, "__rich_console__") and not isclass(renderable): + render_iterable = renderable.__rich_console__(self, _options) # type: ignore[union-attr] + elif isinstance(renderable, str): + text_renderable = self.render_str( + renderable, highlight=_options.highlight, markup=_options.markup + ) + render_iterable = text_renderable.__rich_console__(self, _options) + else: + raise errors.NotRenderableError( + f"Unable to render {renderable!r}; " + "A str, Segment or object with __rich_console__ method is required" + ) + + try: + iter_render = iter(render_iterable) + except TypeError: + raise errors.NotRenderableError( + f"object {render_iterable!r} is not renderable" + ) + _Segment = Segment + _options = _options.reset_height() + for render_output in iter_render: + if isinstance(render_output, _Segment): + yield render_output + else: + yield from self.render(render_output, _options) + + def render_lines( + self, + renderable: RenderableType, + options: Optional[ConsoleOptions] = None, + *, + style: Optional[Style] = None, + pad: bool = True, + new_lines: bool = False, + ) -> List[List[Segment]]: + """Render objects in to a list of lines. + + The output of render_lines is useful when further formatting of rendered console text + is required, such as the Panel class which draws a border around any renderable object. + + Args: + renderable (RenderableType): Any object renderable in the console. + options (Optional[ConsoleOptions], optional): Console options, or None to use self.options. Default to ``None``. + style (Style, optional): Optional style to apply to renderables. Defaults to ``None``. + pad (bool, optional): Pad lines shorter than render width. Defaults to ``True``. + new_lines (bool, optional): Include "\n" characters at end of lines. + + Returns: + List[List[Segment]]: A list of lines, where a line is a list of Segment objects. + """ + with self._lock: + render_options = options or self.options + _rendered = self.render(renderable, render_options) + if style: + _rendered = Segment.apply_style(_rendered, style) + + render_height = render_options.height + if render_height is not None: + render_height = max(0, render_height) + + lines = list( + islice( + Segment.split_and_crop_lines( + _rendered, + render_options.max_width, + include_new_lines=new_lines, + pad=pad, + style=style, + ), + None, + render_height, + ) + ) + if render_options.height is not None: + extra_lines = render_options.height - len(lines) + if extra_lines > 0: + pad_line = [ + [Segment(" " * render_options.max_width, style), Segment("\n")] + if new_lines + else [Segment(" " * render_options.max_width, style)] + ] + lines.extend(pad_line * extra_lines) + + return lines + + def render_str( + self, + text: str, + *, + style: Union[str, Style] = "", + justify: Optional[JustifyMethod] = None, + overflow: Optional[OverflowMethod] = None, + emoji: Optional[bool] = None, + markup: Optional[bool] = None, + highlight: Optional[bool] = None, + highlighter: Optional[HighlighterType] = None, + ) -> "Text": + """Convert a string to a Text instance. This is called automatically if + you print or log a string. + + Args: + text (str): Text to render. + style (Union[str, Style], optional): Style to apply to rendered text. + justify (str, optional): Justify method: "default", "left", "center", "full", or "right". Defaults to ``None``. + overflow (str, optional): Overflow method: "crop", "fold", or "ellipsis". Defaults to ``None``. + emoji (Optional[bool], optional): Enable emoji, or ``None`` to use Console default. + markup (Optional[bool], optional): Enable markup, or ``None`` to use Console default. + highlight (Optional[bool], optional): Enable highlighting, or ``None`` to use Console default. + highlighter (HighlighterType, optional): Optional highlighter to apply. + Returns: + ConsoleRenderable: Renderable object. + + """ + emoji_enabled = emoji or (emoji is None and self._emoji) + markup_enabled = markup or (markup is None and self._markup) + highlight_enabled = highlight or (highlight is None and self._highlight) + + if markup_enabled: + rich_text = render_markup( + text, + style=style, + emoji=emoji_enabled, + emoji_variant=self._emoji_variant, + ) + rich_text.justify = justify + rich_text.overflow = overflow + else: + rich_text = Text( + _emoji_replace(text, default_variant=self._emoji_variant) + if emoji_enabled + else text, + justify=justify, + overflow=overflow, + style=style, + ) + + _highlighter = (highlighter or self.highlighter) if highlight_enabled else None + if _highlighter is not None: + highlight_text = _highlighter(str(rich_text)) + highlight_text.copy_styles(rich_text) + return highlight_text + + return rich_text + + def get_style( + self, name: Union[str, Style], *, default: Optional[Union[Style, str]] = None + ) -> Style: + """Get a Style instance by its theme name or parse a definition. + + Args: + name (str): The name of a style or a style definition. + + Returns: + Style: A Style object. + + Raises: + MissingStyle: If no style could be parsed from name. + + """ + if isinstance(name, Style): + return name + + try: + style = self._theme_stack.get(name) + if style is None: + style = Style.parse(name) + return style.copy() if style.link else style + except errors.StyleSyntaxError as error: + if default is not None: + return self.get_style(default) + raise errors.MissingStyle( + f"Failed to get style {name!r}; {error}" + ) from None + + def _collect_renderables( + self, + objects: Iterable[Any], + sep: str, + end: str, + *, + justify: Optional[JustifyMethod] = None, + emoji: Optional[bool] = None, + markup: Optional[bool] = None, + highlight: Optional[bool] = None, + ) -> List[ConsoleRenderable]: + """Combine a number of renderables and text into one renderable. + + Args: + objects (Iterable[Any]): Anything that Rich can render. + sep (str): String to write between print data. + end (str): String to write at end of print data. + justify (str, optional): One of "left", "right", "center", or "full". Defaults to ``None``. + emoji (Optional[bool], optional): Enable emoji code, or ``None`` to use console default. + markup (Optional[bool], optional): Enable markup, or ``None`` to use console default. + highlight (Optional[bool], optional): Enable automatic highlighting, or ``None`` to use console default. + + Returns: + List[ConsoleRenderable]: A list of things to render. + """ + renderables: List[ConsoleRenderable] = [] + _append = renderables.append + text: List[Text] = [] + append_text = text.append + + append = _append + if justify in ("left", "center", "right"): + + def align_append(renderable: RenderableType) -> None: + _append(Align(renderable, cast(AlignMethod, justify))) + + append = align_append + + _highlighter: HighlighterType = _null_highlighter + if highlight or (highlight is None and self._highlight): + _highlighter = self.highlighter + + def check_text() -> None: + if text: + sep_text = Text(sep, justify=justify, end=end) + append(sep_text.join(text)) + text.clear() + + for renderable in objects: + renderable = rich_cast(renderable) + if isinstance(renderable, str): + append_text( + self.render_str( + renderable, emoji=emoji, markup=markup, highlighter=_highlighter + ) + ) + elif isinstance(renderable, Text): + append_text(renderable) + elif isinstance(renderable, ConsoleRenderable): + check_text() + append(renderable) + elif is_expandable(renderable): + check_text() + append(Pretty(renderable, highlighter=_highlighter)) + else: + append_text(_highlighter(str(renderable))) + + check_text() + + if self.style is not None: + style = self.get_style(self.style) + renderables = [Styled(renderable, style) for renderable in renderables] + + return renderables + + def rule( + self, + title: TextType = "", + *, + characters: str = "─", + style: Union[str, Style] = "rule.line", + align: AlignMethod = "center", + ) -> None: + """Draw a line with optional centered title. + + Args: + title (str, optional): Text to render over the rule. Defaults to "". + characters (str, optional): Character(s) to form the line. Defaults to "─". + style (str, optional): Style of line. Defaults to "rule.line". + align (str, optional): How to align the title, one of "left", "center", or "right". Defaults to "center". + """ + from .rule import Rule + + rule = Rule(title=title, characters=characters, style=style, align=align) + self.print(rule) + + def control(self, *control: Control) -> None: + """Insert non-printing control codes. + + Args: + control_codes (str): Control codes, such as those that may move the cursor. + """ + if not self.is_dumb_terminal: + with self: + self._buffer.extend(_control.segment for _control in control) + + def out( + self, + *objects: Any, + sep: str = " ", + end: str = "\n", + style: Optional[Union[str, Style]] = None, + highlight: Optional[bool] = None, + ) -> None: + """Output to the terminal. This is a low-level way of writing to the terminal which unlike + :meth:`~rich.console.Console.print` won't pretty print, wrap text, or apply markup, but will + optionally apply highlighting and a basic style. + + Args: + sep (str, optional): String to write between print data. Defaults to " ". + end (str, optional): String to write at end of print data. Defaults to "\\\\n". + style (Union[str, Style], optional): A style to apply to output. Defaults to None. + highlight (Optional[bool], optional): Enable automatic highlighting, or ``None`` to use + console default. Defaults to ``None``. + """ + raw_output: str = sep.join(str(_object) for _object in objects) + self.print( + raw_output, + style=style, + highlight=highlight, + emoji=False, + markup=False, + no_wrap=True, + overflow="ignore", + crop=False, + end=end, + ) + + def print( + self, + *objects: Any, + sep: str = " ", + end: str = "\n", + style: Optional[Union[str, Style]] = None, + justify: Optional[JustifyMethod] = None, + overflow: Optional[OverflowMethod] = None, + no_wrap: Optional[bool] = None, + emoji: Optional[bool] = None, + markup: Optional[bool] = None, + highlight: Optional[bool] = None, + width: Optional[int] = None, + height: Optional[int] = None, + crop: bool = True, + soft_wrap: Optional[bool] = None, + new_line_start: bool = False, + ) -> None: + """Print to the console. + + Args: + objects (positional args): Objects to log to the terminal. + sep (str, optional): String to write between print data. Defaults to " ". + end (str, optional): String to write at end of print data. Defaults to "\\\\n". + style (Union[str, Style], optional): A style to apply to output. Defaults to None. + justify (str, optional): Justify method: "default", "left", "right", "center", or "full". Defaults to ``None``. + overflow (str, optional): Overflow method: "ignore", "crop", "fold", or "ellipsis". Defaults to None. + no_wrap (Optional[bool], optional): Disable word wrapping. Defaults to None. + emoji (Optional[bool], optional): Enable emoji code, or ``None`` to use console default. Defaults to ``None``. + markup (Optional[bool], optional): Enable markup, or ``None`` to use console default. Defaults to ``None``. + highlight (Optional[bool], optional): Enable automatic highlighting, or ``None`` to use console default. Defaults to ``None``. + width (Optional[int], optional): Width of output, or ``None`` to auto-detect. Defaults to ``None``. + crop (Optional[bool], optional): Crop output to width of terminal. Defaults to True. + soft_wrap (bool, optional): Enable soft wrap mode which disables word wrapping and cropping of text or ``None`` for + Console default. Defaults to ``None``. + new_line_start (bool, False): Insert a new line at the start if the output contains more than one line. Defaults to ``False``. + """ + if not objects: + objects = (NewLine(),) + + if soft_wrap is None: + soft_wrap = self.soft_wrap + if soft_wrap: + if no_wrap is None: + no_wrap = True + if overflow is None: + overflow = "ignore" + crop = False + render_hooks = self._render_hooks[:] + with self: + renderables = self._collect_renderables( + objects, + sep, + end, + justify=justify, + emoji=emoji, + markup=markup, + highlight=highlight, + ) + for hook in render_hooks: + renderables = hook.process_renderables(renderables) + render_options = self.options.update( + justify=justify, + overflow=overflow, + width=min(width, self.width) if width is not None else NO_CHANGE, + height=height, + no_wrap=no_wrap, + markup=markup, + highlight=highlight, + ) + + new_segments: List[Segment] = [] + extend = new_segments.extend + render = self.render + if style is None: + for renderable in renderables: + extend(render(renderable, render_options)) + else: + for renderable in renderables: + extend( + Segment.apply_style( + render(renderable, render_options), self.get_style(style) + ) + ) + if new_line_start: + if ( + len("".join(segment.text for segment in new_segments).splitlines()) + > 1 + ): + new_segments.insert(0, Segment.line()) + if crop: + buffer_extend = self._buffer.extend + for line in Segment.split_and_crop_lines( + new_segments, self.width, pad=False + ): + buffer_extend(line) + else: + self._buffer.extend(new_segments) + + def print_json( + self, + json: Optional[str] = None, + *, + data: Any = None, + indent: Union[None, int, str] = 2, + highlight: bool = True, + skip_keys: bool = False, + ensure_ascii: bool = False, + check_circular: bool = True, + allow_nan: bool = True, + default: Optional[Callable[[Any], Any]] = None, + sort_keys: bool = False, + ) -> None: + """Pretty prints JSON. Output will be valid JSON. + + Args: + json (Optional[str]): A string containing JSON. + data (Any): If json is not supplied, then encode this data. + indent (Union[None, int, str], optional): Number of spaces to indent. Defaults to 2. + highlight (bool, optional): Enable highlighting of output: Defaults to True. + skip_keys (bool, optional): Skip keys not of a basic type. Defaults to False. + ensure_ascii (bool, optional): Escape all non-ascii characters. Defaults to False. + check_circular (bool, optional): Check for circular references. Defaults to True. + allow_nan (bool, optional): Allow NaN and Infinity values. Defaults to True. + default (Callable, optional): A callable that converts values that can not be encoded + in to something that can be JSON encoded. Defaults to None. + sort_keys (bool, optional): Sort dictionary keys. Defaults to False. + """ + from pip._vendor.rich.json import JSON + + if json is None: + json_renderable = JSON.from_data( + data, + indent=indent, + highlight=highlight, + skip_keys=skip_keys, + ensure_ascii=ensure_ascii, + check_circular=check_circular, + allow_nan=allow_nan, + default=default, + sort_keys=sort_keys, + ) + else: + if not isinstance(json, str): + raise TypeError( + f"json must be str. Did you mean print_json(data={json!r}) ?" + ) + json_renderable = JSON( + json, + indent=indent, + highlight=highlight, + skip_keys=skip_keys, + ensure_ascii=ensure_ascii, + check_circular=check_circular, + allow_nan=allow_nan, + default=default, + sort_keys=sort_keys, + ) + self.print(json_renderable, soft_wrap=True) + + def update_screen( + self, + renderable: RenderableType, + *, + region: Optional[Region] = None, + options: Optional[ConsoleOptions] = None, + ) -> None: + """Update the screen at a given offset. + + Args: + renderable (RenderableType): A Rich renderable. + region (Region, optional): Region of screen to update, or None for entire screen. Defaults to None. + x (int, optional): x offset. Defaults to 0. + y (int, optional): y offset. Defaults to 0. + + Raises: + errors.NoAltScreen: If the Console isn't in alt screen mode. + + """ + if not self.is_alt_screen: + raise errors.NoAltScreen("Alt screen must be enabled to call update_screen") + render_options = options or self.options + if region is None: + x = y = 0 + render_options = render_options.update_dimensions( + render_options.max_width, render_options.height or self.height + ) + else: + x, y, width, height = region + render_options = render_options.update_dimensions(width, height) + + lines = self.render_lines(renderable, options=render_options) + self.update_screen_lines(lines, x, y) + + def update_screen_lines( + self, lines: List[List[Segment]], x: int = 0, y: int = 0 + ) -> None: + """Update lines of the screen at a given offset. + + Args: + lines (List[List[Segment]]): Rendered lines (as produced by :meth:`~rich.Console.render_lines`). + x (int, optional): x offset (column no). Defaults to 0. + y (int, optional): y offset (column no). Defaults to 0. + + Raises: + errors.NoAltScreen: If the Console isn't in alt screen mode. + """ + if not self.is_alt_screen: + raise errors.NoAltScreen("Alt screen must be enabled to call update_screen") + screen_update = ScreenUpdate(lines, x, y) + segments = self.render(screen_update) + self._buffer.extend(segments) + self._check_buffer() + + def print_exception( + self, + *, + width: Optional[int] = 100, + extra_lines: int = 3, + theme: Optional[str] = None, + word_wrap: bool = False, + show_locals: bool = False, + suppress: Iterable[Union[str, ModuleType]] = (), + max_frames: int = 100, + ) -> None: + """Prints a rich render of the last exception and traceback. + + Args: + width (Optional[int], optional): Number of characters used to render code. Defaults to 100. + extra_lines (int, optional): Additional lines of code to render. Defaults to 3. + theme (str, optional): Override pygments theme used in traceback + word_wrap (bool, optional): Enable word wrapping of long lines. Defaults to False. + show_locals (bool, optional): Enable display of local variables. Defaults to False. + suppress (Iterable[Union[str, ModuleType]]): Optional sequence of modules or paths to exclude from traceback. + max_frames (int): Maximum number of frames to show in a traceback, 0 for no maximum. Defaults to 100. + """ + from .traceback import Traceback + + traceback = Traceback( + width=width, + extra_lines=extra_lines, + theme=theme, + word_wrap=word_wrap, + show_locals=show_locals, + suppress=suppress, + max_frames=max_frames, + ) + self.print(traceback) + + @staticmethod + def _caller_frame_info( + offset: int, + currentframe: Callable[[], Optional[FrameType]] = inspect.currentframe, + ) -> Tuple[str, int, Dict[str, Any]]: + """Get caller frame information. + + Args: + offset (int): the caller offset within the current frame stack. + currentframe (Callable[[], Optional[FrameType]], optional): the callable to use to + retrieve the current frame. Defaults to ``inspect.currentframe``. + + Returns: + Tuple[str, int, Dict[str, Any]]: A tuple containing the filename, the line number and + the dictionary of local variables associated with the caller frame. + + Raises: + RuntimeError: If the stack offset is invalid. + """ + # Ignore the frame of this local helper + offset += 1 + + frame = currentframe() + if frame is not None: + # Use the faster currentframe where implemented + while offset and frame is not None: + frame = frame.f_back + offset -= 1 + assert frame is not None + return frame.f_code.co_filename, frame.f_lineno, frame.f_locals + else: + # Fallback to the slower stack + frame_info = inspect.stack()[offset] + return frame_info.filename, frame_info.lineno, frame_info.frame.f_locals + + def log( + self, + *objects: Any, + sep: str = " ", + end: str = "\n", + style: Optional[Union[str, Style]] = None, + justify: Optional[JustifyMethod] = None, + emoji: Optional[bool] = None, + markup: Optional[bool] = None, + highlight: Optional[bool] = None, + log_locals: bool = False, + _stack_offset: int = 1, + ) -> None: + """Log rich content to the terminal. + + Args: + objects (positional args): Objects to log to the terminal. + sep (str, optional): String to write between print data. Defaults to " ". + end (str, optional): String to write at end of print data. Defaults to "\\\\n". + style (Union[str, Style], optional): A style to apply to output. Defaults to None. + justify (str, optional): One of "left", "right", "center", or "full". Defaults to ``None``. + emoji (Optional[bool], optional): Enable emoji code, or ``None`` to use console default. Defaults to None. + markup (Optional[bool], optional): Enable markup, or ``None`` to use console default. Defaults to None. + highlight (Optional[bool], optional): Enable automatic highlighting, or ``None`` to use console default. Defaults to None. + log_locals (bool, optional): Boolean to enable logging of locals where ``log()`` + was called. Defaults to False. + _stack_offset (int, optional): Offset of caller from end of call stack. Defaults to 1. + """ + if not objects: + objects = (NewLine(),) + + render_hooks = self._render_hooks[:] + + with self: + renderables = self._collect_renderables( + objects, + sep, + end, + justify=justify, + emoji=emoji, + markup=markup, + highlight=highlight, + ) + if style is not None: + renderables = [Styled(renderable, style) for renderable in renderables] + + filename, line_no, locals = self._caller_frame_info(_stack_offset) + link_path = None if filename.startswith("<") else os.path.abspath(filename) + path = filename.rpartition(os.sep)[-1] + if log_locals: + locals_map = { + key: value + for key, value in locals.items() + if not key.startswith("__") + } + renderables.append(render_scope(locals_map, title="[i]locals")) + + renderables = [ + self._log_render( + self, + renderables, + log_time=self.get_datetime(), + path=path, + line_no=line_no, + link_path=link_path, + ) + ] + for hook in render_hooks: + renderables = hook.process_renderables(renderables) + new_segments: List[Segment] = [] + extend = new_segments.extend + render = self.render + render_options = self.options + for renderable in renderables: + extend(render(renderable, render_options)) + buffer_extend = self._buffer.extend + for line in Segment.split_and_crop_lines( + new_segments, self.width, pad=False + ): + buffer_extend(line) + + def _check_buffer(self) -> None: + """Check if the buffer may be rendered. Render it if it can (e.g. Console.quiet is False) + Rendering is supported on Windows, Unix and Jupyter environments. For + legacy Windows consoles, the win32 API is called directly. + This method will also record what it renders if recording is enabled via Console.record. + """ + if self.quiet: + del self._buffer[:] + return + with self._lock: + if self.record: + with self._record_buffer_lock: + self._record_buffer.extend(self._buffer[:]) + + if self._buffer_index == 0: + if self.is_jupyter: # pragma: no cover + from .jupyter import display + + display(self._buffer, self._render_buffer(self._buffer[:])) + del self._buffer[:] + else: + if WINDOWS: + use_legacy_windows_render = False + if self.legacy_windows: + fileno = get_fileno(self.file) + if fileno is not None: + use_legacy_windows_render = ( + fileno in _STD_STREAMS_OUTPUT + ) + + if use_legacy_windows_render: + from pip._vendor.rich._win32_console import LegacyWindowsTerm + from pip._vendor.rich._windows_renderer import legacy_windows_render + + buffer = self._buffer[:] + if self.no_color and self._color_system: + buffer = list(Segment.remove_color(buffer)) + + legacy_windows_render(buffer, LegacyWindowsTerm(self.file)) + else: + # Either a non-std stream on legacy Windows, or modern Windows. + text = self._render_buffer(self._buffer[:]) + # https://bugs.python.org/issue37871 + # https://github.com/python/cpython/issues/82052 + # We need to avoid writing more than 32Kb in a single write, due to the above bug + write = self.file.write + # Worse case scenario, every character is 4 bytes of utf-8 + MAX_WRITE = 32 * 1024 // 4 + try: + if len(text) <= MAX_WRITE: + write(text) + else: + batch: List[str] = [] + batch_append = batch.append + size = 0 + for line in text.splitlines(True): + if size + len(line) > MAX_WRITE and batch: + write("".join(batch)) + batch.clear() + size = 0 + batch_append(line) + size += len(line) + if batch: + write("".join(batch)) + batch.clear() + except UnicodeEncodeError as error: + error.reason = f"{error.reason}\n*** You may need to add PYTHONIOENCODING=utf-8 to your environment ***" + raise + else: + text = self._render_buffer(self._buffer[:]) + try: + self.file.write(text) + except UnicodeEncodeError as error: + error.reason = f"{error.reason}\n*** You may need to add PYTHONIOENCODING=utf-8 to your environment ***" + raise + + self.file.flush() + del self._buffer[:] + + def _render_buffer(self, buffer: Iterable[Segment]) -> str: + """Render buffered output, and clear buffer.""" + output: List[str] = [] + append = output.append + color_system = self._color_system + legacy_windows = self.legacy_windows + not_terminal = not self.is_terminal + if self.no_color and color_system: + buffer = Segment.remove_color(buffer) + for text, style, control in buffer: + if style: + append( + style.render( + text, + color_system=color_system, + legacy_windows=legacy_windows, + ) + ) + elif not (not_terminal and control): + append(text) + + rendered = "".join(output) + return rendered + + def input( + self, + prompt: TextType = "", + *, + markup: bool = True, + emoji: bool = True, + password: bool = False, + stream: Optional[TextIO] = None, + ) -> str: + """Displays a prompt and waits for input from the user. The prompt may contain color / style. + + It works in the same way as Python's builtin :func:`input` function and provides elaborate line editing and history features if Python's builtin :mod:`readline` module is previously loaded. + + Args: + prompt (Union[str, Text]): Text to render in the prompt. + markup (bool, optional): Enable console markup (requires a str prompt). Defaults to True. + emoji (bool, optional): Enable emoji (requires a str prompt). Defaults to True. + password: (bool, optional): Hide typed text. Defaults to False. + stream: (TextIO, optional): Optional file to read input from (rather than stdin). Defaults to None. + + Returns: + str: Text read from stdin. + """ + if prompt: + self.print(prompt, markup=markup, emoji=emoji, end="") + if password: + result = getpass("", stream=stream) + else: + if stream: + result = stream.readline() + else: + result = input() + return result + + def export_text(self, *, clear: bool = True, styles: bool = False) -> str: + """Generate text from console contents (requires record=True argument in constructor). + + Args: + clear (bool, optional): Clear record buffer after exporting. Defaults to ``True``. + styles (bool, optional): If ``True``, ansi escape codes will be included. ``False`` for plain text. + Defaults to ``False``. + + Returns: + str: String containing console contents. + + """ + assert ( + self.record + ), "To export console contents set record=True in the constructor or instance" + + with self._record_buffer_lock: + if styles: + text = "".join( + (style.render(text) if style else text) + for text, style, _ in self._record_buffer + ) + else: + text = "".join( + segment.text + for segment in self._record_buffer + if not segment.control + ) + if clear: + del self._record_buffer[:] + return text + + def save_text(self, path: str, *, clear: bool = True, styles: bool = False) -> None: + """Generate text from console and save to a given location (requires record=True argument in constructor). + + Args: + path (str): Path to write text files. + clear (bool, optional): Clear record buffer after exporting. Defaults to ``True``. + styles (bool, optional): If ``True``, ansi style codes will be included. ``False`` for plain text. + Defaults to ``False``. + + """ + text = self.export_text(clear=clear, styles=styles) + with open(path, "wt", encoding="utf-8") as write_file: + write_file.write(text) + + def export_html( + self, + *, + theme: Optional[TerminalTheme] = None, + clear: bool = True, + code_format: Optional[str] = None, + inline_styles: bool = False, + ) -> str: + """Generate HTML from console contents (requires record=True argument in constructor). + + Args: + theme (TerminalTheme, optional): TerminalTheme object containing console colors. + clear (bool, optional): Clear record buffer after exporting. Defaults to ``True``. + code_format (str, optional): Format string to render HTML. In addition to '{foreground}', + '{background}', and '{code}', should contain '{stylesheet}' if inline_styles is ``False``. + inline_styles (bool, optional): If ``True`` styles will be inlined in to spans, which makes files + larger but easier to cut and paste markup. If ``False``, styles will be embedded in a style tag. + Defaults to False. + + Returns: + str: String containing console contents as HTML. + """ + assert ( + self.record + ), "To export console contents set record=True in the constructor or instance" + fragments: List[str] = [] + append = fragments.append + _theme = theme or DEFAULT_TERMINAL_THEME + stylesheet = "" + + render_code_format = CONSOLE_HTML_FORMAT if code_format is None else code_format + + with self._record_buffer_lock: + if inline_styles: + for text, style, _ in Segment.filter_control( + Segment.simplify(self._record_buffer) + ): + text = escape(text) + if style: + rule = style.get_html_style(_theme) + if style.link: + text = f'
{text}' + text = f'{text}' if rule else text + append(text) + else: + styles: Dict[str, int] = {} + for text, style, _ in Segment.filter_control( + Segment.simplify(self._record_buffer) + ): + text = escape(text) + if style: + rule = style.get_html_style(_theme) + style_number = styles.setdefault(rule, len(styles) + 1) + if style.link: + text = f'{text}' + else: + text = f'{text}' + append(text) + stylesheet_rules: List[str] = [] + stylesheet_append = stylesheet_rules.append + for style_rule, style_number in styles.items(): + if style_rule: + stylesheet_append(f".r{style_number} {{{style_rule}}}") + stylesheet = "\n".join(stylesheet_rules) + + rendered_code = render_code_format.format( + code="".join(fragments), + stylesheet=stylesheet, + foreground=_theme.foreground_color.hex, + background=_theme.background_color.hex, + ) + if clear: + del self._record_buffer[:] + return rendered_code + + def save_html( + self, + path: str, + *, + theme: Optional[TerminalTheme] = None, + clear: bool = True, + code_format: str = CONSOLE_HTML_FORMAT, + inline_styles: bool = False, + ) -> None: + """Generate HTML from console contents and write to a file (requires record=True argument in constructor). + + Args: + path (str): Path to write html file. + theme (TerminalTheme, optional): TerminalTheme object containing console colors. + clear (bool, optional): Clear record buffer after exporting. Defaults to ``True``. + code_format (str, optional): Format string to render HTML. In addition to '{foreground}', + '{background}', and '{code}', should contain '{stylesheet}' if inline_styles is ``False``. + inline_styles (bool, optional): If ``True`` styles will be inlined in to spans, which makes files + larger but easier to cut and paste markup. If ``False``, styles will be embedded in a style tag. + Defaults to False. + + """ + html = self.export_html( + theme=theme, + clear=clear, + code_format=code_format, + inline_styles=inline_styles, + ) + with open(path, "wt", encoding="utf-8") as write_file: + write_file.write(html) + + def export_svg( + self, + *, + title: str = "Rich", + theme: Optional[TerminalTheme] = None, + clear: bool = True, + code_format: str = CONSOLE_SVG_FORMAT, + font_aspect_ratio: float = 0.61, + unique_id: Optional[str] = None, + ) -> str: + """ + Generate an SVG from the console contents (requires record=True in Console constructor). + + Args: + title (str, optional): The title of the tab in the output image + theme (TerminalTheme, optional): The ``TerminalTheme`` object to use to style the terminal + clear (bool, optional): Clear record buffer after exporting. Defaults to ``True`` + code_format (str, optional): Format string used to generate the SVG. Rich will inject a number of variables + into the string in order to form the final SVG output. The default template used and the variables + injected by Rich can be found by inspecting the ``console.CONSOLE_SVG_FORMAT`` variable. + font_aspect_ratio (float, optional): The width to height ratio of the font used in the ``code_format`` + string. Defaults to 0.61, which is the width to height ratio of Fira Code (the default font). + If you aren't specifying a different font inside ``code_format``, you probably don't need this. + unique_id (str, optional): unique id that is used as the prefix for various elements (CSS styles, node + ids). If not set, this defaults to a computed value based on the recorded content. + """ + + from pip._vendor.rich.cells import cell_len + + style_cache: Dict[Style, str] = {} + + def get_svg_style(style: Style) -> str: + """Convert a Style to CSS rules for SVG.""" + if style in style_cache: + return style_cache[style] + css_rules = [] + color = ( + _theme.foreground_color + if (style.color is None or style.color.is_default) + else style.color.get_truecolor(_theme) + ) + bgcolor = ( + _theme.background_color + if (style.bgcolor is None or style.bgcolor.is_default) + else style.bgcolor.get_truecolor(_theme) + ) + if style.reverse: + color, bgcolor = bgcolor, color + if style.dim: + color = blend_rgb(color, bgcolor, 0.4) + css_rules.append(f"fill: {color.hex}") + if style.bold: + css_rules.append("font-weight: bold") + if style.italic: + css_rules.append("font-style: italic;") + if style.underline: + css_rules.append("text-decoration: underline;") + if style.strike: + css_rules.append("text-decoration: line-through;") + + css = ";".join(css_rules) + style_cache[style] = css + return css + + _theme = theme or SVG_EXPORT_THEME + + width = self.width + char_height = 20 + char_width = char_height * font_aspect_ratio + line_height = char_height * 1.22 + + margin_top = 1 + margin_right = 1 + margin_bottom = 1 + margin_left = 1 + + padding_top = 40 + padding_right = 8 + padding_bottom = 8 + padding_left = 8 + + padding_width = padding_left + padding_right + padding_height = padding_top + padding_bottom + margin_width = margin_left + margin_right + margin_height = margin_top + margin_bottom + + text_backgrounds: List[str] = [] + text_group: List[str] = [] + classes: Dict[str, int] = {} + style_no = 1 + + def escape_text(text: str) -> str: + """HTML escape text and replace spaces with nbsp.""" + return escape(text).replace(" ", " ") + + def make_tag( + name: str, content: Optional[str] = None, **attribs: object + ) -> str: + """Make a tag from name, content, and attributes.""" + + def stringify(value: object) -> str: + if isinstance(value, (float)): + return format(value, "g") + return str(value) + + tag_attribs = " ".join( + f'{k.lstrip("_").replace("_", "-")}="{stringify(v)}"' + for k, v in attribs.items() + ) + return ( + f"<{name} {tag_attribs}>{content}" + if content + else f"<{name} {tag_attribs}/>" + ) + + with self._record_buffer_lock: + segments = list(Segment.filter_control(self._record_buffer)) + if clear: + self._record_buffer.clear() + + if unique_id is None: + unique_id = "terminal-" + str( + zlib.adler32( + ("".join(repr(segment) for segment in segments)).encode( + "utf-8", + "ignore", + ) + + title.encode("utf-8", "ignore") + ) + ) + y = 0 + for y, line in enumerate(Segment.split_and_crop_lines(segments, length=width)): + x = 0 + for text, style, _control in line: + style = style or Style() + rules = get_svg_style(style) + if rules not in classes: + classes[rules] = style_no + style_no += 1 + class_name = f"r{classes[rules]}" + + if style.reverse: + has_background = True + background = ( + _theme.foreground_color.hex + if style.color is None + else style.color.get_truecolor(_theme).hex + ) + else: + bgcolor = style.bgcolor + has_background = bgcolor is not None and not bgcolor.is_default + background = ( + _theme.background_color.hex + if style.bgcolor is None + else style.bgcolor.get_truecolor(_theme).hex + ) + + text_length = cell_len(text) + if has_background: + text_backgrounds.append( + make_tag( + "rect", + fill=background, + x=x * char_width, + y=y * line_height + 1.5, + width=char_width * text_length, + height=line_height + 0.25, + shape_rendering="crispEdges", + ) + ) + + if text != " " * len(text): + text_group.append( + make_tag( + "text", + escape_text(text), + _class=f"{unique_id}-{class_name}", + x=x * char_width, + y=y * line_height + char_height, + textLength=char_width * len(text), + clip_path=f"url(#{unique_id}-line-{y})", + ) + ) + x += cell_len(text) + + line_offsets = [line_no * line_height + 1.5 for line_no in range(y)] + lines = "\n".join( + f""" + {make_tag("rect", x=0, y=offset, width=char_width * width, height=line_height + 0.25)} + """ + for line_no, offset in enumerate(line_offsets) + ) + + styles = "\n".join( + f".{unique_id}-r{rule_no} {{ {css} }}" for css, rule_no in classes.items() + ) + backgrounds = "".join(text_backgrounds) + matrix = "".join(text_group) + + terminal_width = ceil(width * char_width + padding_width) + terminal_height = (y + 1) * line_height + padding_height + chrome = make_tag( + "rect", + fill=_theme.background_color.hex, + stroke="rgba(255,255,255,0.35)", + stroke_width="1", + x=margin_left, + y=margin_top, + width=terminal_width, + height=terminal_height, + rx=8, + ) + + title_color = _theme.foreground_color.hex + if title: + chrome += make_tag( + "text", + escape_text(title), + _class=f"{unique_id}-title", + fill=title_color, + text_anchor="middle", + x=terminal_width // 2, + y=margin_top + char_height + 6, + ) + chrome += f""" + + + + + + """ + + svg = code_format.format( + unique_id=unique_id, + char_width=char_width, + char_height=char_height, + line_height=line_height, + terminal_width=char_width * width - 1, + terminal_height=(y + 1) * line_height - 1, + width=terminal_width + margin_width, + height=terminal_height + margin_height, + terminal_x=margin_left + padding_left, + terminal_y=margin_top + padding_top, + styles=styles, + chrome=chrome, + backgrounds=backgrounds, + matrix=matrix, + lines=lines, + ) + return svg + + def save_svg( + self, + path: str, + *, + title: str = "Rich", + theme: Optional[TerminalTheme] = None, + clear: bool = True, + code_format: str = CONSOLE_SVG_FORMAT, + font_aspect_ratio: float = 0.61, + unique_id: Optional[str] = None, + ) -> None: + """Generate an SVG file from the console contents (requires record=True in Console constructor). + + Args: + path (str): The path to write the SVG to. + title (str, optional): The title of the tab in the output image + theme (TerminalTheme, optional): The ``TerminalTheme`` object to use to style the terminal + clear (bool, optional): Clear record buffer after exporting. Defaults to ``True`` + code_format (str, optional): Format string used to generate the SVG. Rich will inject a number of variables + into the string in order to form the final SVG output. The default template used and the variables + injected by Rich can be found by inspecting the ``console.CONSOLE_SVG_FORMAT`` variable. + font_aspect_ratio (float, optional): The width to height ratio of the font used in the ``code_format`` + string. Defaults to 0.61, which is the width to height ratio of Fira Code (the default font). + If you aren't specifying a different font inside ``code_format``, you probably don't need this. + unique_id (str, optional): unique id that is used as the prefix for various elements (CSS styles, node + ids). If not set, this defaults to a computed value based on the recorded content. + """ + svg = self.export_svg( + title=title, + theme=theme, + clear=clear, + code_format=code_format, + font_aspect_ratio=font_aspect_ratio, + unique_id=unique_id, + ) + with open(path, "wt", encoding="utf-8") as write_file: + write_file.write(svg) + + +def _svg_hash(svg_main_code: str) -> str: + """Returns a unique hash for the given SVG main code. + + Args: + svg_main_code (str): The content we're going to inject in the SVG envelope. + + Returns: + str: a hash of the given content + """ + return str(zlib.adler32(svg_main_code.encode())) + + +if __name__ == "__main__": # pragma: no cover + console = Console(record=True) + + console.log( + "JSONRPC [i]request[/i]", + 5, + 1.3, + True, + False, + None, + { + "jsonrpc": "2.0", + "method": "subtract", + "params": {"minuend": 42, "subtrahend": 23}, + "id": 3, + }, + ) + + console.log("Hello, World!", "{'a': 1}", repr(console)) + + console.print( + { + "name": None, + "empty": [], + "quiz": { + "sport": { + "answered": True, + "q1": { + "question": "Which one is correct team name in NBA?", + "options": [ + "New York Bulls", + "Los Angeles Kings", + "Golden State Warriors", + "Huston Rocket", + ], + "answer": "Huston Rocket", + }, + }, + "maths": { + "answered": False, + "q1": { + "question": "5 + 7 = ?", + "options": [10, 11, 12, 13], + "answer": 12, + }, + "q2": { + "question": "12 - 8 = ?", + "options": [1, 2, 3, 4], + "answer": 4, + }, + }, + }, + } + ) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/constrain.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/constrain.py new file mode 100644 index 0000000..65fdf56 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/constrain.py @@ -0,0 +1,37 @@ +from typing import Optional, TYPE_CHECKING + +from .jupyter import JupyterMixin +from .measure import Measurement + +if TYPE_CHECKING: + from .console import Console, ConsoleOptions, RenderableType, RenderResult + + +class Constrain(JupyterMixin): + """Constrain the width of a renderable to a given number of characters. + + Args: + renderable (RenderableType): A renderable object. + width (int, optional): The maximum width (in characters) to render. Defaults to 80. + """ + + def __init__(self, renderable: "RenderableType", width: Optional[int] = 80) -> None: + self.renderable = renderable + self.width = width + + def __rich_console__( + self, console: "Console", options: "ConsoleOptions" + ) -> "RenderResult": + if self.width is None: + yield self.renderable + else: + child_options = options.update_width(min(self.width, options.max_width)) + yield from console.render(self.renderable, child_options) + + def __rich_measure__( + self, console: "Console", options: "ConsoleOptions" + ) -> "Measurement": + if self.width is not None: + options = options.update_width(self.width) + measurement = Measurement.get(console, options, self.renderable) + return measurement diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/containers.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/containers.py new file mode 100644 index 0000000..901ff8b --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/containers.py @@ -0,0 +1,167 @@ +from itertools import zip_longest +from typing import ( + TYPE_CHECKING, + Iterable, + Iterator, + List, + Optional, + TypeVar, + Union, + overload, +) + +if TYPE_CHECKING: + from .console import ( + Console, + ConsoleOptions, + JustifyMethod, + OverflowMethod, + RenderResult, + RenderableType, + ) + from .text import Text + +from .cells import cell_len +from .measure import Measurement + +T = TypeVar("T") + + +class Renderables: + """A list subclass which renders its contents to the console.""" + + def __init__( + self, renderables: Optional[Iterable["RenderableType"]] = None + ) -> None: + self._renderables: List["RenderableType"] = ( + list(renderables) if renderables is not None else [] + ) + + def __rich_console__( + self, console: "Console", options: "ConsoleOptions" + ) -> "RenderResult": + """Console render method to insert line-breaks.""" + yield from self._renderables + + def __rich_measure__( + self, console: "Console", options: "ConsoleOptions" + ) -> "Measurement": + dimensions = [ + Measurement.get(console, options, renderable) + for renderable in self._renderables + ] + if not dimensions: + return Measurement(1, 1) + _min = max(dimension.minimum for dimension in dimensions) + _max = max(dimension.maximum for dimension in dimensions) + return Measurement(_min, _max) + + def append(self, renderable: "RenderableType") -> None: + self._renderables.append(renderable) + + def __iter__(self) -> Iterable["RenderableType"]: + return iter(self._renderables) + + +class Lines: + """A list subclass which can render to the console.""" + + def __init__(self, lines: Iterable["Text"] = ()) -> None: + self._lines: List["Text"] = list(lines) + + def __repr__(self) -> str: + return f"Lines({self._lines!r})" + + def __iter__(self) -> Iterator["Text"]: + return iter(self._lines) + + @overload + def __getitem__(self, index: int) -> "Text": + ... + + @overload + def __getitem__(self, index: slice) -> List["Text"]: + ... + + def __getitem__(self, index: Union[slice, int]) -> Union["Text", List["Text"]]: + return self._lines[index] + + def __setitem__(self, index: int, value: "Text") -> "Lines": + self._lines[index] = value + return self + + def __len__(self) -> int: + return self._lines.__len__() + + def __rich_console__( + self, console: "Console", options: "ConsoleOptions" + ) -> "RenderResult": + """Console render method to insert line-breaks.""" + yield from self._lines + + def append(self, line: "Text") -> None: + self._lines.append(line) + + def extend(self, lines: Iterable["Text"]) -> None: + self._lines.extend(lines) + + def pop(self, index: int = -1) -> "Text": + return self._lines.pop(index) + + def justify( + self, + console: "Console", + width: int, + justify: "JustifyMethod" = "left", + overflow: "OverflowMethod" = "fold", + ) -> None: + """Justify and overflow text to a given width. + + Args: + console (Console): Console instance. + width (int): Number of cells available per line. + justify (str, optional): Default justify method for text: "left", "center", "full" or "right". Defaults to "left". + overflow (str, optional): Default overflow for text: "crop", "fold", or "ellipsis". Defaults to "fold". + + """ + from .text import Text + + if justify == "left": + for line in self._lines: + line.truncate(width, overflow=overflow, pad=True) + elif justify == "center": + for line in self._lines: + line.rstrip() + line.truncate(width, overflow=overflow) + line.pad_left((width - cell_len(line.plain)) // 2) + line.pad_right(width - cell_len(line.plain)) + elif justify == "right": + for line in self._lines: + line.rstrip() + line.truncate(width, overflow=overflow) + line.pad_left(width - cell_len(line.plain)) + elif justify == "full": + for line_index, line in enumerate(self._lines): + if line_index == len(self._lines) - 1: + break + words = line.split(" ") + words_size = sum(cell_len(word.plain) for word in words) + num_spaces = len(words) - 1 + spaces = [1 for _ in range(num_spaces)] + index = 0 + if spaces: + while words_size + num_spaces < width: + spaces[len(spaces) - index - 1] += 1 + num_spaces += 1 + index = (index + 1) % len(spaces) + tokens: List[Text] = [] + for index, (word, next_word) in enumerate( + zip_longest(words, words[1:]) + ): + tokens.append(word) + if index < len(spaces): + style = word.get_style_at_offset(console, -1) + next_style = next_word.get_style_at_offset(console, 0) + space_style = style if style == next_style else line.style + tokens.append(Text(" " * spaces[index], style=space_style)) + self[line_index] = Text("").join(tokens) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/control.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/control.py new file mode 100644 index 0000000..88fcb92 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/control.py @@ -0,0 +1,225 @@ +import sys +import time +from typing import TYPE_CHECKING, Callable, Dict, Iterable, List, Union + +if sys.version_info >= (3, 8): + from typing import Final +else: + from pip._vendor.typing_extensions import Final # pragma: no cover + +from .segment import ControlCode, ControlType, Segment + +if TYPE_CHECKING: + from .console import Console, ConsoleOptions, RenderResult + +STRIP_CONTROL_CODES: Final = [ + 7, # Bell + 8, # Backspace + 11, # Vertical tab + 12, # Form feed + 13, # Carriage return +] +_CONTROL_STRIP_TRANSLATE: Final = { + _codepoint: None for _codepoint in STRIP_CONTROL_CODES +} + +CONTROL_ESCAPE: Final = { + 7: "\\a", + 8: "\\b", + 11: "\\v", + 12: "\\f", + 13: "\\r", +} + +CONTROL_CODES_FORMAT: Dict[int, Callable[..., str]] = { + ControlType.BELL: lambda: "\x07", + ControlType.CARRIAGE_RETURN: lambda: "\r", + ControlType.HOME: lambda: "\x1b[H", + ControlType.CLEAR: lambda: "\x1b[2J", + ControlType.ENABLE_ALT_SCREEN: lambda: "\x1b[?1049h", + ControlType.DISABLE_ALT_SCREEN: lambda: "\x1b[?1049l", + ControlType.SHOW_CURSOR: lambda: "\x1b[?25h", + ControlType.HIDE_CURSOR: lambda: "\x1b[?25l", + ControlType.CURSOR_UP: lambda param: f"\x1b[{param}A", + ControlType.CURSOR_DOWN: lambda param: f"\x1b[{param}B", + ControlType.CURSOR_FORWARD: lambda param: f"\x1b[{param}C", + ControlType.CURSOR_BACKWARD: lambda param: f"\x1b[{param}D", + ControlType.CURSOR_MOVE_TO_COLUMN: lambda param: f"\x1b[{param+1}G", + ControlType.ERASE_IN_LINE: lambda param: f"\x1b[{param}K", + ControlType.CURSOR_MOVE_TO: lambda x, y: f"\x1b[{y+1};{x+1}H", + ControlType.SET_WINDOW_TITLE: lambda title: f"\x1b]0;{title}\x07", +} + + +class Control: + """A renderable that inserts a control code (non printable but may move cursor). + + Args: + *codes (str): Positional arguments are either a :class:`~rich.segment.ControlType` enum or a + tuple of ControlType and an integer parameter + """ + + __slots__ = ["segment"] + + def __init__(self, *codes: Union[ControlType, ControlCode]) -> None: + control_codes: List[ControlCode] = [ + (code,) if isinstance(code, ControlType) else code for code in codes + ] + _format_map = CONTROL_CODES_FORMAT + rendered_codes = "".join( + _format_map[code](*parameters) for code, *parameters in control_codes + ) + self.segment = Segment(rendered_codes, None, control_codes) + + @classmethod + def bell(cls) -> "Control": + """Ring the 'bell'.""" + return cls(ControlType.BELL) + + @classmethod + def home(cls) -> "Control": + """Move cursor to 'home' position.""" + return cls(ControlType.HOME) + + @classmethod + def move(cls, x: int = 0, y: int = 0) -> "Control": + """Move cursor relative to current position. + + Args: + x (int): X offset. + y (int): Y offset. + + Returns: + ~Control: Control object. + + """ + + def get_codes() -> Iterable[ControlCode]: + control = ControlType + if x: + yield ( + control.CURSOR_FORWARD if x > 0 else control.CURSOR_BACKWARD, + abs(x), + ) + if y: + yield ( + control.CURSOR_DOWN if y > 0 else control.CURSOR_UP, + abs(y), + ) + + control = cls(*get_codes()) + return control + + @classmethod + def move_to_column(cls, x: int, y: int = 0) -> "Control": + """Move to the given column, optionally add offset to row. + + Returns: + x (int): absolute x (column) + y (int): optional y offset (row) + + Returns: + ~Control: Control object. + """ + + return ( + cls( + (ControlType.CURSOR_MOVE_TO_COLUMN, x), + ( + ControlType.CURSOR_DOWN if y > 0 else ControlType.CURSOR_UP, + abs(y), + ), + ) + if y + else cls((ControlType.CURSOR_MOVE_TO_COLUMN, x)) + ) + + @classmethod + def move_to(cls, x: int, y: int) -> "Control": + """Move cursor to absolute position. + + Args: + x (int): x offset (column) + y (int): y offset (row) + + Returns: + ~Control: Control object. + """ + return cls((ControlType.CURSOR_MOVE_TO, x, y)) + + @classmethod + def clear(cls) -> "Control": + """Clear the screen.""" + return cls(ControlType.CLEAR) + + @classmethod + def show_cursor(cls, show: bool) -> "Control": + """Show or hide the cursor.""" + return cls(ControlType.SHOW_CURSOR if show else ControlType.HIDE_CURSOR) + + @classmethod + def alt_screen(cls, enable: bool) -> "Control": + """Enable or disable alt screen.""" + if enable: + return cls(ControlType.ENABLE_ALT_SCREEN, ControlType.HOME) + else: + return cls(ControlType.DISABLE_ALT_SCREEN) + + @classmethod + def title(cls, title: str) -> "Control": + """Set the terminal window title + + Args: + title (str): The new terminal window title + """ + return cls((ControlType.SET_WINDOW_TITLE, title)) + + def __str__(self) -> str: + return self.segment.text + + def __rich_console__( + self, console: "Console", options: "ConsoleOptions" + ) -> "RenderResult": + if self.segment.text: + yield self.segment + + +def strip_control_codes( + text: str, _translate_table: Dict[int, None] = _CONTROL_STRIP_TRANSLATE +) -> str: + """Remove control codes from text. + + Args: + text (str): A string possibly contain control codes. + + Returns: + str: String with control codes removed. + """ + return text.translate(_translate_table) + + +def escape_control_codes( + text: str, + _translate_table: Dict[int, str] = CONTROL_ESCAPE, +) -> str: + """Replace control codes with their "escaped" equivalent in the given text. + (e.g. "\b" becomes "\\b") + + Args: + text (str): A string possibly containing control codes. + + Returns: + str: String with control codes replaced with their escaped version. + """ + return text.translate(_translate_table) + + +if __name__ == "__main__": # pragma: no cover + from pip._vendor.rich.console import Console + + console = Console() + console.print("Look at the title of your terminal window ^") + # console.print(Control((ControlType.SET_WINDOW_TITLE, "Hello, world!"))) + for i in range(10): + console.set_window_title("🚀 Loading" + "." * i) + time.sleep(0.5) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/default_styles.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/default_styles.py new file mode 100644 index 0000000..dca3719 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/default_styles.py @@ -0,0 +1,190 @@ +from typing import Dict + +from .style import Style + +DEFAULT_STYLES: Dict[str, Style] = { + "none": Style.null(), + "reset": Style( + color="default", + bgcolor="default", + dim=False, + bold=False, + italic=False, + underline=False, + blink=False, + blink2=False, + reverse=False, + conceal=False, + strike=False, + ), + "dim": Style(dim=True), + "bright": Style(dim=False), + "bold": Style(bold=True), + "strong": Style(bold=True), + "code": Style(reverse=True, bold=True), + "italic": Style(italic=True), + "emphasize": Style(italic=True), + "underline": Style(underline=True), + "blink": Style(blink=True), + "blink2": Style(blink2=True), + "reverse": Style(reverse=True), + "strike": Style(strike=True), + "black": Style(color="black"), + "red": Style(color="red"), + "green": Style(color="green"), + "yellow": Style(color="yellow"), + "magenta": Style(color="magenta"), + "cyan": Style(color="cyan"), + "white": Style(color="white"), + "inspect.attr": Style(color="yellow", italic=True), + "inspect.attr.dunder": Style(color="yellow", italic=True, dim=True), + "inspect.callable": Style(bold=True, color="red"), + "inspect.async_def": Style(italic=True, color="bright_cyan"), + "inspect.def": Style(italic=True, color="bright_cyan"), + "inspect.class": Style(italic=True, color="bright_cyan"), + "inspect.error": Style(bold=True, color="red"), + "inspect.equals": Style(), + "inspect.help": Style(color="cyan"), + "inspect.doc": Style(dim=True), + "inspect.value.border": Style(color="green"), + "live.ellipsis": Style(bold=True, color="red"), + "layout.tree.row": Style(dim=False, color="red"), + "layout.tree.column": Style(dim=False, color="blue"), + "logging.keyword": Style(bold=True, color="yellow"), + "logging.level.notset": Style(dim=True), + "logging.level.debug": Style(color="green"), + "logging.level.info": Style(color="blue"), + "logging.level.warning": Style(color="red"), + "logging.level.error": Style(color="red", bold=True), + "logging.level.critical": Style(color="red", bold=True, reverse=True), + "log.level": Style.null(), + "log.time": Style(color="cyan", dim=True), + "log.message": Style.null(), + "log.path": Style(dim=True), + "repr.ellipsis": Style(color="yellow"), + "repr.indent": Style(color="green", dim=True), + "repr.error": Style(color="red", bold=True), + "repr.str": Style(color="green", italic=False, bold=False), + "repr.brace": Style(bold=True), + "repr.comma": Style(bold=True), + "repr.ipv4": Style(bold=True, color="bright_green"), + "repr.ipv6": Style(bold=True, color="bright_green"), + "repr.eui48": Style(bold=True, color="bright_green"), + "repr.eui64": Style(bold=True, color="bright_green"), + "repr.tag_start": Style(bold=True), + "repr.tag_name": Style(color="bright_magenta", bold=True), + "repr.tag_contents": Style(color="default"), + "repr.tag_end": Style(bold=True), + "repr.attrib_name": Style(color="yellow", italic=False), + "repr.attrib_equal": Style(bold=True), + "repr.attrib_value": Style(color="magenta", italic=False), + "repr.number": Style(color="cyan", bold=True, italic=False), + "repr.number_complex": Style(color="cyan", bold=True, italic=False), # same + "repr.bool_true": Style(color="bright_green", italic=True), + "repr.bool_false": Style(color="bright_red", italic=True), + "repr.none": Style(color="magenta", italic=True), + "repr.url": Style(underline=True, color="bright_blue", italic=False, bold=False), + "repr.uuid": Style(color="bright_yellow", bold=False), + "repr.call": Style(color="magenta", bold=True), + "repr.path": Style(color="magenta"), + "repr.filename": Style(color="bright_magenta"), + "rule.line": Style(color="bright_green"), + "rule.text": Style.null(), + "json.brace": Style(bold=True), + "json.bool_true": Style(color="bright_green", italic=True), + "json.bool_false": Style(color="bright_red", italic=True), + "json.null": Style(color="magenta", italic=True), + "json.number": Style(color="cyan", bold=True, italic=False), + "json.str": Style(color="green", italic=False, bold=False), + "json.key": Style(color="blue", bold=True), + "prompt": Style.null(), + "prompt.choices": Style(color="magenta", bold=True), + "prompt.default": Style(color="cyan", bold=True), + "prompt.invalid": Style(color="red"), + "prompt.invalid.choice": Style(color="red"), + "pretty": Style.null(), + "scope.border": Style(color="blue"), + "scope.key": Style(color="yellow", italic=True), + "scope.key.special": Style(color="yellow", italic=True, dim=True), + "scope.equals": Style(color="red"), + "table.header": Style(bold=True), + "table.footer": Style(bold=True), + "table.cell": Style.null(), + "table.title": Style(italic=True), + "table.caption": Style(italic=True, dim=True), + "traceback.error": Style(color="red", italic=True), + "traceback.border.syntax_error": Style(color="bright_red"), + "traceback.border": Style(color="red"), + "traceback.text": Style.null(), + "traceback.title": Style(color="red", bold=True), + "traceback.exc_type": Style(color="bright_red", bold=True), + "traceback.exc_value": Style.null(), + "traceback.offset": Style(color="bright_red", bold=True), + "bar.back": Style(color="grey23"), + "bar.complete": Style(color="rgb(249,38,114)"), + "bar.finished": Style(color="rgb(114,156,31)"), + "bar.pulse": Style(color="rgb(249,38,114)"), + "progress.description": Style.null(), + "progress.filesize": Style(color="green"), + "progress.filesize.total": Style(color="green"), + "progress.download": Style(color="green"), + "progress.elapsed": Style(color="yellow"), + "progress.percentage": Style(color="magenta"), + "progress.remaining": Style(color="cyan"), + "progress.data.speed": Style(color="red"), + "progress.spinner": Style(color="green"), + "status.spinner": Style(color="green"), + "tree": Style(), + "tree.line": Style(), + "markdown.paragraph": Style(), + "markdown.text": Style(), + "markdown.em": Style(italic=True), + "markdown.emph": Style(italic=True), # For commonmark backwards compatibility + "markdown.strong": Style(bold=True), + "markdown.code": Style(bold=True, color="cyan", bgcolor="black"), + "markdown.code_block": Style(color="cyan", bgcolor="black"), + "markdown.block_quote": Style(color="magenta"), + "markdown.list": Style(color="cyan"), + "markdown.item": Style(), + "markdown.item.bullet": Style(color="yellow", bold=True), + "markdown.item.number": Style(color="yellow", bold=True), + "markdown.hr": Style(color="yellow"), + "markdown.h1.border": Style(), + "markdown.h1": Style(bold=True), + "markdown.h2": Style(bold=True, underline=True), + "markdown.h3": Style(bold=True), + "markdown.h4": Style(bold=True, dim=True), + "markdown.h5": Style(underline=True), + "markdown.h6": Style(italic=True), + "markdown.h7": Style(italic=True, dim=True), + "markdown.link": Style(color="bright_blue"), + "markdown.link_url": Style(color="blue", underline=True), + "markdown.s": Style(strike=True), + "iso8601.date": Style(color="blue"), + "iso8601.time": Style(color="magenta"), + "iso8601.timezone": Style(color="yellow"), +} + + +if __name__ == "__main__": # pragma: no cover + import argparse + import io + + from pip._vendor.rich.console import Console + from pip._vendor.rich.table import Table + from pip._vendor.rich.text import Text + + parser = argparse.ArgumentParser() + parser.add_argument("--html", action="store_true", help="Export as HTML table") + args = parser.parse_args() + html: bool = args.html + console = Console(record=True, width=70, file=io.StringIO()) if html else Console() + + table = Table("Name", "Styling") + + for style_name, style in DEFAULT_STYLES.items(): + table.add_row(Text(style_name, style=style), str(style)) + + console.print(table) + if html: + print(console.export_html(inline_styles=True)) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/diagnose.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/diagnose.py new file mode 100644 index 0000000..ad36183 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/diagnose.py @@ -0,0 +1,37 @@ +import os +import platform + +from pip._vendor.rich import inspect +from pip._vendor.rich.console import Console, get_windows_console_features +from pip._vendor.rich.panel import Panel +from pip._vendor.rich.pretty import Pretty + + +def report() -> None: # pragma: no cover + """Print a report to the terminal with debugging information""" + console = Console() + inspect(console) + features = get_windows_console_features() + inspect(features) + + env_names = ( + "TERM", + "COLORTERM", + "CLICOLOR", + "NO_COLOR", + "TERM_PROGRAM", + "COLUMNS", + "LINES", + "JUPYTER_COLUMNS", + "JUPYTER_LINES", + "JPY_PARENT_PID", + "VSCODE_VERBOSE_LOGGING", + ) + env = {name: os.getenv(name) for name in env_names} + console.print(Panel.fit((Pretty(env)), title="[b]Environment Variables")) + + console.print(f'platform="{platform.system()}"') + + +if __name__ == "__main__": # pragma: no cover + report() diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/emoji.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/emoji.py new file mode 100644 index 0000000..791f046 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/emoji.py @@ -0,0 +1,96 @@ +import sys +from typing import TYPE_CHECKING, Optional, Union + +from .jupyter import JupyterMixin +from .segment import Segment +from .style import Style +from ._emoji_codes import EMOJI +from ._emoji_replace import _emoji_replace + +if sys.version_info >= (3, 8): + from typing import Literal +else: + from pip._vendor.typing_extensions import Literal # pragma: no cover + + +if TYPE_CHECKING: + from .console import Console, ConsoleOptions, RenderResult + + +EmojiVariant = Literal["emoji", "text"] + + +class NoEmoji(Exception): + """No emoji by that name.""" + + +class Emoji(JupyterMixin): + __slots__ = ["name", "style", "_char", "variant"] + + VARIANTS = {"text": "\uFE0E", "emoji": "\uFE0F"} + + def __init__( + self, + name: str, + style: Union[str, Style] = "none", + variant: Optional[EmojiVariant] = None, + ) -> None: + """A single emoji character. + + Args: + name (str): Name of emoji. + style (Union[str, Style], optional): Optional style. Defaults to None. + + Raises: + NoEmoji: If the emoji doesn't exist. + """ + self.name = name + self.style = style + self.variant = variant + try: + self._char = EMOJI[name] + except KeyError: + raise NoEmoji(f"No emoji called {name!r}") + if variant is not None: + self._char += self.VARIANTS.get(variant, "") + + @classmethod + def replace(cls, text: str) -> str: + """Replace emoji markup with corresponding unicode characters. + + Args: + text (str): A string with emojis codes, e.g. "Hello :smiley:!" + + Returns: + str: A string with emoji codes replaces with actual emoji. + """ + return _emoji_replace(text) + + def __repr__(self) -> str: + return f"" + + def __str__(self) -> str: + return self._char + + def __rich_console__( + self, console: "Console", options: "ConsoleOptions" + ) -> "RenderResult": + yield Segment(self._char, console.get_style(self.style)) + + +if __name__ == "__main__": # pragma: no cover + import sys + + from pip._vendor.rich.columns import Columns + from pip._vendor.rich.console import Console + + console = Console(record=True) + + columns = Columns( + (f":{name}: {name}" for name in sorted(EMOJI.keys()) if "\u200D" not in name), + column_first=True, + ) + + console.print(columns) + if len(sys.argv) > 1: + console.save_html(sys.argv[1]) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/errors.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/errors.py new file mode 100644 index 0000000..0bcbe53 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/errors.py @@ -0,0 +1,34 @@ +class ConsoleError(Exception): + """An error in console operation.""" + + +class StyleError(Exception): + """An error in styles.""" + + +class StyleSyntaxError(ConsoleError): + """Style was badly formatted.""" + + +class MissingStyle(StyleError): + """No such style.""" + + +class StyleStackError(ConsoleError): + """Style stack is invalid.""" + + +class NotRenderableError(ConsoleError): + """Object is not renderable.""" + + +class MarkupError(ConsoleError): + """Markup was badly formatted.""" + + +class LiveError(ConsoleError): + """Error related to Live display.""" + + +class NoAltScreen(ConsoleError): + """Alt screen mode was required.""" diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/file_proxy.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/file_proxy.py new file mode 100644 index 0000000..4b0b0da --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/file_proxy.py @@ -0,0 +1,57 @@ +import io +from typing import IO, TYPE_CHECKING, Any, List + +from .ansi import AnsiDecoder +from .text import Text + +if TYPE_CHECKING: + from .console import Console + + +class FileProxy(io.TextIOBase): + """Wraps a file (e.g. sys.stdout) and redirects writes to a console.""" + + def __init__(self, console: "Console", file: IO[str]) -> None: + self.__console = console + self.__file = file + self.__buffer: List[str] = [] + self.__ansi_decoder = AnsiDecoder() + + @property + def rich_proxied_file(self) -> IO[str]: + """Get proxied file.""" + return self.__file + + def __getattr__(self, name: str) -> Any: + return getattr(self.__file, name) + + def write(self, text: str) -> int: + if not isinstance(text, str): + raise TypeError(f"write() argument must be str, not {type(text).__name__}") + buffer = self.__buffer + lines: List[str] = [] + while text: + line, new_line, text = text.partition("\n") + if new_line: + lines.append("".join(buffer) + line) + buffer.clear() + else: + buffer.append(line) + break + if lines: + console = self.__console + with console: + output = Text("\n").join( + self.__ansi_decoder.decode_line(line) for line in lines + ) + console.print(output) + return len(text) + + def flush(self) -> None: + output = "".join(self.__buffer) + if output: + self.__console.print(output) + del self.__buffer[:] + + def fileno(self) -> int: + return self.__file.fileno() diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/filesize.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/filesize.py new file mode 100644 index 0000000..99f118e --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/filesize.py @@ -0,0 +1,89 @@ +# coding: utf-8 +"""Functions for reporting filesizes. Borrowed from https://github.com/PyFilesystem/pyfilesystem2 + +The functions declared in this module should cover the different +use cases needed to generate a string representation of a file size +using several different units. Since there are many standards regarding +file size units, three different functions have been implemented. + +See Also: + * `Wikipedia: Binary prefix `_ + +""" + +__all__ = ["decimal"] + +from typing import Iterable, List, Optional, Tuple + + +def _to_str( + size: int, + suffixes: Iterable[str], + base: int, + *, + precision: Optional[int] = 1, + separator: Optional[str] = " ", +) -> str: + if size == 1: + return "1 byte" + elif size < base: + return "{:,} bytes".format(size) + + for i, suffix in enumerate(suffixes, 2): # noqa: B007 + unit = base**i + if size < unit: + break + return "{:,.{precision}f}{separator}{}".format( + (base * size / unit), + suffix, + precision=precision, + separator=separator, + ) + + +def pick_unit_and_suffix(size: int, suffixes: List[str], base: int) -> Tuple[int, str]: + """Pick a suffix and base for the given size.""" + for i, suffix in enumerate(suffixes): + unit = base**i + if size < unit * base: + break + return unit, suffix + + +def decimal( + size: int, + *, + precision: Optional[int] = 1, + separator: Optional[str] = " ", +) -> str: + """Convert a filesize in to a string (powers of 1000, SI prefixes). + + In this convention, ``1000 B = 1 kB``. + + This is typically the format used to advertise the storage + capacity of USB flash drives and the like (*256 MB* meaning + actually a storage capacity of more than *256 000 000 B*), + or used by **Mac OS X** since v10.6 to report file sizes. + + Arguments: + int (size): A file size. + int (precision): The number of decimal places to include (default = 1). + str (separator): The string to separate the value from the units (default = " "). + + Returns: + `str`: A string containing a abbreviated file size and units. + + Example: + >>> filesize.decimal(30000) + '30.0 kB' + >>> filesize.decimal(30000, precision=2, separator="") + '30.00kB' + + """ + return _to_str( + size, + ("kB", "MB", "GB", "TB", "PB", "EB", "ZB", "YB"), + 1000, + precision=precision, + separator=separator, + ) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/highlighter.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/highlighter.py new file mode 100644 index 0000000..27714b2 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/highlighter.py @@ -0,0 +1,232 @@ +import re +from abc import ABC, abstractmethod +from typing import List, Union + +from .text import Span, Text + + +def _combine_regex(*regexes: str) -> str: + """Combine a number of regexes in to a single regex. + + Returns: + str: New regex with all regexes ORed together. + """ + return "|".join(regexes) + + +class Highlighter(ABC): + """Abstract base class for highlighters.""" + + def __call__(self, text: Union[str, Text]) -> Text: + """Highlight a str or Text instance. + + Args: + text (Union[str, ~Text]): Text to highlight. + + Raises: + TypeError: If not called with text or str. + + Returns: + Text: A test instance with highlighting applied. + """ + if isinstance(text, str): + highlight_text = Text(text) + elif isinstance(text, Text): + highlight_text = text.copy() + else: + raise TypeError(f"str or Text instance required, not {text!r}") + self.highlight(highlight_text) + return highlight_text + + @abstractmethod + def highlight(self, text: Text) -> None: + """Apply highlighting in place to text. + + Args: + text (~Text): A text object highlight. + """ + + +class NullHighlighter(Highlighter): + """A highlighter object that doesn't highlight. + + May be used to disable highlighting entirely. + + """ + + def highlight(self, text: Text) -> None: + """Nothing to do""" + + +class RegexHighlighter(Highlighter): + """Applies highlighting from a list of regular expressions.""" + + highlights: List[str] = [] + base_style: str = "" + + def highlight(self, text: Text) -> None: + """Highlight :class:`rich.text.Text` using regular expressions. + + Args: + text (~Text): Text to highlighted. + + """ + + highlight_regex = text.highlight_regex + for re_highlight in self.highlights: + highlight_regex(re_highlight, style_prefix=self.base_style) + + +class ReprHighlighter(RegexHighlighter): + """Highlights the text typically produced from ``__repr__`` methods.""" + + base_style = "repr." + highlights = [ + r"(?P<)(?P[-\w.:|]*)(?P[\w\W]*)(?P>)", + r'(?P[\w_]{1,50})=(?P"?[\w_]+"?)?', + r"(?P[][{}()])", + _combine_regex( + r"(?P[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3})", + r"(?P([A-Fa-f0-9]{1,4}::?){1,7}[A-Fa-f0-9]{1,4})", + r"(?P(?:[0-9A-Fa-f]{1,2}-){7}[0-9A-Fa-f]{1,2}|(?:[0-9A-Fa-f]{1,2}:){7}[0-9A-Fa-f]{1,2}|(?:[0-9A-Fa-f]{4}\.){3}[0-9A-Fa-f]{4})", + r"(?P(?:[0-9A-Fa-f]{1,2}-){5}[0-9A-Fa-f]{1,2}|(?:[0-9A-Fa-f]{1,2}:){5}[0-9A-Fa-f]{1,2}|(?:[0-9A-Fa-f]{4}\.){2}[0-9A-Fa-f]{4})", + r"(?P[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12})", + r"(?P[\w.]*?)\(", + r"\b(?PTrue)\b|\b(?PFalse)\b|\b(?PNone)\b", + r"(?P\.\.\.)", + r"(?P(?(?\B(/[-\w._+]+)*\/)(?P[-\w._+]*)?", + r"(?b?'''.*?(?(file|https|http|ws|wss)://[-0-9a-zA-Z$_+!`(),.?/;:&=%#~]*)", + ), + ] + + +class JSONHighlighter(RegexHighlighter): + """Highlights JSON""" + + # Captures the start and end of JSON strings, handling escaped quotes + JSON_STR = r"(?b?\".*?(?[\{\[\(\)\]\}])", + r"\b(?Ptrue)\b|\b(?Pfalse)\b|\b(?Pnull)\b", + r"(?P(? None: + super().highlight(text) + + # Additional work to handle highlighting JSON keys + plain = text.plain + append = text.spans.append + whitespace = self.JSON_WHITESPACE + for match in re.finditer(self.JSON_STR, plain): + start, end = match.span() + cursor = end + while cursor < len(plain): + char = plain[cursor] + cursor += 1 + if char == ":": + append(Span(start, end, "json.key")) + elif char in whitespace: + continue + break + + +class ISO8601Highlighter(RegexHighlighter): + """Highlights the ISO8601 date time strings. + Regex reference: https://www.oreilly.com/library/view/regular-expressions-cookbook/9781449327453/ch04s07.html + """ + + base_style = "iso8601." + highlights = [ + # + # Dates + # + # Calendar month (e.g. 2008-08). The hyphen is required + r"^(?P[0-9]{4})-(?P1[0-2]|0[1-9])$", + # Calendar date w/o hyphens (e.g. 20080830) + r"^(?P(?P[0-9]{4})(?P1[0-2]|0[1-9])(?P3[01]|0[1-9]|[12][0-9]))$", + # Ordinal date (e.g. 2008-243). The hyphen is optional + r"^(?P(?P[0-9]{4})-?(?P36[0-6]|3[0-5][0-9]|[12][0-9]{2}|0[1-9][0-9]|00[1-9]))$", + # + # Weeks + # + # Week of the year (e.g., 2008-W35). The hyphen is optional + r"^(?P(?P[0-9]{4})-?W(?P5[0-3]|[1-4][0-9]|0[1-9]))$", + # Week date (e.g., 2008-W35-6). The hyphens are optional + r"^(?P(?P[0-9]{4})-?W(?P5[0-3]|[1-4][0-9]|0[1-9])-?(?P[1-7]))$", + # + # Times + # + # Hours and minutes (e.g., 17:21). The colon is optional + r"^(?P
{text}' + append_fragment(text) + + code = "".join(fragments) + html = JUPYTER_HTML_FORMAT.format(code=code) + + return html + + +def display(segments: Iterable[Segment], text: str) -> None: + """Render segments to Jupyter.""" + html = _render_segments(segments) + jupyter_renderable = JupyterRenderable(html, text) + try: + from IPython.display import display as ipython_display + + ipython_display(jupyter_renderable) + except ModuleNotFoundError: + # Handle the case where the Console has force_jupyter=True, + # but IPython is not installed. + pass + + +def print(*args: Any, **kwargs: Any) -> None: + """Proxy for Console print.""" + console = get_console() + return console.print(*args, **kwargs) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/layout.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/layout.py new file mode 100644 index 0000000..a6f1a31 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/layout.py @@ -0,0 +1,442 @@ +from abc import ABC, abstractmethod +from itertools import islice +from operator import itemgetter +from threading import RLock +from typing import ( + TYPE_CHECKING, + Dict, + Iterable, + List, + NamedTuple, + Optional, + Sequence, + Tuple, + Union, +) + +from ._ratio import ratio_resolve +from .align import Align +from .console import Console, ConsoleOptions, RenderableType, RenderResult +from .highlighter import ReprHighlighter +from .panel import Panel +from .pretty import Pretty +from .region import Region +from .repr import Result, rich_repr +from .segment import Segment +from .style import StyleType + +if TYPE_CHECKING: + from pip._vendor.rich.tree import Tree + + +class LayoutRender(NamedTuple): + """An individual layout render.""" + + region: Region + render: List[List[Segment]] + + +RegionMap = Dict["Layout", Region] +RenderMap = Dict["Layout", LayoutRender] + + +class LayoutError(Exception): + """Layout related error.""" + + +class NoSplitter(LayoutError): + """Requested splitter does not exist.""" + + +class _Placeholder: + """An internal renderable used as a Layout placeholder.""" + + highlighter = ReprHighlighter() + + def __init__(self, layout: "Layout", style: StyleType = "") -> None: + self.layout = layout + self.style = style + + def __rich_console__( + self, console: Console, options: ConsoleOptions + ) -> RenderResult: + width = options.max_width + height = options.height or options.size.height + layout = self.layout + title = ( + f"{layout.name!r} ({width} x {height})" + if layout.name + else f"({width} x {height})" + ) + yield Panel( + Align.center(Pretty(layout), vertical="middle"), + style=self.style, + title=self.highlighter(title), + border_style="blue", + height=height, + ) + + +class Splitter(ABC): + """Base class for a splitter.""" + + name: str = "" + + @abstractmethod + def get_tree_icon(self) -> str: + """Get the icon (emoji) used in layout.tree""" + + @abstractmethod + def divide( + self, children: Sequence["Layout"], region: Region + ) -> Iterable[Tuple["Layout", Region]]: + """Divide a region amongst several child layouts. + + Args: + children (Sequence(Layout)): A number of child layouts. + region (Region): A rectangular region to divide. + """ + + +class RowSplitter(Splitter): + """Split a layout region in to rows.""" + + name = "row" + + def get_tree_icon(self) -> str: + return "[layout.tree.row]⬌" + + def divide( + self, children: Sequence["Layout"], region: Region + ) -> Iterable[Tuple["Layout", Region]]: + x, y, width, height = region + render_widths = ratio_resolve(width, children) + offset = 0 + _Region = Region + for child, child_width in zip(children, render_widths): + yield child, _Region(x + offset, y, child_width, height) + offset += child_width + + +class ColumnSplitter(Splitter): + """Split a layout region in to columns.""" + + name = "column" + + def get_tree_icon(self) -> str: + return "[layout.tree.column]⬍" + + def divide( + self, children: Sequence["Layout"], region: Region + ) -> Iterable[Tuple["Layout", Region]]: + x, y, width, height = region + render_heights = ratio_resolve(height, children) + offset = 0 + _Region = Region + for child, child_height in zip(children, render_heights): + yield child, _Region(x, y + offset, width, child_height) + offset += child_height + + +@rich_repr +class Layout: + """A renderable to divide a fixed height in to rows or columns. + + Args: + renderable (RenderableType, optional): Renderable content, or None for placeholder. Defaults to None. + name (str, optional): Optional identifier for Layout. Defaults to None. + size (int, optional): Optional fixed size of layout. Defaults to None. + minimum_size (int, optional): Minimum size of layout. Defaults to 1. + ratio (int, optional): Optional ratio for flexible layout. Defaults to 1. + visible (bool, optional): Visibility of layout. Defaults to True. + """ + + splitters = {"row": RowSplitter, "column": ColumnSplitter} + + def __init__( + self, + renderable: Optional[RenderableType] = None, + *, + name: Optional[str] = None, + size: Optional[int] = None, + minimum_size: int = 1, + ratio: int = 1, + visible: bool = True, + ) -> None: + self._renderable = renderable or _Placeholder(self) + self.size = size + self.minimum_size = minimum_size + self.ratio = ratio + self.name = name + self.visible = visible + self.splitter: Splitter = self.splitters["column"]() + self._children: List[Layout] = [] + self._render_map: RenderMap = {} + self._lock = RLock() + + def __rich_repr__(self) -> Result: + yield "name", self.name, None + yield "size", self.size, None + yield "minimum_size", self.minimum_size, 1 + yield "ratio", self.ratio, 1 + + @property + def renderable(self) -> RenderableType: + """Layout renderable.""" + return self if self._children else self._renderable + + @property + def children(self) -> List["Layout"]: + """Gets (visible) layout children.""" + return [child for child in self._children if child.visible] + + @property + def map(self) -> RenderMap: + """Get a map of the last render.""" + return self._render_map + + def get(self, name: str) -> Optional["Layout"]: + """Get a named layout, or None if it doesn't exist. + + Args: + name (str): Name of layout. + + Returns: + Optional[Layout]: Layout instance or None if no layout was found. + """ + if self.name == name: + return self + else: + for child in self._children: + named_layout = child.get(name) + if named_layout is not None: + return named_layout + return None + + def __getitem__(self, name: str) -> "Layout": + layout = self.get(name) + if layout is None: + raise KeyError(f"No layout with name {name!r}") + return layout + + @property + def tree(self) -> "Tree": + """Get a tree renderable to show layout structure.""" + from pip._vendor.rich.styled import Styled + from pip._vendor.rich.table import Table + from pip._vendor.rich.tree import Tree + + def summary(layout: "Layout") -> Table: + icon = layout.splitter.get_tree_icon() + + table = Table.grid(padding=(0, 1, 0, 0)) + + text: RenderableType = ( + Pretty(layout) if layout.visible else Styled(Pretty(layout), "dim") + ) + table.add_row(icon, text) + _summary = table + return _summary + + layout = self + tree = Tree( + summary(layout), + guide_style=f"layout.tree.{layout.splitter.name}", + highlight=True, + ) + + def recurse(tree: "Tree", layout: "Layout") -> None: + for child in layout._children: + recurse( + tree.add( + summary(child), + guide_style=f"layout.tree.{child.splitter.name}", + ), + child, + ) + + recurse(tree, self) + return tree + + def split( + self, + *layouts: Union["Layout", RenderableType], + splitter: Union[Splitter, str] = "column", + ) -> None: + """Split the layout in to multiple sub-layouts. + + Args: + *layouts (Layout): Positional arguments should be (sub) Layout instances. + splitter (Union[Splitter, str]): Splitter instance or name of splitter. + """ + _layouts = [ + layout if isinstance(layout, Layout) else Layout(layout) + for layout in layouts + ] + try: + self.splitter = ( + splitter + if isinstance(splitter, Splitter) + else self.splitters[splitter]() + ) + except KeyError: + raise NoSplitter(f"No splitter called {splitter!r}") + self._children[:] = _layouts + + def add_split(self, *layouts: Union["Layout", RenderableType]) -> None: + """Add a new layout(s) to existing split. + + Args: + *layouts (Union[Layout, RenderableType]): Positional arguments should be renderables or (sub) Layout instances. + + """ + _layouts = ( + layout if isinstance(layout, Layout) else Layout(layout) + for layout in layouts + ) + self._children.extend(_layouts) + + def split_row(self, *layouts: Union["Layout", RenderableType]) -> None: + """Split the layout in to a row (layouts side by side). + + Args: + *layouts (Layout): Positional arguments should be (sub) Layout instances. + """ + self.split(*layouts, splitter="row") + + def split_column(self, *layouts: Union["Layout", RenderableType]) -> None: + """Split the layout in to a column (layouts stacked on top of each other). + + Args: + *layouts (Layout): Positional arguments should be (sub) Layout instances. + """ + self.split(*layouts, splitter="column") + + def unsplit(self) -> None: + """Reset splits to initial state.""" + del self._children[:] + + def update(self, renderable: RenderableType) -> None: + """Update renderable. + + Args: + renderable (RenderableType): New renderable object. + """ + with self._lock: + self._renderable = renderable + + def refresh_screen(self, console: "Console", layout_name: str) -> None: + """Refresh a sub-layout. + + Args: + console (Console): Console instance where Layout is to be rendered. + layout_name (str): Name of layout. + """ + with self._lock: + layout = self[layout_name] + region, _lines = self._render_map[layout] + (x, y, width, height) = region + lines = console.render_lines( + layout, console.options.update_dimensions(width, height) + ) + self._render_map[layout] = LayoutRender(region, lines) + console.update_screen_lines(lines, x, y) + + def _make_region_map(self, width: int, height: int) -> RegionMap: + """Create a dict that maps layout on to Region.""" + stack: List[Tuple[Layout, Region]] = [(self, Region(0, 0, width, height))] + push = stack.append + pop = stack.pop + layout_regions: List[Tuple[Layout, Region]] = [] + append_layout_region = layout_regions.append + while stack: + append_layout_region(pop()) + layout, region = layout_regions[-1] + children = layout.children + if children: + for child_and_region in layout.splitter.divide(children, region): + push(child_and_region) + + region_map = { + layout: region + for layout, region in sorted(layout_regions, key=itemgetter(1)) + } + return region_map + + def render(self, console: Console, options: ConsoleOptions) -> RenderMap: + """Render the sub_layouts. + + Args: + console (Console): Console instance. + options (ConsoleOptions): Console options. + + Returns: + RenderMap: A dict that maps Layout on to a tuple of Region, lines + """ + render_width = options.max_width + render_height = options.height or console.height + region_map = self._make_region_map(render_width, render_height) + layout_regions = [ + (layout, region) + for layout, region in region_map.items() + if not layout.children + ] + render_map: Dict["Layout", "LayoutRender"] = {} + render_lines = console.render_lines + update_dimensions = options.update_dimensions + + for layout, region in layout_regions: + lines = render_lines( + layout.renderable, update_dimensions(region.width, region.height) + ) + render_map[layout] = LayoutRender(region, lines) + return render_map + + def __rich_console__( + self, console: Console, options: ConsoleOptions + ) -> RenderResult: + with self._lock: + width = options.max_width or console.width + height = options.height or console.height + render_map = self.render(console, options.update_dimensions(width, height)) + self._render_map = render_map + layout_lines: List[List[Segment]] = [[] for _ in range(height)] + _islice = islice + for region, lines in render_map.values(): + _x, y, _layout_width, layout_height = region + for row, line in zip( + _islice(layout_lines, y, y + layout_height), lines + ): + row.extend(line) + + new_line = Segment.line() + for layout_row in layout_lines: + yield from layout_row + yield new_line + + +if __name__ == "__main__": + from pip._vendor.rich.console import Console + + console = Console() + layout = Layout() + + layout.split_column( + Layout(name="header", size=3), + Layout(ratio=1, name="main"), + Layout(size=10, name="footer"), + ) + + layout["main"].split_row(Layout(name="side"), Layout(name="body", ratio=2)) + + layout["body"].split_row(Layout(name="content", ratio=2), Layout(name="s2")) + + layout["s2"].split_column( + Layout(name="top"), Layout(name="middle"), Layout(name="bottom") + ) + + layout["side"].split_column(Layout(layout.tree, name="left1"), Layout(name="left2")) + + layout["content"].update("foo") + + console.print(layout) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/live.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/live.py new file mode 100644 index 0000000..f0529a7 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/live.py @@ -0,0 +1,375 @@ +import sys +from threading import Event, RLock, Thread +from types import TracebackType +from typing import IO, Any, Callable, List, Optional, TextIO, Type, cast + +from . import get_console +from .console import Console, ConsoleRenderable, RenderableType, RenderHook +from .control import Control +from .file_proxy import FileProxy +from .jupyter import JupyterMixin +from .live_render import LiveRender, VerticalOverflowMethod +from .screen import Screen +from .text import Text + + +class _RefreshThread(Thread): + """A thread that calls refresh() at regular intervals.""" + + def __init__(self, live: "Live", refresh_per_second: float) -> None: + self.live = live + self.refresh_per_second = refresh_per_second + self.done = Event() + super().__init__(daemon=True) + + def stop(self) -> None: + self.done.set() + + def run(self) -> None: + while not self.done.wait(1 / self.refresh_per_second): + with self.live._lock: + if not self.done.is_set(): + self.live.refresh() + + +class Live(JupyterMixin, RenderHook): + """Renders an auto-updating live display of any given renderable. + + Args: + renderable (RenderableType, optional): The renderable to live display. Defaults to displaying nothing. + console (Console, optional): Optional Console instance. Default will an internal Console instance writing to stdout. + screen (bool, optional): Enable alternate screen mode. Defaults to False. + auto_refresh (bool, optional): Enable auto refresh. If disabled, you will need to call `refresh()` or `update()` with refresh flag. Defaults to True + refresh_per_second (float, optional): Number of times per second to refresh the live display. Defaults to 4. + transient (bool, optional): Clear the renderable on exit (has no effect when screen=True). Defaults to False. + redirect_stdout (bool, optional): Enable redirection of stdout, so ``print`` may be used. Defaults to True. + redirect_stderr (bool, optional): Enable redirection of stderr. Defaults to True. + vertical_overflow (VerticalOverflowMethod, optional): How to handle renderable when it is too tall for the console. Defaults to "ellipsis". + get_renderable (Callable[[], RenderableType], optional): Optional callable to get renderable. Defaults to None. + """ + + def __init__( + self, + renderable: Optional[RenderableType] = None, + *, + console: Optional[Console] = None, + screen: bool = False, + auto_refresh: bool = True, + refresh_per_second: float = 4, + transient: bool = False, + redirect_stdout: bool = True, + redirect_stderr: bool = True, + vertical_overflow: VerticalOverflowMethod = "ellipsis", + get_renderable: Optional[Callable[[], RenderableType]] = None, + ) -> None: + assert refresh_per_second > 0, "refresh_per_second must be > 0" + self._renderable = renderable + self.console = console if console is not None else get_console() + self._screen = screen + self._alt_screen = False + + self._redirect_stdout = redirect_stdout + self._redirect_stderr = redirect_stderr + self._restore_stdout: Optional[IO[str]] = None + self._restore_stderr: Optional[IO[str]] = None + + self._lock = RLock() + self.ipy_widget: Optional[Any] = None + self.auto_refresh = auto_refresh + self._started: bool = False + self.transient = True if screen else transient + + self._refresh_thread: Optional[_RefreshThread] = None + self.refresh_per_second = refresh_per_second + + self.vertical_overflow = vertical_overflow + self._get_renderable = get_renderable + self._live_render = LiveRender( + self.get_renderable(), vertical_overflow=vertical_overflow + ) + + @property + def is_started(self) -> bool: + """Check if live display has been started.""" + return self._started + + def get_renderable(self) -> RenderableType: + renderable = ( + self._get_renderable() + if self._get_renderable is not None + else self._renderable + ) + return renderable or "" + + def start(self, refresh: bool = False) -> None: + """Start live rendering display. + + Args: + refresh (bool, optional): Also refresh. Defaults to False. + """ + with self._lock: + if self._started: + return + self.console.set_live(self) + self._started = True + if self._screen: + self._alt_screen = self.console.set_alt_screen(True) + self.console.show_cursor(False) + self._enable_redirect_io() + self.console.push_render_hook(self) + if refresh: + try: + self.refresh() + except Exception: + # If refresh fails, we want to stop the redirection of sys.stderr, + # so the error stacktrace is properly displayed in the terminal. + # (or, if the code that calls Rich captures the exception and wants to display something, + # let this be displayed in the terminal). + self.stop() + raise + if self.auto_refresh: + self._refresh_thread = _RefreshThread(self, self.refresh_per_second) + self._refresh_thread.start() + + def stop(self) -> None: + """Stop live rendering display.""" + with self._lock: + if not self._started: + return + self.console.clear_live() + self._started = False + + if self.auto_refresh and self._refresh_thread is not None: + self._refresh_thread.stop() + self._refresh_thread = None + # allow it to fully render on the last even if overflow + self.vertical_overflow = "visible" + with self.console: + try: + if not self._alt_screen and not self.console.is_jupyter: + self.refresh() + finally: + self._disable_redirect_io() + self.console.pop_render_hook() + if not self._alt_screen and self.console.is_terminal: + self.console.line() + self.console.show_cursor(True) + if self._alt_screen: + self.console.set_alt_screen(False) + + if self.transient and not self._alt_screen: + self.console.control(self._live_render.restore_cursor()) + if self.ipy_widget is not None and self.transient: + self.ipy_widget.close() # pragma: no cover + + def __enter__(self) -> "Live": + self.start(refresh=self._renderable is not None) + return self + + def __exit__( + self, + exc_type: Optional[Type[BaseException]], + exc_val: Optional[BaseException], + exc_tb: Optional[TracebackType], + ) -> None: + self.stop() + + def _enable_redirect_io(self) -> None: + """Enable redirecting of stdout / stderr.""" + if self.console.is_terminal or self.console.is_jupyter: + if self._redirect_stdout and not isinstance(sys.stdout, FileProxy): + self._restore_stdout = sys.stdout + sys.stdout = cast("TextIO", FileProxy(self.console, sys.stdout)) + if self._redirect_stderr and not isinstance(sys.stderr, FileProxy): + self._restore_stderr = sys.stderr + sys.stderr = cast("TextIO", FileProxy(self.console, sys.stderr)) + + def _disable_redirect_io(self) -> None: + """Disable redirecting of stdout / stderr.""" + if self._restore_stdout: + sys.stdout = cast("TextIO", self._restore_stdout) + self._restore_stdout = None + if self._restore_stderr: + sys.stderr = cast("TextIO", self._restore_stderr) + self._restore_stderr = None + + @property + def renderable(self) -> RenderableType: + """Get the renderable that is being displayed + + Returns: + RenderableType: Displayed renderable. + """ + renderable = self.get_renderable() + return Screen(renderable) if self._alt_screen else renderable + + def update(self, renderable: RenderableType, *, refresh: bool = False) -> None: + """Update the renderable that is being displayed + + Args: + renderable (RenderableType): New renderable to use. + refresh (bool, optional): Refresh the display. Defaults to False. + """ + if isinstance(renderable, str): + renderable = self.console.render_str(renderable) + with self._lock: + self._renderable = renderable + if refresh: + self.refresh() + + def refresh(self) -> None: + """Update the display of the Live Render.""" + with self._lock: + self._live_render.set_renderable(self.renderable) + if self.console.is_jupyter: # pragma: no cover + try: + from IPython.display import display + from ipywidgets import Output + except ImportError: + import warnings + + warnings.warn('install "ipywidgets" for Jupyter support') + else: + if self.ipy_widget is None: + self.ipy_widget = Output() + display(self.ipy_widget) + + with self.ipy_widget: + self.ipy_widget.clear_output(wait=True) + self.console.print(self._live_render.renderable) + elif self.console.is_terminal and not self.console.is_dumb_terminal: + with self.console: + self.console.print(Control()) + elif ( + not self._started and not self.transient + ): # if it is finished allow files or dumb-terminals to see final result + with self.console: + self.console.print(Control()) + + def process_renderables( + self, renderables: List[ConsoleRenderable] + ) -> List[ConsoleRenderable]: + """Process renderables to restore cursor and display progress.""" + self._live_render.vertical_overflow = self.vertical_overflow + if self.console.is_interactive: + # lock needs acquiring as user can modify live_render renderable at any time unlike in Progress. + with self._lock: + reset = ( + Control.home() + if self._alt_screen + else self._live_render.position_cursor() + ) + renderables = [reset, *renderables, self._live_render] + elif ( + not self._started and not self.transient + ): # if it is finished render the final output for files or dumb_terminals + renderables = [*renderables, self._live_render] + + return renderables + + +if __name__ == "__main__": # pragma: no cover + import random + import time + from itertools import cycle + from typing import Dict, List, Tuple + + from .align import Align + from .console import Console + from .live import Live as Live + from .panel import Panel + from .rule import Rule + from .syntax import Syntax + from .table import Table + + console = Console() + + syntax = Syntax( + '''def loop_last(values: Iterable[T]) -> Iterable[Tuple[bool, T]]: + """Iterate and generate a tuple with a flag for last value.""" + iter_values = iter(values) + try: + previous_value = next(iter_values) + except StopIteration: + return + for value in iter_values: + yield False, previous_value + previous_value = value + yield True, previous_value''', + "python", + line_numbers=True, + ) + + table = Table("foo", "bar", "baz") + table.add_row("1", "2", "3") + + progress_renderables = [ + "You can make the terminal shorter and taller to see the live table hide" + "Text may be printed while the progress bars are rendering.", + Panel("In fact, [i]any[/i] renderable will work"), + "Such as [magenta]tables[/]...", + table, + "Pretty printed structures...", + {"type": "example", "text": "Pretty printed"}, + "Syntax...", + syntax, + Rule("Give it a try!"), + ] + + examples = cycle(progress_renderables) + + exchanges = [ + "SGD", + "MYR", + "EUR", + "USD", + "AUD", + "JPY", + "CNH", + "HKD", + "CAD", + "INR", + "DKK", + "GBP", + "RUB", + "NZD", + "MXN", + "IDR", + "TWD", + "THB", + "VND", + ] + with Live(console=console) as live_table: + exchange_rate_dict: Dict[Tuple[str, str], float] = {} + + for index in range(100): + select_exchange = exchanges[index % len(exchanges)] + + for exchange in exchanges: + if exchange == select_exchange: + continue + time.sleep(0.4) + if random.randint(0, 10) < 1: + console.log(next(examples)) + exchange_rate_dict[(select_exchange, exchange)] = 200 / ( + (random.random() * 320) + 1 + ) + if len(exchange_rate_dict) > len(exchanges) - 1: + exchange_rate_dict.pop(list(exchange_rate_dict.keys())[0]) + table = Table(title="Exchange Rates") + + table.add_column("Source Currency") + table.add_column("Destination Currency") + table.add_column("Exchange Rate") + + for (source, dest), exchange_rate in exchange_rate_dict.items(): + table.add_row( + source, + dest, + Text( + f"{exchange_rate:.4f}", + style="red" if exchange_rate < 1.0 else "green", + ), + ) + + live_table.update(Align.center(table)) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/live_render.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/live_render.py new file mode 100644 index 0000000..e20745d --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/live_render.py @@ -0,0 +1,112 @@ +import sys +from typing import Optional, Tuple + +if sys.version_info >= (3, 8): + from typing import Literal +else: + from pip._vendor.typing_extensions import Literal # pragma: no cover + + +from ._loop import loop_last +from .console import Console, ConsoleOptions, RenderableType, RenderResult +from .control import Control +from .segment import ControlType, Segment +from .style import StyleType +from .text import Text + +VerticalOverflowMethod = Literal["crop", "ellipsis", "visible"] + + +class LiveRender: + """Creates a renderable that may be updated. + + Args: + renderable (RenderableType): Any renderable object. + style (StyleType, optional): An optional style to apply to the renderable. Defaults to "". + """ + + def __init__( + self, + renderable: RenderableType, + style: StyleType = "", + vertical_overflow: VerticalOverflowMethod = "ellipsis", + ) -> None: + self.renderable = renderable + self.style = style + self.vertical_overflow = vertical_overflow + self._shape: Optional[Tuple[int, int]] = None + + def set_renderable(self, renderable: RenderableType) -> None: + """Set a new renderable. + + Args: + renderable (RenderableType): Any renderable object, including str. + """ + self.renderable = renderable + + def position_cursor(self) -> Control: + """Get control codes to move cursor to beginning of live render. + + Returns: + Control: A control instance that may be printed. + """ + if self._shape is not None: + _, height = self._shape + return Control( + ControlType.CARRIAGE_RETURN, + (ControlType.ERASE_IN_LINE, 2), + *( + ( + (ControlType.CURSOR_UP, 1), + (ControlType.ERASE_IN_LINE, 2), + ) + * (height - 1) + ) + ) + return Control() + + def restore_cursor(self) -> Control: + """Get control codes to clear the render and restore the cursor to its previous position. + + Returns: + Control: A Control instance that may be printed. + """ + if self._shape is not None: + _, height = self._shape + return Control( + ControlType.CARRIAGE_RETURN, + *((ControlType.CURSOR_UP, 1), (ControlType.ERASE_IN_LINE, 2)) * height + ) + return Control() + + def __rich_console__( + self, console: Console, options: ConsoleOptions + ) -> RenderResult: + renderable = self.renderable + style = console.get_style(self.style) + lines = console.render_lines(renderable, options, style=style, pad=False) + shape = Segment.get_shape(lines) + + _, height = shape + if height > options.size.height: + if self.vertical_overflow == "crop": + lines = lines[: options.size.height] + shape = Segment.get_shape(lines) + elif self.vertical_overflow == "ellipsis": + lines = lines[: (options.size.height - 1)] + overflow_text = Text( + "...", + overflow="crop", + justify="center", + end="", + style="live.ellipsis", + ) + lines.append(list(console.render(overflow_text))) + shape = Segment.get_shape(lines) + self._shape = shape + + new_line = Segment.line() + for last, line in loop_last(lines): + yield from line + if not last: + yield new_line diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/logging.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/logging.py new file mode 100644 index 0000000..91368dd --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/logging.py @@ -0,0 +1,289 @@ +import logging +from datetime import datetime +from logging import Handler, LogRecord +from pathlib import Path +from types import ModuleType +from typing import ClassVar, Iterable, List, Optional, Type, Union + +from pip._vendor.rich._null_file import NullFile + +from . import get_console +from ._log_render import FormatTimeCallable, LogRender +from .console import Console, ConsoleRenderable +from .highlighter import Highlighter, ReprHighlighter +from .text import Text +from .traceback import Traceback + + +class RichHandler(Handler): + """A logging handler that renders output with Rich. The time / level / message and file are displayed in columns. + The level is color coded, and the message is syntax highlighted. + + Note: + Be careful when enabling console markup in log messages if you have configured logging for libraries not + under your control. If a dependency writes messages containing square brackets, it may not produce the intended output. + + Args: + level (Union[int, str], optional): Log level. Defaults to logging.NOTSET. + console (:class:`~rich.console.Console`, optional): Optional console instance to write logs. + Default will use a global console instance writing to stdout. + show_time (bool, optional): Show a column for the time. Defaults to True. + omit_repeated_times (bool, optional): Omit repetition of the same time. Defaults to True. + show_level (bool, optional): Show a column for the level. Defaults to True. + show_path (bool, optional): Show the path to the original log call. Defaults to True. + enable_link_path (bool, optional): Enable terminal link of path column to file. Defaults to True. + highlighter (Highlighter, optional): Highlighter to style log messages, or None to use ReprHighlighter. Defaults to None. + markup (bool, optional): Enable console markup in log messages. Defaults to False. + rich_tracebacks (bool, optional): Enable rich tracebacks with syntax highlighting and formatting. Defaults to False. + tracebacks_width (Optional[int], optional): Number of characters used to render tracebacks, or None for full width. Defaults to None. + tracebacks_extra_lines (int, optional): Additional lines of code to render tracebacks, or None for full width. Defaults to None. + tracebacks_theme (str, optional): Override pygments theme used in traceback. + tracebacks_word_wrap (bool, optional): Enable word wrapping of long tracebacks lines. Defaults to True. + tracebacks_show_locals (bool, optional): Enable display of locals in tracebacks. Defaults to False. + tracebacks_suppress (Sequence[Union[str, ModuleType]]): Optional sequence of modules or paths to exclude from traceback. + locals_max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation. + Defaults to 10. + locals_max_string (int, optional): Maximum length of string before truncating, or None to disable. Defaults to 80. + log_time_format (Union[str, TimeFormatterCallable], optional): If ``log_time`` is enabled, either string for strftime or callable that formats the time. Defaults to "[%x %X] ". + keywords (List[str], optional): List of words to highlight instead of ``RichHandler.KEYWORDS``. + """ + + KEYWORDS: ClassVar[Optional[List[str]]] = [ + "GET", + "POST", + "HEAD", + "PUT", + "DELETE", + "OPTIONS", + "TRACE", + "PATCH", + ] + HIGHLIGHTER_CLASS: ClassVar[Type[Highlighter]] = ReprHighlighter + + def __init__( + self, + level: Union[int, str] = logging.NOTSET, + console: Optional[Console] = None, + *, + show_time: bool = True, + omit_repeated_times: bool = True, + show_level: bool = True, + show_path: bool = True, + enable_link_path: bool = True, + highlighter: Optional[Highlighter] = None, + markup: bool = False, + rich_tracebacks: bool = False, + tracebacks_width: Optional[int] = None, + tracebacks_extra_lines: int = 3, + tracebacks_theme: Optional[str] = None, + tracebacks_word_wrap: bool = True, + tracebacks_show_locals: bool = False, + tracebacks_suppress: Iterable[Union[str, ModuleType]] = (), + locals_max_length: int = 10, + locals_max_string: int = 80, + log_time_format: Union[str, FormatTimeCallable] = "[%x %X]", + keywords: Optional[List[str]] = None, + ) -> None: + super().__init__(level=level) + self.console = console or get_console() + self.highlighter = highlighter or self.HIGHLIGHTER_CLASS() + self._log_render = LogRender( + show_time=show_time, + show_level=show_level, + show_path=show_path, + time_format=log_time_format, + omit_repeated_times=omit_repeated_times, + level_width=None, + ) + self.enable_link_path = enable_link_path + self.markup = markup + self.rich_tracebacks = rich_tracebacks + self.tracebacks_width = tracebacks_width + self.tracebacks_extra_lines = tracebacks_extra_lines + self.tracebacks_theme = tracebacks_theme + self.tracebacks_word_wrap = tracebacks_word_wrap + self.tracebacks_show_locals = tracebacks_show_locals + self.tracebacks_suppress = tracebacks_suppress + self.locals_max_length = locals_max_length + self.locals_max_string = locals_max_string + self.keywords = keywords + + def get_level_text(self, record: LogRecord) -> Text: + """Get the level name from the record. + + Args: + record (LogRecord): LogRecord instance. + + Returns: + Text: A tuple of the style and level name. + """ + level_name = record.levelname + level_text = Text.styled( + level_name.ljust(8), f"logging.level.{level_name.lower()}" + ) + return level_text + + def emit(self, record: LogRecord) -> None: + """Invoked by logging.""" + message = self.format(record) + traceback = None + if ( + self.rich_tracebacks + and record.exc_info + and record.exc_info != (None, None, None) + ): + exc_type, exc_value, exc_traceback = record.exc_info + assert exc_type is not None + assert exc_value is not None + traceback = Traceback.from_exception( + exc_type, + exc_value, + exc_traceback, + width=self.tracebacks_width, + extra_lines=self.tracebacks_extra_lines, + theme=self.tracebacks_theme, + word_wrap=self.tracebacks_word_wrap, + show_locals=self.tracebacks_show_locals, + locals_max_length=self.locals_max_length, + locals_max_string=self.locals_max_string, + suppress=self.tracebacks_suppress, + ) + message = record.getMessage() + if self.formatter: + record.message = record.getMessage() + formatter = self.formatter + if hasattr(formatter, "usesTime") and formatter.usesTime(): + record.asctime = formatter.formatTime(record, formatter.datefmt) + message = formatter.formatMessage(record) + + message_renderable = self.render_message(record, message) + log_renderable = self.render( + record=record, traceback=traceback, message_renderable=message_renderable + ) + if isinstance(self.console.file, NullFile): + # Handles pythonw, where stdout/stderr are null, and we return NullFile + # instance from Console.file. In this case, we still want to make a log record + # even though we won't be writing anything to a file. + self.handleError(record) + else: + try: + self.console.print(log_renderable) + except Exception: + self.handleError(record) + + def render_message(self, record: LogRecord, message: str) -> "ConsoleRenderable": + """Render message text in to Text. + + Args: + record (LogRecord): logging Record. + message (str): String containing log message. + + Returns: + ConsoleRenderable: Renderable to display log message. + """ + use_markup = getattr(record, "markup", self.markup) + message_text = Text.from_markup(message) if use_markup else Text(message) + + highlighter = getattr(record, "highlighter", self.highlighter) + if highlighter: + message_text = highlighter(message_text) + + if self.keywords is None: + self.keywords = self.KEYWORDS + + if self.keywords: + message_text.highlight_words(self.keywords, "logging.keyword") + + return message_text + + def render( + self, + *, + record: LogRecord, + traceback: Optional[Traceback], + message_renderable: "ConsoleRenderable", + ) -> "ConsoleRenderable": + """Render log for display. + + Args: + record (LogRecord): logging Record. + traceback (Optional[Traceback]): Traceback instance or None for no Traceback. + message_renderable (ConsoleRenderable): Renderable (typically Text) containing log message contents. + + Returns: + ConsoleRenderable: Renderable to display log. + """ + path = Path(record.pathname).name + level = self.get_level_text(record) + time_format = None if self.formatter is None else self.formatter.datefmt + log_time = datetime.fromtimestamp(record.created) + + log_renderable = self._log_render( + self.console, + [message_renderable] if not traceback else [message_renderable, traceback], + log_time=log_time, + time_format=time_format, + level=level, + path=path, + line_no=record.lineno, + link_path=record.pathname if self.enable_link_path else None, + ) + return log_renderable + + +if __name__ == "__main__": # pragma: no cover + from time import sleep + + FORMAT = "%(message)s" + # FORMAT = "%(asctime)-15s - %(levelname)s - %(message)s" + logging.basicConfig( + level="NOTSET", + format=FORMAT, + datefmt="[%X]", + handlers=[RichHandler(rich_tracebacks=True, tracebacks_show_locals=True)], + ) + log = logging.getLogger("rich") + + log.info("Server starting...") + log.info("Listening on http://127.0.0.1:8080") + sleep(1) + + log.info("GET /index.html 200 1298") + log.info("GET /imgs/backgrounds/back1.jpg 200 54386") + log.info("GET /css/styles.css 200 54386") + log.warning("GET /favicon.ico 404 242") + sleep(1) + + log.debug( + "JSONRPC request\n--> %r\n<-- %r", + { + "version": "1.1", + "method": "confirmFruitPurchase", + "params": [["apple", "orange", "mangoes", "pomelo"], 1.123], + "id": "194521489", + }, + {"version": "1.1", "result": True, "error": None, "id": "194521489"}, + ) + log.debug( + "Loading configuration file /adasd/asdasd/qeqwe/qwrqwrqwr/sdgsdgsdg/werwerwer/dfgerert/ertertert/ertetert/werwerwer" + ) + log.error("Unable to find 'pomelo' in database!") + log.info("POST /jsonrpc/ 200 65532") + log.info("POST /admin/ 401 42234") + log.warning("password was rejected for admin site.") + + def divide() -> None: + number = 1 + divisor = 0 + foos = ["foo"] * 100 + log.debug("in divide") + try: + number / divisor + except: + log.exception("An error of some kind occurred!") + + divide() + sleep(1) + log.critical("Out of memory!") + log.info("Server exited with code=-1") + log.info("[bold]EXITING...[/bold]", extra=dict(markup=True)) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/markup.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/markup.py new file mode 100644 index 0000000..f617187 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/markup.py @@ -0,0 +1,251 @@ +import re +from ast import literal_eval +from operator import attrgetter +from typing import Callable, Iterable, List, Match, NamedTuple, Optional, Tuple, Union + +from ._emoji_replace import _emoji_replace +from .emoji import EmojiVariant +from .errors import MarkupError +from .style import Style +from .text import Span, Text + +RE_TAGS = re.compile( + r"""((\\*)\[([a-z#/@][^[]*?)])""", + re.VERBOSE, +) + +RE_HANDLER = re.compile(r"^([\w.]*?)(\(.*?\))?$") + + +class Tag(NamedTuple): + """A tag in console markup.""" + + name: str + """The tag name. e.g. 'bold'.""" + parameters: Optional[str] + """Any additional parameters after the name.""" + + def __str__(self) -> str: + return ( + self.name if self.parameters is None else f"{self.name} {self.parameters}" + ) + + @property + def markup(self) -> str: + """Get the string representation of this tag.""" + return ( + f"[{self.name}]" + if self.parameters is None + else f"[{self.name}={self.parameters}]" + ) + + +_ReStringMatch = Match[str] # regex match object +_ReSubCallable = Callable[[_ReStringMatch], str] # Callable invoked by re.sub +_EscapeSubMethod = Callable[[_ReSubCallable, str], str] # Sub method of a compiled re + + +def escape( + markup: str, + _escape: _EscapeSubMethod = re.compile(r"(\\*)(\[[a-z#/@][^[]*?])").sub, +) -> str: + """Escapes text so that it won't be interpreted as markup. + + Args: + markup (str): Content to be inserted in to markup. + + Returns: + str: Markup with square brackets escaped. + """ + + def escape_backslashes(match: Match[str]) -> str: + """Called by re.sub replace matches.""" + backslashes, text = match.groups() + return f"{backslashes}{backslashes}\\{text}" + + markup = _escape(escape_backslashes, markup) + if markup.endswith("\\") and not markup.endswith("\\\\"): + return markup + "\\" + + return markup + + +def _parse(markup: str) -> Iterable[Tuple[int, Optional[str], Optional[Tag]]]: + """Parse markup in to an iterable of tuples of (position, text, tag). + + Args: + markup (str): A string containing console markup + + """ + position = 0 + _divmod = divmod + _Tag = Tag + for match in RE_TAGS.finditer(markup): + full_text, escapes, tag_text = match.groups() + start, end = match.span() + if start > position: + yield start, markup[position:start], None + if escapes: + backslashes, escaped = _divmod(len(escapes), 2) + if backslashes: + # Literal backslashes + yield start, "\\" * backslashes, None + start += backslashes * 2 + if escaped: + # Escape of tag + yield start, full_text[len(escapes) :], None + position = end + continue + text, equals, parameters = tag_text.partition("=") + yield start, None, _Tag(text, parameters if equals else None) + position = end + if position < len(markup): + yield position, markup[position:], None + + +def render( + markup: str, + style: Union[str, Style] = "", + emoji: bool = True, + emoji_variant: Optional[EmojiVariant] = None, +) -> Text: + """Render console markup in to a Text instance. + + Args: + markup (str): A string containing console markup. + style: (Union[str, Style]): The style to use. + emoji (bool, optional): Also render emoji code. Defaults to True. + emoji_variant (str, optional): Optional emoji variant, either "text" or "emoji". Defaults to None. + + + Raises: + MarkupError: If there is a syntax error in the markup. + + Returns: + Text: A test instance. + """ + emoji_replace = _emoji_replace + if "[" not in markup: + return Text( + emoji_replace(markup, default_variant=emoji_variant) if emoji else markup, + style=style, + ) + text = Text(style=style) + append = text.append + normalize = Style.normalize + + style_stack: List[Tuple[int, Tag]] = [] + pop = style_stack.pop + + spans: List[Span] = [] + append_span = spans.append + + _Span = Span + _Tag = Tag + + def pop_style(style_name: str) -> Tuple[int, Tag]: + """Pop tag matching given style name.""" + for index, (_, tag) in enumerate(reversed(style_stack), 1): + if tag.name == style_name: + return pop(-index) + raise KeyError(style_name) + + for position, plain_text, tag in _parse(markup): + if plain_text is not None: + # Handle open brace escapes, where the brace is not part of a tag. + plain_text = plain_text.replace("\\[", "[") + append(emoji_replace(plain_text) if emoji else plain_text) + elif tag is not None: + if tag.name.startswith("/"): # Closing tag + style_name = tag.name[1:].strip() + + if style_name: # explicit close + style_name = normalize(style_name) + try: + start, open_tag = pop_style(style_name) + except KeyError: + raise MarkupError( + f"closing tag '{tag.markup}' at position {position} doesn't match any open tag" + ) from None + else: # implicit close + try: + start, open_tag = pop() + except IndexError: + raise MarkupError( + f"closing tag '[/]' at position {position} has nothing to close" + ) from None + + if open_tag.name.startswith("@"): + if open_tag.parameters: + handler_name = "" + parameters = open_tag.parameters.strip() + handler_match = RE_HANDLER.match(parameters) + if handler_match is not None: + handler_name, match_parameters = handler_match.groups() + parameters = ( + "()" if match_parameters is None else match_parameters + ) + + try: + meta_params = literal_eval(parameters) + except SyntaxError as error: + raise MarkupError( + f"error parsing {parameters!r} in {open_tag.parameters!r}; {error.msg}" + ) + except Exception as error: + raise MarkupError( + f"error parsing {open_tag.parameters!r}; {error}" + ) from None + + if handler_name: + meta_params = ( + handler_name, + meta_params + if isinstance(meta_params, tuple) + else (meta_params,), + ) + + else: + meta_params = () + + append_span( + _Span( + start, len(text), Style(meta={open_tag.name: meta_params}) + ) + ) + else: + append_span(_Span(start, len(text), str(open_tag))) + + else: # Opening tag + normalized_tag = _Tag(normalize(tag.name), tag.parameters) + style_stack.append((len(text), normalized_tag)) + + text_length = len(text) + while style_stack: + start, tag = style_stack.pop() + style = str(tag) + if style: + append_span(_Span(start, text_length, style)) + + text.spans = sorted(spans[::-1], key=attrgetter("start")) + return text + + +if __name__ == "__main__": # pragma: no cover + MARKUP = [ + "[red]Hello World[/red]", + "[magenta]Hello [b]World[/b]", + "[bold]Bold[italic] bold and italic [/bold]italic[/italic]", + "Click [link=https://www.willmcgugan.com]here[/link] to visit my Blog", + ":warning-emoji: [bold red blink] DANGER![/]", + ] + + from pip._vendor.rich import print + from pip._vendor.rich.table import Table + + grid = Table("Markup", "Result", padding=(0, 1)) + + for markup in MARKUP: + grid.add_row(Text(markup), markup) + + print(grid) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/measure.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/measure.py new file mode 100644 index 0000000..a508ffa --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/measure.py @@ -0,0 +1,151 @@ +from operator import itemgetter +from typing import TYPE_CHECKING, Callable, NamedTuple, Optional, Sequence + +from . import errors +from .protocol import is_renderable, rich_cast + +if TYPE_CHECKING: + from .console import Console, ConsoleOptions, RenderableType + + +class Measurement(NamedTuple): + """Stores the minimum and maximum widths (in characters) required to render an object.""" + + minimum: int + """Minimum number of cells required to render.""" + maximum: int + """Maximum number of cells required to render.""" + + @property + def span(self) -> int: + """Get difference between maximum and minimum.""" + return self.maximum - self.minimum + + def normalize(self) -> "Measurement": + """Get measurement that ensures that minimum <= maximum and minimum >= 0 + + Returns: + Measurement: A normalized measurement. + """ + minimum, maximum = self + minimum = min(max(0, minimum), maximum) + return Measurement(max(0, minimum), max(0, max(minimum, maximum))) + + def with_maximum(self, width: int) -> "Measurement": + """Get a RenderableWith where the widths are <= width. + + Args: + width (int): Maximum desired width. + + Returns: + Measurement: New Measurement object. + """ + minimum, maximum = self + return Measurement(min(minimum, width), min(maximum, width)) + + def with_minimum(self, width: int) -> "Measurement": + """Get a RenderableWith where the widths are >= width. + + Args: + width (int): Minimum desired width. + + Returns: + Measurement: New Measurement object. + """ + minimum, maximum = self + width = max(0, width) + return Measurement(max(minimum, width), max(maximum, width)) + + def clamp( + self, min_width: Optional[int] = None, max_width: Optional[int] = None + ) -> "Measurement": + """Clamp a measurement within the specified range. + + Args: + min_width (int): Minimum desired width, or ``None`` for no minimum. Defaults to None. + max_width (int): Maximum desired width, or ``None`` for no maximum. Defaults to None. + + Returns: + Measurement: New Measurement object. + """ + measurement = self + if min_width is not None: + measurement = measurement.with_minimum(min_width) + if max_width is not None: + measurement = measurement.with_maximum(max_width) + return measurement + + @classmethod + def get( + cls, console: "Console", options: "ConsoleOptions", renderable: "RenderableType" + ) -> "Measurement": + """Get a measurement for a renderable. + + Args: + console (~rich.console.Console): Console instance. + options (~rich.console.ConsoleOptions): Console options. + renderable (RenderableType): An object that may be rendered with Rich. + + Raises: + errors.NotRenderableError: If the object is not renderable. + + Returns: + Measurement: Measurement object containing range of character widths required to render the object. + """ + _max_width = options.max_width + if _max_width < 1: + return Measurement(0, 0) + if isinstance(renderable, str): + renderable = console.render_str( + renderable, markup=options.markup, highlight=False + ) + renderable = rich_cast(renderable) + if is_renderable(renderable): + get_console_width: Optional[ + Callable[["Console", "ConsoleOptions"], "Measurement"] + ] = getattr(renderable, "__rich_measure__", None) + if get_console_width is not None: + render_width = ( + get_console_width(console, options) + .normalize() + .with_maximum(_max_width) + ) + if render_width.maximum < 1: + return Measurement(0, 0) + return render_width.normalize() + else: + return Measurement(0, _max_width) + else: + raise errors.NotRenderableError( + f"Unable to get render width for {renderable!r}; " + "a str, Segment, or object with __rich_console__ method is required" + ) + + +def measure_renderables( + console: "Console", + options: "ConsoleOptions", + renderables: Sequence["RenderableType"], +) -> "Measurement": + """Get a measurement that would fit a number of renderables. + + Args: + console (~rich.console.Console): Console instance. + options (~rich.console.ConsoleOptions): Console options. + renderables (Iterable[RenderableType]): One or more renderable objects. + + Returns: + Measurement: Measurement object containing range of character widths required to + contain all given renderables. + """ + if not renderables: + return Measurement(0, 0) + get_measurement = Measurement.get + measurements = [ + get_measurement(console, options, renderable) for renderable in renderables + ] + measured_width = Measurement( + max(measurements, key=itemgetter(0)).minimum, + max(measurements, key=itemgetter(1)).maximum, + ) + return measured_width diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/padding.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/padding.py new file mode 100644 index 0000000..1b2204f --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/padding.py @@ -0,0 +1,141 @@ +from typing import cast, List, Optional, Tuple, TYPE_CHECKING, Union + +if TYPE_CHECKING: + from .console import ( + Console, + ConsoleOptions, + RenderableType, + RenderResult, + ) +from .jupyter import JupyterMixin +from .measure import Measurement +from .style import Style +from .segment import Segment + + +PaddingDimensions = Union[int, Tuple[int], Tuple[int, int], Tuple[int, int, int, int]] + + +class Padding(JupyterMixin): + """Draw space around content. + + Example: + >>> print(Padding("Hello", (2, 4), style="on blue")) + + Args: + renderable (RenderableType): String or other renderable. + pad (Union[int, Tuple[int]]): Padding for top, right, bottom, and left borders. + May be specified with 1, 2, or 4 integers (CSS style). + style (Union[str, Style], optional): Style for padding characters. Defaults to "none". + expand (bool, optional): Expand padding to fit available width. Defaults to True. + """ + + def __init__( + self, + renderable: "RenderableType", + pad: "PaddingDimensions" = (0, 0, 0, 0), + *, + style: Union[str, Style] = "none", + expand: bool = True, + ): + self.renderable = renderable + self.top, self.right, self.bottom, self.left = self.unpack(pad) + self.style = style + self.expand = expand + + @classmethod + def indent(cls, renderable: "RenderableType", level: int) -> "Padding": + """Make padding instance to render an indent. + + Args: + renderable (RenderableType): String or other renderable. + level (int): Number of characters to indent. + + Returns: + Padding: A Padding instance. + """ + + return Padding(renderable, pad=(0, 0, 0, level), expand=False) + + @staticmethod + def unpack(pad: "PaddingDimensions") -> Tuple[int, int, int, int]: + """Unpack padding specified in CSS style.""" + if isinstance(pad, int): + return (pad, pad, pad, pad) + if len(pad) == 1: + _pad = pad[0] + return (_pad, _pad, _pad, _pad) + if len(pad) == 2: + pad_top, pad_right = cast(Tuple[int, int], pad) + return (pad_top, pad_right, pad_top, pad_right) + if len(pad) == 4: + top, right, bottom, left = cast(Tuple[int, int, int, int], pad) + return (top, right, bottom, left) + raise ValueError(f"1, 2 or 4 integers required for padding; {len(pad)} given") + + def __repr__(self) -> str: + return f"Padding({self.renderable!r}, ({self.top},{self.right},{self.bottom},{self.left}))" + + def __rich_console__( + self, console: "Console", options: "ConsoleOptions" + ) -> "RenderResult": + style = console.get_style(self.style) + if self.expand: + width = options.max_width + else: + width = min( + Measurement.get(console, options, self.renderable).maximum + + self.left + + self.right, + options.max_width, + ) + render_options = options.update_width(width - self.left - self.right) + if render_options.height is not None: + render_options = render_options.update_height( + height=render_options.height - self.top - self.bottom + ) + lines = console.render_lines( + self.renderable, render_options, style=style, pad=True + ) + _Segment = Segment + + left = _Segment(" " * self.left, style) if self.left else None + right = ( + [_Segment(f'{" " * self.right}', style), _Segment.line()] + if self.right + else [_Segment.line()] + ) + blank_line: Optional[List[Segment]] = None + if self.top: + blank_line = [_Segment(f'{" " * width}\n', style)] + yield from blank_line * self.top + if left: + for line in lines: + yield left + yield from line + yield from right + else: + for line in lines: + yield from line + yield from right + if self.bottom: + blank_line = blank_line or [_Segment(f'{" " * width}\n', style)] + yield from blank_line * self.bottom + + def __rich_measure__( + self, console: "Console", options: "ConsoleOptions" + ) -> "Measurement": + max_width = options.max_width + extra_width = self.left + self.right + if max_width - extra_width < 1: + return Measurement(max_width, max_width) + measure_min, measure_max = Measurement.get(console, options, self.renderable) + measurement = Measurement(measure_min + extra_width, measure_max + extra_width) + measurement = measurement.with_maximum(max_width) + return measurement + + +if __name__ == "__main__": # pragma: no cover + from pip._vendor.rich import print + + print(Padding("Hello, World", (2, 4), style="on blue")) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/pager.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/pager.py new file mode 100644 index 0000000..a3f7aa6 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/pager.py @@ -0,0 +1,34 @@ +from abc import ABC, abstractmethod +from typing import Any + + +class Pager(ABC): + """Base class for a pager.""" + + @abstractmethod + def show(self, content: str) -> None: + """Show content in pager. + + Args: + content (str): Content to be displayed. + """ + + +class SystemPager(Pager): + """Uses the pager installed on the system.""" + + def _pager(self, content: str) -> Any: #  pragma: no cover + return __import__("pydoc").pager(content) + + def show(self, content: str) -> None: + """Use the same pager used by pydoc.""" + self._pager(content) + + +if __name__ == "__main__": # pragma: no cover + from .__main__ import make_test_card + from .console import Console + + console = Console() + with console.pager(styles=True): + console.print(make_test_card()) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/palette.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/palette.py new file mode 100644 index 0000000..fa0c4dd --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/palette.py @@ -0,0 +1,100 @@ +from math import sqrt +from functools import lru_cache +from typing import Sequence, Tuple, TYPE_CHECKING + +from .color_triplet import ColorTriplet + +if TYPE_CHECKING: + from pip._vendor.rich.table import Table + + +class Palette: + """A palette of available colors.""" + + def __init__(self, colors: Sequence[Tuple[int, int, int]]): + self._colors = colors + + def __getitem__(self, number: int) -> ColorTriplet: + return ColorTriplet(*self._colors[number]) + + def __rich__(self) -> "Table": + from pip._vendor.rich.color import Color + from pip._vendor.rich.style import Style + from pip._vendor.rich.text import Text + from pip._vendor.rich.table import Table + + table = Table( + "index", + "RGB", + "Color", + title="Palette", + caption=f"{len(self._colors)} colors", + highlight=True, + caption_justify="right", + ) + for index, color in enumerate(self._colors): + table.add_row( + str(index), + repr(color), + Text(" " * 16, style=Style(bgcolor=Color.from_rgb(*color))), + ) + return table + + # This is somewhat inefficient and needs caching + @lru_cache(maxsize=1024) + def match(self, color: Tuple[int, int, int]) -> int: + """Find a color from a palette that most closely matches a given color. + + Args: + color (Tuple[int, int, int]): RGB components in range 0 > 255. + + Returns: + int: Index of closes matching color. + """ + red1, green1, blue1 = color + _sqrt = sqrt + get_color = self._colors.__getitem__ + + def get_color_distance(index: int) -> float: + """Get the distance to a color.""" + red2, green2, blue2 = get_color(index) + red_mean = (red1 + red2) // 2 + red = red1 - red2 + green = green1 - green2 + blue = blue1 - blue2 + return _sqrt( + (((512 + red_mean) * red * red) >> 8) + + 4 * green * green + + (((767 - red_mean) * blue * blue) >> 8) + ) + + min_index = min(range(len(self._colors)), key=get_color_distance) + return min_index + + +if __name__ == "__main__": # pragma: no cover + import colorsys + from typing import Iterable + from pip._vendor.rich.color import Color + from pip._vendor.rich.console import Console, ConsoleOptions + from pip._vendor.rich.segment import Segment + from pip._vendor.rich.style import Style + + class ColorBox: + def __rich_console__( + self, console: Console, options: ConsoleOptions + ) -> Iterable[Segment]: + height = console.size.height - 3 + for y in range(0, height): + for x in range(options.max_width): + h = x / options.max_width + l = y / (height + 1) + r1, g1, b1 = colorsys.hls_to_rgb(h, l, 1.0) + r2, g2, b2 = colorsys.hls_to_rgb(h, l + (1 / height / 2), 1.0) + bgcolor = Color.from_rgb(r1 * 255, g1 * 255, b1 * 255) + color = Color.from_rgb(r2 * 255, g2 * 255, b2 * 255) + yield Segment("▄", Style(color=color, bgcolor=bgcolor)) + yield Segment.line() + + console = Console() + console.print(ColorBox()) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/panel.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/panel.py new file mode 100644 index 0000000..95f4c84 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/panel.py @@ -0,0 +1,312 @@ +from typing import TYPE_CHECKING, Optional + +from .align import AlignMethod +from .box import ROUNDED, Box +from .cells import cell_len +from .jupyter import JupyterMixin +from .measure import Measurement, measure_renderables +from .padding import Padding, PaddingDimensions +from .segment import Segment +from .style import Style, StyleType +from .text import Text, TextType + +if TYPE_CHECKING: + from .console import Console, ConsoleOptions, RenderableType, RenderResult + + +class Panel(JupyterMixin): + """A console renderable that draws a border around its contents. + + Example: + >>> console.print(Panel("Hello, World!")) + + Args: + renderable (RenderableType): A console renderable object. + box (Box, optional): A Box instance that defines the look of the border (see :ref:`appendix_box`. + Defaults to box.ROUNDED. + safe_box (bool, optional): Disable box characters that don't display on windows legacy terminal with *raster* fonts. Defaults to True. + expand (bool, optional): If True the panel will stretch to fill the console + width, otherwise it will be sized to fit the contents. Defaults to True. + style (str, optional): The style of the panel (border and contents). Defaults to "none". + border_style (str, optional): The style of the border. Defaults to "none". + width (Optional[int], optional): Optional width of panel. Defaults to None to auto-detect. + height (Optional[int], optional): Optional height of panel. Defaults to None to auto-detect. + padding (Optional[PaddingDimensions]): Optional padding around renderable. Defaults to 0. + highlight (bool, optional): Enable automatic highlighting of panel title (if str). Defaults to False. + """ + + def __init__( + self, + renderable: "RenderableType", + box: Box = ROUNDED, + *, + title: Optional[TextType] = None, + title_align: AlignMethod = "center", + subtitle: Optional[TextType] = None, + subtitle_align: AlignMethod = "center", + safe_box: Optional[bool] = None, + expand: bool = True, + style: StyleType = "none", + border_style: StyleType = "none", + width: Optional[int] = None, + height: Optional[int] = None, + padding: PaddingDimensions = (0, 1), + highlight: bool = False, + ) -> None: + self.renderable = renderable + self.box = box + self.title = title + self.title_align: AlignMethod = title_align + self.subtitle = subtitle + self.subtitle_align = subtitle_align + self.safe_box = safe_box + self.expand = expand + self.style = style + self.border_style = border_style + self.width = width + self.height = height + self.padding = padding + self.highlight = highlight + + @classmethod + def fit( + cls, + renderable: "RenderableType", + box: Box = ROUNDED, + *, + title: Optional[TextType] = None, + title_align: AlignMethod = "center", + subtitle: Optional[TextType] = None, + subtitle_align: AlignMethod = "center", + safe_box: Optional[bool] = None, + style: StyleType = "none", + border_style: StyleType = "none", + width: Optional[int] = None, + height: Optional[int] = None, + padding: PaddingDimensions = (0, 1), + highlight: bool = False, + ) -> "Panel": + """An alternative constructor that sets expand=False.""" + return cls( + renderable, + box, + title=title, + title_align=title_align, + subtitle=subtitle, + subtitle_align=subtitle_align, + safe_box=safe_box, + style=style, + border_style=border_style, + width=width, + height=height, + padding=padding, + highlight=highlight, + expand=False, + ) + + @property + def _title(self) -> Optional[Text]: + if self.title: + title_text = ( + Text.from_markup(self.title) + if isinstance(self.title, str) + else self.title.copy() + ) + title_text.end = "" + title_text.plain = title_text.plain.replace("\n", " ") + title_text.no_wrap = True + title_text.expand_tabs() + title_text.pad(1) + return title_text + return None + + @property + def _subtitle(self) -> Optional[Text]: + if self.subtitle: + subtitle_text = ( + Text.from_markup(self.subtitle) + if isinstance(self.subtitle, str) + else self.subtitle.copy() + ) + subtitle_text.end = "" + subtitle_text.plain = subtitle_text.plain.replace("\n", " ") + subtitle_text.no_wrap = True + subtitle_text.expand_tabs() + subtitle_text.pad(1) + return subtitle_text + return None + + def __rich_console__( + self, console: "Console", options: "ConsoleOptions" + ) -> "RenderResult": + _padding = Padding.unpack(self.padding) + renderable = ( + Padding(self.renderable, _padding) if any(_padding) else self.renderable + ) + style = console.get_style(self.style) + border_style = style + console.get_style(self.border_style) + width = ( + options.max_width + if self.width is None + else min(options.max_width, self.width) + ) + + safe_box: bool = console.safe_box if self.safe_box is None else self.safe_box + box = self.box.substitute(options, safe=safe_box) + + def align_text( + text: Text, width: int, align: str, character: str, style: Style + ) -> Text: + """Gets new aligned text. + + Args: + text (Text): Title or subtitle text. + width (int): Desired width. + align (str): Alignment. + character (str): Character for alignment. + style (Style): Border style + + Returns: + Text: New text instance + """ + text = text.copy() + text.truncate(width) + excess_space = width - cell_len(text.plain) + if excess_space: + if align == "left": + return Text.assemble( + text, + (character * excess_space, style), + no_wrap=True, + end="", + ) + elif align == "center": + left = excess_space // 2 + return Text.assemble( + (character * left, style), + text, + (character * (excess_space - left), style), + no_wrap=True, + end="", + ) + else: + return Text.assemble( + (character * excess_space, style), + text, + no_wrap=True, + end="", + ) + return text + + title_text = self._title + if title_text is not None: + title_text.stylize_before(border_style) + + child_width = ( + width - 2 + if self.expand + else console.measure( + renderable, options=options.update_width(width - 2) + ).maximum + ) + child_height = self.height or options.height or None + if child_height: + child_height -= 2 + if title_text is not None: + child_width = min( + options.max_width - 2, max(child_width, title_text.cell_len + 2) + ) + + width = child_width + 2 + child_options = options.update( + width=child_width, height=child_height, highlight=self.highlight + ) + lines = console.render_lines(renderable, child_options, style=style) + + line_start = Segment(box.mid_left, border_style) + line_end = Segment(f"{box.mid_right}", border_style) + new_line = Segment.line() + if title_text is None or width <= 4: + yield Segment(box.get_top([width - 2]), border_style) + else: + title_text = align_text( + title_text, + width - 4, + self.title_align, + box.top, + border_style, + ) + yield Segment(box.top_left + box.top, border_style) + yield from console.render(title_text, child_options.update_width(width - 4)) + yield Segment(box.top + box.top_right, border_style) + + yield new_line + for line in lines: + yield line_start + yield from line + yield line_end + yield new_line + + subtitle_text = self._subtitle + if subtitle_text is not None: + subtitle_text.stylize_before(border_style) + + if subtitle_text is None or width <= 4: + yield Segment(box.get_bottom([width - 2]), border_style) + else: + subtitle_text = align_text( + subtitle_text, + width - 4, + self.subtitle_align, + box.bottom, + border_style, + ) + yield Segment(box.bottom_left + box.bottom, border_style) + yield from console.render( + subtitle_text, child_options.update_width(width - 4) + ) + yield Segment(box.bottom + box.bottom_right, border_style) + + yield new_line + + def __rich_measure__( + self, console: "Console", options: "ConsoleOptions" + ) -> "Measurement": + _title = self._title + _, right, _, left = Padding.unpack(self.padding) + padding = left + right + renderables = [self.renderable, _title] if _title else [self.renderable] + + if self.width is None: + width = ( + measure_renderables( + console, + options.update_width(options.max_width - padding - 2), + renderables, + ).maximum + + padding + + 2 + ) + else: + width = self.width + return Measurement(width, width) + + +if __name__ == "__main__": # pragma: no cover + from .console import Console + + c = Console() + + from .box import DOUBLE, ROUNDED + from .padding import Padding + + p = Panel( + "Hello, World!", + title="rich.Panel", + style="white on blue", + box=DOUBLE, + padding=1, + ) + + c.print() + c.print(p) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/pretty.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/pretty.py new file mode 100644 index 0000000..9b9e3ba --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/pretty.py @@ -0,0 +1,995 @@ +import builtins +import collections +import dataclasses +import inspect +import os +import sys +from array import array +from collections import Counter, UserDict, UserList, defaultdict, deque +from dataclasses import dataclass, fields, is_dataclass +from inspect import isclass +from itertools import islice +from types import MappingProxyType +from typing import ( + TYPE_CHECKING, + Any, + Callable, + DefaultDict, + Dict, + Iterable, + List, + Optional, + Sequence, + Set, + Tuple, + Union, +) + +from pip._vendor.rich.repr import RichReprResult + +try: + import attr as _attr_module + + _has_attrs = hasattr(_attr_module, "ib") +except ImportError: # pragma: no cover + _has_attrs = False + +from . import get_console +from ._loop import loop_last +from ._pick import pick_bool +from .abc import RichRenderable +from .cells import cell_len +from .highlighter import ReprHighlighter +from .jupyter import JupyterMixin, JupyterRenderable +from .measure import Measurement +from .text import Text + +if TYPE_CHECKING: + from .console import ( + Console, + ConsoleOptions, + HighlighterType, + JustifyMethod, + OverflowMethod, + RenderResult, + ) + + +def _is_attr_object(obj: Any) -> bool: + """Check if an object was created with attrs module.""" + return _has_attrs and _attr_module.has(type(obj)) + + +def _get_attr_fields(obj: Any) -> Sequence["_attr_module.Attribute[Any]"]: + """Get fields for an attrs object.""" + return _attr_module.fields(type(obj)) if _has_attrs else [] + + +def _is_dataclass_repr(obj: object) -> bool: + """Check if an instance of a dataclass contains the default repr. + + Args: + obj (object): A dataclass instance. + + Returns: + bool: True if the default repr is used, False if there is a custom repr. + """ + # Digging in to a lot of internals here + # Catching all exceptions in case something is missing on a non CPython implementation + try: + return obj.__repr__.__code__.co_filename == dataclasses.__file__ + except Exception: # pragma: no coverage + return False + + +_dummy_namedtuple = collections.namedtuple("_dummy_namedtuple", []) + + +def _has_default_namedtuple_repr(obj: object) -> bool: + """Check if an instance of namedtuple contains the default repr + + Args: + obj (object): A namedtuple + + Returns: + bool: True if the default repr is used, False if there's a custom repr. + """ + obj_file = None + try: + obj_file = inspect.getfile(obj.__repr__) + except (OSError, TypeError): + # OSError handles case where object is defined in __main__ scope, e.g. REPL - no filename available. + # TypeError trapped defensively, in case of object without filename slips through. + pass + default_repr_file = inspect.getfile(_dummy_namedtuple.__repr__) + return obj_file == default_repr_file + + +def _ipy_display_hook( + value: Any, + console: Optional["Console"] = None, + overflow: "OverflowMethod" = "ignore", + crop: bool = False, + indent_guides: bool = False, + max_length: Optional[int] = None, + max_string: Optional[int] = None, + max_depth: Optional[int] = None, + expand_all: bool = False, +) -> Union[str, None]: + # needed here to prevent circular import: + from .console import ConsoleRenderable + + # always skip rich generated jupyter renderables or None values + if _safe_isinstance(value, JupyterRenderable) or value is None: + return None + + console = console or get_console() + + with console.capture() as capture: + # certain renderables should start on a new line + if _safe_isinstance(value, ConsoleRenderable): + console.line() + console.print( + value + if _safe_isinstance(value, RichRenderable) + else Pretty( + value, + overflow=overflow, + indent_guides=indent_guides, + max_length=max_length, + max_string=max_string, + max_depth=max_depth, + expand_all=expand_all, + margin=12, + ), + crop=crop, + new_line_start=True, + end="", + ) + # strip trailing newline, not usually part of a text repr + # I'm not sure if this should be prevented at a lower level + return capture.get().rstrip("\n") + + +def _safe_isinstance( + obj: object, class_or_tuple: Union[type, Tuple[type, ...]] +) -> bool: + """isinstance can fail in rare cases, for example types with no __class__""" + try: + return isinstance(obj, class_or_tuple) + except Exception: + return False + + +def install( + console: Optional["Console"] = None, + overflow: "OverflowMethod" = "ignore", + crop: bool = False, + indent_guides: bool = False, + max_length: Optional[int] = None, + max_string: Optional[int] = None, + max_depth: Optional[int] = None, + expand_all: bool = False, +) -> None: + """Install automatic pretty printing in the Python REPL. + + Args: + console (Console, optional): Console instance or ``None`` to use global console. Defaults to None. + overflow (Optional[OverflowMethod], optional): Overflow method. Defaults to "ignore". + crop (Optional[bool], optional): Enable cropping of long lines. Defaults to False. + indent_guides (bool, optional): Enable indentation guides. Defaults to False. + max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation. + Defaults to None. + max_string (int, optional): Maximum length of string before truncating, or None to disable. Defaults to None. + max_depth (int, optional): Maximum depth of nested data structures, or None for no maximum. Defaults to None. + expand_all (bool, optional): Expand all containers. Defaults to False. + max_frames (int): Maximum number of frames to show in a traceback, 0 for no maximum. Defaults to 100. + """ + from pip._vendor.rich import get_console + + console = console or get_console() + assert console is not None + + def display_hook(value: Any) -> None: + """Replacement sys.displayhook which prettifies objects with Rich.""" + if value is not None: + assert console is not None + builtins._ = None # type: ignore[attr-defined] + console.print( + value + if _safe_isinstance(value, RichRenderable) + else Pretty( + value, + overflow=overflow, + indent_guides=indent_guides, + max_length=max_length, + max_string=max_string, + max_depth=max_depth, + expand_all=expand_all, + ), + crop=crop, + ) + builtins._ = value # type: ignore[attr-defined] + + try: + ip = get_ipython() # type: ignore[name-defined] + except NameError: + sys.displayhook = display_hook + else: + from IPython.core.formatters import BaseFormatter + + class RichFormatter(BaseFormatter): # type: ignore[misc] + pprint: bool = True + + def __call__(self, value: Any) -> Any: + if self.pprint: + return _ipy_display_hook( + value, + console=get_console(), + overflow=overflow, + indent_guides=indent_guides, + max_length=max_length, + max_string=max_string, + max_depth=max_depth, + expand_all=expand_all, + ) + else: + return repr(value) + + # replace plain text formatter with rich formatter + rich_formatter = RichFormatter() + ip.display_formatter.formatters["text/plain"] = rich_formatter + + +class Pretty(JupyterMixin): + """A rich renderable that pretty prints an object. + + Args: + _object (Any): An object to pretty print. + highlighter (HighlighterType, optional): Highlighter object to apply to result, or None for ReprHighlighter. Defaults to None. + indent_size (int, optional): Number of spaces in indent. Defaults to 4. + justify (JustifyMethod, optional): Justify method, or None for default. Defaults to None. + overflow (OverflowMethod, optional): Overflow method, or None for default. Defaults to None. + no_wrap (Optional[bool], optional): Disable word wrapping. Defaults to False. + indent_guides (bool, optional): Enable indentation guides. Defaults to False. + max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation. + Defaults to None. + max_string (int, optional): Maximum length of string before truncating, or None to disable. Defaults to None. + max_depth (int, optional): Maximum depth of nested data structures, or None for no maximum. Defaults to None. + expand_all (bool, optional): Expand all containers. Defaults to False. + margin (int, optional): Subtrace a margin from width to force containers to expand earlier. Defaults to 0. + insert_line (bool, optional): Insert a new line if the output has multiple new lines. Defaults to False. + """ + + def __init__( + self, + _object: Any, + highlighter: Optional["HighlighterType"] = None, + *, + indent_size: int = 4, + justify: Optional["JustifyMethod"] = None, + overflow: Optional["OverflowMethod"] = None, + no_wrap: Optional[bool] = False, + indent_guides: bool = False, + max_length: Optional[int] = None, + max_string: Optional[int] = None, + max_depth: Optional[int] = None, + expand_all: bool = False, + margin: int = 0, + insert_line: bool = False, + ) -> None: + self._object = _object + self.highlighter = highlighter or ReprHighlighter() + self.indent_size = indent_size + self.justify: Optional["JustifyMethod"] = justify + self.overflow: Optional["OverflowMethod"] = overflow + self.no_wrap = no_wrap + self.indent_guides = indent_guides + self.max_length = max_length + self.max_string = max_string + self.max_depth = max_depth + self.expand_all = expand_all + self.margin = margin + self.insert_line = insert_line + + def __rich_console__( + self, console: "Console", options: "ConsoleOptions" + ) -> "RenderResult": + pretty_str = pretty_repr( + self._object, + max_width=options.max_width - self.margin, + indent_size=self.indent_size, + max_length=self.max_length, + max_string=self.max_string, + max_depth=self.max_depth, + expand_all=self.expand_all, + ) + pretty_text = Text.from_ansi( + pretty_str, + justify=self.justify or options.justify, + overflow=self.overflow or options.overflow, + no_wrap=pick_bool(self.no_wrap, options.no_wrap), + style="pretty", + ) + pretty_text = ( + self.highlighter(pretty_text) + if pretty_text + else Text( + f"{type(self._object)}.__repr__ returned empty string", + style="dim italic", + ) + ) + if self.indent_guides and not options.ascii_only: + pretty_text = pretty_text.with_indent_guides( + self.indent_size, style="repr.indent" + ) + if self.insert_line and "\n" in pretty_text: + yield "" + yield pretty_text + + def __rich_measure__( + self, console: "Console", options: "ConsoleOptions" + ) -> "Measurement": + pretty_str = pretty_repr( + self._object, + max_width=options.max_width, + indent_size=self.indent_size, + max_length=self.max_length, + max_string=self.max_string, + max_depth=self.max_depth, + expand_all=self.expand_all, + ) + text_width = ( + max(cell_len(line) for line in pretty_str.splitlines()) if pretty_str else 0 + ) + return Measurement(text_width, text_width) + + +def _get_braces_for_defaultdict(_object: DefaultDict[Any, Any]) -> Tuple[str, str, str]: + return ( + f"defaultdict({_object.default_factory!r}, {{", + "})", + f"defaultdict({_object.default_factory!r}, {{}})", + ) + + +def _get_braces_for_array(_object: "array[Any]") -> Tuple[str, str, str]: + return (f"array({_object.typecode!r}, [", "])", f"array({_object.typecode!r})") + + +_BRACES: Dict[type, Callable[[Any], Tuple[str, str, str]]] = { + os._Environ: lambda _object: ("environ({", "})", "environ({})"), + array: _get_braces_for_array, + defaultdict: _get_braces_for_defaultdict, + Counter: lambda _object: ("Counter({", "})", "Counter()"), + deque: lambda _object: ("deque([", "])", "deque()"), + dict: lambda _object: ("{", "}", "{}"), + UserDict: lambda _object: ("{", "}", "{}"), + frozenset: lambda _object: ("frozenset({", "})", "frozenset()"), + list: lambda _object: ("[", "]", "[]"), + UserList: lambda _object: ("[", "]", "[]"), + set: lambda _object: ("{", "}", "set()"), + tuple: lambda _object: ("(", ")", "()"), + MappingProxyType: lambda _object: ("mappingproxy({", "})", "mappingproxy({})"), +} +_CONTAINERS = tuple(_BRACES.keys()) +_MAPPING_CONTAINERS = (dict, os._Environ, MappingProxyType, UserDict) + + +def is_expandable(obj: Any) -> bool: + """Check if an object may be expanded by pretty print.""" + return ( + _safe_isinstance(obj, _CONTAINERS) + or (is_dataclass(obj)) + or (hasattr(obj, "__rich_repr__")) + or _is_attr_object(obj) + ) and not isclass(obj) + + +@dataclass +class Node: + """A node in a repr tree. May be atomic or a container.""" + + key_repr: str = "" + value_repr: str = "" + open_brace: str = "" + close_brace: str = "" + empty: str = "" + last: bool = False + is_tuple: bool = False + is_namedtuple: bool = False + children: Optional[List["Node"]] = None + key_separator: str = ": " + separator: str = ", " + + def iter_tokens(self) -> Iterable[str]: + """Generate tokens for this node.""" + if self.key_repr: + yield self.key_repr + yield self.key_separator + if self.value_repr: + yield self.value_repr + elif self.children is not None: + if self.children: + yield self.open_brace + if self.is_tuple and not self.is_namedtuple and len(self.children) == 1: + yield from self.children[0].iter_tokens() + yield "," + else: + for child in self.children: + yield from child.iter_tokens() + if not child.last: + yield self.separator + yield self.close_brace + else: + yield self.empty + + def check_length(self, start_length: int, max_length: int) -> bool: + """Check the length fits within a limit. + + Args: + start_length (int): Starting length of the line (indent, prefix, suffix). + max_length (int): Maximum length. + + Returns: + bool: True if the node can be rendered within max length, otherwise False. + """ + total_length = start_length + for token in self.iter_tokens(): + total_length += cell_len(token) + if total_length > max_length: + return False + return True + + def __str__(self) -> str: + repr_text = "".join(self.iter_tokens()) + return repr_text + + def render( + self, max_width: int = 80, indent_size: int = 4, expand_all: bool = False + ) -> str: + """Render the node to a pretty repr. + + Args: + max_width (int, optional): Maximum width of the repr. Defaults to 80. + indent_size (int, optional): Size of indents. Defaults to 4. + expand_all (bool, optional): Expand all levels. Defaults to False. + + Returns: + str: A repr string of the original object. + """ + lines = [_Line(node=self, is_root=True)] + line_no = 0 + while line_no < len(lines): + line = lines[line_no] + if line.expandable and not line.expanded: + if expand_all or not line.check_length(max_width): + lines[line_no : line_no + 1] = line.expand(indent_size) + line_no += 1 + + repr_str = "\n".join(str(line) for line in lines) + return repr_str + + +@dataclass +class _Line: + """A line in repr output.""" + + parent: Optional["_Line"] = None + is_root: bool = False + node: Optional[Node] = None + text: str = "" + suffix: str = "" + whitespace: str = "" + expanded: bool = False + last: bool = False + + @property + def expandable(self) -> bool: + """Check if the line may be expanded.""" + return bool(self.node is not None and self.node.children) + + def check_length(self, max_length: int) -> bool: + """Check this line fits within a given number of cells.""" + start_length = ( + len(self.whitespace) + cell_len(self.text) + cell_len(self.suffix) + ) + assert self.node is not None + return self.node.check_length(start_length, max_length) + + def expand(self, indent_size: int) -> Iterable["_Line"]: + """Expand this line by adding children on their own line.""" + node = self.node + assert node is not None + whitespace = self.whitespace + assert node.children + if node.key_repr: + new_line = yield _Line( + text=f"{node.key_repr}{node.key_separator}{node.open_brace}", + whitespace=whitespace, + ) + else: + new_line = yield _Line(text=node.open_brace, whitespace=whitespace) + child_whitespace = self.whitespace + " " * indent_size + tuple_of_one = node.is_tuple and len(node.children) == 1 + for last, child in loop_last(node.children): + separator = "," if tuple_of_one else node.separator + line = _Line( + parent=new_line, + node=child, + whitespace=child_whitespace, + suffix=separator, + last=last and not tuple_of_one, + ) + yield line + + yield _Line( + text=node.close_brace, + whitespace=whitespace, + suffix=self.suffix, + last=self.last, + ) + + def __str__(self) -> str: + if self.last: + return f"{self.whitespace}{self.text}{self.node or ''}" + else: + return ( + f"{self.whitespace}{self.text}{self.node or ''}{self.suffix.rstrip()}" + ) + + +def _is_namedtuple(obj: Any) -> bool: + """Checks if an object is most likely a namedtuple. It is possible + to craft an object that passes this check and isn't a namedtuple, but + there is only a minuscule chance of this happening unintentionally. + + Args: + obj (Any): The object to test + + Returns: + bool: True if the object is a namedtuple. False otherwise. + """ + try: + fields = getattr(obj, "_fields", None) + except Exception: + # Being very defensive - if we cannot get the attr then its not a namedtuple + return False + return isinstance(obj, tuple) and isinstance(fields, tuple) + + +def traverse( + _object: Any, + max_length: Optional[int] = None, + max_string: Optional[int] = None, + max_depth: Optional[int] = None, +) -> Node: + """Traverse object and generate a tree. + + Args: + _object (Any): Object to be traversed. + max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation. + Defaults to None. + max_string (int, optional): Maximum length of string before truncating, or None to disable truncating. + Defaults to None. + max_depth (int, optional): Maximum depth of data structures, or None for no maximum. + Defaults to None. + + Returns: + Node: The root of a tree structure which can be used to render a pretty repr. + """ + + def to_repr(obj: Any) -> str: + """Get repr string for an object, but catch errors.""" + if ( + max_string is not None + and _safe_isinstance(obj, (bytes, str)) + and len(obj) > max_string + ): + truncated = len(obj) - max_string + obj_repr = f"{obj[:max_string]!r}+{truncated}" + else: + try: + obj_repr = repr(obj) + except Exception as error: + obj_repr = f"" + return obj_repr + + visited_ids: Set[int] = set() + push_visited = visited_ids.add + pop_visited = visited_ids.remove + + def _traverse(obj: Any, root: bool = False, depth: int = 0) -> Node: + """Walk the object depth first.""" + + obj_id = id(obj) + if obj_id in visited_ids: + # Recursion detected + return Node(value_repr="...") + + obj_type = type(obj) + children: List[Node] + reached_max_depth = max_depth is not None and depth >= max_depth + + def iter_rich_args(rich_args: Any) -> Iterable[Union[Any, Tuple[str, Any]]]: + for arg in rich_args: + if _safe_isinstance(arg, tuple): + if len(arg) == 3: + key, child, default = arg + if default == child: + continue + yield key, child + elif len(arg) == 2: + key, child = arg + yield key, child + elif len(arg) == 1: + yield arg[0] + else: + yield arg + + try: + fake_attributes = hasattr( + obj, "awehoi234_wdfjwljet234_234wdfoijsdfmmnxpi492" + ) + except Exception: + fake_attributes = False + + rich_repr_result: Optional[RichReprResult] = None + if not fake_attributes: + try: + if hasattr(obj, "__rich_repr__") and not isclass(obj): + rich_repr_result = obj.__rich_repr__() + except Exception: + pass + + if rich_repr_result is not None: + push_visited(obj_id) + angular = getattr(obj.__rich_repr__, "angular", False) + args = list(iter_rich_args(rich_repr_result)) + class_name = obj.__class__.__name__ + + if args: + children = [] + append = children.append + + if reached_max_depth: + if angular: + node = Node(value_repr=f"<{class_name}...>") + else: + node = Node(value_repr=f"{class_name}(...)") + else: + if angular: + node = Node( + open_brace=f"<{class_name} ", + close_brace=">", + children=children, + last=root, + separator=" ", + ) + else: + node = Node( + open_brace=f"{class_name}(", + close_brace=")", + children=children, + last=root, + ) + for last, arg in loop_last(args): + if _safe_isinstance(arg, tuple): + key, child = arg + child_node = _traverse(child, depth=depth + 1) + child_node.last = last + child_node.key_repr = key + child_node.key_separator = "=" + append(child_node) + else: + child_node = _traverse(arg, depth=depth + 1) + child_node.last = last + append(child_node) + else: + node = Node( + value_repr=f"<{class_name}>" if angular else f"{class_name}()", + children=[], + last=root, + ) + pop_visited(obj_id) + elif _is_attr_object(obj) and not fake_attributes: + push_visited(obj_id) + children = [] + append = children.append + + attr_fields = _get_attr_fields(obj) + if attr_fields: + if reached_max_depth: + node = Node(value_repr=f"{obj.__class__.__name__}(...)") + else: + node = Node( + open_brace=f"{obj.__class__.__name__}(", + close_brace=")", + children=children, + last=root, + ) + + def iter_attrs() -> ( + Iterable[Tuple[str, Any, Optional[Callable[[Any], str]]]] + ): + """Iterate over attr fields and values.""" + for attr in attr_fields: + if attr.repr: + try: + value = getattr(obj, attr.name) + except Exception as error: + # Can happen, albeit rarely + yield (attr.name, error, None) + else: + yield ( + attr.name, + value, + attr.repr if callable(attr.repr) else None, + ) + + for last, (name, value, repr_callable) in loop_last(iter_attrs()): + if repr_callable: + child_node = Node(value_repr=str(repr_callable(value))) + else: + child_node = _traverse(value, depth=depth + 1) + child_node.last = last + child_node.key_repr = name + child_node.key_separator = "=" + append(child_node) + else: + node = Node( + value_repr=f"{obj.__class__.__name__}()", children=[], last=root + ) + pop_visited(obj_id) + elif ( + is_dataclass(obj) + and not _safe_isinstance(obj, type) + and not fake_attributes + and _is_dataclass_repr(obj) + ): + push_visited(obj_id) + children = [] + append = children.append + if reached_max_depth: + node = Node(value_repr=f"{obj.__class__.__name__}(...)") + else: + node = Node( + open_brace=f"{obj.__class__.__name__}(", + close_brace=")", + children=children, + last=root, + empty=f"{obj.__class__.__name__}()", + ) + + for last, field in loop_last( + field for field in fields(obj) if field.repr + ): + child_node = _traverse(getattr(obj, field.name), depth=depth + 1) + child_node.key_repr = field.name + child_node.last = last + child_node.key_separator = "=" + append(child_node) + + pop_visited(obj_id) + elif _is_namedtuple(obj) and _has_default_namedtuple_repr(obj): + push_visited(obj_id) + class_name = obj.__class__.__name__ + if reached_max_depth: + # If we've reached the max depth, we still show the class name, but not its contents + node = Node( + value_repr=f"{class_name}(...)", + ) + else: + children = [] + append = children.append + node = Node( + open_brace=f"{class_name}(", + close_brace=")", + children=children, + empty=f"{class_name}()", + ) + for last, (key, value) in loop_last(obj._asdict().items()): + child_node = _traverse(value, depth=depth + 1) + child_node.key_repr = key + child_node.last = last + child_node.key_separator = "=" + append(child_node) + pop_visited(obj_id) + elif _safe_isinstance(obj, _CONTAINERS): + for container_type in _CONTAINERS: + if _safe_isinstance(obj, container_type): + obj_type = container_type + break + + push_visited(obj_id) + + open_brace, close_brace, empty = _BRACES[obj_type](obj) + + if reached_max_depth: + node = Node(value_repr=f"{open_brace}...{close_brace}") + elif obj_type.__repr__ != type(obj).__repr__: + node = Node(value_repr=to_repr(obj), last=root) + elif obj: + children = [] + node = Node( + open_brace=open_brace, + close_brace=close_brace, + children=children, + last=root, + ) + append = children.append + num_items = len(obj) + last_item_index = num_items - 1 + + if _safe_isinstance(obj, _MAPPING_CONTAINERS): + iter_items = iter(obj.items()) + if max_length is not None: + iter_items = islice(iter_items, max_length) + for index, (key, child) in enumerate(iter_items): + child_node = _traverse(child, depth=depth + 1) + child_node.key_repr = to_repr(key) + child_node.last = index == last_item_index + append(child_node) + else: + iter_values = iter(obj) + if max_length is not None: + iter_values = islice(iter_values, max_length) + for index, child in enumerate(iter_values): + child_node = _traverse(child, depth=depth + 1) + child_node.last = index == last_item_index + append(child_node) + if max_length is not None and num_items > max_length: + append(Node(value_repr=f"... +{num_items - max_length}", last=True)) + else: + node = Node(empty=empty, children=[], last=root) + + pop_visited(obj_id) + else: + node = Node(value_repr=to_repr(obj), last=root) + node.is_tuple = _safe_isinstance(obj, tuple) + node.is_namedtuple = _is_namedtuple(obj) + return node + + node = _traverse(_object, root=True) + return node + + +def pretty_repr( + _object: Any, + *, + max_width: int = 80, + indent_size: int = 4, + max_length: Optional[int] = None, + max_string: Optional[int] = None, + max_depth: Optional[int] = None, + expand_all: bool = False, +) -> str: + """Prettify repr string by expanding on to new lines to fit within a given width. + + Args: + _object (Any): Object to repr. + max_width (int, optional): Desired maximum width of repr string. Defaults to 80. + indent_size (int, optional): Number of spaces to indent. Defaults to 4. + max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation. + Defaults to None. + max_string (int, optional): Maximum length of string before truncating, or None to disable truncating. + Defaults to None. + max_depth (int, optional): Maximum depth of nested data structure, or None for no depth. + Defaults to None. + expand_all (bool, optional): Expand all containers regardless of available width. Defaults to False. + + Returns: + str: A possibly multi-line representation of the object. + """ + + if _safe_isinstance(_object, Node): + node = _object + else: + node = traverse( + _object, max_length=max_length, max_string=max_string, max_depth=max_depth + ) + repr_str: str = node.render( + max_width=max_width, indent_size=indent_size, expand_all=expand_all + ) + return repr_str + + +def pprint( + _object: Any, + *, + console: Optional["Console"] = None, + indent_guides: bool = True, + max_length: Optional[int] = None, + max_string: Optional[int] = None, + max_depth: Optional[int] = None, + expand_all: bool = False, +) -> None: + """A convenience function for pretty printing. + + Args: + _object (Any): Object to pretty print. + console (Console, optional): Console instance, or None to use default. Defaults to None. + max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation. + Defaults to None. + max_string (int, optional): Maximum length of strings before truncating, or None to disable. Defaults to None. + max_depth (int, optional): Maximum depth for nested data structures, or None for unlimited depth. Defaults to None. + indent_guides (bool, optional): Enable indentation guides. Defaults to True. + expand_all (bool, optional): Expand all containers. Defaults to False. + """ + _console = get_console() if console is None else console + _console.print( + Pretty( + _object, + max_length=max_length, + max_string=max_string, + max_depth=max_depth, + indent_guides=indent_guides, + expand_all=expand_all, + overflow="ignore", + ), + soft_wrap=True, + ) + + +if __name__ == "__main__": # pragma: no cover + + class BrokenRepr: + def __repr__(self) -> str: + 1 / 0 + return "this will fail" + + from typing import NamedTuple + + class StockKeepingUnit(NamedTuple): + name: str + description: str + price: float + category: str + reviews: List[str] + + d = defaultdict(int) + d["foo"] = 5 + data = { + "foo": [ + 1, + "Hello World!", + 100.123, + 323.232, + 432324.0, + {5, 6, 7, (1, 2, 3, 4), 8}, + ], + "bar": frozenset({1, 2, 3}), + "defaultdict": defaultdict( + list, {"crumble": ["apple", "rhubarb", "butter", "sugar", "flour"]} + ), + "counter": Counter( + [ + "apple", + "orange", + "pear", + "kumquat", + "kumquat", + "durian" * 100, + ] + ), + "atomic": (False, True, None), + "namedtuple": StockKeepingUnit( + "Sparkling British Spring Water", + "Carbonated spring water", + 0.9, + "water", + ["its amazing!", "its terrible!"], + ), + "Broken": BrokenRepr(), + } + data["foo"].append(data) # type: ignore[attr-defined] + + from pip._vendor.rich import print + + print(Pretty(data, indent_guides=True, max_string=20)) + + class Thing: + def __repr__(self) -> str: + return "Hello\x1b[38;5;239m World!" + + print(Pretty(Thing())) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/progress.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/progress.py new file mode 100644 index 0000000..2420c24 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/progress.py @@ -0,0 +1,1699 @@ +import io +import sys +import typing +import warnings +from abc import ABC, abstractmethod +from collections import deque +from dataclasses import dataclass, field +from datetime import timedelta +from io import RawIOBase, UnsupportedOperation +from math import ceil +from mmap import mmap +from operator import length_hint +from os import PathLike, stat +from threading import Event, RLock, Thread +from types import TracebackType +from typing import ( + Any, + BinaryIO, + Callable, + ContextManager, + Deque, + Dict, + Generic, + Iterable, + List, + NamedTuple, + NewType, + Optional, + Sequence, + TextIO, + Tuple, + Type, + TypeVar, + Union, +) + +if sys.version_info >= (3, 8): + from typing import Literal +else: + from pip._vendor.typing_extensions import Literal # pragma: no cover + +from . import filesize, get_console +from .console import Console, Group, JustifyMethod, RenderableType +from .highlighter import Highlighter +from .jupyter import JupyterMixin +from .live import Live +from .progress_bar import ProgressBar +from .spinner import Spinner +from .style import StyleType +from .table import Column, Table +from .text import Text, TextType + +TaskID = NewType("TaskID", int) + +ProgressType = TypeVar("ProgressType") + +GetTimeCallable = Callable[[], float] + + +_I = typing.TypeVar("_I", TextIO, BinaryIO) + + +class _TrackThread(Thread): + """A thread to periodically update progress.""" + + def __init__(self, progress: "Progress", task_id: "TaskID", update_period: float): + self.progress = progress + self.task_id = task_id + self.update_period = update_period + self.done = Event() + + self.completed = 0 + super().__init__() + + def run(self) -> None: + task_id = self.task_id + advance = self.progress.advance + update_period = self.update_period + last_completed = 0 + wait = self.done.wait + while not wait(update_period): + completed = self.completed + if last_completed != completed: + advance(task_id, completed - last_completed) + last_completed = completed + + self.progress.update(self.task_id, completed=self.completed, refresh=True) + + def __enter__(self) -> "_TrackThread": + self.start() + return self + + def __exit__( + self, + exc_type: Optional[Type[BaseException]], + exc_val: Optional[BaseException], + exc_tb: Optional[TracebackType], + ) -> None: + self.done.set() + self.join() + + +def track( + sequence: Union[Sequence[ProgressType], Iterable[ProgressType]], + description: str = "Working...", + total: Optional[float] = None, + auto_refresh: bool = True, + console: Optional[Console] = None, + transient: bool = False, + get_time: Optional[Callable[[], float]] = None, + refresh_per_second: float = 10, + style: StyleType = "bar.back", + complete_style: StyleType = "bar.complete", + finished_style: StyleType = "bar.finished", + pulse_style: StyleType = "bar.pulse", + update_period: float = 0.1, + disable: bool = False, + show_speed: bool = True, +) -> Iterable[ProgressType]: + """Track progress by iterating over a sequence. + + Args: + sequence (Iterable[ProgressType]): A sequence (must support "len") you wish to iterate over. + description (str, optional): Description of task show next to progress bar. Defaults to "Working". + total: (float, optional): Total number of steps. Default is len(sequence). + auto_refresh (bool, optional): Automatic refresh, disable to force a refresh after each iteration. Default is True. + transient: (bool, optional): Clear the progress on exit. Defaults to False. + console (Console, optional): Console to write to. Default creates internal Console instance. + refresh_per_second (float): Number of times per second to refresh the progress information. Defaults to 10. + style (StyleType, optional): Style for the bar background. Defaults to "bar.back". + complete_style (StyleType, optional): Style for the completed bar. Defaults to "bar.complete". + finished_style (StyleType, optional): Style for a finished bar. Defaults to "bar.finished". + pulse_style (StyleType, optional): Style for pulsing bars. Defaults to "bar.pulse". + update_period (float, optional): Minimum time (in seconds) between calls to update(). Defaults to 0.1. + disable (bool, optional): Disable display of progress. + show_speed (bool, optional): Show speed if total isn't known. Defaults to True. + Returns: + Iterable[ProgressType]: An iterable of the values in the sequence. + + """ + + columns: List["ProgressColumn"] = ( + [TextColumn("[progress.description]{task.description}")] if description else [] + ) + columns.extend( + ( + BarColumn( + style=style, + complete_style=complete_style, + finished_style=finished_style, + pulse_style=pulse_style, + ), + TaskProgressColumn(show_speed=show_speed), + TimeRemainingColumn(elapsed_when_finished=True), + ) + ) + progress = Progress( + *columns, + auto_refresh=auto_refresh, + console=console, + transient=transient, + get_time=get_time, + refresh_per_second=refresh_per_second or 10, + disable=disable, + ) + + with progress: + yield from progress.track( + sequence, total=total, description=description, update_period=update_period + ) + + +class _Reader(RawIOBase, BinaryIO): + """A reader that tracks progress while it's being read from.""" + + def __init__( + self, + handle: BinaryIO, + progress: "Progress", + task: TaskID, + close_handle: bool = True, + ) -> None: + self.handle = handle + self.progress = progress + self.task = task + self.close_handle = close_handle + self._closed = False + + def __enter__(self) -> "_Reader": + self.handle.__enter__() + return self + + def __exit__( + self, + exc_type: Optional[Type[BaseException]], + exc_val: Optional[BaseException], + exc_tb: Optional[TracebackType], + ) -> None: + self.close() + + def __iter__(self) -> BinaryIO: + return self + + def __next__(self) -> bytes: + line = next(self.handle) + self.progress.advance(self.task, advance=len(line)) + return line + + @property + def closed(self) -> bool: + return self._closed + + def fileno(self) -> int: + return self.handle.fileno() + + def isatty(self) -> bool: + return self.handle.isatty() + + @property + def mode(self) -> str: + return self.handle.mode + + @property + def name(self) -> str: + return self.handle.name + + def readable(self) -> bool: + return self.handle.readable() + + def seekable(self) -> bool: + return self.handle.seekable() + + def writable(self) -> bool: + return False + + def read(self, size: int = -1) -> bytes: + block = self.handle.read(size) + self.progress.advance(self.task, advance=len(block)) + return block + + def readinto(self, b: Union[bytearray, memoryview, mmap]): # type: ignore[no-untyped-def, override] + n = self.handle.readinto(b) # type: ignore[attr-defined] + self.progress.advance(self.task, advance=n) + return n + + def readline(self, size: int = -1) -> bytes: # type: ignore[override] + line = self.handle.readline(size) + self.progress.advance(self.task, advance=len(line)) + return line + + def readlines(self, hint: int = -1) -> List[bytes]: + lines = self.handle.readlines(hint) + self.progress.advance(self.task, advance=sum(map(len, lines))) + return lines + + def close(self) -> None: + if self.close_handle: + self.handle.close() + self._closed = True + + def seek(self, offset: int, whence: int = 0) -> int: + pos = self.handle.seek(offset, whence) + self.progress.update(self.task, completed=pos) + return pos + + def tell(self) -> int: + return self.handle.tell() + + def write(self, s: Any) -> int: + raise UnsupportedOperation("write") + + +class _ReadContext(ContextManager[_I], Generic[_I]): + """A utility class to handle a context for both a reader and a progress.""" + + def __init__(self, progress: "Progress", reader: _I) -> None: + self.progress = progress + self.reader: _I = reader + + def __enter__(self) -> _I: + self.progress.start() + return self.reader.__enter__() + + def __exit__( + self, + exc_type: Optional[Type[BaseException]], + exc_val: Optional[BaseException], + exc_tb: Optional[TracebackType], + ) -> None: + self.progress.stop() + self.reader.__exit__(exc_type, exc_val, exc_tb) + + +def wrap_file( + file: BinaryIO, + total: int, + *, + description: str = "Reading...", + auto_refresh: bool = True, + console: Optional[Console] = None, + transient: bool = False, + get_time: Optional[Callable[[], float]] = None, + refresh_per_second: float = 10, + style: StyleType = "bar.back", + complete_style: StyleType = "bar.complete", + finished_style: StyleType = "bar.finished", + pulse_style: StyleType = "bar.pulse", + disable: bool = False, +) -> ContextManager[BinaryIO]: + """Read bytes from a file while tracking progress. + + Args: + file (Union[str, PathLike[str], BinaryIO]): The path to the file to read, or a file-like object in binary mode. + total (int): Total number of bytes to read. + description (str, optional): Description of task show next to progress bar. Defaults to "Reading". + auto_refresh (bool, optional): Automatic refresh, disable to force a refresh after each iteration. Default is True. + transient: (bool, optional): Clear the progress on exit. Defaults to False. + console (Console, optional): Console to write to. Default creates internal Console instance. + refresh_per_second (float): Number of times per second to refresh the progress information. Defaults to 10. + style (StyleType, optional): Style for the bar background. Defaults to "bar.back". + complete_style (StyleType, optional): Style for the completed bar. Defaults to "bar.complete". + finished_style (StyleType, optional): Style for a finished bar. Defaults to "bar.finished". + pulse_style (StyleType, optional): Style for pulsing bars. Defaults to "bar.pulse". + disable (bool, optional): Disable display of progress. + Returns: + ContextManager[BinaryIO]: A context manager yielding a progress reader. + + """ + + columns: List["ProgressColumn"] = ( + [TextColumn("[progress.description]{task.description}")] if description else [] + ) + columns.extend( + ( + BarColumn( + style=style, + complete_style=complete_style, + finished_style=finished_style, + pulse_style=pulse_style, + ), + DownloadColumn(), + TimeRemainingColumn(), + ) + ) + progress = Progress( + *columns, + auto_refresh=auto_refresh, + console=console, + transient=transient, + get_time=get_time, + refresh_per_second=refresh_per_second or 10, + disable=disable, + ) + + reader = progress.wrap_file(file, total=total, description=description) + return _ReadContext(progress, reader) + + +@typing.overload +def open( + file: Union[str, "PathLike[str]", bytes], + mode: Union[Literal["rt"], Literal["r"]], + buffering: int = -1, + encoding: Optional[str] = None, + errors: Optional[str] = None, + newline: Optional[str] = None, + *, + total: Optional[int] = None, + description: str = "Reading...", + auto_refresh: bool = True, + console: Optional[Console] = None, + transient: bool = False, + get_time: Optional[Callable[[], float]] = None, + refresh_per_second: float = 10, + style: StyleType = "bar.back", + complete_style: StyleType = "bar.complete", + finished_style: StyleType = "bar.finished", + pulse_style: StyleType = "bar.pulse", + disable: bool = False, +) -> ContextManager[TextIO]: + pass + + +@typing.overload +def open( + file: Union[str, "PathLike[str]", bytes], + mode: Literal["rb"], + buffering: int = -1, + encoding: Optional[str] = None, + errors: Optional[str] = None, + newline: Optional[str] = None, + *, + total: Optional[int] = None, + description: str = "Reading...", + auto_refresh: bool = True, + console: Optional[Console] = None, + transient: bool = False, + get_time: Optional[Callable[[], float]] = None, + refresh_per_second: float = 10, + style: StyleType = "bar.back", + complete_style: StyleType = "bar.complete", + finished_style: StyleType = "bar.finished", + pulse_style: StyleType = "bar.pulse", + disable: bool = False, +) -> ContextManager[BinaryIO]: + pass + + +def open( + file: Union[str, "PathLike[str]", bytes], + mode: Union[Literal["rb"], Literal["rt"], Literal["r"]] = "r", + buffering: int = -1, + encoding: Optional[str] = None, + errors: Optional[str] = None, + newline: Optional[str] = None, + *, + total: Optional[int] = None, + description: str = "Reading...", + auto_refresh: bool = True, + console: Optional[Console] = None, + transient: bool = False, + get_time: Optional[Callable[[], float]] = None, + refresh_per_second: float = 10, + style: StyleType = "bar.back", + complete_style: StyleType = "bar.complete", + finished_style: StyleType = "bar.finished", + pulse_style: StyleType = "bar.pulse", + disable: bool = False, +) -> Union[ContextManager[BinaryIO], ContextManager[TextIO]]: + """Read bytes from a file while tracking progress. + + Args: + path (Union[str, PathLike[str], BinaryIO]): The path to the file to read, or a file-like object in binary mode. + mode (str): The mode to use to open the file. Only supports "r", "rb" or "rt". + buffering (int): The buffering strategy to use, see :func:`io.open`. + encoding (str, optional): The encoding to use when reading in text mode, see :func:`io.open`. + errors (str, optional): The error handling strategy for decoding errors, see :func:`io.open`. + newline (str, optional): The strategy for handling newlines in text mode, see :func:`io.open` + total: (int, optional): Total number of bytes to read. Must be provided if reading from a file handle. Default for a path is os.stat(file).st_size. + description (str, optional): Description of task show next to progress bar. Defaults to "Reading". + auto_refresh (bool, optional): Automatic refresh, disable to force a refresh after each iteration. Default is True. + transient: (bool, optional): Clear the progress on exit. Defaults to False. + console (Console, optional): Console to write to. Default creates internal Console instance. + refresh_per_second (float): Number of times per second to refresh the progress information. Defaults to 10. + style (StyleType, optional): Style for the bar background. Defaults to "bar.back". + complete_style (StyleType, optional): Style for the completed bar. Defaults to "bar.complete". + finished_style (StyleType, optional): Style for a finished bar. Defaults to "bar.finished". + pulse_style (StyleType, optional): Style for pulsing bars. Defaults to "bar.pulse". + disable (bool, optional): Disable display of progress. + encoding (str, optional): The encoding to use when reading in text mode. + + Returns: + ContextManager[BinaryIO]: A context manager yielding a progress reader. + + """ + + columns: List["ProgressColumn"] = ( + [TextColumn("[progress.description]{task.description}")] if description else [] + ) + columns.extend( + ( + BarColumn( + style=style, + complete_style=complete_style, + finished_style=finished_style, + pulse_style=pulse_style, + ), + DownloadColumn(), + TimeRemainingColumn(), + ) + ) + progress = Progress( + *columns, + auto_refresh=auto_refresh, + console=console, + transient=transient, + get_time=get_time, + refresh_per_second=refresh_per_second or 10, + disable=disable, + ) + + reader = progress.open( + file, + mode=mode, + buffering=buffering, + encoding=encoding, + errors=errors, + newline=newline, + total=total, + description=description, + ) + return _ReadContext(progress, reader) # type: ignore[return-value, type-var] + + +class ProgressColumn(ABC): + """Base class for a widget to use in progress display.""" + + max_refresh: Optional[float] = None + + def __init__(self, table_column: Optional[Column] = None) -> None: + self._table_column = table_column + self._renderable_cache: Dict[TaskID, Tuple[float, RenderableType]] = {} + self._update_time: Optional[float] = None + + def get_table_column(self) -> Column: + """Get a table column, used to build tasks table.""" + return self._table_column or Column() + + def __call__(self, task: "Task") -> RenderableType: + """Called by the Progress object to return a renderable for the given task. + + Args: + task (Task): An object containing information regarding the task. + + Returns: + RenderableType: Anything renderable (including str). + """ + current_time = task.get_time() + if self.max_refresh is not None and not task.completed: + try: + timestamp, renderable = self._renderable_cache[task.id] + except KeyError: + pass + else: + if timestamp + self.max_refresh > current_time: + return renderable + + renderable = self.render(task) + self._renderable_cache[task.id] = (current_time, renderable) + return renderable + + @abstractmethod + def render(self, task: "Task") -> RenderableType: + """Should return a renderable object.""" + + +class RenderableColumn(ProgressColumn): + """A column to insert an arbitrary column. + + Args: + renderable (RenderableType, optional): Any renderable. Defaults to empty string. + """ + + def __init__( + self, renderable: RenderableType = "", *, table_column: Optional[Column] = None + ): + self.renderable = renderable + super().__init__(table_column=table_column) + + def render(self, task: "Task") -> RenderableType: + return self.renderable + + +class SpinnerColumn(ProgressColumn): + """A column with a 'spinner' animation. + + Args: + spinner_name (str, optional): Name of spinner animation. Defaults to "dots". + style (StyleType, optional): Style of spinner. Defaults to "progress.spinner". + speed (float, optional): Speed factor of spinner. Defaults to 1.0. + finished_text (TextType, optional): Text used when task is finished. Defaults to " ". + """ + + def __init__( + self, + spinner_name: str = "dots", + style: Optional[StyleType] = "progress.spinner", + speed: float = 1.0, + finished_text: TextType = " ", + table_column: Optional[Column] = None, + ): + self.spinner = Spinner(spinner_name, style=style, speed=speed) + self.finished_text = ( + Text.from_markup(finished_text) + if isinstance(finished_text, str) + else finished_text + ) + super().__init__(table_column=table_column) + + def set_spinner( + self, + spinner_name: str, + spinner_style: Optional[StyleType] = "progress.spinner", + speed: float = 1.0, + ) -> None: + """Set a new spinner. + + Args: + spinner_name (str): Spinner name, see python -m rich.spinner. + spinner_style (Optional[StyleType], optional): Spinner style. Defaults to "progress.spinner". + speed (float, optional): Speed factor of spinner. Defaults to 1.0. + """ + self.spinner = Spinner(spinner_name, style=spinner_style, speed=speed) + + def render(self, task: "Task") -> RenderableType: + text = ( + self.finished_text + if task.finished + else self.spinner.render(task.get_time()) + ) + return text + + +class TextColumn(ProgressColumn): + """A column containing text.""" + + def __init__( + self, + text_format: str, + style: StyleType = "none", + justify: JustifyMethod = "left", + markup: bool = True, + highlighter: Optional[Highlighter] = None, + table_column: Optional[Column] = None, + ) -> None: + self.text_format = text_format + self.justify: JustifyMethod = justify + self.style = style + self.markup = markup + self.highlighter = highlighter + super().__init__(table_column=table_column or Column(no_wrap=True)) + + def render(self, task: "Task") -> Text: + _text = self.text_format.format(task=task) + if self.markup: + text = Text.from_markup(_text, style=self.style, justify=self.justify) + else: + text = Text(_text, style=self.style, justify=self.justify) + if self.highlighter: + self.highlighter.highlight(text) + return text + + +class BarColumn(ProgressColumn): + """Renders a visual progress bar. + + Args: + bar_width (Optional[int], optional): Width of bar or None for full width. Defaults to 40. + style (StyleType, optional): Style for the bar background. Defaults to "bar.back". + complete_style (StyleType, optional): Style for the completed bar. Defaults to "bar.complete". + finished_style (StyleType, optional): Style for a finished bar. Defaults to "bar.finished". + pulse_style (StyleType, optional): Style for pulsing bars. Defaults to "bar.pulse". + """ + + def __init__( + self, + bar_width: Optional[int] = 40, + style: StyleType = "bar.back", + complete_style: StyleType = "bar.complete", + finished_style: StyleType = "bar.finished", + pulse_style: StyleType = "bar.pulse", + table_column: Optional[Column] = None, + ) -> None: + self.bar_width = bar_width + self.style = style + self.complete_style = complete_style + self.finished_style = finished_style + self.pulse_style = pulse_style + super().__init__(table_column=table_column) + + def render(self, task: "Task") -> ProgressBar: + """Gets a progress bar widget for a task.""" + return ProgressBar( + total=max(0, task.total) if task.total is not None else None, + completed=max(0, task.completed), + width=None if self.bar_width is None else max(1, self.bar_width), + pulse=not task.started, + animation_time=task.get_time(), + style=self.style, + complete_style=self.complete_style, + finished_style=self.finished_style, + pulse_style=self.pulse_style, + ) + + +class TimeElapsedColumn(ProgressColumn): + """Renders time elapsed.""" + + def render(self, task: "Task") -> Text: + """Show time elapsed.""" + elapsed = task.finished_time if task.finished else task.elapsed + if elapsed is None: + return Text("-:--:--", style="progress.elapsed") + delta = timedelta(seconds=max(0, int(elapsed))) + return Text(str(delta), style="progress.elapsed") + + +class TaskProgressColumn(TextColumn): + """Show task progress as a percentage. + + Args: + text_format (str, optional): Format for percentage display. Defaults to "[progress.percentage]{task.percentage:>3.0f}%". + text_format_no_percentage (str, optional): Format if percentage is unknown. Defaults to "". + style (StyleType, optional): Style of output. Defaults to "none". + justify (JustifyMethod, optional): Text justification. Defaults to "left". + markup (bool, optional): Enable markup. Defaults to True. + highlighter (Optional[Highlighter], optional): Highlighter to apply to output. Defaults to None. + table_column (Optional[Column], optional): Table Column to use. Defaults to None. + show_speed (bool, optional): Show speed if total is unknown. Defaults to False. + """ + + def __init__( + self, + text_format: str = "[progress.percentage]{task.percentage:>3.0f}%", + text_format_no_percentage: str = "", + style: StyleType = "none", + justify: JustifyMethod = "left", + markup: bool = True, + highlighter: Optional[Highlighter] = None, + table_column: Optional[Column] = None, + show_speed: bool = False, + ) -> None: + self.text_format_no_percentage = text_format_no_percentage + self.show_speed = show_speed + super().__init__( + text_format=text_format, + style=style, + justify=justify, + markup=markup, + highlighter=highlighter, + table_column=table_column, + ) + + @classmethod + def render_speed(cls, speed: Optional[float]) -> Text: + """Render the speed in iterations per second. + + Args: + task (Task): A Task object. + + Returns: + Text: Text object containing the task speed. + """ + if speed is None: + return Text("", style="progress.percentage") + unit, suffix = filesize.pick_unit_and_suffix( + int(speed), + ["", "×10³", "×10⁶", "×10⁹", "×10¹²"], + 1000, + ) + data_speed = speed / unit + return Text(f"{data_speed:.1f}{suffix} it/s", style="progress.percentage") + + def render(self, task: "Task") -> Text: + if task.total is None and self.show_speed: + return self.render_speed(task.finished_speed or task.speed) + text_format = ( + self.text_format_no_percentage if task.total is None else self.text_format + ) + _text = text_format.format(task=task) + if self.markup: + text = Text.from_markup(_text, style=self.style, justify=self.justify) + else: + text = Text(_text, style=self.style, justify=self.justify) + if self.highlighter: + self.highlighter.highlight(text) + return text + + +class TimeRemainingColumn(ProgressColumn): + """Renders estimated time remaining. + + Args: + compact (bool, optional): Render MM:SS when time remaining is less than an hour. Defaults to False. + elapsed_when_finished (bool, optional): Render time elapsed when the task is finished. Defaults to False. + """ + + # Only refresh twice a second to prevent jitter + max_refresh = 0.5 + + def __init__( + self, + compact: bool = False, + elapsed_when_finished: bool = False, + table_column: Optional[Column] = None, + ): + self.compact = compact + self.elapsed_when_finished = elapsed_when_finished + super().__init__(table_column=table_column) + + def render(self, task: "Task") -> Text: + """Show time remaining.""" + if self.elapsed_when_finished and task.finished: + task_time = task.finished_time + style = "progress.elapsed" + else: + task_time = task.time_remaining + style = "progress.remaining" + + if task.total is None: + return Text("", style=style) + + if task_time is None: + return Text("--:--" if self.compact else "-:--:--", style=style) + + # Based on https://github.com/tqdm/tqdm/blob/master/tqdm/std.py + minutes, seconds = divmod(int(task_time), 60) + hours, minutes = divmod(minutes, 60) + + if self.compact and not hours: + formatted = f"{minutes:02d}:{seconds:02d}" + else: + formatted = f"{hours:d}:{minutes:02d}:{seconds:02d}" + + return Text(formatted, style=style) + + +class FileSizeColumn(ProgressColumn): + """Renders completed filesize.""" + + def render(self, task: "Task") -> Text: + """Show data completed.""" + data_size = filesize.decimal(int(task.completed)) + return Text(data_size, style="progress.filesize") + + +class TotalFileSizeColumn(ProgressColumn): + """Renders total filesize.""" + + def render(self, task: "Task") -> Text: + """Show data completed.""" + data_size = filesize.decimal(int(task.total)) if task.total is not None else "" + return Text(data_size, style="progress.filesize.total") + + +class MofNCompleteColumn(ProgressColumn): + """Renders completed count/total, e.g. ' 10/1000'. + + Best for bounded tasks with int quantities. + + Space pads the completed count so that progress length does not change as task progresses + past powers of 10. + + Args: + separator (str, optional): Text to separate completed and total values. Defaults to "/". + """ + + def __init__(self, separator: str = "/", table_column: Optional[Column] = None): + self.separator = separator + super().__init__(table_column=table_column) + + def render(self, task: "Task") -> Text: + """Show completed/total.""" + completed = int(task.completed) + total = int(task.total) if task.total is not None else "?" + total_width = len(str(total)) + return Text( + f"{completed:{total_width}d}{self.separator}{total}", + style="progress.download", + ) + + +class DownloadColumn(ProgressColumn): + """Renders file size downloaded and total, e.g. '0.5/2.3 GB'. + + Args: + binary_units (bool, optional): Use binary units, KiB, MiB etc. Defaults to False. + """ + + def __init__( + self, binary_units: bool = False, table_column: Optional[Column] = None + ) -> None: + self.binary_units = binary_units + super().__init__(table_column=table_column) + + def render(self, task: "Task") -> Text: + """Calculate common unit for completed and total.""" + completed = int(task.completed) + + unit_and_suffix_calculation_base = ( + int(task.total) if task.total is not None else completed + ) + if self.binary_units: + unit, suffix = filesize.pick_unit_and_suffix( + unit_and_suffix_calculation_base, + ["bytes", "KiB", "MiB", "GiB", "TiB", "PiB", "EiB", "ZiB", "YiB"], + 1024, + ) + else: + unit, suffix = filesize.pick_unit_and_suffix( + unit_and_suffix_calculation_base, + ["bytes", "kB", "MB", "GB", "TB", "PB", "EB", "ZB", "YB"], + 1000, + ) + precision = 0 if unit == 1 else 1 + + completed_ratio = completed / unit + completed_str = f"{completed_ratio:,.{precision}f}" + + if task.total is not None: + total = int(task.total) + total_ratio = total / unit + total_str = f"{total_ratio:,.{precision}f}" + else: + total_str = "?" + + download_status = f"{completed_str}/{total_str} {suffix}" + download_text = Text(download_status, style="progress.download") + return download_text + + +class TransferSpeedColumn(ProgressColumn): + """Renders human readable transfer speed.""" + + def render(self, task: "Task") -> Text: + """Show data transfer speed.""" + speed = task.finished_speed or task.speed + if speed is None: + return Text("?", style="progress.data.speed") + data_speed = filesize.decimal(int(speed)) + return Text(f"{data_speed}/s", style="progress.data.speed") + + +class ProgressSample(NamedTuple): + """Sample of progress for a given time.""" + + timestamp: float + """Timestamp of sample.""" + completed: float + """Number of steps completed.""" + + +@dataclass +class Task: + """Information regarding a progress task. + + This object should be considered read-only outside of the :class:`~Progress` class. + + """ + + id: TaskID + """Task ID associated with this task (used in Progress methods).""" + + description: str + """str: Description of the task.""" + + total: Optional[float] + """Optional[float]: Total number of steps in this task.""" + + completed: float + """float: Number of steps completed""" + + _get_time: GetTimeCallable + """Callable to get the current time.""" + + finished_time: Optional[float] = None + """float: Time task was finished.""" + + visible: bool = True + """bool: Indicates if this task is visible in the progress display.""" + + fields: Dict[str, Any] = field(default_factory=dict) + """dict: Arbitrary fields passed in via Progress.update.""" + + start_time: Optional[float] = field(default=None, init=False, repr=False) + """Optional[float]: Time this task was started, or None if not started.""" + + stop_time: Optional[float] = field(default=None, init=False, repr=False) + """Optional[float]: Time this task was stopped, or None if not stopped.""" + + finished_speed: Optional[float] = None + """Optional[float]: The last speed for a finished task.""" + + _progress: Deque[ProgressSample] = field( + default_factory=lambda: deque(maxlen=1000), init=False, repr=False + ) + + _lock: RLock = field(repr=False, default_factory=RLock) + """Thread lock.""" + + def get_time(self) -> float: + """float: Get the current time, in seconds.""" + return self._get_time() + + @property + def started(self) -> bool: + """bool: Check if the task as started.""" + return self.start_time is not None + + @property + def remaining(self) -> Optional[float]: + """Optional[float]: Get the number of steps remaining, if a non-None total was set.""" + if self.total is None: + return None + return self.total - self.completed + + @property + def elapsed(self) -> Optional[float]: + """Optional[float]: Time elapsed since task was started, or ``None`` if the task hasn't started.""" + if self.start_time is None: + return None + if self.stop_time is not None: + return self.stop_time - self.start_time + return self.get_time() - self.start_time + + @property + def finished(self) -> bool: + """Check if the task has finished.""" + return self.finished_time is not None + + @property + def percentage(self) -> float: + """float: Get progress of task as a percentage. If a None total was set, returns 0""" + if not self.total: + return 0.0 + completed = (self.completed / self.total) * 100.0 + completed = min(100.0, max(0.0, completed)) + return completed + + @property + def speed(self) -> Optional[float]: + """Optional[float]: Get the estimated speed in steps per second.""" + if self.start_time is None: + return None + with self._lock: + progress = self._progress + if not progress: + return None + total_time = progress[-1].timestamp - progress[0].timestamp + if total_time == 0: + return None + iter_progress = iter(progress) + next(iter_progress) + total_completed = sum(sample.completed for sample in iter_progress) + speed = total_completed / total_time + return speed + + @property + def time_remaining(self) -> Optional[float]: + """Optional[float]: Get estimated time to completion, or ``None`` if no data.""" + if self.finished: + return 0.0 + speed = self.speed + if not speed: + return None + remaining = self.remaining + if remaining is None: + return None + estimate = ceil(remaining / speed) + return estimate + + def _reset(self) -> None: + """Reset progress.""" + self._progress.clear() + self.finished_time = None + self.finished_speed = None + + +class Progress(JupyterMixin): + """Renders an auto-updating progress bar(s). + + Args: + console (Console, optional): Optional Console instance. Default will an internal Console instance writing to stdout. + auto_refresh (bool, optional): Enable auto refresh. If disabled, you will need to call `refresh()`. + refresh_per_second (Optional[float], optional): Number of times per second to refresh the progress information or None to use default (10). Defaults to None. + speed_estimate_period: (float, optional): Period (in seconds) used to calculate the speed estimate. Defaults to 30. + transient: (bool, optional): Clear the progress on exit. Defaults to False. + redirect_stdout: (bool, optional): Enable redirection of stdout, so ``print`` may be used. Defaults to True. + redirect_stderr: (bool, optional): Enable redirection of stderr. Defaults to True. + get_time: (Callable, optional): A callable that gets the current time, or None to use Console.get_time. Defaults to None. + disable (bool, optional): Disable progress display. Defaults to False + expand (bool, optional): Expand tasks table to fit width. Defaults to False. + """ + + def __init__( + self, + *columns: Union[str, ProgressColumn], + console: Optional[Console] = None, + auto_refresh: bool = True, + refresh_per_second: float = 10, + speed_estimate_period: float = 30.0, + transient: bool = False, + redirect_stdout: bool = True, + redirect_stderr: bool = True, + get_time: Optional[GetTimeCallable] = None, + disable: bool = False, + expand: bool = False, + ) -> None: + assert refresh_per_second > 0, "refresh_per_second must be > 0" + self._lock = RLock() + self.columns = columns or self.get_default_columns() + self.speed_estimate_period = speed_estimate_period + + self.disable = disable + self.expand = expand + self._tasks: Dict[TaskID, Task] = {} + self._task_index: TaskID = TaskID(0) + self.live = Live( + console=console or get_console(), + auto_refresh=auto_refresh, + refresh_per_second=refresh_per_second, + transient=transient, + redirect_stdout=redirect_stdout, + redirect_stderr=redirect_stderr, + get_renderable=self.get_renderable, + ) + self.get_time = get_time or self.console.get_time + self.print = self.console.print + self.log = self.console.log + + @classmethod + def get_default_columns(cls) -> Tuple[ProgressColumn, ...]: + """Get the default columns used for a new Progress instance: + - a text column for the description (TextColumn) + - the bar itself (BarColumn) + - a text column showing completion percentage (TextColumn) + - an estimated-time-remaining column (TimeRemainingColumn) + If the Progress instance is created without passing a columns argument, + the default columns defined here will be used. + + You can also create a Progress instance using custom columns before + and/or after the defaults, as in this example: + + progress = Progress( + SpinnerColumn(), + *Progress.get_default_columns(), + "Elapsed:", + TimeElapsedColumn(), + ) + + This code shows the creation of a Progress display, containing + a spinner to the left, the default columns, and a labeled elapsed + time column. + """ + return ( + TextColumn("[progress.description]{task.description}"), + BarColumn(), + TaskProgressColumn(), + TimeRemainingColumn(), + ) + + @property + def console(self) -> Console: + return self.live.console + + @property + def tasks(self) -> List[Task]: + """Get a list of Task instances.""" + with self._lock: + return list(self._tasks.values()) + + @property + def task_ids(self) -> List[TaskID]: + """A list of task IDs.""" + with self._lock: + return list(self._tasks.keys()) + + @property + def finished(self) -> bool: + """Check if all tasks have been completed.""" + with self._lock: + if not self._tasks: + return True + return all(task.finished for task in self._tasks.values()) + + def start(self) -> None: + """Start the progress display.""" + if not self.disable: + self.live.start(refresh=True) + + def stop(self) -> None: + """Stop the progress display.""" + self.live.stop() + if not self.console.is_interactive: + self.console.print() + + def __enter__(self) -> "Progress": + self.start() + return self + + def __exit__( + self, + exc_type: Optional[Type[BaseException]], + exc_val: Optional[BaseException], + exc_tb: Optional[TracebackType], + ) -> None: + self.stop() + + def track( + self, + sequence: Union[Iterable[ProgressType], Sequence[ProgressType]], + total: Optional[float] = None, + task_id: Optional[TaskID] = None, + description: str = "Working...", + update_period: float = 0.1, + ) -> Iterable[ProgressType]: + """Track progress by iterating over a sequence. + + Args: + sequence (Sequence[ProgressType]): A sequence of values you want to iterate over and track progress. + total: (float, optional): Total number of steps. Default is len(sequence). + task_id: (TaskID): Task to track. Default is new task. + description: (str, optional): Description of task, if new task is created. + update_period (float, optional): Minimum time (in seconds) between calls to update(). Defaults to 0.1. + + Returns: + Iterable[ProgressType]: An iterable of values taken from the provided sequence. + """ + if total is None: + total = float(length_hint(sequence)) or None + + if task_id is None: + task_id = self.add_task(description, total=total) + else: + self.update(task_id, total=total) + + if self.live.auto_refresh: + with _TrackThread(self, task_id, update_period) as track_thread: + for value in sequence: + yield value + track_thread.completed += 1 + else: + advance = self.advance + refresh = self.refresh + for value in sequence: + yield value + advance(task_id, 1) + refresh() + + def wrap_file( + self, + file: BinaryIO, + total: Optional[int] = None, + *, + task_id: Optional[TaskID] = None, + description: str = "Reading...", + ) -> BinaryIO: + """Track progress file reading from a binary file. + + Args: + file (BinaryIO): A file-like object opened in binary mode. + total (int, optional): Total number of bytes to read. This must be provided unless a task with a total is also given. + task_id (TaskID): Task to track. Default is new task. + description (str, optional): Description of task, if new task is created. + + Returns: + BinaryIO: A readable file-like object in binary mode. + + Raises: + ValueError: When no total value can be extracted from the arguments or the task. + """ + # attempt to recover the total from the task + total_bytes: Optional[float] = None + if total is not None: + total_bytes = total + elif task_id is not None: + with self._lock: + total_bytes = self._tasks[task_id].total + if total_bytes is None: + raise ValueError( + f"unable to get the total number of bytes, please specify 'total'" + ) + + # update total of task or create new task + if task_id is None: + task_id = self.add_task(description, total=total_bytes) + else: + self.update(task_id, total=total_bytes) + + return _Reader(file, self, task_id, close_handle=False) + + @typing.overload + def open( + self, + file: Union[str, "PathLike[str]", bytes], + mode: Literal["rb"], + buffering: int = -1, + encoding: Optional[str] = None, + errors: Optional[str] = None, + newline: Optional[str] = None, + *, + total: Optional[int] = None, + task_id: Optional[TaskID] = None, + description: str = "Reading...", + ) -> BinaryIO: + pass + + @typing.overload + def open( + self, + file: Union[str, "PathLike[str]", bytes], + mode: Union[Literal["r"], Literal["rt"]], + buffering: int = -1, + encoding: Optional[str] = None, + errors: Optional[str] = None, + newline: Optional[str] = None, + *, + total: Optional[int] = None, + task_id: Optional[TaskID] = None, + description: str = "Reading...", + ) -> TextIO: + pass + + def open( + self, + file: Union[str, "PathLike[str]", bytes], + mode: Union[Literal["rb"], Literal["rt"], Literal["r"]] = "r", + buffering: int = -1, + encoding: Optional[str] = None, + errors: Optional[str] = None, + newline: Optional[str] = None, + *, + total: Optional[int] = None, + task_id: Optional[TaskID] = None, + description: str = "Reading...", + ) -> Union[BinaryIO, TextIO]: + """Track progress while reading from a binary file. + + Args: + path (Union[str, PathLike[str]]): The path to the file to read. + mode (str): The mode to use to open the file. Only supports "r", "rb" or "rt". + buffering (int): The buffering strategy to use, see :func:`io.open`. + encoding (str, optional): The encoding to use when reading in text mode, see :func:`io.open`. + errors (str, optional): The error handling strategy for decoding errors, see :func:`io.open`. + newline (str, optional): The strategy for handling newlines in text mode, see :func:`io.open`. + total (int, optional): Total number of bytes to read. If none given, os.stat(path).st_size is used. + task_id (TaskID): Task to track. Default is new task. + description (str, optional): Description of task, if new task is created. + + Returns: + BinaryIO: A readable file-like object in binary mode. + + Raises: + ValueError: When an invalid mode is given. + """ + # normalize the mode (always rb, rt) + _mode = "".join(sorted(mode, reverse=False)) + if _mode not in ("br", "rt", "r"): + raise ValueError("invalid mode {!r}".format(mode)) + + # patch buffering to provide the same behaviour as the builtin `open` + line_buffering = buffering == 1 + if _mode == "br" and buffering == 1: + warnings.warn( + "line buffering (buffering=1) isn't supported in binary mode, the default buffer size will be used", + RuntimeWarning, + ) + buffering = -1 + elif _mode in ("rt", "r"): + if buffering == 0: + raise ValueError("can't have unbuffered text I/O") + elif buffering == 1: + buffering = -1 + + # attempt to get the total with `os.stat` + if total is None: + total = stat(file).st_size + + # update total of task or create new task + if task_id is None: + task_id = self.add_task(description, total=total) + else: + self.update(task_id, total=total) + + # open the file in binary mode, + handle = io.open(file, "rb", buffering=buffering) + reader = _Reader(handle, self, task_id, close_handle=True) + + # wrap the reader in a `TextIOWrapper` if text mode + if mode in ("r", "rt"): + return io.TextIOWrapper( + reader, + encoding=encoding, + errors=errors, + newline=newline, + line_buffering=line_buffering, + ) + + return reader + + def start_task(self, task_id: TaskID) -> None: + """Start a task. + + Starts a task (used when calculating elapsed time). You may need to call this manually, + if you called ``add_task`` with ``start=False``. + + Args: + task_id (TaskID): ID of task. + """ + with self._lock: + task = self._tasks[task_id] + if task.start_time is None: + task.start_time = self.get_time() + + def stop_task(self, task_id: TaskID) -> None: + """Stop a task. + + This will freeze the elapsed time on the task. + + Args: + task_id (TaskID): ID of task. + """ + with self._lock: + task = self._tasks[task_id] + current_time = self.get_time() + if task.start_time is None: + task.start_time = current_time + task.stop_time = current_time + + def update( + self, + task_id: TaskID, + *, + total: Optional[float] = None, + completed: Optional[float] = None, + advance: Optional[float] = None, + description: Optional[str] = None, + visible: Optional[bool] = None, + refresh: bool = False, + **fields: Any, + ) -> None: + """Update information associated with a task. + + Args: + task_id (TaskID): Task id (returned by add_task). + total (float, optional): Updates task.total if not None. + completed (float, optional): Updates task.completed if not None. + advance (float, optional): Add a value to task.completed if not None. + description (str, optional): Change task description if not None. + visible (bool, optional): Set visible flag if not None. + refresh (bool): Force a refresh of progress information. Default is False. + **fields (Any): Additional data fields required for rendering. + """ + with self._lock: + task = self._tasks[task_id] + completed_start = task.completed + + if total is not None and total != task.total: + task.total = total + task._reset() + if advance is not None: + task.completed += advance + if completed is not None: + task.completed = completed + if description is not None: + task.description = description + if visible is not None: + task.visible = visible + task.fields.update(fields) + update_completed = task.completed - completed_start + + current_time = self.get_time() + old_sample_time = current_time - self.speed_estimate_period + _progress = task._progress + + popleft = _progress.popleft + while _progress and _progress[0].timestamp < old_sample_time: + popleft() + if update_completed > 0: + _progress.append(ProgressSample(current_time, update_completed)) + if ( + task.total is not None + and task.completed >= task.total + and task.finished_time is None + ): + task.finished_time = task.elapsed + + if refresh: + self.refresh() + + def reset( + self, + task_id: TaskID, + *, + start: bool = True, + total: Optional[float] = None, + completed: int = 0, + visible: Optional[bool] = None, + description: Optional[str] = None, + **fields: Any, + ) -> None: + """Reset a task so completed is 0 and the clock is reset. + + Args: + task_id (TaskID): ID of task. + start (bool, optional): Start the task after reset. Defaults to True. + total (float, optional): New total steps in task, or None to use current total. Defaults to None. + completed (int, optional): Number of steps completed. Defaults to 0. + visible (bool, optional): Enable display of the task. Defaults to True. + description (str, optional): Change task description if not None. Defaults to None. + **fields (str): Additional data fields required for rendering. + """ + current_time = self.get_time() + with self._lock: + task = self._tasks[task_id] + task._reset() + task.start_time = current_time if start else None + if total is not None: + task.total = total + task.completed = completed + if visible is not None: + task.visible = visible + if fields: + task.fields = fields + if description is not None: + task.description = description + task.finished_time = None + self.refresh() + + def advance(self, task_id: TaskID, advance: float = 1) -> None: + """Advance task by a number of steps. + + Args: + task_id (TaskID): ID of task. + advance (float): Number of steps to advance. Default is 1. + """ + current_time = self.get_time() + with self._lock: + task = self._tasks[task_id] + completed_start = task.completed + task.completed += advance + update_completed = task.completed - completed_start + old_sample_time = current_time - self.speed_estimate_period + _progress = task._progress + + popleft = _progress.popleft + while _progress and _progress[0].timestamp < old_sample_time: + popleft() + while len(_progress) > 1000: + popleft() + _progress.append(ProgressSample(current_time, update_completed)) + if ( + task.total is not None + and task.completed >= task.total + and task.finished_time is None + ): + task.finished_time = task.elapsed + task.finished_speed = task.speed + + def refresh(self) -> None: + """Refresh (render) the progress information.""" + if not self.disable and self.live.is_started: + self.live.refresh() + + def get_renderable(self) -> RenderableType: + """Get a renderable for the progress display.""" + renderable = Group(*self.get_renderables()) + return renderable + + def get_renderables(self) -> Iterable[RenderableType]: + """Get a number of renderables for the progress display.""" + table = self.make_tasks_table(self.tasks) + yield table + + def make_tasks_table(self, tasks: Iterable[Task]) -> Table: + """Get a table to render the Progress display. + + Args: + tasks (Iterable[Task]): An iterable of Task instances, one per row of the table. + + Returns: + Table: A table instance. + """ + table_columns = ( + ( + Column(no_wrap=True) + if isinstance(_column, str) + else _column.get_table_column().copy() + ) + for _column in self.columns + ) + table = Table.grid(*table_columns, padding=(0, 1), expand=self.expand) + + for task in tasks: + if task.visible: + table.add_row( + *( + ( + column.format(task=task) + if isinstance(column, str) + else column(task) + ) + for column in self.columns + ) + ) + return table + + def __rich__(self) -> RenderableType: + """Makes the Progress class itself renderable.""" + with self._lock: + return self.get_renderable() + + def add_task( + self, + description: str, + start: bool = True, + total: Optional[float] = 100.0, + completed: int = 0, + visible: bool = True, + **fields: Any, + ) -> TaskID: + """Add a new 'task' to the Progress display. + + Args: + description (str): A description of the task. + start (bool, optional): Start the task immediately (to calculate elapsed time). If set to False, + you will need to call `start` manually. Defaults to True. + total (float, optional): Number of total steps in the progress if known. + Set to None to render a pulsing animation. Defaults to 100. + completed (int, optional): Number of steps completed so far. Defaults to 0. + visible (bool, optional): Enable display of the task. Defaults to True. + **fields (str): Additional data fields required for rendering. + + Returns: + TaskID: An ID you can use when calling `update`. + """ + with self._lock: + task = Task( + self._task_index, + description, + total, + completed, + visible=visible, + fields=fields, + _get_time=self.get_time, + _lock=self._lock, + ) + self._tasks[self._task_index] = task + if start: + self.start_task(self._task_index) + new_task_index = self._task_index + self._task_index = TaskID(int(self._task_index) + 1) + self.refresh() + return new_task_index + + def remove_task(self, task_id: TaskID) -> None: + """Delete a task if it exists. + + Args: + task_id (TaskID): A task ID. + + """ + with self._lock: + del self._tasks[task_id] + + +if __name__ == "__main__": # pragma: no coverage + import random + import time + + from .panel import Panel + from .rule import Rule + from .syntax import Syntax + from .table import Table + + syntax = Syntax( + '''def loop_last(values: Iterable[T]) -> Iterable[Tuple[bool, T]]: + """Iterate and generate a tuple with a flag for last value.""" + iter_values = iter(values) + try: + previous_value = next(iter_values) + except StopIteration: + return + for value in iter_values: + yield False, previous_value + previous_value = value + yield True, previous_value''', + "python", + line_numbers=True, + ) + + table = Table("foo", "bar", "baz") + table.add_row("1", "2", "3") + + progress_renderables = [ + "Text may be printed while the progress bars are rendering.", + Panel("In fact, [i]any[/i] renderable will work"), + "Such as [magenta]tables[/]...", + table, + "Pretty printed structures...", + {"type": "example", "text": "Pretty printed"}, + "Syntax...", + syntax, + Rule("Give it a try!"), + ] + + from itertools import cycle + + examples = cycle(progress_renderables) + + console = Console(record=True) + + with Progress( + SpinnerColumn(), + *Progress.get_default_columns(), + TimeElapsedColumn(), + console=console, + transient=False, + ) as progress: + task1 = progress.add_task("[red]Downloading", total=1000) + task2 = progress.add_task("[green]Processing", total=1000) + task3 = progress.add_task("[yellow]Thinking", total=None) + + while not progress.finished: + progress.update(task1, advance=0.5) + progress.update(task2, advance=0.3) + time.sleep(0.01) + if random.randint(0, 100) < 1: + progress.log(next(examples)) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/progress_bar.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/progress_bar.py new file mode 100644 index 0000000..a2bf326 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/progress_bar.py @@ -0,0 +1,223 @@ +import math +from functools import lru_cache +from time import monotonic +from typing import Iterable, List, Optional + +from .color import Color, blend_rgb +from .color_triplet import ColorTriplet +from .console import Console, ConsoleOptions, RenderResult +from .jupyter import JupyterMixin +from .measure import Measurement +from .segment import Segment +from .style import Style, StyleType + +# Number of characters before 'pulse' animation repeats +PULSE_SIZE = 20 + + +class ProgressBar(JupyterMixin): + """Renders a (progress) bar. Used by rich.progress. + + Args: + total (float, optional): Number of steps in the bar. Defaults to 100. Set to None to render a pulsing animation. + completed (float, optional): Number of steps completed. Defaults to 0. + width (int, optional): Width of the bar, or ``None`` for maximum width. Defaults to None. + pulse (bool, optional): Enable pulse effect. Defaults to False. Will pulse if a None total was passed. + style (StyleType, optional): Style for the bar background. Defaults to "bar.back". + complete_style (StyleType, optional): Style for the completed bar. Defaults to "bar.complete". + finished_style (StyleType, optional): Style for a finished bar. Defaults to "bar.finished". + pulse_style (StyleType, optional): Style for pulsing bars. Defaults to "bar.pulse". + animation_time (Optional[float], optional): Time in seconds to use for animation, or None to use system time. + """ + + def __init__( + self, + total: Optional[float] = 100.0, + completed: float = 0, + width: Optional[int] = None, + pulse: bool = False, + style: StyleType = "bar.back", + complete_style: StyleType = "bar.complete", + finished_style: StyleType = "bar.finished", + pulse_style: StyleType = "bar.pulse", + animation_time: Optional[float] = None, + ): + self.total = total + self.completed = completed + self.width = width + self.pulse = pulse + self.style = style + self.complete_style = complete_style + self.finished_style = finished_style + self.pulse_style = pulse_style + self.animation_time = animation_time + + self._pulse_segments: Optional[List[Segment]] = None + + def __repr__(self) -> str: + return f"" + + @property + def percentage_completed(self) -> Optional[float]: + """Calculate percentage complete.""" + if self.total is None: + return None + completed = (self.completed / self.total) * 100.0 + completed = min(100, max(0.0, completed)) + return completed + + @lru_cache(maxsize=16) + def _get_pulse_segments( + self, + fore_style: Style, + back_style: Style, + color_system: str, + no_color: bool, + ascii: bool = False, + ) -> List[Segment]: + """Get a list of segments to render a pulse animation. + + Returns: + List[Segment]: A list of segments, one segment per character. + """ + bar = "-" if ascii else "━" + segments: List[Segment] = [] + if color_system not in ("standard", "eight_bit", "truecolor") or no_color: + segments += [Segment(bar, fore_style)] * (PULSE_SIZE // 2) + segments += [Segment(" " if no_color else bar, back_style)] * ( + PULSE_SIZE - (PULSE_SIZE // 2) + ) + return segments + + append = segments.append + fore_color = ( + fore_style.color.get_truecolor() + if fore_style.color + else ColorTriplet(255, 0, 255) + ) + back_color = ( + back_style.color.get_truecolor() + if back_style.color + else ColorTriplet(0, 0, 0) + ) + cos = math.cos + pi = math.pi + _Segment = Segment + _Style = Style + from_triplet = Color.from_triplet + + for index in range(PULSE_SIZE): + position = index / PULSE_SIZE + fade = 0.5 + cos((position * pi * 2)) / 2.0 + color = blend_rgb(fore_color, back_color, cross_fade=fade) + append(_Segment(bar, _Style(color=from_triplet(color)))) + return segments + + def update(self, completed: float, total: Optional[float] = None) -> None: + """Update progress with new values. + + Args: + completed (float): Number of steps completed. + total (float, optional): Total number of steps, or ``None`` to not change. Defaults to None. + """ + self.completed = completed + self.total = total if total is not None else self.total + + def _render_pulse( + self, console: Console, width: int, ascii: bool = False + ) -> Iterable[Segment]: + """Renders the pulse animation. + + Args: + console (Console): Console instance. + width (int): Width in characters of pulse animation. + + Returns: + RenderResult: [description] + + Yields: + Iterator[Segment]: Segments to render pulse + """ + fore_style = console.get_style(self.pulse_style, default="white") + back_style = console.get_style(self.style, default="black") + + pulse_segments = self._get_pulse_segments( + fore_style, back_style, console.color_system, console.no_color, ascii=ascii + ) + segment_count = len(pulse_segments) + current_time = ( + monotonic() if self.animation_time is None else self.animation_time + ) + segments = pulse_segments * (int(width / segment_count) + 2) + offset = int(-current_time * 15) % segment_count + segments = segments[offset : offset + width] + yield from segments + + def __rich_console__( + self, console: Console, options: ConsoleOptions + ) -> RenderResult: + width = min(self.width or options.max_width, options.max_width) + ascii = options.legacy_windows or options.ascii_only + should_pulse = self.pulse or self.total is None + if should_pulse: + yield from self._render_pulse(console, width, ascii=ascii) + return + + completed: Optional[float] = ( + min(self.total, max(0, self.completed)) if self.total is not None else None + ) + + bar = "-" if ascii else "━" + half_bar_right = " " if ascii else "╸" + half_bar_left = " " if ascii else "╺" + complete_halves = ( + int(width * 2 * completed / self.total) + if self.total and completed is not None + else width * 2 + ) + bar_count = complete_halves // 2 + half_bar_count = complete_halves % 2 + style = console.get_style(self.style) + is_finished = self.total is None or self.completed >= self.total + complete_style = console.get_style( + self.finished_style if is_finished else self.complete_style + ) + _Segment = Segment + if bar_count: + yield _Segment(bar * bar_count, complete_style) + if half_bar_count: + yield _Segment(half_bar_right * half_bar_count, complete_style) + + if not console.no_color: + remaining_bars = width - bar_count - half_bar_count + if remaining_bars and console.color_system is not None: + if not half_bar_count and bar_count: + yield _Segment(half_bar_left, style) + remaining_bars -= 1 + if remaining_bars: + yield _Segment(bar * remaining_bars, style) + + def __rich_measure__( + self, console: Console, options: ConsoleOptions + ) -> Measurement: + return ( + Measurement(self.width, self.width) + if self.width is not None + else Measurement(4, options.max_width) + ) + + +if __name__ == "__main__": # pragma: no cover + console = Console() + bar = ProgressBar(width=50, total=100) + + import time + + console.show_cursor(False) + for n in range(0, 101, 1): + bar.update(n) + console.print(bar) + console.file.write("\r") + time.sleep(0.05) + console.show_cursor(True) + console.print() diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/prompt.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/prompt.py new file mode 100644 index 0000000..75ff048 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/prompt.py @@ -0,0 +1,375 @@ +from typing import Any, Generic, List, Optional, TextIO, TypeVar, Union, overload + +from . import get_console +from .console import Console +from .text import Text, TextType + +PromptType = TypeVar("PromptType") +DefaultType = TypeVar("DefaultType") + + +class PromptError(Exception): + """Exception base class for prompt related errors.""" + + +class InvalidResponse(PromptError): + """Exception to indicate a response was invalid. Raise this within process_response() to indicate an error + and provide an error message. + + Args: + message (Union[str, Text]): Error message. + """ + + def __init__(self, message: TextType) -> None: + self.message = message + + def __rich__(self) -> TextType: + return self.message + + +class PromptBase(Generic[PromptType]): + """Ask the user for input until a valid response is received. This is the base class, see one of + the concrete classes for examples. + + Args: + prompt (TextType, optional): Prompt text. Defaults to "". + console (Console, optional): A Console instance or None to use global console. Defaults to None. + password (bool, optional): Enable password input. Defaults to False. + choices (List[str], optional): A list of valid choices. Defaults to None. + show_default (bool, optional): Show default in prompt. Defaults to True. + show_choices (bool, optional): Show choices in prompt. Defaults to True. + """ + + response_type: type = str + + validate_error_message = "[prompt.invalid]Please enter a valid value" + illegal_choice_message = ( + "[prompt.invalid.choice]Please select one of the available options" + ) + prompt_suffix = ": " + + choices: Optional[List[str]] = None + + def __init__( + self, + prompt: TextType = "", + *, + console: Optional[Console] = None, + password: bool = False, + choices: Optional[List[str]] = None, + show_default: bool = True, + show_choices: bool = True, + ) -> None: + self.console = console or get_console() + self.prompt = ( + Text.from_markup(prompt, style="prompt") + if isinstance(prompt, str) + else prompt + ) + self.password = password + if choices is not None: + self.choices = choices + self.show_default = show_default + self.show_choices = show_choices + + @classmethod + @overload + def ask( + cls, + prompt: TextType = "", + *, + console: Optional[Console] = None, + password: bool = False, + choices: Optional[List[str]] = None, + show_default: bool = True, + show_choices: bool = True, + default: DefaultType, + stream: Optional[TextIO] = None, + ) -> Union[DefaultType, PromptType]: + ... + + @classmethod + @overload + def ask( + cls, + prompt: TextType = "", + *, + console: Optional[Console] = None, + password: bool = False, + choices: Optional[List[str]] = None, + show_default: bool = True, + show_choices: bool = True, + stream: Optional[TextIO] = None, + ) -> PromptType: + ... + + @classmethod + def ask( + cls, + prompt: TextType = "", + *, + console: Optional[Console] = None, + password: bool = False, + choices: Optional[List[str]] = None, + show_default: bool = True, + show_choices: bool = True, + default: Any = ..., + stream: Optional[TextIO] = None, + ) -> Any: + """Shortcut to construct and run a prompt loop and return the result. + + Example: + >>> filename = Prompt.ask("Enter a filename") + + Args: + prompt (TextType, optional): Prompt text. Defaults to "". + console (Console, optional): A Console instance or None to use global console. Defaults to None. + password (bool, optional): Enable password input. Defaults to False. + choices (List[str], optional): A list of valid choices. Defaults to None. + show_default (bool, optional): Show default in prompt. Defaults to True. + show_choices (bool, optional): Show choices in prompt. Defaults to True. + stream (TextIO, optional): Optional text file open for reading to get input. Defaults to None. + """ + _prompt = cls( + prompt, + console=console, + password=password, + choices=choices, + show_default=show_default, + show_choices=show_choices, + ) + return _prompt(default=default, stream=stream) + + def render_default(self, default: DefaultType) -> Text: + """Turn the supplied default in to a Text instance. + + Args: + default (DefaultType): Default value. + + Returns: + Text: Text containing rendering of default value. + """ + return Text(f"({default})", "prompt.default") + + def make_prompt(self, default: DefaultType) -> Text: + """Make prompt text. + + Args: + default (DefaultType): Default value. + + Returns: + Text: Text to display in prompt. + """ + prompt = self.prompt.copy() + prompt.end = "" + + if self.show_choices and self.choices: + _choices = "/".join(self.choices) + choices = f"[{_choices}]" + prompt.append(" ") + prompt.append(choices, "prompt.choices") + + if ( + default != ... + and self.show_default + and isinstance(default, (str, self.response_type)) + ): + prompt.append(" ") + _default = self.render_default(default) + prompt.append(_default) + + prompt.append(self.prompt_suffix) + + return prompt + + @classmethod + def get_input( + cls, + console: Console, + prompt: TextType, + password: bool, + stream: Optional[TextIO] = None, + ) -> str: + """Get input from user. + + Args: + console (Console): Console instance. + prompt (TextType): Prompt text. + password (bool): Enable password entry. + + Returns: + str: String from user. + """ + return console.input(prompt, password=password, stream=stream) + + def check_choice(self, value: str) -> bool: + """Check value is in the list of valid choices. + + Args: + value (str): Value entered by user. + + Returns: + bool: True if choice was valid, otherwise False. + """ + assert self.choices is not None + return value.strip() in self.choices + + def process_response(self, value: str) -> PromptType: + """Process response from user, convert to prompt type. + + Args: + value (str): String typed by user. + + Raises: + InvalidResponse: If ``value`` is invalid. + + Returns: + PromptType: The value to be returned from ask method. + """ + value = value.strip() + try: + return_value: PromptType = self.response_type(value) + except ValueError: + raise InvalidResponse(self.validate_error_message) + + if self.choices is not None and not self.check_choice(value): + raise InvalidResponse(self.illegal_choice_message) + + return return_value + + def on_validate_error(self, value: str, error: InvalidResponse) -> None: + """Called to handle validation error. + + Args: + value (str): String entered by user. + error (InvalidResponse): Exception instance the initiated the error. + """ + self.console.print(error) + + def pre_prompt(self) -> None: + """Hook to display something before the prompt.""" + + @overload + def __call__(self, *, stream: Optional[TextIO] = None) -> PromptType: + ... + + @overload + def __call__( + self, *, default: DefaultType, stream: Optional[TextIO] = None + ) -> Union[PromptType, DefaultType]: + ... + + def __call__(self, *, default: Any = ..., stream: Optional[TextIO] = None) -> Any: + """Run the prompt loop. + + Args: + default (Any, optional): Optional default value. + + Returns: + PromptType: Processed value. + """ + while True: + self.pre_prompt() + prompt = self.make_prompt(default) + value = self.get_input(self.console, prompt, self.password, stream=stream) + if value == "" and default != ...: + return default + try: + return_value = self.process_response(value) + except InvalidResponse as error: + self.on_validate_error(value, error) + continue + else: + return return_value + + +class Prompt(PromptBase[str]): + """A prompt that returns a str. + + Example: + >>> name = Prompt.ask("Enter your name") + + + """ + + response_type = str + + +class IntPrompt(PromptBase[int]): + """A prompt that returns an integer. + + Example: + >>> burrito_count = IntPrompt.ask("How many burritos do you want to order") + + """ + + response_type = int + validate_error_message = "[prompt.invalid]Please enter a valid integer number" + + +class FloatPrompt(PromptBase[float]): + """A prompt that returns a float. + + Example: + >>> temperature = FloatPrompt.ask("Enter desired temperature") + + """ + + response_type = float + validate_error_message = "[prompt.invalid]Please enter a number" + + +class Confirm(PromptBase[bool]): + """A yes / no confirmation prompt. + + Example: + >>> if Confirm.ask("Continue"): + run_job() + + """ + + response_type = bool + validate_error_message = "[prompt.invalid]Please enter Y or N" + choices: List[str] = ["y", "n"] + + def render_default(self, default: DefaultType) -> Text: + """Render the default as (y) or (n) rather than True/False.""" + yes, no = self.choices + return Text(f"({yes})" if default else f"({no})", style="prompt.default") + + def process_response(self, value: str) -> bool: + """Convert choices to a bool.""" + value = value.strip().lower() + if value not in self.choices: + raise InvalidResponse(self.validate_error_message) + return value == self.choices[0] + + +if __name__ == "__main__": # pragma: no cover + from pip._vendor.rich import print + + if Confirm.ask("Run [i]prompt[/i] tests?", default=True): + while True: + result = IntPrompt.ask( + ":rocket: Enter a number between [b]1[/b] and [b]10[/b]", default=5 + ) + if result >= 1 and result <= 10: + break + print(":pile_of_poo: [prompt.invalid]Number must be between 1 and 10") + print(f"number={result}") + + while True: + password = Prompt.ask( + "Please enter a password [cyan](must be at least 5 characters)", + password=True, + ) + if len(password) >= 5: + break + print("[prompt.invalid]password too short") + print(f"password={password!r}") + + fruit = Prompt.ask("Enter a fruit", choices=["apple", "orange", "pear"]) + print(f"fruit={fruit!r}") + + else: + print("[b]OK :loudly_crying_face:") diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/protocol.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/protocol.py new file mode 100644 index 0000000..12ab237 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/protocol.py @@ -0,0 +1,42 @@ +from typing import Any, cast, Set, TYPE_CHECKING +from inspect import isclass + +if TYPE_CHECKING: + from pip._vendor.rich.console import RenderableType + +_GIBBERISH = """aihwerij235234ljsdnp34ksodfipwoe234234jlskjdf""" + + +def is_renderable(check_object: Any) -> bool: + """Check if an object may be rendered by Rich.""" + return ( + isinstance(check_object, str) + or hasattr(check_object, "__rich__") + or hasattr(check_object, "__rich_console__") + ) + + +def rich_cast(renderable: object) -> "RenderableType": + """Cast an object to a renderable by calling __rich__ if present. + + Args: + renderable (object): A potentially renderable object + + Returns: + object: The result of recursively calling __rich__. + """ + from pip._vendor.rich.console import RenderableType + + rich_visited_set: Set[type] = set() # Prevent potential infinite loop + while hasattr(renderable, "__rich__") and not isclass(renderable): + # Detect object which claim to have all the attributes + if hasattr(renderable, _GIBBERISH): + return repr(renderable) + cast_method = getattr(renderable, "__rich__") + renderable = cast_method() + renderable_type = type(renderable) + if renderable_type in rich_visited_set: + break + rich_visited_set.add(renderable_type) + + return cast(RenderableType, renderable) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/py.typed b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/region.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/region.py new file mode 100644 index 0000000..75b3631 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/region.py @@ -0,0 +1,10 @@ +from typing import NamedTuple + + +class Region(NamedTuple): + """Defines a rectangular region of the screen.""" + + x: int + y: int + width: int + height: int diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/repr.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/repr.py new file mode 100644 index 0000000..10efc42 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/repr.py @@ -0,0 +1,149 @@ +import inspect +from functools import partial +from typing import ( + Any, + Callable, + Iterable, + List, + Optional, + Tuple, + Type, + TypeVar, + Union, + overload, +) + +T = TypeVar("T") + + +Result = Iterable[Union[Any, Tuple[Any], Tuple[str, Any], Tuple[str, Any, Any]]] +RichReprResult = Result + + +class ReprError(Exception): + """An error occurred when attempting to build a repr.""" + + +@overload +def auto(cls: Optional[Type[T]]) -> Type[T]: + ... + + +@overload +def auto(*, angular: bool = False) -> Callable[[Type[T]], Type[T]]: + ... + + +def auto( + cls: Optional[Type[T]] = None, *, angular: Optional[bool] = None +) -> Union[Type[T], Callable[[Type[T]], Type[T]]]: + """Class decorator to create __repr__ from __rich_repr__""" + + def do_replace(cls: Type[T], angular: Optional[bool] = None) -> Type[T]: + def auto_repr(self: T) -> str: + """Create repr string from __rich_repr__""" + repr_str: List[str] = [] + append = repr_str.append + + angular: bool = getattr(self.__rich_repr__, "angular", False) # type: ignore[attr-defined] + for arg in self.__rich_repr__(): # type: ignore[attr-defined] + if isinstance(arg, tuple): + if len(arg) == 1: + append(repr(arg[0])) + else: + key, value, *default = arg + if key is None: + append(repr(value)) + else: + if default and default[0] == value: + continue + append(f"{key}={value!r}") + else: + append(repr(arg)) + if angular: + return f"<{self.__class__.__name__} {' '.join(repr_str)}>" + else: + return f"{self.__class__.__name__}({', '.join(repr_str)})" + + def auto_rich_repr(self: Type[T]) -> Result: + """Auto generate __rich_rep__ from signature of __init__""" + try: + signature = inspect.signature(self.__init__) + for name, param in signature.parameters.items(): + if param.kind == param.POSITIONAL_ONLY: + yield getattr(self, name) + elif param.kind in ( + param.POSITIONAL_OR_KEYWORD, + param.KEYWORD_ONLY, + ): + if param.default is param.empty: + yield getattr(self, param.name) + else: + yield param.name, getattr(self, param.name), param.default + except Exception as error: + raise ReprError( + f"Failed to auto generate __rich_repr__; {error}" + ) from None + + if not hasattr(cls, "__rich_repr__"): + auto_rich_repr.__doc__ = "Build a rich repr" + cls.__rich_repr__ = auto_rich_repr # type: ignore[attr-defined] + + auto_repr.__doc__ = "Return repr(self)" + cls.__repr__ = auto_repr # type: ignore[assignment] + if angular is not None: + cls.__rich_repr__.angular = angular # type: ignore[attr-defined] + return cls + + if cls is None: + return partial(do_replace, angular=angular) + else: + return do_replace(cls, angular=angular) + + +@overload +def rich_repr(cls: Optional[Type[T]]) -> Type[T]: + ... + + +@overload +def rich_repr(*, angular: bool = False) -> Callable[[Type[T]], Type[T]]: + ... + + +def rich_repr( + cls: Optional[Type[T]] = None, *, angular: bool = False +) -> Union[Type[T], Callable[[Type[T]], Type[T]]]: + if cls is None: + return auto(angular=angular) + else: + return auto(cls) + + +if __name__ == "__main__": + + @auto + class Foo: + def __rich_repr__(self) -> Result: + yield "foo" + yield "bar", {"shopping": ["eggs", "ham", "pineapple"]} + yield "buy", "hand sanitizer" + + foo = Foo() + from pip._vendor.rich.console import Console + + console = Console() + + console.rule("Standard repr") + console.print(foo) + + console.print(foo, width=60) + console.print(foo, width=30) + + console.rule("Angular repr") + Foo.__rich_repr__.angular = True # type: ignore[attr-defined] + + console.print(foo) + + console.print(foo, width=60) + console.print(foo, width=30) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/rule.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/rule.py new file mode 100644 index 0000000..fd00ce6 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/rule.py @@ -0,0 +1,130 @@ +from typing import Union + +from .align import AlignMethod +from .cells import cell_len, set_cell_size +from .console import Console, ConsoleOptions, RenderResult +from .jupyter import JupyterMixin +from .measure import Measurement +from .style import Style +from .text import Text + + +class Rule(JupyterMixin): + """A console renderable to draw a horizontal rule (line). + + Args: + title (Union[str, Text], optional): Text to render in the rule. Defaults to "". + characters (str, optional): Character(s) used to draw the line. Defaults to "─". + style (StyleType, optional): Style of Rule. Defaults to "rule.line". + end (str, optional): Character at end of Rule. defaults to "\\\\n" + align (str, optional): How to align the title, one of "left", "center", or "right". Defaults to "center". + """ + + def __init__( + self, + title: Union[str, Text] = "", + *, + characters: str = "─", + style: Union[str, Style] = "rule.line", + end: str = "\n", + align: AlignMethod = "center", + ) -> None: + if cell_len(characters) < 1: + raise ValueError( + "'characters' argument must have a cell width of at least 1" + ) + if align not in ("left", "center", "right"): + raise ValueError( + f'invalid value for align, expected "left", "center", "right" (not {align!r})' + ) + self.title = title + self.characters = characters + self.style = style + self.end = end + self.align = align + + def __repr__(self) -> str: + return f"Rule({self.title!r}, {self.characters!r})" + + def __rich_console__( + self, console: Console, options: ConsoleOptions + ) -> RenderResult: + width = options.max_width + + characters = ( + "-" + if (options.ascii_only and not self.characters.isascii()) + else self.characters + ) + + chars_len = cell_len(characters) + if not self.title: + yield self._rule_line(chars_len, width) + return + + if isinstance(self.title, Text): + title_text = self.title + else: + title_text = console.render_str(self.title, style="rule.text") + + title_text.plain = title_text.plain.replace("\n", " ") + title_text.expand_tabs() + + required_space = 4 if self.align == "center" else 2 + truncate_width = max(0, width - required_space) + if not truncate_width: + yield self._rule_line(chars_len, width) + return + + rule_text = Text(end=self.end) + if self.align == "center": + title_text.truncate(truncate_width, overflow="ellipsis") + side_width = (width - cell_len(title_text.plain)) // 2 + left = Text(characters * (side_width // chars_len + 1)) + left.truncate(side_width - 1) + right_length = width - cell_len(left.plain) - cell_len(title_text.plain) + right = Text(characters * (side_width // chars_len + 1)) + right.truncate(right_length) + rule_text.append(left.plain + " ", self.style) + rule_text.append(title_text) + rule_text.append(" " + right.plain, self.style) + elif self.align == "left": + title_text.truncate(truncate_width, overflow="ellipsis") + rule_text.append(title_text) + rule_text.append(" ") + rule_text.append(characters * (width - rule_text.cell_len), self.style) + elif self.align == "right": + title_text.truncate(truncate_width, overflow="ellipsis") + rule_text.append(characters * (width - title_text.cell_len - 1), self.style) + rule_text.append(" ") + rule_text.append(title_text) + + rule_text.plain = set_cell_size(rule_text.plain, width) + yield rule_text + + def _rule_line(self, chars_len: int, width: int) -> Text: + rule_text = Text(self.characters * ((width // chars_len) + 1), self.style) + rule_text.truncate(width) + rule_text.plain = set_cell_size(rule_text.plain, width) + return rule_text + + def __rich_measure__( + self, console: Console, options: ConsoleOptions + ) -> Measurement: + return Measurement(1, 1) + + +if __name__ == "__main__": # pragma: no cover + import sys + + from pip._vendor.rich.console import Console + + try: + text = sys.argv[1] + except IndexError: + text = "Hello, World" + console = Console() + console.print(Rule(title=text)) + + console = Console() + console.print(Rule("foo"), width=4) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/scope.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/scope.py new file mode 100644 index 0000000..c9d134c --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/scope.py @@ -0,0 +1,86 @@ +from collections.abc import Mapping +from typing import TYPE_CHECKING, Any, Optional, Tuple + +from .highlighter import ReprHighlighter +from .panel import Panel +from .pretty import Pretty +from .table import Table +from .text import Text, TextType + +if TYPE_CHECKING: + from .console import ConsoleRenderable + + +def render_scope( + scope: "Mapping[str, Any]", + *, + title: Optional[TextType] = None, + sort_keys: bool = True, + indent_guides: bool = False, + max_length: Optional[int] = None, + max_string: Optional[int] = None, +) -> "ConsoleRenderable": + """Render python variables in a given scope. + + Args: + scope (Mapping): A mapping containing variable names and values. + title (str, optional): Optional title. Defaults to None. + sort_keys (bool, optional): Enable sorting of items. Defaults to True. + indent_guides (bool, optional): Enable indentation guides. Defaults to False. + max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation. + Defaults to None. + max_string (int, optional): Maximum length of string before truncating, or None to disable. Defaults to None. + + Returns: + ConsoleRenderable: A renderable object. + """ + highlighter = ReprHighlighter() + items_table = Table.grid(padding=(0, 1), expand=False) + items_table.add_column(justify="right") + + def sort_items(item: Tuple[str, Any]) -> Tuple[bool, str]: + """Sort special variables first, then alphabetically.""" + key, _ = item + return (not key.startswith("__"), key.lower()) + + items = sorted(scope.items(), key=sort_items) if sort_keys else scope.items() + for key, value in items: + key_text = Text.assemble( + (key, "scope.key.special" if key.startswith("__") else "scope.key"), + (" =", "scope.equals"), + ) + items_table.add_row( + key_text, + Pretty( + value, + highlighter=highlighter, + indent_guides=indent_guides, + max_length=max_length, + max_string=max_string, + ), + ) + return Panel.fit( + items_table, + title=title, + border_style="scope.border", + padding=(0, 1), + ) + + +if __name__ == "__main__": # pragma: no cover + from pip._vendor.rich import print + + print() + + def test(foo: float, bar: float) -> None: + list_of_things = [1, 2, 3, None, 4, True, False, "Hello World"] + dict_of_things = { + "version": "1.1", + "method": "confirmFruitPurchase", + "params": [["apple", "orange", "mangoes", "pomelo"], 1.123], + "id": "194521489", + } + print(render_scope(locals(), title="[i]locals", sort_keys=False)) + + test(20.3423, 3.1427) + print() diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/screen.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/screen.py new file mode 100644 index 0000000..7f416e1 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/screen.py @@ -0,0 +1,54 @@ +from typing import Optional, TYPE_CHECKING + +from .segment import Segment +from .style import StyleType +from ._loop import loop_last + + +if TYPE_CHECKING: + from .console import ( + Console, + ConsoleOptions, + RenderResult, + RenderableType, + Group, + ) + + +class Screen: + """A renderable that fills the terminal screen and crops excess. + + Args: + renderable (RenderableType): Child renderable. + style (StyleType, optional): Optional background style. Defaults to None. + """ + + renderable: "RenderableType" + + def __init__( + self, + *renderables: "RenderableType", + style: Optional[StyleType] = None, + application_mode: bool = False, + ) -> None: + from pip._vendor.rich.console import Group + + self.renderable = Group(*renderables) + self.style = style + self.application_mode = application_mode + + def __rich_console__( + self, console: "Console", options: "ConsoleOptions" + ) -> "RenderResult": + width, height = options.size + style = console.get_style(self.style) if self.style else None + render_options = options.update(width=width, height=height) + lines = console.render_lines( + self.renderable or "", render_options, style=style, pad=True + ) + lines = Segment.set_shape(lines, width, height, style=style) + new_line = Segment("\n\r") if self.application_mode else Segment.line() + for last, line in loop_last(lines): + yield from line + if not last: + yield new_line diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/segment.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/segment.py new file mode 100644 index 0000000..93edbbd --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/segment.py @@ -0,0 +1,738 @@ +from enum import IntEnum +from functools import lru_cache +from itertools import filterfalse +from logging import getLogger +from operator import attrgetter +from typing import ( + TYPE_CHECKING, + Dict, + Iterable, + List, + NamedTuple, + Optional, + Sequence, + Tuple, + Type, + Union, +) + +from .cells import ( + _is_single_cell_widths, + cached_cell_len, + cell_len, + get_character_cell_size, + set_cell_size, +) +from .repr import Result, rich_repr +from .style import Style + +if TYPE_CHECKING: + from .console import Console, ConsoleOptions, RenderResult + +log = getLogger("rich") + + +class ControlType(IntEnum): + """Non-printable control codes which typically translate to ANSI codes.""" + + BELL = 1 + CARRIAGE_RETURN = 2 + HOME = 3 + CLEAR = 4 + SHOW_CURSOR = 5 + HIDE_CURSOR = 6 + ENABLE_ALT_SCREEN = 7 + DISABLE_ALT_SCREEN = 8 + CURSOR_UP = 9 + CURSOR_DOWN = 10 + CURSOR_FORWARD = 11 + CURSOR_BACKWARD = 12 + CURSOR_MOVE_TO_COLUMN = 13 + CURSOR_MOVE_TO = 14 + ERASE_IN_LINE = 15 + SET_WINDOW_TITLE = 16 + + +ControlCode = Union[ + Tuple[ControlType], + Tuple[ControlType, Union[int, str]], + Tuple[ControlType, int, int], +] + + +@rich_repr() +class Segment(NamedTuple): + """A piece of text with associated style. Segments are produced by the Console render process and + are ultimately converted in to strings to be written to the terminal. + + Args: + text (str): A piece of text. + style (:class:`~rich.style.Style`, optional): An optional style to apply to the text. + control (Tuple[ControlCode], optional): Optional sequence of control codes. + + Attributes: + cell_length (int): The cell length of this Segment. + """ + + text: str + style: Optional[Style] = None + control: Optional[Sequence[ControlCode]] = None + + @property + def cell_length(self) -> int: + """The number of terminal cells required to display self.text. + + Returns: + int: A number of cells. + """ + text, _style, control = self + return 0 if control else cell_len(text) + + def __rich_repr__(self) -> Result: + yield self.text + if self.control is None: + if self.style is not None: + yield self.style + else: + yield self.style + yield self.control + + def __bool__(self) -> bool: + """Check if the segment contains text.""" + return bool(self.text) + + @property + def is_control(self) -> bool: + """Check if the segment contains control codes.""" + return self.control is not None + + @classmethod + @lru_cache(1024 * 16) + def _split_cells(cls, segment: "Segment", cut: int) -> Tuple["Segment", "Segment"]: + text, style, control = segment + _Segment = Segment + + cell_length = segment.cell_length + if cut >= cell_length: + return segment, _Segment("", style, control) + + cell_size = get_character_cell_size + + pos = int((cut / cell_length) * (len(text) - 1)) + + before = text[:pos] + cell_pos = cell_len(before) + if cell_pos == cut: + return ( + _Segment(before, style, control), + _Segment(text[pos:], style, control), + ) + while pos < len(text): + char = text[pos] + pos += 1 + cell_pos += cell_size(char) + before = text[:pos] + if cell_pos == cut: + return ( + _Segment(before, style, control), + _Segment(text[pos:], style, control), + ) + if cell_pos > cut: + return ( + _Segment(before[: pos - 1] + " ", style, control), + _Segment(" " + text[pos:], style, control), + ) + + raise AssertionError("Will never reach here") + + def split_cells(self, cut: int) -> Tuple["Segment", "Segment"]: + """Split segment in to two segments at the specified column. + + If the cut point falls in the middle of a 2-cell wide character then it is replaced + by two spaces, to preserve the display width of the parent segment. + + Returns: + Tuple[Segment, Segment]: Two segments. + """ + text, style, control = self + + if _is_single_cell_widths(text): + # Fast path with all 1 cell characters + if cut >= len(text): + return self, Segment("", style, control) + return ( + Segment(text[:cut], style, control), + Segment(text[cut:], style, control), + ) + + return self._split_cells(self, cut) + + @classmethod + def line(cls) -> "Segment": + """Make a new line segment.""" + return cls("\n") + + @classmethod + def apply_style( + cls, + segments: Iterable["Segment"], + style: Optional[Style] = None, + post_style: Optional[Style] = None, + ) -> Iterable["Segment"]: + """Apply style(s) to an iterable of segments. + + Returns an iterable of segments where the style is replaced by ``style + segment.style + post_style``. + + Args: + segments (Iterable[Segment]): Segments to process. + style (Style, optional): Base style. Defaults to None. + post_style (Style, optional): Style to apply on top of segment style. Defaults to None. + + Returns: + Iterable[Segments]: A new iterable of segments (possibly the same iterable). + """ + result_segments = segments + if style: + apply = style.__add__ + result_segments = ( + cls(text, None if control else apply(_style), control) + for text, _style, control in result_segments + ) + if post_style: + result_segments = ( + cls( + text, + ( + None + if control + else (_style + post_style if _style else post_style) + ), + control, + ) + for text, _style, control in result_segments + ) + return result_segments + + @classmethod + def filter_control( + cls, segments: Iterable["Segment"], is_control: bool = False + ) -> Iterable["Segment"]: + """Filter segments by ``is_control`` attribute. + + Args: + segments (Iterable[Segment]): An iterable of Segment instances. + is_control (bool, optional): is_control flag to match in search. + + Returns: + Iterable[Segment]: And iterable of Segment instances. + + """ + if is_control: + return filter(attrgetter("control"), segments) + else: + return filterfalse(attrgetter("control"), segments) + + @classmethod + def split_lines(cls, segments: Iterable["Segment"]) -> Iterable[List["Segment"]]: + """Split a sequence of segments in to a list of lines. + + Args: + segments (Iterable[Segment]): Segments potentially containing line feeds. + + Yields: + Iterable[List[Segment]]: Iterable of segment lists, one per line. + """ + line: List[Segment] = [] + append = line.append + + for segment in segments: + if "\n" in segment.text and not segment.control: + text, style, _ = segment + while text: + _text, new_line, text = text.partition("\n") + if _text: + append(cls(_text, style)) + if new_line: + yield line + line = [] + append = line.append + else: + append(segment) + if line: + yield line + + @classmethod + def split_and_crop_lines( + cls, + segments: Iterable["Segment"], + length: int, + style: Optional[Style] = None, + pad: bool = True, + include_new_lines: bool = True, + ) -> Iterable[List["Segment"]]: + """Split segments in to lines, and crop lines greater than a given length. + + Args: + segments (Iterable[Segment]): An iterable of segments, probably + generated from console.render. + length (int): Desired line length. + style (Style, optional): Style to use for any padding. + pad (bool): Enable padding of lines that are less than `length`. + + Returns: + Iterable[List[Segment]]: An iterable of lines of segments. + """ + line: List[Segment] = [] + append = line.append + + adjust_line_length = cls.adjust_line_length + new_line_segment = cls("\n") + + for segment in segments: + if "\n" in segment.text and not segment.control: + text, segment_style, _ = segment + while text: + _text, new_line, text = text.partition("\n") + if _text: + append(cls(_text, segment_style)) + if new_line: + cropped_line = adjust_line_length( + line, length, style=style, pad=pad + ) + if include_new_lines: + cropped_line.append(new_line_segment) + yield cropped_line + line.clear() + else: + append(segment) + if line: + yield adjust_line_length(line, length, style=style, pad=pad) + + @classmethod + def adjust_line_length( + cls, + line: List["Segment"], + length: int, + style: Optional[Style] = None, + pad: bool = True, + ) -> List["Segment"]: + """Adjust a line to a given width (cropping or padding as required). + + Args: + segments (Iterable[Segment]): A list of segments in a single line. + length (int): The desired width of the line. + style (Style, optional): The style of padding if used (space on the end). Defaults to None. + pad (bool, optional): Pad lines with spaces if they are shorter than `length`. Defaults to True. + + Returns: + List[Segment]: A line of segments with the desired length. + """ + line_length = sum(segment.cell_length for segment in line) + new_line: List[Segment] + + if line_length < length: + if pad: + new_line = line + [cls(" " * (length - line_length), style)] + else: + new_line = line[:] + elif line_length > length: + new_line = [] + append = new_line.append + line_length = 0 + for segment in line: + segment_length = segment.cell_length + if line_length + segment_length < length or segment.control: + append(segment) + line_length += segment_length + else: + text, segment_style, _ = segment + text = set_cell_size(text, length - line_length) + append(cls(text, segment_style)) + break + else: + new_line = line[:] + return new_line + + @classmethod + def get_line_length(cls, line: List["Segment"]) -> int: + """Get the length of list of segments. + + Args: + line (List[Segment]): A line encoded as a list of Segments (assumes no '\\\\n' characters), + + Returns: + int: The length of the line. + """ + _cell_len = cell_len + return sum(_cell_len(text) for text, style, control in line if not control) + + @classmethod + def get_shape(cls, lines: List[List["Segment"]]) -> Tuple[int, int]: + """Get the shape (enclosing rectangle) of a list of lines. + + Args: + lines (List[List[Segment]]): A list of lines (no '\\\\n' characters). + + Returns: + Tuple[int, int]: Width and height in characters. + """ + get_line_length = cls.get_line_length + max_width = max(get_line_length(line) for line in lines) if lines else 0 + return (max_width, len(lines)) + + @classmethod + def set_shape( + cls, + lines: List[List["Segment"]], + width: int, + height: Optional[int] = None, + style: Optional[Style] = None, + new_lines: bool = False, + ) -> List[List["Segment"]]: + """Set the shape of a list of lines (enclosing rectangle). + + Args: + lines (List[List[Segment]]): A list of lines. + width (int): Desired width. + height (int, optional): Desired height or None for no change. + style (Style, optional): Style of any padding added. + new_lines (bool, optional): Padded lines should include "\n". Defaults to False. + + Returns: + List[List[Segment]]: New list of lines. + """ + _height = height or len(lines) + + blank = ( + [cls(" " * width + "\n", style)] if new_lines else [cls(" " * width, style)] + ) + + adjust_line_length = cls.adjust_line_length + shaped_lines = lines[:_height] + shaped_lines[:] = [ + adjust_line_length(line, width, style=style) for line in lines + ] + if len(shaped_lines) < _height: + shaped_lines.extend([blank] * (_height - len(shaped_lines))) + return shaped_lines + + @classmethod + def align_top( + cls: Type["Segment"], + lines: List[List["Segment"]], + width: int, + height: int, + style: Style, + new_lines: bool = False, + ) -> List[List["Segment"]]: + """Aligns lines to top (adds extra lines to bottom as required). + + Args: + lines (List[List[Segment]]): A list of lines. + width (int): Desired width. + height (int, optional): Desired height or None for no change. + style (Style): Style of any padding added. + new_lines (bool, optional): Padded lines should include "\n". Defaults to False. + + Returns: + List[List[Segment]]: New list of lines. + """ + extra_lines = height - len(lines) + if not extra_lines: + return lines[:] + lines = lines[:height] + blank = cls(" " * width + "\n", style) if new_lines else cls(" " * width, style) + lines = lines + [[blank]] * extra_lines + return lines + + @classmethod + def align_bottom( + cls: Type["Segment"], + lines: List[List["Segment"]], + width: int, + height: int, + style: Style, + new_lines: bool = False, + ) -> List[List["Segment"]]: + """Aligns render to bottom (adds extra lines above as required). + + Args: + lines (List[List[Segment]]): A list of lines. + width (int): Desired width. + height (int, optional): Desired height or None for no change. + style (Style): Style of any padding added. Defaults to None. + new_lines (bool, optional): Padded lines should include "\n". Defaults to False. + + Returns: + List[List[Segment]]: New list of lines. + """ + extra_lines = height - len(lines) + if not extra_lines: + return lines[:] + lines = lines[:height] + blank = cls(" " * width + "\n", style) if new_lines else cls(" " * width, style) + lines = [[blank]] * extra_lines + lines + return lines + + @classmethod + def align_middle( + cls: Type["Segment"], + lines: List[List["Segment"]], + width: int, + height: int, + style: Style, + new_lines: bool = False, + ) -> List[List["Segment"]]: + """Aligns lines to middle (adds extra lines to above and below as required). + + Args: + lines (List[List[Segment]]): A list of lines. + width (int): Desired width. + height (int, optional): Desired height or None for no change. + style (Style): Style of any padding added. + new_lines (bool, optional): Padded lines should include "\n". Defaults to False. + + Returns: + List[List[Segment]]: New list of lines. + """ + extra_lines = height - len(lines) + if not extra_lines: + return lines[:] + lines = lines[:height] + blank = cls(" " * width + "\n", style) if new_lines else cls(" " * width, style) + top_lines = extra_lines // 2 + bottom_lines = extra_lines - top_lines + lines = [[blank]] * top_lines + lines + [[blank]] * bottom_lines + return lines + + @classmethod + def simplify(cls, segments: Iterable["Segment"]) -> Iterable["Segment"]: + """Simplify an iterable of segments by combining contiguous segments with the same style. + + Args: + segments (Iterable[Segment]): An iterable of segments. + + Returns: + Iterable[Segment]: A possibly smaller iterable of segments that will render the same way. + """ + iter_segments = iter(segments) + try: + last_segment = next(iter_segments) + except StopIteration: + return + + _Segment = Segment + for segment in iter_segments: + if last_segment.style == segment.style and not segment.control: + last_segment = _Segment( + last_segment.text + segment.text, last_segment.style + ) + else: + yield last_segment + last_segment = segment + yield last_segment + + @classmethod + def strip_links(cls, segments: Iterable["Segment"]) -> Iterable["Segment"]: + """Remove all links from an iterable of styles. + + Args: + segments (Iterable[Segment]): An iterable segments. + + Yields: + Segment: Segments with link removed. + """ + for segment in segments: + if segment.control or segment.style is None: + yield segment + else: + text, style, _control = segment + yield cls(text, style.update_link(None) if style else None) + + @classmethod + def strip_styles(cls, segments: Iterable["Segment"]) -> Iterable["Segment"]: + """Remove all styles from an iterable of segments. + + Args: + segments (Iterable[Segment]): An iterable segments. + + Yields: + Segment: Segments with styles replace with None + """ + for text, _style, control in segments: + yield cls(text, None, control) + + @classmethod + def remove_color(cls, segments: Iterable["Segment"]) -> Iterable["Segment"]: + """Remove all color from an iterable of segments. + + Args: + segments (Iterable[Segment]): An iterable segments. + + Yields: + Segment: Segments with colorless style. + """ + + cache: Dict[Style, Style] = {} + for text, style, control in segments: + if style: + colorless_style = cache.get(style) + if colorless_style is None: + colorless_style = style.without_color + cache[style] = colorless_style + yield cls(text, colorless_style, control) + else: + yield cls(text, None, control) + + @classmethod + def divide( + cls, segments: Iterable["Segment"], cuts: Iterable[int] + ) -> Iterable[List["Segment"]]: + """Divides an iterable of segments in to portions. + + Args: + cuts (Iterable[int]): Cell positions where to divide. + + Yields: + [Iterable[List[Segment]]]: An iterable of Segments in List. + """ + split_segments: List["Segment"] = [] + add_segment = split_segments.append + + iter_cuts = iter(cuts) + + while True: + cut = next(iter_cuts, -1) + if cut == -1: + return [] + if cut != 0: + break + yield [] + pos = 0 + + segments_clear = split_segments.clear + segments_copy = split_segments.copy + + _cell_len = cached_cell_len + for segment in segments: + text, _style, control = segment + while text: + end_pos = pos if control else pos + _cell_len(text) + if end_pos < cut: + add_segment(segment) + pos = end_pos + break + + if end_pos == cut: + add_segment(segment) + yield segments_copy() + segments_clear() + pos = end_pos + + cut = next(iter_cuts, -1) + if cut == -1: + if split_segments: + yield segments_copy() + return + + break + + else: + before, segment = segment.split_cells(cut - pos) + text, _style, control = segment + add_segment(before) + yield segments_copy() + segments_clear() + pos = cut + + cut = next(iter_cuts, -1) + if cut == -1: + if split_segments: + yield segments_copy() + return + + yield segments_copy() + + +class Segments: + """A simple renderable to render an iterable of segments. This class may be useful if + you want to print segments outside of a __rich_console__ method. + + Args: + segments (Iterable[Segment]): An iterable of segments. + new_lines (bool, optional): Add new lines between segments. Defaults to False. + """ + + def __init__(self, segments: Iterable[Segment], new_lines: bool = False) -> None: + self.segments = list(segments) + self.new_lines = new_lines + + def __rich_console__( + self, console: "Console", options: "ConsoleOptions" + ) -> "RenderResult": + if self.new_lines: + line = Segment.line() + for segment in self.segments: + yield segment + yield line + else: + yield from self.segments + + +class SegmentLines: + def __init__(self, lines: Iterable[List[Segment]], new_lines: bool = False) -> None: + """A simple renderable containing a number of lines of segments. May be used as an intermediate + in rendering process. + + Args: + lines (Iterable[List[Segment]]): Lists of segments forming lines. + new_lines (bool, optional): Insert new lines after each line. Defaults to False. + """ + self.lines = list(lines) + self.new_lines = new_lines + + def __rich_console__( + self, console: "Console", options: "ConsoleOptions" + ) -> "RenderResult": + if self.new_lines: + new_line = Segment.line() + for line in self.lines: + yield from line + yield new_line + else: + for line in self.lines: + yield from line + + +if __name__ == "__main__": # pragma: no cover + from pip._vendor.rich.console import Console + from pip._vendor.rich.syntax import Syntax + from pip._vendor.rich.text import Text + + code = """from rich.console import Console +console = Console() +text = Text.from_markup("Hello, [bold magenta]World[/]!") +console.print(text)""" + + text = Text.from_markup("Hello, [bold magenta]World[/]!") + + console = Console() + + console.rule("rich.Segment") + console.print( + "A Segment is the last step in the Rich render process before generating text with ANSI codes." + ) + console.print("\nConsider the following code:\n") + console.print(Syntax(code, "python", line_numbers=True)) + console.print() + console.print( + "When you call [b]print()[/b], Rich [i]renders[/i] the object in to the following:\n" + ) + fragments = list(console.render(text)) + console.print(fragments) + console.print() + console.print("The Segments are then processed to produce the following output:\n") + console.print(text) + console.print( + "\nYou will only need to know this if you are implementing your own Rich renderables." + ) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/spinner.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/spinner.py new file mode 100644 index 0000000..91ea630 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/spinner.py @@ -0,0 +1,137 @@ +from typing import cast, List, Optional, TYPE_CHECKING, Union + +from ._spinners import SPINNERS +from .measure import Measurement +from .table import Table +from .text import Text + +if TYPE_CHECKING: + from .console import Console, ConsoleOptions, RenderResult, RenderableType + from .style import StyleType + + +class Spinner: + """A spinner animation. + + Args: + name (str): Name of spinner (run python -m rich.spinner). + text (RenderableType, optional): A renderable to display at the right of the spinner (str or Text typically). Defaults to "". + style (StyleType, optional): Style for spinner animation. Defaults to None. + speed (float, optional): Speed factor for animation. Defaults to 1.0. + + Raises: + KeyError: If name isn't one of the supported spinner animations. + """ + + def __init__( + self, + name: str, + text: "RenderableType" = "", + *, + style: Optional["StyleType"] = None, + speed: float = 1.0, + ) -> None: + try: + spinner = SPINNERS[name] + except KeyError: + raise KeyError(f"no spinner called {name!r}") + self.text: "Union[RenderableType, Text]" = ( + Text.from_markup(text) if isinstance(text, str) else text + ) + self.frames = cast(List[str], spinner["frames"])[:] + self.interval = cast(float, spinner["interval"]) + self.start_time: Optional[float] = None + self.style = style + self.speed = speed + self.frame_no_offset: float = 0.0 + self._update_speed = 0.0 + + def __rich_console__( + self, console: "Console", options: "ConsoleOptions" + ) -> "RenderResult": + yield self.render(console.get_time()) + + def __rich_measure__( + self, console: "Console", options: "ConsoleOptions" + ) -> Measurement: + text = self.render(0) + return Measurement.get(console, options, text) + + def render(self, time: float) -> "RenderableType": + """Render the spinner for a given time. + + Args: + time (float): Time in seconds. + + Returns: + RenderableType: A renderable containing animation frame. + """ + if self.start_time is None: + self.start_time = time + + frame_no = ((time - self.start_time) * self.speed) / ( + self.interval / 1000.0 + ) + self.frame_no_offset + frame = Text( + self.frames[int(frame_no) % len(self.frames)], style=self.style or "" + ) + + if self._update_speed: + self.frame_no_offset = frame_no + self.start_time = time + self.speed = self._update_speed + self._update_speed = 0.0 + + if not self.text: + return frame + elif isinstance(self.text, (str, Text)): + return Text.assemble(frame, " ", self.text) + else: + table = Table.grid(padding=1) + table.add_row(frame, self.text) + return table + + def update( + self, + *, + text: "RenderableType" = "", + style: Optional["StyleType"] = None, + speed: Optional[float] = None, + ) -> None: + """Updates attributes of a spinner after it has been started. + + Args: + text (RenderableType, optional): A renderable to display at the right of the spinner (str or Text typically). Defaults to "". + style (StyleType, optional): Style for spinner animation. Defaults to None. + speed (float, optional): Speed factor for animation. Defaults to None. + """ + if text: + self.text = Text.from_markup(text) if isinstance(text, str) else text + if style: + self.style = style + if speed: + self._update_speed = speed + + +if __name__ == "__main__": # pragma: no cover + from time import sleep + + from .columns import Columns + from .panel import Panel + from .live import Live + + all_spinners = Columns( + [ + Spinner(spinner_name, text=Text(repr(spinner_name), style="green")) + for spinner_name in sorted(SPINNERS.keys()) + ], + column_first=True, + expand=True, + ) + + with Live( + Panel(all_spinners, title="Spinners", border_style="blue"), + refresh_per_second=20, + ) as live: + while True: + sleep(0.1) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/status.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/status.py new file mode 100644 index 0000000..6574483 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/status.py @@ -0,0 +1,131 @@ +from types import TracebackType +from typing import Optional, Type + +from .console import Console, RenderableType +from .jupyter import JupyterMixin +from .live import Live +from .spinner import Spinner +from .style import StyleType + + +class Status(JupyterMixin): + """Displays a status indicator with a 'spinner' animation. + + Args: + status (RenderableType): A status renderable (str or Text typically). + console (Console, optional): Console instance to use, or None for global console. Defaults to None. + spinner (str, optional): Name of spinner animation (see python -m rich.spinner). Defaults to "dots". + spinner_style (StyleType, optional): Style of spinner. Defaults to "status.spinner". + speed (float, optional): Speed factor for spinner animation. Defaults to 1.0. + refresh_per_second (float, optional): Number of refreshes per second. Defaults to 12.5. + """ + + def __init__( + self, + status: RenderableType, + *, + console: Optional[Console] = None, + spinner: str = "dots", + spinner_style: StyleType = "status.spinner", + speed: float = 1.0, + refresh_per_second: float = 12.5, + ): + self.status = status + self.spinner_style = spinner_style + self.speed = speed + self._spinner = Spinner(spinner, text=status, style=spinner_style, speed=speed) + self._live = Live( + self.renderable, + console=console, + refresh_per_second=refresh_per_second, + transient=True, + ) + + @property + def renderable(self) -> Spinner: + return self._spinner + + @property + def console(self) -> "Console": + """Get the Console used by the Status objects.""" + return self._live.console + + def update( + self, + status: Optional[RenderableType] = None, + *, + spinner: Optional[str] = None, + spinner_style: Optional[StyleType] = None, + speed: Optional[float] = None, + ) -> None: + """Update status. + + Args: + status (Optional[RenderableType], optional): New status renderable or None for no change. Defaults to None. + spinner (Optional[str], optional): New spinner or None for no change. Defaults to None. + spinner_style (Optional[StyleType], optional): New spinner style or None for no change. Defaults to None. + speed (Optional[float], optional): Speed factor for spinner animation or None for no change. Defaults to None. + """ + if status is not None: + self.status = status + if spinner_style is not None: + self.spinner_style = spinner_style + if speed is not None: + self.speed = speed + if spinner is not None: + self._spinner = Spinner( + spinner, text=self.status, style=self.spinner_style, speed=self.speed + ) + self._live.update(self.renderable, refresh=True) + else: + self._spinner.update( + text=self.status, style=self.spinner_style, speed=self.speed + ) + + def start(self) -> None: + """Start the status animation.""" + self._live.start() + + def stop(self) -> None: + """Stop the spinner animation.""" + self._live.stop() + + def __rich__(self) -> RenderableType: + return self.renderable + + def __enter__(self) -> "Status": + self.start() + return self + + def __exit__( + self, + exc_type: Optional[Type[BaseException]], + exc_val: Optional[BaseException], + exc_tb: Optional[TracebackType], + ) -> None: + self.stop() + + +if __name__ == "__main__": # pragma: no cover + from time import sleep + + from .console import Console + + console = Console() + with console.status("[magenta]Covid detector booting up") as status: + sleep(3) + console.log("Importing advanced AI") + sleep(3) + console.log("Advanced Covid AI Ready") + sleep(3) + status.update(status="[bold blue] Scanning for Covid", spinner="earth") + sleep(3) + console.log("Found 10,000,000,000 copies of Covid32.exe") + sleep(3) + status.update( + status="[bold red]Moving Covid32.exe to Trash", + spinner="bouncingBall", + spinner_style="yellow", + ) + sleep(5) + console.print("[bold green]Covid deleted successfully") diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/style.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/style.py new file mode 100644 index 0000000..313c889 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/style.py @@ -0,0 +1,796 @@ +import sys +from functools import lru_cache +from marshal import dumps, loads +from random import randint +from typing import Any, Dict, Iterable, List, Optional, Type, Union, cast + +from . import errors +from .color import Color, ColorParseError, ColorSystem, blend_rgb +from .repr import Result, rich_repr +from .terminal_theme import DEFAULT_TERMINAL_THEME, TerminalTheme + +# Style instances and style definitions are often interchangeable +StyleType = Union[str, "Style"] + + +class _Bit: + """A descriptor to get/set a style attribute bit.""" + + __slots__ = ["bit"] + + def __init__(self, bit_no: int) -> None: + self.bit = 1 << bit_no + + def __get__(self, obj: "Style", objtype: Type["Style"]) -> Optional[bool]: + if obj._set_attributes & self.bit: + return obj._attributes & self.bit != 0 + return None + + +@rich_repr +class Style: + """A terminal style. + + A terminal style consists of a color (`color`), a background color (`bgcolor`), and a number of attributes, such + as bold, italic etc. The attributes have 3 states: they can either be on + (``True``), off (``False``), or not set (``None``). + + Args: + color (Union[Color, str], optional): Color of terminal text. Defaults to None. + bgcolor (Union[Color, str], optional): Color of terminal background. Defaults to None. + bold (bool, optional): Enable bold text. Defaults to None. + dim (bool, optional): Enable dim text. Defaults to None. + italic (bool, optional): Enable italic text. Defaults to None. + underline (bool, optional): Enable underlined text. Defaults to None. + blink (bool, optional): Enabled blinking text. Defaults to None. + blink2 (bool, optional): Enable fast blinking text. Defaults to None. + reverse (bool, optional): Enabled reverse text. Defaults to None. + conceal (bool, optional): Enable concealed text. Defaults to None. + strike (bool, optional): Enable strikethrough text. Defaults to None. + underline2 (bool, optional): Enable doubly underlined text. Defaults to None. + frame (bool, optional): Enable framed text. Defaults to None. + encircle (bool, optional): Enable encircled text. Defaults to None. + overline (bool, optional): Enable overlined text. Defaults to None. + link (str, link): Link URL. Defaults to None. + + """ + + _color: Optional[Color] + _bgcolor: Optional[Color] + _attributes: int + _set_attributes: int + _hash: Optional[int] + _null: bool + _meta: Optional[bytes] + + __slots__ = [ + "_color", + "_bgcolor", + "_attributes", + "_set_attributes", + "_link", + "_link_id", + "_ansi", + "_style_definition", + "_hash", + "_null", + "_meta", + ] + + # maps bits on to SGR parameter + _style_map = { + 0: "1", + 1: "2", + 2: "3", + 3: "4", + 4: "5", + 5: "6", + 6: "7", + 7: "8", + 8: "9", + 9: "21", + 10: "51", + 11: "52", + 12: "53", + } + + STYLE_ATTRIBUTES = { + "dim": "dim", + "d": "dim", + "bold": "bold", + "b": "bold", + "italic": "italic", + "i": "italic", + "underline": "underline", + "u": "underline", + "blink": "blink", + "blink2": "blink2", + "reverse": "reverse", + "r": "reverse", + "conceal": "conceal", + "c": "conceal", + "strike": "strike", + "s": "strike", + "underline2": "underline2", + "uu": "underline2", + "frame": "frame", + "encircle": "encircle", + "overline": "overline", + "o": "overline", + } + + def __init__( + self, + *, + color: Optional[Union[Color, str]] = None, + bgcolor: Optional[Union[Color, str]] = None, + bold: Optional[bool] = None, + dim: Optional[bool] = None, + italic: Optional[bool] = None, + underline: Optional[bool] = None, + blink: Optional[bool] = None, + blink2: Optional[bool] = None, + reverse: Optional[bool] = None, + conceal: Optional[bool] = None, + strike: Optional[bool] = None, + underline2: Optional[bool] = None, + frame: Optional[bool] = None, + encircle: Optional[bool] = None, + overline: Optional[bool] = None, + link: Optional[str] = None, + meta: Optional[Dict[str, Any]] = None, + ): + self._ansi: Optional[str] = None + self._style_definition: Optional[str] = None + + def _make_color(color: Union[Color, str]) -> Color: + return color if isinstance(color, Color) else Color.parse(color) + + self._color = None if color is None else _make_color(color) + self._bgcolor = None if bgcolor is None else _make_color(bgcolor) + self._set_attributes = sum( + ( + bold is not None, + dim is not None and 2, + italic is not None and 4, + underline is not None and 8, + blink is not None and 16, + blink2 is not None and 32, + reverse is not None and 64, + conceal is not None and 128, + strike is not None and 256, + underline2 is not None and 512, + frame is not None and 1024, + encircle is not None and 2048, + overline is not None and 4096, + ) + ) + self._attributes = ( + sum( + ( + bold and 1 or 0, + dim and 2 or 0, + italic and 4 or 0, + underline and 8 or 0, + blink and 16 or 0, + blink2 and 32 or 0, + reverse and 64 or 0, + conceal and 128 or 0, + strike and 256 or 0, + underline2 and 512 or 0, + frame and 1024 or 0, + encircle and 2048 or 0, + overline and 4096 or 0, + ) + ) + if self._set_attributes + else 0 + ) + + self._link = link + self._meta = None if meta is None else dumps(meta) + self._link_id = ( + f"{randint(0, 999999)}{hash(self._meta)}" if (link or meta) else "" + ) + self._hash: Optional[int] = None + self._null = not (self._set_attributes or color or bgcolor or link or meta) + + @classmethod + def null(cls) -> "Style": + """Create an 'null' style, equivalent to Style(), but more performant.""" + return NULL_STYLE + + @classmethod + def from_color( + cls, color: Optional[Color] = None, bgcolor: Optional[Color] = None + ) -> "Style": + """Create a new style with colors and no attributes. + + Returns: + color (Optional[Color]): A (foreground) color, or None for no color. Defaults to None. + bgcolor (Optional[Color]): A (background) color, or None for no color. Defaults to None. + """ + style: Style = cls.__new__(Style) + style._ansi = None + style._style_definition = None + style._color = color + style._bgcolor = bgcolor + style._set_attributes = 0 + style._attributes = 0 + style._link = None + style._link_id = "" + style._meta = None + style._null = not (color or bgcolor) + style._hash = None + return style + + @classmethod + def from_meta(cls, meta: Optional[Dict[str, Any]]) -> "Style": + """Create a new style with meta data. + + Returns: + meta (Optional[Dict[str, Any]]): A dictionary of meta data. Defaults to None. + """ + style: Style = cls.__new__(Style) + style._ansi = None + style._style_definition = None + style._color = None + style._bgcolor = None + style._set_attributes = 0 + style._attributes = 0 + style._link = None + style._meta = dumps(meta) + style._link_id = f"{randint(0, 999999)}{hash(style._meta)}" + style._hash = None + style._null = not (meta) + return style + + @classmethod + def on(cls, meta: Optional[Dict[str, Any]] = None, **handlers: Any) -> "Style": + """Create a blank style with meta information. + + Example: + style = Style.on(click=self.on_click) + + Args: + meta (Optional[Dict[str, Any]], optional): An optional dict of meta information. + **handlers (Any): Keyword arguments are translated in to handlers. + + Returns: + Style: A Style with meta information attached. + """ + meta = {} if meta is None else meta + meta.update({f"@{key}": value for key, value in handlers.items()}) + return cls.from_meta(meta) + + bold = _Bit(0) + dim = _Bit(1) + italic = _Bit(2) + underline = _Bit(3) + blink = _Bit(4) + blink2 = _Bit(5) + reverse = _Bit(6) + conceal = _Bit(7) + strike = _Bit(8) + underline2 = _Bit(9) + frame = _Bit(10) + encircle = _Bit(11) + overline = _Bit(12) + + @property + def link_id(self) -> str: + """Get a link id, used in ansi code for links.""" + return self._link_id + + def __str__(self) -> str: + """Re-generate style definition from attributes.""" + if self._style_definition is None: + attributes: List[str] = [] + append = attributes.append + bits = self._set_attributes + if bits & 0b0000000001111: + if bits & 1: + append("bold" if self.bold else "not bold") + if bits & (1 << 1): + append("dim" if self.dim else "not dim") + if bits & (1 << 2): + append("italic" if self.italic else "not italic") + if bits & (1 << 3): + append("underline" if self.underline else "not underline") + if bits & 0b0000111110000: + if bits & (1 << 4): + append("blink" if self.blink else "not blink") + if bits & (1 << 5): + append("blink2" if self.blink2 else "not blink2") + if bits & (1 << 6): + append("reverse" if self.reverse else "not reverse") + if bits & (1 << 7): + append("conceal" if self.conceal else "not conceal") + if bits & (1 << 8): + append("strike" if self.strike else "not strike") + if bits & 0b1111000000000: + if bits & (1 << 9): + append("underline2" if self.underline2 else "not underline2") + if bits & (1 << 10): + append("frame" if self.frame else "not frame") + if bits & (1 << 11): + append("encircle" if self.encircle else "not encircle") + if bits & (1 << 12): + append("overline" if self.overline else "not overline") + if self._color is not None: + append(self._color.name) + if self._bgcolor is not None: + append("on") + append(self._bgcolor.name) + if self._link: + append("link") + append(self._link) + self._style_definition = " ".join(attributes) or "none" + return self._style_definition + + def __bool__(self) -> bool: + """A Style is false if it has no attributes, colors, or links.""" + return not self._null + + def _make_ansi_codes(self, color_system: ColorSystem) -> str: + """Generate ANSI codes for this style. + + Args: + color_system (ColorSystem): Color system. + + Returns: + str: String containing codes. + """ + + if self._ansi is None: + sgr: List[str] = [] + append = sgr.append + _style_map = self._style_map + attributes = self._attributes & self._set_attributes + if attributes: + if attributes & 1: + append(_style_map[0]) + if attributes & 2: + append(_style_map[1]) + if attributes & 4: + append(_style_map[2]) + if attributes & 8: + append(_style_map[3]) + if attributes & 0b0000111110000: + for bit in range(4, 9): + if attributes & (1 << bit): + append(_style_map[bit]) + if attributes & 0b1111000000000: + for bit in range(9, 13): + if attributes & (1 << bit): + append(_style_map[bit]) + if self._color is not None: + sgr.extend(self._color.downgrade(color_system).get_ansi_codes()) + if self._bgcolor is not None: + sgr.extend( + self._bgcolor.downgrade(color_system).get_ansi_codes( + foreground=False + ) + ) + self._ansi = ";".join(sgr) + return self._ansi + + @classmethod + @lru_cache(maxsize=1024) + def normalize(cls, style: str) -> str: + """Normalize a style definition so that styles with the same effect have the same string + representation. + + Args: + style (str): A style definition. + + Returns: + str: Normal form of style definition. + """ + try: + return str(cls.parse(style)) + except errors.StyleSyntaxError: + return style.strip().lower() + + @classmethod + def pick_first(cls, *values: Optional[StyleType]) -> StyleType: + """Pick first non-None style.""" + for value in values: + if value is not None: + return value + raise ValueError("expected at least one non-None style") + + def __rich_repr__(self) -> Result: + yield "color", self.color, None + yield "bgcolor", self.bgcolor, None + yield "bold", self.bold, None, + yield "dim", self.dim, None, + yield "italic", self.italic, None + yield "underline", self.underline, None, + yield "blink", self.blink, None + yield "blink2", self.blink2, None + yield "reverse", self.reverse, None + yield "conceal", self.conceal, None + yield "strike", self.strike, None + yield "underline2", self.underline2, None + yield "frame", self.frame, None + yield "encircle", self.encircle, None + yield "link", self.link, None + if self._meta: + yield "meta", self.meta + + def __eq__(self, other: Any) -> bool: + if not isinstance(other, Style): + return NotImplemented + return self.__hash__() == other.__hash__() + + def __ne__(self, other: Any) -> bool: + if not isinstance(other, Style): + return NotImplemented + return self.__hash__() != other.__hash__() + + def __hash__(self) -> int: + if self._hash is not None: + return self._hash + self._hash = hash( + ( + self._color, + self._bgcolor, + self._attributes, + self._set_attributes, + self._link, + self._meta, + ) + ) + return self._hash + + @property + def color(self) -> Optional[Color]: + """The foreground color or None if it is not set.""" + return self._color + + @property + def bgcolor(self) -> Optional[Color]: + """The background color or None if it is not set.""" + return self._bgcolor + + @property + def link(self) -> Optional[str]: + """Link text, if set.""" + return self._link + + @property + def transparent_background(self) -> bool: + """Check if the style specified a transparent background.""" + return self.bgcolor is None or self.bgcolor.is_default + + @property + def background_style(self) -> "Style": + """A Style with background only.""" + return Style(bgcolor=self.bgcolor) + + @property + def meta(self) -> Dict[str, Any]: + """Get meta information (can not be changed after construction).""" + return {} if self._meta is None else cast(Dict[str, Any], loads(self._meta)) + + @property + def without_color(self) -> "Style": + """Get a copy of the style with color removed.""" + if self._null: + return NULL_STYLE + style: Style = self.__new__(Style) + style._ansi = None + style._style_definition = None + style._color = None + style._bgcolor = None + style._attributes = self._attributes + style._set_attributes = self._set_attributes + style._link = self._link + style._link_id = f"{randint(0, 999999)}" if self._link else "" + style._null = False + style._meta = None + style._hash = None + return style + + @classmethod + @lru_cache(maxsize=4096) + def parse(cls, style_definition: str) -> "Style": + """Parse a style definition. + + Args: + style_definition (str): A string containing a style. + + Raises: + errors.StyleSyntaxError: If the style definition syntax is invalid. + + Returns: + `Style`: A Style instance. + """ + if style_definition.strip() == "none" or not style_definition: + return cls.null() + + STYLE_ATTRIBUTES = cls.STYLE_ATTRIBUTES + color: Optional[str] = None + bgcolor: Optional[str] = None + attributes: Dict[str, Optional[Any]] = {} + link: Optional[str] = None + + words = iter(style_definition.split()) + for original_word in words: + word = original_word.lower() + if word == "on": + word = next(words, "") + if not word: + raise errors.StyleSyntaxError("color expected after 'on'") + try: + Color.parse(word) is None + except ColorParseError as error: + raise errors.StyleSyntaxError( + f"unable to parse {word!r} as background color; {error}" + ) from None + bgcolor = word + + elif word == "not": + word = next(words, "") + attribute = STYLE_ATTRIBUTES.get(word) + if attribute is None: + raise errors.StyleSyntaxError( + f"expected style attribute after 'not', found {word!r}" + ) + attributes[attribute] = False + + elif word == "link": + word = next(words, "") + if not word: + raise errors.StyleSyntaxError("URL expected after 'link'") + link = word + + elif word in STYLE_ATTRIBUTES: + attributes[STYLE_ATTRIBUTES[word]] = True + + else: + try: + Color.parse(word) + except ColorParseError as error: + raise errors.StyleSyntaxError( + f"unable to parse {word!r} as color; {error}" + ) from None + color = word + style = Style(color=color, bgcolor=bgcolor, link=link, **attributes) + return style + + @lru_cache(maxsize=1024) + def get_html_style(self, theme: Optional[TerminalTheme] = None) -> str: + """Get a CSS style rule.""" + theme = theme or DEFAULT_TERMINAL_THEME + css: List[str] = [] + append = css.append + + color = self.color + bgcolor = self.bgcolor + if self.reverse: + color, bgcolor = bgcolor, color + if self.dim: + foreground_color = ( + theme.foreground_color if color is None else color.get_truecolor(theme) + ) + color = Color.from_triplet( + blend_rgb(foreground_color, theme.background_color, 0.5) + ) + if color is not None: + theme_color = color.get_truecolor(theme) + append(f"color: {theme_color.hex}") + append(f"text-decoration-color: {theme_color.hex}") + if bgcolor is not None: + theme_color = bgcolor.get_truecolor(theme, foreground=False) + append(f"background-color: {theme_color.hex}") + if self.bold: + append("font-weight: bold") + if self.italic: + append("font-style: italic") + if self.underline: + append("text-decoration: underline") + if self.strike: + append("text-decoration: line-through") + if self.overline: + append("text-decoration: overline") + return "; ".join(css) + + @classmethod + def combine(cls, styles: Iterable["Style"]) -> "Style": + """Combine styles and get result. + + Args: + styles (Iterable[Style]): Styles to combine. + + Returns: + Style: A new style instance. + """ + iter_styles = iter(styles) + return sum(iter_styles, next(iter_styles)) + + @classmethod + def chain(cls, *styles: "Style") -> "Style": + """Combine styles from positional argument in to a single style. + + Args: + *styles (Iterable[Style]): Styles to combine. + + Returns: + Style: A new style instance. + """ + iter_styles = iter(styles) + return sum(iter_styles, next(iter_styles)) + + def copy(self) -> "Style": + """Get a copy of this style. + + Returns: + Style: A new Style instance with identical attributes. + """ + if self._null: + return NULL_STYLE + style: Style = self.__new__(Style) + style._ansi = self._ansi + style._style_definition = self._style_definition + style._color = self._color + style._bgcolor = self._bgcolor + style._attributes = self._attributes + style._set_attributes = self._set_attributes + style._link = self._link + style._link_id = f"{randint(0, 999999)}" if self._link else "" + style._hash = self._hash + style._null = False + style._meta = self._meta + return style + + @lru_cache(maxsize=128) + def clear_meta_and_links(self) -> "Style": + """Get a copy of this style with link and meta information removed. + + Returns: + Style: New style object. + """ + if self._null: + return NULL_STYLE + style: Style = self.__new__(Style) + style._ansi = self._ansi + style._style_definition = self._style_definition + style._color = self._color + style._bgcolor = self._bgcolor + style._attributes = self._attributes + style._set_attributes = self._set_attributes + style._link = None + style._link_id = "" + style._hash = self._hash + style._null = False + style._meta = None + return style + + def update_link(self, link: Optional[str] = None) -> "Style": + """Get a copy with a different value for link. + + Args: + link (str, optional): New value for link. Defaults to None. + + Returns: + Style: A new Style instance. + """ + style: Style = self.__new__(Style) + style._ansi = self._ansi + style._style_definition = self._style_definition + style._color = self._color + style._bgcolor = self._bgcolor + style._attributes = self._attributes + style._set_attributes = self._set_attributes + style._link = link + style._link_id = f"{randint(0, 999999)}" if link else "" + style._hash = None + style._null = False + style._meta = self._meta + return style + + def render( + self, + text: str = "", + *, + color_system: Optional[ColorSystem] = ColorSystem.TRUECOLOR, + legacy_windows: bool = False, + ) -> str: + """Render the ANSI codes for the style. + + Args: + text (str, optional): A string to style. Defaults to "". + color_system (Optional[ColorSystem], optional): Color system to render to. Defaults to ColorSystem.TRUECOLOR. + + Returns: + str: A string containing ANSI style codes. + """ + if not text or color_system is None: + return text + attrs = self._ansi or self._make_ansi_codes(color_system) + rendered = f"\x1b[{attrs}m{text}\x1b[0m" if attrs else text + if self._link and not legacy_windows: + rendered = ( + f"\x1b]8;id={self._link_id};{self._link}\x1b\\{rendered}\x1b]8;;\x1b\\" + ) + return rendered + + def test(self, text: Optional[str] = None) -> None: + """Write text with style directly to terminal. + + This method is for testing purposes only. + + Args: + text (Optional[str], optional): Text to style or None for style name. + + """ + text = text or str(self) + sys.stdout.write(f"{self.render(text)}\n") + + @lru_cache(maxsize=1024) + def _add(self, style: Optional["Style"]) -> "Style": + if style is None or style._null: + return self + if self._null: + return style + new_style: Style = self.__new__(Style) + new_style._ansi = None + new_style._style_definition = None + new_style._color = style._color or self._color + new_style._bgcolor = style._bgcolor or self._bgcolor + new_style._attributes = (self._attributes & ~style._set_attributes) | ( + style._attributes & style._set_attributes + ) + new_style._set_attributes = self._set_attributes | style._set_attributes + new_style._link = style._link or self._link + new_style._link_id = style._link_id or self._link_id + new_style._null = style._null + if self._meta and style._meta: + new_style._meta = dumps({**self.meta, **style.meta}) + else: + new_style._meta = self._meta or style._meta + new_style._hash = None + return new_style + + def __add__(self, style: Optional["Style"]) -> "Style": + combined_style = self._add(style) + return combined_style.copy() if combined_style.link else combined_style + + +NULL_STYLE = Style() + + +class StyleStack: + """A stack of styles.""" + + __slots__ = ["_stack"] + + def __init__(self, default_style: "Style") -> None: + self._stack: List[Style] = [default_style] + + def __repr__(self) -> str: + return f"" + + @property + def current(self) -> Style: + """Get the Style at the top of the stack.""" + return self._stack[-1] + + def push(self, style: Style) -> None: + """Push a new style on to the stack. + + Args: + style (Style): New style to combine with current style. + """ + self._stack.append(self._stack[-1] + style) + + def pop(self) -> Style: + """Pop last style and discard. + + Returns: + Style: New current style (also available as stack.current) + """ + self._stack.pop() + return self._stack[-1] diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/styled.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/styled.py new file mode 100644 index 0000000..91cd0db --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/styled.py @@ -0,0 +1,42 @@ +from typing import TYPE_CHECKING + +from .measure import Measurement +from .segment import Segment +from .style import StyleType + +if TYPE_CHECKING: + from .console import Console, ConsoleOptions, RenderResult, RenderableType + + +class Styled: + """Apply a style to a renderable. + + Args: + renderable (RenderableType): Any renderable. + style (StyleType): A style to apply across the entire renderable. + """ + + def __init__(self, renderable: "RenderableType", style: "StyleType") -> None: + self.renderable = renderable + self.style = style + + def __rich_console__( + self, console: "Console", options: "ConsoleOptions" + ) -> "RenderResult": + style = console.get_style(self.style) + rendered_segments = console.render(self.renderable, options) + segments = Segment.apply_style(rendered_segments, style) + return segments + + def __rich_measure__( + self, console: "Console", options: "ConsoleOptions" + ) -> Measurement: + return Measurement.get(console, options, self.renderable) + + +if __name__ == "__main__": # pragma: no cover + from pip._vendor.rich import print + from pip._vendor.rich.panel import Panel + + panel = Styled(Panel("hello"), "on blue") + print(panel) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/syntax.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/syntax.py new file mode 100644 index 0000000..c26fd87 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/syntax.py @@ -0,0 +1,958 @@ +import os.path +import platform +import re +import sys +import textwrap +from abc import ABC, abstractmethod +from pathlib import Path +from typing import ( + Any, + Dict, + Iterable, + List, + NamedTuple, + Optional, + Sequence, + Set, + Tuple, + Type, + Union, +) + +from pip._vendor.pygments.lexer import Lexer +from pip._vendor.pygments.lexers import get_lexer_by_name, guess_lexer_for_filename +from pip._vendor.pygments.style import Style as PygmentsStyle +from pip._vendor.pygments.styles import get_style_by_name +from pip._vendor.pygments.token import ( + Comment, + Error, + Generic, + Keyword, + Name, + Number, + Operator, + String, + Token, + Whitespace, +) +from pip._vendor.pygments.util import ClassNotFound + +from pip._vendor.rich.containers import Lines +from pip._vendor.rich.padding import Padding, PaddingDimensions + +from ._loop import loop_first +from .cells import cell_len +from .color import Color, blend_rgb +from .console import Console, ConsoleOptions, JustifyMethod, RenderResult +from .jupyter import JupyterMixin +from .measure import Measurement +from .segment import Segment, Segments +from .style import Style, StyleType +from .text import Text + +TokenType = Tuple[str, ...] + +WINDOWS = platform.system() == "Windows" +DEFAULT_THEME = "monokai" + +# The following styles are based on https://github.com/pygments/pygments/blob/master/pygments/formatters/terminal.py +# A few modifications were made + +ANSI_LIGHT: Dict[TokenType, Style] = { + Token: Style(), + Whitespace: Style(color="white"), + Comment: Style(dim=True), + Comment.Preproc: Style(color="cyan"), + Keyword: Style(color="blue"), + Keyword.Type: Style(color="cyan"), + Operator.Word: Style(color="magenta"), + Name.Builtin: Style(color="cyan"), + Name.Function: Style(color="green"), + Name.Namespace: Style(color="cyan", underline=True), + Name.Class: Style(color="green", underline=True), + Name.Exception: Style(color="cyan"), + Name.Decorator: Style(color="magenta", bold=True), + Name.Variable: Style(color="red"), + Name.Constant: Style(color="red"), + Name.Attribute: Style(color="cyan"), + Name.Tag: Style(color="bright_blue"), + String: Style(color="yellow"), + Number: Style(color="blue"), + Generic.Deleted: Style(color="bright_red"), + Generic.Inserted: Style(color="green"), + Generic.Heading: Style(bold=True), + Generic.Subheading: Style(color="magenta", bold=True), + Generic.Prompt: Style(bold=True), + Generic.Error: Style(color="bright_red"), + Error: Style(color="red", underline=True), +} + +ANSI_DARK: Dict[TokenType, Style] = { + Token: Style(), + Whitespace: Style(color="bright_black"), + Comment: Style(dim=True), + Comment.Preproc: Style(color="bright_cyan"), + Keyword: Style(color="bright_blue"), + Keyword.Type: Style(color="bright_cyan"), + Operator.Word: Style(color="bright_magenta"), + Name.Builtin: Style(color="bright_cyan"), + Name.Function: Style(color="bright_green"), + Name.Namespace: Style(color="bright_cyan", underline=True), + Name.Class: Style(color="bright_green", underline=True), + Name.Exception: Style(color="bright_cyan"), + Name.Decorator: Style(color="bright_magenta", bold=True), + Name.Variable: Style(color="bright_red"), + Name.Constant: Style(color="bright_red"), + Name.Attribute: Style(color="bright_cyan"), + Name.Tag: Style(color="bright_blue"), + String: Style(color="yellow"), + Number: Style(color="bright_blue"), + Generic.Deleted: Style(color="bright_red"), + Generic.Inserted: Style(color="bright_green"), + Generic.Heading: Style(bold=True), + Generic.Subheading: Style(color="bright_magenta", bold=True), + Generic.Prompt: Style(bold=True), + Generic.Error: Style(color="bright_red"), + Error: Style(color="red", underline=True), +} + +RICH_SYNTAX_THEMES = {"ansi_light": ANSI_LIGHT, "ansi_dark": ANSI_DARK} +NUMBERS_COLUMN_DEFAULT_PADDING = 2 + + +class SyntaxTheme(ABC): + """Base class for a syntax theme.""" + + @abstractmethod + def get_style_for_token(self, token_type: TokenType) -> Style: + """Get a style for a given Pygments token.""" + raise NotImplementedError # pragma: no cover + + @abstractmethod + def get_background_style(self) -> Style: + """Get the background color.""" + raise NotImplementedError # pragma: no cover + + +class PygmentsSyntaxTheme(SyntaxTheme): + """Syntax theme that delegates to Pygments theme.""" + + def __init__(self, theme: Union[str, Type[PygmentsStyle]]) -> None: + self._style_cache: Dict[TokenType, Style] = {} + if isinstance(theme, str): + try: + self._pygments_style_class = get_style_by_name(theme) + except ClassNotFound: + self._pygments_style_class = get_style_by_name("default") + else: + self._pygments_style_class = theme + + self._background_color = self._pygments_style_class.background_color + self._background_style = Style(bgcolor=self._background_color) + + def get_style_for_token(self, token_type: TokenType) -> Style: + """Get a style from a Pygments class.""" + try: + return self._style_cache[token_type] + except KeyError: + try: + pygments_style = self._pygments_style_class.style_for_token(token_type) + except KeyError: + style = Style.null() + else: + color = pygments_style["color"] + bgcolor = pygments_style["bgcolor"] + style = Style( + color="#" + color if color else "#000000", + bgcolor="#" + bgcolor if bgcolor else self._background_color, + bold=pygments_style["bold"], + italic=pygments_style["italic"], + underline=pygments_style["underline"], + ) + self._style_cache[token_type] = style + return style + + def get_background_style(self) -> Style: + return self._background_style + + +class ANSISyntaxTheme(SyntaxTheme): + """Syntax theme to use standard colors.""" + + def __init__(self, style_map: Dict[TokenType, Style]) -> None: + self.style_map = style_map + self._missing_style = Style.null() + self._background_style = Style.null() + self._style_cache: Dict[TokenType, Style] = {} + + def get_style_for_token(self, token_type: TokenType) -> Style: + """Look up style in the style map.""" + try: + return self._style_cache[token_type] + except KeyError: + # Styles form a hierarchy + # We need to go from most to least specific + # e.g. ("foo", "bar", "baz") to ("foo", "bar") to ("foo",) + get_style = self.style_map.get + token = tuple(token_type) + style = self._missing_style + while token: + _style = get_style(token) + if _style is not None: + style = _style + break + token = token[:-1] + self._style_cache[token_type] = style + return style + + def get_background_style(self) -> Style: + return self._background_style + + +SyntaxPosition = Tuple[int, int] + + +class _SyntaxHighlightRange(NamedTuple): + """ + A range to highlight in a Syntax object. + `start` and `end` are 2-integers tuples, where the first integer is the line number + (starting from 1) and the second integer is the column index (starting from 0). + """ + + style: StyleType + start: SyntaxPosition + end: SyntaxPosition + + +class Syntax(JupyterMixin): + """Construct a Syntax object to render syntax highlighted code. + + Args: + code (str): Code to highlight. + lexer (Lexer | str): Lexer to use (see https://pygments.org/docs/lexers/) + theme (str, optional): Color theme, aka Pygments style (see https://pygments.org/docs/styles/#getting-a-list-of-available-styles). Defaults to "monokai". + dedent (bool, optional): Enable stripping of initial whitespace. Defaults to False. + line_numbers (bool, optional): Enable rendering of line numbers. Defaults to False. + start_line (int, optional): Starting number for line numbers. Defaults to 1. + line_range (Tuple[int | None, int | None], optional): If given should be a tuple of the start and end line to render. + A value of None in the tuple indicates the range is open in that direction. + highlight_lines (Set[int]): A set of line numbers to highlight. + code_width: Width of code to render (not including line numbers), or ``None`` to use all available width. + tab_size (int, optional): Size of tabs. Defaults to 4. + word_wrap (bool, optional): Enable word wrapping. + background_color (str, optional): Optional background color, or None to use theme color. Defaults to None. + indent_guides (bool, optional): Show indent guides. Defaults to False. + padding (PaddingDimensions): Padding to apply around the syntax. Defaults to 0 (no padding). + """ + + _pygments_style_class: Type[PygmentsStyle] + _theme: SyntaxTheme + + @classmethod + def get_theme(cls, name: Union[str, SyntaxTheme]) -> SyntaxTheme: + """Get a syntax theme instance.""" + if isinstance(name, SyntaxTheme): + return name + theme: SyntaxTheme + if name in RICH_SYNTAX_THEMES: + theme = ANSISyntaxTheme(RICH_SYNTAX_THEMES[name]) + else: + theme = PygmentsSyntaxTheme(name) + return theme + + def __init__( + self, + code: str, + lexer: Union[Lexer, str], + *, + theme: Union[str, SyntaxTheme] = DEFAULT_THEME, + dedent: bool = False, + line_numbers: bool = False, + start_line: int = 1, + line_range: Optional[Tuple[Optional[int], Optional[int]]] = None, + highlight_lines: Optional[Set[int]] = None, + code_width: Optional[int] = None, + tab_size: int = 4, + word_wrap: bool = False, + background_color: Optional[str] = None, + indent_guides: bool = False, + padding: PaddingDimensions = 0, + ) -> None: + self.code = code + self._lexer = lexer + self.dedent = dedent + self.line_numbers = line_numbers + self.start_line = start_line + self.line_range = line_range + self.highlight_lines = highlight_lines or set() + self.code_width = code_width + self.tab_size = tab_size + self.word_wrap = word_wrap + self.background_color = background_color + self.background_style = ( + Style(bgcolor=background_color) if background_color else Style() + ) + self.indent_guides = indent_guides + self.padding = padding + + self._theme = self.get_theme(theme) + self._stylized_ranges: List[_SyntaxHighlightRange] = [] + + @classmethod + def from_path( + cls, + path: str, + encoding: str = "utf-8", + lexer: Optional[Union[Lexer, str]] = None, + theme: Union[str, SyntaxTheme] = DEFAULT_THEME, + dedent: bool = False, + line_numbers: bool = False, + line_range: Optional[Tuple[int, int]] = None, + start_line: int = 1, + highlight_lines: Optional[Set[int]] = None, + code_width: Optional[int] = None, + tab_size: int = 4, + word_wrap: bool = False, + background_color: Optional[str] = None, + indent_guides: bool = False, + padding: PaddingDimensions = 0, + ) -> "Syntax": + """Construct a Syntax object from a file. + + Args: + path (str): Path to file to highlight. + encoding (str): Encoding of file. + lexer (str | Lexer, optional): Lexer to use. If None, lexer will be auto-detected from path/file content. + theme (str, optional): Color theme, aka Pygments style (see https://pygments.org/docs/styles/#getting-a-list-of-available-styles). Defaults to "emacs". + dedent (bool, optional): Enable stripping of initial whitespace. Defaults to True. + line_numbers (bool, optional): Enable rendering of line numbers. Defaults to False. + start_line (int, optional): Starting number for line numbers. Defaults to 1. + line_range (Tuple[int, int], optional): If given should be a tuple of the start and end line to render. + highlight_lines (Set[int]): A set of line numbers to highlight. + code_width: Width of code to render (not including line numbers), or ``None`` to use all available width. + tab_size (int, optional): Size of tabs. Defaults to 4. + word_wrap (bool, optional): Enable word wrapping of code. + background_color (str, optional): Optional background color, or None to use theme color. Defaults to None. + indent_guides (bool, optional): Show indent guides. Defaults to False. + padding (PaddingDimensions): Padding to apply around the syntax. Defaults to 0 (no padding). + + Returns: + [Syntax]: A Syntax object that may be printed to the console + """ + code = Path(path).read_text(encoding=encoding) + + if not lexer: + lexer = cls.guess_lexer(path, code=code) + + return cls( + code, + lexer, + theme=theme, + dedent=dedent, + line_numbers=line_numbers, + line_range=line_range, + start_line=start_line, + highlight_lines=highlight_lines, + code_width=code_width, + tab_size=tab_size, + word_wrap=word_wrap, + background_color=background_color, + indent_guides=indent_guides, + padding=padding, + ) + + @classmethod + def guess_lexer(cls, path: str, code: Optional[str] = None) -> str: + """Guess the alias of the Pygments lexer to use based on a path and an optional string of code. + If code is supplied, it will use a combination of the code and the filename to determine the + best lexer to use. For example, if the file is ``index.html`` and the file contains Django + templating syntax, then "html+django" will be returned. If the file is ``index.html``, and no + templating language is used, the "html" lexer will be used. If no string of code + is supplied, the lexer will be chosen based on the file extension.. + + Args: + path (AnyStr): The path to the file containing the code you wish to know the lexer for. + code (str, optional): Optional string of code that will be used as a fallback if no lexer + is found for the supplied path. + + Returns: + str: The name of the Pygments lexer that best matches the supplied path/code. + """ + lexer: Optional[Lexer] = None + lexer_name = "default" + if code: + try: + lexer = guess_lexer_for_filename(path, code) + except ClassNotFound: + pass + + if not lexer: + try: + _, ext = os.path.splitext(path) + if ext: + extension = ext.lstrip(".").lower() + lexer = get_lexer_by_name(extension) + except ClassNotFound: + pass + + if lexer: + if lexer.aliases: + lexer_name = lexer.aliases[0] + else: + lexer_name = lexer.name + + return lexer_name + + def _get_base_style(self) -> Style: + """Get the base style.""" + default_style = self._theme.get_background_style() + self.background_style + return default_style + + def _get_token_color(self, token_type: TokenType) -> Optional[Color]: + """Get a color (if any) for the given token. + + Args: + token_type (TokenType): A token type tuple from Pygments. + + Returns: + Optional[Color]: Color from theme, or None for no color. + """ + style = self._theme.get_style_for_token(token_type) + return style.color + + @property + def lexer(self) -> Optional[Lexer]: + """The lexer for this syntax, or None if no lexer was found. + + Tries to find the lexer by name if a string was passed to the constructor. + """ + + if isinstance(self._lexer, Lexer): + return self._lexer + try: + return get_lexer_by_name( + self._lexer, + stripnl=False, + ensurenl=True, + tabsize=self.tab_size, + ) + except ClassNotFound: + return None + + @property + def default_lexer(self) -> Lexer: + """A Pygments Lexer to use if one is not specified or invalid.""" + return get_lexer_by_name( + "text", + stripnl=False, + ensurenl=True, + tabsize=self.tab_size, + ) + + def highlight( + self, + code: str, + line_range: Optional[Tuple[Optional[int], Optional[int]]] = None, + ) -> Text: + """Highlight code and return a Text instance. + + Args: + code (str): Code to highlight. + line_range(Tuple[int, int], optional): Optional line range to highlight. + + Returns: + Text: A text instance containing highlighted syntax. + """ + + base_style = self._get_base_style() + justify: JustifyMethod = ( + "default" if base_style.transparent_background else "left" + ) + + text = Text( + justify=justify, + style=base_style, + tab_size=self.tab_size, + no_wrap=not self.word_wrap, + ) + _get_theme_style = self._theme.get_style_for_token + + lexer = self.lexer or self.default_lexer + + if lexer is None: + text.append(code) + else: + if line_range: + # More complicated path to only stylize a portion of the code + # This speeds up further operations as there are less spans to process + line_start, line_end = line_range + + def line_tokenize() -> Iterable[Tuple[Any, str]]: + """Split tokens to one per line.""" + assert lexer # required to make MyPy happy - we know lexer is not None at this point + + for token_type, token in lexer.get_tokens(code): + while token: + line_token, new_line, token = token.partition("\n") + yield token_type, line_token + new_line + + def tokens_to_spans() -> Iterable[Tuple[str, Optional[Style]]]: + """Convert tokens to spans.""" + tokens = iter(line_tokenize()) + line_no = 0 + _line_start = line_start - 1 if line_start else 0 + + # Skip over tokens until line start + while line_no < _line_start: + try: + _token_type, token = next(tokens) + except StopIteration: + break + yield (token, None) + if token.endswith("\n"): + line_no += 1 + # Generate spans until line end + for token_type, token in tokens: + yield (token, _get_theme_style(token_type)) + if token.endswith("\n"): + line_no += 1 + if line_end and line_no >= line_end: + break + + text.append_tokens(tokens_to_spans()) + + else: + text.append_tokens( + (token, _get_theme_style(token_type)) + for token_type, token in lexer.get_tokens(code) + ) + if self.background_color is not None: + text.stylize(f"on {self.background_color}") + + if self._stylized_ranges: + self._apply_stylized_ranges(text) + + return text + + def stylize_range( + self, style: StyleType, start: SyntaxPosition, end: SyntaxPosition + ) -> None: + """ + Adds a custom style on a part of the code, that will be applied to the syntax display when it's rendered. + Line numbers are 1-based, while column indexes are 0-based. + + Args: + style (StyleType): The style to apply. + start (Tuple[int, int]): The start of the range, in the form `[line number, column index]`. + end (Tuple[int, int]): The end of the range, in the form `[line number, column index]`. + """ + self._stylized_ranges.append(_SyntaxHighlightRange(style, start, end)) + + def _get_line_numbers_color(self, blend: float = 0.3) -> Color: + background_style = self._theme.get_background_style() + self.background_style + background_color = background_style.bgcolor + if background_color is None or background_color.is_system_defined: + return Color.default() + foreground_color = self._get_token_color(Token.Text) + if foreground_color is None or foreground_color.is_system_defined: + return foreground_color or Color.default() + new_color = blend_rgb( + background_color.get_truecolor(), + foreground_color.get_truecolor(), + cross_fade=blend, + ) + return Color.from_triplet(new_color) + + @property + def _numbers_column_width(self) -> int: + """Get the number of characters used to render the numbers column.""" + column_width = 0 + if self.line_numbers: + column_width = ( + len(str(self.start_line + self.code.count("\n"))) + + NUMBERS_COLUMN_DEFAULT_PADDING + ) + return column_width + + def _get_number_styles(self, console: Console) -> Tuple[Style, Style, Style]: + """Get background, number, and highlight styles for line numbers.""" + background_style = self._get_base_style() + if background_style.transparent_background: + return Style.null(), Style(dim=True), Style.null() + if console.color_system in ("256", "truecolor"): + number_style = Style.chain( + background_style, + self._theme.get_style_for_token(Token.Text), + Style(color=self._get_line_numbers_color()), + self.background_style, + ) + highlight_number_style = Style.chain( + background_style, + self._theme.get_style_for_token(Token.Text), + Style(bold=True, color=self._get_line_numbers_color(0.9)), + self.background_style, + ) + else: + number_style = background_style + Style(dim=True) + highlight_number_style = background_style + Style(dim=False) + return background_style, number_style, highlight_number_style + + def __rich_measure__( + self, console: "Console", options: "ConsoleOptions" + ) -> "Measurement": + _, right, _, left = Padding.unpack(self.padding) + padding = left + right + if self.code_width is not None: + width = self.code_width + self._numbers_column_width + padding + 1 + return Measurement(self._numbers_column_width, width) + lines = self.code.splitlines() + width = ( + self._numbers_column_width + + padding + + (max(cell_len(line) for line in lines) if lines else 0) + ) + if self.line_numbers: + width += 1 + return Measurement(self._numbers_column_width, width) + + def __rich_console__( + self, console: Console, options: ConsoleOptions + ) -> RenderResult: + segments = Segments(self._get_syntax(console, options)) + if self.padding: + yield Padding( + segments, style=self._theme.get_background_style(), pad=self.padding + ) + else: + yield segments + + def _get_syntax( + self, + console: Console, + options: ConsoleOptions, + ) -> Iterable[Segment]: + """ + Get the Segments for the Syntax object, excluding any vertical/horizontal padding + """ + transparent_background = self._get_base_style().transparent_background + code_width = ( + ( + (options.max_width - self._numbers_column_width - 1) + if self.line_numbers + else options.max_width + ) + if self.code_width is None + else self.code_width + ) + + ends_on_nl, processed_code = self._process_code(self.code) + text = self.highlight(processed_code, self.line_range) + + if not self.line_numbers and not self.word_wrap and not self.line_range: + if not ends_on_nl: + text.remove_suffix("\n") + # Simple case of just rendering text + style = ( + self._get_base_style() + + self._theme.get_style_for_token(Comment) + + Style(dim=True) + + self.background_style + ) + if self.indent_guides and not options.ascii_only: + text = text.with_indent_guides(self.tab_size, style=style) + text.overflow = "crop" + if style.transparent_background: + yield from console.render( + text, options=options.update(width=code_width) + ) + else: + syntax_lines = console.render_lines( + text, + options.update(width=code_width, height=None, justify="left"), + style=self.background_style, + pad=True, + new_lines=True, + ) + for syntax_line in syntax_lines: + yield from syntax_line + return + + start_line, end_line = self.line_range or (None, None) + line_offset = 0 + if start_line: + line_offset = max(0, start_line - 1) + lines: Union[List[Text], Lines] = text.split("\n", allow_blank=ends_on_nl) + if self.line_range: + if line_offset > len(lines): + return + lines = lines[line_offset:end_line] + + if self.indent_guides and not options.ascii_only: + style = ( + self._get_base_style() + + self._theme.get_style_for_token(Comment) + + Style(dim=True) + + self.background_style + ) + lines = ( + Text("\n") + .join(lines) + .with_indent_guides(self.tab_size, style=style + Style(italic=False)) + .split("\n", allow_blank=True) + ) + + numbers_column_width = self._numbers_column_width + render_options = options.update(width=code_width) + + highlight_line = self.highlight_lines.__contains__ + _Segment = Segment + new_line = _Segment("\n") + + line_pointer = "> " if options.legacy_windows else "❱ " + + ( + background_style, + number_style, + highlight_number_style, + ) = self._get_number_styles(console) + + for line_no, line in enumerate(lines, self.start_line + line_offset): + if self.word_wrap: + wrapped_lines = console.render_lines( + line, + render_options.update(height=None, justify="left"), + style=background_style, + pad=not transparent_background, + ) + else: + segments = list(line.render(console, end="")) + if options.no_wrap: + wrapped_lines = [segments] + else: + wrapped_lines = [ + _Segment.adjust_line_length( + segments, + render_options.max_width, + style=background_style, + pad=not transparent_background, + ) + ] + + if self.line_numbers: + wrapped_line_left_pad = _Segment( + " " * numbers_column_width + " ", background_style + ) + for first, wrapped_line in loop_first(wrapped_lines): + if first: + line_column = str(line_no).rjust(numbers_column_width - 2) + " " + if highlight_line(line_no): + yield _Segment(line_pointer, Style(color="red")) + yield _Segment(line_column, highlight_number_style) + else: + yield _Segment(" ", highlight_number_style) + yield _Segment(line_column, number_style) + else: + yield wrapped_line_left_pad + yield from wrapped_line + yield new_line + else: + for wrapped_line in wrapped_lines: + yield from wrapped_line + yield new_line + + def _apply_stylized_ranges(self, text: Text) -> None: + """ + Apply stylized ranges to a text instance, + using the given code to determine the right portion to apply the style to. + + Args: + text (Text): Text instance to apply the style to. + """ + code = text.plain + newlines_offsets = [ + # Let's add outer boundaries at each side of the list: + 0, + # N.B. using "\n" here is much faster than using metacharacters such as "^" or "\Z": + *[ + match.start() + 1 + for match in re.finditer("\n", code, flags=re.MULTILINE) + ], + len(code) + 1, + ] + + for stylized_range in self._stylized_ranges: + start = _get_code_index_for_syntax_position( + newlines_offsets, stylized_range.start + ) + end = _get_code_index_for_syntax_position( + newlines_offsets, stylized_range.end + ) + if start is not None and end is not None: + text.stylize(stylized_range.style, start, end) + + def _process_code(self, code: str) -> Tuple[bool, str]: + """ + Applies various processing to a raw code string + (normalises it so it always ends with a line return, dedents it if necessary, etc.) + + Args: + code (str): The raw code string to process + + Returns: + Tuple[bool, str]: the boolean indicates whether the raw code ends with a line return, + while the string is the processed code. + """ + ends_on_nl = code.endswith("\n") + processed_code = code if ends_on_nl else code + "\n" + processed_code = ( + textwrap.dedent(processed_code) if self.dedent else processed_code + ) + processed_code = processed_code.expandtabs(self.tab_size) + return ends_on_nl, processed_code + + +def _get_code_index_for_syntax_position( + newlines_offsets: Sequence[int], position: SyntaxPosition +) -> Optional[int]: + """ + Returns the index of the code string for the given positions. + + Args: + newlines_offsets (Sequence[int]): The offset of each newline character found in the code snippet. + position (SyntaxPosition): The position to search for. + + Returns: + Optional[int]: The index of the code string for this position, or `None` + if the given position's line number is out of range (if it's the column that is out of range + we silently clamp its value so that it reaches the end of the line) + """ + lines_count = len(newlines_offsets) + + line_number, column_index = position + if line_number > lines_count or len(newlines_offsets) < (line_number + 1): + return None # `line_number` is out of range + line_index = line_number - 1 + line_length = newlines_offsets[line_index + 1] - newlines_offsets[line_index] - 1 + # If `column_index` is out of range: let's silently clamp it: + column_index = min(line_length, column_index) + return newlines_offsets[line_index] + column_index + + +if __name__ == "__main__": # pragma: no cover + import argparse + import sys + + parser = argparse.ArgumentParser( + description="Render syntax to the console with Rich" + ) + parser.add_argument( + "path", + metavar="PATH", + help="path to file, or - for stdin", + ) + parser.add_argument( + "-c", + "--force-color", + dest="force_color", + action="store_true", + default=None, + help="force color for non-terminals", + ) + parser.add_argument( + "-i", + "--indent-guides", + dest="indent_guides", + action="store_true", + default=False, + help="display indent guides", + ) + parser.add_argument( + "-l", + "--line-numbers", + dest="line_numbers", + action="store_true", + help="render line numbers", + ) + parser.add_argument( + "-w", + "--width", + type=int, + dest="width", + default=None, + help="width of output (default will auto-detect)", + ) + parser.add_argument( + "-r", + "--wrap", + dest="word_wrap", + action="store_true", + default=False, + help="word wrap long lines", + ) + parser.add_argument( + "-s", + "--soft-wrap", + action="store_true", + dest="soft_wrap", + default=False, + help="enable soft wrapping mode", + ) + parser.add_argument( + "-t", "--theme", dest="theme", default="monokai", help="pygments theme" + ) + parser.add_argument( + "-b", + "--background-color", + dest="background_color", + default=None, + help="Override background color", + ) + parser.add_argument( + "-x", + "--lexer", + default=None, + dest="lexer_name", + help="Lexer name", + ) + parser.add_argument( + "-p", "--padding", type=int, default=0, dest="padding", help="Padding" + ) + parser.add_argument( + "--highlight-line", + type=int, + default=None, + dest="highlight_line", + help="The line number (not index!) to highlight", + ) + args = parser.parse_args() + + from pip._vendor.rich.console import Console + + console = Console(force_terminal=args.force_color, width=args.width) + + if args.path == "-": + code = sys.stdin.read() + syntax = Syntax( + code=code, + lexer=args.lexer_name, + line_numbers=args.line_numbers, + word_wrap=args.word_wrap, + theme=args.theme, + background_color=args.background_color, + indent_guides=args.indent_guides, + padding=args.padding, + highlight_lines={args.highlight_line}, + ) + else: + syntax = Syntax.from_path( + args.path, + lexer=args.lexer_name, + line_numbers=args.line_numbers, + word_wrap=args.word_wrap, + theme=args.theme, + background_color=args.background_color, + indent_guides=args.indent_guides, + padding=args.padding, + highlight_lines={args.highlight_line}, + ) + console.print(syntax, soft_wrap=args.soft_wrap) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/table.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/table.py new file mode 100644 index 0000000..43c718e --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/table.py @@ -0,0 +1,1000 @@ +from dataclasses import dataclass, field, replace +from typing import ( + TYPE_CHECKING, + Dict, + Iterable, + List, + NamedTuple, + Optional, + Sequence, + Tuple, + Union, +) + +from . import box, errors +from ._loop import loop_first_last, loop_last +from ._pick import pick_bool +from ._ratio import ratio_distribute, ratio_reduce +from .align import VerticalAlignMethod +from .jupyter import JupyterMixin +from .measure import Measurement +from .padding import Padding, PaddingDimensions +from .protocol import is_renderable +from .segment import Segment +from .style import Style, StyleType +from .text import Text, TextType + +if TYPE_CHECKING: + from .console import ( + Console, + ConsoleOptions, + JustifyMethod, + OverflowMethod, + RenderableType, + RenderResult, + ) + + +@dataclass +class Column: + """Defines a column within a ~Table. + + Args: + title (Union[str, Text], optional): The title of the table rendered at the top. Defaults to None. + caption (Union[str, Text], optional): The table caption rendered below. Defaults to None. + width (int, optional): The width in characters of the table, or ``None`` to automatically fit. Defaults to None. + min_width (Optional[int], optional): The minimum width of the table, or ``None`` for no minimum. Defaults to None. + box (box.Box, optional): One of the constants in box.py used to draw the edges (see :ref:`appendix_box`), or ``None`` for no box lines. Defaults to box.HEAVY_HEAD. + safe_box (Optional[bool], optional): Disable box characters that don't display on windows legacy terminal with *raster* fonts. Defaults to True. + padding (PaddingDimensions, optional): Padding for cells (top, right, bottom, left). Defaults to (0, 1). + collapse_padding (bool, optional): Enable collapsing of padding around cells. Defaults to False. + pad_edge (bool, optional): Enable padding of edge cells. Defaults to True. + expand (bool, optional): Expand the table to fit the available space if ``True``, otherwise the table width will be auto-calculated. Defaults to False. + show_header (bool, optional): Show a header row. Defaults to True. + show_footer (bool, optional): Show a footer row. Defaults to False. + show_edge (bool, optional): Draw a box around the outside of the table. Defaults to True. + show_lines (bool, optional): Draw lines between every row. Defaults to False. + leading (bool, optional): Number of blank lines between rows (precludes ``show_lines``). Defaults to 0. + style (Union[str, Style], optional): Default style for the table. Defaults to "none". + row_styles (List[Union, str], optional): Optional list of row styles, if more than one style is given then the styles will alternate. Defaults to None. + header_style (Union[str, Style], optional): Style of the header. Defaults to "table.header". + footer_style (Union[str, Style], optional): Style of the footer. Defaults to "table.footer". + border_style (Union[str, Style], optional): Style of the border. Defaults to None. + title_style (Union[str, Style], optional): Style of the title. Defaults to None. + caption_style (Union[str, Style], optional): Style of the caption. Defaults to None. + title_justify (str, optional): Justify method for title. Defaults to "center". + caption_justify (str, optional): Justify method for caption. Defaults to "center". + highlight (bool, optional): Highlight cell contents (if str). Defaults to False. + """ + + header: "RenderableType" = "" + """RenderableType: Renderable for the header (typically a string)""" + + footer: "RenderableType" = "" + """RenderableType: Renderable for the footer (typically a string)""" + + header_style: StyleType = "" + """StyleType: The style of the header.""" + + footer_style: StyleType = "" + """StyleType: The style of the footer.""" + + style: StyleType = "" + """StyleType: The style of the column.""" + + justify: "JustifyMethod" = "left" + """str: How to justify text within the column ("left", "center", "right", or "full")""" + + vertical: "VerticalAlignMethod" = "top" + """str: How to vertically align content ("top", "middle", or "bottom")""" + + overflow: "OverflowMethod" = "ellipsis" + """str: Overflow method.""" + + width: Optional[int] = None + """Optional[int]: Width of the column, or ``None`` (default) to auto calculate width.""" + + min_width: Optional[int] = None + """Optional[int]: Minimum width of column, or ``None`` for no minimum. Defaults to None.""" + + max_width: Optional[int] = None + """Optional[int]: Maximum width of column, or ``None`` for no maximum. Defaults to None.""" + + ratio: Optional[int] = None + """Optional[int]: Ratio to use when calculating column width, or ``None`` (default) to adapt to column contents.""" + + no_wrap: bool = False + """bool: Prevent wrapping of text within the column. Defaults to ``False``.""" + + _index: int = 0 + """Index of column.""" + + _cells: List["RenderableType"] = field(default_factory=list) + + def copy(self) -> "Column": + """Return a copy of this Column.""" + return replace(self, _cells=[]) + + @property + def cells(self) -> Iterable["RenderableType"]: + """Get all cells in the column, not including header.""" + yield from self._cells + + @property + def flexible(self) -> bool: + """Check if this column is flexible.""" + return self.ratio is not None + + +@dataclass +class Row: + """Information regarding a row.""" + + style: Optional[StyleType] = None + """Style to apply to row.""" + + end_section: bool = False + """Indicated end of section, which will force a line beneath the row.""" + + +class _Cell(NamedTuple): + """A single cell in a table.""" + + style: StyleType + """Style to apply to cell.""" + renderable: "RenderableType" + """Cell renderable.""" + vertical: VerticalAlignMethod + """Cell vertical alignment.""" + + +class Table(JupyterMixin): + """A console renderable to draw a table. + + Args: + *headers (Union[Column, str]): Column headers, either as a string, or :class:`~rich.table.Column` instance. + title (Union[str, Text], optional): The title of the table rendered at the top. Defaults to None. + caption (Union[str, Text], optional): The table caption rendered below. Defaults to None. + width (int, optional): The width in characters of the table, or ``None`` to automatically fit. Defaults to None. + min_width (Optional[int], optional): The minimum width of the table, or ``None`` for no minimum. Defaults to None. + box (box.Box, optional): One of the constants in box.py used to draw the edges (see :ref:`appendix_box`), or ``None`` for no box lines. Defaults to box.HEAVY_HEAD. + safe_box (Optional[bool], optional): Disable box characters that don't display on windows legacy terminal with *raster* fonts. Defaults to True. + padding (PaddingDimensions, optional): Padding for cells (top, right, bottom, left). Defaults to (0, 1). + collapse_padding (bool, optional): Enable collapsing of padding around cells. Defaults to False. + pad_edge (bool, optional): Enable padding of edge cells. Defaults to True. + expand (bool, optional): Expand the table to fit the available space if ``True``, otherwise the table width will be auto-calculated. Defaults to False. + show_header (bool, optional): Show a header row. Defaults to True. + show_footer (bool, optional): Show a footer row. Defaults to False. + show_edge (bool, optional): Draw a box around the outside of the table. Defaults to True. + show_lines (bool, optional): Draw lines between every row. Defaults to False. + leading (bool, optional): Number of blank lines between rows (precludes ``show_lines``). Defaults to 0. + style (Union[str, Style], optional): Default style for the table. Defaults to "none". + row_styles (List[Union, str], optional): Optional list of row styles, if more than one style is given then the styles will alternate. Defaults to None. + header_style (Union[str, Style], optional): Style of the header. Defaults to "table.header". + footer_style (Union[str, Style], optional): Style of the footer. Defaults to "table.footer". + border_style (Union[str, Style], optional): Style of the border. Defaults to None. + title_style (Union[str, Style], optional): Style of the title. Defaults to None. + caption_style (Union[str, Style], optional): Style of the caption. Defaults to None. + title_justify (str, optional): Justify method for title. Defaults to "center". + caption_justify (str, optional): Justify method for caption. Defaults to "center". + highlight (bool, optional): Highlight cell contents (if str). Defaults to False. + """ + + columns: List[Column] + rows: List[Row] + + def __init__( + self, + *headers: Union[Column, str], + title: Optional[TextType] = None, + caption: Optional[TextType] = None, + width: Optional[int] = None, + min_width: Optional[int] = None, + box: Optional[box.Box] = box.HEAVY_HEAD, + safe_box: Optional[bool] = None, + padding: PaddingDimensions = (0, 1), + collapse_padding: bool = False, + pad_edge: bool = True, + expand: bool = False, + show_header: bool = True, + show_footer: bool = False, + show_edge: bool = True, + show_lines: bool = False, + leading: int = 0, + style: StyleType = "none", + row_styles: Optional[Iterable[StyleType]] = None, + header_style: Optional[StyleType] = "table.header", + footer_style: Optional[StyleType] = "table.footer", + border_style: Optional[StyleType] = None, + title_style: Optional[StyleType] = None, + caption_style: Optional[StyleType] = None, + title_justify: "JustifyMethod" = "center", + caption_justify: "JustifyMethod" = "center", + highlight: bool = False, + ) -> None: + self.columns: List[Column] = [] + self.rows: List[Row] = [] + self.title = title + self.caption = caption + self.width = width + self.min_width = min_width + self.box = box + self.safe_box = safe_box + self._padding = Padding.unpack(padding) + self.pad_edge = pad_edge + self._expand = expand + self.show_header = show_header + self.show_footer = show_footer + self.show_edge = show_edge + self.show_lines = show_lines + self.leading = leading + self.collapse_padding = collapse_padding + self.style = style + self.header_style = header_style or "" + self.footer_style = footer_style or "" + self.border_style = border_style + self.title_style = title_style + self.caption_style = caption_style + self.title_justify: "JustifyMethod" = title_justify + self.caption_justify: "JustifyMethod" = caption_justify + self.highlight = highlight + self.row_styles: Sequence[StyleType] = list(row_styles or []) + append_column = self.columns.append + for header in headers: + if isinstance(header, str): + self.add_column(header=header) + else: + header._index = len(self.columns) + append_column(header) + + @classmethod + def grid( + cls, + *headers: Union[Column, str], + padding: PaddingDimensions = 0, + collapse_padding: bool = True, + pad_edge: bool = False, + expand: bool = False, + ) -> "Table": + """Get a table with no lines, headers, or footer. + + Args: + *headers (Union[Column, str]): Column headers, either as a string, or :class:`~rich.table.Column` instance. + padding (PaddingDimensions, optional): Get padding around cells. Defaults to 0. + collapse_padding (bool, optional): Enable collapsing of padding around cells. Defaults to True. + pad_edge (bool, optional): Enable padding around edges of table. Defaults to False. + expand (bool, optional): Expand the table to fit the available space if ``True``, otherwise the table width will be auto-calculated. Defaults to False. + + Returns: + Table: A table instance. + """ + return cls( + *headers, + box=None, + padding=padding, + collapse_padding=collapse_padding, + show_header=False, + show_footer=False, + show_edge=False, + pad_edge=pad_edge, + expand=expand, + ) + + @property + def expand(self) -> bool: + """Setting a non-None self.width implies expand.""" + return self._expand or self.width is not None + + @expand.setter + def expand(self, expand: bool) -> None: + """Set expand.""" + self._expand = expand + + @property + def _extra_width(self) -> int: + """Get extra width to add to cell content.""" + width = 0 + if self.box and self.show_edge: + width += 2 + if self.box: + width += len(self.columns) - 1 + return width + + @property + def row_count(self) -> int: + """Get the current number of rows.""" + return len(self.rows) + + def get_row_style(self, console: "Console", index: int) -> StyleType: + """Get the current row style.""" + style = Style.null() + if self.row_styles: + style += console.get_style(self.row_styles[index % len(self.row_styles)]) + row_style = self.rows[index].style + if row_style is not None: + style += console.get_style(row_style) + return style + + def __rich_measure__( + self, console: "Console", options: "ConsoleOptions" + ) -> Measurement: + max_width = options.max_width + if self.width is not None: + max_width = self.width + if max_width < 0: + return Measurement(0, 0) + + extra_width = self._extra_width + max_width = sum( + self._calculate_column_widths( + console, options.update_width(max_width - extra_width) + ) + ) + _measure_column = self._measure_column + + measurements = [ + _measure_column(console, options.update_width(max_width), column) + for column in self.columns + ] + minimum_width = ( + sum(measurement.minimum for measurement in measurements) + extra_width + ) + maximum_width = ( + sum(measurement.maximum for measurement in measurements) + extra_width + if (self.width is None) + else self.width + ) + measurement = Measurement(minimum_width, maximum_width) + measurement = measurement.clamp(self.min_width) + return measurement + + @property + def padding(self) -> Tuple[int, int, int, int]: + """Get cell padding.""" + return self._padding + + @padding.setter + def padding(self, padding: PaddingDimensions) -> "Table": + """Set cell padding.""" + self._padding = Padding.unpack(padding) + return self + + def add_column( + self, + header: "RenderableType" = "", + footer: "RenderableType" = "", + *, + header_style: Optional[StyleType] = None, + footer_style: Optional[StyleType] = None, + style: Optional[StyleType] = None, + justify: "JustifyMethod" = "left", + vertical: "VerticalAlignMethod" = "top", + overflow: "OverflowMethod" = "ellipsis", + width: Optional[int] = None, + min_width: Optional[int] = None, + max_width: Optional[int] = None, + ratio: Optional[int] = None, + no_wrap: bool = False, + ) -> None: + """Add a column to the table. + + Args: + header (RenderableType, optional): Text or renderable for the header. + Defaults to "". + footer (RenderableType, optional): Text or renderable for the footer. + Defaults to "". + header_style (Union[str, Style], optional): Style for the header, or None for default. Defaults to None. + footer_style (Union[str, Style], optional): Style for the footer, or None for default. Defaults to None. + style (Union[str, Style], optional): Style for the column cells, or None for default. Defaults to None. + justify (JustifyMethod, optional): Alignment for cells. Defaults to "left". + vertical (VerticalAlignMethod, optional): Vertical alignment, one of "top", "middle", or "bottom". Defaults to "top". + overflow (OverflowMethod): Overflow method: "crop", "fold", "ellipsis". Defaults to "ellipsis". + width (int, optional): Desired width of column in characters, or None to fit to contents. Defaults to None. + min_width (Optional[int], optional): Minimum width of column, or ``None`` for no minimum. Defaults to None. + max_width (Optional[int], optional): Maximum width of column, or ``None`` for no maximum. Defaults to None. + ratio (int, optional): Flexible ratio for the column (requires ``Table.expand`` or ``Table.width``). Defaults to None. + no_wrap (bool, optional): Set to ``True`` to disable wrapping of this column. + """ + + column = Column( + _index=len(self.columns), + header=header, + footer=footer, + header_style=header_style or "", + footer_style=footer_style or "", + style=style or "", + justify=justify, + vertical=vertical, + overflow=overflow, + width=width, + min_width=min_width, + max_width=max_width, + ratio=ratio, + no_wrap=no_wrap, + ) + self.columns.append(column) + + def add_row( + self, + *renderables: Optional["RenderableType"], + style: Optional[StyleType] = None, + end_section: bool = False, + ) -> None: + """Add a row of renderables. + + Args: + *renderables (None or renderable): Each cell in a row must be a renderable object (including str), + or ``None`` for a blank cell. + style (StyleType, optional): An optional style to apply to the entire row. Defaults to None. + end_section (bool, optional): End a section and draw a line. Defaults to False. + + Raises: + errors.NotRenderableError: If you add something that can't be rendered. + """ + + def add_cell(column: Column, renderable: "RenderableType") -> None: + column._cells.append(renderable) + + cell_renderables: List[Optional["RenderableType"]] = list(renderables) + + columns = self.columns + if len(cell_renderables) < len(columns): + cell_renderables = [ + *cell_renderables, + *[None] * (len(columns) - len(cell_renderables)), + ] + for index, renderable in enumerate(cell_renderables): + if index == len(columns): + column = Column(_index=index) + for _ in self.rows: + add_cell(column, Text("")) + self.columns.append(column) + else: + column = columns[index] + if renderable is None: + add_cell(column, "") + elif is_renderable(renderable): + add_cell(column, renderable) + else: + raise errors.NotRenderableError( + f"unable to render {type(renderable).__name__}; a string or other renderable object is required" + ) + self.rows.append(Row(style=style, end_section=end_section)) + + def add_section(self) -> None: + """Add a new section (draw a line after current row).""" + + if self.rows: + self.rows[-1].end_section = True + + def __rich_console__( + self, console: "Console", options: "ConsoleOptions" + ) -> "RenderResult": + if not self.columns: + yield Segment("\n") + return + + max_width = options.max_width + if self.width is not None: + max_width = self.width + + extra_width = self._extra_width + widths = self._calculate_column_widths( + console, options.update_width(max_width - extra_width) + ) + table_width = sum(widths) + extra_width + + render_options = options.update( + width=table_width, highlight=self.highlight, height=None + ) + + def render_annotation( + text: TextType, style: StyleType, justify: "JustifyMethod" = "center" + ) -> "RenderResult": + render_text = ( + console.render_str(text, style=style, highlight=False) + if isinstance(text, str) + else text + ) + return console.render( + render_text, options=render_options.update(justify=justify) + ) + + if self.title: + yield from render_annotation( + self.title, + style=Style.pick_first(self.title_style, "table.title"), + justify=self.title_justify, + ) + yield from self._render(console, render_options, widths) + if self.caption: + yield from render_annotation( + self.caption, + style=Style.pick_first(self.caption_style, "table.caption"), + justify=self.caption_justify, + ) + + def _calculate_column_widths( + self, console: "Console", options: "ConsoleOptions" + ) -> List[int]: + """Calculate the widths of each column, including padding, not including borders.""" + max_width = options.max_width + columns = self.columns + width_ranges = [ + self._measure_column(console, options, column) for column in columns + ] + widths = [_range.maximum or 1 for _range in width_ranges] + get_padding_width = self._get_padding_width + extra_width = self._extra_width + if self.expand: + ratios = [col.ratio or 0 for col in columns if col.flexible] + if any(ratios): + fixed_widths = [ + 0 if column.flexible else _range.maximum + for _range, column in zip(width_ranges, columns) + ] + flex_minimum = [ + (column.width or 1) + get_padding_width(column._index) + for column in columns + if column.flexible + ] + flexible_width = max_width - sum(fixed_widths) + flex_widths = ratio_distribute(flexible_width, ratios, flex_minimum) + iter_flex_widths = iter(flex_widths) + for index, column in enumerate(columns): + if column.flexible: + widths[index] = fixed_widths[index] + next(iter_flex_widths) + table_width = sum(widths) + + if table_width > max_width: + widths = self._collapse_widths( + widths, + [(column.width is None and not column.no_wrap) for column in columns], + max_width, + ) + table_width = sum(widths) + # last resort, reduce columns evenly + if table_width > max_width: + excess_width = table_width - max_width + widths = ratio_reduce(excess_width, [1] * len(widths), widths, widths) + table_width = sum(widths) + + width_ranges = [ + self._measure_column(console, options.update_width(width), column) + for width, column in zip(widths, columns) + ] + widths = [_range.maximum or 0 for _range in width_ranges] + + if (table_width < max_width and self.expand) or ( + self.min_width is not None and table_width < (self.min_width - extra_width) + ): + _max_width = ( + max_width + if self.min_width is None + else min(self.min_width - extra_width, max_width) + ) + pad_widths = ratio_distribute(_max_width - table_width, widths) + widths = [_width + pad for _width, pad in zip(widths, pad_widths)] + + return widths + + @classmethod + def _collapse_widths( + cls, widths: List[int], wrapable: List[bool], max_width: int + ) -> List[int]: + """Reduce widths so that the total is under max_width. + + Args: + widths (List[int]): List of widths. + wrapable (List[bool]): List of booleans that indicate if a column may shrink. + max_width (int): Maximum width to reduce to. + + Returns: + List[int]: A new list of widths. + """ + total_width = sum(widths) + excess_width = total_width - max_width + if any(wrapable): + while total_width and excess_width > 0: + max_column = max( + width for width, allow_wrap in zip(widths, wrapable) if allow_wrap + ) + second_max_column = max( + width if allow_wrap and width != max_column else 0 + for width, allow_wrap in zip(widths, wrapable) + ) + column_difference = max_column - second_max_column + ratios = [ + (1 if (width == max_column and allow_wrap) else 0) + for width, allow_wrap in zip(widths, wrapable) + ] + if not any(ratios) or not column_difference: + break + max_reduce = [min(excess_width, column_difference)] * len(widths) + widths = ratio_reduce(excess_width, ratios, max_reduce, widths) + + total_width = sum(widths) + excess_width = total_width - max_width + return widths + + def _get_cells( + self, console: "Console", column_index: int, column: Column + ) -> Iterable[_Cell]: + """Get all the cells with padding and optional header.""" + + collapse_padding = self.collapse_padding + pad_edge = self.pad_edge + padding = self.padding + any_padding = any(padding) + + first_column = column_index == 0 + last_column = column_index == len(self.columns) - 1 + + _padding_cache: Dict[Tuple[bool, bool], Tuple[int, int, int, int]] = {} + + def get_padding(first_row: bool, last_row: bool) -> Tuple[int, int, int, int]: + cached = _padding_cache.get((first_row, last_row)) + if cached: + return cached + top, right, bottom, left = padding + + if collapse_padding: + if not first_column: + left = max(0, left - right) + if not last_row: + bottom = max(0, top - bottom) + + if not pad_edge: + if first_column: + left = 0 + if last_column: + right = 0 + if first_row: + top = 0 + if last_row: + bottom = 0 + _padding = (top, right, bottom, left) + _padding_cache[(first_row, last_row)] = _padding + return _padding + + raw_cells: List[Tuple[StyleType, "RenderableType"]] = [] + _append = raw_cells.append + get_style = console.get_style + if self.show_header: + header_style = get_style(self.header_style or "") + get_style( + column.header_style + ) + _append((header_style, column.header)) + cell_style = get_style(column.style or "") + for cell in column.cells: + _append((cell_style, cell)) + if self.show_footer: + footer_style = get_style(self.footer_style or "") + get_style( + column.footer_style + ) + _append((footer_style, column.footer)) + + if any_padding: + _Padding = Padding + for first, last, (style, renderable) in loop_first_last(raw_cells): + yield _Cell( + style, + _Padding(renderable, get_padding(first, last)), + getattr(renderable, "vertical", None) or column.vertical, + ) + else: + for style, renderable in raw_cells: + yield _Cell( + style, + renderable, + getattr(renderable, "vertical", None) or column.vertical, + ) + + def _get_padding_width(self, column_index: int) -> int: + """Get extra width from padding.""" + _, pad_right, _, pad_left = self.padding + if self.collapse_padding: + if column_index > 0: + pad_left = max(0, pad_left - pad_right) + return pad_left + pad_right + + def _measure_column( + self, + console: "Console", + options: "ConsoleOptions", + column: Column, + ) -> Measurement: + """Get the minimum and maximum width of the column.""" + + max_width = options.max_width + if max_width < 1: + return Measurement(0, 0) + + padding_width = self._get_padding_width(column._index) + + if column.width is not None: + # Fixed width column + return Measurement( + column.width + padding_width, column.width + padding_width + ).with_maximum(max_width) + # Flexible column, we need to measure contents + min_widths: List[int] = [] + max_widths: List[int] = [] + append_min = min_widths.append + append_max = max_widths.append + get_render_width = Measurement.get + for cell in self._get_cells(console, column._index, column): + _min, _max = get_render_width(console, options, cell.renderable) + append_min(_min) + append_max(_max) + + measurement = Measurement( + max(min_widths) if min_widths else 1, + max(max_widths) if max_widths else max_width, + ).with_maximum(max_width) + measurement = measurement.clamp( + None if column.min_width is None else column.min_width + padding_width, + None if column.max_width is None else column.max_width + padding_width, + ) + return measurement + + def _render( + self, console: "Console", options: "ConsoleOptions", widths: List[int] + ) -> "RenderResult": + table_style = console.get_style(self.style or "") + + border_style = table_style + console.get_style(self.border_style or "") + _column_cells = ( + self._get_cells(console, column_index, column) + for column_index, column in enumerate(self.columns) + ) + row_cells: List[Tuple[_Cell, ...]] = list(zip(*_column_cells)) + _box = ( + self.box.substitute( + options, safe=pick_bool(self.safe_box, console.safe_box) + ) + if self.box + else None + ) + _box = _box.get_plain_headed_box() if _box and not self.show_header else _box + + new_line = Segment.line() + + columns = self.columns + show_header = self.show_header + show_footer = self.show_footer + show_edge = self.show_edge + show_lines = self.show_lines + leading = self.leading + + _Segment = Segment + if _box: + box_segments = [ + ( + _Segment(_box.head_left, border_style), + _Segment(_box.head_right, border_style), + _Segment(_box.head_vertical, border_style), + ), + ( + _Segment(_box.foot_left, border_style), + _Segment(_box.foot_right, border_style), + _Segment(_box.foot_vertical, border_style), + ), + ( + _Segment(_box.mid_left, border_style), + _Segment(_box.mid_right, border_style), + _Segment(_box.mid_vertical, border_style), + ), + ] + if show_edge: + yield _Segment(_box.get_top(widths), border_style) + yield new_line + else: + box_segments = [] + + get_row_style = self.get_row_style + get_style = console.get_style + + for index, (first, last, row_cell) in enumerate(loop_first_last(row_cells)): + header_row = first and show_header + footer_row = last and show_footer + row = ( + self.rows[index - show_header] + if (not header_row and not footer_row) + else None + ) + max_height = 1 + cells: List[List[List[Segment]]] = [] + if header_row or footer_row: + row_style = Style.null() + else: + row_style = get_style( + get_row_style(console, index - 1 if show_header else index) + ) + for width, cell, column in zip(widths, row_cell, columns): + render_options = options.update( + width=width, + justify=column.justify, + no_wrap=column.no_wrap, + overflow=column.overflow, + height=None, + ) + lines = console.render_lines( + cell.renderable, + render_options, + style=get_style(cell.style) + row_style, + ) + max_height = max(max_height, len(lines)) + cells.append(lines) + + row_height = max(len(cell) for cell in cells) + + def align_cell( + cell: List[List[Segment]], + vertical: "VerticalAlignMethod", + width: int, + style: Style, + ) -> List[List[Segment]]: + if header_row: + vertical = "bottom" + elif footer_row: + vertical = "top" + + if vertical == "top": + return _Segment.align_top(cell, width, row_height, style) + elif vertical == "middle": + return _Segment.align_middle(cell, width, row_height, style) + return _Segment.align_bottom(cell, width, row_height, style) + + cells[:] = [ + _Segment.set_shape( + align_cell( + cell, + _cell.vertical, + width, + get_style(_cell.style) + row_style, + ), + width, + max_height, + ) + for width, _cell, cell, column in zip(widths, row_cell, cells, columns) + ] + + if _box: + if last and show_footer: + yield _Segment( + _box.get_row(widths, "foot", edge=show_edge), border_style + ) + yield new_line + left, right, _divider = box_segments[0 if first else (2 if last else 1)] + + # If the column divider is whitespace also style it with the row background + divider = ( + _divider + if _divider.text.strip() + else _Segment( + _divider.text, row_style.background_style + _divider.style + ) + ) + for line_no in range(max_height): + if show_edge: + yield left + for last_cell, rendered_cell in loop_last(cells): + yield from rendered_cell[line_no] + if not last_cell: + yield divider + if show_edge: + yield right + yield new_line + else: + for line_no in range(max_height): + for rendered_cell in cells: + yield from rendered_cell[line_no] + yield new_line + if _box and first and show_header: + yield _Segment( + _box.get_row(widths, "head", edge=show_edge), border_style + ) + yield new_line + end_section = row and row.end_section + if _box and (show_lines or leading or end_section): + if ( + not last + and not (show_footer and index >= len(row_cells) - 2) + and not (show_header and header_row) + ): + if leading: + yield _Segment( + _box.get_row(widths, "mid", edge=show_edge) * leading, + border_style, + ) + else: + yield _Segment( + _box.get_row(widths, "row", edge=show_edge), border_style + ) + yield new_line + + if _box and show_edge: + yield _Segment(_box.get_bottom(widths), border_style) + yield new_line + + +if __name__ == "__main__": # pragma: no cover + from pip._vendor.rich.console import Console + from pip._vendor.rich.highlighter import ReprHighlighter + from pip._vendor.rich.table import Table as Table + + from ._timer import timer + + with timer("Table render"): + table = Table( + title="Star Wars Movies", + caption="Rich example table", + caption_justify="right", + ) + + table.add_column( + "Released", header_style="bright_cyan", style="cyan", no_wrap=True + ) + table.add_column("Title", style="magenta") + table.add_column("Box Office", justify="right", style="green") + + table.add_row( + "Dec 20, 2019", + "Star Wars: The Rise of Skywalker", + "$952,110,690", + ) + table.add_row("May 25, 2018", "Solo: A Star Wars Story", "$393,151,347") + table.add_row( + "Dec 15, 2017", + "Star Wars Ep. V111: The Last Jedi", + "$1,332,539,889", + style="on black", + end_section=True, + ) + table.add_row( + "Dec 16, 2016", + "Rogue One: A Star Wars Story", + "$1,332,439,889", + ) + + def header(text: str) -> None: + console.print() + console.rule(highlight(text)) + console.print() + + console = Console() + highlight = ReprHighlighter() + header("Example Table") + console.print(table, justify="center") + + table.expand = True + header("expand=True") + console.print(table) + + table.width = 50 + header("width=50") + + console.print(table, justify="center") + + table.width = None + table.expand = False + table.row_styles = ["dim", "none"] + header("row_styles=['dim', 'none']") + + console.print(table, justify="center") + + table.width = None + table.expand = False + table.row_styles = ["dim", "none"] + table.leading = 1 + header("leading=1, row_styles=['dim', 'none']") + console.print(table, justify="center") + + table.width = None + table.expand = False + table.row_styles = ["dim", "none"] + table.show_lines = True + table.leading = 0 + header("show_lines=True, row_styles=['dim', 'none']") + console.print(table, justify="center") diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/terminal_theme.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/terminal_theme.py new file mode 100644 index 0000000..565e9d9 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/terminal_theme.py @@ -0,0 +1,153 @@ +from typing import List, Optional, Tuple + +from .color_triplet import ColorTriplet +from .palette import Palette + +_ColorTuple = Tuple[int, int, int] + + +class TerminalTheme: + """A color theme used when exporting console content. + + Args: + background (Tuple[int, int, int]): The background color. + foreground (Tuple[int, int, int]): The foreground (text) color. + normal (List[Tuple[int, int, int]]): A list of 8 normal intensity colors. + bright (List[Tuple[int, int, int]], optional): A list of 8 bright colors, or None + to repeat normal intensity. Defaults to None. + """ + + def __init__( + self, + background: _ColorTuple, + foreground: _ColorTuple, + normal: List[_ColorTuple], + bright: Optional[List[_ColorTuple]] = None, + ) -> None: + self.background_color = ColorTriplet(*background) + self.foreground_color = ColorTriplet(*foreground) + self.ansi_colors = Palette(normal + (bright or normal)) + + +DEFAULT_TERMINAL_THEME = TerminalTheme( + (255, 255, 255), + (0, 0, 0), + [ + (0, 0, 0), + (128, 0, 0), + (0, 128, 0), + (128, 128, 0), + (0, 0, 128), + (128, 0, 128), + (0, 128, 128), + (192, 192, 192), + ], + [ + (128, 128, 128), + (255, 0, 0), + (0, 255, 0), + (255, 255, 0), + (0, 0, 255), + (255, 0, 255), + (0, 255, 255), + (255, 255, 255), + ], +) + +MONOKAI = TerminalTheme( + (12, 12, 12), + (217, 217, 217), + [ + (26, 26, 26), + (244, 0, 95), + (152, 224, 36), + (253, 151, 31), + (157, 101, 255), + (244, 0, 95), + (88, 209, 235), + (196, 197, 181), + (98, 94, 76), + ], + [ + (244, 0, 95), + (152, 224, 36), + (224, 213, 97), + (157, 101, 255), + (244, 0, 95), + (88, 209, 235), + (246, 246, 239), + ], +) +DIMMED_MONOKAI = TerminalTheme( + (25, 25, 25), + (185, 188, 186), + [ + (58, 61, 67), + (190, 63, 72), + (135, 154, 59), + (197, 166, 53), + (79, 118, 161), + (133, 92, 141), + (87, 143, 164), + (185, 188, 186), + (136, 137, 135), + ], + [ + (251, 0, 31), + (15, 114, 47), + (196, 112, 51), + (24, 109, 227), + (251, 0, 103), + (46, 112, 109), + (253, 255, 185), + ], +) +NIGHT_OWLISH = TerminalTheme( + (255, 255, 255), + (64, 63, 83), + [ + (1, 22, 39), + (211, 66, 62), + (42, 162, 152), + (218, 170, 1), + (72, 118, 214), + (64, 63, 83), + (8, 145, 106), + (122, 129, 129), + (122, 129, 129), + ], + [ + (247, 110, 110), + (73, 208, 197), + (218, 194, 107), + (92, 167, 228), + (105, 112, 152), + (0, 201, 144), + (152, 159, 177), + ], +) + +SVG_EXPORT_THEME = TerminalTheme( + (41, 41, 41), + (197, 200, 198), + [ + (75, 78, 85), + (204, 85, 90), + (152, 168, 75), + (208, 179, 68), + (96, 138, 177), + (152, 114, 159), + (104, 160, 179), + (197, 200, 198), + (154, 155, 153), + ], + [ + (255, 38, 39), + (0, 130, 61), + (208, 132, 66), + (25, 132, 233), + (255, 44, 122), + (57, 130, 128), + (253, 253, 197), + ], +) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/text.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/text.py new file mode 100644 index 0000000..209aa94 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/text.py @@ -0,0 +1,1357 @@ +import re +from functools import partial, reduce +from math import gcd +from operator import itemgetter +from typing import ( + TYPE_CHECKING, + Any, + Callable, + Dict, + Iterable, + List, + NamedTuple, + Optional, + Tuple, + Union, +) + +from ._loop import loop_last +from ._pick import pick_bool +from ._wrap import divide_line +from .align import AlignMethod +from .cells import cell_len, set_cell_size +from .containers import Lines +from .control import strip_control_codes +from .emoji import EmojiVariant +from .jupyter import JupyterMixin +from .measure import Measurement +from .segment import Segment +from .style import Style, StyleType + +if TYPE_CHECKING: # pragma: no cover + from .console import Console, ConsoleOptions, JustifyMethod, OverflowMethod + +DEFAULT_JUSTIFY: "JustifyMethod" = "default" +DEFAULT_OVERFLOW: "OverflowMethod" = "fold" + + +_re_whitespace = re.compile(r"\s+$") + +TextType = Union[str, "Text"] +"""A plain string or a :class:`Text` instance.""" + +GetStyleCallable = Callable[[str], Optional[StyleType]] + + +class Span(NamedTuple): + """A marked up region in some text.""" + + start: int + """Span start index.""" + end: int + """Span end index.""" + style: Union[str, Style] + """Style associated with the span.""" + + def __repr__(self) -> str: + return f"Span({self.start}, {self.end}, {self.style!r})" + + def __bool__(self) -> bool: + return self.end > self.start + + def split(self, offset: int) -> Tuple["Span", Optional["Span"]]: + """Split a span in to 2 from a given offset.""" + + if offset < self.start: + return self, None + if offset >= self.end: + return self, None + + start, end, style = self + span1 = Span(start, min(end, offset), style) + span2 = Span(span1.end, end, style) + return span1, span2 + + def move(self, offset: int) -> "Span": + """Move start and end by a given offset. + + Args: + offset (int): Number of characters to add to start and end. + + Returns: + TextSpan: A new TextSpan with adjusted position. + """ + start, end, style = self + return Span(start + offset, end + offset, style) + + def right_crop(self, offset: int) -> "Span": + """Crop the span at the given offset. + + Args: + offset (int): A value between start and end. + + Returns: + Span: A new (possibly smaller) span. + """ + start, end, style = self + if offset >= end: + return self + return Span(start, min(offset, end), style) + + def extend(self, cells: int) -> "Span": + """Extend the span by the given number of cells. + + Args: + cells (int): Additional space to add to end of span. + + Returns: + Span: A span. + """ + if cells: + start, end, style = self + return Span(start, end + cells, style) + else: + return self + + +class Text(JupyterMixin): + """Text with color / style. + + Args: + text (str, optional): Default unstyled text. Defaults to "". + style (Union[str, Style], optional): Base style for text. Defaults to "". + justify (str, optional): Justify method: "left", "center", "full", "right". Defaults to None. + overflow (str, optional): Overflow method: "crop", "fold", "ellipsis". Defaults to None. + no_wrap (bool, optional): Disable text wrapping, or None for default. Defaults to None. + end (str, optional): Character to end text with. Defaults to "\\\\n". + tab_size (int): Number of spaces per tab, or ``None`` to use ``console.tab_size``. Defaults to None. + spans (List[Span], optional). A list of predefined style spans. Defaults to None. + """ + + __slots__ = [ + "_text", + "style", + "justify", + "overflow", + "no_wrap", + "end", + "tab_size", + "_spans", + "_length", + ] + + def __init__( + self, + text: str = "", + style: Union[str, Style] = "", + *, + justify: Optional["JustifyMethod"] = None, + overflow: Optional["OverflowMethod"] = None, + no_wrap: Optional[bool] = None, + end: str = "\n", + tab_size: Optional[int] = None, + spans: Optional[List[Span]] = None, + ) -> None: + sanitized_text = strip_control_codes(text) + self._text = [sanitized_text] + self.style = style + self.justify: Optional["JustifyMethod"] = justify + self.overflow: Optional["OverflowMethod"] = overflow + self.no_wrap = no_wrap + self.end = end + self.tab_size = tab_size + self._spans: List[Span] = spans or [] + self._length: int = len(sanitized_text) + + def __len__(self) -> int: + return self._length + + def __bool__(self) -> bool: + return bool(self._length) + + def __str__(self) -> str: + return self.plain + + def __repr__(self) -> str: + return f"" + + def __add__(self, other: Any) -> "Text": + if isinstance(other, (str, Text)): + result = self.copy() + result.append(other) + return result + return NotImplemented + + def __eq__(self, other: object) -> bool: + if not isinstance(other, Text): + return NotImplemented + return self.plain == other.plain and self._spans == other._spans + + def __contains__(self, other: object) -> bool: + if isinstance(other, str): + return other in self.plain + elif isinstance(other, Text): + return other.plain in self.plain + return False + + def __getitem__(self, slice: Union[int, slice]) -> "Text": + def get_text_at(offset: int) -> "Text": + _Span = Span + text = Text( + self.plain[offset], + spans=[ + _Span(0, 1, style) + for start, end, style in self._spans + if end > offset >= start + ], + end="", + ) + return text + + if isinstance(slice, int): + return get_text_at(slice) + else: + start, stop, step = slice.indices(len(self.plain)) + if step == 1: + lines = self.divide([start, stop]) + return lines[1] + else: + # This would be a bit of work to implement efficiently + # For now, its not required + raise TypeError("slices with step!=1 are not supported") + + @property + def cell_len(self) -> int: + """Get the number of cells required to render this text.""" + return cell_len(self.plain) + + @property + def markup(self) -> str: + """Get console markup to render this Text. + + Returns: + str: A string potentially creating markup tags. + """ + from .markup import escape + + output: List[str] = [] + + plain = self.plain + markup_spans = [ + (0, False, self.style), + *((span.start, False, span.style) for span in self._spans), + *((span.end, True, span.style) for span in self._spans), + (len(plain), True, self.style), + ] + markup_spans.sort(key=itemgetter(0, 1)) + position = 0 + append = output.append + for offset, closing, style in markup_spans: + if offset > position: + append(escape(plain[position:offset])) + position = offset + if style: + append(f"[/{style}]" if closing else f"[{style}]") + markup = "".join(output) + return markup + + @classmethod + def from_markup( + cls, + text: str, + *, + style: Union[str, Style] = "", + emoji: bool = True, + emoji_variant: Optional[EmojiVariant] = None, + justify: Optional["JustifyMethod"] = None, + overflow: Optional["OverflowMethod"] = None, + end: str = "\n", + ) -> "Text": + """Create Text instance from markup. + + Args: + text (str): A string containing console markup. + style (Union[str, Style], optional): Base style for text. Defaults to "". + emoji (bool, optional): Also render emoji code. Defaults to True. + emoji_variant (str, optional): Optional emoji variant, either "text" or "emoji". Defaults to None. + justify (str, optional): Justify method: "left", "center", "full", "right". Defaults to None. + overflow (str, optional): Overflow method: "crop", "fold", "ellipsis". Defaults to None. + end (str, optional): Character to end text with. Defaults to "\\\\n". + + Returns: + Text: A Text instance with markup rendered. + """ + from .markup import render + + rendered_text = render(text, style, emoji=emoji, emoji_variant=emoji_variant) + rendered_text.justify = justify + rendered_text.overflow = overflow + rendered_text.end = end + return rendered_text + + @classmethod + def from_ansi( + cls, + text: str, + *, + style: Union[str, Style] = "", + justify: Optional["JustifyMethod"] = None, + overflow: Optional["OverflowMethod"] = None, + no_wrap: Optional[bool] = None, + end: str = "\n", + tab_size: Optional[int] = 8, + ) -> "Text": + """Create a Text object from a string containing ANSI escape codes. + + Args: + text (str): A string containing escape codes. + style (Union[str, Style], optional): Base style for text. Defaults to "". + justify (str, optional): Justify method: "left", "center", "full", "right". Defaults to None. + overflow (str, optional): Overflow method: "crop", "fold", "ellipsis". Defaults to None. + no_wrap (bool, optional): Disable text wrapping, or None for default. Defaults to None. + end (str, optional): Character to end text with. Defaults to "\\\\n". + tab_size (int): Number of spaces per tab, or ``None`` to use ``console.tab_size``. Defaults to None. + """ + from .ansi import AnsiDecoder + + joiner = Text( + "\n", + justify=justify, + overflow=overflow, + no_wrap=no_wrap, + end=end, + tab_size=tab_size, + style=style, + ) + decoder = AnsiDecoder() + result = joiner.join(line for line in decoder.decode(text)) + return result + + @classmethod + def styled( + cls, + text: str, + style: StyleType = "", + *, + justify: Optional["JustifyMethod"] = None, + overflow: Optional["OverflowMethod"] = None, + ) -> "Text": + """Construct a Text instance with a pre-applied styled. A style applied in this way won't be used + to pad the text when it is justified. + + Args: + text (str): A string containing console markup. + style (Union[str, Style]): Style to apply to the text. Defaults to "". + justify (str, optional): Justify method: "left", "center", "full", "right". Defaults to None. + overflow (str, optional): Overflow method: "crop", "fold", "ellipsis". Defaults to None. + + Returns: + Text: A text instance with a style applied to the entire string. + """ + styled_text = cls(text, justify=justify, overflow=overflow) + styled_text.stylize(style) + return styled_text + + @classmethod + def assemble( + cls, + *parts: Union[str, "Text", Tuple[str, StyleType]], + style: Union[str, Style] = "", + justify: Optional["JustifyMethod"] = None, + overflow: Optional["OverflowMethod"] = None, + no_wrap: Optional[bool] = None, + end: str = "\n", + tab_size: int = 8, + meta: Optional[Dict[str, Any]] = None, + ) -> "Text": + """Construct a text instance by combining a sequence of strings with optional styles. + The positional arguments should be either strings, or a tuple of string + style. + + Args: + style (Union[str, Style], optional): Base style for text. Defaults to "". + justify (str, optional): Justify method: "left", "center", "full", "right". Defaults to None. + overflow (str, optional): Overflow method: "crop", "fold", "ellipsis". Defaults to None. + no_wrap (bool, optional): Disable text wrapping, or None for default. Defaults to None. + end (str, optional): Character to end text with. Defaults to "\\\\n". + tab_size (int): Number of spaces per tab, or ``None`` to use ``console.tab_size``. Defaults to None. + meta (Dict[str, Any], optional). Meta data to apply to text, or None for no meta data. Default to None + + Returns: + Text: A new text instance. + """ + text = cls( + style=style, + justify=justify, + overflow=overflow, + no_wrap=no_wrap, + end=end, + tab_size=tab_size, + ) + append = text.append + _Text = Text + for part in parts: + if isinstance(part, (_Text, str)): + append(part) + else: + append(*part) + if meta: + text.apply_meta(meta) + return text + + @property + def plain(self) -> str: + """Get the text as a single string.""" + if len(self._text) != 1: + self._text[:] = ["".join(self._text)] + return self._text[0] + + @plain.setter + def plain(self, new_text: str) -> None: + """Set the text to a new value.""" + if new_text != self.plain: + sanitized_text = strip_control_codes(new_text) + self._text[:] = [sanitized_text] + old_length = self._length + self._length = len(sanitized_text) + if old_length > self._length: + self._trim_spans() + + @property + def spans(self) -> List[Span]: + """Get a reference to the internal list of spans.""" + return self._spans + + @spans.setter + def spans(self, spans: List[Span]) -> None: + """Set spans.""" + self._spans = spans[:] + + def blank_copy(self, plain: str = "") -> "Text": + """Return a new Text instance with copied metadata (but not the string or spans).""" + copy_self = Text( + plain, + style=self.style, + justify=self.justify, + overflow=self.overflow, + no_wrap=self.no_wrap, + end=self.end, + tab_size=self.tab_size, + ) + return copy_self + + def copy(self) -> "Text": + """Return a copy of this instance.""" + copy_self = Text( + self.plain, + style=self.style, + justify=self.justify, + overflow=self.overflow, + no_wrap=self.no_wrap, + end=self.end, + tab_size=self.tab_size, + ) + copy_self._spans[:] = self._spans + return copy_self + + def stylize( + self, + style: Union[str, Style], + start: int = 0, + end: Optional[int] = None, + ) -> None: + """Apply a style to the text, or a portion of the text. + + Args: + style (Union[str, Style]): Style instance or style definition to apply. + start (int): Start offset (negative indexing is supported). Defaults to 0. + end (Optional[int], optional): End offset (negative indexing is supported), or None for end of text. Defaults to None. + """ + if style: + length = len(self) + if start < 0: + start = length + start + if end is None: + end = length + if end < 0: + end = length + end + if start >= length or end <= start: + # Span not in text or not valid + return + self._spans.append(Span(start, min(length, end), style)) + + def stylize_before( + self, + style: Union[str, Style], + start: int = 0, + end: Optional[int] = None, + ) -> None: + """Apply a style to the text, or a portion of the text. Styles will be applied before other styles already present. + + Args: + style (Union[str, Style]): Style instance or style definition to apply. + start (int): Start offset (negative indexing is supported). Defaults to 0. + end (Optional[int], optional): End offset (negative indexing is supported), or None for end of text. Defaults to None. + """ + if style: + length = len(self) + if start < 0: + start = length + start + if end is None: + end = length + if end < 0: + end = length + end + if start >= length or end <= start: + # Span not in text or not valid + return + self._spans.insert(0, Span(start, min(length, end), style)) + + def apply_meta( + self, meta: Dict[str, Any], start: int = 0, end: Optional[int] = None + ) -> None: + """Apply metadata to the text, or a portion of the text. + + Args: + meta (Dict[str, Any]): A dict of meta information. + start (int): Start offset (negative indexing is supported). Defaults to 0. + end (Optional[int], optional): End offset (negative indexing is supported), or None for end of text. Defaults to None. + + """ + style = Style.from_meta(meta) + self.stylize(style, start=start, end=end) + + def on(self, meta: Optional[Dict[str, Any]] = None, **handlers: Any) -> "Text": + """Apply event handlers (used by Textual project). + + Example: + >>> from rich.text import Text + >>> text = Text("hello world") + >>> text.on(click="view.toggle('world')") + + Args: + meta (Dict[str, Any]): Mapping of meta information. + **handlers: Keyword args are prefixed with "@" to defined handlers. + + Returns: + Text: Self is returned to method may be chained. + """ + meta = {} if meta is None else meta + meta.update({f"@{key}": value for key, value in handlers.items()}) + self.stylize(Style.from_meta(meta)) + return self + + def remove_suffix(self, suffix: str) -> None: + """Remove a suffix if it exists. + + Args: + suffix (str): Suffix to remove. + """ + if self.plain.endswith(suffix): + self.right_crop(len(suffix)) + + def get_style_at_offset(self, console: "Console", offset: int) -> Style: + """Get the style of a character at give offset. + + Args: + console (~Console): Console where text will be rendered. + offset (int): Offset in to text (negative indexing supported) + + Returns: + Style: A Style instance. + """ + # TODO: This is a little inefficient, it is only used by full justify + if offset < 0: + offset = len(self) + offset + get_style = console.get_style + style = get_style(self.style).copy() + for start, end, span_style in self._spans: + if end > offset >= start: + style += get_style(span_style, default="") + return style + + def extend_style(self, spaces: int) -> None: + """Extend the Text given number of spaces where the spaces have the same style as the last character. + + Args: + spaces (int): Number of spaces to add to the Text. + """ + if spaces <= 0: + return + spans = self.spans + new_spaces = " " * spaces + if spans: + end_offset = len(self) + self._spans[:] = [ + span.extend(spaces) if span.end >= end_offset else span + for span in spans + ] + self._text.append(new_spaces) + self._length += spaces + else: + self.plain += new_spaces + + def highlight_regex( + self, + re_highlight: str, + style: Optional[Union[GetStyleCallable, StyleType]] = None, + *, + style_prefix: str = "", + ) -> int: + """Highlight text with a regular expression, where group names are + translated to styles. + + Args: + re_highlight (str): A regular expression. + style (Union[GetStyleCallable, StyleType]): Optional style to apply to whole match, or a callable + which accepts the matched text and returns a style. Defaults to None. + style_prefix (str, optional): Optional prefix to add to style group names. + + Returns: + int: Number of regex matches + """ + count = 0 + append_span = self._spans.append + _Span = Span + plain = self.plain + for match in re.finditer(re_highlight, plain): + get_span = match.span + if style: + start, end = get_span() + match_style = style(plain[start:end]) if callable(style) else style + if match_style is not None and end > start: + append_span(_Span(start, end, match_style)) + + count += 1 + for name in match.groupdict().keys(): + start, end = get_span(name) + if start != -1 and end > start: + append_span(_Span(start, end, f"{style_prefix}{name}")) + return count + + def highlight_words( + self, + words: Iterable[str], + style: Union[str, Style], + *, + case_sensitive: bool = True, + ) -> int: + """Highlight words with a style. + + Args: + words (Iterable[str]): Words to highlight. + style (Union[str, Style]): Style to apply. + case_sensitive (bool, optional): Enable case sensitive matching. Defaults to True. + + Returns: + int: Number of words highlighted. + """ + re_words = "|".join(re.escape(word) for word in words) + add_span = self._spans.append + count = 0 + _Span = Span + for match in re.finditer( + re_words, self.plain, flags=0 if case_sensitive else re.IGNORECASE + ): + start, end = match.span(0) + add_span(_Span(start, end, style)) + count += 1 + return count + + def rstrip(self) -> None: + """Strip whitespace from end of text.""" + self.plain = self.plain.rstrip() + + def rstrip_end(self, size: int) -> None: + """Remove whitespace beyond a certain width at the end of the text. + + Args: + size (int): The desired size of the text. + """ + text_length = len(self) + if text_length > size: + excess = text_length - size + whitespace_match = _re_whitespace.search(self.plain) + if whitespace_match is not None: + whitespace_count = len(whitespace_match.group(0)) + self.right_crop(min(whitespace_count, excess)) + + def set_length(self, new_length: int) -> None: + """Set new length of the text, clipping or padding is required.""" + length = len(self) + if length != new_length: + if length < new_length: + self.pad_right(new_length - length) + else: + self.right_crop(length - new_length) + + def __rich_console__( + self, console: "Console", options: "ConsoleOptions" + ) -> Iterable[Segment]: + tab_size: int = console.tab_size if self.tab_size is None else self.tab_size + justify = self.justify or options.justify or DEFAULT_JUSTIFY + + overflow = self.overflow or options.overflow or DEFAULT_OVERFLOW + + lines = self.wrap( + console, + options.max_width, + justify=justify, + overflow=overflow, + tab_size=tab_size or 8, + no_wrap=pick_bool(self.no_wrap, options.no_wrap, False), + ) + all_lines = Text("\n").join(lines) + yield from all_lines.render(console, end=self.end) + + def __rich_measure__( + self, console: "Console", options: "ConsoleOptions" + ) -> Measurement: + text = self.plain + lines = text.splitlines() + max_text_width = max(cell_len(line) for line in lines) if lines else 0 + words = text.split() + min_text_width = ( + max(cell_len(word) for word in words) if words else max_text_width + ) + return Measurement(min_text_width, max_text_width) + + def render(self, console: "Console", end: str = "") -> Iterable["Segment"]: + """Render the text as Segments. + + Args: + console (Console): Console instance. + end (Optional[str], optional): Optional end character. + + Returns: + Iterable[Segment]: Result of render that may be written to the console. + """ + _Segment = Segment + text = self.plain + if not self._spans: + yield Segment(text) + if end: + yield _Segment(end) + return + get_style = partial(console.get_style, default=Style.null()) + + enumerated_spans = list(enumerate(self._spans, 1)) + style_map = {index: get_style(span.style) for index, span in enumerated_spans} + style_map[0] = get_style(self.style) + + spans = [ + (0, False, 0), + *((span.start, False, index) for index, span in enumerated_spans), + *((span.end, True, index) for index, span in enumerated_spans), + (len(text), True, 0), + ] + spans.sort(key=itemgetter(0, 1)) + + stack: List[int] = [] + stack_append = stack.append + stack_pop = stack.remove + + style_cache: Dict[Tuple[Style, ...], Style] = {} + style_cache_get = style_cache.get + combine = Style.combine + + def get_current_style() -> Style: + """Construct current style from stack.""" + styles = tuple(style_map[_style_id] for _style_id in sorted(stack)) + cached_style = style_cache_get(styles) + if cached_style is not None: + return cached_style + current_style = combine(styles) + style_cache[styles] = current_style + return current_style + + for (offset, leaving, style_id), (next_offset, _, _) in zip(spans, spans[1:]): + if leaving: + stack_pop(style_id) + else: + stack_append(style_id) + if next_offset > offset: + yield _Segment(text[offset:next_offset], get_current_style()) + if end: + yield _Segment(end) + + def join(self, lines: Iterable["Text"]) -> "Text": + """Join text together with this instance as the separator. + + Args: + lines (Iterable[Text]): An iterable of Text instances to join. + + Returns: + Text: A new text instance containing join text. + """ + + new_text = self.blank_copy() + + def iter_text() -> Iterable["Text"]: + if self.plain: + for last, line in loop_last(lines): + yield line + if not last: + yield self + else: + yield from lines + + extend_text = new_text._text.extend + append_span = new_text._spans.append + extend_spans = new_text._spans.extend + offset = 0 + _Span = Span + + for text in iter_text(): + extend_text(text._text) + if text.style: + append_span(_Span(offset, offset + len(text), text.style)) + extend_spans( + _Span(offset + start, offset + end, style) + for start, end, style in text._spans + ) + offset += len(text) + new_text._length = offset + return new_text + + def expand_tabs(self, tab_size: Optional[int] = None) -> None: + """Converts tabs to spaces. + + Args: + tab_size (int, optional): Size of tabs. Defaults to 8. + + """ + if "\t" not in self.plain: + return + if tab_size is None: + tab_size = self.tab_size + if tab_size is None: + tab_size = 8 + + new_text: List[Text] = [] + append = new_text.append + + for line in self.split("\n", include_separator=True): + if "\t" not in line.plain: + append(line) + else: + cell_position = 0 + parts = line.split("\t", include_separator=True) + for part in parts: + if part.plain.endswith("\t"): + part._text[-1] = part._text[-1][:-1] + " " + cell_position += part.cell_len + tab_remainder = cell_position % tab_size + if tab_remainder: + spaces = tab_size - tab_remainder + part.extend_style(spaces) + cell_position += spaces + else: + cell_position += part.cell_len + append(part) + + result = Text("").join(new_text) + + self._text = [result.plain] + self._length = len(self.plain) + self._spans[:] = result._spans + + def truncate( + self, + max_width: int, + *, + overflow: Optional["OverflowMethod"] = None, + pad: bool = False, + ) -> None: + """Truncate text if it is longer that a given width. + + Args: + max_width (int): Maximum number of characters in text. + overflow (str, optional): Overflow method: "crop", "fold", or "ellipsis". Defaults to None, to use self.overflow. + pad (bool, optional): Pad with spaces if the length is less than max_width. Defaults to False. + """ + _overflow = overflow or self.overflow or DEFAULT_OVERFLOW + if _overflow != "ignore": + length = cell_len(self.plain) + if length > max_width: + if _overflow == "ellipsis": + self.plain = set_cell_size(self.plain, max_width - 1) + "…" + else: + self.plain = set_cell_size(self.plain, max_width) + if pad and length < max_width: + spaces = max_width - length + self._text = [f"{self.plain}{' ' * spaces}"] + self._length = len(self.plain) + + def _trim_spans(self) -> None: + """Remove or modify any spans that are over the end of the text.""" + max_offset = len(self.plain) + _Span = Span + self._spans[:] = [ + ( + span + if span.end < max_offset + else _Span(span.start, min(max_offset, span.end), span.style) + ) + for span in self._spans + if span.start < max_offset + ] + + def pad(self, count: int, character: str = " ") -> None: + """Pad left and right with a given number of characters. + + Args: + count (int): Width of padding. + character (str): The character to pad with. Must be a string of length 1. + """ + assert len(character) == 1, "Character must be a string of length 1" + if count: + pad_characters = character * count + self.plain = f"{pad_characters}{self.plain}{pad_characters}" + _Span = Span + self._spans[:] = [ + _Span(start + count, end + count, style) + for start, end, style in self._spans + ] + + def pad_left(self, count: int, character: str = " ") -> None: + """Pad the left with a given character. + + Args: + count (int): Number of characters to pad. + character (str, optional): Character to pad with. Defaults to " ". + """ + assert len(character) == 1, "Character must be a string of length 1" + if count: + self.plain = f"{character * count}{self.plain}" + _Span = Span + self._spans[:] = [ + _Span(start + count, end + count, style) + for start, end, style in self._spans + ] + + def pad_right(self, count: int, character: str = " ") -> None: + """Pad the right with a given character. + + Args: + count (int): Number of characters to pad. + character (str, optional): Character to pad with. Defaults to " ". + """ + assert len(character) == 1, "Character must be a string of length 1" + if count: + self.plain = f"{self.plain}{character * count}" + + def align(self, align: AlignMethod, width: int, character: str = " ") -> None: + """Align text to a given width. + + Args: + align (AlignMethod): One of "left", "center", or "right". + width (int): Desired width. + character (str, optional): Character to pad with. Defaults to " ". + """ + self.truncate(width) + excess_space = width - cell_len(self.plain) + if excess_space: + if align == "left": + self.pad_right(excess_space, character) + elif align == "center": + left = excess_space // 2 + self.pad_left(left, character) + self.pad_right(excess_space - left, character) + else: + self.pad_left(excess_space, character) + + def append( + self, text: Union["Text", str], style: Optional[Union[str, "Style"]] = None + ) -> "Text": + """Add text with an optional style. + + Args: + text (Union[Text, str]): A str or Text to append. + style (str, optional): A style name. Defaults to None. + + Returns: + Text: Returns self for chaining. + """ + + if not isinstance(text, (str, Text)): + raise TypeError("Only str or Text can be appended to Text") + + if len(text): + if isinstance(text, str): + sanitized_text = strip_control_codes(text) + self._text.append(sanitized_text) + offset = len(self) + text_length = len(sanitized_text) + if style: + self._spans.append(Span(offset, offset + text_length, style)) + self._length += text_length + elif isinstance(text, Text): + _Span = Span + if style is not None: + raise ValueError( + "style must not be set when appending Text instance" + ) + text_length = self._length + if text.style: + self._spans.append( + _Span(text_length, text_length + len(text), text.style) + ) + self._text.append(text.plain) + self._spans.extend( + _Span(start + text_length, end + text_length, style) + for start, end, style in text._spans + ) + self._length += len(text) + return self + + def append_text(self, text: "Text") -> "Text": + """Append another Text instance. This method is more performant that Text.append, but + only works for Text. + + Args: + text (Text): The Text instance to append to this instance. + + Returns: + Text: Returns self for chaining. + """ + _Span = Span + text_length = self._length + if text.style: + self._spans.append(_Span(text_length, text_length + len(text), text.style)) + self._text.append(text.plain) + self._spans.extend( + _Span(start + text_length, end + text_length, style) + for start, end, style in text._spans + ) + self._length += len(text) + return self + + def append_tokens( + self, tokens: Iterable[Tuple[str, Optional[StyleType]]] + ) -> "Text": + """Append iterable of str and style. Style may be a Style instance or a str style definition. + + Args: + tokens (Iterable[Tuple[str, Optional[StyleType]]]): An iterable of tuples containing str content and style. + + Returns: + Text: Returns self for chaining. + """ + append_text = self._text.append + append_span = self._spans.append + _Span = Span + offset = len(self) + for content, style in tokens: + append_text(content) + if style: + append_span(_Span(offset, offset + len(content), style)) + offset += len(content) + self._length = offset + return self + + def copy_styles(self, text: "Text") -> None: + """Copy styles from another Text instance. + + Args: + text (Text): A Text instance to copy styles from, must be the same length. + """ + self._spans.extend(text._spans) + + def split( + self, + separator: str = "\n", + *, + include_separator: bool = False, + allow_blank: bool = False, + ) -> Lines: + """Split rich text in to lines, preserving styles. + + Args: + separator (str, optional): String to split on. Defaults to "\\\\n". + include_separator (bool, optional): Include the separator in the lines. Defaults to False. + allow_blank (bool, optional): Return a blank line if the text ends with a separator. Defaults to False. + + Returns: + List[RichText]: A list of rich text, one per line of the original. + """ + assert separator, "separator must not be empty" + + text = self.plain + if separator not in text: + return Lines([self.copy()]) + + if include_separator: + lines = self.divide( + match.end() for match in re.finditer(re.escape(separator), text) + ) + else: + + def flatten_spans() -> Iterable[int]: + for match in re.finditer(re.escape(separator), text): + start, end = match.span() + yield start + yield end + + lines = Lines( + line for line in self.divide(flatten_spans()) if line.plain != separator + ) + + if not allow_blank and text.endswith(separator): + lines.pop() + + return lines + + def divide(self, offsets: Iterable[int]) -> Lines: + """Divide text in to a number of lines at given offsets. + + Args: + offsets (Iterable[int]): Offsets used to divide text. + + Returns: + Lines: New RichText instances between offsets. + """ + _offsets = list(offsets) + + if not _offsets: + return Lines([self.copy()]) + + text = self.plain + text_length = len(text) + divide_offsets = [0, *_offsets, text_length] + line_ranges = list(zip(divide_offsets, divide_offsets[1:])) + + style = self.style + justify = self.justify + overflow = self.overflow + _Text = Text + new_lines = Lines( + _Text( + text[start:end], + style=style, + justify=justify, + overflow=overflow, + ) + for start, end in line_ranges + ) + if not self._spans: + return new_lines + + _line_appends = [line._spans.append for line in new_lines._lines] + line_count = len(line_ranges) + _Span = Span + + for span_start, span_end, style in self._spans: + lower_bound = 0 + upper_bound = line_count + start_line_no = (lower_bound + upper_bound) // 2 + + while True: + line_start, line_end = line_ranges[start_line_no] + if span_start < line_start: + upper_bound = start_line_no - 1 + elif span_start > line_end: + lower_bound = start_line_no + 1 + else: + break + start_line_no = (lower_bound + upper_bound) // 2 + + if span_end < line_end: + end_line_no = start_line_no + else: + end_line_no = lower_bound = start_line_no + upper_bound = line_count + + while True: + line_start, line_end = line_ranges[end_line_no] + if span_end < line_start: + upper_bound = end_line_no - 1 + elif span_end > line_end: + lower_bound = end_line_no + 1 + else: + break + end_line_no = (lower_bound + upper_bound) // 2 + + for line_no in range(start_line_no, end_line_no + 1): + line_start, line_end = line_ranges[line_no] + new_start = max(0, span_start - line_start) + new_end = min(span_end - line_start, line_end - line_start) + if new_end > new_start: + _line_appends[line_no](_Span(new_start, new_end, style)) + + return new_lines + + def right_crop(self, amount: int = 1) -> None: + """Remove a number of characters from the end of the text.""" + max_offset = len(self.plain) - amount + _Span = Span + self._spans[:] = [ + ( + span + if span.end < max_offset + else _Span(span.start, min(max_offset, span.end), span.style) + ) + for span in self._spans + if span.start < max_offset + ] + self._text = [self.plain[:-amount]] + self._length -= amount + + def wrap( + self, + console: "Console", + width: int, + *, + justify: Optional["JustifyMethod"] = None, + overflow: Optional["OverflowMethod"] = None, + tab_size: int = 8, + no_wrap: Optional[bool] = None, + ) -> Lines: + """Word wrap the text. + + Args: + console (Console): Console instance. + width (int): Number of cells available per line. + justify (str, optional): Justify method: "default", "left", "center", "full", "right". Defaults to "default". + overflow (str, optional): Overflow method: "crop", "fold", or "ellipsis". Defaults to None. + tab_size (int, optional): Default tab size. Defaults to 8. + no_wrap (bool, optional): Disable wrapping, Defaults to False. + + Returns: + Lines: Number of lines. + """ + wrap_justify = justify or self.justify or DEFAULT_JUSTIFY + wrap_overflow = overflow or self.overflow or DEFAULT_OVERFLOW + + no_wrap = pick_bool(no_wrap, self.no_wrap, False) or overflow == "ignore" + + lines = Lines() + for line in self.split(allow_blank=True): + if "\t" in line: + line.expand_tabs(tab_size) + if no_wrap: + new_lines = Lines([line]) + else: + offsets = divide_line(str(line), width, fold=wrap_overflow == "fold") + new_lines = line.divide(offsets) + for line in new_lines: + line.rstrip_end(width) + if wrap_justify: + new_lines.justify( + console, width, justify=wrap_justify, overflow=wrap_overflow + ) + for line in new_lines: + line.truncate(width, overflow=wrap_overflow) + lines.extend(new_lines) + return lines + + def fit(self, width: int) -> Lines: + """Fit the text in to given width by chopping in to lines. + + Args: + width (int): Maximum characters in a line. + + Returns: + Lines: Lines container. + """ + lines: Lines = Lines() + append = lines.append + for line in self.split(): + line.set_length(width) + append(line) + return lines + + def detect_indentation(self) -> int: + """Auto-detect indentation of code. + + Returns: + int: Number of spaces used to indent code. + """ + + _indentations = { + len(match.group(1)) + for match in re.finditer(r"^( *)(.*)$", self.plain, flags=re.MULTILINE) + } + + try: + indentation = ( + reduce(gcd, [indent for indent in _indentations if not indent % 2]) or 1 + ) + except TypeError: + indentation = 1 + + return indentation + + def with_indent_guides( + self, + indent_size: Optional[int] = None, + *, + character: str = "│", + style: StyleType = "dim green", + ) -> "Text": + """Adds indent guide lines to text. + + Args: + indent_size (Optional[int]): Size of indentation, or None to auto detect. Defaults to None. + character (str, optional): Character to use for indentation. Defaults to "│". + style (Union[Style, str], optional): Style of indent guides. + + Returns: + Text: New text with indentation guides. + """ + + _indent_size = self.detect_indentation() if indent_size is None else indent_size + + text = self.copy() + text.expand_tabs() + indent_line = f"{character}{' ' * (_indent_size - 1)}" + + re_indent = re.compile(r"^( *)(.*)$") + new_lines: List[Text] = [] + add_line = new_lines.append + blank_lines = 0 + for line in text.split(allow_blank=True): + match = re_indent.match(line.plain) + if not match or not match.group(2): + blank_lines += 1 + continue + indent = match.group(1) + full_indents, remaining_space = divmod(len(indent), _indent_size) + new_indent = f"{indent_line * full_indents}{' ' * remaining_space}" + line.plain = new_indent + line.plain[len(new_indent) :] + line.stylize(style, 0, len(new_indent)) + if blank_lines: + new_lines.extend([Text(new_indent, style=style)] * blank_lines) + blank_lines = 0 + add_line(line) + if blank_lines: + new_lines.extend([Text("", style=style)] * blank_lines) + + new_text = text.blank_copy("\n").join(new_lines) + return new_text + + +if __name__ == "__main__": # pragma: no cover + from pip._vendor.rich.console import Console + + text = Text( + """\nLorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.\n""" + ) + text.highlight_words(["Lorem"], "bold") + text.highlight_words(["ipsum"], "italic") + + console = Console() + + console.rule("justify='left'") + console.print(text, style="red") + console.print() + + console.rule("justify='center'") + console.print(text, style="green", justify="center") + console.print() + + console.rule("justify='right'") + console.print(text, style="blue", justify="right") + console.print() + + console.rule("justify='full'") + console.print(text, style="magenta", justify="full") + console.print() diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/theme.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/theme.py new file mode 100644 index 0000000..471dfb2 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/theme.py @@ -0,0 +1,115 @@ +import configparser +from typing import Dict, List, IO, Mapping, Optional + +from .default_styles import DEFAULT_STYLES +from .style import Style, StyleType + + +class Theme: + """A container for style information, used by :class:`~rich.console.Console`. + + Args: + styles (Dict[str, Style], optional): A mapping of style names on to styles. Defaults to None for a theme with no styles. + inherit (bool, optional): Inherit default styles. Defaults to True. + """ + + styles: Dict[str, Style] + + def __init__( + self, styles: Optional[Mapping[str, StyleType]] = None, inherit: bool = True + ): + self.styles = DEFAULT_STYLES.copy() if inherit else {} + if styles is not None: + self.styles.update( + { + name: style if isinstance(style, Style) else Style.parse(style) + for name, style in styles.items() + } + ) + + @property + def config(self) -> str: + """Get contents of a config file for this theme.""" + config = "[styles]\n" + "\n".join( + f"{name} = {style}" for name, style in sorted(self.styles.items()) + ) + return config + + @classmethod + def from_file( + cls, config_file: IO[str], source: Optional[str] = None, inherit: bool = True + ) -> "Theme": + """Load a theme from a text mode file. + + Args: + config_file (IO[str]): An open conf file. + source (str, optional): The filename of the open file. Defaults to None. + inherit (bool, optional): Inherit default styles. Defaults to True. + + Returns: + Theme: A New theme instance. + """ + config = configparser.ConfigParser() + config.read_file(config_file, source=source) + styles = {name: Style.parse(value) for name, value in config.items("styles")} + theme = Theme(styles, inherit=inherit) + return theme + + @classmethod + def read( + cls, path: str, inherit: bool = True, encoding: Optional[str] = None + ) -> "Theme": + """Read a theme from a path. + + Args: + path (str): Path to a config file readable by Python configparser module. + inherit (bool, optional): Inherit default styles. Defaults to True. + encoding (str, optional): Encoding of the config file. Defaults to None. + + Returns: + Theme: A new theme instance. + """ + with open(path, "rt", encoding=encoding) as config_file: + return cls.from_file(config_file, source=path, inherit=inherit) + + +class ThemeStackError(Exception): + """Base exception for errors related to the theme stack.""" + + +class ThemeStack: + """A stack of themes. + + Args: + theme (Theme): A theme instance + """ + + def __init__(self, theme: Theme) -> None: + self._entries: List[Dict[str, Style]] = [theme.styles] + self.get = self._entries[-1].get + + def push_theme(self, theme: Theme, inherit: bool = True) -> None: + """Push a theme on the top of the stack. + + Args: + theme (Theme): A Theme instance. + inherit (boolean, optional): Inherit styles from current top of stack. + """ + styles: Dict[str, Style] + styles = ( + {**self._entries[-1], **theme.styles} if inherit else theme.styles.copy() + ) + self._entries.append(styles) + self.get = self._entries[-1].get + + def pop_theme(self) -> None: + """Pop (and discard) the top-most theme.""" + if len(self._entries) == 1: + raise ThemeStackError("Unable to pop base theme") + self._entries.pop() + self.get = self._entries[-1].get + + +if __name__ == "__main__": # pragma: no cover + theme = Theme() + print(theme.config) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/themes.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/themes.py new file mode 100644 index 0000000..bf6db10 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/themes.py @@ -0,0 +1,5 @@ +from .default_styles import DEFAULT_STYLES +from .theme import Theme + + +DEFAULT = Theme(DEFAULT_STYLES) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/traceback.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/traceback.py new file mode 100644 index 0000000..f223ad4 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/traceback.py @@ -0,0 +1,753 @@ +from __future__ import absolute_import + +import linecache +import os +import platform +import sys +from dataclasses import dataclass, field +from traceback import walk_tb +from types import ModuleType, TracebackType +from typing import ( + Any, + Callable, + Dict, + Iterable, + List, + Optional, + Sequence, + Tuple, + Type, + Union, +) + +from pip._vendor.pygments.lexers import guess_lexer_for_filename +from pip._vendor.pygments.token import Comment, Keyword, Name, Number, Operator, String +from pip._vendor.pygments.token import Text as TextToken +from pip._vendor.pygments.token import Token +from pip._vendor.pygments.util import ClassNotFound + +from . import pretty +from ._loop import loop_last +from .columns import Columns +from .console import Console, ConsoleOptions, ConsoleRenderable, RenderResult, group +from .constrain import Constrain +from .highlighter import RegexHighlighter, ReprHighlighter +from .panel import Panel +from .scope import render_scope +from .style import Style +from .syntax import Syntax +from .text import Text +from .theme import Theme + +WINDOWS = platform.system() == "Windows" + +LOCALS_MAX_LENGTH = 10 +LOCALS_MAX_STRING = 80 + + +def install( + *, + console: Optional[Console] = None, + width: Optional[int] = 100, + extra_lines: int = 3, + theme: Optional[str] = None, + word_wrap: bool = False, + show_locals: bool = False, + locals_max_length: int = LOCALS_MAX_LENGTH, + locals_max_string: int = LOCALS_MAX_STRING, + locals_hide_dunder: bool = True, + locals_hide_sunder: Optional[bool] = None, + indent_guides: bool = True, + suppress: Iterable[Union[str, ModuleType]] = (), + max_frames: int = 100, +) -> Callable[[Type[BaseException], BaseException, Optional[TracebackType]], Any]: + """Install a rich traceback handler. + + Once installed, any tracebacks will be printed with syntax highlighting and rich formatting. + + + Args: + console (Optional[Console], optional): Console to write exception to. Default uses internal Console instance. + width (Optional[int], optional): Width (in characters) of traceback. Defaults to 100. + extra_lines (int, optional): Extra lines of code. Defaults to 3. + theme (Optional[str], optional): Pygments theme to use in traceback. Defaults to ``None`` which will pick + a theme appropriate for the platform. + word_wrap (bool, optional): Enable word wrapping of long lines. Defaults to False. + show_locals (bool, optional): Enable display of local variables. Defaults to False. + locals_max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation. + Defaults to 10. + locals_max_string (int, optional): Maximum length of string before truncating, or None to disable. Defaults to 80. + locals_hide_dunder (bool, optional): Hide locals prefixed with double underscore. Defaults to True. + locals_hide_sunder (bool, optional): Hide locals prefixed with single underscore. Defaults to False. + indent_guides (bool, optional): Enable indent guides in code and locals. Defaults to True. + suppress (Sequence[Union[str, ModuleType]]): Optional sequence of modules or paths to exclude from traceback. + + Returns: + Callable: The previous exception handler that was replaced. + + """ + traceback_console = Console(stderr=True) if console is None else console + + locals_hide_sunder = ( + True + if (traceback_console.is_jupyter and locals_hide_sunder is None) + else locals_hide_sunder + ) + + def excepthook( + type_: Type[BaseException], + value: BaseException, + traceback: Optional[TracebackType], + ) -> None: + traceback_console.print( + Traceback.from_exception( + type_, + value, + traceback, + width=width, + extra_lines=extra_lines, + theme=theme, + word_wrap=word_wrap, + show_locals=show_locals, + locals_max_length=locals_max_length, + locals_max_string=locals_max_string, + locals_hide_dunder=locals_hide_dunder, + locals_hide_sunder=bool(locals_hide_sunder), + indent_guides=indent_guides, + suppress=suppress, + max_frames=max_frames, + ) + ) + + def ipy_excepthook_closure(ip: Any) -> None: # pragma: no cover + tb_data = {} # store information about showtraceback call + default_showtraceback = ip.showtraceback # keep reference of default traceback + + def ipy_show_traceback(*args: Any, **kwargs: Any) -> None: + """wrap the default ip.showtraceback to store info for ip._showtraceback""" + nonlocal tb_data + tb_data = kwargs + default_showtraceback(*args, **kwargs) + + def ipy_display_traceback( + *args: Any, is_syntax: bool = False, **kwargs: Any + ) -> None: + """Internally called traceback from ip._showtraceback""" + nonlocal tb_data + exc_tuple = ip._get_exc_info() + + # do not display trace on syntax error + tb: Optional[TracebackType] = None if is_syntax else exc_tuple[2] + + # determine correct tb_offset + compiled = tb_data.get("running_compiled_code", False) + tb_offset = tb_data.get("tb_offset", 1 if compiled else 0) + # remove ipython internal frames from trace with tb_offset + for _ in range(tb_offset): + if tb is None: + break + tb = tb.tb_next + + excepthook(exc_tuple[0], exc_tuple[1], tb) + tb_data = {} # clear data upon usage + + # replace _showtraceback instead of showtraceback to allow ipython features such as debugging to work + # this is also what the ipython docs recommends to modify when subclassing InteractiveShell + ip._showtraceback = ipy_display_traceback + # add wrapper to capture tb_data + ip.showtraceback = ipy_show_traceback + ip.showsyntaxerror = lambda *args, **kwargs: ipy_display_traceback( + *args, is_syntax=True, **kwargs + ) + + try: # pragma: no cover + # if within ipython, use customized traceback + ip = get_ipython() # type: ignore[name-defined] + ipy_excepthook_closure(ip) + return sys.excepthook + except Exception: + # otherwise use default system hook + old_excepthook = sys.excepthook + sys.excepthook = excepthook + return old_excepthook + + +@dataclass +class Frame: + filename: str + lineno: int + name: str + line: str = "" + locals: Optional[Dict[str, pretty.Node]] = None + + +@dataclass +class _SyntaxError: + offset: int + filename: str + line: str + lineno: int + msg: str + + +@dataclass +class Stack: + exc_type: str + exc_value: str + syntax_error: Optional[_SyntaxError] = None + is_cause: bool = False + frames: List[Frame] = field(default_factory=list) + + +@dataclass +class Trace: + stacks: List[Stack] + + +class PathHighlighter(RegexHighlighter): + highlights = [r"(?P.*/)(?P.+)"] + + +class Traceback: + """A Console renderable that renders a traceback. + + Args: + trace (Trace, optional): A `Trace` object produced from `extract`. Defaults to None, which uses + the last exception. + width (Optional[int], optional): Number of characters used to traceback. Defaults to 100. + extra_lines (int, optional): Additional lines of code to render. Defaults to 3. + theme (str, optional): Override pygments theme used in traceback. + word_wrap (bool, optional): Enable word wrapping of long lines. Defaults to False. + show_locals (bool, optional): Enable display of local variables. Defaults to False. + indent_guides (bool, optional): Enable indent guides in code and locals. Defaults to True. + locals_max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation. + Defaults to 10. + locals_max_string (int, optional): Maximum length of string before truncating, or None to disable. Defaults to 80. + locals_hide_dunder (bool, optional): Hide locals prefixed with double underscore. Defaults to True. + locals_hide_sunder (bool, optional): Hide locals prefixed with single underscore. Defaults to False. + suppress (Sequence[Union[str, ModuleType]]): Optional sequence of modules or paths to exclude from traceback. + max_frames (int): Maximum number of frames to show in a traceback, 0 for no maximum. Defaults to 100. + + """ + + LEXERS = { + "": "text", + ".py": "python", + ".pxd": "cython", + ".pyx": "cython", + ".pxi": "pyrex", + } + + def __init__( + self, + trace: Optional[Trace] = None, + *, + width: Optional[int] = 100, + extra_lines: int = 3, + theme: Optional[str] = None, + word_wrap: bool = False, + show_locals: bool = False, + locals_max_length: int = LOCALS_MAX_LENGTH, + locals_max_string: int = LOCALS_MAX_STRING, + locals_hide_dunder: bool = True, + locals_hide_sunder: bool = False, + indent_guides: bool = True, + suppress: Iterable[Union[str, ModuleType]] = (), + max_frames: int = 100, + ): + if trace is None: + exc_type, exc_value, traceback = sys.exc_info() + if exc_type is None or exc_value is None or traceback is None: + raise ValueError( + "Value for 'trace' required if not called in except: block" + ) + trace = self.extract( + exc_type, exc_value, traceback, show_locals=show_locals + ) + self.trace = trace + self.width = width + self.extra_lines = extra_lines + self.theme = Syntax.get_theme(theme or "ansi_dark") + self.word_wrap = word_wrap + self.show_locals = show_locals + self.indent_guides = indent_guides + self.locals_max_length = locals_max_length + self.locals_max_string = locals_max_string + self.locals_hide_dunder = locals_hide_dunder + self.locals_hide_sunder = locals_hide_sunder + + self.suppress: Sequence[str] = [] + for suppress_entity in suppress: + if not isinstance(suppress_entity, str): + assert ( + suppress_entity.__file__ is not None + ), f"{suppress_entity!r} must be a module with '__file__' attribute" + path = os.path.dirname(suppress_entity.__file__) + else: + path = suppress_entity + path = os.path.normpath(os.path.abspath(path)) + self.suppress.append(path) + self.max_frames = max(4, max_frames) if max_frames > 0 else 0 + + @classmethod + def from_exception( + cls, + exc_type: Type[Any], + exc_value: BaseException, + traceback: Optional[TracebackType], + *, + width: Optional[int] = 100, + extra_lines: int = 3, + theme: Optional[str] = None, + word_wrap: bool = False, + show_locals: bool = False, + locals_max_length: int = LOCALS_MAX_LENGTH, + locals_max_string: int = LOCALS_MAX_STRING, + locals_hide_dunder: bool = True, + locals_hide_sunder: bool = False, + indent_guides: bool = True, + suppress: Iterable[Union[str, ModuleType]] = (), + max_frames: int = 100, + ) -> "Traceback": + """Create a traceback from exception info + + Args: + exc_type (Type[BaseException]): Exception type. + exc_value (BaseException): Exception value. + traceback (TracebackType): Python Traceback object. + width (Optional[int], optional): Number of characters used to traceback. Defaults to 100. + extra_lines (int, optional): Additional lines of code to render. Defaults to 3. + theme (str, optional): Override pygments theme used in traceback. + word_wrap (bool, optional): Enable word wrapping of long lines. Defaults to False. + show_locals (bool, optional): Enable display of local variables. Defaults to False. + indent_guides (bool, optional): Enable indent guides in code and locals. Defaults to True. + locals_max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation. + Defaults to 10. + locals_max_string (int, optional): Maximum length of string before truncating, or None to disable. Defaults to 80. + locals_hide_dunder (bool, optional): Hide locals prefixed with double underscore. Defaults to True. + locals_hide_sunder (bool, optional): Hide locals prefixed with single underscore. Defaults to False. + suppress (Iterable[Union[str, ModuleType]]): Optional sequence of modules or paths to exclude from traceback. + max_frames (int): Maximum number of frames to show in a traceback, 0 for no maximum. Defaults to 100. + + Returns: + Traceback: A Traceback instance that may be printed. + """ + rich_traceback = cls.extract( + exc_type, + exc_value, + traceback, + show_locals=show_locals, + locals_max_length=locals_max_length, + locals_max_string=locals_max_string, + locals_hide_dunder=locals_hide_dunder, + locals_hide_sunder=locals_hide_sunder, + ) + + return cls( + rich_traceback, + width=width, + extra_lines=extra_lines, + theme=theme, + word_wrap=word_wrap, + show_locals=show_locals, + indent_guides=indent_guides, + locals_max_length=locals_max_length, + locals_max_string=locals_max_string, + locals_hide_dunder=locals_hide_dunder, + locals_hide_sunder=locals_hide_sunder, + suppress=suppress, + max_frames=max_frames, + ) + + @classmethod + def extract( + cls, + exc_type: Type[BaseException], + exc_value: BaseException, + traceback: Optional[TracebackType], + *, + show_locals: bool = False, + locals_max_length: int = LOCALS_MAX_LENGTH, + locals_max_string: int = LOCALS_MAX_STRING, + locals_hide_dunder: bool = True, + locals_hide_sunder: bool = False, + ) -> Trace: + """Extract traceback information. + + Args: + exc_type (Type[BaseException]): Exception type. + exc_value (BaseException): Exception value. + traceback (TracebackType): Python Traceback object. + show_locals (bool, optional): Enable display of local variables. Defaults to False. + locals_max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation. + Defaults to 10. + locals_max_string (int, optional): Maximum length of string before truncating, or None to disable. Defaults to 80. + locals_hide_dunder (bool, optional): Hide locals prefixed with double underscore. Defaults to True. + locals_hide_sunder (bool, optional): Hide locals prefixed with single underscore. Defaults to False. + + Returns: + Trace: A Trace instance which you can use to construct a `Traceback`. + """ + + stacks: List[Stack] = [] + is_cause = False + + from pip._vendor.rich import _IMPORT_CWD + + def safe_str(_object: Any) -> str: + """Don't allow exceptions from __str__ to propagate.""" + try: + return str(_object) + except Exception: + return "" + + while True: + stack = Stack( + exc_type=safe_str(exc_type.__name__), + exc_value=safe_str(exc_value), + is_cause=is_cause, + ) + + if isinstance(exc_value, SyntaxError): + stack.syntax_error = _SyntaxError( + offset=exc_value.offset or 0, + filename=exc_value.filename or "?", + lineno=exc_value.lineno or 0, + line=exc_value.text or "", + msg=exc_value.msg, + ) + + stacks.append(stack) + append = stack.frames.append + + def get_locals( + iter_locals: Iterable[Tuple[str, object]] + ) -> Iterable[Tuple[str, object]]: + """Extract locals from an iterator of key pairs.""" + if not (locals_hide_dunder or locals_hide_sunder): + yield from iter_locals + return + for key, value in iter_locals: + if locals_hide_dunder and key.startswith("__"): + continue + if locals_hide_sunder and key.startswith("_"): + continue + yield key, value + + for frame_summary, line_no in walk_tb(traceback): + filename = frame_summary.f_code.co_filename + if filename and not filename.startswith("<"): + if not os.path.isabs(filename): + filename = os.path.join(_IMPORT_CWD, filename) + if frame_summary.f_locals.get("_rich_traceback_omit", False): + continue + + frame = Frame( + filename=filename or "?", + lineno=line_no, + name=frame_summary.f_code.co_name, + locals={ + key: pretty.traverse( + value, + max_length=locals_max_length, + max_string=locals_max_string, + ) + for key, value in get_locals(frame_summary.f_locals.items()) + } + if show_locals + else None, + ) + append(frame) + if frame_summary.f_locals.get("_rich_traceback_guard", False): + del stack.frames[:] + + cause = getattr(exc_value, "__cause__", None) + if cause: + exc_type = cause.__class__ + exc_value = cause + # __traceback__ can be None, e.g. for exceptions raised by the + # 'multiprocessing' module + traceback = cause.__traceback__ + is_cause = True + continue + + cause = exc_value.__context__ + if cause and not getattr(exc_value, "__suppress_context__", False): + exc_type = cause.__class__ + exc_value = cause + traceback = cause.__traceback__ + is_cause = False + continue + # No cover, code is reached but coverage doesn't recognize it. + break # pragma: no cover + + trace = Trace(stacks=stacks) + return trace + + def __rich_console__( + self, console: Console, options: ConsoleOptions + ) -> RenderResult: + theme = self.theme + background_style = theme.get_background_style() + token_style = theme.get_style_for_token + + traceback_theme = Theme( + { + "pretty": token_style(TextToken), + "pygments.text": token_style(Token), + "pygments.string": token_style(String), + "pygments.function": token_style(Name.Function), + "pygments.number": token_style(Number), + "repr.indent": token_style(Comment) + Style(dim=True), + "repr.str": token_style(String), + "repr.brace": token_style(TextToken) + Style(bold=True), + "repr.number": token_style(Number), + "repr.bool_true": token_style(Keyword.Constant), + "repr.bool_false": token_style(Keyword.Constant), + "repr.none": token_style(Keyword.Constant), + "scope.border": token_style(String.Delimiter), + "scope.equals": token_style(Operator), + "scope.key": token_style(Name), + "scope.key.special": token_style(Name.Constant) + Style(dim=True), + }, + inherit=False, + ) + + highlighter = ReprHighlighter() + for last, stack in loop_last(reversed(self.trace.stacks)): + if stack.frames: + stack_renderable: ConsoleRenderable = Panel( + self._render_stack(stack), + title="[traceback.title]Traceback [dim](most recent call last)", + style=background_style, + border_style="traceback.border", + expand=True, + padding=(0, 1), + ) + stack_renderable = Constrain(stack_renderable, self.width) + with console.use_theme(traceback_theme): + yield stack_renderable + if stack.syntax_error is not None: + with console.use_theme(traceback_theme): + yield Constrain( + Panel( + self._render_syntax_error(stack.syntax_error), + style=background_style, + border_style="traceback.border.syntax_error", + expand=True, + padding=(0, 1), + width=self.width, + ), + self.width, + ) + yield Text.assemble( + (f"{stack.exc_type}: ", "traceback.exc_type"), + highlighter(stack.syntax_error.msg), + ) + elif stack.exc_value: + yield Text.assemble( + (f"{stack.exc_type}: ", "traceback.exc_type"), + highlighter(stack.exc_value), + ) + else: + yield Text.assemble((f"{stack.exc_type}", "traceback.exc_type")) + + if not last: + if stack.is_cause: + yield Text.from_markup( + "\n[i]The above exception was the direct cause of the following exception:\n", + ) + else: + yield Text.from_markup( + "\n[i]During handling of the above exception, another exception occurred:\n", + ) + + @group() + def _render_syntax_error(self, syntax_error: _SyntaxError) -> RenderResult: + highlighter = ReprHighlighter() + path_highlighter = PathHighlighter() + if syntax_error.filename != "": + if os.path.exists(syntax_error.filename): + text = Text.assemble( + (f" {syntax_error.filename}", "pygments.string"), + (":", "pygments.text"), + (str(syntax_error.lineno), "pygments.number"), + style="pygments.text", + ) + yield path_highlighter(text) + syntax_error_text = highlighter(syntax_error.line.rstrip()) + syntax_error_text.no_wrap = True + offset = min(syntax_error.offset - 1, len(syntax_error_text)) + syntax_error_text.stylize("bold underline", offset, offset) + syntax_error_text += Text.from_markup( + "\n" + " " * offset + "[traceback.offset]▲[/]", + style="pygments.text", + ) + yield syntax_error_text + + @classmethod + def _guess_lexer(cls, filename: str, code: str) -> str: + ext = os.path.splitext(filename)[-1] + if not ext: + # No extension, look at first line to see if it is a hashbang + # Note, this is an educated guess and not a guarantee + # If it fails, the only downside is that the code is highlighted strangely + new_line_index = code.index("\n") + first_line = code[:new_line_index] if new_line_index != -1 else code + if first_line.startswith("#!") and "python" in first_line.lower(): + return "python" + try: + return cls.LEXERS.get(ext) or guess_lexer_for_filename(filename, code).name + except ClassNotFound: + return "text" + + @group() + def _render_stack(self, stack: Stack) -> RenderResult: + path_highlighter = PathHighlighter() + theme = self.theme + + def read_code(filename: str) -> str: + """Read files, and cache results on filename. + + Args: + filename (str): Filename to read + + Returns: + str: Contents of file + """ + return "".join(linecache.getlines(filename)) + + def render_locals(frame: Frame) -> Iterable[ConsoleRenderable]: + if frame.locals: + yield render_scope( + frame.locals, + title="locals", + indent_guides=self.indent_guides, + max_length=self.locals_max_length, + max_string=self.locals_max_string, + ) + + exclude_frames: Optional[range] = None + if self.max_frames != 0: + exclude_frames = range( + self.max_frames // 2, + len(stack.frames) - self.max_frames // 2, + ) + + excluded = False + for frame_index, frame in enumerate(stack.frames): + if exclude_frames and frame_index in exclude_frames: + excluded = True + continue + + if excluded: + assert exclude_frames is not None + yield Text( + f"\n... {len(exclude_frames)} frames hidden ...", + justify="center", + style="traceback.error", + ) + excluded = False + + first = frame_index == 0 + frame_filename = frame.filename + suppressed = any(frame_filename.startswith(path) for path in self.suppress) + + if os.path.exists(frame.filename): + text = Text.assemble( + path_highlighter(Text(frame.filename, style="pygments.string")), + (":", "pygments.text"), + (str(frame.lineno), "pygments.number"), + " in ", + (frame.name, "pygments.function"), + style="pygments.text", + ) + else: + text = Text.assemble( + "in ", + (frame.name, "pygments.function"), + (":", "pygments.text"), + (str(frame.lineno), "pygments.number"), + style="pygments.text", + ) + if not frame.filename.startswith("<") and not first: + yield "" + yield text + if frame.filename.startswith("<"): + yield from render_locals(frame) + continue + if not suppressed: + try: + code = read_code(frame.filename) + if not code: + # code may be an empty string if the file doesn't exist, OR + # if the traceback filename is generated dynamically + continue + lexer_name = self._guess_lexer(frame.filename, code) + syntax = Syntax( + code, + lexer_name, + theme=theme, + line_numbers=True, + line_range=( + frame.lineno - self.extra_lines, + frame.lineno + self.extra_lines, + ), + highlight_lines={frame.lineno}, + word_wrap=self.word_wrap, + code_width=88, + indent_guides=self.indent_guides, + dedent=False, + ) + yield "" + except Exception as error: + yield Text.assemble( + (f"\n{error}", "traceback.error"), + ) + else: + yield ( + Columns( + [ + syntax, + *render_locals(frame), + ], + padding=1, + ) + if frame.locals + else syntax + ) + + +if __name__ == "__main__": # pragma: no cover + from .console import Console + + console = Console() + import sys + + def bar(a: Any) -> None: # 这是对亚洲语言支持的测试。面对模棱两可的想法,拒绝猜测的诱惑 + one = 1 + print(one / a) + + def foo(a: Any) -> None: + _rich_traceback_guard = True + zed = { + "characters": { + "Paul Atreides", + "Vladimir Harkonnen", + "Thufir Hawat", + "Duncan Idaho", + }, + "atomic_types": (None, False, True), + } + bar(a) + + def error() -> None: + try: + try: + foo(0) + except: + slfkjsldkfj # type: ignore[name-defined] + except: + console.print_exception(show_locals=True) + + error() diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/rich/tree.py b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/tree.py new file mode 100644 index 0000000..64bc75d --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/rich/tree.py @@ -0,0 +1,249 @@ +from typing import Iterator, List, Optional, Tuple + +from ._loop import loop_first, loop_last +from .console import Console, ConsoleOptions, RenderableType, RenderResult +from .jupyter import JupyterMixin +from .measure import Measurement +from .segment import Segment +from .style import Style, StyleStack, StyleType +from .styled import Styled + + +class Tree(JupyterMixin): + """A renderable for a tree structure. + + Args: + label (RenderableType): The renderable or str for the tree label. + style (StyleType, optional): Style of this tree. Defaults to "tree". + guide_style (StyleType, optional): Style of the guide lines. Defaults to "tree.line". + expanded (bool, optional): Also display children. Defaults to True. + highlight (bool, optional): Highlight renderable (if str). Defaults to False. + """ + + def __init__( + self, + label: RenderableType, + *, + style: StyleType = "tree", + guide_style: StyleType = "tree.line", + expanded: bool = True, + highlight: bool = False, + hide_root: bool = False, + ) -> None: + self.label = label + self.style = style + self.guide_style = guide_style + self.children: List[Tree] = [] + self.expanded = expanded + self.highlight = highlight + self.hide_root = hide_root + + def add( + self, + label: RenderableType, + *, + style: Optional[StyleType] = None, + guide_style: Optional[StyleType] = None, + expanded: bool = True, + highlight: Optional[bool] = False, + ) -> "Tree": + """Add a child tree. + + Args: + label (RenderableType): The renderable or str for the tree label. + style (StyleType, optional): Style of this tree. Defaults to "tree". + guide_style (StyleType, optional): Style of the guide lines. Defaults to "tree.line". + expanded (bool, optional): Also display children. Defaults to True. + highlight (Optional[bool], optional): Highlight renderable (if str). Defaults to False. + + Returns: + Tree: A new child Tree, which may be further modified. + """ + node = Tree( + label, + style=self.style if style is None else style, + guide_style=self.guide_style if guide_style is None else guide_style, + expanded=expanded, + highlight=self.highlight if highlight is None else highlight, + ) + self.children.append(node) + return node + + def __rich_console__( + self, console: "Console", options: "ConsoleOptions" + ) -> "RenderResult": + stack: List[Iterator[Tuple[bool, Tree]]] = [] + pop = stack.pop + push = stack.append + new_line = Segment.line() + + get_style = console.get_style + null_style = Style.null() + guide_style = get_style(self.guide_style, default="") or null_style + SPACE, CONTINUE, FORK, END = range(4) + + ASCII_GUIDES = (" ", "| ", "+-- ", "`-- ") + TREE_GUIDES = [ + (" ", "│ ", "├── ", "└── "), + (" ", "┃ ", "┣━━ ", "┗━━ "), + (" ", "║ ", "╠══ ", "╚══ "), + ] + _Segment = Segment + + def make_guide(index: int, style: Style) -> Segment: + """Make a Segment for a level of the guide lines.""" + if options.ascii_only: + line = ASCII_GUIDES[index] + else: + guide = 1 if style.bold else (2 if style.underline2 else 0) + line = TREE_GUIDES[0 if options.legacy_windows else guide][index] + return _Segment(line, style) + + levels: List[Segment] = [make_guide(CONTINUE, guide_style)] + push(iter(loop_last([self]))) + + guide_style_stack = StyleStack(get_style(self.guide_style)) + style_stack = StyleStack(get_style(self.style)) + remove_guide_styles = Style(bold=False, underline2=False) + + depth = 0 + + while stack: + stack_node = pop() + try: + last, node = next(stack_node) + except StopIteration: + levels.pop() + if levels: + guide_style = levels[-1].style or null_style + levels[-1] = make_guide(FORK, guide_style) + guide_style_stack.pop() + style_stack.pop() + continue + push(stack_node) + if last: + levels[-1] = make_guide(END, levels[-1].style or null_style) + + guide_style = guide_style_stack.current + get_style(node.guide_style) + style = style_stack.current + get_style(node.style) + prefix = levels[(2 if self.hide_root else 1) :] + renderable_lines = console.render_lines( + Styled(node.label, style), + options.update( + width=options.max_width + - sum(level.cell_length for level in prefix), + highlight=self.highlight, + height=None, + ), + pad=options.justify is not None, + ) + + if not (depth == 0 and self.hide_root): + for first, line in loop_first(renderable_lines): + if prefix: + yield from _Segment.apply_style( + prefix, + style.background_style, + post_style=remove_guide_styles, + ) + yield from line + yield new_line + if first and prefix: + prefix[-1] = make_guide( + SPACE if last else CONTINUE, prefix[-1].style or null_style + ) + + if node.expanded and node.children: + levels[-1] = make_guide( + SPACE if last else CONTINUE, levels[-1].style or null_style + ) + levels.append( + make_guide(END if len(node.children) == 1 else FORK, guide_style) + ) + style_stack.push(get_style(node.style)) + guide_style_stack.push(get_style(node.guide_style)) + push(iter(loop_last(node.children))) + depth += 1 + + def __rich_measure__( + self, console: "Console", options: "ConsoleOptions" + ) -> "Measurement": + stack: List[Iterator[Tree]] = [iter([self])] + pop = stack.pop + push = stack.append + minimum = 0 + maximum = 0 + measure = Measurement.get + level = 0 + while stack: + iter_tree = pop() + try: + tree = next(iter_tree) + except StopIteration: + level -= 1 + continue + push(iter_tree) + min_measure, max_measure = measure(console, options, tree.label) + indent = level * 4 + minimum = max(min_measure + indent, minimum) + maximum = max(max_measure + indent, maximum) + if tree.expanded and tree.children: + push(iter(tree.children)) + level += 1 + return Measurement(minimum, maximum) + + +if __name__ == "__main__": # pragma: no cover + from pip._vendor.rich.console import Group + from pip._vendor.rich.markdown import Markdown + from pip._vendor.rich.panel import Panel + from pip._vendor.rich.syntax import Syntax + from pip._vendor.rich.table import Table + + table = Table(row_styles=["", "dim"]) + + table.add_column("Released", style="cyan", no_wrap=True) + table.add_column("Title", style="magenta") + table.add_column("Box Office", justify="right", style="green") + + table.add_row("Dec 20, 2019", "Star Wars: The Rise of Skywalker", "$952,110,690") + table.add_row("May 25, 2018", "Solo: A Star Wars Story", "$393,151,347") + table.add_row("Dec 15, 2017", "Star Wars Ep. V111: The Last Jedi", "$1,332,539,889") + table.add_row("Dec 16, 2016", "Rogue One: A Star Wars Story", "$1,332,439,889") + + code = """\ +class Segment(NamedTuple): + text: str = "" + style: Optional[Style] = None + is_control: bool = False +""" + syntax = Syntax(code, "python", theme="monokai", line_numbers=True) + + markdown = Markdown( + """\ +### example.md +> Hello, World! +> +> Markdown _all_ the things +""" + ) + + root = Tree("🌲 [b green]Rich Tree", highlight=True, hide_root=True) + + node = root.add(":file_folder: Renderables", guide_style="red") + simple_node = node.add(":file_folder: [bold yellow]Atomic", guide_style="uu green") + simple_node.add(Group("📄 Syntax", syntax)) + simple_node.add(Group("📄 Markdown", Panel(markdown, border_style="green"))) + + containers_node = node.add( + ":file_folder: [bold magenta]Containers", guide_style="bold magenta" + ) + containers_node.expanded = True + panel = Panel.fit("Just a panel", border_style="red") + containers_node.add(Group("📄 Panels", panel)) + + containers_node.add(Group("📄 [b magenta]Table", table)) + + console = Console() + + console.print(root) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/__init__.py b/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/__init__.py new file mode 100644 index 0000000..4c6ec97 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/__init__.py @@ -0,0 +1,11 @@ +# SPDX-License-Identifier: MIT +# SPDX-FileCopyrightText: 2021 Taneli Hukkinen +# Licensed to PSF under a Contributor Agreement. + +__all__ = ("loads", "load", "TOMLDecodeError") +__version__ = "2.0.1" # DO NOT EDIT THIS LINE MANUALLY. LET bump2version UTILITY DO IT + +from ._parser import TOMLDecodeError, load, loads + +# Pretend this exception was created here. +TOMLDecodeError.__module__ = __name__ diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..fe0f749191ba9a340b8bf4c192202993d8ec2131 GIT binary patch literal 384 zcmZ8cu};G<5WUn%Q?<06SQwC4kTMXHvLYtfCfz=2`1F{kit!U;lzH$*;eHr>*-!|G zacwcAp(gb#=+r)9A|+zoL#((dgvzb)Q75M0=HEcwLClkk+m0?`rr5o-`U#eH8LY18 zL}i>B%}b*ykxpoH1|5qcrD4VMib`=!^|YL*{2+`*v=AlV(@A=l-135Ip{YF~XUfo0 zWl~T?k&6;B)YDbx@Hg(r3~W~OPO)QYK^(_fbfHIQ{`+8a*87C$6{1BOws&X4H`p>8 Gw(AEQU1%Ku literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/__pycache__/_parser.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/__pycache__/_parser.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..63b08f9c2031b512b48ed573b5d9d9d4c5e82d37 GIT binary patch literal 26927 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/__pycache__/_re.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/__pycache__/_re.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..cebe067b572f82dce0e11242143511f4394f832c GIT binary patch literal 3908 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/__pycache__/_types.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/__pycache__/_types.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..85fd090c50de7138d116510da8a845b69fd64e4b GIT binary patch literal 366 zcmXv|F-yZh6u!%)v5iCrL2z`^4(6zCB7zh|5T&AvSxTC`wx^d|xJwJ!+O1v-~K){Zz_2j@tP%TK^{#qTX6HPACLRXt1=V6C~t~?Af4*qSu zrk%XVSlW}TNNKOAVn`E}OYOEoso;`}FxTW73QbsQR7 dict[str, Any]: + """Parse TOML from a binary file object.""" + b = __fp.read() + try: + s = b.decode() + except AttributeError: + raise TypeError( + "File must be opened in binary mode, e.g. use `open('foo.toml', 'rb')`" + ) from None + return loads(s, parse_float=parse_float) + + +def loads(__s: str, *, parse_float: ParseFloat = float) -> dict[str, Any]: # noqa: C901 + """Parse TOML from a string.""" + + # The spec allows converting "\r\n" to "\n", even in string + # literals. Let's do so to simplify parsing. + src = __s.replace("\r\n", "\n") + pos = 0 + out = Output(NestedDict(), Flags()) + header: Key = () + parse_float = make_safe_parse_float(parse_float) + + # Parse one statement at a time + # (typically means one line in TOML source) + while True: + # 1. Skip line leading whitespace + pos = skip_chars(src, pos, TOML_WS) + + # 2. Parse rules. Expect one of the following: + # - end of file + # - end of line + # - comment + # - key/value pair + # - append dict to list (and move to its namespace) + # - create dict (and move to its namespace) + # Skip trailing whitespace when applicable. + try: + char = src[pos] + except IndexError: + break + if char == "\n": + pos += 1 + continue + if char in KEY_INITIAL_CHARS: + pos = key_value_rule(src, pos, out, header, parse_float) + pos = skip_chars(src, pos, TOML_WS) + elif char == "[": + try: + second_char: str | None = src[pos + 1] + except IndexError: + second_char = None + out.flags.finalize_pending() + if second_char == "[": + pos, header = create_list_rule(src, pos, out) + else: + pos, header = create_dict_rule(src, pos, out) + pos = skip_chars(src, pos, TOML_WS) + elif char != "#": + raise suffixed_err(src, pos, "Invalid statement") + + # 3. Skip comment + pos = skip_comment(src, pos) + + # 4. Expect end of line or end of file + try: + char = src[pos] + except IndexError: + break + if char != "\n": + raise suffixed_err( + src, pos, "Expected newline or end of document after a statement" + ) + pos += 1 + + return out.data.dict + + +class Flags: + """Flags that map to parsed keys/namespaces.""" + + # Marks an immutable namespace (inline array or inline table). + FROZEN = 0 + # Marks a nest that has been explicitly created and can no longer + # be opened using the "[table]" syntax. + EXPLICIT_NEST = 1 + + def __init__(self) -> None: + self._flags: dict[str, dict] = {} + self._pending_flags: set[tuple[Key, int]] = set() + + def add_pending(self, key: Key, flag: int) -> None: + self._pending_flags.add((key, flag)) + + def finalize_pending(self) -> None: + for key, flag in self._pending_flags: + self.set(key, flag, recursive=False) + self._pending_flags.clear() + + def unset_all(self, key: Key) -> None: + cont = self._flags + for k in key[:-1]: + if k not in cont: + return + cont = cont[k]["nested"] + cont.pop(key[-1], None) + + def set(self, key: Key, flag: int, *, recursive: bool) -> None: # noqa: A003 + cont = self._flags + key_parent, key_stem = key[:-1], key[-1] + for k in key_parent: + if k not in cont: + cont[k] = {"flags": set(), "recursive_flags": set(), "nested": {}} + cont = cont[k]["nested"] + if key_stem not in cont: + cont[key_stem] = {"flags": set(), "recursive_flags": set(), "nested": {}} + cont[key_stem]["recursive_flags" if recursive else "flags"].add(flag) + + def is_(self, key: Key, flag: int) -> bool: + if not key: + return False # document root has no flags + cont = self._flags + for k in key[:-1]: + if k not in cont: + return False + inner_cont = cont[k] + if flag in inner_cont["recursive_flags"]: + return True + cont = inner_cont["nested"] + key_stem = key[-1] + if key_stem in cont: + cont = cont[key_stem] + return flag in cont["flags"] or flag in cont["recursive_flags"] + return False + + +class NestedDict: + def __init__(self) -> None: + # The parsed content of the TOML document + self.dict: dict[str, Any] = {} + + def get_or_create_nest( + self, + key: Key, + *, + access_lists: bool = True, + ) -> dict: + cont: Any = self.dict + for k in key: + if k not in cont: + cont[k] = {} + cont = cont[k] + if access_lists and isinstance(cont, list): + cont = cont[-1] + if not isinstance(cont, dict): + raise KeyError("There is no nest behind this key") + return cont + + def append_nest_to_list(self, key: Key) -> None: + cont = self.get_or_create_nest(key[:-1]) + last_key = key[-1] + if last_key in cont: + list_ = cont[last_key] + if not isinstance(list_, list): + raise KeyError("An object other than list found behind this key") + list_.append({}) + else: + cont[last_key] = [{}] + + +class Output(NamedTuple): + data: NestedDict + flags: Flags + + +def skip_chars(src: str, pos: Pos, chars: Iterable[str]) -> Pos: + try: + while src[pos] in chars: + pos += 1 + except IndexError: + pass + return pos + + +def skip_until( + src: str, + pos: Pos, + expect: str, + *, + error_on: frozenset[str], + error_on_eof: bool, +) -> Pos: + try: + new_pos = src.index(expect, pos) + except ValueError: + new_pos = len(src) + if error_on_eof: + raise suffixed_err(src, new_pos, f"Expected {expect!r}") from None + + if not error_on.isdisjoint(src[pos:new_pos]): + while src[pos] not in error_on: + pos += 1 + raise suffixed_err(src, pos, f"Found invalid character {src[pos]!r}") + return new_pos + + +def skip_comment(src: str, pos: Pos) -> Pos: + try: + char: str | None = src[pos] + except IndexError: + char = None + if char == "#": + return skip_until( + src, pos + 1, "\n", error_on=ILLEGAL_COMMENT_CHARS, error_on_eof=False + ) + return pos + + +def skip_comments_and_array_ws(src: str, pos: Pos) -> Pos: + while True: + pos_before_skip = pos + pos = skip_chars(src, pos, TOML_WS_AND_NEWLINE) + pos = skip_comment(src, pos) + if pos == pos_before_skip: + return pos + + +def create_dict_rule(src: str, pos: Pos, out: Output) -> tuple[Pos, Key]: + pos += 1 # Skip "[" + pos = skip_chars(src, pos, TOML_WS) + pos, key = parse_key(src, pos) + + if out.flags.is_(key, Flags.EXPLICIT_NEST) or out.flags.is_(key, Flags.FROZEN): + raise suffixed_err(src, pos, f"Cannot declare {key} twice") + out.flags.set(key, Flags.EXPLICIT_NEST, recursive=False) + try: + out.data.get_or_create_nest(key) + except KeyError: + raise suffixed_err(src, pos, "Cannot overwrite a value") from None + + if not src.startswith("]", pos): + raise suffixed_err(src, pos, "Expected ']' at the end of a table declaration") + return pos + 1, key + + +def create_list_rule(src: str, pos: Pos, out: Output) -> tuple[Pos, Key]: + pos += 2 # Skip "[[" + pos = skip_chars(src, pos, TOML_WS) + pos, key = parse_key(src, pos) + + if out.flags.is_(key, Flags.FROZEN): + raise suffixed_err(src, pos, f"Cannot mutate immutable namespace {key}") + # Free the namespace now that it points to another empty list item... + out.flags.unset_all(key) + # ...but this key precisely is still prohibited from table declaration + out.flags.set(key, Flags.EXPLICIT_NEST, recursive=False) + try: + out.data.append_nest_to_list(key) + except KeyError: + raise suffixed_err(src, pos, "Cannot overwrite a value") from None + + if not src.startswith("]]", pos): + raise suffixed_err(src, pos, "Expected ']]' at the end of an array declaration") + return pos + 2, key + + +def key_value_rule( + src: str, pos: Pos, out: Output, header: Key, parse_float: ParseFloat +) -> Pos: + pos, key, value = parse_key_value_pair(src, pos, parse_float) + key_parent, key_stem = key[:-1], key[-1] + abs_key_parent = header + key_parent + + relative_path_cont_keys = (header + key[:i] for i in range(1, len(key))) + for cont_key in relative_path_cont_keys: + # Check that dotted key syntax does not redefine an existing table + if out.flags.is_(cont_key, Flags.EXPLICIT_NEST): + raise suffixed_err(src, pos, f"Cannot redefine namespace {cont_key}") + # Containers in the relative path can't be opened with the table syntax or + # dotted key/value syntax in following table sections. + out.flags.add_pending(cont_key, Flags.EXPLICIT_NEST) + + if out.flags.is_(abs_key_parent, Flags.FROZEN): + raise suffixed_err( + src, pos, f"Cannot mutate immutable namespace {abs_key_parent}" + ) + + try: + nest = out.data.get_or_create_nest(abs_key_parent) + except KeyError: + raise suffixed_err(src, pos, "Cannot overwrite a value") from None + if key_stem in nest: + raise suffixed_err(src, pos, "Cannot overwrite a value") + # Mark inline table and array namespaces recursively immutable + if isinstance(value, (dict, list)): + out.flags.set(header + key, Flags.FROZEN, recursive=True) + nest[key_stem] = value + return pos + + +def parse_key_value_pair( + src: str, pos: Pos, parse_float: ParseFloat +) -> tuple[Pos, Key, Any]: + pos, key = parse_key(src, pos) + try: + char: str | None = src[pos] + except IndexError: + char = None + if char != "=": + raise suffixed_err(src, pos, "Expected '=' after a key in a key/value pair") + pos += 1 + pos = skip_chars(src, pos, TOML_WS) + pos, value = parse_value(src, pos, parse_float) + return pos, key, value + + +def parse_key(src: str, pos: Pos) -> tuple[Pos, Key]: + pos, key_part = parse_key_part(src, pos) + key: Key = (key_part,) + pos = skip_chars(src, pos, TOML_WS) + while True: + try: + char: str | None = src[pos] + except IndexError: + char = None + if char != ".": + return pos, key + pos += 1 + pos = skip_chars(src, pos, TOML_WS) + pos, key_part = parse_key_part(src, pos) + key += (key_part,) + pos = skip_chars(src, pos, TOML_WS) + + +def parse_key_part(src: str, pos: Pos) -> tuple[Pos, str]: + try: + char: str | None = src[pos] + except IndexError: + char = None + if char in BARE_KEY_CHARS: + start_pos = pos + pos = skip_chars(src, pos, BARE_KEY_CHARS) + return pos, src[start_pos:pos] + if char == "'": + return parse_literal_str(src, pos) + if char == '"': + return parse_one_line_basic_str(src, pos) + raise suffixed_err(src, pos, "Invalid initial character for a key part") + + +def parse_one_line_basic_str(src: str, pos: Pos) -> tuple[Pos, str]: + pos += 1 + return parse_basic_str(src, pos, multiline=False) + + +def parse_array(src: str, pos: Pos, parse_float: ParseFloat) -> tuple[Pos, list]: + pos += 1 + array: list = [] + + pos = skip_comments_and_array_ws(src, pos) + if src.startswith("]", pos): + return pos + 1, array + while True: + pos, val = parse_value(src, pos, parse_float) + array.append(val) + pos = skip_comments_and_array_ws(src, pos) + + c = src[pos : pos + 1] + if c == "]": + return pos + 1, array + if c != ",": + raise suffixed_err(src, pos, "Unclosed array") + pos += 1 + + pos = skip_comments_and_array_ws(src, pos) + if src.startswith("]", pos): + return pos + 1, array + + +def parse_inline_table(src: str, pos: Pos, parse_float: ParseFloat) -> tuple[Pos, dict]: + pos += 1 + nested_dict = NestedDict() + flags = Flags() + + pos = skip_chars(src, pos, TOML_WS) + if src.startswith("}", pos): + return pos + 1, nested_dict.dict + while True: + pos, key, value = parse_key_value_pair(src, pos, parse_float) + key_parent, key_stem = key[:-1], key[-1] + if flags.is_(key, Flags.FROZEN): + raise suffixed_err(src, pos, f"Cannot mutate immutable namespace {key}") + try: + nest = nested_dict.get_or_create_nest(key_parent, access_lists=False) + except KeyError: + raise suffixed_err(src, pos, "Cannot overwrite a value") from None + if key_stem in nest: + raise suffixed_err(src, pos, f"Duplicate inline table key {key_stem!r}") + nest[key_stem] = value + pos = skip_chars(src, pos, TOML_WS) + c = src[pos : pos + 1] + if c == "}": + return pos + 1, nested_dict.dict + if c != ",": + raise suffixed_err(src, pos, "Unclosed inline table") + if isinstance(value, (dict, list)): + flags.set(key, Flags.FROZEN, recursive=True) + pos += 1 + pos = skip_chars(src, pos, TOML_WS) + + +def parse_basic_str_escape( + src: str, pos: Pos, *, multiline: bool = False +) -> tuple[Pos, str]: + escape_id = src[pos : pos + 2] + pos += 2 + if multiline and escape_id in {"\\ ", "\\\t", "\\\n"}: + # Skip whitespace until next non-whitespace character or end of + # the doc. Error if non-whitespace is found before newline. + if escape_id != "\\\n": + pos = skip_chars(src, pos, TOML_WS) + try: + char = src[pos] + except IndexError: + return pos, "" + if char != "\n": + raise suffixed_err(src, pos, "Unescaped '\\' in a string") + pos += 1 + pos = skip_chars(src, pos, TOML_WS_AND_NEWLINE) + return pos, "" + if escape_id == "\\u": + return parse_hex_char(src, pos, 4) + if escape_id == "\\U": + return parse_hex_char(src, pos, 8) + try: + return pos, BASIC_STR_ESCAPE_REPLACEMENTS[escape_id] + except KeyError: + raise suffixed_err(src, pos, "Unescaped '\\' in a string") from None + + +def parse_basic_str_escape_multiline(src: str, pos: Pos) -> tuple[Pos, str]: + return parse_basic_str_escape(src, pos, multiline=True) + + +def parse_hex_char(src: str, pos: Pos, hex_len: int) -> tuple[Pos, str]: + hex_str = src[pos : pos + hex_len] + if len(hex_str) != hex_len or not HEXDIGIT_CHARS.issuperset(hex_str): + raise suffixed_err(src, pos, "Invalid hex value") + pos += hex_len + hex_int = int(hex_str, 16) + if not is_unicode_scalar_value(hex_int): + raise suffixed_err(src, pos, "Escaped character is not a Unicode scalar value") + return pos, chr(hex_int) + + +def parse_literal_str(src: str, pos: Pos) -> tuple[Pos, str]: + pos += 1 # Skip starting apostrophe + start_pos = pos + pos = skip_until( + src, pos, "'", error_on=ILLEGAL_LITERAL_STR_CHARS, error_on_eof=True + ) + return pos + 1, src[start_pos:pos] # Skip ending apostrophe + + +def parse_multiline_str(src: str, pos: Pos, *, literal: bool) -> tuple[Pos, str]: + pos += 3 + if src.startswith("\n", pos): + pos += 1 + + if literal: + delim = "'" + end_pos = skip_until( + src, + pos, + "'''", + error_on=ILLEGAL_MULTILINE_LITERAL_STR_CHARS, + error_on_eof=True, + ) + result = src[pos:end_pos] + pos = end_pos + 3 + else: + delim = '"' + pos, result = parse_basic_str(src, pos, multiline=True) + + # Add at maximum two extra apostrophes/quotes if the end sequence + # is 4 or 5 chars long instead of just 3. + if not src.startswith(delim, pos): + return pos, result + pos += 1 + if not src.startswith(delim, pos): + return pos, result + delim + pos += 1 + return pos, result + (delim * 2) + + +def parse_basic_str(src: str, pos: Pos, *, multiline: bool) -> tuple[Pos, str]: + if multiline: + error_on = ILLEGAL_MULTILINE_BASIC_STR_CHARS + parse_escapes = parse_basic_str_escape_multiline + else: + error_on = ILLEGAL_BASIC_STR_CHARS + parse_escapes = parse_basic_str_escape + result = "" + start_pos = pos + while True: + try: + char = src[pos] + except IndexError: + raise suffixed_err(src, pos, "Unterminated string") from None + if char == '"': + if not multiline: + return pos + 1, result + src[start_pos:pos] + if src.startswith('"""', pos): + return pos + 3, result + src[start_pos:pos] + pos += 1 + continue + if char == "\\": + result += src[start_pos:pos] + pos, parsed_escape = parse_escapes(src, pos) + result += parsed_escape + start_pos = pos + continue + if char in error_on: + raise suffixed_err(src, pos, f"Illegal character {char!r}") + pos += 1 + + +def parse_value( # noqa: C901 + src: str, pos: Pos, parse_float: ParseFloat +) -> tuple[Pos, Any]: + try: + char: str | None = src[pos] + except IndexError: + char = None + + # IMPORTANT: order conditions based on speed of checking and likelihood + + # Basic strings + if char == '"': + if src.startswith('"""', pos): + return parse_multiline_str(src, pos, literal=False) + return parse_one_line_basic_str(src, pos) + + # Literal strings + if char == "'": + if src.startswith("'''", pos): + return parse_multiline_str(src, pos, literal=True) + return parse_literal_str(src, pos) + + # Booleans + if char == "t": + if src.startswith("true", pos): + return pos + 4, True + if char == "f": + if src.startswith("false", pos): + return pos + 5, False + + # Arrays + if char == "[": + return parse_array(src, pos, parse_float) + + # Inline tables + if char == "{": + return parse_inline_table(src, pos, parse_float) + + # Dates and times + datetime_match = RE_DATETIME.match(src, pos) + if datetime_match: + try: + datetime_obj = match_to_datetime(datetime_match) + except ValueError as e: + raise suffixed_err(src, pos, "Invalid date or datetime") from e + return datetime_match.end(), datetime_obj + localtime_match = RE_LOCALTIME.match(src, pos) + if localtime_match: + return localtime_match.end(), match_to_localtime(localtime_match) + + # Integers and "normal" floats. + # The regex will greedily match any type starting with a decimal + # char, so needs to be located after handling of dates and times. + number_match = RE_NUMBER.match(src, pos) + if number_match: + return number_match.end(), match_to_number(number_match, parse_float) + + # Special floats + first_three = src[pos : pos + 3] + if first_three in {"inf", "nan"}: + return pos + 3, parse_float(first_three) + first_four = src[pos : pos + 4] + if first_four in {"-inf", "+inf", "-nan", "+nan"}: + return pos + 4, parse_float(first_four) + + raise suffixed_err(src, pos, "Invalid value") + + +def suffixed_err(src: str, pos: Pos, msg: str) -> TOMLDecodeError: + """Return a `TOMLDecodeError` where error message is suffixed with + coordinates in source.""" + + def coord_repr(src: str, pos: Pos) -> str: + if pos >= len(src): + return "end of document" + line = src.count("\n", 0, pos) + 1 + if line == 1: + column = pos + 1 + else: + column = pos - src.rindex("\n", 0, pos) + return f"line {line}, column {column}" + + return TOMLDecodeError(f"{msg} (at {coord_repr(src, pos)})") + + +def is_unicode_scalar_value(codepoint: int) -> bool: + return (0 <= codepoint <= 55295) or (57344 <= codepoint <= 1114111) + + +def make_safe_parse_float(parse_float: ParseFloat) -> ParseFloat: + """A decorator to make `parse_float` safe. + + `parse_float` must not return dicts or lists, because these types + would be mixed with parsed TOML tables and arrays, thus confusing + the parser. The returned decorated callable raises `ValueError` + instead of returning illegal types. + """ + # The default `float` callable never returns illegal types. Optimize it. + if parse_float is float: # type: ignore[comparison-overlap] + return float + + def safe_parse_float(float_str: str) -> Any: + float_value = parse_float(float_str) + if isinstance(float_value, (dict, list)): + raise ValueError("parse_float must not return dicts or lists") + return float_value + + return safe_parse_float diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/_re.py b/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/_re.py new file mode 100644 index 0000000..994bb74 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/_re.py @@ -0,0 +1,107 @@ +# SPDX-License-Identifier: MIT +# SPDX-FileCopyrightText: 2021 Taneli Hukkinen +# Licensed to PSF under a Contributor Agreement. + +from __future__ import annotations + +from datetime import date, datetime, time, timedelta, timezone, tzinfo +from functools import lru_cache +import re +from typing import Any + +from ._types import ParseFloat + +# E.g. +# - 00:32:00.999999 +# - 00:32:00 +_TIME_RE_STR = r"([01][0-9]|2[0-3]):([0-5][0-9]):([0-5][0-9])(?:\.([0-9]{1,6})[0-9]*)?" + +RE_NUMBER = re.compile( + r""" +0 +(?: + x[0-9A-Fa-f](?:_?[0-9A-Fa-f])* # hex + | + b[01](?:_?[01])* # bin + | + o[0-7](?:_?[0-7])* # oct +) +| +[+-]?(?:0|[1-9](?:_?[0-9])*) # dec, integer part +(?P + (?:\.[0-9](?:_?[0-9])*)? # optional fractional part + (?:[eE][+-]?[0-9](?:_?[0-9])*)? # optional exponent part +) +""", + flags=re.VERBOSE, +) +RE_LOCALTIME = re.compile(_TIME_RE_STR) +RE_DATETIME = re.compile( + rf""" +([0-9]{{4}})-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01]) # date, e.g. 1988-10-27 +(?: + [Tt ] + {_TIME_RE_STR} + (?:([Zz])|([+-])([01][0-9]|2[0-3]):([0-5][0-9]))? # optional time offset +)? +""", + flags=re.VERBOSE, +) + + +def match_to_datetime(match: re.Match) -> datetime | date: + """Convert a `RE_DATETIME` match to `datetime.datetime` or `datetime.date`. + + Raises ValueError if the match does not correspond to a valid date + or datetime. + """ + ( + year_str, + month_str, + day_str, + hour_str, + minute_str, + sec_str, + micros_str, + zulu_time, + offset_sign_str, + offset_hour_str, + offset_minute_str, + ) = match.groups() + year, month, day = int(year_str), int(month_str), int(day_str) + if hour_str is None: + return date(year, month, day) + hour, minute, sec = int(hour_str), int(minute_str), int(sec_str) + micros = int(micros_str.ljust(6, "0")) if micros_str else 0 + if offset_sign_str: + tz: tzinfo | None = cached_tz( + offset_hour_str, offset_minute_str, offset_sign_str + ) + elif zulu_time: + tz = timezone.utc + else: # local date-time + tz = None + return datetime(year, month, day, hour, minute, sec, micros, tzinfo=tz) + + +@lru_cache(maxsize=None) +def cached_tz(hour_str: str, minute_str: str, sign_str: str) -> timezone: + sign = 1 if sign_str == "+" else -1 + return timezone( + timedelta( + hours=sign * int(hour_str), + minutes=sign * int(minute_str), + ) + ) + + +def match_to_localtime(match: re.Match) -> time: + hour_str, minute_str, sec_str, micros_str = match.groups() + micros = int(micros_str.ljust(6, "0")) if micros_str else 0 + return time(int(hour_str), int(minute_str), int(sec_str), micros) + + +def match_to_number(match: re.Match, parse_float: ParseFloat) -> Any: + if match.group("floatpart"): + return parse_float(match.group()) + return int(match.group(), 0) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/_types.py b/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/_types.py new file mode 100644 index 0000000..d949412 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/_types.py @@ -0,0 +1,10 @@ +# SPDX-License-Identifier: MIT +# SPDX-FileCopyrightText: 2021 Taneli Hukkinen +# Licensed to PSF under a Contributor Agreement. + +from typing import Any, Callable, Tuple + +# Type annotations +ParseFloat = Callable[[str], Any] +Key = Tuple[str, ...] +Pos = int diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/py.typed b/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/py.typed new file mode 100644 index 0000000..7632ecf --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/tomli/py.typed @@ -0,0 +1 @@ +# Marker file for PEP 561 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/__init__.py b/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/__init__.py new file mode 100644 index 0000000..8636814 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/__init__.py @@ -0,0 +1,13 @@ +"""Verify certificates using native system trust stores""" + +import sys as _sys + +if _sys.version_info < (3, 10): + raise ImportError("truststore requires Python 3.10 or later") + +from ._api import SSLContext, extract_from_ssl, inject_into_ssl # noqa: E402 + +del _api, _sys # type: ignore[name-defined] # noqa: F821 + +__all__ = ["SSLContext", "inject_into_ssl", "extract_from_ssl"] +__version__ = "0.9.1" diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..0b6415abc1603952ba4c9d6c152ad5ce7a0cafe6 GIT binary patch literal 618 zcmYLFzi-qq6n1{xCCyPl)s+!>U?2nM7FehdM}-)W0D&qoq=QLg-<{he4$r=WbOI(u zBnEai)IWu#g#ntWq64}O)U6Zt!KrU}etti`_kHin;$no1{du}K_~0OPY(I1J{s$*p zCisXLN)U6Hn>&fi-R<_g?d)aVj*Ae4F5*7(_Y9u3w+?HucHS!5NxKM=pa_%DL7S~j zcZgW<$w?Mim_)T3FYMlY#z72foN>@%AhJ|*g~v*iLtLg>OgL7x(!9VL#!6$QC2%#h zOCHDW)bgELIlEV9^;sDMe=!!O4L_;%NS63UZ*>Jrz_|g3spS}ZO|-G`@SZF+f2Es? z#zC5CIsjQvrSj&2D7U#uh*C?Nh&{0CA+#>A3tKC_TfNn|(*%?(5O% zC?QKTKafr5K~YK2_W>lBhO`p@z%0%T(PE@|ZZJBO&PVBIbYdFN>2orY1t(B(4RRu~ z5y>RumGRB_bZ^>e0Sw%)PEiPIKTX+150N7FPc)c+5i9m literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/__pycache__/_api.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/__pycache__/_api.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..8a0a80c9b6f402442803778bc554f785d3785306 GIT binary patch literal 16541 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/__pycache__/_macos.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/__pycache__/_macos.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a3bfe5071e6ed80e1218af0b6018d3e03f1f5df1 GIT binary patch literal 16577 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 S@VgpqD_q^9YP827y?+CdNfn|1 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/bindings.py b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/bindings.py new file mode 100644 index 0000000..264d564 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/bindings.py @@ -0,0 +1,519 @@ +""" +This module uses ctypes to bind a whole bunch of functions and constants from +SecureTransport. The goal here is to provide the low-level API to +SecureTransport. These are essentially the C-level functions and constants, and +they're pretty gross to work with. + +This code is a bastardised version of the code found in Will Bond's oscrypto +library. An enormous debt is owed to him for blazing this trail for us. For +that reason, this code should be considered to be covered both by urllib3's +license and by oscrypto's: + + Copyright (c) 2015-2016 Will Bond + + Permission is hereby granted, free of charge, to any person obtaining a + copy of this software and associated documentation files (the "Software"), + to deal in the Software without restriction, including without limitation + the rights to use, copy, modify, merge, publish, distribute, sublicense, + and/or sell copies of the Software, and to permit persons to whom the + Software is furnished to do so, subject to the following conditions: + + The above copyright notice and this permission notice shall be included in + all copies or substantial portions of the Software. + + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING + FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER + DEALINGS IN THE SOFTWARE. +""" +from __future__ import absolute_import + +import platform +from ctypes import ( + CDLL, + CFUNCTYPE, + POINTER, + c_bool, + c_byte, + c_char_p, + c_int32, + c_long, + c_size_t, + c_uint32, + c_ulong, + c_void_p, +) +from ctypes.util import find_library + +from ...packages.six import raise_from + +if platform.system() != "Darwin": + raise ImportError("Only macOS is supported") + +version = platform.mac_ver()[0] +version_info = tuple(map(int, version.split("."))) +if version_info < (10, 8): + raise OSError( + "Only OS X 10.8 and newer are supported, not %s.%s" + % (version_info[0], version_info[1]) + ) + + +def load_cdll(name, macos10_16_path): + """Loads a CDLL by name, falling back to known path on 10.16+""" + try: + # Big Sur is technically 11 but we use 10.16 due to the Big Sur + # beta being labeled as 10.16. + if version_info >= (10, 16): + path = macos10_16_path + else: + path = find_library(name) + if not path: + raise OSError # Caught and reraised as 'ImportError' + return CDLL(path, use_errno=True) + except OSError: + raise_from(ImportError("The library %s failed to load" % name), None) + + +Security = load_cdll( + "Security", "/System/Library/Frameworks/Security.framework/Security" +) +CoreFoundation = load_cdll( + "CoreFoundation", + "/System/Library/Frameworks/CoreFoundation.framework/CoreFoundation", +) + + +Boolean = c_bool +CFIndex = c_long +CFStringEncoding = c_uint32 +CFData = c_void_p +CFString = c_void_p +CFArray = c_void_p +CFMutableArray = c_void_p +CFDictionary = c_void_p +CFError = c_void_p +CFType = c_void_p +CFTypeID = c_ulong + +CFTypeRef = POINTER(CFType) +CFAllocatorRef = c_void_p + +OSStatus = c_int32 + +CFDataRef = POINTER(CFData) +CFStringRef = POINTER(CFString) +CFArrayRef = POINTER(CFArray) +CFMutableArrayRef = POINTER(CFMutableArray) +CFDictionaryRef = POINTER(CFDictionary) +CFArrayCallBacks = c_void_p +CFDictionaryKeyCallBacks = c_void_p +CFDictionaryValueCallBacks = c_void_p + +SecCertificateRef = POINTER(c_void_p) +SecExternalFormat = c_uint32 +SecExternalItemType = c_uint32 +SecIdentityRef = POINTER(c_void_p) +SecItemImportExportFlags = c_uint32 +SecItemImportExportKeyParameters = c_void_p +SecKeychainRef = POINTER(c_void_p) +SSLProtocol = c_uint32 +SSLCipherSuite = c_uint32 +SSLContextRef = POINTER(c_void_p) +SecTrustRef = POINTER(c_void_p) +SSLConnectionRef = c_uint32 +SecTrustResultType = c_uint32 +SecTrustOptionFlags = c_uint32 +SSLProtocolSide = c_uint32 +SSLConnectionType = c_uint32 +SSLSessionOption = c_uint32 + + +try: + Security.SecItemImport.argtypes = [ + CFDataRef, + CFStringRef, + POINTER(SecExternalFormat), + POINTER(SecExternalItemType), + SecItemImportExportFlags, + POINTER(SecItemImportExportKeyParameters), + SecKeychainRef, + POINTER(CFArrayRef), + ] + Security.SecItemImport.restype = OSStatus + + Security.SecCertificateGetTypeID.argtypes = [] + Security.SecCertificateGetTypeID.restype = CFTypeID + + Security.SecIdentityGetTypeID.argtypes = [] + Security.SecIdentityGetTypeID.restype = CFTypeID + + Security.SecKeyGetTypeID.argtypes = [] + Security.SecKeyGetTypeID.restype = CFTypeID + + Security.SecCertificateCreateWithData.argtypes = [CFAllocatorRef, CFDataRef] + Security.SecCertificateCreateWithData.restype = SecCertificateRef + + Security.SecCertificateCopyData.argtypes = [SecCertificateRef] + Security.SecCertificateCopyData.restype = CFDataRef + + Security.SecCopyErrorMessageString.argtypes = [OSStatus, c_void_p] + Security.SecCopyErrorMessageString.restype = CFStringRef + + Security.SecIdentityCreateWithCertificate.argtypes = [ + CFTypeRef, + SecCertificateRef, + POINTER(SecIdentityRef), + ] + Security.SecIdentityCreateWithCertificate.restype = OSStatus + + Security.SecKeychainCreate.argtypes = [ + c_char_p, + c_uint32, + c_void_p, + Boolean, + c_void_p, + POINTER(SecKeychainRef), + ] + Security.SecKeychainCreate.restype = OSStatus + + Security.SecKeychainDelete.argtypes = [SecKeychainRef] + Security.SecKeychainDelete.restype = OSStatus + + Security.SecPKCS12Import.argtypes = [ + CFDataRef, + CFDictionaryRef, + POINTER(CFArrayRef), + ] + Security.SecPKCS12Import.restype = OSStatus + + SSLReadFunc = CFUNCTYPE(OSStatus, SSLConnectionRef, c_void_p, POINTER(c_size_t)) + SSLWriteFunc = CFUNCTYPE( + OSStatus, SSLConnectionRef, POINTER(c_byte), POINTER(c_size_t) + ) + + Security.SSLSetIOFuncs.argtypes = [SSLContextRef, SSLReadFunc, SSLWriteFunc] + Security.SSLSetIOFuncs.restype = OSStatus + + Security.SSLSetPeerID.argtypes = [SSLContextRef, c_char_p, c_size_t] + Security.SSLSetPeerID.restype = OSStatus + + Security.SSLSetCertificate.argtypes = [SSLContextRef, CFArrayRef] + Security.SSLSetCertificate.restype = OSStatus + + Security.SSLSetCertificateAuthorities.argtypes = [SSLContextRef, CFTypeRef, Boolean] + Security.SSLSetCertificateAuthorities.restype = OSStatus + + Security.SSLSetConnection.argtypes = [SSLContextRef, SSLConnectionRef] + Security.SSLSetConnection.restype = OSStatus + + Security.SSLSetPeerDomainName.argtypes = [SSLContextRef, c_char_p, c_size_t] + Security.SSLSetPeerDomainName.restype = OSStatus + + Security.SSLHandshake.argtypes = [SSLContextRef] + Security.SSLHandshake.restype = OSStatus + + Security.SSLRead.argtypes = [SSLContextRef, c_char_p, c_size_t, POINTER(c_size_t)] + Security.SSLRead.restype = OSStatus + + Security.SSLWrite.argtypes = [SSLContextRef, c_char_p, c_size_t, POINTER(c_size_t)] + Security.SSLWrite.restype = OSStatus + + Security.SSLClose.argtypes = [SSLContextRef] + Security.SSLClose.restype = OSStatus + + Security.SSLGetNumberSupportedCiphers.argtypes = [SSLContextRef, POINTER(c_size_t)] + Security.SSLGetNumberSupportedCiphers.restype = OSStatus + + Security.SSLGetSupportedCiphers.argtypes = [ + SSLContextRef, + POINTER(SSLCipherSuite), + POINTER(c_size_t), + ] + Security.SSLGetSupportedCiphers.restype = OSStatus + + Security.SSLSetEnabledCiphers.argtypes = [ + SSLContextRef, + POINTER(SSLCipherSuite), + c_size_t, + ] + Security.SSLSetEnabledCiphers.restype = OSStatus + + Security.SSLGetNumberEnabledCiphers.argtype = [SSLContextRef, POINTER(c_size_t)] + Security.SSLGetNumberEnabledCiphers.restype = OSStatus + + Security.SSLGetEnabledCiphers.argtypes = [ + SSLContextRef, + POINTER(SSLCipherSuite), + POINTER(c_size_t), + ] + Security.SSLGetEnabledCiphers.restype = OSStatus + + Security.SSLGetNegotiatedCipher.argtypes = [SSLContextRef, POINTER(SSLCipherSuite)] + Security.SSLGetNegotiatedCipher.restype = OSStatus + + Security.SSLGetNegotiatedProtocolVersion.argtypes = [ + SSLContextRef, + POINTER(SSLProtocol), + ] + Security.SSLGetNegotiatedProtocolVersion.restype = OSStatus + + Security.SSLCopyPeerTrust.argtypes = [SSLContextRef, POINTER(SecTrustRef)] + Security.SSLCopyPeerTrust.restype = OSStatus + + Security.SecTrustSetAnchorCertificates.argtypes = [SecTrustRef, CFArrayRef] + Security.SecTrustSetAnchorCertificates.restype = OSStatus + + Security.SecTrustSetAnchorCertificatesOnly.argstypes = [SecTrustRef, Boolean] + Security.SecTrustSetAnchorCertificatesOnly.restype = OSStatus + + Security.SecTrustEvaluate.argtypes = [SecTrustRef, POINTER(SecTrustResultType)] + Security.SecTrustEvaluate.restype = OSStatus + + Security.SecTrustGetCertificateCount.argtypes = [SecTrustRef] + Security.SecTrustGetCertificateCount.restype = CFIndex + + Security.SecTrustGetCertificateAtIndex.argtypes = [SecTrustRef, CFIndex] + Security.SecTrustGetCertificateAtIndex.restype = SecCertificateRef + + Security.SSLCreateContext.argtypes = [ + CFAllocatorRef, + SSLProtocolSide, + SSLConnectionType, + ] + Security.SSLCreateContext.restype = SSLContextRef + + Security.SSLSetSessionOption.argtypes = [SSLContextRef, SSLSessionOption, Boolean] + Security.SSLSetSessionOption.restype = OSStatus + + Security.SSLSetProtocolVersionMin.argtypes = [SSLContextRef, SSLProtocol] + Security.SSLSetProtocolVersionMin.restype = OSStatus + + Security.SSLSetProtocolVersionMax.argtypes = [SSLContextRef, SSLProtocol] + Security.SSLSetProtocolVersionMax.restype = OSStatus + + try: + Security.SSLSetALPNProtocols.argtypes = [SSLContextRef, CFArrayRef] + Security.SSLSetALPNProtocols.restype = OSStatus + except AttributeError: + # Supported only in 10.12+ + pass + + Security.SecCopyErrorMessageString.argtypes = [OSStatus, c_void_p] + Security.SecCopyErrorMessageString.restype = CFStringRef + + Security.SSLReadFunc = SSLReadFunc + Security.SSLWriteFunc = SSLWriteFunc + Security.SSLContextRef = SSLContextRef + Security.SSLProtocol = SSLProtocol + Security.SSLCipherSuite = SSLCipherSuite + Security.SecIdentityRef = SecIdentityRef + Security.SecKeychainRef = SecKeychainRef + Security.SecTrustRef = SecTrustRef + Security.SecTrustResultType = SecTrustResultType + Security.SecExternalFormat = SecExternalFormat + Security.OSStatus = OSStatus + + Security.kSecImportExportPassphrase = CFStringRef.in_dll( + Security, "kSecImportExportPassphrase" + ) + Security.kSecImportItemIdentity = CFStringRef.in_dll( + Security, "kSecImportItemIdentity" + ) + + # CoreFoundation time! + CoreFoundation.CFRetain.argtypes = [CFTypeRef] + CoreFoundation.CFRetain.restype = CFTypeRef + + CoreFoundation.CFRelease.argtypes = [CFTypeRef] + CoreFoundation.CFRelease.restype = None + + CoreFoundation.CFGetTypeID.argtypes = [CFTypeRef] + CoreFoundation.CFGetTypeID.restype = CFTypeID + + CoreFoundation.CFStringCreateWithCString.argtypes = [ + CFAllocatorRef, + c_char_p, + CFStringEncoding, + ] + CoreFoundation.CFStringCreateWithCString.restype = CFStringRef + + CoreFoundation.CFStringGetCStringPtr.argtypes = [CFStringRef, CFStringEncoding] + CoreFoundation.CFStringGetCStringPtr.restype = c_char_p + + CoreFoundation.CFStringGetCString.argtypes = [ + CFStringRef, + c_char_p, + CFIndex, + CFStringEncoding, + ] + CoreFoundation.CFStringGetCString.restype = c_bool + + CoreFoundation.CFDataCreate.argtypes = [CFAllocatorRef, c_char_p, CFIndex] + CoreFoundation.CFDataCreate.restype = CFDataRef + + CoreFoundation.CFDataGetLength.argtypes = [CFDataRef] + CoreFoundation.CFDataGetLength.restype = CFIndex + + CoreFoundation.CFDataGetBytePtr.argtypes = [CFDataRef] + CoreFoundation.CFDataGetBytePtr.restype = c_void_p + + CoreFoundation.CFDictionaryCreate.argtypes = [ + CFAllocatorRef, + POINTER(CFTypeRef), + POINTER(CFTypeRef), + CFIndex, + CFDictionaryKeyCallBacks, + CFDictionaryValueCallBacks, + ] + CoreFoundation.CFDictionaryCreate.restype = CFDictionaryRef + + CoreFoundation.CFDictionaryGetValue.argtypes = [CFDictionaryRef, CFTypeRef] + CoreFoundation.CFDictionaryGetValue.restype = CFTypeRef + + CoreFoundation.CFArrayCreate.argtypes = [ + CFAllocatorRef, + POINTER(CFTypeRef), + CFIndex, + CFArrayCallBacks, + ] + CoreFoundation.CFArrayCreate.restype = CFArrayRef + + CoreFoundation.CFArrayCreateMutable.argtypes = [ + CFAllocatorRef, + CFIndex, + CFArrayCallBacks, + ] + CoreFoundation.CFArrayCreateMutable.restype = CFMutableArrayRef + + CoreFoundation.CFArrayAppendValue.argtypes = [CFMutableArrayRef, c_void_p] + CoreFoundation.CFArrayAppendValue.restype = None + + CoreFoundation.CFArrayGetCount.argtypes = [CFArrayRef] + CoreFoundation.CFArrayGetCount.restype = CFIndex + + CoreFoundation.CFArrayGetValueAtIndex.argtypes = [CFArrayRef, CFIndex] + CoreFoundation.CFArrayGetValueAtIndex.restype = c_void_p + + CoreFoundation.kCFAllocatorDefault = CFAllocatorRef.in_dll( + CoreFoundation, "kCFAllocatorDefault" + ) + CoreFoundation.kCFTypeArrayCallBacks = c_void_p.in_dll( + CoreFoundation, "kCFTypeArrayCallBacks" + ) + CoreFoundation.kCFTypeDictionaryKeyCallBacks = c_void_p.in_dll( + CoreFoundation, "kCFTypeDictionaryKeyCallBacks" + ) + CoreFoundation.kCFTypeDictionaryValueCallBacks = c_void_p.in_dll( + CoreFoundation, "kCFTypeDictionaryValueCallBacks" + ) + + CoreFoundation.CFTypeRef = CFTypeRef + CoreFoundation.CFArrayRef = CFArrayRef + CoreFoundation.CFStringRef = CFStringRef + CoreFoundation.CFDictionaryRef = CFDictionaryRef + +except (AttributeError): + raise ImportError("Error initializing ctypes") + + +class CFConst(object): + """ + A class object that acts as essentially a namespace for CoreFoundation + constants. + """ + + kCFStringEncodingUTF8 = CFStringEncoding(0x08000100) + + +class SecurityConst(object): + """ + A class object that acts as essentially a namespace for Security constants. + """ + + kSSLSessionOptionBreakOnServerAuth = 0 + + kSSLProtocol2 = 1 + kSSLProtocol3 = 2 + kTLSProtocol1 = 4 + kTLSProtocol11 = 7 + kTLSProtocol12 = 8 + # SecureTransport does not support TLS 1.3 even if there's a constant for it + kTLSProtocol13 = 10 + kTLSProtocolMaxSupported = 999 + + kSSLClientSide = 1 + kSSLStreamType = 0 + + kSecFormatPEMSequence = 10 + + kSecTrustResultInvalid = 0 + kSecTrustResultProceed = 1 + # This gap is present on purpose: this was kSecTrustResultConfirm, which + # is deprecated. + kSecTrustResultDeny = 3 + kSecTrustResultUnspecified = 4 + kSecTrustResultRecoverableTrustFailure = 5 + kSecTrustResultFatalTrustFailure = 6 + kSecTrustResultOtherError = 7 + + errSSLProtocol = -9800 + errSSLWouldBlock = -9803 + errSSLClosedGraceful = -9805 + errSSLClosedNoNotify = -9816 + errSSLClosedAbort = -9806 + + errSSLXCertChainInvalid = -9807 + errSSLCrypto = -9809 + errSSLInternal = -9810 + errSSLCertExpired = -9814 + errSSLCertNotYetValid = -9815 + errSSLUnknownRootCert = -9812 + errSSLNoRootCert = -9813 + errSSLHostNameMismatch = -9843 + errSSLPeerHandshakeFail = -9824 + errSSLPeerUserCancelled = -9839 + errSSLWeakPeerEphemeralDHKey = -9850 + errSSLServerAuthCompleted = -9841 + errSSLRecordOverflow = -9847 + + errSecVerifyFailed = -67808 + errSecNoTrustSettings = -25263 + errSecItemNotFound = -25300 + errSecInvalidTrustSettings = -25262 + + # Cipher suites. We only pick the ones our default cipher string allows. + # Source: https://developer.apple.com/documentation/security/1550981-ssl_cipher_suite_values + TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 = 0xC02C + TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 = 0xC030 + TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 = 0xC02B + TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 = 0xC02F + TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256 = 0xCCA9 + TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256 = 0xCCA8 + TLS_DHE_RSA_WITH_AES_256_GCM_SHA384 = 0x009F + TLS_DHE_RSA_WITH_AES_128_GCM_SHA256 = 0x009E + TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384 = 0xC024 + TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 = 0xC028 + TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA = 0xC00A + TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA = 0xC014 + TLS_DHE_RSA_WITH_AES_256_CBC_SHA256 = 0x006B + TLS_DHE_RSA_WITH_AES_256_CBC_SHA = 0x0039 + TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 = 0xC023 + TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 = 0xC027 + TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA = 0xC009 + TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA = 0xC013 + TLS_DHE_RSA_WITH_AES_128_CBC_SHA256 = 0x0067 + TLS_DHE_RSA_WITH_AES_128_CBC_SHA = 0x0033 + TLS_RSA_WITH_AES_256_GCM_SHA384 = 0x009D + TLS_RSA_WITH_AES_128_GCM_SHA256 = 0x009C + TLS_RSA_WITH_AES_256_CBC_SHA256 = 0x003D + TLS_RSA_WITH_AES_128_CBC_SHA256 = 0x003C + TLS_RSA_WITH_AES_256_CBC_SHA = 0x0035 + TLS_RSA_WITH_AES_128_CBC_SHA = 0x002F + TLS_AES_128_GCM_SHA256 = 0x1301 + TLS_AES_256_GCM_SHA384 = 0x1302 + TLS_AES_128_CCM_8_SHA256 = 0x1305 + TLS_AES_128_CCM_SHA256 = 0x1304 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/low_level.py b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/low_level.py new file mode 100644 index 0000000..fa0b245 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/low_level.py @@ -0,0 +1,397 @@ +""" +Low-level helpers for the SecureTransport bindings. + +These are Python functions that are not directly related to the high-level APIs +but are necessary to get them to work. They include a whole bunch of low-level +CoreFoundation messing about and memory management. The concerns in this module +are almost entirely about trying to avoid memory leaks and providing +appropriate and useful assistance to the higher-level code. +""" +import base64 +import ctypes +import itertools +import os +import re +import ssl +import struct +import tempfile + +from .bindings import CFConst, CoreFoundation, Security + +# This regular expression is used to grab PEM data out of a PEM bundle. +_PEM_CERTS_RE = re.compile( + b"-----BEGIN CERTIFICATE-----\n(.*?)\n-----END CERTIFICATE-----", re.DOTALL +) + + +def _cf_data_from_bytes(bytestring): + """ + Given a bytestring, create a CFData object from it. This CFData object must + be CFReleased by the caller. + """ + return CoreFoundation.CFDataCreate( + CoreFoundation.kCFAllocatorDefault, bytestring, len(bytestring) + ) + + +def _cf_dictionary_from_tuples(tuples): + """ + Given a list of Python tuples, create an associated CFDictionary. + """ + dictionary_size = len(tuples) + + # We need to get the dictionary keys and values out in the same order. + keys = (t[0] for t in tuples) + values = (t[1] for t in tuples) + cf_keys = (CoreFoundation.CFTypeRef * dictionary_size)(*keys) + cf_values = (CoreFoundation.CFTypeRef * dictionary_size)(*values) + + return CoreFoundation.CFDictionaryCreate( + CoreFoundation.kCFAllocatorDefault, + cf_keys, + cf_values, + dictionary_size, + CoreFoundation.kCFTypeDictionaryKeyCallBacks, + CoreFoundation.kCFTypeDictionaryValueCallBacks, + ) + + +def _cfstr(py_bstr): + """ + Given a Python binary data, create a CFString. + The string must be CFReleased by the caller. + """ + c_str = ctypes.c_char_p(py_bstr) + cf_str = CoreFoundation.CFStringCreateWithCString( + CoreFoundation.kCFAllocatorDefault, + c_str, + CFConst.kCFStringEncodingUTF8, + ) + return cf_str + + +def _create_cfstring_array(lst): + """ + Given a list of Python binary data, create an associated CFMutableArray. + The array must be CFReleased by the caller. + + Raises an ssl.SSLError on failure. + """ + cf_arr = None + try: + cf_arr = CoreFoundation.CFArrayCreateMutable( + CoreFoundation.kCFAllocatorDefault, + 0, + ctypes.byref(CoreFoundation.kCFTypeArrayCallBacks), + ) + if not cf_arr: + raise MemoryError("Unable to allocate memory!") + for item in lst: + cf_str = _cfstr(item) + if not cf_str: + raise MemoryError("Unable to allocate memory!") + try: + CoreFoundation.CFArrayAppendValue(cf_arr, cf_str) + finally: + CoreFoundation.CFRelease(cf_str) + except BaseException as e: + if cf_arr: + CoreFoundation.CFRelease(cf_arr) + raise ssl.SSLError("Unable to allocate array: %s" % (e,)) + return cf_arr + + +def _cf_string_to_unicode(value): + """ + Creates a Unicode string from a CFString object. Used entirely for error + reporting. + + Yes, it annoys me quite a lot that this function is this complex. + """ + value_as_void_p = ctypes.cast(value, ctypes.POINTER(ctypes.c_void_p)) + + string = CoreFoundation.CFStringGetCStringPtr( + value_as_void_p, CFConst.kCFStringEncodingUTF8 + ) + if string is None: + buffer = ctypes.create_string_buffer(1024) + result = CoreFoundation.CFStringGetCString( + value_as_void_p, buffer, 1024, CFConst.kCFStringEncodingUTF8 + ) + if not result: + raise OSError("Error copying C string from CFStringRef") + string = buffer.value + if string is not None: + string = string.decode("utf-8") + return string + + +def _assert_no_error(error, exception_class=None): + """ + Checks the return code and throws an exception if there is an error to + report + """ + if error == 0: + return + + cf_error_string = Security.SecCopyErrorMessageString(error, None) + output = _cf_string_to_unicode(cf_error_string) + CoreFoundation.CFRelease(cf_error_string) + + if output is None or output == u"": + output = u"OSStatus %s" % error + + if exception_class is None: + exception_class = ssl.SSLError + + raise exception_class(output) + + +def _cert_array_from_pem(pem_bundle): + """ + Given a bundle of certs in PEM format, turns them into a CFArray of certs + that can be used to validate a cert chain. + """ + # Normalize the PEM bundle's line endings. + pem_bundle = pem_bundle.replace(b"\r\n", b"\n") + + der_certs = [ + base64.b64decode(match.group(1)) for match in _PEM_CERTS_RE.finditer(pem_bundle) + ] + if not der_certs: + raise ssl.SSLError("No root certificates specified") + + cert_array = CoreFoundation.CFArrayCreateMutable( + CoreFoundation.kCFAllocatorDefault, + 0, + ctypes.byref(CoreFoundation.kCFTypeArrayCallBacks), + ) + if not cert_array: + raise ssl.SSLError("Unable to allocate memory!") + + try: + for der_bytes in der_certs: + certdata = _cf_data_from_bytes(der_bytes) + if not certdata: + raise ssl.SSLError("Unable to allocate memory!") + cert = Security.SecCertificateCreateWithData( + CoreFoundation.kCFAllocatorDefault, certdata + ) + CoreFoundation.CFRelease(certdata) + if not cert: + raise ssl.SSLError("Unable to build cert object!") + + CoreFoundation.CFArrayAppendValue(cert_array, cert) + CoreFoundation.CFRelease(cert) + except Exception: + # We need to free the array before the exception bubbles further. + # We only want to do that if an error occurs: otherwise, the caller + # should free. + CoreFoundation.CFRelease(cert_array) + raise + + return cert_array + + +def _is_cert(item): + """ + Returns True if a given CFTypeRef is a certificate. + """ + expected = Security.SecCertificateGetTypeID() + return CoreFoundation.CFGetTypeID(item) == expected + + +def _is_identity(item): + """ + Returns True if a given CFTypeRef is an identity. + """ + expected = Security.SecIdentityGetTypeID() + return CoreFoundation.CFGetTypeID(item) == expected + + +def _temporary_keychain(): + """ + This function creates a temporary Mac keychain that we can use to work with + credentials. This keychain uses a one-time password and a temporary file to + store the data. We expect to have one keychain per socket. The returned + SecKeychainRef must be freed by the caller, including calling + SecKeychainDelete. + + Returns a tuple of the SecKeychainRef and the path to the temporary + directory that contains it. + """ + # Unfortunately, SecKeychainCreate requires a path to a keychain. This + # means we cannot use mkstemp to use a generic temporary file. Instead, + # we're going to create a temporary directory and a filename to use there. + # This filename will be 8 random bytes expanded into base64. We also need + # some random bytes to password-protect the keychain we're creating, so we + # ask for 40 random bytes. + random_bytes = os.urandom(40) + filename = base64.b16encode(random_bytes[:8]).decode("utf-8") + password = base64.b16encode(random_bytes[8:]) # Must be valid UTF-8 + tempdirectory = tempfile.mkdtemp() + + keychain_path = os.path.join(tempdirectory, filename).encode("utf-8") + + # We now want to create the keychain itself. + keychain = Security.SecKeychainRef() + status = Security.SecKeychainCreate( + keychain_path, len(password), password, False, None, ctypes.byref(keychain) + ) + _assert_no_error(status) + + # Having created the keychain, we want to pass it off to the caller. + return keychain, tempdirectory + + +def _load_items_from_file(keychain, path): + """ + Given a single file, loads all the trust objects from it into arrays and + the keychain. + Returns a tuple of lists: the first list is a list of identities, the + second a list of certs. + """ + certificates = [] + identities = [] + result_array = None + + with open(path, "rb") as f: + raw_filedata = f.read() + + try: + filedata = CoreFoundation.CFDataCreate( + CoreFoundation.kCFAllocatorDefault, raw_filedata, len(raw_filedata) + ) + result_array = CoreFoundation.CFArrayRef() + result = Security.SecItemImport( + filedata, # cert data + None, # Filename, leaving it out for now + None, # What the type of the file is, we don't care + None, # what's in the file, we don't care + 0, # import flags + None, # key params, can include passphrase in the future + keychain, # The keychain to insert into + ctypes.byref(result_array), # Results + ) + _assert_no_error(result) + + # A CFArray is not very useful to us as an intermediary + # representation, so we are going to extract the objects we want + # and then free the array. We don't need to keep hold of keys: the + # keychain already has them! + result_count = CoreFoundation.CFArrayGetCount(result_array) + for index in range(result_count): + item = CoreFoundation.CFArrayGetValueAtIndex(result_array, index) + item = ctypes.cast(item, CoreFoundation.CFTypeRef) + + if _is_cert(item): + CoreFoundation.CFRetain(item) + certificates.append(item) + elif _is_identity(item): + CoreFoundation.CFRetain(item) + identities.append(item) + finally: + if result_array: + CoreFoundation.CFRelease(result_array) + + CoreFoundation.CFRelease(filedata) + + return (identities, certificates) + + +def _load_client_cert_chain(keychain, *paths): + """ + Load certificates and maybe keys from a number of files. Has the end goal + of returning a CFArray containing one SecIdentityRef, and then zero or more + SecCertificateRef objects, suitable for use as a client certificate trust + chain. + """ + # Ok, the strategy. + # + # This relies on knowing that macOS will not give you a SecIdentityRef + # unless you have imported a key into a keychain. This is a somewhat + # artificial limitation of macOS (for example, it doesn't necessarily + # affect iOS), but there is nothing inside Security.framework that lets you + # get a SecIdentityRef without having a key in a keychain. + # + # So the policy here is we take all the files and iterate them in order. + # Each one will use SecItemImport to have one or more objects loaded from + # it. We will also point at a keychain that macOS can use to work with the + # private key. + # + # Once we have all the objects, we'll check what we actually have. If we + # already have a SecIdentityRef in hand, fab: we'll use that. Otherwise, + # we'll take the first certificate (which we assume to be our leaf) and + # ask the keychain to give us a SecIdentityRef with that cert's associated + # key. + # + # We'll then return a CFArray containing the trust chain: one + # SecIdentityRef and then zero-or-more SecCertificateRef objects. The + # responsibility for freeing this CFArray will be with the caller. This + # CFArray must remain alive for the entire connection, so in practice it + # will be stored with a single SSLSocket, along with the reference to the + # keychain. + certificates = [] + identities = [] + + # Filter out bad paths. + paths = (path for path in paths if path) + + try: + for file_path in paths: + new_identities, new_certs = _load_items_from_file(keychain, file_path) + identities.extend(new_identities) + certificates.extend(new_certs) + + # Ok, we have everything. The question is: do we have an identity? If + # not, we want to grab one from the first cert we have. + if not identities: + new_identity = Security.SecIdentityRef() + status = Security.SecIdentityCreateWithCertificate( + keychain, certificates[0], ctypes.byref(new_identity) + ) + _assert_no_error(status) + identities.append(new_identity) + + # We now want to release the original certificate, as we no longer + # need it. + CoreFoundation.CFRelease(certificates.pop(0)) + + # We now need to build a new CFArray that holds the trust chain. + trust_chain = CoreFoundation.CFArrayCreateMutable( + CoreFoundation.kCFAllocatorDefault, + 0, + ctypes.byref(CoreFoundation.kCFTypeArrayCallBacks), + ) + for item in itertools.chain(identities, certificates): + # ArrayAppendValue does a CFRetain on the item. That's fine, + # because the finally block will release our other refs to them. + CoreFoundation.CFArrayAppendValue(trust_chain, item) + + return trust_chain + finally: + for obj in itertools.chain(identities, certificates): + CoreFoundation.CFRelease(obj) + + +TLS_PROTOCOL_VERSIONS = { + "SSLv2": (0, 2), + "SSLv3": (3, 0), + "TLSv1": (3, 1), + "TLSv1.1": (3, 2), + "TLSv1.2": (3, 3), +} + + +def _build_tls_unknown_ca_alert(version): + """ + Builds a TLS alert record for an unknown CA. + """ + ver_maj, ver_min = TLS_PROTOCOL_VERSIONS[version] + severity_fatal = 0x02 + description_unknown_ca = 0x30 + msg = struct.pack(">BB", severity_fatal, description_unknown_ca) + msg_len = len(msg) + record_type_alert = 0x15 + record = struct.pack(">BBBH", record_type_alert, ver_maj, ver_min, msg_len) + msg + return record diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/appengine.py b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/appengine.py new file mode 100644 index 0000000..1717ee2 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/appengine.py @@ -0,0 +1,314 @@ +""" +This module provides a pool manager that uses Google App Engine's +`URLFetch Service `_. + +Example usage:: + + from pip._vendor.urllib3 import PoolManager + from pip._vendor.urllib3.contrib.appengine import AppEngineManager, is_appengine_sandbox + + if is_appengine_sandbox(): + # AppEngineManager uses AppEngine's URLFetch API behind the scenes + http = AppEngineManager() + else: + # PoolManager uses a socket-level API behind the scenes + http = PoolManager() + + r = http.request('GET', 'https://google.com/') + +There are `limitations `_ to the URLFetch service and it may not be +the best choice for your application. There are three options for using +urllib3 on Google App Engine: + +1. You can use :class:`AppEngineManager` with URLFetch. URLFetch is + cost-effective in many circumstances as long as your usage is within the + limitations. +2. You can use a normal :class:`~urllib3.PoolManager` by enabling sockets. + Sockets also have `limitations and restrictions + `_ and have a lower free quota than URLFetch. + To use sockets, be sure to specify the following in your ``app.yaml``:: + + env_variables: + GAE_USE_SOCKETS_HTTPLIB : 'true' + +3. If you are using `App Engine Flexible +`_, you can use the standard +:class:`PoolManager` without any configuration or special environment variables. +""" + +from __future__ import absolute_import + +import io +import logging +import warnings + +from ..exceptions import ( + HTTPError, + HTTPWarning, + MaxRetryError, + ProtocolError, + SSLError, + TimeoutError, +) +from ..packages.six.moves.urllib.parse import urljoin +from ..request import RequestMethods +from ..response import HTTPResponse +from ..util.retry import Retry +from ..util.timeout import Timeout +from . import _appengine_environ + +try: + from google.appengine.api import urlfetch +except ImportError: + urlfetch = None + + +log = logging.getLogger(__name__) + + +class AppEnginePlatformWarning(HTTPWarning): + pass + + +class AppEnginePlatformError(HTTPError): + pass + + +class AppEngineManager(RequestMethods): + """ + Connection manager for Google App Engine sandbox applications. + + This manager uses the URLFetch service directly instead of using the + emulated httplib, and is subject to URLFetch limitations as described in + the App Engine documentation `here + `_. + + Notably it will raise an :class:`AppEnginePlatformError` if: + * URLFetch is not available. + * If you attempt to use this on App Engine Flexible, as full socket + support is available. + * If a request size is more than 10 megabytes. + * If a response size is more than 32 megabytes. + * If you use an unsupported request method such as OPTIONS. + + Beyond those cases, it will raise normal urllib3 errors. + """ + + def __init__( + self, + headers=None, + retries=None, + validate_certificate=True, + urlfetch_retries=True, + ): + if not urlfetch: + raise AppEnginePlatformError( + "URLFetch is not available in this environment." + ) + + warnings.warn( + "urllib3 is using URLFetch on Google App Engine sandbox instead " + "of sockets. To use sockets directly instead of URLFetch see " + "https://urllib3.readthedocs.io/en/1.26.x/reference/urllib3.contrib.html.", + AppEnginePlatformWarning, + ) + + RequestMethods.__init__(self, headers) + self.validate_certificate = validate_certificate + self.urlfetch_retries = urlfetch_retries + + self.retries = retries or Retry.DEFAULT + + def __enter__(self): + return self + + def __exit__(self, exc_type, exc_val, exc_tb): + # Return False to re-raise any potential exceptions + return False + + def urlopen( + self, + method, + url, + body=None, + headers=None, + retries=None, + redirect=True, + timeout=Timeout.DEFAULT_TIMEOUT, + **response_kw + ): + + retries = self._get_retries(retries, redirect) + + try: + follow_redirects = redirect and retries.redirect != 0 and retries.total + response = urlfetch.fetch( + url, + payload=body, + method=method, + headers=headers or {}, + allow_truncated=False, + follow_redirects=self.urlfetch_retries and follow_redirects, + deadline=self._get_absolute_timeout(timeout), + validate_certificate=self.validate_certificate, + ) + except urlfetch.DeadlineExceededError as e: + raise TimeoutError(self, e) + + except urlfetch.InvalidURLError as e: + if "too large" in str(e): + raise AppEnginePlatformError( + "URLFetch request too large, URLFetch only " + "supports requests up to 10mb in size.", + e, + ) + raise ProtocolError(e) + + except urlfetch.DownloadError as e: + if "Too many redirects" in str(e): + raise MaxRetryError(self, url, reason=e) + raise ProtocolError(e) + + except urlfetch.ResponseTooLargeError as e: + raise AppEnginePlatformError( + "URLFetch response too large, URLFetch only supports" + "responses up to 32mb in size.", + e, + ) + + except urlfetch.SSLCertificateError as e: + raise SSLError(e) + + except urlfetch.InvalidMethodError as e: + raise AppEnginePlatformError( + "URLFetch does not support method: %s" % method, e + ) + + http_response = self._urlfetch_response_to_http_response( + response, retries=retries, **response_kw + ) + + # Handle redirect? + redirect_location = redirect and http_response.get_redirect_location() + if redirect_location: + # Check for redirect response + if self.urlfetch_retries and retries.raise_on_redirect: + raise MaxRetryError(self, url, "too many redirects") + else: + if http_response.status == 303: + method = "GET" + + try: + retries = retries.increment( + method, url, response=http_response, _pool=self + ) + except MaxRetryError: + if retries.raise_on_redirect: + raise MaxRetryError(self, url, "too many redirects") + return http_response + + retries.sleep_for_retry(http_response) + log.debug("Redirecting %s -> %s", url, redirect_location) + redirect_url = urljoin(url, redirect_location) + return self.urlopen( + method, + redirect_url, + body, + headers, + retries=retries, + redirect=redirect, + timeout=timeout, + **response_kw + ) + + # Check if we should retry the HTTP response. + has_retry_after = bool(http_response.headers.get("Retry-After")) + if retries.is_retry(method, http_response.status, has_retry_after): + retries = retries.increment(method, url, response=http_response, _pool=self) + log.debug("Retry: %s", url) + retries.sleep(http_response) + return self.urlopen( + method, + url, + body=body, + headers=headers, + retries=retries, + redirect=redirect, + timeout=timeout, + **response_kw + ) + + return http_response + + def _urlfetch_response_to_http_response(self, urlfetch_resp, **response_kw): + + if is_prod_appengine(): + # Production GAE handles deflate encoding automatically, but does + # not remove the encoding header. + content_encoding = urlfetch_resp.headers.get("content-encoding") + + if content_encoding == "deflate": + del urlfetch_resp.headers["content-encoding"] + + transfer_encoding = urlfetch_resp.headers.get("transfer-encoding") + # We have a full response's content, + # so let's make sure we don't report ourselves as chunked data. + if transfer_encoding == "chunked": + encodings = transfer_encoding.split(",") + encodings.remove("chunked") + urlfetch_resp.headers["transfer-encoding"] = ",".join(encodings) + + original_response = HTTPResponse( + # In order for decoding to work, we must present the content as + # a file-like object. + body=io.BytesIO(urlfetch_resp.content), + msg=urlfetch_resp.header_msg, + headers=urlfetch_resp.headers, + status=urlfetch_resp.status_code, + **response_kw + ) + + return HTTPResponse( + body=io.BytesIO(urlfetch_resp.content), + headers=urlfetch_resp.headers, + status=urlfetch_resp.status_code, + original_response=original_response, + **response_kw + ) + + def _get_absolute_timeout(self, timeout): + if timeout is Timeout.DEFAULT_TIMEOUT: + return None # Defer to URLFetch's default. + if isinstance(timeout, Timeout): + if timeout._read is not None or timeout._connect is not None: + warnings.warn( + "URLFetch does not support granular timeout settings, " + "reverting to total or default URLFetch timeout.", + AppEnginePlatformWarning, + ) + return timeout.total + return timeout + + def _get_retries(self, retries, redirect): + if not isinstance(retries, Retry): + retries = Retry.from_int(retries, redirect=redirect, default=self.retries) + + if retries.connect or retries.read or retries.redirect: + warnings.warn( + "URLFetch only supports total retries and does not " + "recognize connect, read, or redirect retry parameters.", + AppEnginePlatformWarning, + ) + + return retries + + +# Alias methods from _appengine_environ to maintain public API interface. + +is_appengine = _appengine_environ.is_appengine +is_appengine_sandbox = _appengine_environ.is_appengine_sandbox +is_local_appengine = _appengine_environ.is_local_appengine +is_prod_appengine = _appengine_environ.is_prod_appengine +is_prod_appengine_mvms = _appengine_environ.is_prod_appengine_mvms diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/ntlmpool.py b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/ntlmpool.py new file mode 100644 index 0000000..4716657 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/ntlmpool.py @@ -0,0 +1,130 @@ +""" +NTLM authenticating pool, contributed by erikcederstran + +Issue #10, see: http://code.google.com/p/urllib3/issues/detail?id=10 +""" +from __future__ import absolute_import + +import warnings +from logging import getLogger + +from ntlm import ntlm + +from .. import HTTPSConnectionPool +from ..packages.six.moves.http_client import HTTPSConnection + +warnings.warn( + "The 'urllib3.contrib.ntlmpool' module is deprecated and will be removed " + "in urllib3 v2.0 release, urllib3 is not able to support it properly due " + "to reasons listed in issue: https://github.com/urllib3/urllib3/issues/2282. " + "If you are a user of this module please comment in the mentioned issue.", + DeprecationWarning, +) + +log = getLogger(__name__) + + +class NTLMConnectionPool(HTTPSConnectionPool): + """ + Implements an NTLM authentication version of an urllib3 connection pool + """ + + scheme = "https" + + def __init__(self, user, pw, authurl, *args, **kwargs): + """ + authurl is a random URL on the server that is protected by NTLM. + user is the Windows user, probably in the DOMAIN\\username format. + pw is the password for the user. + """ + super(NTLMConnectionPool, self).__init__(*args, **kwargs) + self.authurl = authurl + self.rawuser = user + user_parts = user.split("\\", 1) + self.domain = user_parts[0].upper() + self.user = user_parts[1] + self.pw = pw + + def _new_conn(self): + # Performs the NTLM handshake that secures the connection. The socket + # must be kept open while requests are performed. + self.num_connections += 1 + log.debug( + "Starting NTLM HTTPS connection no. %d: https://%s%s", + self.num_connections, + self.host, + self.authurl, + ) + + headers = {"Connection": "Keep-Alive"} + req_header = "Authorization" + resp_header = "www-authenticate" + + conn = HTTPSConnection(host=self.host, port=self.port) + + # Send negotiation message + headers[req_header] = "NTLM %s" % ntlm.create_NTLM_NEGOTIATE_MESSAGE( + self.rawuser + ) + log.debug("Request headers: %s", headers) + conn.request("GET", self.authurl, None, headers) + res = conn.getresponse() + reshdr = dict(res.headers) + log.debug("Response status: %s %s", res.status, res.reason) + log.debug("Response headers: %s", reshdr) + log.debug("Response data: %s [...]", res.read(100)) + + # Remove the reference to the socket, so that it can not be closed by + # the response object (we want to keep the socket open) + res.fp = None + + # Server should respond with a challenge message + auth_header_values = reshdr[resp_header].split(", ") + auth_header_value = None + for s in auth_header_values: + if s[:5] == "NTLM ": + auth_header_value = s[5:] + if auth_header_value is None: + raise Exception( + "Unexpected %s response header: %s" % (resp_header, reshdr[resp_header]) + ) + + # Send authentication message + ServerChallenge, NegotiateFlags = ntlm.parse_NTLM_CHALLENGE_MESSAGE( + auth_header_value + ) + auth_msg = ntlm.create_NTLM_AUTHENTICATE_MESSAGE( + ServerChallenge, self.user, self.domain, self.pw, NegotiateFlags + ) + headers[req_header] = "NTLM %s" % auth_msg + log.debug("Request headers: %s", headers) + conn.request("GET", self.authurl, None, headers) + res = conn.getresponse() + log.debug("Response status: %s %s", res.status, res.reason) + log.debug("Response headers: %s", dict(res.headers)) + log.debug("Response data: %s [...]", res.read()[:100]) + if res.status != 200: + if res.status == 401: + raise Exception("Server rejected request: wrong username or password") + raise Exception("Wrong server response: %s %s" % (res.status, res.reason)) + + res.fp = None + log.debug("Connection established") + return conn + + def urlopen( + self, + method, + url, + body=None, + headers=None, + retries=3, + redirect=True, + assert_same_host=True, + ): + if headers is None: + headers = {} + headers["Connection"] = "Keep-Alive" + return super(NTLMConnectionPool, self).urlopen( + method, url, body, headers, retries, redirect, assert_same_host + ) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/pyopenssl.py b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/pyopenssl.py new file mode 100644 index 0000000..19e4aa9 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/pyopenssl.py @@ -0,0 +1,518 @@ +""" +TLS with SNI_-support for Python 2. Follow these instructions if you would +like to verify TLS certificates in Python 2. Note, the default libraries do +*not* do certificate checking; you need to do additional work to validate +certificates yourself. + +This needs the following packages installed: + +* `pyOpenSSL`_ (tested with 16.0.0) +* `cryptography`_ (minimum 1.3.4, from pyopenssl) +* `idna`_ (minimum 2.0, from cryptography) + +However, pyopenssl depends on cryptography, which depends on idna, so while we +use all three directly here we end up having relatively few packages required. + +You can install them with the following command: + +.. code-block:: bash + + $ python -m pip install pyopenssl cryptography idna + +To activate certificate checking, call +:func:`~urllib3.contrib.pyopenssl.inject_into_urllib3` from your Python code +before you begin making HTTP requests. This can be done in a ``sitecustomize`` +module, or at any other time before your application begins using ``urllib3``, +like this: + +.. code-block:: python + + try: + import pip._vendor.urllib3.contrib.pyopenssl as pyopenssl + pyopenssl.inject_into_urllib3() + except ImportError: + pass + +Now you can use :mod:`urllib3` as you normally would, and it will support SNI +when the required modules are installed. + +Activating this module also has the positive side effect of disabling SSL/TLS +compression in Python 2 (see `CRIME attack`_). + +.. _sni: https://en.wikipedia.org/wiki/Server_Name_Indication +.. _crime attack: https://en.wikipedia.org/wiki/CRIME_(security_exploit) +.. _pyopenssl: https://www.pyopenssl.org +.. _cryptography: https://cryptography.io +.. _idna: https://github.com/kjd/idna +""" +from __future__ import absolute_import + +import OpenSSL.crypto +import OpenSSL.SSL +from cryptography import x509 +from cryptography.hazmat.backends.openssl import backend as openssl_backend + +try: + from cryptography.x509 import UnsupportedExtension +except ImportError: + # UnsupportedExtension is gone in cryptography >= 2.1.0 + class UnsupportedExtension(Exception): + pass + + +from io import BytesIO +from socket import error as SocketError +from socket import timeout + +try: # Platform-specific: Python 2 + from socket import _fileobject +except ImportError: # Platform-specific: Python 3 + _fileobject = None + from ..packages.backports.makefile import backport_makefile + +import logging +import ssl +import sys +import warnings + +from .. import util +from ..packages import six +from ..util.ssl_ import PROTOCOL_TLS_CLIENT + +warnings.warn( + "'urllib3.contrib.pyopenssl' module is deprecated and will be removed " + "in a future release of urllib3 2.x. Read more in this issue: " + "https://github.com/urllib3/urllib3/issues/2680", + category=DeprecationWarning, + stacklevel=2, +) + +__all__ = ["inject_into_urllib3", "extract_from_urllib3"] + +# SNI always works. +HAS_SNI = True + +# Map from urllib3 to PyOpenSSL compatible parameter-values. +_openssl_versions = { + util.PROTOCOL_TLS: OpenSSL.SSL.SSLv23_METHOD, + PROTOCOL_TLS_CLIENT: OpenSSL.SSL.SSLv23_METHOD, + ssl.PROTOCOL_TLSv1: OpenSSL.SSL.TLSv1_METHOD, +} + +if hasattr(ssl, "PROTOCOL_SSLv3") and hasattr(OpenSSL.SSL, "SSLv3_METHOD"): + _openssl_versions[ssl.PROTOCOL_SSLv3] = OpenSSL.SSL.SSLv3_METHOD + +if hasattr(ssl, "PROTOCOL_TLSv1_1") and hasattr(OpenSSL.SSL, "TLSv1_1_METHOD"): + _openssl_versions[ssl.PROTOCOL_TLSv1_1] = OpenSSL.SSL.TLSv1_1_METHOD + +if hasattr(ssl, "PROTOCOL_TLSv1_2") and hasattr(OpenSSL.SSL, "TLSv1_2_METHOD"): + _openssl_versions[ssl.PROTOCOL_TLSv1_2] = OpenSSL.SSL.TLSv1_2_METHOD + + +_stdlib_to_openssl_verify = { + ssl.CERT_NONE: OpenSSL.SSL.VERIFY_NONE, + ssl.CERT_OPTIONAL: OpenSSL.SSL.VERIFY_PEER, + ssl.CERT_REQUIRED: OpenSSL.SSL.VERIFY_PEER + + OpenSSL.SSL.VERIFY_FAIL_IF_NO_PEER_CERT, +} +_openssl_to_stdlib_verify = dict((v, k) for k, v in _stdlib_to_openssl_verify.items()) + +# OpenSSL will only write 16K at a time +SSL_WRITE_BLOCKSIZE = 16384 + +orig_util_HAS_SNI = util.HAS_SNI +orig_util_SSLContext = util.ssl_.SSLContext + + +log = logging.getLogger(__name__) + + +def inject_into_urllib3(): + "Monkey-patch urllib3 with PyOpenSSL-backed SSL-support." + + _validate_dependencies_met() + + util.SSLContext = PyOpenSSLContext + util.ssl_.SSLContext = PyOpenSSLContext + util.HAS_SNI = HAS_SNI + util.ssl_.HAS_SNI = HAS_SNI + util.IS_PYOPENSSL = True + util.ssl_.IS_PYOPENSSL = True + + +def extract_from_urllib3(): + "Undo monkey-patching by :func:`inject_into_urllib3`." + + util.SSLContext = orig_util_SSLContext + util.ssl_.SSLContext = orig_util_SSLContext + util.HAS_SNI = orig_util_HAS_SNI + util.ssl_.HAS_SNI = orig_util_HAS_SNI + util.IS_PYOPENSSL = False + util.ssl_.IS_PYOPENSSL = False + + +def _validate_dependencies_met(): + """ + Verifies that PyOpenSSL's package-level dependencies have been met. + Throws `ImportError` if they are not met. + """ + # Method added in `cryptography==1.1`; not available in older versions + from cryptography.x509.extensions import Extensions + + if getattr(Extensions, "get_extension_for_class", None) is None: + raise ImportError( + "'cryptography' module missing required functionality. " + "Try upgrading to v1.3.4 or newer." + ) + + # pyOpenSSL 0.14 and above use cryptography for OpenSSL bindings. The _x509 + # attribute is only present on those versions. + from OpenSSL.crypto import X509 + + x509 = X509() + if getattr(x509, "_x509", None) is None: + raise ImportError( + "'pyOpenSSL' module missing required functionality. " + "Try upgrading to v0.14 or newer." + ) + + +def _dnsname_to_stdlib(name): + """ + Converts a dNSName SubjectAlternativeName field to the form used by the + standard library on the given Python version. + + Cryptography produces a dNSName as a unicode string that was idna-decoded + from ASCII bytes. We need to idna-encode that string to get it back, and + then on Python 3 we also need to convert to unicode via UTF-8 (the stdlib + uses PyUnicode_FromStringAndSize on it, which decodes via UTF-8). + + If the name cannot be idna-encoded then we return None signalling that + the name given should be skipped. + """ + + def idna_encode(name): + """ + Borrowed wholesale from the Python Cryptography Project. It turns out + that we can't just safely call `idna.encode`: it can explode for + wildcard names. This avoids that problem. + """ + from pip._vendor import idna + + try: + for prefix in [u"*.", u"."]: + if name.startswith(prefix): + name = name[len(prefix) :] + return prefix.encode("ascii") + idna.encode(name) + return idna.encode(name) + except idna.core.IDNAError: + return None + + # Don't send IPv6 addresses through the IDNA encoder. + if ":" in name: + return name + + name = idna_encode(name) + if name is None: + return None + elif sys.version_info >= (3, 0): + name = name.decode("utf-8") + return name + + +def get_subj_alt_name(peer_cert): + """ + Given an PyOpenSSL certificate, provides all the subject alternative names. + """ + # Pass the cert to cryptography, which has much better APIs for this. + if hasattr(peer_cert, "to_cryptography"): + cert = peer_cert.to_cryptography() + else: + der = OpenSSL.crypto.dump_certificate(OpenSSL.crypto.FILETYPE_ASN1, peer_cert) + cert = x509.load_der_x509_certificate(der, openssl_backend) + + # We want to find the SAN extension. Ask Cryptography to locate it (it's + # faster than looping in Python) + try: + ext = cert.extensions.get_extension_for_class(x509.SubjectAlternativeName).value + except x509.ExtensionNotFound: + # No such extension, return the empty list. + return [] + except ( + x509.DuplicateExtension, + UnsupportedExtension, + x509.UnsupportedGeneralNameType, + UnicodeError, + ) as e: + # A problem has been found with the quality of the certificate. Assume + # no SAN field is present. + log.warning( + "A problem was encountered with the certificate that prevented " + "urllib3 from finding the SubjectAlternativeName field. This can " + "affect certificate validation. The error was %s", + e, + ) + return [] + + # We want to return dNSName and iPAddress fields. We need to cast the IPs + # back to strings because the match_hostname function wants them as + # strings. + # Sadly the DNS names need to be idna encoded and then, on Python 3, UTF-8 + # decoded. This is pretty frustrating, but that's what the standard library + # does with certificates, and so we need to attempt to do the same. + # We also want to skip over names which cannot be idna encoded. + names = [ + ("DNS", name) + for name in map(_dnsname_to_stdlib, ext.get_values_for_type(x509.DNSName)) + if name is not None + ] + names.extend( + ("IP Address", str(name)) for name in ext.get_values_for_type(x509.IPAddress) + ) + + return names + + +class WrappedSocket(object): + """API-compatibility wrapper for Python OpenSSL's Connection-class. + + Note: _makefile_refs, _drop() and _reuse() are needed for the garbage + collector of pypy. + """ + + def __init__(self, connection, socket, suppress_ragged_eofs=True): + self.connection = connection + self.socket = socket + self.suppress_ragged_eofs = suppress_ragged_eofs + self._makefile_refs = 0 + self._closed = False + + def fileno(self): + return self.socket.fileno() + + # Copy-pasted from Python 3.5 source code + def _decref_socketios(self): + if self._makefile_refs > 0: + self._makefile_refs -= 1 + if self._closed: + self.close() + + def recv(self, *args, **kwargs): + try: + data = self.connection.recv(*args, **kwargs) + except OpenSSL.SSL.SysCallError as e: + if self.suppress_ragged_eofs and e.args == (-1, "Unexpected EOF"): + return b"" + else: + raise SocketError(str(e)) + except OpenSSL.SSL.ZeroReturnError: + if self.connection.get_shutdown() == OpenSSL.SSL.RECEIVED_SHUTDOWN: + return b"" + else: + raise + except OpenSSL.SSL.WantReadError: + if not util.wait_for_read(self.socket, self.socket.gettimeout()): + raise timeout("The read operation timed out") + else: + return self.recv(*args, **kwargs) + + # TLS 1.3 post-handshake authentication + except OpenSSL.SSL.Error as e: + raise ssl.SSLError("read error: %r" % e) + else: + return data + + def recv_into(self, *args, **kwargs): + try: + return self.connection.recv_into(*args, **kwargs) + except OpenSSL.SSL.SysCallError as e: + if self.suppress_ragged_eofs and e.args == (-1, "Unexpected EOF"): + return 0 + else: + raise SocketError(str(e)) + except OpenSSL.SSL.ZeroReturnError: + if self.connection.get_shutdown() == OpenSSL.SSL.RECEIVED_SHUTDOWN: + return 0 + else: + raise + except OpenSSL.SSL.WantReadError: + if not util.wait_for_read(self.socket, self.socket.gettimeout()): + raise timeout("The read operation timed out") + else: + return self.recv_into(*args, **kwargs) + + # TLS 1.3 post-handshake authentication + except OpenSSL.SSL.Error as e: + raise ssl.SSLError("read error: %r" % e) + + def settimeout(self, timeout): + return self.socket.settimeout(timeout) + + def _send_until_done(self, data): + while True: + try: + return self.connection.send(data) + except OpenSSL.SSL.WantWriteError: + if not util.wait_for_write(self.socket, self.socket.gettimeout()): + raise timeout() + continue + except OpenSSL.SSL.SysCallError as e: + raise SocketError(str(e)) + + def sendall(self, data): + total_sent = 0 + while total_sent < len(data): + sent = self._send_until_done( + data[total_sent : total_sent + SSL_WRITE_BLOCKSIZE] + ) + total_sent += sent + + def shutdown(self): + # FIXME rethrow compatible exceptions should we ever use this + self.connection.shutdown() + + def close(self): + if self._makefile_refs < 1: + try: + self._closed = True + return self.connection.close() + except OpenSSL.SSL.Error: + return + else: + self._makefile_refs -= 1 + + def getpeercert(self, binary_form=False): + x509 = self.connection.get_peer_certificate() + + if not x509: + return x509 + + if binary_form: + return OpenSSL.crypto.dump_certificate(OpenSSL.crypto.FILETYPE_ASN1, x509) + + return { + "subject": ((("commonName", x509.get_subject().CN),),), + "subjectAltName": get_subj_alt_name(x509), + } + + def version(self): + return self.connection.get_protocol_version_name() + + def _reuse(self): + self._makefile_refs += 1 + + def _drop(self): + if self._makefile_refs < 1: + self.close() + else: + self._makefile_refs -= 1 + + +if _fileobject: # Platform-specific: Python 2 + + def makefile(self, mode, bufsize=-1): + self._makefile_refs += 1 + return _fileobject(self, mode, bufsize, close=True) + +else: # Platform-specific: Python 3 + makefile = backport_makefile + +WrappedSocket.makefile = makefile + + +class PyOpenSSLContext(object): + """ + I am a wrapper class for the PyOpenSSL ``Context`` object. I am responsible + for translating the interface of the standard library ``SSLContext`` object + to calls into PyOpenSSL. + """ + + def __init__(self, protocol): + self.protocol = _openssl_versions[protocol] + self._ctx = OpenSSL.SSL.Context(self.protocol) + self._options = 0 + self.check_hostname = False + + @property + def options(self): + return self._options + + @options.setter + def options(self, value): + self._options = value + self._ctx.set_options(value) + + @property + def verify_mode(self): + return _openssl_to_stdlib_verify[self._ctx.get_verify_mode()] + + @verify_mode.setter + def verify_mode(self, value): + self._ctx.set_verify(_stdlib_to_openssl_verify[value], _verify_callback) + + def set_default_verify_paths(self): + self._ctx.set_default_verify_paths() + + def set_ciphers(self, ciphers): + if isinstance(ciphers, six.text_type): + ciphers = ciphers.encode("utf-8") + self._ctx.set_cipher_list(ciphers) + + def load_verify_locations(self, cafile=None, capath=None, cadata=None): + if cafile is not None: + cafile = cafile.encode("utf-8") + if capath is not None: + capath = capath.encode("utf-8") + try: + self._ctx.load_verify_locations(cafile, capath) + if cadata is not None: + self._ctx.load_verify_locations(BytesIO(cadata)) + except OpenSSL.SSL.Error as e: + raise ssl.SSLError("unable to load trusted certificates: %r" % e) + + def load_cert_chain(self, certfile, keyfile=None, password=None): + self._ctx.use_certificate_chain_file(certfile) + if password is not None: + if not isinstance(password, six.binary_type): + password = password.encode("utf-8") + self._ctx.set_passwd_cb(lambda *_: password) + self._ctx.use_privatekey_file(keyfile or certfile) + + def set_alpn_protocols(self, protocols): + protocols = [six.ensure_binary(p) for p in protocols] + return self._ctx.set_alpn_protos(protocols) + + def wrap_socket( + self, + sock, + server_side=False, + do_handshake_on_connect=True, + suppress_ragged_eofs=True, + server_hostname=None, + ): + cnx = OpenSSL.SSL.Connection(self._ctx, sock) + + if isinstance(server_hostname, six.text_type): # Platform-specific: Python 3 + server_hostname = server_hostname.encode("utf-8") + + if server_hostname is not None: + cnx.set_tlsext_host_name(server_hostname) + + cnx.set_connect_state() + + while True: + try: + cnx.do_handshake() + except OpenSSL.SSL.WantReadError: + if not util.wait_for_read(sock, sock.gettimeout()): + raise timeout("select timed out") + continue + except OpenSSL.SSL.Error as e: + raise ssl.SSLError("bad handshake: %r" % e) + break + + return WrappedSocket(cnx, sock) + + +def _verify_callback(cnx, x509, err_no, err_depth, return_code): + return err_no == 0 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/securetransport.py b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/securetransport.py new file mode 100644 index 0000000..722ee4e --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/securetransport.py @@ -0,0 +1,920 @@ +""" +SecureTranport support for urllib3 via ctypes. + +This makes platform-native TLS available to urllib3 users on macOS without the +use of a compiler. This is an important feature because the Python Package +Index is moving to become a TLSv1.2-or-higher server, and the default OpenSSL +that ships with macOS is not capable of doing TLSv1.2. The only way to resolve +this is to give macOS users an alternative solution to the problem, and that +solution is to use SecureTransport. + +We use ctypes here because this solution must not require a compiler. That's +because pip is not allowed to require a compiler either. + +This is not intended to be a seriously long-term solution to this problem. +The hope is that PEP 543 will eventually solve this issue for us, at which +point we can retire this contrib module. But in the short term, we need to +solve the impending tire fire that is Python on Mac without this kind of +contrib module. So...here we are. + +To use this module, simply import and inject it:: + + import pip._vendor.urllib3.contrib.securetransport as securetransport + securetransport.inject_into_urllib3() + +Happy TLSing! + +This code is a bastardised version of the code found in Will Bond's oscrypto +library. An enormous debt is owed to him for blazing this trail for us. For +that reason, this code should be considered to be covered both by urllib3's +license and by oscrypto's: + +.. code-block:: + + Copyright (c) 2015-2016 Will Bond + + Permission is hereby granted, free of charge, to any person obtaining a + copy of this software and associated documentation files (the "Software"), + to deal in the Software without restriction, including without limitation + the rights to use, copy, modify, merge, publish, distribute, sublicense, + and/or sell copies of the Software, and to permit persons to whom the + Software is furnished to do so, subject to the following conditions: + + The above copyright notice and this permission notice shall be included in + all copies or substantial portions of the Software. + + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING + FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER + DEALINGS IN THE SOFTWARE. +""" +from __future__ import absolute_import + +import contextlib +import ctypes +import errno +import os.path +import shutil +import socket +import ssl +import struct +import threading +import weakref + +from .. import util +from ..packages import six +from ..util.ssl_ import PROTOCOL_TLS_CLIENT +from ._securetransport.bindings import CoreFoundation, Security, SecurityConst +from ._securetransport.low_level import ( + _assert_no_error, + _build_tls_unknown_ca_alert, + _cert_array_from_pem, + _create_cfstring_array, + _load_client_cert_chain, + _temporary_keychain, +) + +try: # Platform-specific: Python 2 + from socket import _fileobject +except ImportError: # Platform-specific: Python 3 + _fileobject = None + from ..packages.backports.makefile import backport_makefile + +__all__ = ["inject_into_urllib3", "extract_from_urllib3"] + +# SNI always works +HAS_SNI = True + +orig_util_HAS_SNI = util.HAS_SNI +orig_util_SSLContext = util.ssl_.SSLContext + +# This dictionary is used by the read callback to obtain a handle to the +# calling wrapped socket. This is a pretty silly approach, but for now it'll +# do. I feel like I should be able to smuggle a handle to the wrapped socket +# directly in the SSLConnectionRef, but for now this approach will work I +# guess. +# +# We need to lock around this structure for inserts, but we don't do it for +# reads/writes in the callbacks. The reasoning here goes as follows: +# +# 1. It is not possible to call into the callbacks before the dictionary is +# populated, so once in the callback the id must be in the dictionary. +# 2. The callbacks don't mutate the dictionary, they only read from it, and +# so cannot conflict with any of the insertions. +# +# This is good: if we had to lock in the callbacks we'd drastically slow down +# the performance of this code. +_connection_refs = weakref.WeakValueDictionary() +_connection_ref_lock = threading.Lock() + +# Limit writes to 16kB. This is OpenSSL's limit, but we'll cargo-cult it over +# for no better reason than we need *a* limit, and this one is right there. +SSL_WRITE_BLOCKSIZE = 16384 + +# This is our equivalent of util.ssl_.DEFAULT_CIPHERS, but expanded out to +# individual cipher suites. We need to do this because this is how +# SecureTransport wants them. +CIPHER_SUITES = [ + SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384, + SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256, + SecurityConst.TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384, + SecurityConst.TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256, + SecurityConst.TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256, + SecurityConst.TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256, + SecurityConst.TLS_DHE_RSA_WITH_AES_256_GCM_SHA384, + SecurityConst.TLS_DHE_RSA_WITH_AES_128_GCM_SHA256, + SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384, + SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA, + SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256, + SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA, + SecurityConst.TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384, + SecurityConst.TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA, + SecurityConst.TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256, + SecurityConst.TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA, + SecurityConst.TLS_DHE_RSA_WITH_AES_256_CBC_SHA256, + SecurityConst.TLS_DHE_RSA_WITH_AES_256_CBC_SHA, + SecurityConst.TLS_DHE_RSA_WITH_AES_128_CBC_SHA256, + SecurityConst.TLS_DHE_RSA_WITH_AES_128_CBC_SHA, + SecurityConst.TLS_AES_256_GCM_SHA384, + SecurityConst.TLS_AES_128_GCM_SHA256, + SecurityConst.TLS_RSA_WITH_AES_256_GCM_SHA384, + SecurityConst.TLS_RSA_WITH_AES_128_GCM_SHA256, + SecurityConst.TLS_AES_128_CCM_8_SHA256, + SecurityConst.TLS_AES_128_CCM_SHA256, + SecurityConst.TLS_RSA_WITH_AES_256_CBC_SHA256, + SecurityConst.TLS_RSA_WITH_AES_128_CBC_SHA256, + SecurityConst.TLS_RSA_WITH_AES_256_CBC_SHA, + SecurityConst.TLS_RSA_WITH_AES_128_CBC_SHA, +] + +# Basically this is simple: for PROTOCOL_SSLv23 we turn it into a low of +# TLSv1 and a high of TLSv1.2. For everything else, we pin to that version. +# TLSv1 to 1.2 are supported on macOS 10.8+ +_protocol_to_min_max = { + util.PROTOCOL_TLS: (SecurityConst.kTLSProtocol1, SecurityConst.kTLSProtocol12), + PROTOCOL_TLS_CLIENT: (SecurityConst.kTLSProtocol1, SecurityConst.kTLSProtocol12), +} + +if hasattr(ssl, "PROTOCOL_SSLv2"): + _protocol_to_min_max[ssl.PROTOCOL_SSLv2] = ( + SecurityConst.kSSLProtocol2, + SecurityConst.kSSLProtocol2, + ) +if hasattr(ssl, "PROTOCOL_SSLv3"): + _protocol_to_min_max[ssl.PROTOCOL_SSLv3] = ( + SecurityConst.kSSLProtocol3, + SecurityConst.kSSLProtocol3, + ) +if hasattr(ssl, "PROTOCOL_TLSv1"): + _protocol_to_min_max[ssl.PROTOCOL_TLSv1] = ( + SecurityConst.kTLSProtocol1, + SecurityConst.kTLSProtocol1, + ) +if hasattr(ssl, "PROTOCOL_TLSv1_1"): + _protocol_to_min_max[ssl.PROTOCOL_TLSv1_1] = ( + SecurityConst.kTLSProtocol11, + SecurityConst.kTLSProtocol11, + ) +if hasattr(ssl, "PROTOCOL_TLSv1_2"): + _protocol_to_min_max[ssl.PROTOCOL_TLSv1_2] = ( + SecurityConst.kTLSProtocol12, + SecurityConst.kTLSProtocol12, + ) + + +def inject_into_urllib3(): + """ + Monkey-patch urllib3 with SecureTransport-backed SSL-support. + """ + util.SSLContext = SecureTransportContext + util.ssl_.SSLContext = SecureTransportContext + util.HAS_SNI = HAS_SNI + util.ssl_.HAS_SNI = HAS_SNI + util.IS_SECURETRANSPORT = True + util.ssl_.IS_SECURETRANSPORT = True + + +def extract_from_urllib3(): + """ + Undo monkey-patching by :func:`inject_into_urllib3`. + """ + util.SSLContext = orig_util_SSLContext + util.ssl_.SSLContext = orig_util_SSLContext + util.HAS_SNI = orig_util_HAS_SNI + util.ssl_.HAS_SNI = orig_util_HAS_SNI + util.IS_SECURETRANSPORT = False + util.ssl_.IS_SECURETRANSPORT = False + + +def _read_callback(connection_id, data_buffer, data_length_pointer): + """ + SecureTransport read callback. This is called by ST to request that data + be returned from the socket. + """ + wrapped_socket = None + try: + wrapped_socket = _connection_refs.get(connection_id) + if wrapped_socket is None: + return SecurityConst.errSSLInternal + base_socket = wrapped_socket.socket + + requested_length = data_length_pointer[0] + + timeout = wrapped_socket.gettimeout() + error = None + read_count = 0 + + try: + while read_count < requested_length: + if timeout is None or timeout >= 0: + if not util.wait_for_read(base_socket, timeout): + raise socket.error(errno.EAGAIN, "timed out") + + remaining = requested_length - read_count + buffer = (ctypes.c_char * remaining).from_address( + data_buffer + read_count + ) + chunk_size = base_socket.recv_into(buffer, remaining) + read_count += chunk_size + if not chunk_size: + if not read_count: + return SecurityConst.errSSLClosedGraceful + break + except (socket.error) as e: + error = e.errno + + if error is not None and error != errno.EAGAIN: + data_length_pointer[0] = read_count + if error == errno.ECONNRESET or error == errno.EPIPE: + return SecurityConst.errSSLClosedAbort + raise + + data_length_pointer[0] = read_count + + if read_count != requested_length: + return SecurityConst.errSSLWouldBlock + + return 0 + except Exception as e: + if wrapped_socket is not None: + wrapped_socket._exception = e + return SecurityConst.errSSLInternal + + +def _write_callback(connection_id, data_buffer, data_length_pointer): + """ + SecureTransport write callback. This is called by ST to request that data + actually be sent on the network. + """ + wrapped_socket = None + try: + wrapped_socket = _connection_refs.get(connection_id) + if wrapped_socket is None: + return SecurityConst.errSSLInternal + base_socket = wrapped_socket.socket + + bytes_to_write = data_length_pointer[0] + data = ctypes.string_at(data_buffer, bytes_to_write) + + timeout = wrapped_socket.gettimeout() + error = None + sent = 0 + + try: + while sent < bytes_to_write: + if timeout is None or timeout >= 0: + if not util.wait_for_write(base_socket, timeout): + raise socket.error(errno.EAGAIN, "timed out") + chunk_sent = base_socket.send(data) + sent += chunk_sent + + # This has some needless copying here, but I'm not sure there's + # much value in optimising this data path. + data = data[chunk_sent:] + except (socket.error) as e: + error = e.errno + + if error is not None and error != errno.EAGAIN: + data_length_pointer[0] = sent + if error == errno.ECONNRESET or error == errno.EPIPE: + return SecurityConst.errSSLClosedAbort + raise + + data_length_pointer[0] = sent + + if sent != bytes_to_write: + return SecurityConst.errSSLWouldBlock + + return 0 + except Exception as e: + if wrapped_socket is not None: + wrapped_socket._exception = e + return SecurityConst.errSSLInternal + + +# We need to keep these two objects references alive: if they get GC'd while +# in use then SecureTransport could attempt to call a function that is in freed +# memory. That would be...uh...bad. Yeah, that's the word. Bad. +_read_callback_pointer = Security.SSLReadFunc(_read_callback) +_write_callback_pointer = Security.SSLWriteFunc(_write_callback) + + +class WrappedSocket(object): + """ + API-compatibility wrapper for Python's OpenSSL wrapped socket object. + + Note: _makefile_refs, _drop(), and _reuse() are needed for the garbage + collector of PyPy. + """ + + def __init__(self, socket): + self.socket = socket + self.context = None + self._makefile_refs = 0 + self._closed = False + self._exception = None + self._keychain = None + self._keychain_dir = None + self._client_cert_chain = None + + # We save off the previously-configured timeout and then set it to + # zero. This is done because we use select and friends to handle the + # timeouts, but if we leave the timeout set on the lower socket then + # Python will "kindly" call select on that socket again for us. Avoid + # that by forcing the timeout to zero. + self._timeout = self.socket.gettimeout() + self.socket.settimeout(0) + + @contextlib.contextmanager + def _raise_on_error(self): + """ + A context manager that can be used to wrap calls that do I/O from + SecureTransport. If any of the I/O callbacks hit an exception, this + context manager will correctly propagate the exception after the fact. + This avoids silently swallowing those exceptions. + + It also correctly forces the socket closed. + """ + self._exception = None + + # We explicitly don't catch around this yield because in the unlikely + # event that an exception was hit in the block we don't want to swallow + # it. + yield + if self._exception is not None: + exception, self._exception = self._exception, None + self.close() + raise exception + + def _set_ciphers(self): + """ + Sets up the allowed ciphers. By default this matches the set in + util.ssl_.DEFAULT_CIPHERS, at least as supported by macOS. This is done + custom and doesn't allow changing at this time, mostly because parsing + OpenSSL cipher strings is going to be a freaking nightmare. + """ + ciphers = (Security.SSLCipherSuite * len(CIPHER_SUITES))(*CIPHER_SUITES) + result = Security.SSLSetEnabledCiphers( + self.context, ciphers, len(CIPHER_SUITES) + ) + _assert_no_error(result) + + def _set_alpn_protocols(self, protocols): + """ + Sets up the ALPN protocols on the context. + """ + if not protocols: + return + protocols_arr = _create_cfstring_array(protocols) + try: + result = Security.SSLSetALPNProtocols(self.context, protocols_arr) + _assert_no_error(result) + finally: + CoreFoundation.CFRelease(protocols_arr) + + def _custom_validate(self, verify, trust_bundle): + """ + Called when we have set custom validation. We do this in two cases: + first, when cert validation is entirely disabled; and second, when + using a custom trust DB. + Raises an SSLError if the connection is not trusted. + """ + # If we disabled cert validation, just say: cool. + if not verify: + return + + successes = ( + SecurityConst.kSecTrustResultUnspecified, + SecurityConst.kSecTrustResultProceed, + ) + try: + trust_result = self._evaluate_trust(trust_bundle) + if trust_result in successes: + return + reason = "error code: %d" % (trust_result,) + except Exception as e: + # Do not trust on error + reason = "exception: %r" % (e,) + + # SecureTransport does not send an alert nor shuts down the connection. + rec = _build_tls_unknown_ca_alert(self.version()) + self.socket.sendall(rec) + # close the connection immediately + # l_onoff = 1, activate linger + # l_linger = 0, linger for 0 seoncds + opts = struct.pack("ii", 1, 0) + self.socket.setsockopt(socket.SOL_SOCKET, socket.SO_LINGER, opts) + self.close() + raise ssl.SSLError("certificate verify failed, %s" % reason) + + def _evaluate_trust(self, trust_bundle): + # We want data in memory, so load it up. + if os.path.isfile(trust_bundle): + with open(trust_bundle, "rb") as f: + trust_bundle = f.read() + + cert_array = None + trust = Security.SecTrustRef() + + try: + # Get a CFArray that contains the certs we want. + cert_array = _cert_array_from_pem(trust_bundle) + + # Ok, now the hard part. We want to get the SecTrustRef that ST has + # created for this connection, shove our CAs into it, tell ST to + # ignore everything else it knows, and then ask if it can build a + # chain. This is a buuuunch of code. + result = Security.SSLCopyPeerTrust(self.context, ctypes.byref(trust)) + _assert_no_error(result) + if not trust: + raise ssl.SSLError("Failed to copy trust reference") + + result = Security.SecTrustSetAnchorCertificates(trust, cert_array) + _assert_no_error(result) + + result = Security.SecTrustSetAnchorCertificatesOnly(trust, True) + _assert_no_error(result) + + trust_result = Security.SecTrustResultType() + result = Security.SecTrustEvaluate(trust, ctypes.byref(trust_result)) + _assert_no_error(result) + finally: + if trust: + CoreFoundation.CFRelease(trust) + + if cert_array is not None: + CoreFoundation.CFRelease(cert_array) + + return trust_result.value + + def handshake( + self, + server_hostname, + verify, + trust_bundle, + min_version, + max_version, + client_cert, + client_key, + client_key_passphrase, + alpn_protocols, + ): + """ + Actually performs the TLS handshake. This is run automatically by + wrapped socket, and shouldn't be needed in user code. + """ + # First, we do the initial bits of connection setup. We need to create + # a context, set its I/O funcs, and set the connection reference. + self.context = Security.SSLCreateContext( + None, SecurityConst.kSSLClientSide, SecurityConst.kSSLStreamType + ) + result = Security.SSLSetIOFuncs( + self.context, _read_callback_pointer, _write_callback_pointer + ) + _assert_no_error(result) + + # Here we need to compute the handle to use. We do this by taking the + # id of self modulo 2**31 - 1. If this is already in the dictionary, we + # just keep incrementing by one until we find a free space. + with _connection_ref_lock: + handle = id(self) % 2147483647 + while handle in _connection_refs: + handle = (handle + 1) % 2147483647 + _connection_refs[handle] = self + + result = Security.SSLSetConnection(self.context, handle) + _assert_no_error(result) + + # If we have a server hostname, we should set that too. + if server_hostname: + if not isinstance(server_hostname, bytes): + server_hostname = server_hostname.encode("utf-8") + + result = Security.SSLSetPeerDomainName( + self.context, server_hostname, len(server_hostname) + ) + _assert_no_error(result) + + # Setup the ciphers. + self._set_ciphers() + + # Setup the ALPN protocols. + self._set_alpn_protocols(alpn_protocols) + + # Set the minimum and maximum TLS versions. + result = Security.SSLSetProtocolVersionMin(self.context, min_version) + _assert_no_error(result) + + result = Security.SSLSetProtocolVersionMax(self.context, max_version) + _assert_no_error(result) + + # If there's a trust DB, we need to use it. We do that by telling + # SecureTransport to break on server auth. We also do that if we don't + # want to validate the certs at all: we just won't actually do any + # authing in that case. + if not verify or trust_bundle is not None: + result = Security.SSLSetSessionOption( + self.context, SecurityConst.kSSLSessionOptionBreakOnServerAuth, True + ) + _assert_no_error(result) + + # If there's a client cert, we need to use it. + if client_cert: + self._keychain, self._keychain_dir = _temporary_keychain() + self._client_cert_chain = _load_client_cert_chain( + self._keychain, client_cert, client_key + ) + result = Security.SSLSetCertificate(self.context, self._client_cert_chain) + _assert_no_error(result) + + while True: + with self._raise_on_error(): + result = Security.SSLHandshake(self.context) + + if result == SecurityConst.errSSLWouldBlock: + raise socket.timeout("handshake timed out") + elif result == SecurityConst.errSSLServerAuthCompleted: + self._custom_validate(verify, trust_bundle) + continue + else: + _assert_no_error(result) + break + + def fileno(self): + return self.socket.fileno() + + # Copy-pasted from Python 3.5 source code + def _decref_socketios(self): + if self._makefile_refs > 0: + self._makefile_refs -= 1 + if self._closed: + self.close() + + def recv(self, bufsiz): + buffer = ctypes.create_string_buffer(bufsiz) + bytes_read = self.recv_into(buffer, bufsiz) + data = buffer[:bytes_read] + return data + + def recv_into(self, buffer, nbytes=None): + # Read short on EOF. + if self._closed: + return 0 + + if nbytes is None: + nbytes = len(buffer) + + buffer = (ctypes.c_char * nbytes).from_buffer(buffer) + processed_bytes = ctypes.c_size_t(0) + + with self._raise_on_error(): + result = Security.SSLRead( + self.context, buffer, nbytes, ctypes.byref(processed_bytes) + ) + + # There are some result codes that we want to treat as "not always + # errors". Specifically, those are errSSLWouldBlock, + # errSSLClosedGraceful, and errSSLClosedNoNotify. + if result == SecurityConst.errSSLWouldBlock: + # If we didn't process any bytes, then this was just a time out. + # However, we can get errSSLWouldBlock in situations when we *did* + # read some data, and in those cases we should just read "short" + # and return. + if processed_bytes.value == 0: + # Timed out, no data read. + raise socket.timeout("recv timed out") + elif result in ( + SecurityConst.errSSLClosedGraceful, + SecurityConst.errSSLClosedNoNotify, + ): + # The remote peer has closed this connection. We should do so as + # well. Note that we don't actually return here because in + # principle this could actually be fired along with return data. + # It's unlikely though. + self.close() + else: + _assert_no_error(result) + + # Ok, we read and probably succeeded. We should return whatever data + # was actually read. + return processed_bytes.value + + def settimeout(self, timeout): + self._timeout = timeout + + def gettimeout(self): + return self._timeout + + def send(self, data): + processed_bytes = ctypes.c_size_t(0) + + with self._raise_on_error(): + result = Security.SSLWrite( + self.context, data, len(data), ctypes.byref(processed_bytes) + ) + + if result == SecurityConst.errSSLWouldBlock and processed_bytes.value == 0: + # Timed out + raise socket.timeout("send timed out") + else: + _assert_no_error(result) + + # We sent, and probably succeeded. Tell them how much we sent. + return processed_bytes.value + + def sendall(self, data): + total_sent = 0 + while total_sent < len(data): + sent = self.send(data[total_sent : total_sent + SSL_WRITE_BLOCKSIZE]) + total_sent += sent + + def shutdown(self): + with self._raise_on_error(): + Security.SSLClose(self.context) + + def close(self): + # TODO: should I do clean shutdown here? Do I have to? + if self._makefile_refs < 1: + self._closed = True + if self.context: + CoreFoundation.CFRelease(self.context) + self.context = None + if self._client_cert_chain: + CoreFoundation.CFRelease(self._client_cert_chain) + self._client_cert_chain = None + if self._keychain: + Security.SecKeychainDelete(self._keychain) + CoreFoundation.CFRelease(self._keychain) + shutil.rmtree(self._keychain_dir) + self._keychain = self._keychain_dir = None + return self.socket.close() + else: + self._makefile_refs -= 1 + + def getpeercert(self, binary_form=False): + # Urgh, annoying. + # + # Here's how we do this: + # + # 1. Call SSLCopyPeerTrust to get hold of the trust object for this + # connection. + # 2. Call SecTrustGetCertificateAtIndex for index 0 to get the leaf. + # 3. To get the CN, call SecCertificateCopyCommonName and process that + # string so that it's of the appropriate type. + # 4. To get the SAN, we need to do something a bit more complex: + # a. Call SecCertificateCopyValues to get the data, requesting + # kSecOIDSubjectAltName. + # b. Mess about with this dictionary to try to get the SANs out. + # + # This is gross. Really gross. It's going to be a few hundred LoC extra + # just to repeat something that SecureTransport can *already do*. So my + # operating assumption at this time is that what we want to do is + # instead to just flag to urllib3 that it shouldn't do its own hostname + # validation when using SecureTransport. + if not binary_form: + raise ValueError("SecureTransport only supports dumping binary certs") + trust = Security.SecTrustRef() + certdata = None + der_bytes = None + + try: + # Grab the trust store. + result = Security.SSLCopyPeerTrust(self.context, ctypes.byref(trust)) + _assert_no_error(result) + if not trust: + # Probably we haven't done the handshake yet. No biggie. + return None + + cert_count = Security.SecTrustGetCertificateCount(trust) + if not cert_count: + # Also a case that might happen if we haven't handshaked. + # Handshook? Handshaken? + return None + + leaf = Security.SecTrustGetCertificateAtIndex(trust, 0) + assert leaf + + # Ok, now we want the DER bytes. + certdata = Security.SecCertificateCopyData(leaf) + assert certdata + + data_length = CoreFoundation.CFDataGetLength(certdata) + data_buffer = CoreFoundation.CFDataGetBytePtr(certdata) + der_bytes = ctypes.string_at(data_buffer, data_length) + finally: + if certdata: + CoreFoundation.CFRelease(certdata) + if trust: + CoreFoundation.CFRelease(trust) + + return der_bytes + + def version(self): + protocol = Security.SSLProtocol() + result = Security.SSLGetNegotiatedProtocolVersion( + self.context, ctypes.byref(protocol) + ) + _assert_no_error(result) + if protocol.value == SecurityConst.kTLSProtocol13: + raise ssl.SSLError("SecureTransport does not support TLS 1.3") + elif protocol.value == SecurityConst.kTLSProtocol12: + return "TLSv1.2" + elif protocol.value == SecurityConst.kTLSProtocol11: + return "TLSv1.1" + elif protocol.value == SecurityConst.kTLSProtocol1: + return "TLSv1" + elif protocol.value == SecurityConst.kSSLProtocol3: + return "SSLv3" + elif protocol.value == SecurityConst.kSSLProtocol2: + return "SSLv2" + else: + raise ssl.SSLError("Unknown TLS version: %r" % protocol) + + def _reuse(self): + self._makefile_refs += 1 + + def _drop(self): + if self._makefile_refs < 1: + self.close() + else: + self._makefile_refs -= 1 + + +if _fileobject: # Platform-specific: Python 2 + + def makefile(self, mode, bufsize=-1): + self._makefile_refs += 1 + return _fileobject(self, mode, bufsize, close=True) + +else: # Platform-specific: Python 3 + + def makefile(self, mode="r", buffering=None, *args, **kwargs): + # We disable buffering with SecureTransport because it conflicts with + # the buffering that ST does internally (see issue #1153 for more). + buffering = 0 + return backport_makefile(self, mode, buffering, *args, **kwargs) + + +WrappedSocket.makefile = makefile + + +class SecureTransportContext(object): + """ + I am a wrapper class for the SecureTransport library, to translate the + interface of the standard library ``SSLContext`` object to calls into + SecureTransport. + """ + + def __init__(self, protocol): + self._min_version, self._max_version = _protocol_to_min_max[protocol] + self._options = 0 + self._verify = False + self._trust_bundle = None + self._client_cert = None + self._client_key = None + self._client_key_passphrase = None + self._alpn_protocols = None + + @property + def check_hostname(self): + """ + SecureTransport cannot have its hostname checking disabled. For more, + see the comment on getpeercert() in this file. + """ + return True + + @check_hostname.setter + def check_hostname(self, value): + """ + SecureTransport cannot have its hostname checking disabled. For more, + see the comment on getpeercert() in this file. + """ + pass + + @property + def options(self): + # TODO: Well, crap. + # + # So this is the bit of the code that is the most likely to cause us + # trouble. Essentially we need to enumerate all of the SSL options that + # users might want to use and try to see if we can sensibly translate + # them, or whether we should just ignore them. + return self._options + + @options.setter + def options(self, value): + # TODO: Update in line with above. + self._options = value + + @property + def verify_mode(self): + return ssl.CERT_REQUIRED if self._verify else ssl.CERT_NONE + + @verify_mode.setter + def verify_mode(self, value): + self._verify = True if value == ssl.CERT_REQUIRED else False + + def set_default_verify_paths(self): + # So, this has to do something a bit weird. Specifically, what it does + # is nothing. + # + # This means that, if we had previously had load_verify_locations + # called, this does not undo that. We need to do that because it turns + # out that the rest of the urllib3 code will attempt to load the + # default verify paths if it hasn't been told about any paths, even if + # the context itself was sometime earlier. We resolve that by just + # ignoring it. + pass + + def load_default_certs(self): + return self.set_default_verify_paths() + + def set_ciphers(self, ciphers): + # For now, we just require the default cipher string. + if ciphers != util.ssl_.DEFAULT_CIPHERS: + raise ValueError("SecureTransport doesn't support custom cipher strings") + + def load_verify_locations(self, cafile=None, capath=None, cadata=None): + # OK, we only really support cadata and cafile. + if capath is not None: + raise ValueError("SecureTransport does not support cert directories") + + # Raise if cafile does not exist. + if cafile is not None: + with open(cafile): + pass + + self._trust_bundle = cafile or cadata + + def load_cert_chain(self, certfile, keyfile=None, password=None): + self._client_cert = certfile + self._client_key = keyfile + self._client_cert_passphrase = password + + def set_alpn_protocols(self, protocols): + """ + Sets the ALPN protocols that will later be set on the context. + + Raises a NotImplementedError if ALPN is not supported. + """ + if not hasattr(Security, "SSLSetALPNProtocols"): + raise NotImplementedError( + "SecureTransport supports ALPN only in macOS 10.12+" + ) + self._alpn_protocols = [six.ensure_binary(p) for p in protocols] + + def wrap_socket( + self, + sock, + server_side=False, + do_handshake_on_connect=True, + suppress_ragged_eofs=True, + server_hostname=None, + ): + # So, what do we do here? Firstly, we assert some properties. This is a + # stripped down shim, so there is some functionality we don't support. + # See PEP 543 for the real deal. + assert not server_side + assert do_handshake_on_connect + assert suppress_ragged_eofs + + # Ok, we're good to go. Now we want to create the wrapped socket object + # and store it in the appropriate place. + wrapped_socket = WrappedSocket(sock) + + # Now we can handshake + wrapped_socket.handshake( + server_hostname, + self._verify, + self._trust_bundle, + self._min_version, + self._max_version, + self._client_cert, + self._client_key, + self._client_key_passphrase, + self._alpn_protocols, + ) + return wrapped_socket diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/socks.py b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/socks.py new file mode 100644 index 0000000..c326e80 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/socks.py @@ -0,0 +1,216 @@ +# -*- coding: utf-8 -*- +""" +This module contains provisional support for SOCKS proxies from within +urllib3. This module supports SOCKS4, SOCKS4A (an extension of SOCKS4), and +SOCKS5. To enable its functionality, either install PySocks or install this +module with the ``socks`` extra. + +The SOCKS implementation supports the full range of urllib3 features. It also +supports the following SOCKS features: + +- SOCKS4A (``proxy_url='socks4a://...``) +- SOCKS4 (``proxy_url='socks4://...``) +- SOCKS5 with remote DNS (``proxy_url='socks5h://...``) +- SOCKS5 with local DNS (``proxy_url='socks5://...``) +- Usernames and passwords for the SOCKS proxy + +.. note:: + It is recommended to use ``socks5h://`` or ``socks4a://`` schemes in + your ``proxy_url`` to ensure that DNS resolution is done from the remote + server instead of client-side when connecting to a domain name. + +SOCKS4 supports IPv4 and domain names with the SOCKS4A extension. SOCKS5 +supports IPv4, IPv6, and domain names. + +When connecting to a SOCKS4 proxy the ``username`` portion of the ``proxy_url`` +will be sent as the ``userid`` section of the SOCKS request: + +.. code-block:: python + + proxy_url="socks4a://@proxy-host" + +When connecting to a SOCKS5 proxy the ``username`` and ``password`` portion +of the ``proxy_url`` will be sent as the username/password to authenticate +with the proxy: + +.. code-block:: python + + proxy_url="socks5h://:@proxy-host" + +""" +from __future__ import absolute_import + +try: + import socks +except ImportError: + import warnings + + from ..exceptions import DependencyWarning + + warnings.warn( + ( + "SOCKS support in urllib3 requires the installation of optional " + "dependencies: specifically, PySocks. For more information, see " + "https://urllib3.readthedocs.io/en/1.26.x/contrib.html#socks-proxies" + ), + DependencyWarning, + ) + raise + +from socket import error as SocketError +from socket import timeout as SocketTimeout + +from ..connection import HTTPConnection, HTTPSConnection +from ..connectionpool import HTTPConnectionPool, HTTPSConnectionPool +from ..exceptions import ConnectTimeoutError, NewConnectionError +from ..poolmanager import PoolManager +from ..util.url import parse_url + +try: + import ssl +except ImportError: + ssl = None + + +class SOCKSConnection(HTTPConnection): + """ + A plain-text HTTP connection that connects via a SOCKS proxy. + """ + + def __init__(self, *args, **kwargs): + self._socks_options = kwargs.pop("_socks_options") + super(SOCKSConnection, self).__init__(*args, **kwargs) + + def _new_conn(self): + """ + Establish a new connection via the SOCKS proxy. + """ + extra_kw = {} + if self.source_address: + extra_kw["source_address"] = self.source_address + + if self.socket_options: + extra_kw["socket_options"] = self.socket_options + + try: + conn = socks.create_connection( + (self.host, self.port), + proxy_type=self._socks_options["socks_version"], + proxy_addr=self._socks_options["proxy_host"], + proxy_port=self._socks_options["proxy_port"], + proxy_username=self._socks_options["username"], + proxy_password=self._socks_options["password"], + proxy_rdns=self._socks_options["rdns"], + timeout=self.timeout, + **extra_kw + ) + + except SocketTimeout: + raise ConnectTimeoutError( + self, + "Connection to %s timed out. (connect timeout=%s)" + % (self.host, self.timeout), + ) + + except socks.ProxyError as e: + # This is fragile as hell, but it seems to be the only way to raise + # useful errors here. + if e.socket_err: + error = e.socket_err + if isinstance(error, SocketTimeout): + raise ConnectTimeoutError( + self, + "Connection to %s timed out. (connect timeout=%s)" + % (self.host, self.timeout), + ) + else: + raise NewConnectionError( + self, "Failed to establish a new connection: %s" % error + ) + else: + raise NewConnectionError( + self, "Failed to establish a new connection: %s" % e + ) + + except SocketError as e: # Defensive: PySocks should catch all these. + raise NewConnectionError( + self, "Failed to establish a new connection: %s" % e + ) + + return conn + + +# We don't need to duplicate the Verified/Unverified distinction from +# urllib3/connection.py here because the HTTPSConnection will already have been +# correctly set to either the Verified or Unverified form by that module. This +# means the SOCKSHTTPSConnection will automatically be the correct type. +class SOCKSHTTPSConnection(SOCKSConnection, HTTPSConnection): + pass + + +class SOCKSHTTPConnectionPool(HTTPConnectionPool): + ConnectionCls = SOCKSConnection + + +class SOCKSHTTPSConnectionPool(HTTPSConnectionPool): + ConnectionCls = SOCKSHTTPSConnection + + +class SOCKSProxyManager(PoolManager): + """ + A version of the urllib3 ProxyManager that routes connections via the + defined SOCKS proxy. + """ + + pool_classes_by_scheme = { + "http": SOCKSHTTPConnectionPool, + "https": SOCKSHTTPSConnectionPool, + } + + def __init__( + self, + proxy_url, + username=None, + password=None, + num_pools=10, + headers=None, + **connection_pool_kw + ): + parsed = parse_url(proxy_url) + + if username is None and password is None and parsed.auth is not None: + split = parsed.auth.split(":") + if len(split) == 2: + username, password = split + if parsed.scheme == "socks5": + socks_version = socks.PROXY_TYPE_SOCKS5 + rdns = False + elif parsed.scheme == "socks5h": + socks_version = socks.PROXY_TYPE_SOCKS5 + rdns = True + elif parsed.scheme == "socks4": + socks_version = socks.PROXY_TYPE_SOCKS4 + rdns = False + elif parsed.scheme == "socks4a": + socks_version = socks.PROXY_TYPE_SOCKS4 + rdns = True + else: + raise ValueError("Unable to determine SOCKS version from %s" % proxy_url) + + self.proxy_url = proxy_url + + socks_options = { + "socks_version": socks_version, + "proxy_host": parsed.host, + "proxy_port": parsed.port, + "username": username, + "password": password, + "rdns": rdns, + } + connection_pool_kw["_socks_options"] = socks_options + + super(SOCKSProxyManager, self).__init__( + num_pools, headers, **connection_pool_kw + ) + + self.pool_classes_by_scheme = SOCKSProxyManager.pool_classes_by_scheme diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/exceptions.py b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/exceptions.py new file mode 100644 index 0000000..cba6f3f --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/exceptions.py @@ -0,0 +1,323 @@ +from __future__ import absolute_import + +from .packages.six.moves.http_client import IncompleteRead as httplib_IncompleteRead + +# Base Exceptions + + +class HTTPError(Exception): + """Base exception used by this module.""" + + pass + + +class HTTPWarning(Warning): + """Base warning used by this module.""" + + pass + + +class PoolError(HTTPError): + """Base exception for errors caused within a pool.""" + + def __init__(self, pool, message): + self.pool = pool + HTTPError.__init__(self, "%s: %s" % (pool, message)) + + def __reduce__(self): + # For pickling purposes. + return self.__class__, (None, None) + + +class RequestError(PoolError): + """Base exception for PoolErrors that have associated URLs.""" + + def __init__(self, pool, url, message): + self.url = url + PoolError.__init__(self, pool, message) + + def __reduce__(self): + # For pickling purposes. + return self.__class__, (None, self.url, None) + + +class SSLError(HTTPError): + """Raised when SSL certificate fails in an HTTPS connection.""" + + pass + + +class ProxyError(HTTPError): + """Raised when the connection to a proxy fails.""" + + def __init__(self, message, error, *args): + super(ProxyError, self).__init__(message, error, *args) + self.original_error = error + + +class DecodeError(HTTPError): + """Raised when automatic decoding based on Content-Type fails.""" + + pass + + +class ProtocolError(HTTPError): + """Raised when something unexpected happens mid-request/response.""" + + pass + + +#: Renamed to ProtocolError but aliased for backwards compatibility. +ConnectionError = ProtocolError + + +# Leaf Exceptions + + +class MaxRetryError(RequestError): + """Raised when the maximum number of retries is exceeded. + + :param pool: The connection pool + :type pool: :class:`~urllib3.connectionpool.HTTPConnectionPool` + :param string url: The requested Url + :param exceptions.Exception reason: The underlying error + + """ + + def __init__(self, pool, url, reason=None): + self.reason = reason + + message = "Max retries exceeded with url: %s (Caused by %r)" % (url, reason) + + RequestError.__init__(self, pool, url, message) + + +class HostChangedError(RequestError): + """Raised when an existing pool gets a request for a foreign host.""" + + def __init__(self, pool, url, retries=3): + message = "Tried to open a foreign host with url: %s" % url + RequestError.__init__(self, pool, url, message) + self.retries = retries + + +class TimeoutStateError(HTTPError): + """Raised when passing an invalid state to a timeout""" + + pass + + +class TimeoutError(HTTPError): + """Raised when a socket timeout error occurs. + + Catching this error will catch both :exc:`ReadTimeoutErrors + ` and :exc:`ConnectTimeoutErrors `. + """ + + pass + + +class ReadTimeoutError(TimeoutError, RequestError): + """Raised when a socket timeout occurs while receiving data from a server""" + + pass + + +# This timeout error does not have a URL attached and needs to inherit from the +# base HTTPError +class ConnectTimeoutError(TimeoutError): + """Raised when a socket timeout occurs while connecting to a server""" + + pass + + +class NewConnectionError(ConnectTimeoutError, PoolError): + """Raised when we fail to establish a new connection. Usually ECONNREFUSED.""" + + pass + + +class EmptyPoolError(PoolError): + """Raised when a pool runs out of connections and no more are allowed.""" + + pass + + +class ClosedPoolError(PoolError): + """Raised when a request enters a pool after the pool has been closed.""" + + pass + + +class LocationValueError(ValueError, HTTPError): + """Raised when there is something wrong with a given URL input.""" + + pass + + +class LocationParseError(LocationValueError): + """Raised when get_host or similar fails to parse the URL input.""" + + def __init__(self, location): + message = "Failed to parse: %s" % location + HTTPError.__init__(self, message) + + self.location = location + + +class URLSchemeUnknown(LocationValueError): + """Raised when a URL input has an unsupported scheme.""" + + def __init__(self, scheme): + message = "Not supported URL scheme %s" % scheme + super(URLSchemeUnknown, self).__init__(message) + + self.scheme = scheme + + +class ResponseError(HTTPError): + """Used as a container for an error reason supplied in a MaxRetryError.""" + + GENERIC_ERROR = "too many error responses" + SPECIFIC_ERROR = "too many {status_code} error responses" + + +class SecurityWarning(HTTPWarning): + """Warned when performing security reducing actions""" + + pass + + +class SubjectAltNameWarning(SecurityWarning): + """Warned when connecting to a host with a certificate missing a SAN.""" + + pass + + +class InsecureRequestWarning(SecurityWarning): + """Warned when making an unverified HTTPS request.""" + + pass + + +class SystemTimeWarning(SecurityWarning): + """Warned when system time is suspected to be wrong""" + + pass + + +class InsecurePlatformWarning(SecurityWarning): + """Warned when certain TLS/SSL configuration is not available on a platform.""" + + pass + + +class SNIMissingWarning(HTTPWarning): + """Warned when making a HTTPS request without SNI available.""" + + pass + + +class DependencyWarning(HTTPWarning): + """ + Warned when an attempt is made to import a module with missing optional + dependencies. + """ + + pass + + +class ResponseNotChunked(ProtocolError, ValueError): + """Response needs to be chunked in order to read it as chunks.""" + + pass + + +class BodyNotHttplibCompatible(HTTPError): + """ + Body should be :class:`http.client.HTTPResponse` like + (have an fp attribute which returns raw chunks) for read_chunked(). + """ + + pass + + +class IncompleteRead(HTTPError, httplib_IncompleteRead): + """ + Response length doesn't match expected Content-Length + + Subclass of :class:`http.client.IncompleteRead` to allow int value + for ``partial`` to avoid creating large objects on streamed reads. + """ + + def __init__(self, partial, expected): + super(IncompleteRead, self).__init__(partial, expected) + + def __repr__(self): + return "IncompleteRead(%i bytes read, %i more expected)" % ( + self.partial, + self.expected, + ) + + +class InvalidChunkLength(HTTPError, httplib_IncompleteRead): + """Invalid chunk length in a chunked response.""" + + def __init__(self, response, length): + super(InvalidChunkLength, self).__init__( + response.tell(), response.length_remaining + ) + self.response = response + self.length = length + + def __repr__(self): + return "InvalidChunkLength(got length %r, %i bytes read)" % ( + self.length, + self.partial, + ) + + +class InvalidHeader(HTTPError): + """The header provided was somehow invalid.""" + + pass + + +class ProxySchemeUnknown(AssertionError, URLSchemeUnknown): + """ProxyManager does not support the supplied scheme""" + + # TODO(t-8ch): Stop inheriting from AssertionError in v2.0. + + def __init__(self, scheme): + # 'localhost' is here because our URL parser parses + # localhost:8080 -> scheme=localhost, remove if we fix this. + if scheme == "localhost": + scheme = None + if scheme is None: + message = "Proxy URL had no scheme, should start with http:// or https://" + else: + message = ( + "Proxy URL had unsupported scheme %s, should use http:// or https://" + % scheme + ) + super(ProxySchemeUnknown, self).__init__(message) + + +class ProxySchemeUnsupported(ValueError): + """Fetching HTTPS resources through HTTPS proxies is unsupported""" + + pass + + +class HeaderParsingError(HTTPError): + """Raised by assert_header_parsing, but we convert it to a log.warning statement.""" + + def __init__(self, defects, unparsed_data): + message = "%s, unparsed data: %r" % (defects or "Unknown", unparsed_data) + super(HeaderParsingError, self).__init__(message) + + +class UnrewindableBodyError(HTTPError): + """urllib3 encountered an error when trying to rewind a body""" + + pass diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/fields.py b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/fields.py new file mode 100644 index 0000000..9d630f4 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/fields.py @@ -0,0 +1,274 @@ +from __future__ import absolute_import + +import email.utils +import mimetypes +import re + +from .packages import six + + +def guess_content_type(filename, default="application/octet-stream"): + """ + Guess the "Content-Type" of a file. + + :param filename: + The filename to guess the "Content-Type" of using :mod:`mimetypes`. + :param default: + If no "Content-Type" can be guessed, default to `default`. + """ + if filename: + return mimetypes.guess_type(filename)[0] or default + return default + + +def format_header_param_rfc2231(name, value): + """ + Helper function to format and quote a single header parameter using the + strategy defined in RFC 2231. + + Particularly useful for header parameters which might contain + non-ASCII values, like file names. This follows + `RFC 2388 Section 4.4 `_. + + :param name: + The name of the parameter, a string expected to be ASCII only. + :param value: + The value of the parameter, provided as ``bytes`` or `str``. + :ret: + An RFC-2231-formatted unicode string. + """ + if isinstance(value, six.binary_type): + value = value.decode("utf-8") + + if not any(ch in value for ch in '"\\\r\n'): + result = u'%s="%s"' % (name, value) + try: + result.encode("ascii") + except (UnicodeEncodeError, UnicodeDecodeError): + pass + else: + return result + + if six.PY2: # Python 2: + value = value.encode("utf-8") + + # encode_rfc2231 accepts an encoded string and returns an ascii-encoded + # string in Python 2 but accepts and returns unicode strings in Python 3 + value = email.utils.encode_rfc2231(value, "utf-8") + value = "%s*=%s" % (name, value) + + if six.PY2: # Python 2: + value = value.decode("utf-8") + + return value + + +_HTML5_REPLACEMENTS = { + u"\u0022": u"%22", + # Replace "\" with "\\". + u"\u005C": u"\u005C\u005C", +} + +# All control characters from 0x00 to 0x1F *except* 0x1B. +_HTML5_REPLACEMENTS.update( + { + six.unichr(cc): u"%{:02X}".format(cc) + for cc in range(0x00, 0x1F + 1) + if cc not in (0x1B,) + } +) + + +def _replace_multiple(value, needles_and_replacements): + def replacer(match): + return needles_and_replacements[match.group(0)] + + pattern = re.compile( + r"|".join([re.escape(needle) for needle in needles_and_replacements.keys()]) + ) + + result = pattern.sub(replacer, value) + + return result + + +def format_header_param_html5(name, value): + """ + Helper function to format and quote a single header parameter using the + HTML5 strategy. + + Particularly useful for header parameters which might contain + non-ASCII values, like file names. This follows the `HTML5 Working Draft + Section 4.10.22.7`_ and matches the behavior of curl and modern browsers. + + .. _HTML5 Working Draft Section 4.10.22.7: + https://w3c.github.io/html/sec-forms.html#multipart-form-data + + :param name: + The name of the parameter, a string expected to be ASCII only. + :param value: + The value of the parameter, provided as ``bytes`` or `str``. + :ret: + A unicode string, stripped of troublesome characters. + """ + if isinstance(value, six.binary_type): + value = value.decode("utf-8") + + value = _replace_multiple(value, _HTML5_REPLACEMENTS) + + return u'%s="%s"' % (name, value) + + +# For backwards-compatibility. +format_header_param = format_header_param_html5 + + +class RequestField(object): + """ + A data container for request body parameters. + + :param name: + The name of this request field. Must be unicode. + :param data: + The data/value body. + :param filename: + An optional filename of the request field. Must be unicode. + :param headers: + An optional dict-like object of headers to initially use for the field. + :param header_formatter: + An optional callable that is used to encode and format the headers. By + default, this is :func:`format_header_param_html5`. + """ + + def __init__( + self, + name, + data, + filename=None, + headers=None, + header_formatter=format_header_param_html5, + ): + self._name = name + self._filename = filename + self.data = data + self.headers = {} + if headers: + self.headers = dict(headers) + self.header_formatter = header_formatter + + @classmethod + def from_tuples(cls, fieldname, value, header_formatter=format_header_param_html5): + """ + A :class:`~urllib3.fields.RequestField` factory from old-style tuple parameters. + + Supports constructing :class:`~urllib3.fields.RequestField` from + parameter of key/value strings AND key/filetuple. A filetuple is a + (filename, data, MIME type) tuple where the MIME type is optional. + For example:: + + 'foo': 'bar', + 'fakefile': ('foofile.txt', 'contents of foofile'), + 'realfile': ('barfile.txt', open('realfile').read()), + 'typedfile': ('bazfile.bin', open('bazfile').read(), 'image/jpeg'), + 'nonamefile': 'contents of nonamefile field', + + Field names and filenames must be unicode. + """ + if isinstance(value, tuple): + if len(value) == 3: + filename, data, content_type = value + else: + filename, data = value + content_type = guess_content_type(filename) + else: + filename = None + content_type = None + data = value + + request_param = cls( + fieldname, data, filename=filename, header_formatter=header_formatter + ) + request_param.make_multipart(content_type=content_type) + + return request_param + + def _render_part(self, name, value): + """ + Overridable helper function to format a single header parameter. By + default, this calls ``self.header_formatter``. + + :param name: + The name of the parameter, a string expected to be ASCII only. + :param value: + The value of the parameter, provided as a unicode string. + """ + + return self.header_formatter(name, value) + + def _render_parts(self, header_parts): + """ + Helper function to format and quote a single header. + + Useful for single headers that are composed of multiple items. E.g., + 'Content-Disposition' fields. + + :param header_parts: + A sequence of (k, v) tuples or a :class:`dict` of (k, v) to format + as `k1="v1"; k2="v2"; ...`. + """ + parts = [] + iterable = header_parts + if isinstance(header_parts, dict): + iterable = header_parts.items() + + for name, value in iterable: + if value is not None: + parts.append(self._render_part(name, value)) + + return u"; ".join(parts) + + def render_headers(self): + """ + Renders the headers for this request field. + """ + lines = [] + + sort_keys = ["Content-Disposition", "Content-Type", "Content-Location"] + for sort_key in sort_keys: + if self.headers.get(sort_key, False): + lines.append(u"%s: %s" % (sort_key, self.headers[sort_key])) + + for header_name, header_value in self.headers.items(): + if header_name not in sort_keys: + if header_value: + lines.append(u"%s: %s" % (header_name, header_value)) + + lines.append(u"\r\n") + return u"\r\n".join(lines) + + def make_multipart( + self, content_disposition=None, content_type=None, content_location=None + ): + """ + Makes this request field into a multipart request field. + + This method overrides "Content-Disposition", "Content-Type" and + "Content-Location" headers to the request parameter. + + :param content_type: + The 'Content-Type' of the request body. + :param content_location: + The 'Content-Location' of the request body. + + """ + self.headers["Content-Disposition"] = content_disposition or u"form-data" + self.headers["Content-Disposition"] += u"; ".join( + [ + u"", + self._render_parts( + ((u"name", self._name), (u"filename", self._filename)) + ), + ] + ) + self.headers["Content-Type"] = content_type + self.headers["Content-Location"] = content_location diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/filepost.py b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/filepost.py new file mode 100644 index 0000000..36c9252 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/filepost.py @@ -0,0 +1,98 @@ +from __future__ import absolute_import + +import binascii +import codecs +import os +from io import BytesIO + +from .fields import RequestField +from .packages import six +from .packages.six import b + +writer = codecs.lookup("utf-8")[3] + + +def choose_boundary(): + """ + Our embarrassingly-simple replacement for mimetools.choose_boundary. + """ + boundary = binascii.hexlify(os.urandom(16)) + if not six.PY2: + boundary = boundary.decode("ascii") + return boundary + + +def iter_field_objects(fields): + """ + Iterate over fields. + + Supports list of (k, v) tuples and dicts, and lists of + :class:`~urllib3.fields.RequestField`. + + """ + if isinstance(fields, dict): + i = six.iteritems(fields) + else: + i = iter(fields) + + for field in i: + if isinstance(field, RequestField): + yield field + else: + yield RequestField.from_tuples(*field) + + +def iter_fields(fields): + """ + .. deprecated:: 1.6 + + Iterate over fields. + + The addition of :class:`~urllib3.fields.RequestField` makes this function + obsolete. Instead, use :func:`iter_field_objects`, which returns + :class:`~urllib3.fields.RequestField` objects. + + Supports list of (k, v) tuples and dicts. + """ + if isinstance(fields, dict): + return ((k, v) for k, v in six.iteritems(fields)) + + return ((k, v) for k, v in fields) + + +def encode_multipart_formdata(fields, boundary=None): + """ + Encode a dictionary of ``fields`` using the multipart/form-data MIME format. + + :param fields: + Dictionary of fields or list of (key, :class:`~urllib3.fields.RequestField`). + + :param boundary: + If not specified, then a random boundary will be generated using + :func:`urllib3.filepost.choose_boundary`. + """ + body = BytesIO() + if boundary is None: + boundary = choose_boundary() + + for field in iter_field_objects(fields): + body.write(b("--%s\r\n" % (boundary))) + + writer(body).write(field.render_headers()) + data = field.data + + if isinstance(data, int): + data = str(data) # Backwards compatibility + + if isinstance(data, six.text_type): + writer(body).write(data) + else: + body.write(data) + + body.write(b"\r\n") + + body.write(b("--%s--\r\n" % (boundary))) + + content_type = str("multipart/form-data; boundary=%s" % boundary) + + return body.getvalue(), content_type diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/__init__.py b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e72f5f2f8dfbebb13003f9ca0daec558d2a81627 GIT binary patch literal 199 zcmX@j%ge<81Rn!er-A6lAOanHW&w&!XQ*V*Wb|9fP{ah}eFmxdm8PGOpPQ;*RFGOy zlwX#aoS~nbpOUKYn^~N!uUD3uSEiqnnWSG(S(1^TXRK#vq+gs_lB!#fn4F!Mo?5J5 zkXfJ~4^)g LjEsy$%s>_Zra(3j literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/__pycache__/six.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/__pycache__/six.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4533288e787832403c6ad1a21e2ff64812787a75 GIT binary patch literal 41319 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 Ilk)k018Lji*Z=?k literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/backports/__pycache__/weakref_finalize.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/backports/__pycache__/weakref_finalize.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..cfd949ca430ed27d8487fe9695340b02eeae535d GIT binary patch literal 7331 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" % (type(self).__name__, id(self)) + else: + return "<%s object at %#x; for %r at %#x>" % ( + type(self).__name__, + id(self), + type(obj).__name__, + id(obj), + ) + + @classmethod + def _select_for_exit(cls): + # Return live finalizers marked for exit, oldest first + L = [(f, i) for (f, i) in cls._registry.items() if i.atexit] + L.sort(key=lambda item: item[1].index) + return [f for (f, i) in L] + + @classmethod + def _exitfunc(cls): + # At shutdown invoke finalizers for which atexit is true. + # This is called once all other non-daemonic threads have been + # joined. + reenable_gc = False + try: + if cls._registry: + import gc + + if gc.isenabled(): + reenable_gc = True + gc.disable() + pending = None + while True: + if pending is None or weakref_finalize._dirty: + pending = cls._select_for_exit() + weakref_finalize._dirty = False + if not pending: + break + f = pending.pop() + try: + # gc is disabled, so (assuming no daemonic + # threads) the following is the only line in + # this function which might trigger creation + # of a new finalizer + f() + except Exception: + sys.excepthook(*sys.exc_info()) + assert f not in cls._registry + finally: + # prevent any more finalizers from executing during shutdown + weakref_finalize._shutdown = True + if reenable_gc: + gc.enable() diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/six.py b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/six.py new file mode 100644 index 0000000..f099a3d --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/packages/six.py @@ -0,0 +1,1076 @@ +# Copyright (c) 2010-2020 Benjamin Peterson +# +# Permission is hereby granted, free of charge, to any person obtaining a copy +# of this software and associated documentation files (the "Software"), to deal +# in the Software without restriction, including without limitation the rights +# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +# copies of the Software, and to permit persons to whom the Software is +# furnished to do so, subject to the following conditions: +# +# The above copyright notice and this permission notice shall be included in all +# copies or substantial portions of the Software. +# +# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +# SOFTWARE. + +"""Utilities for writing code that runs on Python 2 and 3""" + +from __future__ import absolute_import + +import functools +import itertools +import operator +import sys +import types + +__author__ = "Benjamin Peterson " +__version__ = "1.16.0" + + +# Useful for very coarse version differentiation. +PY2 = sys.version_info[0] == 2 +PY3 = sys.version_info[0] == 3 +PY34 = sys.version_info[0:2] >= (3, 4) + +if PY3: + string_types = (str,) + integer_types = (int,) + class_types = (type,) + text_type = str + binary_type = bytes + + MAXSIZE = sys.maxsize +else: + string_types = (basestring,) + integer_types = (int, long) + class_types = (type, types.ClassType) + text_type = unicode + binary_type = str + + if sys.platform.startswith("java"): + # Jython always uses 32 bits. + MAXSIZE = int((1 << 31) - 1) + else: + # It's possible to have sizeof(long) != sizeof(Py_ssize_t). + class X(object): + def __len__(self): + return 1 << 31 + + try: + len(X()) + except OverflowError: + # 32-bit + MAXSIZE = int((1 << 31) - 1) + else: + # 64-bit + MAXSIZE = int((1 << 63) - 1) + del X + +if PY34: + from importlib.util import spec_from_loader +else: + spec_from_loader = None + + +def _add_doc(func, doc): + """Add documentation to a function.""" + func.__doc__ = doc + + +def _import_module(name): + """Import module, returning the module after the last dot.""" + __import__(name) + return sys.modules[name] + + +class _LazyDescr(object): + def __init__(self, name): + self.name = name + + def __get__(self, obj, tp): + result = self._resolve() + setattr(obj, self.name, result) # Invokes __set__. + try: + # This is a bit ugly, but it avoids running this again by + # removing this descriptor. + delattr(obj.__class__, self.name) + except AttributeError: + pass + return result + + +class MovedModule(_LazyDescr): + def __init__(self, name, old, new=None): + super(MovedModule, self).__init__(name) + if PY3: + if new is None: + new = name + self.mod = new + else: + self.mod = old + + def _resolve(self): + return _import_module(self.mod) + + def __getattr__(self, attr): + _module = self._resolve() + value = getattr(_module, attr) + setattr(self, attr, value) + return value + + +class _LazyModule(types.ModuleType): + def __init__(self, name): + super(_LazyModule, self).__init__(name) + self.__doc__ = self.__class__.__doc__ + + def __dir__(self): + attrs = ["__doc__", "__name__"] + attrs += [attr.name for attr in self._moved_attributes] + return attrs + + # Subclasses should override this + _moved_attributes = [] + + +class MovedAttribute(_LazyDescr): + def __init__(self, name, old_mod, new_mod, old_attr=None, new_attr=None): + super(MovedAttribute, self).__init__(name) + if PY3: + if new_mod is None: + new_mod = name + self.mod = new_mod + if new_attr is None: + if old_attr is None: + new_attr = name + else: + new_attr = old_attr + self.attr = new_attr + else: + self.mod = old_mod + if old_attr is None: + old_attr = name + self.attr = old_attr + + def _resolve(self): + module = _import_module(self.mod) + return getattr(module, self.attr) + + +class _SixMetaPathImporter(object): + + """ + A meta path importer to import six.moves and its submodules. + + This class implements a PEP302 finder and loader. It should be compatible + with Python 2.5 and all existing versions of Python3 + """ + + def __init__(self, six_module_name): + self.name = six_module_name + self.known_modules = {} + + def _add_module(self, mod, *fullnames): + for fullname in fullnames: + self.known_modules[self.name + "." + fullname] = mod + + def _get_module(self, fullname): + return self.known_modules[self.name + "." + fullname] + + def find_module(self, fullname, path=None): + if fullname in self.known_modules: + return self + return None + + def find_spec(self, fullname, path, target=None): + if fullname in self.known_modules: + return spec_from_loader(fullname, self) + return None + + def __get_module(self, fullname): + try: + return self.known_modules[fullname] + except KeyError: + raise ImportError("This loader does not know module " + fullname) + + def load_module(self, fullname): + try: + # in case of a reload + return sys.modules[fullname] + except KeyError: + pass + mod = self.__get_module(fullname) + if isinstance(mod, MovedModule): + mod = mod._resolve() + else: + mod.__loader__ = self + sys.modules[fullname] = mod + return mod + + def is_package(self, fullname): + """ + Return true, if the named module is a package. + + We need this method to get correct spec objects with + Python 3.4 (see PEP451) + """ + return hasattr(self.__get_module(fullname), "__path__") + + def get_code(self, fullname): + """Return None + + Required, if is_package is implemented""" + self.__get_module(fullname) # eventually raises ImportError + return None + + get_source = get_code # same as get_code + + def create_module(self, spec): + return self.load_module(spec.name) + + def exec_module(self, module): + pass + + +_importer = _SixMetaPathImporter(__name__) + + +class _MovedItems(_LazyModule): + + """Lazy loading of moved objects""" + + __path__ = [] # mark as package + + +_moved_attributes = [ + MovedAttribute("cStringIO", "cStringIO", "io", "StringIO"), + MovedAttribute("filter", "itertools", "builtins", "ifilter", "filter"), + MovedAttribute( + "filterfalse", "itertools", "itertools", "ifilterfalse", "filterfalse" + ), + MovedAttribute("input", "__builtin__", "builtins", "raw_input", "input"), + MovedAttribute("intern", "__builtin__", "sys"), + MovedAttribute("map", "itertools", "builtins", "imap", "map"), + MovedAttribute("getcwd", "os", "os", "getcwdu", "getcwd"), + MovedAttribute("getcwdb", "os", "os", "getcwd", "getcwdb"), + MovedAttribute("getoutput", "commands", "subprocess"), + MovedAttribute("range", "__builtin__", "builtins", "xrange", "range"), + MovedAttribute( + "reload_module", "__builtin__", "importlib" if PY34 else "imp", "reload" + ), + MovedAttribute("reduce", "__builtin__", "functools"), + MovedAttribute("shlex_quote", "pipes", "shlex", "quote"), + MovedAttribute("StringIO", "StringIO", "io"), + MovedAttribute("UserDict", "UserDict", "collections"), + MovedAttribute("UserList", "UserList", "collections"), + MovedAttribute("UserString", "UserString", "collections"), + MovedAttribute("xrange", "__builtin__", "builtins", "xrange", "range"), + MovedAttribute("zip", "itertools", "builtins", "izip", "zip"), + MovedAttribute( + "zip_longest", "itertools", "itertools", "izip_longest", "zip_longest" + ), + MovedModule("builtins", "__builtin__"), + MovedModule("configparser", "ConfigParser"), + MovedModule( + "collections_abc", + "collections", + "collections.abc" if sys.version_info >= (3, 3) else "collections", + ), + MovedModule("copyreg", "copy_reg"), + MovedModule("dbm_gnu", "gdbm", "dbm.gnu"), + MovedModule("dbm_ndbm", "dbm", "dbm.ndbm"), + MovedModule( + "_dummy_thread", + "dummy_thread", + "_dummy_thread" if sys.version_info < (3, 9) else "_thread", + ), + MovedModule("http_cookiejar", "cookielib", "http.cookiejar"), + MovedModule("http_cookies", "Cookie", "http.cookies"), + MovedModule("html_entities", "htmlentitydefs", "html.entities"), + MovedModule("html_parser", "HTMLParser", "html.parser"), + MovedModule("http_client", "httplib", "http.client"), + MovedModule("email_mime_base", "email.MIMEBase", "email.mime.base"), + MovedModule("email_mime_image", "email.MIMEImage", "email.mime.image"), + MovedModule("email_mime_multipart", "email.MIMEMultipart", "email.mime.multipart"), + MovedModule( + "email_mime_nonmultipart", "email.MIMENonMultipart", "email.mime.nonmultipart" + ), + MovedModule("email_mime_text", "email.MIMEText", "email.mime.text"), + MovedModule("BaseHTTPServer", "BaseHTTPServer", "http.server"), + MovedModule("CGIHTTPServer", "CGIHTTPServer", "http.server"), + MovedModule("SimpleHTTPServer", "SimpleHTTPServer", "http.server"), + MovedModule("cPickle", "cPickle", "pickle"), + MovedModule("queue", "Queue"), + MovedModule("reprlib", "repr"), + MovedModule("socketserver", "SocketServer"), + MovedModule("_thread", "thread", "_thread"), + MovedModule("tkinter", "Tkinter"), + MovedModule("tkinter_dialog", "Dialog", "tkinter.dialog"), + MovedModule("tkinter_filedialog", "FileDialog", "tkinter.filedialog"), + MovedModule("tkinter_scrolledtext", "ScrolledText", "tkinter.scrolledtext"), + MovedModule("tkinter_simpledialog", "SimpleDialog", "tkinter.simpledialog"), + MovedModule("tkinter_tix", "Tix", "tkinter.tix"), + MovedModule("tkinter_ttk", "ttk", "tkinter.ttk"), + MovedModule("tkinter_constants", "Tkconstants", "tkinter.constants"), + MovedModule("tkinter_dnd", "Tkdnd", "tkinter.dnd"), + MovedModule("tkinter_colorchooser", "tkColorChooser", "tkinter.colorchooser"), + MovedModule("tkinter_commondialog", "tkCommonDialog", "tkinter.commondialog"), + MovedModule("tkinter_tkfiledialog", "tkFileDialog", "tkinter.filedialog"), + MovedModule("tkinter_font", "tkFont", "tkinter.font"), + MovedModule("tkinter_messagebox", "tkMessageBox", "tkinter.messagebox"), + MovedModule("tkinter_tksimpledialog", "tkSimpleDialog", "tkinter.simpledialog"), + MovedModule("urllib_parse", __name__ + ".moves.urllib_parse", "urllib.parse"), + MovedModule("urllib_error", __name__ + ".moves.urllib_error", "urllib.error"), + MovedModule("urllib", __name__ + ".moves.urllib", __name__ + ".moves.urllib"), + MovedModule("urllib_robotparser", "robotparser", "urllib.robotparser"), + MovedModule("xmlrpc_client", "xmlrpclib", "xmlrpc.client"), + MovedModule("xmlrpc_server", "SimpleXMLRPCServer", "xmlrpc.server"), +] +# Add windows specific modules. +if sys.platform == "win32": + _moved_attributes += [ + MovedModule("winreg", "_winreg"), + ] + +for attr in _moved_attributes: + setattr(_MovedItems, attr.name, attr) + if isinstance(attr, MovedModule): + _importer._add_module(attr, "moves." + attr.name) +del attr + +_MovedItems._moved_attributes = _moved_attributes + +moves = _MovedItems(__name__ + ".moves") +_importer._add_module(moves, "moves") + + +class Module_six_moves_urllib_parse(_LazyModule): + + """Lazy loading of moved objects in six.moves.urllib_parse""" + + +_urllib_parse_moved_attributes = [ + MovedAttribute("ParseResult", "urlparse", "urllib.parse"), + MovedAttribute("SplitResult", "urlparse", "urllib.parse"), + MovedAttribute("parse_qs", "urlparse", "urllib.parse"), + MovedAttribute("parse_qsl", "urlparse", "urllib.parse"), + MovedAttribute("urldefrag", "urlparse", "urllib.parse"), + MovedAttribute("urljoin", "urlparse", "urllib.parse"), + MovedAttribute("urlparse", "urlparse", "urllib.parse"), + MovedAttribute("urlsplit", "urlparse", "urllib.parse"), + MovedAttribute("urlunparse", "urlparse", "urllib.parse"), + MovedAttribute("urlunsplit", "urlparse", "urllib.parse"), + MovedAttribute("quote", "urllib", "urllib.parse"), + MovedAttribute("quote_plus", "urllib", "urllib.parse"), + MovedAttribute("unquote", "urllib", "urllib.parse"), + MovedAttribute("unquote_plus", "urllib", "urllib.parse"), + MovedAttribute( + "unquote_to_bytes", "urllib", "urllib.parse", "unquote", "unquote_to_bytes" + ), + MovedAttribute("urlencode", "urllib", "urllib.parse"), + MovedAttribute("splitquery", "urllib", "urllib.parse"), + MovedAttribute("splittag", "urllib", "urllib.parse"), + MovedAttribute("splituser", "urllib", "urllib.parse"), + MovedAttribute("splitvalue", "urllib", "urllib.parse"), + MovedAttribute("uses_fragment", "urlparse", "urllib.parse"), + MovedAttribute("uses_netloc", "urlparse", "urllib.parse"), + MovedAttribute("uses_params", "urlparse", "urllib.parse"), + MovedAttribute("uses_query", "urlparse", "urllib.parse"), + MovedAttribute("uses_relative", "urlparse", "urllib.parse"), +] +for attr in _urllib_parse_moved_attributes: + setattr(Module_six_moves_urllib_parse, attr.name, attr) +del attr + +Module_six_moves_urllib_parse._moved_attributes = _urllib_parse_moved_attributes + +_importer._add_module( + Module_six_moves_urllib_parse(__name__ + ".moves.urllib_parse"), + "moves.urllib_parse", + "moves.urllib.parse", +) + + +class Module_six_moves_urllib_error(_LazyModule): + + """Lazy loading of moved objects in six.moves.urllib_error""" + + +_urllib_error_moved_attributes = [ + MovedAttribute("URLError", "urllib2", "urllib.error"), + MovedAttribute("HTTPError", "urllib2", "urllib.error"), + MovedAttribute("ContentTooShortError", "urllib", "urllib.error"), +] +for attr in _urllib_error_moved_attributes: + setattr(Module_six_moves_urllib_error, attr.name, attr) +del attr + +Module_six_moves_urllib_error._moved_attributes = _urllib_error_moved_attributes + +_importer._add_module( + Module_six_moves_urllib_error(__name__ + ".moves.urllib.error"), + "moves.urllib_error", + "moves.urllib.error", +) + + +class Module_six_moves_urllib_request(_LazyModule): + + """Lazy loading of moved objects in six.moves.urllib_request""" + + +_urllib_request_moved_attributes = [ + MovedAttribute("urlopen", "urllib2", "urllib.request"), + MovedAttribute("install_opener", "urllib2", "urllib.request"), + MovedAttribute("build_opener", "urllib2", "urllib.request"), + MovedAttribute("pathname2url", "urllib", "urllib.request"), + MovedAttribute("url2pathname", "urllib", "urllib.request"), + MovedAttribute("getproxies", "urllib", "urllib.request"), + MovedAttribute("Request", "urllib2", "urllib.request"), + MovedAttribute("OpenerDirector", "urllib2", "urllib.request"), + MovedAttribute("HTTPDefaultErrorHandler", "urllib2", "urllib.request"), + MovedAttribute("HTTPRedirectHandler", "urllib2", "urllib.request"), + MovedAttribute("HTTPCookieProcessor", "urllib2", "urllib.request"), + MovedAttribute("ProxyHandler", "urllib2", "urllib.request"), + MovedAttribute("BaseHandler", "urllib2", "urllib.request"), + MovedAttribute("HTTPPasswordMgr", "urllib2", "urllib.request"), + MovedAttribute("HTTPPasswordMgrWithDefaultRealm", "urllib2", "urllib.request"), + MovedAttribute("AbstractBasicAuthHandler", "urllib2", "urllib.request"), + MovedAttribute("HTTPBasicAuthHandler", "urllib2", "urllib.request"), + MovedAttribute("ProxyBasicAuthHandler", "urllib2", "urllib.request"), + MovedAttribute("AbstractDigestAuthHandler", "urllib2", "urllib.request"), + MovedAttribute("HTTPDigestAuthHandler", "urllib2", "urllib.request"), + MovedAttribute("ProxyDigestAuthHandler", "urllib2", "urllib.request"), + MovedAttribute("HTTPHandler", "urllib2", "urllib.request"), + MovedAttribute("HTTPSHandler", "urllib2", "urllib.request"), + MovedAttribute("FileHandler", "urllib2", "urllib.request"), + MovedAttribute("FTPHandler", "urllib2", "urllib.request"), + MovedAttribute("CacheFTPHandler", "urllib2", "urllib.request"), + MovedAttribute("UnknownHandler", "urllib2", "urllib.request"), + MovedAttribute("HTTPErrorProcessor", "urllib2", "urllib.request"), + MovedAttribute("urlretrieve", "urllib", "urllib.request"), + MovedAttribute("urlcleanup", "urllib", "urllib.request"), + MovedAttribute("URLopener", "urllib", "urllib.request"), + MovedAttribute("FancyURLopener", "urllib", "urllib.request"), + MovedAttribute("proxy_bypass", "urllib", "urllib.request"), + MovedAttribute("parse_http_list", "urllib2", "urllib.request"), + MovedAttribute("parse_keqv_list", "urllib2", "urllib.request"), +] +for attr in _urllib_request_moved_attributes: + setattr(Module_six_moves_urllib_request, attr.name, attr) +del attr + +Module_six_moves_urllib_request._moved_attributes = _urllib_request_moved_attributes + +_importer._add_module( + Module_six_moves_urllib_request(__name__ + ".moves.urllib.request"), + "moves.urllib_request", + "moves.urllib.request", +) + + +class Module_six_moves_urllib_response(_LazyModule): + + """Lazy loading of moved objects in six.moves.urllib_response""" + + +_urllib_response_moved_attributes = [ + MovedAttribute("addbase", "urllib", "urllib.response"), + MovedAttribute("addclosehook", "urllib", "urllib.response"), + MovedAttribute("addinfo", "urllib", "urllib.response"), + MovedAttribute("addinfourl", "urllib", "urllib.response"), +] +for attr in _urllib_response_moved_attributes: + setattr(Module_six_moves_urllib_response, attr.name, attr) +del attr + +Module_six_moves_urllib_response._moved_attributes = _urllib_response_moved_attributes + +_importer._add_module( + Module_six_moves_urllib_response(__name__ + ".moves.urllib.response"), + "moves.urllib_response", + "moves.urllib.response", +) + + +class Module_six_moves_urllib_robotparser(_LazyModule): + + """Lazy loading of moved objects in six.moves.urllib_robotparser""" + + +_urllib_robotparser_moved_attributes = [ + MovedAttribute("RobotFileParser", "robotparser", "urllib.robotparser"), +] +for attr in _urllib_robotparser_moved_attributes: + setattr(Module_six_moves_urllib_robotparser, attr.name, attr) +del attr + +Module_six_moves_urllib_robotparser._moved_attributes = ( + _urllib_robotparser_moved_attributes +) + +_importer._add_module( + Module_six_moves_urllib_robotparser(__name__ + ".moves.urllib.robotparser"), + "moves.urllib_robotparser", + "moves.urllib.robotparser", +) + + +class Module_six_moves_urllib(types.ModuleType): + + """Create a six.moves.urllib namespace that resembles the Python 3 namespace""" + + __path__ = [] # mark as package + parse = _importer._get_module("moves.urllib_parse") + error = _importer._get_module("moves.urllib_error") + request = _importer._get_module("moves.urllib_request") + response = _importer._get_module("moves.urllib_response") + robotparser = _importer._get_module("moves.urllib_robotparser") + + def __dir__(self): + return ["parse", "error", "request", "response", "robotparser"] + + +_importer._add_module( + Module_six_moves_urllib(__name__ + ".moves.urllib"), "moves.urllib" +) + + +def add_move(move): + """Add an item to six.moves.""" + setattr(_MovedItems, move.name, move) + + +def remove_move(name): + """Remove item from six.moves.""" + try: + delattr(_MovedItems, name) + except AttributeError: + try: + del moves.__dict__[name] + except KeyError: + raise AttributeError("no such move, %r" % (name,)) + + +if PY3: + _meth_func = "__func__" + _meth_self = "__self__" + + _func_closure = "__closure__" + _func_code = "__code__" + _func_defaults = "__defaults__" + _func_globals = "__globals__" +else: + _meth_func = "im_func" + _meth_self = "im_self" + + _func_closure = "func_closure" + _func_code = "func_code" + _func_defaults = "func_defaults" + _func_globals = "func_globals" + + +try: + advance_iterator = next +except NameError: + + def advance_iterator(it): + return it.next() + + +next = advance_iterator + + +try: + callable = callable +except NameError: + + def callable(obj): + return any("__call__" in klass.__dict__ for klass in type(obj).__mro__) + + +if PY3: + + def get_unbound_function(unbound): + return unbound + + create_bound_method = types.MethodType + + def create_unbound_method(func, cls): + return func + + Iterator = object +else: + + def get_unbound_function(unbound): + return unbound.im_func + + def create_bound_method(func, obj): + return types.MethodType(func, obj, obj.__class__) + + def create_unbound_method(func, cls): + return types.MethodType(func, None, cls) + + class Iterator(object): + def next(self): + return type(self).__next__(self) + + callable = callable +_add_doc( + get_unbound_function, """Get the function out of a possibly unbound function""" +) + + +get_method_function = operator.attrgetter(_meth_func) +get_method_self = operator.attrgetter(_meth_self) +get_function_closure = operator.attrgetter(_func_closure) +get_function_code = operator.attrgetter(_func_code) +get_function_defaults = operator.attrgetter(_func_defaults) +get_function_globals = operator.attrgetter(_func_globals) + + +if PY3: + + def iterkeys(d, **kw): + return iter(d.keys(**kw)) + + def itervalues(d, **kw): + return iter(d.values(**kw)) + + def iteritems(d, **kw): + return iter(d.items(**kw)) + + def iterlists(d, **kw): + return iter(d.lists(**kw)) + + viewkeys = operator.methodcaller("keys") + + viewvalues = operator.methodcaller("values") + + viewitems = operator.methodcaller("items") +else: + + def iterkeys(d, **kw): + return d.iterkeys(**kw) + + def itervalues(d, **kw): + return d.itervalues(**kw) + + def iteritems(d, **kw): + return d.iteritems(**kw) + + def iterlists(d, **kw): + return d.iterlists(**kw) + + viewkeys = operator.methodcaller("viewkeys") + + viewvalues = operator.methodcaller("viewvalues") + + viewitems = operator.methodcaller("viewitems") + +_add_doc(iterkeys, "Return an iterator over the keys of a dictionary.") +_add_doc(itervalues, "Return an iterator over the values of a dictionary.") +_add_doc(iteritems, "Return an iterator over the (key, value) pairs of a dictionary.") +_add_doc( + iterlists, "Return an iterator over the (key, [values]) pairs of a dictionary." +) + + +if PY3: + + def b(s): + return s.encode("latin-1") + + def u(s): + return s + + unichr = chr + import struct + + int2byte = struct.Struct(">B").pack + del struct + byte2int = operator.itemgetter(0) + indexbytes = operator.getitem + iterbytes = iter + import io + + StringIO = io.StringIO + BytesIO = io.BytesIO + del io + _assertCountEqual = "assertCountEqual" + if sys.version_info[1] <= 1: + _assertRaisesRegex = "assertRaisesRegexp" + _assertRegex = "assertRegexpMatches" + _assertNotRegex = "assertNotRegexpMatches" + else: + _assertRaisesRegex = "assertRaisesRegex" + _assertRegex = "assertRegex" + _assertNotRegex = "assertNotRegex" +else: + + def b(s): + return s + + # Workaround for standalone backslash + + def u(s): + return unicode(s.replace(r"\\", r"\\\\"), "unicode_escape") + + unichr = unichr + int2byte = chr + + def byte2int(bs): + return ord(bs[0]) + + def indexbytes(buf, i): + return ord(buf[i]) + + iterbytes = functools.partial(itertools.imap, ord) + import StringIO + + StringIO = BytesIO = StringIO.StringIO + _assertCountEqual = "assertItemsEqual" + _assertRaisesRegex = "assertRaisesRegexp" + _assertRegex = "assertRegexpMatches" + _assertNotRegex = "assertNotRegexpMatches" +_add_doc(b, """Byte literal""") +_add_doc(u, """Text literal""") + + +def assertCountEqual(self, *args, **kwargs): + return getattr(self, _assertCountEqual)(*args, **kwargs) + + +def assertRaisesRegex(self, *args, **kwargs): + return getattr(self, _assertRaisesRegex)(*args, **kwargs) + + +def assertRegex(self, *args, **kwargs): + return getattr(self, _assertRegex)(*args, **kwargs) + + +def assertNotRegex(self, *args, **kwargs): + return getattr(self, _assertNotRegex)(*args, **kwargs) + + +if PY3: + exec_ = getattr(moves.builtins, "exec") + + def reraise(tp, value, tb=None): + try: + if value is None: + value = tp() + if value.__traceback__ is not tb: + raise value.with_traceback(tb) + raise value + finally: + value = None + tb = None + +else: + + def exec_(_code_, _globs_=None, _locs_=None): + """Execute code in a namespace.""" + if _globs_ is None: + frame = sys._getframe(1) + _globs_ = frame.f_globals + if _locs_ is None: + _locs_ = frame.f_locals + del frame + elif _locs_ is None: + _locs_ = _globs_ + exec ("""exec _code_ in _globs_, _locs_""") + + exec_( + """def reraise(tp, value, tb=None): + try: + raise tp, value, tb + finally: + tb = None +""" + ) + + +if sys.version_info[:2] > (3,): + exec_( + """def raise_from(value, from_value): + try: + raise value from from_value + finally: + value = None +""" + ) +else: + + def raise_from(value, from_value): + raise value + + +print_ = getattr(moves.builtins, "print", None) +if print_ is None: + + def print_(*args, **kwargs): + """The new-style print function for Python 2.4 and 2.5.""" + fp = kwargs.pop("file", sys.stdout) + if fp is None: + return + + def write(data): + if not isinstance(data, basestring): + data = str(data) + # If the file has an encoding, encode unicode with it. + if ( + isinstance(fp, file) + and isinstance(data, unicode) + and fp.encoding is not None + ): + errors = getattr(fp, "errors", None) + if errors is None: + errors = "strict" + data = data.encode(fp.encoding, errors) + fp.write(data) + + want_unicode = False + sep = kwargs.pop("sep", None) + if sep is not None: + if isinstance(sep, unicode): + want_unicode = True + elif not isinstance(sep, str): + raise TypeError("sep must be None or a string") + end = kwargs.pop("end", None) + if end is not None: + if isinstance(end, unicode): + want_unicode = True + elif not isinstance(end, str): + raise TypeError("end must be None or a string") + if kwargs: + raise TypeError("invalid keyword arguments to print()") + if not want_unicode: + for arg in args: + if isinstance(arg, unicode): + want_unicode = True + break + if want_unicode: + newline = unicode("\n") + space = unicode(" ") + else: + newline = "\n" + space = " " + if sep is None: + sep = space + if end is None: + end = newline + for i, arg in enumerate(args): + if i: + write(sep) + write(arg) + write(end) + + +if sys.version_info[:2] < (3, 3): + _print = print_ + + def print_(*args, **kwargs): + fp = kwargs.get("file", sys.stdout) + flush = kwargs.pop("flush", False) + _print(*args, **kwargs) + if flush and fp is not None: + fp.flush() + + +_add_doc(reraise, """Reraise an exception.""") + +if sys.version_info[0:2] < (3, 4): + # This does exactly the same what the :func:`py3:functools.update_wrapper` + # function does on Python versions after 3.2. It sets the ``__wrapped__`` + # attribute on ``wrapper`` object and it doesn't raise an error if any of + # the attributes mentioned in ``assigned`` and ``updated`` are missing on + # ``wrapped`` object. + def _update_wrapper( + wrapper, + wrapped, + assigned=functools.WRAPPER_ASSIGNMENTS, + updated=functools.WRAPPER_UPDATES, + ): + for attr in assigned: + try: + value = getattr(wrapped, attr) + except AttributeError: + continue + else: + setattr(wrapper, attr, value) + for attr in updated: + getattr(wrapper, attr).update(getattr(wrapped, attr, {})) + wrapper.__wrapped__ = wrapped + return wrapper + + _update_wrapper.__doc__ = functools.update_wrapper.__doc__ + + def wraps( + wrapped, + assigned=functools.WRAPPER_ASSIGNMENTS, + updated=functools.WRAPPER_UPDATES, + ): + return functools.partial( + _update_wrapper, wrapped=wrapped, assigned=assigned, updated=updated + ) + + wraps.__doc__ = functools.wraps.__doc__ + +else: + wraps = functools.wraps + + +def with_metaclass(meta, *bases): + """Create a base class with a metaclass.""" + # This requires a bit of explanation: the basic idea is to make a dummy + # metaclass for one level of class instantiation that replaces itself with + # the actual metaclass. + class metaclass(type): + def __new__(cls, name, this_bases, d): + if sys.version_info[:2] >= (3, 7): + # This version introduced PEP 560 that requires a bit + # of extra care (we mimic what is done by __build_class__). + resolved_bases = types.resolve_bases(bases) + if resolved_bases is not bases: + d["__orig_bases__"] = bases + else: + resolved_bases = bases + return meta(name, resolved_bases, d) + + @classmethod + def __prepare__(cls, name, this_bases): + return meta.__prepare__(name, bases) + + return type.__new__(metaclass, "temporary_class", (), {}) + + +def add_metaclass(metaclass): + """Class decorator for creating a class with a metaclass.""" + + def wrapper(cls): + orig_vars = cls.__dict__.copy() + slots = orig_vars.get("__slots__") + if slots is not None: + if isinstance(slots, str): + slots = [slots] + for slots_var in slots: + orig_vars.pop(slots_var) + orig_vars.pop("__dict__", None) + orig_vars.pop("__weakref__", None) + if hasattr(cls, "__qualname__"): + orig_vars["__qualname__"] = cls.__qualname__ + return metaclass(cls.__name__, cls.__bases__, orig_vars) + + return wrapper + + +def ensure_binary(s, encoding="utf-8", errors="strict"): + """Coerce **s** to six.binary_type. + + For Python 2: + - `unicode` -> encoded to `str` + - `str` -> `str` + + For Python 3: + - `str` -> encoded to `bytes` + - `bytes` -> `bytes` + """ + if isinstance(s, binary_type): + return s + if isinstance(s, text_type): + return s.encode(encoding, errors) + raise TypeError("not expecting type '%s'" % type(s)) + + +def ensure_str(s, encoding="utf-8", errors="strict"): + """Coerce *s* to `str`. + + For Python 2: + - `unicode` -> encoded to `str` + - `str` -> `str` + + For Python 3: + - `str` -> `str` + - `bytes` -> decoded to `str` + """ + # Optimization: Fast return for the common case. + if type(s) is str: + return s + if PY2 and isinstance(s, text_type): + return s.encode(encoding, errors) + elif PY3 and isinstance(s, binary_type): + return s.decode(encoding, errors) + elif not isinstance(s, (text_type, binary_type)): + raise TypeError("not expecting type '%s'" % type(s)) + return s + + +def ensure_text(s, encoding="utf-8", errors="strict"): + """Coerce *s* to six.text_type. + + For Python 2: + - `unicode` -> `unicode` + - `str` -> `unicode` + + For Python 3: + - `str` -> `str` + - `bytes` -> decoded to `str` + """ + if isinstance(s, binary_type): + return s.decode(encoding, errors) + elif isinstance(s, text_type): + return s + else: + raise TypeError("not expecting type '%s'" % type(s)) + + +def python_2_unicode_compatible(klass): + """ + A class decorator that defines __unicode__ and __str__ methods under Python 2. + Under Python 3 it does nothing. + + To support Python 2 and 3 with a single code base, define a __str__ method + returning text and apply this decorator to the class. + """ + if PY2: + if "__str__" not in klass.__dict__: + raise ValueError( + "@python_2_unicode_compatible cannot be applied " + "to %s because it doesn't define __str__()." % klass.__name__ + ) + klass.__unicode__ = klass.__str__ + klass.__str__ = lambda self: self.__unicode__().encode("utf-8") + return klass + + +# Complete the moves implementation. +# This code is at the end of this module to speed up module loading. +# Turn this module into a package. +__path__ = [] # required for PEP 302 and PEP 451 +__package__ = __name__ # see PEP 366 @ReservedAssignment +if globals().get("__spec__") is not None: + __spec__.submodule_search_locations = [] # PEP 451 @UndefinedVariable +# Remove other six meta path importers, since they cause problems. This can +# happen if six is removed from sys.modules and then reloaded. (Setuptools does +# this for some reason.) +if sys.meta_path: + for i, importer in enumerate(sys.meta_path): + # Here's some real nastiness: Another "instance" of the six module might + # be floating around. Therefore, we can't use isinstance() to check for + # the six meta path importer, since the other six instance will have + # inserted an importer with different class. + if ( + type(importer).__name__ == "_SixMetaPathImporter" + and importer.name == __name__ + ): + del sys.meta_path[i] + break + del i, importer +# Finally, add the importer to the meta path import hook. +sys.meta_path.append(_importer) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/poolmanager.py b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/poolmanager.py new file mode 100644 index 0000000..fb51bf7 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/poolmanager.py @@ -0,0 +1,540 @@ +from __future__ import absolute_import + +import collections +import functools +import logging + +from ._collections import HTTPHeaderDict, RecentlyUsedContainer +from .connectionpool import HTTPConnectionPool, HTTPSConnectionPool, port_by_scheme +from .exceptions import ( + LocationValueError, + MaxRetryError, + ProxySchemeUnknown, + ProxySchemeUnsupported, + URLSchemeUnknown, +) +from .packages import six +from .packages.six.moves.urllib.parse import urljoin +from .request import RequestMethods +from .util.proxy import connection_requires_http_tunnel +from .util.retry import Retry +from .util.url import parse_url + +__all__ = ["PoolManager", "ProxyManager", "proxy_from_url"] + + +log = logging.getLogger(__name__) + +SSL_KEYWORDS = ( + "key_file", + "cert_file", + "cert_reqs", + "ca_certs", + "ssl_version", + "ca_cert_dir", + "ssl_context", + "key_password", + "server_hostname", +) + +# All known keyword arguments that could be provided to the pool manager, its +# pools, or the underlying connections. This is used to construct a pool key. +_key_fields = ( + "key_scheme", # str + "key_host", # str + "key_port", # int + "key_timeout", # int or float or Timeout + "key_retries", # int or Retry + "key_strict", # bool + "key_block", # bool + "key_source_address", # str + "key_key_file", # str + "key_key_password", # str + "key_cert_file", # str + "key_cert_reqs", # str + "key_ca_certs", # str + "key_ssl_version", # str + "key_ca_cert_dir", # str + "key_ssl_context", # instance of ssl.SSLContext or urllib3.util.ssl_.SSLContext + "key_maxsize", # int + "key_headers", # dict + "key__proxy", # parsed proxy url + "key__proxy_headers", # dict + "key__proxy_config", # class + "key_socket_options", # list of (level (int), optname (int), value (int or str)) tuples + "key__socks_options", # dict + "key_assert_hostname", # bool or string + "key_assert_fingerprint", # str + "key_server_hostname", # str +) + +#: The namedtuple class used to construct keys for the connection pool. +#: All custom key schemes should include the fields in this key at a minimum. +PoolKey = collections.namedtuple("PoolKey", _key_fields) + +_proxy_config_fields = ("ssl_context", "use_forwarding_for_https") +ProxyConfig = collections.namedtuple("ProxyConfig", _proxy_config_fields) + + +def _default_key_normalizer(key_class, request_context): + """ + Create a pool key out of a request context dictionary. + + According to RFC 3986, both the scheme and host are case-insensitive. + Therefore, this function normalizes both before constructing the pool + key for an HTTPS request. If you wish to change this behaviour, provide + alternate callables to ``key_fn_by_scheme``. + + :param key_class: + The class to use when constructing the key. This should be a namedtuple + with the ``scheme`` and ``host`` keys at a minimum. + :type key_class: namedtuple + :param request_context: + A dictionary-like object that contain the context for a request. + :type request_context: dict + + :return: A namedtuple that can be used as a connection pool key. + :rtype: PoolKey + """ + # Since we mutate the dictionary, make a copy first + context = request_context.copy() + context["scheme"] = context["scheme"].lower() + context["host"] = context["host"].lower() + + # These are both dictionaries and need to be transformed into frozensets + for key in ("headers", "_proxy_headers", "_socks_options"): + if key in context and context[key] is not None: + context[key] = frozenset(context[key].items()) + + # The socket_options key may be a list and needs to be transformed into a + # tuple. + socket_opts = context.get("socket_options") + if socket_opts is not None: + context["socket_options"] = tuple(socket_opts) + + # Map the kwargs to the names in the namedtuple - this is necessary since + # namedtuples can't have fields starting with '_'. + for key in list(context.keys()): + context["key_" + key] = context.pop(key) + + # Default to ``None`` for keys missing from the context + for field in key_class._fields: + if field not in context: + context[field] = None + + return key_class(**context) + + +#: A dictionary that maps a scheme to a callable that creates a pool key. +#: This can be used to alter the way pool keys are constructed, if desired. +#: Each PoolManager makes a copy of this dictionary so they can be configured +#: globally here, or individually on the instance. +key_fn_by_scheme = { + "http": functools.partial(_default_key_normalizer, PoolKey), + "https": functools.partial(_default_key_normalizer, PoolKey), +} + +pool_classes_by_scheme = {"http": HTTPConnectionPool, "https": HTTPSConnectionPool} + + +class PoolManager(RequestMethods): + """ + Allows for arbitrary requests while transparently keeping track of + necessary connection pools for you. + + :param num_pools: + Number of connection pools to cache before discarding the least + recently used pool. + + :param headers: + Headers to include with all requests, unless other headers are given + explicitly. + + :param \\**connection_pool_kw: + Additional parameters are used to create fresh + :class:`urllib3.connectionpool.ConnectionPool` instances. + + Example:: + + >>> manager = PoolManager(num_pools=2) + >>> r = manager.request('GET', 'http://google.com/') + >>> r = manager.request('GET', 'http://google.com/mail') + >>> r = manager.request('GET', 'http://yahoo.com/') + >>> len(manager.pools) + 2 + + """ + + proxy = None + proxy_config = None + + def __init__(self, num_pools=10, headers=None, **connection_pool_kw): + RequestMethods.__init__(self, headers) + self.connection_pool_kw = connection_pool_kw + self.pools = RecentlyUsedContainer(num_pools) + + # Locally set the pool classes and keys so other PoolManagers can + # override them. + self.pool_classes_by_scheme = pool_classes_by_scheme + self.key_fn_by_scheme = key_fn_by_scheme.copy() + + def __enter__(self): + return self + + def __exit__(self, exc_type, exc_val, exc_tb): + self.clear() + # Return False to re-raise any potential exceptions + return False + + def _new_pool(self, scheme, host, port, request_context=None): + """ + Create a new :class:`urllib3.connectionpool.ConnectionPool` based on host, port, scheme, and + any additional pool keyword arguments. + + If ``request_context`` is provided, it is provided as keyword arguments + to the pool class used. This method is used to actually create the + connection pools handed out by :meth:`connection_from_url` and + companion methods. It is intended to be overridden for customization. + """ + pool_cls = self.pool_classes_by_scheme[scheme] + if request_context is None: + request_context = self.connection_pool_kw.copy() + + # Although the context has everything necessary to create the pool, + # this function has historically only used the scheme, host, and port + # in the positional args. When an API change is acceptable these can + # be removed. + for key in ("scheme", "host", "port"): + request_context.pop(key, None) + + if scheme == "http": + for kw in SSL_KEYWORDS: + request_context.pop(kw, None) + + return pool_cls(host, port, **request_context) + + def clear(self): + """ + Empty our store of pools and direct them all to close. + + This will not affect in-flight connections, but they will not be + re-used after completion. + """ + self.pools.clear() + + def connection_from_host(self, host, port=None, scheme="http", pool_kwargs=None): + """ + Get a :class:`urllib3.connectionpool.ConnectionPool` based on the host, port, and scheme. + + If ``port`` isn't given, it will be derived from the ``scheme`` using + ``urllib3.connectionpool.port_by_scheme``. If ``pool_kwargs`` is + provided, it is merged with the instance's ``connection_pool_kw`` + variable and used to create the new connection pool, if one is + needed. + """ + + if not host: + raise LocationValueError("No host specified.") + + request_context = self._merge_pool_kwargs(pool_kwargs) + request_context["scheme"] = scheme or "http" + if not port: + port = port_by_scheme.get(request_context["scheme"].lower(), 80) + request_context["port"] = port + request_context["host"] = host + + return self.connection_from_context(request_context) + + def connection_from_context(self, request_context): + """ + Get a :class:`urllib3.connectionpool.ConnectionPool` based on the request context. + + ``request_context`` must at least contain the ``scheme`` key and its + value must be a key in ``key_fn_by_scheme`` instance variable. + """ + scheme = request_context["scheme"].lower() + pool_key_constructor = self.key_fn_by_scheme.get(scheme) + if not pool_key_constructor: + raise URLSchemeUnknown(scheme) + pool_key = pool_key_constructor(request_context) + + return self.connection_from_pool_key(pool_key, request_context=request_context) + + def connection_from_pool_key(self, pool_key, request_context=None): + """ + Get a :class:`urllib3.connectionpool.ConnectionPool` based on the provided pool key. + + ``pool_key`` should be a namedtuple that only contains immutable + objects. At a minimum it must have the ``scheme``, ``host``, and + ``port`` fields. + """ + with self.pools.lock: + # If the scheme, host, or port doesn't match existing open + # connections, open a new ConnectionPool. + pool = self.pools.get(pool_key) + if pool: + return pool + + # Make a fresh ConnectionPool of the desired type + scheme = request_context["scheme"] + host = request_context["host"] + port = request_context["port"] + pool = self._new_pool(scheme, host, port, request_context=request_context) + self.pools[pool_key] = pool + + return pool + + def connection_from_url(self, url, pool_kwargs=None): + """ + Similar to :func:`urllib3.connectionpool.connection_from_url`. + + If ``pool_kwargs`` is not provided and a new pool needs to be + constructed, ``self.connection_pool_kw`` is used to initialize + the :class:`urllib3.connectionpool.ConnectionPool`. If ``pool_kwargs`` + is provided, it is used instead. Note that if a new pool does not + need to be created for the request, the provided ``pool_kwargs`` are + not used. + """ + u = parse_url(url) + return self.connection_from_host( + u.host, port=u.port, scheme=u.scheme, pool_kwargs=pool_kwargs + ) + + def _merge_pool_kwargs(self, override): + """ + Merge a dictionary of override values for self.connection_pool_kw. + + This does not modify self.connection_pool_kw and returns a new dict. + Any keys in the override dictionary with a value of ``None`` are + removed from the merged dictionary. + """ + base_pool_kwargs = self.connection_pool_kw.copy() + if override: + for key, value in override.items(): + if value is None: + try: + del base_pool_kwargs[key] + except KeyError: + pass + else: + base_pool_kwargs[key] = value + return base_pool_kwargs + + def _proxy_requires_url_absolute_form(self, parsed_url): + """ + Indicates if the proxy requires the complete destination URL in the + request. Normally this is only needed when not using an HTTP CONNECT + tunnel. + """ + if self.proxy is None: + return False + + return not connection_requires_http_tunnel( + self.proxy, self.proxy_config, parsed_url.scheme + ) + + def _validate_proxy_scheme_url_selection(self, url_scheme): + """ + Validates that were not attempting to do TLS in TLS connections on + Python2 or with unsupported SSL implementations. + """ + if self.proxy is None or url_scheme != "https": + return + + if self.proxy.scheme != "https": + return + + if six.PY2 and not self.proxy_config.use_forwarding_for_https: + raise ProxySchemeUnsupported( + "Contacting HTTPS destinations through HTTPS proxies " + "'via CONNECT tunnels' is not supported in Python 2" + ) + + def urlopen(self, method, url, redirect=True, **kw): + """ + Same as :meth:`urllib3.HTTPConnectionPool.urlopen` + with custom cross-host redirect logic and only sends the request-uri + portion of the ``url``. + + The given ``url`` parameter must be absolute, such that an appropriate + :class:`urllib3.connectionpool.ConnectionPool` can be chosen for it. + """ + u = parse_url(url) + self._validate_proxy_scheme_url_selection(u.scheme) + + conn = self.connection_from_host(u.host, port=u.port, scheme=u.scheme) + + kw["assert_same_host"] = False + kw["redirect"] = False + + if "headers" not in kw: + kw["headers"] = self.headers.copy() + + if self._proxy_requires_url_absolute_form(u): + response = conn.urlopen(method, url, **kw) + else: + response = conn.urlopen(method, u.request_uri, **kw) + + redirect_location = redirect and response.get_redirect_location() + if not redirect_location: + return response + + # Support relative URLs for redirecting. + redirect_location = urljoin(url, redirect_location) + + if response.status == 303: + # Change the method according to RFC 9110, Section 15.4.4. + method = "GET" + # And lose the body not to transfer anything sensitive. + kw["body"] = None + kw["headers"] = HTTPHeaderDict(kw["headers"])._prepare_for_method_change() + + retries = kw.get("retries") + if not isinstance(retries, Retry): + retries = Retry.from_int(retries, redirect=redirect) + + # Strip headers marked as unsafe to forward to the redirected location. + # Check remove_headers_on_redirect to avoid a potential network call within + # conn.is_same_host() which may use socket.gethostbyname() in the future. + if retries.remove_headers_on_redirect and not conn.is_same_host( + redirect_location + ): + headers = list(six.iterkeys(kw["headers"])) + for header in headers: + if header.lower() in retries.remove_headers_on_redirect: + kw["headers"].pop(header, None) + + try: + retries = retries.increment(method, url, response=response, _pool=conn) + except MaxRetryError: + if retries.raise_on_redirect: + response.drain_conn() + raise + return response + + kw["retries"] = retries + kw["redirect"] = redirect + + log.info("Redirecting %s -> %s", url, redirect_location) + + response.drain_conn() + return self.urlopen(method, redirect_location, **kw) + + +class ProxyManager(PoolManager): + """ + Behaves just like :class:`PoolManager`, but sends all requests through + the defined proxy, using the CONNECT method for HTTPS URLs. + + :param proxy_url: + The URL of the proxy to be used. + + :param proxy_headers: + A dictionary containing headers that will be sent to the proxy. In case + of HTTP they are being sent with each request, while in the + HTTPS/CONNECT case they are sent only once. Could be used for proxy + authentication. + + :param proxy_ssl_context: + The proxy SSL context is used to establish the TLS connection to the + proxy when using HTTPS proxies. + + :param use_forwarding_for_https: + (Defaults to False) If set to True will forward requests to the HTTPS + proxy to be made on behalf of the client instead of creating a TLS + tunnel via the CONNECT method. **Enabling this flag means that request + and response headers and content will be visible from the HTTPS proxy** + whereas tunneling keeps request and response headers and content + private. IP address, target hostname, SNI, and port are always visible + to an HTTPS proxy even when this flag is disabled. + + Example: + >>> proxy = urllib3.ProxyManager('http://localhost:3128/') + >>> r1 = proxy.request('GET', 'http://google.com/') + >>> r2 = proxy.request('GET', 'http://httpbin.org/') + >>> len(proxy.pools) + 1 + >>> r3 = proxy.request('GET', 'https://httpbin.org/') + >>> r4 = proxy.request('GET', 'https://twitter.com/') + >>> len(proxy.pools) + 3 + + """ + + def __init__( + self, + proxy_url, + num_pools=10, + headers=None, + proxy_headers=None, + proxy_ssl_context=None, + use_forwarding_for_https=False, + **connection_pool_kw + ): + + if isinstance(proxy_url, HTTPConnectionPool): + proxy_url = "%s://%s:%i" % ( + proxy_url.scheme, + proxy_url.host, + proxy_url.port, + ) + proxy = parse_url(proxy_url) + + if proxy.scheme not in ("http", "https"): + raise ProxySchemeUnknown(proxy.scheme) + + if not proxy.port: + port = port_by_scheme.get(proxy.scheme, 80) + proxy = proxy._replace(port=port) + + self.proxy = proxy + self.proxy_headers = proxy_headers or {} + self.proxy_ssl_context = proxy_ssl_context + self.proxy_config = ProxyConfig(proxy_ssl_context, use_forwarding_for_https) + + connection_pool_kw["_proxy"] = self.proxy + connection_pool_kw["_proxy_headers"] = self.proxy_headers + connection_pool_kw["_proxy_config"] = self.proxy_config + + super(ProxyManager, self).__init__(num_pools, headers, **connection_pool_kw) + + def connection_from_host(self, host, port=None, scheme="http", pool_kwargs=None): + if scheme == "https": + return super(ProxyManager, self).connection_from_host( + host, port, scheme, pool_kwargs=pool_kwargs + ) + + return super(ProxyManager, self).connection_from_host( + self.proxy.host, self.proxy.port, self.proxy.scheme, pool_kwargs=pool_kwargs + ) + + def _set_proxy_headers(self, url, headers=None): + """ + Sets headers needed by proxies: specifically, the Accept and Host + headers. Only sets headers not provided by the user. + """ + headers_ = {"Accept": "*/*"} + + netloc = parse_url(url).netloc + if netloc: + headers_["Host"] = netloc + + if headers: + headers_.update(headers) + return headers_ + + def urlopen(self, method, url, redirect=True, **kw): + "Same as HTTP(S)ConnectionPool.urlopen, ``url`` must be absolute." + u = parse_url(url) + if not connection_requires_http_tunnel(self.proxy, self.proxy_config, u.scheme): + # For connections using HTTP CONNECT, httplib sets the necessary + # headers on the CONNECT to the proxy. If we're not using CONNECT, + # we'll definitely need to set 'Host' at the very least. + headers = kw.get("headers", self.headers) + kw["headers"] = self._set_proxy_headers(url, headers) + + return super(ProxyManager, self).urlopen(method, url, redirect=redirect, **kw) + + +def proxy_from_url(url, **kw): + return ProxyManager(proxy_url=url, **kw) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/request.py b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/request.py new file mode 100644 index 0000000..3b4cf99 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/request.py @@ -0,0 +1,191 @@ +from __future__ import absolute_import + +import sys + +from .filepost import encode_multipart_formdata +from .packages import six +from .packages.six.moves.urllib.parse import urlencode + +__all__ = ["RequestMethods"] + + +class RequestMethods(object): + """ + Convenience mixin for classes who implement a :meth:`urlopen` method, such + as :class:`urllib3.HTTPConnectionPool` and + :class:`urllib3.PoolManager`. + + Provides behavior for making common types of HTTP request methods and + decides which type of request field encoding to use. + + Specifically, + + :meth:`.request_encode_url` is for sending requests whose fields are + encoded in the URL (such as GET, HEAD, DELETE). + + :meth:`.request_encode_body` is for sending requests whose fields are + encoded in the *body* of the request using multipart or www-form-urlencoded + (such as for POST, PUT, PATCH). + + :meth:`.request` is for making any kind of request, it will look up the + appropriate encoding format and use one of the above two methods to make + the request. + + Initializer parameters: + + :param headers: + Headers to include with all requests, unless other headers are given + explicitly. + """ + + _encode_url_methods = {"DELETE", "GET", "HEAD", "OPTIONS"} + + def __init__(self, headers=None): + self.headers = headers or {} + + def urlopen( + self, + method, + url, + body=None, + headers=None, + encode_multipart=True, + multipart_boundary=None, + **kw + ): # Abstract + raise NotImplementedError( + "Classes extending RequestMethods must implement " + "their own ``urlopen`` method." + ) + + def request(self, method, url, fields=None, headers=None, **urlopen_kw): + """ + Make a request using :meth:`urlopen` with the appropriate encoding of + ``fields`` based on the ``method`` used. + + This is a convenience method that requires the least amount of manual + effort. It can be used in most situations, while still having the + option to drop down to more specific methods when necessary, such as + :meth:`request_encode_url`, :meth:`request_encode_body`, + or even the lowest level :meth:`urlopen`. + """ + method = method.upper() + + urlopen_kw["request_url"] = url + + if method in self._encode_url_methods: + return self.request_encode_url( + method, url, fields=fields, headers=headers, **urlopen_kw + ) + else: + return self.request_encode_body( + method, url, fields=fields, headers=headers, **urlopen_kw + ) + + def request_encode_url(self, method, url, fields=None, headers=None, **urlopen_kw): + """ + Make a request using :meth:`urlopen` with the ``fields`` encoded in + the url. This is useful for request methods like GET, HEAD, DELETE, etc. + """ + if headers is None: + headers = self.headers + + extra_kw = {"headers": headers} + extra_kw.update(urlopen_kw) + + if fields: + url += "?" + urlencode(fields) + + return self.urlopen(method, url, **extra_kw) + + def request_encode_body( + self, + method, + url, + fields=None, + headers=None, + encode_multipart=True, + multipart_boundary=None, + **urlopen_kw + ): + """ + Make a request using :meth:`urlopen` with the ``fields`` encoded in + the body. This is useful for request methods like POST, PUT, PATCH, etc. + + When ``encode_multipart=True`` (default), then + :func:`urllib3.encode_multipart_formdata` is used to encode + the payload with the appropriate content type. Otherwise + :func:`urllib.parse.urlencode` is used with the + 'application/x-www-form-urlencoded' content type. + + Multipart encoding must be used when posting files, and it's reasonably + safe to use it in other times too. However, it may break request + signing, such as with OAuth. + + Supports an optional ``fields`` parameter of key/value strings AND + key/filetuple. A filetuple is a (filename, data, MIME type) tuple where + the MIME type is optional. For example:: + + fields = { + 'foo': 'bar', + 'fakefile': ('foofile.txt', 'contents of foofile'), + 'realfile': ('barfile.txt', open('realfile').read()), + 'typedfile': ('bazfile.bin', open('bazfile').read(), + 'image/jpeg'), + 'nonamefile': 'contents of nonamefile field', + } + + When uploading a file, providing a filename (the first parameter of the + tuple) is optional but recommended to best mimic behavior of browsers. + + Note that if ``headers`` are supplied, the 'Content-Type' header will + be overwritten because it depends on the dynamic random boundary string + which is used to compose the body of the request. The random boundary + string can be explicitly set with the ``multipart_boundary`` parameter. + """ + if headers is None: + headers = self.headers + + extra_kw = {"headers": {}} + + if fields: + if "body" in urlopen_kw: + raise TypeError( + "request got values for both 'fields' and 'body', can only specify one." + ) + + if encode_multipart: + body, content_type = encode_multipart_formdata( + fields, boundary=multipart_boundary + ) + else: + body, content_type = ( + urlencode(fields), + "application/x-www-form-urlencoded", + ) + + extra_kw["body"] = body + extra_kw["headers"] = {"Content-Type": content_type} + + extra_kw["headers"].update(headers) + extra_kw.update(urlopen_kw) + + return self.urlopen(method, url, **extra_kw) + + +if not six.PY2: + + class RequestModule(sys.modules[__name__].__class__): + def __call__(self, *args, **kwargs): + """ + If user tries to call this module directly urllib3 v2.x style raise an error to the user + suggesting they may need urllib3 v2 + """ + raise TypeError( + "'module' object is not callable\n" + "urllib3.request() method is not supported in this release, " + "upgrade to urllib3 v2 to use it\n" + "see https://urllib3.readthedocs.io/en/stable/v2-migration-guide.html" + ) + + sys.modules[__name__].__class__ = RequestModule diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/response.py b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/response.py new file mode 100644 index 0000000..8909f84 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/response.py @@ -0,0 +1,879 @@ +from __future__ import absolute_import + +import io +import logging +import sys +import warnings +import zlib +from contextlib import contextmanager +from socket import error as SocketError +from socket import timeout as SocketTimeout + +brotli = None + +from . import util +from ._collections import HTTPHeaderDict +from .connection import BaseSSLError, HTTPException +from .exceptions import ( + BodyNotHttplibCompatible, + DecodeError, + HTTPError, + IncompleteRead, + InvalidChunkLength, + InvalidHeader, + ProtocolError, + ReadTimeoutError, + ResponseNotChunked, + SSLError, +) +from .packages import six +from .util.response import is_fp_closed, is_response_to_head + +log = logging.getLogger(__name__) + + +class DeflateDecoder(object): + def __init__(self): + self._first_try = True + self._data = b"" + self._obj = zlib.decompressobj() + + def __getattr__(self, name): + return getattr(self._obj, name) + + def decompress(self, data): + if not data: + return data + + if not self._first_try: + return self._obj.decompress(data) + + self._data += data + try: + decompressed = self._obj.decompress(data) + if decompressed: + self._first_try = False + self._data = None + return decompressed + except zlib.error: + self._first_try = False + self._obj = zlib.decompressobj(-zlib.MAX_WBITS) + try: + return self.decompress(self._data) + finally: + self._data = None + + +class GzipDecoderState(object): + + FIRST_MEMBER = 0 + OTHER_MEMBERS = 1 + SWALLOW_DATA = 2 + + +class GzipDecoder(object): + def __init__(self): + self._obj = zlib.decompressobj(16 + zlib.MAX_WBITS) + self._state = GzipDecoderState.FIRST_MEMBER + + def __getattr__(self, name): + return getattr(self._obj, name) + + def decompress(self, data): + ret = bytearray() + if self._state == GzipDecoderState.SWALLOW_DATA or not data: + return bytes(ret) + while True: + try: + ret += self._obj.decompress(data) + except zlib.error: + previous_state = self._state + # Ignore data after the first error + self._state = GzipDecoderState.SWALLOW_DATA + if previous_state == GzipDecoderState.OTHER_MEMBERS: + # Allow trailing garbage acceptable in other gzip clients + return bytes(ret) + raise + data = self._obj.unused_data + if not data: + return bytes(ret) + self._state = GzipDecoderState.OTHER_MEMBERS + self._obj = zlib.decompressobj(16 + zlib.MAX_WBITS) + + +if brotli is not None: + + class BrotliDecoder(object): + # Supports both 'brotlipy' and 'Brotli' packages + # since they share an import name. The top branches + # are for 'brotlipy' and bottom branches for 'Brotli' + def __init__(self): + self._obj = brotli.Decompressor() + if hasattr(self._obj, "decompress"): + self.decompress = self._obj.decompress + else: + self.decompress = self._obj.process + + def flush(self): + if hasattr(self._obj, "flush"): + return self._obj.flush() + return b"" + + +class MultiDecoder(object): + """ + From RFC7231: + If one or more encodings have been applied to a representation, the + sender that applied the encodings MUST generate a Content-Encoding + header field that lists the content codings in the order in which + they were applied. + """ + + def __init__(self, modes): + self._decoders = [_get_decoder(m.strip()) for m in modes.split(",")] + + def flush(self): + return self._decoders[0].flush() + + def decompress(self, data): + for d in reversed(self._decoders): + data = d.decompress(data) + return data + + +def _get_decoder(mode): + if "," in mode: + return MultiDecoder(mode) + + if mode == "gzip": + return GzipDecoder() + + if brotli is not None and mode == "br": + return BrotliDecoder() + + return DeflateDecoder() + + +class HTTPResponse(io.IOBase): + """ + HTTP Response container. + + Backwards-compatible with :class:`http.client.HTTPResponse` but the response ``body`` is + loaded and decoded on-demand when the ``data`` property is accessed. This + class is also compatible with the Python standard library's :mod:`io` + module, and can hence be treated as a readable object in the context of that + framework. + + Extra parameters for behaviour not present in :class:`http.client.HTTPResponse`: + + :param preload_content: + If True, the response's body will be preloaded during construction. + + :param decode_content: + If True, will attempt to decode the body based on the + 'content-encoding' header. + + :param original_response: + When this HTTPResponse wrapper is generated from an :class:`http.client.HTTPResponse` + object, it's convenient to include the original for debug purposes. It's + otherwise unused. + + :param retries: + The retries contains the last :class:`~urllib3.util.retry.Retry` that + was used during the request. + + :param enforce_content_length: + Enforce content length checking. Body returned by server must match + value of Content-Length header, if present. Otherwise, raise error. + """ + + CONTENT_DECODERS = ["gzip", "deflate"] + if brotli is not None: + CONTENT_DECODERS += ["br"] + REDIRECT_STATUSES = [301, 302, 303, 307, 308] + + def __init__( + self, + body="", + headers=None, + status=0, + version=0, + reason=None, + strict=0, + preload_content=True, + decode_content=True, + original_response=None, + pool=None, + connection=None, + msg=None, + retries=None, + enforce_content_length=False, + request_method=None, + request_url=None, + auto_close=True, + ): + + if isinstance(headers, HTTPHeaderDict): + self.headers = headers + else: + self.headers = HTTPHeaderDict(headers) + self.status = status + self.version = version + self.reason = reason + self.strict = strict + self.decode_content = decode_content + self.retries = retries + self.enforce_content_length = enforce_content_length + self.auto_close = auto_close + + self._decoder = None + self._body = None + self._fp = None + self._original_response = original_response + self._fp_bytes_read = 0 + self.msg = msg + self._request_url = request_url + + if body and isinstance(body, (six.string_types, bytes)): + self._body = body + + self._pool = pool + self._connection = connection + + if hasattr(body, "read"): + self._fp = body + + # Are we using the chunked-style of transfer encoding? + self.chunked = False + self.chunk_left = None + tr_enc = self.headers.get("transfer-encoding", "").lower() + # Don't incur the penalty of creating a list and then discarding it + encodings = (enc.strip() for enc in tr_enc.split(",")) + if "chunked" in encodings: + self.chunked = True + + # Determine length of response + self.length_remaining = self._init_length(request_method) + + # If requested, preload the body. + if preload_content and not self._body: + self._body = self.read(decode_content=decode_content) + + def get_redirect_location(self): + """ + Should we redirect and where to? + + :returns: Truthy redirect location string if we got a redirect status + code and valid location. ``None`` if redirect status and no + location. ``False`` if not a redirect status code. + """ + if self.status in self.REDIRECT_STATUSES: + return self.headers.get("location") + + return False + + def release_conn(self): + if not self._pool or not self._connection: + return + + self._pool._put_conn(self._connection) + self._connection = None + + def drain_conn(self): + """ + Read and discard any remaining HTTP response data in the response connection. + + Unread data in the HTTPResponse connection blocks the connection from being released back to the pool. + """ + try: + self.read() + except (HTTPError, SocketError, BaseSSLError, HTTPException): + pass + + @property + def data(self): + # For backwards-compat with earlier urllib3 0.4 and earlier. + if self._body: + return self._body + + if self._fp: + return self.read(cache_content=True) + + @property + def connection(self): + return self._connection + + def isclosed(self): + return is_fp_closed(self._fp) + + def tell(self): + """ + Obtain the number of bytes pulled over the wire so far. May differ from + the amount of content returned by :meth:``urllib3.response.HTTPResponse.read`` + if bytes are encoded on the wire (e.g, compressed). + """ + return self._fp_bytes_read + + def _init_length(self, request_method): + """ + Set initial length value for Response content if available. + """ + length = self.headers.get("content-length") + + if length is not None: + if self.chunked: + # This Response will fail with an IncompleteRead if it can't be + # received as chunked. This method falls back to attempt reading + # the response before raising an exception. + log.warning( + "Received response with both Content-Length and " + "Transfer-Encoding set. This is expressly forbidden " + "by RFC 7230 sec 3.3.2. Ignoring Content-Length and " + "attempting to process response as Transfer-Encoding: " + "chunked." + ) + return None + + try: + # RFC 7230 section 3.3.2 specifies multiple content lengths can + # be sent in a single Content-Length header + # (e.g. Content-Length: 42, 42). This line ensures the values + # are all valid ints and that as long as the `set` length is 1, + # all values are the same. Otherwise, the header is invalid. + lengths = set([int(val) for val in length.split(",")]) + if len(lengths) > 1: + raise InvalidHeader( + "Content-Length contained multiple " + "unmatching values (%s)" % length + ) + length = lengths.pop() + except ValueError: + length = None + else: + if length < 0: + length = None + + # Convert status to int for comparison + # In some cases, httplib returns a status of "_UNKNOWN" + try: + status = int(self.status) + except ValueError: + status = 0 + + # Check for responses that shouldn't include a body + if status in (204, 304) or 100 <= status < 200 or request_method == "HEAD": + length = 0 + + return length + + def _init_decoder(self): + """ + Set-up the _decoder attribute if necessary. + """ + # Note: content-encoding value should be case-insensitive, per RFC 7230 + # Section 3.2 + content_encoding = self.headers.get("content-encoding", "").lower() + if self._decoder is None: + if content_encoding in self.CONTENT_DECODERS: + self._decoder = _get_decoder(content_encoding) + elif "," in content_encoding: + encodings = [ + e.strip() + for e in content_encoding.split(",") + if e.strip() in self.CONTENT_DECODERS + ] + if len(encodings): + self._decoder = _get_decoder(content_encoding) + + DECODER_ERROR_CLASSES = (IOError, zlib.error) + if brotli is not None: + DECODER_ERROR_CLASSES += (brotli.error,) + + def _decode(self, data, decode_content, flush_decoder): + """ + Decode the data passed in and potentially flush the decoder. + """ + if not decode_content: + return data + + try: + if self._decoder: + data = self._decoder.decompress(data) + except self.DECODER_ERROR_CLASSES as e: + content_encoding = self.headers.get("content-encoding", "").lower() + raise DecodeError( + "Received response with content-encoding: %s, but " + "failed to decode it." % content_encoding, + e, + ) + if flush_decoder: + data += self._flush_decoder() + + return data + + def _flush_decoder(self): + """ + Flushes the decoder. Should only be called if the decoder is actually + being used. + """ + if self._decoder: + buf = self._decoder.decompress(b"") + return buf + self._decoder.flush() + + return b"" + + @contextmanager + def _error_catcher(self): + """ + Catch low-level python exceptions, instead re-raising urllib3 + variants, so that low-level exceptions are not leaked in the + high-level api. + + On exit, release the connection back to the pool. + """ + clean_exit = False + + try: + try: + yield + + except SocketTimeout: + # FIXME: Ideally we'd like to include the url in the ReadTimeoutError but + # there is yet no clean way to get at it from this context. + raise ReadTimeoutError(self._pool, None, "Read timed out.") + + except BaseSSLError as e: + # FIXME: Is there a better way to differentiate between SSLErrors? + if "read operation timed out" not in str(e): + # SSL errors related to framing/MAC get wrapped and reraised here + raise SSLError(e) + + raise ReadTimeoutError(self._pool, None, "Read timed out.") + + except (HTTPException, SocketError) as e: + # This includes IncompleteRead. + raise ProtocolError("Connection broken: %r" % e, e) + + # If no exception is thrown, we should avoid cleaning up + # unnecessarily. + clean_exit = True + finally: + # If we didn't terminate cleanly, we need to throw away our + # connection. + if not clean_exit: + # The response may not be closed but we're not going to use it + # anymore so close it now to ensure that the connection is + # released back to the pool. + if self._original_response: + self._original_response.close() + + # Closing the response may not actually be sufficient to close + # everything, so if we have a hold of the connection close that + # too. + if self._connection: + self._connection.close() + + # If we hold the original response but it's closed now, we should + # return the connection back to the pool. + if self._original_response and self._original_response.isclosed(): + self.release_conn() + + def _fp_read(self, amt): + """ + Read a response with the thought that reading the number of bytes + larger than can fit in a 32-bit int at a time via SSL in some + known cases leads to an overflow error that has to be prevented + if `amt` or `self.length_remaining` indicate that a problem may + happen. + + The known cases: + * 3.8 <= CPython < 3.9.7 because of a bug + https://github.com/urllib3/urllib3/issues/2513#issuecomment-1152559900. + * urllib3 injected with pyOpenSSL-backed SSL-support. + * CPython < 3.10 only when `amt` does not fit 32-bit int. + """ + assert self._fp + c_int_max = 2 ** 31 - 1 + if ( + ( + (amt and amt > c_int_max) + or (self.length_remaining and self.length_remaining > c_int_max) + ) + and not util.IS_SECURETRANSPORT + and (util.IS_PYOPENSSL or sys.version_info < (3, 10)) + ): + buffer = io.BytesIO() + # Besides `max_chunk_amt` being a maximum chunk size, it + # affects memory overhead of reading a response by this + # method in CPython. + # `c_int_max` equal to 2 GiB - 1 byte is the actual maximum + # chunk size that does not lead to an overflow error, but + # 256 MiB is a compromise. + max_chunk_amt = 2 ** 28 + while amt is None or amt != 0: + if amt is not None: + chunk_amt = min(amt, max_chunk_amt) + amt -= chunk_amt + else: + chunk_amt = max_chunk_amt + data = self._fp.read(chunk_amt) + if not data: + break + buffer.write(data) + del data # to reduce peak memory usage by `max_chunk_amt`. + return buffer.getvalue() + else: + # StringIO doesn't like amt=None + return self._fp.read(amt) if amt is not None else self._fp.read() + + def read(self, amt=None, decode_content=None, cache_content=False): + """ + Similar to :meth:`http.client.HTTPResponse.read`, but with two additional + parameters: ``decode_content`` and ``cache_content``. + + :param amt: + How much of the content to read. If specified, caching is skipped + because it doesn't make sense to cache partial content as the full + response. + + :param decode_content: + If True, will attempt to decode the body based on the + 'content-encoding' header. + + :param cache_content: + If True, will save the returned data such that the same result is + returned despite of the state of the underlying file object. This + is useful if you want the ``.data`` property to continue working + after having ``.read()`` the file object. (Overridden if ``amt`` is + set.) + """ + self._init_decoder() + if decode_content is None: + decode_content = self.decode_content + + if self._fp is None: + return + + flush_decoder = False + fp_closed = getattr(self._fp, "closed", False) + + with self._error_catcher(): + data = self._fp_read(amt) if not fp_closed else b"" + if amt is None: + flush_decoder = True + else: + cache_content = False + if ( + amt != 0 and not data + ): # Platform-specific: Buggy versions of Python. + # Close the connection when no data is returned + # + # This is redundant to what httplib/http.client _should_ + # already do. However, versions of python released before + # December 15, 2012 (http://bugs.python.org/issue16298) do + # not properly close the connection in all cases. There is + # no harm in redundantly calling close. + self._fp.close() + flush_decoder = True + if self.enforce_content_length and self.length_remaining not in ( + 0, + None, + ): + # This is an edge case that httplib failed to cover due + # to concerns of backward compatibility. We're + # addressing it here to make sure IncompleteRead is + # raised during streaming, so all calls with incorrect + # Content-Length are caught. + raise IncompleteRead(self._fp_bytes_read, self.length_remaining) + + if data: + self._fp_bytes_read += len(data) + if self.length_remaining is not None: + self.length_remaining -= len(data) + + data = self._decode(data, decode_content, flush_decoder) + + if cache_content: + self._body = data + + return data + + def stream(self, amt=2 ** 16, decode_content=None): + """ + A generator wrapper for the read() method. A call will block until + ``amt`` bytes have been read from the connection or until the + connection is closed. + + :param amt: + How much of the content to read. The generator will return up to + much data per iteration, but may return less. This is particularly + likely when using compressed data. However, the empty string will + never be returned. + + :param decode_content: + If True, will attempt to decode the body based on the + 'content-encoding' header. + """ + if self.chunked and self.supports_chunked_reads(): + for line in self.read_chunked(amt, decode_content=decode_content): + yield line + else: + while not is_fp_closed(self._fp): + data = self.read(amt=amt, decode_content=decode_content) + + if data: + yield data + + @classmethod + def from_httplib(ResponseCls, r, **response_kw): + """ + Given an :class:`http.client.HTTPResponse` instance ``r``, return a + corresponding :class:`urllib3.response.HTTPResponse` object. + + Remaining parameters are passed to the HTTPResponse constructor, along + with ``original_response=r``. + """ + headers = r.msg + + if not isinstance(headers, HTTPHeaderDict): + if six.PY2: + # Python 2.7 + headers = HTTPHeaderDict.from_httplib(headers) + else: + headers = HTTPHeaderDict(headers.items()) + + # HTTPResponse objects in Python 3 don't have a .strict attribute + strict = getattr(r, "strict", 0) + resp = ResponseCls( + body=r, + headers=headers, + status=r.status, + version=r.version, + reason=r.reason, + strict=strict, + original_response=r, + **response_kw + ) + return resp + + # Backwards-compatibility methods for http.client.HTTPResponse + def getheaders(self): + warnings.warn( + "HTTPResponse.getheaders() is deprecated and will be removed " + "in urllib3 v2.1.0. Instead access HTTPResponse.headers directly.", + category=DeprecationWarning, + stacklevel=2, + ) + return self.headers + + def getheader(self, name, default=None): + warnings.warn( + "HTTPResponse.getheader() is deprecated and will be removed " + "in urllib3 v2.1.0. Instead use HTTPResponse.headers.get(name, default).", + category=DeprecationWarning, + stacklevel=2, + ) + return self.headers.get(name, default) + + # Backwards compatibility for http.cookiejar + def info(self): + return self.headers + + # Overrides from io.IOBase + def close(self): + if not self.closed: + self._fp.close() + + if self._connection: + self._connection.close() + + if not self.auto_close: + io.IOBase.close(self) + + @property + def closed(self): + if not self.auto_close: + return io.IOBase.closed.__get__(self) + elif self._fp is None: + return True + elif hasattr(self._fp, "isclosed"): + return self._fp.isclosed() + elif hasattr(self._fp, "closed"): + return self._fp.closed + else: + return True + + def fileno(self): + if self._fp is None: + raise IOError("HTTPResponse has no file to get a fileno from") + elif hasattr(self._fp, "fileno"): + return self._fp.fileno() + else: + raise IOError( + "The file-like object this HTTPResponse is wrapped " + "around has no file descriptor" + ) + + def flush(self): + if ( + self._fp is not None + and hasattr(self._fp, "flush") + and not getattr(self._fp, "closed", False) + ): + return self._fp.flush() + + def readable(self): + # This method is required for `io` module compatibility. + return True + + def readinto(self, b): + # This method is required for `io` module compatibility. + temp = self.read(len(b)) + if len(temp) == 0: + return 0 + else: + b[: len(temp)] = temp + return len(temp) + + def supports_chunked_reads(self): + """ + Checks if the underlying file-like object looks like a + :class:`http.client.HTTPResponse` object. We do this by testing for + the fp attribute. If it is present we assume it returns raw chunks as + processed by read_chunked(). + """ + return hasattr(self._fp, "fp") + + def _update_chunk_length(self): + # First, we'll figure out length of a chunk and then + # we'll try to read it from socket. + if self.chunk_left is not None: + return + line = self._fp.fp.readline() + line = line.split(b";", 1)[0] + try: + self.chunk_left = int(line, 16) + except ValueError: + # Invalid chunked protocol response, abort. + self.close() + raise InvalidChunkLength(self, line) + + def _handle_chunk(self, amt): + returned_chunk = None + if amt is None: + chunk = self._fp._safe_read(self.chunk_left) + returned_chunk = chunk + self._fp._safe_read(2) # Toss the CRLF at the end of the chunk. + self.chunk_left = None + elif amt < self.chunk_left: + value = self._fp._safe_read(amt) + self.chunk_left = self.chunk_left - amt + returned_chunk = value + elif amt == self.chunk_left: + value = self._fp._safe_read(amt) + self._fp._safe_read(2) # Toss the CRLF at the end of the chunk. + self.chunk_left = None + returned_chunk = value + else: # amt > self.chunk_left + returned_chunk = self._fp._safe_read(self.chunk_left) + self._fp._safe_read(2) # Toss the CRLF at the end of the chunk. + self.chunk_left = None + return returned_chunk + + def read_chunked(self, amt=None, decode_content=None): + """ + Similar to :meth:`HTTPResponse.read`, but with an additional + parameter: ``decode_content``. + + :param amt: + How much of the content to read. If specified, caching is skipped + because it doesn't make sense to cache partial content as the full + response. + + :param decode_content: + If True, will attempt to decode the body based on the + 'content-encoding' header. + """ + self._init_decoder() + # FIXME: Rewrite this method and make it a class with a better structured logic. + if not self.chunked: + raise ResponseNotChunked( + "Response is not chunked. " + "Header 'transfer-encoding: chunked' is missing." + ) + if not self.supports_chunked_reads(): + raise BodyNotHttplibCompatible( + "Body should be http.client.HTTPResponse like. " + "It should have have an fp attribute which returns raw chunks." + ) + + with self._error_catcher(): + # Don't bother reading the body of a HEAD request. + if self._original_response and is_response_to_head(self._original_response): + self._original_response.close() + return + + # If a response is already read and closed + # then return immediately. + if self._fp.fp is None: + return + + while True: + self._update_chunk_length() + if self.chunk_left == 0: + break + chunk = self._handle_chunk(amt) + decoded = self._decode( + chunk, decode_content=decode_content, flush_decoder=False + ) + if decoded: + yield decoded + + if decode_content: + # On CPython and PyPy, we should never need to flush the + # decoder. However, on Jython we *might* need to, so + # lets defensively do it anyway. + decoded = self._flush_decoder() + if decoded: # Platform-specific: Jython. + yield decoded + + # Chunk content ends with \r\n: discard it. + while True: + line = self._fp.fp.readline() + if not line: + # Some sites may not end with '\r\n'. + break + if line == b"\r\n": + break + + # We read everything; close the "file". + if self._original_response: + self._original_response.close() + + def geturl(self): + """ + Returns the URL that was the source of this response. + If the request that generated this response redirected, this method + will return the final redirect location. + """ + if self.retries is not None and len(self.retries.history): + return self.retries.history[-1].redirect_location + else: + return self._request_url + + def __iter__(self): + buffer = [] + for chunk in self.stream(decode_content=True): + if b"\n" in chunk: + chunk = chunk.split(b"\n") + yield b"".join(buffer) + chunk[0] + b"\n" + for x in chunk[1:-1]: + yield x + b"\n" + if chunk[-1]: + buffer = [chunk[-1]] + else: + buffer = [] + else: + buffer.append(chunk) + if buffer: + yield b"".join(buffer) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__init__.py b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__init__.py new file mode 100644 index 0000000..4547fc5 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__init__.py @@ -0,0 +1,49 @@ +from __future__ import absolute_import + +# For backwards compatibility, provide imports that used to be here. +from .connection import is_connection_dropped +from .request import SKIP_HEADER, SKIPPABLE_HEADERS, make_headers +from .response import is_fp_closed +from .retry import Retry +from .ssl_ import ( + ALPN_PROTOCOLS, + HAS_SNI, + IS_PYOPENSSL, + IS_SECURETRANSPORT, + PROTOCOL_TLS, + SSLContext, + assert_fingerprint, + resolve_cert_reqs, + resolve_ssl_version, + ssl_wrap_socket, +) +from .timeout import Timeout, current_time +from .url import Url, get_host, parse_url, split_first +from .wait import wait_for_read, wait_for_write + +__all__ = ( + "HAS_SNI", + "IS_PYOPENSSL", + "IS_SECURETRANSPORT", + "SSLContext", + "PROTOCOL_TLS", + "ALPN_PROTOCOLS", + "Retry", + "Timeout", + "Url", + "assert_fingerprint", + "current_time", + "is_connection_dropped", + "is_fp_closed", + "get_host", + "parse_url", + "make_headers", + "resolve_cert_reqs", + "resolve_ssl_version", + "split_first", + "ssl_wrap_socket", + "wait_for_read", + "wait_for_write", + "SKIP_HEADER", + "SKIPPABLE_HEADERS", +) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..36861a49431764f4a5d44285f86c8585e0e505ab GIT binary patch literal 1146 zcmZ9L%WfMt6oxsvjqbAKOXS!|a{+=VK|E*!WYrc>T>&xbN~%U#gd1W!Lt6ur!wJce z<7Lo?=ra`E_AR<9x+7qC(N%USf+9dx%qzIUUF_zyGOO|$uH|us z)p-Lq^4Mif-oh>3#%+ZsgU}u zb5-Ar6$wR>&``%BA(0emN~1y1H2fb9rsVl(`2A>Rx{yqV-yM!VReaOr!6_vR8bnko z+n{L=I!;N*gtGe`Q=U;R&j)qW9v)7|WICJ7C;O8_-?-0*KJmu~rg`9#>C4GN z)3cdB+J7+{&1b{0Kb_3xrg^=K%nASFtKr&JFL#+}EUicFhkm`Oxn5-T3m0R#= zigun?zE>W>lqta!SFVgpNWd5&zoPf{HTrnuEd-~YOsy=jjKhT&iimnY#wzsomNZ#< zEI#tmbG;DB)4eah@|3-cCutC#1}9W`X`FiYt4JatJuAVked=X8W*#ANVsDe|rRN{3 zUvm*Rkj6QN6U!rG! Tp=X!Kdso_S6yCVcl%rCm(sl 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 Ab^rhX literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/queue.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/queue.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b0cb0c9153cff857004137cfc66658400b749dee GIT binary patch literal 1352 zcma)6&rcgi6n?Y6SZs(1iKRl-;zNSiL%j-#iiE0Ob4gH8Pua`J^$xJ^+PlnnQEj0V zMMy2GD&XY&3y41@mqbyNbel?*P!HTFZZA3YyVs`j&4Xj`d8(O2;1rYtd@fu4qAR$R-}cFA)aNMNRV6x?DAi z9gm*dz%Q~rIASY~o|cZ^$h&n1YeSyrSh4qe>8cKv~DdUPZ)oSm#yAid8D`U}> z(N@shaGQ}Y+=qc`y7ev5*>c0+TQ}}?H=@qn`kh5r1zqt)+-QE+SQpBTgV^O*=10;^ zWQetQ-J~0YZYEYe?xiLVIzhKzxj1q?3(y^?X@nhkSFOFN&cCeAzp5_$Wc*SZVicMe zheC%$$%L6lV}Lqsvu$Xh{oy(uN%jp$8V5;JGrQ(qK!Ujscs_dz*~D_zqD6+W6!*_XP(`9ZO`SzFXjoWNZw1c z_Wy|&b2pN>Ag#wy?66E}MgLRFH8%LVxJniMD(2M<1f*KIvESe8??2gl@~SfTV#IXC zu~VD#PNOY2PfMJ)BR>hrp5S~lX@q%3(j7@^Bjvza5MnT#XB`D)hQF<57 zHD)?z7R-J&1ZK{iTgklMwpOM~3$!mZ<1q27+RgvxJCfAn}UHM5sG zy~&eKqJ&@Y&Z0SyIc)MDx%c*0`O&_Xw=qG&Df*V2>5Q@8VERv({T=52(5)Yro-Umj U3x8W>Ry!~U<-_tnfM(X|UrtF8o&W#< literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/request.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/request.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..8b096a93aee220f87a300f04b3e7e19943f815ea GIT binary patch literal 4183 zcmbtXO>7&-6`tikmw)=T6DO9(l5Lu{NZPgQwnAc9mStP6Evb=hAZk&1#T|)jFL&A5 zp=7cWOdC1a@I^%n*ag}qEplj~+?qpy_L8=T0KG_+i_!}fwb7(SZgQkUpi|!rxg@0~ zZGnum!n-6*b=Yv+|IHFpNs>aCf^~&z*7V(c*-<&q8R;H*DThLL0pSb5H-~h z!8so@su&hWnT45&fk9q(F%Uj=?CMtT~gab=3)@ z$N659YGp7yx0GOrQ>j$EAq1!RT&sZ+ZkIA&UIf7>`6UEVHH!zXOjgO}{s$;IMG~ON zsHqQN!%T`jJ5V`%Tgex6GB8lnH3#_V)2DG>xkWN{mpI(?g4a3j`-Pfo#(%x{titk& zkv^U})|+VP@%t?<5g)*D&Y|uU{W#tXmHb_kL42XX;6G&8;Wk2$*7J5mWzKk;H`G{f zN&Pekk%;n$R+gJ$*>cl|%f7Q5YPjqzvgzd4?Z`HBl{-JjhUI{x-f~1}+0lCtd`BCxeVzm znw3qbW{EMI2IoxIT=hii_*c@F#z?ZDWN$$%u+jyskj?;^YSOgh$VH~<>3Wn+6-suv z61WvG&S^r~X}Qq3%WVUF%8cXf@on7TNtc_FmVMNUGYi|Lxq5 zbMM?)?fKe+v5$I^_s6OSPu}-0x9wjE^gj2uSMibi{>AW0V6T|;w@mtuzNh_8`puEw zMpjej|C+k8lDhKY%xdcTO5b&$ime3jbN}vY;`sX`YvIUpv}ZNEZ^P~Ss{Ajx?ZKhN z-4D|*ysjgA_*n;60*77%P@ucom#lAn7V4;sZon;2wvoYM;)O?K{GY+#5#;x~(Ux2e zb0>#OFrGk+(~33^wUjC?)#rCRgJ>Szj0v%gqW!8 zIFkkGO+i10ZoA(^b5g=xz9T#kQk;SdCfF7NCDxibpdaVWS%RlEo$!RiatZ@FsG4e7 zWDKG`ozpA`5pyIC`9@)k4Jfu%NqtqH^i8%@AsT=_k9FWBWfv?qJWR4|VoD7|KKLWx>s1+}&q`DkTEV$-fclWd)Mq)gC zh~}V*%0c9U8n0OiN~i=g7Ir9$5Dl9Zp4zCu?n$gs(Wze6?$9?ml|jy>dgXdg`Y)&p z1L_(zq}r$)?@0~h`O5zk$Qx`046o9m8d6IfKMKwg$`s9L0JDaeajNANs_CU#!NNi1 zlysD+8o&-}J_Q(22x%JGQQ&dz&2r*AU?Zt(w+J?;Zom6Clu#ZXv{H#6?E`esHs0}X40?cf2YJV#Obj=I`*v@%llw=Mf$ zeRt0tLpy%NN0(Y|$;6gj!!cE{v(a8G$tMzNQx z;j@3d`r+X}e0L>00TG|Sas}njHoIFrIl9&nueR~`ol$rniLSfd!RVI7k^S?)U>EwJ z>y^Q@JK-A@Ezx1inM^IfWipgs$o4^kCZ|q{EN{!?Hvf`@5NioF*1j=R)jgBz+WM{4@iVsw*s%_ zO|__#)ASp##vR$Z2Hm<_lBB<(Lm#78KSrs)qoWYqV!f5n)2_XL?zynqb#WQBKkLAi u*z;)D!(1h_9zbnf)vlMSu}=Qq{W8SGjmWShb$&YTib=7J1FuN3IQHM(C2oiS literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/response.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/response.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..01e2fac3f1602cd7d8f407c8af6d194fa6a9147d GIT binary patch literal 2989 zcma)8OKcm*8J^wck`yVDdOs3B#-ofvdV#OVjD=&99 zGeb#~sX{P%u#f_Fl7n?ffuQIig@Pcb0=)!D+e6VFNyDhnvLlZ=;L}6`p#NMCiYMm&PZ-bn`5?F zG-_xTziQZ~#tqxLNQ$Ju-KS?bY`Q9^=q7|u-VsRa z@my3=YyQ-O0e;q!h0x>ahVElM4SGFr8M;*ecyNW#O0$In$WSIW=CktW`2i)YuNTSd(-RZTR*sH^u@eXaiP&l}O>|JjWX?;%M| z+>3TL6?i{xhC^!NeyZoz^4fAEI{a+{`&Jg#7S{W29l&xO*A9I zCd+{T8>t@je#Z&rSJDaP*YPa+v|~*9y)>qLo|x!FUv_p(oL0U(B|(2E!-;g-4j^FCQDY~*D zqJp+^cqi1h15ztWU8XreY08&w?*o*wlQOEy!E7becE%9z3N(06Fe=Ky*{EC(fd`2` zQQ#_ zQ3Ibhq?%HYCGfMNE}~3WI}capp=p9KLU|i{O%sgRKff6v}I`A&Gi=HY_X5gVk1aDYib%?4>JLE>A%?fUv;Q81^}t2~t=f)F{>heX1FZFx*04mMj&B zBM6^mpQP~vB6{^8*w%403e+Tuflourr^%87vrEPt(cy}C7a{x&#z?Ni0)Mt zHtohsgy$WtX4;ybk!de{CpS^G{JYHS8rL!jH)cRVVO+Bc#ErD9y79K-x*b<)PC#Ep zn^rXLhBz#_5wNcTzj- zryFjCFRF(4+89%j+HSw*Wli4Khhuq#kfvepJMgf-LAQ#&Ie|I{ZkIk>ynFK8=E-y0 z@zLGnU}I?f?$CwJp$mVy_~*etPHhdnxs{x0L}wl(`)`-lYagH4O6FEy+3gu#Kl{-S zK0CA3^Wy63_xpxcr|w011Pcz{O{F(e>Fv}r_XbXVP`UZagA|DVX7ZEKkH)uC&+p)~ zw-fgw$>uTi^yz=A;ojK&u7Ta&<2zjg+ruwxfB&t<&`-WmR#3vRQS_YH)BwZq;{{~Uio`pP$gwK03qC7?Jc}V{4OigD!fwItp}0slBz7|) zHBo90>dj9`*usPdU*4?%U6PnBI<@*h%%TcduP zketsKtGr4{K2N=fJ4r<|%&gBPJ_-dM-Pi#id9ZYQf`5lBGnTRydx0=2>M0!*o%lKM zaOTDOTSQ01f&k^?=y=7}t0p;5M`0>TB1=ODKM0ca6?*oc=&gUC?|y||+zTI*UXu3C Qk4kSyk4z~co$-wP55EcpOaK4? literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/retry.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/retry.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..6ad0eb93f82506be523592cee857504b81b401d2 GIT binary patch literal 21697 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 tV5M)}()xw4;B{{RMUF5>_I literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/ssl_.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/ssl_.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ecb522e6cd6e13f90956ad39dabd96d22e4591b8 GIT binary patch literal 15103 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/ssltransport.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/ssltransport.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..64ce17fae358a4f43e8cc7291c9d5bb8f8c0d2cc GIT binary patch literal 10772 zcmcgyYit`=cAnvI$l*hxL{ikliaoYu*^Fe-kHks6aT?i{vWjilYsu?I0hXmWBa<@4 zVeSkiOQBLDn;%q~)^dZ^a(CNkAH_Ow(RG0W4T}AfZqXm@AJK{-dZGoqC|V%Dszd>@ z@cwAexx*PgL?^rHrdRfzJNJ3+x#ygF&Nuw`h6XnS>635Wnf&h#hWQVCF_XPi*g6A+ zn~cOrY>F8-p6obF-)-YI$tH0rZrVO>XBjBlQ~b1J+yP~N+-YN8WF*I%jO4syGiDnX z=Gd_CF}{p^jCEmF51l8<)w$7lLY|f{rqygFqYzD&poLSDSCh;O3=_uzW-3j^Z2c?L z++<`1i2*{`aZa{Nwl|qOrJm!wi;+4d`X5sFFlk)nXH=q?(Xv7Z@nUm2_H;Ye^;D z@1`@JRMHxWkvUOQ#Pf4nLP_sa#pHA*1?*32G3+TSlep+8ow!d-!sMxxGOLPnN*0I3 z6R~8PPBxuQX-OC=j-45;SW1Onmt`#>lYVhngZVQtq9xaEvlFpZw zWeK{|=`1qne6vX{kxXN;L^?7fo{FieSdtP|oK{o~$%VB{Mhu)E7L|-l=vLHzI&mEM zX(g0w4*qW?AiK$ER$C5a+>}(cM>7SDnKE_3nu1}7M{}C5lI>1ujyKqfTCQ9>XAkr9 z_b4fNsuyBO6^}@)FZ#$D+)#!nGf4^9qpGPW9Hb^+)x>x#y-yP-WMrdc%{ZwL%Cjnd znF6Gwf$KzmHJc>#ki{e%P$H%oT&tM7v>>+1;yx6$=tNT4XRR^~XR1ggp5pAfV0M~6 zjUr$yZ?2`H6rsEU-Th|A{b6x7k&GvR2;7LJ?;^;ZA&=tW`9Jt-lf`CY$rNaSjFY96 z^no-8!3@=)5*Z_5yY5WH)R?9b!ovaT-1(Oe6FgurIGzedt9Yd1qsd4@nU*6YBWrjX z@kAu9NOI(CQjJIYXXNxuB$b?qWT+w?=|6Nhq9!%@KqeNy61yy`kxViZi9$C?A(1Re zLEj^htd>kgU?osPL*4r`b9#4lCYDM{F-?wE5D|rQjcO@1noQ$k{!pbY=>JWIgkTry z3y@u7J_|BUtxK=1y!4?jvf=YzpM7g~Bhv%$zOE z&41fcsFOs76GwAid9Y%PC|NM)CCi>w(ab;2AQ%P?l@SEkr^;kTCeZ|##dK_19tpeQ z7FAQa>#RJjkhv4X=X4>Njw{nJr7kF0?XrTUAgUpeRW(XtmoLjwR8}Tc-C+( zQB%sqlQNK1D{`3E?W&xbB&{%jcrin^5h{atOh~0j@Q`#N z3NoG4qS5)5%B}aC)qT)OorVnL*2}bazT0rC;d{Qk{q2U0wjJe{huzQS?H>xei=j?v z^E?dgUJpH42t8T!HeElvcy{@zcaPsX{(fYWV_JK+7+b3wdu_TISHrr{UJ%-syWj1- z)w|wtxX^LV-5rh^0G#E_j(4JXgXQ;I5wZImjV zjjA|P1+&3jsK;!h`ULb<6(fudh`m|A29EF~gHh9*iDN9w$EhfFAC2DO{ zKy=4sG9{YLC>wP;@V?J4;7tQ@)RSo1|zg~)cAaZ*b2DT8M4Yp*;*-3?0+D%}kb5bRx(a;#}_ zMwu`-LQodwd+|b?mx&@yrec>>xF1V?9XJ?pZ^yyML%$6!@AypErn|o#OJ(IjLKH%t zgz+U7kX|V3Je^`22jVl^I1ryX4Fgm>0XQ{J)6&3O$2R<(t53YN=0CmaJq>zbGG)!T zZ&lc5umq3JOx7``p$3kT`x2J0q%mi^=G835l-aRhOWUChVwMFPu+F+V%%vD6XM^6z zFG#>Vdx?1me+%Y;Vbhe486X>Y7J+#v&&UBNh3!<12wFGYk)D{-WR)C*7Zo=N!c?-3 zE<6M}PmL+D>d)h#7a*(V>bW)l`Bm@v2cG7onWfh^TH2OF@4T`&RBQ<3zf){!&kq5= zug@*cEr(V@Yrg%f!v5_di1vqypr2mrxi1kxiCy68@%m|I!Jf0%|c&z&Vgza87su)ubE`a=>&j)(9tzaL&WsvcOqm*|&E=oC<&Di9%dj^FGIP zF^9nX%-UGyWrl^nxBXYSmzi0%wtkK=>Mfb*{|#kA1@{k>OJ`4nc`6UOdz#+HGf8^X2H19R2Q=MI`@2wRqO|CUP16Q;MiqcPC_b2s+sIj3 zc0O2TlS;KOLx1%KWYywxcFjMs>K!RIHRt(_hSp{KTEi2YjNP?kCAgyfWbOxZcLP6q zomRZxj>6Uc&UZkh{H@D9f7V|Nw%r`QF}$3-&EIyc?u@Jj4=%CArk3UA8}223lV<{L z%RTS(f6l{npW~b~`vgmmXpzqQNZkWe{k4DKICnQPaESjv6rlLQA%5VP>w}|CEFb4j zIGk}yyP-QO50zK~1+WlbBC(G#nspt;x^ALnAyC%7f{CT)Y&UE}JCID;Ak+C-0 zBEEt3Xc}|@9J7p)hKRAsNRVUDSYvN-;y6^Rctuwqt!Zxqt?PmALZEwP>?g1M;Fa~g zM+*v7|WEq$3Pz|-Tbm$O+e)QBlZelNUE=F3nZ|m-ve9w zSC+oN!AkZVJHsphAcN1Vtje)W&f#SioH?gz&pA}vOAPdK&|U!5EVyz`!slEPPj%as zbI>=t@upc8yzV(MIhU#V3vM`d=iN9DrfCRWFy5v^W@WJiDw*g4Kv*RR2|JG^0RMo0*)&AgS{5(@8Ss%9;8z)V zK-`r9iwqFLWGMiH@VrbDf>NS74ffnx9N@4tt_{9Z2BIl|RTKkRF@QMR;NTzA*4`7xgi}S7Gegm-S6KDIx2?KirJd~g-NnXTk2*)!YqeuAh z|3ESvyxrNf#Vxo}(8NxnW zQqcpa28RYNo*9dtxHvR4cp*AEJU*y5o}iAeEM2&CK9(dE?{Fq^#rq{RWJGTm1K?-) z+$F$~0FTq{xW90N;Q?L5)m;X?G!~U1D#e4<9Wwfys_sn7v#DfS)}3ejJ`aJo^_$~p3u3%7KGjRh0dZUxa#RF zwsqu(p}6$wTgNxrI@a6z3vK=zjF9RLy98}dWoOBMs|`Li3o=5^n$ zf^XM~Z zd2P*iWVId^W3m4K4nR!9cbQC@&Xi8j3 zZKE}Xw02dAMg5U~108FbeW>6&^#3IvEf!hnFWL{n67zfN@27I$?K;~zSnwTO^BrCl z4uAdU(+D6ffzvSrL)~^R8QjN?>U~s=KnqrT9^ry7yyoj&6?(t^4R`>zrYLnioyE|v z#@JMJ|GPS*qp_*PK2gX^Uwr)5ChP1DJPLy>!p`OFePQp{dH~d0bc6XW?O>bq%x|8uy5omHIQHs~L5BQ@9W-h#0Az6o67b!#RJPU-dgUr@No zxE=%NLtt7ddZp3z{2z){msS`B;7YT?^m;*TH$$F6fMUuDR87K|%8_+~*DG*gkY=E( zu{^>o5&mU>&=$DYxjFWYQfZc*ErDb2*$luGP%O(aqsS*gra`zddWJ&EIuDmvTG1Pz zB06~C!nq64!E;0OOOXkH^uhqcr)O)C55%KuELAmL|4-0C9f#~1vuSgr#4C@~4wM*Qb)Xi0O9P0hWCL`R zBR_>F{7l8h;L-jmBBo5e{LyxUiB0W)Z`T4&5n8s_r-jvXcep_tiq&ih6U`z0Vq%1xff88YzvOp9dG~Ic$U>D zY@dJryiBM^jbDd{Bj-f?-U^|-HY)=PVt&Jon4fSda8dphO#j%(P`HsQ9mxSnWC1cA z9mJBhT^bk}i(VKUIHjYXTUmMO!tmH2L1S$wE?RyvfY~9OgKF%FGv`j8MofUl?%ep^oKKOIMb-%|<5Bdh@`I1MB|o zg1>vs-;+OyUx-gHo?iFvDtLFTa36ZRANqp%h2qYx8=hiw2-W{kq2tiK=0n9$$IUA@ zuB?Z83Zb4KFRX>0Ug91ELWp;ty>WIuxUUf0cbmH(?0aa|^cI4>9|jM68fJVQn@=)L zfxP=ypLH?8)|=1Wcn*wAgIEj%Z$5M5nI9in?>biKI`*@Z>(7l9o*P@;bFmP(_^@Ng z(u>8m_II7PoPW-vy=f31(NO6v{=~D)KR+8d<>P+tId;m;{fnE2a@aO91}?=BV8%%4 zNg*Nf8q|bA3h}{H>}Uj1m>n`c8}G!=@c27{XjFGcqX4C3Q&{#!qpxOTsZxtG8kLkd zR>RNB;AdRMuYd^N4WtvZ-I(pg3_sl(QiHNWp2m!d4!Tj~4>6m-tP3*?4@m+uj9v(a z1q6L*f{rLbe~zGr5%eqwUe5G8q;aq8!dHxFD6m7&xYEo61@(uJy~%uH6L?`W$T<9; z*aEzNi-Xc8mNxsCbL=R)#WnL!ecHqF!A~75--2297Gwvv92~!Y%kAXDTYiDxu@$uQ zZ6HBs*>Ay^Ug$o~vV1@G@5KI3VQDWNjv0MDf~7vp!kG17wx4EO4ksVl@^|n7gM6es z>>}rI160%KJ?WOO#^ntD7Eh(WP0|JP7e(|(OXR!Qoo>3C5s!rDj6-~$+<-3VQmJ?_ nn;grsA2F_vn1+uS_kS{xUoahTm0fH2+;M?p1D`UOQ-b~%Lti)f literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/timeout.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/timeout.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d7c565fe2cf52e6d7cdef0d160d7d1a55d180d01 GIT binary patch literal 11139 zcmd5?TWlL=b{^g&ilRhaEX#2eXCiwo(UwWam&D7g(v2_i+VCxFWs9o7QX|e#9Gm1Y zGeapNybHO=gHtaW2Pj|%Nf7VT+D(CV+lS_{*#hkreW+BWkU%)7(ajdvH`z|nBKy+s z{FmWSqH@{pLkH4u=D(c({O5koKmXj-6;p6MeC5OZMNSM)$p zDFr420eTJ=gOfr0hKiw5crsjyOh(Wi)+5EXQu}0kKnW^F^g{t+vIB21BdE6-!AoJ$ z===FF#9t;mgUU%oZ+}D4qnIsQ>*mkibivnS7- zKl;*{?C}#Xzx3*viR{FwvnS5KI#KVPFFufD}{i3V6#tGZD z?0QGZDqF5qHgh?S4!;X5l*fOD_nV5LOa^oXdk;*8jPPVc4;pPoTRx)|() zN#H)&VZ`*v8;VDPPQ17I-s5=3KE3`fJ&Kv#dI#HD{Ic=1kSrT+=G2Vlfq$=yTMZR#vAC6=X5XhOTOks?iJ4NX=U|-YS+= z%Vum_8S1@x0)tWVI+tdw5bqj3!-j3;=_MH5BoBmxe z8ONHB~Z|1WH4?6t8Xw#sB6!!`iiT@4~ea!J=j!Nl&Z(ljKJvqy-L zs+DynMUs4uYL>BaVE6)~2T7Rh^T5rSpcX_N#3L#Zduiip(a5_b1!~^5O03yi#&wNS z#Z9TF%GB;bGG>i3U=%c0ownQpbVJUNlq3W-z8_Vyv1Y}{nR(OD$5f_EgrEoRYfK_! zodWC{(3HdFezZ!Z2*^UAiEzic-ZEhzwu!EcJ72+`8Ig%#V`{!=Y4`z3G^~jiVn=>% z7-~s--7Hm0s#db9pn#R<6dX0npeknQPLfDFr-gY%kRT`*anoXp~vs2CG z3~WO^UoyFLGX<2At+MS(i{$6VdfE%#I`a;=CvDi6TCuHZDA2q*MQ~?|cq__Y4>w6$ z+7L{e;if9{Ugvj&aVgB8l?-0WvS-pc{+!O6MI-&({)5wp^uymi`267`=`-eZ+JmyQ zc=+Jq7pJl*4;+!4?}{W6=GTOIE}JeFOE@KFcN+v$1>u|~c8dPYS2C1D?sw*8|neWlwYd zUvRgHi;Ov&vk?9kF^G{77M*k)j&fejYdP0~(I@Av<@4~cj5tii*DEPG@v2=cn$rh~ zh_>NYZJ$z>)$dJATtGATuRd$?GA0UtI;LJ=f3Y^hW)^*p!<(Hbls%*iGydNPsW~;T$m3Bo(P7fWN1zm#-H$@9)M&@huUH`OjPzMM`dipq>b*#QBotxN@GuH|-foN3}K6 zp^(JLX;lPev<64a+hYNdB;n?8muaYZ(+0%pdDuDVA)6tcBcoD^`+c~6nx+-!w0Xya zM#FQO12=Ex8{WflLCF$P9W*AuV5tr5F!L_iEa95QFhQX1!Gi}ouwM?~#+VV(HfIop zju9Zj(W*km`~+k+%GEA6sOHd`kkyh|Mi#S8o>%u^y%k*CR|ZlaYFFc2+BzI?_5B?$)DOIX04| z!FD&G*1NNgtJ$vXONQ%V$0+7mr;Th%vAb|{Xjw7|UufxqRWj0c#c*wF7AZxVQls=) z)5)b%5TDsJOm3P72?tZp9!NWI@%t)T?lKY`CtWcs=`4onmYo*nISuz(Obby(r~yQ? z6c}W)wVnxXS5vaZAY5L?Z9!SxHng%WwX`jDXYQkp+q7vTDwS1YEc*_ zvU}rS1d`x&m;zm*S{YeUHf#3)oZU+|;_%&o-H#uKuvhIZxYJPEsMyT}<}H_LXbQIl z<+FItjV;$tuf(5Tjz7H`?|JL&^|SPI`ub_{v(^#miLEJ-j+ng_Q*wU7&@&_Cb9lI^ zTp{w{Y5i4I?3n9GxGV%*#CU8!KxK`@x^jk1C7HXydMH

g_^o99m8l+Zz;)IxE6w zsR6a8r8sReU=~1}9k?wh4|ean*T3@Y@g@B2KK@BUT}})yMql~m2yT3{9?}@^NzEjv zOq+Gl$S-U#j;;GiBYJ3)SGyTuTJ&OGkci;Q3KT*0q)3_vyVLEEE5RTM3H_5mhvIh1 z_A6d{KuH}Iua5clWSnf=L0ZXlA%tEQ0 zYp?*KIm2$?QadhGk79QUIZ&9;P))Fk2A1TAtEXJGRHa}EeGI0^*k!_=s&z{!Y=&Bk zAoq6E8Y*GnJnihu=i8)bwceL_MlRTaWV9BSkrFYec8r5#`xJ3~18Y%E(Y}ms>i$%+ z9adHpCTub(^_c0HW%$~1&ZviJ=k-{FGxZ3gT)krgrkwFA8M0NH7GYbhhe`SzvN>P{ zv*LCFFSRG6N!#G>Yv^|F%{Gg zE8jY@gukI9tNq)qo%yVD;D+(u#3!A@_xpy{f`Q(#$DvSv_nH#w>RyYsb#&j4_ulx{ zPtL4$$2+=L6I*Tt{yc$DAh~!L@Y%dXr%h^nKxM z!v;SNb-t8TK28iC?N&Zc4j=6d{i1v5=$=rMKO)ymKrI)c|v|qe+oV%IMh<<|fAwCe6;|ikjnOri5rrdEl(+OFUP+MLhFF|Vs7*}?yr!nOxO+BN;TT<(0Gc$7L?D2l%By`C-3~>CyB$0(Zf7?5S|(X6oouI z6U|9HG>K-*xB<}w3G=!OtzLA{=z?GqWL!+JxA_G-XF&|9rs?x%f>a)@BneShK*7s3 zk?FDeF3K=qKbnbDO|+9XlTBho5tfF|Y8QjIbz8L+vO&QkhpLNTm4 z4>i&q7C0xvob}D&wEZNA=?|tONKwm1 ztxL)Pd;N$8k<5Vo+lc+{2S0k}NB0i>ZRW2se>d@ulOIohlDM!Ky|7Ujh+Rw=@_0Zf z*)nRr+S!Pi{b64tSd@`8GDg7RS8G@#7`4C037{=1Dne^m<~_#47QJfoMB6h+vO3$a zdNSM)SzXF_J!e$NC^#uW8mu8s8BxAvl>rZmtaR>J>fEu|x#xc0&c$74m;25w#?Rf~vFF|LweTm=Csz~wD~aJH z$|r`ug#SMTz|Hu-@D2FiD(kAjrZIz%fI&DZJrR*jHHun=Ogn;=9ItTY*s+_XW^m+I z$V@eDeaatXOS^kQfMD>b_{`5r8k~|Am|0KHI{ZEb2q)eugqBt4MS-3Rg_Nc82*sIH zE#uWk_6Z>NvtZf=A=&~^QiQS+tJ=^6SF}{C-X#*L!(60# zd?K|QBDLCc=5Z)U5m~US`|~!XXXyHmZ--aZgG=~J99)bZ+$dG#Fql>OS3GPgRhuWO zEgjL-ZLlaUQdhLLa8M!<#`^0oB)O!D?AjEf9N_zvNiZZipgqGSnRzpw9l(xIk#?@Y zYNFxJAgUg#|@Tm3&ixT%$u3T&Zk!U2XBtQJ-!%MA9N<(8h>+q zu~WT${AXu>diLJL%HdN>_}g`g24&vPEXJSuEYWx45KXwf>t}m@x@S4DZ!x-WqYQgR zmj48+Hvm3u;*G!>($Gx+c$-C5j`yeum#eo7TN%r_Z4n@#hRA>9x$j1 zyY7-co~(K6RiuWd5y&=d*JZZ5IzSmodSK7fgBOxS!U|TUnf|b;s-_3jl&;)4CdRo zXT5$vwI+(-$nv&klr)vU4}12_LI#klWenrdh)|OUc=M1s79ddggLsJX37q4(OT#R) zno_cz+f_2Dyz))~W<7)tNbKjSja>N#GaDzV@NDcBX=DAZ4>8aA1#U2~yOgfpw@$x# zdNDq{+Oy?m?Csd?T`R-SE#a@{InlD%vwLIT8e)VkBIHc$Ssi@xX6^0TV$U=8`?ubB z?Y*71^ban*bLq~ZmA%K8_8wo}`|{F`mwy@lm)JkWmbYJA?w?qUPpo3)$u}n#yLR3Q z|2%d#_R+4D%(*4}jh7hZptsY*x2&IG`Ydz$$0eK7Ir(^HqG^Ku13mTyy4#Z<2$>4p1hk}P8?c@f8KT_6xeYs|6dCIGWh=sU!A|5 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/url.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/url.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..cf9ca79ee9dfdcff3c4f32e7a9c284cb47da6893 GIT binary patch literal 15795 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/wait.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/__pycache__/wait.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..496ff0f667d20417bc95016e1b6f77acab878e87 GIT binary patch literal 4403 zcmc&%|4$sp6`$GN+uQpN=4=84a$cjLQ8oC4)rs{GRqJ0y#%Cd5UOW-M1vVqxSoCVR&C{sz$9T zBUcGwlIEKt{lToL`LWjaXn`r(AA&jvbyy2QZ$t}&Y|gH>Wb&P&3f z#yrspMzLR*pmBl8+!N7JQmL#us;5$pKb0CawR{HK!Bpz4yqa+}cgQ9VwEg46kU6R+ zSWdT@IcB7X5@}P@6F)SpbfR}m&yFQB#Q~MMRJGsu@GqDf+GxM9WMsi%-a?Y5sR@1R8APeX|suxnN1m4n=!=7 zA$Tl|U5VU}G|%?Dd!wwhb9Ww^9o^xx?}r)ZVdhfMu7w^zT=SzSWJ5OE@v>B{3v?1% zMZpJPe$?*+#FnaN#KsNdWmu`T8ufqx(7R9+3*sjy%ovV0{JBpeX)Cd~ejP$7wwc#6CwfvI7jm zA6FdDK*m&UhAVZv7cROemn}V`r)|fhbI?mF8?^XK)^t2)&-Yz=BQCKhe8PZ6h@)tb z3mGG;J5;xDq!<*wv3w)BNIGp~Hv8oPO8@$z!(k?B{y z2=7@JLZQz4t!)cEH*b`i_CNSC+VSC!etY$UtL2tM8^j;#{Guf~|H9l03s25{=OfRb z0>2B~YdO3YZTq6D`{TByj^(anv**@YyB3>&bz^P+fdwzLKYHr6=MP8jwf3&2OZK3nO@ph9xww(@(e?8?n?Gyjz^FTXY-*~XVt>*ySfCd803Kaw^u-gW_ zO$SL)g2z*!thpc!*8vBgR!f1@AW31n!OHVZR(6e>cfzm^$lADs6r_Tu;908rUX*QL zO;?Z$;!-tbuYylSZ&4}w>_A=by-qFQ%Yp*60JX2?<3&i@zU`x zmeEz{Ftd8h9Ec$kp18#F`jHrCLEetbPVkL<7L&b-DK(b^`e7In)`0?(+>x%CW+v`; zBnw#9kvOY*_%JTEWR@P%K_idznxoE<8QM)iXSKf0YYVdvvF8?-TK2hEPSu$jCjzoT zKqld_CO`ni1R@`JD&h8W$Ay*fYh~rNwNRv#_%Ybi)}b%O~R-Z>tOf@KoY6)c5EEO&vCYuVtT-59UN zpYO;s@^BqS?o24*1dwWgqhwkhpqe)_l0JE@Ny06piabe+(l z2LaRq&*m`@zorl%@>5R%sD2X8pCXx|!#l0P21_IBIHHYz!6wu%v&$Gw+M{Q$3V=J-8mK*X|gM8#@xhyMt>`B zjHwwtYsb_v)ySyVGJ2fyE6W{$b;3Z7JTi_)*h5#2Xf_Y~{m6#0lVCmykA;VHiB$Xt z$_LM^_|KN5vtRcX(+oY{oB}ZqSBQqc!}VkYRkhTTrbrr$ULd@G0A7#>$TJI|b^u;IS||C9$3qQ9h^8hG3w$8ga+JDkWP zAaT4ys-;3S-4G|x5F^8mgV>2N_I>O{@e|ZM528fiyinR#y&aYI-kC_n*K}*&!egtx z{gw7-XChy=_fAJDf%b(n<-p;^TK`2|I_Y#)Z|c(U|oN#Vyo491r{M z<<-E6vUI{dQ^aJlkD*08$`Bv!=^|Pamg5`9XVW&^w=DM-hB$I>{((S%eVkx$wJr+UOsx+%#20>> make_headers(keep_alive=True, user_agent="Batman/1.0") + {'connection': 'keep-alive', 'user-agent': 'Batman/1.0'} + >>> make_headers(accept_encoding=True) + {'accept-encoding': 'gzip,deflate'} + """ + headers = {} + if accept_encoding: + if isinstance(accept_encoding, str): + pass + elif isinstance(accept_encoding, list): + accept_encoding = ",".join(accept_encoding) + else: + accept_encoding = ACCEPT_ENCODING + headers["accept-encoding"] = accept_encoding + + if user_agent: + headers["user-agent"] = user_agent + + if keep_alive: + headers["connection"] = "keep-alive" + + if basic_auth: + headers["authorization"] = "Basic " + b64encode(b(basic_auth)).decode("utf-8") + + if proxy_basic_auth: + headers["proxy-authorization"] = "Basic " + b64encode( + b(proxy_basic_auth) + ).decode("utf-8") + + if disable_cache: + headers["cache-control"] = "no-cache" + + return headers + + +def set_file_position(body, pos): + """ + If a position is provided, move file to that point. + Otherwise, we'll attempt to record a position for future use. + """ + if pos is not None: + rewind_body(body, pos) + elif getattr(body, "tell", None) is not None: + try: + pos = body.tell() + except (IOError, OSError): + # This differentiates from None, allowing us to catch + # a failed `tell()` later when trying to rewind the body. + pos = _FAILEDTELL + + return pos + + +def rewind_body(body, body_pos): + """ + Attempt to rewind body to a certain position. + Primarily used for request redirects and retries. + + :param body: + File-like object that supports seek. + + :param int pos: + Position to seek to in file. + """ + body_seek = getattr(body, "seek", None) + if body_seek is not None and isinstance(body_pos, integer_types): + try: + body_seek(body_pos) + except (IOError, OSError): + raise UnrewindableBodyError( + "An error occurred when rewinding request body for redirect/retry." + ) + elif body_pos is _FAILEDTELL: + raise UnrewindableBodyError( + "Unable to record file position for rewinding " + "request body during a redirect/retry." + ) + else: + raise ValueError( + "body_pos must be of type integer, instead it was %s." % type(body_pos) + ) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/response.py b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/response.py new file mode 100644 index 0000000..5ea609c --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/response.py @@ -0,0 +1,107 @@ +from __future__ import absolute_import + +from email.errors import MultipartInvariantViolationDefect, StartBoundaryNotFoundDefect + +from ..exceptions import HeaderParsingError +from ..packages.six.moves import http_client as httplib + + +def is_fp_closed(obj): + """ + Checks whether a given file-like object is closed. + + :param obj: + The file-like object to check. + """ + + try: + # Check `isclosed()` first, in case Python3 doesn't set `closed`. + # GH Issue #928 + return obj.isclosed() + except AttributeError: + pass + + try: + # Check via the official file-like-object way. + return obj.closed + except AttributeError: + pass + + try: + # Check if the object is a container for another file-like object that + # gets released on exhaustion (e.g. HTTPResponse). + return obj.fp is None + except AttributeError: + pass + + raise ValueError("Unable to determine whether fp is closed.") + + +def assert_header_parsing(headers): + """ + Asserts whether all headers have been successfully parsed. + Extracts encountered errors from the result of parsing headers. + + Only works on Python 3. + + :param http.client.HTTPMessage headers: Headers to verify. + + :raises urllib3.exceptions.HeaderParsingError: + If parsing errors are found. + """ + + # This will fail silently if we pass in the wrong kind of parameter. + # To make debugging easier add an explicit check. + if not isinstance(headers, httplib.HTTPMessage): + raise TypeError("expected httplib.Message, got {0}.".format(type(headers))) + + defects = getattr(headers, "defects", None) + get_payload = getattr(headers, "get_payload", None) + + unparsed_data = None + if get_payload: + # get_payload is actually email.message.Message.get_payload; + # we're only interested in the result if it's not a multipart message + if not headers.is_multipart(): + payload = get_payload() + + if isinstance(payload, (bytes, str)): + unparsed_data = payload + if defects: + # httplib is assuming a response body is available + # when parsing headers even when httplib only sends + # header data to parse_headers() This results in + # defects on multipart responses in particular. + # See: https://github.com/urllib3/urllib3/issues/800 + + # So we ignore the following defects: + # - StartBoundaryNotFoundDefect: + # The claimed start boundary was never found. + # - MultipartInvariantViolationDefect: + # A message claimed to be a multipart but no subparts were found. + defects = [ + defect + for defect in defects + if not isinstance( + defect, (StartBoundaryNotFoundDefect, MultipartInvariantViolationDefect) + ) + ] + + if defects or unparsed_data: + raise HeaderParsingError(defects=defects, unparsed_data=unparsed_data) + + +def is_response_to_head(response): + """ + Checks whether the request of a response has been a HEAD-request. + Handles the quirks of AppEngine. + + :param http.client.HTTPResponse response: + Response to check if the originating request + used 'HEAD' as a method. + """ + # FIXME: Can we do this somehow without accessing private httplib _method? + method = response._method + if isinstance(method, int): # Platform-specific: Appengine + return method == 3 + return method.upper() == "HEAD" diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/retry.py b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/retry.py new file mode 100644 index 0000000..60ef6c4 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/retry.py @@ -0,0 +1,620 @@ +from __future__ import absolute_import + +import email +import logging +import re +import time +import warnings +from collections import namedtuple +from itertools import takewhile + +from ..exceptions import ( + ConnectTimeoutError, + InvalidHeader, + MaxRetryError, + ProtocolError, + ProxyError, + ReadTimeoutError, + ResponseError, +) +from ..packages import six + +log = logging.getLogger(__name__) + + +# Data structure for representing the metadata of requests that result in a retry. +RequestHistory = namedtuple( + "RequestHistory", ["method", "url", "error", "status", "redirect_location"] +) + + +# TODO: In v2 we can remove this sentinel and metaclass with deprecated options. +_Default = object() + + +class _RetryMeta(type): + @property + def DEFAULT_METHOD_WHITELIST(cls): + warnings.warn( + "Using 'Retry.DEFAULT_METHOD_WHITELIST' is deprecated and " + "will be removed in v2.0. Use 'Retry.DEFAULT_ALLOWED_METHODS' instead", + DeprecationWarning, + ) + return cls.DEFAULT_ALLOWED_METHODS + + @DEFAULT_METHOD_WHITELIST.setter + def DEFAULT_METHOD_WHITELIST(cls, value): + warnings.warn( + "Using 'Retry.DEFAULT_METHOD_WHITELIST' is deprecated and " + "will be removed in v2.0. Use 'Retry.DEFAULT_ALLOWED_METHODS' instead", + DeprecationWarning, + ) + cls.DEFAULT_ALLOWED_METHODS = value + + @property + def DEFAULT_REDIRECT_HEADERS_BLACKLIST(cls): + warnings.warn( + "Using 'Retry.DEFAULT_REDIRECT_HEADERS_BLACKLIST' is deprecated and " + "will be removed in v2.0. Use 'Retry.DEFAULT_REMOVE_HEADERS_ON_REDIRECT' instead", + DeprecationWarning, + ) + return cls.DEFAULT_REMOVE_HEADERS_ON_REDIRECT + + @DEFAULT_REDIRECT_HEADERS_BLACKLIST.setter + def DEFAULT_REDIRECT_HEADERS_BLACKLIST(cls, value): + warnings.warn( + "Using 'Retry.DEFAULT_REDIRECT_HEADERS_BLACKLIST' is deprecated and " + "will be removed in v2.0. Use 'Retry.DEFAULT_REMOVE_HEADERS_ON_REDIRECT' instead", + DeprecationWarning, + ) + cls.DEFAULT_REMOVE_HEADERS_ON_REDIRECT = value + + @property + def BACKOFF_MAX(cls): + warnings.warn( + "Using 'Retry.BACKOFF_MAX' is deprecated and " + "will be removed in v2.0. Use 'Retry.DEFAULT_BACKOFF_MAX' instead", + DeprecationWarning, + ) + return cls.DEFAULT_BACKOFF_MAX + + @BACKOFF_MAX.setter + def BACKOFF_MAX(cls, value): + warnings.warn( + "Using 'Retry.BACKOFF_MAX' is deprecated and " + "will be removed in v2.0. Use 'Retry.DEFAULT_BACKOFF_MAX' instead", + DeprecationWarning, + ) + cls.DEFAULT_BACKOFF_MAX = value + + +@six.add_metaclass(_RetryMeta) +class Retry(object): + """Retry configuration. + + Each retry attempt will create a new Retry object with updated values, so + they can be safely reused. + + Retries can be defined as a default for a pool:: + + retries = Retry(connect=5, read=2, redirect=5) + http = PoolManager(retries=retries) + response = http.request('GET', 'http://example.com/') + + Or per-request (which overrides the default for the pool):: + + response = http.request('GET', 'http://example.com/', retries=Retry(10)) + + Retries can be disabled by passing ``False``:: + + response = http.request('GET', 'http://example.com/', retries=False) + + Errors will be wrapped in :class:`~urllib3.exceptions.MaxRetryError` unless + retries are disabled, in which case the causing exception will be raised. + + :param int total: + Total number of retries to allow. Takes precedence over other counts. + + Set to ``None`` to remove this constraint and fall back on other + counts. + + Set to ``0`` to fail on the first retry. + + Set to ``False`` to disable and imply ``raise_on_redirect=False``. + + :param int connect: + How many connection-related errors to retry on. + + These are errors raised before the request is sent to the remote server, + which we assume has not triggered the server to process the request. + + Set to ``0`` to fail on the first retry of this type. + + :param int read: + How many times to retry on read errors. + + These errors are raised after the request was sent to the server, so the + request may have side-effects. + + Set to ``0`` to fail on the first retry of this type. + + :param int redirect: + How many redirects to perform. Limit this to avoid infinite redirect + loops. + + A redirect is a HTTP response with a status code 301, 302, 303, 307 or + 308. + + Set to ``0`` to fail on the first retry of this type. + + Set to ``False`` to disable and imply ``raise_on_redirect=False``. + + :param int status: + How many times to retry on bad status codes. + + These are retries made on responses, where status code matches + ``status_forcelist``. + + Set to ``0`` to fail on the first retry of this type. + + :param int other: + How many times to retry on other errors. + + Other errors are errors that are not connect, read, redirect or status errors. + These errors might be raised after the request was sent to the server, so the + request might have side-effects. + + Set to ``0`` to fail on the first retry of this type. + + If ``total`` is not set, it's a good idea to set this to 0 to account + for unexpected edge cases and avoid infinite retry loops. + + :param iterable allowed_methods: + Set of uppercased HTTP method verbs that we should retry on. + + By default, we only retry on methods which are considered to be + idempotent (multiple requests with the same parameters end with the + same state). See :attr:`Retry.DEFAULT_ALLOWED_METHODS`. + + Set to a ``False`` value to retry on any verb. + + .. warning:: + + Previously this parameter was named ``method_whitelist``, that + usage is deprecated in v1.26.0 and will be removed in v2.0. + + :param iterable status_forcelist: + A set of integer HTTP status codes that we should force a retry on. + A retry is initiated if the request method is in ``allowed_methods`` + and the response status code is in ``status_forcelist``. + + By default, this is disabled with ``None``. + + :param float backoff_factor: + A backoff factor to apply between attempts after the second try + (most errors are resolved immediately by a second try without a + delay). urllib3 will sleep for:: + + {backoff factor} * (2 ** ({number of total retries} - 1)) + + seconds. If the backoff_factor is 0.1, then :func:`.sleep` will sleep + for [0.0s, 0.2s, 0.4s, ...] between retries. It will never be longer + than :attr:`Retry.DEFAULT_BACKOFF_MAX`. + + By default, backoff is disabled (set to 0). + + :param bool raise_on_redirect: Whether, if the number of redirects is + exhausted, to raise a MaxRetryError, or to return a response with a + response code in the 3xx range. + + :param bool raise_on_status: Similar meaning to ``raise_on_redirect``: + whether we should raise an exception, or return a response, + if status falls in ``status_forcelist`` range and retries have + been exhausted. + + :param tuple history: The history of the request encountered during + each call to :meth:`~Retry.increment`. The list is in the order + the requests occurred. Each list item is of class :class:`RequestHistory`. + + :param bool respect_retry_after_header: + Whether to respect Retry-After header on status codes defined as + :attr:`Retry.RETRY_AFTER_STATUS_CODES` or not. + + :param iterable remove_headers_on_redirect: + Sequence of headers to remove from the request when a response + indicating a redirect is returned before firing off the redirected + request. + """ + + #: Default methods to be used for ``allowed_methods`` + DEFAULT_ALLOWED_METHODS = frozenset( + ["HEAD", "GET", "PUT", "DELETE", "OPTIONS", "TRACE"] + ) + + #: Default status codes to be used for ``status_forcelist`` + RETRY_AFTER_STATUS_CODES = frozenset([413, 429, 503]) + + #: Default headers to be used for ``remove_headers_on_redirect`` + DEFAULT_REMOVE_HEADERS_ON_REDIRECT = frozenset(["Cookie", "Authorization"]) + + #: Maximum backoff time. + DEFAULT_BACKOFF_MAX = 120 + + def __init__( + self, + total=10, + connect=None, + read=None, + redirect=None, + status=None, + other=None, + allowed_methods=_Default, + status_forcelist=None, + backoff_factor=0, + raise_on_redirect=True, + raise_on_status=True, + history=None, + respect_retry_after_header=True, + remove_headers_on_redirect=_Default, + # TODO: Deprecated, remove in v2.0 + method_whitelist=_Default, + ): + + if method_whitelist is not _Default: + if allowed_methods is not _Default: + raise ValueError( + "Using both 'allowed_methods' and " + "'method_whitelist' together is not allowed. " + "Instead only use 'allowed_methods'" + ) + warnings.warn( + "Using 'method_whitelist' with Retry is deprecated and " + "will be removed in v2.0. Use 'allowed_methods' instead", + DeprecationWarning, + stacklevel=2, + ) + allowed_methods = method_whitelist + if allowed_methods is _Default: + allowed_methods = self.DEFAULT_ALLOWED_METHODS + if remove_headers_on_redirect is _Default: + remove_headers_on_redirect = self.DEFAULT_REMOVE_HEADERS_ON_REDIRECT + + self.total = total + self.connect = connect + self.read = read + self.status = status + self.other = other + + if redirect is False or total is False: + redirect = 0 + raise_on_redirect = False + + self.redirect = redirect + self.status_forcelist = status_forcelist or set() + self.allowed_methods = allowed_methods + self.backoff_factor = backoff_factor + self.raise_on_redirect = raise_on_redirect + self.raise_on_status = raise_on_status + self.history = history or tuple() + self.respect_retry_after_header = respect_retry_after_header + self.remove_headers_on_redirect = frozenset( + [h.lower() for h in remove_headers_on_redirect] + ) + + def new(self, **kw): + params = dict( + total=self.total, + connect=self.connect, + read=self.read, + redirect=self.redirect, + status=self.status, + other=self.other, + status_forcelist=self.status_forcelist, + backoff_factor=self.backoff_factor, + raise_on_redirect=self.raise_on_redirect, + raise_on_status=self.raise_on_status, + history=self.history, + remove_headers_on_redirect=self.remove_headers_on_redirect, + respect_retry_after_header=self.respect_retry_after_header, + ) + + # TODO: If already given in **kw we use what's given to us + # If not given we need to figure out what to pass. We decide + # based on whether our class has the 'method_whitelist' property + # and if so we pass the deprecated 'method_whitelist' otherwise + # we use 'allowed_methods'. Remove in v2.0 + if "method_whitelist" not in kw and "allowed_methods" not in kw: + if "method_whitelist" in self.__dict__: + warnings.warn( + "Using 'method_whitelist' with Retry is deprecated and " + "will be removed in v2.0. Use 'allowed_methods' instead", + DeprecationWarning, + ) + params["method_whitelist"] = self.allowed_methods + else: + params["allowed_methods"] = self.allowed_methods + + params.update(kw) + return type(self)(**params) + + @classmethod + def from_int(cls, retries, redirect=True, default=None): + """Backwards-compatibility for the old retries format.""" + if retries is None: + retries = default if default is not None else cls.DEFAULT + + if isinstance(retries, Retry): + return retries + + redirect = bool(redirect) and None + new_retries = cls(retries, redirect=redirect) + log.debug("Converted retries value: %r -> %r", retries, new_retries) + return new_retries + + def get_backoff_time(self): + """Formula for computing the current backoff + + :rtype: float + """ + # We want to consider only the last consecutive errors sequence (Ignore redirects). + consecutive_errors_len = len( + list( + takewhile(lambda x: x.redirect_location is None, reversed(self.history)) + ) + ) + if consecutive_errors_len <= 1: + return 0 + + backoff_value = self.backoff_factor * (2 ** (consecutive_errors_len - 1)) + return min(self.DEFAULT_BACKOFF_MAX, backoff_value) + + def parse_retry_after(self, retry_after): + # Whitespace: https://tools.ietf.org/html/rfc7230#section-3.2.4 + if re.match(r"^\s*[0-9]+\s*$", retry_after): + seconds = int(retry_after) + else: + retry_date_tuple = email.utils.parsedate_tz(retry_after) + if retry_date_tuple is None: + raise InvalidHeader("Invalid Retry-After header: %s" % retry_after) + if retry_date_tuple[9] is None: # Python 2 + # Assume UTC if no timezone was specified + # On Python2.7, parsedate_tz returns None for a timezone offset + # instead of 0 if no timezone is given, where mktime_tz treats + # a None timezone offset as local time. + retry_date_tuple = retry_date_tuple[:9] + (0,) + retry_date_tuple[10:] + + retry_date = email.utils.mktime_tz(retry_date_tuple) + seconds = retry_date - time.time() + + if seconds < 0: + seconds = 0 + + return seconds + + def get_retry_after(self, response): + """Get the value of Retry-After in seconds.""" + + retry_after = response.headers.get("Retry-After") + + if retry_after is None: + return None + + return self.parse_retry_after(retry_after) + + def sleep_for_retry(self, response=None): + retry_after = self.get_retry_after(response) + if retry_after: + time.sleep(retry_after) + return True + + return False + + def _sleep_backoff(self): + backoff = self.get_backoff_time() + if backoff <= 0: + return + time.sleep(backoff) + + def sleep(self, response=None): + """Sleep between retry attempts. + + This method will respect a server's ``Retry-After`` response header + and sleep the duration of the time requested. If that is not present, it + will use an exponential backoff. By default, the backoff factor is 0 and + this method will return immediately. + """ + + if self.respect_retry_after_header and response: + slept = self.sleep_for_retry(response) + if slept: + return + + self._sleep_backoff() + + def _is_connection_error(self, err): + """Errors when we're fairly sure that the server did not receive the + request, so it should be safe to retry. + """ + if isinstance(err, ProxyError): + err = err.original_error + return isinstance(err, ConnectTimeoutError) + + def _is_read_error(self, err): + """Errors that occur after the request has been started, so we should + assume that the server began processing it. + """ + return isinstance(err, (ReadTimeoutError, ProtocolError)) + + def _is_method_retryable(self, method): + """Checks if a given HTTP method should be retried upon, depending if + it is included in the allowed_methods + """ + # TODO: For now favor if the Retry implementation sets its own method_whitelist + # property outside of our constructor to avoid breaking custom implementations. + if "method_whitelist" in self.__dict__: + warnings.warn( + "Using 'method_whitelist' with Retry is deprecated and " + "will be removed in v2.0. Use 'allowed_methods' instead", + DeprecationWarning, + ) + allowed_methods = self.method_whitelist + else: + allowed_methods = self.allowed_methods + + if allowed_methods and method.upper() not in allowed_methods: + return False + return True + + def is_retry(self, method, status_code, has_retry_after=False): + """Is this method/status code retryable? (Based on allowlists and control + variables such as the number of total retries to allow, whether to + respect the Retry-After header, whether this header is present, and + whether the returned status code is on the list of status codes to + be retried upon on the presence of the aforementioned header) + """ + if not self._is_method_retryable(method): + return False + + if self.status_forcelist and status_code in self.status_forcelist: + return True + + return ( + self.total + and self.respect_retry_after_header + and has_retry_after + and (status_code in self.RETRY_AFTER_STATUS_CODES) + ) + + def is_exhausted(self): + """Are we out of retries?""" + retry_counts = ( + self.total, + self.connect, + self.read, + self.redirect, + self.status, + self.other, + ) + retry_counts = list(filter(None, retry_counts)) + if not retry_counts: + return False + + return min(retry_counts) < 0 + + def increment( + self, + method=None, + url=None, + response=None, + error=None, + _pool=None, + _stacktrace=None, + ): + """Return a new Retry object with incremented retry counters. + + :param response: A response object, or None, if the server did not + return a response. + :type response: :class:`~urllib3.response.HTTPResponse` + :param Exception error: An error encountered during the request, or + None if the response was received successfully. + + :return: A new ``Retry`` object. + """ + if self.total is False and error: + # Disabled, indicate to re-raise the error. + raise six.reraise(type(error), error, _stacktrace) + + total = self.total + if total is not None: + total -= 1 + + connect = self.connect + read = self.read + redirect = self.redirect + status_count = self.status + other = self.other + cause = "unknown" + status = None + redirect_location = None + + if error and self._is_connection_error(error): + # Connect retry? + if connect is False: + raise six.reraise(type(error), error, _stacktrace) + elif connect is not None: + connect -= 1 + + elif error and self._is_read_error(error): + # Read retry? + if read is False or not self._is_method_retryable(method): + raise six.reraise(type(error), error, _stacktrace) + elif read is not None: + read -= 1 + + elif error: + # Other retry? + if other is not None: + other -= 1 + + elif response and response.get_redirect_location(): + # Redirect retry? + if redirect is not None: + redirect -= 1 + cause = "too many redirects" + redirect_location = response.get_redirect_location() + status = response.status + + else: + # Incrementing because of a server error like a 500 in + # status_forcelist and the given method is in the allowed_methods + cause = ResponseError.GENERIC_ERROR + if response and response.status: + if status_count is not None: + status_count -= 1 + cause = ResponseError.SPECIFIC_ERROR.format(status_code=response.status) + status = response.status + + history = self.history + ( + RequestHistory(method, url, error, status, redirect_location), + ) + + new_retry = self.new( + total=total, + connect=connect, + read=read, + redirect=redirect, + status=status_count, + other=other, + history=history, + ) + + if new_retry.is_exhausted(): + raise MaxRetryError(_pool, url, error or ResponseError(cause)) + + log.debug("Incremented Retry for (url='%s'): %r", url, new_retry) + + return new_retry + + def __repr__(self): + return ( + "{cls.__name__}(total={self.total}, connect={self.connect}, " + "read={self.read}, redirect={self.redirect}, status={self.status})" + ).format(cls=type(self), self=self) + + def __getattr__(self, item): + if item == "method_whitelist": + # TODO: Remove this deprecated alias in v2.0 + warnings.warn( + "Using 'method_whitelist' with Retry is deprecated and " + "will be removed in v2.0. Use 'allowed_methods' instead", + DeprecationWarning, + ) + return self.allowed_methods + try: + return getattr(super(Retry, self), item) + except AttributeError: + return getattr(Retry, item) + + +# For backwards compatibility (equivalent to pre-v1.9): +Retry.DEFAULT = Retry(3) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/ssl_.py b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/ssl_.py new file mode 100644 index 0000000..2b45d39 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/ssl_.py @@ -0,0 +1,495 @@ +from __future__ import absolute_import + +import hmac +import os +import sys +import warnings +from binascii import hexlify, unhexlify +from hashlib import md5, sha1, sha256 + +from ..exceptions import ( + InsecurePlatformWarning, + ProxySchemeUnsupported, + SNIMissingWarning, + SSLError, +) +from ..packages import six +from .url import BRACELESS_IPV6_ADDRZ_RE, IPV4_RE + +SSLContext = None +SSLTransport = None +HAS_SNI = False +IS_PYOPENSSL = False +IS_SECURETRANSPORT = False +ALPN_PROTOCOLS = ["http/1.1"] + +# Maps the length of a digest to a possible hash function producing this digest +HASHFUNC_MAP = {32: md5, 40: sha1, 64: sha256} + + +def _const_compare_digest_backport(a, b): + """ + Compare two digests of equal length in constant time. + + The digests must be of type str/bytes. + Returns True if the digests match, and False otherwise. + """ + result = abs(len(a) - len(b)) + for left, right in zip(bytearray(a), bytearray(b)): + result |= left ^ right + return result == 0 + + +_const_compare_digest = getattr(hmac, "compare_digest", _const_compare_digest_backport) + +try: # Test for SSL features + import ssl + from ssl import CERT_REQUIRED, wrap_socket +except ImportError: + pass + +try: + from ssl import HAS_SNI # Has SNI? +except ImportError: + pass + +try: + from .ssltransport import SSLTransport +except ImportError: + pass + + +try: # Platform-specific: Python 3.6 + from ssl import PROTOCOL_TLS + + PROTOCOL_SSLv23 = PROTOCOL_TLS +except ImportError: + try: + from ssl import PROTOCOL_SSLv23 as PROTOCOL_TLS + + PROTOCOL_SSLv23 = PROTOCOL_TLS + except ImportError: + PROTOCOL_SSLv23 = PROTOCOL_TLS = 2 + +try: + from ssl import PROTOCOL_TLS_CLIENT +except ImportError: + PROTOCOL_TLS_CLIENT = PROTOCOL_TLS + + +try: + from ssl import OP_NO_COMPRESSION, OP_NO_SSLv2, OP_NO_SSLv3 +except ImportError: + OP_NO_SSLv2, OP_NO_SSLv3 = 0x1000000, 0x2000000 + OP_NO_COMPRESSION = 0x20000 + + +try: # OP_NO_TICKET was added in Python 3.6 + from ssl import OP_NO_TICKET +except ImportError: + OP_NO_TICKET = 0x4000 + + +# A secure default. +# Sources for more information on TLS ciphers: +# +# - https://wiki.mozilla.org/Security/Server_Side_TLS +# - https://www.ssllabs.com/projects/best-practices/index.html +# - https://hynek.me/articles/hardening-your-web-servers-ssl-ciphers/ +# +# The general intent is: +# - prefer cipher suites that offer perfect forward secrecy (DHE/ECDHE), +# - prefer ECDHE over DHE for better performance, +# - prefer any AES-GCM and ChaCha20 over any AES-CBC for better performance and +# security, +# - prefer AES-GCM over ChaCha20 because hardware-accelerated AES is common, +# - disable NULL authentication, MD5 MACs, DSS, and other +# insecure ciphers for security reasons. +# - NOTE: TLS 1.3 cipher suites are managed through a different interface +# not exposed by CPython (yet!) and are enabled by default if they're available. +DEFAULT_CIPHERS = ":".join( + [ + "ECDHE+AESGCM", + "ECDHE+CHACHA20", + "DHE+AESGCM", + "DHE+CHACHA20", + "ECDH+AESGCM", + "DH+AESGCM", + "ECDH+AES", + "DH+AES", + "RSA+AESGCM", + "RSA+AES", + "!aNULL", + "!eNULL", + "!MD5", + "!DSS", + ] +) + +try: + from ssl import SSLContext # Modern SSL? +except ImportError: + + class SSLContext(object): # Platform-specific: Python 2 + def __init__(self, protocol_version): + self.protocol = protocol_version + # Use default values from a real SSLContext + self.check_hostname = False + self.verify_mode = ssl.CERT_NONE + self.ca_certs = None + self.options = 0 + self.certfile = None + self.keyfile = None + self.ciphers = None + + def load_cert_chain(self, certfile, keyfile): + self.certfile = certfile + self.keyfile = keyfile + + def load_verify_locations(self, cafile=None, capath=None, cadata=None): + self.ca_certs = cafile + + if capath is not None: + raise SSLError("CA directories not supported in older Pythons") + + if cadata is not None: + raise SSLError("CA data not supported in older Pythons") + + def set_ciphers(self, cipher_suite): + self.ciphers = cipher_suite + + def wrap_socket(self, socket, server_hostname=None, server_side=False): + warnings.warn( + "A true SSLContext object is not available. This prevents " + "urllib3 from configuring SSL appropriately and may cause " + "certain SSL connections to fail. You can upgrade to a newer " + "version of Python to solve this. For more information, see " + "https://urllib3.readthedocs.io/en/1.26.x/advanced-usage.html" + "#ssl-warnings", + InsecurePlatformWarning, + ) + kwargs = { + "keyfile": self.keyfile, + "certfile": self.certfile, + "ca_certs": self.ca_certs, + "cert_reqs": self.verify_mode, + "ssl_version": self.protocol, + "server_side": server_side, + } + return wrap_socket(socket, ciphers=self.ciphers, **kwargs) + + +def assert_fingerprint(cert, fingerprint): + """ + Checks if given fingerprint matches the supplied certificate. + + :param cert: + Certificate as bytes object. + :param fingerprint: + Fingerprint as string of hexdigits, can be interspersed by colons. + """ + + fingerprint = fingerprint.replace(":", "").lower() + digest_length = len(fingerprint) + hashfunc = HASHFUNC_MAP.get(digest_length) + if not hashfunc: + raise SSLError("Fingerprint of invalid length: {0}".format(fingerprint)) + + # We need encode() here for py32; works on py2 and p33. + fingerprint_bytes = unhexlify(fingerprint.encode()) + + cert_digest = hashfunc(cert).digest() + + if not _const_compare_digest(cert_digest, fingerprint_bytes): + raise SSLError( + 'Fingerprints did not match. Expected "{0}", got "{1}".'.format( + fingerprint, hexlify(cert_digest) + ) + ) + + +def resolve_cert_reqs(candidate): + """ + Resolves the argument to a numeric constant, which can be passed to + the wrap_socket function/method from the ssl module. + Defaults to :data:`ssl.CERT_REQUIRED`. + If given a string it is assumed to be the name of the constant in the + :mod:`ssl` module or its abbreviation. + (So you can specify `REQUIRED` instead of `CERT_REQUIRED`. + If it's neither `None` nor a string we assume it is already the numeric + constant which can directly be passed to wrap_socket. + """ + if candidate is None: + return CERT_REQUIRED + + if isinstance(candidate, str): + res = getattr(ssl, candidate, None) + if res is None: + res = getattr(ssl, "CERT_" + candidate) + return res + + return candidate + + +def resolve_ssl_version(candidate): + """ + like resolve_cert_reqs + """ + if candidate is None: + return PROTOCOL_TLS + + if isinstance(candidate, str): + res = getattr(ssl, candidate, None) + if res is None: + res = getattr(ssl, "PROTOCOL_" + candidate) + return res + + return candidate + + +def create_urllib3_context( + ssl_version=None, cert_reqs=None, options=None, ciphers=None +): + """All arguments have the same meaning as ``ssl_wrap_socket``. + + By default, this function does a lot of the same work that + ``ssl.create_default_context`` does on Python 3.4+. It: + + - Disables SSLv2, SSLv3, and compression + - Sets a restricted set of server ciphers + + If you wish to enable SSLv3, you can do:: + + from pip._vendor.urllib3.util import ssl_ + context = ssl_.create_urllib3_context() + context.options &= ~ssl_.OP_NO_SSLv3 + + You can do the same to enable compression (substituting ``COMPRESSION`` + for ``SSLv3`` in the last line above). + + :param ssl_version: + The desired protocol version to use. This will default to + PROTOCOL_SSLv23 which will negotiate the highest protocol that both + the server and your installation of OpenSSL support. + :param cert_reqs: + Whether to require the certificate verification. This defaults to + ``ssl.CERT_REQUIRED``. + :param options: + Specific OpenSSL options. These default to ``ssl.OP_NO_SSLv2``, + ``ssl.OP_NO_SSLv3``, ``ssl.OP_NO_COMPRESSION``, and ``ssl.OP_NO_TICKET``. + :param ciphers: + Which cipher suites to allow the server to select. + :returns: + Constructed SSLContext object with specified options + :rtype: SSLContext + """ + # PROTOCOL_TLS is deprecated in Python 3.10 + if not ssl_version or ssl_version == PROTOCOL_TLS: + ssl_version = PROTOCOL_TLS_CLIENT + + context = SSLContext(ssl_version) + + context.set_ciphers(ciphers or DEFAULT_CIPHERS) + + # Setting the default here, as we may have no ssl module on import + cert_reqs = ssl.CERT_REQUIRED if cert_reqs is None else cert_reqs + + if options is None: + options = 0 + # SSLv2 is easily broken and is considered harmful and dangerous + options |= OP_NO_SSLv2 + # SSLv3 has several problems and is now dangerous + options |= OP_NO_SSLv3 + # Disable compression to prevent CRIME attacks for OpenSSL 1.0+ + # (issue #309) + options |= OP_NO_COMPRESSION + # TLSv1.2 only. Unless set explicitly, do not request tickets. + # This may save some bandwidth on wire, and although the ticket is encrypted, + # there is a risk associated with it being on wire, + # if the server is not rotating its ticketing keys properly. + options |= OP_NO_TICKET + + context.options |= options + + # Enable post-handshake authentication for TLS 1.3, see GH #1634. PHA is + # necessary for conditional client cert authentication with TLS 1.3. + # The attribute is None for OpenSSL <= 1.1.0 or does not exist in older + # versions of Python. We only enable on Python 3.7.4+ or if certificate + # verification is enabled to work around Python issue #37428 + # See: https://bugs.python.org/issue37428 + if (cert_reqs == ssl.CERT_REQUIRED or sys.version_info >= (3, 7, 4)) and getattr( + context, "post_handshake_auth", None + ) is not None: + context.post_handshake_auth = True + + def disable_check_hostname(): + if ( + getattr(context, "check_hostname", None) is not None + ): # Platform-specific: Python 3.2 + # We do our own verification, including fingerprints and alternative + # hostnames. So disable it here + context.check_hostname = False + + # The order of the below lines setting verify_mode and check_hostname + # matter due to safe-guards SSLContext has to prevent an SSLContext with + # check_hostname=True, verify_mode=NONE/OPTIONAL. This is made even more + # complex because we don't know whether PROTOCOL_TLS_CLIENT will be used + # or not so we don't know the initial state of the freshly created SSLContext. + if cert_reqs == ssl.CERT_REQUIRED: + context.verify_mode = cert_reqs + disable_check_hostname() + else: + disable_check_hostname() + context.verify_mode = cert_reqs + + # Enable logging of TLS session keys via defacto standard environment variable + # 'SSLKEYLOGFILE', if the feature is available (Python 3.8+). Skip empty values. + if hasattr(context, "keylog_filename"): + sslkeylogfile = os.environ.get("SSLKEYLOGFILE") + if sslkeylogfile: + context.keylog_filename = sslkeylogfile + + return context + + +def ssl_wrap_socket( + sock, + keyfile=None, + certfile=None, + cert_reqs=None, + ca_certs=None, + server_hostname=None, + ssl_version=None, + ciphers=None, + ssl_context=None, + ca_cert_dir=None, + key_password=None, + ca_cert_data=None, + tls_in_tls=False, +): + """ + All arguments except for server_hostname, ssl_context, and ca_cert_dir have + the same meaning as they do when using :func:`ssl.wrap_socket`. + + :param server_hostname: + When SNI is supported, the expected hostname of the certificate + :param ssl_context: + A pre-made :class:`SSLContext` object. If none is provided, one will + be created using :func:`create_urllib3_context`. + :param ciphers: + A string of ciphers we wish the client to support. + :param ca_cert_dir: + A directory containing CA certificates in multiple separate files, as + supported by OpenSSL's -CApath flag or the capath argument to + SSLContext.load_verify_locations(). + :param key_password: + Optional password if the keyfile is encrypted. + :param ca_cert_data: + Optional string containing CA certificates in PEM format suitable for + passing as the cadata parameter to SSLContext.load_verify_locations() + :param tls_in_tls: + Use SSLTransport to wrap the existing socket. + """ + context = ssl_context + if context is None: + # Note: This branch of code and all the variables in it are no longer + # used by urllib3 itself. We should consider deprecating and removing + # this code. + context = create_urllib3_context(ssl_version, cert_reqs, ciphers=ciphers) + + if ca_certs or ca_cert_dir or ca_cert_data: + try: + context.load_verify_locations(ca_certs, ca_cert_dir, ca_cert_data) + except (IOError, OSError) as e: + raise SSLError(e) + + elif ssl_context is None and hasattr(context, "load_default_certs"): + # try to load OS default certs; works well on Windows (require Python3.4+) + context.load_default_certs() + + # Attempt to detect if we get the goofy behavior of the + # keyfile being encrypted and OpenSSL asking for the + # passphrase via the terminal and instead error out. + if keyfile and key_password is None and _is_key_file_encrypted(keyfile): + raise SSLError("Client private key is encrypted, password is required") + + if certfile: + if key_password is None: + context.load_cert_chain(certfile, keyfile) + else: + context.load_cert_chain(certfile, keyfile, key_password) + + try: + if hasattr(context, "set_alpn_protocols"): + context.set_alpn_protocols(ALPN_PROTOCOLS) + except NotImplementedError: # Defensive: in CI, we always have set_alpn_protocols + pass + + # If we detect server_hostname is an IP address then the SNI + # extension should not be used according to RFC3546 Section 3.1 + use_sni_hostname = server_hostname and not is_ipaddress(server_hostname) + # SecureTransport uses server_hostname in certificate verification. + send_sni = (use_sni_hostname and HAS_SNI) or ( + IS_SECURETRANSPORT and server_hostname + ) + # Do not warn the user if server_hostname is an invalid SNI hostname. + if not HAS_SNI and use_sni_hostname: + warnings.warn( + "An HTTPS request has been made, but the SNI (Server Name " + "Indication) extension to TLS is not available on this platform. " + "This may cause the server to present an incorrect TLS " + "certificate, which can cause validation failures. You can upgrade to " + "a newer version of Python to solve this. For more information, see " + "https://urllib3.readthedocs.io/en/1.26.x/advanced-usage.html" + "#ssl-warnings", + SNIMissingWarning, + ) + + if send_sni: + ssl_sock = _ssl_wrap_socket_impl( + sock, context, tls_in_tls, server_hostname=server_hostname + ) + else: + ssl_sock = _ssl_wrap_socket_impl(sock, context, tls_in_tls) + return ssl_sock + + +def is_ipaddress(hostname): + """Detects whether the hostname given is an IPv4 or IPv6 address. + Also detects IPv6 addresses with Zone IDs. + + :param str hostname: Hostname to examine. + :return: True if the hostname is an IP address, False otherwise. + """ + if not six.PY2 and isinstance(hostname, bytes): + # IDN A-label bytes are ASCII compatible. + hostname = hostname.decode("ascii") + return bool(IPV4_RE.match(hostname) or BRACELESS_IPV6_ADDRZ_RE.match(hostname)) + + +def _is_key_file_encrypted(key_file): + """Detects if a key file is encrypted or not.""" + with open(key_file, "r") as f: + for line in f: + # Look for Proc-Type: 4,ENCRYPTED + if "ENCRYPTED" in line: + return True + + return False + + +def _ssl_wrap_socket_impl(sock, ssl_context, tls_in_tls, server_hostname=None): + if tls_in_tls: + if not SSLTransport: + # Import error, ssl is not available. + raise ProxySchemeUnsupported( + "TLS in TLS requires support for the 'ssl' module" + ) + + SSLTransport._validate_ssl_context_for_tls_in_tls(ssl_context) + return SSLTransport(sock, ssl_context, server_hostname) + + if server_hostname: + return ssl_context.wrap_socket(sock, server_hostname=server_hostname) + else: + return ssl_context.wrap_socket(sock) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/ssl_match_hostname.py b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/ssl_match_hostname.py new file mode 100644 index 0000000..1dd950c --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/ssl_match_hostname.py @@ -0,0 +1,159 @@ +"""The match_hostname() function from Python 3.3.3, essential when using SSL.""" + +# Note: This file is under the PSF license as the code comes from the python +# stdlib. http://docs.python.org/3/license.html + +import re +import sys + +# ipaddress has been backported to 2.6+ in pypi. If it is installed on the +# system, use it to handle IPAddress ServerAltnames (this was added in +# python-3.5) otherwise only do DNS matching. This allows +# util.ssl_match_hostname to continue to be used in Python 2.7. +try: + import ipaddress +except ImportError: + ipaddress = None + +__version__ = "3.5.0.1" + + +class CertificateError(ValueError): + pass + + +def _dnsname_match(dn, hostname, max_wildcards=1): + """Matching according to RFC 6125, section 6.4.3 + + http://tools.ietf.org/html/rfc6125#section-6.4.3 + """ + pats = [] + if not dn: + return False + + # Ported from python3-syntax: + # leftmost, *remainder = dn.split(r'.') + parts = dn.split(r".") + leftmost = parts[0] + remainder = parts[1:] + + wildcards = leftmost.count("*") + if wildcards > max_wildcards: + # Issue #17980: avoid denials of service by refusing more + # than one wildcard per fragment. A survey of established + # policy among SSL implementations showed it to be a + # reasonable choice. + raise CertificateError( + "too many wildcards in certificate DNS name: " + repr(dn) + ) + + # speed up common case w/o wildcards + if not wildcards: + return dn.lower() == hostname.lower() + + # RFC 6125, section 6.4.3, subitem 1. + # The client SHOULD NOT attempt to match a presented identifier in which + # the wildcard character comprises a label other than the left-most label. + if leftmost == "*": + # When '*' is a fragment by itself, it matches a non-empty dotless + # fragment. + pats.append("[^.]+") + elif leftmost.startswith("xn--") or hostname.startswith("xn--"): + # RFC 6125, section 6.4.3, subitem 3. + # The client SHOULD NOT attempt to match a presented identifier + # where the wildcard character is embedded within an A-label or + # U-label of an internationalized domain name. + pats.append(re.escape(leftmost)) + else: + # Otherwise, '*' matches any dotless string, e.g. www* + pats.append(re.escape(leftmost).replace(r"\*", "[^.]*")) + + # add the remaining fragments, ignore any wildcards + for frag in remainder: + pats.append(re.escape(frag)) + + pat = re.compile(r"\A" + r"\.".join(pats) + r"\Z", re.IGNORECASE) + return pat.match(hostname) + + +def _to_unicode(obj): + if isinstance(obj, str) and sys.version_info < (3,): + # ignored flake8 # F821 to support python 2.7 function + obj = unicode(obj, encoding="ascii", errors="strict") # noqa: F821 + return obj + + +def _ipaddress_match(ipname, host_ip): + """Exact matching of IP addresses. + + RFC 6125 explicitly doesn't define an algorithm for this + (section 1.7.2 - "Out of Scope"). + """ + # OpenSSL may add a trailing newline to a subjectAltName's IP address + # Divergence from upstream: ipaddress can't handle byte str + ip = ipaddress.ip_address(_to_unicode(ipname).rstrip()) + return ip == host_ip + + +def match_hostname(cert, hostname): + """Verify that *cert* (in decoded format as returned by + SSLSocket.getpeercert()) matches the *hostname*. RFC 2818 and RFC 6125 + rules are followed, but IP addresses are not accepted for *hostname*. + + CertificateError is raised on failure. On success, the function + returns nothing. + """ + if not cert: + raise ValueError( + "empty or no certificate, match_hostname needs a " + "SSL socket or SSL context with either " + "CERT_OPTIONAL or CERT_REQUIRED" + ) + try: + # Divergence from upstream: ipaddress can't handle byte str + host_ip = ipaddress.ip_address(_to_unicode(hostname)) + except (UnicodeError, ValueError): + # ValueError: Not an IP address (common case) + # UnicodeError: Divergence from upstream: Have to deal with ipaddress not taking + # byte strings. addresses should be all ascii, so we consider it not + # an ipaddress in this case + host_ip = None + except AttributeError: + # Divergence from upstream: Make ipaddress library optional + if ipaddress is None: + host_ip = None + else: # Defensive + raise + dnsnames = [] + san = cert.get("subjectAltName", ()) + for key, value in san: + if key == "DNS": + if host_ip is None and _dnsname_match(value, hostname): + return + dnsnames.append(value) + elif key == "IP Address": + if host_ip is not None and _ipaddress_match(value, host_ip): + return + dnsnames.append(value) + if not dnsnames: + # The subject is only checked when there is no dNSName entry + # in subjectAltName + for sub in cert.get("subject", ()): + for key, value in sub: + # XXX according to RFC 2818, the most specific Common Name + # must be used. + if key == "commonName": + if _dnsname_match(value, hostname): + return + dnsnames.append(value) + if len(dnsnames) > 1: + raise CertificateError( + "hostname %r " + "doesn't match either of %s" % (hostname, ", ".join(map(repr, dnsnames))) + ) + elif len(dnsnames) == 1: + raise CertificateError("hostname %r doesn't match %r" % (hostname, dnsnames[0])) + else: + raise CertificateError( + "no appropriate commonName or subjectAltName fields were found" + ) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/ssltransport.py b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/ssltransport.py new file mode 100644 index 0000000..4a7105d --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/ssltransport.py @@ -0,0 +1,221 @@ +import io +import socket +import ssl + +from ..exceptions import ProxySchemeUnsupported +from ..packages import six + +SSL_BLOCKSIZE = 16384 + + +class SSLTransport: + """ + The SSLTransport wraps an existing socket and establishes an SSL connection. + + Contrary to Python's implementation of SSLSocket, it allows you to chain + multiple TLS connections together. It's particularly useful if you need to + implement TLS within TLS. + + The class supports most of the socket API operations. + """ + + @staticmethod + def _validate_ssl_context_for_tls_in_tls(ssl_context): + """ + Raises a ProxySchemeUnsupported if the provided ssl_context can't be used + for TLS in TLS. + + The only requirement is that the ssl_context provides the 'wrap_bio' + methods. + """ + + if not hasattr(ssl_context, "wrap_bio"): + if six.PY2: + raise ProxySchemeUnsupported( + "TLS in TLS requires SSLContext.wrap_bio() which isn't " + "supported on Python 2" + ) + else: + raise ProxySchemeUnsupported( + "TLS in TLS requires SSLContext.wrap_bio() which isn't " + "available on non-native SSLContext" + ) + + def __init__( + self, socket, ssl_context, server_hostname=None, suppress_ragged_eofs=True + ): + """ + Create an SSLTransport around socket using the provided ssl_context. + """ + self.incoming = ssl.MemoryBIO() + self.outgoing = ssl.MemoryBIO() + + self.suppress_ragged_eofs = suppress_ragged_eofs + self.socket = socket + + self.sslobj = ssl_context.wrap_bio( + self.incoming, self.outgoing, server_hostname=server_hostname + ) + + # Perform initial handshake. + self._ssl_io_loop(self.sslobj.do_handshake) + + def __enter__(self): + return self + + def __exit__(self, *_): + self.close() + + def fileno(self): + return self.socket.fileno() + + def read(self, len=1024, buffer=None): + return self._wrap_ssl_read(len, buffer) + + def recv(self, len=1024, flags=0): + if flags != 0: + raise ValueError("non-zero flags not allowed in calls to recv") + return self._wrap_ssl_read(len) + + def recv_into(self, buffer, nbytes=None, flags=0): + if flags != 0: + raise ValueError("non-zero flags not allowed in calls to recv_into") + if buffer and (nbytes is None): + nbytes = len(buffer) + elif nbytes is None: + nbytes = 1024 + return self.read(nbytes, buffer) + + def sendall(self, data, flags=0): + if flags != 0: + raise ValueError("non-zero flags not allowed in calls to sendall") + count = 0 + with memoryview(data) as view, view.cast("B") as byte_view: + amount = len(byte_view) + while count < amount: + v = self.send(byte_view[count:]) + count += v + + def send(self, data, flags=0): + if flags != 0: + raise ValueError("non-zero flags not allowed in calls to send") + response = self._ssl_io_loop(self.sslobj.write, data) + return response + + def makefile( + self, mode="r", buffering=None, encoding=None, errors=None, newline=None + ): + """ + Python's httpclient uses makefile and buffered io when reading HTTP + messages and we need to support it. + + This is unfortunately a copy and paste of socket.py makefile with small + changes to point to the socket directly. + """ + if not set(mode) <= {"r", "w", "b"}: + raise ValueError("invalid mode %r (only r, w, b allowed)" % (mode,)) + + writing = "w" in mode + reading = "r" in mode or not writing + assert reading or writing + binary = "b" in mode + rawmode = "" + if reading: + rawmode += "r" + if writing: + rawmode += "w" + raw = socket.SocketIO(self, rawmode) + self.socket._io_refs += 1 + if buffering is None: + buffering = -1 + if buffering < 0: + buffering = io.DEFAULT_BUFFER_SIZE + if buffering == 0: + if not binary: + raise ValueError("unbuffered streams must be binary") + return raw + if reading and writing: + buffer = io.BufferedRWPair(raw, raw, buffering) + elif reading: + buffer = io.BufferedReader(raw, buffering) + else: + assert writing + buffer = io.BufferedWriter(raw, buffering) + if binary: + return buffer + text = io.TextIOWrapper(buffer, encoding, errors, newline) + text.mode = mode + return text + + def unwrap(self): + self._ssl_io_loop(self.sslobj.unwrap) + + def close(self): + self.socket.close() + + def getpeercert(self, binary_form=False): + return self.sslobj.getpeercert(binary_form) + + def version(self): + return self.sslobj.version() + + def cipher(self): + return self.sslobj.cipher() + + def selected_alpn_protocol(self): + return self.sslobj.selected_alpn_protocol() + + def selected_npn_protocol(self): + return self.sslobj.selected_npn_protocol() + + def shared_ciphers(self): + return self.sslobj.shared_ciphers() + + def compression(self): + return self.sslobj.compression() + + def settimeout(self, value): + self.socket.settimeout(value) + + def gettimeout(self): + return self.socket.gettimeout() + + def _decref_socketios(self): + self.socket._decref_socketios() + + def _wrap_ssl_read(self, len, buffer=None): + try: + return self._ssl_io_loop(self.sslobj.read, len, buffer) + except ssl.SSLError as e: + if e.errno == ssl.SSL_ERROR_EOF and self.suppress_ragged_eofs: + return 0 # eof, return 0. + else: + raise + + def _ssl_io_loop(self, func, *args): + """Performs an I/O loop between incoming/outgoing and the socket.""" + should_loop = True + ret = None + + while should_loop: + errno = None + try: + ret = func(*args) + except ssl.SSLError as e: + if e.errno not in (ssl.SSL_ERROR_WANT_READ, ssl.SSL_ERROR_WANT_WRITE): + # WANT_READ, and WANT_WRITE are expected, others are not. + raise e + errno = e.errno + + buf = self.outgoing.read() + self.socket.sendall(buf) + + if errno is None: + should_loop = False + elif errno == ssl.SSL_ERROR_WANT_READ: + buf = self.socket.recv(SSL_BLOCKSIZE) + if buf: + self.incoming.write(buf) + else: + self.incoming.write_eof() + return ret diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/timeout.py b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/timeout.py new file mode 100644 index 0000000..78e18a6 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/timeout.py @@ -0,0 +1,271 @@ +from __future__ import absolute_import + +import time + +# The default socket timeout, used by httplib to indicate that no timeout was; specified by the user +from socket import _GLOBAL_DEFAULT_TIMEOUT, getdefaulttimeout + +from ..exceptions import TimeoutStateError + +# A sentinel value to indicate that no timeout was specified by the user in +# urllib3 +_Default = object() + + +# Use time.monotonic if available. +current_time = getattr(time, "monotonic", time.time) + + +class Timeout(object): + """Timeout configuration. + + Timeouts can be defined as a default for a pool: + + .. code-block:: python + + timeout = Timeout(connect=2.0, read=7.0) + http = PoolManager(timeout=timeout) + response = http.request('GET', 'http://example.com/') + + Or per-request (which overrides the default for the pool): + + .. code-block:: python + + response = http.request('GET', 'http://example.com/', timeout=Timeout(10)) + + Timeouts can be disabled by setting all the parameters to ``None``: + + .. code-block:: python + + no_timeout = Timeout(connect=None, read=None) + response = http.request('GET', 'http://example.com/, timeout=no_timeout) + + + :param total: + This combines the connect and read timeouts into one; the read timeout + will be set to the time leftover from the connect attempt. In the + event that both a connect timeout and a total are specified, or a read + timeout and a total are specified, the shorter timeout will be applied. + + Defaults to None. + + :type total: int, float, or None + + :param connect: + The maximum amount of time (in seconds) to wait for a connection + attempt to a server to succeed. Omitting the parameter will default the + connect timeout to the system default, probably `the global default + timeout in socket.py + `_. + None will set an infinite timeout for connection attempts. + + :type connect: int, float, or None + + :param read: + The maximum amount of time (in seconds) to wait between consecutive + read operations for a response from the server. Omitting the parameter + will default the read timeout to the system default, probably `the + global default timeout in socket.py + `_. + None will set an infinite timeout. + + :type read: int, float, or None + + .. note:: + + Many factors can affect the total amount of time for urllib3 to return + an HTTP response. + + For example, Python's DNS resolver does not obey the timeout specified + on the socket. Other factors that can affect total request time include + high CPU load, high swap, the program running at a low priority level, + or other behaviors. + + In addition, the read and total timeouts only measure the time between + read operations on the socket connecting the client and the server, + not the total amount of time for the request to return a complete + response. For most requests, the timeout is raised because the server + has not sent the first byte in the specified time. This is not always + the case; if a server streams one byte every fifteen seconds, a timeout + of 20 seconds will not trigger, even though the request will take + several minutes to complete. + + If your goal is to cut off any request after a set amount of wall clock + time, consider having a second "watcher" thread to cut off a slow + request. + """ + + #: A sentinel object representing the default timeout value + DEFAULT_TIMEOUT = _GLOBAL_DEFAULT_TIMEOUT + + def __init__(self, total=None, connect=_Default, read=_Default): + self._connect = self._validate_timeout(connect, "connect") + self._read = self._validate_timeout(read, "read") + self.total = self._validate_timeout(total, "total") + self._start_connect = None + + def __repr__(self): + return "%s(connect=%r, read=%r, total=%r)" % ( + type(self).__name__, + self._connect, + self._read, + self.total, + ) + + # __str__ provided for backwards compatibility + __str__ = __repr__ + + @classmethod + def resolve_default_timeout(cls, timeout): + return getdefaulttimeout() if timeout is cls.DEFAULT_TIMEOUT else timeout + + @classmethod + def _validate_timeout(cls, value, name): + """Check that a timeout attribute is valid. + + :param value: The timeout value to validate + :param name: The name of the timeout attribute to validate. This is + used to specify in error messages. + :return: The validated and casted version of the given value. + :raises ValueError: If it is a numeric value less than or equal to + zero, or the type is not an integer, float, or None. + """ + if value is _Default: + return cls.DEFAULT_TIMEOUT + + if value is None or value is cls.DEFAULT_TIMEOUT: + return value + + if isinstance(value, bool): + raise ValueError( + "Timeout cannot be a boolean value. It must " + "be an int, float or None." + ) + try: + float(value) + except (TypeError, ValueError): + raise ValueError( + "Timeout value %s was %s, but it must be an " + "int, float or None." % (name, value) + ) + + try: + if value <= 0: + raise ValueError( + "Attempted to set %s timeout to %s, but the " + "timeout cannot be set to a value less " + "than or equal to 0." % (name, value) + ) + except TypeError: + # Python 3 + raise ValueError( + "Timeout value %s was %s, but it must be an " + "int, float or None." % (name, value) + ) + + return value + + @classmethod + def from_float(cls, timeout): + """Create a new Timeout from a legacy timeout value. + + The timeout value used by httplib.py sets the same timeout on the + connect(), and recv() socket requests. This creates a :class:`Timeout` + object that sets the individual timeouts to the ``timeout`` value + passed to this function. + + :param timeout: The legacy timeout value. + :type timeout: integer, float, sentinel default object, or None + :return: Timeout object + :rtype: :class:`Timeout` + """ + return Timeout(read=timeout, connect=timeout) + + def clone(self): + """Create a copy of the timeout object + + Timeout properties are stored per-pool but each request needs a fresh + Timeout object to ensure each one has its own start/stop configured. + + :return: a copy of the timeout object + :rtype: :class:`Timeout` + """ + # We can't use copy.deepcopy because that will also create a new object + # for _GLOBAL_DEFAULT_TIMEOUT, which socket.py uses as a sentinel to + # detect the user default. + return Timeout(connect=self._connect, read=self._read, total=self.total) + + def start_connect(self): + """Start the timeout clock, used during a connect() attempt + + :raises urllib3.exceptions.TimeoutStateError: if you attempt + to start a timer that has been started already. + """ + if self._start_connect is not None: + raise TimeoutStateError("Timeout timer has already been started.") + self._start_connect = current_time() + return self._start_connect + + def get_connect_duration(self): + """Gets the time elapsed since the call to :meth:`start_connect`. + + :return: Elapsed time in seconds. + :rtype: float + :raises urllib3.exceptions.TimeoutStateError: if you attempt + to get duration for a timer that hasn't been started. + """ + if self._start_connect is None: + raise TimeoutStateError( + "Can't get connect duration for timer that has not started." + ) + return current_time() - self._start_connect + + @property + def connect_timeout(self): + """Get the value to use when setting a connection timeout. + + This will be a positive float or integer, the value None + (never timeout), or the default system timeout. + + :return: Connect timeout. + :rtype: int, float, :attr:`Timeout.DEFAULT_TIMEOUT` or None + """ + if self.total is None: + return self._connect + + if self._connect is None or self._connect is self.DEFAULT_TIMEOUT: + return self.total + + return min(self._connect, self.total) + + @property + def read_timeout(self): + """Get the value for the read timeout. + + This assumes some time has elapsed in the connection timeout and + computes the read timeout appropriately. + + If self.total is set, the read timeout is dependent on the amount of + time taken by the connect timeout. If the connection time has not been + established, a :exc:`~urllib3.exceptions.TimeoutStateError` will be + raised. + + :return: Value to use for the read timeout. + :rtype: int, float, :attr:`Timeout.DEFAULT_TIMEOUT` or None + :raises urllib3.exceptions.TimeoutStateError: If :meth:`start_connect` + has not yet been called on this object. + """ + if ( + self.total is not None + and self.total is not self.DEFAULT_TIMEOUT + and self._read is not None + and self._read is not self.DEFAULT_TIMEOUT + ): + # In case the connect timeout has not yet been established. + if self._start_connect is None: + return self._read + return max(0, min(self.total - self.get_connect_duration(), self._read)) + elif self.total is not None and self.total is not self.DEFAULT_TIMEOUT: + return max(0, self.total - self.get_connect_duration()) + else: + return self._read diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/url.py b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/url.py new file mode 100644 index 0000000..a960b2f --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/url.py @@ -0,0 +1,435 @@ +from __future__ import absolute_import + +import re +from collections import namedtuple + +from ..exceptions import LocationParseError +from ..packages import six + +url_attrs = ["scheme", "auth", "host", "port", "path", "query", "fragment"] + +# We only want to normalize urls with an HTTP(S) scheme. +# urllib3 infers URLs without a scheme (None) to be http. +NORMALIZABLE_SCHEMES = ("http", "https", None) + +# Almost all of these patterns were derived from the +# 'rfc3986' module: https://github.com/python-hyper/rfc3986 +PERCENT_RE = re.compile(r"%[a-fA-F0-9]{2}") +SCHEME_RE = re.compile(r"^(?:[a-zA-Z][a-zA-Z0-9+-]*:|/)") +URI_RE = re.compile( + r"^(?:([a-zA-Z][a-zA-Z0-9+.-]*):)?" + r"(?://([^\\/?#]*))?" + r"([^?#]*)" + r"(?:\?([^#]*))?" + r"(?:#(.*))?$", + re.UNICODE | re.DOTALL, +) + +IPV4_PAT = r"(?:[0-9]{1,3}\.){3}[0-9]{1,3}" +HEX_PAT = "[0-9A-Fa-f]{1,4}" +LS32_PAT = "(?:{hex}:{hex}|{ipv4})".format(hex=HEX_PAT, ipv4=IPV4_PAT) +_subs = {"hex": HEX_PAT, "ls32": LS32_PAT} +_variations = [ + # 6( h16 ":" ) ls32 + "(?:%(hex)s:){6}%(ls32)s", + # "::" 5( h16 ":" ) ls32 + "::(?:%(hex)s:){5}%(ls32)s", + # [ h16 ] "::" 4( h16 ":" ) ls32 + "(?:%(hex)s)?::(?:%(hex)s:){4}%(ls32)s", + # [ *1( h16 ":" ) h16 ] "::" 3( h16 ":" ) ls32 + "(?:(?:%(hex)s:)?%(hex)s)?::(?:%(hex)s:){3}%(ls32)s", + # [ *2( h16 ":" ) h16 ] "::" 2( h16 ":" ) ls32 + "(?:(?:%(hex)s:){0,2}%(hex)s)?::(?:%(hex)s:){2}%(ls32)s", + # [ *3( h16 ":" ) h16 ] "::" h16 ":" ls32 + "(?:(?:%(hex)s:){0,3}%(hex)s)?::%(hex)s:%(ls32)s", + # [ *4( h16 ":" ) h16 ] "::" ls32 + "(?:(?:%(hex)s:){0,4}%(hex)s)?::%(ls32)s", + # [ *5( h16 ":" ) h16 ] "::" h16 + "(?:(?:%(hex)s:){0,5}%(hex)s)?::%(hex)s", + # [ *6( h16 ":" ) h16 ] "::" + "(?:(?:%(hex)s:){0,6}%(hex)s)?::", +] + +UNRESERVED_PAT = r"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789._\-~" +IPV6_PAT = "(?:" + "|".join([x % _subs for x in _variations]) + ")" +ZONE_ID_PAT = "(?:%25|%)(?:[" + UNRESERVED_PAT + "]|%[a-fA-F0-9]{2})+" +IPV6_ADDRZ_PAT = r"\[" + IPV6_PAT + r"(?:" + ZONE_ID_PAT + r")?\]" +REG_NAME_PAT = r"(?:[^\[\]%:/?#]|%[a-fA-F0-9]{2})*" +TARGET_RE = re.compile(r"^(/[^?#]*)(?:\?([^#]*))?(?:#.*)?$") + +IPV4_RE = re.compile("^" + IPV4_PAT + "$") +IPV6_RE = re.compile("^" + IPV6_PAT + "$") +IPV6_ADDRZ_RE = re.compile("^" + IPV6_ADDRZ_PAT + "$") +BRACELESS_IPV6_ADDRZ_RE = re.compile("^" + IPV6_ADDRZ_PAT[2:-2] + "$") +ZONE_ID_RE = re.compile("(" + ZONE_ID_PAT + r")\]$") + +_HOST_PORT_PAT = ("^(%s|%s|%s)(?::0*?(|0|[1-9][0-9]{0,4}))?$") % ( + REG_NAME_PAT, + IPV4_PAT, + IPV6_ADDRZ_PAT, +) +_HOST_PORT_RE = re.compile(_HOST_PORT_PAT, re.UNICODE | re.DOTALL) + +UNRESERVED_CHARS = set( + "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789._-~" +) +SUB_DELIM_CHARS = set("!$&'()*+,;=") +USERINFO_CHARS = UNRESERVED_CHARS | SUB_DELIM_CHARS | {":"} +PATH_CHARS = USERINFO_CHARS | {"@", "/"} +QUERY_CHARS = FRAGMENT_CHARS = PATH_CHARS | {"?"} + + +class Url(namedtuple("Url", url_attrs)): + """ + Data structure for representing an HTTP URL. Used as a return value for + :func:`parse_url`. Both the scheme and host are normalized as they are + both case-insensitive according to RFC 3986. + """ + + __slots__ = () + + def __new__( + cls, + scheme=None, + auth=None, + host=None, + port=None, + path=None, + query=None, + fragment=None, + ): + if path and not path.startswith("/"): + path = "/" + path + if scheme is not None: + scheme = scheme.lower() + return super(Url, cls).__new__( + cls, scheme, auth, host, port, path, query, fragment + ) + + @property + def hostname(self): + """For backwards-compatibility with urlparse. We're nice like that.""" + return self.host + + @property + def request_uri(self): + """Absolute path including the query string.""" + uri = self.path or "/" + + if self.query is not None: + uri += "?" + self.query + + return uri + + @property + def netloc(self): + """Network location including host and port""" + if self.port: + return "%s:%d" % (self.host, self.port) + return self.host + + @property + def url(self): + """ + Convert self into a url + + This function should more or less round-trip with :func:`.parse_url`. The + returned url may not be exactly the same as the url inputted to + :func:`.parse_url`, but it should be equivalent by the RFC (e.g., urls + with a blank port will have : removed). + + Example: :: + + >>> U = parse_url('http://google.com/mail/') + >>> U.url + 'http://google.com/mail/' + >>> Url('http', 'username:password', 'host.com', 80, + ... '/path', 'query', 'fragment').url + 'http://username:password@host.com:80/path?query#fragment' + """ + scheme, auth, host, port, path, query, fragment = self + url = u"" + + # We use "is not None" we want things to happen with empty strings (or 0 port) + if scheme is not None: + url += scheme + u"://" + if auth is not None: + url += auth + u"@" + if host is not None: + url += host + if port is not None: + url += u":" + str(port) + if path is not None: + url += path + if query is not None: + url += u"?" + query + if fragment is not None: + url += u"#" + fragment + + return url + + def __str__(self): + return self.url + + +def split_first(s, delims): + """ + .. deprecated:: 1.25 + + Given a string and an iterable of delimiters, split on the first found + delimiter. Return two split parts and the matched delimiter. + + If not found, then the first part is the full input string. + + Example:: + + >>> split_first('foo/bar?baz', '?/=') + ('foo', 'bar?baz', '/') + >>> split_first('foo/bar?baz', '123') + ('foo/bar?baz', '', None) + + Scales linearly with number of delims. Not ideal for large number of delims. + """ + min_idx = None + min_delim = None + for d in delims: + idx = s.find(d) + if idx < 0: + continue + + if min_idx is None or idx < min_idx: + min_idx = idx + min_delim = d + + if min_idx is None or min_idx < 0: + return s, "", None + + return s[:min_idx], s[min_idx + 1 :], min_delim + + +def _encode_invalid_chars(component, allowed_chars, encoding="utf-8"): + """Percent-encodes a URI component without reapplying + onto an already percent-encoded component. + """ + if component is None: + return component + + component = six.ensure_text(component) + + # Normalize existing percent-encoded bytes. + # Try to see if the component we're encoding is already percent-encoded + # so we can skip all '%' characters but still encode all others. + component, percent_encodings = PERCENT_RE.subn( + lambda match: match.group(0).upper(), component + ) + + uri_bytes = component.encode("utf-8", "surrogatepass") + is_percent_encoded = percent_encodings == uri_bytes.count(b"%") + encoded_component = bytearray() + + for i in range(0, len(uri_bytes)): + # Will return a single character bytestring on both Python 2 & 3 + byte = uri_bytes[i : i + 1] + byte_ord = ord(byte) + if (is_percent_encoded and byte == b"%") or ( + byte_ord < 128 and byte.decode() in allowed_chars + ): + encoded_component += byte + continue + encoded_component.extend(b"%" + (hex(byte_ord)[2:].encode().zfill(2).upper())) + + return encoded_component.decode(encoding) + + +def _remove_path_dot_segments(path): + # See http://tools.ietf.org/html/rfc3986#section-5.2.4 for pseudo-code + segments = path.split("/") # Turn the path into a list of segments + output = [] # Initialize the variable to use to store output + + for segment in segments: + # '.' is the current directory, so ignore it, it is superfluous + if segment == ".": + continue + # Anything other than '..', should be appended to the output + elif segment != "..": + output.append(segment) + # In this case segment == '..', if we can, we should pop the last + # element + elif output: + output.pop() + + # If the path starts with '/' and the output is empty or the first string + # is non-empty + if path.startswith("/") and (not output or output[0]): + output.insert(0, "") + + # If the path starts with '/.' or '/..' ensure we add one more empty + # string to add a trailing '/' + if path.endswith(("/.", "/..")): + output.append("") + + return "/".join(output) + + +def _normalize_host(host, scheme): + if host: + if isinstance(host, six.binary_type): + host = six.ensure_str(host) + + if scheme in NORMALIZABLE_SCHEMES: + is_ipv6 = IPV6_ADDRZ_RE.match(host) + if is_ipv6: + # IPv6 hosts of the form 'a::b%zone' are encoded in a URL as + # such per RFC 6874: 'a::b%25zone'. Unquote the ZoneID + # separator as necessary to return a valid RFC 4007 scoped IP. + match = ZONE_ID_RE.search(host) + if match: + start, end = match.span(1) + zone_id = host[start:end] + + if zone_id.startswith("%25") and zone_id != "%25": + zone_id = zone_id[3:] + else: + zone_id = zone_id[1:] + zone_id = "%" + _encode_invalid_chars(zone_id, UNRESERVED_CHARS) + return host[:start].lower() + zone_id + host[end:] + else: + return host.lower() + elif not IPV4_RE.match(host): + return six.ensure_str( + b".".join([_idna_encode(label) for label in host.split(".")]) + ) + return host + + +def _idna_encode(name): + if name and any(ord(x) >= 128 for x in name): + try: + from pip._vendor import idna + except ImportError: + six.raise_from( + LocationParseError("Unable to parse URL without the 'idna' module"), + None, + ) + try: + return idna.encode(name.lower(), strict=True, std3_rules=True) + except idna.IDNAError: + six.raise_from( + LocationParseError(u"Name '%s' is not a valid IDNA label" % name), None + ) + return name.lower().encode("ascii") + + +def _encode_target(target): + """Percent-encodes a request target so that there are no invalid characters""" + path, query = TARGET_RE.match(target).groups() + target = _encode_invalid_chars(path, PATH_CHARS) + query = _encode_invalid_chars(query, QUERY_CHARS) + if query is not None: + target += "?" + query + return target + + +def parse_url(url): + """ + Given a url, return a parsed :class:`.Url` namedtuple. Best-effort is + performed to parse incomplete urls. Fields not provided will be None. + This parser is RFC 3986 and RFC 6874 compliant. + + The parser logic and helper functions are based heavily on + work done in the ``rfc3986`` module. + + :param str url: URL to parse into a :class:`.Url` namedtuple. + + Partly backwards-compatible with :mod:`urlparse`. + + Example:: + + >>> parse_url('http://google.com/mail/') + Url(scheme='http', host='google.com', port=None, path='/mail/', ...) + >>> parse_url('google.com:80') + Url(scheme=None, host='google.com', port=80, path=None, ...) + >>> parse_url('/foo?bar') + Url(scheme=None, host=None, port=None, path='/foo', query='bar', ...) + """ + if not url: + # Empty + return Url() + + source_url = url + if not SCHEME_RE.search(url): + url = "//" + url + + try: + scheme, authority, path, query, fragment = URI_RE.match(url).groups() + normalize_uri = scheme is None or scheme.lower() in NORMALIZABLE_SCHEMES + + if scheme: + scheme = scheme.lower() + + if authority: + auth, _, host_port = authority.rpartition("@") + auth = auth or None + host, port = _HOST_PORT_RE.match(host_port).groups() + if auth and normalize_uri: + auth = _encode_invalid_chars(auth, USERINFO_CHARS) + if port == "": + port = None + else: + auth, host, port = None, None, None + + if port is not None: + port = int(port) + if not (0 <= port <= 65535): + raise LocationParseError(url) + + host = _normalize_host(host, scheme) + + if normalize_uri and path: + path = _remove_path_dot_segments(path) + path = _encode_invalid_chars(path, PATH_CHARS) + if normalize_uri and query: + query = _encode_invalid_chars(query, QUERY_CHARS) + if normalize_uri and fragment: + fragment = _encode_invalid_chars(fragment, FRAGMENT_CHARS) + + except (ValueError, AttributeError): + return six.raise_from(LocationParseError(source_url), None) + + # For the sake of backwards compatibility we put empty + # string values for path if there are any defined values + # beyond the path in the URL. + # TODO: Remove this when we break backwards compatibility. + if not path: + if query is not None or fragment is not None: + path = "" + else: + path = None + + # Ensure that each part of the URL is a `str` for + # backwards compatibility. + if isinstance(url, six.text_type): + ensure_func = six.ensure_text + else: + ensure_func = six.ensure_str + + def ensure_type(x): + return x if x is None else ensure_func(x) + + return Url( + scheme=ensure_type(scheme), + auth=ensure_type(auth), + host=ensure_type(host), + port=port, + path=ensure_type(path), + query=ensure_type(query), + fragment=ensure_type(fragment), + ) + + +def get_host(url): + """ + Deprecated. Use :func:`parse_url` instead. + """ + p = parse_url(url) + return p.scheme or "http", p.hostname, p.port diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/wait.py b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/wait.py new file mode 100644 index 0000000..21b4590 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/util/wait.py @@ -0,0 +1,152 @@ +import errno +import select +import sys +from functools import partial + +try: + from time import monotonic +except ImportError: + from time import time as monotonic + +__all__ = ["NoWayToWaitForSocketError", "wait_for_read", "wait_for_write"] + + +class NoWayToWaitForSocketError(Exception): + pass + + +# How should we wait on sockets? +# +# There are two types of APIs you can use for waiting on sockets: the fancy +# modern stateful APIs like epoll/kqueue, and the older stateless APIs like +# select/poll. The stateful APIs are more efficient when you have a lots of +# sockets to keep track of, because you can set them up once and then use them +# lots of times. But we only ever want to wait on a single socket at a time +# and don't want to keep track of state, so the stateless APIs are actually +# more efficient. So we want to use select() or poll(). +# +# Now, how do we choose between select() and poll()? On traditional Unixes, +# select() has a strange calling convention that makes it slow, or fail +# altogether, for high-numbered file descriptors. The point of poll() is to fix +# that, so on Unixes, we prefer poll(). +# +# On Windows, there is no poll() (or at least Python doesn't provide a wrapper +# for it), but that's OK, because on Windows, select() doesn't have this +# strange calling convention; plain select() works fine. +# +# So: on Windows we use select(), and everywhere else we use poll(). We also +# fall back to select() in case poll() is somehow broken or missing. + +if sys.version_info >= (3, 5): + # Modern Python, that retries syscalls by default + def _retry_on_intr(fn, timeout): + return fn(timeout) + +else: + # Old and broken Pythons. + def _retry_on_intr(fn, timeout): + if timeout is None: + deadline = float("inf") + else: + deadline = monotonic() + timeout + + while True: + try: + return fn(timeout) + # OSError for 3 <= pyver < 3.5, select.error for pyver <= 2.7 + except (OSError, select.error) as e: + # 'e.args[0]' incantation works for both OSError and select.error + if e.args[0] != errno.EINTR: + raise + else: + timeout = deadline - monotonic() + if timeout < 0: + timeout = 0 + if timeout == float("inf"): + timeout = None + continue + + +def select_wait_for_socket(sock, read=False, write=False, timeout=None): + if not read and not write: + raise RuntimeError("must specify at least one of read=True, write=True") + rcheck = [] + wcheck = [] + if read: + rcheck.append(sock) + if write: + wcheck.append(sock) + # When doing a non-blocking connect, most systems signal success by + # marking the socket writable. Windows, though, signals success by marked + # it as "exceptional". We paper over the difference by checking the write + # sockets for both conditions. (The stdlib selectors module does the same + # thing.) + fn = partial(select.select, rcheck, wcheck, wcheck) + rready, wready, xready = _retry_on_intr(fn, timeout) + return bool(rready or wready or xready) + + +def poll_wait_for_socket(sock, read=False, write=False, timeout=None): + if not read and not write: + raise RuntimeError("must specify at least one of read=True, write=True") + mask = 0 + if read: + mask |= select.POLLIN + if write: + mask |= select.POLLOUT + poll_obj = select.poll() + poll_obj.register(sock, mask) + + # For some reason, poll() takes timeout in milliseconds + def do_poll(t): + if t is not None: + t *= 1000 + return poll_obj.poll(t) + + return bool(_retry_on_intr(do_poll, timeout)) + + +def null_wait_for_socket(*args, **kwargs): + raise NoWayToWaitForSocketError("no select-equivalent available") + + +def _have_working_poll(): + # Apparently some systems have a select.poll that fails as soon as you try + # to use it, either due to strange configuration or broken monkeypatching + # from libraries like eventlet/greenlet. + try: + poll_obj = select.poll() + _retry_on_intr(poll_obj.poll, 0) + except (AttributeError, OSError): + return False + else: + return True + + +def wait_for_socket(*args, **kwargs): + # We delay choosing which implementation to use until the first time we're + # called. We could do it at import time, but then we might make the wrong + # decision if someone goes wild with monkeypatching select.poll after + # we're imported. + global wait_for_socket + if _have_working_poll(): + wait_for_socket = poll_wait_for_socket + elif hasattr(select, "select"): + wait_for_socket = select_wait_for_socket + else: # Platform-specific: Appengine. + wait_for_socket = null_wait_for_socket + return wait_for_socket(*args, **kwargs) + + +def wait_for_read(sock, timeout=None): + """Waits for reading to be available on a given socket. + Returns True if the socket is readable, or False if the timeout expired. + """ + return wait_for_socket(sock, read=True, timeout=timeout) + + +def wait_for_write(sock, timeout=None): + """Waits for writing to be available on a given socket. + Returns True if the socket is readable, or False if the timeout expired. + """ + return wait_for_socket(sock, write=True, timeout=timeout) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/vendor.txt b/.venv/lib/python3.12/site-packages/pip/_vendor/vendor.txt new file mode 100644 index 0000000..fd92690 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/vendor.txt @@ -0,0 +1,18 @@ +CacheControl==0.14.0 +distlib==0.3.8 +distro==1.9.0 +msgpack==1.0.8 +packaging==24.1 +platformdirs==4.2.2 +pyproject-hooks==1.0.0 +requests==2.32.3 + certifi==2024.7.4 + idna==3.7 + urllib3==1.26.18 +rich==13.7.1 + pygments==2.18.0 + typing_extensions==4.12.2 +resolvelib==1.0.1 +setuptools==70.3.0 +tomli==2.0.1 +truststore==0.9.1 diff --git a/.venv/lib/python3.12/site-packages/pip/py.typed b/.venv/lib/python3.12/site-packages/pip/py.typed new file mode 100644 index 0000000..493b53e --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/py.typed @@ -0,0 +1,4 @@ +pip is a command line program. While it is implemented in Python, and so is +available for import, you must not use pip's internal APIs in this way. Typing +information is provided as a convenience only and is not a guarantee. Expect +unannounced changes to the API and types in releases. diff --git a/.venv/lib/python3.12/site-packages/requests-2.32.3.dist-info/INSTALLER b/.venv/lib/python3.12/site-packages/requests-2.32.3.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/.venv/lib/python3.12/site-packages/requests-2.32.3.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/.venv/lib/python3.12/site-packages/requests-2.32.3.dist-info/LICENSE b/.venv/lib/python3.12/site-packages/requests-2.32.3.dist-info/LICENSE new file mode 100644 index 0000000..67db858 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/requests-2.32.3.dist-info/LICENSE @@ -0,0 +1,175 @@ + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. diff --git a/.venv/lib/python3.12/site-packages/requests-2.32.3.dist-info/METADATA b/.venv/lib/python3.12/site-packages/requests-2.32.3.dist-info/METADATA new file mode 100644 index 0000000..72d9dc5 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/requests-2.32.3.dist-info/METADATA @@ -0,0 +1,119 @@ +Metadata-Version: 2.1 +Name: requests +Version: 2.32.3 +Summary: Python HTTP for Humans. +Home-page: https://requests.readthedocs.io +Author: Kenneth Reitz +Author-email: me@kennethreitz.org +License: Apache-2.0 +Project-URL: Documentation, https://requests.readthedocs.io +Project-URL: Source, https://github.com/psf/requests +Classifier: Development Status :: 5 - Production/Stable +Classifier: Environment :: Web Environment +Classifier: Intended Audience :: Developers +Classifier: License :: OSI Approved :: Apache Software License +Classifier: Natural Language :: English +Classifier: Operating System :: OS Independent +Classifier: Programming Language :: Python +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3.8 +Classifier: Programming Language :: Python :: 3.9 +Classifier: Programming Language :: Python :: 3.10 +Classifier: Programming Language :: Python :: 3.11 +Classifier: Programming Language :: Python :: 3.12 +Classifier: Programming Language :: Python :: 3 :: Only +Classifier: Programming Language :: Python :: Implementation :: CPython +Classifier: Programming Language :: Python :: Implementation :: PyPy +Classifier: Topic :: Internet :: WWW/HTTP +Classifier: Topic :: Software Development :: Libraries +Requires-Python: >=3.8 +Description-Content-Type: text/markdown +License-File: LICENSE +Requires-Dist: charset-normalizer <4,>=2 +Requires-Dist: idna <4,>=2.5 +Requires-Dist: urllib3 <3,>=1.21.1 +Requires-Dist: certifi >=2017.4.17 +Provides-Extra: security +Provides-Extra: socks +Requires-Dist: PySocks !=1.5.7,>=1.5.6 ; extra == 'socks' +Provides-Extra: use_chardet_on_py3 +Requires-Dist: chardet <6,>=3.0.2 ; extra == 'use_chardet_on_py3' + +# Requests + +**Requests** is a simple, yet elegant, HTTP library. + +```python +>>> import requests +>>> r = requests.get('https://httpbin.org/basic-auth/user/pass', auth=('user', 'pass')) +>>> r.status_code +200 +>>> r.headers['content-type'] +'application/json; charset=utf8' +>>> r.encoding +'utf-8' +>>> r.text +'{"authenticated": true, ...' +>>> r.json() +{'authenticated': True, ...} +``` + +Requests allows you to send HTTP/1.1 requests extremely easily. There’s no need to manually add query strings to your URLs, or to form-encode your `PUT` & `POST` data — but nowadays, just use the `json` method! + +Requests is one of the most downloaded Python packages today, pulling in around `30M downloads / week`— according to GitHub, Requests is currently [depended upon](https://github.com/psf/requests/network/dependents?package_id=UGFja2FnZS01NzA4OTExNg%3D%3D) by `1,000,000+` repositories. You may certainly put your trust in this code. + +[![Downloads](https://static.pepy.tech/badge/requests/month)](https://pepy.tech/project/requests) +[![Supported Versions](https://img.shields.io/pypi/pyversions/requests.svg)](https://pypi.org/project/requests) +[![Contributors](https://img.shields.io/github/contributors/psf/requests.svg)](https://github.com/psf/requests/graphs/contributors) + +## Installing Requests and Supported Versions + +Requests is available on PyPI: + +```console +$ python -m pip install requests +``` + +Requests officially supports Python 3.8+. + +## Supported Features & Best–Practices + +Requests is ready for the demands of building robust and reliable HTTP–speaking applications, for the needs of today. + +- Keep-Alive & Connection Pooling +- International Domains and URLs +- Sessions with Cookie Persistence +- Browser-style TLS/SSL Verification +- Basic & Digest Authentication +- Familiar `dict`–like Cookies +- Automatic Content Decompression and Decoding +- Multi-part File Uploads +- SOCKS Proxy Support +- Connection Timeouts +- Streaming Downloads +- Automatic honoring of `.netrc` +- Chunked HTTP Requests + +## API Reference and User Guide available on [Read the Docs](https://requests.readthedocs.io) + +[![Read the Docs](https://raw.githubusercontent.com/psf/requests/main/ext/ss.png)](https://requests.readthedocs.io) + +## Cloning the repository + +When cloning the Requests repository, you may need to add the `-c +fetch.fsck.badTimezone=ignore` flag to avoid an error about a bad commit (see +[this issue](https://github.com/psf/requests/issues/2690) for more background): + +```shell +git clone -c fetch.fsck.badTimezone=ignore https://github.com/psf/requests.git +``` + +You can also apply this setting to your global Git config: + +```shell +git config --global fetch.fsck.badTimezone ignore +``` + +--- + +[![Kenneth Reitz](https://raw.githubusercontent.com/psf/requests/main/ext/kr.png)](https://kennethreitz.org) [![Python Software Foundation](https://raw.githubusercontent.com/psf/requests/main/ext/psf.png)](https://www.python.org/psf) diff --git a/.venv/lib/python3.12/site-packages/requests-2.32.3.dist-info/RECORD b/.venv/lib/python3.12/site-packages/requests-2.32.3.dist-info/RECORD new file mode 100644 index 0000000..f34e5a1 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/requests-2.32.3.dist-info/RECORD @@ -0,0 +1,43 @@ +requests-2.32.3.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +requests-2.32.3.dist-info/LICENSE,sha256=CeipvOyAZxBGUsFoaFqwkx54aPnIKEtm9a5u2uXxEws,10142 +requests-2.32.3.dist-info/METADATA,sha256=ZY7oRUweLnb7jCEnEW9hFWs7IpQbNVnAA4ncpwA4WBo,4610 +requests-2.32.3.dist-info/RECORD,, +requests-2.32.3.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +requests-2.32.3.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92 +requests-2.32.3.dist-info/top_level.txt,sha256=fMSVmHfb5rbGOo6xv-O_tUX6j-WyixssE-SnwcDRxNQ,9 +requests/__init__.py,sha256=4xaAERmPDIBPsa2PsjpU9r06yooK-2mZKHTZAhWRWts,5072 +requests/__pycache__/__init__.cpython-312.pyc,, +requests/__pycache__/__version__.cpython-312.pyc,, +requests/__pycache__/_internal_utils.cpython-312.pyc,, +requests/__pycache__/adapters.cpython-312.pyc,, +requests/__pycache__/api.cpython-312.pyc,, +requests/__pycache__/auth.cpython-312.pyc,, +requests/__pycache__/certs.cpython-312.pyc,, +requests/__pycache__/compat.cpython-312.pyc,, +requests/__pycache__/cookies.cpython-312.pyc,, +requests/__pycache__/exceptions.cpython-312.pyc,, +requests/__pycache__/help.cpython-312.pyc,, +requests/__pycache__/hooks.cpython-312.pyc,, +requests/__pycache__/models.cpython-312.pyc,, +requests/__pycache__/packages.cpython-312.pyc,, +requests/__pycache__/sessions.cpython-312.pyc,, +requests/__pycache__/status_codes.cpython-312.pyc,, +requests/__pycache__/structures.cpython-312.pyc,, +requests/__pycache__/utils.cpython-312.pyc,, +requests/__version__.py,sha256=FVfglgZmNQnmYPXpOohDU58F5EUb_-VnSTaAesS187g,435 +requests/_internal_utils.py,sha256=nMQymr4hs32TqVo5AbCrmcJEhvPUh7xXlluyqwslLiQ,1495 +requests/adapters.py,sha256=KIcecscqam6reOCXRl4DwP4jX8Jcl8sd57ft17KR2cQ,27451 +requests/api.py,sha256=_Zb9Oa7tzVIizTKwFrPjDEY9ejtm_OnSRERnADxGsQs,6449 +requests/auth.py,sha256=kF75tqnLctZ9Mf_hm9TZIj4cQWnN5uxRz8oWsx5wmR0,10186 +requests/certs.py,sha256=Z9Sb410Anv6jUFTyss0jFFhU6xst8ctELqfy8Ev23gw,429 +requests/compat.py,sha256=C5w_DPLSurXPgcdWU78fora0APmbYkX2G89QvH5xzPA,1817 +requests/cookies.py,sha256=bNi-iqEj4NPZ00-ob-rHvzkvObzN3lEpgw3g6paS3Xw,18590 +requests/exceptions.py,sha256=jJPS1UWATs86ShVUaLorTiJb1SaGuoNEWgICJep-VkY,4260 +requests/help.py,sha256=gPX5d_H7Xd88aDABejhqGgl9B1VFRTt5BmiYvL3PzIQ,3875 +requests/hooks.py,sha256=CiuysiHA39V5UfcCBXFIx83IrDpuwfN9RcTUgv28ftQ,733 +requests/models.py,sha256=k42roXzC8u_OagAPQi9U4MkfO7i4r2FdaqvMqstPehc,35418 +requests/packages.py,sha256=_g0gZ681UyAlKHRjH6kanbaoxx2eAb6qzcXiODyTIoc,904 +requests/sessions.py,sha256=ykTI8UWGSltOfH07HKollH7kTBGw4WhiBVaQGmckTw4,30495 +requests/status_codes.py,sha256=iJUAeA25baTdw-6PfD0eF4qhpINDJRJI-yaMqxs4LEI,4322 +requests/structures.py,sha256=-IbmhVz06S-5aPSZuUthZ6-6D9XOjRuTXHOabY041XM,2912 +requests/utils.py,sha256=HiQC6Nq_Da3ktaMiFzQkh-dCk3iQHHKEsYS5kDc-8Cw,33619 diff --git a/.venv/lib/python3.12/site-packages/requests-2.32.3.dist-info/REQUESTED b/.venv/lib/python3.12/site-packages/requests-2.32.3.dist-info/REQUESTED new file mode 100644 index 0000000..e69de29 diff --git a/.venv/lib/python3.12/site-packages/requests-2.32.3.dist-info/WHEEL b/.venv/lib/python3.12/site-packages/requests-2.32.3.dist-info/WHEEL new file mode 100644 index 0000000..bab98d6 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/requests-2.32.3.dist-info/WHEEL @@ -0,0 +1,5 @@ +Wheel-Version: 1.0 +Generator: bdist_wheel (0.43.0) +Root-Is-Purelib: true +Tag: py3-none-any + diff --git a/.venv/lib/python3.12/site-packages/requests-2.32.3.dist-info/top_level.txt b/.venv/lib/python3.12/site-packages/requests-2.32.3.dist-info/top_level.txt new file mode 100644 index 0000000..f229360 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/requests-2.32.3.dist-info/top_level.txt @@ -0,0 +1 @@ +requests diff --git a/.venv/lib/python3.12/site-packages/requests/__init__.py b/.venv/lib/python3.12/site-packages/requests/__init__.py new file mode 100644 index 0000000..051cda1 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/requests/__init__.py @@ -0,0 +1,184 @@ +# __ +# /__) _ _ _ _ _/ _ +# / ( (- (/ (/ (- _) / _) +# / + +""" +Requests HTTP Library +~~~~~~~~~~~~~~~~~~~~~ + +Requests is an HTTP library, written in Python, for human beings. +Basic GET usage: + + >>> import requests + >>> r = requests.get('https://www.python.org') + >>> r.status_code + 200 + >>> b'Python is a programming language' in r.content + True + +... or POST: + + >>> payload = dict(key1='value1', key2='value2') + >>> r = requests.post('https://httpbin.org/post', data=payload) + >>> print(r.text) + { + ... + "form": { + "key1": "value1", + "key2": "value2" + }, + ... + } + +The other HTTP methods are supported - see `requests.api`. Full documentation +is at . + +:copyright: (c) 2017 by Kenneth Reitz. +:license: Apache 2.0, see LICENSE for more details. +""" + +import warnings + +import urllib3 + +from .exceptions import RequestsDependencyWarning + +try: + from charset_normalizer import __version__ as charset_normalizer_version +except ImportError: + charset_normalizer_version = None + +try: + from chardet import __version__ as chardet_version +except ImportError: + chardet_version = None + + +def check_compatibility(urllib3_version, chardet_version, charset_normalizer_version): + urllib3_version = urllib3_version.split(".") + assert urllib3_version != ["dev"] # Verify urllib3 isn't installed from git. + + # Sometimes, urllib3 only reports its version as 16.1. + if len(urllib3_version) == 2: + urllib3_version.append("0") + + # Check urllib3 for compatibility. + major, minor, patch = urllib3_version # noqa: F811 + major, minor, patch = int(major), int(minor), int(patch) + # urllib3 >= 1.21.1 + assert major >= 1 + if major == 1: + assert minor >= 21 + + # Check charset_normalizer for compatibility. + if chardet_version: + major, minor, patch = chardet_version.split(".")[:3] + major, minor, patch = int(major), int(minor), int(patch) + # chardet_version >= 3.0.2, < 6.0.0 + assert (3, 0, 2) <= (major, minor, patch) < (6, 0, 0) + elif charset_normalizer_version: + major, minor, patch = charset_normalizer_version.split(".")[:3] + major, minor, patch = int(major), int(minor), int(patch) + # charset_normalizer >= 2.0.0 < 4.0.0 + assert (2, 0, 0) <= (major, minor, patch) < (4, 0, 0) + else: + warnings.warn( + "Unable to find acceptable character detection dependency " + "(chardet or charset_normalizer).", + RequestsDependencyWarning, + ) + + +def _check_cryptography(cryptography_version): + # cryptography < 1.3.4 + try: + cryptography_version = list(map(int, cryptography_version.split("."))) + except ValueError: + return + + if cryptography_version < [1, 3, 4]: + warning = "Old version of cryptography ({}) may cause slowdown.".format( + cryptography_version + ) + warnings.warn(warning, RequestsDependencyWarning) + + +# Check imported dependencies for compatibility. +try: + check_compatibility( + urllib3.__version__, chardet_version, charset_normalizer_version + ) +except (AssertionError, ValueError): + warnings.warn( + "urllib3 ({}) or chardet ({})/charset_normalizer ({}) doesn't match a supported " + "version!".format( + urllib3.__version__, chardet_version, charset_normalizer_version + ), + RequestsDependencyWarning, + ) + +# Attempt to enable urllib3's fallback for SNI support +# if the standard library doesn't support SNI or the +# 'ssl' library isn't available. +try: + try: + import ssl + except ImportError: + ssl = None + + if not getattr(ssl, "HAS_SNI", False): + from urllib3.contrib import pyopenssl + + pyopenssl.inject_into_urllib3() + + # Check cryptography version + from cryptography import __version__ as cryptography_version + + _check_cryptography(cryptography_version) +except ImportError: + pass + +# urllib3's DependencyWarnings should be silenced. +from urllib3.exceptions import DependencyWarning + +warnings.simplefilter("ignore", DependencyWarning) + +# Set default logging handler to avoid "No handler found" warnings. +import logging +from logging import NullHandler + +from . import packages, utils +from .__version__ import ( + __author__, + __author_email__, + __build__, + __cake__, + __copyright__, + __description__, + __license__, + __title__, + __url__, + __version__, +) +from .api import delete, get, head, options, patch, post, put, request +from .exceptions import ( + ConnectionError, + ConnectTimeout, + FileModeWarning, + HTTPError, + JSONDecodeError, + ReadTimeout, + RequestException, + Timeout, + TooManyRedirects, + URLRequired, +) +from .models import PreparedRequest, Request, Response +from .sessions import Session, session +from .status_codes import codes + +logging.getLogger(__name__).addHandler(NullHandler()) + +# FileModeWarnings go off per the default. +warnings.simplefilter("default", FileModeWarning, append=True) diff --git a/.venv/lib/python3.12/site-packages/requests/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/requests/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d5e5762b1fa616d167472805587a1f66bf822b31 GIT binary patch literal 5408 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/requests/__pycache__/__version__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/requests/__pycache__/__version__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..cc7f5a8f894a04706e108c8739062bf05600e0be GIT binary patch literal 572 zcmY*WL2uJA6n5IJP1B{T7@`tFA{Qj8u^77Bgb;|!Bm|nKammHX;gp+`9E3kMgXz_N?<{QBV-wZZ+C+P5Q(B*bu^Ip(fIOG1(R&ZW`Ho6=gEleyk z@9^a0$UBqDJ1o*L(|&nBHYV2xl&+8Z3PNsT;4;#_kY#7$@8b~dNsE;3E66f1v3Cr@ zl;ute&u7<)Y6M@ZY3aPk!zhNmiT}79y_ESviD_)S|D44Z7W3=lXK(fC{WlN6o3XR( zF=m8GfU)H^V;pp(L~ex4Q0OvNs02Zuu{kJxt)kGgCPyYUsoa` z$aHhL%UHBd3#pAXoZ-e7a?y19@-2;J3RLA_l$?twrjg`8Uke>ke-7E4CgPOlR}J0w zpG>G02KKP%SvUoK(@6SHrhdM-w4bJu7YRI5Lwu$AR(*ies%=@;$|3Hk>eaV)tL@s^ nt-AH#PSvlsZlmVjtDJi0;ZHKG2X|2%jw`qBKX_-W0owlnR#>}0 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/requests/__pycache__/_internal_utils.cpython-312.pyc b/.venv/lib/python3.12/site-packages/requests/__pycache__/_internal_utils.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4e379f30824dfd4174c761dcc1203a1c2dc6b972 GIT binary patch literal 2012 zcmah}-D?zA6u&dGpR-9eu|`QWda-GA`>{(SQivZA>$V!IhD|JF)r_+d?`W^3Wfd`z6?a#?a+rn>4R@+(}&_y&z=1UriNaaJNKOXJ0JI) z-@VU!dv$^%Q+T%UOO%k`rO+9X_G0U2Ts$H+DH2<;)rwM7Y|V~T)T&n06rvJP784z# z?Y|v;rnIDDbXQEQi;3-uiFYyaT``F+CIK->EU3jKL?MoU9a5k}4tRCg-EaSbjQA3)vw)%l5Q{JNakHTU|vqbmdd zQSr0{UYof(-^Q%YkFKP5C@d90ogtZ^;kPx7(<36Yd=bt)D;8K&~F&y_M^-7CiiT5dknz&Z66sA$wc>O`Gk#Z6q* z7;tcfDSLnjo#F^P(e~rGC<1j6umm0FEjQp=o-JdU*asWh!g3iHgl=50Fs#WMSvp&G zFdUa{<#cl9;|mvP-3^lxUIm+oA=t9RAsZTIv_N;b<8ooT7BE@5AQlDy+={g_3lg39 zf#%f(m&L{0U(MypUKMhz210VpD(5gU$X#@}mCIs@mU0!Rl&dvF*>jI)KOE0-N5BU) z)4FBe1fJ_KIk$t!*;*s$7oO27gd_`|ob_PPA^dm_r#s|toh0@=9Q*dY7xA%X-`;!L zW`gvj?@Vn*NqX=>^?r5j{CeLz_q2^v-<_!~G$B@(2PkwovWUX}afGW=j^p? zwug?>8|d&xixm@0(r$v5Jg*WO1W}V)jx+m7Cc@uG8+JuU^O0>QBH`Q&F8&Kc+PljrgU_2Y?xfp(VLw&CRnEBQTP zy@&~m{VH*)>e=-QoMA^$C%eEO;)DfLlt0y&64~k_iv9;VyfJcgt?;Dyxac1{y*_fr zC&SHyV{2!hOg*0RkDgpVc*-Y3%|pl5N>3IaFZ!8N>xWMJgzgeKN4sqbupH;T~l$%=llEcO}UH literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/requests/__pycache__/adapters.cpython-312.pyc b/.venv/lib/python3.12/site-packages/requests/__pycache__/adapters.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d2b727a188838d6b17c1379e11a9331008a27419 GIT binary patch literal 28352 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

U*p7LzB>WaU?^<&8U|U%S#aZMC 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/requests/__pycache__/api.cpython-312.pyc b/.venv/lib/python3.12/site-packages/requests/__pycache__/api.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b83f5bd1342c46f45cb8c248aba231b707613cbe GIT binary patch literal 7192 zcmeHM&u<&Y72YLRzeqc7o!E(+)ScEqDB2WhOLm+Rj%-DeYp0GZSaOlLDYUEIp}5v^ zmz`OPp{q1Gq(FOVb7)~5ib97TZ200s5BVQ@q0jm+Ale4dH-!5j?kU`doHTk<4I}%^wcn)# z|8b4WQ0A?woBC;iL4?`696Od{-kG!Le+bwnT^6p%?n-NF=X7g1BW04)CHCk0hVB9 znrdqG9_F+ypDl8@?C6MULjQ1vMkqOQN)AYnCEpo)=#U)C*nuA+W-f${D$n4REo2F- zaQt(Ppw23mk6^+fG~zNQu3K){ zkqVBv!bQhBD2{YCu*i{~ID?8J5apOfDlP#`p$Z=e@`9I&<}l{=5tvylLXHV|U1y%S zHOo%LH92lZ`;6sR2I+{e<|ju}U{tfjslxKSpuQlu;|i?S>qM^yfyXUB&!&~$3XUt4 z{*WjNagHcZQYauF6lN(E6rvPRpriqTqeedFrLL|eQZ8Q z@w#4i?J|5?g299e^CIvhnvrKQxXxKLQ^!0M5opN>3K_}fFU&EUi_k5(wiWW&)KNNm zz!DXJGKwEnD=ha;3m0IM6Kt{OJHRrwS(E&s`i(dN*5X#BXRj_r#m>%OLbE^F}6%*If}CPVlfMkPo*~O)N3EP*j5>M6o?Wk05vz z0mhi1wueQ8>9Vwzc(E8gFg89uP8>Brq;J0vE1!DM#9r%k>%V&c7w9`WosD9ds{-{)ew47;?g)yt3nXF2IR zhu=9InYzd>#?da0Q{dAlFArg3r;-J0Dw zi{YVzgqQHJ6A3QPTy)w33KG{ojUnK(I8Qxc96UvK7>JmO6kmf{ZYClNDCN^}v#tAQ zQ5RIu>0j+Vie>Mt#P4E5am9?>rbawq^ z6ip)=!KecRyhwpT#qsZ;veSE45yPDXzL+FqA5L1IbOD7}<`Z_||HI?`fXw!XKKRA|xiOwNNOysRSBR z7}cr>72*p0Ir>9M9U_Qi4cmu}qA`TDCE*#2IGoJ(KD zKlj(vrwDm{I2GIFE$oSJ5vY17^S23aRQzl^-cGJfZlq7FJI(Zo8zt15#)*e;w@0AN ze{Y|fqE9$a7->(D+WQ^u@sO)@BX&@pL!@ykeoY$hCd#j_&26NQti!pFG>s!l*;#!i zo0yr&rdtCG3r=7!EVMLrT#xvaI`Amwt%#ILTPlJmv#OQopHFHkbws*9cq;lw*|>Na z9q@il7E#bm}q#Gr2c>p4w-{$BrxKA~@#dRl+=-b+LJ$h{YK>4!HD?$XcbR34|| MmCb`gdc^1d11lO=;s5{u literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/requests/__pycache__/auth.cpython-312.pyc b/.venv/lib/python3.12/site-packages/requests/__pycache__/auth.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2608c72f80886358cc78a6b64eb8e6140fc04a0b GIT binary patch literal 13911 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 Rp3<_d^Jjm@;FD7Oe*p0xV7mYS literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/requests/__pycache__/certs.cpython-312.pyc b/.venv/lib/python3.12/site-packages/requests/__pycache__/certs.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..3542f90d3a71cc4413e4efcad7de6e89f137c0d6 GIT binary patch literal 654 zcmY*XL2DE-6i#+#ZH?BWU{CK-?7}*OdXpj)K@hY;>8Y0?J9)DcI+Kh^W_5ZHFM{G# z@HfcfFY)HhJ&B&YRf?CMOlGGCA0)i@c;ENlmzS?wTa0*{94?D5l#pK`xU_h1&L4Q^ z6A|Q?2r5Putw+ZrN-z@9$u1%0#)x3-&uBRSmYyjXC0*RblX3glCz!z(Em~)j9F4Q= z^?%0LQ7J9dTC^2{LDw2(!IcP&!2*pz0Rju&Rt_HRL!gj_%(+9DwMtZ&z)^_?L0YC& z)qz$BKi_=pDS}@ZUH8ENg@)%Re2xiYPYURC3*4jENvY;=I7~YQOyofl zAf$Ch&RQq6f<9k!<+%hywU9=u8kL*&q&ZiRmt4)UZ|)^XCD*tDUWSQxC*bs;*mtnl zaN}iF9UCSTLGU1w{SNOsp{sF^U2SGr&85n+gUNWck!3>XS+?33G@8g4hZ@Ce^!agP zq;j9hc_6uXo|d}C)HLXfUdX&mb1g7^CT*T33$G-t03V9GhL?Rm$kRn=%MzcF@@0fYf-D|T5 zqD9I9Bp;kpenAcq7Y_LY;hGcTfYZbYQj`O?1qXqAO7+azfYQ=@{Z(~U&2&|D&u{s> zhG0~`y1O)%Lg;TP?2dS!Y+DLKKOzfZWGR;FC|C(+6{}Y4dxT>uBC)%DV;m>yN*HrD zOf=&pNm|Mn2v+>c5rlARPfmn#+DhU~CVGR0vsMacNQS21O=(AS^Ej^{4{-Y-WhYp@p#A!&VF|SPq>qK z(mj9=xKnt_)v@j##0TAJJndF+#ht-3?jd|Av@bgExQFp!_Xs}XR&mumijTU-@G%9E z2;h>6>*OSvg?WygTvG6SN39@|n?W=cMpB(D&R$0Ad<|WTT}Eq4wRHVg zjgqTv!Z@oneK#<<_TAe<(=N4arn|n?c8DHOvTFNn=5+Ly=~)i3blVMl%Jsq@)Qfin1h(aKrPdYdZFILaQ;6iINLGA|FvB zDul?M3)B7?r9Q2yRDPF;fgO{3(e<4R^_K6FIt>V?{;J(<)tkOW>I*h&)@!T8Tdjj} zJqYVEUz?q)GnY5GCb@{fG&Dc zD0e^KES`Lh5{cp4vCVAx&PP2pmLL9Oyz*##_QCk%f>gE57ZCG>|~n zIb!O~ zGA2gfl-_i#zAI9OVfjtNph?K0h_Ma}%NO-eu79Qs+gtKQ+yGG|ZDs_Wx&Aya3N4cv z40_QaE6n$V_6Cnj4NXI2T9DzhP2X{%wr8{`HN`hHHM7yAC22e$L3WUc%RSLSN&97y zt)G)xxSnL07#)(Us_oNZNpg@qu&IS9q5D8ZM{jpn3hnHFarR&;#6cCZQJ3tXGkH@=y0f#)-V~|pR!p*%!cwLmK@*YBJZ_b zLhYu(I{}#GVTmjg8i_xnZ3v2}{BiB1KZp+XhxB6*<+Z~e0l+CxlxJ#6iEo#YGVmB_ z&kGr4@YyKJPCwKt-BhoD(%DC;kq4=fZoHR7TH&^NXJq4(I}_dH|Hbl1x6o4)O6hTY z^2zX6ckx*o#mj%jkNy*%d67iQ%wOo#19WN&9o|AyTWI8^mQ~c3Xb(n{iuwWp^h&5$ z?q)ZWnQm+|o$n?#3j-VP-TtPlZ4L}=kd0h7FG=!N{#Ea51*He!SSzKicu{Vsw8Lb% Te@ULMp!=1~>3ZybO#%E5px|Be literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/requests/__pycache__/cookies.cpython-312.pyc b/.venv/lib/python3.12/site-packages/requests/__pycache__/cookies.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..68ecae03bc57d14d07bd7e4c512cb11b5fec066d GIT binary patch literal 25264 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 RAbjru@1qX;_w6Fe{{tyznOy(? literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/requests/__pycache__/exceptions.cpython-312.pyc b/.venv/lib/python3.12/site-packages/requests/__pycache__/exceptions.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..7a9d350153c561c6cf2eb53ea9a2c6e187c7ad86 GIT binary patch literal 7573 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/requests/__pycache__/models.cpython-312.pyc b/.venv/lib/python3.12/site-packages/requests/__pycache__/models.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..7e308b59e0a91971b174adbaa840efea8cc07540 GIT binary patch literal 35394 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/requests/__pycache__/packages.cpython-312.pyc b/.venv/lib/python3.12/site-packages/requests/__pycache__/packages.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2b9f4d3b5f2757e08532a0ed2c2be3e8e6fc3992 GIT binary patch literal 1127 zcmb7BOH30{6uoa|Ivx7~!p~~0F_NfFwWBn_51)lqFsYCT3r!PghM5N)I_;Es1Ej7X zY$|CYtbh;#%Q4;P%B_1hR6;D{(zsw(V8_ZC+a^Sa=v}*gp{Q^0gj z6=5+mWHcs5+0JLg4Jqn7d?g&i*H{ zm|KSp%Jx?1WuPE2fT{TfOii|)){MKYiO%;g)cm{u>fil;{^K6(Ie!LgSN_w!v0HK$ zsVZ)5_8T8-&SB;<5f)$~NdWEE8u6k;-pOmx$k zR;6hL6O*!zpL14{|J)~VsFB8d1s9NG4dhxw$M z#=Mrrx~9&^Vv-kC3G;(85&7^8&dl)EBz!ifC)G?Oe6N!yvX1Z6r{L>z@pUAe%^h<+ zReOD!&yukBL)xvgLL-E}gX<^wD=uj2I0P0Apt*rP-}SBgJHF6-|H8BU%M#Oez(P~& zQgkJ@9NTHUb_kSX0OjejyJ6|(V&Ce>=IGj}F>A;lri{Vez@u{4!%wM?sm~pyuKs-V zUF>aa`|@pL#CW>x>-_4895`%x<$|qMX#&Q*O}Cf5t>3(Xk~c8dzt`AuLdoHX)|756 z_O3=Zht`ISapTp87e>$Sl?P@2)y?j;?k!UChw{(MU622iD|sU2=C+m4a%gpYOWtX| Wn~$DRWt(!_N)-n%7qxb4KfeGdH4EDS literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/requests/__pycache__/sessions.cpython-312.pyc b/.venv/lib/python3.12/site-packages/requests/__pycache__/sessions.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5e2cde3c566cde110759a34a52a1309bbd3a204f GIT binary patch literal 27870 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/requests/__pycache__/status_codes.cpython-312.pyc b/.venv/lib/python3.12/site-packages/requests/__pycache__/status_codes.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..24578c8fb837e38c8b21e124fc85c9fc37f3ac46 GIT binary patch literal 6019 zcmZ`+YjhOHmF}LGG^5d50)#DS^AaL3BM^=q@De`&%fSe2Ft&NP)tai23e9wnyL%)? z770n5jhtmSPOyzwJ2BpKytWtTB>$5?yUCB;%|6W9IqTEMKlXV4to}9N>^kh($5(ZG zM#A7ZXTI+5-l|)-?yb62{oB^ojE3LflUItLc4*qaOH%(OqL&+=>Y8>@W16KgoyAIe zId(jzYeHjjmbjp^BufFCSTiuqGQbv=1-7y_U_0vocCs#DH|qiRvK7FUY!$GNtp?u3 z?gsX=HNdsZ0N%sa0oSt)7j%rXk!=DSV4H!1Yzy!!Y%6dZ%K`Ij2)Lc?01mUAz`_mV-<4MSqS4gDkTJ6sUe`vMEG%a&A5vX{$b_MNfHl@i~zE0Zzs+p}knA<7lU^$nLlU*(?fHRN?cPK|kD02a^?#!Qzp z;bK|?r&QzNq5Hn1Q_kmB#qpJP=l1)*q}7RmlTJRewPR=~lR4s)InC6Vw5GXHu9kcO zuPIQNz0Hhq$DcH+l?r#aDPD4B@LI4uZcKC6!?Y2FVg|8^!fUzQuu8HS%NhF-AWos! zTF+L_nHn2gVuub$hM_W1Hlep_NGXiKIoIW0#epM~q~)1Yt{a$1F0&{X&7dA+9(SCn zYGp4HvdBo(TySh(*j2vBNzm=h2){6i#bH)l$9D=&$y+Q+T`b5zqB3qz%(igLE!DQ6 zq3c^&xZLtNTl{kF$cXjxK=pzRi|Sp0x|>aa?fGn2bO?i)ooUWYEZwqYV``;ZkW?ZW;%y>F-IGP9YBQ0SEEc3a z&P^FdlT>zNLfqC7JRm zNH+vxXVk6Xd7}~poyY@<6q1XYhOO%JAVnhavg{QLTE;Dg_NvGPaS-vN$hE2+Es$Bv z;K$Uuqhi&{h>hxjV#5NYQc1)G>Xt^m92bmnTf9Pj(lQh(YP0ce2;{3I?kaOEKW0j8 zQ~-jOWkkG22HTWOtzQd;Ra}(fc+junsMaw2K@pYc?={ACT*k2# zV6IfcB(V;Ibk&Ze*r+J>>TD2yMTR@7l?m5kys>D4rbr^*rxv}-7fPdU{EB*D1Hzs>K|LNMa2Rm$*QCj~ z+{YaQXW^u*?syk}Lz)fa6gP8Rs%_@XcqZyQG7wdK7bj-Wd7DW5n)>&n&`e{4sJx+i zm?b`eo~Y&?+z484q2h+@qzAo)lE4UNq2!>p*JB_)liEbkivyRtHmrEu#l6GiuIso# zb~&4k=be+$!Ff^qp3Jt(VuPDkiOVX7weX)LS5%>hmv~t>Vg@svLCC@Q!KH=b0#l2Ge zH|cu>_I$A@3Mw?7k89xs7ym<}ts2LrX+|&EL_u9`lp+4t}csHW!=Iu0*zUZ7y~? zUDqreC9-PBLs)boXCV#=5d zPdENI5Iy-pte;-4RZZX)9QP4g`ps#5c)5MRvpS2)opHj7Xn!B!ldjcqk<8BTtG z595DhGvENe(JpFp+9`amqcgg`4sU-Fe@(xr>)QEjLaXUNi_hqTvDw(z*yww5-^Fr6 zfo^-!8N;}FEI*0QlDu0%Npi3qC-ZV)yz+v51`Cpf1A#qx)lY4B{Aew(E9R8 zxV>-T=;eDC4qj~^{GfU81{!NO^~{~ql7sS9y^$C!)w6m`dnq>8*bY&0+K?PgB}X51 ze~4a#arb3B+}9*506e+F4C9=dfO`RCcGVXq&W#rUDx92o%8!X$#%c8Z{gm{8$QYoeB8b2U%S^|?OuQR!0)<;KIvHbMslJ0 z<_nizc>V0V>~|f**P75JjKj+HY%ICuvo|b$!*wIS zTJf9IFV}puZsfzhk*m!k*Wy|-8>Y0ju4_$rb1%WM(ZQ7a7M?N=ZnfZ7ahAI>2`Xsr zPvx7OiAtC1p(c5=`2l>YR7-r1`wp~n`+HwS7{a)&>(^pkdgAw+HGO@UctX#_{w>io z-ybIBD@IQ?e~`W>Y*MUQu}xuGu?*P!+OS2DtWs?cTNP_lY$R+~tV1@uJM2`XOOpPu zTag~sZg1GD*b1py8?IDjl~Sz_`xINP*g$xfVs|TcFzi=sjbdxUwTc;F80;QJHbkn8 zifvLXe{Ddq&9dR@a8QvgO0_opieg(8TODpwEGHYT3G<2!MXK$J?NIFN;jm&m!9p#O zNrm?+{-CbZYr}_h#UCcVI(&rqUgDd>eZ==mj*%WEIzsCH@G;^zEM+os;Q`{06Tdq= zNPLv|;qVag!^8)|Cx|~O`F#KNBSeoX+7~`W^cc1751%If4Dq4xS>nfu?+Q;4KS_K? zc#8OQ#P^3L@iECM8Wu@#>PY{MaEf?|_;6SzZWF&Jbck1o9|)f(?n*v?SLhM-Nxe0! z5}zi%JDeeYhWO^NMtqj|j_?KIbHuk?KTG_Z#P1KkMf|~7U@v3r`Toy-9{22_ya-@ztS8e2n<9YnI~YQrC(xE#1A)_EGb|x#aa!hn~8& NNz+r`Yf^RP{{fr&EoT4# literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/requests/__pycache__/structures.cpython-312.pyc b/.venv/lib/python3.12/site-packages/requests/__pycache__/structures.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c1baf875c93f6afbae3d36ba10168391ba260ccd GIT binary patch literal 5605 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/requests/__version__.py b/.venv/lib/python3.12/site-packages/requests/__version__.py new file mode 100644 index 0000000..2c105ac --- /dev/null +++ b/.venv/lib/python3.12/site-packages/requests/__version__.py @@ -0,0 +1,14 @@ +# .-. .-. .-. . . .-. .-. .-. .-. +# |( |- |.| | | |- `-. | `-. +# ' ' `-' `-`.`-' `-' `-' ' `-' + +__title__ = "requests" +__description__ = "Python HTTP for Humans." +__url__ = "https://requests.readthedocs.io" +__version__ = "2.32.3" +__build__ = 0x023203 +__author__ = "Kenneth Reitz" +__author_email__ = "me@kennethreitz.org" +__license__ = "Apache-2.0" +__copyright__ = "Copyright Kenneth Reitz" +__cake__ = "\u2728 \U0001f370 \u2728" diff --git a/.venv/lib/python3.12/site-packages/requests/_internal_utils.py b/.venv/lib/python3.12/site-packages/requests/_internal_utils.py new file mode 100644 index 0000000..f2cf635 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/requests/_internal_utils.py @@ -0,0 +1,50 @@ +""" +requests._internal_utils +~~~~~~~~~~~~~~ + +Provides utility functions that are consumed internally by Requests +which depend on extremely few external helpers (such as compat) +""" +import re + +from .compat import builtin_str + +_VALID_HEADER_NAME_RE_BYTE = re.compile(rb"^[^:\s][^:\r\n]*$") +_VALID_HEADER_NAME_RE_STR = re.compile(r"^[^:\s][^:\r\n]*$") +_VALID_HEADER_VALUE_RE_BYTE = re.compile(rb"^\S[^\r\n]*$|^$") +_VALID_HEADER_VALUE_RE_STR = re.compile(r"^\S[^\r\n]*$|^$") + +_HEADER_VALIDATORS_STR = (_VALID_HEADER_NAME_RE_STR, _VALID_HEADER_VALUE_RE_STR) +_HEADER_VALIDATORS_BYTE = (_VALID_HEADER_NAME_RE_BYTE, _VALID_HEADER_VALUE_RE_BYTE) +HEADER_VALIDATORS = { + bytes: _HEADER_VALIDATORS_BYTE, + str: _HEADER_VALIDATORS_STR, +} + + +def to_native_string(string, encoding="ascii"): + """Given a string object, regardless of type, returns a representation of + that string in the native string type, encoding and decoding where + necessary. This assumes ASCII unless told otherwise. + """ + if isinstance(string, builtin_str): + out = string + else: + out = string.decode(encoding) + + return out + + +def unicode_is_ascii(u_string): + """Determine if unicode string only contains ASCII characters. + + :param str u_string: unicode string to check. Must be unicode + and not Python 2 `str`. + :rtype: bool + """ + assert isinstance(u_string, str) + try: + u_string.encode("ascii") + return True + except UnicodeEncodeError: + return False diff --git a/.venv/lib/python3.12/site-packages/requests/adapters.py b/.venv/lib/python3.12/site-packages/requests/adapters.py new file mode 100644 index 0000000..9a58b16 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/requests/adapters.py @@ -0,0 +1,719 @@ +""" +requests.adapters +~~~~~~~~~~~~~~~~~ + +This module contains the transport adapters that Requests uses to define +and maintain connections. +""" + +import os.path +import socket # noqa: F401 +import typing +import warnings + +from urllib3.exceptions import ClosedPoolError, ConnectTimeoutError +from urllib3.exceptions import HTTPError as _HTTPError +from urllib3.exceptions import InvalidHeader as _InvalidHeader +from urllib3.exceptions import ( + LocationValueError, + MaxRetryError, + NewConnectionError, + ProtocolError, +) +from urllib3.exceptions import ProxyError as _ProxyError +from urllib3.exceptions import ReadTimeoutError, ResponseError +from urllib3.exceptions import SSLError as _SSLError +from urllib3.poolmanager import PoolManager, proxy_from_url +from urllib3.util import Timeout as TimeoutSauce +from urllib3.util import parse_url +from urllib3.util.retry import Retry +from urllib3.util.ssl_ import create_urllib3_context + +from .auth import _basic_auth_str +from .compat import basestring, urlparse +from .cookies import extract_cookies_to_jar +from .exceptions import ( + ConnectionError, + ConnectTimeout, + InvalidHeader, + InvalidProxyURL, + InvalidSchema, + InvalidURL, + ProxyError, + ReadTimeout, + RetryError, + SSLError, +) +from .models import Response +from .structures import CaseInsensitiveDict +from .utils import ( + DEFAULT_CA_BUNDLE_PATH, + extract_zipped_paths, + get_auth_from_url, + get_encoding_from_headers, + prepend_scheme_if_needed, + select_proxy, + urldefragauth, +) + +try: + from urllib3.contrib.socks import SOCKSProxyManager +except ImportError: + + def SOCKSProxyManager(*args, **kwargs): + raise InvalidSchema("Missing dependencies for SOCKS support.") + + +if typing.TYPE_CHECKING: + from .models import PreparedRequest + + +DEFAULT_POOLBLOCK = False +DEFAULT_POOLSIZE = 10 +DEFAULT_RETRIES = 0 +DEFAULT_POOL_TIMEOUT = None + + +try: + import ssl # noqa: F401 + + _preloaded_ssl_context = create_urllib3_context() + _preloaded_ssl_context.load_verify_locations( + extract_zipped_paths(DEFAULT_CA_BUNDLE_PATH) + ) +except ImportError: + # Bypass default SSLContext creation when Python + # interpreter isn't built with the ssl module. + _preloaded_ssl_context = None + + +def _urllib3_request_context( + request: "PreparedRequest", + verify: "bool | str | None", + client_cert: "typing.Tuple[str, str] | str | None", + poolmanager: "PoolManager", +) -> "(typing.Dict[str, typing.Any], typing.Dict[str, typing.Any])": + host_params = {} + pool_kwargs = {} + parsed_request_url = urlparse(request.url) + scheme = parsed_request_url.scheme.lower() + port = parsed_request_url.port + + # Determine if we have and should use our default SSLContext + # to optimize performance on standard requests. + poolmanager_kwargs = getattr(poolmanager, "connection_pool_kw", {}) + has_poolmanager_ssl_context = poolmanager_kwargs.get("ssl_context") + should_use_default_ssl_context = ( + _preloaded_ssl_context is not None and not has_poolmanager_ssl_context + ) + + cert_reqs = "CERT_REQUIRED" + if verify is False: + cert_reqs = "CERT_NONE" + elif verify is True and should_use_default_ssl_context: + pool_kwargs["ssl_context"] = _preloaded_ssl_context + elif isinstance(verify, str): + if not os.path.isdir(verify): + pool_kwargs["ca_certs"] = verify + else: + pool_kwargs["ca_cert_dir"] = verify + pool_kwargs["cert_reqs"] = cert_reqs + if client_cert is not None: + if isinstance(client_cert, tuple) and len(client_cert) == 2: + pool_kwargs["cert_file"] = client_cert[0] + pool_kwargs["key_file"] = client_cert[1] + else: + # According to our docs, we allow users to specify just the client + # cert path + pool_kwargs["cert_file"] = client_cert + host_params = { + "scheme": scheme, + "host": parsed_request_url.hostname, + "port": port, + } + return host_params, pool_kwargs + + +class BaseAdapter: + """The Base Transport Adapter""" + + def __init__(self): + super().__init__() + + def send( + self, request, stream=False, timeout=None, verify=True, cert=None, proxies=None + ): + """Sends PreparedRequest object. Returns Response object. + + :param request: The :class:`PreparedRequest ` being sent. + :param stream: (optional) Whether to stream the request content. + :param timeout: (optional) How long to wait for the server to send + data before giving up, as a float, or a :ref:`(connect timeout, + read timeout) ` tuple. + :type timeout: float or tuple + :param verify: (optional) Either a boolean, in which case it controls whether we verify + the server's TLS certificate, or a string, in which case it must be a path + to a CA bundle to use + :param cert: (optional) Any user-provided SSL certificate to be trusted. + :param proxies: (optional) The proxies dictionary to apply to the request. + """ + raise NotImplementedError + + def close(self): + """Cleans up adapter specific items.""" + raise NotImplementedError + + +class HTTPAdapter(BaseAdapter): + """The built-in HTTP Adapter for urllib3. + + Provides a general-case interface for Requests sessions to contact HTTP and + HTTPS urls by implementing the Transport Adapter interface. This class will + usually be created by the :class:`Session ` class under the + covers. + + :param pool_connections: The number of urllib3 connection pools to cache. + :param pool_maxsize: The maximum number of connections to save in the pool. + :param max_retries: The maximum number of retries each connection + should attempt. Note, this applies only to failed DNS lookups, socket + connections and connection timeouts, never to requests where data has + made it to the server. By default, Requests does not retry failed + connections. If you need granular control over the conditions under + which we retry a request, import urllib3's ``Retry`` class and pass + that instead. + :param pool_block: Whether the connection pool should block for connections. + + Usage:: + + >>> import requests + >>> s = requests.Session() + >>> a = requests.adapters.HTTPAdapter(max_retries=3) + >>> s.mount('http://', a) + """ + + __attrs__ = [ + "max_retries", + "config", + "_pool_connections", + "_pool_maxsize", + "_pool_block", + ] + + def __init__( + self, + pool_connections=DEFAULT_POOLSIZE, + pool_maxsize=DEFAULT_POOLSIZE, + max_retries=DEFAULT_RETRIES, + pool_block=DEFAULT_POOLBLOCK, + ): + if max_retries == DEFAULT_RETRIES: + self.max_retries = Retry(0, read=False) + else: + self.max_retries = Retry.from_int(max_retries) + self.config = {} + self.proxy_manager = {} + + super().__init__() + + self._pool_connections = pool_connections + self._pool_maxsize = pool_maxsize + self._pool_block = pool_block + + self.init_poolmanager(pool_connections, pool_maxsize, block=pool_block) + + def __getstate__(self): + return {attr: getattr(self, attr, None) for attr in self.__attrs__} + + def __setstate__(self, state): + # Can't handle by adding 'proxy_manager' to self.__attrs__ because + # self.poolmanager uses a lambda function, which isn't pickleable. + self.proxy_manager = {} + self.config = {} + + for attr, value in state.items(): + setattr(self, attr, value) + + self.init_poolmanager( + self._pool_connections, self._pool_maxsize, block=self._pool_block + ) + + def init_poolmanager( + self, connections, maxsize, block=DEFAULT_POOLBLOCK, **pool_kwargs + ): + """Initializes a urllib3 PoolManager. + + This method should not be called from user code, and is only + exposed for use when subclassing the + :class:`HTTPAdapter `. + + :param connections: The number of urllib3 connection pools to cache. + :param maxsize: The maximum number of connections to save in the pool. + :param block: Block when no free connections are available. + :param pool_kwargs: Extra keyword arguments used to initialize the Pool Manager. + """ + # save these values for pickling + self._pool_connections = connections + self._pool_maxsize = maxsize + self._pool_block = block + + self.poolmanager = PoolManager( + num_pools=connections, + maxsize=maxsize, + block=block, + **pool_kwargs, + ) + + def proxy_manager_for(self, proxy, **proxy_kwargs): + """Return urllib3 ProxyManager for the given proxy. + + This method should not be called from user code, and is only + exposed for use when subclassing the + :class:`HTTPAdapter `. + + :param proxy: The proxy to return a urllib3 ProxyManager for. + :param proxy_kwargs: Extra keyword arguments used to configure the Proxy Manager. + :returns: ProxyManager + :rtype: urllib3.ProxyManager + """ + if proxy in self.proxy_manager: + manager = self.proxy_manager[proxy] + elif proxy.lower().startswith("socks"): + username, password = get_auth_from_url(proxy) + manager = self.proxy_manager[proxy] = SOCKSProxyManager( + proxy, + username=username, + password=password, + num_pools=self._pool_connections, + maxsize=self._pool_maxsize, + block=self._pool_block, + **proxy_kwargs, + ) + else: + proxy_headers = self.proxy_headers(proxy) + manager = self.proxy_manager[proxy] = proxy_from_url( + proxy, + proxy_headers=proxy_headers, + num_pools=self._pool_connections, + maxsize=self._pool_maxsize, + block=self._pool_block, + **proxy_kwargs, + ) + + return manager + + def cert_verify(self, conn, url, verify, cert): + """Verify a SSL certificate. This method should not be called from user + code, and is only exposed for use when subclassing the + :class:`HTTPAdapter `. + + :param conn: The urllib3 connection object associated with the cert. + :param url: The requested URL. + :param verify: Either a boolean, in which case it controls whether we verify + the server's TLS certificate, or a string, in which case it must be a path + to a CA bundle to use + :param cert: The SSL certificate to verify. + """ + if url.lower().startswith("https") and verify: + conn.cert_reqs = "CERT_REQUIRED" + + # Only load the CA certificates if 'verify' is a string indicating the CA bundle to use. + # Otherwise, if verify is a boolean, we don't load anything since + # the connection will be using a context with the default certificates already loaded, + # and this avoids a call to the slow load_verify_locations() + if verify is not True: + # `verify` must be a str with a path then + cert_loc = verify + + if not os.path.exists(cert_loc): + raise OSError( + f"Could not find a suitable TLS CA certificate bundle, " + f"invalid path: {cert_loc}" + ) + + if not os.path.isdir(cert_loc): + conn.ca_certs = cert_loc + else: + conn.ca_cert_dir = cert_loc + else: + conn.cert_reqs = "CERT_NONE" + conn.ca_certs = None + conn.ca_cert_dir = None + + if cert: + if not isinstance(cert, basestring): + conn.cert_file = cert[0] + conn.key_file = cert[1] + else: + conn.cert_file = cert + conn.key_file = None + if conn.cert_file and not os.path.exists(conn.cert_file): + raise OSError( + f"Could not find the TLS certificate file, " + f"invalid path: {conn.cert_file}" + ) + if conn.key_file and not os.path.exists(conn.key_file): + raise OSError( + f"Could not find the TLS key file, invalid path: {conn.key_file}" + ) + + def build_response(self, req, resp): + """Builds a :class:`Response ` object from a urllib3 + response. This should not be called from user code, and is only exposed + for use when subclassing the + :class:`HTTPAdapter ` + + :param req: The :class:`PreparedRequest ` used to generate the response. + :param resp: The urllib3 response object. + :rtype: requests.Response + """ + response = Response() + + # Fallback to None if there's no status_code, for whatever reason. + response.status_code = getattr(resp, "status", None) + + # Make headers case-insensitive. + response.headers = CaseInsensitiveDict(getattr(resp, "headers", {})) + + # Set encoding. + response.encoding = get_encoding_from_headers(response.headers) + response.raw = resp + response.reason = response.raw.reason + + if isinstance(req.url, bytes): + response.url = req.url.decode("utf-8") + else: + response.url = req.url + + # Add new cookies from the server. + extract_cookies_to_jar(response.cookies, req, resp) + + # Give the Response some context. + response.request = req + response.connection = self + + return response + + def build_connection_pool_key_attributes(self, request, verify, cert=None): + """Build the PoolKey attributes used by urllib3 to return a connection. + + This looks at the PreparedRequest, the user-specified verify value, + and the value of the cert parameter to determine what PoolKey values + to use to select a connection from a given urllib3 Connection Pool. + + The SSL related pool key arguments are not consistently set. As of + this writing, use the following to determine what keys may be in that + dictionary: + + * If ``verify`` is ``True``, ``"ssl_context"`` will be set and will be the + default Requests SSL Context + * If ``verify`` is ``False``, ``"ssl_context"`` will not be set but + ``"cert_reqs"`` will be set + * If ``verify`` is a string, (i.e., it is a user-specified trust bundle) + ``"ca_certs"`` will be set if the string is not a directory recognized + by :py:func:`os.path.isdir`, otherwise ``"ca_certs_dir"`` will be + set. + * If ``"cert"`` is specified, ``"cert_file"`` will always be set. If + ``"cert"`` is a tuple with a second item, ``"key_file"`` will also + be present + + To override these settings, one may subclass this class, call this + method and use the above logic to change parameters as desired. For + example, if one wishes to use a custom :py:class:`ssl.SSLContext` one + must both set ``"ssl_context"`` and based on what else they require, + alter the other keys to ensure the desired behaviour. + + :param request: + The PreparedReqest being sent over the connection. + :type request: + :class:`~requests.models.PreparedRequest` + :param verify: + Either a boolean, in which case it controls whether + we verify the server's TLS certificate, or a string, in which case it + must be a path to a CA bundle to use. + :param cert: + (optional) Any user-provided SSL certificate for client + authentication (a.k.a., mTLS). This may be a string (i.e., just + the path to a file which holds both certificate and key) or a + tuple of length 2 with the certificate file path and key file + path. + :returns: + A tuple of two dictionaries. The first is the "host parameters" + portion of the Pool Key including scheme, hostname, and port. The + second is a dictionary of SSLContext related parameters. + """ + return _urllib3_request_context(request, verify, cert, self.poolmanager) + + def get_connection_with_tls_context(self, request, verify, proxies=None, cert=None): + """Returns a urllib3 connection for the given request and TLS settings. + This should not be called from user code, and is only exposed for use + when subclassing the :class:`HTTPAdapter `. + + :param request: + The :class:`PreparedRequest ` object to be sent + over the connection. + :param verify: + Either a boolean, in which case it controls whether we verify the + server's TLS certificate, or a string, in which case it must be a + path to a CA bundle to use. + :param proxies: + (optional) The proxies dictionary to apply to the request. + :param cert: + (optional) Any user-provided SSL certificate to be used for client + authentication (a.k.a., mTLS). + :rtype: + urllib3.ConnectionPool + """ + proxy = select_proxy(request.url, proxies) + try: + host_params, pool_kwargs = self.build_connection_pool_key_attributes( + request, + verify, + cert, + ) + except ValueError as e: + raise InvalidURL(e, request=request) + if proxy: + proxy = prepend_scheme_if_needed(proxy, "http") + proxy_url = parse_url(proxy) + if not proxy_url.host: + raise InvalidProxyURL( + "Please check proxy URL. It is malformed " + "and could be missing the host." + ) + proxy_manager = self.proxy_manager_for(proxy) + conn = proxy_manager.connection_from_host( + **host_params, pool_kwargs=pool_kwargs + ) + else: + # Only scheme should be lower case + conn = self.poolmanager.connection_from_host( + **host_params, pool_kwargs=pool_kwargs + ) + + return conn + + def get_connection(self, url, proxies=None): + """DEPRECATED: Users should move to `get_connection_with_tls_context` + for all subclasses of HTTPAdapter using Requests>=2.32.2. + + Returns a urllib3 connection for the given URL. This should not be + called from user code, and is only exposed for use when subclassing the + :class:`HTTPAdapter `. + + :param url: The URL to connect to. + :param proxies: (optional) A Requests-style dictionary of proxies used on this request. + :rtype: urllib3.ConnectionPool + """ + warnings.warn( + ( + "`get_connection` has been deprecated in favor of " + "`get_connection_with_tls_context`. Custom HTTPAdapter subclasses " + "will need to migrate for Requests>=2.32.2. Please see " + "https://github.com/psf/requests/pull/6710 for more details." + ), + DeprecationWarning, + ) + proxy = select_proxy(url, proxies) + + if proxy: + proxy = prepend_scheme_if_needed(proxy, "http") + proxy_url = parse_url(proxy) + if not proxy_url.host: + raise InvalidProxyURL( + "Please check proxy URL. It is malformed " + "and could be missing the host." + ) + proxy_manager = self.proxy_manager_for(proxy) + conn = proxy_manager.connection_from_url(url) + else: + # Only scheme should be lower case + parsed = urlparse(url) + url = parsed.geturl() + conn = self.poolmanager.connection_from_url(url) + + return conn + + def close(self): + """Disposes of any internal state. + + Currently, this closes the PoolManager and any active ProxyManager, + which closes any pooled connections. + """ + self.poolmanager.clear() + for proxy in self.proxy_manager.values(): + proxy.clear() + + def request_url(self, request, proxies): + """Obtain the url to use when making the final request. + + If the message is being sent through a HTTP proxy, the full URL has to + be used. Otherwise, we should only use the path portion of the URL. + + This should not be called from user code, and is only exposed for use + when subclassing the + :class:`HTTPAdapter `. + + :param request: The :class:`PreparedRequest ` being sent. + :param proxies: A dictionary of schemes or schemes and hosts to proxy URLs. + :rtype: str + """ + proxy = select_proxy(request.url, proxies) + scheme = urlparse(request.url).scheme + + is_proxied_http_request = proxy and scheme != "https" + using_socks_proxy = False + if proxy: + proxy_scheme = urlparse(proxy).scheme.lower() + using_socks_proxy = proxy_scheme.startswith("socks") + + url = request.path_url + if url.startswith("//"): # Don't confuse urllib3 + url = f"/{url.lstrip('/')}" + + if is_proxied_http_request and not using_socks_proxy: + url = urldefragauth(request.url) + + return url + + def add_headers(self, request, **kwargs): + """Add any headers needed by the connection. As of v2.0 this does + nothing by default, but is left for overriding by users that subclass + the :class:`HTTPAdapter `. + + This should not be called from user code, and is only exposed for use + when subclassing the + :class:`HTTPAdapter `. + + :param request: The :class:`PreparedRequest ` to add headers to. + :param kwargs: The keyword arguments from the call to send(). + """ + pass + + def proxy_headers(self, proxy): + """Returns a dictionary of the headers to add to any request sent + through a proxy. This works with urllib3 magic to ensure that they are + correctly sent to the proxy, rather than in a tunnelled request if + CONNECT is being used. + + This should not be called from user code, and is only exposed for use + when subclassing the + :class:`HTTPAdapter `. + + :param proxy: The url of the proxy being used for this request. + :rtype: dict + """ + headers = {} + username, password = get_auth_from_url(proxy) + + if username: + headers["Proxy-Authorization"] = _basic_auth_str(username, password) + + return headers + + def send( + self, request, stream=False, timeout=None, verify=True, cert=None, proxies=None + ): + """Sends PreparedRequest object. Returns Response object. + + :param request: The :class:`PreparedRequest ` being sent. + :param stream: (optional) Whether to stream the request content. + :param timeout: (optional) How long to wait for the server to send + data before giving up, as a float, or a :ref:`(connect timeout, + read timeout) ` tuple. + :type timeout: float or tuple or urllib3 Timeout object + :param verify: (optional) Either a boolean, in which case it controls whether + we verify the server's TLS certificate, or a string, in which case it + must be a path to a CA bundle to use + :param cert: (optional) Any user-provided SSL certificate to be trusted. + :param proxies: (optional) The proxies dictionary to apply to the request. + :rtype: requests.Response + """ + + try: + conn = self.get_connection_with_tls_context( + request, verify, proxies=proxies, cert=cert + ) + except LocationValueError as e: + raise InvalidURL(e, request=request) + + self.cert_verify(conn, request.url, verify, cert) + url = self.request_url(request, proxies) + self.add_headers( + request, + stream=stream, + timeout=timeout, + verify=verify, + cert=cert, + proxies=proxies, + ) + + chunked = not (request.body is None or "Content-Length" in request.headers) + + if isinstance(timeout, tuple): + try: + connect, read = timeout + timeout = TimeoutSauce(connect=connect, read=read) + except ValueError: + raise ValueError( + f"Invalid timeout {timeout}. Pass a (connect, read) timeout tuple, " + f"or a single float to set both timeouts to the same value." + ) + elif isinstance(timeout, TimeoutSauce): + pass + else: + timeout = TimeoutSauce(connect=timeout, read=timeout) + + try: + resp = conn.urlopen( + method=request.method, + url=url, + body=request.body, + headers=request.headers, + redirect=False, + assert_same_host=False, + preload_content=False, + decode_content=False, + retries=self.max_retries, + timeout=timeout, + chunked=chunked, + ) + + except (ProtocolError, OSError) as err: + raise ConnectionError(err, request=request) + + except MaxRetryError as e: + if isinstance(e.reason, ConnectTimeoutError): + # TODO: Remove this in 3.0.0: see #2811 + if not isinstance(e.reason, NewConnectionError): + raise ConnectTimeout(e, request=request) + + if isinstance(e.reason, ResponseError): + raise RetryError(e, request=request) + + if isinstance(e.reason, _ProxyError): + raise ProxyError(e, request=request) + + if isinstance(e.reason, _SSLError): + # This branch is for urllib3 v1.22 and later. + raise SSLError(e, request=request) + + raise ConnectionError(e, request=request) + + except ClosedPoolError as e: + raise ConnectionError(e, request=request) + + except _ProxyError as e: + raise ProxyError(e) + + except (_SSLError, _HTTPError) as e: + if isinstance(e, _SSLError): + # This branch is for urllib3 versions earlier than v1.22 + raise SSLError(e, request=request) + elif isinstance(e, ReadTimeoutError): + raise ReadTimeout(e, request=request) + elif isinstance(e, _InvalidHeader): + raise InvalidHeader(e, request=request) + else: + raise + + return self.build_response(request, resp) diff --git a/.venv/lib/python3.12/site-packages/requests/api.py b/.venv/lib/python3.12/site-packages/requests/api.py new file mode 100644 index 0000000..5960744 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/requests/api.py @@ -0,0 +1,157 @@ +""" +requests.api +~~~~~~~~~~~~ + +This module implements the Requests API. + +:copyright: (c) 2012 by Kenneth Reitz. +:license: Apache2, see LICENSE for more details. +""" + +from . import sessions + + +def request(method, url, **kwargs): + """Constructs and sends a :class:`Request `. + + :param method: method for the new :class:`Request` object: ``GET``, ``OPTIONS``, ``HEAD``, ``POST``, ``PUT``, ``PATCH``, or ``DELETE``. + :param url: URL for the new :class:`Request` object. + :param params: (optional) Dictionary, list of tuples or bytes to send + in the query string for the :class:`Request`. + :param data: (optional) Dictionary, list of tuples, bytes, or file-like + object to send in the body of the :class:`Request`. + :param json: (optional) A JSON serializable Python object to send in the body of the :class:`Request`. + :param headers: (optional) Dictionary of HTTP Headers to send with the :class:`Request`. + :param cookies: (optional) Dict or CookieJar object to send with the :class:`Request`. + :param files: (optional) Dictionary of ``'name': file-like-objects`` (or ``{'name': file-tuple}``) for multipart encoding upload. + ``file-tuple`` can be a 2-tuple ``('filename', fileobj)``, 3-tuple ``('filename', fileobj, 'content_type')`` + or a 4-tuple ``('filename', fileobj, 'content_type', custom_headers)``, where ``'content_type'`` is a string + defining the content type of the given file and ``custom_headers`` a dict-like object containing additional headers + to add for the file. + :param auth: (optional) Auth tuple to enable Basic/Digest/Custom HTTP Auth. + :param timeout: (optional) How many seconds to wait for the server to send data + before giving up, as a float, or a :ref:`(connect timeout, read + timeout) ` tuple. + :type timeout: float or tuple + :param allow_redirects: (optional) Boolean. Enable/disable GET/OPTIONS/POST/PUT/PATCH/DELETE/HEAD redirection. Defaults to ``True``. + :type allow_redirects: bool + :param proxies: (optional) Dictionary mapping protocol to the URL of the proxy. + :param verify: (optional) Either a boolean, in which case it controls whether we verify + the server's TLS certificate, or a string, in which case it must be a path + to a CA bundle to use. Defaults to ``True``. + :param stream: (optional) if ``False``, the response content will be immediately downloaded. + :param cert: (optional) if String, path to ssl client cert file (.pem). If Tuple, ('cert', 'key') pair. + :return: :class:`Response ` object + :rtype: requests.Response + + Usage:: + + >>> import requests + >>> req = requests.request('GET', 'https://httpbin.org/get') + >>> req + + """ + + # By using the 'with' statement we are sure the session is closed, thus we + # avoid leaving sockets open which can trigger a ResourceWarning in some + # cases, and look like a memory leak in others. + with sessions.Session() as session: + return session.request(method=method, url=url, **kwargs) + + +def get(url, params=None, **kwargs): + r"""Sends a GET request. + + :param url: URL for the new :class:`Request` object. + :param params: (optional) Dictionary, list of tuples or bytes to send + in the query string for the :class:`Request`. + :param \*\*kwargs: Optional arguments that ``request`` takes. + :return: :class:`Response ` object + :rtype: requests.Response + """ + + return request("get", url, params=params, **kwargs) + + +def options(url, **kwargs): + r"""Sends an OPTIONS request. + + :param url: URL for the new :class:`Request` object. + :param \*\*kwargs: Optional arguments that ``request`` takes. + :return: :class:`Response ` object + :rtype: requests.Response + """ + + return request("options", url, **kwargs) + + +def head(url, **kwargs): + r"""Sends a HEAD request. + + :param url: URL for the new :class:`Request` object. + :param \*\*kwargs: Optional arguments that ``request`` takes. If + `allow_redirects` is not provided, it will be set to `False` (as + opposed to the default :meth:`request` behavior). + :return: :class:`Response ` object + :rtype: requests.Response + """ + + kwargs.setdefault("allow_redirects", False) + return request("head", url, **kwargs) + + +def post(url, data=None, json=None, **kwargs): + r"""Sends a POST request. + + :param url: URL for the new :class:`Request` object. + :param data: (optional) Dictionary, list of tuples, bytes, or file-like + object to send in the body of the :class:`Request`. + :param json: (optional) A JSON serializable Python object to send in the body of the :class:`Request`. + :param \*\*kwargs: Optional arguments that ``request`` takes. + :return: :class:`Response ` object + :rtype: requests.Response + """ + + return request("post", url, data=data, json=json, **kwargs) + + +def put(url, data=None, **kwargs): + r"""Sends a PUT request. + + :param url: URL for the new :class:`Request` object. + :param data: (optional) Dictionary, list of tuples, bytes, or file-like + object to send in the body of the :class:`Request`. + :param json: (optional) A JSON serializable Python object to send in the body of the :class:`Request`. + :param \*\*kwargs: Optional arguments that ``request`` takes. + :return: :class:`Response ` object + :rtype: requests.Response + """ + + return request("put", url, data=data, **kwargs) + + +def patch(url, data=None, **kwargs): + r"""Sends a PATCH request. + + :param url: URL for the new :class:`Request` object. + :param data: (optional) Dictionary, list of tuples, bytes, or file-like + object to send in the body of the :class:`Request`. + :param json: (optional) A JSON serializable Python object to send in the body of the :class:`Request`. + :param \*\*kwargs: Optional arguments that ``request`` takes. + :return: :class:`Response ` object + :rtype: requests.Response + """ + + return request("patch", url, data=data, **kwargs) + + +def delete(url, **kwargs): + r"""Sends a DELETE request. + + :param url: URL for the new :class:`Request` object. + :param \*\*kwargs: Optional arguments that ``request`` takes. + :return: :class:`Response ` object + :rtype: requests.Response + """ + + return request("delete", url, **kwargs) diff --git a/.venv/lib/python3.12/site-packages/requests/auth.py b/.venv/lib/python3.12/site-packages/requests/auth.py new file mode 100644 index 0000000..4a7ce6d --- /dev/null +++ b/.venv/lib/python3.12/site-packages/requests/auth.py @@ -0,0 +1,314 @@ +""" +requests.auth +~~~~~~~~~~~~~ + +This module contains the authentication handlers for Requests. +""" + +import hashlib +import os +import re +import threading +import time +import warnings +from base64 import b64encode + +from ._internal_utils import to_native_string +from .compat import basestring, str, urlparse +from .cookies import extract_cookies_to_jar +from .utils import parse_dict_header + +CONTENT_TYPE_FORM_URLENCODED = "application/x-www-form-urlencoded" +CONTENT_TYPE_MULTI_PART = "multipart/form-data" + + +def _basic_auth_str(username, password): + """Returns a Basic Auth string.""" + + # "I want us to put a big-ol' comment on top of it that + # says that this behaviour is dumb but we need to preserve + # it because people are relying on it." + # - Lukasa + # + # These are here solely to maintain backwards compatibility + # for things like ints. This will be removed in 3.0.0. + if not isinstance(username, basestring): + warnings.warn( + "Non-string usernames will no longer be supported in Requests " + "3.0.0. Please convert the object you've passed in ({!r}) to " + "a string or bytes object in the near future to avoid " + "problems.".format(username), + category=DeprecationWarning, + ) + username = str(username) + + if not isinstance(password, basestring): + warnings.warn( + "Non-string passwords will no longer be supported in Requests " + "3.0.0. Please convert the object you've passed in ({!r}) to " + "a string or bytes object in the near future to avoid " + "problems.".format(type(password)), + category=DeprecationWarning, + ) + password = str(password) + # -- End Removal -- + + if isinstance(username, str): + username = username.encode("latin1") + + if isinstance(password, str): + password = password.encode("latin1") + + authstr = "Basic " + to_native_string( + b64encode(b":".join((username, password))).strip() + ) + + return authstr + + +class AuthBase: + """Base class that all auth implementations derive from""" + + def __call__(self, r): + raise NotImplementedError("Auth hooks must be callable.") + + +class HTTPBasicAuth(AuthBase): + """Attaches HTTP Basic Authentication to the given Request object.""" + + def __init__(self, username, password): + self.username = username + self.password = password + + def __eq__(self, other): + return all( + [ + self.username == getattr(other, "username", None), + self.password == getattr(other, "password", None), + ] + ) + + def __ne__(self, other): + return not self == other + + def __call__(self, r): + r.headers["Authorization"] = _basic_auth_str(self.username, self.password) + return r + + +class HTTPProxyAuth(HTTPBasicAuth): + """Attaches HTTP Proxy Authentication to a given Request object.""" + + def __call__(self, r): + r.headers["Proxy-Authorization"] = _basic_auth_str(self.username, self.password) + return r + + +class HTTPDigestAuth(AuthBase): + """Attaches HTTP Digest Authentication to the given Request object.""" + + def __init__(self, username, password): + self.username = username + self.password = password + # Keep state in per-thread local storage + self._thread_local = threading.local() + + def init_per_thread_state(self): + # Ensure state is initialized just once per-thread + if not hasattr(self._thread_local, "init"): + self._thread_local.init = True + self._thread_local.last_nonce = "" + self._thread_local.nonce_count = 0 + self._thread_local.chal = {} + self._thread_local.pos = None + self._thread_local.num_401_calls = None + + def build_digest_header(self, method, url): + """ + :rtype: str + """ + + realm = self._thread_local.chal["realm"] + nonce = self._thread_local.chal["nonce"] + qop = self._thread_local.chal.get("qop") + algorithm = self._thread_local.chal.get("algorithm") + opaque = self._thread_local.chal.get("opaque") + hash_utf8 = None + + if algorithm is None: + _algorithm = "MD5" + else: + _algorithm = algorithm.upper() + # lambdas assume digest modules are imported at the top level + if _algorithm == "MD5" or _algorithm == "MD5-SESS": + + def md5_utf8(x): + if isinstance(x, str): + x = x.encode("utf-8") + return hashlib.md5(x).hexdigest() + + hash_utf8 = md5_utf8 + elif _algorithm == "SHA": + + def sha_utf8(x): + if isinstance(x, str): + x = x.encode("utf-8") + return hashlib.sha1(x).hexdigest() + + hash_utf8 = sha_utf8 + elif _algorithm == "SHA-256": + + def sha256_utf8(x): + if isinstance(x, str): + x = x.encode("utf-8") + return hashlib.sha256(x).hexdigest() + + hash_utf8 = sha256_utf8 + elif _algorithm == "SHA-512": + + def sha512_utf8(x): + if isinstance(x, str): + x = x.encode("utf-8") + return hashlib.sha512(x).hexdigest() + + hash_utf8 = sha512_utf8 + + KD = lambda s, d: hash_utf8(f"{s}:{d}") # noqa:E731 + + if hash_utf8 is None: + return None + + # XXX not implemented yet + entdig = None + p_parsed = urlparse(url) + #: path is request-uri defined in RFC 2616 which should not be empty + path = p_parsed.path or "/" + if p_parsed.query: + path += f"?{p_parsed.query}" + + A1 = f"{self.username}:{realm}:{self.password}" + A2 = f"{method}:{path}" + + HA1 = hash_utf8(A1) + HA2 = hash_utf8(A2) + + if nonce == self._thread_local.last_nonce: + self._thread_local.nonce_count += 1 + else: + self._thread_local.nonce_count = 1 + ncvalue = f"{self._thread_local.nonce_count:08x}" + s = str(self._thread_local.nonce_count).encode("utf-8") + s += nonce.encode("utf-8") + s += time.ctime().encode("utf-8") + s += os.urandom(8) + + cnonce = hashlib.sha1(s).hexdigest()[:16] + if _algorithm == "MD5-SESS": + HA1 = hash_utf8(f"{HA1}:{nonce}:{cnonce}") + + if not qop: + respdig = KD(HA1, f"{nonce}:{HA2}") + elif qop == "auth" or "auth" in qop.split(","): + noncebit = f"{nonce}:{ncvalue}:{cnonce}:auth:{HA2}" + respdig = KD(HA1, noncebit) + else: + # XXX handle auth-int. + return None + + self._thread_local.last_nonce = nonce + + # XXX should the partial digests be encoded too? + base = ( + f'username="{self.username}", realm="{realm}", nonce="{nonce}", ' + f'uri="{path}", response="{respdig}"' + ) + if opaque: + base += f', opaque="{opaque}"' + if algorithm: + base += f', algorithm="{algorithm}"' + if entdig: + base += f', digest="{entdig}"' + if qop: + base += f', qop="auth", nc={ncvalue}, cnonce="{cnonce}"' + + return f"Digest {base}" + + def handle_redirect(self, r, **kwargs): + """Reset num_401_calls counter on redirects.""" + if r.is_redirect: + self._thread_local.num_401_calls = 1 + + def handle_401(self, r, **kwargs): + """ + Takes the given response and tries digest-auth, if needed. + + :rtype: requests.Response + """ + + # If response is not 4xx, do not auth + # See https://github.com/psf/requests/issues/3772 + if not 400 <= r.status_code < 500: + self._thread_local.num_401_calls = 1 + return r + + if self._thread_local.pos is not None: + # Rewind the file position indicator of the body to where + # it was to resend the request. + r.request.body.seek(self._thread_local.pos) + s_auth = r.headers.get("www-authenticate", "") + + if "digest" in s_auth.lower() and self._thread_local.num_401_calls < 2: + self._thread_local.num_401_calls += 1 + pat = re.compile(r"digest ", flags=re.IGNORECASE) + self._thread_local.chal = parse_dict_header(pat.sub("", s_auth, count=1)) + + # Consume content and release the original connection + # to allow our new request to reuse the same one. + r.content + r.close() + prep = r.request.copy() + extract_cookies_to_jar(prep._cookies, r.request, r.raw) + prep.prepare_cookies(prep._cookies) + + prep.headers["Authorization"] = self.build_digest_header( + prep.method, prep.url + ) + _r = r.connection.send(prep, **kwargs) + _r.history.append(r) + _r.request = prep + + return _r + + self._thread_local.num_401_calls = 1 + return r + + def __call__(self, r): + # Initialize per-thread state, if needed + self.init_per_thread_state() + # If we have a saved nonce, skip the 401 + if self._thread_local.last_nonce: + r.headers["Authorization"] = self.build_digest_header(r.method, r.url) + try: + self._thread_local.pos = r.body.tell() + except AttributeError: + # In the case of HTTPDigestAuth being reused and the body of + # the previous request was a file-like object, pos has the + # file position of the previous body. Ensure it's set to + # None. + self._thread_local.pos = None + r.register_hook("response", self.handle_401) + r.register_hook("response", self.handle_redirect) + self._thread_local.num_401_calls = 1 + + return r + + def __eq__(self, other): + return all( + [ + self.username == getattr(other, "username", None), + self.password == getattr(other, "password", None), + ] + ) + + def __ne__(self, other): + return not self == other diff --git a/.venv/lib/python3.12/site-packages/requests/certs.py b/.venv/lib/python3.12/site-packages/requests/certs.py new file mode 100644 index 0000000..be422c3 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/requests/certs.py @@ -0,0 +1,17 @@ +#!/usr/bin/env python + +""" +requests.certs +~~~~~~~~~~~~~~ + +This module returns the preferred default CA certificate bundle. There is +only one — the one from the certifi package. + +If you are packaging Requests, e.g., for a Linux distribution or a managed +environment, you can change the definition of where() to return a separately +packaged CA bundle. +""" +from certifi import where + +if __name__ == "__main__": + print(where()) diff --git a/.venv/lib/python3.12/site-packages/requests/compat.py b/.venv/lib/python3.12/site-packages/requests/compat.py new file mode 100644 index 0000000..095de1b --- /dev/null +++ b/.venv/lib/python3.12/site-packages/requests/compat.py @@ -0,0 +1,94 @@ +""" +requests.compat +~~~~~~~~~~~~~~~ + +This module previously handled import compatibility issues +between Python 2 and Python 3. It remains for backwards +compatibility until the next major version. +""" + +import importlib +import sys + +# ------------------- +# Character Detection +# ------------------- + + +def _resolve_char_detection(): + """Find supported character detection libraries.""" + chardet = None + for lib in ("chardet", "charset_normalizer"): + if chardet is None: + try: + chardet = importlib.import_module(lib) + except ImportError: + pass + return chardet + + +chardet = _resolve_char_detection() + +# ------- +# Pythons +# ------- + +# Syntax sugar. +_ver = sys.version_info + +#: Python 2.x? +is_py2 = _ver[0] == 2 + +#: Python 3.x? +is_py3 = _ver[0] == 3 + +# json/simplejson module import resolution +has_simplejson = False +try: + import simplejson as json + + has_simplejson = True +except ImportError: + import json + +if has_simplejson: + from simplejson import JSONDecodeError +else: + from json import JSONDecodeError + +# Keep OrderedDict for backwards compatibility. +from collections import OrderedDict +from collections.abc import Callable, Mapping, MutableMapping +from http import cookiejar as cookielib +from http.cookies import Morsel +from io import StringIO + +# -------------- +# Legacy Imports +# -------------- +from urllib.parse import ( + quote, + quote_plus, + unquote, + unquote_plus, + urldefrag, + urlencode, + urljoin, + urlparse, + urlsplit, + urlunparse, +) +from urllib.request import ( + getproxies, + getproxies_environment, + parse_http_list, + proxy_bypass, + proxy_bypass_environment, +) + +builtin_str = str +str = str +bytes = bytes +basestring = (str, bytes) +numeric_types = (int, float) +integer_types = (int,) diff --git a/.venv/lib/python3.12/site-packages/requests/cookies.py b/.venv/lib/python3.12/site-packages/requests/cookies.py new file mode 100644 index 0000000..f69d0cd --- /dev/null +++ b/.venv/lib/python3.12/site-packages/requests/cookies.py @@ -0,0 +1,561 @@ +""" +requests.cookies +~~~~~~~~~~~~~~~~ + +Compatibility code to be able to use `http.cookiejar.CookieJar` with requests. + +requests.utils imports from here, so be careful with imports. +""" + +import calendar +import copy +import time + +from ._internal_utils import to_native_string +from .compat import Morsel, MutableMapping, cookielib, urlparse, urlunparse + +try: + import threading +except ImportError: + import dummy_threading as threading + + +class MockRequest: + """Wraps a `requests.Request` to mimic a `urllib2.Request`. + + The code in `http.cookiejar.CookieJar` expects this interface in order to correctly + manage cookie policies, i.e., determine whether a cookie can be set, given the + domains of the request and the cookie. + + The original request object is read-only. The client is responsible for collecting + the new headers via `get_new_headers()` and interpreting them appropriately. You + probably want `get_cookie_header`, defined below. + """ + + def __init__(self, request): + self._r = request + self._new_headers = {} + self.type = urlparse(self._r.url).scheme + + def get_type(self): + return self.type + + def get_host(self): + return urlparse(self._r.url).netloc + + def get_origin_req_host(self): + return self.get_host() + + def get_full_url(self): + # Only return the response's URL if the user hadn't set the Host + # header + if not self._r.headers.get("Host"): + return self._r.url + # If they did set it, retrieve it and reconstruct the expected domain + host = to_native_string(self._r.headers["Host"], encoding="utf-8") + parsed = urlparse(self._r.url) + # Reconstruct the URL as we expect it + return urlunparse( + [ + parsed.scheme, + host, + parsed.path, + parsed.params, + parsed.query, + parsed.fragment, + ] + ) + + def is_unverifiable(self): + return True + + def has_header(self, name): + return name in self._r.headers or name in self._new_headers + + def get_header(self, name, default=None): + return self._r.headers.get(name, self._new_headers.get(name, default)) + + def add_header(self, key, val): + """cookiejar has no legitimate use for this method; add it back if you find one.""" + raise NotImplementedError( + "Cookie headers should be added with add_unredirected_header()" + ) + + def add_unredirected_header(self, name, value): + self._new_headers[name] = value + + def get_new_headers(self): + return self._new_headers + + @property + def unverifiable(self): + return self.is_unverifiable() + + @property + def origin_req_host(self): + return self.get_origin_req_host() + + @property + def host(self): + return self.get_host() + + +class MockResponse: + """Wraps a `httplib.HTTPMessage` to mimic a `urllib.addinfourl`. + + ...what? Basically, expose the parsed HTTP headers from the server response + the way `http.cookiejar` expects to see them. + """ + + def __init__(self, headers): + """Make a MockResponse for `cookiejar` to read. + + :param headers: a httplib.HTTPMessage or analogous carrying the headers + """ + self._headers = headers + + def info(self): + return self._headers + + def getheaders(self, name): + self._headers.getheaders(name) + + +def extract_cookies_to_jar(jar, request, response): + """Extract the cookies from the response into a CookieJar. + + :param jar: http.cookiejar.CookieJar (not necessarily a RequestsCookieJar) + :param request: our own requests.Request object + :param response: urllib3.HTTPResponse object + """ + if not (hasattr(response, "_original_response") and response._original_response): + return + # the _original_response field is the wrapped httplib.HTTPResponse object, + req = MockRequest(request) + # pull out the HTTPMessage with the headers and put it in the mock: + res = MockResponse(response._original_response.msg) + jar.extract_cookies(res, req) + + +def get_cookie_header(jar, request): + """ + Produce an appropriate Cookie header string to be sent with `request`, or None. + + :rtype: str + """ + r = MockRequest(request) + jar.add_cookie_header(r) + return r.get_new_headers().get("Cookie") + + +def remove_cookie_by_name(cookiejar, name, domain=None, path=None): + """Unsets a cookie by name, by default over all domains and paths. + + Wraps CookieJar.clear(), is O(n). + """ + clearables = [] + for cookie in cookiejar: + if cookie.name != name: + continue + if domain is not None and domain != cookie.domain: + continue + if path is not None and path != cookie.path: + continue + clearables.append((cookie.domain, cookie.path, cookie.name)) + + for domain, path, name in clearables: + cookiejar.clear(domain, path, name) + + +class CookieConflictError(RuntimeError): + """There are two cookies that meet the criteria specified in the cookie jar. + Use .get and .set and include domain and path args in order to be more specific. + """ + + +class RequestsCookieJar(cookielib.CookieJar, MutableMapping): + """Compatibility class; is a http.cookiejar.CookieJar, but exposes a dict + interface. + + This is the CookieJar we create by default for requests and sessions that + don't specify one, since some clients may expect response.cookies and + session.cookies to support dict operations. + + Requests does not use the dict interface internally; it's just for + compatibility with external client code. All requests code should work + out of the box with externally provided instances of ``CookieJar``, e.g. + ``LWPCookieJar`` and ``FileCookieJar``. + + Unlike a regular CookieJar, this class is pickleable. + + .. warning:: dictionary operations that are normally O(1) may be O(n). + """ + + def get(self, name, default=None, domain=None, path=None): + """Dict-like get() that also supports optional domain and path args in + order to resolve naming collisions from using one cookie jar over + multiple domains. + + .. warning:: operation is O(n), not O(1). + """ + try: + return self._find_no_duplicates(name, domain, path) + except KeyError: + return default + + def set(self, name, value, **kwargs): + """Dict-like set() that also supports optional domain and path args in + order to resolve naming collisions from using one cookie jar over + multiple domains. + """ + # support client code that unsets cookies by assignment of a None value: + if value is None: + remove_cookie_by_name( + self, name, domain=kwargs.get("domain"), path=kwargs.get("path") + ) + return + + if isinstance(value, Morsel): + c = morsel_to_cookie(value) + else: + c = create_cookie(name, value, **kwargs) + self.set_cookie(c) + return c + + def iterkeys(self): + """Dict-like iterkeys() that returns an iterator of names of cookies + from the jar. + + .. seealso:: itervalues() and iteritems(). + """ + for cookie in iter(self): + yield cookie.name + + def keys(self): + """Dict-like keys() that returns a list of names of cookies from the + jar. + + .. seealso:: values() and items(). + """ + return list(self.iterkeys()) + + def itervalues(self): + """Dict-like itervalues() that returns an iterator of values of cookies + from the jar. + + .. seealso:: iterkeys() and iteritems(). + """ + for cookie in iter(self): + yield cookie.value + + def values(self): + """Dict-like values() that returns a list of values of cookies from the + jar. + + .. seealso:: keys() and items(). + """ + return list(self.itervalues()) + + def iteritems(self): + """Dict-like iteritems() that returns an iterator of name-value tuples + from the jar. + + .. seealso:: iterkeys() and itervalues(). + """ + for cookie in iter(self): + yield cookie.name, cookie.value + + def items(self): + """Dict-like items() that returns a list of name-value tuples from the + jar. Allows client-code to call ``dict(RequestsCookieJar)`` and get a + vanilla python dict of key value pairs. + + .. seealso:: keys() and values(). + """ + return list(self.iteritems()) + + def list_domains(self): + """Utility method to list all the domains in the jar.""" + domains = [] + for cookie in iter(self): + if cookie.domain not in domains: + domains.append(cookie.domain) + return domains + + def list_paths(self): + """Utility method to list all the paths in the jar.""" + paths = [] + for cookie in iter(self): + if cookie.path not in paths: + paths.append(cookie.path) + return paths + + def multiple_domains(self): + """Returns True if there are multiple domains in the jar. + Returns False otherwise. + + :rtype: bool + """ + domains = [] + for cookie in iter(self): + if cookie.domain is not None and cookie.domain in domains: + return True + domains.append(cookie.domain) + return False # there is only one domain in jar + + def get_dict(self, domain=None, path=None): + """Takes as an argument an optional domain and path and returns a plain + old Python dict of name-value pairs of cookies that meet the + requirements. + + :rtype: dict + """ + dictionary = {} + for cookie in iter(self): + if (domain is None or cookie.domain == domain) and ( + path is None or cookie.path == path + ): + dictionary[cookie.name] = cookie.value + return dictionary + + def __contains__(self, name): + try: + return super().__contains__(name) + except CookieConflictError: + return True + + def __getitem__(self, name): + """Dict-like __getitem__() for compatibility with client code. Throws + exception if there are more than one cookie with name. In that case, + use the more explicit get() method instead. + + .. warning:: operation is O(n), not O(1). + """ + return self._find_no_duplicates(name) + + def __setitem__(self, name, value): + """Dict-like __setitem__ for compatibility with client code. Throws + exception if there is already a cookie of that name in the jar. In that + case, use the more explicit set() method instead. + """ + self.set(name, value) + + def __delitem__(self, name): + """Deletes a cookie given a name. Wraps ``http.cookiejar.CookieJar``'s + ``remove_cookie_by_name()``. + """ + remove_cookie_by_name(self, name) + + def set_cookie(self, cookie, *args, **kwargs): + if ( + hasattr(cookie.value, "startswith") + and cookie.value.startswith('"') + and cookie.value.endswith('"') + ): + cookie.value = cookie.value.replace('\\"', "") + return super().set_cookie(cookie, *args, **kwargs) + + def update(self, other): + """Updates this jar with cookies from another CookieJar or dict-like""" + if isinstance(other, cookielib.CookieJar): + for cookie in other: + self.set_cookie(copy.copy(cookie)) + else: + super().update(other) + + def _find(self, name, domain=None, path=None): + """Requests uses this method internally to get cookie values. + + If there are conflicting cookies, _find arbitrarily chooses one. + See _find_no_duplicates if you want an exception thrown if there are + conflicting cookies. + + :param name: a string containing name of cookie + :param domain: (optional) string containing domain of cookie + :param path: (optional) string containing path of cookie + :return: cookie.value + """ + for cookie in iter(self): + if cookie.name == name: + if domain is None or cookie.domain == domain: + if path is None or cookie.path == path: + return cookie.value + + raise KeyError(f"name={name!r}, domain={domain!r}, path={path!r}") + + def _find_no_duplicates(self, name, domain=None, path=None): + """Both ``__get_item__`` and ``get`` call this function: it's never + used elsewhere in Requests. + + :param name: a string containing name of cookie + :param domain: (optional) string containing domain of cookie + :param path: (optional) string containing path of cookie + :raises KeyError: if cookie is not found + :raises CookieConflictError: if there are multiple cookies + that match name and optionally domain and path + :return: cookie.value + """ + toReturn = None + for cookie in iter(self): + if cookie.name == name: + if domain is None or cookie.domain == domain: + if path is None or cookie.path == path: + if toReturn is not None: + # if there are multiple cookies that meet passed in criteria + raise CookieConflictError( + f"There are multiple cookies with name, {name!r}" + ) + # we will eventually return this as long as no cookie conflict + toReturn = cookie.value + + if toReturn: + return toReturn + raise KeyError(f"name={name!r}, domain={domain!r}, path={path!r}") + + def __getstate__(self): + """Unlike a normal CookieJar, this class is pickleable.""" + state = self.__dict__.copy() + # remove the unpickleable RLock object + state.pop("_cookies_lock") + return state + + def __setstate__(self, state): + """Unlike a normal CookieJar, this class is pickleable.""" + self.__dict__.update(state) + if "_cookies_lock" not in self.__dict__: + self._cookies_lock = threading.RLock() + + def copy(self): + """Return a copy of this RequestsCookieJar.""" + new_cj = RequestsCookieJar() + new_cj.set_policy(self.get_policy()) + new_cj.update(self) + return new_cj + + def get_policy(self): + """Return the CookiePolicy instance used.""" + return self._policy + + +def _copy_cookie_jar(jar): + if jar is None: + return None + + if hasattr(jar, "copy"): + # We're dealing with an instance of RequestsCookieJar + return jar.copy() + # We're dealing with a generic CookieJar instance + new_jar = copy.copy(jar) + new_jar.clear() + for cookie in jar: + new_jar.set_cookie(copy.copy(cookie)) + return new_jar + + +def create_cookie(name, value, **kwargs): + """Make a cookie from underspecified parameters. + + By default, the pair of `name` and `value` will be set for the domain '' + and sent on every request (this is sometimes called a "supercookie"). + """ + result = { + "version": 0, + "name": name, + "value": value, + "port": None, + "domain": "", + "path": "/", + "secure": False, + "expires": None, + "discard": True, + "comment": None, + "comment_url": None, + "rest": {"HttpOnly": None}, + "rfc2109": False, + } + + badargs = set(kwargs) - set(result) + if badargs: + raise TypeError( + f"create_cookie() got unexpected keyword arguments: {list(badargs)}" + ) + + result.update(kwargs) + result["port_specified"] = bool(result["port"]) + result["domain_specified"] = bool(result["domain"]) + result["domain_initial_dot"] = result["domain"].startswith(".") + result["path_specified"] = bool(result["path"]) + + return cookielib.Cookie(**result) + + +def morsel_to_cookie(morsel): + """Convert a Morsel object into a Cookie containing the one k/v pair.""" + + expires = None + if morsel["max-age"]: + try: + expires = int(time.time() + int(morsel["max-age"])) + except ValueError: + raise TypeError(f"max-age: {morsel['max-age']} must be integer") + elif morsel["expires"]: + time_template = "%a, %d-%b-%Y %H:%M:%S GMT" + expires = calendar.timegm(time.strptime(morsel["expires"], time_template)) + return create_cookie( + comment=morsel["comment"], + comment_url=bool(morsel["comment"]), + discard=False, + domain=morsel["domain"], + expires=expires, + name=morsel.key, + path=morsel["path"], + port=None, + rest={"HttpOnly": morsel["httponly"]}, + rfc2109=False, + secure=bool(morsel["secure"]), + value=morsel.value, + version=morsel["version"] or 0, + ) + + +def cookiejar_from_dict(cookie_dict, cookiejar=None, overwrite=True): + """Returns a CookieJar from a key/value dictionary. + + :param cookie_dict: Dict of key/values to insert into CookieJar. + :param cookiejar: (optional) A cookiejar to add the cookies to. + :param overwrite: (optional) If False, will not replace cookies + already in the jar with new ones. + :rtype: CookieJar + """ + if cookiejar is None: + cookiejar = RequestsCookieJar() + + if cookie_dict is not None: + names_from_jar = [cookie.name for cookie in cookiejar] + for name in cookie_dict: + if overwrite or (name not in names_from_jar): + cookiejar.set_cookie(create_cookie(name, cookie_dict[name])) + + return cookiejar + + +def merge_cookies(cookiejar, cookies): + """Add cookies to cookiejar and returns a merged CookieJar. + + :param cookiejar: CookieJar object to add the cookies to. + :param cookies: Dictionary or CookieJar object to be added. + :rtype: CookieJar + """ + if not isinstance(cookiejar, cookielib.CookieJar): + raise ValueError("You can only merge into CookieJar") + + if isinstance(cookies, dict): + cookiejar = cookiejar_from_dict(cookies, cookiejar=cookiejar, overwrite=False) + elif isinstance(cookies, cookielib.CookieJar): + try: + cookiejar.update(cookies) + except AttributeError: + for cookie_in_jar in cookies: + cookiejar.set_cookie(cookie_in_jar) + + return cookiejar diff --git a/.venv/lib/python3.12/site-packages/requests/exceptions.py b/.venv/lib/python3.12/site-packages/requests/exceptions.py new file mode 100644 index 0000000..83986b4 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/requests/exceptions.py @@ -0,0 +1,151 @@ +""" +requests.exceptions +~~~~~~~~~~~~~~~~~~~ + +This module contains the set of Requests' exceptions. +""" +from urllib3.exceptions import HTTPError as BaseHTTPError + +from .compat import JSONDecodeError as CompatJSONDecodeError + + +class RequestException(IOError): + """There was an ambiguous exception that occurred while handling your + request. + """ + + def __init__(self, *args, **kwargs): + """Initialize RequestException with `request` and `response` objects.""" + response = kwargs.pop("response", None) + self.response = response + self.request = kwargs.pop("request", None) + if response is not None and not self.request and hasattr(response, "request"): + self.request = self.response.request + super().__init__(*args, **kwargs) + + +class InvalidJSONError(RequestException): + """A JSON error occurred.""" + + +class JSONDecodeError(InvalidJSONError, CompatJSONDecodeError): + """Couldn't decode the text into json""" + + def __init__(self, *args, **kwargs): + """ + Construct the JSONDecodeError instance first with all + args. Then use it's args to construct the IOError so that + the json specific args aren't used as IOError specific args + and the error message from JSONDecodeError is preserved. + """ + CompatJSONDecodeError.__init__(self, *args) + InvalidJSONError.__init__(self, *self.args, **kwargs) + + def __reduce__(self): + """ + The __reduce__ method called when pickling the object must + be the one from the JSONDecodeError (be it json/simplejson) + as it expects all the arguments for instantiation, not just + one like the IOError, and the MRO would by default call the + __reduce__ method from the IOError due to the inheritance order. + """ + return CompatJSONDecodeError.__reduce__(self) + + +class HTTPError(RequestException): + """An HTTP error occurred.""" + + +class ConnectionError(RequestException): + """A Connection error occurred.""" + + +class ProxyError(ConnectionError): + """A proxy error occurred.""" + + +class SSLError(ConnectionError): + """An SSL error occurred.""" + + +class Timeout(RequestException): + """The request timed out. + + Catching this error will catch both + :exc:`~requests.exceptions.ConnectTimeout` and + :exc:`~requests.exceptions.ReadTimeout` errors. + """ + + +class ConnectTimeout(ConnectionError, Timeout): + """The request timed out while trying to connect to the remote server. + + Requests that produced this error are safe to retry. + """ + + +class ReadTimeout(Timeout): + """The server did not send any data in the allotted amount of time.""" + + +class URLRequired(RequestException): + """A valid URL is required to make a request.""" + + +class TooManyRedirects(RequestException): + """Too many redirects.""" + + +class MissingSchema(RequestException, ValueError): + """The URL scheme (e.g. http or https) is missing.""" + + +class InvalidSchema(RequestException, ValueError): + """The URL scheme provided is either invalid or unsupported.""" + + +class InvalidURL(RequestException, ValueError): + """The URL provided was somehow invalid.""" + + +class InvalidHeader(RequestException, ValueError): + """The header value provided was somehow invalid.""" + + +class InvalidProxyURL(InvalidURL): + """The proxy URL provided is invalid.""" + + +class ChunkedEncodingError(RequestException): + """The server declared chunked encoding but sent an invalid chunk.""" + + +class ContentDecodingError(RequestException, BaseHTTPError): + """Failed to decode response content.""" + + +class StreamConsumedError(RequestException, TypeError): + """The content for this response was already consumed.""" + + +class RetryError(RequestException): + """Custom retries logic failed""" + + +class UnrewindableBodyError(RequestException): + """Requests encountered an error when trying to rewind a body.""" + + +# Warnings + + +class RequestsWarning(Warning): + """Base warning for Requests.""" + + +class FileModeWarning(RequestsWarning, DeprecationWarning): + """A file was opened in text mode, but Requests determined its binary length.""" + + +class RequestsDependencyWarning(RequestsWarning): + """An imported dependency doesn't match the expected version range.""" diff --git a/.venv/lib/python3.12/site-packages/requests/help.py b/.venv/lib/python3.12/site-packages/requests/help.py new file mode 100644 index 0000000..8fbcd65 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/requests/help.py @@ -0,0 +1,134 @@ +"""Module containing bug report helper(s).""" + +import json +import platform +import ssl +import sys + +import idna +import urllib3 + +from . import __version__ as requests_version + +try: + import charset_normalizer +except ImportError: + charset_normalizer = None + +try: + import chardet +except ImportError: + chardet = None + +try: + from urllib3.contrib import pyopenssl +except ImportError: + pyopenssl = None + OpenSSL = None + cryptography = None +else: + import cryptography + import OpenSSL + + +def _implementation(): + """Return a dict with the Python implementation and version. + + Provide both the name and the version of the Python implementation + currently running. For example, on CPython 3.10.3 it will return + {'name': 'CPython', 'version': '3.10.3'}. + + This function works best on CPython and PyPy: in particular, it probably + doesn't work for Jython or IronPython. Future investigation should be done + to work out the correct shape of the code for those platforms. + """ + implementation = platform.python_implementation() + + if implementation == "CPython": + implementation_version = platform.python_version() + elif implementation == "PyPy": + implementation_version = "{}.{}.{}".format( + sys.pypy_version_info.major, + sys.pypy_version_info.minor, + sys.pypy_version_info.micro, + ) + if sys.pypy_version_info.releaselevel != "final": + implementation_version = "".join( + [implementation_version, sys.pypy_version_info.releaselevel] + ) + elif implementation == "Jython": + implementation_version = platform.python_version() # Complete Guess + elif implementation == "IronPython": + implementation_version = platform.python_version() # Complete Guess + else: + implementation_version = "Unknown" + + return {"name": implementation, "version": implementation_version} + + +def info(): + """Generate information for a bug report.""" + try: + platform_info = { + "system": platform.system(), + "release": platform.release(), + } + except OSError: + platform_info = { + "system": "Unknown", + "release": "Unknown", + } + + implementation_info = _implementation() + urllib3_info = {"version": urllib3.__version__} + charset_normalizer_info = {"version": None} + chardet_info = {"version": None} + if charset_normalizer: + charset_normalizer_info = {"version": charset_normalizer.__version__} + if chardet: + chardet_info = {"version": chardet.__version__} + + pyopenssl_info = { + "version": None, + "openssl_version": "", + } + if OpenSSL: + pyopenssl_info = { + "version": OpenSSL.__version__, + "openssl_version": f"{OpenSSL.SSL.OPENSSL_VERSION_NUMBER:x}", + } + cryptography_info = { + "version": getattr(cryptography, "__version__", ""), + } + idna_info = { + "version": getattr(idna, "__version__", ""), + } + + system_ssl = ssl.OPENSSL_VERSION_NUMBER + system_ssl_info = {"version": f"{system_ssl:x}" if system_ssl is not None else ""} + + return { + "platform": platform_info, + "implementation": implementation_info, + "system_ssl": system_ssl_info, + "using_pyopenssl": pyopenssl is not None, + "using_charset_normalizer": chardet is None, + "pyOpenSSL": pyopenssl_info, + "urllib3": urllib3_info, + "chardet": chardet_info, + "charset_normalizer": charset_normalizer_info, + "cryptography": cryptography_info, + "idna": idna_info, + "requests": { + "version": requests_version, + }, + } + + +def main(): + """Pretty-print the bug information as JSON.""" + print(json.dumps(info(), sort_keys=True, indent=2)) + + +if __name__ == "__main__": + main() diff --git a/.venv/lib/python3.12/site-packages/requests/hooks.py b/.venv/lib/python3.12/site-packages/requests/hooks.py new file mode 100644 index 0000000..d181ba2 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/requests/hooks.py @@ -0,0 +1,33 @@ +""" +requests.hooks +~~~~~~~~~~~~~~ + +This module provides the capabilities for the Requests hooks system. + +Available hooks: + +``response``: + The response generated from a Request. +""" +HOOKS = ["response"] + + +def default_hooks(): + return {event: [] for event in HOOKS} + + +# TODO: response is the only one + + +def dispatch_hook(key, hooks, hook_data, **kwargs): + """Dispatches a hook dictionary on a given piece of data.""" + hooks = hooks or {} + hooks = hooks.get(key) + if hooks: + if hasattr(hooks, "__call__"): + hooks = [hooks] + for hook in hooks: + _hook_data = hook(hook_data, **kwargs) + if _hook_data is not None: + hook_data = _hook_data + return hook_data diff --git a/.venv/lib/python3.12/site-packages/requests/models.py b/.venv/lib/python3.12/site-packages/requests/models.py new file mode 100644 index 0000000..8f56ca7 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/requests/models.py @@ -0,0 +1,1037 @@ +""" +requests.models +~~~~~~~~~~~~~~~ + +This module contains the primary objects that power Requests. +""" + +import datetime + +# Import encoding now, to avoid implicit import later. +# Implicit import within threads may cause LookupError when standard library is in a ZIP, +# such as in Embedded Python. See https://github.com/psf/requests/issues/3578. +import encodings.idna # noqa: F401 +from io import UnsupportedOperation + +from urllib3.exceptions import ( + DecodeError, + LocationParseError, + ProtocolError, + ReadTimeoutError, + SSLError, +) +from urllib3.fields import RequestField +from urllib3.filepost import encode_multipart_formdata +from urllib3.util import parse_url + +from ._internal_utils import to_native_string, unicode_is_ascii +from .auth import HTTPBasicAuth +from .compat import ( + Callable, + JSONDecodeError, + Mapping, + basestring, + builtin_str, + chardet, + cookielib, +) +from .compat import json as complexjson +from .compat import urlencode, urlsplit, urlunparse +from .cookies import _copy_cookie_jar, cookiejar_from_dict, get_cookie_header +from .exceptions import ( + ChunkedEncodingError, + ConnectionError, + ContentDecodingError, + HTTPError, + InvalidJSONError, + InvalidURL, +) +from .exceptions import JSONDecodeError as RequestsJSONDecodeError +from .exceptions import MissingSchema +from .exceptions import SSLError as RequestsSSLError +from .exceptions import StreamConsumedError +from .hooks import default_hooks +from .status_codes import codes +from .structures import CaseInsensitiveDict +from .utils import ( + check_header_validity, + get_auth_from_url, + guess_filename, + guess_json_utf, + iter_slices, + parse_header_links, + requote_uri, + stream_decode_response_unicode, + super_len, + to_key_val_list, +) + +#: The set of HTTP status codes that indicate an automatically +#: processable redirect. +REDIRECT_STATI = ( + codes.moved, # 301 + codes.found, # 302 + codes.other, # 303 + codes.temporary_redirect, # 307 + codes.permanent_redirect, # 308 +) + +DEFAULT_REDIRECT_LIMIT = 30 +CONTENT_CHUNK_SIZE = 10 * 1024 +ITER_CHUNK_SIZE = 512 + + +class RequestEncodingMixin: + @property + def path_url(self): + """Build the path URL to use.""" + + url = [] + + p = urlsplit(self.url) + + path = p.path + if not path: + path = "/" + + url.append(path) + + query = p.query + if query: + url.append("?") + url.append(query) + + return "".join(url) + + @staticmethod + def _encode_params(data): + """Encode parameters in a piece of data. + + Will successfully encode parameters when passed as a dict or a list of + 2-tuples. Order is retained if data is a list of 2-tuples but arbitrary + if parameters are supplied as a dict. + """ + + if isinstance(data, (str, bytes)): + return data + elif hasattr(data, "read"): + return data + elif hasattr(data, "__iter__"): + result = [] + for k, vs in to_key_val_list(data): + if isinstance(vs, basestring) or not hasattr(vs, "__iter__"): + vs = [vs] + for v in vs: + if v is not None: + result.append( + ( + k.encode("utf-8") if isinstance(k, str) else k, + v.encode("utf-8") if isinstance(v, str) else v, + ) + ) + return urlencode(result, doseq=True) + else: + return data + + @staticmethod + def _encode_files(files, data): + """Build the body for a multipart/form-data request. + + Will successfully encode files when passed as a dict or a list of + tuples. Order is retained if data is a list of tuples but arbitrary + if parameters are supplied as a dict. + The tuples may be 2-tuples (filename, fileobj), 3-tuples (filename, fileobj, contentype) + or 4-tuples (filename, fileobj, contentype, custom_headers). + """ + if not files: + raise ValueError("Files must be provided.") + elif isinstance(data, basestring): + raise ValueError("Data must not be a string.") + + new_fields = [] + fields = to_key_val_list(data or {}) + files = to_key_val_list(files or {}) + + for field, val in fields: + if isinstance(val, basestring) or not hasattr(val, "__iter__"): + val = [val] + for v in val: + if v is not None: + # Don't call str() on bytestrings: in Py3 it all goes wrong. + if not isinstance(v, bytes): + v = str(v) + + new_fields.append( + ( + field.decode("utf-8") + if isinstance(field, bytes) + else field, + v.encode("utf-8") if isinstance(v, str) else v, + ) + ) + + for k, v in files: + # support for explicit filename + ft = None + fh = None + if isinstance(v, (tuple, list)): + if len(v) == 2: + fn, fp = v + elif len(v) == 3: + fn, fp, ft = v + else: + fn, fp, ft, fh = v + else: + fn = guess_filename(v) or k + fp = v + + if isinstance(fp, (str, bytes, bytearray)): + fdata = fp + elif hasattr(fp, "read"): + fdata = fp.read() + elif fp is None: + continue + else: + fdata = fp + + rf = RequestField(name=k, data=fdata, filename=fn, headers=fh) + rf.make_multipart(content_type=ft) + new_fields.append(rf) + + body, content_type = encode_multipart_formdata(new_fields) + + return body, content_type + + +class RequestHooksMixin: + def register_hook(self, event, hook): + """Properly register a hook.""" + + if event not in self.hooks: + raise ValueError(f'Unsupported event specified, with event name "{event}"') + + if isinstance(hook, Callable): + self.hooks[event].append(hook) + elif hasattr(hook, "__iter__"): + self.hooks[event].extend(h for h in hook if isinstance(h, Callable)) + + def deregister_hook(self, event, hook): + """Deregister a previously registered hook. + Returns True if the hook existed, False if not. + """ + + try: + self.hooks[event].remove(hook) + return True + except ValueError: + return False + + +class Request(RequestHooksMixin): + """A user-created :class:`Request ` object. + + Used to prepare a :class:`PreparedRequest `, which is sent to the server. + + :param method: HTTP method to use. + :param url: URL to send. + :param headers: dictionary of headers to send. + :param files: dictionary of {filename: fileobject} files to multipart upload. + :param data: the body to attach to the request. If a dictionary or + list of tuples ``[(key, value)]`` is provided, form-encoding will + take place. + :param json: json for the body to attach to the request (if files or data is not specified). + :param params: URL parameters to append to the URL. If a dictionary or + list of tuples ``[(key, value)]`` is provided, form-encoding will + take place. + :param auth: Auth handler or (user, pass) tuple. + :param cookies: dictionary or CookieJar of cookies to attach to this request. + :param hooks: dictionary of callback hooks, for internal usage. + + Usage:: + + >>> import requests + >>> req = requests.Request('GET', 'https://httpbin.org/get') + >>> req.prepare() + + """ + + def __init__( + self, + method=None, + url=None, + headers=None, + files=None, + data=None, + params=None, + auth=None, + cookies=None, + hooks=None, + json=None, + ): + # Default empty dicts for dict params. + data = [] if data is None else data + files = [] if files is None else files + headers = {} if headers is None else headers + params = {} if params is None else params + hooks = {} if hooks is None else hooks + + self.hooks = default_hooks() + for k, v in list(hooks.items()): + self.register_hook(event=k, hook=v) + + self.method = method + self.url = url + self.headers = headers + self.files = files + self.data = data + self.json = json + self.params = params + self.auth = auth + self.cookies = cookies + + def __repr__(self): + return f"" + + def prepare(self): + """Constructs a :class:`PreparedRequest ` for transmission and returns it.""" + p = PreparedRequest() + p.prepare( + method=self.method, + url=self.url, + headers=self.headers, + files=self.files, + data=self.data, + json=self.json, + params=self.params, + auth=self.auth, + cookies=self.cookies, + hooks=self.hooks, + ) + return p + + +class PreparedRequest(RequestEncodingMixin, RequestHooksMixin): + """The fully mutable :class:`PreparedRequest ` object, + containing the exact bytes that will be sent to the server. + + Instances are generated from a :class:`Request ` object, and + should not be instantiated manually; doing so may produce undesirable + effects. + + Usage:: + + >>> import requests + >>> req = requests.Request('GET', 'https://httpbin.org/get') + >>> r = req.prepare() + >>> r + + + >>> s = requests.Session() + >>> s.send(r) + + """ + + def __init__(self): + #: HTTP verb to send to the server. + self.method = None + #: HTTP URL to send the request to. + self.url = None + #: dictionary of HTTP headers. + self.headers = None + # The `CookieJar` used to create the Cookie header will be stored here + # after prepare_cookies is called + self._cookies = None + #: request body to send to the server. + self.body = None + #: dictionary of callback hooks, for internal usage. + self.hooks = default_hooks() + #: integer denoting starting position of a readable file-like body. + self._body_position = None + + def prepare( + self, + method=None, + url=None, + headers=None, + files=None, + data=None, + params=None, + auth=None, + cookies=None, + hooks=None, + json=None, + ): + """Prepares the entire request with the given parameters.""" + + self.prepare_method(method) + self.prepare_url(url, params) + self.prepare_headers(headers) + self.prepare_cookies(cookies) + self.prepare_body(data, files, json) + self.prepare_auth(auth, url) + + # Note that prepare_auth must be last to enable authentication schemes + # such as OAuth to work on a fully prepared request. + + # This MUST go after prepare_auth. Authenticators could add a hook + self.prepare_hooks(hooks) + + def __repr__(self): + return f"" + + def copy(self): + p = PreparedRequest() + p.method = self.method + p.url = self.url + p.headers = self.headers.copy() if self.headers is not None else None + p._cookies = _copy_cookie_jar(self._cookies) + p.body = self.body + p.hooks = self.hooks + p._body_position = self._body_position + return p + + def prepare_method(self, method): + """Prepares the given HTTP method.""" + self.method = method + if self.method is not None: + self.method = to_native_string(self.method.upper()) + + @staticmethod + def _get_idna_encoded_host(host): + import idna + + try: + host = idna.encode(host, uts46=True).decode("utf-8") + except idna.IDNAError: + raise UnicodeError + return host + + def prepare_url(self, url, params): + """Prepares the given HTTP URL.""" + #: Accept objects that have string representations. + #: We're unable to blindly call unicode/str functions + #: as this will include the bytestring indicator (b'') + #: on python 3.x. + #: https://github.com/psf/requests/pull/2238 + if isinstance(url, bytes): + url = url.decode("utf8") + else: + url = str(url) + + # Remove leading whitespaces from url + url = url.lstrip() + + # Don't do any URL preparation for non-HTTP schemes like `mailto`, + # `data` etc to work around exceptions from `url_parse`, which + # handles RFC 3986 only. + if ":" in url and not url.lower().startswith("http"): + self.url = url + return + + # Support for unicode domain names and paths. + try: + scheme, auth, host, port, path, query, fragment = parse_url(url) + except LocationParseError as e: + raise InvalidURL(*e.args) + + if not scheme: + raise MissingSchema( + f"Invalid URL {url!r}: No scheme supplied. " + f"Perhaps you meant https://{url}?" + ) + + if not host: + raise InvalidURL(f"Invalid URL {url!r}: No host supplied") + + # In general, we want to try IDNA encoding the hostname if the string contains + # non-ASCII characters. This allows users to automatically get the correct IDNA + # behaviour. For strings containing only ASCII characters, we need to also verify + # it doesn't start with a wildcard (*), before allowing the unencoded hostname. + if not unicode_is_ascii(host): + try: + host = self._get_idna_encoded_host(host) + except UnicodeError: + raise InvalidURL("URL has an invalid label.") + elif host.startswith(("*", ".")): + raise InvalidURL("URL has an invalid label.") + + # Carefully reconstruct the network location + netloc = auth or "" + if netloc: + netloc += "@" + netloc += host + if port: + netloc += f":{port}" + + # Bare domains aren't valid URLs. + if not path: + path = "/" + + if isinstance(params, (str, bytes)): + params = to_native_string(params) + + enc_params = self._encode_params(params) + if enc_params: + if query: + query = f"{query}&{enc_params}" + else: + query = enc_params + + url = requote_uri(urlunparse([scheme, netloc, path, None, query, fragment])) + self.url = url + + def prepare_headers(self, headers): + """Prepares the given HTTP headers.""" + + self.headers = CaseInsensitiveDict() + if headers: + for header in headers.items(): + # Raise exception on invalid header value. + check_header_validity(header) + name, value = header + self.headers[to_native_string(name)] = value + + def prepare_body(self, data, files, json=None): + """Prepares the given HTTP body data.""" + + # Check if file, fo, generator, iterator. + # If not, run through normal process. + + # Nottin' on you. + body = None + content_type = None + + if not data and json is not None: + # urllib3 requires a bytes-like body. Python 2's json.dumps + # provides this natively, but Python 3 gives a Unicode string. + content_type = "application/json" + + try: + body = complexjson.dumps(json, allow_nan=False) + except ValueError as ve: + raise InvalidJSONError(ve, request=self) + + if not isinstance(body, bytes): + body = body.encode("utf-8") + + is_stream = all( + [ + hasattr(data, "__iter__"), + not isinstance(data, (basestring, list, tuple, Mapping)), + ] + ) + + if is_stream: + try: + length = super_len(data) + except (TypeError, AttributeError, UnsupportedOperation): + length = None + + body = data + + if getattr(body, "tell", None) is not None: + # Record the current file position before reading. + # This will allow us to rewind a file in the event + # of a redirect. + try: + self._body_position = body.tell() + except OSError: + # This differentiates from None, allowing us to catch + # a failed `tell()` later when trying to rewind the body + self._body_position = object() + + if files: + raise NotImplementedError( + "Streamed bodies and files are mutually exclusive." + ) + + if length: + self.headers["Content-Length"] = builtin_str(length) + else: + self.headers["Transfer-Encoding"] = "chunked" + else: + # Multi-part file uploads. + if files: + (body, content_type) = self._encode_files(files, data) + else: + if data: + body = self._encode_params(data) + if isinstance(data, basestring) or hasattr(data, "read"): + content_type = None + else: + content_type = "application/x-www-form-urlencoded" + + self.prepare_content_length(body) + + # Add content-type if it wasn't explicitly provided. + if content_type and ("content-type" not in self.headers): + self.headers["Content-Type"] = content_type + + self.body = body + + def prepare_content_length(self, body): + """Prepare Content-Length header based on request method and body""" + if body is not None: + length = super_len(body) + if length: + # If length exists, set it. Otherwise, we fallback + # to Transfer-Encoding: chunked. + self.headers["Content-Length"] = builtin_str(length) + elif ( + self.method not in ("GET", "HEAD") + and self.headers.get("Content-Length") is None + ): + # Set Content-Length to 0 for methods that can have a body + # but don't provide one. (i.e. not GET or HEAD) + self.headers["Content-Length"] = "0" + + def prepare_auth(self, auth, url=""): + """Prepares the given HTTP auth data.""" + + # If no Auth is explicitly provided, extract it from the URL first. + if auth is None: + url_auth = get_auth_from_url(self.url) + auth = url_auth if any(url_auth) else None + + if auth: + if isinstance(auth, tuple) and len(auth) == 2: + # special-case basic HTTP auth + auth = HTTPBasicAuth(*auth) + + # Allow auth to make its changes. + r = auth(self) + + # Update self to reflect the auth changes. + self.__dict__.update(r.__dict__) + + # Recompute Content-Length + self.prepare_content_length(self.body) + + def prepare_cookies(self, cookies): + """Prepares the given HTTP cookie data. + + This function eventually generates a ``Cookie`` header from the + given cookies using cookielib. Due to cookielib's design, the header + will not be regenerated if it already exists, meaning this function + can only be called once for the life of the + :class:`PreparedRequest ` object. Any subsequent calls + to ``prepare_cookies`` will have no actual effect, unless the "Cookie" + header is removed beforehand. + """ + if isinstance(cookies, cookielib.CookieJar): + self._cookies = cookies + else: + self._cookies = cookiejar_from_dict(cookies) + + cookie_header = get_cookie_header(self._cookies, self) + if cookie_header is not None: + self.headers["Cookie"] = cookie_header + + def prepare_hooks(self, hooks): + """Prepares the given hooks.""" + # hooks can be passed as None to the prepare method and to this + # method. To prevent iterating over None, simply use an empty list + # if hooks is False-y + hooks = hooks or [] + for event in hooks: + self.register_hook(event, hooks[event]) + + +class Response: + """The :class:`Response ` object, which contains a + server's response to an HTTP request. + """ + + __attrs__ = [ + "_content", + "status_code", + "headers", + "url", + "history", + "encoding", + "reason", + "cookies", + "elapsed", + "request", + ] + + def __init__(self): + self._content = False + self._content_consumed = False + self._next = None + + #: Integer Code of responded HTTP Status, e.g. 404 or 200. + self.status_code = None + + #: Case-insensitive Dictionary of Response Headers. + #: For example, ``headers['content-encoding']`` will return the + #: value of a ``'Content-Encoding'`` response header. + self.headers = CaseInsensitiveDict() + + #: File-like object representation of response (for advanced usage). + #: Use of ``raw`` requires that ``stream=True`` be set on the request. + #: This requirement does not apply for use internally to Requests. + self.raw = None + + #: Final URL location of Response. + self.url = None + + #: Encoding to decode with when accessing r.text. + self.encoding = None + + #: A list of :class:`Response ` objects from + #: the history of the Request. Any redirect responses will end + #: up here. The list is sorted from the oldest to the most recent request. + self.history = [] + + #: Textual reason of responded HTTP Status, e.g. "Not Found" or "OK". + self.reason = None + + #: A CookieJar of Cookies the server sent back. + self.cookies = cookiejar_from_dict({}) + + #: The amount of time elapsed between sending the request + #: and the arrival of the response (as a timedelta). + #: This property specifically measures the time taken between sending + #: the first byte of the request and finishing parsing the headers. It + #: is therefore unaffected by consuming the response content or the + #: value of the ``stream`` keyword argument. + self.elapsed = datetime.timedelta(0) + + #: The :class:`PreparedRequest ` object to which this + #: is a response. + self.request = None + + def __enter__(self): + return self + + def __exit__(self, *args): + self.close() + + def __getstate__(self): + # Consume everything; accessing the content attribute makes + # sure the content has been fully read. + if not self._content_consumed: + self.content + + return {attr: getattr(self, attr, None) for attr in self.__attrs__} + + def __setstate__(self, state): + for name, value in state.items(): + setattr(self, name, value) + + # pickled objects do not have .raw + setattr(self, "_content_consumed", True) + setattr(self, "raw", None) + + def __repr__(self): + return f"" + + def __bool__(self): + """Returns True if :attr:`status_code` is less than 400. + + This attribute checks if the status code of the response is between + 400 and 600 to see if there was a client error or a server error. If + the status code, is between 200 and 400, this will return True. This + is **not** a check to see if the response code is ``200 OK``. + """ + return self.ok + + def __nonzero__(self): + """Returns True if :attr:`status_code` is less than 400. + + This attribute checks if the status code of the response is between + 400 and 600 to see if there was a client error or a server error. If + the status code, is between 200 and 400, this will return True. This + is **not** a check to see if the response code is ``200 OK``. + """ + return self.ok + + def __iter__(self): + """Allows you to use a response as an iterator.""" + return self.iter_content(128) + + @property + def ok(self): + """Returns True if :attr:`status_code` is less than 400, False if not. + + This attribute checks if the status code of the response is between + 400 and 600 to see if there was a client error or a server error. If + the status code is between 200 and 400, this will return True. This + is **not** a check to see if the response code is ``200 OK``. + """ + try: + self.raise_for_status() + except HTTPError: + return False + return True + + @property + def is_redirect(self): + """True if this Response is a well-formed HTTP redirect that could have + been processed automatically (by :meth:`Session.resolve_redirects`). + """ + return "location" in self.headers and self.status_code in REDIRECT_STATI + + @property + def is_permanent_redirect(self): + """True if this Response one of the permanent versions of redirect.""" + return "location" in self.headers and self.status_code in ( + codes.moved_permanently, + codes.permanent_redirect, + ) + + @property + def next(self): + """Returns a PreparedRequest for the next request in a redirect chain, if there is one.""" + return self._next + + @property + def apparent_encoding(self): + """The apparent encoding, provided by the charset_normalizer or chardet libraries.""" + if chardet is not None: + return chardet.detect(self.content)["encoding"] + else: + # If no character detection library is available, we'll fall back + # to a standard Python utf-8 str. + return "utf-8" + + def iter_content(self, chunk_size=1, decode_unicode=False): + """Iterates over the response data. When stream=True is set on the + request, this avoids reading the content at once into memory for + large responses. The chunk size is the number of bytes it should + read into memory. This is not necessarily the length of each item + returned as decoding can take place. + + chunk_size must be of type int or None. A value of None will + function differently depending on the value of `stream`. + stream=True will read data as it arrives in whatever size the + chunks are received. If stream=False, data is returned as + a single chunk. + + If decode_unicode is True, content will be decoded using the best + available encoding based on the response. + """ + + def generate(): + # Special case for urllib3. + if hasattr(self.raw, "stream"): + try: + yield from self.raw.stream(chunk_size, decode_content=True) + except ProtocolError as e: + raise ChunkedEncodingError(e) + except DecodeError as e: + raise ContentDecodingError(e) + except ReadTimeoutError as e: + raise ConnectionError(e) + except SSLError as e: + raise RequestsSSLError(e) + else: + # Standard file-like object. + while True: + chunk = self.raw.read(chunk_size) + if not chunk: + break + yield chunk + + self._content_consumed = True + + if self._content_consumed and isinstance(self._content, bool): + raise StreamConsumedError() + elif chunk_size is not None and not isinstance(chunk_size, int): + raise TypeError( + f"chunk_size must be an int, it is instead a {type(chunk_size)}." + ) + # simulate reading small chunks of the content + reused_chunks = iter_slices(self._content, chunk_size) + + stream_chunks = generate() + + chunks = reused_chunks if self._content_consumed else stream_chunks + + if decode_unicode: + chunks = stream_decode_response_unicode(chunks, self) + + return chunks + + def iter_lines( + self, chunk_size=ITER_CHUNK_SIZE, decode_unicode=False, delimiter=None + ): + """Iterates over the response data, one line at a time. When + stream=True is set on the request, this avoids reading the + content at once into memory for large responses. + + .. note:: This method is not reentrant safe. + """ + + pending = None + + for chunk in self.iter_content( + chunk_size=chunk_size, decode_unicode=decode_unicode + ): + if pending is not None: + chunk = pending + chunk + + if delimiter: + lines = chunk.split(delimiter) + else: + lines = chunk.splitlines() + + if lines and lines[-1] and chunk and lines[-1][-1] == chunk[-1]: + pending = lines.pop() + else: + pending = None + + yield from lines + + if pending is not None: + yield pending + + @property + def content(self): + """Content of the response, in bytes.""" + + if self._content is False: + # Read the contents. + if self._content_consumed: + raise RuntimeError("The content for this response was already consumed") + + if self.status_code == 0 or self.raw is None: + self._content = None + else: + self._content = b"".join(self.iter_content(CONTENT_CHUNK_SIZE)) or b"" + + self._content_consumed = True + # don't need to release the connection; that's been handled by urllib3 + # since we exhausted the data. + return self._content + + @property + def text(self): + """Content of the response, in unicode. + + If Response.encoding is None, encoding will be guessed using + ``charset_normalizer`` or ``chardet``. + + The encoding of the response content is determined based solely on HTTP + headers, following RFC 2616 to the letter. If you can take advantage of + non-HTTP knowledge to make a better guess at the encoding, you should + set ``r.encoding`` appropriately before accessing this property. + """ + + # Try charset from content-type + content = None + encoding = self.encoding + + if not self.content: + return "" + + # Fallback to auto-detected encoding. + if self.encoding is None: + encoding = self.apparent_encoding + + # Decode unicode from given encoding. + try: + content = str(self.content, encoding, errors="replace") + except (LookupError, TypeError): + # A LookupError is raised if the encoding was not found which could + # indicate a misspelling or similar mistake. + # + # A TypeError can be raised if encoding is None + # + # So we try blindly encoding. + content = str(self.content, errors="replace") + + return content + + def json(self, **kwargs): + r"""Returns the json-encoded content of a response, if any. + + :param \*\*kwargs: Optional arguments that ``json.loads`` takes. + :raises requests.exceptions.JSONDecodeError: If the response body does not + contain valid json. + """ + + if not self.encoding and self.content and len(self.content) > 3: + # No encoding set. JSON RFC 4627 section 3 states we should expect + # UTF-8, -16 or -32. Detect which one to use; If the detection or + # decoding fails, fall back to `self.text` (using charset_normalizer to make + # a best guess). + encoding = guess_json_utf(self.content) + if encoding is not None: + try: + return complexjson.loads(self.content.decode(encoding), **kwargs) + except UnicodeDecodeError: + # Wrong UTF codec detected; usually because it's not UTF-8 + # but some other 8-bit codec. This is an RFC violation, + # and the server didn't bother to tell us what codec *was* + # used. + pass + except JSONDecodeError as e: + raise RequestsJSONDecodeError(e.msg, e.doc, e.pos) + + try: + return complexjson.loads(self.text, **kwargs) + except JSONDecodeError as e: + # Catch JSON-related errors and raise as requests.JSONDecodeError + # This aliases json.JSONDecodeError and simplejson.JSONDecodeError + raise RequestsJSONDecodeError(e.msg, e.doc, e.pos) + + @property + def links(self): + """Returns the parsed header links of the response, if any.""" + + header = self.headers.get("link") + + resolved_links = {} + + if header: + links = parse_header_links(header) + + for link in links: + key = link.get("rel") or link.get("url") + resolved_links[key] = link + + return resolved_links + + def raise_for_status(self): + """Raises :class:`HTTPError`, if one occurred.""" + + http_error_msg = "" + if isinstance(self.reason, bytes): + # We attempt to decode utf-8 first because some servers + # choose to localize their reason strings. If the string + # isn't utf-8, we fall back to iso-8859-1 for all other + # encodings. (See PR #3538) + try: + reason = self.reason.decode("utf-8") + except UnicodeDecodeError: + reason = self.reason.decode("iso-8859-1") + else: + reason = self.reason + + if 400 <= self.status_code < 500: + http_error_msg = ( + f"{self.status_code} Client Error: {reason} for url: {self.url}" + ) + + elif 500 <= self.status_code < 600: + http_error_msg = ( + f"{self.status_code} Server Error: {reason} for url: {self.url}" + ) + + if http_error_msg: + raise HTTPError(http_error_msg, response=self) + + def close(self): + """Releases the connection back to the pool. Once this method has been + called the underlying ``raw`` object must not be accessed again. + + *Note: Should not normally need to be called explicitly.* + """ + if not self._content_consumed: + self.raw.close() + + release_conn = getattr(self.raw, "release_conn", None) + if release_conn is not None: + release_conn() diff --git a/.venv/lib/python3.12/site-packages/requests/packages.py b/.venv/lib/python3.12/site-packages/requests/packages.py new file mode 100644 index 0000000..5ab3d8e --- /dev/null +++ b/.venv/lib/python3.12/site-packages/requests/packages.py @@ -0,0 +1,23 @@ +import sys + +from .compat import chardet + +# This code exists for backwards compatibility reasons. +# I don't like it either. Just look the other way. :) + +for package in ("urllib3", "idna"): + locals()[package] = __import__(package) + # This traversal is apparently necessary such that the identities are + # preserved (requests.packages.urllib3.* is urllib3.*) + for mod in list(sys.modules): + if mod == package or mod.startswith(f"{package}."): + sys.modules[f"requests.packages.{mod}"] = sys.modules[mod] + +if chardet is not None: + target = chardet.__name__ + for mod in list(sys.modules): + if mod == target or mod.startswith(f"{target}."): + imported_mod = sys.modules[mod] + sys.modules[f"requests.packages.{mod}"] = imported_mod + mod = mod.replace(target, "chardet") + sys.modules[f"requests.packages.{mod}"] = imported_mod diff --git a/.venv/lib/python3.12/site-packages/requests/sessions.py b/.venv/lib/python3.12/site-packages/requests/sessions.py new file mode 100644 index 0000000..b387bc3 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/requests/sessions.py @@ -0,0 +1,831 @@ +""" +requests.sessions +~~~~~~~~~~~~~~~~~ + +This module provides a Session object to manage and persist settings across +requests (cookies, auth, proxies). +""" +import os +import sys +import time +from collections import OrderedDict +from datetime import timedelta + +from ._internal_utils import to_native_string +from .adapters import HTTPAdapter +from .auth import _basic_auth_str +from .compat import Mapping, cookielib, urljoin, urlparse +from .cookies import ( + RequestsCookieJar, + cookiejar_from_dict, + extract_cookies_to_jar, + merge_cookies, +) +from .exceptions import ( + ChunkedEncodingError, + ContentDecodingError, + InvalidSchema, + TooManyRedirects, +) +from .hooks import default_hooks, dispatch_hook + +# formerly defined here, reexposed here for backward compatibility +from .models import ( # noqa: F401 + DEFAULT_REDIRECT_LIMIT, + REDIRECT_STATI, + PreparedRequest, + Request, +) +from .status_codes import codes +from .structures import CaseInsensitiveDict +from .utils import ( # noqa: F401 + DEFAULT_PORTS, + default_headers, + get_auth_from_url, + get_environ_proxies, + get_netrc_auth, + requote_uri, + resolve_proxies, + rewind_body, + should_bypass_proxies, + to_key_val_list, +) + +# Preferred clock, based on which one is more accurate on a given system. +if sys.platform == "win32": + preferred_clock = time.perf_counter +else: + preferred_clock = time.time + + +def merge_setting(request_setting, session_setting, dict_class=OrderedDict): + """Determines appropriate setting for a given request, taking into account + the explicit setting on that request, and the setting in the session. If a + setting is a dictionary, they will be merged together using `dict_class` + """ + + if session_setting is None: + return request_setting + + if request_setting is None: + return session_setting + + # Bypass if not a dictionary (e.g. verify) + if not ( + isinstance(session_setting, Mapping) and isinstance(request_setting, Mapping) + ): + return request_setting + + merged_setting = dict_class(to_key_val_list(session_setting)) + merged_setting.update(to_key_val_list(request_setting)) + + # Remove keys that are set to None. Extract keys first to avoid altering + # the dictionary during iteration. + none_keys = [k for (k, v) in merged_setting.items() if v is None] + for key in none_keys: + del merged_setting[key] + + return merged_setting + + +def merge_hooks(request_hooks, session_hooks, dict_class=OrderedDict): + """Properly merges both requests and session hooks. + + This is necessary because when request_hooks == {'response': []}, the + merge breaks Session hooks entirely. + """ + if session_hooks is None or session_hooks.get("response") == []: + return request_hooks + + if request_hooks is None or request_hooks.get("response") == []: + return session_hooks + + return merge_setting(request_hooks, session_hooks, dict_class) + + +class SessionRedirectMixin: + def get_redirect_target(self, resp): + """Receives a Response. Returns a redirect URI or ``None``""" + # Due to the nature of how requests processes redirects this method will + # be called at least once upon the original response and at least twice + # on each subsequent redirect response (if any). + # If a custom mixin is used to handle this logic, it may be advantageous + # to cache the redirect location onto the response object as a private + # attribute. + if resp.is_redirect: + location = resp.headers["location"] + # Currently the underlying http module on py3 decode headers + # in latin1, but empirical evidence suggests that latin1 is very + # rarely used with non-ASCII characters in HTTP headers. + # It is more likely to get UTF8 header rather than latin1. + # This causes incorrect handling of UTF8 encoded location headers. + # To solve this, we re-encode the location in latin1. + location = location.encode("latin1") + return to_native_string(location, "utf8") + return None + + def should_strip_auth(self, old_url, new_url): + """Decide whether Authorization header should be removed when redirecting""" + old_parsed = urlparse(old_url) + new_parsed = urlparse(new_url) + if old_parsed.hostname != new_parsed.hostname: + return True + # Special case: allow http -> https redirect when using the standard + # ports. This isn't specified by RFC 7235, but is kept to avoid + # breaking backwards compatibility with older versions of requests + # that allowed any redirects on the same host. + if ( + old_parsed.scheme == "http" + and old_parsed.port in (80, None) + and new_parsed.scheme == "https" + and new_parsed.port in (443, None) + ): + return False + + # Handle default port usage corresponding to scheme. + changed_port = old_parsed.port != new_parsed.port + changed_scheme = old_parsed.scheme != new_parsed.scheme + default_port = (DEFAULT_PORTS.get(old_parsed.scheme, None), None) + if ( + not changed_scheme + and old_parsed.port in default_port + and new_parsed.port in default_port + ): + return False + + # Standard case: root URI must match + return changed_port or changed_scheme + + def resolve_redirects( + self, + resp, + req, + stream=False, + timeout=None, + verify=True, + cert=None, + proxies=None, + yield_requests=False, + **adapter_kwargs, + ): + """Receives a Response. Returns a generator of Responses or Requests.""" + + hist = [] # keep track of history + + url = self.get_redirect_target(resp) + previous_fragment = urlparse(req.url).fragment + while url: + prepared_request = req.copy() + + # Update history and keep track of redirects. + # resp.history must ignore the original request in this loop + hist.append(resp) + resp.history = hist[1:] + + try: + resp.content # Consume socket so it can be released + except (ChunkedEncodingError, ContentDecodingError, RuntimeError): + resp.raw.read(decode_content=False) + + if len(resp.history) >= self.max_redirects: + raise TooManyRedirects( + f"Exceeded {self.max_redirects} redirects.", response=resp + ) + + # Release the connection back into the pool. + resp.close() + + # Handle redirection without scheme (see: RFC 1808 Section 4) + if url.startswith("//"): + parsed_rurl = urlparse(resp.url) + url = ":".join([to_native_string(parsed_rurl.scheme), url]) + + # Normalize url case and attach previous fragment if needed (RFC 7231 7.1.2) + parsed = urlparse(url) + if parsed.fragment == "" and previous_fragment: + parsed = parsed._replace(fragment=previous_fragment) + elif parsed.fragment: + previous_fragment = parsed.fragment + url = parsed.geturl() + + # Facilitate relative 'location' headers, as allowed by RFC 7231. + # (e.g. '/path/to/resource' instead of 'http://domain.tld/path/to/resource') + # Compliant with RFC3986, we percent encode the url. + if not parsed.netloc: + url = urljoin(resp.url, requote_uri(url)) + else: + url = requote_uri(url) + + prepared_request.url = to_native_string(url) + + self.rebuild_method(prepared_request, resp) + + # https://github.com/psf/requests/issues/1084 + if resp.status_code not in ( + codes.temporary_redirect, + codes.permanent_redirect, + ): + # https://github.com/psf/requests/issues/3490 + purged_headers = ("Content-Length", "Content-Type", "Transfer-Encoding") + for header in purged_headers: + prepared_request.headers.pop(header, None) + prepared_request.body = None + + headers = prepared_request.headers + headers.pop("Cookie", None) + + # Extract any cookies sent on the response to the cookiejar + # in the new request. Because we've mutated our copied prepared + # request, use the old one that we haven't yet touched. + extract_cookies_to_jar(prepared_request._cookies, req, resp.raw) + merge_cookies(prepared_request._cookies, self.cookies) + prepared_request.prepare_cookies(prepared_request._cookies) + + # Rebuild auth and proxy information. + proxies = self.rebuild_proxies(prepared_request, proxies) + self.rebuild_auth(prepared_request, resp) + + # A failed tell() sets `_body_position` to `object()`. This non-None + # value ensures `rewindable` will be True, allowing us to raise an + # UnrewindableBodyError, instead of hanging the connection. + rewindable = prepared_request._body_position is not None and ( + "Content-Length" in headers or "Transfer-Encoding" in headers + ) + + # Attempt to rewind consumed file-like object. + if rewindable: + rewind_body(prepared_request) + + # Override the original request. + req = prepared_request + + if yield_requests: + yield req + else: + resp = self.send( + req, + stream=stream, + timeout=timeout, + verify=verify, + cert=cert, + proxies=proxies, + allow_redirects=False, + **adapter_kwargs, + ) + + extract_cookies_to_jar(self.cookies, prepared_request, resp.raw) + + # extract redirect url, if any, for the next loop + url = self.get_redirect_target(resp) + yield resp + + def rebuild_auth(self, prepared_request, response): + """When being redirected we may want to strip authentication from the + request to avoid leaking credentials. This method intelligently removes + and reapplies authentication where possible to avoid credential loss. + """ + headers = prepared_request.headers + url = prepared_request.url + + if "Authorization" in headers and self.should_strip_auth( + response.request.url, url + ): + # If we get redirected to a new host, we should strip out any + # authentication headers. + del headers["Authorization"] + + # .netrc might have more auth for us on our new host. + new_auth = get_netrc_auth(url) if self.trust_env else None + if new_auth is not None: + prepared_request.prepare_auth(new_auth) + + def rebuild_proxies(self, prepared_request, proxies): + """This method re-evaluates the proxy configuration by considering the + environment variables. If we are redirected to a URL covered by + NO_PROXY, we strip the proxy configuration. Otherwise, we set missing + proxy keys for this URL (in case they were stripped by a previous + redirect). + + This method also replaces the Proxy-Authorization header where + necessary. + + :rtype: dict + """ + headers = prepared_request.headers + scheme = urlparse(prepared_request.url).scheme + new_proxies = resolve_proxies(prepared_request, proxies, self.trust_env) + + if "Proxy-Authorization" in headers: + del headers["Proxy-Authorization"] + + try: + username, password = get_auth_from_url(new_proxies[scheme]) + except KeyError: + username, password = None, None + + # urllib3 handles proxy authorization for us in the standard adapter. + # Avoid appending this to TLS tunneled requests where it may be leaked. + if not scheme.startswith("https") and username and password: + headers["Proxy-Authorization"] = _basic_auth_str(username, password) + + return new_proxies + + def rebuild_method(self, prepared_request, response): + """When being redirected we may want to change the method of the request + based on certain specs or browser behavior. + """ + method = prepared_request.method + + # https://tools.ietf.org/html/rfc7231#section-6.4.4 + if response.status_code == codes.see_other and method != "HEAD": + method = "GET" + + # Do what the browsers do, despite standards... + # First, turn 302s into GETs. + if response.status_code == codes.found and method != "HEAD": + method = "GET" + + # Second, if a POST is responded to with a 301, turn it into a GET. + # This bizarre behaviour is explained in Issue 1704. + if response.status_code == codes.moved and method == "POST": + method = "GET" + + prepared_request.method = method + + +class Session(SessionRedirectMixin): + """A Requests session. + + Provides cookie persistence, connection-pooling, and configuration. + + Basic Usage:: + + >>> import requests + >>> s = requests.Session() + >>> s.get('https://httpbin.org/get') + + + Or as a context manager:: + + >>> with requests.Session() as s: + ... s.get('https://httpbin.org/get') + + """ + + __attrs__ = [ + "headers", + "cookies", + "auth", + "proxies", + "hooks", + "params", + "verify", + "cert", + "adapters", + "stream", + "trust_env", + "max_redirects", + ] + + def __init__(self): + #: A case-insensitive dictionary of headers to be sent on each + #: :class:`Request ` sent from this + #: :class:`Session `. + self.headers = default_headers() + + #: Default Authentication tuple or object to attach to + #: :class:`Request `. + self.auth = None + + #: Dictionary mapping protocol or protocol and host to the URL of the proxy + #: (e.g. {'http': 'foo.bar:3128', 'http://host.name': 'foo.bar:4012'}) to + #: be used on each :class:`Request `. + self.proxies = {} + + #: Event-handling hooks. + self.hooks = default_hooks() + + #: Dictionary of querystring data to attach to each + #: :class:`Request `. The dictionary values may be lists for + #: representing multivalued query parameters. + self.params = {} + + #: Stream response content default. + self.stream = False + + #: SSL Verification default. + #: Defaults to `True`, requiring requests to verify the TLS certificate at the + #: remote end. + #: If verify is set to `False`, requests will accept any TLS certificate + #: presented by the server, and will ignore hostname mismatches and/or + #: expired certificates, which will make your application vulnerable to + #: man-in-the-middle (MitM) attacks. + #: Only set this to `False` for testing. + self.verify = True + + #: SSL client certificate default, if String, path to ssl client + #: cert file (.pem). If Tuple, ('cert', 'key') pair. + self.cert = None + + #: Maximum number of redirects allowed. If the request exceeds this + #: limit, a :class:`TooManyRedirects` exception is raised. + #: This defaults to requests.models.DEFAULT_REDIRECT_LIMIT, which is + #: 30. + self.max_redirects = DEFAULT_REDIRECT_LIMIT + + #: Trust environment settings for proxy configuration, default + #: authentication and similar. + self.trust_env = True + + #: A CookieJar containing all currently outstanding cookies set on this + #: session. By default it is a + #: :class:`RequestsCookieJar `, but + #: may be any other ``cookielib.CookieJar`` compatible object. + self.cookies = cookiejar_from_dict({}) + + # Default connection adapters. + self.adapters = OrderedDict() + self.mount("https://", HTTPAdapter()) + self.mount("http://", HTTPAdapter()) + + def __enter__(self): + return self + + def __exit__(self, *args): + self.close() + + def prepare_request(self, request): + """Constructs a :class:`PreparedRequest ` for + transmission and returns it. The :class:`PreparedRequest` has settings + merged from the :class:`Request ` instance and those of the + :class:`Session`. + + :param request: :class:`Request` instance to prepare with this + session's settings. + :rtype: requests.PreparedRequest + """ + cookies = request.cookies or {} + + # Bootstrap CookieJar. + if not isinstance(cookies, cookielib.CookieJar): + cookies = cookiejar_from_dict(cookies) + + # Merge with session cookies + merged_cookies = merge_cookies( + merge_cookies(RequestsCookieJar(), self.cookies), cookies + ) + + # Set environment's basic authentication if not explicitly set. + auth = request.auth + if self.trust_env and not auth and not self.auth: + auth = get_netrc_auth(request.url) + + p = PreparedRequest() + p.prepare( + method=request.method.upper(), + url=request.url, + files=request.files, + data=request.data, + json=request.json, + headers=merge_setting( + request.headers, self.headers, dict_class=CaseInsensitiveDict + ), + params=merge_setting(request.params, self.params), + auth=merge_setting(auth, self.auth), + cookies=merged_cookies, + hooks=merge_hooks(request.hooks, self.hooks), + ) + return p + + def request( + self, + method, + url, + params=None, + data=None, + headers=None, + cookies=None, + files=None, + auth=None, + timeout=None, + allow_redirects=True, + proxies=None, + hooks=None, + stream=None, + verify=None, + cert=None, + json=None, + ): + """Constructs a :class:`Request `, prepares it and sends it. + Returns :class:`Response ` object. + + :param method: method for the new :class:`Request` object. + :param url: URL for the new :class:`Request` object. + :param params: (optional) Dictionary or bytes to be sent in the query + string for the :class:`Request`. + :param data: (optional) Dictionary, list of tuples, bytes, or file-like + object to send in the body of the :class:`Request`. + :param json: (optional) json to send in the body of the + :class:`Request`. + :param headers: (optional) Dictionary of HTTP Headers to send with the + :class:`Request`. + :param cookies: (optional) Dict or CookieJar object to send with the + :class:`Request`. + :param files: (optional) Dictionary of ``'filename': file-like-objects`` + for multipart encoding upload. + :param auth: (optional) Auth tuple or callable to enable + Basic/Digest/Custom HTTP Auth. + :param timeout: (optional) How long to wait for the server to send + data before giving up, as a float, or a :ref:`(connect timeout, + read timeout) ` tuple. + :type timeout: float or tuple + :param allow_redirects: (optional) Set to True by default. + :type allow_redirects: bool + :param proxies: (optional) Dictionary mapping protocol or protocol and + hostname to the URL of the proxy. + :param hooks: (optional) Dictionary mapping hook name to one event or + list of events, event must be callable. + :param stream: (optional) whether to immediately download the response + content. Defaults to ``False``. + :param verify: (optional) Either a boolean, in which case it controls whether we verify + the server's TLS certificate, or a string, in which case it must be a path + to a CA bundle to use. Defaults to ``True``. When set to + ``False``, requests will accept any TLS certificate presented by + the server, and will ignore hostname mismatches and/or expired + certificates, which will make your application vulnerable to + man-in-the-middle (MitM) attacks. Setting verify to ``False`` + may be useful during local development or testing. + :param cert: (optional) if String, path to ssl client cert file (.pem). + If Tuple, ('cert', 'key') pair. + :rtype: requests.Response + """ + # Create the Request. + req = Request( + method=method.upper(), + url=url, + headers=headers, + files=files, + data=data or {}, + json=json, + params=params or {}, + auth=auth, + cookies=cookies, + hooks=hooks, + ) + prep = self.prepare_request(req) + + proxies = proxies or {} + + settings = self.merge_environment_settings( + prep.url, proxies, stream, verify, cert + ) + + # Send the request. + send_kwargs = { + "timeout": timeout, + "allow_redirects": allow_redirects, + } + send_kwargs.update(settings) + resp = self.send(prep, **send_kwargs) + + return resp + + def get(self, url, **kwargs): + r"""Sends a GET request. Returns :class:`Response` object. + + :param url: URL for the new :class:`Request` object. + :param \*\*kwargs: Optional arguments that ``request`` takes. + :rtype: requests.Response + """ + + kwargs.setdefault("allow_redirects", True) + return self.request("GET", url, **kwargs) + + def options(self, url, **kwargs): + r"""Sends a OPTIONS request. Returns :class:`Response` object. + + :param url: URL for the new :class:`Request` object. + :param \*\*kwargs: Optional arguments that ``request`` takes. + :rtype: requests.Response + """ + + kwargs.setdefault("allow_redirects", True) + return self.request("OPTIONS", url, **kwargs) + + def head(self, url, **kwargs): + r"""Sends a HEAD request. Returns :class:`Response` object. + + :param url: URL for the new :class:`Request` object. + :param \*\*kwargs: Optional arguments that ``request`` takes. + :rtype: requests.Response + """ + + kwargs.setdefault("allow_redirects", False) + return self.request("HEAD", url, **kwargs) + + def post(self, url, data=None, json=None, **kwargs): + r"""Sends a POST request. Returns :class:`Response` object. + + :param url: URL for the new :class:`Request` object. + :param data: (optional) Dictionary, list of tuples, bytes, or file-like + object to send in the body of the :class:`Request`. + :param json: (optional) json to send in the body of the :class:`Request`. + :param \*\*kwargs: Optional arguments that ``request`` takes. + :rtype: requests.Response + """ + + return self.request("POST", url, data=data, json=json, **kwargs) + + def put(self, url, data=None, **kwargs): + r"""Sends a PUT request. Returns :class:`Response` object. + + :param url: URL for the new :class:`Request` object. + :param data: (optional) Dictionary, list of tuples, bytes, or file-like + object to send in the body of the :class:`Request`. + :param \*\*kwargs: Optional arguments that ``request`` takes. + :rtype: requests.Response + """ + + return self.request("PUT", url, data=data, **kwargs) + + def patch(self, url, data=None, **kwargs): + r"""Sends a PATCH request. Returns :class:`Response` object. + + :param url: URL for the new :class:`Request` object. + :param data: (optional) Dictionary, list of tuples, bytes, or file-like + object to send in the body of the :class:`Request`. + :param \*\*kwargs: Optional arguments that ``request`` takes. + :rtype: requests.Response + """ + + return self.request("PATCH", url, data=data, **kwargs) + + def delete(self, url, **kwargs): + r"""Sends a DELETE request. Returns :class:`Response` object. + + :param url: URL for the new :class:`Request` object. + :param \*\*kwargs: Optional arguments that ``request`` takes. + :rtype: requests.Response + """ + + return self.request("DELETE", url, **kwargs) + + def send(self, request, **kwargs): + """Send a given PreparedRequest. + + :rtype: requests.Response + """ + # Set defaults that the hooks can utilize to ensure they always have + # the correct parameters to reproduce the previous request. + kwargs.setdefault("stream", self.stream) + kwargs.setdefault("verify", self.verify) + kwargs.setdefault("cert", self.cert) + if "proxies" not in kwargs: + kwargs["proxies"] = resolve_proxies(request, self.proxies, self.trust_env) + + # It's possible that users might accidentally send a Request object. + # Guard against that specific failure case. + if isinstance(request, Request): + raise ValueError("You can only send PreparedRequests.") + + # Set up variables needed for resolve_redirects and dispatching of hooks + allow_redirects = kwargs.pop("allow_redirects", True) + stream = kwargs.get("stream") + hooks = request.hooks + + # Get the appropriate adapter to use + adapter = self.get_adapter(url=request.url) + + # Start time (approximately) of the request + start = preferred_clock() + + # Send the request + r = adapter.send(request, **kwargs) + + # Total elapsed time of the request (approximately) + elapsed = preferred_clock() - start + r.elapsed = timedelta(seconds=elapsed) + + # Response manipulation hooks + r = dispatch_hook("response", hooks, r, **kwargs) + + # Persist cookies + if r.history: + # If the hooks create history then we want those cookies too + for resp in r.history: + extract_cookies_to_jar(self.cookies, resp.request, resp.raw) + + extract_cookies_to_jar(self.cookies, request, r.raw) + + # Resolve redirects if allowed. + if allow_redirects: + # Redirect resolving generator. + gen = self.resolve_redirects(r, request, **kwargs) + history = [resp for resp in gen] + else: + history = [] + + # Shuffle things around if there's history. + if history: + # Insert the first (original) request at the start + history.insert(0, r) + # Get the last request made + r = history.pop() + r.history = history + + # If redirects aren't being followed, store the response on the Request for Response.next(). + if not allow_redirects: + try: + r._next = next( + self.resolve_redirects(r, request, yield_requests=True, **kwargs) + ) + except StopIteration: + pass + + if not stream: + r.content + + return r + + def merge_environment_settings(self, url, proxies, stream, verify, cert): + """ + Check the environment and merge it with some settings. + + :rtype: dict + """ + # Gather clues from the surrounding environment. + if self.trust_env: + # Set environment's proxies. + no_proxy = proxies.get("no_proxy") if proxies is not None else None + env_proxies = get_environ_proxies(url, no_proxy=no_proxy) + for k, v in env_proxies.items(): + proxies.setdefault(k, v) + + # Look for requests environment configuration + # and be compatible with cURL. + if verify is True or verify is None: + verify = ( + os.environ.get("REQUESTS_CA_BUNDLE") + or os.environ.get("CURL_CA_BUNDLE") + or verify + ) + + # Merge all the kwargs. + proxies = merge_setting(proxies, self.proxies) + stream = merge_setting(stream, self.stream) + verify = merge_setting(verify, self.verify) + cert = merge_setting(cert, self.cert) + + return {"proxies": proxies, "stream": stream, "verify": verify, "cert": cert} + + def get_adapter(self, url): + """ + Returns the appropriate connection adapter for the given URL. + + :rtype: requests.adapters.BaseAdapter + """ + for prefix, adapter in self.adapters.items(): + if url.lower().startswith(prefix.lower()): + return adapter + + # Nothing matches :-/ + raise InvalidSchema(f"No connection adapters were found for {url!r}") + + def close(self): + """Closes all adapters and as such the session""" + for v in self.adapters.values(): + v.close() + + def mount(self, prefix, adapter): + """Registers a connection adapter to a prefix. + + Adapters are sorted in descending order by prefix length. + """ + self.adapters[prefix] = adapter + keys_to_move = [k for k in self.adapters if len(k) < len(prefix)] + + for key in keys_to_move: + self.adapters[key] = self.adapters.pop(key) + + def __getstate__(self): + state = {attr: getattr(self, attr, None) for attr in self.__attrs__} + return state + + def __setstate__(self, state): + for attr, value in state.items(): + setattr(self, attr, value) + + +def session(): + """ + Returns a :class:`Session` for context-management. + + .. deprecated:: 1.0.0 + + This method has been deprecated since version 1.0.0 and is only kept for + backwards compatibility. New code should use :class:`~requests.sessions.Session` + to create a session. This may be removed at a future date. + + :rtype: Session + """ + return Session() diff --git a/.venv/lib/python3.12/site-packages/requests/status_codes.py b/.venv/lib/python3.12/site-packages/requests/status_codes.py new file mode 100644 index 0000000..c7945a2 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/requests/status_codes.py @@ -0,0 +1,128 @@ +r""" +The ``codes`` object defines a mapping from common names for HTTP statuses +to their numerical codes, accessible either as attributes or as dictionary +items. + +Example:: + + >>> import requests + >>> requests.codes['temporary_redirect'] + 307 + >>> requests.codes.teapot + 418 + >>> requests.codes['\o/'] + 200 + +Some codes have multiple names, and both upper- and lower-case versions of +the names are allowed. For example, ``codes.ok``, ``codes.OK``, and +``codes.okay`` all correspond to the HTTP status code 200. +""" + +from .structures import LookupDict + +_codes = { + # Informational. + 100: ("continue",), + 101: ("switching_protocols",), + 102: ("processing", "early-hints"), + 103: ("checkpoint",), + 122: ("uri_too_long", "request_uri_too_long"), + 200: ("ok", "okay", "all_ok", "all_okay", "all_good", "\\o/", "✓"), + 201: ("created",), + 202: ("accepted",), + 203: ("non_authoritative_info", "non_authoritative_information"), + 204: ("no_content",), + 205: ("reset_content", "reset"), + 206: ("partial_content", "partial"), + 207: ("multi_status", "multiple_status", "multi_stati", "multiple_stati"), + 208: ("already_reported",), + 226: ("im_used",), + # Redirection. + 300: ("multiple_choices",), + 301: ("moved_permanently", "moved", "\\o-"), + 302: ("found",), + 303: ("see_other", "other"), + 304: ("not_modified",), + 305: ("use_proxy",), + 306: ("switch_proxy",), + 307: ("temporary_redirect", "temporary_moved", "temporary"), + 308: ( + "permanent_redirect", + "resume_incomplete", + "resume", + ), # "resume" and "resume_incomplete" to be removed in 3.0 + # Client Error. + 400: ("bad_request", "bad"), + 401: ("unauthorized",), + 402: ("payment_required", "payment"), + 403: ("forbidden",), + 404: ("not_found", "-o-"), + 405: ("method_not_allowed", "not_allowed"), + 406: ("not_acceptable",), + 407: ("proxy_authentication_required", "proxy_auth", "proxy_authentication"), + 408: ("request_timeout", "timeout"), + 409: ("conflict",), + 410: ("gone",), + 411: ("length_required",), + 412: ("precondition_failed", "precondition"), + 413: ("request_entity_too_large", "content_too_large"), + 414: ("request_uri_too_large", "uri_too_long"), + 415: ("unsupported_media_type", "unsupported_media", "media_type"), + 416: ( + "requested_range_not_satisfiable", + "requested_range", + "range_not_satisfiable", + ), + 417: ("expectation_failed",), + 418: ("im_a_teapot", "teapot", "i_am_a_teapot"), + 421: ("misdirected_request",), + 422: ("unprocessable_entity", "unprocessable", "unprocessable_content"), + 423: ("locked",), + 424: ("failed_dependency", "dependency"), + 425: ("unordered_collection", "unordered", "too_early"), + 426: ("upgrade_required", "upgrade"), + 428: ("precondition_required", "precondition"), + 429: ("too_many_requests", "too_many"), + 431: ("header_fields_too_large", "fields_too_large"), + 444: ("no_response", "none"), + 449: ("retry_with", "retry"), + 450: ("blocked_by_windows_parental_controls", "parental_controls"), + 451: ("unavailable_for_legal_reasons", "legal_reasons"), + 499: ("client_closed_request",), + # Server Error. + 500: ("internal_server_error", "server_error", "/o\\", "✗"), + 501: ("not_implemented",), + 502: ("bad_gateway",), + 503: ("service_unavailable", "unavailable"), + 504: ("gateway_timeout",), + 505: ("http_version_not_supported", "http_version"), + 506: ("variant_also_negotiates",), + 507: ("insufficient_storage",), + 509: ("bandwidth_limit_exceeded", "bandwidth"), + 510: ("not_extended",), + 511: ("network_authentication_required", "network_auth", "network_authentication"), +} + +codes = LookupDict(name="status_codes") + + +def _init(): + for code, titles in _codes.items(): + for title in titles: + setattr(codes, title, code) + if not title.startswith(("\\", "/")): + setattr(codes, title.upper(), code) + + def doc(code): + names = ", ".join(f"``{n}``" for n in _codes[code]) + return "* %d: %s" % (code, names) + + global __doc__ + __doc__ = ( + __doc__ + "\n" + "\n".join(doc(code) for code in sorted(_codes)) + if __doc__ is not None + else None + ) + + +_init() diff --git a/.venv/lib/python3.12/site-packages/requests/structures.py b/.venv/lib/python3.12/site-packages/requests/structures.py new file mode 100644 index 0000000..188e13e --- /dev/null +++ b/.venv/lib/python3.12/site-packages/requests/structures.py @@ -0,0 +1,99 @@ +""" +requests.structures +~~~~~~~~~~~~~~~~~~~ + +Data structures that power Requests. +""" + +from collections import OrderedDict + +from .compat import Mapping, MutableMapping + + +class CaseInsensitiveDict(MutableMapping): + """A case-insensitive ``dict``-like object. + + Implements all methods and operations of + ``MutableMapping`` as well as dict's ``copy``. Also + provides ``lower_items``. + + All keys are expected to be strings. The structure remembers the + case of the last key to be set, and ``iter(instance)``, + ``keys()``, ``items()``, ``iterkeys()``, and ``iteritems()`` + will contain case-sensitive keys. However, querying and contains + testing is case insensitive:: + + cid = CaseInsensitiveDict() + cid['Accept'] = 'application/json' + cid['aCCEPT'] == 'application/json' # True + list(cid) == ['Accept'] # True + + For example, ``headers['content-encoding']`` will return the + value of a ``'Content-Encoding'`` response header, regardless + of how the header name was originally stored. + + If the constructor, ``.update``, or equality comparison + operations are given keys that have equal ``.lower()``s, the + behavior is undefined. + """ + + def __init__(self, data=None, **kwargs): + self._store = OrderedDict() + if data is None: + data = {} + self.update(data, **kwargs) + + def __setitem__(self, key, value): + # Use the lowercased key for lookups, but store the actual + # key alongside the value. + self._store[key.lower()] = (key, value) + + def __getitem__(self, key): + return self._store[key.lower()][1] + + def __delitem__(self, key): + del self._store[key.lower()] + + def __iter__(self): + return (casedkey for casedkey, mappedvalue in self._store.values()) + + def __len__(self): + return len(self._store) + + def lower_items(self): + """Like iteritems(), but with all lowercase keys.""" + return ((lowerkey, keyval[1]) for (lowerkey, keyval) in self._store.items()) + + def __eq__(self, other): + if isinstance(other, Mapping): + other = CaseInsensitiveDict(other) + else: + return NotImplemented + # Compare insensitively + return dict(self.lower_items()) == dict(other.lower_items()) + + # Copy is required + def copy(self): + return CaseInsensitiveDict(self._store.values()) + + def __repr__(self): + return str(dict(self.items())) + + +class LookupDict(dict): + """Dictionary lookup object.""" + + def __init__(self, name=None): + self.name = name + super().__init__() + + def __repr__(self): + return f"" + + def __getitem__(self, key): + # We allow fall-through here, so values default to None + + return self.__dict__.get(key, None) + + def get(self, key, default=None): + return self.__dict__.get(key, default) diff --git a/.venv/lib/python3.12/site-packages/requests/utils.py b/.venv/lib/python3.12/site-packages/requests/utils.py new file mode 100644 index 0000000..ae6c42f --- /dev/null +++ b/.venv/lib/python3.12/site-packages/requests/utils.py @@ -0,0 +1,1096 @@ +""" +requests.utils +~~~~~~~~~~~~~~ + +This module provides utility functions that are used within Requests +that are also useful for external consumption. +""" + +import codecs +import contextlib +import io +import os +import re +import socket +import struct +import sys +import tempfile +import warnings +import zipfile +from collections import OrderedDict + +from urllib3.util import make_headers, parse_url + +from . import certs +from .__version__ import __version__ + +# to_native_string is unused here, but imported here for backwards compatibility +from ._internal_utils import ( # noqa: F401 + _HEADER_VALIDATORS_BYTE, + _HEADER_VALIDATORS_STR, + HEADER_VALIDATORS, + to_native_string, +) +from .compat import ( + Mapping, + basestring, + bytes, + getproxies, + getproxies_environment, + integer_types, +) +from .compat import parse_http_list as _parse_list_header +from .compat import ( + proxy_bypass, + proxy_bypass_environment, + quote, + str, + unquote, + urlparse, + urlunparse, +) +from .cookies import cookiejar_from_dict +from .exceptions import ( + FileModeWarning, + InvalidHeader, + InvalidURL, + UnrewindableBodyError, +) +from .structures import CaseInsensitiveDict + +NETRC_FILES = (".netrc", "_netrc") + +DEFAULT_CA_BUNDLE_PATH = certs.where() + +DEFAULT_PORTS = {"http": 80, "https": 443} + +# Ensure that ', ' is used to preserve previous delimiter behavior. +DEFAULT_ACCEPT_ENCODING = ", ".join( + re.split(r",\s*", make_headers(accept_encoding=True)["accept-encoding"]) +) + + +if sys.platform == "win32": + # provide a proxy_bypass version on Windows without DNS lookups + + def proxy_bypass_registry(host): + try: + import winreg + except ImportError: + return False + + try: + internetSettings = winreg.OpenKey( + winreg.HKEY_CURRENT_USER, + r"Software\Microsoft\Windows\CurrentVersion\Internet Settings", + ) + # ProxyEnable could be REG_SZ or REG_DWORD, normalizing it + proxyEnable = int(winreg.QueryValueEx(internetSettings, "ProxyEnable")[0]) + # ProxyOverride is almost always a string + proxyOverride = winreg.QueryValueEx(internetSettings, "ProxyOverride")[0] + except (OSError, ValueError): + return False + if not proxyEnable or not proxyOverride: + return False + + # make a check value list from the registry entry: replace the + # '' string by the localhost entry and the corresponding + # canonical entry. + proxyOverride = proxyOverride.split(";") + # filter out empty strings to avoid re.match return true in the following code. + proxyOverride = filter(None, proxyOverride) + # now check if we match one of the registry values. + for test in proxyOverride: + if test == "": + if "." not in host: + return True + test = test.replace(".", r"\.") # mask dots + test = test.replace("*", r".*") # change glob sequence + test = test.replace("?", r".") # change glob char + if re.match(test, host, re.I): + return True + return False + + def proxy_bypass(host): # noqa + """Return True, if the host should be bypassed. + + Checks proxy settings gathered from the environment, if specified, + or the registry. + """ + if getproxies_environment(): + return proxy_bypass_environment(host) + else: + return proxy_bypass_registry(host) + + +def dict_to_sequence(d): + """Returns an internal sequence dictionary update.""" + + if hasattr(d, "items"): + d = d.items() + + return d + + +def super_len(o): + total_length = None + current_position = 0 + + if isinstance(o, str): + o = o.encode("utf-8") + + if hasattr(o, "__len__"): + total_length = len(o) + + elif hasattr(o, "len"): + total_length = o.len + + elif hasattr(o, "fileno"): + try: + fileno = o.fileno() + except (io.UnsupportedOperation, AttributeError): + # AttributeError is a surprising exception, seeing as how we've just checked + # that `hasattr(o, 'fileno')`. It happens for objects obtained via + # `Tarfile.extractfile()`, per issue 5229. + pass + else: + total_length = os.fstat(fileno).st_size + + # Having used fstat to determine the file length, we need to + # confirm that this file was opened up in binary mode. + if "b" not in o.mode: + warnings.warn( + ( + "Requests has determined the content-length for this " + "request using the binary size of the file: however, the " + "file has been opened in text mode (i.e. without the 'b' " + "flag in the mode). This may lead to an incorrect " + "content-length. In Requests 3.0, support will be removed " + "for files in text mode." + ), + FileModeWarning, + ) + + if hasattr(o, "tell"): + try: + current_position = o.tell() + except OSError: + # This can happen in some weird situations, such as when the file + # is actually a special file descriptor like stdin. In this + # instance, we don't know what the length is, so set it to zero and + # let requests chunk it instead. + if total_length is not None: + current_position = total_length + else: + if hasattr(o, "seek") and total_length is None: + # StringIO and BytesIO have seek but no usable fileno + try: + # seek to end of file + o.seek(0, 2) + total_length = o.tell() + + # seek back to current position to support + # partially read file-like objects + o.seek(current_position or 0) + except OSError: + total_length = 0 + + if total_length is None: + total_length = 0 + + return max(0, total_length - current_position) + + +def get_netrc_auth(url, raise_errors=False): + """Returns the Requests tuple auth for a given url from netrc.""" + + netrc_file = os.environ.get("NETRC") + if netrc_file is not None: + netrc_locations = (netrc_file,) + else: + netrc_locations = (f"~/{f}" for f in NETRC_FILES) + + try: + from netrc import NetrcParseError, netrc + + netrc_path = None + + for f in netrc_locations: + try: + loc = os.path.expanduser(f) + except KeyError: + # os.path.expanduser can fail when $HOME is undefined and + # getpwuid fails. See https://bugs.python.org/issue20164 & + # https://github.com/psf/requests/issues/1846 + return + + if os.path.exists(loc): + netrc_path = loc + break + + # Abort early if there isn't one. + if netrc_path is None: + return + + ri = urlparse(url) + + # Strip port numbers from netloc. This weird `if...encode`` dance is + # used for Python 3.2, which doesn't support unicode literals. + splitstr = b":" + if isinstance(url, str): + splitstr = splitstr.decode("ascii") + host = ri.netloc.split(splitstr)[0] + + try: + _netrc = netrc(netrc_path).authenticators(host) + if _netrc: + # Return with login / password + login_i = 0 if _netrc[0] else 1 + return (_netrc[login_i], _netrc[2]) + except (NetrcParseError, OSError): + # If there was a parsing error or a permissions issue reading the file, + # we'll just skip netrc auth unless explicitly asked to raise errors. + if raise_errors: + raise + + # App Engine hackiness. + except (ImportError, AttributeError): + pass + + +def guess_filename(obj): + """Tries to guess the filename of the given object.""" + name = getattr(obj, "name", None) + if name and isinstance(name, basestring) and name[0] != "<" and name[-1] != ">": + return os.path.basename(name) + + +def extract_zipped_paths(path): + """Replace nonexistent paths that look like they refer to a member of a zip + archive with the location of an extracted copy of the target, or else + just return the provided path unchanged. + """ + if os.path.exists(path): + # this is already a valid path, no need to do anything further + return path + + # find the first valid part of the provided path and treat that as a zip archive + # assume the rest of the path is the name of a member in the archive + archive, member = os.path.split(path) + while archive and not os.path.exists(archive): + archive, prefix = os.path.split(archive) + if not prefix: + # If we don't check for an empty prefix after the split (in other words, archive remains unchanged after the split), + # we _can_ end up in an infinite loop on a rare corner case affecting a small number of users + break + member = "/".join([prefix, member]) + + if not zipfile.is_zipfile(archive): + return path + + zip_file = zipfile.ZipFile(archive) + if member not in zip_file.namelist(): + return path + + # we have a valid zip archive and a valid member of that archive + tmp = tempfile.gettempdir() + extracted_path = os.path.join(tmp, member.split("/")[-1]) + if not os.path.exists(extracted_path): + # use read + write to avoid the creating nested folders, we only want the file, avoids mkdir racing condition + with atomic_open(extracted_path) as file_handler: + file_handler.write(zip_file.read(member)) + return extracted_path + + +@contextlib.contextmanager +def atomic_open(filename): + """Write a file to the disk in an atomic fashion""" + tmp_descriptor, tmp_name = tempfile.mkstemp(dir=os.path.dirname(filename)) + try: + with os.fdopen(tmp_descriptor, "wb") as tmp_handler: + yield tmp_handler + os.replace(tmp_name, filename) + except BaseException: + os.remove(tmp_name) + raise + + +def from_key_val_list(value): + """Take an object and test to see if it can be represented as a + dictionary. Unless it can not be represented as such, return an + OrderedDict, e.g., + + :: + + >>> from_key_val_list([('key', 'val')]) + OrderedDict([('key', 'val')]) + >>> from_key_val_list('string') + Traceback (most recent call last): + ... + ValueError: cannot encode objects that are not 2-tuples + >>> from_key_val_list({'key': 'val'}) + OrderedDict([('key', 'val')]) + + :rtype: OrderedDict + """ + if value is None: + return None + + if isinstance(value, (str, bytes, bool, int)): + raise ValueError("cannot encode objects that are not 2-tuples") + + return OrderedDict(value) + + +def to_key_val_list(value): + """Take an object and test to see if it can be represented as a + dictionary. If it can be, return a list of tuples, e.g., + + :: + + >>> to_key_val_list([('key', 'val')]) + [('key', 'val')] + >>> to_key_val_list({'key': 'val'}) + [('key', 'val')] + >>> to_key_val_list('string') + Traceback (most recent call last): + ... + ValueError: cannot encode objects that are not 2-tuples + + :rtype: list + """ + if value is None: + return None + + if isinstance(value, (str, bytes, bool, int)): + raise ValueError("cannot encode objects that are not 2-tuples") + + if isinstance(value, Mapping): + value = value.items() + + return list(value) + + +# From mitsuhiko/werkzeug (used with permission). +def parse_list_header(value): + """Parse lists as described by RFC 2068 Section 2. + + In particular, parse comma-separated lists where the elements of + the list may include quoted-strings. A quoted-string could + contain a comma. A non-quoted string could have quotes in the + middle. Quotes are removed automatically after parsing. + + It basically works like :func:`parse_set_header` just that items + may appear multiple times and case sensitivity is preserved. + + The return value is a standard :class:`list`: + + >>> parse_list_header('token, "quoted value"') + ['token', 'quoted value'] + + To create a header from the :class:`list` again, use the + :func:`dump_header` function. + + :param value: a string with a list header. + :return: :class:`list` + :rtype: list + """ + result = [] + for item in _parse_list_header(value): + if item[:1] == item[-1:] == '"': + item = unquote_header_value(item[1:-1]) + result.append(item) + return result + + +# From mitsuhiko/werkzeug (used with permission). +def parse_dict_header(value): + """Parse lists of key, value pairs as described by RFC 2068 Section 2 and + convert them into a python dict: + + >>> d = parse_dict_header('foo="is a fish", bar="as well"') + >>> type(d) is dict + True + >>> sorted(d.items()) + [('bar', 'as well'), ('foo', 'is a fish')] + + If there is no value for a key it will be `None`: + + >>> parse_dict_header('key_without_value') + {'key_without_value': None} + + To create a header from the :class:`dict` again, use the + :func:`dump_header` function. + + :param value: a string with a dict header. + :return: :class:`dict` + :rtype: dict + """ + result = {} + for item in _parse_list_header(value): + if "=" not in item: + result[item] = None + continue + name, value = item.split("=", 1) + if value[:1] == value[-1:] == '"': + value = unquote_header_value(value[1:-1]) + result[name] = value + return result + + +# From mitsuhiko/werkzeug (used with permission). +def unquote_header_value(value, is_filename=False): + r"""Unquotes a header value. (Reversal of :func:`quote_header_value`). + This does not use the real unquoting but what browsers are actually + using for quoting. + + :param value: the header value to unquote. + :rtype: str + """ + if value and value[0] == value[-1] == '"': + # this is not the real unquoting, but fixing this so that the + # RFC is met will result in bugs with internet explorer and + # probably some other browsers as well. IE for example is + # uploading files with "C:\foo\bar.txt" as filename + value = value[1:-1] + + # if this is a filename and the starting characters look like + # a UNC path, then just return the value without quotes. Using the + # replace sequence below on a UNC path has the effect of turning + # the leading double slash into a single slash and then + # _fix_ie_filename() doesn't work correctly. See #458. + if not is_filename or value[:2] != "\\\\": + return value.replace("\\\\", "\\").replace('\\"', '"') + return value + + +def dict_from_cookiejar(cj): + """Returns a key/value dictionary from a CookieJar. + + :param cj: CookieJar object to extract cookies from. + :rtype: dict + """ + + cookie_dict = {cookie.name: cookie.value for cookie in cj} + return cookie_dict + + +def add_dict_to_cookiejar(cj, cookie_dict): + """Returns a CookieJar from a key/value dictionary. + + :param cj: CookieJar to insert cookies into. + :param cookie_dict: Dict of key/values to insert into CookieJar. + :rtype: CookieJar + """ + + return cookiejar_from_dict(cookie_dict, cj) + + +def get_encodings_from_content(content): + """Returns encodings from given content string. + + :param content: bytestring to extract encodings from. + """ + warnings.warn( + ( + "In requests 3.0, get_encodings_from_content will be removed. For " + "more information, please see the discussion on issue #2266. (This" + " warning should only appear once.)" + ), + DeprecationWarning, + ) + + charset_re = re.compile(r']', flags=re.I) + pragma_re = re.compile(r']', flags=re.I) + xml_re = re.compile(r'^<\?xml.*?encoding=["\']*(.+?)["\'>]') + + return ( + charset_re.findall(content) + + pragma_re.findall(content) + + xml_re.findall(content) + ) + + +def _parse_content_type_header(header): + """Returns content type and parameters from given header + + :param header: string + :return: tuple containing content type and dictionary of + parameters + """ + + tokens = header.split(";") + content_type, params = tokens[0].strip(), tokens[1:] + params_dict = {} + items_to_strip = "\"' " + + for param in params: + param = param.strip() + if param: + key, value = param, True + index_of_equals = param.find("=") + if index_of_equals != -1: + key = param[:index_of_equals].strip(items_to_strip) + value = param[index_of_equals + 1 :].strip(items_to_strip) + params_dict[key.lower()] = value + return content_type, params_dict + + +def get_encoding_from_headers(headers): + """Returns encodings from given HTTP Header Dict. + + :param headers: dictionary to extract encoding from. + :rtype: str + """ + + content_type = headers.get("content-type") + + if not content_type: + return None + + content_type, params = _parse_content_type_header(content_type) + + if "charset" in params: + return params["charset"].strip("'\"") + + if "text" in content_type: + return "ISO-8859-1" + + if "application/json" in content_type: + # Assume UTF-8 based on RFC 4627: https://www.ietf.org/rfc/rfc4627.txt since the charset was unset + return "utf-8" + + +def stream_decode_response_unicode(iterator, r): + """Stream decodes an iterator.""" + + if r.encoding is None: + yield from iterator + return + + decoder = codecs.getincrementaldecoder(r.encoding)(errors="replace") + for chunk in iterator: + rv = decoder.decode(chunk) + if rv: + yield rv + rv = decoder.decode(b"", final=True) + if rv: + yield rv + + +def iter_slices(string, slice_length): + """Iterate over slices of a string.""" + pos = 0 + if slice_length is None or slice_length <= 0: + slice_length = len(string) + while pos < len(string): + yield string[pos : pos + slice_length] + pos += slice_length + + +def get_unicode_from_response(r): + """Returns the requested content back in unicode. + + :param r: Response object to get unicode content from. + + Tried: + + 1. charset from content-type + 2. fall back and replace all unicode characters + + :rtype: str + """ + warnings.warn( + ( + "In requests 3.0, get_unicode_from_response will be removed. For " + "more information, please see the discussion on issue #2266. (This" + " warning should only appear once.)" + ), + DeprecationWarning, + ) + + tried_encodings = [] + + # Try charset from content-type + encoding = get_encoding_from_headers(r.headers) + + if encoding: + try: + return str(r.content, encoding) + except UnicodeError: + tried_encodings.append(encoding) + + # Fall back: + try: + return str(r.content, encoding, errors="replace") + except TypeError: + return r.content + + +# The unreserved URI characters (RFC 3986) +UNRESERVED_SET = frozenset( + "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz" + "0123456789-._~" +) + + +def unquote_unreserved(uri): + """Un-escape any percent-escape sequences in a URI that are unreserved + characters. This leaves all reserved, illegal and non-ASCII bytes encoded. + + :rtype: str + """ + parts = uri.split("%") + for i in range(1, len(parts)): + h = parts[i][0:2] + if len(h) == 2 and h.isalnum(): + try: + c = chr(int(h, 16)) + except ValueError: + raise InvalidURL(f"Invalid percent-escape sequence: '{h}'") + + if c in UNRESERVED_SET: + parts[i] = c + parts[i][2:] + else: + parts[i] = f"%{parts[i]}" + else: + parts[i] = f"%{parts[i]}" + return "".join(parts) + + +def requote_uri(uri): + """Re-quote the given URI. + + This function passes the given URI through an unquote/quote cycle to + ensure that it is fully and consistently quoted. + + :rtype: str + """ + safe_with_percent = "!#$%&'()*+,/:;=?@[]~" + safe_without_percent = "!#$&'()*+,/:;=?@[]~" + try: + # Unquote only the unreserved characters + # Then quote only illegal characters (do not quote reserved, + # unreserved, or '%') + return quote(unquote_unreserved(uri), safe=safe_with_percent) + except InvalidURL: + # We couldn't unquote the given URI, so let's try quoting it, but + # there may be unquoted '%'s in the URI. We need to make sure they're + # properly quoted so they do not cause issues elsewhere. + return quote(uri, safe=safe_without_percent) + + +def address_in_network(ip, net): + """This function allows you to check if an IP belongs to a network subnet + + Example: returns True if ip = 192.168.1.1 and net = 192.168.1.0/24 + returns False if ip = 192.168.1.1 and net = 192.168.100.0/24 + + :rtype: bool + """ + ipaddr = struct.unpack("=L", socket.inet_aton(ip))[0] + netaddr, bits = net.split("/") + netmask = struct.unpack("=L", socket.inet_aton(dotted_netmask(int(bits))))[0] + network = struct.unpack("=L", socket.inet_aton(netaddr))[0] & netmask + return (ipaddr & netmask) == (network & netmask) + + +def dotted_netmask(mask): + """Converts mask from /xx format to xxx.xxx.xxx.xxx + + Example: if mask is 24 function returns 255.255.255.0 + + :rtype: str + """ + bits = 0xFFFFFFFF ^ (1 << 32 - mask) - 1 + return socket.inet_ntoa(struct.pack(">I", bits)) + + +def is_ipv4_address(string_ip): + """ + :rtype: bool + """ + try: + socket.inet_aton(string_ip) + except OSError: + return False + return True + + +def is_valid_cidr(string_network): + """ + Very simple check of the cidr format in no_proxy variable. + + :rtype: bool + """ + if string_network.count("/") == 1: + try: + mask = int(string_network.split("/")[1]) + except ValueError: + return False + + if mask < 1 or mask > 32: + return False + + try: + socket.inet_aton(string_network.split("/")[0]) + except OSError: + return False + else: + return False + return True + + +@contextlib.contextmanager +def set_environ(env_name, value): + """Set the environment variable 'env_name' to 'value' + + Save previous value, yield, and then restore the previous value stored in + the environment variable 'env_name'. + + If 'value' is None, do nothing""" + value_changed = value is not None + if value_changed: + old_value = os.environ.get(env_name) + os.environ[env_name] = value + try: + yield + finally: + if value_changed: + if old_value is None: + del os.environ[env_name] + else: + os.environ[env_name] = old_value + + +def should_bypass_proxies(url, no_proxy): + """ + Returns whether we should bypass proxies or not. + + :rtype: bool + """ + + # Prioritize lowercase environment variables over uppercase + # to keep a consistent behaviour with other http projects (curl, wget). + def get_proxy(key): + return os.environ.get(key) or os.environ.get(key.upper()) + + # First check whether no_proxy is defined. If it is, check that the URL + # we're getting isn't in the no_proxy list. + no_proxy_arg = no_proxy + if no_proxy is None: + no_proxy = get_proxy("no_proxy") + parsed = urlparse(url) + + if parsed.hostname is None: + # URLs don't always have hostnames, e.g. file:/// urls. + return True + + if no_proxy: + # We need to check whether we match here. We need to see if we match + # the end of the hostname, both with and without the port. + no_proxy = (host for host in no_proxy.replace(" ", "").split(",") if host) + + if is_ipv4_address(parsed.hostname): + for proxy_ip in no_proxy: + if is_valid_cidr(proxy_ip): + if address_in_network(parsed.hostname, proxy_ip): + return True + elif parsed.hostname == proxy_ip: + # If no_proxy ip was defined in plain IP notation instead of cidr notation & + # matches the IP of the index + return True + else: + host_with_port = parsed.hostname + if parsed.port: + host_with_port += f":{parsed.port}" + + for host in no_proxy: + if parsed.hostname.endswith(host) or host_with_port.endswith(host): + # The URL does match something in no_proxy, so we don't want + # to apply the proxies on this URL. + return True + + with set_environ("no_proxy", no_proxy_arg): + # parsed.hostname can be `None` in cases such as a file URI. + try: + bypass = proxy_bypass(parsed.hostname) + except (TypeError, socket.gaierror): + bypass = False + + if bypass: + return True + + return False + + +def get_environ_proxies(url, no_proxy=None): + """ + Return a dict of environment proxies. + + :rtype: dict + """ + if should_bypass_proxies(url, no_proxy=no_proxy): + return {} + else: + return getproxies() + + +def select_proxy(url, proxies): + """Select a proxy for the url, if applicable. + + :param url: The url being for the request + :param proxies: A dictionary of schemes or schemes and hosts to proxy URLs + """ + proxies = proxies or {} + urlparts = urlparse(url) + if urlparts.hostname is None: + return proxies.get(urlparts.scheme, proxies.get("all")) + + proxy_keys = [ + urlparts.scheme + "://" + urlparts.hostname, + urlparts.scheme, + "all://" + urlparts.hostname, + "all", + ] + proxy = None + for proxy_key in proxy_keys: + if proxy_key in proxies: + proxy = proxies[proxy_key] + break + + return proxy + + +def resolve_proxies(request, proxies, trust_env=True): + """This method takes proxy information from a request and configuration + input to resolve a mapping of target proxies. This will consider settings + such as NO_PROXY to strip proxy configurations. + + :param request: Request or PreparedRequest + :param proxies: A dictionary of schemes or schemes and hosts to proxy URLs + :param trust_env: Boolean declaring whether to trust environment configs + + :rtype: dict + """ + proxies = proxies if proxies is not None else {} + url = request.url + scheme = urlparse(url).scheme + no_proxy = proxies.get("no_proxy") + new_proxies = proxies.copy() + + if trust_env and not should_bypass_proxies(url, no_proxy=no_proxy): + environ_proxies = get_environ_proxies(url, no_proxy=no_proxy) + + proxy = environ_proxies.get(scheme, environ_proxies.get("all")) + + if proxy: + new_proxies.setdefault(scheme, proxy) + return new_proxies + + +def default_user_agent(name="python-requests"): + """ + Return a string representing the default user agent. + + :rtype: str + """ + return f"{name}/{__version__}" + + +def default_headers(): + """ + :rtype: requests.structures.CaseInsensitiveDict + """ + return CaseInsensitiveDict( + { + "User-Agent": default_user_agent(), + "Accept-Encoding": DEFAULT_ACCEPT_ENCODING, + "Accept": "*/*", + "Connection": "keep-alive", + } + ) + + +def parse_header_links(value): + """Return a list of parsed link headers proxies. + + i.e. Link: ; rel=front; type="image/jpeg",; rel=back;type="image/jpeg" + + :rtype: list + """ + + links = [] + + replace_chars = " '\"" + + value = value.strip(replace_chars) + if not value: + return links + + for val in re.split(", *<", value): + try: + url, params = val.split(";", 1) + except ValueError: + url, params = val, "" + + link = {"url": url.strip("<> '\"")} + + for param in params.split(";"): + try: + key, value = param.split("=") + except ValueError: + break + + link[key.strip(replace_chars)] = value.strip(replace_chars) + + links.append(link) + + return links + + +# Null bytes; no need to recreate these on each call to guess_json_utf +_null = "\x00".encode("ascii") # encoding to ASCII for Python 3 +_null2 = _null * 2 +_null3 = _null * 3 + + +def guess_json_utf(data): + """ + :rtype: str + """ + # JSON always starts with two ASCII characters, so detection is as + # easy as counting the nulls and from their location and count + # determine the encoding. Also detect a BOM, if present. + sample = data[:4] + if sample in (codecs.BOM_UTF32_LE, codecs.BOM_UTF32_BE): + return "utf-32" # BOM included + if sample[:3] == codecs.BOM_UTF8: + return "utf-8-sig" # BOM included, MS style (discouraged) + if sample[:2] in (codecs.BOM_UTF16_LE, codecs.BOM_UTF16_BE): + return "utf-16" # BOM included + nullcount = sample.count(_null) + if nullcount == 0: + return "utf-8" + if nullcount == 2: + if sample[::2] == _null2: # 1st and 3rd are null + return "utf-16-be" + if sample[1::2] == _null2: # 2nd and 4th are null + return "utf-16-le" + # Did not detect 2 valid UTF-16 ascii-range characters + if nullcount == 3: + if sample[:3] == _null3: + return "utf-32-be" + if sample[1:] == _null3: + return "utf-32-le" + # Did not detect a valid UTF-32 ascii-range character + return None + + +def prepend_scheme_if_needed(url, new_scheme): + """Given a URL that may or may not have a scheme, prepend the given scheme. + Does not replace a present scheme with the one provided as an argument. + + :rtype: str + """ + parsed = parse_url(url) + scheme, auth, host, port, path, query, fragment = parsed + + # A defect in urlparse determines that there isn't a netloc present in some + # urls. We previously assumed parsing was overly cautious, and swapped the + # netloc and path. Due to a lack of tests on the original defect, this is + # maintained with parse_url for backwards compatibility. + netloc = parsed.netloc + if not netloc: + netloc, path = path, netloc + + if auth: + # parse_url doesn't provide the netloc with auth + # so we'll add it ourselves. + netloc = "@".join([auth, netloc]) + if scheme is None: + scheme = new_scheme + if path is None: + path = "" + + return urlunparse((scheme, netloc, path, "", query, fragment)) + + +def get_auth_from_url(url): + """Given a url with authentication components, extract them into a tuple of + username,password. + + :rtype: (str,str) + """ + parsed = urlparse(url) + + try: + auth = (unquote(parsed.username), unquote(parsed.password)) + except (AttributeError, TypeError): + auth = ("", "") + + return auth + + +def check_header_validity(header): + """Verifies that header parts don't contain leading whitespace + reserved characters, or return characters. + + :param header: tuple, in the format (name, value). + """ + name, value = header + _validate_header_part(header, name, 0) + _validate_header_part(header, value, 1) + + +def _validate_header_part(header, header_part, header_validator_index): + if isinstance(header_part, str): + validator = _HEADER_VALIDATORS_STR[header_validator_index] + elif isinstance(header_part, bytes): + validator = _HEADER_VALIDATORS_BYTE[header_validator_index] + else: + raise InvalidHeader( + f"Header part ({header_part!r}) from {header} " + f"must be of type str or bytes, not {type(header_part)}" + ) + + if not validator.match(header_part): + header_kind = "name" if header_validator_index == 0 else "value" + raise InvalidHeader( + f"Invalid leading whitespace, reserved character(s), or return " + f"character(s) in header {header_kind}: {header_part!r}" + ) + + +def urldefragauth(url): + """ + Given a url remove the fragment and the authentication part. + + :rtype: str + """ + scheme, netloc, path, params, query, fragment = urlparse(url) + + # see func:`prepend_scheme_if_needed` + if not netloc: + netloc, path = path, netloc + + netloc = netloc.rsplit("@", 1)[-1] + + return urlunparse((scheme, netloc, path, params, query, "")) + + +def rewind_body(prepared_request): + """Move file pointer back to its recorded starting position + so it can be read again on redirect. + """ + body_seek = getattr(prepared_request.body, "seek", None) + if body_seek is not None and isinstance( + prepared_request._body_position, integer_types + ): + try: + body_seek(prepared_request._body_position) + except OSError: + raise UnrewindableBodyError( + "An error occurred when rewinding request body for redirect." + ) + else: + raise UnrewindableBodyError("Unable to rewind request body for redirect.") diff --git a/.venv/lib/python3.12/site-packages/urllib3-2.2.2.dist-info/INSTALLER b/.venv/lib/python3.12/site-packages/urllib3-2.2.2.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/.venv/lib/python3.12/site-packages/urllib3-2.2.2.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/.venv/lib/python3.12/site-packages/urllib3-2.2.2.dist-info/METADATA b/.venv/lib/python3.12/site-packages/urllib3-2.2.2.dist-info/METADATA new file mode 100644 index 0000000..baeb1dd --- /dev/null +++ b/.venv/lib/python3.12/site-packages/urllib3-2.2.2.dist-info/METADATA @@ -0,0 +1,154 @@ +Metadata-Version: 2.3 +Name: urllib3 +Version: 2.2.2 +Summary: HTTP library with thread-safe connection pooling, file post, and more. +Project-URL: Changelog, https://github.com/urllib3/urllib3/blob/main/CHANGES.rst +Project-URL: Documentation, https://urllib3.readthedocs.io +Project-URL: Code, https://github.com/urllib3/urllib3 +Project-URL: Issue tracker, https://github.com/urllib3/urllib3/issues +Author-email: Andrey Petrov +Maintainer-email: Seth Michael Larson , Quentin Pradet , Illia Volochii +License-File: LICENSE.txt +Keywords: filepost,http,httplib,https,pooling,ssl,threadsafe,urllib +Classifier: Environment :: Web Environment +Classifier: Intended Audience :: Developers +Classifier: License :: OSI Approved :: MIT License +Classifier: Operating System :: OS Independent +Classifier: Programming Language :: Python +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3 :: Only +Classifier: Programming Language :: Python :: 3.8 +Classifier: Programming Language :: Python :: 3.9 +Classifier: Programming Language :: Python :: 3.10 +Classifier: Programming Language :: Python :: 3.11 +Classifier: Programming Language :: Python :: 3.12 +Classifier: Programming Language :: Python :: Implementation :: CPython +Classifier: Programming Language :: Python :: Implementation :: PyPy +Classifier: Topic :: Internet :: WWW/HTTP +Classifier: Topic :: Software Development :: Libraries +Requires-Python: >=3.8 +Provides-Extra: brotli +Requires-Dist: brotli>=1.0.9; (platform_python_implementation == 'CPython') and extra == 'brotli' +Requires-Dist: brotlicffi>=0.8.0; (platform_python_implementation != 'CPython') and extra == 'brotli' +Provides-Extra: h2 +Requires-Dist: h2<5,>=4; extra == 'h2' +Provides-Extra: socks +Requires-Dist: pysocks!=1.5.7,<2.0,>=1.5.6; extra == 'socks' +Provides-Extra: zstd +Requires-Dist: zstandard>=0.18.0; extra == 'zstd' +Description-Content-Type: text/markdown + +

+ +![urllib3](https://github.com/urllib3/urllib3/raw/main/docs/_static/banner_github.svg) + +

+ +

+ PyPI Version + Python Versions + Join our Discord + Coverage Status + Build Status on GitHub + Documentation Status
+ OpenSSF Scorecard + SLSA 3 + CII Best Practices +

+ +urllib3 is a powerful, *user-friendly* HTTP client for Python. Much of the +Python ecosystem already uses urllib3 and you should too. +urllib3 brings many critical features that are missing from the Python +standard libraries: + +- Thread safety. +- Connection pooling. +- Client-side SSL/TLS verification. +- File uploads with multipart encoding. +- Helpers for retrying requests and dealing with HTTP redirects. +- Support for gzip, deflate, brotli, and zstd encoding. +- Proxy support for HTTP and SOCKS. +- 100% test coverage. + +urllib3 is powerful and easy to use: + +```python3 +>>> import urllib3 +>>> resp = urllib3.request("GET", "http://httpbin.org/robots.txt") +>>> resp.status +200 +>>> resp.data +b"User-agent: *\nDisallow: /deny\n" +``` + +## Installing + +urllib3 can be installed with [pip](https://pip.pypa.io): + +```bash +$ python -m pip install urllib3 +``` + +Alternatively, you can grab the latest source code from [GitHub](https://github.com/urllib3/urllib3): + +```bash +$ git clone https://github.com/urllib3/urllib3.git +$ cd urllib3 +$ pip install . +``` + + +## Documentation + +urllib3 has usage and reference documentation at [urllib3.readthedocs.io](https://urllib3.readthedocs.io). + + +## Community + +urllib3 has a [community Discord channel](https://discord.gg/urllib3) for asking questions and +collaborating with other contributors. Drop by and say hello 👋 + + +## Contributing + +urllib3 happily accepts contributions. Please see our +[contributing documentation](https://urllib3.readthedocs.io/en/latest/contributing.html) +for some tips on getting started. + + +## Security Disclosures + +To report a security vulnerability, please use the +[Tidelift security contact](https://tidelift.com/security). +Tidelift will coordinate the fix and disclosure with maintainers. + + +## Maintainers + +- [@sethmlarson](https://github.com/sethmlarson) (Seth M. Larson) +- [@pquentin](https://github.com/pquentin) (Quentin Pradet) +- [@illia-v](https://github.com/illia-v) (Illia Volochii) +- [@theacodes](https://github.com/theacodes) (Thea Flowers) +- [@haikuginger](https://github.com/haikuginger) (Jess Shapiro) +- [@lukasa](https://github.com/lukasa) (Cory Benfield) +- [@sigmavirus24](https://github.com/sigmavirus24) (Ian Stapleton Cordasco) +- [@shazow](https://github.com/shazow) (Andrey Petrov) + +👋 + + +## Sponsorship + +If your company benefits from this library, please consider [sponsoring its +development](https://urllib3.readthedocs.io/en/latest/sponsors.html). + + +## For Enterprise + +Professional support for urllib3 is available as part of the [Tidelift +Subscription][1]. Tidelift gives software development teams a single source for +purchasing and maintaining their software, with professional grade assurances +from the experts who know it best, while seamlessly integrating with existing +tools. + +[1]: https://tidelift.com/subscription/pkg/pypi-urllib3?utm_source=pypi-urllib3&utm_medium=referral&utm_campaign=readme diff --git a/.venv/lib/python3.12/site-packages/urllib3-2.2.2.dist-info/RECORD b/.venv/lib/python3.12/site-packages/urllib3-2.2.2.dist-info/RECORD new file mode 100644 index 0000000..7c9ac85 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/urllib3-2.2.2.dist-info/RECORD @@ -0,0 +1,75 @@ +urllib3-2.2.2.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +urllib3-2.2.2.dist-info/METADATA,sha256=1lFmEu2KSrvTuzjDf_UQxhN3hm5dHoUoUe8iX0XpK20,6434 +urllib3-2.2.2.dist-info/RECORD,, +urllib3-2.2.2.dist-info/WHEEL,sha256=zEMcRr9Kr03x1ozGwg5v9NQBKn3kndp6LSoSlVg-jhU,87 +urllib3-2.2.2.dist-info/licenses/LICENSE.txt,sha256=Ew46ZNX91dCWp1JpRjSn2d8oRGnehuVzIQAmgEHj1oY,1093 +urllib3/__init__.py,sha256=JMo1tg1nIV1AeJ2vENC_Txfl0e5h6Gzl9DGVk1rWRbo,6979 +urllib3/__pycache__/__init__.cpython-312.pyc,, +urllib3/__pycache__/_base_connection.cpython-312.pyc,, +urllib3/__pycache__/_collections.cpython-312.pyc,, +urllib3/__pycache__/_request_methods.cpython-312.pyc,, +urllib3/__pycache__/_version.cpython-312.pyc,, +urllib3/__pycache__/connection.cpython-312.pyc,, +urllib3/__pycache__/connectionpool.cpython-312.pyc,, +urllib3/__pycache__/exceptions.cpython-312.pyc,, +urllib3/__pycache__/fields.cpython-312.pyc,, +urllib3/__pycache__/filepost.cpython-312.pyc,, +urllib3/__pycache__/http2.cpython-312.pyc,, +urllib3/__pycache__/poolmanager.cpython-312.pyc,, +urllib3/__pycache__/response.cpython-312.pyc,, +urllib3/_base_connection.py,sha256=tH0ZlOxWKika-S9NW-MuIlI_PLFQUUmSnoE_9MeywkM,5652 +urllib3/_collections.py,sha256=aGhh9zCYce3o-5FW9DPSUay6O9LjHx8z6T7wDtdhrkY,17370 +urllib3/_request_methods.py,sha256=ucEpHQyQf06b9o1RxKLkCpzGH0ct-v7X2xGpU6rmmlo,9984 +urllib3/_version.py,sha256=NcS90vVEriRXqG3ygXh7bjsUTZrTaLODQB3cjBtxkAw,98 +urllib3/connection.py,sha256=jSJmWOwEfzghV-P9F5dU4opSt6TFG6g6Y23JAaN2Bxg,34762 +urllib3/connectionpool.py,sha256=5fPIHypPwlbKBASMs6bESTEJVEGlsj9FOY9_GGU2GpM,43393 +urllib3/contrib/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +urllib3/contrib/__pycache__/__init__.cpython-312.pyc,, +urllib3/contrib/__pycache__/pyopenssl.cpython-312.pyc,, +urllib3/contrib/__pycache__/socks.cpython-312.pyc,, +urllib3/contrib/emscripten/__init__.py,sha256=u6KNgzjlFZbuAAXa_ybCR7gQ71VJESnF-IIdDA73brw,733 +urllib3/contrib/emscripten/__pycache__/__init__.cpython-312.pyc,, +urllib3/contrib/emscripten/__pycache__/connection.cpython-312.pyc,, +urllib3/contrib/emscripten/__pycache__/fetch.cpython-312.pyc,, +urllib3/contrib/emscripten/__pycache__/request.cpython-312.pyc,, +urllib3/contrib/emscripten/__pycache__/response.cpython-312.pyc,, +urllib3/contrib/emscripten/connection.py,sha256=kaBe2tWt7Yy9vNUFRBV7CSyDnfhCYILGxju9KTZj8Sw,8755 +urllib3/contrib/emscripten/emscripten_fetch_worker.js,sha256=CDfYF_9CDobtx2lGidyJ1zjDEvwNT5F-dchmVWXDh0E,3655 +urllib3/contrib/emscripten/fetch.py,sha256=ymwJlHBBuw6WTpKgPHpdmmrNBxlsr75HqoD4Rn27YXk,14131 +urllib3/contrib/emscripten/request.py,sha256=mL28szy1KvE3NJhWor5jNmarp8gwplDU-7gwGZY5g0Q,566 +urllib3/contrib/emscripten/response.py,sha256=wEYWPHCL-JsgCtpCpfnWGYA1-DcjDGpFGqWCXZLwbHY,10017 +urllib3/contrib/pyopenssl.py,sha256=X31eCYGwB09EkAHX8RhDKC0X0Ki7d0cCVWoMJZUM5bQ,19161 +urllib3/contrib/socks.py,sha256=-iardc61GypsJzD6W6yuRS7KVCyfowcQrl_719H7lIM,7549 +urllib3/exceptions.py,sha256=RDaiudtR7rqbVKTKpLSgZBBtwaIqV7eZtervZV_mZag,9393 +urllib3/fields.py,sha256=8vi0PeRo_pE5chPmJA07LZtMkVls4UrBS1k2xM506jM,10843 +urllib3/filepost.py,sha256=-9qJT11cNGjO9dqnI20-oErZuTvNaM18xZZPCjZSbOE,2395 +urllib3/http2.py,sha256=ZfXCqoeKqMoC2JOn9ajMFwNgdyqJozj-6oBZNAUcqd0,7517 +urllib3/poolmanager.py,sha256=2_L2AjVDgoQ0qBmYbX9u9QqyU1u5J37zQbtv_-ueZQA,22913 +urllib3/py.typed,sha256=UaCuPFa3H8UAakbt-5G8SPacldTOGvJv18pPjUJ5gDY,93 +urllib3/response.py,sha256=NS0rqwRmtwWtC_6XDqgDJN_uo-jEmBVzx0V6KCsHlwg,44801 +urllib3/util/__init__.py,sha256=-qeS0QceivazvBEKDNFCAI-6ACcdDOE4TMvo7SLNlAQ,1001 +urllib3/util/__pycache__/__init__.cpython-312.pyc,, +urllib3/util/__pycache__/connection.cpython-312.pyc,, +urllib3/util/__pycache__/proxy.cpython-312.pyc,, +urllib3/util/__pycache__/request.cpython-312.pyc,, +urllib3/util/__pycache__/response.cpython-312.pyc,, +urllib3/util/__pycache__/retry.cpython-312.pyc,, +urllib3/util/__pycache__/ssl_.cpython-312.pyc,, +urllib3/util/__pycache__/ssl_match_hostname.cpython-312.pyc,, +urllib3/util/__pycache__/ssltransport.cpython-312.pyc,, +urllib3/util/__pycache__/timeout.cpython-312.pyc,, +urllib3/util/__pycache__/url.cpython-312.pyc,, +urllib3/util/__pycache__/util.cpython-312.pyc,, +urllib3/util/__pycache__/wait.cpython-312.pyc,, +urllib3/util/connection.py,sha256=QeUUEuNmhznpuKNPL-B0IVOkMdMCu8oJX62OC0Vpzug,4462 +urllib3/util/proxy.py,sha256=seP8-Q5B6bB0dMtwPj-YcZZQ30vHuLqRu-tI0JZ2fzs,1148 +urllib3/util/request.py,sha256=QIZWYzQ6Y4MpJsD_kssVEIrWNu69ioUMuE6fjd4qhPM,8069 +urllib3/util/response.py,sha256=vQE639uoEhj1vpjEdxu5lNIhJCSUZkd7pqllUI0BZOA,3374 +urllib3/util/retry.py,sha256=bj-2YUqblxLlv8THg5fxww-DM54XCbjgZXIQ71XioCY,18459 +urllib3/util/ssl_.py,sha256=DevjBk-8GNMgZjHzgCHHaxmWlXb-dKjcgymNd3ZT-ew,19107 +urllib3/util/ssl_match_hostname.py,sha256=gaWqixoYtQ_GKO8fcRGFj3VXeMoqyxQQuUTPgWeiL_M,5812 +urllib3/util/ssltransport.py,sha256=HHvjU0i-PjPThvNYQ8R1SEsseY0x07tPfVntiXg72n0,8990 +urllib3/util/timeout.py,sha256=4eT1FVeZZU7h7mYD1Jq2OXNe4fxekdNvhoWUkZusRpA,10346 +urllib3/util/url.py,sha256=wHORhp80RAXyTlAIkTqLFzSrkU7J34ZDxX-tN65MBZk,15213 +urllib3/util/util.py,sha256=j3lbZK1jPyiwD34T8IgJzdWEZVT-4E-0vYIJi9UjeNA,1146 +urllib3/util/wait.py,sha256=_ph8IrUR3sqPqi0OopQgJUlH4wzkGeM5CiyA7XGGtmI,4423 diff --git a/.venv/lib/python3.12/site-packages/urllib3-2.2.2.dist-info/WHEEL b/.venv/lib/python3.12/site-packages/urllib3-2.2.2.dist-info/WHEEL new file mode 100644 index 0000000..516596c --- /dev/null +++ b/.venv/lib/python3.12/site-packages/urllib3-2.2.2.dist-info/WHEEL @@ -0,0 +1,4 @@ +Wheel-Version: 1.0 +Generator: hatchling 1.24.2 +Root-Is-Purelib: true +Tag: py3-none-any diff --git a/.venv/lib/python3.12/site-packages/urllib3-2.2.2.dist-info/licenses/LICENSE.txt b/.venv/lib/python3.12/site-packages/urllib3-2.2.2.dist-info/licenses/LICENSE.txt new file mode 100644 index 0000000..e6183d0 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/urllib3-2.2.2.dist-info/licenses/LICENSE.txt @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2008-2020 Andrey Petrov and contributors. + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/.venv/lib/python3.12/site-packages/urllib3/__init__.py b/.venv/lib/python3.12/site-packages/urllib3/__init__.py new file mode 100644 index 0000000..3fe782c --- /dev/null +++ b/.venv/lib/python3.12/site-packages/urllib3/__init__.py @@ -0,0 +1,211 @@ +""" +Python HTTP library with thread-safe connection pooling, file post support, user friendly, and more +""" + +from __future__ import annotations + +# Set default logging handler to avoid "No handler found" warnings. +import logging +import sys +import typing +import warnings +from logging import NullHandler + +from . import exceptions +from ._base_connection import _TYPE_BODY +from ._collections import HTTPHeaderDict +from ._version import __version__ +from .connectionpool import HTTPConnectionPool, HTTPSConnectionPool, connection_from_url +from .filepost import _TYPE_FIELDS, encode_multipart_formdata +from .poolmanager import PoolManager, ProxyManager, proxy_from_url +from .response import BaseHTTPResponse, HTTPResponse +from .util.request import make_headers +from .util.retry import Retry +from .util.timeout import Timeout + +# Ensure that Python is compiled with OpenSSL 1.1.1+ +# If the 'ssl' module isn't available at all that's +# fine, we only care if the module is available. +try: + import ssl +except ImportError: + pass +else: + if not ssl.OPENSSL_VERSION.startswith("OpenSSL "): # Defensive: + warnings.warn( + "urllib3 v2 only supports OpenSSL 1.1.1+, currently " + f"the 'ssl' module is compiled with {ssl.OPENSSL_VERSION!r}. " + "See: https://github.com/urllib3/urllib3/issues/3020", + exceptions.NotOpenSSLWarning, + ) + elif ssl.OPENSSL_VERSION_INFO < (1, 1, 1): # Defensive: + raise ImportError( + "urllib3 v2 only supports OpenSSL 1.1.1+, currently " + f"the 'ssl' module is compiled with {ssl.OPENSSL_VERSION!r}. " + "See: https://github.com/urllib3/urllib3/issues/2168" + ) + +__author__ = "Andrey Petrov (andrey.petrov@shazow.net)" +__license__ = "MIT" +__version__ = __version__ + +__all__ = ( + "HTTPConnectionPool", + "HTTPHeaderDict", + "HTTPSConnectionPool", + "PoolManager", + "ProxyManager", + "HTTPResponse", + "Retry", + "Timeout", + "add_stderr_logger", + "connection_from_url", + "disable_warnings", + "encode_multipart_formdata", + "make_headers", + "proxy_from_url", + "request", + "BaseHTTPResponse", +) + +logging.getLogger(__name__).addHandler(NullHandler()) + + +def add_stderr_logger( + level: int = logging.DEBUG, +) -> logging.StreamHandler[typing.TextIO]: + """ + Helper for quickly adding a StreamHandler to the logger. Useful for + debugging. + + Returns the handler after adding it. + """ + # This method needs to be in this __init__.py to get the __name__ correct + # even if urllib3 is vendored within another package. + logger = logging.getLogger(__name__) + handler = logging.StreamHandler() + handler.setFormatter(logging.Formatter("%(asctime)s %(levelname)s %(message)s")) + logger.addHandler(handler) + logger.setLevel(level) + logger.debug("Added a stderr logging handler to logger: %s", __name__) + return handler + + +# ... Clean up. +del NullHandler + + +# All warning filters *must* be appended unless you're really certain that they +# shouldn't be: otherwise, it's very hard for users to use most Python +# mechanisms to silence them. +# SecurityWarning's always go off by default. +warnings.simplefilter("always", exceptions.SecurityWarning, append=True) +# InsecurePlatformWarning's don't vary between requests, so we keep it default. +warnings.simplefilter("default", exceptions.InsecurePlatformWarning, append=True) + + +def disable_warnings(category: type[Warning] = exceptions.HTTPWarning) -> None: + """ + Helper for quickly disabling all urllib3 warnings. + """ + warnings.simplefilter("ignore", category) + + +_DEFAULT_POOL = PoolManager() + + +def request( + method: str, + url: str, + *, + body: _TYPE_BODY | None = None, + fields: _TYPE_FIELDS | None = None, + headers: typing.Mapping[str, str] | None = None, + preload_content: bool | None = True, + decode_content: bool | None = True, + redirect: bool | None = True, + retries: Retry | bool | int | None = None, + timeout: Timeout | float | int | None = 3, + json: typing.Any | None = None, +) -> BaseHTTPResponse: + """ + A convenience, top-level request method. It uses a module-global ``PoolManager`` instance. + Therefore, its side effects could be shared across dependencies relying on it. + To avoid side effects create a new ``PoolManager`` instance and use it instead. + The method does not accept low-level ``**urlopen_kw`` keyword arguments. + + :param method: + HTTP request method (such as GET, POST, PUT, etc.) + + :param url: + The URL to perform the request on. + + :param body: + Data to send in the request body, either :class:`str`, :class:`bytes`, + an iterable of :class:`str`/:class:`bytes`, or a file-like object. + + :param fields: + Data to encode and send in the request body. + + :param headers: + Dictionary of custom headers to send, such as User-Agent, + If-None-Match, etc. + + :param bool preload_content: + If True, the response's body will be preloaded into memory. + + :param bool decode_content: + If True, will attempt to decode the body based on the + 'content-encoding' header. + + :param redirect: + If True, automatically handle redirects (status codes 301, 302, + 303, 307, 308). Each redirect counts as a retry. Disabling retries + will disable redirect, too. + + :param retries: + Configure the number of retries to allow before raising a + :class:`~urllib3.exceptions.MaxRetryError` exception. + + If ``None`` (default) will retry 3 times, see ``Retry.DEFAULT``. Pass a + :class:`~urllib3.util.retry.Retry` object for fine-grained control + over different types of retries. + Pass an integer number to retry connection errors that many times, + but no other types of errors. Pass zero to never retry. + + If ``False``, then retries are disabled and any exception is raised + immediately. Also, instead of raising a MaxRetryError on redirects, + the redirect response will be returned. + + :type retries: :class:`~urllib3.util.retry.Retry`, False, or an int. + + :param timeout: + If specified, overrides the default timeout for this one + request. It may be a float (in seconds) or an instance of + :class:`urllib3.util.Timeout`. + + :param json: + Data to encode and send as JSON with UTF-encoded in the request body. + The ``"Content-Type"`` header will be set to ``"application/json"`` + unless specified otherwise. + """ + + return _DEFAULT_POOL.request( + method, + url, + body=body, + fields=fields, + headers=headers, + preload_content=preload_content, + decode_content=decode_content, + redirect=redirect, + retries=retries, + timeout=timeout, + json=json, + ) + + +if sys.platform == "emscripten": + from .contrib.emscripten import inject_into_urllib3 # noqa: 401 + + inject_into_urllib3() diff --git a/.venv/lib/python3.12/site-packages/urllib3/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/urllib3/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..12a1fb8e12c2d61d77ae38037c95209771b25b34 GIT binary patch literal 7303 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 KiT)E)(Ebmrq3c`# literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/urllib3/__pycache__/_base_connection.cpython-312.pyc b/.venv/lib/python3.12/site-packages/urllib3/__pycache__/_base_connection.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..348e82c2189da4fd010fbb71045a4a196199643f GIT binary patch literal 6850 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 MtfrR;X>OqZ0#(sup#T5? literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/urllib3/__pycache__/_collections.cpython-312.pyc b/.venv/lib/python3.12/site-packages/urllib3/__pycache__/_collections.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..0bd2cd5a5a4e832d6414691d0e37e0788a534de6 GIT binary patch literal 22702 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 UGb1D8QwF66e4>rqMeINk0O`d=?f?J) literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/urllib3/__pycache__/connection.cpython-312.pyc b/.venv/lib/python3.12/site-packages/urllib3/__pycache__/connection.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a3a697692581b55080a366989cdb456a6e79fa0b GIT binary patch literal 32253 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/urllib3/__pycache__/connectionpool.cpython-312.pyc b/.venv/lib/python3.12/site-packages/urllib3/__pycache__/connectionpool.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a943d5e707fe3d7f950fccbf31125b9e78354efd GIT binary patch literal 39736 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/urllib3/__pycache__/fields.cpython-312.pyc b/.venv/lib/python3.12/site-packages/urllib3/__pycache__/fields.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4b2f3af35f47aca2e3685d9e75e6afd415cfe517 GIT binary patch literal 12065 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/urllib3/__pycache__/filepost.cpython-312.pyc b/.venv/lib/python3.12/site-packages/urllib3/__pycache__/filepost.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ff85f1f89e55e6033b1b01e011aa7cf96923ba11 GIT binary patch literal 3506 zcma)8U2Gf25#BrAk;fm2mMF=VB`X)(bxlhoYsq$E#dhIDG9pD*68{0EV^AmF(mMHg z$L=lVQlJaD2pS0rDh2^+8F65vPcDoCdFVr*i=r=mAt414E)F0d23o(#ae%gY>gwJ=Ts3+-hsE`yKDkeps9^ISuC4C?(sG=@q{Yif|kPL8$N7ysn;cn8Ps`nA>!r zggzO<;`CmJ@j?gO?iU!&2XK3K;O@fy49~RTK$SY0TYf+X;~)GnEma-Kh#FL-4~1l# z8dCj0+xu>N$h%M3nWMbD zJ9X(7?+vHUjSPui>YbqRy;jrnift?nt4N2NFnYhdb$gg zM@3tj)C|Q+Ynttw!oSkBOu^<&%l74oVyI@;_Nq8-s`!uSIWy+__Y+fQ7AHs!Q)13& z>8S*pO`O-PbRs^3jhTe5O(t>$I%OII@uU3-OQSfJQ_?q->)1-oN3W` zu3(3^*+(L<5zAfc5Oj0sI|+r_)`DG?VAs7j?~mRceLy}NUkUcE1^X+({*~advT%&F zfM~iN5cpv3Kfr?ZcNn~bxEBIeM6@2VX#oVbwMVsC(o#gzzHO86=?3N&XYfUIiz{+N z=vpsAxA;a<6nQGSE9?5iBL92t4qWb!_t1L4ryY23WvjHv{|?n8V*)C0fAZYqAPIi! z#BPLQqEIZGGnmL3ma|qo;LKdi=W-^YmaJR6P0NmQpA!Wq_V1|snzEU znUDoi&eFlO4kCQN1F6x5q}I}*dx!4F@5Wbs(e+5@ol~Ej`t;0#v=Ql?mo{2DzeR#LFfTq1wwLg| z4_1Rm)?0TkzVoEDXRY-}rS-_e;c{#LN~r&tAH@D^v8(!SMBt0uT!6A8IIYg-8aPlyk7@}D$?{i77Eh7iDY;Zgr_TWUKlki}3984{;!+OL zpu2C8cey)hE_$Y$T*(G?ZFN_22;`a@^X}-DK-n#GT2Y`ZOirsOcaXNbyrST0+qSCB zm8h@kdTHzHIyq#t?CiV7zHo}2y}L!r$A1%kNU9nG@#SNndRf#y=WoFkpWf}BvO!%h z7sU(@cyDQ|Iny$-}SiX)82PM_2`|4i!Kf7v`Xj>HmgV^b2`B-e0Zwk!%ba+=7 zv7;8l1^5^j*V&7ii&qQsW2V>-jU9rY6SW`o*YE9tf{X{rUno^0d*n+c^&gThN71;C6Q zRAYy6!L_rxd#Y}HilvXU&;h`9qflh=`Tu@2%CK{5aB4qMx3eAKJnSwU&-8j;)1y zDxscb`eo?gMrha4=)!1;u7>4npaKVKdz2M?Ep!_H#@o{L_BX`UG5 zC*X>xP<44|%M4lluebwR@AF0)|t6MAPwI~P0(pgLTK$`rNEeSw4<)S=pLW(*% zTAcEDb&|bT`(&8C7Ts+JQmITHEWoK0VU>jhp|iaVEz%ZYNKV)@$>ue)nr1912&+}q z!t2#d^F}^LUS&ekMfSvH#ag^<01DXRCH5w84rjM-Jyq)B@cWmC$KM(z492QfvnQF8 zz=S0TVQ)vrOHQ%=UOJUE)x3_+kmE4Hik$Ul=r%nZ$9;|Ve}lqbp{B2pANsFR$3M}@ z4S&ac$I`xqeWjZ#{#PDw761M@@5Y{<`{BFcbs_N4*zK`W$DQs^x|h@C1B2zB!Ai>; zfBB%?GExynpLzIBzKq&8y=Yg*QgNZUE_AXrfh>Na=_EhP?xI;I@j_*X^JE!^|19dOV literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/urllib3/__pycache__/http2.cpython-312.pyc b/.venv/lib/python3.12/site-packages/urllib3/__pycache__/http2.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4b26a70b2307733f8556b4b4497c6c2a2530d72d GIT binary patch literal 11028 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 GC;TrK&>wOD literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/urllib3/__pycache__/poolmanager.cpython-312.pyc b/.venv/lib/python3.12/site-packages/urllib3/__pycache__/poolmanager.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..16051e4e892c87a3574abd3f2b0457a29123f17c GIT binary patch literal 24067 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

P+@C!S@5@H}-dy|M2gl!U z%C{fY+zB5C>Q}C>e0lZSJtY@7@c@3D6Cc0e+H9ihw?BC%* zGvJavU;Z&AY%10X`WYn*`k0_2l>ARh3Y7dklBFK9-ow5QNdRei)B69S()%c3p>mc* zm`vmHPbm3oO0FXTEoW0bNEud7h|euG>*$~HF~}cMX_cyb%G#F~={;i~>=V<+k$+0b zVXl7UrRZ+|hsz-mr7#usZCT+8(iYiNu0WLj=u zxs7C7Zerk@e2KNU%IRg+UfgwSFF~5MmmtmBOAy(Ne_2UT4|jq;1H)~=*~|>LbnkwJ zJ#TutpTNG|TPM{#f0Qw|wsIaAR3vg-Vn@q@9lA*2DfTv~dv9BrT z8@kuK?i*UG1+?xM(l$VaOdNfw5^G8N9MKVkYkpz7yJQ!NY*~rarfe--)}1l>9Yihe zARLy7QR640=$Fq(cUE2S7GHsJN3GCSt^7?Y;G||1nW(ku2SGptNr=VsX+Cj341n=C zPU*r#sCmY<-?pe`VR|t2>8^1_CiPbJT2c$s3e+kqgEV+e2O+JC=^LsSKe(Vd(iCk z%Od@tiO>@n#&0~+uNxmfbMpABXU9+D2UwN3TBFSqe*6JP-szWu73K}Z?`nl1R^XRE zJTPmW!=&O=);MAM0VTgr$yLJX9fx5_oTQ&i)m&giV^tSsmtyL*V^-dQ4{u{1u)9%@@H$AjB{nSzQ zcaEL^!~5d03%l0UynJP&qA6F=wCc`RbT8YBj>>A=vcD*Bjcw~(?bC`rzB4UzrIp*YU(|yN*5!@L z&Rk{Zde?#XUHQsae&Mv&+t#^iP>J6C>qjo-S|--H#-|mho&4e3p{E?(pH6zu+xV0G S?H8YN40t;2;Q3)TXa5g6U4&i$ literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/urllib3/__pycache__/response.cpython-312.pyc b/.venv/lib/python3.12/site-packages/urllib3/__pycache__/response.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..15c72eae0a2a4f5520a94b54daae276a09a45dcc GIT binary patch literal 50453 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/urllib3/_base_connection.py b/.venv/lib/python3.12/site-packages/urllib3/_base_connection.py new file mode 100644 index 0000000..29ca334 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/urllib3/_base_connection.py @@ -0,0 +1,172 @@ +from __future__ import annotations + +import typing + +from .util.connection import _TYPE_SOCKET_OPTIONS +from .util.timeout import _DEFAULT_TIMEOUT, _TYPE_TIMEOUT +from .util.url import Url + +_TYPE_BODY = typing.Union[bytes, typing.IO[typing.Any], typing.Iterable[bytes], str] + + +class ProxyConfig(typing.NamedTuple): + ssl_context: ssl.SSLContext | None + use_forwarding_for_https: bool + assert_hostname: None | str | typing.Literal[False] + assert_fingerprint: str | None + + +class _ResponseOptions(typing.NamedTuple): + # TODO: Remove this in favor of a better + # HTTP request/response lifecycle tracking. + request_method: str + request_url: str + preload_content: bool + decode_content: bool + enforce_content_length: bool + + +if typing.TYPE_CHECKING: + import ssl + from typing import Protocol + + from .response import BaseHTTPResponse + + class BaseHTTPConnection(Protocol): + default_port: typing.ClassVar[int] + default_socket_options: typing.ClassVar[_TYPE_SOCKET_OPTIONS] + + host: str + port: int + timeout: None | ( + float + ) # Instance doesn't store _DEFAULT_TIMEOUT, must be resolved. + blocksize: int + source_address: tuple[str, int] | None + socket_options: _TYPE_SOCKET_OPTIONS | None + + proxy: Url | None + proxy_config: ProxyConfig | None + + is_verified: bool + proxy_is_verified: bool | None + + def __init__( + self, + host: str, + port: int | None = None, + *, + timeout: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT, + source_address: tuple[str, int] | None = None, + blocksize: int = 8192, + socket_options: _TYPE_SOCKET_OPTIONS | None = ..., + proxy: Url | None = None, + proxy_config: ProxyConfig | None = None, + ) -> None: + ... + + def set_tunnel( + self, + host: str, + port: int | None = None, + headers: typing.Mapping[str, str] | None = None, + scheme: str = "http", + ) -> None: + ... + + def connect(self) -> None: + ... + + def request( + self, + method: str, + url: str, + body: _TYPE_BODY | None = None, + headers: typing.Mapping[str, str] | None = None, + # We know *at least* botocore is depending on the order of the + # first 3 parameters so to be safe we only mark the later ones + # as keyword-only to ensure we have space to extend. + *, + chunked: bool = False, + preload_content: bool = True, + decode_content: bool = True, + enforce_content_length: bool = True, + ) -> None: + ... + + def getresponse(self) -> BaseHTTPResponse: + ... + + def close(self) -> None: + ... + + @property + def is_closed(self) -> bool: + """Whether the connection either is brand new or has been previously closed. + If this property is True then both ``is_connected`` and ``has_connected_to_proxy`` + properties must be False. + """ + + @property + def is_connected(self) -> bool: + """Whether the connection is actively connected to any origin (proxy or target)""" + + @property + def has_connected_to_proxy(self) -> bool: + """Whether the connection has successfully connected to its proxy. + This returns False if no proxy is in use. Used to determine whether + errors are coming from the proxy layer or from tunnelling to the target origin. + """ + + class BaseHTTPSConnection(BaseHTTPConnection, Protocol): + default_port: typing.ClassVar[int] + default_socket_options: typing.ClassVar[_TYPE_SOCKET_OPTIONS] + + # Certificate verification methods + cert_reqs: int | str | None + assert_hostname: None | str | typing.Literal[False] + assert_fingerprint: str | None + ssl_context: ssl.SSLContext | None + + # Trusted CAs + ca_certs: str | None + ca_cert_dir: str | None + ca_cert_data: None | str | bytes + + # TLS version + ssl_minimum_version: int | None + ssl_maximum_version: int | None + ssl_version: int | str | None # Deprecated + + # Client certificates + cert_file: str | None + key_file: str | None + key_password: str | None + + def __init__( + self, + host: str, + port: int | None = None, + *, + timeout: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT, + source_address: tuple[str, int] | None = None, + blocksize: int = 16384, + socket_options: _TYPE_SOCKET_OPTIONS | None = ..., + proxy: Url | None = None, + proxy_config: ProxyConfig | None = None, + cert_reqs: int | str | None = None, + assert_hostname: None | str | typing.Literal[False] = None, + assert_fingerprint: str | None = None, + server_hostname: str | None = None, + ssl_context: ssl.SSLContext | None = None, + ca_certs: str | None = None, + ca_cert_dir: str | None = None, + ca_cert_data: None | str | bytes = None, + ssl_minimum_version: int | None = None, + ssl_maximum_version: int | None = None, + ssl_version: int | str | None = None, # Deprecated + cert_file: str | None = None, + key_file: str | None = None, + key_password: str | None = None, + ) -> None: + ... diff --git a/.venv/lib/python3.12/site-packages/urllib3/_collections.py b/.venv/lib/python3.12/site-packages/urllib3/_collections.py new file mode 100644 index 0000000..8a4409a --- /dev/null +++ b/.venv/lib/python3.12/site-packages/urllib3/_collections.py @@ -0,0 +1,483 @@ +from __future__ import annotations + +import typing +from collections import OrderedDict +from enum import Enum, auto +from threading import RLock + +if typing.TYPE_CHECKING: + # We can only import Protocol if TYPE_CHECKING because it's a development + # dependency, and is not available at runtime. + from typing import Protocol + + from typing_extensions import Self + + class HasGettableStringKeys(Protocol): + def keys(self) -> typing.Iterator[str]: + ... + + def __getitem__(self, key: str) -> str: + ... + + +__all__ = ["RecentlyUsedContainer", "HTTPHeaderDict"] + + +# Key type +_KT = typing.TypeVar("_KT") +# Value type +_VT = typing.TypeVar("_VT") +# Default type +_DT = typing.TypeVar("_DT") + +ValidHTTPHeaderSource = typing.Union[ + "HTTPHeaderDict", + typing.Mapping[str, str], + typing.Iterable[typing.Tuple[str, str]], + "HasGettableStringKeys", +] + + +class _Sentinel(Enum): + not_passed = auto() + + +def ensure_can_construct_http_header_dict( + potential: object, +) -> ValidHTTPHeaderSource | None: + if isinstance(potential, HTTPHeaderDict): + return potential + elif isinstance(potential, typing.Mapping): + # Full runtime checking of the contents of a Mapping is expensive, so for the + # purposes of typechecking, we assume that any Mapping is the right shape. + return typing.cast(typing.Mapping[str, str], potential) + elif isinstance(potential, typing.Iterable): + # Similarly to Mapping, full runtime checking of the contents of an Iterable is + # expensive, so for the purposes of typechecking, we assume that any Iterable + # is the right shape. + return typing.cast(typing.Iterable[typing.Tuple[str, str]], potential) + elif hasattr(potential, "keys") and hasattr(potential, "__getitem__"): + return typing.cast("HasGettableStringKeys", potential) + else: + return None + + +class RecentlyUsedContainer(typing.Generic[_KT, _VT], typing.MutableMapping[_KT, _VT]): + """ + Provides a thread-safe dict-like container which maintains up to + ``maxsize`` keys while throwing away the least-recently-used keys beyond + ``maxsize``. + + :param maxsize: + Maximum number of recent elements to retain. + + :param dispose_func: + Every time an item is evicted from the container, + ``dispose_func(value)`` is called. Callback which will get called + """ + + _container: typing.OrderedDict[_KT, _VT] + _maxsize: int + dispose_func: typing.Callable[[_VT], None] | None + lock: RLock + + def __init__( + self, + maxsize: int = 10, + dispose_func: typing.Callable[[_VT], None] | None = None, + ) -> None: + super().__init__() + self._maxsize = maxsize + self.dispose_func = dispose_func + self._container = OrderedDict() + self.lock = RLock() + + def __getitem__(self, key: _KT) -> _VT: + # Re-insert the item, moving it to the end of the eviction line. + with self.lock: + item = self._container.pop(key) + self._container[key] = item + return item + + def __setitem__(self, key: _KT, value: _VT) -> None: + evicted_item = None + with self.lock: + # Possibly evict the existing value of 'key' + try: + # If the key exists, we'll overwrite it, which won't change the + # size of the pool. Because accessing a key should move it to + # the end of the eviction line, we pop it out first. + evicted_item = key, self._container.pop(key) + self._container[key] = value + except KeyError: + # When the key does not exist, we insert the value first so that + # evicting works in all cases, including when self._maxsize is 0 + self._container[key] = value + if len(self._container) > self._maxsize: + # If we didn't evict an existing value, and we've hit our maximum + # size, then we have to evict the least recently used item from + # the beginning of the container. + evicted_item = self._container.popitem(last=False) + + # After releasing the lock on the pool, dispose of any evicted value. + if evicted_item is not None and self.dispose_func: + _, evicted_value = evicted_item + self.dispose_func(evicted_value) + + def __delitem__(self, key: _KT) -> None: + with self.lock: + value = self._container.pop(key) + + if self.dispose_func: + self.dispose_func(value) + + def __len__(self) -> int: + with self.lock: + return len(self._container) + + def __iter__(self) -> typing.NoReturn: + raise NotImplementedError( + "Iteration over this class is unlikely to be threadsafe." + ) + + def clear(self) -> None: + with self.lock: + # Copy pointers to all values, then wipe the mapping + values = list(self._container.values()) + self._container.clear() + + if self.dispose_func: + for value in values: + self.dispose_func(value) + + def keys(self) -> set[_KT]: # type: ignore[override] + with self.lock: + return set(self._container.keys()) + + +class HTTPHeaderDictItemView(typing.Set[typing.Tuple[str, str]]): + """ + HTTPHeaderDict is unusual for a Mapping[str, str] in that it has two modes of + address. + + If we directly try to get an item with a particular name, we will get a string + back that is the concatenated version of all the values: + + >>> d['X-Header-Name'] + 'Value1, Value2, Value3' + + However, if we iterate over an HTTPHeaderDict's items, we will optionally combine + these values based on whether combine=True was called when building up the dictionary + + >>> d = HTTPHeaderDict({"A": "1", "B": "foo"}) + >>> d.add("A", "2", combine=True) + >>> d.add("B", "bar") + >>> list(d.items()) + [ + ('A', '1, 2'), + ('B', 'foo'), + ('B', 'bar'), + ] + + This class conforms to the interface required by the MutableMapping ABC while + also giving us the nonstandard iteration behavior we want; items with duplicate + keys, ordered by time of first insertion. + """ + + _headers: HTTPHeaderDict + + def __init__(self, headers: HTTPHeaderDict) -> None: + self._headers = headers + + def __len__(self) -> int: + return len(list(self._headers.iteritems())) + + def __iter__(self) -> typing.Iterator[tuple[str, str]]: + return self._headers.iteritems() + + def __contains__(self, item: object) -> bool: + if isinstance(item, tuple) and len(item) == 2: + passed_key, passed_val = item + if isinstance(passed_key, str) and isinstance(passed_val, str): + return self._headers._has_value_for_header(passed_key, passed_val) + return False + + +class HTTPHeaderDict(typing.MutableMapping[str, str]): + """ + :param headers: + An iterable of field-value pairs. Must not contain multiple field names + when compared case-insensitively. + + :param kwargs: + Additional field-value pairs to pass in to ``dict.update``. + + A ``dict`` like container for storing HTTP Headers. + + Field names are stored and compared case-insensitively in compliance with + RFC 7230. Iteration provides the first case-sensitive key seen for each + case-insensitive pair. + + Using ``__setitem__`` syntax overwrites fields that compare equal + case-insensitively in order to maintain ``dict``'s api. For fields that + compare equal, instead create a new ``HTTPHeaderDict`` and use ``.add`` + in a loop. + + If multiple fields that are equal case-insensitively are passed to the + constructor or ``.update``, the behavior is undefined and some will be + lost. + + >>> headers = HTTPHeaderDict() + >>> headers.add('Set-Cookie', 'foo=bar') + >>> headers.add('set-cookie', 'baz=quxx') + >>> headers['content-length'] = '7' + >>> headers['SET-cookie'] + 'foo=bar, baz=quxx' + >>> headers['Content-Length'] + '7' + """ + + _container: typing.MutableMapping[str, list[str]] + + def __init__(self, headers: ValidHTTPHeaderSource | None = None, **kwargs: str): + super().__init__() + self._container = {} # 'dict' is insert-ordered + if headers is not None: + if isinstance(headers, HTTPHeaderDict): + self._copy_from(headers) + else: + self.extend(headers) + if kwargs: + self.extend(kwargs) + + def __setitem__(self, key: str, val: str) -> None: + # avoid a bytes/str comparison by decoding before httplib + if isinstance(key, bytes): + key = key.decode("latin-1") + self._container[key.lower()] = [key, val] + + def __getitem__(self, key: str) -> str: + val = self._container[key.lower()] + return ", ".join(val[1:]) + + def __delitem__(self, key: str) -> None: + del self._container[key.lower()] + + def __contains__(self, key: object) -> bool: + if isinstance(key, str): + return key.lower() in self._container + return False + + def setdefault(self, key: str, default: str = "") -> str: + return super().setdefault(key, default) + + def __eq__(self, other: object) -> bool: + maybe_constructable = ensure_can_construct_http_header_dict(other) + if maybe_constructable is None: + return False + else: + other_as_http_header_dict = type(self)(maybe_constructable) + + return {k.lower(): v for k, v in self.itermerged()} == { + k.lower(): v for k, v in other_as_http_header_dict.itermerged() + } + + def __ne__(self, other: object) -> bool: + return not self.__eq__(other) + + def __len__(self) -> int: + return len(self._container) + + def __iter__(self) -> typing.Iterator[str]: + # Only provide the originally cased names + for vals in self._container.values(): + yield vals[0] + + def discard(self, key: str) -> None: + try: + del self[key] + except KeyError: + pass + + def add(self, key: str, val: str, *, combine: bool = False) -> None: + """Adds a (name, value) pair, doesn't overwrite the value if it already + exists. + + If this is called with combine=True, instead of adding a new header value + as a distinct item during iteration, this will instead append the value to + any existing header value with a comma. If no existing header value exists + for the key, then the value will simply be added, ignoring the combine parameter. + + >>> headers = HTTPHeaderDict(foo='bar') + >>> headers.add('Foo', 'baz') + >>> headers['foo'] + 'bar, baz' + >>> list(headers.items()) + [('foo', 'bar'), ('foo', 'baz')] + >>> headers.add('foo', 'quz', combine=True) + >>> list(headers.items()) + [('foo', 'bar, baz, quz')] + """ + # avoid a bytes/str comparison by decoding before httplib + if isinstance(key, bytes): + key = key.decode("latin-1") + key_lower = key.lower() + new_vals = [key, val] + # Keep the common case aka no item present as fast as possible + vals = self._container.setdefault(key_lower, new_vals) + if new_vals is not vals: + # if there are values here, then there is at least the initial + # key/value pair + assert len(vals) >= 2 + if combine: + vals[-1] = vals[-1] + ", " + val + else: + vals.append(val) + + def extend(self, *args: ValidHTTPHeaderSource, **kwargs: str) -> None: + """Generic import function for any type of header-like object. + Adapted version of MutableMapping.update in order to insert items + with self.add instead of self.__setitem__ + """ + if len(args) > 1: + raise TypeError( + f"extend() takes at most 1 positional arguments ({len(args)} given)" + ) + other = args[0] if len(args) >= 1 else () + + if isinstance(other, HTTPHeaderDict): + for key, val in other.iteritems(): + self.add(key, val) + elif isinstance(other, typing.Mapping): + for key, val in other.items(): + self.add(key, val) + elif isinstance(other, typing.Iterable): + other = typing.cast(typing.Iterable[typing.Tuple[str, str]], other) + for key, value in other: + self.add(key, value) + elif hasattr(other, "keys") and hasattr(other, "__getitem__"): + # THIS IS NOT A TYPESAFE BRANCH + # In this branch, the object has a `keys` attr but is not a Mapping or any of + # the other types indicated in the method signature. We do some stuff with + # it as though it partially implements the Mapping interface, but we're not + # doing that stuff safely AT ALL. + for key in other.keys(): + self.add(key, other[key]) + + for key, value in kwargs.items(): + self.add(key, value) + + @typing.overload + def getlist(self, key: str) -> list[str]: + ... + + @typing.overload + def getlist(self, key: str, default: _DT) -> list[str] | _DT: + ... + + def getlist( + self, key: str, default: _Sentinel | _DT = _Sentinel.not_passed + ) -> list[str] | _DT: + """Returns a list of all the values for the named field. Returns an + empty list if the key doesn't exist.""" + try: + vals = self._container[key.lower()] + except KeyError: + if default is _Sentinel.not_passed: + # _DT is unbound; empty list is instance of List[str] + return [] + # _DT is bound; default is instance of _DT + return default + else: + # _DT may or may not be bound; vals[1:] is instance of List[str], which + # meets our external interface requirement of `Union[List[str], _DT]`. + return vals[1:] + + def _prepare_for_method_change(self) -> Self: + """ + Remove content-specific header fields before changing the request + method to GET or HEAD according to RFC 9110, Section 15.4. + """ + content_specific_headers = [ + "Content-Encoding", + "Content-Language", + "Content-Location", + "Content-Type", + "Content-Length", + "Digest", + "Last-Modified", + ] + for header in content_specific_headers: + self.discard(header) + return self + + # Backwards compatibility for httplib + getheaders = getlist + getallmatchingheaders = getlist + iget = getlist + + # Backwards compatibility for http.cookiejar + get_all = getlist + + def __repr__(self) -> str: + return f"{type(self).__name__}({dict(self.itermerged())})" + + def _copy_from(self, other: HTTPHeaderDict) -> None: + for key in other: + val = other.getlist(key) + self._container[key.lower()] = [key, *val] + + def copy(self) -> Self: + clone = type(self)() + clone._copy_from(self) + return clone + + def iteritems(self) -> typing.Iterator[tuple[str, str]]: + """Iterate over all header lines, including duplicate ones.""" + for key in self: + vals = self._container[key.lower()] + for val in vals[1:]: + yield vals[0], val + + def itermerged(self) -> typing.Iterator[tuple[str, str]]: + """Iterate over all headers, merging duplicate ones together.""" + for key in self: + val = self._container[key.lower()] + yield val[0], ", ".join(val[1:]) + + def items(self) -> HTTPHeaderDictItemView: # type: ignore[override] + return HTTPHeaderDictItemView(self) + + def _has_value_for_header(self, header_name: str, potential_value: str) -> bool: + if header_name in self: + return potential_value in self._container[header_name.lower()][1:] + return False + + def __ior__(self, other: object) -> HTTPHeaderDict: + # Supports extending a header dict in-place using operator |= + # combining items with add instead of __setitem__ + maybe_constructable = ensure_can_construct_http_header_dict(other) + if maybe_constructable is None: + return NotImplemented + self.extend(maybe_constructable) + return self + + def __or__(self, other: object) -> Self: + # Supports merging header dicts using operator | + # combining items with add instead of __setitem__ + maybe_constructable = ensure_can_construct_http_header_dict(other) + if maybe_constructable is None: + return NotImplemented + result = self.copy() + result.extend(maybe_constructable) + return result + + def __ror__(self, other: object) -> Self: + # Supports merging header dicts using operator | when other is on left side + # combining items with add instead of __setitem__ + maybe_constructable = ensure_can_construct_http_header_dict(other) + if maybe_constructable is None: + return NotImplemented + result = type(self)(maybe_constructable) + result.extend(self) + return result diff --git a/.venv/lib/python3.12/site-packages/urllib3/_request_methods.py b/.venv/lib/python3.12/site-packages/urllib3/_request_methods.py new file mode 100644 index 0000000..632042f --- /dev/null +++ b/.venv/lib/python3.12/site-packages/urllib3/_request_methods.py @@ -0,0 +1,279 @@ +from __future__ import annotations + +import json as _json +import typing +from urllib.parse import urlencode + +from ._base_connection import _TYPE_BODY +from ._collections import HTTPHeaderDict +from .filepost import _TYPE_FIELDS, encode_multipart_formdata +from .response import BaseHTTPResponse + +__all__ = ["RequestMethods"] + +_TYPE_ENCODE_URL_FIELDS = typing.Union[ + typing.Sequence[typing.Tuple[str, typing.Union[str, bytes]]], + typing.Mapping[str, typing.Union[str, bytes]], +] + + +class RequestMethods: + """ + Convenience mixin for classes who implement a :meth:`urlopen` method, such + as :class:`urllib3.HTTPConnectionPool` and + :class:`urllib3.PoolManager`. + + Provides behavior for making common types of HTTP request methods and + decides which type of request field encoding to use. + + Specifically, + + :meth:`.request_encode_url` is for sending requests whose fields are + encoded in the URL (such as GET, HEAD, DELETE). + + :meth:`.request_encode_body` is for sending requests whose fields are + encoded in the *body* of the request using multipart or www-form-urlencoded + (such as for POST, PUT, PATCH). + + :meth:`.request` is for making any kind of request, it will look up the + appropriate encoding format and use one of the above two methods to make + the request. + + Initializer parameters: + + :param headers: + Headers to include with all requests, unless other headers are given + explicitly. + """ + + _encode_url_methods = {"DELETE", "GET", "HEAD", "OPTIONS"} + + def __init__(self, headers: typing.Mapping[str, str] | None = None) -> None: + self.headers = headers or {} + + def urlopen( + self, + method: str, + url: str, + body: _TYPE_BODY | None = None, + headers: typing.Mapping[str, str] | None = None, + encode_multipart: bool = True, + multipart_boundary: str | None = None, + **kw: typing.Any, + ) -> BaseHTTPResponse: # Abstract + raise NotImplementedError( + "Classes extending RequestMethods must implement " + "their own ``urlopen`` method." + ) + + def request( + self, + method: str, + url: str, + body: _TYPE_BODY | None = None, + fields: _TYPE_FIELDS | None = None, + headers: typing.Mapping[str, str] | None = None, + json: typing.Any | None = None, + **urlopen_kw: typing.Any, + ) -> BaseHTTPResponse: + """ + Make a request using :meth:`urlopen` with the appropriate encoding of + ``fields`` based on the ``method`` used. + + This is a convenience method that requires the least amount of manual + effort. It can be used in most situations, while still having the + option to drop down to more specific methods when necessary, such as + :meth:`request_encode_url`, :meth:`request_encode_body`, + or even the lowest level :meth:`urlopen`. + + :param method: + HTTP request method (such as GET, POST, PUT, etc.) + + :param url: + The URL to perform the request on. + + :param body: + Data to send in the request body, either :class:`str`, :class:`bytes`, + an iterable of :class:`str`/:class:`bytes`, or a file-like object. + + :param fields: + Data to encode and send in the request body. Values are processed + by :func:`urllib.parse.urlencode`. + + :param headers: + Dictionary of custom headers to send, such as User-Agent, + If-None-Match, etc. If None, pool headers are used. If provided, + these headers completely replace any pool-specific headers. + + :param json: + Data to encode and send as JSON with UTF-encoded in the request body. + The ``"Content-Type"`` header will be set to ``"application/json"`` + unless specified otherwise. + """ + method = method.upper() + + if json is not None and body is not None: + raise TypeError( + "request got values for both 'body' and 'json' parameters which are mutually exclusive" + ) + + if json is not None: + if headers is None: + headers = self.headers + + if not ("content-type" in map(str.lower, headers.keys())): + headers = HTTPHeaderDict(headers) + headers["Content-Type"] = "application/json" + + body = _json.dumps(json, separators=(",", ":"), ensure_ascii=False).encode( + "utf-8" + ) + + if body is not None: + urlopen_kw["body"] = body + + if method in self._encode_url_methods: + return self.request_encode_url( + method, + url, + fields=fields, # type: ignore[arg-type] + headers=headers, + **urlopen_kw, + ) + else: + return self.request_encode_body( + method, url, fields=fields, headers=headers, **urlopen_kw + ) + + def request_encode_url( + self, + method: str, + url: str, + fields: _TYPE_ENCODE_URL_FIELDS | None = None, + headers: typing.Mapping[str, str] | None = None, + **urlopen_kw: str, + ) -> BaseHTTPResponse: + """ + Make a request using :meth:`urlopen` with the ``fields`` encoded in + the url. This is useful for request methods like GET, HEAD, DELETE, etc. + + :param method: + HTTP request method (such as GET, POST, PUT, etc.) + + :param url: + The URL to perform the request on. + + :param fields: + Data to encode and send in the request body. + + :param headers: + Dictionary of custom headers to send, such as User-Agent, + If-None-Match, etc. If None, pool headers are used. If provided, + these headers completely replace any pool-specific headers. + """ + if headers is None: + headers = self.headers + + extra_kw: dict[str, typing.Any] = {"headers": headers} + extra_kw.update(urlopen_kw) + + if fields: + url += "?" + urlencode(fields) + + return self.urlopen(method, url, **extra_kw) + + def request_encode_body( + self, + method: str, + url: str, + fields: _TYPE_FIELDS | None = None, + headers: typing.Mapping[str, str] | None = None, + encode_multipart: bool = True, + multipart_boundary: str | None = None, + **urlopen_kw: str, + ) -> BaseHTTPResponse: + """ + Make a request using :meth:`urlopen` with the ``fields`` encoded in + the body. This is useful for request methods like POST, PUT, PATCH, etc. + + When ``encode_multipart=True`` (default), then + :func:`urllib3.encode_multipart_formdata` is used to encode + the payload with the appropriate content type. Otherwise + :func:`urllib.parse.urlencode` is used with the + 'application/x-www-form-urlencoded' content type. + + Multipart encoding must be used when posting files, and it's reasonably + safe to use it in other times too. However, it may break request + signing, such as with OAuth. + + Supports an optional ``fields`` parameter of key/value strings AND + key/filetuple. A filetuple is a (filename, data, MIME type) tuple where + the MIME type is optional. For example:: + + fields = { + 'foo': 'bar', + 'fakefile': ('foofile.txt', 'contents of foofile'), + 'realfile': ('barfile.txt', open('realfile').read()), + 'typedfile': ('bazfile.bin', open('bazfile').read(), + 'image/jpeg'), + 'nonamefile': 'contents of nonamefile field', + } + + When uploading a file, providing a filename (the first parameter of the + tuple) is optional but recommended to best mimic behavior of browsers. + + Note that if ``headers`` are supplied, the 'Content-Type' header will + be overwritten because it depends on the dynamic random boundary string + which is used to compose the body of the request. The random boundary + string can be explicitly set with the ``multipart_boundary`` parameter. + + :param method: + HTTP request method (such as GET, POST, PUT, etc.) + + :param url: + The URL to perform the request on. + + :param fields: + Data to encode and send in the request body. + + :param headers: + Dictionary of custom headers to send, such as User-Agent, + If-None-Match, etc. If None, pool headers are used. If provided, + these headers completely replace any pool-specific headers. + + :param encode_multipart: + If True, encode the ``fields`` using the multipart/form-data MIME + format. + + :param multipart_boundary: + If not specified, then a random boundary will be generated using + :func:`urllib3.filepost.choose_boundary`. + """ + if headers is None: + headers = self.headers + + extra_kw: dict[str, typing.Any] = {"headers": HTTPHeaderDict(headers)} + body: bytes | str + + if fields: + if "body" in urlopen_kw: + raise TypeError( + "request got values for both 'fields' and 'body', can only specify one." + ) + + if encode_multipart: + body, content_type = encode_multipart_formdata( + fields, boundary=multipart_boundary + ) + else: + body, content_type = ( + urlencode(fields), # type: ignore[arg-type] + "application/x-www-form-urlencoded", + ) + + extra_kw["body"] = body + extra_kw["headers"].setdefault("Content-Type", content_type) + + extra_kw.update(urlopen_kw) + + return self.urlopen(method, url, **extra_kw) diff --git a/.venv/lib/python3.12/site-packages/urllib3/_version.py b/.venv/lib/python3.12/site-packages/urllib3/_version.py new file mode 100644 index 0000000..7442f2b --- /dev/null +++ b/.venv/lib/python3.12/site-packages/urllib3/_version.py @@ -0,0 +1,4 @@ +# This file is protected via CODEOWNERS +from __future__ import annotations + +__version__ = "2.2.2" diff --git a/.venv/lib/python3.12/site-packages/urllib3/connection.py b/.venv/lib/python3.12/site-packages/urllib3/connection.py new file mode 100644 index 0000000..1b16279 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/urllib3/connection.py @@ -0,0 +1,929 @@ +from __future__ import annotations + +import datetime +import logging +import os +import re +import socket +import sys +import typing +import warnings +from http.client import HTTPConnection as _HTTPConnection +from http.client import HTTPException as HTTPException # noqa: F401 +from http.client import ResponseNotReady +from socket import timeout as SocketTimeout + +if typing.TYPE_CHECKING: + from .response import HTTPResponse + from .util.ssl_ import _TYPE_PEER_CERT_RET_DICT + from .util.ssltransport import SSLTransport + +from ._collections import HTTPHeaderDict +from .util.response import assert_header_parsing +from .util.timeout import _DEFAULT_TIMEOUT, _TYPE_TIMEOUT, Timeout +from .util.util import to_str +from .util.wait import wait_for_read + +try: # Compiled with SSL? + import ssl + + BaseSSLError = ssl.SSLError +except (ImportError, AttributeError): + ssl = None # type: ignore[assignment] + + class BaseSSLError(BaseException): # type: ignore[no-redef] + pass + + +from ._base_connection import _TYPE_BODY +from ._base_connection import ProxyConfig as ProxyConfig +from ._base_connection import _ResponseOptions as _ResponseOptions +from ._version import __version__ +from .exceptions import ( + ConnectTimeoutError, + HeaderParsingError, + NameResolutionError, + NewConnectionError, + ProxyError, + SystemTimeWarning, +) +from .util import SKIP_HEADER, SKIPPABLE_HEADERS, connection, ssl_ +from .util.request import body_to_chunks +from .util.ssl_ import assert_fingerprint as _assert_fingerprint +from .util.ssl_ import ( + create_urllib3_context, + is_ipaddress, + resolve_cert_reqs, + resolve_ssl_version, + ssl_wrap_socket, +) +from .util.ssl_match_hostname import CertificateError, match_hostname +from .util.url import Url + +# Not a no-op, we're adding this to the namespace so it can be imported. +ConnectionError = ConnectionError +BrokenPipeError = BrokenPipeError + + +log = logging.getLogger(__name__) + +port_by_scheme = {"http": 80, "https": 443} + +# When it comes time to update this value as a part of regular maintenance +# (ie test_recent_date is failing) update it to ~6 months before the current date. +RECENT_DATE = datetime.date(2023, 6, 1) + +_CONTAINS_CONTROL_CHAR_RE = re.compile(r"[^-!#$%&'*+.^_`|~0-9a-zA-Z]") + +_HAS_SYS_AUDIT = hasattr(sys, "audit") + + +class HTTPConnection(_HTTPConnection): + """ + Based on :class:`http.client.HTTPConnection` but provides an extra constructor + backwards-compatibility layer between older and newer Pythons. + + Additional keyword parameters are used to configure attributes of the connection. + Accepted parameters include: + + - ``source_address``: Set the source address for the current connection. + - ``socket_options``: Set specific options on the underlying socket. If not specified, then + defaults are loaded from ``HTTPConnection.default_socket_options`` which includes disabling + Nagle's algorithm (sets TCP_NODELAY to 1) unless the connection is behind a proxy. + + For example, if you wish to enable TCP Keep Alive in addition to the defaults, + you might pass: + + .. code-block:: python + + HTTPConnection.default_socket_options + [ + (socket.SOL_SOCKET, socket.SO_KEEPALIVE, 1), + ] + + Or you may want to disable the defaults by passing an empty list (e.g., ``[]``). + """ + + default_port: typing.ClassVar[int] = port_by_scheme["http"] # type: ignore[misc] + + #: Disable Nagle's algorithm by default. + #: ``[(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)]`` + default_socket_options: typing.ClassVar[connection._TYPE_SOCKET_OPTIONS] = [ + (socket.IPPROTO_TCP, socket.TCP_NODELAY, 1) + ] + + #: Whether this connection verifies the host's certificate. + is_verified: bool = False + + #: Whether this proxy connection verified the proxy host's certificate. + # If no proxy is currently connected to the value will be ``None``. + proxy_is_verified: bool | None = None + + blocksize: int + source_address: tuple[str, int] | None + socket_options: connection._TYPE_SOCKET_OPTIONS | None + + _has_connected_to_proxy: bool + _response_options: _ResponseOptions | None + _tunnel_host: str | None + _tunnel_port: int | None + _tunnel_scheme: str | None + + def __init__( + self, + host: str, + port: int | None = None, + *, + timeout: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT, + source_address: tuple[str, int] | None = None, + blocksize: int = 16384, + socket_options: None + | (connection._TYPE_SOCKET_OPTIONS) = default_socket_options, + proxy: Url | None = None, + proxy_config: ProxyConfig | None = None, + ) -> None: + super().__init__( + host=host, + port=port, + timeout=Timeout.resolve_default_timeout(timeout), + source_address=source_address, + blocksize=blocksize, + ) + self.socket_options = socket_options + self.proxy = proxy + self.proxy_config = proxy_config + + self._has_connected_to_proxy = False + self._response_options = None + self._tunnel_host: str | None = None + self._tunnel_port: int | None = None + self._tunnel_scheme: str | None = None + + @property + def host(self) -> str: + """ + Getter method to remove any trailing dots that indicate the hostname is an FQDN. + + In general, SSL certificates don't include the trailing dot indicating a + fully-qualified domain name, and thus, they don't validate properly when + checked against a domain name that includes the dot. In addition, some + servers may not expect to receive the trailing dot when provided. + + However, the hostname with trailing dot is critical to DNS resolution; doing a + lookup with the trailing dot will properly only resolve the appropriate FQDN, + whereas a lookup without a trailing dot will search the system's search domain + list. Thus, it's important to keep the original host around for use only in + those cases where it's appropriate (i.e., when doing DNS lookup to establish the + actual TCP connection across which we're going to send HTTP requests). + """ + return self._dns_host.rstrip(".") + + @host.setter + def host(self, value: str) -> None: + """ + Setter for the `host` property. + + We assume that only urllib3 uses the _dns_host attribute; httplib itself + only uses `host`, and it seems reasonable that other libraries follow suit. + """ + self._dns_host = value + + def _new_conn(self) -> socket.socket: + """Establish a socket connection and set nodelay settings on it. + + :return: New socket connection. + """ + try: + sock = connection.create_connection( + (self._dns_host, self.port), + self.timeout, + source_address=self.source_address, + socket_options=self.socket_options, + ) + except socket.gaierror as e: + raise NameResolutionError(self.host, self, e) from e + except SocketTimeout as e: + raise ConnectTimeoutError( + self, + f"Connection to {self.host} timed out. (connect timeout={self.timeout})", + ) from e + + except OSError as e: + raise NewConnectionError( + self, f"Failed to establish a new connection: {e}" + ) from e + + # Audit hooks are only available in Python 3.8+ + if _HAS_SYS_AUDIT: + sys.audit("http.client.connect", self, self.host, self.port) + + return sock + + def set_tunnel( + self, + host: str, + port: int | None = None, + headers: typing.Mapping[str, str] | None = None, + scheme: str = "http", + ) -> None: + if scheme not in ("http", "https"): + raise ValueError( + f"Invalid proxy scheme for tunneling: {scheme!r}, must be either 'http' or 'https'" + ) + super().set_tunnel(host, port=port, headers=headers) + self._tunnel_scheme = scheme + + def connect(self) -> None: + self.sock = self._new_conn() + if self._tunnel_host: + # If we're tunneling it means we're connected to our proxy. + self._has_connected_to_proxy = True + + # TODO: Fix tunnel so it doesn't depend on self.sock state. + self._tunnel() # type: ignore[attr-defined] + + # If there's a proxy to be connected to we are fully connected. + # This is set twice (once above and here) due to forwarding proxies + # not using tunnelling. + self._has_connected_to_proxy = bool(self.proxy) + + if self._has_connected_to_proxy: + self.proxy_is_verified = False + + @property + def is_closed(self) -> bool: + return self.sock is None + + @property + def is_connected(self) -> bool: + if self.sock is None: + return False + return not wait_for_read(self.sock, timeout=0.0) + + @property + def has_connected_to_proxy(self) -> bool: + return self._has_connected_to_proxy + + @property + def proxy_is_forwarding(self) -> bool: + """ + Return True if a forwarding proxy is configured, else return False + """ + return bool(self.proxy) and self._tunnel_host is None + + def close(self) -> None: + try: + super().close() + finally: + # Reset all stateful properties so connection + # can be re-used without leaking prior configs. + self.sock = None + self.is_verified = False + self.proxy_is_verified = None + self._has_connected_to_proxy = False + self._response_options = None + self._tunnel_host = None + self._tunnel_port = None + self._tunnel_scheme = None + + def putrequest( + self, + method: str, + url: str, + skip_host: bool = False, + skip_accept_encoding: bool = False, + ) -> None: + """""" + # Empty docstring because the indentation of CPython's implementation + # is broken but we don't want this method in our documentation. + match = _CONTAINS_CONTROL_CHAR_RE.search(method) + if match: + raise ValueError( + f"Method cannot contain non-token characters {method!r} (found at least {match.group()!r})" + ) + + return super().putrequest( + method, url, skip_host=skip_host, skip_accept_encoding=skip_accept_encoding + ) + + def putheader(self, header: str, *values: str) -> None: # type: ignore[override] + """""" + if not any(isinstance(v, str) and v == SKIP_HEADER for v in values): + super().putheader(header, *values) + elif to_str(header.lower()) not in SKIPPABLE_HEADERS: + skippable_headers = "', '".join( + [str.title(header) for header in sorted(SKIPPABLE_HEADERS)] + ) + raise ValueError( + f"urllib3.util.SKIP_HEADER only supports '{skippable_headers}'" + ) + + # `request` method's signature intentionally violates LSP. + # urllib3's API is different from `http.client.HTTPConnection` and the subclassing is only incidental. + def request( # type: ignore[override] + self, + method: str, + url: str, + body: _TYPE_BODY | None = None, + headers: typing.Mapping[str, str] | None = None, + *, + chunked: bool = False, + preload_content: bool = True, + decode_content: bool = True, + enforce_content_length: bool = True, + ) -> None: + # Update the inner socket's timeout value to send the request. + # This only triggers if the connection is re-used. + if self.sock is not None: + self.sock.settimeout(self.timeout) + + # Store these values to be fed into the HTTPResponse + # object later. TODO: Remove this in favor of a real + # HTTP lifecycle mechanism. + + # We have to store these before we call .request() + # because sometimes we can still salvage a response + # off the wire even if we aren't able to completely + # send the request body. + self._response_options = _ResponseOptions( + request_method=method, + request_url=url, + preload_content=preload_content, + decode_content=decode_content, + enforce_content_length=enforce_content_length, + ) + + if headers is None: + headers = {} + header_keys = frozenset(to_str(k.lower()) for k in headers) + skip_accept_encoding = "accept-encoding" in header_keys + skip_host = "host" in header_keys + self.putrequest( + method, url, skip_accept_encoding=skip_accept_encoding, skip_host=skip_host + ) + + # Transform the body into an iterable of sendall()-able chunks + # and detect if an explicit Content-Length is doable. + chunks_and_cl = body_to_chunks(body, method=method, blocksize=self.blocksize) + chunks = chunks_and_cl.chunks + content_length = chunks_and_cl.content_length + + # When chunked is explicit set to 'True' we respect that. + if chunked: + if "transfer-encoding" not in header_keys: + self.putheader("Transfer-Encoding", "chunked") + else: + # Detect whether a framing mechanism is already in use. If so + # we respect that value, otherwise we pick chunked vs content-length + # depending on the type of 'body'. + if "content-length" in header_keys: + chunked = False + elif "transfer-encoding" in header_keys: + chunked = True + + # Otherwise we go off the recommendation of 'body_to_chunks()'. + else: + chunked = False + if content_length is None: + if chunks is not None: + chunked = True + self.putheader("Transfer-Encoding", "chunked") + else: + self.putheader("Content-Length", str(content_length)) + + # Now that framing headers are out of the way we send all the other headers. + if "user-agent" not in header_keys: + self.putheader("User-Agent", _get_default_user_agent()) + for header, value in headers.items(): + self.putheader(header, value) + self.endheaders() + + # If we're given a body we start sending that in chunks. + if chunks is not None: + for chunk in chunks: + # Sending empty chunks isn't allowed for TE: chunked + # as it indicates the end of the body. + if not chunk: + continue + if isinstance(chunk, str): + chunk = chunk.encode("utf-8") + if chunked: + self.send(b"%x\r\n%b\r\n" % (len(chunk), chunk)) + else: + self.send(chunk) + + # Regardless of whether we have a body or not, if we're in + # chunked mode we want to send an explicit empty chunk. + if chunked: + self.send(b"0\r\n\r\n") + + def request_chunked( + self, + method: str, + url: str, + body: _TYPE_BODY | None = None, + headers: typing.Mapping[str, str] | None = None, + ) -> None: + """ + Alternative to the common request method, which sends the + body with chunked encoding and not as one block + """ + warnings.warn( + "HTTPConnection.request_chunked() is deprecated and will be removed " + "in urllib3 v2.1.0. Instead use HTTPConnection.request(..., chunked=True).", + category=DeprecationWarning, + stacklevel=2, + ) + self.request(method, url, body=body, headers=headers, chunked=True) + + def getresponse( # type: ignore[override] + self, + ) -> HTTPResponse: + """ + Get the response from the server. + + If the HTTPConnection is in the correct state, returns an instance of HTTPResponse or of whatever object is returned by the response_class variable. + + If a request has not been sent or if a previous response has not be handled, ResponseNotReady is raised. If the HTTP response indicates that the connection should be closed, then it will be closed before the response is returned. When the connection is closed, the underlying socket is closed. + """ + # Raise the same error as http.client.HTTPConnection + if self._response_options is None: + raise ResponseNotReady() + + # Reset this attribute for being used again. + resp_options = self._response_options + self._response_options = None + + # Since the connection's timeout value may have been updated + # we need to set the timeout on the socket. + self.sock.settimeout(self.timeout) + + # This is needed here to avoid circular import errors + from .response import HTTPResponse + + # Get the response from http.client.HTTPConnection + httplib_response = super().getresponse() + + try: + assert_header_parsing(httplib_response.msg) + except (HeaderParsingError, TypeError) as hpe: + log.warning( + "Failed to parse headers (url=%s): %s", + _url_from_connection(self, resp_options.request_url), + hpe, + exc_info=True, + ) + + headers = HTTPHeaderDict(httplib_response.msg.items()) + + response = HTTPResponse( + body=httplib_response, + headers=headers, + status=httplib_response.status, + version=httplib_response.version, + version_string=getattr(self, "_http_vsn_str", "HTTP/?"), + reason=httplib_response.reason, + preload_content=resp_options.preload_content, + decode_content=resp_options.decode_content, + original_response=httplib_response, + enforce_content_length=resp_options.enforce_content_length, + request_method=resp_options.request_method, + request_url=resp_options.request_url, + ) + return response + + +class HTTPSConnection(HTTPConnection): + """ + Many of the parameters to this constructor are passed to the underlying SSL + socket by means of :py:func:`urllib3.util.ssl_wrap_socket`. + """ + + default_port = port_by_scheme["https"] # type: ignore[misc] + + cert_reqs: int | str | None = None + ca_certs: str | None = None + ca_cert_dir: str | None = None + ca_cert_data: None | str | bytes = None + ssl_version: int | str | None = None + ssl_minimum_version: int | None = None + ssl_maximum_version: int | None = None + assert_fingerprint: str | None = None + + def __init__( + self, + host: str, + port: int | None = None, + *, + timeout: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT, + source_address: tuple[str, int] | None = None, + blocksize: int = 16384, + socket_options: None + | (connection._TYPE_SOCKET_OPTIONS) = HTTPConnection.default_socket_options, + proxy: Url | None = None, + proxy_config: ProxyConfig | None = None, + cert_reqs: int | str | None = None, + assert_hostname: None | str | typing.Literal[False] = None, + assert_fingerprint: str | None = None, + server_hostname: str | None = None, + ssl_context: ssl.SSLContext | None = None, + ca_certs: str | None = None, + ca_cert_dir: str | None = None, + ca_cert_data: None | str | bytes = None, + ssl_minimum_version: int | None = None, + ssl_maximum_version: int | None = None, + ssl_version: int | str | None = None, # Deprecated + cert_file: str | None = None, + key_file: str | None = None, + key_password: str | None = None, + ) -> None: + super().__init__( + host, + port=port, + timeout=timeout, + source_address=source_address, + blocksize=blocksize, + socket_options=socket_options, + proxy=proxy, + proxy_config=proxy_config, + ) + + self.key_file = key_file + self.cert_file = cert_file + self.key_password = key_password + self.ssl_context = ssl_context + self.server_hostname = server_hostname + self.assert_hostname = assert_hostname + self.assert_fingerprint = assert_fingerprint + self.ssl_version = ssl_version + self.ssl_minimum_version = ssl_minimum_version + self.ssl_maximum_version = ssl_maximum_version + self.ca_certs = ca_certs and os.path.expanduser(ca_certs) + self.ca_cert_dir = ca_cert_dir and os.path.expanduser(ca_cert_dir) + self.ca_cert_data = ca_cert_data + + # cert_reqs depends on ssl_context so calculate last. + if cert_reqs is None: + if self.ssl_context is not None: + cert_reqs = self.ssl_context.verify_mode + else: + cert_reqs = resolve_cert_reqs(None) + self.cert_reqs = cert_reqs + + def set_cert( + self, + key_file: str | None = None, + cert_file: str | None = None, + cert_reqs: int | str | None = None, + key_password: str | None = None, + ca_certs: str | None = None, + assert_hostname: None | str | typing.Literal[False] = None, + assert_fingerprint: str | None = None, + ca_cert_dir: str | None = None, + ca_cert_data: None | str | bytes = None, + ) -> None: + """ + This method should only be called once, before the connection is used. + """ + warnings.warn( + "HTTPSConnection.set_cert() is deprecated and will be removed " + "in urllib3 v2.1.0. Instead provide the parameters to the " + "HTTPSConnection constructor.", + category=DeprecationWarning, + stacklevel=2, + ) + + # If cert_reqs is not provided we'll assume CERT_REQUIRED unless we also + # have an SSLContext object in which case we'll use its verify_mode. + if cert_reqs is None: + if self.ssl_context is not None: + cert_reqs = self.ssl_context.verify_mode + else: + cert_reqs = resolve_cert_reqs(None) + + self.key_file = key_file + self.cert_file = cert_file + self.cert_reqs = cert_reqs + self.key_password = key_password + self.assert_hostname = assert_hostname + self.assert_fingerprint = assert_fingerprint + self.ca_certs = ca_certs and os.path.expanduser(ca_certs) + self.ca_cert_dir = ca_cert_dir and os.path.expanduser(ca_cert_dir) + self.ca_cert_data = ca_cert_data + + def connect(self) -> None: + sock: socket.socket | ssl.SSLSocket + self.sock = sock = self._new_conn() + server_hostname: str = self.host + tls_in_tls = False + + # Do we need to establish a tunnel? + if self._tunnel_host is not None: + # We're tunneling to an HTTPS origin so need to do TLS-in-TLS. + if self._tunnel_scheme == "https": + # _connect_tls_proxy will verify and assign proxy_is_verified + self.sock = sock = self._connect_tls_proxy(self.host, sock) + tls_in_tls = True + elif self._tunnel_scheme == "http": + self.proxy_is_verified = False + + # If we're tunneling it means we're connected to our proxy. + self._has_connected_to_proxy = True + + self._tunnel() # type: ignore[attr-defined] + # Override the host with the one we're requesting data from. + server_hostname = self._tunnel_host + + if self.server_hostname is not None: + server_hostname = self.server_hostname + + is_time_off = datetime.date.today() < RECENT_DATE + if is_time_off: + warnings.warn( + ( + f"System time is way off (before {RECENT_DATE}). This will probably " + "lead to SSL verification errors" + ), + SystemTimeWarning, + ) + + # Remove trailing '.' from fqdn hostnames to allow certificate validation + server_hostname_rm_dot = server_hostname.rstrip(".") + + sock_and_verified = _ssl_wrap_socket_and_match_hostname( + sock=sock, + cert_reqs=self.cert_reqs, + ssl_version=self.ssl_version, + ssl_minimum_version=self.ssl_minimum_version, + ssl_maximum_version=self.ssl_maximum_version, + ca_certs=self.ca_certs, + ca_cert_dir=self.ca_cert_dir, + ca_cert_data=self.ca_cert_data, + cert_file=self.cert_file, + key_file=self.key_file, + key_password=self.key_password, + server_hostname=server_hostname_rm_dot, + ssl_context=self.ssl_context, + tls_in_tls=tls_in_tls, + assert_hostname=self.assert_hostname, + assert_fingerprint=self.assert_fingerprint, + ) + self.sock = sock_and_verified.socket + + # Forwarding proxies can never have a verified target since + # the proxy is the one doing the verification. Should instead + # use a CONNECT tunnel in order to verify the target. + # See: https://github.com/urllib3/urllib3/issues/3267. + if self.proxy_is_forwarding: + self.is_verified = False + else: + self.is_verified = sock_and_verified.is_verified + + # If there's a proxy to be connected to we are fully connected. + # This is set twice (once above and here) due to forwarding proxies + # not using tunnelling. + self._has_connected_to_proxy = bool(self.proxy) + + # Set `self.proxy_is_verified` unless it's already set while + # establishing a tunnel. + if self._has_connected_to_proxy and self.proxy_is_verified is None: + self.proxy_is_verified = sock_and_verified.is_verified + + def _connect_tls_proxy(self, hostname: str, sock: socket.socket) -> ssl.SSLSocket: + """ + Establish a TLS connection to the proxy using the provided SSL context. + """ + # `_connect_tls_proxy` is called when self._tunnel_host is truthy. + proxy_config = typing.cast(ProxyConfig, self.proxy_config) + ssl_context = proxy_config.ssl_context + sock_and_verified = _ssl_wrap_socket_and_match_hostname( + sock, + cert_reqs=self.cert_reqs, + ssl_version=self.ssl_version, + ssl_minimum_version=self.ssl_minimum_version, + ssl_maximum_version=self.ssl_maximum_version, + ca_certs=self.ca_certs, + ca_cert_dir=self.ca_cert_dir, + ca_cert_data=self.ca_cert_data, + server_hostname=hostname, + ssl_context=ssl_context, + assert_hostname=proxy_config.assert_hostname, + assert_fingerprint=proxy_config.assert_fingerprint, + # Features that aren't implemented for proxies yet: + cert_file=None, + key_file=None, + key_password=None, + tls_in_tls=False, + ) + self.proxy_is_verified = sock_and_verified.is_verified + return sock_and_verified.socket # type: ignore[return-value] + + +class _WrappedAndVerifiedSocket(typing.NamedTuple): + """ + Wrapped socket and whether the connection is + verified after the TLS handshake + """ + + socket: ssl.SSLSocket | SSLTransport + is_verified: bool + + +def _ssl_wrap_socket_and_match_hostname( + sock: socket.socket, + *, + cert_reqs: None | str | int, + ssl_version: None | str | int, + ssl_minimum_version: int | None, + ssl_maximum_version: int | None, + cert_file: str | None, + key_file: str | None, + key_password: str | None, + ca_certs: str | None, + ca_cert_dir: str | None, + ca_cert_data: None | str | bytes, + assert_hostname: None | str | typing.Literal[False], + assert_fingerprint: str | None, + server_hostname: str | None, + ssl_context: ssl.SSLContext | None, + tls_in_tls: bool = False, +) -> _WrappedAndVerifiedSocket: + """Logic for constructing an SSLContext from all TLS parameters, passing + that down into ssl_wrap_socket, and then doing certificate verification + either via hostname or fingerprint. This function exists to guarantee + that both proxies and targets have the same behavior when connecting via TLS. + """ + default_ssl_context = False + if ssl_context is None: + default_ssl_context = True + context = create_urllib3_context( + ssl_version=resolve_ssl_version(ssl_version), + ssl_minimum_version=ssl_minimum_version, + ssl_maximum_version=ssl_maximum_version, + cert_reqs=resolve_cert_reqs(cert_reqs), + ) + else: + context = ssl_context + + context.verify_mode = resolve_cert_reqs(cert_reqs) + + # In some cases, we want to verify hostnames ourselves + if ( + # `ssl` can't verify fingerprints or alternate hostnames + assert_fingerprint + or assert_hostname + # assert_hostname can be set to False to disable hostname checking + or assert_hostname is False + # We still support OpenSSL 1.0.2, which prevents us from verifying + # hostnames easily: https://github.com/pyca/pyopenssl/pull/933 + or ssl_.IS_PYOPENSSL + or not ssl_.HAS_NEVER_CHECK_COMMON_NAME + ): + context.check_hostname = False + + # Try to load OS default certs if none are given. We need to do the hasattr() check + # for custom pyOpenSSL SSLContext objects because they don't support + # load_default_certs(). + if ( + not ca_certs + and not ca_cert_dir + and not ca_cert_data + and default_ssl_context + and hasattr(context, "load_default_certs") + ): + context.load_default_certs() + + # Ensure that IPv6 addresses are in the proper format and don't have a + # scope ID. Python's SSL module fails to recognize scoped IPv6 addresses + # and interprets them as DNS hostnames. + if server_hostname is not None: + normalized = server_hostname.strip("[]") + if "%" in normalized: + normalized = normalized[: normalized.rfind("%")] + if is_ipaddress(normalized): + server_hostname = normalized + + ssl_sock = ssl_wrap_socket( + sock=sock, + keyfile=key_file, + certfile=cert_file, + key_password=key_password, + ca_certs=ca_certs, + ca_cert_dir=ca_cert_dir, + ca_cert_data=ca_cert_data, + server_hostname=server_hostname, + ssl_context=context, + tls_in_tls=tls_in_tls, + ) + + try: + if assert_fingerprint: + _assert_fingerprint( + ssl_sock.getpeercert(binary_form=True), assert_fingerprint + ) + elif ( + context.verify_mode != ssl.CERT_NONE + and not context.check_hostname + and assert_hostname is not False + ): + cert: _TYPE_PEER_CERT_RET_DICT = ssl_sock.getpeercert() # type: ignore[assignment] + + # Need to signal to our match_hostname whether to use 'commonName' or not. + # If we're using our own constructed SSLContext we explicitly set 'False' + # because PyPy hard-codes 'True' from SSLContext.hostname_checks_common_name. + if default_ssl_context: + hostname_checks_common_name = False + else: + hostname_checks_common_name = ( + getattr(context, "hostname_checks_common_name", False) or False + ) + + _match_hostname( + cert, + assert_hostname or server_hostname, # type: ignore[arg-type] + hostname_checks_common_name, + ) + + return _WrappedAndVerifiedSocket( + socket=ssl_sock, + is_verified=context.verify_mode == ssl.CERT_REQUIRED + or bool(assert_fingerprint), + ) + except BaseException: + ssl_sock.close() + raise + + +def _match_hostname( + cert: _TYPE_PEER_CERT_RET_DICT | None, + asserted_hostname: str, + hostname_checks_common_name: bool = False, +) -> None: + # Our upstream implementation of ssl.match_hostname() + # only applies this normalization to IP addresses so it doesn't + # match DNS SANs so we do the same thing! + stripped_hostname = asserted_hostname.strip("[]") + if is_ipaddress(stripped_hostname): + asserted_hostname = stripped_hostname + + try: + match_hostname(cert, asserted_hostname, hostname_checks_common_name) + except CertificateError as e: + log.warning( + "Certificate did not match expected hostname: %s. Certificate: %s", + asserted_hostname, + cert, + ) + # Add cert to exception and reraise so client code can inspect + # the cert when catching the exception, if they want to + e._peer_cert = cert # type: ignore[attr-defined] + raise + + +def _wrap_proxy_error(err: Exception, proxy_scheme: str | None) -> ProxyError: + # Look for the phrase 'wrong version number', if found + # then we should warn the user that we're very sure that + # this proxy is HTTP-only and they have a configuration issue. + error_normalized = " ".join(re.split("[^a-z]", str(err).lower())) + is_likely_http_proxy = ( + "wrong version number" in error_normalized + or "unknown protocol" in error_normalized + or "record layer failure" in error_normalized + ) + http_proxy_warning = ( + ". Your proxy appears to only use HTTP and not HTTPS, " + "try changing your proxy URL to be HTTP. See: " + "https://urllib3.readthedocs.io/en/latest/advanced-usage.html" + "#https-proxy-error-http-proxy" + ) + new_err = ProxyError( + f"Unable to connect to proxy" + f"{http_proxy_warning if is_likely_http_proxy and proxy_scheme == 'https' else ''}", + err, + ) + new_err.__cause__ = err + return new_err + + +def _get_default_user_agent() -> str: + return f"python-urllib3/{__version__}" + + +class DummyConnection: + """Used to detect a failed ConnectionCls import.""" + + +if not ssl: + HTTPSConnection = DummyConnection # type: ignore[misc, assignment] # noqa: F811 + + +VerifiedHTTPSConnection = HTTPSConnection + + +def _url_from_connection( + conn: HTTPConnection | HTTPSConnection, path: str | None = None +) -> str: + """Returns the URL from a given connection. This is mainly used for testing and logging.""" + + scheme = "https" if isinstance(conn, HTTPSConnection) else "http" + + return Url(scheme=scheme, host=conn.host, port=conn.port, path=path).url diff --git a/.venv/lib/python3.12/site-packages/urllib3/connectionpool.py b/.venv/lib/python3.12/site-packages/urllib3/connectionpool.py new file mode 100644 index 0000000..a2c3cf6 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/urllib3/connectionpool.py @@ -0,0 +1,1182 @@ +from __future__ import annotations + +import errno +import logging +import queue +import sys +import typing +import warnings +import weakref +from socket import timeout as SocketTimeout +from types import TracebackType + +from ._base_connection import _TYPE_BODY +from ._collections import HTTPHeaderDict +from ._request_methods import RequestMethods +from .connection import ( + BaseSSLError, + BrokenPipeError, + DummyConnection, + HTTPConnection, + HTTPException, + HTTPSConnection, + ProxyConfig, + _wrap_proxy_error, +) +from .connection import port_by_scheme as port_by_scheme +from .exceptions import ( + ClosedPoolError, + EmptyPoolError, + FullPoolError, + HostChangedError, + InsecureRequestWarning, + LocationValueError, + MaxRetryError, + NewConnectionError, + ProtocolError, + ProxyError, + ReadTimeoutError, + SSLError, + TimeoutError, +) +from .response import BaseHTTPResponse +from .util.connection import is_connection_dropped +from .util.proxy import connection_requires_http_tunnel +from .util.request import _TYPE_BODY_POSITION, set_file_position +from .util.retry import Retry +from .util.ssl_match_hostname import CertificateError +from .util.timeout import _DEFAULT_TIMEOUT, _TYPE_DEFAULT, Timeout +from .util.url import Url, _encode_target +from .util.url import _normalize_host as normalize_host +from .util.url import parse_url +from .util.util import to_str + +if typing.TYPE_CHECKING: + import ssl + + from typing_extensions import Self + + from ._base_connection import BaseHTTPConnection, BaseHTTPSConnection + +log = logging.getLogger(__name__) + +_TYPE_TIMEOUT = typing.Union[Timeout, float, _TYPE_DEFAULT, None] + + +# Pool objects +class ConnectionPool: + """ + Base class for all connection pools, such as + :class:`.HTTPConnectionPool` and :class:`.HTTPSConnectionPool`. + + .. note:: + ConnectionPool.urlopen() does not normalize or percent-encode target URIs + which is useful if your target server doesn't support percent-encoded + target URIs. + """ + + scheme: str | None = None + QueueCls = queue.LifoQueue + + def __init__(self, host: str, port: int | None = None) -> None: + if not host: + raise LocationValueError("No host specified.") + + self.host = _normalize_host(host, scheme=self.scheme) + self.port = port + + # This property uses 'normalize_host()' (not '_normalize_host()') + # to avoid removing square braces around IPv6 addresses. + # This value is sent to `HTTPConnection.set_tunnel()` if called + # because square braces are required for HTTP CONNECT tunneling. + self._tunnel_host = normalize_host(host, scheme=self.scheme).lower() + + def __str__(self) -> str: + return f"{type(self).__name__}(host={self.host!r}, port={self.port!r})" + + def __enter__(self) -> Self: + return self + + def __exit__( + self, + exc_type: type[BaseException] | None, + exc_val: BaseException | None, + exc_tb: TracebackType | None, + ) -> typing.Literal[False]: + self.close() + # Return False to re-raise any potential exceptions + return False + + def close(self) -> None: + """ + Close all pooled connections and disable the pool. + """ + + +# This is taken from http://hg.python.org/cpython/file/7aaba721ebc0/Lib/socket.py#l252 +_blocking_errnos = {errno.EAGAIN, errno.EWOULDBLOCK} + + +class HTTPConnectionPool(ConnectionPool, RequestMethods): + """ + Thread-safe connection pool for one host. + + :param host: + Host used for this HTTP Connection (e.g. "localhost"), passed into + :class:`http.client.HTTPConnection`. + + :param port: + Port used for this HTTP Connection (None is equivalent to 80), passed + into :class:`http.client.HTTPConnection`. + + :param timeout: + Socket timeout in seconds for each individual connection. This can + be a float or integer, which sets the timeout for the HTTP request, + or an instance of :class:`urllib3.util.Timeout` which gives you more + fine-grained control over request timeouts. After the constructor has + been parsed, this is always a `urllib3.util.Timeout` object. + + :param maxsize: + Number of connections to save that can be reused. More than 1 is useful + in multithreaded situations. If ``block`` is set to False, more + connections will be created but they will not be saved once they've + been used. + + :param block: + If set to True, no more than ``maxsize`` connections will be used at + a time. When no free connections are available, the call will block + until a connection has been released. This is a useful side effect for + particular multithreaded situations where one does not want to use more + than maxsize connections per host to prevent flooding. + + :param headers: + Headers to include with all requests, unless other headers are given + explicitly. + + :param retries: + Retry configuration to use by default with requests in this pool. + + :param _proxy: + Parsed proxy URL, should not be used directly, instead, see + :class:`urllib3.ProxyManager` + + :param _proxy_headers: + A dictionary with proxy headers, should not be used directly, + instead, see :class:`urllib3.ProxyManager` + + :param \\**conn_kw: + Additional parameters are used to create fresh :class:`urllib3.connection.HTTPConnection`, + :class:`urllib3.connection.HTTPSConnection` instances. + """ + + scheme = "http" + ConnectionCls: ( + type[BaseHTTPConnection] | type[BaseHTTPSConnection] + ) = HTTPConnection + + def __init__( + self, + host: str, + port: int | None = None, + timeout: _TYPE_TIMEOUT | None = _DEFAULT_TIMEOUT, + maxsize: int = 1, + block: bool = False, + headers: typing.Mapping[str, str] | None = None, + retries: Retry | bool | int | None = None, + _proxy: Url | None = None, + _proxy_headers: typing.Mapping[str, str] | None = None, + _proxy_config: ProxyConfig | None = None, + **conn_kw: typing.Any, + ): + ConnectionPool.__init__(self, host, port) + RequestMethods.__init__(self, headers) + + if not isinstance(timeout, Timeout): + timeout = Timeout.from_float(timeout) + + if retries is None: + retries = Retry.DEFAULT + + self.timeout = timeout + self.retries = retries + + self.pool: queue.LifoQueue[typing.Any] | None = self.QueueCls(maxsize) + self.block = block + + self.proxy = _proxy + self.proxy_headers = _proxy_headers or {} + self.proxy_config = _proxy_config + + # Fill the queue up so that doing get() on it will block properly + for _ in range(maxsize): + self.pool.put(None) + + # These are mostly for testing and debugging purposes. + self.num_connections = 0 + self.num_requests = 0 + self.conn_kw = conn_kw + + if self.proxy: + # Enable Nagle's algorithm for proxies, to avoid packet fragmentation. + # We cannot know if the user has added default socket options, so we cannot replace the + # list. + self.conn_kw.setdefault("socket_options", []) + + self.conn_kw["proxy"] = self.proxy + self.conn_kw["proxy_config"] = self.proxy_config + + # Do not pass 'self' as callback to 'finalize'. + # Then the 'finalize' would keep an endless living (leak) to self. + # By just passing a reference to the pool allows the garbage collector + # to free self if nobody else has a reference to it. + pool = self.pool + + # Close all the HTTPConnections in the pool before the + # HTTPConnectionPool object is garbage collected. + weakref.finalize(self, _close_pool_connections, pool) + + def _new_conn(self) -> BaseHTTPConnection: + """ + Return a fresh :class:`HTTPConnection`. + """ + self.num_connections += 1 + log.debug( + "Starting new HTTP connection (%d): %s:%s", + self.num_connections, + self.host, + self.port or "80", + ) + + conn = self.ConnectionCls( + host=self.host, + port=self.port, + timeout=self.timeout.connect_timeout, + **self.conn_kw, + ) + return conn + + def _get_conn(self, timeout: float | None = None) -> BaseHTTPConnection: + """ + Get a connection. Will return a pooled connection if one is available. + + If no connections are available and :prop:`.block` is ``False``, then a + fresh connection is returned. + + :param timeout: + Seconds to wait before giving up and raising + :class:`urllib3.exceptions.EmptyPoolError` if the pool is empty and + :prop:`.block` is ``True``. + """ + conn = None + + if self.pool is None: + raise ClosedPoolError(self, "Pool is closed.") + + try: + conn = self.pool.get(block=self.block, timeout=timeout) + + except AttributeError: # self.pool is None + raise ClosedPoolError(self, "Pool is closed.") from None # Defensive: + + except queue.Empty: + if self.block: + raise EmptyPoolError( + self, + "Pool is empty and a new connection can't be opened due to blocking mode.", + ) from None + pass # Oh well, we'll create a new connection then + + # If this is a persistent connection, check if it got disconnected + if conn and is_connection_dropped(conn): + log.debug("Resetting dropped connection: %s", self.host) + conn.close() + + return conn or self._new_conn() + + def _put_conn(self, conn: BaseHTTPConnection | None) -> None: + """ + Put a connection back into the pool. + + :param conn: + Connection object for the current host and port as returned by + :meth:`._new_conn` or :meth:`._get_conn`. + + If the pool is already full, the connection is closed and discarded + because we exceeded maxsize. If connections are discarded frequently, + then maxsize should be increased. + + If the pool is closed, then the connection will be closed and discarded. + """ + if self.pool is not None: + try: + self.pool.put(conn, block=False) + return # Everything is dandy, done. + except AttributeError: + # self.pool is None. + pass + except queue.Full: + # Connection never got put back into the pool, close it. + if conn: + conn.close() + + if self.block: + # This should never happen if you got the conn from self._get_conn + raise FullPoolError( + self, + "Pool reached maximum size and no more connections are allowed.", + ) from None + + log.warning( + "Connection pool is full, discarding connection: %s. Connection pool size: %s", + self.host, + self.pool.qsize(), + ) + + # Connection never got put back into the pool, close it. + if conn: + conn.close() + + def _validate_conn(self, conn: BaseHTTPConnection) -> None: + """ + Called right before a request is made, after the socket is created. + """ + + def _prepare_proxy(self, conn: BaseHTTPConnection) -> None: + # Nothing to do for HTTP connections. + pass + + def _get_timeout(self, timeout: _TYPE_TIMEOUT) -> Timeout: + """Helper that always returns a :class:`urllib3.util.Timeout`""" + if timeout is _DEFAULT_TIMEOUT: + return self.timeout.clone() + + if isinstance(timeout, Timeout): + return timeout.clone() + else: + # User passed us an int/float. This is for backwards compatibility, + # can be removed later + return Timeout.from_float(timeout) + + def _raise_timeout( + self, + err: BaseSSLError | OSError | SocketTimeout, + url: str, + timeout_value: _TYPE_TIMEOUT | None, + ) -> None: + """Is the error actually a timeout? Will raise a ReadTimeout or pass""" + + if isinstance(err, SocketTimeout): + raise ReadTimeoutError( + self, url, f"Read timed out. (read timeout={timeout_value})" + ) from err + + # See the above comment about EAGAIN in Python 3. + if hasattr(err, "errno") and err.errno in _blocking_errnos: + raise ReadTimeoutError( + self, url, f"Read timed out. (read timeout={timeout_value})" + ) from err + + def _make_request( + self, + conn: BaseHTTPConnection, + method: str, + url: str, + body: _TYPE_BODY | None = None, + headers: typing.Mapping[str, str] | None = None, + retries: Retry | None = None, + timeout: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT, + chunked: bool = False, + response_conn: BaseHTTPConnection | None = None, + preload_content: bool = True, + decode_content: bool = True, + enforce_content_length: bool = True, + ) -> BaseHTTPResponse: + """ + Perform a request on a given urllib connection object taken from our + pool. + + :param conn: + a connection from one of our connection pools + + :param method: + HTTP request method (such as GET, POST, PUT, etc.) + + :param url: + The URL to perform the request on. + + :param body: + Data to send in the request body, either :class:`str`, :class:`bytes`, + an iterable of :class:`str`/:class:`bytes`, or a file-like object. + + :param headers: + Dictionary of custom headers to send, such as User-Agent, + If-None-Match, etc. If None, pool headers are used. If provided, + these headers completely replace any pool-specific headers. + + :param retries: + Configure the number of retries to allow before raising a + :class:`~urllib3.exceptions.MaxRetryError` exception. + + Pass ``None`` to retry until you receive a response. Pass a + :class:`~urllib3.util.retry.Retry` object for fine-grained control + over different types of retries. + Pass an integer number to retry connection errors that many times, + but no other types of errors. Pass zero to never retry. + + If ``False``, then retries are disabled and any exception is raised + immediately. Also, instead of raising a MaxRetryError on redirects, + the redirect response will be returned. + + :type retries: :class:`~urllib3.util.retry.Retry`, False, or an int. + + :param timeout: + If specified, overrides the default timeout for this one + request. It may be a float (in seconds) or an instance of + :class:`urllib3.util.Timeout`. + + :param chunked: + If True, urllib3 will send the body using chunked transfer + encoding. Otherwise, urllib3 will send the body using the standard + content-length form. Defaults to False. + + :param response_conn: + Set this to ``None`` if you will handle releasing the connection or + set the connection to have the response release it. + + :param preload_content: + If True, the response's body will be preloaded during construction. + + :param decode_content: + If True, will attempt to decode the body based on the + 'content-encoding' header. + + :param enforce_content_length: + Enforce content length checking. Body returned by server must match + value of Content-Length header, if present. Otherwise, raise error. + """ + self.num_requests += 1 + + timeout_obj = self._get_timeout(timeout) + timeout_obj.start_connect() + conn.timeout = Timeout.resolve_default_timeout(timeout_obj.connect_timeout) + + try: + # Trigger any extra validation we need to do. + try: + self._validate_conn(conn) + except (SocketTimeout, BaseSSLError) as e: + self._raise_timeout(err=e, url=url, timeout_value=conn.timeout) + raise + + # _validate_conn() starts the connection to an HTTPS proxy + # so we need to wrap errors with 'ProxyError' here too. + except ( + OSError, + NewConnectionError, + TimeoutError, + BaseSSLError, + CertificateError, + SSLError, + ) as e: + new_e: Exception = e + if isinstance(e, (BaseSSLError, CertificateError)): + new_e = SSLError(e) + # If the connection didn't successfully connect to it's proxy + # then there + if isinstance( + new_e, (OSError, NewConnectionError, TimeoutError, SSLError) + ) and (conn and conn.proxy and not conn.has_connected_to_proxy): + new_e = _wrap_proxy_error(new_e, conn.proxy.scheme) + raise new_e + + # conn.request() calls http.client.*.request, not the method in + # urllib3.request. It also calls makefile (recv) on the socket. + try: + conn.request( + method, + url, + body=body, + headers=headers, + chunked=chunked, + preload_content=preload_content, + decode_content=decode_content, + enforce_content_length=enforce_content_length, + ) + + # We are swallowing BrokenPipeError (errno.EPIPE) since the server is + # legitimately able to close the connection after sending a valid response. + # With this behaviour, the received response is still readable. + except BrokenPipeError: + pass + except OSError as e: + # MacOS/Linux + # EPROTOTYPE and ECONNRESET are needed on macOS + # https://erickt.github.io/blog/2014/11/19/adventures-in-debugging-a-potential-osx-kernel-bug/ + # Condition changed later to emit ECONNRESET instead of only EPROTOTYPE. + if e.errno != errno.EPROTOTYPE and e.errno != errno.ECONNRESET: + raise + + # Reset the timeout for the recv() on the socket + read_timeout = timeout_obj.read_timeout + + if not conn.is_closed: + # In Python 3 socket.py will catch EAGAIN and return None when you + # try and read into the file pointer created by http.client, which + # instead raises a BadStatusLine exception. Instead of catching + # the exception and assuming all BadStatusLine exceptions are read + # timeouts, check for a zero timeout before making the request. + if read_timeout == 0: + raise ReadTimeoutError( + self, url, f"Read timed out. (read timeout={read_timeout})" + ) + conn.timeout = read_timeout + + # Receive the response from the server + try: + response = conn.getresponse() + except (BaseSSLError, OSError) as e: + self._raise_timeout(err=e, url=url, timeout_value=read_timeout) + raise + + # Set properties that are used by the pooling layer. + response.retries = retries + response._connection = response_conn # type: ignore[attr-defined] + response._pool = self # type: ignore[attr-defined] + + log.debug( + '%s://%s:%s "%s %s HTTP/%s" %s %s', + self.scheme, + self.host, + self.port, + method, + url, + response.version, + response.status, + response.length_remaining, + ) + + return response + + def close(self) -> None: + """ + Close all pooled connections and disable the pool. + """ + if self.pool is None: + return + # Disable access to the pool + old_pool, self.pool = self.pool, None + + # Close all the HTTPConnections in the pool. + _close_pool_connections(old_pool) + + def is_same_host(self, url: str) -> bool: + """ + Check if the given ``url`` is a member of the same host as this + connection pool. + """ + if url.startswith("/"): + return True + + # TODO: Add optional support for socket.gethostbyname checking. + scheme, _, host, port, *_ = parse_url(url) + scheme = scheme or "http" + if host is not None: + host = _normalize_host(host, scheme=scheme) + + # Use explicit default port for comparison when none is given + if self.port and not port: + port = port_by_scheme.get(scheme) + elif not self.port and port == port_by_scheme.get(scheme): + port = None + + return (scheme, host, port) == (self.scheme, self.host, self.port) + + def urlopen( # type: ignore[override] + self, + method: str, + url: str, + body: _TYPE_BODY | None = None, + headers: typing.Mapping[str, str] | None = None, + retries: Retry | bool | int | None = None, + redirect: bool = True, + assert_same_host: bool = True, + timeout: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT, + pool_timeout: int | None = None, + release_conn: bool | None = None, + chunked: bool = False, + body_pos: _TYPE_BODY_POSITION | None = None, + preload_content: bool = True, + decode_content: bool = True, + **response_kw: typing.Any, + ) -> BaseHTTPResponse: + """ + Get a connection from the pool and perform an HTTP request. This is the + lowest level call for making a request, so you'll need to specify all + the raw details. + + .. note:: + + More commonly, it's appropriate to use a convenience method + such as :meth:`request`. + + .. note:: + + `release_conn` will only behave as expected if + `preload_content=False` because we want to make + `preload_content=False` the default behaviour someday soon without + breaking backwards compatibility. + + :param method: + HTTP request method (such as GET, POST, PUT, etc.) + + :param url: + The URL to perform the request on. + + :param body: + Data to send in the request body, either :class:`str`, :class:`bytes`, + an iterable of :class:`str`/:class:`bytes`, or a file-like object. + + :param headers: + Dictionary of custom headers to send, such as User-Agent, + If-None-Match, etc. If None, pool headers are used. If provided, + these headers completely replace any pool-specific headers. + + :param retries: + Configure the number of retries to allow before raising a + :class:`~urllib3.exceptions.MaxRetryError` exception. + + If ``None`` (default) will retry 3 times, see ``Retry.DEFAULT``. Pass a + :class:`~urllib3.util.retry.Retry` object for fine-grained control + over different types of retries. + Pass an integer number to retry connection errors that many times, + but no other types of errors. Pass zero to never retry. + + If ``False``, then retries are disabled and any exception is raised + immediately. Also, instead of raising a MaxRetryError on redirects, + the redirect response will be returned. + + :type retries: :class:`~urllib3.util.retry.Retry`, False, or an int. + + :param redirect: + If True, automatically handle redirects (status codes 301, 302, + 303, 307, 308). Each redirect counts as a retry. Disabling retries + will disable redirect, too. + + :param assert_same_host: + If ``True``, will make sure that the host of the pool requests is + consistent else will raise HostChangedError. When ``False``, you can + use the pool on an HTTP proxy and request foreign hosts. + + :param timeout: + If specified, overrides the default timeout for this one + request. It may be a float (in seconds) or an instance of + :class:`urllib3.util.Timeout`. + + :param pool_timeout: + If set and the pool is set to block=True, then this method will + block for ``pool_timeout`` seconds and raise EmptyPoolError if no + connection is available within the time period. + + :param bool preload_content: + If True, the response's body will be preloaded into memory. + + :param bool decode_content: + If True, will attempt to decode the body based on the + 'content-encoding' header. + + :param release_conn: + If False, then the urlopen call will not release the connection + back into the pool once a response is received (but will release if + you read the entire contents of the response such as when + `preload_content=True`). This is useful if you're not preloading + the response's content immediately. You will need to call + ``r.release_conn()`` on the response ``r`` to return the connection + back into the pool. If None, it takes the value of ``preload_content`` + which defaults to ``True``. + + :param bool chunked: + If True, urllib3 will send the body using chunked transfer + encoding. Otherwise, urllib3 will send the body using the standard + content-length form. Defaults to False. + + :param int body_pos: + Position to seek to in file-like body in the event of a retry or + redirect. Typically this won't need to be set because urllib3 will + auto-populate the value when needed. + """ + parsed_url = parse_url(url) + destination_scheme = parsed_url.scheme + + if headers is None: + headers = self.headers + + if not isinstance(retries, Retry): + retries = Retry.from_int(retries, redirect=redirect, default=self.retries) + + if release_conn is None: + release_conn = preload_content + + # Check host + if assert_same_host and not self.is_same_host(url): + raise HostChangedError(self, url, retries) + + # Ensure that the URL we're connecting to is properly encoded + if url.startswith("/"): + url = to_str(_encode_target(url)) + else: + url = to_str(parsed_url.url) + + conn = None + + # Track whether `conn` needs to be released before + # returning/raising/recursing. Update this variable if necessary, and + # leave `release_conn` constant throughout the function. That way, if + # the function recurses, the original value of `release_conn` will be + # passed down into the recursive call, and its value will be respected. + # + # See issue #651 [1] for details. + # + # [1] + release_this_conn = release_conn + + http_tunnel_required = connection_requires_http_tunnel( + self.proxy, self.proxy_config, destination_scheme + ) + + # Merge the proxy headers. Only done when not using HTTP CONNECT. We + # have to copy the headers dict so we can safely change it without those + # changes being reflected in anyone else's copy. + if not http_tunnel_required: + headers = headers.copy() # type: ignore[attr-defined] + headers.update(self.proxy_headers) # type: ignore[union-attr] + + # Must keep the exception bound to a separate variable or else Python 3 + # complains about UnboundLocalError. + err = None + + # Keep track of whether we cleanly exited the except block. This + # ensures we do proper cleanup in finally. + clean_exit = False + + # Rewind body position, if needed. Record current position + # for future rewinds in the event of a redirect/retry. + body_pos = set_file_position(body, body_pos) + + try: + # Request a connection from the queue. + timeout_obj = self._get_timeout(timeout) + conn = self._get_conn(timeout=pool_timeout) + + conn.timeout = timeout_obj.connect_timeout # type: ignore[assignment] + + # Is this a closed/new connection that requires CONNECT tunnelling? + if self.proxy is not None and http_tunnel_required and conn.is_closed: + try: + self._prepare_proxy(conn) + except (BaseSSLError, OSError, SocketTimeout) as e: + self._raise_timeout( + err=e, url=self.proxy.url, timeout_value=conn.timeout + ) + raise + + # If we're going to release the connection in ``finally:``, then + # the response doesn't need to know about the connection. Otherwise + # it will also try to release it and we'll have a double-release + # mess. + response_conn = conn if not release_conn else None + + # Make the request on the HTTPConnection object + response = self._make_request( + conn, + method, + url, + timeout=timeout_obj, + body=body, + headers=headers, + chunked=chunked, + retries=retries, + response_conn=response_conn, + preload_content=preload_content, + decode_content=decode_content, + **response_kw, + ) + + # Everything went great! + clean_exit = True + + except EmptyPoolError: + # Didn't get a connection from the pool, no need to clean up + clean_exit = True + release_this_conn = False + raise + + except ( + TimeoutError, + HTTPException, + OSError, + ProtocolError, + BaseSSLError, + SSLError, + CertificateError, + ProxyError, + ) as e: + # Discard the connection for these exceptions. It will be + # replaced during the next _get_conn() call. + clean_exit = False + new_e: Exception = e + if isinstance(e, (BaseSSLError, CertificateError)): + new_e = SSLError(e) + if isinstance( + new_e, + ( + OSError, + NewConnectionError, + TimeoutError, + SSLError, + HTTPException, + ), + ) and (conn and conn.proxy and not conn.has_connected_to_proxy): + new_e = _wrap_proxy_error(new_e, conn.proxy.scheme) + elif isinstance(new_e, (OSError, HTTPException)): + new_e = ProtocolError("Connection aborted.", new_e) + + retries = retries.increment( + method, url, error=new_e, _pool=self, _stacktrace=sys.exc_info()[2] + ) + retries.sleep() + + # Keep track of the error for the retry warning. + err = e + + finally: + if not clean_exit: + # We hit some kind of exception, handled or otherwise. We need + # to throw the connection away unless explicitly told not to. + # Close the connection, set the variable to None, and make sure + # we put the None back in the pool to avoid leaking it. + if conn: + conn.close() + conn = None + release_this_conn = True + + if release_this_conn: + # Put the connection back to be reused. If the connection is + # expired then it will be None, which will get replaced with a + # fresh connection during _get_conn. + self._put_conn(conn) + + if not conn: + # Try again + log.warning( + "Retrying (%r) after connection broken by '%r': %s", retries, err, url + ) + return self.urlopen( + method, + url, + body, + headers, + retries, + redirect, + assert_same_host, + timeout=timeout, + pool_timeout=pool_timeout, + release_conn=release_conn, + chunked=chunked, + body_pos=body_pos, + preload_content=preload_content, + decode_content=decode_content, + **response_kw, + ) + + # Handle redirect? + redirect_location = redirect and response.get_redirect_location() + if redirect_location: + if response.status == 303: + # Change the method according to RFC 9110, Section 15.4.4. + method = "GET" + # And lose the body not to transfer anything sensitive. + body = None + headers = HTTPHeaderDict(headers)._prepare_for_method_change() + + try: + retries = retries.increment(method, url, response=response, _pool=self) + except MaxRetryError: + if retries.raise_on_redirect: + response.drain_conn() + raise + return response + + response.drain_conn() + retries.sleep_for_retry(response) + log.debug("Redirecting %s -> %s", url, redirect_location) + return self.urlopen( + method, + redirect_location, + body, + headers, + retries=retries, + redirect=redirect, + assert_same_host=assert_same_host, + timeout=timeout, + pool_timeout=pool_timeout, + release_conn=release_conn, + chunked=chunked, + body_pos=body_pos, + preload_content=preload_content, + decode_content=decode_content, + **response_kw, + ) + + # Check if we should retry the HTTP response. + has_retry_after = bool(response.headers.get("Retry-After")) + if retries.is_retry(method, response.status, has_retry_after): + try: + retries = retries.increment(method, url, response=response, _pool=self) + except MaxRetryError: + if retries.raise_on_status: + response.drain_conn() + raise + return response + + response.drain_conn() + retries.sleep(response) + log.debug("Retry: %s", url) + return self.urlopen( + method, + url, + body, + headers, + retries=retries, + redirect=redirect, + assert_same_host=assert_same_host, + timeout=timeout, + pool_timeout=pool_timeout, + release_conn=release_conn, + chunked=chunked, + body_pos=body_pos, + preload_content=preload_content, + decode_content=decode_content, + **response_kw, + ) + + return response + + +class HTTPSConnectionPool(HTTPConnectionPool): + """ + Same as :class:`.HTTPConnectionPool`, but HTTPS. + + :class:`.HTTPSConnection` uses one of ``assert_fingerprint``, + ``assert_hostname`` and ``host`` in this order to verify connections. + If ``assert_hostname`` is False, no verification is done. + + The ``key_file``, ``cert_file``, ``cert_reqs``, ``ca_certs``, + ``ca_cert_dir``, ``ssl_version``, ``key_password`` are only used if :mod:`ssl` + is available and are fed into :meth:`urllib3.util.ssl_wrap_socket` to upgrade + the connection socket into an SSL socket. + """ + + scheme = "https" + ConnectionCls: type[BaseHTTPSConnection] = HTTPSConnection + + def __init__( + self, + host: str, + port: int | None = None, + timeout: _TYPE_TIMEOUT | None = _DEFAULT_TIMEOUT, + maxsize: int = 1, + block: bool = False, + headers: typing.Mapping[str, str] | None = None, + retries: Retry | bool | int | None = None, + _proxy: Url | None = None, + _proxy_headers: typing.Mapping[str, str] | None = None, + key_file: str | None = None, + cert_file: str | None = None, + cert_reqs: int | str | None = None, + key_password: str | None = None, + ca_certs: str | None = None, + ssl_version: int | str | None = None, + ssl_minimum_version: ssl.TLSVersion | None = None, + ssl_maximum_version: ssl.TLSVersion | None = None, + assert_hostname: str | typing.Literal[False] | None = None, + assert_fingerprint: str | None = None, + ca_cert_dir: str | None = None, + **conn_kw: typing.Any, + ) -> None: + super().__init__( + host, + port, + timeout, + maxsize, + block, + headers, + retries, + _proxy, + _proxy_headers, + **conn_kw, + ) + + self.key_file = key_file + self.cert_file = cert_file + self.cert_reqs = cert_reqs + self.key_password = key_password + self.ca_certs = ca_certs + self.ca_cert_dir = ca_cert_dir + self.ssl_version = ssl_version + self.ssl_minimum_version = ssl_minimum_version + self.ssl_maximum_version = ssl_maximum_version + self.assert_hostname = assert_hostname + self.assert_fingerprint = assert_fingerprint + + def _prepare_proxy(self, conn: HTTPSConnection) -> None: # type: ignore[override] + """Establishes a tunnel connection through HTTP CONNECT.""" + if self.proxy and self.proxy.scheme == "https": + tunnel_scheme = "https" + else: + tunnel_scheme = "http" + + conn.set_tunnel( + scheme=tunnel_scheme, + host=self._tunnel_host, + port=self.port, + headers=self.proxy_headers, + ) + conn.connect() + + def _new_conn(self) -> BaseHTTPSConnection: + """ + Return a fresh :class:`urllib3.connection.HTTPConnection`. + """ + self.num_connections += 1 + log.debug( + "Starting new HTTPS connection (%d): %s:%s", + self.num_connections, + self.host, + self.port or "443", + ) + + if not self.ConnectionCls or self.ConnectionCls is DummyConnection: # type: ignore[comparison-overlap] + raise ImportError( + "Can't connect to HTTPS URL because the SSL module is not available." + ) + + actual_host: str = self.host + actual_port = self.port + if self.proxy is not None and self.proxy.host is not None: + actual_host = self.proxy.host + actual_port = self.proxy.port + + return self.ConnectionCls( + host=actual_host, + port=actual_port, + timeout=self.timeout.connect_timeout, + cert_file=self.cert_file, + key_file=self.key_file, + key_password=self.key_password, + cert_reqs=self.cert_reqs, + ca_certs=self.ca_certs, + ca_cert_dir=self.ca_cert_dir, + assert_hostname=self.assert_hostname, + assert_fingerprint=self.assert_fingerprint, + ssl_version=self.ssl_version, + ssl_minimum_version=self.ssl_minimum_version, + ssl_maximum_version=self.ssl_maximum_version, + **self.conn_kw, + ) + + def _validate_conn(self, conn: BaseHTTPConnection) -> None: + """ + Called right before a request is made, after the socket is created. + """ + super()._validate_conn(conn) + + # Force connect early to allow us to validate the connection. + if conn.is_closed: + conn.connect() + + # TODO revise this, see https://github.com/urllib3/urllib3/issues/2791 + if not conn.is_verified and not conn.proxy_is_verified: + warnings.warn( + ( + f"Unverified HTTPS request is being made to host '{conn.host}'. " + "Adding certificate verification is strongly advised. See: " + "https://urllib3.readthedocs.io/en/latest/advanced-usage.html" + "#tls-warnings" + ), + InsecureRequestWarning, + ) + + +def connection_from_url(url: str, **kw: typing.Any) -> HTTPConnectionPool: + """ + Given a url, return an :class:`.ConnectionPool` instance of its host. + + This is a shortcut for not having to parse out the scheme, host, and port + of the url before creating an :class:`.ConnectionPool` instance. + + :param url: + Absolute URL string that must include the scheme. Port is optional. + + :param \\**kw: + Passes additional parameters to the constructor of the appropriate + :class:`.ConnectionPool`. Useful for specifying things like + timeout, maxsize, headers, etc. + + Example:: + + >>> conn = connection_from_url('http://google.com/') + >>> r = conn.request('GET', '/') + """ + scheme, _, host, port, *_ = parse_url(url) + scheme = scheme or "http" + port = port or port_by_scheme.get(scheme, 80) + if scheme == "https": + return HTTPSConnectionPool(host, port=port, **kw) # type: ignore[arg-type] + else: + return HTTPConnectionPool(host, port=port, **kw) # type: ignore[arg-type] + + +@typing.overload +def _normalize_host(host: None, scheme: str | None) -> None: + ... + + +@typing.overload +def _normalize_host(host: str, scheme: str | None) -> str: + ... + + +def _normalize_host(host: str | None, scheme: str | None) -> str | None: + """ + Normalize hosts for comparisons and use with sockets. + """ + + host = normalize_host(host, scheme) + + # httplib doesn't like it when we include brackets in IPv6 addresses + # Specifically, if we include brackets but also pass the port then + # httplib crazily doubles up the square brackets on the Host header. + # Instead, we need to make sure we never pass ``None`` as the port. + # However, for backward compatibility reasons we can't actually + # *assert* that. See http://bugs.python.org/issue28539 + if host and host.startswith("[") and host.endswith("]"): + host = host[1:-1] + return host + + +def _url_from_pool( + pool: HTTPConnectionPool | HTTPSConnectionPool, path: str | None = None +) -> str: + """Returns the URL from a given connection pool. This is mainly used for testing and logging.""" + return Url(scheme=pool.scheme, host=pool.host, port=pool.port, path=path).url + + +def _close_pool_connections(pool: queue.LifoQueue[typing.Any]) -> None: + """Drains a queue of connections and closes each one.""" + try: + while True: + conn = pool.get(block=False) + if conn: + conn.close() + except queue.Empty: + pass # Done. diff --git a/.venv/lib/python3.12/site-packages/urllib3/contrib/__init__.py b/.venv/lib/python3.12/site-packages/urllib3/contrib/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/.venv/lib/python3.12/site-packages/urllib3/contrib/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/urllib3/contrib/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..3ba5e1cfce28db0385301cdf5827454f5a9dfaac GIT binary patch literal 186 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 z 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 Ref%c}yhjNC$#Wc({|h=78$$p9 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/urllib3/contrib/emscripten/__init__.py b/.venv/lib/python3.12/site-packages/urllib3/contrib/emscripten/__init__.py new file mode 100644 index 0000000..8a3c5be --- /dev/null +++ b/.venv/lib/python3.12/site-packages/urllib3/contrib/emscripten/__init__.py @@ -0,0 +1,16 @@ +from __future__ import annotations + +import urllib3.connection + +from ...connectionpool import HTTPConnectionPool, HTTPSConnectionPool +from .connection import EmscriptenHTTPConnection, EmscriptenHTTPSConnection + + +def inject_into_urllib3() -> None: + # override connection classes to use emscripten specific classes + # n.b. mypy complains about the overriding of classes below + # if it isn't ignored + HTTPConnectionPool.ConnectionCls = EmscriptenHTTPConnection + HTTPSConnectionPool.ConnectionCls = EmscriptenHTTPSConnection + urllib3.connection.HTTPConnection = EmscriptenHTTPConnection # type: ignore[misc,assignment] + urllib3.connection.HTTPSConnection = EmscriptenHTTPSConnection # type: ignore[misc,assignment] diff --git a/.venv/lib/python3.12/site-packages/urllib3/contrib/emscripten/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/urllib3/contrib/emscripten/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c0a96115ced4480562270241695e0cea20768ad0 GIT binary patch literal 894 zcmaJljA6uwIw+et~GiPVx6Q4|lvf~*w^L={MgsDe&jPQktsxAvWNzC_B#(Erds zz=HTGOh`dUr&J6bP&TA=>cqP=c9IUf;px5a-S^(zckg?(T0vmW`)?50tG0*5sI;gv5pH-!7B#Ez=({v-XUAo)47nXx=Z04q7o74; zH*>Js>NCb=Uxu8ey;)I%1yy@#fg-Fo)iO+!haCVl^`|B0sVax{>b6mXE{ zzvL1UvQQGzO2(=lvQzkIKqMzij;Oz}?sfF%O0jeIXi<>NQRG!2K;^j4#onE7bUd P4u7M!*QSNLctQLJX+G9| literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/urllib3/contrib/emscripten/__pycache__/connection.cpython-312.pyc b/.venv/lib/python3.12/site-packages/urllib3/contrib/emscripten/__pycache__/connection.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ec64a217342347e657b3a9cffe24b5b6b6418710 GIT binary patch literal 10233 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/urllib3/contrib/emscripten/__pycache__/fetch.cpython-312.pyc b/.venv/lib/python3.12/site-packages/urllib3/contrib/emscripten/__pycache__/fetch.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..25c112f9e6b17f379361ce94dc58f4870e7f1892 GIT binary patch literal 18366 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 F{R=@zVPgOQ literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/urllib3/contrib/emscripten/__pycache__/response.cpython-312.pyc b/.venv/lib/python3.12/site-packages/urllib3/contrib/emscripten/__pycache__/response.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..de64c889f3fe7336f4ca06539128931562bc1fb1 GIT binary patch literal 12699 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/urllib3/contrib/emscripten/connection.py b/.venv/lib/python3.12/site-packages/urllib3/contrib/emscripten/connection.py new file mode 100644 index 0000000..2ceb457 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/urllib3/contrib/emscripten/connection.py @@ -0,0 +1,254 @@ +from __future__ import annotations + +import os +import typing + +# use http.client.HTTPException for consistency with non-emscripten +from http.client import HTTPException as HTTPException # noqa: F401 +from http.client import ResponseNotReady + +from ..._base_connection import _TYPE_BODY +from ...connection import HTTPConnection, ProxyConfig, port_by_scheme +from ...exceptions import TimeoutError +from ...response import BaseHTTPResponse +from ...util.connection import _TYPE_SOCKET_OPTIONS +from ...util.timeout import _DEFAULT_TIMEOUT, _TYPE_TIMEOUT +from ...util.url import Url +from .fetch import _RequestError, _TimeoutError, send_request, send_streaming_request +from .request import EmscriptenRequest +from .response import EmscriptenHttpResponseWrapper, EmscriptenResponse + +if typing.TYPE_CHECKING: + from ..._base_connection import BaseHTTPConnection, BaseHTTPSConnection + + +class EmscriptenHTTPConnection: + default_port: typing.ClassVar[int] = port_by_scheme["http"] + default_socket_options: typing.ClassVar[_TYPE_SOCKET_OPTIONS] + + timeout: None | (float) + + host: str + port: int + blocksize: int + source_address: tuple[str, int] | None + socket_options: _TYPE_SOCKET_OPTIONS | None + + proxy: Url | None + proxy_config: ProxyConfig | None + + is_verified: bool = False + proxy_is_verified: bool | None = None + + _response: EmscriptenResponse | None + + def __init__( + self, + host: str, + port: int = 0, + *, + timeout: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT, + source_address: tuple[str, int] | None = None, + blocksize: int = 8192, + socket_options: _TYPE_SOCKET_OPTIONS | None = None, + proxy: Url | None = None, + proxy_config: ProxyConfig | None = None, + ) -> None: + self.host = host + self.port = port + self.timeout = timeout if isinstance(timeout, float) else 0.0 + self.scheme = "http" + self._closed = True + self._response = None + # ignore these things because we don't + # have control over that stuff + self.proxy = None + self.proxy_config = None + self.blocksize = blocksize + self.source_address = None + self.socket_options = None + self.is_verified = False + + def set_tunnel( + self, + host: str, + port: int | None = 0, + headers: typing.Mapping[str, str] | None = None, + scheme: str = "http", + ) -> None: + pass + + def connect(self) -> None: + pass + + def request( + self, + method: str, + url: str, + body: _TYPE_BODY | None = None, + headers: typing.Mapping[str, str] | None = None, + # We know *at least* botocore is depending on the order of the + # first 3 parameters so to be safe we only mark the later ones + # as keyword-only to ensure we have space to extend. + *, + chunked: bool = False, + preload_content: bool = True, + decode_content: bool = True, + enforce_content_length: bool = True, + ) -> None: + self._closed = False + if url.startswith("/"): + # no scheme / host / port included, make a full url + url = f"{self.scheme}://{self.host}:{self.port}" + url + request = EmscriptenRequest( + url=url, + method=method, + timeout=self.timeout if self.timeout else 0, + decode_content=decode_content, + ) + request.set_body(body) + if headers: + for k, v in headers.items(): + request.set_header(k, v) + self._response = None + try: + if not preload_content: + self._response = send_streaming_request(request) + if self._response is None: + self._response = send_request(request) + except _TimeoutError as e: + raise TimeoutError(e.message) from e + except _RequestError as e: + raise HTTPException(e.message) from e + + def getresponse(self) -> BaseHTTPResponse: + if self._response is not None: + return EmscriptenHttpResponseWrapper( + internal_response=self._response, + url=self._response.request.url, + connection=self, + ) + else: + raise ResponseNotReady() + + def close(self) -> None: + self._closed = True + self._response = None + + @property + def is_closed(self) -> bool: + """Whether the connection either is brand new or has been previously closed. + If this property is True then both ``is_connected`` and ``has_connected_to_proxy`` + properties must be False. + """ + return self._closed + + @property + def is_connected(self) -> bool: + """Whether the connection is actively connected to any origin (proxy or target)""" + return True + + @property + def has_connected_to_proxy(self) -> bool: + """Whether the connection has successfully connected to its proxy. + This returns False if no proxy is in use. Used to determine whether + errors are coming from the proxy layer or from tunnelling to the target origin. + """ + return False + + +class EmscriptenHTTPSConnection(EmscriptenHTTPConnection): + default_port = port_by_scheme["https"] + # all this is basically ignored, as browser handles https + cert_reqs: int | str | None = None + ca_certs: str | None = None + ca_cert_dir: str | None = None + ca_cert_data: None | str | bytes = None + cert_file: str | None + key_file: str | None + key_password: str | None + ssl_context: typing.Any | None + ssl_version: int | str | None = None + ssl_minimum_version: int | None = None + ssl_maximum_version: int | None = None + assert_hostname: None | str | typing.Literal[False] + assert_fingerprint: str | None = None + + def __init__( + self, + host: str, + port: int = 0, + *, + timeout: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT, + source_address: tuple[str, int] | None = None, + blocksize: int = 16384, + socket_options: None + | _TYPE_SOCKET_OPTIONS = HTTPConnection.default_socket_options, + proxy: Url | None = None, + proxy_config: ProxyConfig | None = None, + cert_reqs: int | str | None = None, + assert_hostname: None | str | typing.Literal[False] = None, + assert_fingerprint: str | None = None, + server_hostname: str | None = None, + ssl_context: typing.Any | None = None, + ca_certs: str | None = None, + ca_cert_dir: str | None = None, + ca_cert_data: None | str | bytes = None, + ssl_minimum_version: int | None = None, + ssl_maximum_version: int | None = None, + ssl_version: int | str | None = None, # Deprecated + cert_file: str | None = None, + key_file: str | None = None, + key_password: str | None = None, + ) -> None: + super().__init__( + host, + port=port, + timeout=timeout, + source_address=source_address, + blocksize=blocksize, + socket_options=socket_options, + proxy=proxy, + proxy_config=proxy_config, + ) + self.scheme = "https" + + self.key_file = key_file + self.cert_file = cert_file + self.key_password = key_password + self.ssl_context = ssl_context + self.server_hostname = server_hostname + self.assert_hostname = assert_hostname + self.assert_fingerprint = assert_fingerprint + self.ssl_version = ssl_version + self.ssl_minimum_version = ssl_minimum_version + self.ssl_maximum_version = ssl_maximum_version + self.ca_certs = ca_certs and os.path.expanduser(ca_certs) + self.ca_cert_dir = ca_cert_dir and os.path.expanduser(ca_cert_dir) + self.ca_cert_data = ca_cert_data + + self.cert_reqs = None + + # The browser will automatically verify all requests. + # We have no control over that setting. + self.is_verified = True + + def set_cert( + self, + key_file: str | None = None, + cert_file: str | None = None, + cert_reqs: int | str | None = None, + key_password: str | None = None, + ca_certs: str | None = None, + assert_hostname: None | str | typing.Literal[False] = None, + assert_fingerprint: str | None = None, + ca_cert_dir: str | None = None, + ca_cert_data: None | str | bytes = None, + ) -> None: + pass + + +# verify that this class implements BaseHTTP(s) connection correctly +if typing.TYPE_CHECKING: + _supports_http_protocol: BaseHTTPConnection = EmscriptenHTTPConnection("", 0) + _supports_https_protocol: BaseHTTPSConnection = EmscriptenHTTPSConnection("", 0) diff --git a/.venv/lib/python3.12/site-packages/urllib3/contrib/emscripten/emscripten_fetch_worker.js b/.venv/lib/python3.12/site-packages/urllib3/contrib/emscripten/emscripten_fetch_worker.js new file mode 100644 index 0000000..243b862 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/urllib3/contrib/emscripten/emscripten_fetch_worker.js @@ -0,0 +1,110 @@ +let Status = { + SUCCESS_HEADER: -1, + SUCCESS_EOF: -2, + ERROR_TIMEOUT: -3, + ERROR_EXCEPTION: -4, +}; + +let connections = {}; +let nextConnectionID = 1; +const encoder = new TextEncoder(); + +self.addEventListener("message", async function (event) { + if (event.data.close) { + let connectionID = event.data.close; + delete connections[connectionID]; + return; + } else if (event.data.getMore) { + let connectionID = event.data.getMore; + let { curOffset, value, reader, intBuffer, byteBuffer } = + connections[connectionID]; + // if we still have some in buffer, then just send it back straight away + if (!value || curOffset >= value.length) { + // read another buffer if required + try { + let readResponse = await reader.read(); + + if (readResponse.done) { + // read everything - clear connection and return + delete connections[connectionID]; + Atomics.store(intBuffer, 0, Status.SUCCESS_EOF); + Atomics.notify(intBuffer, 0); + // finished reading successfully + // return from event handler + return; + } + curOffset = 0; + connections[connectionID].value = readResponse.value; + value = readResponse.value; + } catch (error) { + console.log("Request exception:", error); + let errorBytes = encoder.encode(error.message); + let written = errorBytes.length; + byteBuffer.set(errorBytes); + intBuffer[1] = written; + Atomics.store(intBuffer, 0, Status.ERROR_EXCEPTION); + Atomics.notify(intBuffer, 0); + } + } + + // send as much buffer as we can + let curLen = value.length - curOffset; + if (curLen > byteBuffer.length) { + curLen = byteBuffer.length; + } + byteBuffer.set(value.subarray(curOffset, curOffset + curLen), 0); + + Atomics.store(intBuffer, 0, curLen); // store current length in bytes + Atomics.notify(intBuffer, 0); + curOffset += curLen; + connections[connectionID].curOffset = curOffset; + + return; + } else { + // start fetch + let connectionID = nextConnectionID; + nextConnectionID += 1; + const intBuffer = new Int32Array(event.data.buffer); + const byteBuffer = new Uint8Array(event.data.buffer, 8); + try { + const response = await fetch(event.data.url, event.data.fetchParams); + // return the headers first via textencoder + var headers = []; + for (const pair of response.headers.entries()) { + headers.push([pair[0], pair[1]]); + } + let headerObj = { + headers: headers, + status: response.status, + connectionID, + }; + const headerText = JSON.stringify(headerObj); + let headerBytes = encoder.encode(headerText); + let written = headerBytes.length; + byteBuffer.set(headerBytes); + intBuffer[1] = written; + // make a connection + connections[connectionID] = { + reader: response.body.getReader(), + intBuffer: intBuffer, + byteBuffer: byteBuffer, + value: undefined, + curOffset: 0, + }; + // set header ready + Atomics.store(intBuffer, 0, Status.SUCCESS_HEADER); + Atomics.notify(intBuffer, 0); + // all fetching after this goes through a new postmessage call with getMore + // this allows for parallel requests + } catch (error) { + console.log("Request exception:", error); + let errorBytes = encoder.encode(error.message); + let written = errorBytes.length; + byteBuffer.set(errorBytes); + intBuffer[1] = written; + Atomics.store(intBuffer, 0, Status.ERROR_EXCEPTION); + Atomics.notify(intBuffer, 0); + } + } +}); +self.postMessage({ inited: true }); diff --git a/.venv/lib/python3.12/site-packages/urllib3/contrib/emscripten/fetch.py b/.venv/lib/python3.12/site-packages/urllib3/contrib/emscripten/fetch.py new file mode 100644 index 0000000..8d197ea --- /dev/null +++ b/.venv/lib/python3.12/site-packages/urllib3/contrib/emscripten/fetch.py @@ -0,0 +1,418 @@ +""" +Support for streaming http requests in emscripten. + +A few caveats - + +Firstly, you can't do streaming http in the main UI thread, because atomics.wait isn't allowed. +Streaming only works if you're running pyodide in a web worker. + +Secondly, this uses an extra web worker and SharedArrayBuffer to do the asynchronous fetch +operation, so it requires that you have crossOriginIsolation enabled, by serving over https +(or from localhost) with the two headers below set: + + Cross-Origin-Opener-Policy: same-origin + Cross-Origin-Embedder-Policy: require-corp + +You can tell if cross origin isolation is successfully enabled by looking at the global crossOriginIsolated variable in +javascript console. If it isn't, streaming requests will fallback to XMLHttpRequest, i.e. getting the whole +request into a buffer and then returning it. it shows a warning in the javascript console in this case. + +Finally, the webworker which does the streaming fetch is created on initial import, but will only be started once +control is returned to javascript. Call `await wait_for_streaming_ready()` to wait for streaming fetch. + +NB: in this code, there are a lot of javascript objects. They are named js_* +to make it clear what type of object they are. +""" +from __future__ import annotations + +import io +import json +from email.parser import Parser +from importlib.resources import files +from typing import TYPE_CHECKING, Any + +import js # type: ignore[import-not-found] +from pyodide.ffi import ( # type: ignore[import-not-found] + JsArray, + JsException, + JsProxy, + to_js, +) + +if TYPE_CHECKING: + from typing_extensions import Buffer + +from .request import EmscriptenRequest +from .response import EmscriptenResponse + +""" +There are some headers that trigger unintended CORS preflight requests. +See also https://github.com/koenvo/pyodide-http/issues/22 +""" +HEADERS_TO_IGNORE = ("user-agent",) + +SUCCESS_HEADER = -1 +SUCCESS_EOF = -2 +ERROR_TIMEOUT = -3 +ERROR_EXCEPTION = -4 + +_STREAMING_WORKER_CODE = ( + files(__package__) + .joinpath("emscripten_fetch_worker.js") + .read_text(encoding="utf-8") +) + + +class _RequestError(Exception): + def __init__( + self, + message: str | None = None, + *, + request: EmscriptenRequest | None = None, + response: EmscriptenResponse | None = None, + ): + self.request = request + self.response = response + self.message = message + super().__init__(self.message) + + +class _StreamingError(_RequestError): + pass + + +class _TimeoutError(_RequestError): + pass + + +def _obj_from_dict(dict_val: dict[str, Any]) -> JsProxy: + return to_js(dict_val, dict_converter=js.Object.fromEntries) + + +class _ReadStream(io.RawIOBase): + def __init__( + self, + int_buffer: JsArray, + byte_buffer: JsArray, + timeout: float, + worker: JsProxy, + connection_id: int, + request: EmscriptenRequest, + ): + self.int_buffer = int_buffer + self.byte_buffer = byte_buffer + self.read_pos = 0 + self.read_len = 0 + self.connection_id = connection_id + self.worker = worker + self.timeout = int(1000 * timeout) if timeout > 0 else None + self.is_live = True + self._is_closed = False + self.request: EmscriptenRequest | None = request + + def __del__(self) -> None: + self.close() + + # this is compatible with _base_connection + def is_closed(self) -> bool: + return self._is_closed + + # for compatibility with RawIOBase + @property + def closed(self) -> bool: + return self.is_closed() + + def close(self) -> None: + if not self.is_closed(): + self.read_len = 0 + self.read_pos = 0 + self.int_buffer = None + self.byte_buffer = None + self._is_closed = True + self.request = None + if self.is_live: + self.worker.postMessage(_obj_from_dict({"close": self.connection_id})) + self.is_live = False + super().close() + + def readable(self) -> bool: + return True + + def writable(self) -> bool: + return False + + def seekable(self) -> bool: + return False + + def readinto(self, byte_obj: Buffer) -> int: + if not self.int_buffer: + raise _StreamingError( + "No buffer for stream in _ReadStream.readinto", + request=self.request, + response=None, + ) + if self.read_len == 0: + # wait for the worker to send something + js.Atomics.store(self.int_buffer, 0, ERROR_TIMEOUT) + self.worker.postMessage(_obj_from_dict({"getMore": self.connection_id})) + if ( + js.Atomics.wait(self.int_buffer, 0, ERROR_TIMEOUT, self.timeout) + == "timed-out" + ): + raise _TimeoutError + data_len = self.int_buffer[0] + if data_len > 0: + self.read_len = data_len + self.read_pos = 0 + elif data_len == ERROR_EXCEPTION: + string_len = self.int_buffer[1] + # decode the error string + js_decoder = js.TextDecoder.new() + json_str = js_decoder.decode(self.byte_buffer.slice(0, string_len)) + raise _StreamingError( + f"Exception thrown in fetch: {json_str}", + request=self.request, + response=None, + ) + else: + # EOF, free the buffers and return zero + # and free the request + self.is_live = False + self.close() + return 0 + # copy from int32array to python bytes + ret_length = min(self.read_len, len(memoryview(byte_obj))) + subarray = self.byte_buffer.subarray( + self.read_pos, self.read_pos + ret_length + ).to_py() + memoryview(byte_obj)[0:ret_length] = subarray + self.read_len -= ret_length + self.read_pos += ret_length + return ret_length + + +class _StreamingFetcher: + def __init__(self) -> None: + # make web-worker and data buffer on startup + self.streaming_ready = False + + js_data_blob = js.Blob.new( + [_STREAMING_WORKER_CODE], _obj_from_dict({"type": "application/javascript"}) + ) + + def promise_resolver(js_resolve_fn: JsProxy, js_reject_fn: JsProxy) -> None: + def onMsg(e: JsProxy) -> None: + self.streaming_ready = True + js_resolve_fn(e) + + def onErr(e: JsProxy) -> None: + js_reject_fn(e) # Defensive: never happens in ci + + self.js_worker.onmessage = onMsg + self.js_worker.onerror = onErr + + js_data_url = js.URL.createObjectURL(js_data_blob) + self.js_worker = js.globalThis.Worker.new(js_data_url) + self.js_worker_ready_promise = js.globalThis.Promise.new(promise_resolver) + + def send(self, request: EmscriptenRequest) -> EmscriptenResponse: + headers = { + k: v for k, v in request.headers.items() if k not in HEADERS_TO_IGNORE + } + + body = request.body + fetch_data = {"headers": headers, "body": to_js(body), "method": request.method} + # start the request off in the worker + timeout = int(1000 * request.timeout) if request.timeout > 0 else None + js_shared_buffer = js.SharedArrayBuffer.new(1048576) + js_int_buffer = js.Int32Array.new(js_shared_buffer) + js_byte_buffer = js.Uint8Array.new(js_shared_buffer, 8) + + js.Atomics.store(js_int_buffer, 0, ERROR_TIMEOUT) + js.Atomics.notify(js_int_buffer, 0) + js_absolute_url = js.URL.new(request.url, js.location).href + self.js_worker.postMessage( + _obj_from_dict( + { + "buffer": js_shared_buffer, + "url": js_absolute_url, + "fetchParams": fetch_data, + } + ) + ) + # wait for the worker to send something + js.Atomics.wait(js_int_buffer, 0, ERROR_TIMEOUT, timeout) + if js_int_buffer[0] == ERROR_TIMEOUT: + raise _TimeoutError( + "Timeout connecting to streaming request", + request=request, + response=None, + ) + elif js_int_buffer[0] == SUCCESS_HEADER: + # got response + # header length is in second int of intBuffer + string_len = js_int_buffer[1] + # decode the rest to a JSON string + js_decoder = js.TextDecoder.new() + # this does a copy (the slice) because decode can't work on shared array + # for some silly reason + json_str = js_decoder.decode(js_byte_buffer.slice(0, string_len)) + # get it as an object + response_obj = json.loads(json_str) + return EmscriptenResponse( + request=request, + status_code=response_obj["status"], + headers=response_obj["headers"], + body=_ReadStream( + js_int_buffer, + js_byte_buffer, + request.timeout, + self.js_worker, + response_obj["connectionID"], + request, + ), + ) + elif js_int_buffer[0] == ERROR_EXCEPTION: + string_len = js_int_buffer[1] + # decode the error string + js_decoder = js.TextDecoder.new() + json_str = js_decoder.decode(js_byte_buffer.slice(0, string_len)) + raise _StreamingError( + f"Exception thrown in fetch: {json_str}", request=request, response=None + ) + else: + raise _StreamingError( + f"Unknown status from worker in fetch: {js_int_buffer[0]}", + request=request, + response=None, + ) + + +# check if we are in a worker or not +def is_in_browser_main_thread() -> bool: + return hasattr(js, "window") and hasattr(js, "self") and js.self == js.window + + +def is_cross_origin_isolated() -> bool: + return hasattr(js, "crossOriginIsolated") and js.crossOriginIsolated + + +def is_in_node() -> bool: + return ( + hasattr(js, "process") + and hasattr(js.process, "release") + and hasattr(js.process.release, "name") + and js.process.release.name == "node" + ) + + +def is_worker_available() -> bool: + return hasattr(js, "Worker") and hasattr(js, "Blob") + + +_fetcher: _StreamingFetcher | None = None + +if is_worker_available() and ( + (is_cross_origin_isolated() and not is_in_browser_main_thread()) + and (not is_in_node()) +): + _fetcher = _StreamingFetcher() +else: + _fetcher = None + + +def send_streaming_request(request: EmscriptenRequest) -> EmscriptenResponse | None: + if _fetcher and streaming_ready(): + return _fetcher.send(request) + else: + _show_streaming_warning() + return None + + +_SHOWN_TIMEOUT_WARNING = False + + +def _show_timeout_warning() -> None: + global _SHOWN_TIMEOUT_WARNING + if not _SHOWN_TIMEOUT_WARNING: + _SHOWN_TIMEOUT_WARNING = True + message = "Warning: Timeout is not available on main browser thread" + js.console.warn(message) + + +_SHOWN_STREAMING_WARNING = False + + +def _show_streaming_warning() -> None: + global _SHOWN_STREAMING_WARNING + if not _SHOWN_STREAMING_WARNING: + _SHOWN_STREAMING_WARNING = True + message = "Can't stream HTTP requests because: \n" + if not is_cross_origin_isolated(): + message += " Page is not cross-origin isolated\n" + if is_in_browser_main_thread(): + message += " Python is running in main browser thread\n" + if not is_worker_available(): + message += " Worker or Blob classes are not available in this environment." # Defensive: this is always False in browsers that we test in + if streaming_ready() is False: + message += """ Streaming fetch worker isn't ready. If you want to be sure that streaming fetch +is working, you need to call: 'await urllib3.contrib.emscripten.fetch.wait_for_streaming_ready()`""" + from js import console + + console.warn(message) + + +def send_request(request: EmscriptenRequest) -> EmscriptenResponse: + try: + js_xhr = js.XMLHttpRequest.new() + + if not is_in_browser_main_thread(): + js_xhr.responseType = "arraybuffer" + if request.timeout: + js_xhr.timeout = int(request.timeout * 1000) + else: + js_xhr.overrideMimeType("text/plain; charset=ISO-8859-15") + if request.timeout: + # timeout isn't available on the main thread - show a warning in console + # if it is set + _show_timeout_warning() + + js_xhr.open(request.method, request.url, False) + for name, value in request.headers.items(): + if name.lower() not in HEADERS_TO_IGNORE: + js_xhr.setRequestHeader(name, value) + + js_xhr.send(to_js(request.body)) + + headers = dict(Parser().parsestr(js_xhr.getAllResponseHeaders())) + + if not is_in_browser_main_thread(): + body = js_xhr.response.to_py().tobytes() + else: + body = js_xhr.response.encode("ISO-8859-15") + return EmscriptenResponse( + status_code=js_xhr.status, headers=headers, body=body, request=request + ) + except JsException as err: + if err.name == "TimeoutError": + raise _TimeoutError(err.message, request=request) + elif err.name == "NetworkError": + raise _RequestError(err.message, request=request) + else: + # general http error + raise _RequestError(err.message, request=request) + + +def streaming_ready() -> bool | None: + if _fetcher: + return _fetcher.streaming_ready + else: + return None # no fetcher, return None to signify that + + +async def wait_for_streaming_ready() -> bool: + if _fetcher: + await _fetcher.js_worker_ready_promise + return True + else: + return False diff --git a/.venv/lib/python3.12/site-packages/urllib3/contrib/emscripten/request.py b/.venv/lib/python3.12/site-packages/urllib3/contrib/emscripten/request.py new file mode 100644 index 0000000..e692e69 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/urllib3/contrib/emscripten/request.py @@ -0,0 +1,22 @@ +from __future__ import annotations + +from dataclasses import dataclass, field + +from ..._base_connection import _TYPE_BODY + + +@dataclass +class EmscriptenRequest: + method: str + url: str + params: dict[str, str] | None = None + body: _TYPE_BODY | None = None + headers: dict[str, str] = field(default_factory=dict) + timeout: float = 0 + decode_content: bool = True + + def set_header(self, name: str, value: str) -> None: + self.headers[name.capitalize()] = value + + def set_body(self, body: _TYPE_BODY | None) -> None: + self.body = body diff --git a/.venv/lib/python3.12/site-packages/urllib3/contrib/emscripten/response.py b/.venv/lib/python3.12/site-packages/urllib3/contrib/emscripten/response.py new file mode 100644 index 0000000..cd3d80e --- /dev/null +++ b/.venv/lib/python3.12/site-packages/urllib3/contrib/emscripten/response.py @@ -0,0 +1,285 @@ +from __future__ import annotations + +import json as _json +import logging +import typing +from contextlib import contextmanager +from dataclasses import dataclass +from http.client import HTTPException as HTTPException +from io import BytesIO, IOBase + +from ...exceptions import InvalidHeader, TimeoutError +from ...response import BaseHTTPResponse +from ...util.retry import Retry +from .request import EmscriptenRequest + +if typing.TYPE_CHECKING: + from ..._base_connection import BaseHTTPConnection, BaseHTTPSConnection + +log = logging.getLogger(__name__) + + +@dataclass +class EmscriptenResponse: + status_code: int + headers: dict[str, str] + body: IOBase | bytes + request: EmscriptenRequest + + +class EmscriptenHttpResponseWrapper(BaseHTTPResponse): + def __init__( + self, + internal_response: EmscriptenResponse, + url: str | None = None, + connection: BaseHTTPConnection | BaseHTTPSConnection | None = None, + ): + self._pool = None # set by pool class + self._body = None + self._response = internal_response + self._url = url + self._connection = connection + self._closed = False + super().__init__( + headers=internal_response.headers, + status=internal_response.status_code, + request_url=url, + version=0, + version_string="HTTP/?", + reason="", + decode_content=True, + ) + self.length_remaining = self._init_length(self._response.request.method) + self.length_is_certain = False + + @property + def url(self) -> str | None: + return self._url + + @url.setter + def url(self, url: str | None) -> None: + self._url = url + + @property + def connection(self) -> BaseHTTPConnection | BaseHTTPSConnection | None: + return self._connection + + @property + def retries(self) -> Retry | None: + return self._retries + + @retries.setter + def retries(self, retries: Retry | None) -> None: + # Override the request_url if retries has a redirect location. + self._retries = retries + + def stream( + self, amt: int | None = 2**16, decode_content: bool | None = None + ) -> typing.Generator[bytes, None, None]: + """ + A generator wrapper for the read() method. A call will block until + ``amt`` bytes have been read from the connection or until the + connection is closed. + + :param amt: + How much of the content to read. The generator will return up to + much data per iteration, but may return less. This is particularly + likely when using compressed data. However, the empty string will + never be returned. + + :param decode_content: + If True, will attempt to decode the body based on the + 'content-encoding' header. + """ + while True: + data = self.read(amt=amt, decode_content=decode_content) + + if data: + yield data + else: + break + + def _init_length(self, request_method: str | None) -> int | None: + length: int | None + content_length: str | None = self.headers.get("content-length") + + if content_length is not None: + try: + # RFC 7230 section 3.3.2 specifies multiple content lengths can + # be sent in a single Content-Length header + # (e.g. Content-Length: 42, 42). This line ensures the values + # are all valid ints and that as long as the `set` length is 1, + # all values are the same. Otherwise, the header is invalid. + lengths = {int(val) for val in content_length.split(",")} + if len(lengths) > 1: + raise InvalidHeader( + "Content-Length contained multiple " + "unmatching values (%s)" % content_length + ) + length = lengths.pop() + except ValueError: + length = None + else: + if length < 0: + length = None + + else: # if content_length is None + length = None + + # Check for responses that shouldn't include a body + if ( + self.status in (204, 304) + or 100 <= self.status < 200 + or request_method == "HEAD" + ): + length = 0 + + return length + + def read( + self, + amt: int | None = None, + decode_content: bool | None = None, # ignored because browser decodes always + cache_content: bool = False, + ) -> bytes: + if ( + self._closed + or self._response is None + or (isinstance(self._response.body, IOBase) and self._response.body.closed) + ): + return b"" + + with self._error_catcher(): + # body has been preloaded as a string by XmlHttpRequest + if not isinstance(self._response.body, IOBase): + self.length_remaining = len(self._response.body) + self.length_is_certain = True + # wrap body in IOStream + self._response.body = BytesIO(self._response.body) + if amt is not None and amt >= 0: + # don't cache partial content + cache_content = False + data = self._response.body.read(amt) + if self.length_remaining is not None: + self.length_remaining = max(self.length_remaining - len(data), 0) + if (self.length_is_certain and self.length_remaining == 0) or len( + data + ) < amt: + # definitely finished reading, close response stream + self._response.body.close() + return typing.cast(bytes, data) + else: # read all we can (and cache it) + data = self._response.body.read() + if cache_content: + self._body = data + if self.length_remaining is not None: + self.length_remaining = max(self.length_remaining - len(data), 0) + if len(data) == 0 or ( + self.length_is_certain and self.length_remaining == 0 + ): + # definitely finished reading, close response stream + self._response.body.close() + return typing.cast(bytes, data) + + def read_chunked( + self, + amt: int | None = None, + decode_content: bool | None = None, + ) -> typing.Generator[bytes, None, None]: + # chunked is handled by browser + while True: + bytes = self.read(amt, decode_content) + if not bytes: + break + yield bytes + + def release_conn(self) -> None: + if not self._pool or not self._connection: + return None + + self._pool._put_conn(self._connection) + self._connection = None + + def drain_conn(self) -> None: + self.close() + + @property + def data(self) -> bytes: + if self._body: + return self._body + else: + return self.read(cache_content=True) + + def json(self) -> typing.Any: + """ + Deserializes the body of the HTTP response as a Python object. + + The body of the HTTP response must be encoded using UTF-8, as per + `RFC 8529 Section 8.1 `_. + + To use a custom JSON decoder pass the result of :attr:`HTTPResponse.data` to + your custom decoder instead. + + If the body of the HTTP response is not decodable to UTF-8, a + `UnicodeDecodeError` will be raised. If the body of the HTTP response is not a + valid JSON document, a `json.JSONDecodeError` will be raised. + + Read more :ref:`here `. + + :returns: The body of the HTTP response as a Python object. + """ + data = self.data.decode("utf-8") + return _json.loads(data) + + def close(self) -> None: + if not self._closed: + if isinstance(self._response.body, IOBase): + self._response.body.close() + if self._connection: + self._connection.close() + self._connection = None + self._closed = True + + @contextmanager + def _error_catcher(self) -> typing.Generator[None, None, None]: + """ + Catch Emscripten specific exceptions thrown by fetch.py, + instead re-raising urllib3 variants, so that low-level exceptions + are not leaked in the high-level api. + + On exit, release the connection back to the pool. + """ + from .fetch import _RequestError, _TimeoutError # avoid circular import + + clean_exit = False + + try: + yield + # If no exception is thrown, we should avoid cleaning up + # unnecessarily. + clean_exit = True + except _TimeoutError as e: + raise TimeoutError(str(e)) + except _RequestError as e: + raise HTTPException(str(e)) + finally: + # If we didn't terminate cleanly, we need to throw away our + # connection. + if not clean_exit: + # The response may not be closed but we're not going to use it + # anymore so close it now + if ( + isinstance(self._response.body, IOBase) + and not self._response.body.closed + ): + self._response.body.close() + # release the connection back to the pool + self.release_conn() + else: + # If we have read everything from the response stream, + # return the connection back to the pool. + if ( + isinstance(self._response.body, IOBase) + and self._response.body.closed + ): + self.release_conn() diff --git a/.venv/lib/python3.12/site-packages/urllib3/contrib/pyopenssl.py b/.venv/lib/python3.12/site-packages/urllib3/contrib/pyopenssl.py new file mode 100644 index 0000000..b89a6da --- /dev/null +++ b/.venv/lib/python3.12/site-packages/urllib3/contrib/pyopenssl.py @@ -0,0 +1,548 @@ +""" +Module for using pyOpenSSL as a TLS backend. This module was relevant before +the standard library ``ssl`` module supported SNI, but now that we've dropped +support for Python 2.7 all relevant Python versions support SNI so +**this module is no longer recommended**. + +This needs the following packages installed: + +* `pyOpenSSL`_ (tested with 16.0.0) +* `cryptography`_ (minimum 1.3.4, from pyopenssl) +* `idna`_ (minimum 2.0) + +However, pyOpenSSL depends on cryptography, so while we use all three directly here we +end up having relatively few packages required. + +You can install them with the following command: + +.. code-block:: bash + + $ python -m pip install pyopenssl cryptography idna + +To activate certificate checking, call +:func:`~urllib3.contrib.pyopenssl.inject_into_urllib3` from your Python code +before you begin making HTTP requests. This can be done in a ``sitecustomize`` +module, or at any other time before your application begins using ``urllib3``, +like this: + +.. code-block:: python + + try: + import urllib3.contrib.pyopenssl + urllib3.contrib.pyopenssl.inject_into_urllib3() + except ImportError: + pass + +.. _pyopenssl: https://www.pyopenssl.org +.. _cryptography: https://cryptography.io +.. _idna: https://github.com/kjd/idna +""" + +from __future__ import annotations + +import OpenSSL.SSL # type: ignore[import-untyped] +from cryptography import x509 + +try: + from cryptography.x509 import UnsupportedExtension # type: ignore[attr-defined] +except ImportError: + # UnsupportedExtension is gone in cryptography >= 2.1.0 + class UnsupportedExtension(Exception): # type: ignore[no-redef] + pass + + +import logging +import ssl +import typing +from io import BytesIO +from socket import socket as socket_cls +from socket import timeout + +from .. import util + +if typing.TYPE_CHECKING: + from OpenSSL.crypto import X509 # type: ignore[import-untyped] + + +__all__ = ["inject_into_urllib3", "extract_from_urllib3"] + +# Map from urllib3 to PyOpenSSL compatible parameter-values. +_openssl_versions: dict[int, int] = { + util.ssl_.PROTOCOL_TLS: OpenSSL.SSL.SSLv23_METHOD, # type: ignore[attr-defined] + util.ssl_.PROTOCOL_TLS_CLIENT: OpenSSL.SSL.SSLv23_METHOD, # type: ignore[attr-defined] + ssl.PROTOCOL_TLSv1: OpenSSL.SSL.TLSv1_METHOD, +} + +if hasattr(ssl, "PROTOCOL_TLSv1_1") and hasattr(OpenSSL.SSL, "TLSv1_1_METHOD"): + _openssl_versions[ssl.PROTOCOL_TLSv1_1] = OpenSSL.SSL.TLSv1_1_METHOD + +if hasattr(ssl, "PROTOCOL_TLSv1_2") and hasattr(OpenSSL.SSL, "TLSv1_2_METHOD"): + _openssl_versions[ssl.PROTOCOL_TLSv1_2] = OpenSSL.SSL.TLSv1_2_METHOD + + +_stdlib_to_openssl_verify = { + ssl.CERT_NONE: OpenSSL.SSL.VERIFY_NONE, + ssl.CERT_OPTIONAL: OpenSSL.SSL.VERIFY_PEER, + ssl.CERT_REQUIRED: OpenSSL.SSL.VERIFY_PEER + + OpenSSL.SSL.VERIFY_FAIL_IF_NO_PEER_CERT, +} +_openssl_to_stdlib_verify = {v: k for k, v in _stdlib_to_openssl_verify.items()} + +# The SSLvX values are the most likely to be missing in the future +# but we check them all just to be sure. +_OP_NO_SSLv2_OR_SSLv3: int = getattr(OpenSSL.SSL, "OP_NO_SSLv2", 0) | getattr( + OpenSSL.SSL, "OP_NO_SSLv3", 0 +) +_OP_NO_TLSv1: int = getattr(OpenSSL.SSL, "OP_NO_TLSv1", 0) +_OP_NO_TLSv1_1: int = getattr(OpenSSL.SSL, "OP_NO_TLSv1_1", 0) +_OP_NO_TLSv1_2: int = getattr(OpenSSL.SSL, "OP_NO_TLSv1_2", 0) +_OP_NO_TLSv1_3: int = getattr(OpenSSL.SSL, "OP_NO_TLSv1_3", 0) + +_openssl_to_ssl_minimum_version: dict[int, int] = { + ssl.TLSVersion.MINIMUM_SUPPORTED: _OP_NO_SSLv2_OR_SSLv3, + ssl.TLSVersion.TLSv1: _OP_NO_SSLv2_OR_SSLv3, + ssl.TLSVersion.TLSv1_1: _OP_NO_SSLv2_OR_SSLv3 | _OP_NO_TLSv1, + ssl.TLSVersion.TLSv1_2: _OP_NO_SSLv2_OR_SSLv3 | _OP_NO_TLSv1 | _OP_NO_TLSv1_1, + ssl.TLSVersion.TLSv1_3: ( + _OP_NO_SSLv2_OR_SSLv3 | _OP_NO_TLSv1 | _OP_NO_TLSv1_1 | _OP_NO_TLSv1_2 + ), + ssl.TLSVersion.MAXIMUM_SUPPORTED: ( + _OP_NO_SSLv2_OR_SSLv3 | _OP_NO_TLSv1 | _OP_NO_TLSv1_1 | _OP_NO_TLSv1_2 + ), +} +_openssl_to_ssl_maximum_version: dict[int, int] = { + ssl.TLSVersion.MINIMUM_SUPPORTED: ( + _OP_NO_SSLv2_OR_SSLv3 + | _OP_NO_TLSv1 + | _OP_NO_TLSv1_1 + | _OP_NO_TLSv1_2 + | _OP_NO_TLSv1_3 + ), + ssl.TLSVersion.TLSv1: ( + _OP_NO_SSLv2_OR_SSLv3 | _OP_NO_TLSv1_1 | _OP_NO_TLSv1_2 | _OP_NO_TLSv1_3 + ), + ssl.TLSVersion.TLSv1_1: _OP_NO_SSLv2_OR_SSLv3 | _OP_NO_TLSv1_2 | _OP_NO_TLSv1_3, + ssl.TLSVersion.TLSv1_2: _OP_NO_SSLv2_OR_SSLv3 | _OP_NO_TLSv1_3, + ssl.TLSVersion.TLSv1_3: _OP_NO_SSLv2_OR_SSLv3, + ssl.TLSVersion.MAXIMUM_SUPPORTED: _OP_NO_SSLv2_OR_SSLv3, +} + +# OpenSSL will only write 16K at a time +SSL_WRITE_BLOCKSIZE = 16384 + +orig_util_SSLContext = util.ssl_.SSLContext + + +log = logging.getLogger(__name__) + + +def inject_into_urllib3() -> None: + "Monkey-patch urllib3 with PyOpenSSL-backed SSL-support." + + _validate_dependencies_met() + + util.SSLContext = PyOpenSSLContext # type: ignore[assignment] + util.ssl_.SSLContext = PyOpenSSLContext # type: ignore[assignment] + util.IS_PYOPENSSL = True + util.ssl_.IS_PYOPENSSL = True + + +def extract_from_urllib3() -> None: + "Undo monkey-patching by :func:`inject_into_urllib3`." + + util.SSLContext = orig_util_SSLContext + util.ssl_.SSLContext = orig_util_SSLContext + util.IS_PYOPENSSL = False + util.ssl_.IS_PYOPENSSL = False + + +def _validate_dependencies_met() -> None: + """ + Verifies that PyOpenSSL's package-level dependencies have been met. + Throws `ImportError` if they are not met. + """ + # Method added in `cryptography==1.1`; not available in older versions + from cryptography.x509.extensions import Extensions + + if getattr(Extensions, "get_extension_for_class", None) is None: + raise ImportError( + "'cryptography' module missing required functionality. " + "Try upgrading to v1.3.4 or newer." + ) + + # pyOpenSSL 0.14 and above use cryptography for OpenSSL bindings. The _x509 + # attribute is only present on those versions. + from OpenSSL.crypto import X509 + + x509 = X509() + if getattr(x509, "_x509", None) is None: + raise ImportError( + "'pyOpenSSL' module missing required functionality. " + "Try upgrading to v0.14 or newer." + ) + + +def _dnsname_to_stdlib(name: str) -> str | None: + """ + Converts a dNSName SubjectAlternativeName field to the form used by the + standard library on the given Python version. + + Cryptography produces a dNSName as a unicode string that was idna-decoded + from ASCII bytes. We need to idna-encode that string to get it back, and + then on Python 3 we also need to convert to unicode via UTF-8 (the stdlib + uses PyUnicode_FromStringAndSize on it, which decodes via UTF-8). + + If the name cannot be idna-encoded then we return None signalling that + the name given should be skipped. + """ + + def idna_encode(name: str) -> bytes | None: + """ + Borrowed wholesale from the Python Cryptography Project. It turns out + that we can't just safely call `idna.encode`: it can explode for + wildcard names. This avoids that problem. + """ + import idna + + try: + for prefix in ["*.", "."]: + if name.startswith(prefix): + name = name[len(prefix) :] + return prefix.encode("ascii") + idna.encode(name) + return idna.encode(name) + except idna.core.IDNAError: + return None + + # Don't send IPv6 addresses through the IDNA encoder. + if ":" in name: + return name + + encoded_name = idna_encode(name) + if encoded_name is None: + return None + return encoded_name.decode("utf-8") + + +def get_subj_alt_name(peer_cert: X509) -> list[tuple[str, str]]: + """ + Given an PyOpenSSL certificate, provides all the subject alternative names. + """ + cert = peer_cert.to_cryptography() + + # We want to find the SAN extension. Ask Cryptography to locate it (it's + # faster than looping in Python) + try: + ext = cert.extensions.get_extension_for_class(x509.SubjectAlternativeName).value + except x509.ExtensionNotFound: + # No such extension, return the empty list. + return [] + except ( + x509.DuplicateExtension, + UnsupportedExtension, + x509.UnsupportedGeneralNameType, + UnicodeError, + ) as e: + # A problem has been found with the quality of the certificate. Assume + # no SAN field is present. + log.warning( + "A problem was encountered with the certificate that prevented " + "urllib3 from finding the SubjectAlternativeName field. This can " + "affect certificate validation. The error was %s", + e, + ) + return [] + + # We want to return dNSName and iPAddress fields. We need to cast the IPs + # back to strings because the match_hostname function wants them as + # strings. + # Sadly the DNS names need to be idna encoded and then, on Python 3, UTF-8 + # decoded. This is pretty frustrating, but that's what the standard library + # does with certificates, and so we need to attempt to do the same. + # We also want to skip over names which cannot be idna encoded. + names = [ + ("DNS", name) + for name in map(_dnsname_to_stdlib, ext.get_values_for_type(x509.DNSName)) + if name is not None + ] + names.extend( + ("IP Address", str(name)) for name in ext.get_values_for_type(x509.IPAddress) + ) + + return names + + +class WrappedSocket: + """API-compatibility wrapper for Python OpenSSL's Connection-class.""" + + def __init__( + self, + connection: OpenSSL.SSL.Connection, + socket: socket_cls, + suppress_ragged_eofs: bool = True, + ) -> None: + self.connection = connection + self.socket = socket + self.suppress_ragged_eofs = suppress_ragged_eofs + self._io_refs = 0 + self._closed = False + + def fileno(self) -> int: + return self.socket.fileno() + + # Copy-pasted from Python 3.5 source code + def _decref_socketios(self) -> None: + if self._io_refs > 0: + self._io_refs -= 1 + if self._closed: + self.close() + + def recv(self, *args: typing.Any, **kwargs: typing.Any) -> bytes: + try: + data = self.connection.recv(*args, **kwargs) + except OpenSSL.SSL.SysCallError as e: + if self.suppress_ragged_eofs and e.args == (-1, "Unexpected EOF"): + return b"" + else: + raise OSError(e.args[0], str(e)) from e + except OpenSSL.SSL.ZeroReturnError: + if self.connection.get_shutdown() == OpenSSL.SSL.RECEIVED_SHUTDOWN: + return b"" + else: + raise + except OpenSSL.SSL.WantReadError as e: + if not util.wait_for_read(self.socket, self.socket.gettimeout()): + raise timeout("The read operation timed out") from e + else: + return self.recv(*args, **kwargs) + + # TLS 1.3 post-handshake authentication + except OpenSSL.SSL.Error as e: + raise ssl.SSLError(f"read error: {e!r}") from e + else: + return data # type: ignore[no-any-return] + + def recv_into(self, *args: typing.Any, **kwargs: typing.Any) -> int: + try: + return self.connection.recv_into(*args, **kwargs) # type: ignore[no-any-return] + except OpenSSL.SSL.SysCallError as e: + if self.suppress_ragged_eofs and e.args == (-1, "Unexpected EOF"): + return 0 + else: + raise OSError(e.args[0], str(e)) from e + except OpenSSL.SSL.ZeroReturnError: + if self.connection.get_shutdown() == OpenSSL.SSL.RECEIVED_SHUTDOWN: + return 0 + else: + raise + except OpenSSL.SSL.WantReadError as e: + if not util.wait_for_read(self.socket, self.socket.gettimeout()): + raise timeout("The read operation timed out") from e + else: + return self.recv_into(*args, **kwargs) + + # TLS 1.3 post-handshake authentication + except OpenSSL.SSL.Error as e: + raise ssl.SSLError(f"read error: {e!r}") from e + + def settimeout(self, timeout: float) -> None: + return self.socket.settimeout(timeout) + + def _send_until_done(self, data: bytes) -> int: + while True: + try: + return self.connection.send(data) # type: ignore[no-any-return] + except OpenSSL.SSL.WantWriteError as e: + if not util.wait_for_write(self.socket, self.socket.gettimeout()): + raise timeout() from e + continue + except OpenSSL.SSL.SysCallError as e: + raise OSError(e.args[0], str(e)) from e + + def sendall(self, data: bytes) -> None: + total_sent = 0 + while total_sent < len(data): + sent = self._send_until_done( + data[total_sent : total_sent + SSL_WRITE_BLOCKSIZE] + ) + total_sent += sent + + def shutdown(self) -> None: + # FIXME rethrow compatible exceptions should we ever use this + self.connection.shutdown() + + def close(self) -> None: + self._closed = True + if self._io_refs <= 0: + self._real_close() + + def _real_close(self) -> None: + try: + return self.connection.close() # type: ignore[no-any-return] + except OpenSSL.SSL.Error: + return + + def getpeercert( + self, binary_form: bool = False + ) -> dict[str, list[typing.Any]] | None: + x509 = self.connection.get_peer_certificate() + + if not x509: + return x509 # type: ignore[no-any-return] + + if binary_form: + return OpenSSL.crypto.dump_certificate(OpenSSL.crypto.FILETYPE_ASN1, x509) # type: ignore[no-any-return] + + return { + "subject": ((("commonName", x509.get_subject().CN),),), # type: ignore[dict-item] + "subjectAltName": get_subj_alt_name(x509), + } + + def version(self) -> str: + return self.connection.get_protocol_version_name() # type: ignore[no-any-return] + + +WrappedSocket.makefile = socket_cls.makefile # type: ignore[attr-defined] + + +class PyOpenSSLContext: + """ + I am a wrapper class for the PyOpenSSL ``Context`` object. I am responsible + for translating the interface of the standard library ``SSLContext`` object + to calls into PyOpenSSL. + """ + + def __init__(self, protocol: int) -> None: + self.protocol = _openssl_versions[protocol] + self._ctx = OpenSSL.SSL.Context(self.protocol) + self._options = 0 + self.check_hostname = False + self._minimum_version: int = ssl.TLSVersion.MINIMUM_SUPPORTED + self._maximum_version: int = ssl.TLSVersion.MAXIMUM_SUPPORTED + + @property + def options(self) -> int: + return self._options + + @options.setter + def options(self, value: int) -> None: + self._options = value + self._set_ctx_options() + + @property + def verify_mode(self) -> int: + return _openssl_to_stdlib_verify[self._ctx.get_verify_mode()] + + @verify_mode.setter + def verify_mode(self, value: ssl.VerifyMode) -> None: + self._ctx.set_verify(_stdlib_to_openssl_verify[value], _verify_callback) + + def set_default_verify_paths(self) -> None: + self._ctx.set_default_verify_paths() + + def set_ciphers(self, ciphers: bytes | str) -> None: + if isinstance(ciphers, str): + ciphers = ciphers.encode("utf-8") + self._ctx.set_cipher_list(ciphers) + + def load_verify_locations( + self, + cafile: str | None = None, + capath: str | None = None, + cadata: bytes | None = None, + ) -> None: + if cafile is not None: + cafile = cafile.encode("utf-8") # type: ignore[assignment] + if capath is not None: + capath = capath.encode("utf-8") # type: ignore[assignment] + try: + self._ctx.load_verify_locations(cafile, capath) + if cadata is not None: + self._ctx.load_verify_locations(BytesIO(cadata)) + except OpenSSL.SSL.Error as e: + raise ssl.SSLError(f"unable to load trusted certificates: {e!r}") from e + + def load_cert_chain( + self, + certfile: str, + keyfile: str | None = None, + password: str | None = None, + ) -> None: + try: + self._ctx.use_certificate_chain_file(certfile) + if password is not None: + if not isinstance(password, bytes): + password = password.encode("utf-8") # type: ignore[assignment] + self._ctx.set_passwd_cb(lambda *_: password) + self._ctx.use_privatekey_file(keyfile or certfile) + except OpenSSL.SSL.Error as e: + raise ssl.SSLError(f"Unable to load certificate chain: {e!r}") from e + + def set_alpn_protocols(self, protocols: list[bytes | str]) -> None: + protocols = [util.util.to_bytes(p, "ascii") for p in protocols] + return self._ctx.set_alpn_protos(protocols) # type: ignore[no-any-return] + + def wrap_socket( + self, + sock: socket_cls, + server_side: bool = False, + do_handshake_on_connect: bool = True, + suppress_ragged_eofs: bool = True, + server_hostname: bytes | str | None = None, + ) -> WrappedSocket: + cnx = OpenSSL.SSL.Connection(self._ctx, sock) + + # If server_hostname is an IP, don't use it for SNI, per RFC6066 Section 3 + if server_hostname and not util.ssl_.is_ipaddress(server_hostname): + if isinstance(server_hostname, str): + server_hostname = server_hostname.encode("utf-8") + cnx.set_tlsext_host_name(server_hostname) + + cnx.set_connect_state() + + while True: + try: + cnx.do_handshake() + except OpenSSL.SSL.WantReadError as e: + if not util.wait_for_read(sock, sock.gettimeout()): + raise timeout("select timed out") from e + continue + except OpenSSL.SSL.Error as e: + raise ssl.SSLError(f"bad handshake: {e!r}") from e + break + + return WrappedSocket(cnx, sock) + + def _set_ctx_options(self) -> None: + self._ctx.set_options( + self._options + | _openssl_to_ssl_minimum_version[self._minimum_version] + | _openssl_to_ssl_maximum_version[self._maximum_version] + ) + + @property + def minimum_version(self) -> int: + return self._minimum_version + + @minimum_version.setter + def minimum_version(self, minimum_version: int) -> None: + self._minimum_version = minimum_version + self._set_ctx_options() + + @property + def maximum_version(self) -> int: + return self._maximum_version + + @maximum_version.setter + def maximum_version(self, maximum_version: int) -> None: + self._maximum_version = maximum_version + self._set_ctx_options() + + +def _verify_callback( + cnx: OpenSSL.SSL.Connection, + x509: X509, + err_no: int, + err_depth: int, + return_code: int, +) -> bool: + return err_no == 0 diff --git a/.venv/lib/python3.12/site-packages/urllib3/contrib/socks.py b/.venv/lib/python3.12/site-packages/urllib3/contrib/socks.py new file mode 100644 index 0000000..c62b5e0 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/urllib3/contrib/socks.py @@ -0,0 +1,228 @@ +""" +This module contains provisional support for SOCKS proxies from within +urllib3. This module supports SOCKS4, SOCKS4A (an extension of SOCKS4), and +SOCKS5. To enable its functionality, either install PySocks or install this +module with the ``socks`` extra. + +The SOCKS implementation supports the full range of urllib3 features. It also +supports the following SOCKS features: + +- SOCKS4A (``proxy_url='socks4a://...``) +- SOCKS4 (``proxy_url='socks4://...``) +- SOCKS5 with remote DNS (``proxy_url='socks5h://...``) +- SOCKS5 with local DNS (``proxy_url='socks5://...``) +- Usernames and passwords for the SOCKS proxy + +.. note:: + It is recommended to use ``socks5h://`` or ``socks4a://`` schemes in + your ``proxy_url`` to ensure that DNS resolution is done from the remote + server instead of client-side when connecting to a domain name. + +SOCKS4 supports IPv4 and domain names with the SOCKS4A extension. SOCKS5 +supports IPv4, IPv6, and domain names. + +When connecting to a SOCKS4 proxy the ``username`` portion of the ``proxy_url`` +will be sent as the ``userid`` section of the SOCKS request: + +.. code-block:: python + + proxy_url="socks4a://@proxy-host" + +When connecting to a SOCKS5 proxy the ``username`` and ``password`` portion +of the ``proxy_url`` will be sent as the username/password to authenticate +with the proxy: + +.. code-block:: python + + proxy_url="socks5h://:@proxy-host" + +""" + +from __future__ import annotations + +try: + import socks # type: ignore[import-not-found] +except ImportError: + import warnings + + from ..exceptions import DependencyWarning + + warnings.warn( + ( + "SOCKS support in urllib3 requires the installation of optional " + "dependencies: specifically, PySocks. For more information, see " + "https://urllib3.readthedocs.io/en/latest/advanced-usage.html#socks-proxies" + ), + DependencyWarning, + ) + raise + +import typing +from socket import timeout as SocketTimeout + +from ..connection import HTTPConnection, HTTPSConnection +from ..connectionpool import HTTPConnectionPool, HTTPSConnectionPool +from ..exceptions import ConnectTimeoutError, NewConnectionError +from ..poolmanager import PoolManager +from ..util.url import parse_url + +try: + import ssl +except ImportError: + ssl = None # type: ignore[assignment] + + +class _TYPE_SOCKS_OPTIONS(typing.TypedDict): + socks_version: int + proxy_host: str | None + proxy_port: str | None + username: str | None + password: str | None + rdns: bool + + +class SOCKSConnection(HTTPConnection): + """ + A plain-text HTTP connection that connects via a SOCKS proxy. + """ + + def __init__( + self, + _socks_options: _TYPE_SOCKS_OPTIONS, + *args: typing.Any, + **kwargs: typing.Any, + ) -> None: + self._socks_options = _socks_options + super().__init__(*args, **kwargs) + + def _new_conn(self) -> socks.socksocket: + """ + Establish a new connection via the SOCKS proxy. + """ + extra_kw: dict[str, typing.Any] = {} + if self.source_address: + extra_kw["source_address"] = self.source_address + + if self.socket_options: + extra_kw["socket_options"] = self.socket_options + + try: + conn = socks.create_connection( + (self.host, self.port), + proxy_type=self._socks_options["socks_version"], + proxy_addr=self._socks_options["proxy_host"], + proxy_port=self._socks_options["proxy_port"], + proxy_username=self._socks_options["username"], + proxy_password=self._socks_options["password"], + proxy_rdns=self._socks_options["rdns"], + timeout=self.timeout, + **extra_kw, + ) + + except SocketTimeout as e: + raise ConnectTimeoutError( + self, + f"Connection to {self.host} timed out. (connect timeout={self.timeout})", + ) from e + + except socks.ProxyError as e: + # This is fragile as hell, but it seems to be the only way to raise + # useful errors here. + if e.socket_err: + error = e.socket_err + if isinstance(error, SocketTimeout): + raise ConnectTimeoutError( + self, + f"Connection to {self.host} timed out. (connect timeout={self.timeout})", + ) from e + else: + # Adding `from e` messes with coverage somehow, so it's omitted. + # See #2386. + raise NewConnectionError( + self, f"Failed to establish a new connection: {error}" + ) + else: + raise NewConnectionError( + self, f"Failed to establish a new connection: {e}" + ) from e + + except OSError as e: # Defensive: PySocks should catch all these. + raise NewConnectionError( + self, f"Failed to establish a new connection: {e}" + ) from e + + return conn + + +# We don't need to duplicate the Verified/Unverified distinction from +# urllib3/connection.py here because the HTTPSConnection will already have been +# correctly set to either the Verified or Unverified form by that module. This +# means the SOCKSHTTPSConnection will automatically be the correct type. +class SOCKSHTTPSConnection(SOCKSConnection, HTTPSConnection): + pass + + +class SOCKSHTTPConnectionPool(HTTPConnectionPool): + ConnectionCls = SOCKSConnection + + +class SOCKSHTTPSConnectionPool(HTTPSConnectionPool): + ConnectionCls = SOCKSHTTPSConnection + + +class SOCKSProxyManager(PoolManager): + """ + A version of the urllib3 ProxyManager that routes connections via the + defined SOCKS proxy. + """ + + pool_classes_by_scheme = { + "http": SOCKSHTTPConnectionPool, + "https": SOCKSHTTPSConnectionPool, + } + + def __init__( + self, + proxy_url: str, + username: str | None = None, + password: str | None = None, + num_pools: int = 10, + headers: typing.Mapping[str, str] | None = None, + **connection_pool_kw: typing.Any, + ): + parsed = parse_url(proxy_url) + + if username is None and password is None and parsed.auth is not None: + split = parsed.auth.split(":") + if len(split) == 2: + username, password = split + if parsed.scheme == "socks5": + socks_version = socks.PROXY_TYPE_SOCKS5 + rdns = False + elif parsed.scheme == "socks5h": + socks_version = socks.PROXY_TYPE_SOCKS5 + rdns = True + elif parsed.scheme == "socks4": + socks_version = socks.PROXY_TYPE_SOCKS4 + rdns = False + elif parsed.scheme == "socks4a": + socks_version = socks.PROXY_TYPE_SOCKS4 + rdns = True + else: + raise ValueError(f"Unable to determine SOCKS version from {proxy_url}") + + self.proxy_url = proxy_url + + socks_options = { + "socks_version": socks_version, + "proxy_host": parsed.host, + "proxy_port": parsed.port, + "username": username, + "password": password, + "rdns": rdns, + } + connection_pool_kw["_socks_options"] = socks_options + + super().__init__(num_pools, headers, **connection_pool_kw) + + self.pool_classes_by_scheme = SOCKSProxyManager.pool_classes_by_scheme diff --git a/.venv/lib/python3.12/site-packages/urllib3/exceptions.py b/.venv/lib/python3.12/site-packages/urllib3/exceptions.py new file mode 100644 index 0000000..b0792f0 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/urllib3/exceptions.py @@ -0,0 +1,321 @@ +from __future__ import annotations + +import socket +import typing +import warnings +from email.errors import MessageDefect +from http.client import IncompleteRead as httplib_IncompleteRead + +if typing.TYPE_CHECKING: + from .connection import HTTPConnection + from .connectionpool import ConnectionPool + from .response import HTTPResponse + from .util.retry import Retry + +# Base Exceptions + + +class HTTPError(Exception): + """Base exception used by this module.""" + + +class HTTPWarning(Warning): + """Base warning used by this module.""" + + +_TYPE_REDUCE_RESULT = typing.Tuple[ + typing.Callable[..., object], typing.Tuple[object, ...] +] + + +class PoolError(HTTPError): + """Base exception for errors caused within a pool.""" + + def __init__(self, pool: ConnectionPool, message: str) -> None: + self.pool = pool + super().__init__(f"{pool}: {message}") + + def __reduce__(self) -> _TYPE_REDUCE_RESULT: + # For pickling purposes. + return self.__class__, (None, None) + + +class RequestError(PoolError): + """Base exception for PoolErrors that have associated URLs.""" + + def __init__(self, pool: ConnectionPool, url: str, message: str) -> None: + self.url = url + super().__init__(pool, message) + + def __reduce__(self) -> _TYPE_REDUCE_RESULT: + # For pickling purposes. + return self.__class__, (None, self.url, None) + + +class SSLError(HTTPError): + """Raised when SSL certificate fails in an HTTPS connection.""" + + +class ProxyError(HTTPError): + """Raised when the connection to a proxy fails.""" + + # The original error is also available as __cause__. + original_error: Exception + + def __init__(self, message: str, error: Exception) -> None: + super().__init__(message, error) + self.original_error = error + + +class DecodeError(HTTPError): + """Raised when automatic decoding based on Content-Type fails.""" + + +class ProtocolError(HTTPError): + """Raised when something unexpected happens mid-request/response.""" + + +#: Renamed to ProtocolError but aliased for backwards compatibility. +ConnectionError = ProtocolError + + +# Leaf Exceptions + + +class MaxRetryError(RequestError): + """Raised when the maximum number of retries is exceeded. + + :param pool: The connection pool + :type pool: :class:`~urllib3.connectionpool.HTTPConnectionPool` + :param str url: The requested Url + :param reason: The underlying error + :type reason: :class:`Exception` + + """ + + def __init__( + self, pool: ConnectionPool, url: str, reason: Exception | None = None + ) -> None: + self.reason = reason + + message = f"Max retries exceeded with url: {url} (Caused by {reason!r})" + + super().__init__(pool, url, message) + + +class HostChangedError(RequestError): + """Raised when an existing pool gets a request for a foreign host.""" + + def __init__( + self, pool: ConnectionPool, url: str, retries: Retry | int = 3 + ) -> None: + message = f"Tried to open a foreign host with url: {url}" + super().__init__(pool, url, message) + self.retries = retries + + +class TimeoutStateError(HTTPError): + """Raised when passing an invalid state to a timeout""" + + +class TimeoutError(HTTPError): + """Raised when a socket timeout error occurs. + + Catching this error will catch both :exc:`ReadTimeoutErrors + ` and :exc:`ConnectTimeoutErrors `. + """ + + +class ReadTimeoutError(TimeoutError, RequestError): + """Raised when a socket timeout occurs while receiving data from a server""" + + +# This timeout error does not have a URL attached and needs to inherit from the +# base HTTPError +class ConnectTimeoutError(TimeoutError): + """Raised when a socket timeout occurs while connecting to a server""" + + +class NewConnectionError(ConnectTimeoutError, HTTPError): + """Raised when we fail to establish a new connection. Usually ECONNREFUSED.""" + + def __init__(self, conn: HTTPConnection, message: str) -> None: + self.conn = conn + super().__init__(f"{conn}: {message}") + + @property + def pool(self) -> HTTPConnection: + warnings.warn( + "The 'pool' property is deprecated and will be removed " + "in urllib3 v2.1.0. Use 'conn' instead.", + DeprecationWarning, + stacklevel=2, + ) + + return self.conn + + +class NameResolutionError(NewConnectionError): + """Raised when host name resolution fails.""" + + def __init__(self, host: str, conn: HTTPConnection, reason: socket.gaierror): + message = f"Failed to resolve '{host}' ({reason})" + super().__init__(conn, message) + + +class EmptyPoolError(PoolError): + """Raised when a pool runs out of connections and no more are allowed.""" + + +class FullPoolError(PoolError): + """Raised when we try to add a connection to a full pool in blocking mode.""" + + +class ClosedPoolError(PoolError): + """Raised when a request enters a pool after the pool has been closed.""" + + +class LocationValueError(ValueError, HTTPError): + """Raised when there is something wrong with a given URL input.""" + + +class LocationParseError(LocationValueError): + """Raised when get_host or similar fails to parse the URL input.""" + + def __init__(self, location: str) -> None: + message = f"Failed to parse: {location}" + super().__init__(message) + + self.location = location + + +class URLSchemeUnknown(LocationValueError): + """Raised when a URL input has an unsupported scheme.""" + + def __init__(self, scheme: str): + message = f"Not supported URL scheme {scheme}" + super().__init__(message) + + self.scheme = scheme + + +class ResponseError(HTTPError): + """Used as a container for an error reason supplied in a MaxRetryError.""" + + GENERIC_ERROR = "too many error responses" + SPECIFIC_ERROR = "too many {status_code} error responses" + + +class SecurityWarning(HTTPWarning): + """Warned when performing security reducing actions""" + + +class InsecureRequestWarning(SecurityWarning): + """Warned when making an unverified HTTPS request.""" + + +class NotOpenSSLWarning(SecurityWarning): + """Warned when using unsupported SSL library""" + + +class SystemTimeWarning(SecurityWarning): + """Warned when system time is suspected to be wrong""" + + +class InsecurePlatformWarning(SecurityWarning): + """Warned when certain TLS/SSL configuration is not available on a platform.""" + + +class DependencyWarning(HTTPWarning): + """ + Warned when an attempt is made to import a module with missing optional + dependencies. + """ + + +class ResponseNotChunked(ProtocolError, ValueError): + """Response needs to be chunked in order to read it as chunks.""" + + +class BodyNotHttplibCompatible(HTTPError): + """ + Body should be :class:`http.client.HTTPResponse` like + (have an fp attribute which returns raw chunks) for read_chunked(). + """ + + +class IncompleteRead(HTTPError, httplib_IncompleteRead): + """ + Response length doesn't match expected Content-Length + + Subclass of :class:`http.client.IncompleteRead` to allow int value + for ``partial`` to avoid creating large objects on streamed reads. + """ + + partial: int # type: ignore[assignment] + expected: int + + def __init__(self, partial: int, expected: int) -> None: + self.partial = partial + self.expected = expected + + def __repr__(self) -> str: + return "IncompleteRead(%i bytes read, %i more expected)" % ( + self.partial, + self.expected, + ) + + +class InvalidChunkLength(HTTPError, httplib_IncompleteRead): + """Invalid chunk length in a chunked response.""" + + def __init__(self, response: HTTPResponse, length: bytes) -> None: + self.partial: int = response.tell() # type: ignore[assignment] + self.expected: int | None = response.length_remaining + self.response = response + self.length = length + + def __repr__(self) -> str: + return "InvalidChunkLength(got length %r, %i bytes read)" % ( + self.length, + self.partial, + ) + + +class InvalidHeader(HTTPError): + """The header provided was somehow invalid.""" + + +class ProxySchemeUnknown(AssertionError, URLSchemeUnknown): + """ProxyManager does not support the supplied scheme""" + + # TODO(t-8ch): Stop inheriting from AssertionError in v2.0. + + def __init__(self, scheme: str | None) -> None: + # 'localhost' is here because our URL parser parses + # localhost:8080 -> scheme=localhost, remove if we fix this. + if scheme == "localhost": + scheme = None + if scheme is None: + message = "Proxy URL had no scheme, should start with http:// or https://" + else: + message = f"Proxy URL had unsupported scheme {scheme}, should use http:// or https://" + super().__init__(message) + + +class ProxySchemeUnsupported(ValueError): + """Fetching HTTPS resources through HTTPS proxies is unsupported""" + + +class HeaderParsingError(HTTPError): + """Raised by assert_header_parsing, but we convert it to a log.warning statement.""" + + def __init__( + self, defects: list[MessageDefect], unparsed_data: bytes | str | None + ) -> None: + message = f"{defects or 'Unknown'}, unparsed data: {unparsed_data!r}" + super().__init__(message) + + +class UnrewindableBodyError(HTTPError): + """urllib3 encountered an error when trying to rewind a body""" diff --git a/.venv/lib/python3.12/site-packages/urllib3/fields.py b/.venv/lib/python3.12/site-packages/urllib3/fields.py new file mode 100644 index 0000000..3e258a5 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/urllib3/fields.py @@ -0,0 +1,341 @@ +from __future__ import annotations + +import email.utils +import mimetypes +import typing + +_TYPE_FIELD_VALUE = typing.Union[str, bytes] +_TYPE_FIELD_VALUE_TUPLE = typing.Union[ + _TYPE_FIELD_VALUE, + typing.Tuple[str, _TYPE_FIELD_VALUE], + typing.Tuple[str, _TYPE_FIELD_VALUE, str], +] + + +def guess_content_type( + filename: str | None, default: str = "application/octet-stream" +) -> str: + """ + Guess the "Content-Type" of a file. + + :param filename: + The filename to guess the "Content-Type" of using :mod:`mimetypes`. + :param default: + If no "Content-Type" can be guessed, default to `default`. + """ + if filename: + return mimetypes.guess_type(filename)[0] or default + return default + + +def format_header_param_rfc2231(name: str, value: _TYPE_FIELD_VALUE) -> str: + """ + Helper function to format and quote a single header parameter using the + strategy defined in RFC 2231. + + Particularly useful for header parameters which might contain + non-ASCII values, like file names. This follows + `RFC 2388 Section 4.4 `_. + + :param name: + The name of the parameter, a string expected to be ASCII only. + :param value: + The value of the parameter, provided as ``bytes`` or `str``. + :returns: + An RFC-2231-formatted unicode string. + + .. deprecated:: 2.0.0 + Will be removed in urllib3 v2.1.0. This is not valid for + ``multipart/form-data`` header parameters. + """ + import warnings + + warnings.warn( + "'format_header_param_rfc2231' is deprecated and will be " + "removed in urllib3 v2.1.0. This is not valid for " + "multipart/form-data header parameters.", + DeprecationWarning, + stacklevel=2, + ) + + if isinstance(value, bytes): + value = value.decode("utf-8") + + if not any(ch in value for ch in '"\\\r\n'): + result = f'{name}="{value}"' + try: + result.encode("ascii") + except (UnicodeEncodeError, UnicodeDecodeError): + pass + else: + return result + + value = email.utils.encode_rfc2231(value, "utf-8") + value = f"{name}*={value}" + + return value + + +def format_multipart_header_param(name: str, value: _TYPE_FIELD_VALUE) -> str: + """ + Format and quote a single multipart header parameter. + + This follows the `WHATWG HTML Standard`_ as of 2021/06/10, matching + the behavior of current browser and curl versions. Values are + assumed to be UTF-8. The ``\\n``, ``\\r``, and ``"`` characters are + percent encoded. + + .. _WHATWG HTML Standard: + https://html.spec.whatwg.org/multipage/ + form-control-infrastructure.html#multipart-form-data + + :param name: + The name of the parameter, an ASCII-only ``str``. + :param value: + The value of the parameter, a ``str`` or UTF-8 encoded + ``bytes``. + :returns: + A string ``name="value"`` with the escaped value. + + .. versionchanged:: 2.0.0 + Matches the WHATWG HTML Standard as of 2021/06/10. Control + characters are no longer percent encoded. + + .. versionchanged:: 2.0.0 + Renamed from ``format_header_param_html5`` and + ``format_header_param``. The old names will be removed in + urllib3 v2.1.0. + """ + if isinstance(value, bytes): + value = value.decode("utf-8") + + # percent encode \n \r " + value = value.translate({10: "%0A", 13: "%0D", 34: "%22"}) + return f'{name}="{value}"' + + +def format_header_param_html5(name: str, value: _TYPE_FIELD_VALUE) -> str: + """ + .. deprecated:: 2.0.0 + Renamed to :func:`format_multipart_header_param`. Will be + removed in urllib3 v2.1.0. + """ + import warnings + + warnings.warn( + "'format_header_param_html5' has been renamed to " + "'format_multipart_header_param'. The old name will be " + "removed in urllib3 v2.1.0.", + DeprecationWarning, + stacklevel=2, + ) + return format_multipart_header_param(name, value) + + +def format_header_param(name: str, value: _TYPE_FIELD_VALUE) -> str: + """ + .. deprecated:: 2.0.0 + Renamed to :func:`format_multipart_header_param`. Will be + removed in urllib3 v2.1.0. + """ + import warnings + + warnings.warn( + "'format_header_param' has been renamed to " + "'format_multipart_header_param'. The old name will be " + "removed in urllib3 v2.1.0.", + DeprecationWarning, + stacklevel=2, + ) + return format_multipart_header_param(name, value) + + +class RequestField: + """ + A data container for request body parameters. + + :param name: + The name of this request field. Must be unicode. + :param data: + The data/value body. + :param filename: + An optional filename of the request field. Must be unicode. + :param headers: + An optional dict-like object of headers to initially use for the field. + + .. versionchanged:: 2.0.0 + The ``header_formatter`` parameter is deprecated and will + be removed in urllib3 v2.1.0. + """ + + def __init__( + self, + name: str, + data: _TYPE_FIELD_VALUE, + filename: str | None = None, + headers: typing.Mapping[str, str] | None = None, + header_formatter: typing.Callable[[str, _TYPE_FIELD_VALUE], str] | None = None, + ): + self._name = name + self._filename = filename + self.data = data + self.headers: dict[str, str | None] = {} + if headers: + self.headers = dict(headers) + + if header_formatter is not None: + import warnings + + warnings.warn( + "The 'header_formatter' parameter is deprecated and " + "will be removed in urllib3 v2.1.0.", + DeprecationWarning, + stacklevel=2, + ) + self.header_formatter = header_formatter + else: + self.header_formatter = format_multipart_header_param + + @classmethod + def from_tuples( + cls, + fieldname: str, + value: _TYPE_FIELD_VALUE_TUPLE, + header_formatter: typing.Callable[[str, _TYPE_FIELD_VALUE], str] | None = None, + ) -> RequestField: + """ + A :class:`~urllib3.fields.RequestField` factory from old-style tuple parameters. + + Supports constructing :class:`~urllib3.fields.RequestField` from + parameter of key/value strings AND key/filetuple. A filetuple is a + (filename, data, MIME type) tuple where the MIME type is optional. + For example:: + + 'foo': 'bar', + 'fakefile': ('foofile.txt', 'contents of foofile'), + 'realfile': ('barfile.txt', open('realfile').read()), + 'typedfile': ('bazfile.bin', open('bazfile').read(), 'image/jpeg'), + 'nonamefile': 'contents of nonamefile field', + + Field names and filenames must be unicode. + """ + filename: str | None + content_type: str | None + data: _TYPE_FIELD_VALUE + + if isinstance(value, tuple): + if len(value) == 3: + filename, data, content_type = value + else: + filename, data = value + content_type = guess_content_type(filename) + else: + filename = None + content_type = None + data = value + + request_param = cls( + fieldname, data, filename=filename, header_formatter=header_formatter + ) + request_param.make_multipart(content_type=content_type) + + return request_param + + def _render_part(self, name: str, value: _TYPE_FIELD_VALUE) -> str: + """ + Override this method to change how each multipart header + parameter is formatted. By default, this calls + :func:`format_multipart_header_param`. + + :param name: + The name of the parameter, an ASCII-only ``str``. + :param value: + The value of the parameter, a ``str`` or UTF-8 encoded + ``bytes``. + + :meta public: + """ + return self.header_formatter(name, value) + + def _render_parts( + self, + header_parts: ( + dict[str, _TYPE_FIELD_VALUE | None] + | typing.Sequence[tuple[str, _TYPE_FIELD_VALUE | None]] + ), + ) -> str: + """ + Helper function to format and quote a single header. + + Useful for single headers that are composed of multiple items. E.g., + 'Content-Disposition' fields. + + :param header_parts: + A sequence of (k, v) tuples or a :class:`dict` of (k, v) to format + as `k1="v1"; k2="v2"; ...`. + """ + iterable: typing.Iterable[tuple[str, _TYPE_FIELD_VALUE | None]] + + parts = [] + if isinstance(header_parts, dict): + iterable = header_parts.items() + else: + iterable = header_parts + + for name, value in iterable: + if value is not None: + parts.append(self._render_part(name, value)) + + return "; ".join(parts) + + def render_headers(self) -> str: + """ + Renders the headers for this request field. + """ + lines = [] + + sort_keys = ["Content-Disposition", "Content-Type", "Content-Location"] + for sort_key in sort_keys: + if self.headers.get(sort_key, False): + lines.append(f"{sort_key}: {self.headers[sort_key]}") + + for header_name, header_value in self.headers.items(): + if header_name not in sort_keys: + if header_value: + lines.append(f"{header_name}: {header_value}") + + lines.append("\r\n") + return "\r\n".join(lines) + + def make_multipart( + self, + content_disposition: str | None = None, + content_type: str | None = None, + content_location: str | None = None, + ) -> None: + """ + Makes this request field into a multipart request field. + + This method overrides "Content-Disposition", "Content-Type" and + "Content-Location" headers to the request parameter. + + :param content_disposition: + The 'Content-Disposition' of the request body. Defaults to 'form-data' + :param content_type: + The 'Content-Type' of the request body. + :param content_location: + The 'Content-Location' of the request body. + + """ + content_disposition = (content_disposition or "form-data") + "; ".join( + [ + "", + self._render_parts( + (("name", self._name), ("filename", self._filename)) + ), + ] + ) + + self.headers["Content-Disposition"] = content_disposition + self.headers["Content-Type"] = content_type + self.headers["Content-Location"] = content_location diff --git a/.venv/lib/python3.12/site-packages/urllib3/filepost.py b/.venv/lib/python3.12/site-packages/urllib3/filepost.py new file mode 100644 index 0000000..1c90a21 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/urllib3/filepost.py @@ -0,0 +1,89 @@ +from __future__ import annotations + +import binascii +import codecs +import os +import typing +from io import BytesIO + +from .fields import _TYPE_FIELD_VALUE_TUPLE, RequestField + +writer = codecs.lookup("utf-8")[3] + +_TYPE_FIELDS_SEQUENCE = typing.Sequence[ + typing.Union[typing.Tuple[str, _TYPE_FIELD_VALUE_TUPLE], RequestField] +] +_TYPE_FIELDS = typing.Union[ + _TYPE_FIELDS_SEQUENCE, + typing.Mapping[str, _TYPE_FIELD_VALUE_TUPLE], +] + + +def choose_boundary() -> str: + """ + Our embarrassingly-simple replacement for mimetools.choose_boundary. + """ + return binascii.hexlify(os.urandom(16)).decode() + + +def iter_field_objects(fields: _TYPE_FIELDS) -> typing.Iterable[RequestField]: + """ + Iterate over fields. + + Supports list of (k, v) tuples and dicts, and lists of + :class:`~urllib3.fields.RequestField`. + + """ + iterable: typing.Iterable[RequestField | tuple[str, _TYPE_FIELD_VALUE_TUPLE]] + + if isinstance(fields, typing.Mapping): + iterable = fields.items() + else: + iterable = fields + + for field in iterable: + if isinstance(field, RequestField): + yield field + else: + yield RequestField.from_tuples(*field) + + +def encode_multipart_formdata( + fields: _TYPE_FIELDS, boundary: str | None = None +) -> tuple[bytes, str]: + """ + Encode a dictionary of ``fields`` using the multipart/form-data MIME format. + + :param fields: + Dictionary of fields or list of (key, :class:`~urllib3.fields.RequestField`). + Values are processed by :func:`urllib3.fields.RequestField.from_tuples`. + + :param boundary: + If not specified, then a random boundary will be generated using + :func:`urllib3.filepost.choose_boundary`. + """ + body = BytesIO() + if boundary is None: + boundary = choose_boundary() + + for field in iter_field_objects(fields): + body.write(f"--{boundary}\r\n".encode("latin-1")) + + writer(body).write(field.render_headers()) + data = field.data + + if isinstance(data, int): + data = str(data) # Backwards compatibility + + if isinstance(data, str): + writer(body).write(data) + else: + body.write(data) + + body.write(b"\r\n") + + body.write(f"--{boundary}--\r\n".encode("latin-1")) + + content_type = f"multipart/form-data; boundary={boundary}" + + return body.getvalue(), content_type diff --git a/.venv/lib/python3.12/site-packages/urllib3/http2.py b/.venv/lib/python3.12/site-packages/urllib3/http2.py new file mode 100644 index 0000000..ceb4060 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/urllib3/http2.py @@ -0,0 +1,230 @@ +from __future__ import annotations + +import threading +import types +import typing + +import h2.config # type: ignore[import-untyped] +import h2.connection # type: ignore[import-untyped] +import h2.events # type: ignore[import-untyped] + +import urllib3.connection +import urllib3.util.ssl_ +from urllib3.response import BaseHTTPResponse + +from ._collections import HTTPHeaderDict +from .connection import HTTPSConnection +from .connectionpool import HTTPSConnectionPool + +orig_HTTPSConnection = HTTPSConnection + +T = typing.TypeVar("T") + + +class _LockedObject(typing.Generic[T]): + """ + A wrapper class that hides a specific object behind a lock. + + The goal here is to provide a simple way to protect access to an object + that cannot safely be simultaneously accessed from multiple threads. The + intended use of this class is simple: take hold of it with a context + manager, which returns the protected object. + """ + + def __init__(self, obj: T): + self.lock = threading.RLock() + self._obj = obj + + def __enter__(self) -> T: + self.lock.acquire() + return self._obj + + def __exit__( + self, + exc_type: type[BaseException] | None, + exc_val: BaseException | None, + exc_tb: types.TracebackType | None, + ) -> None: + self.lock.release() + + +class HTTP2Connection(HTTPSConnection): + def __init__( + self, host: str, port: int | None = None, **kwargs: typing.Any + ) -> None: + self._h2_conn = self._new_h2_conn() + self._h2_stream: int | None = None + self._h2_headers: list[tuple[bytes, bytes]] = [] + + if "proxy" in kwargs or "proxy_config" in kwargs: # Defensive: + raise NotImplementedError("Proxies aren't supported with HTTP/2") + + super().__init__(host, port, **kwargs) + + def _new_h2_conn(self) -> _LockedObject[h2.connection.H2Connection]: + config = h2.config.H2Configuration(client_side=True) + return _LockedObject(h2.connection.H2Connection(config=config)) + + def connect(self) -> None: + super().connect() + + with self._h2_conn as h2_conn: + h2_conn.initiate_connection() + self.sock.sendall(h2_conn.data_to_send()) + + def putrequest( + self, + method: str, + url: str, + skip_host: bool = False, + skip_accept_encoding: bool = False, + ) -> None: + with self._h2_conn as h2_conn: + self._request_url = url + self._h2_stream = h2_conn.get_next_available_stream_id() + + if ":" in self.host: + authority = f"[{self.host}]:{self.port or 443}" + else: + authority = f"{self.host}:{self.port or 443}" + + self._h2_headers.extend( + ( + (b":scheme", b"https"), + (b":method", method.encode()), + (b":authority", authority.encode()), + (b":path", url.encode()), + ) + ) + + def putheader(self, header: str, *values: str) -> None: # type: ignore[override] + for value in values: + self._h2_headers.append( + (header.encode("utf-8").lower(), value.encode("utf-8")) + ) + + def endheaders(self) -> None: # type: ignore[override] + with self._h2_conn as h2_conn: + h2_conn.send_headers( + stream_id=self._h2_stream, + headers=self._h2_headers, + end_stream=True, + ) + if data_to_send := h2_conn.data_to_send(): + self.sock.sendall(data_to_send) + + def send(self, data: bytes) -> None: # type: ignore[override] # Defensive: + if not data: + return + raise NotImplementedError("Sending data isn't supported yet") + + def getresponse( # type: ignore[override] + self, + ) -> HTTP2Response: + status = None + data = bytearray() + with self._h2_conn as h2_conn: + end_stream = False + while not end_stream: + # TODO: Arbitrary read value. + if received_data := self.sock.recv(65535): + events = h2_conn.receive_data(received_data) + for event in events: + if isinstance(event, h2.events.ResponseReceived): + headers = HTTPHeaderDict() + for header, value in event.headers: + if header == b":status": + status = int(value.decode()) + else: + headers.add( + header.decode("ascii"), value.decode("ascii") + ) + + elif isinstance(event, h2.events.DataReceived): + data += event.data + h2_conn.acknowledge_received_data( + event.flow_controlled_length, event.stream_id + ) + + elif isinstance(event, h2.events.StreamEnded): + end_stream = True + + if data_to_send := h2_conn.data_to_send(): + self.sock.sendall(data_to_send) + + # We always close to not have to handle connection management. + self.close() + + assert status is not None + return HTTP2Response( + status=status, + headers=headers, + request_url=self._request_url, + data=bytes(data), + ) + + def close(self) -> None: + with self._h2_conn as h2_conn: + try: + h2_conn.close_connection() + if data := h2_conn.data_to_send(): + self.sock.sendall(data) + except Exception: + pass + + # Reset all our HTTP/2 connection state. + self._h2_conn = self._new_h2_conn() + self._h2_stream = None + self._h2_headers = [] + + super().close() + + +class HTTP2Response(BaseHTTPResponse): + # TODO: This is a woefully incomplete response object, but works for non-streaming. + def __init__( + self, + status: int, + headers: HTTPHeaderDict, + request_url: str, + data: bytes, + decode_content: bool = False, # TODO: support decoding + ) -> None: + super().__init__( + status=status, + headers=headers, + # Following CPython, we map HTTP versions to major * 10 + minor integers + version=20, + version_string="HTTP/2", + # No reason phrase in HTTP/2 + reason=None, + decode_content=decode_content, + request_url=request_url, + ) + self._data = data + self.length_remaining = 0 + + @property + def data(self) -> bytes: + return self._data + + def get_redirect_location(self) -> None: + return None + + def close(self) -> None: + pass + + +def inject_into_urllib3() -> None: + HTTPSConnectionPool.ConnectionCls = HTTP2Connection + urllib3.connection.HTTPSConnection = HTTP2Connection # type: ignore[misc] + + # TODO: Offer 'http/1.1' as well, but for testing purposes this is handy. + urllib3.util.ssl_.ALPN_PROTOCOLS = ["h2"] + + +def extract_from_urllib3() -> None: + HTTPSConnectionPool.ConnectionCls = orig_HTTPSConnection + urllib3.connection.HTTPSConnection = orig_HTTPSConnection # type: ignore[misc] + + urllib3.util.ssl_.ALPN_PROTOCOLS = ["http/1.1"] diff --git a/.venv/lib/python3.12/site-packages/urllib3/poolmanager.py b/.venv/lib/python3.12/site-packages/urllib3/poolmanager.py new file mode 100644 index 0000000..085d1db --- /dev/null +++ b/.venv/lib/python3.12/site-packages/urllib3/poolmanager.py @@ -0,0 +1,637 @@ +from __future__ import annotations + +import functools +import logging +import typing +import warnings +from types import TracebackType +from urllib.parse import urljoin + +from ._collections import HTTPHeaderDict, RecentlyUsedContainer +from ._request_methods import RequestMethods +from .connection import ProxyConfig +from .connectionpool import HTTPConnectionPool, HTTPSConnectionPool, port_by_scheme +from .exceptions import ( + LocationValueError, + MaxRetryError, + ProxySchemeUnknown, + URLSchemeUnknown, +) +from .response import BaseHTTPResponse +from .util.connection import _TYPE_SOCKET_OPTIONS +from .util.proxy import connection_requires_http_tunnel +from .util.retry import Retry +from .util.timeout import Timeout +from .util.url import Url, parse_url + +if typing.TYPE_CHECKING: + import ssl + + from typing_extensions import Self + +__all__ = ["PoolManager", "ProxyManager", "proxy_from_url"] + + +log = logging.getLogger(__name__) + +SSL_KEYWORDS = ( + "key_file", + "cert_file", + "cert_reqs", + "ca_certs", + "ca_cert_data", + "ssl_version", + "ssl_minimum_version", + "ssl_maximum_version", + "ca_cert_dir", + "ssl_context", + "key_password", + "server_hostname", +) +# Default value for `blocksize` - a new parameter introduced to +# http.client.HTTPConnection & http.client.HTTPSConnection in Python 3.7 +_DEFAULT_BLOCKSIZE = 16384 + + +class PoolKey(typing.NamedTuple): + """ + All known keyword arguments that could be provided to the pool manager, its + pools, or the underlying connections. + + All custom key schemes should include the fields in this key at a minimum. + """ + + key_scheme: str + key_host: str + key_port: int | None + key_timeout: Timeout | float | int | None + key_retries: Retry | bool | int | None + key_block: bool | None + key_source_address: tuple[str, int] | None + key_key_file: str | None + key_key_password: str | None + key_cert_file: str | None + key_cert_reqs: str | None + key_ca_certs: str | None + key_ca_cert_data: str | bytes | None + key_ssl_version: int | str | None + key_ssl_minimum_version: ssl.TLSVersion | None + key_ssl_maximum_version: ssl.TLSVersion | None + key_ca_cert_dir: str | None + key_ssl_context: ssl.SSLContext | None + key_maxsize: int | None + key_headers: frozenset[tuple[str, str]] | None + key__proxy: Url | None + key__proxy_headers: frozenset[tuple[str, str]] | None + key__proxy_config: ProxyConfig | None + key_socket_options: _TYPE_SOCKET_OPTIONS | None + key__socks_options: frozenset[tuple[str, str]] | None + key_assert_hostname: bool | str | None + key_assert_fingerprint: str | None + key_server_hostname: str | None + key_blocksize: int | None + + +def _default_key_normalizer( + key_class: type[PoolKey], request_context: dict[str, typing.Any] +) -> PoolKey: + """ + Create a pool key out of a request context dictionary. + + According to RFC 3986, both the scheme and host are case-insensitive. + Therefore, this function normalizes both before constructing the pool + key for an HTTPS request. If you wish to change this behaviour, provide + alternate callables to ``key_fn_by_scheme``. + + :param key_class: + The class to use when constructing the key. This should be a namedtuple + with the ``scheme`` and ``host`` keys at a minimum. + :type key_class: namedtuple + :param request_context: + A dictionary-like object that contain the context for a request. + :type request_context: dict + + :return: A namedtuple that can be used as a connection pool key. + :rtype: PoolKey + """ + # Since we mutate the dictionary, make a copy first + context = request_context.copy() + context["scheme"] = context["scheme"].lower() + context["host"] = context["host"].lower() + + # These are both dictionaries and need to be transformed into frozensets + for key in ("headers", "_proxy_headers", "_socks_options"): + if key in context and context[key] is not None: + context[key] = frozenset(context[key].items()) + + # The socket_options key may be a list and needs to be transformed into a + # tuple. + socket_opts = context.get("socket_options") + if socket_opts is not None: + context["socket_options"] = tuple(socket_opts) + + # Map the kwargs to the names in the namedtuple - this is necessary since + # namedtuples can't have fields starting with '_'. + for key in list(context.keys()): + context["key_" + key] = context.pop(key) + + # Default to ``None`` for keys missing from the context + for field in key_class._fields: + if field not in context: + context[field] = None + + # Default key_blocksize to _DEFAULT_BLOCKSIZE if missing from the context + if context.get("key_blocksize") is None: + context["key_blocksize"] = _DEFAULT_BLOCKSIZE + + return key_class(**context) + + +#: A dictionary that maps a scheme to a callable that creates a pool key. +#: This can be used to alter the way pool keys are constructed, if desired. +#: Each PoolManager makes a copy of this dictionary so they can be configured +#: globally here, or individually on the instance. +key_fn_by_scheme = { + "http": functools.partial(_default_key_normalizer, PoolKey), + "https": functools.partial(_default_key_normalizer, PoolKey), +} + +pool_classes_by_scheme = {"http": HTTPConnectionPool, "https": HTTPSConnectionPool} + + +class PoolManager(RequestMethods): + """ + Allows for arbitrary requests while transparently keeping track of + necessary connection pools for you. + + :param num_pools: + Number of connection pools to cache before discarding the least + recently used pool. + + :param headers: + Headers to include with all requests, unless other headers are given + explicitly. + + :param \\**connection_pool_kw: + Additional parameters are used to create fresh + :class:`urllib3.connectionpool.ConnectionPool` instances. + + Example: + + .. code-block:: python + + import urllib3 + + http = urllib3.PoolManager(num_pools=2) + + resp1 = http.request("GET", "https://google.com/") + resp2 = http.request("GET", "https://google.com/mail") + resp3 = http.request("GET", "https://yahoo.com/") + + print(len(http.pools)) + # 2 + + """ + + proxy: Url | None = None + proxy_config: ProxyConfig | None = None + + def __init__( + self, + num_pools: int = 10, + headers: typing.Mapping[str, str] | None = None, + **connection_pool_kw: typing.Any, + ) -> None: + super().__init__(headers) + self.connection_pool_kw = connection_pool_kw + + self.pools: RecentlyUsedContainer[PoolKey, HTTPConnectionPool] + self.pools = RecentlyUsedContainer(num_pools) + + # Locally set the pool classes and keys so other PoolManagers can + # override them. + self.pool_classes_by_scheme = pool_classes_by_scheme + self.key_fn_by_scheme = key_fn_by_scheme.copy() + + def __enter__(self) -> Self: + return self + + def __exit__( + self, + exc_type: type[BaseException] | None, + exc_val: BaseException | None, + exc_tb: TracebackType | None, + ) -> typing.Literal[False]: + self.clear() + # Return False to re-raise any potential exceptions + return False + + def _new_pool( + self, + scheme: str, + host: str, + port: int, + request_context: dict[str, typing.Any] | None = None, + ) -> HTTPConnectionPool: + """ + Create a new :class:`urllib3.connectionpool.ConnectionPool` based on host, port, scheme, and + any additional pool keyword arguments. + + If ``request_context`` is provided, it is provided as keyword arguments + to the pool class used. This method is used to actually create the + connection pools handed out by :meth:`connection_from_url` and + companion methods. It is intended to be overridden for customization. + """ + pool_cls: type[HTTPConnectionPool] = self.pool_classes_by_scheme[scheme] + if request_context is None: + request_context = self.connection_pool_kw.copy() + + # Default blocksize to _DEFAULT_BLOCKSIZE if missing or explicitly + # set to 'None' in the request_context. + if request_context.get("blocksize") is None: + request_context["blocksize"] = _DEFAULT_BLOCKSIZE + + # Although the context has everything necessary to create the pool, + # this function has historically only used the scheme, host, and port + # in the positional args. When an API change is acceptable these can + # be removed. + for key in ("scheme", "host", "port"): + request_context.pop(key, None) + + if scheme == "http": + for kw in SSL_KEYWORDS: + request_context.pop(kw, None) + + return pool_cls(host, port, **request_context) + + def clear(self) -> None: + """ + Empty our store of pools and direct them all to close. + + This will not affect in-flight connections, but they will not be + re-used after completion. + """ + self.pools.clear() + + def connection_from_host( + self, + host: str | None, + port: int | None = None, + scheme: str | None = "http", + pool_kwargs: dict[str, typing.Any] | None = None, + ) -> HTTPConnectionPool: + """ + Get a :class:`urllib3.connectionpool.ConnectionPool` based on the host, port, and scheme. + + If ``port`` isn't given, it will be derived from the ``scheme`` using + ``urllib3.connectionpool.port_by_scheme``. If ``pool_kwargs`` is + provided, it is merged with the instance's ``connection_pool_kw`` + variable and used to create the new connection pool, if one is + needed. + """ + + if not host: + raise LocationValueError("No host specified.") + + request_context = self._merge_pool_kwargs(pool_kwargs) + request_context["scheme"] = scheme or "http" + if not port: + port = port_by_scheme.get(request_context["scheme"].lower(), 80) + request_context["port"] = port + request_context["host"] = host + + return self.connection_from_context(request_context) + + def connection_from_context( + self, request_context: dict[str, typing.Any] + ) -> HTTPConnectionPool: + """ + Get a :class:`urllib3.connectionpool.ConnectionPool` based on the request context. + + ``request_context`` must at least contain the ``scheme`` key and its + value must be a key in ``key_fn_by_scheme`` instance variable. + """ + if "strict" in request_context: + warnings.warn( + "The 'strict' parameter is no longer needed on Python 3+. " + "This will raise an error in urllib3 v2.1.0.", + DeprecationWarning, + ) + request_context.pop("strict") + + scheme = request_context["scheme"].lower() + pool_key_constructor = self.key_fn_by_scheme.get(scheme) + if not pool_key_constructor: + raise URLSchemeUnknown(scheme) + pool_key = pool_key_constructor(request_context) + + return self.connection_from_pool_key(pool_key, request_context=request_context) + + def connection_from_pool_key( + self, pool_key: PoolKey, request_context: dict[str, typing.Any] + ) -> HTTPConnectionPool: + """ + Get a :class:`urllib3.connectionpool.ConnectionPool` based on the provided pool key. + + ``pool_key`` should be a namedtuple that only contains immutable + objects. At a minimum it must have the ``scheme``, ``host``, and + ``port`` fields. + """ + with self.pools.lock: + # If the scheme, host, or port doesn't match existing open + # connections, open a new ConnectionPool. + pool = self.pools.get(pool_key) + if pool: + return pool + + # Make a fresh ConnectionPool of the desired type + scheme = request_context["scheme"] + host = request_context["host"] + port = request_context["port"] + pool = self._new_pool(scheme, host, port, request_context=request_context) + self.pools[pool_key] = pool + + return pool + + def connection_from_url( + self, url: str, pool_kwargs: dict[str, typing.Any] | None = None + ) -> HTTPConnectionPool: + """ + Similar to :func:`urllib3.connectionpool.connection_from_url`. + + If ``pool_kwargs`` is not provided and a new pool needs to be + constructed, ``self.connection_pool_kw`` is used to initialize + the :class:`urllib3.connectionpool.ConnectionPool`. If ``pool_kwargs`` + is provided, it is used instead. Note that if a new pool does not + need to be created for the request, the provided ``pool_kwargs`` are + not used. + """ + u = parse_url(url) + return self.connection_from_host( + u.host, port=u.port, scheme=u.scheme, pool_kwargs=pool_kwargs + ) + + def _merge_pool_kwargs( + self, override: dict[str, typing.Any] | None + ) -> dict[str, typing.Any]: + """ + Merge a dictionary of override values for self.connection_pool_kw. + + This does not modify self.connection_pool_kw and returns a new dict. + Any keys in the override dictionary with a value of ``None`` are + removed from the merged dictionary. + """ + base_pool_kwargs = self.connection_pool_kw.copy() + if override: + for key, value in override.items(): + if value is None: + try: + del base_pool_kwargs[key] + except KeyError: + pass + else: + base_pool_kwargs[key] = value + return base_pool_kwargs + + def _proxy_requires_url_absolute_form(self, parsed_url: Url) -> bool: + """ + Indicates if the proxy requires the complete destination URL in the + request. Normally this is only needed when not using an HTTP CONNECT + tunnel. + """ + if self.proxy is None: + return False + + return not connection_requires_http_tunnel( + self.proxy, self.proxy_config, parsed_url.scheme + ) + + def urlopen( # type: ignore[override] + self, method: str, url: str, redirect: bool = True, **kw: typing.Any + ) -> BaseHTTPResponse: + """ + Same as :meth:`urllib3.HTTPConnectionPool.urlopen` + with custom cross-host redirect logic and only sends the request-uri + portion of the ``url``. + + The given ``url`` parameter must be absolute, such that an appropriate + :class:`urllib3.connectionpool.ConnectionPool` can be chosen for it. + """ + u = parse_url(url) + + if u.scheme is None: + warnings.warn( + "URLs without a scheme (ie 'https://') are deprecated and will raise an error " + "in a future version of urllib3. To avoid this DeprecationWarning ensure all URLs " + "start with 'https://' or 'http://'. Read more in this issue: " + "https://github.com/urllib3/urllib3/issues/2920", + category=DeprecationWarning, + stacklevel=2, + ) + + conn = self.connection_from_host(u.host, port=u.port, scheme=u.scheme) + + kw["assert_same_host"] = False + kw["redirect"] = False + + if "headers" not in kw: + kw["headers"] = self.headers + + if self._proxy_requires_url_absolute_form(u): + response = conn.urlopen(method, url, **kw) + else: + response = conn.urlopen(method, u.request_uri, **kw) + + redirect_location = redirect and response.get_redirect_location() + if not redirect_location: + return response + + # Support relative URLs for redirecting. + redirect_location = urljoin(url, redirect_location) + + if response.status == 303: + # Change the method according to RFC 9110, Section 15.4.4. + method = "GET" + # And lose the body not to transfer anything sensitive. + kw["body"] = None + kw["headers"] = HTTPHeaderDict(kw["headers"])._prepare_for_method_change() + + retries = kw.get("retries") + if not isinstance(retries, Retry): + retries = Retry.from_int(retries, redirect=redirect) + + # Strip headers marked as unsafe to forward to the redirected location. + # Check remove_headers_on_redirect to avoid a potential network call within + # conn.is_same_host() which may use socket.gethostbyname() in the future. + if retries.remove_headers_on_redirect and not conn.is_same_host( + redirect_location + ): + new_headers = kw["headers"].copy() + for header in kw["headers"]: + if header.lower() in retries.remove_headers_on_redirect: + new_headers.pop(header, None) + kw["headers"] = new_headers + + try: + retries = retries.increment(method, url, response=response, _pool=conn) + except MaxRetryError: + if retries.raise_on_redirect: + response.drain_conn() + raise + return response + + kw["retries"] = retries + kw["redirect"] = redirect + + log.info("Redirecting %s -> %s", url, redirect_location) + + response.drain_conn() + return self.urlopen(method, redirect_location, **kw) + + +class ProxyManager(PoolManager): + """ + Behaves just like :class:`PoolManager`, but sends all requests through + the defined proxy, using the CONNECT method for HTTPS URLs. + + :param proxy_url: + The URL of the proxy to be used. + + :param proxy_headers: + A dictionary containing headers that will be sent to the proxy. In case + of HTTP they are being sent with each request, while in the + HTTPS/CONNECT case they are sent only once. Could be used for proxy + authentication. + + :param proxy_ssl_context: + The proxy SSL context is used to establish the TLS connection to the + proxy when using HTTPS proxies. + + :param use_forwarding_for_https: + (Defaults to False) If set to True will forward requests to the HTTPS + proxy to be made on behalf of the client instead of creating a TLS + tunnel via the CONNECT method. **Enabling this flag means that request + and response headers and content will be visible from the HTTPS proxy** + whereas tunneling keeps request and response headers and content + private. IP address, target hostname, SNI, and port are always visible + to an HTTPS proxy even when this flag is disabled. + + :param proxy_assert_hostname: + The hostname of the certificate to verify against. + + :param proxy_assert_fingerprint: + The fingerprint of the certificate to verify against. + + Example: + + .. code-block:: python + + import urllib3 + + proxy = urllib3.ProxyManager("https://localhost:3128/") + + resp1 = proxy.request("GET", "https://google.com/") + resp2 = proxy.request("GET", "https://httpbin.org/") + + print(len(proxy.pools)) + # 1 + + resp3 = proxy.request("GET", "https://httpbin.org/") + resp4 = proxy.request("GET", "https://twitter.com/") + + print(len(proxy.pools)) + # 3 + + """ + + def __init__( + self, + proxy_url: str, + num_pools: int = 10, + headers: typing.Mapping[str, str] | None = None, + proxy_headers: typing.Mapping[str, str] | None = None, + proxy_ssl_context: ssl.SSLContext | None = None, + use_forwarding_for_https: bool = False, + proxy_assert_hostname: None | str | typing.Literal[False] = None, + proxy_assert_fingerprint: str | None = None, + **connection_pool_kw: typing.Any, + ) -> None: + if isinstance(proxy_url, HTTPConnectionPool): + str_proxy_url = f"{proxy_url.scheme}://{proxy_url.host}:{proxy_url.port}" + else: + str_proxy_url = proxy_url + proxy = parse_url(str_proxy_url) + + if proxy.scheme not in ("http", "https"): + raise ProxySchemeUnknown(proxy.scheme) + + if not proxy.port: + port = port_by_scheme.get(proxy.scheme, 80) + proxy = proxy._replace(port=port) + + self.proxy = proxy + self.proxy_headers = proxy_headers or {} + self.proxy_ssl_context = proxy_ssl_context + self.proxy_config = ProxyConfig( + proxy_ssl_context, + use_forwarding_for_https, + proxy_assert_hostname, + proxy_assert_fingerprint, + ) + + connection_pool_kw["_proxy"] = self.proxy + connection_pool_kw["_proxy_headers"] = self.proxy_headers + connection_pool_kw["_proxy_config"] = self.proxy_config + + super().__init__(num_pools, headers, **connection_pool_kw) + + def connection_from_host( + self, + host: str | None, + port: int | None = None, + scheme: str | None = "http", + pool_kwargs: dict[str, typing.Any] | None = None, + ) -> HTTPConnectionPool: + if scheme == "https": + return super().connection_from_host( + host, port, scheme, pool_kwargs=pool_kwargs + ) + + return super().connection_from_host( + self.proxy.host, self.proxy.port, self.proxy.scheme, pool_kwargs=pool_kwargs # type: ignore[union-attr] + ) + + def _set_proxy_headers( + self, url: str, headers: typing.Mapping[str, str] | None = None + ) -> typing.Mapping[str, str]: + """ + Sets headers needed by proxies: specifically, the Accept and Host + headers. Only sets headers not provided by the user. + """ + headers_ = {"Accept": "*/*"} + + netloc = parse_url(url).netloc + if netloc: + headers_["Host"] = netloc + + if headers: + headers_.update(headers) + return headers_ + + def urlopen( # type: ignore[override] + self, method: str, url: str, redirect: bool = True, **kw: typing.Any + ) -> BaseHTTPResponse: + "Same as HTTP(S)ConnectionPool.urlopen, ``url`` must be absolute." + u = parse_url(url) + if not connection_requires_http_tunnel(self.proxy, self.proxy_config, u.scheme): + # For connections using HTTP CONNECT, httplib sets the necessary + # headers on the CONNECT to the proxy. If we're not using CONNECT, + # we'll definitely need to set 'Host' at the very least. + headers = kw.get("headers", self.headers) + kw["headers"] = self._set_proxy_headers(url, headers) + + return super().urlopen(method, url, redirect=redirect, **kw) + + +def proxy_from_url(url: str, **kw: typing.Any) -> ProxyManager: + return ProxyManager(proxy_url=url, **kw) diff --git a/.venv/lib/python3.12/site-packages/urllib3/py.typed b/.venv/lib/python3.12/site-packages/urllib3/py.typed new file mode 100644 index 0000000..5f3ea3d --- /dev/null +++ b/.venv/lib/python3.12/site-packages/urllib3/py.typed @@ -0,0 +1,2 @@ +# Instruct type checkers to look for inline type annotations in this package. +# See PEP 561. diff --git a/.venv/lib/python3.12/site-packages/urllib3/response.py b/.venv/lib/python3.12/site-packages/urllib3/response.py new file mode 100644 index 0000000..a0273d6 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/urllib3/response.py @@ -0,0 +1,1265 @@ +from __future__ import annotations + +import collections +import io +import json as _json +import logging +import re +import sys +import typing +import warnings +import zlib +from contextlib import contextmanager +from http.client import HTTPMessage as _HttplibHTTPMessage +from http.client import HTTPResponse as _HttplibHTTPResponse +from socket import timeout as SocketTimeout + +if typing.TYPE_CHECKING: + from ._base_connection import BaseHTTPConnection + +try: + try: + import brotlicffi as brotli # type: ignore[import-not-found] + except ImportError: + import brotli # type: ignore[import-not-found] +except ImportError: + brotli = None + +try: + import zstandard as zstd +except (AttributeError, ImportError, ValueError): # Defensive: + HAS_ZSTD = False +else: + # The package 'zstandard' added the 'eof' property starting + # in v0.18.0 which we require to ensure a complete and + # valid zstd stream was fed into the ZstdDecoder. + # See: https://github.com/urllib3/urllib3/pull/2624 + _zstd_version = tuple( + map(int, re.search(r"^([0-9]+)\.([0-9]+)", zstd.__version__).groups()) # type: ignore[union-attr] + ) + if _zstd_version < (0, 18): # Defensive: + HAS_ZSTD = False + else: + HAS_ZSTD = True + +from . import util +from ._base_connection import _TYPE_BODY +from ._collections import HTTPHeaderDict +from .connection import BaseSSLError, HTTPConnection, HTTPException +from .exceptions import ( + BodyNotHttplibCompatible, + DecodeError, + HTTPError, + IncompleteRead, + InvalidChunkLength, + InvalidHeader, + ProtocolError, + ReadTimeoutError, + ResponseNotChunked, + SSLError, +) +from .util.response import is_fp_closed, is_response_to_head +from .util.retry import Retry + +if typing.TYPE_CHECKING: + from .connectionpool import HTTPConnectionPool + +log = logging.getLogger(__name__) + + +class ContentDecoder: + def decompress(self, data: bytes) -> bytes: + raise NotImplementedError() + + def flush(self) -> bytes: + raise NotImplementedError() + + +class DeflateDecoder(ContentDecoder): + def __init__(self) -> None: + self._first_try = True + self._data = b"" + self._obj = zlib.decompressobj() + + def decompress(self, data: bytes) -> bytes: + if not data: + return data + + if not self._first_try: + return self._obj.decompress(data) + + self._data += data + try: + decompressed = self._obj.decompress(data) + if decompressed: + self._first_try = False + self._data = None # type: ignore[assignment] + return decompressed + except zlib.error: + self._first_try = False + self._obj = zlib.decompressobj(-zlib.MAX_WBITS) + try: + return self.decompress(self._data) + finally: + self._data = None # type: ignore[assignment] + + def flush(self) -> bytes: + return self._obj.flush() + + +class GzipDecoderState: + FIRST_MEMBER = 0 + OTHER_MEMBERS = 1 + SWALLOW_DATA = 2 + + +class GzipDecoder(ContentDecoder): + def __init__(self) -> None: + self._obj = zlib.decompressobj(16 + zlib.MAX_WBITS) + self._state = GzipDecoderState.FIRST_MEMBER + + def decompress(self, data: bytes) -> bytes: + ret = bytearray() + if self._state == GzipDecoderState.SWALLOW_DATA or not data: + return bytes(ret) + while True: + try: + ret += self._obj.decompress(data) + except zlib.error: + previous_state = self._state + # Ignore data after the first error + self._state = GzipDecoderState.SWALLOW_DATA + if previous_state == GzipDecoderState.OTHER_MEMBERS: + # Allow trailing garbage acceptable in other gzip clients + return bytes(ret) + raise + data = self._obj.unused_data + if not data: + return bytes(ret) + self._state = GzipDecoderState.OTHER_MEMBERS + self._obj = zlib.decompressobj(16 + zlib.MAX_WBITS) + + def flush(self) -> bytes: + return self._obj.flush() + + +if brotli is not None: + + class BrotliDecoder(ContentDecoder): + # Supports both 'brotlipy' and 'Brotli' packages + # since they share an import name. The top branches + # are for 'brotlipy' and bottom branches for 'Brotli' + def __init__(self) -> None: + self._obj = brotli.Decompressor() + if hasattr(self._obj, "decompress"): + setattr(self, "decompress", self._obj.decompress) + else: + setattr(self, "decompress", self._obj.process) + + def flush(self) -> bytes: + if hasattr(self._obj, "flush"): + return self._obj.flush() # type: ignore[no-any-return] + return b"" + + +if HAS_ZSTD: + + class ZstdDecoder(ContentDecoder): + def __init__(self) -> None: + self._obj = zstd.ZstdDecompressor().decompressobj() + + def decompress(self, data: bytes) -> bytes: + if not data: + return b"" + data_parts = [self._obj.decompress(data)] + while self._obj.eof and self._obj.unused_data: + unused_data = self._obj.unused_data + self._obj = zstd.ZstdDecompressor().decompressobj() + data_parts.append(self._obj.decompress(unused_data)) + return b"".join(data_parts) + + def flush(self) -> bytes: + ret = self._obj.flush() # note: this is a no-op + if not self._obj.eof: + raise DecodeError("Zstandard data is incomplete") + return ret + + +class MultiDecoder(ContentDecoder): + """ + From RFC7231: + If one or more encodings have been applied to a representation, the + sender that applied the encodings MUST generate a Content-Encoding + header field that lists the content codings in the order in which + they were applied. + """ + + def __init__(self, modes: str) -> None: + self._decoders = [_get_decoder(m.strip()) for m in modes.split(",")] + + def flush(self) -> bytes: + return self._decoders[0].flush() + + def decompress(self, data: bytes) -> bytes: + for d in reversed(self._decoders): + data = d.decompress(data) + return data + + +def _get_decoder(mode: str) -> ContentDecoder: + if "," in mode: + return MultiDecoder(mode) + + # According to RFC 9110 section 8.4.1.3, recipients should + # consider x-gzip equivalent to gzip + if mode in ("gzip", "x-gzip"): + return GzipDecoder() + + if brotli is not None and mode == "br": + return BrotliDecoder() + + if HAS_ZSTD and mode == "zstd": + return ZstdDecoder() + + return DeflateDecoder() + + +class BytesQueueBuffer: + """Memory-efficient bytes buffer + + To return decoded data in read() and still follow the BufferedIOBase API, we need a + buffer to always return the correct amount of bytes. + + This buffer should be filled using calls to put() + + Our maximum memory usage is determined by the sum of the size of: + + * self.buffer, which contains the full data + * the largest chunk that we will copy in get() + + The worst case scenario is a single chunk, in which case we'll make a full copy of + the data inside get(). + """ + + def __init__(self) -> None: + self.buffer: typing.Deque[bytes] = collections.deque() + self._size: int = 0 + + def __len__(self) -> int: + return self._size + + def put(self, data: bytes) -> None: + self.buffer.append(data) + self._size += len(data) + + def get(self, n: int) -> bytes: + if n == 0: + return b"" + elif not self.buffer: + raise RuntimeError("buffer is empty") + elif n < 0: + raise ValueError("n should be > 0") + + fetched = 0 + ret = io.BytesIO() + while fetched < n: + remaining = n - fetched + chunk = self.buffer.popleft() + chunk_length = len(chunk) + if remaining < chunk_length: + left_chunk, right_chunk = chunk[:remaining], chunk[remaining:] + ret.write(left_chunk) + self.buffer.appendleft(right_chunk) + self._size -= remaining + break + else: + ret.write(chunk) + self._size -= chunk_length + fetched += chunk_length + + if not self.buffer: + break + + return ret.getvalue() + + def get_all(self) -> bytes: + buffer = self.buffer + if not buffer: + assert self._size == 0 + return b"" + if len(buffer) == 1: + result = buffer.pop() + else: + ret = io.BytesIO() + ret.writelines(buffer.popleft() for _ in range(len(buffer))) + result = ret.getvalue() + self._size = 0 + return result + + +class BaseHTTPResponse(io.IOBase): + CONTENT_DECODERS = ["gzip", "x-gzip", "deflate"] + if brotli is not None: + CONTENT_DECODERS += ["br"] + if HAS_ZSTD: + CONTENT_DECODERS += ["zstd"] + REDIRECT_STATUSES = [301, 302, 303, 307, 308] + + DECODER_ERROR_CLASSES: tuple[type[Exception], ...] = (IOError, zlib.error) + if brotli is not None: + DECODER_ERROR_CLASSES += (brotli.error,) + + if HAS_ZSTD: + DECODER_ERROR_CLASSES += (zstd.ZstdError,) + + def __init__( + self, + *, + headers: typing.Mapping[str, str] | typing.Mapping[bytes, bytes] | None = None, + status: int, + version: int, + version_string: str, + reason: str | None, + decode_content: bool, + request_url: str | None, + retries: Retry | None = None, + ) -> None: + if isinstance(headers, HTTPHeaderDict): + self.headers = headers + else: + self.headers = HTTPHeaderDict(headers) # type: ignore[arg-type] + self.status = status + self.version = version + self.version_string = version_string + self.reason = reason + self.decode_content = decode_content + self._has_decoded_content = False + self._request_url: str | None = request_url + self.retries = retries + + self.chunked = False + tr_enc = self.headers.get("transfer-encoding", "").lower() + # Don't incur the penalty of creating a list and then discarding it + encodings = (enc.strip() for enc in tr_enc.split(",")) + if "chunked" in encodings: + self.chunked = True + + self._decoder: ContentDecoder | None = None + self.length_remaining: int | None + + def get_redirect_location(self) -> str | None | typing.Literal[False]: + """ + Should we redirect and where to? + + :returns: Truthy redirect location string if we got a redirect status + code and valid location. ``None`` if redirect status and no + location. ``False`` if not a redirect status code. + """ + if self.status in self.REDIRECT_STATUSES: + return self.headers.get("location") + return False + + @property + def data(self) -> bytes: + raise NotImplementedError() + + def json(self) -> typing.Any: + """ + Deserializes the body of the HTTP response as a Python object. + + The body of the HTTP response must be encoded using UTF-8, as per + `RFC 8529 Section 8.1 `_. + + To use a custom JSON decoder pass the result of :attr:`HTTPResponse.data` to + your custom decoder instead. + + If the body of the HTTP response is not decodable to UTF-8, a + `UnicodeDecodeError` will be raised. If the body of the HTTP response is not a + valid JSON document, a `json.JSONDecodeError` will be raised. + + Read more :ref:`here `. + + :returns: The body of the HTTP response as a Python object. + """ + data = self.data.decode("utf-8") + return _json.loads(data) + + @property + def url(self) -> str | None: + raise NotImplementedError() + + @url.setter + def url(self, url: str | None) -> None: + raise NotImplementedError() + + @property + def connection(self) -> BaseHTTPConnection | None: + raise NotImplementedError() + + @property + def retries(self) -> Retry | None: + return self._retries + + @retries.setter + def retries(self, retries: Retry | None) -> None: + # Override the request_url if retries has a redirect location. + if retries is not None and retries.history: + self.url = retries.history[-1].redirect_location + self._retries = retries + + def stream( + self, amt: int | None = 2**16, decode_content: bool | None = None + ) -> typing.Iterator[bytes]: + raise NotImplementedError() + + def read( + self, + amt: int | None = None, + decode_content: bool | None = None, + cache_content: bool = False, + ) -> bytes: + raise NotImplementedError() + + def read1( + self, + amt: int | None = None, + decode_content: bool | None = None, + ) -> bytes: + raise NotImplementedError() + + def read_chunked( + self, + amt: int | None = None, + decode_content: bool | None = None, + ) -> typing.Iterator[bytes]: + raise NotImplementedError() + + def release_conn(self) -> None: + raise NotImplementedError() + + def drain_conn(self) -> None: + raise NotImplementedError() + + def close(self) -> None: + raise NotImplementedError() + + def _init_decoder(self) -> None: + """ + Set-up the _decoder attribute if necessary. + """ + # Note: content-encoding value should be case-insensitive, per RFC 7230 + # Section 3.2 + content_encoding = self.headers.get("content-encoding", "").lower() + if self._decoder is None: + if content_encoding in self.CONTENT_DECODERS: + self._decoder = _get_decoder(content_encoding) + elif "," in content_encoding: + encodings = [ + e.strip() + for e in content_encoding.split(",") + if e.strip() in self.CONTENT_DECODERS + ] + if encodings: + self._decoder = _get_decoder(content_encoding) + + def _decode( + self, data: bytes, decode_content: bool | None, flush_decoder: bool + ) -> bytes: + """ + Decode the data passed in and potentially flush the decoder. + """ + if not decode_content: + if self._has_decoded_content: + raise RuntimeError( + "Calling read(decode_content=False) is not supported after " + "read(decode_content=True) was called." + ) + return data + + try: + if self._decoder: + data = self._decoder.decompress(data) + self._has_decoded_content = True + except self.DECODER_ERROR_CLASSES as e: + content_encoding = self.headers.get("content-encoding", "").lower() + raise DecodeError( + "Received response with content-encoding: %s, but " + "failed to decode it." % content_encoding, + e, + ) from e + if flush_decoder: + data += self._flush_decoder() + + return data + + def _flush_decoder(self) -> bytes: + """ + Flushes the decoder. Should only be called if the decoder is actually + being used. + """ + if self._decoder: + return self._decoder.decompress(b"") + self._decoder.flush() + return b"" + + # Compatibility methods for `io` module + def readinto(self, b: bytearray) -> int: + temp = self.read(len(b)) + if len(temp) == 0: + return 0 + else: + b[: len(temp)] = temp + return len(temp) + + # Compatibility methods for http.client.HTTPResponse + def getheaders(self) -> HTTPHeaderDict: + warnings.warn( + "HTTPResponse.getheaders() is deprecated and will be removed " + "in urllib3 v2.1.0. Instead access HTTPResponse.headers directly.", + category=DeprecationWarning, + stacklevel=2, + ) + return self.headers + + def getheader(self, name: str, default: str | None = None) -> str | None: + warnings.warn( + "HTTPResponse.getheader() is deprecated and will be removed " + "in urllib3 v2.1.0. Instead use HTTPResponse.headers.get(name, default).", + category=DeprecationWarning, + stacklevel=2, + ) + return self.headers.get(name, default) + + # Compatibility method for http.cookiejar + def info(self) -> HTTPHeaderDict: + return self.headers + + def geturl(self) -> str | None: + return self.url + + +class HTTPResponse(BaseHTTPResponse): + """ + HTTP Response container. + + Backwards-compatible with :class:`http.client.HTTPResponse` but the response ``body`` is + loaded and decoded on-demand when the ``data`` property is accessed. This + class is also compatible with the Python standard library's :mod:`io` + module, and can hence be treated as a readable object in the context of that + framework. + + Extra parameters for behaviour not present in :class:`http.client.HTTPResponse`: + + :param preload_content: + If True, the response's body will be preloaded during construction. + + :param decode_content: + If True, will attempt to decode the body based on the + 'content-encoding' header. + + :param original_response: + When this HTTPResponse wrapper is generated from an :class:`http.client.HTTPResponse` + object, it's convenient to include the original for debug purposes. It's + otherwise unused. + + :param retries: + The retries contains the last :class:`~urllib3.util.retry.Retry` that + was used during the request. + + :param enforce_content_length: + Enforce content length checking. Body returned by server must match + value of Content-Length header, if present. Otherwise, raise error. + """ + + def __init__( + self, + body: _TYPE_BODY = "", + headers: typing.Mapping[str, str] | typing.Mapping[bytes, bytes] | None = None, + status: int = 0, + version: int = 0, + version_string: str = "HTTP/?", + reason: str | None = None, + preload_content: bool = True, + decode_content: bool = True, + original_response: _HttplibHTTPResponse | None = None, + pool: HTTPConnectionPool | None = None, + connection: HTTPConnection | None = None, + msg: _HttplibHTTPMessage | None = None, + retries: Retry | None = None, + enforce_content_length: bool = True, + request_method: str | None = None, + request_url: str | None = None, + auto_close: bool = True, + ) -> None: + super().__init__( + headers=headers, + status=status, + version=version, + version_string=version_string, + reason=reason, + decode_content=decode_content, + request_url=request_url, + retries=retries, + ) + + self.enforce_content_length = enforce_content_length + self.auto_close = auto_close + + self._body = None + self._fp: _HttplibHTTPResponse | None = None + self._original_response = original_response + self._fp_bytes_read = 0 + self.msg = msg + + if body and isinstance(body, (str, bytes)): + self._body = body + + self._pool = pool + self._connection = connection + + if hasattr(body, "read"): + self._fp = body # type: ignore[assignment] + + # Are we using the chunked-style of transfer encoding? + self.chunk_left: int | None = None + + # Determine length of response + self.length_remaining = self._init_length(request_method) + + # Used to return the correct amount of bytes for partial read()s + self._decoded_buffer = BytesQueueBuffer() + + # If requested, preload the body. + if preload_content and not self._body: + self._body = self.read(decode_content=decode_content) + + def release_conn(self) -> None: + if not self._pool or not self._connection: + return None + + self._pool._put_conn(self._connection) + self._connection = None + + def drain_conn(self) -> None: + """ + Read and discard any remaining HTTP response data in the response connection. + + Unread data in the HTTPResponse connection blocks the connection from being released back to the pool. + """ + try: + self.read() + except (HTTPError, OSError, BaseSSLError, HTTPException): + pass + + @property + def data(self) -> bytes: + # For backwards-compat with earlier urllib3 0.4 and earlier. + if self._body: + return self._body # type: ignore[return-value] + + if self._fp: + return self.read(cache_content=True) + + return None # type: ignore[return-value] + + @property + def connection(self) -> HTTPConnection | None: + return self._connection + + def isclosed(self) -> bool: + return is_fp_closed(self._fp) + + def tell(self) -> int: + """ + Obtain the number of bytes pulled over the wire so far. May differ from + the amount of content returned by :meth:``urllib3.response.HTTPResponse.read`` + if bytes are encoded on the wire (e.g, compressed). + """ + return self._fp_bytes_read + + def _init_length(self, request_method: str | None) -> int | None: + """ + Set initial length value for Response content if available. + """ + length: int | None + content_length: str | None = self.headers.get("content-length") + + if content_length is not None: + if self.chunked: + # This Response will fail with an IncompleteRead if it can't be + # received as chunked. This method falls back to attempt reading + # the response before raising an exception. + log.warning( + "Received response with both Content-Length and " + "Transfer-Encoding set. This is expressly forbidden " + "by RFC 7230 sec 3.3.2. Ignoring Content-Length and " + "attempting to process response as Transfer-Encoding: " + "chunked." + ) + return None + + try: + # RFC 7230 section 3.3.2 specifies multiple content lengths can + # be sent in a single Content-Length header + # (e.g. Content-Length: 42, 42). This line ensures the values + # are all valid ints and that as long as the `set` length is 1, + # all values are the same. Otherwise, the header is invalid. + lengths = {int(val) for val in content_length.split(",")} + if len(lengths) > 1: + raise InvalidHeader( + "Content-Length contained multiple " + "unmatching values (%s)" % content_length + ) + length = lengths.pop() + except ValueError: + length = None + else: + if length < 0: + length = None + + else: # if content_length is None + length = None + + # Convert status to int for comparison + # In some cases, httplib returns a status of "_UNKNOWN" + try: + status = int(self.status) + except ValueError: + status = 0 + + # Check for responses that shouldn't include a body + if status in (204, 304) or 100 <= status < 200 or request_method == "HEAD": + length = 0 + + return length + + @contextmanager + def _error_catcher(self) -> typing.Generator[None, None, None]: + """ + Catch low-level python exceptions, instead re-raising urllib3 + variants, so that low-level exceptions are not leaked in the + high-level api. + + On exit, release the connection back to the pool. + """ + clean_exit = False + + try: + try: + yield + + except SocketTimeout as e: + # FIXME: Ideally we'd like to include the url in the ReadTimeoutError but + # there is yet no clean way to get at it from this context. + raise ReadTimeoutError(self._pool, None, "Read timed out.") from e # type: ignore[arg-type] + + except BaseSSLError as e: + # FIXME: Is there a better way to differentiate between SSLErrors? + if "read operation timed out" not in str(e): + # SSL errors related to framing/MAC get wrapped and reraised here + raise SSLError(e) from e + + raise ReadTimeoutError(self._pool, None, "Read timed out.") from e # type: ignore[arg-type] + + except IncompleteRead as e: + if ( + e.expected is not None + and e.partial is not None + and e.expected == -e.partial + ): + arg = "Response may not contain content." + else: + arg = f"Connection broken: {e!r}" + raise ProtocolError(arg, e) from e + + except (HTTPException, OSError) as e: + raise ProtocolError(f"Connection broken: {e!r}", e) from e + + # If no exception is thrown, we should avoid cleaning up + # unnecessarily. + clean_exit = True + finally: + # If we didn't terminate cleanly, we need to throw away our + # connection. + if not clean_exit: + # The response may not be closed but we're not going to use it + # anymore so close it now to ensure that the connection is + # released back to the pool. + if self._original_response: + self._original_response.close() + + # Closing the response may not actually be sufficient to close + # everything, so if we have a hold of the connection close that + # too. + if self._connection: + self._connection.close() + + # If we hold the original response but it's closed now, we should + # return the connection back to the pool. + if self._original_response and self._original_response.isclosed(): + self.release_conn() + + def _fp_read( + self, + amt: int | None = None, + *, + read1: bool = False, + ) -> bytes: + """ + Read a response with the thought that reading the number of bytes + larger than can fit in a 32-bit int at a time via SSL in some + known cases leads to an overflow error that has to be prevented + if `amt` or `self.length_remaining` indicate that a problem may + happen. + + The known cases: + * 3.8 <= CPython < 3.9.7 because of a bug + https://github.com/urllib3/urllib3/issues/2513#issuecomment-1152559900. + * urllib3 injected with pyOpenSSL-backed SSL-support. + * CPython < 3.10 only when `amt` does not fit 32-bit int. + """ + assert self._fp + c_int_max = 2**31 - 1 + if ( + (amt and amt > c_int_max) + or ( + amt is None + and self.length_remaining + and self.length_remaining > c_int_max + ) + ) and (util.IS_PYOPENSSL or sys.version_info < (3, 10)): + if read1: + return self._fp.read1(c_int_max) + buffer = io.BytesIO() + # Besides `max_chunk_amt` being a maximum chunk size, it + # affects memory overhead of reading a response by this + # method in CPython. + # `c_int_max` equal to 2 GiB - 1 byte is the actual maximum + # chunk size that does not lead to an overflow error, but + # 256 MiB is a compromise. + max_chunk_amt = 2**28 + while amt is None or amt != 0: + if amt is not None: + chunk_amt = min(amt, max_chunk_amt) + amt -= chunk_amt + else: + chunk_amt = max_chunk_amt + data = self._fp.read(chunk_amt) + if not data: + break + buffer.write(data) + del data # to reduce peak memory usage by `max_chunk_amt`. + return buffer.getvalue() + elif read1: + return self._fp.read1(amt) if amt is not None else self._fp.read1() + else: + # StringIO doesn't like amt=None + return self._fp.read(amt) if amt is not None else self._fp.read() + + def _raw_read( + self, + amt: int | None = None, + *, + read1: bool = False, + ) -> bytes: + """ + Reads `amt` of bytes from the socket. + """ + if self._fp is None: + return None # type: ignore[return-value] + + fp_closed = getattr(self._fp, "closed", False) + + with self._error_catcher(): + data = self._fp_read(amt, read1=read1) if not fp_closed else b"" + if amt is not None and amt != 0 and not data: + # Platform-specific: Buggy versions of Python. + # Close the connection when no data is returned + # + # This is redundant to what httplib/http.client _should_ + # already do. However, versions of python released before + # December 15, 2012 (http://bugs.python.org/issue16298) do + # not properly close the connection in all cases. There is + # no harm in redundantly calling close. + self._fp.close() + if ( + self.enforce_content_length + and self.length_remaining is not None + and self.length_remaining != 0 + ): + # This is an edge case that httplib failed to cover due + # to concerns of backward compatibility. We're + # addressing it here to make sure IncompleteRead is + # raised during streaming, so all calls with incorrect + # Content-Length are caught. + raise IncompleteRead(self._fp_bytes_read, self.length_remaining) + elif read1 and ( + (amt != 0 and not data) or self.length_remaining == len(data) + ): + # All data has been read, but `self._fp.read1` in + # CPython 3.12 and older doesn't always close + # `http.client.HTTPResponse`, so we close it here. + # See https://github.com/python/cpython/issues/113199 + self._fp.close() + + if data: + self._fp_bytes_read += len(data) + if self.length_remaining is not None: + self.length_remaining -= len(data) + return data + + def read( + self, + amt: int | None = None, + decode_content: bool | None = None, + cache_content: bool = False, + ) -> bytes: + """ + Similar to :meth:`http.client.HTTPResponse.read`, but with two additional + parameters: ``decode_content`` and ``cache_content``. + + :param amt: + How much of the content to read. If specified, caching is skipped + because it doesn't make sense to cache partial content as the full + response. + + :param decode_content: + If True, will attempt to decode the body based on the + 'content-encoding' header. + + :param cache_content: + If True, will save the returned data such that the same result is + returned despite of the state of the underlying file object. This + is useful if you want the ``.data`` property to continue working + after having ``.read()`` the file object. (Overridden if ``amt`` is + set.) + """ + self._init_decoder() + if decode_content is None: + decode_content = self.decode_content + + if amt and amt < 0: + # Negative numbers and `None` should be treated the same. + amt = None + elif amt is not None: + cache_content = False + + if len(self._decoded_buffer) >= amt: + return self._decoded_buffer.get(amt) + + data = self._raw_read(amt) + + flush_decoder = amt is None or (amt != 0 and not data) + + if not data and len(self._decoded_buffer) == 0: + return data + + if amt is None: + data = self._decode(data, decode_content, flush_decoder) + if cache_content: + self._body = data + else: + # do not waste memory on buffer when not decoding + if not decode_content: + if self._has_decoded_content: + raise RuntimeError( + "Calling read(decode_content=False) is not supported after " + "read(decode_content=True) was called." + ) + return data + + decoded_data = self._decode(data, decode_content, flush_decoder) + self._decoded_buffer.put(decoded_data) + + while len(self._decoded_buffer) < amt and data: + # TODO make sure to initially read enough data to get past the headers + # For example, the GZ file header takes 10 bytes, we don't want to read + # it one byte at a time + data = self._raw_read(amt) + decoded_data = self._decode(data, decode_content, flush_decoder) + self._decoded_buffer.put(decoded_data) + data = self._decoded_buffer.get(amt) + + return data + + def read1( + self, + amt: int | None = None, + decode_content: bool | None = None, + ) -> bytes: + """ + Similar to ``http.client.HTTPResponse.read1`` and documented + in :meth:`io.BufferedReader.read1`, but with an additional parameter: + ``decode_content``. + + :param amt: + How much of the content to read. + + :param decode_content: + If True, will attempt to decode the body based on the + 'content-encoding' header. + """ + if decode_content is None: + decode_content = self.decode_content + if amt and amt < 0: + # Negative numbers and `None` should be treated the same. + amt = None + # try and respond without going to the network + if self._has_decoded_content: + if not decode_content: + raise RuntimeError( + "Calling read1(decode_content=False) is not supported after " + "read1(decode_content=True) was called." + ) + if len(self._decoded_buffer) > 0: + if amt is None: + return self._decoded_buffer.get_all() + return self._decoded_buffer.get(amt) + if amt == 0: + return b"" + + # FIXME, this method's type doesn't say returning None is possible + data = self._raw_read(amt, read1=True) + if not decode_content or data is None: + return data + + self._init_decoder() + while True: + flush_decoder = not data + decoded_data = self._decode(data, decode_content, flush_decoder) + self._decoded_buffer.put(decoded_data) + if decoded_data or flush_decoder: + break + data = self._raw_read(8192, read1=True) + + if amt is None: + return self._decoded_buffer.get_all() + return self._decoded_buffer.get(amt) + + def stream( + self, amt: int | None = 2**16, decode_content: bool | None = None + ) -> typing.Generator[bytes, None, None]: + """ + A generator wrapper for the read() method. A call will block until + ``amt`` bytes have been read from the connection or until the + connection is closed. + + :param amt: + How much of the content to read. The generator will return up to + much data per iteration, but may return less. This is particularly + likely when using compressed data. However, the empty string will + never be returned. + + :param decode_content: + If True, will attempt to decode the body based on the + 'content-encoding' header. + """ + if self.chunked and self.supports_chunked_reads(): + yield from self.read_chunked(amt, decode_content=decode_content) + else: + while not is_fp_closed(self._fp) or len(self._decoded_buffer) > 0: + data = self.read(amt=amt, decode_content=decode_content) + + if data: + yield data + + # Overrides from io.IOBase + def readable(self) -> bool: + return True + + def close(self) -> None: + if not self.closed and self._fp: + self._fp.close() + + if self._connection: + self._connection.close() + + if not self.auto_close: + io.IOBase.close(self) + + @property + def closed(self) -> bool: + if not self.auto_close: + return io.IOBase.closed.__get__(self) # type: ignore[no-any-return] + elif self._fp is None: + return True + elif hasattr(self._fp, "isclosed"): + return self._fp.isclosed() + elif hasattr(self._fp, "closed"): + return self._fp.closed + else: + return True + + def fileno(self) -> int: + if self._fp is None: + raise OSError("HTTPResponse has no file to get a fileno from") + elif hasattr(self._fp, "fileno"): + return self._fp.fileno() + else: + raise OSError( + "The file-like object this HTTPResponse is wrapped " + "around has no file descriptor" + ) + + def flush(self) -> None: + if ( + self._fp is not None + and hasattr(self._fp, "flush") + and not getattr(self._fp, "closed", False) + ): + return self._fp.flush() + + def supports_chunked_reads(self) -> bool: + """ + Checks if the underlying file-like object looks like a + :class:`http.client.HTTPResponse` object. We do this by testing for + the fp attribute. If it is present we assume it returns raw chunks as + processed by read_chunked(). + """ + return hasattr(self._fp, "fp") + + def _update_chunk_length(self) -> None: + # First, we'll figure out length of a chunk and then + # we'll try to read it from socket. + if self.chunk_left is not None: + return None + line = self._fp.fp.readline() # type: ignore[union-attr] + line = line.split(b";", 1)[0] + try: + self.chunk_left = int(line, 16) + except ValueError: + self.close() + if line: + # Invalid chunked protocol response, abort. + raise InvalidChunkLength(self, line) from None + else: + # Truncated at start of next chunk + raise ProtocolError("Response ended prematurely") from None + + def _handle_chunk(self, amt: int | None) -> bytes: + returned_chunk = None + if amt is None: + chunk = self._fp._safe_read(self.chunk_left) # type: ignore[union-attr] + returned_chunk = chunk + self._fp._safe_read(2) # type: ignore[union-attr] # Toss the CRLF at the end of the chunk. + self.chunk_left = None + elif self.chunk_left is not None and amt < self.chunk_left: + value = self._fp._safe_read(amt) # type: ignore[union-attr] + self.chunk_left = self.chunk_left - amt + returned_chunk = value + elif amt == self.chunk_left: + value = self._fp._safe_read(amt) # type: ignore[union-attr] + self._fp._safe_read(2) # type: ignore[union-attr] # Toss the CRLF at the end of the chunk. + self.chunk_left = None + returned_chunk = value + else: # amt > self.chunk_left + returned_chunk = self._fp._safe_read(self.chunk_left) # type: ignore[union-attr] + self._fp._safe_read(2) # type: ignore[union-attr] # Toss the CRLF at the end of the chunk. + self.chunk_left = None + return returned_chunk # type: ignore[no-any-return] + + def read_chunked( + self, amt: int | None = None, decode_content: bool | None = None + ) -> typing.Generator[bytes, None, None]: + """ + Similar to :meth:`HTTPResponse.read`, but with an additional + parameter: ``decode_content``. + + :param amt: + How much of the content to read. If specified, caching is skipped + because it doesn't make sense to cache partial content as the full + response. + + :param decode_content: + If True, will attempt to decode the body based on the + 'content-encoding' header. + """ + self._init_decoder() + # FIXME: Rewrite this method and make it a class with a better structured logic. + if not self.chunked: + raise ResponseNotChunked( + "Response is not chunked. " + "Header 'transfer-encoding: chunked' is missing." + ) + if not self.supports_chunked_reads(): + raise BodyNotHttplibCompatible( + "Body should be http.client.HTTPResponse like. " + "It should have have an fp attribute which returns raw chunks." + ) + + with self._error_catcher(): + # Don't bother reading the body of a HEAD request. + if self._original_response and is_response_to_head(self._original_response): + self._original_response.close() + return None + + # If a response is already read and closed + # then return immediately. + if self._fp.fp is None: # type: ignore[union-attr] + return None + + if amt and amt < 0: + # Negative numbers and `None` should be treated the same, + # but httplib handles only `None` correctly. + amt = None + + while True: + self._update_chunk_length() + if self.chunk_left == 0: + break + chunk = self._handle_chunk(amt) + decoded = self._decode( + chunk, decode_content=decode_content, flush_decoder=False + ) + if decoded: + yield decoded + + if decode_content: + # On CPython and PyPy, we should never need to flush the + # decoder. However, on Jython we *might* need to, so + # lets defensively do it anyway. + decoded = self._flush_decoder() + if decoded: # Platform-specific: Jython. + yield decoded + + # Chunk content ends with \r\n: discard it. + while self._fp is not None: + line = self._fp.fp.readline() + if not line: + # Some sites may not end with '\r\n'. + break + if line == b"\r\n": + break + + # We read everything; close the "file". + if self._original_response: + self._original_response.close() + + @property + def url(self) -> str | None: + """ + Returns the URL that was the source of this response. + If the request that generated this response redirected, this method + will return the final redirect location. + """ + return self._request_url + + @url.setter + def url(self, url: str) -> None: + self._request_url = url + + def __iter__(self) -> typing.Iterator[bytes]: + buffer: list[bytes] = [] + for chunk in self.stream(decode_content=True): + if b"\n" in chunk: + chunks = chunk.split(b"\n") + yield b"".join(buffer) + chunks[0] + b"\n" + for x in chunks[1:-1]: + yield x + b"\n" + if chunks[-1]: + buffer = [chunks[-1]] + else: + buffer = [] + else: + buffer.append(chunk) + if buffer: + yield b"".join(buffer) diff --git a/.venv/lib/python3.12/site-packages/urllib3/util/__init__.py b/.venv/lib/python3.12/site-packages/urllib3/util/__init__.py new file mode 100644 index 0000000..5341260 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/urllib3/util/__init__.py @@ -0,0 +1,42 @@ +# For backwards compatibility, provide imports that used to be here. +from __future__ import annotations + +from .connection import is_connection_dropped +from .request import SKIP_HEADER, SKIPPABLE_HEADERS, make_headers +from .response import is_fp_closed +from .retry import Retry +from .ssl_ import ( + ALPN_PROTOCOLS, + IS_PYOPENSSL, + SSLContext, + assert_fingerprint, + create_urllib3_context, + resolve_cert_reqs, + resolve_ssl_version, + ssl_wrap_socket, +) +from .timeout import Timeout +from .url import Url, parse_url +from .wait import wait_for_read, wait_for_write + +__all__ = ( + "IS_PYOPENSSL", + "SSLContext", + "ALPN_PROTOCOLS", + "Retry", + "Timeout", + "Url", + "assert_fingerprint", + "create_urllib3_context", + "is_connection_dropped", + "is_fp_closed", + "parse_url", + "make_headers", + "resolve_cert_reqs", + "resolve_ssl_version", + "ssl_wrap_socket", + "wait_for_read", + "wait_for_write", + "SKIP_HEADER", + "SKIPPABLE_HEADERS", +) diff --git a/.venv/lib/python3.12/site-packages/urllib3/util/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/urllib3/util/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..84256e01fe877dd503fe7866430671c48e54132e GIT binary patch literal 999 zcmY+Czi-n(6vxkT66bfCA5B}@f>gxdp|zk3140TV5*49|l7iG*PR718R_|j8Iq%Um{061DbOM;CbmUN zv<%C%0xPr%t8@u2(HgALI;_(MY|tibCg*ZwnYLgnvGZhwuEJHi2GCiMl5kjj`)v##Ql>Dm03bMH4zr&pl;AFXrZ}8BYLiYp6XPh{-Ff=V;cBwmvFn|<$Cx{Jn|3B5APz!7sP=(& z;@NHP1&#a(!7tepb&Y<%{JFxFX&A-@*t!7Q=b-%yw9mlS8CbnZ<&D%0P`K9k(*(xm TIe2sqoU3%RnEGO|$13?Rh}02o literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/urllib3/util/__pycache__/connection.cpython-312.pyc b/.venv/lib/python3.12/site-packages/urllib3/util/__pycache__/connection.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..50d6b5389a7ee2502478288a83d405f672bde05d GIT binary patch literal 4742 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/urllib3/util/__pycache__/proxy.cpython-312.pyc b/.venv/lib/python3.12/site-packages/urllib3/util/__pycache__/proxy.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..efb1e4136b0f0d4f55a11f64000d836ff0c1f352 GIT binary patch literal 1211 zcmZ8g&2G~`5Z<-(ZBEVE7Ad!n@>`mihd(GM|1m(~J z?*OlWcoZ&>OM|6Kl@N#CB9#*-X4eUg*eJWRGvEAuv;JDIR}n0I^Gk17K_1Jx8SQmpXjLk!wE7j-RKUAiG4bI*T+AQpOTh6pp;fsVF z?)YdEgpX*5cJTlY6<2w^f)E!n+7`I~ma9tp!VvTN5O0ep|1IG=DCkA|9+Xohur_Iu z@-QYHo>JoVNYbaoVPQxeQ8(fAP3mzP6FVg9oz4bnKQ+y@b_Z~rrCWW8k3<`-s*HC# zvbi0Q=bMj-R9h+cZ%d2FCe$oXGIbK#sm~l6Q(q_qs5y3*2vHtrQ!be$JJJJ4^gn-w;PZjlwQMM*zNqWHQzt`nL#x=e6C zD+ohYl;)1EWTiY%)=Xn+^%#F^bJq*EglI{Su4a{gtYo!Z%-hKtb9tv##^Ox?KYyMX zeHKuIM>OGV$8-9I!(3`S@nXkl?a*+?@V!??G)Vd^ywzI0X~bSaZ$!598W@QU7y;OC z8ENAAhD-`1WfzXeY|X|j%e0ad=I`@Uko^Sw-*P5RmjI`w+wdT0i+^emQYO4nlTU$JW2uN2=)6_Ly2l;&!z5_BOCJQM) zDHIJk+_s$U%&;JlVuU#|D{=W;v%)JFxL(Psmeot)0aMH3f~>5R3?iUBQ=w;G6qfaPGT3F8pAl~ec@efh+MR&8sZa0nb8r=(ZEV6eQ8C8*=+aMA z|AkH;sFgkS%t$@6UswSG&R-l~y*9q0Ps#)@ju)0DDx3$6%abCUz}C{Tv;eYH{apc_ G%=Z`D9ZoU; literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/urllib3/util/__pycache__/request.cpython-312.pyc b/.venv/lib/python3.12/site-packages/urllib3/util/__pycache__/request.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b861ec1382246160116a4c0d37721680bf745a4d GIT binary patch literal 8030 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 JTTgM2|1a>}J1+nL literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/urllib3/util/__pycache__/response.cpython-312.pyc b/.venv/lib/python3.12/site-packages/urllib3/util/__pycache__/response.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..fdc6f5cd0348a72821c3cd44b63e08536336d087 GIT binary patch literal 2867 zcma)8OKcm*8J>Ocxuhghl5P1RjpC*<5t~fy9tyQEBG+zg15%7wbr2N=vDzJyYcF@1 znW1E=R3R8W*k}RAy(mBvpa^nkp`ynkMT;W7wigN(Aa&uO2AUjlV=bd-ed<56yB00y z&;htJv;T8v{_p$ww|qW}U=-ipsFv~w{Znk>p@s`(_bM#bk&SG{MGa*^QN&tx)rPj9 z%eCev8p(xZBejr%y>2JmbR)Bnfpx}C{!CxU+F3gVvtb){8s=PEE#|%w?u$xbn4afz zlRLi0=89@CIooo%(=;i+>@AtpF+G0W@m;BKfmDgbgQM3th|l{i&o*g$&gVZ6%TV~0 zNE_T1E)mlv^r}gjQhS*A)}$gtRbZA{uLJMD1$oaM!!5#+lc0C=mg@?i6Hb1 zL^TDyi#&Z9-O}Dg%ZjuYKKG6P%PzUk2)4G;LND3oMNFQFwQY4H%J{Yt=TX#FcoxI> zew|o18D6dvUMCcrxaKSo4_6(RoOYd?1pA9O;4HDju;u!U*rlwrn}(A&8$voQ_rlkF zoxE(weQb#sC8;*IQv9K3F1iH6dz)}V8;(bwhp#sK0u>WM+F@bTU|@!G>MXW6k#`g% zqxWjH8Dy`UZYz8bH>yESOnfkYcD-Ep8>CE|gj0XXvFc^Zw@G;xyp~JwnM-BYSu8i( zyzYBvOW!(EW)3H(o2GTstPxgjQ5WQA%PsD>WlC5RN{^J9?I7o{O0`)DQ=mf-OB^=) z2|U(NZzz$-_mXI6_+IC3=jT7|rjP&UkumlJDT(~w)484o^Rr%3PvjpD7VfRwUFoLB zzE0t}m!-Q)AB^02!Ou=Q_eFN3JNm}M>`Ygm>7|5ER)qMs2Mg$znQ`qSWnBB%D52kH zrnNsR)7oG1Gdc7imzjA*doZcM^Mxu;gQcwUDjeK8;?FC*(^t(mzNT(BqFQH%c?x{U zVJmyJ*FhVRuU`Qde5A#@+lsBNDu5*;w%VIxEU}Xy2e#QiV)?4tm#4}HVm&S{M2@N& z=SS6!D&rMm+1`8s-P0_!hAj2RM-W=o`n+mMxGzXjNa;Iy&qX zn&)G&W=HQRztiI!ZYynwqd=ThZ5b64<~cYTiHaG<2<3e!bX{DRyu@(bTq1ap047<> zvIt|}eW@WXc4%mk4#L?bx20 z4kHXlh$@j=7HLWVYMaq^9fd%=N7am;2Hn~~M2U!PbpK;T(NRWzL1V-Pt1)2GFGvXYb!%~935%-?J zs1aUinr+uN?I5w(=7a?rRgj7elVO6=hzTQct(Xo9 zrBPE>MmNsyg{ANvD5*3i>&lsou-?Zf5mi8GrMXSR&9j|L8Pk9_CPBcIm( zbo|r7&)(}EzWi|DN;iGw@yOw|*W-M{buJCPhrKF$>$4UX;P3R|PEZ=Jc;9hrZssYBT( z36vS^X`rz7W)H#iuOXBkynp)90RGLP&+=OXbKUe@Pea4_zfTT;n2Cn=;JXv&OZp3J zBsfK~(HpQ>7abSo{R7af+yJfpBW4F%xe3Q}4Heaut_0b>P8VY0y%u2-6s7=(BzQm^ z3jt^1OBZJ@oTfx-#iblJzWq>mJGPG9>{an|QQQi#QE6!_d59r3&|D zT~Sd+URZFnb|m^>S3--_}%dgV)W{2%C@FVSne$z#fSW%u0c%3I3Qs*+VsN+Os(u#RdK46Uy&=RTJPq^4hU{x+@`DGTBQ>G%1BV+ zUH!^;?(OcG0Y|pC?4(8AzVE*G-1EBUoWXyqt@Q|aLeuXpbes}|f1rZ#IC#dg^Nd9h zZVQqiS>i&%GHbC=-Ws>gTG`t+Yh!Qwtew3bvkvxl&N|t%$lNq<}G-+!xtn3|_W|>OZDJ$f9|p$z&=W zO~+D6bqZy7I(kLEb~zT8QK+3!qVw{_==_zLtU zPtCJ~nF`r8S0s{*Cgey&^F$(vl$426-WQ2{Jrj-VE&fQP>@*{hcZD4+Rrvh;@a0rO z9#)ocAgQad`OCxeDM=oFKBmqOhp)=XtHbfw#o?u8EI4^M{K%nUHI|kSF5%dtmt=Jq zJ3#y4;Y>OfA6Dp4!%NFb6J};fFEVNml5YwHUvSeNEVvv0^lZV~v1#wnD_VN*+k2Hh zV?@QF1W=2|vhx>=uFDT))&?B5UjlXiTZ@6mvktw^R#xZK>+EH9HIif2B{^lcesnI$ zZTu%Ykn_kc$&3Hol2@*gdxU)m!z;2n_qrAEB#rM*%U-VM?|X}{Er`5UDHDTtaTyj$>Y zmO@f1-a&k8aM!mENNpI=A`MCH=+RoOx**4wF?U9lCH-qOQA}2iE|R&BW8WMbOuk(NU2jK5wHf(CTT@V|<+h*e0>N zV@HS36qSx0qBkeeV@E@5oiyxnI=zH3#EG7dCP6vMfIibP{axy-=o}9HX;@g{jAWqi zge#Wd_9_2ip$~oRARU<#Fuzh5tn4;pgu$#0J8?jQ&+)JViJ}Om{shZ z%C!5?@4bD_eg9c&Bakqt9h)WwG4RMpNMA0M%a16gMlZ&3Mi-aGrKqaLl9$A}xyfi; zmFMRE|E!RGOkW)nF)Bw<;Mg@Ky0nDF#ggLad>qRgo%<7={e@+NhpXWV;Wj5`l5ts8 z86xOV5TgnXLEq{SO~+4Z9^#1|(0nw*wr);pE`bR-1HVU?qDnM@@o6y)DGdxJOrvLp ziefU8xF{=PYQX?Mx{1+vJasKB&Onf>;u0i@EXm1vnW2c70y-$b|4cHi>O@4-otNng zI0+J7b90neS*JB`wWh|9JDw0Y@Ols5z=yR0;Pbc9L_)ev+iHT?u%!Ly- zL^CKV&Ug?L&7dO!0dN_MEnD2oWf@0E$E$ba=LH4@KEuz}piIC`mD$O$%@RDp0aaN6 zsScR{z3=mzzX3Jru0|)G% zx|uLCx+kK`fDe#T1*bbGFD!s9SHMN>rCd{N`ROGrLlUw59kw=D*Knxuo zIZVl;VoEWmKRohS*-`uf_)x(X{&=LwcTxqm4`bIwAXnMO%YnvGjNz6pUlO=?5MMDM z2PNVfSRHVMsnr~GiD-Hr1Z)CpZjQG`aFFwI9D4lR+#d&eWz2^$$lq(joH=vCDO<)_ z(1K#{n=;muz8nQV#ukZR=!}f(C?yRAs9`|Bn3oQg9u7mDOcSw7m(!$X{n2QZP5A$a zT50*G7a#+eRD@sw-cNLNDU|{lN^+El5)CGSjxZ{nXOhaq1kw^SN%{H` zSPFQqEM1bJRjS~3B=8=hX_5=&gsdO;cq$&p1a#43QdpKE{2r*5&YwsU>^B2NL!mE7 zoZ@*u5whVTF?XCSWP*A*m5EEh>4)Ud@nu8F1D+G&Gu4=P6ZLQEN(W&G32?xIiIWtL z+1xiO6HAawkW&K*sLL^^oA@4+E2I}eHwX4X`G#m>%7_deu8J~%Vl@PXJ48)5qW-M=G55}=c~|Lw4{fy`v9Gn0RkMy zG6RxM9}fe5H$|5qKgQ4iu!kNaL$-3jm+^;(0MFP0aLM?3*xV~|ZGtuskNA9yX$~=x zswVjKW8ht|rCk^?H)l>pD8>isT)%8h=J4J7s^C=R=)eRK)@A6Q{GjG^)vgk53-J^% zja0eR!a`&rIuAoeIl%N5XnfSd2xp13uZwc}nk)m$`5g~bV#;<^2C`v4%Cfn?fkX;= zUb#XbtEu=^QnV8Z$VUK==3EA(OQYGcVP6uX<~$NKv}NFyu9Bk%^iVY}%S&|28`ZB5 z#2n~(rE>8r;-ENiNE}4^N=a{qetb2S%Bbu(aZgz>?kzL}UyK@Nyv6|1Vhnp$be5Am zn3a{(5Ka#O=PN-*z7B$tu)T}RyBDS4tW$|_CKHJ)SdV@*`0Pj+iUIHlmzRZ1a^4_3wyZe@EEAF@(8QNV!XuECBjH0VJ;Kt*kcPwI z3+6c!vI9C{7`F^;;n0`Cu*_K@KH{k)Q5G0jQk*lEn2264C-ZV-HO{CUUkCIpF{Ygo zM?#f2dl8peE~d(r|55R!%P_e?wKf1$I%Go!1Fe>1zkK~NE@5EyfEoA;*%pC+6<50< zlAfITWE3DfkfcH_GdFJ5lVJf2fl>3}>(?+-^EU5(VTzCel$-I*bCpgp}ANE~#`aWkO2ID1d_b0hz2y^K|P3Tt-Q} z;bK0`#7Zm)(^3NRYYtalOioIi&NBfX93Z5gIS{7K+1F!e#O^U zsa8;v`K9x;ab`YP5c&GpEl0NwEGVf2Lw4he2COV66myzbQi_o^8>mfW#P37|X@CpZ zNxYKZpkWiBP7p`>yu7O{nN#VX;<7m8)a<7w#!hH9n9elYxi8OX&Jz=7CT1qInzQF- zPM@7RuQ_I>$Hpf@w%GSzVvhZolHVW+*)->PDs?3$Yqet;7{8TRmYFiMjm$rBu%hzg z>#*2ngSaqbdEs#~4!syvUS`L4L95ZVn~%wXHKmZJWafY9CSGB_-pJu?$Nx66cR$JO z-8oB6h?vbeD@v&6PtJyt?#~f~oC76{)Z3gW(Om4w*(FOxQ0+Mjy%oD;T|v!?H)lsL z-E)Q+T-PnC$0DR_jd6w*8og?ax?BxPF0v>Oy0eb8H0emfhk_pLWA>^2vWPnzBF~__K zH53R+hZ&5Kc}}pv*^?74z;3-_$ypZ5d!n5lcCxo9 zG=b(|cSX%*kdkJDwA2E-dAH`@rFCj`hEV20R`VKV2x<79NQ9I#0?lt$@wv4cotJCv zB=xFuJk1Tpkd@)XOH(&8Bv#`xrNwaFCseQ5RrvOl$FW6)yraq!lpLdkwyluwO?ifr zrzshu7EKmXYDNo~*rLfmDq6tM z7ESh1(E^6FXfln878hDf22s%hwzb$$sxfj{0a(}~IWKoTXaPH04DPB%5iMYCi>*~# zYSGeOwFRthv9oH6A1&QgTfpKL#cC~oW?8Z3tc%2Qc0D=MHA+DR>AgmCPB54#oo~+i z1IwRT&I_T2sXv^!7+o<6BjRH0H`J)vA>h-0?8!AJ_Y7)wvQ&p`%Cq>QX1#Jvb24j$ zsuHgUU2|f#!Mm7sb2>)$H)vB4YylE}P~ZHiP~YGwGz4!CzA;#|A-~t!t}w;9l!Mv6;$2p=Zxl_mO+uM~W>} zZY|B%M&)*)xs9!|gG!ykz|hwI$$R@Ji(ORiE|q(zESA33i}I?oxKD8VU$4DcyLR!u ztF7Q~`%Zf8#J95>{yldlk>p)_IHxG5a8eimR?E)6M+TzPawCwly=u+bl0+e>+x@Iq z(sT^$$yw6oTt+a8V$A{f(j^tcYT)K|i$Y2Qu-gg|4Q0ssBdalL#hx~K$Raq`?g#wG zlCv8@Fcu+a2Y%bLhmXUWaV@Gy>Or_om!Q#IjKyQ=W#$NGR|4IlMqWv}gh$h1NO>k? zvc2P}ByO~10#x{wm%F4##l4Dn@F}Drr!tI{Xr34xco2zDjTIs~%}%!f%@$8x(j1a} zF>@*8&}{Q@l_FQz<(Yj!tI_?^nimMlE(=(PN+4&_Nf%0_S3@qP4WVR|>wwJaSJ4?l zDIoY7SD!BQ4&-}}+`9C^p8tH{KOI;-`H{DI?b6$s``*2U#`e{zj~ZL6GatItAT$U=`@v8GKOG~H;-C)v`?Mjqp<2$7tL*1LBNq;+Ob z!@>jeYm^}=p)G=K$O?e_D!Zh@Jge(zr8tFAg?Qqq$ZU8XhCN6sWIjoBEYh+=;)ayq zYSb$U8R5L396=Y50f{W=yq4=KorbREx}Jdzc1UgsWNrg}zK@#$TeB`8Nr>nR^T!i#nkRy!b zT&)|Ut|W9cCpV;N4z_#EM%t?_5lb>{(2x^BGJDJOfF<-#Zhnl=2WpL_^Kg?25fa$F zwQR8ZmV0S~Z(%JrgwK3J-`)qlz=J^BM*GwMwe{!ye>e0uLz`nSZ3e!wW3$%Q?bz&n zp1i9YlEl}y{=z-)zCvTuc5CNW>w%5d19!ikKl!hZVaE>XnkR|w&3+|dAm2f z-RpbqfslP|Z@>7?h3{T?D{?ozHGF&n|GJKE_>QkW|G?k$=jZR#zdgQg-x5bQ#F6(8 zZgxJi**v!CKc06T=fqsD*AY}1F%Mz+^XahT&rn{2GJ8E0co2A zowG_dW9OuKkz|?5*8PjGse><%9DMx30c85KoqEt?6(i25$dDURf>uS=9L({k*}%~? zhnzqNgyx`dI#u&QjRAVY0v<_c6_R(FJ8^|b3T0?L$S4b_4LP{#<0WCDo0qg2-9W7c zcrBlX3~rjIRI^*S)U!{P+o`fG9K|1MI6^pn1D^+uI|X0e>yO=hEZ?+u{gwOP!w(=! z4r~VZ-8}hGPyaiweD{^Do<}!&9{s?(*>fWA>n!+t^8Wn~f_w7&j(_;XhX?ch=Qe{c z4g(a;r;L07K_yty1FBsVOK`LZ%Yb&sHZ?N|4*e&X zPf?L*4(5$ea>(z30c#-VJcon;rrFwvP~QjDr;XN80^C+z@Q&b$z z;epHdy62{6?NQS_P%aou5M0J2U!*E1!JI{D0=-nBt6f-OStgT06}mFONZ1gvMvr6R z=a~!7@F_B+H$98G@tV||8FI4eesbpe(+yB!6vRhSRq*@Iac?sxO9TcO6sFs*O*M&J zt_-Y9$AY_oS$++d1hHKVWnOS{5Fplox#aPE3NwJykfN3-)WDpOEeN5h@RGn4g7|fG zh#^EzKeez}?)4(QPH!+=tC)I(JS^sf%%xblTjs|pbD5Uh(cm-O=JhI0Pk9XqDxRhM z3KB+POX&*YVtA+XsxX7Z1wtXx!@x=!1YcmwJ9y7K`0jOBySADJHkt~MlA8JloDG_lSQu!;}dn?~$4T$A@B*a0Di3jE1x26=XD1a3WoPC{%J9U+B9LMx=xHzBSc zI7J`hWR2hpJ@i=j1HwRP_7B;W8LUq6BGKyLKDZQ1M&n%3ROqt%u1?lA=$;iM-4uzb z5#6ebU=cnf+pZIKm9_+(4QFwmxddNuZT{`i`_LjAnztJIHyZj^#~=9H?(DhWb7<3l zIPW_A@QDy5vJ(j-Q?B@xpGfKIzF^*07?l5|4rK;T<~S?!_#3_-3SDHbKwOLI3e5m% zMzNS+(*qrMpUg%15=ci6Z=}ml42~-zdwPJ)4Af*GRG_N~%1tB{Fs&n)l7U=@rokpF zYBL1K77T?#;}Qbx0GT-Q(}Ve*XEyy~dDqy(a3gGGa5E($Dt13g7cdyTc0UHMtA6pi zYQg=MNyO~(_+@$i3LLNtA|jW7n8}K$AUzI|6ij*L#D&Wg-mh&SnjVX@19A|g8y+W|& zA_?|1;wL@#ygloaKRomOGk-btLI2k1)CT_bPZb(l3;sq9`f@g4GLgTxDc+VT%<_y_I=@B2qU5Zhz{5bt@#^_Sm2v32D12LA0m4gK{a ze`A4bw4VyL+NTQ`7#Q9N41a1vX*jlh38aLUH zZ&|`cDEvp#IZFp|-AQL(QtMDB$%; zs}Se}>U`vHSbK8QFRnkb;qTA8`v2+E9<-`-CO@n3j_tM2lWt->Ze-Z;58^1l==fPw zL2J%le%C8wn)df}ghIT5(=fwsN8w=5_onpaTnr9n_ubzE z2Ci5C7sm0ux{@E`OOyDLX=tkYrK34Fi|1&}SzfJ2Z_~D1*4w;Ts{g$8xL^GtX6Ng1 zC%=#NxN^Q%znAmrb-v{7oJ|?c*%nDn+VvRvj53(>;0!(b7?0#wsr~IERsy*INH_pk z+p3;ZUGn9$>0+(sQl&2_r>l=vj^(^qk5^xhw``^=F4#pg?xeK6>hu1{X`DXWUp4$9 zH?LTl$H=Ak7&&rkfiCKD{`d6T@PZ|a#uYl*y+*In8}T=;oIB@1bd4`p|D&4sbZT8` z$Tcj|6=2t6o=I2Ej+h%S;(OYRF1cEB{f+66S?j=x8Vx$lHGadI9yHn(4;s1BTXLa) zgV7&KP6Lz}ck~A!4DdG|TUh;Pon~;J?oXrNTd@$o^51gkL3GAVeN-F+gVy6L`ENv7 z7$f~M&5Z4=yv=z?+!_yfb7i<==@v0c4ij_oQ8T#D{EeUS-SF<;k(Xk%_0^Vs(arn{ zSTwHvbQ48r{O&MDrrnsA%d+3<(2{9er1o99OkGQ68`7y1|Mi;@J*2|%^Ck}bcZ$LZbjtRh zHexPutW3f&x77f`vXAZGtL_hxw=~qkr79Wdm9vzLQc^9R=iAiquP7nCOl#&QP9FDX z{s>-y^G(odPfkotOrIW)OiWLoo!08kpPLvzJ!zJm+@H&xMNKs0G$nT^Awj3mB~Ez> zNvNr$&nd*|n4v@=%F!GV`n{~?jX=$tzk=UA!o|x}#L69LK2r?@PP5P?%|SoxlzFTY zaULEdMP4YVh`V=0z|`D^8+aK$Ejg;9FD=}_=JGdJDBUJeW&I5JVYA{#q+1+@`UBl! zA8uT)kKP=;(+oG#_m6(m(Dru!oy=PY)-!jnY&MMMeWTl4vsiT$yn(#8v*4>=d*SA@ zs}tJ@gc!Ot1k<6v@%81K%d2*%owtwOI=1R6v~=8l<<={!OjUtag0X=%B=ya!&O)b{ zceVZ68(5p!Y7TEShwo)M93^j6E@M$6#cqxV}Lfwg)qb8}_gxnB3awDqO48(%t`KlkGOFTGTC zs^)xsFI1&FmRs&yc1*SHZ_4|{LZJCh{VmTe$FFOf?+k3UKeo~S*!}j=ZGTJNzo!sr zy)$;JcFk328d#kugdW)no!khW+zg%0`}Y09A1d@?mA!@LuG^7Yk(-mBd4%S^t)}6P zreU&ywcI)N&e^{>TWIXbHy$W7iR)tM^A0~P8V&~J`ZBM8a=BuxHBX2 zL*_r`% z@jaIH4AGCE*bn)$HT+j{$Fkni59N+!-LO}&-wGc4+!6vOWK63Id#^_PjKsk;pGA9_ zr<}qG6?sXCM2zd6QLY79s>FV72)M#g49=FnZ^Pf0uiLZ!=-nef8GU#3?$G;-A2$7U z=g&GntSbtZvz8{9UT>eib$acIJ6G=Z|K#Ai2k-WL;Qp}xuMhm}z=vHwj}~o~+7~QE zn@zvhh5Fc1Kd)y2={cBwjK40znQuF7hH+q)V_}tlMRgsNu(~JB+%w2!yNq~e^M`FO z!!>_F|C=T33SF%aK5X_GqZwsNj+?o0%CW2W2{Xq;OE3Gm0HUgy>HQS{)qwt66#kc0 zxS5-cJ%zEQi0sN0vM2%eSz@cC5omT2wYbNhqhTI>V`Ir>g)}H7fFxv{nF_g-uOj<- z8y9Rj@nKk&;5JJme@qFRV=tS7=V{0ISQ;!>7NWVQgWY z+L|i<2$9jmKF`mLubXxd>QK7yQYhL*Athg{iA1E-JZSJFm0G^wH;Bp`)Y@mXPES04 z_Qi<^{j6YO`h4W$Z1y~!w|9Qx6b27#u2D1&qH!M# z5FOoldkf4(b^V+6JrFtl`wHECg^r%WzQICQFJyY*@pFaIrwU?kp=+ejx33`f7mhw& zI53PcwZjE*PjUYN$H8sCSaje`cBjr_4dq;dzpdz|oJVNvFM28G6Y4vPwUn!a?Y-!y zTtH}lv{+BM2BG7zVk6}cBiUVSrd$w#*TojfwIZ^y*haZ_p}o7mB2koqc{s%TAxmad@Z6>1f^w*d3jp`RW|q zJEGHZgo?*4J3gnQ30s@AJO@VIV|_7=P~c)Jd(Le+(8j{J>I$fmdaGTdOPi(nxhz$dFUwqM92wiZfU~E@+HDkQmlH zQ}|7@G(*uc{Et}?_hzx3yU6Wx*OUAYZat;^7j%J+EvQ7jkiHhnuY|sT5PZKB>V7HI z{!(!NQt%@4E1?Jfeq(o8tiKVEd_u|pZV)W(+cx)>t>vDr9yNbhR1P{oy^ir$2&+DfUCRHDd_$dw;EAn3xVO~-InNlKMU)mWs< zF8W9Eo!gHYK$O-_<_ zzKlQS&jezDOfVKioJ(}4Lz!?aoT-Xc;oBqf>FP{PtR_<%tHrlHwhO;H(HpDBuR-)( zvc(!D_uPQl-SS&%V*i?@rWx06M8{erzZ8&yqW>*NY>$`Q{!fgEfv-Dbt=nVEU*Z8V zi1aqJ^;EeHlakvovQWA`(-G@nBMYb9na)@z8$nfiZ>BERW#jDJX-=&EIw#ghouc>q zwYR`gdSd%hT&!E%CG8jM9>cd+=WBbc9kte@)<`UpsgKoX4#W;*dSX49-dJzuVC-Nf z8jEK7VttuIu|t{uSbt_$Y*%I=HelnVXlzibm!G$DQk&E(9h6*iv#hCY!Q9-oPxgVF z=|{%?p5?`c%lkP_4xpawr|ZeuMEfn594Y>O9lvGQb4cAR zrd`}E9se`#&+TSB@#wW?C#?>hw{;k?d+zF|+XJT`7wt0+HvdnEJz^W?@JX>(6!3mZ zJSeu~JzSn;a6Vf3wVf9G#E!4KVo#&3KlyZ9+w+#c#6xBJ523_0;+|N)=(=i)4aTBkYpjoz zsWHn$j(<#Cjo37QBAd;r2{o0=D&zR}E@Wq=tLfCtQpBM-GU5@e5tlR?0}{v&zE!d`?y+QRAnk&Wy@(PX5@YXKai=eQtPU^vvkgRD5jm zi$~+bCr_S>#m|juJbfPqb!wTPRn_^v{%C*1@v(q%A7cY?A3ud4=|EsUMB`_>PwV_T zmxmZ;Tg{cXi}uSeaoiNeIapjz-X=OlR}**50g8#gYtFnwbW`e8o9wc2d8g>1QdeyX z1S`_`ZE0R3jdD6fpI-lxKN3j%5Mw(hsS9#en3fkLVJ0UFBa=(&Y%VJdMvq5N^z`C= zB0AV3AZ0Mxf2c=DWJO_eX>v(87DbjG;mWKeOFjXQBB^RBdr1K2MsitIx~fKJbBdZx zWTZIwo4l;VletVLmyJ`Dpyq^AiL@dKS90=YCF)~!Of0BMN|c1$jMWjV!7Gv==Ca+Y za5BI_SVibBmV=<=1QbhRO-S-07RRELUJ@42Xl_9k%-#u^ zgqobCt|t`A&gxfZ6RO@dy}qoFNT+wUXY`t8T^Z`@yOdIA7cNFI%Dx3ToladGwB9L2 zS&)>zf&LQ%os1?{px+0N5A+`&95``wkTql0G?P=5=&UraCgyWuG%Kln^GowfdT_AM zsBG}a;0abrb5bhSoCoXaV_IDw^9VFga-L1*xJ;iBySxi8xsKAk6%h>-OG!qKj|oDY zdWVa+wA$?qW;3S+7A0B1K8vTaGdZoA+Kz9F@@EorIXRw5WplFT%A}HVP9ar6t3-Hs zu5UJ%k^1C$NtJVpn8m(iPL%r2rj%q~bWzGK_JMO4DlJ2-xq&_hR63+x_nx_{4$Ot#H$gOY7mTlE>-wl>%H<-F>vmB@Gox zG)FYs_g@A<`+kmu%Z^91-7;dYxv=AzJha=aVM+svzckikgsB%S5{4=IbtKSh3&n{#xO0wL9 zW@O@{+=4*!fzw7#t))z30G;X9k?G}Tbpg`rMLkqhxmQ5&a<34LMqk!K%EHAt zDX9*p)p3Z+jfwqc52ICnJM!#63~JM!=67s zc5d{f*8I%yRD66C+2bS6jE+1PADK9N7Ujl=&yH%<6O-}r35uFL2PKXAw16HpJvQ>( z=(HA|m>eCiXilr&5fL9hfA;Cob6Q~X+{E<6$ix}yjaFOv6(2b>Hab47`SqGn+u}gw z$DrmzoT2_SAIf97k*t(!hz}0Ug{Z}T&BI=Cix|+nRx>FM@Hxdj#UTJlpuqld6~d$e zra^KXZ7wWJ+x=BY3z8)(e$|pDfaV7Msx5DuGnOwaX9OY^s|mvADrJ?&y#_RRTBs{GDd?E|$qlu$*_Ak&xuVD(Q8n&r^but}HSW>3r!U31!jWAdE& zJy%`MYf@&JYc93cjGLo%y5q^aAUO@LDndms-PB9blXuOLa@_HlwIc`r=Pt7!uiBPu z5%2OZeI)Wm7~T<5Gr}ccj;t^PbRo&}G8Vm#HY7ARD+vTR(U$7DjA?+ zXg(n)GAv<;)ye8DXCtt3aY;o*IVLEgER#{HqP=qAQx%;+VTcF9Jb+pN%3=!OMd=li ziL7u@qRokQJC7gwc5w*^Dh&*!H!;54GM=mKFvE>Bnt4f*qYrIE8n@h5*%+EgWfv3a zlqjU7>?L(}NLb!ikwFneBoSU?NGvLhUY&>NL(?70d`GWv2`L>9Z5@$-OwdI0$kKc| zk(4x7I(J2qH3w?d0uT<*oH{=~5i`cTZp}&ap!qA#KalPjn5B)Vevye?{)fKtoY$h~66*sC>+-RNV%+!80 z2?fGfg>tmkg8VY_d$UavX4QFCXw=)S`q_LVq0 zV2^_fJjuj<(h@}&mj!#s)Mlc}t%A~@sY)orsWfHmF}J0>zbt^tLWfKy6Y^Yxh+C}g_HtWprEVN723Vj6J}#!;}K2v4|N~A zkiK<6fgZ4SE*O0w6AvOlNL;)qON%LHN$ZX7pUMeKxdkR0AQO^+Pr`+BqqJay24o&BWP$m!+>L@(hyy1%ApH0_@~^j;}6w8t;W$3Vh2)p6b^l zZ%y6xwBHNWy_vjmVolr#^{hII{?O_d?$zvmtMkT{o4eQBu)zmcM~dN^Ro|9>SHZdK zb2ihzL_2@*W_s#T+vId3ut-M7E`t*^c{xaQah?=A3qD`$=5zxh}q@HJqu z>s(p<0kt7Uf3~4E2)ME^RIR#Z9E&zt$vaomiRQ*$C{M^$fRenEeHH!gjMR@Wa89%gR%}?Gv#dUJ( zV`d$2FFVNX{MxYPKn^CzMKc0*Lr|KWjnFYOsY?qG9rzT6l4)orT_cxGJ6-FM@?hYX zJc{I75e(E4iH-~Trs4^QDsz^o`r6|l7iz=)G>mI zH3(H&1|zdV2MuV#a%Uw#W~gu-3e2W1%>wzBn_<4qi#c`HNA=J{D1lt0P|w5yXnTMG zQjh600|KPnO`nqCBsa!LrCB$bxgx=AApI>$^U%uZfM~%3;!!uT0&c-nW+7wxow{}X zY#1(&$grJfMrn&x=ooBi1Nfi~F)Ex#OEe&AEm}6gy9Eh&j?I^WV#xfVj4(|WV0O_^ zD!Y-mTG`JX-Ov;NZ*_yZG7hT;Ok{pyQO9<0vC~KsSvW_T?S|gV7y{Pmj=@IH4u5&< z?D@0tsq>SQ6X&K!Pj;Iwb7py3GjA@ePxHXSHsz6jX%Q#YhYYs3Uc%8ET`P~6oZ~X;MBRD@(xEZ~~YjNwh{`G)OK6lOH&DiuU8k1{+(FucW{d><0)j zG?0Wivlv9H2;0V}!C3b)I|r&5zz7))@&Yr%%Yx5vHt5n$-$vxVFs6d_Zb$|)lZGnJ zfmrnT^0AQw9p5CGtR>m{=xTEdDkWm`8kWg&OfP8K9wfPRQDVr;ZZ<~-%N{9X$hgrH zwr}e0<;yJEsz@Km4iQExfXP*u7_yYfEi$oY3VUI30E|Br6~@3YGK4-;(iz7v8c&k( zQchlCe);6(G~D57*$yqG)z0I{3_kL#h;z!zQarJs&Q71w!k49`bnX&-2XI5c9jpbx zyXQt&wV@n-3lbVIco5Y(Qdkhis^AwCwQuW!f@$FIqQ9A{P z#$QRuS%@1&a}uT1oHV36w)mIyBrUu{s>`RS{%~eHyEQ-7UffuC48}8KOn!=bG)%z| z1z$j*d5krsL;f5^1;(c0lP?%vTg}fz%@R4WCHQm5;}$oM^t5J^dc@JA78-_~m%6y1 z>Ri!0@aZtq&z@5>4^E&`GCa2PXcGQ=KdB^ReZVLr4-PZ<@~o4_ShU(lC@v#%2Mavd z%yc-a1yMwwR+?3X9I7Pt>Cul%>h+xxH$VkWN?1YpHRLSfr~Co{d4+p$%Es|E1<&q# zp@u@^^BbXa1^!&g&GEH24u7xZZr{^|rjd2e2x0bd#|RYWVclh+wMCY zwV@K{2!!U5Ercb_StWprAjAk zAMNfbHn;rR>teNrci-LJyAe9La(c_tRPgL8b{tvt{FHC|sH0c+MXh@7@@*Aq`1%#B zvT%_PZ}QFSIJG-{m*0y4?CUFZ9evZWS=D~0s{P%um9Z^PXyt3gn%Y&*79W1|3+sGq zC4~~+s=Kv&*ZIAx9-J6?tKNKUoo_=Hr~jK1uTH#vW!>5Ojfn>Vw6%Jr(0K5sy5Tuo z@H|!AcYylTSqi~6d~;-TSJ(Qkt~;Ktzf2cfyD6o)*xp5BXx(bxN8hbxe97r>1&h%^ zitMo}j@F#C2|od&f4;j%?lu z;?e`0QJM$qj20Or57sYH@}D3t2_ojgP_(eFj;swNe*@|AHz^a_0Oq3g8ztc6#NiUE zjg!v>NBE)^u#(`y(tK)K!2xj`FNHeG*0mYv>pM()rov+;|0(ia#G1ZOM-H&e1BJal8 zgXjBp(@I6UQ*q|Kiaqa_>%3e(_^8ts*s0#U-z;O}vaNZ3rKN1W=YyidvVy8mhviv8 ze~iaGbs!s5Zp`~u>MKu9ZlS;Q$o{g22PZs6EKY&!@_v-5MctOgtCye^FL`!o+8t|CZRlek}@n*+@9 zvDQA$VX-ic72hkA7cw1>=q^9<(h}%k^;(fB+$l*c>X=xeJ1!Y1L5h=(YJka>aDN3L z9LGTm@I78)WrxU1tXr3cv^QX^***a15IK-{TA2 zqq9})MW9=~fBGrZ4(U({b1|H$@i9V7*6k_q3;1`0MMQ$2!=kx5HMC0YqZvM&;g!dBft%RaAbHs0RTOdPT=s5tVeJq!J^E~ zQE8}^xvj4_19YWxz_7r7%KpeU!?{u;lm|A!Y`H|5Ip|4Qkl8{F8+wW64aaoy(mXr{ z+v>CUM8_i5(5(851ZuJFmyiuj`;DlBCW|kIN+?psY zyh8?QH6&;f>G^EjbZIF7+h-=n< z!9SpYP>W0lrt+H$G+nmp@{-Nftri{hJwG1Rol59=v;f|=B1woj&4yi=J)OV-M~p5a+)=N z?}@wozyqGE>ROw=dF=MH?}azQlPk{@{k1C-zkM*sRW;BRsjhoC_3i&o&su*Wu=jU> zn%=J8JvaaZVF&t*fCqnC`}9%n{pz}rTJHU$-jOQD`%eZ&{Ei>^U7&wZ>m6xx{Gio_ z@X?39{|r^&#KS-$?EHZ&UG`X*ry6(R=!|5?Q*jrLE8~GOZkn@BD9Q!PH$!k!4%f-c zDCzTa-!giL!(sdKe?19LW)i2NP}h)Cx|Fo^n0}`NG7D~svB|~5Bu4Q*DkMY^Ze!z~ z#Bdt7Per4i%4GOtn6o%W3To`6dH2UWGWT$$QQss&86RBaEtId!lrg!%;nNDL2q2*q${#A z9rNKb7jL$s5YG&2H2@irnm0Hg-$ueuX%`KHfQ<@6s^<0mZ;jsdbZpf&Uw`tAC)bW` z)b_0M_x#~E`Rk!KLN~5%RPDc0HGQ}D%Gr@aD1b8dc%Ld;5`57V^9mIla;=G zd6^S=groC*{7nKj{58PFynT^VY_IY3wF5G)Yuv8?Bx1U;)!;$K za7VGB`8Qsqu?)Y0Tx$7^gFXXXp!zpKlX}R6;A_5K$8}q;<8A!D?>gd1S_m9%(r#py z5XoIwLUwsj1*Jbq<*B80E9_NUd6&;s)@76`-yf?y+k-t|!wDOW91l*2ZFAO*Gd+$% zaB{sD&QWw@g)5Xx{pAq;ZwbsLUEC{$7#5vSaPmrRGJ+TJ+3m;@cl zRFHxCMXXDWy37^+mE0h3D6=kA|U4hsGU&D{iu74BE?Gt~S% z-273^{$kbBaIBEy#SRw<&w1-M`4j8>iFbSM@~3c{=f=sko||9W2tQfipWO1-Z~8md z{T*wE--QFGW5YjIaE`Gpf%EYuYUmIJbTX&a=(kPH8c7!w^5!FnGc! zhEZ7C45+X;hE^EGAdA&AnZ?mcdRVu;d9%9=)396&*f5IF&BGdlbNbL2!x`dPuG23@ zM9<*NK~AJ!WPfGxGUMPf`5bACQ|yY8F(~(@iF zxXb;**ejtj-O-K&^l4||DJ+eDj5@Jc3M82;wt(--U6g-Ui8i(T{4tsNc*HZqwix(o0&_3dp6 zn2_F0R67N22p;l}=~wffkUzwy4L_w5lLm-vv;8No<8L_s&p7YTxZuw?9}B}j=URWk zb**z<|BXBG3vO^LSiRyahHF;>#n#RO*IW$m0$J1Yddo^^tFHO_OK-fi*14wK9JyV4 zJ6Y&Bv0gV+;A-Hhu4}w8y|%cH>zjd+yV+J(+}%=g;JsC|x8%YbSsMFG9-?^8?Yr+K z>akjzyI9v)a^Sty(pGZejf_ouN*CCW#I{X_+*aFD28>89G~97C{M_04 zbEoiMoKHM}`?_iE#O={vb0FaU?(4@GZv4>(cc|p-v+enrGxQsK(B=LOX9o9)!k^YO zbgoR0)4p@PXR63I6yXx*{hNH#I^VR(x54YqJ{#Bh#$x;4&Gy0d_QB2e3-G`5T=k((IJc{A)mgH;ymcR*nJQK_-8c#5dDezw ziSBniw;i{a-rMz_yKv<6#{OsS1jb4(0e{7en?tU}~Hg<4roy8WR*wjk@_Z`6hQt-6hR$HuYE;)$U3hyqthyZs( zjU^8wc_O`x^l?plOMXTMh-9TP4EL`4VHP{>Q)&*|_@b|&ci+L; zt4nrD-TMcOqM_;k>nQ51QS93}iv3(OnBPWIj<922v9*IHK5~! zOXvMuRVz6K>a@Tvas|}=4$F(L#lExcDK@s@j(D+l_sW@KP4migdeF76;M}(|@p`)0 z)Ux4hC@9f9j zK|=a9r=6LddFP$?otyWWXZEkbAcr7D2d|EP*nrR%+?IhGj9Xu2w<<(4QvI-w?YC8P4AIFsfFru8wX?-X{m@v^4Ls;-DBesWA!`3X%? zPx3=UF9}}}lcJR27gaT*i)6Ic7j+r_-htDdU6O=hr1`Sje))>B2CPjCzcLU{48-Gu ziSGE|aAGh%oH)?iJ)HBxjKX$dN7C}v%E>55)N%mwc_gC|3YOkAO~G7|ZW-&!sFDlc&U!vKE`bDd^uBo6wb1Ow&?{ zhu2lePGc6PF|&H8Xk-hWMJ2Znhn)7L{nx@fLLPYFomzH5K95eK89I+NYMRQUaeEz1 zIXjbFSMAmrcit`0PeA(&12wnAtV1)NJTqRa-5KSnjPmBadDp1}U}B?gZ*K&fPxm^r zt7nPKzn`1)`5=P5_y5Q>I#V=oh^BA6p4lNl_Lnx5eY4|emrcXR+gX|e@e zyM<0+C&%%S#&kWqHx|<~nUp3dvOX$g@X6Sio=(N^Xp#)uWRGgMMv*}WA5a1&YmG?| z_8C-bt_?H*RI1bbq>_@7B9=5>QTb#QbNB;&Lp*_$y?l;&^>yL+ww!xPZEw%HUTd`) zTA|tnj{wg|G;A}*0QrLOs&9Vov z!3+L5f1&5L@2L`7cZYpyiG6C}=q+~h72lnfXO~)@y?*dkOE-+L1b?xAzV~A9!dS6> z>uq04WqeKZo%+~Pee4=@ZL(PZ{4L);kf~dDA5qMfbMBHaKxVV0rMLTU`!<(p=vwh0 zfAB)#F0OB1TGM`wSz5E}L;TUq2Qx)3KHFXLhb}xb_e|kf(ciS_ zZZZ#$q>T-*#t6CLG0%?kP?<-1<-8cLl_HXm0I@50Z?%xzL2M@iXIwQWfot4Xm2_%= zuiw)8Fs4T-@n>L6d`e8}7V{uMoEhbN2YAuq39=?wp-bZWnH@W}SHc>CTG+LhZ|>r; zJSt;ZP0G9?5k{g62Gcpb=%B$Gp2GNItav@UBzj&xM#6ZkHbyq=b^ zMp#d$V+gNk@RCXDvaYr9qAI}yf~GD~$d1TizvsZ~@N2?8<=6pZL>aYC^W1F_mZ&C&mH(x>9-{U=S})>9T72V>?`f zR6?^kBFY%7lC@_uI3=5K>K?4=Sjl1n{)UH899aS~(F3hd%gM1z~uja3AZ>e%%oS}g0y7JU%gj@8=_;C^# zkEA?sb=bNUnp5qrQmS)10SgLpt%ZKc< z@2sURdAG9$5@*s{L0|2xqvX$1ms}>1`4+0BH#%}UIkLhXB`v-=5`}?|HB7*jv_VAJ3!T5m()RsOY^e|9kaG!teALj&?#B9 zZo5sUcWE(;Nt{Jl!%cP;ZYIr7I-VqwV{-D8matqkFYK5c7lzN~keWejqH55m-n-OP;BTt z*8{{bvI_X>)@|=ky*IVEecz4d;#S~k!1@}2_4$}hbKE)l+!5eyg)KjSt`u%K_vWvE zaBa)=wYN6y|1{E23e;cdpX*26^EMGZxt8urnwy9MA)O`QN{>$;(^{rpCAX}zk=t>Cr{O9)kbf)meP4C*zLrs5g z>%1m?qk1sTIR;sCvW`e)Q!aAh9kw$(M8|UFGEd>8wQG@!;8Md|6J*zP@v&HaxsnfRyDlk zEi+Jippm=wg)S=If&Sd#KS=te4g*is4^7fvK95<9WV$VA{p6xxhHBqU4an1Ip41E3q*); zqbPL{4B1D-H$3h`mOYPYou$6Z8Ez^v+{BD%o#9O+q)gKKQZ+gO_zYjFFkvoM%#rJ} z;j!GngvMY(+Kr(3{jB>?y!*x8z8=F(zC2;VWek5JVY5`w^DG%)et&}V*NRdzG)(xh zK0pyt@WA(+^^xocco1G8WRUhN$l#x*s83PfKLUu_^aYB1hS<+g@NY=CN3(b6#+!8G z=WgL%sBzZ6;-M(EkXu1eKv+Dpw@mM%Hk5p;tg>mNRd(z$%X`e`Wd{0}vs8d;FK z+ofdjsH<~z5$SS;^Gkd&9#U@bbJ5S=*=10Sm^0fSNOi9el z#EB|PP-7mIqZ6Ov2!2z(F*x?h`Jv$Xp`i=G!J!Ld!3#rU`IZ`m!IQ&-V|i!rf~+P; z>?@&YLXI$BW|%PGDL%Xgu^YRAirb9LjI$C0EM~_!*(`0BOgGGT^~U48jj=IO7p9dz zsarDN;Kwb}4vD{E9=A$8k_B=>+9_Efw@JGsza&5lyR=*Cm23bxD6YOLJbQp?{J2vJ zNd1xnAQwP;B_}|2F!BH_F#cTcaFzXxH))?#cf&gFmi9|-7`GnsddM4O&s0xw#zg=y z9?*J92c?D^d~u%M+U=!7lBbLtUg0a#pEz?GST!wfFcg-`h-d=>O_uV*o}Pv z+-B5bT?(|LpwjjAC60M|JjHV?hnk$vDyA;L84H< zzdxZyqWyp!q+Q!pftmSycW^cojYuI?4welZ1f~bos1l6CFiQ@UZ@Iwd>Cy?5D?1>$ z&OG)q_07w#uDxS1d5cB>!CAtK5{+M;0&4<=FcJ?&AZUD%CQRBOQE-`X(~1OHnHPc}xDhoNOg5EIJzx|M zV4rD7sBpG+yz6?)^|pJ_{HE(+OMB^Mz55G`=8uHVoUa4w9P7T$HQ(-xZ+FgFfAj3p z*_8wD9)0WR2mK(y&Al6pso9RL3U?e&dVuj+x z?M-DI#pO1WVn&(w*^&1lA={ut+y2^=Y{4L$M!@}G(pNPnz5GS&fl_sy$+;UB9h-;4 ztpN?#jcx#NxG5x{>M^zwh!aD$LnW*{ACATq*>9p$<=LQun97(9M{g}=YsIIbt>Sc5q_ja^{Y(|NYN^JccT}g=L_RcKFrjU=KM;y0ZLe2LZtzRZogFG|njF=SB$1Lb4anx1>zs;zTrb zMSmQ73u&u(Hucy zE4T=-aE|)r<8K^(=;=src`55Topzpvt)TPeP}aRWE$r5~f~#jd#g+VHD1nvap1~E< z^)gea#Ek_L@T+)U7|7uqF+m$-5*$)L?!yl^e1b;JhVv zd0v$jau8k=oDm3*t_^L-bc&)%brj2A!A`jGt}_KE<7_B0@m$t(KJ7f8b2Ka-d)U;n z;`{cc#Z$o2oAXQaE521<*1an&?Ak17sD`MZdFbJtdWN7$>;hM^E=w#u$Sjys=2}dZ zI70}b4X>6CQ{E_Fu%x(@HuSD+fcP#0x{aNqcWj0se zw9;_PzRVYRrm?H@~0D3o=-K654wf8TGo7x5nhTXat;XgU^_wr2{#;aTs=HxmjP@^^@Rr z{(!v-hMnRrX$1+?=-VcV`(AP9zs^eL6g$f-SR@|vYplYtOv>V97OW|&Voq5U(@PAr zvd~t7WL>bOtb|Y5B%bbaTgpP;%-Wk;RNggLj7ixH9k5`B^+$=RdakikxQnVDNkIHz zQ<-aFx^9weaA24uJJnG2DvelT$0=u3cX-uX?t&$Cr-TYm++k?1*V&YPl!5uR!K_+T zG`Q$f%Z*6c;b$_Okp)L=KlE!Z>r*4PNqgwW81#TqH13x5s^Oee_DTuFlyZzRWqrH` zouxeG0PSl|@pp9&FF3)Bat4btN;%;eb%tQAwU7`htYYA1QdMWd(FoYY7)5}12)GVt z;L&i9W?P|25(iIRj)6H6LXj0;92+}tM?CmUgR6p$Gwm`bi+VuDh_OKUM-RVX|DLD!jx6}bh6iyWE;UM3*61mT&>kr>3w{7&%x zARV}ip2AcCx=cQfBDQ<@WjifPC;0Cba;FyUw48Uy0UcP z;`va7l)b~6$Yt*rQLT}@YYajy!{;tS@6s%waU9*I(F@B-&=n%Xn7o8F zR@98BnXLMHgOyFE00p5rM3mp7cto?Z7et$3Gv7p*xBxbNv(y|~)G zX#LpjduwM}=uEpia}C}V^K$#5CFk)%g~O9`HZChmBa1JT!w>7cH{(n36>0T_Y+c_X zhmMwG$+0GM+!s1l*^JQnKAuBB~p7{KMPzj5?oOWRsYAkz|{B`fS3$3AXs zedrU@ohP%tp>+LFuF<#n(kBkjt+|Iy&1+3PnWmmq<<8)})@;)kmri}`@|G75XPXW! zo%*D)ZE?ody40Z zGEPqo6x*jdTTHD$Pc1!d=**Ij%aPJSYDvV!`K7gR72l2sk|jXQl7o zmuc&JAneghsTFzKnV->5T>SQJ#) zlx9s>FlO;UXxC`fRXw!O9!jej;M+!EfONsz`+88oq3tLP98On+2OJRho{?n|mWi5d zsUW1R=5GL%9=s?Bj7<*^d`=q373__Tb<34R0Dk&le+RW2c-UWO)&)IIQa%(+^?$cC zB^$r&J z1?j_NQ*`ck%}yVLFX8Zp0B9&W6AQu@2{j&$M>o+*kk+n>ol?8!htRN^*#jB(!2g$g zG!@B;eb#*NP)u&GJ)iQ9KdmvHy&3o3tb1Qt*!TNipE`&$6IdNhFqBQ}GK=$Qubf9k zkAJK&0e{Br&$@flLhtW?0uBhh(?ENzJ$ntQuhhR~&3{&dbW}Fw0iK#F@-TG#ZBDO} zimX1r@^-K$)yT9A9}bLAGY__GLatElNt{P>9@IX|MBgeQNpT-3&Q^k-n*-?`^bZ%6r!E$FHI%-T-vfm3kNu;a`F1-~#s= zH_yJVLv!q$9{GFUq(%N9L{~I8X)u@g00DSVqi1MTJkP@+7K`UyP!JrtaN*pA;Ly2K z^kbJ1_N8%P8vA8s1r0OwRj8XnL+VwUs`8V=zd~~by(S3wnk+V7uCaNou{+b)y*l=z zOYdD;+i@_n+&9wD`b92wU zws-jc-rxve1IRyw)3f=_X!__x- z!7P~;_>`Ia3~~!>Kht%4in}hD;M=$1Wi0S9FO=D^3_?cw_JmTsB*hhjVmxe!8e6H> zck?24q4p-K`9-{V2@ZpN*Wsqtf;l#ovY>gPJ+;DibgN!`$|xuqRga3N2Yrfj6(DTY z0T^(HRy|XAZ?Eb}mC*@dvfBOdxTtyzp1|zPgnjd8DlRyErnVYTDOW`UhCrFVm#E4! zifbxOP^ilznYYu07v5`~$2C72I>p&FwQ%Le? z?(4eq;_(r@$awr@9zSK27hb$DJT^pd88tPG3qyu5IfOW<{ylN#+~8>pT9Fp4cmXSH zG}?|=8S)l&eg>mXN3jw&fZwKtrHcERd<(lcl*xD^Drt8cI0B(FB$NCZ)^QNLQt%rU zDslQ~n*14?egk?aO|U6JkJmBH?Te0FooA8zq^=d?DMJO5!zF@lUp}&Wa`nu|ZCl^& zxiy$;YF+*+z$@z8yKfDCg23unwr%(FAfRY$zP;zxo;6Q*#?zhk^ehhIU5C?4r`Md@ zGR|$Q+(*vtb+>nMA-A>bmLu2T!&6`&(>8FwVIb#gyM6W6)iqyF#@F-1g{<%3GWT(# z55MW0y>)iYyEEh6d53%8?OQiWdNbbMkGy*x?PuI=j}I{QKJ*vgIdZ2l>)w+V_WbAL zF2>t@`^c>$aPHtdytkjb_1q8luXP>HbRGWj;M$R~%#pG5_Lnn_FR!#TY6NIV8N9!AFec6y;8>Cz0NfPQTSJCnb}1kJW5c8HORDG@u-LppE190%9#JJ{eh zByfyT7!48_8texqY1iZ?a6C4@sbQXj*stI8DFaG-#Bb3)`hFL&;fbGYD0MYPMf6V` z7%@(X^iwbl`8IYyBEw@a5|J(sB#V3aHcw( zY*!O-+4K@{rca~^tism}M4HGYJK_GTdZ|{!VoNi56_7r0PDJByby64O(kkh)`yLKl zEs9U-k@yfHq4|oAC{-{IRDsD>ed>eop#$$jUb^(PKFS-7h1v$OXl=J_YD<{|9dK&Y zI?}|2l85pPVoOKq-_#R&z&DR7@&J>DQNu-d1gdB9SC~+&D2}l8M-0r{t1$-xfj+VP z;=4vzaWBvTfE_>pRsChS>G=ScOM^kYLKh6??ZF^?fk;FVb_RoAPlTd+jWrmQ;$bX? zTg-4dFhL)Xx)+-J(uJ>RMQNuMx=I8SAN*H#ffBgE{Msb& zLcz;eJdaE+zHWm9sDMzRhuPVi+u<)bn)n0j^;-%&n>Ok5}3B`f(;=%v#pD^ zg3BrPx(yeUZ3I}}yJ2DZCQP~?L$dd=h2wh*^~~1oxh7x1X6OCu^&JHsa=_ZqUa%r0 zz*iYs2UzVL8xAOY+#>MpkG&j!7&>?EC|LLLUZ@qjb6YxdTett(4e#r94Fw*{EsS@o z(V}rn!GUE?#O^||;rT>D;{ zuiJJ#;^7^c(^N141mkN>ADP%c?^Xt192z`5Jn}+bKO%$hHBXLV6k8#9_`(etymp5Qm7u+q=UG7}>)8B^{1s4cxNFHxOsI%giv1Jeh_-`|k-vo|=prd!g`~i-Ec**)`!5;W z&l%Ux89SuEV*1xP+Zxw=pKJbwx#!=_gTNOse89P08D34MJ0O0$@47SR-m*A*^R=bd aR$^caU3Y?8eckmN%W*Rsc*I~z`Sm||0>W%8@ebxgg>X8|`a=1ZLTkDe^|02Gj}+R{ZL*{X&-Mx6 z{@ZH7+}3=s(4KCWrGRuy(ju=*TALpJD9A^pV|wiDR)2=5r8~8#9@p9rp#iWJ(eA&| zI^_QnHN8iV+*_tt|+3`_;k4g6}1`?fL(vO5(Ygda!(@`D6EZS4}9hxkb z3wU?W>5iu7)Nak4b zm9m<5d%})+PA`5at^i}%U#(%eIFE7=)#I`ci$4^Y2JTu)y8JG3)+Rp&SrwoJ;w9!N9uolo;v>>rw z3+ecm3${s(|FpOkem$IS)w;Bn*F))u9!a<9QLS5ReLeIMX3>*w*JD}_#LaK%KufRI z*3i{?JKkM*$MEjfd$cWDN5jZovn*#v>e6dq2KQEQ5hFqNn&r(MPe8T7WJ$%elWRzM6q;L8-FsnKjBZG zcbrng+*3g4gj$5SSi>&larfOY$Z$`Cc$snJpWf?6o$ z^<>s8j1D!-Em=m<872rx8|SKQyL~4urKDT?TyV9`Wcm zkuUM>=tm3U;OoB<+9QgffgtCB{RtOex5ekOVXL!wuz7Y-v301D;+&%9^9=8jYT=+e zx`l0+%FN7^S=47{z8&I4Gvguw)CC%Xs|3hpD^(Lr{va&B;copku~`N)#kK(K9Tfsg z@<`A0yn+3jg;~fq=a7q-q82qKZGwQd0!EeS!D??+KBtXa~t zM$XW+5rv&hLeK;EEhZ7N_B>7~&=kYPe$-Ma56G^1Ai^EtT7ZcIG0yEuIg2IinGu-? zHlpP6rivF(qG3(EaCg+m4P7ay7mPx=pr{423<{VzPQhWL2&!U+W+#ZW3#uVhkP8M@ z(c7-dsY(M?OtXmesN3aiR>wA!lLdpzH#>tuwiUKrq2C(0v7YuWZ|y}J+!GpcL@8P3 zERN8kGDC3Z^7xe(y&i6YwzMHAO5K40^EwZa@`3J|pF=Ad!K7);jb?d$G-u@X(I@sl zHv70X_S9ofj(unJ1z1ZD%Fg`QV`JZ)$s|2+L~_0>l1M0X1IoS#lj?Dpw75?|#U-5G z#7?(A^^FWAk^A+zIjcJhx?Uu7z-ick^Zs#Qr_F?VWoF8DjgO}!yko_AeLn_!bXm{n zrjt&R!VbgNan}RY%w>+owC(%D2vK-)6=Is)!v{@j$)!~Zby_;Oz`*E%8{wlG}z43 z@zqQyXke(Av-%=Of%~?;;`4Z7GF>W;mvR!^gz9xS!gOlmZb(^S9p(gZWn&bx`LgCq z-@Gw5uS}deqd=EIy|SP7f?9%gB^z#;bFhwzRW25p&BRH=$OUv5re!#bQ2*!k{D_a9 zr9hvMN`mKyA0(|cu)^OvP0yp zwf^8Vk;Xguu=E5W3ndSo%ND~=ewci`iTZ3IMzM7Yns`s09w7z)ndu@&%JB&*4sKE* z&KFGE5%X-mX-`SoilrJhIVE~lEyMevH8^749_Qhg5^gp(nYxlQEI^!Hgr37WWHW?u zWK>FWyARV()71Qex@ddQXn0n&VdjmTZ#`@Wlq?X{L1O|8mRdL+M$RFf<(j4uOmI>6 z;K70&+%E=jWy}a^8FTPaM+gw%XqF*kjRa&m%2ChxRI_PK$ZEkTmK}0eOfZmBmaBXb zr@4VlE$#+vBC?svhIqiiN~#AXNnU#wm8;T{bk+?68^%aW2m(bkx+G=15%(D#)B+8o z-6&SNA8c6*HjD-?{LwHz<6*ieB|=lRR@VsCLL|{OM3p$TiEynub6(9G8p2!QWFjgR zW5XF5Y&{6DwayHjb;}Wbh+adsp3kvPi{fvKB72*brDJII&?E%7WG*wAO4l^kHc8P^ zpwZ8vxG2?Q(gWL92b0T#$r}rQ(Y7-9?B&ppI&Sqpu-gCVa{r?@j(og(rT;0kMg6wP zkDpxWf10(8?7tlPdE`MBsAfF^19Aj^j6oMsxhgqc-;(r^TR-cO7(?9W9mJ+!k4He! zE=lhMv;cZq{1#C|PY^w{;<^Vtp&v(1ONsDQrOgY*Dy^>5UWwqq5--NTk`v%Zh#WvG z1|ZgUDt1so4ERvC6ufLg+^4Rkm#k*$@|FuU^m`~SO1FEqTyg$r?`qE@%RP@&yLVqV zJ`Vk~UkauDQy%PNa~@%0ohY z?la(3z_dvUFG_cI@4I>6@bd1%H{;4me5e|k`g8#W--(AEhI-<$7c|9A6G9wL7hV#U7kpSFB!>+a!n5DC}91MZ1jD#*(bHoWohMdKzZ7E(P9^ zHLQ=a?Z;s;p5PD;J0*wZ_XwQhiC-?TOS1Z8sR2%q!3i-qVIPhrzZO`KE(CudEy#_q zex3P=sQPEv=ES_7JqLx00L#ZRJI3W*Nkkay+LX_yUDg1qn#q zGO~OY{2ZHtXn2a`&ruQ(xO$)nTt&A`77UW5W3i$z!W5f0ISOID2-L45oU%WeXkjX+7By_62>Vsc>a`H< zw-)soQVTPJ)!L?^dU=vJSPN$Jb}h^{SPPNR*`zwa0cO~&ZM204gi_jILtjI;{f{VM z+_p%u?#tuXCT~76w!CfZR`1~D7k<&+e?@%aXFbx= zHh4SMedUoKy-@FLZyUT7@4F`dVde8J%H0+zdGJri>fu0tYAqNV=&4Jg?w)#3>e^Z# zl)Cya$NuZy9;tilyQyk?_gyK}Hu!nZwtq|P`{QywD0e@>*JzRY2J5ZCj=_2m1OEHo zR;lZOZ#VWUdkc2-Vf*2@^ydSI$E45VI}aZWem1uK*`8pw(T|TdrKpQgE|TvAO`b z!rGi}q(bO%(@Y!(mX~PK94XSMsTnsEZAvF6*SW+qerk$?CY8tHR^Z_>jnl&0P|703 zmAXIe;3$wU$-K&hZ1tm#rv213jKU^a6CP%iQWqI^fGa)jf=R#aCp4aJFfK~>wn<$B z*N)xzotyEoYGiDqXG4Ao6WcT@O=2r;<|c0LB5v*;Lg)dR9wzjIWIu(_XHAGGrRf?h znoBW{WP*|imEj#a27(usvP5P9qCr`6N`y1@tE)(wiy*RyY#oVd4sO%@253S?O+_!V zD45Nq2#q2_1Bb?3Kxjs8|ETSlB?@=hT}M+U(_=TKSns6`IW z)yS!h!a(d|!cakl1$TI_e=fEA&LP4)&-ruQD_3dLSV1_(2+}-&5F4-VS4dbYe|4G| z&?Fw%TlU-tcV@IQu2XQ)AaW5aG(jJyX@#)a@NZ?-k!JuIxx&4&97Acq`t!8XsDw=wawe;;Ak8lyq z6HE@KsYFcd#k`wC*?gXenIXcm`Y;z^rq_5J0p&so%7uBB4|MNO1urSiA`TMeeZ|JE zAH7R9+y>)w2Sj1~(u@KYFD4@E%9ml+XhNwC7bzzwAj9{=92zPvvD_P~jVpUrZ-QU1 z3lP3Qiqq0~i|0C4LWI`)QX<6i&K7JR<$k#BqvS~~h~(u4NsYS#@1;uy#0u*=z5odO z1PbWFKFH^rsW(#9_U*TN2d<94HC~M=ciQ7`j=wQpZC9=z`QXI+CvJ{SF7KM8{?uEk zYHa&2;yqU$r?J;}eX#fay({s3)yTe$8q!Ox+yR&Gry(!>{^nxhcw$_ZtyeIH4#2wS zlD>I+)7;Y-<0VUc02fKDH-QPU_EI*Q?BE*@{$RAIHoVc=(eTr)3foSadh=DpArNnN zKsN%CE0 z2iq!7!RSQ~96qDL{kLJy(^m+HF5#%9W?ua^ZrcpM8JYEOJNUg%!^S<8^&;h>$d@B^ zyE&tTe%z?UHt48d&HjTLn>r*O320?;A+-pRV%DB~88|nL4PXopTzpl_GD?XE*Oe^C z%+luMNkU<&7p(80W{p#kpkjUO5F^fe%Ck=>&&JmOz&!geQ9yIDj7?QUwuhjd+it~(judu!mqtChDZ)vkwc_inlJ%DX$SY44qV z`|OR!S06pH{OFODM~^P=ILg!VD_c*m^iEe})3>l*`i*q8W9N;~pF}^5-b_8eJp4SH ze{I)$d*9xB-C5o9%<`URR`xu*y!F|Y-ic~#;!f|tYVYWB?G+DM+^+@VXCD z?I;yAkWJYzUBvcmgd69xdJ5`-zJuue`Jp8mmVnW!J5T58T?3 zthcp=58R1wtB3K1%=A1|Z>3s9LL2qfqf)eUtsS+sEpoUhQ_sM~V|T*ccLQ?xq`VfC zT6&O8L>1Fp(7GqwPmSGms@1rBrRT}z2YX29h<8!J1b7|MVOMCAG+g5`E z{~R3nJhbgzOHhtqIdV_J3wM-zpIl8GT236QN?p~S-7C_eJ6&6@#@~uxZ}}khe(c7X ek55$h9bQ(RUGAE=*zun&m7sj+u0$mx*8c*oiXis@ literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/urllib3/util/__pycache__/url.cpython-312.pyc b/.venv/lib/python3.12/site-packages/urllib3/util/__pycache__/url.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e1ebd1c298e7769ec9577be756ff7ec8481744ba GIT binary patch literal 16223 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 bool: # Platform-specific + """ + Returns True if the connection is dropped and should be closed. + :param conn: :class:`urllib3.connection.HTTPConnection` object. + """ + return not conn.is_connected + + +# This function is copied from socket.py in the Python 2.7 standard +# library test suite. Added to its signature is only `socket_options`. +# One additional modification is that we avoid binding to IPv6 servers +# discovered in DNS if the system doesn't have IPv6 functionality. +def create_connection( + address: tuple[str, int], + timeout: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT, + source_address: tuple[str, int] | None = None, + socket_options: _TYPE_SOCKET_OPTIONS | None = None, +) -> socket.socket: + """Connect to *address* and return the socket object. + + Convenience function. Connect to *address* (a 2-tuple ``(host, + port)``) and return the socket object. Passing the optional + *timeout* parameter will set the timeout on the socket instance + before attempting to connect. If no *timeout* is supplied, the + global default timeout setting returned by :func:`socket.getdefaulttimeout` + is used. If *source_address* is set it must be a tuple of (host, port) + for the socket to bind as a source address before making the connection. + An host of '' or port 0 tells the OS to use the default. + """ + + host, port = address + if host.startswith("["): + host = host.strip("[]") + err = None + + # Using the value from allowed_gai_family() in the context of getaddrinfo lets + # us select whether to work with IPv4 DNS records, IPv6 records, or both. + # The original create_connection function always returns all records. + family = allowed_gai_family() + + try: + host.encode("idna") + except UnicodeError: + raise LocationParseError(f"'{host}', label empty or too long") from None + + for res in socket.getaddrinfo(host, port, family, socket.SOCK_STREAM): + af, socktype, proto, canonname, sa = res + sock = None + try: + sock = socket.socket(af, socktype, proto) + + # If provided, set socket level options before connecting. + _set_socket_options(sock, socket_options) + + if timeout is not _DEFAULT_TIMEOUT: + sock.settimeout(timeout) + if source_address: + sock.bind(source_address) + sock.connect(sa) + # Break explicitly a reference cycle + err = None + return sock + + except OSError as _: + err = _ + if sock is not None: + sock.close() + + if err is not None: + try: + raise err + finally: + # Break explicitly a reference cycle + err = None + else: + raise OSError("getaddrinfo returns an empty list") + + +def _set_socket_options( + sock: socket.socket, options: _TYPE_SOCKET_OPTIONS | None +) -> None: + if options is None: + return + + for opt in options: + sock.setsockopt(*opt) + + +def allowed_gai_family() -> socket.AddressFamily: + """This function is designed to work in the context of + getaddrinfo, where family=socket.AF_UNSPEC is the default and + will perform a DNS search for both IPv6 and IPv4 records.""" + + family = socket.AF_INET + if HAS_IPV6: + family = socket.AF_UNSPEC + return family + + +def _has_ipv6(host: str) -> bool: + """Returns True if the system can bind an IPv6 address.""" + sock = None + has_ipv6 = False + + if socket.has_ipv6: + # has_ipv6 returns true if cPython was compiled with IPv6 support. + # It does not tell us if the system has IPv6 support enabled. To + # determine that we must bind to an IPv6 address. + # https://github.com/urllib3/urllib3/pull/611 + # https://bugs.python.org/issue658327 + try: + sock = socket.socket(socket.AF_INET6) + sock.bind((host, 0)) + has_ipv6 = True + except Exception: + pass + + if sock: + sock.close() + return has_ipv6 + + +HAS_IPV6 = _has_ipv6("::1") diff --git a/.venv/lib/python3.12/site-packages/urllib3/util/proxy.py b/.venv/lib/python3.12/site-packages/urllib3/util/proxy.py new file mode 100644 index 0000000..908fc66 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/urllib3/util/proxy.py @@ -0,0 +1,43 @@ +from __future__ import annotations + +import typing + +from .url import Url + +if typing.TYPE_CHECKING: + from ..connection import ProxyConfig + + +def connection_requires_http_tunnel( + proxy_url: Url | None = None, + proxy_config: ProxyConfig | None = None, + destination_scheme: str | None = None, +) -> bool: + """ + Returns True if the connection requires an HTTP CONNECT through the proxy. + + :param URL proxy_url: + URL of the proxy. + :param ProxyConfig proxy_config: + Proxy configuration from poolmanager.py + :param str destination_scheme: + The scheme of the destination. (i.e https, http, etc) + """ + # If we're not using a proxy, no way to use a tunnel. + if proxy_url is None: + return False + + # HTTP destinations never require tunneling, we always forward. + if destination_scheme == "http": + return False + + # Support for forwarding with HTTPS proxies and HTTPS destinations. + if ( + proxy_url.scheme == "https" + and proxy_config + and proxy_config.use_forwarding_for_https + ): + return False + + # Otherwise always use a tunnel. + return True diff --git a/.venv/lib/python3.12/site-packages/urllib3/util/request.py b/.venv/lib/python3.12/site-packages/urllib3/util/request.py new file mode 100644 index 0000000..859597e --- /dev/null +++ b/.venv/lib/python3.12/site-packages/urllib3/util/request.py @@ -0,0 +1,256 @@ +from __future__ import annotations + +import io +import typing +from base64 import b64encode +from enum import Enum + +from ..exceptions import UnrewindableBodyError +from .util import to_bytes + +if typing.TYPE_CHECKING: + from typing import Final + +# Pass as a value within ``headers`` to skip +# emitting some HTTP headers that are added automatically. +# The only headers that are supported are ``Accept-Encoding``, +# ``Host``, and ``User-Agent``. +SKIP_HEADER = "@@@SKIP_HEADER@@@" +SKIPPABLE_HEADERS = frozenset(["accept-encoding", "host", "user-agent"]) + +ACCEPT_ENCODING = "gzip,deflate" +try: + try: + import brotlicffi as _unused_module_brotli # type: ignore[import-not-found] # noqa: F401 + except ImportError: + import brotli as _unused_module_brotli # type: ignore[import-not-found] # noqa: F401 +except ImportError: + pass +else: + ACCEPT_ENCODING += ",br" +try: + import zstandard as _unused_module_zstd # noqa: F401 +except ImportError: + pass +else: + ACCEPT_ENCODING += ",zstd" + + +class _TYPE_FAILEDTELL(Enum): + token = 0 + + +_FAILEDTELL: Final[_TYPE_FAILEDTELL] = _TYPE_FAILEDTELL.token + +_TYPE_BODY_POSITION = typing.Union[int, _TYPE_FAILEDTELL] + +# When sending a request with these methods we aren't expecting +# a body so don't need to set an explicit 'Content-Length: 0' +# The reason we do this in the negative instead of tracking methods +# which 'should' have a body is because unknown methods should be +# treated as if they were 'POST' which *does* expect a body. +_METHODS_NOT_EXPECTING_BODY = {"GET", "HEAD", "DELETE", "TRACE", "OPTIONS", "CONNECT"} + + +def make_headers( + keep_alive: bool | None = None, + accept_encoding: bool | list[str] | str | None = None, + user_agent: str | None = None, + basic_auth: str | None = None, + proxy_basic_auth: str | None = None, + disable_cache: bool | None = None, +) -> dict[str, str]: + """ + Shortcuts for generating request headers. + + :param keep_alive: + If ``True``, adds 'connection: keep-alive' header. + + :param accept_encoding: + Can be a boolean, list, or string. + ``True`` translates to 'gzip,deflate'. If either the ``brotli`` or + ``brotlicffi`` package is installed 'gzip,deflate,br' is used instead. + List will get joined by comma. + String will be used as provided. + + :param user_agent: + String representing the user-agent you want, such as + "python-urllib3/0.6" + + :param basic_auth: + Colon-separated username:password string for 'authorization: basic ...' + auth header. + + :param proxy_basic_auth: + Colon-separated username:password string for 'proxy-authorization: basic ...' + auth header. + + :param disable_cache: + If ``True``, adds 'cache-control: no-cache' header. + + Example: + + .. code-block:: python + + import urllib3 + + print(urllib3.util.make_headers(keep_alive=True, user_agent="Batman/1.0")) + # {'connection': 'keep-alive', 'user-agent': 'Batman/1.0'} + print(urllib3.util.make_headers(accept_encoding=True)) + # {'accept-encoding': 'gzip,deflate'} + """ + headers: dict[str, str] = {} + if accept_encoding: + if isinstance(accept_encoding, str): + pass + elif isinstance(accept_encoding, list): + accept_encoding = ",".join(accept_encoding) + else: + accept_encoding = ACCEPT_ENCODING + headers["accept-encoding"] = accept_encoding + + if user_agent: + headers["user-agent"] = user_agent + + if keep_alive: + headers["connection"] = "keep-alive" + + if basic_auth: + headers[ + "authorization" + ] = f"Basic {b64encode(basic_auth.encode('latin-1')).decode()}" + + if proxy_basic_auth: + headers[ + "proxy-authorization" + ] = f"Basic {b64encode(proxy_basic_auth.encode('latin-1')).decode()}" + + if disable_cache: + headers["cache-control"] = "no-cache" + + return headers + + +def set_file_position( + body: typing.Any, pos: _TYPE_BODY_POSITION | None +) -> _TYPE_BODY_POSITION | None: + """ + If a position is provided, move file to that point. + Otherwise, we'll attempt to record a position for future use. + """ + if pos is not None: + rewind_body(body, pos) + elif getattr(body, "tell", None) is not None: + try: + pos = body.tell() + except OSError: + # This differentiates from None, allowing us to catch + # a failed `tell()` later when trying to rewind the body. + pos = _FAILEDTELL + + return pos + + +def rewind_body(body: typing.IO[typing.AnyStr], body_pos: _TYPE_BODY_POSITION) -> None: + """ + Attempt to rewind body to a certain position. + Primarily used for request redirects and retries. + + :param body: + File-like object that supports seek. + + :param int pos: + Position to seek to in file. + """ + body_seek = getattr(body, "seek", None) + if body_seek is not None and isinstance(body_pos, int): + try: + body_seek(body_pos) + except OSError as e: + raise UnrewindableBodyError( + "An error occurred when rewinding request body for redirect/retry." + ) from e + elif body_pos is _FAILEDTELL: + raise UnrewindableBodyError( + "Unable to record file position for rewinding " + "request body during a redirect/retry." + ) + else: + raise ValueError( + f"body_pos must be of type integer, instead it was {type(body_pos)}." + ) + + +class ChunksAndContentLength(typing.NamedTuple): + chunks: typing.Iterable[bytes] | None + content_length: int | None + + +def body_to_chunks( + body: typing.Any | None, method: str, blocksize: int +) -> ChunksAndContentLength: + """Takes the HTTP request method, body, and blocksize and + transforms them into an iterable of chunks to pass to + socket.sendall() and an optional 'Content-Length' header. + + A 'Content-Length' of 'None' indicates the length of the body + can't be determined so should use 'Transfer-Encoding: chunked' + for framing instead. + """ + + chunks: typing.Iterable[bytes] | None + content_length: int | None + + # No body, we need to make a recommendation on 'Content-Length' + # based on whether that request method is expected to have + # a body or not. + if body is None: + chunks = None + if method.upper() not in _METHODS_NOT_EXPECTING_BODY: + content_length = 0 + else: + content_length = None + + # Bytes or strings become bytes + elif isinstance(body, (str, bytes)): + chunks = (to_bytes(body),) + content_length = len(chunks[0]) + + # File-like object, TODO: use seek() and tell() for length? + elif hasattr(body, "read"): + + def chunk_readable() -> typing.Iterable[bytes]: + nonlocal body, blocksize + encode = isinstance(body, io.TextIOBase) + while True: + datablock = body.read(blocksize) + if not datablock: + break + if encode: + datablock = datablock.encode("iso-8859-1") + yield datablock + + chunks = chunk_readable() + content_length = None + + # Otherwise we need to start checking via duck-typing. + else: + try: + # Check if the body implements the buffer API. + mv = memoryview(body) + except TypeError: + try: + # Check if the body is an iterable + chunks = iter(body) + content_length = None + except TypeError: + raise TypeError( + f"'body' must be a bytes-like object, file-like " + f"object, or iterable. Instead was {body!r}" + ) from None + else: + # Since it implements the buffer API can be passed directly to socket.sendall() + chunks = (body,) + content_length = mv.nbytes + + return ChunksAndContentLength(chunks=chunks, content_length=content_length) diff --git a/.venv/lib/python3.12/site-packages/urllib3/util/response.py b/.venv/lib/python3.12/site-packages/urllib3/util/response.py new file mode 100644 index 0000000..0f45786 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/urllib3/util/response.py @@ -0,0 +1,101 @@ +from __future__ import annotations + +import http.client as httplib +from email.errors import MultipartInvariantViolationDefect, StartBoundaryNotFoundDefect + +from ..exceptions import HeaderParsingError + + +def is_fp_closed(obj: object) -> bool: + """ + Checks whether a given file-like object is closed. + + :param obj: + The file-like object to check. + """ + + try: + # Check `isclosed()` first, in case Python3 doesn't set `closed`. + # GH Issue #928 + return obj.isclosed() # type: ignore[no-any-return, attr-defined] + except AttributeError: + pass + + try: + # Check via the official file-like-object way. + return obj.closed # type: ignore[no-any-return, attr-defined] + except AttributeError: + pass + + try: + # Check if the object is a container for another file-like object that + # gets released on exhaustion (e.g. HTTPResponse). + return obj.fp is None # type: ignore[attr-defined] + except AttributeError: + pass + + raise ValueError("Unable to determine whether fp is closed.") + + +def assert_header_parsing(headers: httplib.HTTPMessage) -> None: + """ + Asserts whether all headers have been successfully parsed. + Extracts encountered errors from the result of parsing headers. + + Only works on Python 3. + + :param http.client.HTTPMessage headers: Headers to verify. + + :raises urllib3.exceptions.HeaderParsingError: + If parsing errors are found. + """ + + # This will fail silently if we pass in the wrong kind of parameter. + # To make debugging easier add an explicit check. + if not isinstance(headers, httplib.HTTPMessage): + raise TypeError(f"expected httplib.Message, got {type(headers)}.") + + unparsed_data = None + + # get_payload is actually email.message.Message.get_payload; + # we're only interested in the result if it's not a multipart message + if not headers.is_multipart(): + payload = headers.get_payload() + + if isinstance(payload, (bytes, str)): + unparsed_data = payload + + # httplib is assuming a response body is available + # when parsing headers even when httplib only sends + # header data to parse_headers() This results in + # defects on multipart responses in particular. + # See: https://github.com/urllib3/urllib3/issues/800 + + # So we ignore the following defects: + # - StartBoundaryNotFoundDefect: + # The claimed start boundary was never found. + # - MultipartInvariantViolationDefect: + # A message claimed to be a multipart but no subparts were found. + defects = [ + defect + for defect in headers.defects + if not isinstance( + defect, (StartBoundaryNotFoundDefect, MultipartInvariantViolationDefect) + ) + ] + + if defects or unparsed_data: + raise HeaderParsingError(defects=defects, unparsed_data=unparsed_data) + + +def is_response_to_head(response: httplib.HTTPResponse) -> bool: + """ + Checks whether the request of a response has been a HEAD-request. + + :param http.client.HTTPResponse response: + Response to check if the originating request + used 'HEAD' as a method. + """ + # FIXME: Can we do this somehow without accessing private httplib _method? + method_str = response._method # type: str # type: ignore[attr-defined] + return method_str.upper() == "HEAD" diff --git a/.venv/lib/python3.12/site-packages/urllib3/util/retry.py b/.venv/lib/python3.12/site-packages/urllib3/util/retry.py new file mode 100644 index 0000000..0456cce --- /dev/null +++ b/.venv/lib/python3.12/site-packages/urllib3/util/retry.py @@ -0,0 +1,533 @@ +from __future__ import annotations + +import email +import logging +import random +import re +import time +import typing +from itertools import takewhile +from types import TracebackType + +from ..exceptions import ( + ConnectTimeoutError, + InvalidHeader, + MaxRetryError, + ProtocolError, + ProxyError, + ReadTimeoutError, + ResponseError, +) +from .util import reraise + +if typing.TYPE_CHECKING: + from typing_extensions import Self + + from ..connectionpool import ConnectionPool + from ..response import BaseHTTPResponse + +log = logging.getLogger(__name__) + + +# Data structure for representing the metadata of requests that result in a retry. +class RequestHistory(typing.NamedTuple): + method: str | None + url: str | None + error: Exception | None + status: int | None + redirect_location: str | None + + +class Retry: + """Retry configuration. + + Each retry attempt will create a new Retry object with updated values, so + they can be safely reused. + + Retries can be defined as a default for a pool: + + .. code-block:: python + + retries = Retry(connect=5, read=2, redirect=5) + http = PoolManager(retries=retries) + response = http.request("GET", "https://example.com/") + + Or per-request (which overrides the default for the pool): + + .. code-block:: python + + response = http.request("GET", "https://example.com/", retries=Retry(10)) + + Retries can be disabled by passing ``False``: + + .. code-block:: python + + response = http.request("GET", "https://example.com/", retries=False) + + Errors will be wrapped in :class:`~urllib3.exceptions.MaxRetryError` unless + retries are disabled, in which case the causing exception will be raised. + + :param int total: + Total number of retries to allow. Takes precedence over other counts. + + Set to ``None`` to remove this constraint and fall back on other + counts. + + Set to ``0`` to fail on the first retry. + + Set to ``False`` to disable and imply ``raise_on_redirect=False``. + + :param int connect: + How many connection-related errors to retry on. + + These are errors raised before the request is sent to the remote server, + which we assume has not triggered the server to process the request. + + Set to ``0`` to fail on the first retry of this type. + + :param int read: + How many times to retry on read errors. + + These errors are raised after the request was sent to the server, so the + request may have side-effects. + + Set to ``0`` to fail on the first retry of this type. + + :param int redirect: + How many redirects to perform. Limit this to avoid infinite redirect + loops. + + A redirect is a HTTP response with a status code 301, 302, 303, 307 or + 308. + + Set to ``0`` to fail on the first retry of this type. + + Set to ``False`` to disable and imply ``raise_on_redirect=False``. + + :param int status: + How many times to retry on bad status codes. + + These are retries made on responses, where status code matches + ``status_forcelist``. + + Set to ``0`` to fail on the first retry of this type. + + :param int other: + How many times to retry on other errors. + + Other errors are errors that are not connect, read, redirect or status errors. + These errors might be raised after the request was sent to the server, so the + request might have side-effects. + + Set to ``0`` to fail on the first retry of this type. + + If ``total`` is not set, it's a good idea to set this to 0 to account + for unexpected edge cases and avoid infinite retry loops. + + :param Collection allowed_methods: + Set of uppercased HTTP method verbs that we should retry on. + + By default, we only retry on methods which are considered to be + idempotent (multiple requests with the same parameters end with the + same state). See :attr:`Retry.DEFAULT_ALLOWED_METHODS`. + + Set to a ``None`` value to retry on any verb. + + :param Collection status_forcelist: + A set of integer HTTP status codes that we should force a retry on. + A retry is initiated if the request method is in ``allowed_methods`` + and the response status code is in ``status_forcelist``. + + By default, this is disabled with ``None``. + + :param float backoff_factor: + A backoff factor to apply between attempts after the second try + (most errors are resolved immediately by a second try without a + delay). urllib3 will sleep for:: + + {backoff factor} * (2 ** ({number of previous retries})) + + seconds. If `backoff_jitter` is non-zero, this sleep is extended by:: + + random.uniform(0, {backoff jitter}) + + seconds. For example, if the backoff_factor is 0.1, then :func:`Retry.sleep` will + sleep for [0.0s, 0.2s, 0.4s, 0.8s, ...] between retries. No backoff will ever + be longer than `backoff_max`. + + By default, backoff is disabled (factor set to 0). + + :param bool raise_on_redirect: Whether, if the number of redirects is + exhausted, to raise a MaxRetryError, or to return a response with a + response code in the 3xx range. + + :param bool raise_on_status: Similar meaning to ``raise_on_redirect``: + whether we should raise an exception, or return a response, + if status falls in ``status_forcelist`` range and retries have + been exhausted. + + :param tuple history: The history of the request encountered during + each call to :meth:`~Retry.increment`. The list is in the order + the requests occurred. Each list item is of class :class:`RequestHistory`. + + :param bool respect_retry_after_header: + Whether to respect Retry-After header on status codes defined as + :attr:`Retry.RETRY_AFTER_STATUS_CODES` or not. + + :param Collection remove_headers_on_redirect: + Sequence of headers to remove from the request when a response + indicating a redirect is returned before firing off the redirected + request. + """ + + #: Default methods to be used for ``allowed_methods`` + DEFAULT_ALLOWED_METHODS = frozenset( + ["HEAD", "GET", "PUT", "DELETE", "OPTIONS", "TRACE"] + ) + + #: Default status codes to be used for ``status_forcelist`` + RETRY_AFTER_STATUS_CODES = frozenset([413, 429, 503]) + + #: Default headers to be used for ``remove_headers_on_redirect`` + DEFAULT_REMOVE_HEADERS_ON_REDIRECT = frozenset( + ["Cookie", "Authorization", "Proxy-Authorization"] + ) + + #: Default maximum backoff time. + DEFAULT_BACKOFF_MAX = 120 + + # Backward compatibility; assigned outside of the class. + DEFAULT: typing.ClassVar[Retry] + + def __init__( + self, + total: bool | int | None = 10, + connect: int | None = None, + read: int | None = None, + redirect: bool | int | None = None, + status: int | None = None, + other: int | None = None, + allowed_methods: typing.Collection[str] | None = DEFAULT_ALLOWED_METHODS, + status_forcelist: typing.Collection[int] | None = None, + backoff_factor: float = 0, + backoff_max: float = DEFAULT_BACKOFF_MAX, + raise_on_redirect: bool = True, + raise_on_status: bool = True, + history: tuple[RequestHistory, ...] | None = None, + respect_retry_after_header: bool = True, + remove_headers_on_redirect: typing.Collection[ + str + ] = DEFAULT_REMOVE_HEADERS_ON_REDIRECT, + backoff_jitter: float = 0.0, + ) -> None: + self.total = total + self.connect = connect + self.read = read + self.status = status + self.other = other + + if redirect is False or total is False: + redirect = 0 + raise_on_redirect = False + + self.redirect = redirect + self.status_forcelist = status_forcelist or set() + self.allowed_methods = allowed_methods + self.backoff_factor = backoff_factor + self.backoff_max = backoff_max + self.raise_on_redirect = raise_on_redirect + self.raise_on_status = raise_on_status + self.history = history or () + self.respect_retry_after_header = respect_retry_after_header + self.remove_headers_on_redirect = frozenset( + h.lower() for h in remove_headers_on_redirect + ) + self.backoff_jitter = backoff_jitter + + def new(self, **kw: typing.Any) -> Self: + params = dict( + total=self.total, + connect=self.connect, + read=self.read, + redirect=self.redirect, + status=self.status, + other=self.other, + allowed_methods=self.allowed_methods, + status_forcelist=self.status_forcelist, + backoff_factor=self.backoff_factor, + backoff_max=self.backoff_max, + raise_on_redirect=self.raise_on_redirect, + raise_on_status=self.raise_on_status, + history=self.history, + remove_headers_on_redirect=self.remove_headers_on_redirect, + respect_retry_after_header=self.respect_retry_after_header, + backoff_jitter=self.backoff_jitter, + ) + + params.update(kw) + return type(self)(**params) # type: ignore[arg-type] + + @classmethod + def from_int( + cls, + retries: Retry | bool | int | None, + redirect: bool | int | None = True, + default: Retry | bool | int | None = None, + ) -> Retry: + """Backwards-compatibility for the old retries format.""" + if retries is None: + retries = default if default is not None else cls.DEFAULT + + if isinstance(retries, Retry): + return retries + + redirect = bool(redirect) and None + new_retries = cls(retries, redirect=redirect) + log.debug("Converted retries value: %r -> %r", retries, new_retries) + return new_retries + + def get_backoff_time(self) -> float: + """Formula for computing the current backoff + + :rtype: float + """ + # We want to consider only the last consecutive errors sequence (Ignore redirects). + consecutive_errors_len = len( + list( + takewhile(lambda x: x.redirect_location is None, reversed(self.history)) + ) + ) + if consecutive_errors_len <= 1: + return 0 + + backoff_value = self.backoff_factor * (2 ** (consecutive_errors_len - 1)) + if self.backoff_jitter != 0.0: + backoff_value += random.random() * self.backoff_jitter + return float(max(0, min(self.backoff_max, backoff_value))) + + def parse_retry_after(self, retry_after: str) -> float: + seconds: float + # Whitespace: https://tools.ietf.org/html/rfc7230#section-3.2.4 + if re.match(r"^\s*[0-9]+\s*$", retry_after): + seconds = int(retry_after) + else: + retry_date_tuple = email.utils.parsedate_tz(retry_after) + if retry_date_tuple is None: + raise InvalidHeader(f"Invalid Retry-After header: {retry_after}") + + retry_date = email.utils.mktime_tz(retry_date_tuple) + seconds = retry_date - time.time() + + seconds = max(seconds, 0) + + return seconds + + def get_retry_after(self, response: BaseHTTPResponse) -> float | None: + """Get the value of Retry-After in seconds.""" + + retry_after = response.headers.get("Retry-After") + + if retry_after is None: + return None + + return self.parse_retry_after(retry_after) + + def sleep_for_retry(self, response: BaseHTTPResponse) -> bool: + retry_after = self.get_retry_after(response) + if retry_after: + time.sleep(retry_after) + return True + + return False + + def _sleep_backoff(self) -> None: + backoff = self.get_backoff_time() + if backoff <= 0: + return + time.sleep(backoff) + + def sleep(self, response: BaseHTTPResponse | None = None) -> None: + """Sleep between retry attempts. + + This method will respect a server's ``Retry-After`` response header + and sleep the duration of the time requested. If that is not present, it + will use an exponential backoff. By default, the backoff factor is 0 and + this method will return immediately. + """ + + if self.respect_retry_after_header and response: + slept = self.sleep_for_retry(response) + if slept: + return + + self._sleep_backoff() + + def _is_connection_error(self, err: Exception) -> bool: + """Errors when we're fairly sure that the server did not receive the + request, so it should be safe to retry. + """ + if isinstance(err, ProxyError): + err = err.original_error + return isinstance(err, ConnectTimeoutError) + + def _is_read_error(self, err: Exception) -> bool: + """Errors that occur after the request has been started, so we should + assume that the server began processing it. + """ + return isinstance(err, (ReadTimeoutError, ProtocolError)) + + def _is_method_retryable(self, method: str) -> bool: + """Checks if a given HTTP method should be retried upon, depending if + it is included in the allowed_methods + """ + if self.allowed_methods and method.upper() not in self.allowed_methods: + return False + return True + + def is_retry( + self, method: str, status_code: int, has_retry_after: bool = False + ) -> bool: + """Is this method/status code retryable? (Based on allowlists and control + variables such as the number of total retries to allow, whether to + respect the Retry-After header, whether this header is present, and + whether the returned status code is on the list of status codes to + be retried upon on the presence of the aforementioned header) + """ + if not self._is_method_retryable(method): + return False + + if self.status_forcelist and status_code in self.status_forcelist: + return True + + return bool( + self.total + and self.respect_retry_after_header + and has_retry_after + and (status_code in self.RETRY_AFTER_STATUS_CODES) + ) + + def is_exhausted(self) -> bool: + """Are we out of retries?""" + retry_counts = [ + x + for x in ( + self.total, + self.connect, + self.read, + self.redirect, + self.status, + self.other, + ) + if x + ] + if not retry_counts: + return False + + return min(retry_counts) < 0 + + def increment( + self, + method: str | None = None, + url: str | None = None, + response: BaseHTTPResponse | None = None, + error: Exception | None = None, + _pool: ConnectionPool | None = None, + _stacktrace: TracebackType | None = None, + ) -> Self: + """Return a new Retry object with incremented retry counters. + + :param response: A response object, or None, if the server did not + return a response. + :type response: :class:`~urllib3.response.BaseHTTPResponse` + :param Exception error: An error encountered during the request, or + None if the response was received successfully. + + :return: A new ``Retry`` object. + """ + if self.total is False and error: + # Disabled, indicate to re-raise the error. + raise reraise(type(error), error, _stacktrace) + + total = self.total + if total is not None: + total -= 1 + + connect = self.connect + read = self.read + redirect = self.redirect + status_count = self.status + other = self.other + cause = "unknown" + status = None + redirect_location = None + + if error and self._is_connection_error(error): + # Connect retry? + if connect is False: + raise reraise(type(error), error, _stacktrace) + elif connect is not None: + connect -= 1 + + elif error and self._is_read_error(error): + # Read retry? + if read is False or method is None or not self._is_method_retryable(method): + raise reraise(type(error), error, _stacktrace) + elif read is not None: + read -= 1 + + elif error: + # Other retry? + if other is not None: + other -= 1 + + elif response and response.get_redirect_location(): + # Redirect retry? + if redirect is not None: + redirect -= 1 + cause = "too many redirects" + response_redirect_location = response.get_redirect_location() + if response_redirect_location: + redirect_location = response_redirect_location + status = response.status + + else: + # Incrementing because of a server error like a 500 in + # status_forcelist and the given method is in the allowed_methods + cause = ResponseError.GENERIC_ERROR + if response and response.status: + if status_count is not None: + status_count -= 1 + cause = ResponseError.SPECIFIC_ERROR.format(status_code=response.status) + status = response.status + + history = self.history + ( + RequestHistory(method, url, error, status, redirect_location), + ) + + new_retry = self.new( + total=total, + connect=connect, + read=read, + redirect=redirect, + status=status_count, + other=other, + history=history, + ) + + if new_retry.is_exhausted(): + reason = error or ResponseError(cause) + raise MaxRetryError(_pool, url, reason) from reason # type: ignore[arg-type] + + log.debug("Incremented Retry for (url='%s'): %r", url, new_retry) + + return new_retry + + def __repr__(self) -> str: + return ( + f"{type(self).__name__}(total={self.total}, connect={self.connect}, " + f"read={self.read}, redirect={self.redirect}, status={self.status})" + ) + + +# For backwards compatibility (equivalent to pre-v1.9): +Retry.DEFAULT = Retry(3) diff --git a/.venv/lib/python3.12/site-packages/urllib3/util/ssl_.py b/.venv/lib/python3.12/site-packages/urllib3/util/ssl_.py new file mode 100644 index 0000000..c46dd83 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/urllib3/util/ssl_.py @@ -0,0 +1,509 @@ +from __future__ import annotations + +import hmac +import os +import socket +import sys +import typing +import warnings +from binascii import unhexlify +from hashlib import md5, sha1, sha256 + +from ..exceptions import ProxySchemeUnsupported, SSLError +from .url import _BRACELESS_IPV6_ADDRZ_RE, _IPV4_RE + +SSLContext = None +SSLTransport = None +HAS_NEVER_CHECK_COMMON_NAME = False +IS_PYOPENSSL = False +ALPN_PROTOCOLS = ["http/1.1"] + +_TYPE_VERSION_INFO = typing.Tuple[int, int, int, str, int] + +# Maps the length of a digest to a possible hash function producing this digest +HASHFUNC_MAP = {32: md5, 40: sha1, 64: sha256} + + +def _is_bpo_43522_fixed( + implementation_name: str, + version_info: _TYPE_VERSION_INFO, + pypy_version_info: _TYPE_VERSION_INFO | None, +) -> bool: + """Return True for CPython 3.8.9+, 3.9.3+ or 3.10+ and PyPy 7.3.8+ where + setting SSLContext.hostname_checks_common_name to False works. + + Outside of CPython and PyPy we don't know which implementations work + or not so we conservatively use our hostname matching as we know that works + on all implementations. + + https://github.com/urllib3/urllib3/issues/2192#issuecomment-821832963 + https://foss.heptapod.net/pypy/pypy/-/issues/3539 + """ + if implementation_name == "pypy": + # https://foss.heptapod.net/pypy/pypy/-/issues/3129 + return pypy_version_info >= (7, 3, 8) # type: ignore[operator] + elif implementation_name == "cpython": + major_minor = version_info[:2] + micro = version_info[2] + return ( + (major_minor == (3, 8) and micro >= 9) + or (major_minor == (3, 9) and micro >= 3) + or major_minor >= (3, 10) + ) + else: # Defensive: + return False + + +def _is_has_never_check_common_name_reliable( + openssl_version: str, + openssl_version_number: int, + implementation_name: str, + version_info: _TYPE_VERSION_INFO, + pypy_version_info: _TYPE_VERSION_INFO | None, +) -> bool: + # As of May 2023, all released versions of LibreSSL fail to reject certificates with + # only common names, see https://github.com/urllib3/urllib3/pull/3024 + is_openssl = openssl_version.startswith("OpenSSL ") + # Before fixing OpenSSL issue #14579, the SSL_new() API was not copying hostflags + # like X509_CHECK_FLAG_NEVER_CHECK_SUBJECT, which tripped up CPython. + # https://github.com/openssl/openssl/issues/14579 + # This was released in OpenSSL 1.1.1l+ (>=0x101010cf) + is_openssl_issue_14579_fixed = openssl_version_number >= 0x101010CF + + return is_openssl and ( + is_openssl_issue_14579_fixed + or _is_bpo_43522_fixed(implementation_name, version_info, pypy_version_info) + ) + + +if typing.TYPE_CHECKING: + from ssl import VerifyMode + from typing import TypedDict + + from .ssltransport import SSLTransport as SSLTransportType + + class _TYPE_PEER_CERT_RET_DICT(TypedDict, total=False): + subjectAltName: tuple[tuple[str, str], ...] + subject: tuple[tuple[tuple[str, str], ...], ...] + serialNumber: str + + +# Mapping from 'ssl.PROTOCOL_TLSX' to 'TLSVersion.X' +_SSL_VERSION_TO_TLS_VERSION: dict[int, int] = {} + +try: # Do we have ssl at all? + import ssl + from ssl import ( # type: ignore[assignment] + CERT_REQUIRED, + HAS_NEVER_CHECK_COMMON_NAME, + OP_NO_COMPRESSION, + OP_NO_TICKET, + OPENSSL_VERSION, + OPENSSL_VERSION_NUMBER, + PROTOCOL_TLS, + PROTOCOL_TLS_CLIENT, + OP_NO_SSLv2, + OP_NO_SSLv3, + SSLContext, + TLSVersion, + ) + + PROTOCOL_SSLv23 = PROTOCOL_TLS + + # Setting SSLContext.hostname_checks_common_name = False didn't work before CPython + # 3.8.9, 3.9.3, and 3.10 (but OK on PyPy) or OpenSSL 1.1.1l+ + if HAS_NEVER_CHECK_COMMON_NAME and not _is_has_never_check_common_name_reliable( + OPENSSL_VERSION, + OPENSSL_VERSION_NUMBER, + sys.implementation.name, + sys.version_info, + sys.pypy_version_info if sys.implementation.name == "pypy" else None, # type: ignore[attr-defined] + ): + HAS_NEVER_CHECK_COMMON_NAME = False + + # Need to be careful here in case old TLS versions get + # removed in future 'ssl' module implementations. + for attr in ("TLSv1", "TLSv1_1", "TLSv1_2"): + try: + _SSL_VERSION_TO_TLS_VERSION[getattr(ssl, f"PROTOCOL_{attr}")] = getattr( + TLSVersion, attr + ) + except AttributeError: # Defensive: + continue + + from .ssltransport import SSLTransport # type: ignore[assignment] +except ImportError: + OP_NO_COMPRESSION = 0x20000 # type: ignore[assignment] + OP_NO_TICKET = 0x4000 # type: ignore[assignment] + OP_NO_SSLv2 = 0x1000000 # type: ignore[assignment] + OP_NO_SSLv3 = 0x2000000 # type: ignore[assignment] + PROTOCOL_SSLv23 = PROTOCOL_TLS = 2 # type: ignore[assignment] + PROTOCOL_TLS_CLIENT = 16 # type: ignore[assignment] + + +_TYPE_PEER_CERT_RET = typing.Union["_TYPE_PEER_CERT_RET_DICT", bytes, None] + + +def assert_fingerprint(cert: bytes | None, fingerprint: str) -> None: + """ + Checks if given fingerprint matches the supplied certificate. + + :param cert: + Certificate as bytes object. + :param fingerprint: + Fingerprint as string of hexdigits, can be interspersed by colons. + """ + + if cert is None: + raise SSLError("No certificate for the peer.") + + fingerprint = fingerprint.replace(":", "").lower() + digest_length = len(fingerprint) + hashfunc = HASHFUNC_MAP.get(digest_length) + if not hashfunc: + raise SSLError(f"Fingerprint of invalid length: {fingerprint}") + + # We need encode() here for py32; works on py2 and p33. + fingerprint_bytes = unhexlify(fingerprint.encode()) + + cert_digest = hashfunc(cert).digest() + + if not hmac.compare_digest(cert_digest, fingerprint_bytes): + raise SSLError( + f'Fingerprints did not match. Expected "{fingerprint}", got "{cert_digest.hex()}"' + ) + + +def resolve_cert_reqs(candidate: None | int | str) -> VerifyMode: + """ + Resolves the argument to a numeric constant, which can be passed to + the wrap_socket function/method from the ssl module. + Defaults to :data:`ssl.CERT_REQUIRED`. + If given a string it is assumed to be the name of the constant in the + :mod:`ssl` module or its abbreviation. + (So you can specify `REQUIRED` instead of `CERT_REQUIRED`. + If it's neither `None` nor a string we assume it is already the numeric + constant which can directly be passed to wrap_socket. + """ + if candidate is None: + return CERT_REQUIRED + + if isinstance(candidate, str): + res = getattr(ssl, candidate, None) + if res is None: + res = getattr(ssl, "CERT_" + candidate) + return res # type: ignore[no-any-return] + + return candidate # type: ignore[return-value] + + +def resolve_ssl_version(candidate: None | int | str) -> int: + """ + like resolve_cert_reqs + """ + if candidate is None: + return PROTOCOL_TLS + + if isinstance(candidate, str): + res = getattr(ssl, candidate, None) + if res is None: + res = getattr(ssl, "PROTOCOL_" + candidate) + return typing.cast(int, res) + + return candidate + + +def create_urllib3_context( + ssl_version: int | None = None, + cert_reqs: int | None = None, + options: int | None = None, + ciphers: str | None = None, + ssl_minimum_version: int | None = None, + ssl_maximum_version: int | None = None, +) -> ssl.SSLContext: + """Creates and configures an :class:`ssl.SSLContext` instance for use with urllib3. + + :param ssl_version: + The desired protocol version to use. This will default to + PROTOCOL_SSLv23 which will negotiate the highest protocol that both + the server and your installation of OpenSSL support. + + This parameter is deprecated instead use 'ssl_minimum_version'. + :param ssl_minimum_version: + The minimum version of TLS to be used. Use the 'ssl.TLSVersion' enum for specifying the value. + :param ssl_maximum_version: + The maximum version of TLS to be used. Use the 'ssl.TLSVersion' enum for specifying the value. + Not recommended to set to anything other than 'ssl.TLSVersion.MAXIMUM_SUPPORTED' which is the + default value. + :param cert_reqs: + Whether to require the certificate verification. This defaults to + ``ssl.CERT_REQUIRED``. + :param options: + Specific OpenSSL options. These default to ``ssl.OP_NO_SSLv2``, + ``ssl.OP_NO_SSLv3``, ``ssl.OP_NO_COMPRESSION``, and ``ssl.OP_NO_TICKET``. + :param ciphers: + Which cipher suites to allow the server to select. Defaults to either system configured + ciphers if OpenSSL 1.1.1+, otherwise uses a secure default set of ciphers. + :returns: + Constructed SSLContext object with specified options + :rtype: SSLContext + """ + if SSLContext is None: + raise TypeError("Can't create an SSLContext object without an ssl module") + + # This means 'ssl_version' was specified as an exact value. + if ssl_version not in (None, PROTOCOL_TLS, PROTOCOL_TLS_CLIENT): + # Disallow setting 'ssl_version' and 'ssl_minimum|maximum_version' + # to avoid conflicts. + if ssl_minimum_version is not None or ssl_maximum_version is not None: + raise ValueError( + "Can't specify both 'ssl_version' and either " + "'ssl_minimum_version' or 'ssl_maximum_version'" + ) + + # 'ssl_version' is deprecated and will be removed in the future. + else: + # Use 'ssl_minimum_version' and 'ssl_maximum_version' instead. + ssl_minimum_version = _SSL_VERSION_TO_TLS_VERSION.get( + ssl_version, TLSVersion.MINIMUM_SUPPORTED + ) + ssl_maximum_version = _SSL_VERSION_TO_TLS_VERSION.get( + ssl_version, TLSVersion.MAXIMUM_SUPPORTED + ) + + # This warning message is pushing users to use 'ssl_minimum_version' + # instead of both min/max. Best practice is to only set the minimum version and + # keep the maximum version to be it's default value: 'TLSVersion.MAXIMUM_SUPPORTED' + warnings.warn( + "'ssl_version' option is deprecated and will be " + "removed in urllib3 v2.1.0. Instead use 'ssl_minimum_version'", + category=DeprecationWarning, + stacklevel=2, + ) + + # PROTOCOL_TLS is deprecated in Python 3.10 so we always use PROTOCOL_TLS_CLIENT + context = SSLContext(PROTOCOL_TLS_CLIENT) + + if ssl_minimum_version is not None: + context.minimum_version = ssl_minimum_version + else: # Python <3.10 defaults to 'MINIMUM_SUPPORTED' so explicitly set TLSv1.2 here + context.minimum_version = TLSVersion.TLSv1_2 + + if ssl_maximum_version is not None: + context.maximum_version = ssl_maximum_version + + # Unless we're given ciphers defer to either system ciphers in + # the case of OpenSSL 1.1.1+ or use our own secure default ciphers. + if ciphers: + context.set_ciphers(ciphers) + + # Setting the default here, as we may have no ssl module on import + cert_reqs = ssl.CERT_REQUIRED if cert_reqs is None else cert_reqs + + if options is None: + options = 0 + # SSLv2 is easily broken and is considered harmful and dangerous + options |= OP_NO_SSLv2 + # SSLv3 has several problems and is now dangerous + options |= OP_NO_SSLv3 + # Disable compression to prevent CRIME attacks for OpenSSL 1.0+ + # (issue #309) + options |= OP_NO_COMPRESSION + # TLSv1.2 only. Unless set explicitly, do not request tickets. + # This may save some bandwidth on wire, and although the ticket is encrypted, + # there is a risk associated with it being on wire, + # if the server is not rotating its ticketing keys properly. + options |= OP_NO_TICKET + + context.options |= options + + # Enable post-handshake authentication for TLS 1.3, see GH #1634. PHA is + # necessary for conditional client cert authentication with TLS 1.3. + # The attribute is None for OpenSSL <= 1.1.0 or does not exist when using + # an SSLContext created by pyOpenSSL. + if getattr(context, "post_handshake_auth", None) is not None: + context.post_handshake_auth = True + + # The order of the below lines setting verify_mode and check_hostname + # matter due to safe-guards SSLContext has to prevent an SSLContext with + # check_hostname=True, verify_mode=NONE/OPTIONAL. + # We always set 'check_hostname=False' for pyOpenSSL so we rely on our own + # 'ssl.match_hostname()' implementation. + if cert_reqs == ssl.CERT_REQUIRED and not IS_PYOPENSSL: + context.verify_mode = cert_reqs + context.check_hostname = True + else: + context.check_hostname = False + context.verify_mode = cert_reqs + + try: + context.hostname_checks_common_name = False + except AttributeError: # Defensive: for CPython < 3.8.9 and 3.9.3; for PyPy < 7.3.8 + pass + + # Enable logging of TLS session keys via defacto standard environment variable + # 'SSLKEYLOGFILE', if the feature is available (Python 3.8+). Skip empty values. + if hasattr(context, "keylog_filename"): + sslkeylogfile = os.environ.get("SSLKEYLOGFILE") + if sslkeylogfile: + context.keylog_filename = sslkeylogfile + + return context + + +@typing.overload +def ssl_wrap_socket( + sock: socket.socket, + keyfile: str | None = ..., + certfile: str | None = ..., + cert_reqs: int | None = ..., + ca_certs: str | None = ..., + server_hostname: str | None = ..., + ssl_version: int | None = ..., + ciphers: str | None = ..., + ssl_context: ssl.SSLContext | None = ..., + ca_cert_dir: str | None = ..., + key_password: str | None = ..., + ca_cert_data: None | str | bytes = ..., + tls_in_tls: typing.Literal[False] = ..., +) -> ssl.SSLSocket: + ... + + +@typing.overload +def ssl_wrap_socket( + sock: socket.socket, + keyfile: str | None = ..., + certfile: str | None = ..., + cert_reqs: int | None = ..., + ca_certs: str | None = ..., + server_hostname: str | None = ..., + ssl_version: int | None = ..., + ciphers: str | None = ..., + ssl_context: ssl.SSLContext | None = ..., + ca_cert_dir: str | None = ..., + key_password: str | None = ..., + ca_cert_data: None | str | bytes = ..., + tls_in_tls: bool = ..., +) -> ssl.SSLSocket | SSLTransportType: + ... + + +def ssl_wrap_socket( + sock: socket.socket, + keyfile: str | None = None, + certfile: str | None = None, + cert_reqs: int | None = None, + ca_certs: str | None = None, + server_hostname: str | None = None, + ssl_version: int | None = None, + ciphers: str | None = None, + ssl_context: ssl.SSLContext | None = None, + ca_cert_dir: str | None = None, + key_password: str | None = None, + ca_cert_data: None | str | bytes = None, + tls_in_tls: bool = False, +) -> ssl.SSLSocket | SSLTransportType: + """ + All arguments except for server_hostname, ssl_context, tls_in_tls, ca_cert_data and + ca_cert_dir have the same meaning as they do when using + :func:`ssl.create_default_context`, :meth:`ssl.SSLContext.load_cert_chain`, + :meth:`ssl.SSLContext.set_ciphers` and :meth:`ssl.SSLContext.wrap_socket`. + + :param server_hostname: + When SNI is supported, the expected hostname of the certificate + :param ssl_context: + A pre-made :class:`SSLContext` object. If none is provided, one will + be created using :func:`create_urllib3_context`. + :param ciphers: + A string of ciphers we wish the client to support. + :param ca_cert_dir: + A directory containing CA certificates in multiple separate files, as + supported by OpenSSL's -CApath flag or the capath argument to + SSLContext.load_verify_locations(). + :param key_password: + Optional password if the keyfile is encrypted. + :param ca_cert_data: + Optional string containing CA certificates in PEM format suitable for + passing as the cadata parameter to SSLContext.load_verify_locations() + :param tls_in_tls: + Use SSLTransport to wrap the existing socket. + """ + context = ssl_context + if context is None: + # Note: This branch of code and all the variables in it are only used in tests. + # We should consider deprecating and removing this code. + context = create_urllib3_context(ssl_version, cert_reqs, ciphers=ciphers) + + if ca_certs or ca_cert_dir or ca_cert_data: + try: + context.load_verify_locations(ca_certs, ca_cert_dir, ca_cert_data) + except OSError as e: + raise SSLError(e) from e + + elif ssl_context is None and hasattr(context, "load_default_certs"): + # try to load OS default certs; works well on Windows. + context.load_default_certs() + + # Attempt to detect if we get the goofy behavior of the + # keyfile being encrypted and OpenSSL asking for the + # passphrase via the terminal and instead error out. + if keyfile and key_password is None and _is_key_file_encrypted(keyfile): + raise SSLError("Client private key is encrypted, password is required") + + if certfile: + if key_password is None: + context.load_cert_chain(certfile, keyfile) + else: + context.load_cert_chain(certfile, keyfile, key_password) + + try: + context.set_alpn_protocols(ALPN_PROTOCOLS) + except NotImplementedError: # Defensive: in CI, we always have set_alpn_protocols + pass + + ssl_sock = _ssl_wrap_socket_impl(sock, context, tls_in_tls, server_hostname) + return ssl_sock + + +def is_ipaddress(hostname: str | bytes) -> bool: + """Detects whether the hostname given is an IPv4 or IPv6 address. + Also detects IPv6 addresses with Zone IDs. + + :param str hostname: Hostname to examine. + :return: True if the hostname is an IP address, False otherwise. + """ + if isinstance(hostname, bytes): + # IDN A-label bytes are ASCII compatible. + hostname = hostname.decode("ascii") + return bool(_IPV4_RE.match(hostname) or _BRACELESS_IPV6_ADDRZ_RE.match(hostname)) + + +def _is_key_file_encrypted(key_file: str) -> bool: + """Detects if a key file is encrypted or not.""" + with open(key_file) as f: + for line in f: + # Look for Proc-Type: 4,ENCRYPTED + if "ENCRYPTED" in line: + return True + + return False + + +def _ssl_wrap_socket_impl( + sock: socket.socket, + ssl_context: ssl.SSLContext, + tls_in_tls: bool, + server_hostname: str | None = None, +) -> ssl.SSLSocket | SSLTransportType: + if tls_in_tls: + if not SSLTransport: + # Import error, ssl is not available. + raise ProxySchemeUnsupported( + "TLS in TLS requires support for the 'ssl' module" + ) + + SSLTransport._validate_ssl_context_for_tls_in_tls(ssl_context) + return SSLTransport(sock, ssl_context, server_hostname) + + return ssl_context.wrap_socket(sock, server_hostname=server_hostname) diff --git a/.venv/lib/python3.12/site-packages/urllib3/util/ssl_match_hostname.py b/.venv/lib/python3.12/site-packages/urllib3/util/ssl_match_hostname.py new file mode 100644 index 0000000..453cfd4 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/urllib3/util/ssl_match_hostname.py @@ -0,0 +1,159 @@ +"""The match_hostname() function from Python 3.5, essential when using SSL.""" + +# Note: This file is under the PSF license as the code comes from the python +# stdlib. http://docs.python.org/3/license.html +# It is modified to remove commonName support. + +from __future__ import annotations + +import ipaddress +import re +import typing +from ipaddress import IPv4Address, IPv6Address + +if typing.TYPE_CHECKING: + from .ssl_ import _TYPE_PEER_CERT_RET_DICT + +__version__ = "3.5.0.1" + + +class CertificateError(ValueError): + pass + + +def _dnsname_match( + dn: typing.Any, hostname: str, max_wildcards: int = 1 +) -> typing.Match[str] | None | bool: + """Matching according to RFC 6125, section 6.4.3 + + http://tools.ietf.org/html/rfc6125#section-6.4.3 + """ + pats = [] + if not dn: + return False + + # Ported from python3-syntax: + # leftmost, *remainder = dn.split(r'.') + parts = dn.split(r".") + leftmost = parts[0] + remainder = parts[1:] + + wildcards = leftmost.count("*") + if wildcards > max_wildcards: + # Issue #17980: avoid denials of service by refusing more + # than one wildcard per fragment. A survey of established + # policy among SSL implementations showed it to be a + # reasonable choice. + raise CertificateError( + "too many wildcards in certificate DNS name: " + repr(dn) + ) + + # speed up common case w/o wildcards + if not wildcards: + return bool(dn.lower() == hostname.lower()) + + # RFC 6125, section 6.4.3, subitem 1. + # The client SHOULD NOT attempt to match a presented identifier in which + # the wildcard character comprises a label other than the left-most label. + if leftmost == "*": + # When '*' is a fragment by itself, it matches a non-empty dotless + # fragment. + pats.append("[^.]+") + elif leftmost.startswith("xn--") or hostname.startswith("xn--"): + # RFC 6125, section 6.4.3, subitem 3. + # The client SHOULD NOT attempt to match a presented identifier + # where the wildcard character is embedded within an A-label or + # U-label of an internationalized domain name. + pats.append(re.escape(leftmost)) + else: + # Otherwise, '*' matches any dotless string, e.g. www* + pats.append(re.escape(leftmost).replace(r"\*", "[^.]*")) + + # add the remaining fragments, ignore any wildcards + for frag in remainder: + pats.append(re.escape(frag)) + + pat = re.compile(r"\A" + r"\.".join(pats) + r"\Z", re.IGNORECASE) + return pat.match(hostname) + + +def _ipaddress_match(ipname: str, host_ip: IPv4Address | IPv6Address) -> bool: + """Exact matching of IP addresses. + + RFC 9110 section 4.3.5: "A reference identity of IP-ID contains the decoded + bytes of the IP address. An IP version 4 address is 4 octets, and an IP + version 6 address is 16 octets. [...] A reference identity of type IP-ID + matches if the address is identical to an iPAddress value of the + subjectAltName extension of the certificate." + """ + # OpenSSL may add a trailing newline to a subjectAltName's IP address + # Divergence from upstream: ipaddress can't handle byte str + ip = ipaddress.ip_address(ipname.rstrip()) + return bool(ip.packed == host_ip.packed) + + +def match_hostname( + cert: _TYPE_PEER_CERT_RET_DICT | None, + hostname: str, + hostname_checks_common_name: bool = False, +) -> None: + """Verify that *cert* (in decoded format as returned by + SSLSocket.getpeercert()) matches the *hostname*. RFC 2818 and RFC 6125 + rules are followed, but IP addresses are not accepted for *hostname*. + + CertificateError is raised on failure. On success, the function + returns nothing. + """ + if not cert: + raise ValueError( + "empty or no certificate, match_hostname needs a " + "SSL socket or SSL context with either " + "CERT_OPTIONAL or CERT_REQUIRED" + ) + try: + # Divergence from upstream: ipaddress can't handle byte str + # + # The ipaddress module shipped with Python < 3.9 does not support + # scoped IPv6 addresses so we unconditionally strip the Zone IDs for + # now. Once we drop support for Python 3.9 we can remove this branch. + if "%" in hostname: + host_ip = ipaddress.ip_address(hostname[: hostname.rfind("%")]) + else: + host_ip = ipaddress.ip_address(hostname) + + except ValueError: + # Not an IP address (common case) + host_ip = None + dnsnames = [] + san: tuple[tuple[str, str], ...] = cert.get("subjectAltName", ()) + key: str + value: str + for key, value in san: + if key == "DNS": + if host_ip is None and _dnsname_match(value, hostname): + return + dnsnames.append(value) + elif key == "IP Address": + if host_ip is not None and _ipaddress_match(value, host_ip): + return + dnsnames.append(value) + + # We only check 'commonName' if it's enabled and we're not verifying + # an IP address. IP addresses aren't valid within 'commonName'. + if hostname_checks_common_name and host_ip is None and not dnsnames: + for sub in cert.get("subject", ()): + for key, value in sub: + if key == "commonName": + if _dnsname_match(value, hostname): + return + dnsnames.append(value) + + if len(dnsnames) > 1: + raise CertificateError( + "hostname %r " + "doesn't match either of %s" % (hostname, ", ".join(map(repr, dnsnames))) + ) + elif len(dnsnames) == 1: + raise CertificateError(f"hostname {hostname!r} doesn't match {dnsnames[0]!r}") + else: + raise CertificateError("no appropriate subjectAltName fields were found") diff --git a/.venv/lib/python3.12/site-packages/urllib3/util/ssltransport.py b/.venv/lib/python3.12/site-packages/urllib3/util/ssltransport.py new file mode 100644 index 0000000..b52c477 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/urllib3/util/ssltransport.py @@ -0,0 +1,279 @@ +from __future__ import annotations + +import io +import socket +import ssl +import typing + +from ..exceptions import ProxySchemeUnsupported + +if typing.TYPE_CHECKING: + from typing_extensions import Self + + from .ssl_ import _TYPE_PEER_CERT_RET, _TYPE_PEER_CERT_RET_DICT + + +_WriteBuffer = typing.Union[bytearray, memoryview] +_ReturnValue = typing.TypeVar("_ReturnValue") + +SSL_BLOCKSIZE = 16384 + + +class SSLTransport: + """ + The SSLTransport wraps an existing socket and establishes an SSL connection. + + Contrary to Python's implementation of SSLSocket, it allows you to chain + multiple TLS connections together. It's particularly useful if you need to + implement TLS within TLS. + + The class supports most of the socket API operations. + """ + + @staticmethod + def _validate_ssl_context_for_tls_in_tls(ssl_context: ssl.SSLContext) -> None: + """ + Raises a ProxySchemeUnsupported if the provided ssl_context can't be used + for TLS in TLS. + + The only requirement is that the ssl_context provides the 'wrap_bio' + methods. + """ + + if not hasattr(ssl_context, "wrap_bio"): + raise ProxySchemeUnsupported( + "TLS in TLS requires SSLContext.wrap_bio() which isn't " + "available on non-native SSLContext" + ) + + def __init__( + self, + socket: socket.socket, + ssl_context: ssl.SSLContext, + server_hostname: str | None = None, + suppress_ragged_eofs: bool = True, + ) -> None: + """ + Create an SSLTransport around socket using the provided ssl_context. + """ + self.incoming = ssl.MemoryBIO() + self.outgoing = ssl.MemoryBIO() + + self.suppress_ragged_eofs = suppress_ragged_eofs + self.socket = socket + + self.sslobj = ssl_context.wrap_bio( + self.incoming, self.outgoing, server_hostname=server_hostname + ) + + # Perform initial handshake. + self._ssl_io_loop(self.sslobj.do_handshake) + + def __enter__(self) -> Self: + return self + + def __exit__(self, *_: typing.Any) -> None: + self.close() + + def fileno(self) -> int: + return self.socket.fileno() + + def read(self, len: int = 1024, buffer: typing.Any | None = None) -> int | bytes: + return self._wrap_ssl_read(len, buffer) + + def recv(self, buflen: int = 1024, flags: int = 0) -> int | bytes: + if flags != 0: + raise ValueError("non-zero flags not allowed in calls to recv") + return self._wrap_ssl_read(buflen) + + def recv_into( + self, + buffer: _WriteBuffer, + nbytes: int | None = None, + flags: int = 0, + ) -> None | int | bytes: + if flags != 0: + raise ValueError("non-zero flags not allowed in calls to recv_into") + if nbytes is None: + nbytes = len(buffer) + return self.read(nbytes, buffer) + + def sendall(self, data: bytes, flags: int = 0) -> None: + if flags != 0: + raise ValueError("non-zero flags not allowed in calls to sendall") + count = 0 + with memoryview(data) as view, view.cast("B") as byte_view: + amount = len(byte_view) + while count < amount: + v = self.send(byte_view[count:]) + count += v + + def send(self, data: bytes, flags: int = 0) -> int: + if flags != 0: + raise ValueError("non-zero flags not allowed in calls to send") + return self._ssl_io_loop(self.sslobj.write, data) + + def makefile( + self, + mode: str, + buffering: int | None = None, + *, + encoding: str | None = None, + errors: str | None = None, + newline: str | None = None, + ) -> typing.BinaryIO | typing.TextIO | socket.SocketIO: + """ + Python's httpclient uses makefile and buffered io when reading HTTP + messages and we need to support it. + + This is unfortunately a copy and paste of socket.py makefile with small + changes to point to the socket directly. + """ + if not set(mode) <= {"r", "w", "b"}: + raise ValueError(f"invalid mode {mode!r} (only r, w, b allowed)") + + writing = "w" in mode + reading = "r" in mode or not writing + assert reading or writing + binary = "b" in mode + rawmode = "" + if reading: + rawmode += "r" + if writing: + rawmode += "w" + raw = socket.SocketIO(self, rawmode) # type: ignore[arg-type] + self.socket._io_refs += 1 # type: ignore[attr-defined] + if buffering is None: + buffering = -1 + if buffering < 0: + buffering = io.DEFAULT_BUFFER_SIZE + if buffering == 0: + if not binary: + raise ValueError("unbuffered streams must be binary") + return raw + buffer: typing.BinaryIO + if reading and writing: + buffer = io.BufferedRWPair(raw, raw, buffering) # type: ignore[assignment] + elif reading: + buffer = io.BufferedReader(raw, buffering) + else: + assert writing + buffer = io.BufferedWriter(raw, buffering) + if binary: + return buffer + text = io.TextIOWrapper(buffer, encoding, errors, newline) + text.mode = mode # type: ignore[misc] + return text + + def unwrap(self) -> None: + self._ssl_io_loop(self.sslobj.unwrap) + + def close(self) -> None: + self.socket.close() + + @typing.overload + def getpeercert( + self, binary_form: typing.Literal[False] = ... + ) -> _TYPE_PEER_CERT_RET_DICT | None: + ... + + @typing.overload + def getpeercert(self, binary_form: typing.Literal[True]) -> bytes | None: + ... + + def getpeercert(self, binary_form: bool = False) -> _TYPE_PEER_CERT_RET: + return self.sslobj.getpeercert(binary_form) # type: ignore[return-value] + + def version(self) -> str | None: + return self.sslobj.version() + + def cipher(self) -> tuple[str, str, int] | None: + return self.sslobj.cipher() + + def selected_alpn_protocol(self) -> str | None: + return self.sslobj.selected_alpn_protocol() + + def selected_npn_protocol(self) -> str | None: + return self.sslobj.selected_npn_protocol() + + def shared_ciphers(self) -> list[tuple[str, str, int]] | None: + return self.sslobj.shared_ciphers() + + def compression(self) -> str | None: + return self.sslobj.compression() + + def settimeout(self, value: float | None) -> None: + self.socket.settimeout(value) + + def gettimeout(self) -> float | None: + return self.socket.gettimeout() + + def _decref_socketios(self) -> None: + self.socket._decref_socketios() # type: ignore[attr-defined] + + def _wrap_ssl_read(self, len: int, buffer: bytearray | None = None) -> int | bytes: + try: + return self._ssl_io_loop(self.sslobj.read, len, buffer) + except ssl.SSLError as e: + if e.errno == ssl.SSL_ERROR_EOF and self.suppress_ragged_eofs: + return 0 # eof, return 0. + else: + raise + + # func is sslobj.do_handshake or sslobj.unwrap + @typing.overload + def _ssl_io_loop(self, func: typing.Callable[[], None]) -> None: + ... + + # func is sslobj.write, arg1 is data + @typing.overload + def _ssl_io_loop(self, func: typing.Callable[[bytes], int], arg1: bytes) -> int: + ... + + # func is sslobj.read, arg1 is len, arg2 is buffer + @typing.overload + def _ssl_io_loop( + self, + func: typing.Callable[[int, bytearray | None], bytes], + arg1: int, + arg2: bytearray | None, + ) -> bytes: + ... + + def _ssl_io_loop( + self, + func: typing.Callable[..., _ReturnValue], + arg1: None | bytes | int = None, + arg2: bytearray | None = None, + ) -> _ReturnValue: + """Performs an I/O loop between incoming/outgoing and the socket.""" + should_loop = True + ret = None + + while should_loop: + errno = None + try: + if arg1 is None and arg2 is None: + ret = func() + elif arg2 is None: + ret = func(arg1) + else: + ret = func(arg1, arg2) + except ssl.SSLError as e: + if e.errno not in (ssl.SSL_ERROR_WANT_READ, ssl.SSL_ERROR_WANT_WRITE): + # WANT_READ, and WANT_WRITE are expected, others are not. + raise e + errno = e.errno + + buf = self.outgoing.read() + self.socket.sendall(buf) + + if errno is None: + should_loop = False + elif errno == ssl.SSL_ERROR_WANT_READ: + buf = self.socket.recv(SSL_BLOCKSIZE) + if buf: + self.incoming.write(buf) + else: + self.incoming.write_eof() + return typing.cast(_ReturnValue, ret) diff --git a/.venv/lib/python3.12/site-packages/urllib3/util/timeout.py b/.venv/lib/python3.12/site-packages/urllib3/util/timeout.py new file mode 100644 index 0000000..4bb1be1 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/urllib3/util/timeout.py @@ -0,0 +1,275 @@ +from __future__ import annotations + +import time +import typing +from enum import Enum +from socket import getdefaulttimeout + +from ..exceptions import TimeoutStateError + +if typing.TYPE_CHECKING: + from typing import Final + + +class _TYPE_DEFAULT(Enum): + # This value should never be passed to socket.settimeout() so for safety we use a -1. + # socket.settimout() raises a ValueError for negative values. + token = -1 + + +_DEFAULT_TIMEOUT: Final[_TYPE_DEFAULT] = _TYPE_DEFAULT.token + +_TYPE_TIMEOUT = typing.Optional[typing.Union[float, _TYPE_DEFAULT]] + + +class Timeout: + """Timeout configuration. + + Timeouts can be defined as a default for a pool: + + .. code-block:: python + + import urllib3 + + timeout = urllib3.util.Timeout(connect=2.0, read=7.0) + + http = urllib3.PoolManager(timeout=timeout) + + resp = http.request("GET", "https://example.com/") + + print(resp.status) + + Or per-request (which overrides the default for the pool): + + .. code-block:: python + + response = http.request("GET", "https://example.com/", timeout=Timeout(10)) + + Timeouts can be disabled by setting all the parameters to ``None``: + + .. code-block:: python + + no_timeout = Timeout(connect=None, read=None) + response = http.request("GET", "https://example.com/", timeout=no_timeout) + + + :param total: + This combines the connect and read timeouts into one; the read timeout + will be set to the time leftover from the connect attempt. In the + event that both a connect timeout and a total are specified, or a read + timeout and a total are specified, the shorter timeout will be applied. + + Defaults to None. + + :type total: int, float, or None + + :param connect: + The maximum amount of time (in seconds) to wait for a connection + attempt to a server to succeed. Omitting the parameter will default the + connect timeout to the system default, probably `the global default + timeout in socket.py + `_. + None will set an infinite timeout for connection attempts. + + :type connect: int, float, or None + + :param read: + The maximum amount of time (in seconds) to wait between consecutive + read operations for a response from the server. Omitting the parameter + will default the read timeout to the system default, probably `the + global default timeout in socket.py + `_. + None will set an infinite timeout. + + :type read: int, float, or None + + .. note:: + + Many factors can affect the total amount of time for urllib3 to return + an HTTP response. + + For example, Python's DNS resolver does not obey the timeout specified + on the socket. Other factors that can affect total request time include + high CPU load, high swap, the program running at a low priority level, + or other behaviors. + + In addition, the read and total timeouts only measure the time between + read operations on the socket connecting the client and the server, + not the total amount of time for the request to return a complete + response. For most requests, the timeout is raised because the server + has not sent the first byte in the specified time. This is not always + the case; if a server streams one byte every fifteen seconds, a timeout + of 20 seconds will not trigger, even though the request will take + several minutes to complete. + """ + + #: A sentinel object representing the default timeout value + DEFAULT_TIMEOUT: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT + + def __init__( + self, + total: _TYPE_TIMEOUT = None, + connect: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT, + read: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT, + ) -> None: + self._connect = self._validate_timeout(connect, "connect") + self._read = self._validate_timeout(read, "read") + self.total = self._validate_timeout(total, "total") + self._start_connect: float | None = None + + def __repr__(self) -> str: + return f"{type(self).__name__}(connect={self._connect!r}, read={self._read!r}, total={self.total!r})" + + # __str__ provided for backwards compatibility + __str__ = __repr__ + + @staticmethod + def resolve_default_timeout(timeout: _TYPE_TIMEOUT) -> float | None: + return getdefaulttimeout() if timeout is _DEFAULT_TIMEOUT else timeout + + @classmethod + def _validate_timeout(cls, value: _TYPE_TIMEOUT, name: str) -> _TYPE_TIMEOUT: + """Check that a timeout attribute is valid. + + :param value: The timeout value to validate + :param name: The name of the timeout attribute to validate. This is + used to specify in error messages. + :return: The validated and casted version of the given value. + :raises ValueError: If it is a numeric value less than or equal to + zero, or the type is not an integer, float, or None. + """ + if value is None or value is _DEFAULT_TIMEOUT: + return value + + if isinstance(value, bool): + raise ValueError( + "Timeout cannot be a boolean value. It must " + "be an int, float or None." + ) + try: + float(value) + except (TypeError, ValueError): + raise ValueError( + "Timeout value %s was %s, but it must be an " + "int, float or None." % (name, value) + ) from None + + try: + if value <= 0: + raise ValueError( + "Attempted to set %s timeout to %s, but the " + "timeout cannot be set to a value less " + "than or equal to 0." % (name, value) + ) + except TypeError: + raise ValueError( + "Timeout value %s was %s, but it must be an " + "int, float or None." % (name, value) + ) from None + + return value + + @classmethod + def from_float(cls, timeout: _TYPE_TIMEOUT) -> Timeout: + """Create a new Timeout from a legacy timeout value. + + The timeout value used by httplib.py sets the same timeout on the + connect(), and recv() socket requests. This creates a :class:`Timeout` + object that sets the individual timeouts to the ``timeout`` value + passed to this function. + + :param timeout: The legacy timeout value. + :type timeout: integer, float, :attr:`urllib3.util.Timeout.DEFAULT_TIMEOUT`, or None + :return: Timeout object + :rtype: :class:`Timeout` + """ + return Timeout(read=timeout, connect=timeout) + + def clone(self) -> Timeout: + """Create a copy of the timeout object + + Timeout properties are stored per-pool but each request needs a fresh + Timeout object to ensure each one has its own start/stop configured. + + :return: a copy of the timeout object + :rtype: :class:`Timeout` + """ + # We can't use copy.deepcopy because that will also create a new object + # for _GLOBAL_DEFAULT_TIMEOUT, which socket.py uses as a sentinel to + # detect the user default. + return Timeout(connect=self._connect, read=self._read, total=self.total) + + def start_connect(self) -> float: + """Start the timeout clock, used during a connect() attempt + + :raises urllib3.exceptions.TimeoutStateError: if you attempt + to start a timer that has been started already. + """ + if self._start_connect is not None: + raise TimeoutStateError("Timeout timer has already been started.") + self._start_connect = time.monotonic() + return self._start_connect + + def get_connect_duration(self) -> float: + """Gets the time elapsed since the call to :meth:`start_connect`. + + :return: Elapsed time in seconds. + :rtype: float + :raises urllib3.exceptions.TimeoutStateError: if you attempt + to get duration for a timer that hasn't been started. + """ + if self._start_connect is None: + raise TimeoutStateError( + "Can't get connect duration for timer that has not started." + ) + return time.monotonic() - self._start_connect + + @property + def connect_timeout(self) -> _TYPE_TIMEOUT: + """Get the value to use when setting a connection timeout. + + This will be a positive float or integer, the value None + (never timeout), or the default system timeout. + + :return: Connect timeout. + :rtype: int, float, :attr:`Timeout.DEFAULT_TIMEOUT` or None + """ + if self.total is None: + return self._connect + + if self._connect is None or self._connect is _DEFAULT_TIMEOUT: + return self.total + + return min(self._connect, self.total) # type: ignore[type-var] + + @property + def read_timeout(self) -> float | None: + """Get the value for the read timeout. + + This assumes some time has elapsed in the connection timeout and + computes the read timeout appropriately. + + If self.total is set, the read timeout is dependent on the amount of + time taken by the connect timeout. If the connection time has not been + established, a :exc:`~urllib3.exceptions.TimeoutStateError` will be + raised. + + :return: Value to use for the read timeout. + :rtype: int, float or None + :raises urllib3.exceptions.TimeoutStateError: If :meth:`start_connect` + has not yet been called on this object. + """ + if ( + self.total is not None + and self.total is not _DEFAULT_TIMEOUT + and self._read is not None + and self._read is not _DEFAULT_TIMEOUT + ): + # In case the connect timeout has not yet been established. + if self._start_connect is None: + return self._read + return max(0, min(self.total - self.get_connect_duration(), self._read)) + elif self.total is not None and self.total is not _DEFAULT_TIMEOUT: + return max(0, self.total - self.get_connect_duration()) + else: + return self.resolve_default_timeout(self._read) diff --git a/.venv/lib/python3.12/site-packages/urllib3/util/url.py b/.venv/lib/python3.12/site-packages/urllib3/util/url.py new file mode 100644 index 0000000..d53ea93 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/urllib3/util/url.py @@ -0,0 +1,471 @@ +from __future__ import annotations + +import re +import typing + +from ..exceptions import LocationParseError +from .util import to_str + +# We only want to normalize urls with an HTTP(S) scheme. +# urllib3 infers URLs without a scheme (None) to be http. +_NORMALIZABLE_SCHEMES = ("http", "https", None) + +# Almost all of these patterns were derived from the +# 'rfc3986' module: https://github.com/python-hyper/rfc3986 +_PERCENT_RE = re.compile(r"%[a-fA-F0-9]{2}") +_SCHEME_RE = re.compile(r"^(?:[a-zA-Z][a-zA-Z0-9+-]*:|/)") +_URI_RE = re.compile( + r"^(?:([a-zA-Z][a-zA-Z0-9+.-]*):)?" + r"(?://([^\\/?#]*))?" + r"([^?#]*)" + r"(?:\?([^#]*))?" + r"(?:#(.*))?$", + re.UNICODE | re.DOTALL, +) + +_IPV4_PAT = r"(?:[0-9]{1,3}\.){3}[0-9]{1,3}" +_HEX_PAT = "[0-9A-Fa-f]{1,4}" +_LS32_PAT = "(?:{hex}:{hex}|{ipv4})".format(hex=_HEX_PAT, ipv4=_IPV4_PAT) +_subs = {"hex": _HEX_PAT, "ls32": _LS32_PAT} +_variations = [ + # 6( h16 ":" ) ls32 + "(?:%(hex)s:){6}%(ls32)s", + # "::" 5( h16 ":" ) ls32 + "::(?:%(hex)s:){5}%(ls32)s", + # [ h16 ] "::" 4( h16 ":" ) ls32 + "(?:%(hex)s)?::(?:%(hex)s:){4}%(ls32)s", + # [ *1( h16 ":" ) h16 ] "::" 3( h16 ":" ) ls32 + "(?:(?:%(hex)s:)?%(hex)s)?::(?:%(hex)s:){3}%(ls32)s", + # [ *2( h16 ":" ) h16 ] "::" 2( h16 ":" ) ls32 + "(?:(?:%(hex)s:){0,2}%(hex)s)?::(?:%(hex)s:){2}%(ls32)s", + # [ *3( h16 ":" ) h16 ] "::" h16 ":" ls32 + "(?:(?:%(hex)s:){0,3}%(hex)s)?::%(hex)s:%(ls32)s", + # [ *4( h16 ":" ) h16 ] "::" ls32 + "(?:(?:%(hex)s:){0,4}%(hex)s)?::%(ls32)s", + # [ *5( h16 ":" ) h16 ] "::" h16 + "(?:(?:%(hex)s:){0,5}%(hex)s)?::%(hex)s", + # [ *6( h16 ":" ) h16 ] "::" + "(?:(?:%(hex)s:){0,6}%(hex)s)?::", +] + +_UNRESERVED_PAT = r"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789._\-~" +_IPV6_PAT = "(?:" + "|".join([x % _subs for x in _variations]) + ")" +_ZONE_ID_PAT = "(?:%25|%)(?:[" + _UNRESERVED_PAT + "]|%[a-fA-F0-9]{2})+" +_IPV6_ADDRZ_PAT = r"\[" + _IPV6_PAT + r"(?:" + _ZONE_ID_PAT + r")?\]" +_REG_NAME_PAT = r"(?:[^\[\]%:/?#]|%[a-fA-F0-9]{2})*" +_TARGET_RE = re.compile(r"^(/[^?#]*)(?:\?([^#]*))?(?:#.*)?$") + +_IPV4_RE = re.compile("^" + _IPV4_PAT + "$") +_IPV6_RE = re.compile("^" + _IPV6_PAT + "$") +_IPV6_ADDRZ_RE = re.compile("^" + _IPV6_ADDRZ_PAT + "$") +_BRACELESS_IPV6_ADDRZ_RE = re.compile("^" + _IPV6_ADDRZ_PAT[2:-2] + "$") +_ZONE_ID_RE = re.compile("(" + _ZONE_ID_PAT + r")\]$") + +_HOST_PORT_PAT = ("^(%s|%s|%s)(?::0*?(|0|[1-9][0-9]{0,4}))?$") % ( + _REG_NAME_PAT, + _IPV4_PAT, + _IPV6_ADDRZ_PAT, +) +_HOST_PORT_RE = re.compile(_HOST_PORT_PAT, re.UNICODE | re.DOTALL) + +_UNRESERVED_CHARS = set( + "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789._-~" +) +_SUB_DELIM_CHARS = set("!$&'()*+,;=") +_USERINFO_CHARS = _UNRESERVED_CHARS | _SUB_DELIM_CHARS | {":"} +_PATH_CHARS = _USERINFO_CHARS | {"@", "/"} +_QUERY_CHARS = _FRAGMENT_CHARS = _PATH_CHARS | {"?"} + + +class Url( + typing.NamedTuple( + "Url", + [ + ("scheme", typing.Optional[str]), + ("auth", typing.Optional[str]), + ("host", typing.Optional[str]), + ("port", typing.Optional[int]), + ("path", typing.Optional[str]), + ("query", typing.Optional[str]), + ("fragment", typing.Optional[str]), + ], + ) +): + """ + Data structure for representing an HTTP URL. Used as a return value for + :func:`parse_url`. Both the scheme and host are normalized as they are + both case-insensitive according to RFC 3986. + """ + + def __new__( # type: ignore[no-untyped-def] + cls, + scheme: str | None = None, + auth: str | None = None, + host: str | None = None, + port: int | None = None, + path: str | None = None, + query: str | None = None, + fragment: str | None = None, + ): + if path and not path.startswith("/"): + path = "/" + path + if scheme is not None: + scheme = scheme.lower() + return super().__new__(cls, scheme, auth, host, port, path, query, fragment) + + @property + def hostname(self) -> str | None: + """For backwards-compatibility with urlparse. We're nice like that.""" + return self.host + + @property + def request_uri(self) -> str: + """Absolute path including the query string.""" + uri = self.path or "/" + + if self.query is not None: + uri += "?" + self.query + + return uri + + @property + def authority(self) -> str | None: + """ + Authority component as defined in RFC 3986 3.2. + This includes userinfo (auth), host and port. + + i.e. + userinfo@host:port + """ + userinfo = self.auth + netloc = self.netloc + if netloc is None or userinfo is None: + return netloc + else: + return f"{userinfo}@{netloc}" + + @property + def netloc(self) -> str | None: + """ + Network location including host and port. + + If you need the equivalent of urllib.parse's ``netloc``, + use the ``authority`` property instead. + """ + if self.host is None: + return None + if self.port: + return f"{self.host}:{self.port}" + return self.host + + @property + def url(self) -> str: + """ + Convert self into a url + + This function should more or less round-trip with :func:`.parse_url`. The + returned url may not be exactly the same as the url inputted to + :func:`.parse_url`, but it should be equivalent by the RFC (e.g., urls + with a blank port will have : removed). + + Example: + + .. code-block:: python + + import urllib3 + + U = urllib3.util.parse_url("https://google.com/mail/") + + print(U.url) + # "https://google.com/mail/" + + print( urllib3.util.Url("https", "username:password", + "host.com", 80, "/path", "query", "fragment" + ).url + ) + # "https://username:password@host.com:80/path?query#fragment" + """ + scheme, auth, host, port, path, query, fragment = self + url = "" + + # We use "is not None" we want things to happen with empty strings (or 0 port) + if scheme is not None: + url += scheme + "://" + if auth is not None: + url += auth + "@" + if host is not None: + url += host + if port is not None: + url += ":" + str(port) + if path is not None: + url += path + if query is not None: + url += "?" + query + if fragment is not None: + url += "#" + fragment + + return url + + def __str__(self) -> str: + return self.url + + +@typing.overload +def _encode_invalid_chars( + component: str, allowed_chars: typing.Container[str] +) -> str: # Abstract + ... + + +@typing.overload +def _encode_invalid_chars( + component: None, allowed_chars: typing.Container[str] +) -> None: # Abstract + ... + + +def _encode_invalid_chars( + component: str | None, allowed_chars: typing.Container[str] +) -> str | None: + """Percent-encodes a URI component without reapplying + onto an already percent-encoded component. + """ + if component is None: + return component + + component = to_str(component) + + # Normalize existing percent-encoded bytes. + # Try to see if the component we're encoding is already percent-encoded + # so we can skip all '%' characters but still encode all others. + component, percent_encodings = _PERCENT_RE.subn( + lambda match: match.group(0).upper(), component + ) + + uri_bytes = component.encode("utf-8", "surrogatepass") + is_percent_encoded = percent_encodings == uri_bytes.count(b"%") + encoded_component = bytearray() + + for i in range(0, len(uri_bytes)): + # Will return a single character bytestring + byte = uri_bytes[i : i + 1] + byte_ord = ord(byte) + if (is_percent_encoded and byte == b"%") or ( + byte_ord < 128 and byte.decode() in allowed_chars + ): + encoded_component += byte + continue + encoded_component.extend(b"%" + (hex(byte_ord)[2:].encode().zfill(2).upper())) + + return encoded_component.decode() + + +def _remove_path_dot_segments(path: str) -> str: + # See http://tools.ietf.org/html/rfc3986#section-5.2.4 for pseudo-code + segments = path.split("/") # Turn the path into a list of segments + output = [] # Initialize the variable to use to store output + + for segment in segments: + # '.' is the current directory, so ignore it, it is superfluous + if segment == ".": + continue + # Anything other than '..', should be appended to the output + if segment != "..": + output.append(segment) + # In this case segment == '..', if we can, we should pop the last + # element + elif output: + output.pop() + + # If the path starts with '/' and the output is empty or the first string + # is non-empty + if path.startswith("/") and (not output or output[0]): + output.insert(0, "") + + # If the path starts with '/.' or '/..' ensure we add one more empty + # string to add a trailing '/' + if path.endswith(("/.", "/..")): + output.append("") + + return "/".join(output) + + +@typing.overload +def _normalize_host(host: None, scheme: str | None) -> None: + ... + + +@typing.overload +def _normalize_host(host: str, scheme: str | None) -> str: + ... + + +def _normalize_host(host: str | None, scheme: str | None) -> str | None: + if host: + if scheme in _NORMALIZABLE_SCHEMES: + is_ipv6 = _IPV6_ADDRZ_RE.match(host) + if is_ipv6: + # IPv6 hosts of the form 'a::b%zone' are encoded in a URL as + # such per RFC 6874: 'a::b%25zone'. Unquote the ZoneID + # separator as necessary to return a valid RFC 4007 scoped IP. + match = _ZONE_ID_RE.search(host) + if match: + start, end = match.span(1) + zone_id = host[start:end] + + if zone_id.startswith("%25") and zone_id != "%25": + zone_id = zone_id[3:] + else: + zone_id = zone_id[1:] + zone_id = _encode_invalid_chars(zone_id, _UNRESERVED_CHARS) + return f"{host[:start].lower()}%{zone_id}{host[end:]}" + else: + return host.lower() + elif not _IPV4_RE.match(host): + return to_str( + b".".join([_idna_encode(label) for label in host.split(".")]), + "ascii", + ) + return host + + +def _idna_encode(name: str) -> bytes: + if not name.isascii(): + try: + import idna + except ImportError: + raise LocationParseError( + "Unable to parse URL without the 'idna' module" + ) from None + + try: + return idna.encode(name.lower(), strict=True, std3_rules=True) + except idna.IDNAError: + raise LocationParseError( + f"Name '{name}' is not a valid IDNA label" + ) from None + + return name.lower().encode("ascii") + + +def _encode_target(target: str) -> str: + """Percent-encodes a request target so that there are no invalid characters + + Pre-condition for this function is that 'target' must start with '/'. + If that is the case then _TARGET_RE will always produce a match. + """ + match = _TARGET_RE.match(target) + if not match: # Defensive: + raise LocationParseError(f"{target!r} is not a valid request URI") + + path, query = match.groups() + encoded_target = _encode_invalid_chars(path, _PATH_CHARS) + if query is not None: + query = _encode_invalid_chars(query, _QUERY_CHARS) + encoded_target += "?" + query + return encoded_target + + +def parse_url(url: str) -> Url: + """ + Given a url, return a parsed :class:`.Url` namedtuple. Best-effort is + performed to parse incomplete urls. Fields not provided will be None. + This parser is RFC 3986 and RFC 6874 compliant. + + The parser logic and helper functions are based heavily on + work done in the ``rfc3986`` module. + + :param str url: URL to parse into a :class:`.Url` namedtuple. + + Partly backwards-compatible with :mod:`urllib.parse`. + + Example: + + .. code-block:: python + + import urllib3 + + print( urllib3.util.parse_url('http://google.com/mail/')) + # Url(scheme='http', host='google.com', port=None, path='/mail/', ...) + + print( urllib3.util.parse_url('google.com:80')) + # Url(scheme=None, host='google.com', port=80, path=None, ...) + + print( urllib3.util.parse_url('/foo?bar')) + # Url(scheme=None, host=None, port=None, path='/foo', query='bar', ...) + """ + if not url: + # Empty + return Url() + + source_url = url + if not _SCHEME_RE.search(url): + url = "//" + url + + scheme: str | None + authority: str | None + auth: str | None + host: str | None + port: str | None + port_int: int | None + path: str | None + query: str | None + fragment: str | None + + try: + scheme, authority, path, query, fragment = _URI_RE.match(url).groups() # type: ignore[union-attr] + normalize_uri = scheme is None or scheme.lower() in _NORMALIZABLE_SCHEMES + + if scheme: + scheme = scheme.lower() + + if authority: + auth, _, host_port = authority.rpartition("@") + auth = auth or None + host, port = _HOST_PORT_RE.match(host_port).groups() # type: ignore[union-attr] + if auth and normalize_uri: + auth = _encode_invalid_chars(auth, _USERINFO_CHARS) + if port == "": + port = None + else: + auth, host, port = None, None, None + + if port is not None: + port_int = int(port) + if not (0 <= port_int <= 65535): + raise LocationParseError(url) + else: + port_int = None + + host = _normalize_host(host, scheme) + + if normalize_uri and path: + path = _remove_path_dot_segments(path) + path = _encode_invalid_chars(path, _PATH_CHARS) + if normalize_uri and query: + query = _encode_invalid_chars(query, _QUERY_CHARS) + if normalize_uri and fragment: + fragment = _encode_invalid_chars(fragment, _FRAGMENT_CHARS) + + except (ValueError, AttributeError) as e: + raise LocationParseError(source_url) from e + + # For the sake of backwards compatibility we put empty + # string values for path if there are any defined values + # beyond the path in the URL. + # TODO: Remove this when we break backwards compatibility. + if not path: + if query is not None or fragment is not None: + path = "" + else: + path = None + + return Url( + scheme=scheme, + auth=auth, + host=host, + port=port_int, + path=path, + query=query, + fragment=fragment, + ) diff --git a/.venv/lib/python3.12/site-packages/urllib3/util/util.py b/.venv/lib/python3.12/site-packages/urllib3/util/util.py new file mode 100644 index 0000000..35c77e4 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/urllib3/util/util.py @@ -0,0 +1,42 @@ +from __future__ import annotations + +import typing +from types import TracebackType + + +def to_bytes( + x: str | bytes, encoding: str | None = None, errors: str | None = None +) -> bytes: + if isinstance(x, bytes): + return x + elif not isinstance(x, str): + raise TypeError(f"not expecting type {type(x).__name__}") + if encoding or errors: + return x.encode(encoding or "utf-8", errors=errors or "strict") + return x.encode() + + +def to_str( + x: str | bytes, encoding: str | None = None, errors: str | None = None +) -> str: + if isinstance(x, str): + return x + elif not isinstance(x, bytes): + raise TypeError(f"not expecting type {type(x).__name__}") + if encoding or errors: + return x.decode(encoding or "utf-8", errors=errors or "strict") + return x.decode() + + +def reraise( + tp: type[BaseException] | None, + value: BaseException, + tb: TracebackType | None = None, +) -> typing.NoReturn: + try: + if value.__traceback__ is not tb: + raise value.with_traceback(tb) + raise value + finally: + value = None # type: ignore[assignment] + tb = None diff --git a/.venv/lib/python3.12/site-packages/urllib3/util/wait.py b/.venv/lib/python3.12/site-packages/urllib3/util/wait.py new file mode 100644 index 0000000..aeca0c7 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/urllib3/util/wait.py @@ -0,0 +1,124 @@ +from __future__ import annotations + +import select +import socket +from functools import partial + +__all__ = ["wait_for_read", "wait_for_write"] + + +# How should we wait on sockets? +# +# There are two types of APIs you can use for waiting on sockets: the fancy +# modern stateful APIs like epoll/kqueue, and the older stateless APIs like +# select/poll. The stateful APIs are more efficient when you have a lots of +# sockets to keep track of, because you can set them up once and then use them +# lots of times. But we only ever want to wait on a single socket at a time +# and don't want to keep track of state, so the stateless APIs are actually +# more efficient. So we want to use select() or poll(). +# +# Now, how do we choose between select() and poll()? On traditional Unixes, +# select() has a strange calling convention that makes it slow, or fail +# altogether, for high-numbered file descriptors. The point of poll() is to fix +# that, so on Unixes, we prefer poll(). +# +# On Windows, there is no poll() (or at least Python doesn't provide a wrapper +# for it), but that's OK, because on Windows, select() doesn't have this +# strange calling convention; plain select() works fine. +# +# So: on Windows we use select(), and everywhere else we use poll(). We also +# fall back to select() in case poll() is somehow broken or missing. + + +def select_wait_for_socket( + sock: socket.socket, + read: bool = False, + write: bool = False, + timeout: float | None = None, +) -> bool: + if not read and not write: + raise RuntimeError("must specify at least one of read=True, write=True") + rcheck = [] + wcheck = [] + if read: + rcheck.append(sock) + if write: + wcheck.append(sock) + # When doing a non-blocking connect, most systems signal success by + # marking the socket writable. Windows, though, signals success by marked + # it as "exceptional". We paper over the difference by checking the write + # sockets for both conditions. (The stdlib selectors module does the same + # thing.) + fn = partial(select.select, rcheck, wcheck, wcheck) + rready, wready, xready = fn(timeout) + return bool(rready or wready or xready) + + +def poll_wait_for_socket( + sock: socket.socket, + read: bool = False, + write: bool = False, + timeout: float | None = None, +) -> bool: + if not read and not write: + raise RuntimeError("must specify at least one of read=True, write=True") + mask = 0 + if read: + mask |= select.POLLIN + if write: + mask |= select.POLLOUT + poll_obj = select.poll() + poll_obj.register(sock, mask) + + # For some reason, poll() takes timeout in milliseconds + def do_poll(t: float | None) -> list[tuple[int, int]]: + if t is not None: + t *= 1000 + return poll_obj.poll(t) + + return bool(do_poll(timeout)) + + +def _have_working_poll() -> bool: + # Apparently some systems have a select.poll that fails as soon as you try + # to use it, either due to strange configuration or broken monkeypatching + # from libraries like eventlet/greenlet. + try: + poll_obj = select.poll() + poll_obj.poll(0) + except (AttributeError, OSError): + return False + else: + return True + + +def wait_for_socket( + sock: socket.socket, + read: bool = False, + write: bool = False, + timeout: float | None = None, +) -> bool: + # We delay choosing which implementation to use until the first time we're + # called. We could do it at import time, but then we might make the wrong + # decision if someone goes wild with monkeypatching select.poll after + # we're imported. + global wait_for_socket + if _have_working_poll(): + wait_for_socket = poll_wait_for_socket + elif hasattr(select, "select"): + wait_for_socket = select_wait_for_socket + return wait_for_socket(sock, read, write, timeout) + + +def wait_for_read(sock: socket.socket, timeout: float | None = None) -> bool: + """Waits for reading to be available on a given socket. + Returns True if the socket is readable, or False if the timeout expired. + """ + return wait_for_socket(sock, read=True, timeout=timeout) + + +def wait_for_write(sock: socket.socket, timeout: float | None = None) -> bool: + """Waits for writing to be available on a given socket. + Returns True if the socket is readable, or False if the timeout expired. + """ + return wait_for_socket(sock, write=True, timeout=timeout) diff --git a/.venv/lib64 b/.venv/lib64 new file mode 120000 index 0000000..7951405 --- /dev/null +++ b/.venv/lib64 @@ -0,0 +1 @@ +lib \ No newline at end of file diff --git a/.venv/pyvenv.cfg b/.venv/pyvenv.cfg new file mode 100644 index 0000000..3e51560 --- /dev/null +++ b/.venv/pyvenv.cfg @@ -0,0 +1,5 @@ +home = /bin +include-system-site-packages = false +version = 3.12.3 +executable = /usr/bin/python3.12 +command = /bin/python -m venv /home/rpetrovich/code/Misc/.venv diff --git a/block_ips.sh b/block_ips.sh new file mode 100644 index 0000000..075e03c --- /dev/null +++ b/block_ips.sh @@ -0,0 +1,160 @@ +#!/bin/bash +sudo iptables -A OUTPUT -d 104.16.0.35 -j REJECT +sudo iptables -A OUTPUT -d 104.16.1.35 -j REJECT +sudo iptables -A OUTPUT -d 104.16.168.120 -j REJECT +sudo iptables -A OUTPUT -d 104.16.169.120 -j REJECT +sudo iptables -A OUTPUT -d 104.16.2.35 -j REJECT +sudo iptables -A OUTPUT -d 104.16.24.34 -j REJECT +sudo iptables -A OUTPUT -d 104.16.25.34 -j REJECT +sudo iptables -A OUTPUT -d 104.16.26.34 -j REJECT +sudo iptables -A OUTPUT -d 104.16.27.34 -j REJECT +sudo iptables -A OUTPUT -d 104.16.28.34 -j REJECT +sudo iptables -A OUTPUT -d 104.16.29.34 -j REJECT +sudo iptables -A OUTPUT -d 104.16.3.35 -j REJECT +sudo iptables -A OUTPUT -d 104.16.30.34 -j REJECT +sudo iptables -A OUTPUT -d 104.16.31.34 -j REJECT +sudo iptables -A OUTPUT -d 104.16.72.101 -j REJECT +sudo iptables -A OUTPUT -d 104.16.73.101 -j REJECT +sudo iptables -A OUTPUT -d 104.21.13.85 -j REJECT +sudo iptables -A OUTPUT -d 104.21.80.4 -j REJECT +sudo iptables -A OUTPUT -d 108.138.7.18 -j REJECT +sudo iptables -A OUTPUT -d 108.138.7.33 -j REJECT +sudo iptables -A OUTPUT -d 108.138.7.48 -j REJECT +sudo iptables -A OUTPUT -d 108.138.7.88 -j REJECT +sudo iptables -A OUTPUT -d 108.157.214.121 -j REJECT +sudo iptables -A OUTPUT -d 108.157.214.24 -j REJECT +sudo iptables -A OUTPUT -d 108.157.214.42 -j REJECT +sudo iptables -A OUTPUT -d 108.157.214.59 -j REJECT +sudo iptables -A OUTPUT -d 108.157.229.17 -j REJECT +sudo iptables -A OUTPUT -d 108.157.229.3 -j REJECT +sudo iptables -A OUTPUT -d 108.157.229.36 -j REJECT +sudo iptables -A OUTPUT -d 108.157.229.86 -j REJECT +sudo iptables -A OUTPUT -d 108.177.14.141 -j REJECT +sudo iptables -A OUTPUT -d 116.203.44.5 -j REJECT +sudo iptables -A OUTPUT -d 13.107.253.72 -j REJECT +sudo iptables -A OUTPUT -d 13.90.137.153 -j REJECT +sudo iptables -A OUTPUT -d 140.82.121.3 -j REJECT +sudo iptables -A OUTPUT -d 140.82.121.33 -j REJECT +sudo iptables -A OUTPUT -d 146.75.116.209 -j REJECT +sudo iptables -A OUTPUT -d 146.75.122.132 -j REJECT +sudo iptables -A OUTPUT -d 147.75.85.69 -j REJECT +sudo iptables -A OUTPUT -d 150.171.69.10 -j REJECT +sudo iptables -A OUTPUT -d 150.171.70.10 -j REJECT +sudo iptables -A OUTPUT -d 151.101.1.227 -j REJECT +sudo iptables -A OUTPUT -d 151.101.129.227 -j REJECT +sudo iptables -A OUTPUT -d 151.101.130.132 -j REJECT +sudo iptables -A OUTPUT -d 151.101.193.227 -j REJECT +sudo iptables -A OUTPUT -d 151.101.194.132 -j REJECT +sudo iptables -A OUTPUT -d 151.101.2.132 -j REJECT +sudo iptables -A OUTPUT -d 151.101.36.223 -j REJECT +sudo iptables -A OUTPUT -d 151.101.65.227 -j REJECT +sudo iptables -A OUTPUT -d 151.101.66.132 -j REJECT +sudo iptables -A OUTPUT -d 157.90.160.34 -j REJECT +sudo iptables -A OUTPUT -d 158.160.130.222 -j REJECT +sudo iptables -A OUTPUT -d 172.67.132.164 -j REJECT +sudo iptables -A OUTPUT -d 172.67.172.85 -j REJECT +sudo iptables -A OUTPUT -d 173.194.222.82 -j REJECT +sudo iptables -A OUTPUT -d 174.129.67.79 -j REJECT +sudo iptables -A OUTPUT -d 178.128.6.101 -j REJECT +sudo iptables -A OUTPUT -d 18.172.112.101 -j REJECT +sudo iptables -A OUTPUT -d 18.172.112.106 -j REJECT +sudo iptables -A OUTPUT -d 18.172.112.108 -j REJECT +sudo iptables -A OUTPUT -d 18.172.112.122 -j REJECT +sudo iptables -A OUTPUT -d 18.172.112.30 -j REJECT +sudo iptables -A OUTPUT -d 18.172.112.51 -j REJECT +sudo iptables -A OUTPUT -d 18.172.112.53 -j REJECT +sudo iptables -A OUTPUT -d 18.172.112.67 -j REJECT +sudo iptables -A OUTPUT -d 18.193.107.15 -j REJECT +sudo iptables -A OUTPUT -d 18.198.112.44 -j REJECT +sudo iptables -A OUTPUT -d 18.198.212.80 -j REJECT +sudo iptables -A OUTPUT -d 18.209.251.225 -j REJECT +sudo iptables -A OUTPUT -d 18.214.194.113 -j REJECT +sudo iptables -A OUTPUT -d 18.232.172.199 -j REJECT +sudo iptables -A OUTPUT -d 18.245.60.101 -j REJECT +sudo iptables -A OUTPUT -d 18.245.60.117 -j REJECT +sudo iptables -A OUTPUT -d 18.245.60.125 -j REJECT +sudo iptables -A OUTPUT -d 18.245.60.89 -j REJECT +sudo iptables -A OUTPUT -d 18.66.122.124 -j REJECT +sudo iptables -A OUTPUT -d 18.66.122.127 -j REJECT +sudo iptables -A OUTPUT -d 18.66.122.15 -j REJECT +sudo iptables -A OUTPUT -d 18.66.122.32 -j REJECT +sudo iptables -A OUTPUT -d 185.125.190.81 -j REJECT +sudo iptables -A OUTPUT -d 185.125.190.82 -j REJECT +sudo iptables -A OUTPUT -d 185.125.190.83 -j REJECT +sudo iptables -A OUTPUT -d 185.199.108.133 -j REJECT +sudo iptables -A OUTPUT -d 185.199.108.153 -j REJECT +sudo iptables -A OUTPUT -d 185.199.109.133 -j REJECT +sudo iptables -A OUTPUT -d 185.199.109.153 -j REJECT +sudo iptables -A OUTPUT -d 185.199.110.133 -j REJECT +sudo iptables -A OUTPUT -d 185.199.110.153 -j REJECT +sudo iptables -A OUTPUT -d 185.199.111.133 -j REJECT +sudo iptables -A OUTPUT -d 185.199.111.153 -j REJECT +sudo iptables -A OUTPUT -d 188.114.98.229 -j REJECT +sudo iptables -A OUTPUT -d 188.114.99.229 -j REJECT +sudo iptables -A OUTPUT -d 213.180.204.183 -j REJECT +sudo iptables -A OUTPUT -d 216.239.32.21 -j REJECT +sudo iptables -A OUTPUT -d 216.239.34.21 -j REJECT +sudo iptables -A OUTPUT -d 216.239.36.21 -j REJECT +sudo iptables -A OUTPUT -d 216.239.38.21 -j REJECT +sudo iptables -A OUTPUT -d 216.58.210.142 -j REJECT +sudo iptables -A OUTPUT -d 217.196.149.55 -j REJECT +sudo iptables -A OUTPUT -d 3.123.220.237 -j REJECT +sudo iptables -A OUTPUT -d 3.164.68.117 -j REJECT +sudo iptables -A OUTPUT -d 3.164.68.119 -j REJECT +sudo iptables -A OUTPUT -d 3.164.68.45 -j REJECT +sudo iptables -A OUTPUT -d 3.164.68.9 -j REJECT +sudo iptables -A OUTPUT -d 3.210.119.111 -j REJECT +sudo iptables -A OUTPUT -d 3.219.239.5 -j REJECT +sudo iptables -A OUTPUT -d 3.221.179.99 -j REJECT +sudo iptables -A OUTPUT -d 3.64.156.118 -j REJECT +sudo iptables -A OUTPUT -d 3.95.117.170 -j REJECT +sudo iptables -A OUTPUT -d 34.120.127.130 -j REJECT +sudo iptables -A OUTPUT -d 34.120.251.192 -j REJECT +sudo iptables -A OUTPUT -d 34.225.228.28 -j REJECT +sudo iptables -A OUTPUT -d 34.226.69.105 -j REJECT +sudo iptables -A OUTPUT -d 34.234.104.159 -j REJECT +sudo iptables -A OUTPUT -d 34.68.230.202 -j REJECT +sudo iptables -A OUTPUT -d 34.95.74.180 -j REJECT +sudo iptables -A OUTPUT -d 34.96.108.209 -j REJECT +sudo iptables -A OUTPUT -d 35.171.70.57 -j REJECT +sudo iptables -A OUTPUT -d 44.197.30.101 -j REJECT +sudo iptables -A OUTPUT -d 44.209.124.32 -j REJECT +sudo iptables -A OUTPUT -d 44.209.48.142 -j REJECT +sudo iptables -A OUTPUT -d 44.216.36.216 -j REJECT +sudo iptables -A OUTPUT -d 46.148.230.218 -j REJECT +sudo iptables -A OUTPUT -d 5.182.227.150 -j REJECT +sudo iptables -A OUTPUT -d 50.17.28.229 -j REJECT +sudo iptables -A OUTPUT -d 52.22.177.50 -j REJECT +sudo iptables -A OUTPUT -d 52.240.159.111 -j REJECT +sudo iptables -A OUTPUT -d 52.53.136.54 -j REJECT +sudo iptables -A OUTPUT -d 52.59.103.36 -j REJECT +sudo iptables -A OUTPUT -d 52.72.29.48 -j REJECT +sudo iptables -A OUTPUT -d 52.8.83.157 -j REJECT +sudo iptables -A OUTPUT -d 52.85.243.2 -j REJECT +sudo iptables -A OUTPUT -d 52.85.243.52 -j REJECT +sudo iptables -A OUTPUT -d 52.85.243.54 -j REJECT +sudo iptables -A OUTPUT -d 52.85.243.60 -j REJECT +sudo iptables -A OUTPUT -d 54.153.26.201 -j REJECT +sudo iptables -A OUTPUT -d 54.158.168.65 -j REJECT +sudo iptables -A OUTPUT -d 54.158.32.169 -j REJECT +sudo iptables -A OUTPUT -d 54.177.231.75 -j REJECT +sudo iptables -A OUTPUT -d 54.196.99.49 -j REJECT +sudo iptables -A OUTPUT -d 54.221.82.220 -j REJECT +sudo iptables -A OUTPUT -d 72.32.157.246 -j REJECT +sudo iptables -A OUTPUT -d 74.125.131.82 -j REJECT +sudo iptables -A OUTPUT -d 77.223.118.150 -j REJECT +sudo iptables -A OUTPUT -d 77.223.120.232 -j REJECT +sudo iptables -A OUTPUT -d 80.239.150.10 -j REJECT +sudo iptables -A OUTPUT -d 80.239.150.57 -j REJECT +sudo iptables -A OUTPUT -d 82.202.247.250 -j REJECT +sudo iptables -A OUTPUT -d 84.201.144.250 -j REJECT +sudo iptables -A OUTPUT -d 84.201.171.239 -j REJECT +sudo iptables -A OUTPUT -d 84.201.185.129 -j REJECT +sudo iptables -A OUTPUT -d 87.238.57.227 -j REJECT +sudo iptables -A OUTPUT -d 88.221.132.184 -j REJECT +sudo iptables -A OUTPUT -d 88.221.132.91 -j REJECT +sudo iptables -A OUTPUT -d 91.134.164.156 -j REJECT +sudo iptables -A OUTPUT -d 91.189.91.81 -j REJECT +sudo iptables -A OUTPUT -d 91.189.91.82 -j REJECT +sudo iptables -A OUTPUT -d 91.189.91.83 -j REJECT +sudo iptables -A OUTPUT -d 93.189.63.149 -j REJECT \ No newline at end of file diff --git a/check_external_repos.py b/check_external_repos.py new file mode 100644 index 0000000..5ddf5c5 --- /dev/null +++ b/check_external_repos.py @@ -0,0 +1,363 @@ +import os +import time +import requests +from github import Github +import base64 +import json +import re +import concurrent.futures +from retrying import retry +from functools import wraps + +# Список токенов +TOKENS = [ + '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', + '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', + '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', + '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' + # Добавьте столько токенов, сколько нужно +] +TOKEN_INDEX = 0 +ORG_NAME = 'adeo' +GITHUB_ENTERPRISE_URL = 'https://github.lmru.tech' # URL вашей инстанции GitHub Enterprise +OUTPUT_FILE = 'external_repositories.txt' +CACHE_DIR = 'repo_cache' +REPOS_CACHE_FILE = 'repos_cache.json' +MAX_WORKERS = 16 # Начнем с 8 потоков + +# Регулярное выражение для поиска URL +url_regex = re.compile(r'https?://[^\s]+') +excluded_url_pattern = re.compile(r'https?://art\.lmru\.tech') + +# Уникальные внешние URL +unique_urls = set() + +# Создание директории для кэша +if not os.path.exists(CACHE_DIR): + os.makedirs(CACHE_DIR) + +# Декоратор для задержки между запросами +def rate_limited(func): + @wraps(func) + def wrapper(*args, **kwargs): + time.sleep(1) # Задержка в 1 секунду между запросами + return func(*args, **kwargs) + return wrapper + +# Функция для получения текущего токена +def get_current_token(): + global TOKEN_INDEX + token = TOKENS[TOKEN_INDEX % len(TOKENS)] + TOKEN_INDEX += 1 + return token + +# Создание экземпляра GitHub API с аутентификацией и кастомным URL +def create_github_instance(): + token = get_current_token() + return Github(base_url=f"{GITHUB_ENTERPRISE_URL}/api/v3", login_or_token=token) + +@rate_limited +@retry(wait_exponential_multiplier=1000, wait_exponential_max=10000, stop_max_attempt_number=5) +def get_repo_contents(repo, path=""): + return repo.get_contents(path) + +@rate_limited +@retry(wait_exponential_multiplier=1000, wait_exponential_max=10000, stop_max_attempt_number=5) +def get_file_content(file_content): + return base64.b64decode(file_content.content).decode('utf-8') + +@rate_limited +def check_rate_limit(): + headers = { + "Authorization": f"token {get_current_token()}" + } + rate_limit_url = f"{GITHUB_ENTERPRISE_URL}/api/v3/rate_limit" + response = requests.get(rate_limit_url, headers=headers) + if response.status_code == 200: + limits = response.json() + core_limit = limits["resources"]["core"]["limit"] + core_remaining = limits["resources"]["core"]["remaining"] + core_reset = limits["resources"]["core"]["reset"] + print(f"Core limit: {core_limit}") + print(f"Core remaining: {core_remaining}") + print(f"Core reset time: {time.strftime('%Y-%m-%d %H:%M:%S', time.gmtime(core_reset))}") + return core_remaining + else: + print(f"Failed to retrieve rate limits: {response.status_code}, {response.text}") + return None + +@rate_limited +def fetch_all_repos(): + repos = [] + g = create_github_instance() + try: + for repo in g.get_organization(ORG_NAME).get_repos(): + repos.append(repo.full_name) + except Exception as e: + print(f'Error retrieving organization repositories: {str(e)}') + if '403' in str(e): + print('Hit rate limit, sleeping for 60 seconds...') + time.sleep(60) + print(f"Total repositories retrieved: {len(repos)}") # Логирование количества репозиториев + return repos + +def get_all_repos(): + if os.path.exists(REPOS_CACHE_FILE): + with open(REPOS_CACHE_FILE, 'r') as f: + repos = json.load(f) + print(f"Loaded {len(repos)} repositories from cache") + else: + repos = fetch_all_repos() + with open(REPOS_CACHE_FILE, 'w') as f: + json.dump(repos, f) + print(f"Saved {len(repos)} repositories to cache") + return repos + +def cache_file_path(repo_name, file_path): + return os.path.join(CACHE_DIR, f"{repo_name.replace('/', '_')}_{file_path.replace('/', '_')}") + +def is_cached(repo_name, file_path): + return os.path.exists(cache_file_path(repo_name, file_path)) + +def read_cache(repo_name, file_path): + with open(cache_file_path(repo_name, file_path), 'r') as f: + return f.read() + +def write_cache(repo_name, file_path, content): + with open(cache_file_path(repo_name, file_path), 'w') as f: + f.write(content) + +def find_external_urls(content, repo_name, file_path): + urls = url_regex.findall(content) + for url in urls: + if not excluded_url_pattern.search(url): + unique_urls.add(url) + print(f'Found external URL in {repo_name}/{file_path}: {url}') + +def check_file(repo, file_content): + file_path = file_content.path + + if is_cached(repo.name, file_path): + print(f'Reading from cache: {repo.name}/{file_path}') + content = read_cache(repo.name, file_path) + else: + try: + # Чтение содержимого файла с повторными попытками + content = get_file_content(file_content) + write_cache(repo.name, file_path, content) + except Exception as e: + print(f'Error decoding {file_path} in {repo.name}: {str(e)}') + return + + # Поиск внешних URL + find_external_urls(content, repo.name, file_path) + +def check_and_report_external_repositories(repo): + try: + contents = get_repo_contents(repo) + while contents: + file_content = contents.pop(0) + if file_content.type == "dir": + print(f'Entering directory: {file_content.path}') + contents.extend(get_repo_contents(repo, file_content.path)) + else: + print(f'Checking file: {file_content.path}') + if file_content.path.endswith(( + "package.json", "requirements.txt", "setup.py", "pom.xml", "build.gradle", "Cargo.toml", "composer.json", + "Makefile", "Dockerfile", "saltfile", "Pipfile", "environment.yml", "Jenkinsfile", "Gemfile", "Rakefile", + "go.mod", "go.sum", "build.sbt", "Vagrantfile", "shard.yml", "Chart.yaml", "mix.exs", "nimble", "rebar.config", + "Project.toml", "deps.edn", "shadow-cljs.edn", "Spago.dhall", "flake.nix", "default.nix", "pubspec.yaml", + "Paket.dependencies", "Packages.swift", "universe.json", "stack.yaml", "hpack.yaml", "default.build", "project.clj" + )): + check_file(repo, file_content) + except Exception as e: + if '404' in str(e): + print(f'Skipping empty repository {repo.name}') + else: + print(f'Error processing repository {repo.name}: {str(e)}') + +def process_repository(repo_name): + print(f'Checking repository: {repo_name}') + g = create_github_instance() + repo = g.get_repo(repo_name) + check_and_report_external_repositories(repo) + print(f'Finished checking repository: {repo_name}') + +start_time = time.time() + +# Проверка лимитов перед началом выполнения +if check_rate_limit() is None: + exit(1) + +# Получение всех репозиториев +repos = get_all_repos() + +# Проверка, что репозитории были получены +if not repos: + print("No repositories retrieved. Exiting.") + exit(1) + +# Использование пула потоков для обработки репозиториев +with concurrent.futures.ThreadPoolExecutor(max_workers=MAX_WORKERS) as executor: + executor.map(process_repository, repos) + +end_time = time.time() +elapsed_time = end_time - start_time + +# Запись уникальных внешних URL в файл +with open(OUTPUT_FILE, 'w') as file: + for url in unique_urls: + file.write(f"{url}\n") + +print(f'Unique external URLs have been written to {OUTPUT_FILE}') +print(f'Total time taken: {elapsed_time / 60:.2f} minutes') + +# Проверка лимитов после выполнения +check_rate_limit() + +import os +import subprocess +import time +import shutil +import re +from github import Github +import concurrent.futures +import json + +# Список токенов +TOKENS = [ + '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', + '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', + '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', + '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' + # Добавьте столько токенов, сколько нужно +] +TOKEN_INDEX = 0 +ORG_NAME = 'adeo' +GITHUB_ENTERPRISE_URL = 'https://github.lmru.tech' +CLONE_DIR = '/tmp/github_test' # Укажите путь к директории, куда будут клонироваться репозитории +REPOS_CACHE_FILE = 'repos_cache.json' +OUTPUT_FILE = 'external_repositories.txt' +MAX_WORKERS = 8 # Количество параллельных процессов для клонирования +BATCH_SIZE = 50 # Количество репозиториев в одной партии для обработки + +# Регулярное выражение для поиска URL +url_regex = re.compile(r'https?://[^\s]+') +excluded_url_pattern = re.compile(r'https?://art\.lmru\.tech') + +# Уникальные внешние URL +unique_urls = set() + +# Функция для получения текущего токена +def get_current_token(): + global TOKEN_INDEX + token = TOKENS[TOKEN_INDEX % len(TOKENS)] + TOKEN_INDEX += 1 + return token + +# Создание экземпляра GitHub API с аутентификацией и кастомным URL +def create_github_instance(): + token = get_current_token() + return Github(base_url=f"{GITHUB_ENTERPRISE_URL}/api/v3", login_or_token=token) + +# Получение всех репозиториев и сохранение их в файл кэша +def fetch_all_repos(): + repos = [] + g = create_github_instance() + try: + for repo in g.get_organization(ORG_NAME).get_repos(): + repos.append(repo.clone_url) + except Exception as e: + print(f'Error retrieving organization repositories: {str(e)}') + if '403' in str(e): + print('Hit rate limit, sleeping for 60 seconds...') + time.sleep(60) + print(f"Total repositories retrieved: {len(repos)}") + with open(REPOS_CACHE_FILE, 'w') as f: + json.dump(repos, f) + return repos + +# Получение списка репозиториев из кэша +def get_all_repos(): + if os.path.exists(REPOS_CACHE_FILE): + with open(REPOS_CACHE_FILE, 'r') as f: + repos = json.load(f) + print(f"Loaded {len(repos)} repositories from cache") + else: + repos = fetch_all_repos() + return repos + +# Клонирование репозитория +def clone_repo(repo_url): + try: + token = get_current_token() + repo_name = repo_url.split('/')[-1].replace('.git', '') + clone_url = repo_url.replace('https://', f'https://{token}:x-oauth-basic@') + clone_path = os.path.join(CLONE_DIR, repo_name) + if not os.path.exists(clone_path): + subprocess.run(['git', 'clone', clone_url, clone_path]) + print(f'Cloned {repo_url} to {clone_path}') + else: + print(f'Repository {repo_name} already exists, pulling latest changes') + subprocess.run(['git', '-C', clone_path, 'pull']) + except Exception as e: + print(f'Error cloning repository {repo_url}: {str(e)}') + +# Поиск внешних URL в файлах +def find_external_urls(file_path): + with open(file_path, 'r', encoding='utf-8', errors='ignore') as f: + content = f.read() + urls = url_regex.findall(content) + for url in urls: + if not excluded_url_pattern.search(url): + unique_urls.add(url) + print(f'Found external URL in {file_path}: {url}') + +# Анализ репозитория +def analyze_repo(repo_path): + for root, _, files in os.walk(repo_path): + for file in files: + if file.endswith(( + "package.json", "requirements.txt", "setup.py", "pom.xml", "build.gradle", "Cargo.toml", "composer.json", + "Makefile", "Dockerfile", "saltfile", "Pipfile", "environment.yml", "Jenkinsfile", "Gemfile", "Rakefile", + "go.mod", "go.sum", "build.sbt", "Vagrantfile", "shard.yml", "Chart.yaml", "mix.exs", "nimble", "rebar.config", + "Project.toml", "deps.edn", "shadow-cljs.edn", "Spago.dhall", "flake.nix", "default.nix", "pubspec.yaml", + "Paket.dependencies", "Packages.swift", "universe.json", "stack.yaml", "hpack.yaml", "default.build", "project.clj" + )): + find_external_urls(os.path.join(root, file)) + +# Обработка репозиториев партиями +def process_repos_in_batches(repos): + for i in range(0, len(repos), BATCH_SIZE): + batch = repos[i:i + BATCH_SIZE] + + # Клонирование репозиториев + with concurrent.futures.ThreadPoolExecutor(max_workers=MAX_WORKERS) as executor: + executor.map(clone_repo, batch) + + # Анализ клонированных репозиториев + for repo_url in batch: + repo_name = repo_url.split('/')[-1].replace('.git', '') + repo_path = os.path.join(CLONE_DIR, repo_name) + if os.path.isdir(repo_path): + analyze_repo(repo_path) + + # Очистка после анализа + for repo_url in batch: + repo_name = repo_url.split('/')[-1].replace('.git', '') + repo_path = os.path.join(CLONE_DIR, repo_name) + if os.path.isdir(repo_path): + shutil.rmtree(repo_path) + print(f'Removed {repo_path} after analysis') + +# Основной код +if __name__ == '__main__': + repos = get_all_repos() + process_repos_in_batches(repos) + + # Запись уникальных внешних URL в файл + with open(OUTPUT_FILE, 'w') as file: + for url in unique_urls: + file.write(f"{url}\n") + + print(f'Unique external URLs have been written to {OUTPUT_FILE}') diff --git a/cross_namespace_communication.py b/cross_namespace_communication.py new file mode 100644 index 0000000..b52bc73 --- /dev/null +++ b/cross_namespace_communication.py @@ -0,0 +1,53 @@ +import json +import subprocess + +def get_kubectl_output(command): + result = subprocess.run(command, shell=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True) + if result.returncode != 0: + raise Exception(f"Error running command: {result.stderr}") + return json.loads(result.stdout) + +def filter_namespaces(items): + system_namespaces = ['kube-system', 'default', 'kube-node-lease'] + return [item for item in items if 'd8-' not in item['metadata']['namespace'] and item['metadata']['namespace'] not in system_namespaces] + +def main(): + services = get_kubectl_output("kubectl get services --all-namespaces -o json") + pods = get_kubectl_output("kubectl get pods --all-namespaces -o json") + + filtered_services = filter_namespaces(services['items']) + filtered_pods = filter_namespaces(pods['items']) + + service_dict = {} + for svc in filtered_services: + svc_namespace = svc['metadata']['namespace'] + svc_name = svc['metadata']['name'] + selectors = svc['spec'].get('selector', {}) + service_dict[(svc_namespace, svc_name)] = selectors + + pod_dict = {} + for pod in filtered_pods: + pod_namespace = pod['metadata']['namespace'] + pod_labels = pod['metadata'].get('labels', {}) + pod_name = pod['metadata']['name'] + pod_dict[(pod_namespace, pod_name)] = pod_labels + + cross_namespace_communication = [] + + for (svc_namespace, svc_name), selectors in service_dict.items(): + for (pod_namespace, pod_name), labels in pod_dict.items(): + if svc_namespace != pod_namespace and all(labels.get(key) == value for key, value in selectors.items()): + cross_namespace_communication.append({ + "service_namespace": svc_namespace, + "service_name": svc_name, + "service_selectors": selectors, + "pod_namespace": pod_namespace, + "pod_name": pod_name, + "pod_labels": labels + }) + + for comm in cross_namespace_communication: + print(f"Service {comm['service_namespace']}/{comm['service_name']} (selectors: {comm['service_selectors']}) communicates with Pod {comm['pod_namespace']}/{comm['pod_name']} (labels: {comm['pod_labels']}) in different namespace") + +if __name__ == "__main__": + main() diff --git a/filter_repos.py b/filter_repos.py new file mode 100644 index 0000000..040b61b --- /dev/null +++ b/filter_repos.py @@ -0,0 +1,28 @@ +import re + +input_file = 'external_repositories.txt' +output_file = 'filtered_repositories.txt' + +# Регулярное выражение для определения ссылок на репозитории +repo_patterns = [ + re.compile(r'https?://[^/]+/[^/]+/[^/]+\.git'), # Например, https://github.com/user/repo.git + re.compile(r'https?://[^/]+/[^/]+/[^/]+/[^/]+') # Например, https://gitlab.com/group/project/repo +] + +# Функция для проверки, является ли ссылка ссылкой на репозиторий +def is_repo_url(url): + return any(pattern.match(url) for pattern in repo_patterns) + +# Чтение и обработка файла +with open(input_file, 'r') as file: + lines = file.readlines() + +# Фильтрация ссылок +filtered_urls = [line for line in lines if is_repo_url(line) and 'lmru.adeo' not in line and 'lmru.tech' not in line and 'LICENSE' not in line and 'adeo.com' not in line and 'adeo.cloud' not in line] + +# Запись отфильтрованных ссылок в новый файл +with open(output_file, 'w') as file: + file.writelines(filtered_urls) + +print(f'Filtered URLs have been written to {output_file}') + diff --git a/iptables_rules_template.txt b/iptables_rules_template.txt new file mode 100644 index 0000000..b33e444 --- /dev/null +++ b/iptables_rules_template.txt @@ -0,0 +1,192 @@ + +*filter +:INPUT ACCEPT [0:0] +:FORWARD DROP [0:0] +:OUTPUT ACCEPT [0:0] +:DOCKER - [0:0] +:DOCKER-ISOLATION-STAGE-1 - [0:0] +:DOCKER-ISOLATION-STAGE-2 - [0:0] +:DOCKER-USER - [0:0] +-A FORWARD -j DOCKER-USER +-A FORWARD -j DOCKER-ISOLATION-STAGE-1 +-A FORWARD -o docker0 -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT +-A FORWARD -o docker0 -j DOCKER +-A FORWARD -i docker0 ! -o docker0 -j ACCEPT +-A FORWARD -i docker0 -o docker0 -j ACCEPT +-A DOCKER-ISOLATION-STAGE-1 -i docker0 ! -o docker0 -j DOCKER-ISOLATION-STAGE-2 +-A DOCKER-ISOLATION-STAGE-1 -j RETURN +-A DOCKER-ISOLATION-STAGE-2 -o docker0 -j DROP +-A DOCKER-ISOLATION-STAGE-2 -j RETURN +-A DOCKER-USER -j RETURN +COMMIT +*nat +:PREROUTING ACCEPT [0:0] +:INPUT ACCEPT [0:0] +:OUTPUT ACCEPT [0:0] +:POSTROUTING ACCEPT [0:0] +:DOCKER - [0:0] +-A PREROUTING -m addrtype --dst-type LOCAL -j DOCKER +-A OUTPUT ! -d 127.0.0.0/8 -m addrtype --dst-type LOCAL -j DOCKER +-A POSTROUTING -s 172.17.0.0/16 ! -o docker0 -j MASQUERADE +-A DOCKER -i docker0 -j RETURN +COMMIT + +-A OUTPUT -d 104.16.0.35 -j REJECT +-A OUTPUT -d 104.16.1.35 -j REJECT +-A OUTPUT -d 104.16.168.120 -j REJECT +-A OUTPUT -d 104.16.169.120 -j REJECT +-A OUTPUT -d 104.16.2.35 -j REJECT +-A OUTPUT -d 104.16.24.34 -j REJECT +-A OUTPUT -d 104.16.25.34 -j REJECT +-A OUTPUT -d 104.16.26.34 -j REJECT +-A OUTPUT -d 104.16.27.34 -j REJECT +-A OUTPUT -d 104.16.28.34 -j REJECT +-A OUTPUT -d 104.16.29.34 -j REJECT +-A OUTPUT -d 104.16.3.35 -j REJECT +-A OUTPUT -d 104.16.30.34 -j REJECT +-A OUTPUT -d 104.16.31.34 -j REJECT +-A OUTPUT -d 104.16.72.101 -j REJECT +-A OUTPUT -d 104.16.73.101 -j REJECT +-A OUTPUT -d 104.21.80.4 -j REJECT +-A OUTPUT -d 108.156.22.103 -j REJECT +-A OUTPUT -d 108.156.22.109 -j REJECT +-A OUTPUT -d 108.156.22.23 -j REJECT +-A OUTPUT -d 108.156.22.35 -j REJECT +-A OUTPUT -d 108.156.22.43 -j REJECT +-A OUTPUT -d 108.156.22.52 -j REJECT +-A OUTPUT -d 108.156.22.93 -j REJECT +-A OUTPUT -d 116.203.44.5 -j REJECT +-A OUTPUT -d 13.107.246.44 -j REJECT +-A OUTPUT -d 13.90.137.153 -j REJECT +-A OUTPUT -d 140.82.121.3 -j REJECT +-A OUTPUT -d 140.82.121.33 -j REJECT +-A OUTPUT -d 147.75.85.69 -j REJECT +-A OUTPUT -d 150.171.69.10 -j REJECT +-A OUTPUT -d 150.171.70.10 -j REJECT +-A OUTPUT -d 151.101.1.227 -j REJECT +-A OUTPUT -d 151.101.129.227 -j REJECT +-A OUTPUT -d 151.101.130.132 -j REJECT +-A OUTPUT -d 151.101.193.227 -j REJECT +-A OUTPUT -d 151.101.194.132 -j REJECT +-A OUTPUT -d 151.101.2.132 -j REJECT +-A OUTPUT -d 151.101.244.223 -j REJECT +-A OUTPUT -d 151.101.246.132 -j REJECT +-A OUTPUT -d 151.101.65.227 -j REJECT +-A OUTPUT -d 151.101.66.132 -j REJECT +-A OUTPUT -d 157.90.160.34 -j REJECT +-A OUTPUT -d 158.160.130.222 -j REJECT +-A OUTPUT -d 172.67.172.85 -j REJECT +-A OUTPUT -d 174.129.67.79 -j REJECT +-A OUTPUT -d 178.128.6.101 -j REJECT +-A OUTPUT -d 18.165.140.100 -j REJECT +-A OUTPUT -d 18.165.140.122 -j REJECT +-A OUTPUT -d 18.165.140.2 -j REJECT +-A OUTPUT -d 18.165.140.61 -j REJECT +-A OUTPUT -d 18.193.107.15 -j REJECT +-A OUTPUT -d 18.198.112.44 -j REJECT +-A OUTPUT -d 18.198.212.80 -j REJECT +-A OUTPUT -d 18.209.251.225 -j REJECT +-A OUTPUT -d 18.214.194.113 -j REJECT +-A OUTPUT -d 18.232.172.199 -j REJECT +-A OUTPUT -d 185.125.190.81 -j REJECT +-A OUTPUT -d 185.125.190.82 -j REJECT +-A OUTPUT -d 185.125.190.83 -j REJECT +-A OUTPUT -d 185.199.108.133 -j REJECT +-A OUTPUT -d 185.199.108.153 -j REJECT +-A OUTPUT -d 185.199.109.133 -j REJECT +-A OUTPUT -d 185.199.109.153 -j REJECT +-A OUTPUT -d 185.199.110.133 -j REJECT +-A OUTPUT -d 185.199.110.153 -j REJECT +-A OUTPUT -d 185.199.111.133 -j REJECT +-A OUTPUT -d 185.199.111.153 -j REJECT +-A OUTPUT -d 188.114.96.1 -j REJECT +-A OUTPUT -d 188.114.97.1 -j REJECT +-A OUTPUT -d 188.114.98.233 -j REJECT +-A OUTPUT -d 188.114.99.233 -j REJECT +-A OUTPUT -d 199.232.192.209 -j REJECT +-A OUTPUT -d 199.232.196.209 -j REJECT +-A OUTPUT -d 2.16.154.122 -j REJECT +-A OUTPUT -d 2.16.154.186 -j REJECT +-A OUTPUT -d 213.180.204.183 -j REJECT +-A OUTPUT -d 216.239.32.21 -j REJECT +-A OUTPUT -d 216.239.34.21 -j REJECT +-A OUTPUT -d 216.239.36.21 -j REJECT +-A OUTPUT -d 216.239.38.21 -j REJECT +-A OUTPUT -d 216.58.210.142 -j REJECT +-A OUTPUT -d 216.58.210.177 -j REJECT +-A OUTPUT -d 217.196.149.55 -j REJECT +-A OUTPUT -d 3.123.220.237 -j REJECT +-A OUTPUT -d 3.164.206.102 -j REJECT +-A OUTPUT -d 3.164.206.39 -j REJECT +-A OUTPUT -d 3.164.206.5 -j REJECT +-A OUTPUT -d 3.164.206.93 -j REJECT +-A OUTPUT -d 3.164.68.105 -j REJECT +-A OUTPUT -d 3.164.68.117 -j REJECT +-A OUTPUT -d 3.164.68.119 -j REJECT +-A OUTPUT -d 3.164.68.120 -j REJECT +-A OUTPUT -d 3.164.68.125 -j REJECT +-A OUTPUT -d 3.164.68.13 -j REJECT +-A OUTPUT -d 3.164.68.18 -j REJECT +-A OUTPUT -d 3.164.68.34 -j REJECT +-A OUTPUT -d 3.164.68.45 -j REJECT +-A OUTPUT -d 3.164.68.49 -j REJECT +-A OUTPUT -d 3.164.68.51 -j REJECT +-A OUTPUT -d 3.164.68.55 -j REJECT +-A OUTPUT -d 3.164.68.60 -j REJECT +-A OUTPUT -d 3.164.68.70 -j REJECT +-A OUTPUT -d 3.164.68.9 -j REJECT +-A OUTPUT -d 3.210.119.111 -j REJECT +-A OUTPUT -d 3.219.239.5 -j REJECT +-A OUTPUT -d 3.221.179.99 -j REJECT +-A OUTPUT -d 3.64.156.118 -j REJECT +-A OUTPUT -d 3.95.117.170 -j REJECT +-A OUTPUT -d 34.120.127.130 -j REJECT +-A OUTPUT -d 34.120.251.192 -j REJECT +-A OUTPUT -d 34.225.228.28 -j REJECT +-A OUTPUT -d 34.226.69.105 -j REJECT +-A OUTPUT -d 34.234.104.159 -j REJECT +-A OUTPUT -d 34.68.230.202 -j REJECT +-A OUTPUT -d 34.95.74.180 -j REJECT +-A OUTPUT -d 34.96.108.209 -j REJECT +-A OUTPUT -d 35.171.70.57 -j REJECT +-A OUTPUT -d 44.197.30.101 -j REJECT +-A OUTPUT -d 44.209.124.32 -j REJECT +-A OUTPUT -d 44.209.48.142 -j REJECT +-A OUTPUT -d 44.216.36.216 -j REJECT +-A OUTPUT -d 46.148.230.218 -j REJECT +-A OUTPUT -d 5.182.227.150 -j REJECT +-A OUTPUT -d 50.17.28.229 -j REJECT +-A OUTPUT -d 52.22.177.50 -j REJECT +-A OUTPUT -d 52.240.159.111 -j REJECT +-A OUTPUT -d 52.53.136.54 -j REJECT +-A OUTPUT -d 52.59.103.36 -j REJECT +-A OUTPUT -d 52.72.29.48 -j REJECT +-A OUTPUT -d 52.8.83.157 -j REJECT +-A OUTPUT -d 52.85.49.108 -j REJECT +-A OUTPUT -d 52.85.49.128 -j REJECT +-A OUTPUT -d 52.85.49.20 -j REJECT +-A OUTPUT -d 52.85.49.85 -j REJECT +-A OUTPUT -d 54.153.26.201 -j REJECT +-A OUTPUT -d 54.158.168.65 -j REJECT +-A OUTPUT -d 54.158.32.169 -j REJECT +-A OUTPUT -d 54.177.231.75 -j REJECT +-A OUTPUT -d 54.196.99.49 -j REJECT +-A OUTPUT -d 54.221.82.220 -j REJECT +-A OUTPUT -d 62.115.252.18 -j REJECT +-A OUTPUT -d 62.115.252.59 -j REJECT +-A OUTPUT -d 64.233.163.82 -j REJECT +-A OUTPUT -d 72.32.157.246 -j REJECT +-A OUTPUT -d 74.125.131.82 -j REJECT +-A OUTPUT -d 77.223.118.150 -j REJECT +-A OUTPUT -d 77.223.120.232 -j REJECT +-A OUTPUT -d 82.202.247.250 -j REJECT +-A OUTPUT -d 84.201.144.250 -j REJECT +-A OUTPUT -d 84.201.171.239 -j REJECT +-A OUTPUT -d 84.201.185.129 -j REJECT +-A OUTPUT -d 87.238.57.227 -j REJECT +-A OUTPUT -d 91.134.164.156 -j REJECT +-A OUTPUT -d 91.189.91.81 -j REJECT +-A OUTPUT -d 91.189.91.82 -j REJECT +-A OUTPUT -d 91.189.91.83 -j REJECT +-A OUTPUT -d 93.189.63.149 -j REJECT +COMMIT diff --git a/merge_ips.py b/merge_ips.py new file mode 100644 index 0000000..8afe3c2 --- /dev/null +++ b/merge_ips.py @@ -0,0 +1,25 @@ +# Определение путей к файлам +file_path_1 = '/home/rpetrovich/code/Repos/lmru--devops-core--salt/states/jenkins-slave/files/blocked_ips.txt' +file_path_2 = '/home/rpetrovich/code/Misc/blocked_ips.txt' +output_file_path = 'merged_ips.txt' + +# Чтение IP-адресов из первого файла +with open(file_path_1, 'r') as file: + ip_list_1 = file.read().splitlines() + +# Чтение IP-адресов из второго файла +with open(file_path_2, 'r') as file: + ip_list_2 = file.read().splitlines() + +# Объединение и удаление дубликатов с использованием множества +unique_ips = set(ip_list_1 + ip_list_2) + +# Сортировка IP-адресов +sorted_unique_ips = sorted(unique_ips) + +# Сохранение уникальных IP-адресов в файл +with open(output_file_path, 'w') as file: + for ip in sorted_unique_ips: + file.write(f"{ip}\n") + +print("Merged IP addresses list successfully created.") diff --git a/nexus/artifactory_export.py b/nexus/artifactory_export.py new file mode 100644 index 0000000..d93cb6b --- /dev/null +++ b/nexus/artifactory_export.py @@ -0,0 +1,31 @@ +import requests +import json + +artifactory_url = 'https://art.lmru.tech/artifactory/api/repositories' +headers = { + 'Content-Type': 'application/json' +} + +def get_virtual_repo_details(repo_key): + virtual_repo_url = f'{artifactory_url}/{repo_key}' + response = requests.get(virtual_repo_url, headers=headers) + if response.status_code == 200: + return response.json() + else: + print(f"Error getting details for virtual repository {repo_key}: {response.status_code} {response.text}") + return None + +response = requests.get(artifactory_url, headers=headers) +if response.status_code == 200: + repositories = response.json() + for repo in repositories: + if repo['type'] == 'VIRTUAL': + details = get_virtual_repo_details(repo['key']) + if details and 'repositories' in details: + repo['repositories'] = details['repositories'] + + with open('artifactory_repositories.json', 'w') as file: + json.dump(repositories, file, indent=4) + print("Repository list successfully retrieved and saved to artifactory_repositories.json") +else: + print("Error retrieving repository list:", response.status_code, response.text) diff --git a/nexus/nexus_content.py b/nexus/nexus_content.py new file mode 100644 index 0000000..1e0448b --- /dev/null +++ b/nexus/nexus_content.py @@ -0,0 +1,154 @@ +import requests +import json +import time +import logging +import os + +log_dir = '/tmp' +if not os.path.exists(log_dir): + os.makedirs(log_dir) +log_file = os.path.join(log_dir, 'nexus_task_logs.log') + +logging.basicConfig(filename=log_file, level=logging.INFO, + format='%(asctime)s - %(levelname)s - %(message)s') +logger = logging.getLogger() + +with open('artifactory_repositories.json', 'r') as file: + artifactory_repositories = json.load(file) + +headers = { + 'Content-Type': 'application/json' +} + +nexus_url_base = 'https://nexus-test.devops.lmru.tech' +nexus_username = 'admin' +nexus_password = 'nexus' + +def create_or_update_script(script_name, script_content): + script_url = f"{nexus_url_base}/service/rest/v1/script" + script_payload = { + "name": script_name, + "type": "groovy", + "content": script_content + } + + response = requests.get(f"{script_url}/{script_name}", headers=headers, auth=(nexus_username, nexus_password)) + if response.status_code == 200: + response = requests.put(f"{script_url}/{script_name}", headers=headers, auth=(nexus_username, nexus_password), data=json.dumps(script_payload)) + else: + response = requests.post(script_url, headers=headers, auth=(nexus_username, nexus_password), data=json.dumps(script_payload)) + + if response.status_code in [200, 201, 204]: + logger.info(f"Script {script_name} successfully created/updated") + return True + else: + logger.error(f"Error creating/updating script {script_name}: {response.status_code} {response.text}") + return False + +def run_script(script_name, args): + script_run_url = f"{nexus_url_base}/service/rest/v1/script/{script_name}/run" + response = requests.post(script_run_url, headers=headers, auth=(nexus_username, nexus_password), data=json.dumps(args)) + + if response.status_code == 200: + logger.info(f"Script {script_name} successfully executed") + return response.json() + else: + logger.error(f"Error executing script {script_name}: {response.status_code} {response.text}") + return None + +def check_task_status(task_id): + task_url = f"{nexus_url_base}/service/rest/v1/tasks/{task_id}" + while True: + response = requests.get(task_url, headers=headers, auth=(nexus_username, nexus_password)) + if response.status_code == 200: + task_info = response.json() + logger.debug(f"Raw task_info: {task_info}") + status = task_info['currentState'] + logger.info(f"Task {task_id} status: {status}") + if status in ['WAITING', 'FAILED', 'OK']: + last_run_result = task_info['lastRunResult'] + logger.info(f"Task {task_id} last run result: {last_run_result}") + return status, last_run_result + else: + logger.error(f"Error checking status of task {task_id}: {response.status_code} {response.text}") + time.sleep(10) + +groovy_script_content = ''' +import org.sonatype.nexus.scheduling.TaskConfiguration +import org.sonatype.nexus.scheduling.TaskInfo +import org.sonatype.nexus.scheduling.TaskScheduler + +import groovy.json.JsonOutput +import groovy.json.JsonSlurper + +class TaskXO { + String typeId + Boolean enabled + String name + String alertEmail + Map properties +} + +TaskXO task = new JsonSlurper().parseText(args) + +TaskScheduler scheduler = container.lookup(TaskScheduler.class.name) + +TaskConfiguration config = scheduler.createTaskConfigurationInstance(task.typeId) +config.enabled = task.enabled +config.name = task.name +config.alertEmail = task.alertEmail +task.properties?.each { key, value -> config.setString(key, value) } +TaskInfo taskInfo = scheduler.scheduleTask(config, scheduler.scheduleFactory.manual()) +JsonOutput.toJson(taskInfo) +''' + +if create_or_update_script("create_task", groovy_script_content): + for repo in artifactory_repositories: + logger.info("="*50) + repo_name = repo['key'] + repo_type = repo['type'] + + if repo_type != 'LOCAL': + continue + + task_name = f"{repo_name}-import" + args = { + "typeId": "repository.import", + "enabled": True, + "name": task_name, + "alertEmail": None, + "properties": { + "repositoryName": repo_name, + "sourceDir": f"/opt/art-migr/repositories/{repo_name}" + } + } + + task_info = run_script("create_task", args) + + if task_info: + logger.debug(f"Task info: {task_info}") + result = json.loads(task_info['result']) + if 'id' in result: + task_id = result['id'] + logger.info(f"Task {task_name} successfully created with ID {task_id}") + + task_run_url = f"{nexus_url_base}/service/rest/v1/tasks/{task_id}/run" + run_response = requests.post(task_run_url, headers=headers, auth=(nexus_username, nexus_password)) + + if run_response.status_code == 204: + logger.info(f"Task {task_name} successfully started") + status, last_run_result = check_task_status(task_id) + if status == 'FAILED': + logger.error(f"Task {task_name} failed with result: {last_run_result}") + break + else: + logger.error(f"Error starting task {task_name}: {run_response.status_code} {run_response.text}") + break + + time.sleep(5) + else: + logger.error(f"Task ID not found in the response for task {task_name}") + break + else: + logger.error(f"Failed to create task {task_name}") + break \ No newline at end of file diff --git a/nexus/nexus_import.py b/nexus/nexus_import.py new file mode 100644 index 0000000..81a2d90 --- /dev/null +++ b/nexus/nexus_import.py @@ -0,0 +1,189 @@ +import requests +import json + +nexus_url_base = 'https://nexus-test.devops.lmru.tech/service/rest/v1/repositories' +nexus_username = 'admin' +nexus_password = 'nexus' + +with open('artifactory_repositories.json', 'r') as file: + artifactory_repositories = json.load(file) + +headers = { + 'Content-Type': 'application/json' +} + +repo_type_mapping = { + 'LOCAL': 'hosted', + 'REMOTE': 'proxy', + 'VIRTUAL': 'group' +} + +format_url_mapping = { + 'maven': 'maven', + 'npm': 'npm', + 'nuget': 'nuget', + 'docker': 'docker', + 'pypi': 'pypi', + 'rubygems': 'rubygems', + 'yum': 'yum', + 'debian': 'apt', + 'generic': 'raw', + 'go': 'go', + 'gradle': 'gradle', + 'helm': 'helm', + 'cocoapods': 'cocoapods' +} + +default_attributes = { + 'maven': { + 'versionPolicy': 'RELEASE', + 'layoutPolicy': 'STRICT' + }, + 'nugetProxy': { + 'queryCacheItemMaxAge': 1440, + 'nugetVersion': 'V3' + }, + 'dockerProxy': { + 'indexType': 'REGISTRY' + }, + 'apt': { + 'flat': False, + 'distribution': 'default' + }, + 'proxyDefaults': { + 'contentMaxAge': 1440, + 'metadataMaxAge': 1440 + } +} + +for repo in artifactory_repositories: + repo_name = repo['key'] + repo_type = repo_type_mapping.get(repo['type']) + package_type = repo.get('packageType').lower() + + format_url = format_url_mapping.get(package_type) + + if not format_url: + print(f"Unknown package type {package_type} for {repo_name}") + continue + + nexus_url = f"{nexus_url_base}/{format_url}/{repo_type}" + + if repo_type == 'proxy': + config = { + "name": repo_name, + "online": True, + "storage": { + "blobStoreName": "nexus-test", + "strictContentTypeValidation": True + }, + "proxy": { + "remoteUrl": repo['url'], + "contentMaxAge": default_attributes['proxyDefaults']['contentMaxAge'], + "metadataMaxAge": default_attributes['proxyDefaults']['metadataMaxAge'] + }, + "negativeCache": { + "enabled": True, + "timeToLive": 1440 + }, + "httpClient": { + "blocked": False, + "autoBlock": True + }, + "routingRuleName": None, + "format": format_url + } + + if format_url == 'docker': + config['dockerProxy'] = default_attributes['dockerProxy'] + config['docker'] = { + "v1Enabled": False, + "forceBasicAuth": True + } + + if format_url == 'apt': + config['apt'] = default_attributes['apt'] + config['apt']['distribution'] = repo.get('distribution', 'default') + + if format_url == 'yum': + config['yum'] = {} + + if format_url == 'maven': + config["maven"] = default_attributes['maven'] + + if format_url == 'nuget': + config["nugetProxy"] = default_attributes['nugetProxy'] + + elif repo_type == 'hosted': + config = { + "name": repo_name, + "online": True, + "storage": { + "blobStoreName": "nexus-test", + "strictContentTypeValidation": True, + "writePolicy": 'ALLOW' + }, + "cleanup": None, + "component": { + "proprietaryComponents": False + }, + "format": format_url + } + + if format_url == 'docker': + config['docker'] = { + "v1Enabled": False, + "forceBasicAuth": True + } + if format_url == 'maven': + config["maven"] = default_attributes['maven'] + if format_url == 'yum': + config['yum'] = {} + + elif repo_type == 'group': + config = { + "name": repo_name, + "online": True, + "storage": { + "blobStoreName": "nexus-test", + "strictContentTypeValidation": True + }, + "group": { + "memberNames": repo['repositories'] + }, + "format": format_url + } + + if format_url == 'docker': + config['docker'] = { + "v1Enabled": False, + "forceBasicAuth": True + } + if format_url == 'maven': + config["maven"] = default_attributes['maven'] + + else: + print(f"Unknown repository type {repo['type']} for {repo_name}") + continue + + + try: + response = requests.post(nexus_url, headers=headers, auth=(nexus_username, nexus_password), data=json.dumps(config)) + + if response.status_code == 201: + print(f"Repository {repo_name} successfully created") + else: + try: + response_json = response.json() + if isinstance(response_json, dict): + if "duplicated key" in response_json.get("message", ""): + print(f"!!! Repository {repo_name} already exists") + else: + print(f"Error creating repository {repo_name}: {response.status_code} {response.text}") + else: + print(f"Error creating repository {repo_name}: {response.status_code} {response.text}") + except json.JSONDecodeError: + print(f"Error creating repository {repo_name}: {response.status_code} {response.text}") + + except requests.exceptions.RequestException as e: + print(f"Error during request execution: {e}") \ No newline at end of file diff --git a/nexus/remote_artifactory.py b/nexus/remote_artifactory.py new file mode 100644 index 0000000..f374f1f --- /dev/null +++ b/nexus/remote_artifactory.py @@ -0,0 +1,60 @@ +import requests +import json +import dns.resolver +from urllib.parse import urlparse + +artifactory_url = 'https://art.lmru.tech/artifactory/api/repositories' +headers = { + 'Content-Type': 'application/json' +} + +def get_remote_repositories(): + response = requests.get(artifactory_url, headers=headers) + if response.status_code == 200: + repositories = response.json() + excluded_package_types = ['yum', 'deb', 'rpm', 'apt', 'alpine'] + remote_repositories = [ + repo for repo in repositories + if repo['type'] == 'REMOTE' and repo.get('packageType', '').lower() not in excluded_package_types + ] + return remote_repositories + else: + print("Error retrieving repository list:", response.status_code, response.text) + return [] + +remote_repositories = get_remote_repositories() + +def extract_hostname(url): + parsed_url = urlparse(url) + return parsed_url.hostname + +def get_ip_addresses(hostname, iterations=20): + ip_addresses = set() + for _ in range(iterations): + try: + answers = dns.resolver.resolve(hostname, 'A') + for rdata in answers: + ip_addresses.add(rdata.to_text()) + except dns.resolver.NoAnswer: + print(f"No A records found for {hostname}") + except dns.resolver.NXDOMAIN: + print(f"Domain {hostname} does not exist") + except dns.exception.Timeout: + print(f"Timeout while resolving {hostname}") + except Exception as e: + print(f"An error occurred while resolving {hostname}: {e}") + return ip_addresses + +# Получаем уникальные IP-адреса для каждого хоста +hostnames = {extract_hostname(repo['url']) for repo in remote_repositories} +hostnames.add('docker.io') +unique_ip_addresses = set() +for hostname in hostnames: + unique_ip_addresses.update(get_ip_addresses(hostname)) + +# Сохранение уникальных IP-адресов в файл +with open('blocked_ips.txt', 'w') as file: + for ip in sorted(unique_ip_addresses): + file.write(f"{ip}\n") + +print("Blocked IP addresses list successfully created.") diff --git a/result.json b/result.json new file mode 100644 index 0000000..c3f36d3 --- /dev/null +++ b/result.json @@ -0,0 +1,2 @@ +20004701 20007558 20009453 20012720 20100159 20100170 20100584 20101131 20101610 20101868 20102344 60001792 60006703 60013876 60016701 60018962 60019480 60019686 60021643 60025677 60030222 60032246 60033640 60034539 60034602 60034833 60036725 60039395 60042264 60042377 60042381 60043421 60043736 60043780 60044407 60044590 60044939 60046417 60046439 60046790 60046922 60047845 60049002 60049394 60050213 60050222 60050223 60050226 60050426 60050926 60051503 60051658 60052080 60053489 60054058 60054291 60054317 60055036 60055049 60055376 60055379 60055865 60055889 60055892 60056045 60056125 60057278 60058562 60058585 60058697 60058887 60059149 60059839 60060360 60060933 60060959 60060966 60061003 60061489 60061498 60061515 60061517 60061914 60062812 60063125 60063241 60063242 60063243 60063455 60063696 60064241 60065265 60065297 60065317 60065617 60066078 60066518 60067116 60067117 60067118 60067166 60067347 60067765 60067830 60067859 60067976 60068500 60068508 60068873 60069430 60071625 60071957 60073410 60074043 60074149 60074339 60074461 60075234 60075858 60076153 60076298 60076591 60076599 60076848 60076865 60077374 60077389 60078463 60078469 60078660 60078674 60078822 60079038 60079174 60079301 60079404 60079434 60079598 60079603 60079608 60079620 60079824 60080058 60080069 60080070 60080077 60080084 60080088 60080254 60080259 60080274 60080507 60080510 60080512 60080513 60080743 60080744 60080762 60080776 60081041 60081065 60081069 60081078 60081084 60081092 60081229 60081362 60081389 60081597 60083638 60084085 60084583 60084585 60084857 60085078 60087048 60089062 60089952 60090260 60092098 60092104 60092272 60092273 60092429 60093688 60093786 60094676 60094988 60095085 60095267 60095662 60095663 60095917 60095922 60096212 60096339 60097994 60099817 60099977 60100117 60100396 60100413 60100993 60101512 60102051 60102244 60102528 60102678 60102679 60102827 60103281 60103285 60103286 60104249 60104258 60104436 60104719 60104753 60104755 60104768 60104802 60105284 60105740 60106133 60106543 60106553 60106555 60106613 60106993 60107000 60107005 60107006 60107332 60107406 60107447 60107728 60107885 60107893 60107907 60108248 60108254 60108267 60108828 60108963 60109064 60109228 60109234 60109256 60109618 60109828 60109900 60110087 60110511 60110530 60110890 60110929 60110934 60111346 60111358 60111698 60111736 60111741 60111980 60112003 60112075 60112101 60112105 60112107 60112125 60112253 60112254 60112498 60112518 60112522 60112755 60112794 60112800 60112811 60113208 60113417 60113421 60113441 60113484 60113739 60113851 60113892 60114134 60114140 60114277 60114355 60114400 60114429 60114431 60114442 60114473 60114807 60114812 60114820 60114993 60115071 60115164 60115199 60115244 60115256 60115305 60115322 60115324 60115405 60115406 60115475 60115477 60115481 60115587 60115594 60115597 60115904 60115905 60116012 60116013 60116014 60116126 60116128 60116541 60116701 60116703 60116957 60117166 60117329 60117703 60117764 60117789 60118036 60118160 60118320 60118528 60118725 60118953 60119180 60119188 60119274 60119444 60119553 60119882 60119883 60119912 60120125 60120232 60120367 60120497 60120499 60120501 60120922 60121062 60121066 60121067 60121073 60121480 60121578 60121589 60121862 60122158 60122289 60122290 60122293 60122301 60122736 60123156 60123159 60123184 60123426 60123753 60123754 60124001 60124661 60124665 60124847 60124989 60124990 60125022 60125137 60125138 60125139 60125141 60125362 60125363 60125784 60126229 60126442 60126452 60126487 60126524 60126539 60126560 60126565 60126575 60126579 60127134 60127135 60127300 60127399 60127466 60127764 60127795 60127856 60127858 60128049 60128117 60128185 60128186 60128188 60128253 60128270 60128391 60128462 60128544 60128551 60128552 60128791 60128794 60128798 60128806 60128922 60129175 60129177 60129301 60129303 60129305 60129392 60129475 60129478 60129547 60129551 60129553 60129554 60129615 60129664 60129676 60129735 60129795 60129811 60129866 60129867 60130004 60130233 60130237 60130342 60130381 60130508 60130510 60130642 60130709 60130726 60130744 60130745 60130793 60131055 60131129 60131251 60131401 60131474 60131475 60131613 60131615 60131666 60131705 60131706 60131708 60131751 60131758 60131898 60131993 60132316 60132365 60132650 60132654 60132686 60132896 60133252 60133618 60133666 60134227 60134256 60134290 60134510 60134980 60135257 60135334 60135743 60135745 60136076 60136286 60136670 60137540 60137697 60137714 60138340 60138342 60138362 60138832 admin +20005355 60040301 60043381 60044118 60051499 60051660 60052041 60053702 60056137 60056207 60056825 60057665 60058117 60058509 60059958 60060685 60061212 60061679 60063191 60064215 60064702 60065276 60065296 60065630 60066341 60067766 60068511 60072728 60073478 60074370 60074745 60075171 60076569 60078677 60080030 60080049 60082900 60083653 60084092 60085559 60090922 60093807 60101544 60101573 60102791 60103280 60106149 60107002 60107003 60107440 60107448 60109288 60109724 60110192 60111347 60111370 60111371 60112118 60112998 60113443 60113646 60114130 60114260 60114867 60116473 60117227 60120126 60120228 60121064 60121960 60122739 60123152 60123153 60123750 60124099 60125671 60127137 60129179 60130191 60130727 60131057 60131399 60136091 60138126 60138160 60200370 60200371 60200446 60200742 bricks-sonar-service-account jenkins lm-sa-apiinfra lm-sa-cr lm-sa-devops lm-sa-lmdb lm-sa-lmvsp lm-sa-microfronts lm-sa-triffle lm-sa-vsppm lm-sa-vspspc lm-sa-vspspdm lm-sa-vspspr lm-sa-vspsspc lm-sa-wms \ No newline at end of file diff --git a/sonarqube.py b/sonarqube.py new file mode 100644 index 0000000..f1cea03 --- /dev/null +++ b/sonarqube.py @@ -0,0 +1,37 @@ +import requests + +# Set up authentication token and base URL +TOKEN = "squ_ebe55ae1337899b210495f163664abd9f614426e" +base_url = "https://t-sonarqube-x1.devops.lmru.tech/sonarqube/api/users" + +# Headers with the authentication +headers = { + 'Authorization': f'Basic {TOKEN}:' +} + +# Function to update user identity provider +# def update_identity_provider(login): +# update_url = f"{base_url}/update_identity_provider" +# params = { +# 'login': login, +# 'newExternalProvider': 'saml' +# } +# response = requests.post(update_url, headers=headers, params=params) +# return response.json() + +for i in range(1, 11): + url = f"https://t-sonarqube-x1.devops.lmru.tech/sonarqube/api/users/search" + params = { + 'ps': 500, + 'p': i + } + response = requests.get(url, headers=headers, params=params) + + if response.status_code == 200: + users = response.json() + print(users) + # for user in users: + # result = update_identity_provider(user['login']) + # print(f"Updated {user['login']}:", result) + else: + print(f"Failed to fetch page {i}, status code {response}") diff --git a/sonarqube.sh b/sonarqube.sh new file mode 100644 index 0000000..36a628d --- /dev/null +++ b/sonarqube.sh @@ -0,0 +1,21 @@ +#!/bin/bash + + +TOKEN="squ_ebe55ae1337899b210495f163664abd9f614426e" +BASE_URL="https://t-sonarqube-x1.devops.lmru.tech/sonarqube/api/users" + +update_identity_provider() { + login=$1 + curl -s -u "${TOKEN}:" -X POST "${BASE_URL}/update_identity_provider?login=${login}&newExternalProvider=saml" +} + +for i in {1..2}; +do + #response=$(curl -s -u "${TOKEN}:" "${BASE_URL}/search?ps=500&p=$i") + #logins=$(echo $response | jq -r '.users[] | select(.login | . != "admin" and . !="bricks-sonar-service-account" and . !="jenkins") | .login') + logins=60231159 + for login in $logins; do + update_result=$(update_identity_provider $login) + echo "Updated $login: $update_result" + done +done \ No newline at end of file diff --git a/test_payload.json b/test_payload.json new file mode 100644 index 0000000..ebdb920 --- /dev/null +++ b/test_payload.json @@ -0,0 +1,32 @@ +{ + "category": "file", + "cluster": "k8s-yc-techno-stage", + "container": "itsec-pipeline-scanner", + "containerid": "b0f8865c5ea4d9f21861e39497f046dc92eaeadbe9c3b9e926f27f5bd5dbdef2", + "data": "{\"timestamp\":1717490469193,\"time\":1717490469,\"subtype\":\"alert\",\"user\":\"0\",\"uid\":\"0\",\"action\":\"exec\",\"command\":\"git clone -b master https://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@github.lmru.tech/adeo/lmru--hr--intraru--currency repo_folder\",\"image\":\"docker-security.art.lmru.tech/itsec-pipeline-scanner-test:37\",\"imageid\":\"328b125da6657b0d0910f5906766cfac05bb22276ec61ed8e9c1fb45bbe12589\",\"container\":\"itsec-pipeline-scanner\",\"containerid\":\"b0f8865c5ea4d9f21861e39497f046dc92eaeadbe9c3b9e926f27f5bd5dbdef2\",\"host\":\"s-shared-ks-application-nodes-d421333b-5647f-c6qx9\",\"hostip\":\"172.16.1.83\",\"hostid\":\"eb49f2d4-0569-4507-991e-bc17df1c4e1f\",\"hostgroup\":\"enforcer-shared-stage\",\"category\":\"file\",\"resource\":\"/usr/bin/git\",\"process\":\"/usr/local/bin/python3.10\",\"pid\":17,\"ppid\":1,\"rule\":\"Aqua default runtime policy\",\"rule_type\":\"runtime.policy\",\"result\":3,\"level\":\"detect\",\"reason\":\"Cryptocurrency mining detection\",\"severity\":4,\"control\":\"Block Cryptocurrency Mining\",\"podname\":\"itsec-pipeline-scanner-job-1-d4kdt\",\"podnamespace\":\"aqua\",\"podtype\":\"container\",\"podjob\":\"itsec-pipeline-scanner-job\",\"k8s_cluster\":\"k8s-yc-techno-stage\",\"tactic\":\"Defense Evasion\",\"technique\":\"Resource Hijacking\"}", + "event_category": "incident", + "guid": "5044fa93-7375-4728-af40-d3e02048d2ad", + "host": "s-shared-ks-application-nodes-d421333b-5647f-c6qx9", + "host_group": "enforcer-shared-stage", + "hostid": "eb49f2d4-0569-4507-991e-bc17df1c4e1f", + "id": 806808, + "image": "docker-security.art.lmru.tech/itsec-pipeline-scanner-test:37", + "last_occur_time": 1717490469193, + "main_category": "runtime", + "name": "Block Cryptocurrency Mining", + "postee": { + "AquaServer": "" + }, + "response_policy_name": "Test policy-1", + "result": 3, + "severity": "critical", + "severity_score": 4, + "source": "", + "source_id": "", + "suppressed_count": 0, + "time": 1717490469, + "timestamp": 1717490469193, + "type": "Runtime", + "url": "https://aquasec-stage.lmru.tech/#/alerts/details/5044fa93-7375-4728-af40-d3e02048d2ad/summary", + "user_response": "{}" +}

9xG7CG#j>kV4 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 B{VM=_kQ!<%zMAL^Cg)~06G4=I4n2_ zfM0>p9co88`zw_icm*tA!6Go)D>PteM~nyoPS>{^D^~+W0ErSr&|#zv8!Cx7sR5Uc zO5(SqMux1&O0dSIri2=F(wDuR8<#N)?aTu}=Iot>pheDaEu zViqi@R{R|@u2-Qp^gD1_7t@&2GUJSUl;DkxwWprT$s3NXvTG5F&0?N0arZw?tnBxE zVy0i^+ny_i87pG5eT*2c5Na2yxa3(xsFd(Bb?;n=*YpXERgJR)|~Ci}t48F84upaY<)3C-?olxs%@_O!sYH$I{L6 zsNN@6#~of6&%2yu{i+xbQy8F2M)laDNtw*JoGc^7TX3#|=$$57XrP5AT56!BqsO0z zzoE4=xeK&Wp~!Qjs4}7Qs&BhnBGIo|r2BjfpwW;U8oU${f9`YJlY|K*PZhPPj5U<8rjltWnfLZrW$r|KQb)5V3)u#mJJs}1U#+9L ima4!UJQ+>bCif>>N@!#kKe-2P+c=F5oks&SO#B~1s~nyH literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/__pycache__/_windows.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/__pycache__/_windows.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..62b5220c1f8487984b004656a8f7d3fd480803a6 GIT binary patch literal 15750 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 Jndn=f{||>R(2xKC literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/_api.py b/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/_api.py new file mode 100644 index 0000000..b1ea3b0 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/_api.py @@ -0,0 +1,313 @@ +import os +import platform +import socket +import ssl +import sys +import typing + +import _ssl # type: ignore[import-not-found] + +from ._ssl_constants import ( + _original_SSLContext, + _original_super_SSLContext, + _truststore_SSLContext_dunder_class, + _truststore_SSLContext_super_class, +) + +if platform.system() == "Windows": + from ._windows import _configure_context, _verify_peercerts_impl +elif platform.system() == "Darwin": + from ._macos import _configure_context, _verify_peercerts_impl +else: + from ._openssl import _configure_context, _verify_peercerts_impl + +if typing.TYPE_CHECKING: + from pip._vendor.typing_extensions import Buffer + +# From typeshed/stdlib/ssl.pyi +_StrOrBytesPath: typing.TypeAlias = str | bytes | os.PathLike[str] | os.PathLike[bytes] +_PasswordType: typing.TypeAlias = str | bytes | typing.Callable[[], str | bytes] + + +def inject_into_ssl() -> None: + """Injects the :class:`truststore.SSLContext` into the ``ssl`` + module by replacing :class:`ssl.SSLContext`. + """ + setattr(ssl, "SSLContext", SSLContext) + # urllib3 holds on to its own reference of ssl.SSLContext + # so we need to replace that reference too. + try: + import pip._vendor.urllib3.util.ssl_ as urllib3_ssl + + setattr(urllib3_ssl, "SSLContext", SSLContext) + except ImportError: + pass + + +def extract_from_ssl() -> None: + """Restores the :class:`ssl.SSLContext` class to its original state""" + setattr(ssl, "SSLContext", _original_SSLContext) + try: + import pip._vendor.urllib3.util.ssl_ as urllib3_ssl + + urllib3_ssl.SSLContext = _original_SSLContext # type: ignore[assignment] + except ImportError: + pass + + +class SSLContext(_truststore_SSLContext_super_class): # type: ignore[misc] + """SSLContext API that uses system certificates on all platforms""" + + @property # type: ignore[misc] + def __class__(self) -> type: + # Dirty hack to get around isinstance() checks + # for ssl.SSLContext instances in aiohttp/trustme + # when using non-CPython implementations. + return _truststore_SSLContext_dunder_class or SSLContext + + def __init__(self, protocol: int = None) -> None: # type: ignore[assignment] + self._ctx = _original_SSLContext(protocol) + + class TruststoreSSLObject(ssl.SSLObject): + # This object exists because wrap_bio() doesn't + # immediately do the handshake so we need to do + # certificate verifications after SSLObject.do_handshake() + + def do_handshake(self) -> None: + ret = super().do_handshake() + _verify_peercerts(self, server_hostname=self.server_hostname) + return ret + + self._ctx.sslobject_class = TruststoreSSLObject + + def wrap_socket( + self, + sock: socket.socket, + server_side: bool = False, + do_handshake_on_connect: bool = True, + suppress_ragged_eofs: bool = True, + server_hostname: str | None = None, + session: ssl.SSLSession | None = None, + ) -> ssl.SSLSocket: + # Use a context manager here because the + # inner SSLContext holds on to our state + # but also does the actual handshake. + with _configure_context(self._ctx): + ssl_sock = self._ctx.wrap_socket( + sock, + server_side=server_side, + server_hostname=server_hostname, + do_handshake_on_connect=do_handshake_on_connect, + suppress_ragged_eofs=suppress_ragged_eofs, + session=session, + ) + try: + _verify_peercerts(ssl_sock, server_hostname=server_hostname) + except Exception: + ssl_sock.close() + raise + return ssl_sock + + def wrap_bio( + self, + incoming: ssl.MemoryBIO, + outgoing: ssl.MemoryBIO, + server_side: bool = False, + server_hostname: str | None = None, + session: ssl.SSLSession | None = None, + ) -> ssl.SSLObject: + with _configure_context(self._ctx): + ssl_obj = self._ctx.wrap_bio( + incoming, + outgoing, + server_hostname=server_hostname, + server_side=server_side, + session=session, + ) + return ssl_obj + + def load_verify_locations( + self, + cafile: str | bytes | os.PathLike[str] | os.PathLike[bytes] | None = None, + capath: str | bytes | os.PathLike[str] | os.PathLike[bytes] | None = None, + cadata: typing.Union[str, "Buffer", None] = None, + ) -> None: + return self._ctx.load_verify_locations( + cafile=cafile, capath=capath, cadata=cadata + ) + + def load_cert_chain( + self, + certfile: _StrOrBytesPath, + keyfile: _StrOrBytesPath | None = None, + password: _PasswordType | None = None, + ) -> None: + return self._ctx.load_cert_chain( + certfile=certfile, keyfile=keyfile, password=password + ) + + def load_default_certs( + self, purpose: ssl.Purpose = ssl.Purpose.SERVER_AUTH + ) -> None: + return self._ctx.load_default_certs(purpose) + + def set_alpn_protocols(self, alpn_protocols: typing.Iterable[str]) -> None: + return self._ctx.set_alpn_protocols(alpn_protocols) + + def set_npn_protocols(self, npn_protocols: typing.Iterable[str]) -> None: + return self._ctx.set_npn_protocols(npn_protocols) + + def set_ciphers(self, __cipherlist: str) -> None: + return self._ctx.set_ciphers(__cipherlist) + + def get_ciphers(self) -> typing.Any: + return self._ctx.get_ciphers() + + def session_stats(self) -> dict[str, int]: + return self._ctx.session_stats() + + def cert_store_stats(self) -> dict[str, int]: + raise NotImplementedError() + + @typing.overload + def get_ca_certs( + self, binary_form: typing.Literal[False] = ... + ) -> list[typing.Any]: ... + + @typing.overload + def get_ca_certs(self, binary_form: typing.Literal[True] = ...) -> list[bytes]: ... + + @typing.overload + def get_ca_certs(self, binary_form: bool = ...) -> typing.Any: ... + + def get_ca_certs(self, binary_form: bool = False) -> list[typing.Any] | list[bytes]: + raise NotImplementedError() + + @property + def check_hostname(self) -> bool: + return self._ctx.check_hostname + + @check_hostname.setter + def check_hostname(self, value: bool) -> None: + self._ctx.check_hostname = value + + @property + def hostname_checks_common_name(self) -> bool: + return self._ctx.hostname_checks_common_name + + @hostname_checks_common_name.setter + def hostname_checks_common_name(self, value: bool) -> None: + self._ctx.hostname_checks_common_name = value + + @property + def keylog_filename(self) -> str: + return self._ctx.keylog_filename + + @keylog_filename.setter + def keylog_filename(self, value: str) -> None: + self._ctx.keylog_filename = value + + @property + def maximum_version(self) -> ssl.TLSVersion: + return self._ctx.maximum_version + + @maximum_version.setter + def maximum_version(self, value: ssl.TLSVersion) -> None: + _original_super_SSLContext.maximum_version.__set__( # type: ignore[attr-defined] + self._ctx, value + ) + + @property + def minimum_version(self) -> ssl.TLSVersion: + return self._ctx.minimum_version + + @minimum_version.setter + def minimum_version(self, value: ssl.TLSVersion) -> None: + _original_super_SSLContext.minimum_version.__set__( # type: ignore[attr-defined] + self._ctx, value + ) + + @property + def options(self) -> ssl.Options: + return self._ctx.options + + @options.setter + def options(self, value: ssl.Options) -> None: + _original_super_SSLContext.options.__set__( # type: ignore[attr-defined] + self._ctx, value + ) + + @property + def post_handshake_auth(self) -> bool: + return self._ctx.post_handshake_auth + + @post_handshake_auth.setter + def post_handshake_auth(self, value: bool) -> None: + self._ctx.post_handshake_auth = value + + @property + def protocol(self) -> ssl._SSLMethod: + return self._ctx.protocol + + @property + def security_level(self) -> int: + return self._ctx.security_level + + @property + def verify_flags(self) -> ssl.VerifyFlags: + return self._ctx.verify_flags + + @verify_flags.setter + def verify_flags(self, value: ssl.VerifyFlags) -> None: + _original_super_SSLContext.verify_flags.__set__( # type: ignore[attr-defined] + self._ctx, value + ) + + @property + def verify_mode(self) -> ssl.VerifyMode: + return self._ctx.verify_mode + + @verify_mode.setter + def verify_mode(self, value: ssl.VerifyMode) -> None: + _original_super_SSLContext.verify_mode.__set__( # type: ignore[attr-defined] + self._ctx, value + ) + + +# Python 3.13+ makes get_unverified_chain() a public API that only returns DER +# encoded certificates. We detect whether we need to call public_bytes() for 3.10->3.12 +# Pre-3.13 returned None instead of an empty list from get_unverified_chain() +if sys.version_info >= (3, 13): + + def _get_unverified_chain_bytes(sslobj: ssl.SSLObject) -> list[bytes]: + unverified_chain = sslobj.get_unverified_chain() or () # type: ignore[attr-defined] + return [ + cert if isinstance(cert, bytes) else cert.public_bytes(_ssl.ENCODING_DER) + for cert in unverified_chain + ] + +else: + + def _get_unverified_chain_bytes(sslobj: ssl.SSLObject) -> list[bytes]: + unverified_chain = sslobj.get_unverified_chain() or () # type: ignore[attr-defined] + return [cert.public_bytes(_ssl.ENCODING_DER) for cert in unverified_chain] + + +def _verify_peercerts( + sock_or_sslobj: ssl.SSLSocket | ssl.SSLObject, server_hostname: str | None +) -> None: + """ + Verifies the peer certificates from an SSLSocket or SSLObject + against the certificates in the OS trust store. + """ + sslobj: ssl.SSLObject = sock_or_sslobj # type: ignore[assignment] + try: + while not hasattr(sslobj, "get_unverified_chain"): + sslobj = sslobj._sslobj # type: ignore[attr-defined] + except AttributeError: + pass + + cert_bytes = _get_unverified_chain_bytes(sslobj) + _verify_peercerts_impl( + sock_or_sslobj.context, cert_bytes, server_hostname=server_hostname + ) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/_macos.py b/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/_macos.py new file mode 100644 index 0000000..b234ffe --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/_macos.py @@ -0,0 +1,499 @@ +import contextlib +import ctypes +import platform +import ssl +import typing +from ctypes import ( + CDLL, + POINTER, + c_bool, + c_char_p, + c_int32, + c_long, + c_uint32, + c_ulong, + c_void_p, +) +from ctypes.util import find_library + +from ._ssl_constants import _set_ssl_context_verify_mode + +_mac_version = platform.mac_ver()[0] +_mac_version_info = tuple(map(int, _mac_version.split("."))) +if _mac_version_info < (10, 8): + raise ImportError( + f"Only OS X 10.8 and newer are supported, not {_mac_version_info[0]}.{_mac_version_info[1]}" + ) + + +def _load_cdll(name: str, macos10_16_path: str) -> CDLL: + """Loads a CDLL by name, falling back to known path on 10.16+""" + try: + # Big Sur is technically 11 but we use 10.16 due to the Big Sur + # beta being labeled as 10.16. + path: str | None + if _mac_version_info >= (10, 16): + path = macos10_16_path + else: + path = find_library(name) + if not path: + raise OSError # Caught and reraised as 'ImportError' + return CDLL(path, use_errno=True) + except OSError: + raise ImportError(f"The library {name} failed to load") from None + + +Security = _load_cdll( + "Security", "/System/Library/Frameworks/Security.framework/Security" +) +CoreFoundation = _load_cdll( + "CoreFoundation", + "/System/Library/Frameworks/CoreFoundation.framework/CoreFoundation", +) + +Boolean = c_bool +CFIndex = c_long +CFStringEncoding = c_uint32 +CFData = c_void_p +CFString = c_void_p +CFArray = c_void_p +CFMutableArray = c_void_p +CFError = c_void_p +CFType = c_void_p +CFTypeID = c_ulong +CFTypeRef = POINTER(CFType) +CFAllocatorRef = c_void_p + +OSStatus = c_int32 + +CFErrorRef = POINTER(CFError) +CFDataRef = POINTER(CFData) +CFStringRef = POINTER(CFString) +CFArrayRef = POINTER(CFArray) +CFMutableArrayRef = POINTER(CFMutableArray) +CFArrayCallBacks = c_void_p +CFOptionFlags = c_uint32 + +SecCertificateRef = POINTER(c_void_p) +SecPolicyRef = POINTER(c_void_p) +SecTrustRef = POINTER(c_void_p) +SecTrustResultType = c_uint32 +SecTrustOptionFlags = c_uint32 + +try: + Security.SecCertificateCreateWithData.argtypes = [CFAllocatorRef, CFDataRef] + Security.SecCertificateCreateWithData.restype = SecCertificateRef + + Security.SecCertificateCopyData.argtypes = [SecCertificateRef] + Security.SecCertificateCopyData.restype = CFDataRef + + Security.SecCopyErrorMessageString.argtypes = [OSStatus, c_void_p] + Security.SecCopyErrorMessageString.restype = CFStringRef + + Security.SecTrustSetAnchorCertificates.argtypes = [SecTrustRef, CFArrayRef] + Security.SecTrustSetAnchorCertificates.restype = OSStatus + + Security.SecTrustSetAnchorCertificatesOnly.argtypes = [SecTrustRef, Boolean] + Security.SecTrustSetAnchorCertificatesOnly.restype = OSStatus + + Security.SecPolicyCreateRevocation.argtypes = [CFOptionFlags] + Security.SecPolicyCreateRevocation.restype = SecPolicyRef + + Security.SecPolicyCreateSSL.argtypes = [Boolean, CFStringRef] + Security.SecPolicyCreateSSL.restype = SecPolicyRef + + Security.SecTrustCreateWithCertificates.argtypes = [ + CFTypeRef, + CFTypeRef, + POINTER(SecTrustRef), + ] + Security.SecTrustCreateWithCertificates.restype = OSStatus + + Security.SecTrustGetTrustResult.argtypes = [ + SecTrustRef, + POINTER(SecTrustResultType), + ] + Security.SecTrustGetTrustResult.restype = OSStatus + + Security.SecTrustRef = SecTrustRef # type: ignore[attr-defined] + Security.SecTrustResultType = SecTrustResultType # type: ignore[attr-defined] + Security.OSStatus = OSStatus # type: ignore[attr-defined] + + kSecRevocationUseAnyAvailableMethod = 3 + kSecRevocationRequirePositiveResponse = 8 + + CoreFoundation.CFRelease.argtypes = [CFTypeRef] + CoreFoundation.CFRelease.restype = None + + CoreFoundation.CFGetTypeID.argtypes = [CFTypeRef] + CoreFoundation.CFGetTypeID.restype = CFTypeID + + CoreFoundation.CFStringCreateWithCString.argtypes = [ + CFAllocatorRef, + c_char_p, + CFStringEncoding, + ] + CoreFoundation.CFStringCreateWithCString.restype = CFStringRef + + CoreFoundation.CFStringGetCStringPtr.argtypes = [CFStringRef, CFStringEncoding] + CoreFoundation.CFStringGetCStringPtr.restype = c_char_p + + CoreFoundation.CFStringGetCString.argtypes = [ + CFStringRef, + c_char_p, + CFIndex, + CFStringEncoding, + ] + CoreFoundation.CFStringGetCString.restype = c_bool + + CoreFoundation.CFDataCreate.argtypes = [CFAllocatorRef, c_char_p, CFIndex] + CoreFoundation.CFDataCreate.restype = CFDataRef + + CoreFoundation.CFDataGetLength.argtypes = [CFDataRef] + CoreFoundation.CFDataGetLength.restype = CFIndex + + CoreFoundation.CFDataGetBytePtr.argtypes = [CFDataRef] + CoreFoundation.CFDataGetBytePtr.restype = c_void_p + + CoreFoundation.CFArrayCreate.argtypes = [ + CFAllocatorRef, + POINTER(CFTypeRef), + CFIndex, + CFArrayCallBacks, + ] + CoreFoundation.CFArrayCreate.restype = CFArrayRef + + CoreFoundation.CFArrayCreateMutable.argtypes = [ + CFAllocatorRef, + CFIndex, + CFArrayCallBacks, + ] + CoreFoundation.CFArrayCreateMutable.restype = CFMutableArrayRef + + CoreFoundation.CFArrayAppendValue.argtypes = [CFMutableArrayRef, c_void_p] + CoreFoundation.CFArrayAppendValue.restype = None + + CoreFoundation.CFArrayGetCount.argtypes = [CFArrayRef] + CoreFoundation.CFArrayGetCount.restype = CFIndex + + CoreFoundation.CFArrayGetValueAtIndex.argtypes = [CFArrayRef, CFIndex] + CoreFoundation.CFArrayGetValueAtIndex.restype = c_void_p + + CoreFoundation.CFErrorGetCode.argtypes = [CFErrorRef] + CoreFoundation.CFErrorGetCode.restype = CFIndex + + CoreFoundation.CFErrorCopyDescription.argtypes = [CFErrorRef] + CoreFoundation.CFErrorCopyDescription.restype = CFStringRef + + CoreFoundation.kCFAllocatorDefault = CFAllocatorRef.in_dll( # type: ignore[attr-defined] + CoreFoundation, "kCFAllocatorDefault" + ) + CoreFoundation.kCFTypeArrayCallBacks = c_void_p.in_dll( # type: ignore[attr-defined] + CoreFoundation, "kCFTypeArrayCallBacks" + ) + + CoreFoundation.CFTypeRef = CFTypeRef # type: ignore[attr-defined] + CoreFoundation.CFArrayRef = CFArrayRef # type: ignore[attr-defined] + CoreFoundation.CFStringRef = CFStringRef # type: ignore[attr-defined] + CoreFoundation.CFErrorRef = CFErrorRef # type: ignore[attr-defined] + +except AttributeError: + raise ImportError("Error initializing ctypes") from None + + +def _handle_osstatus(result: OSStatus, _: typing.Any, args: typing.Any) -> typing.Any: + """ + Raises an error if the OSStatus value is non-zero. + """ + if int(result) == 0: + return args + + # Returns a CFString which we need to transform + # into a UTF-8 Python string. + error_message_cfstring = None + try: + error_message_cfstring = Security.SecCopyErrorMessageString(result, None) + + # First step is convert the CFString into a C string pointer. + # We try the fast no-copy way first. + error_message_cfstring_c_void_p = ctypes.cast( + error_message_cfstring, ctypes.POINTER(ctypes.c_void_p) + ) + message = CoreFoundation.CFStringGetCStringPtr( + error_message_cfstring_c_void_p, CFConst.kCFStringEncodingUTF8 + ) + + # Quoting the Apple dev docs: + # + # "A pointer to a C string or NULL if the internal + # storage of theString does not allow this to be + # returned efficiently." + # + # So we need to get our hands dirty. + if message is None: + buffer = ctypes.create_string_buffer(1024) + result = CoreFoundation.CFStringGetCString( + error_message_cfstring_c_void_p, + buffer, + 1024, + CFConst.kCFStringEncodingUTF8, + ) + if not result: + raise OSError("Error copying C string from CFStringRef") + message = buffer.value + + finally: + if error_message_cfstring is not None: + CoreFoundation.CFRelease(error_message_cfstring) + + # If no message can be found for this status we come + # up with a generic one that forwards the status code. + if message is None or message == "": + message = f"SecureTransport operation returned a non-zero OSStatus: {result}" + + raise ssl.SSLError(message) + + +Security.SecTrustCreateWithCertificates.errcheck = _handle_osstatus # type: ignore[assignment] +Security.SecTrustSetAnchorCertificates.errcheck = _handle_osstatus # type: ignore[assignment] +Security.SecTrustSetAnchorCertificatesOnly.errcheck = _handle_osstatus # type: ignore[assignment] +Security.SecTrustGetTrustResult.errcheck = _handle_osstatus # type: ignore[assignment] + + +class CFConst: + """CoreFoundation constants""" + + kCFStringEncodingUTF8 = CFStringEncoding(0x08000100) + + errSecIncompleteCertRevocationCheck = -67635 + errSecHostNameMismatch = -67602 + errSecCertificateExpired = -67818 + errSecNotTrusted = -67843 + + +def _bytes_to_cf_data_ref(value: bytes) -> CFDataRef: # type: ignore[valid-type] + return CoreFoundation.CFDataCreate( # type: ignore[no-any-return] + CoreFoundation.kCFAllocatorDefault, value, len(value) + ) + + +def _bytes_to_cf_string(value: bytes) -> CFString: + """ + Given a Python binary data, create a CFString. + The string must be CFReleased by the caller. + """ + c_str = ctypes.c_char_p(value) + cf_str = CoreFoundation.CFStringCreateWithCString( + CoreFoundation.kCFAllocatorDefault, + c_str, + CFConst.kCFStringEncodingUTF8, + ) + return cf_str # type: ignore[no-any-return] + + +def _cf_string_ref_to_str(cf_string_ref: CFStringRef) -> str | None: # type: ignore[valid-type] + """ + Creates a Unicode string from a CFString object. Used entirely for error + reporting. + Yes, it annoys me quite a lot that this function is this complex. + """ + + string = CoreFoundation.CFStringGetCStringPtr( + cf_string_ref, CFConst.kCFStringEncodingUTF8 + ) + if string is None: + buffer = ctypes.create_string_buffer(1024) + result = CoreFoundation.CFStringGetCString( + cf_string_ref, buffer, 1024, CFConst.kCFStringEncodingUTF8 + ) + if not result: + raise OSError("Error copying C string from CFStringRef") + string = buffer.value + if string is not None: + string = string.decode("utf-8") + return string # type: ignore[no-any-return] + + +def _der_certs_to_cf_cert_array(certs: list[bytes]) -> CFMutableArrayRef: # type: ignore[valid-type] + """Builds a CFArray of SecCertificateRefs from a list of DER-encoded certificates. + Responsibility of the caller to call CoreFoundation.CFRelease on the CFArray. + """ + cf_array = CoreFoundation.CFArrayCreateMutable( + CoreFoundation.kCFAllocatorDefault, + 0, + ctypes.byref(CoreFoundation.kCFTypeArrayCallBacks), + ) + if not cf_array: + raise MemoryError("Unable to allocate memory!") + + for cert_data in certs: + cf_data = None + sec_cert_ref = None + try: + cf_data = _bytes_to_cf_data_ref(cert_data) + sec_cert_ref = Security.SecCertificateCreateWithData( + CoreFoundation.kCFAllocatorDefault, cf_data + ) + CoreFoundation.CFArrayAppendValue(cf_array, sec_cert_ref) + finally: + if cf_data: + CoreFoundation.CFRelease(cf_data) + if sec_cert_ref: + CoreFoundation.CFRelease(sec_cert_ref) + + return cf_array # type: ignore[no-any-return] + + +@contextlib.contextmanager +def _configure_context(ctx: ssl.SSLContext) -> typing.Iterator[None]: + check_hostname = ctx.check_hostname + verify_mode = ctx.verify_mode + ctx.check_hostname = False + _set_ssl_context_verify_mode(ctx, ssl.CERT_NONE) + try: + yield + finally: + ctx.check_hostname = check_hostname + _set_ssl_context_verify_mode(ctx, verify_mode) + + +def _verify_peercerts_impl( + ssl_context: ssl.SSLContext, + cert_chain: list[bytes], + server_hostname: str | None = None, +) -> None: + certs = None + policies = None + trust = None + cf_error = None + try: + if server_hostname is not None: + cf_str_hostname = None + try: + cf_str_hostname = _bytes_to_cf_string(server_hostname.encode("ascii")) + ssl_policy = Security.SecPolicyCreateSSL(True, cf_str_hostname) + finally: + if cf_str_hostname: + CoreFoundation.CFRelease(cf_str_hostname) + else: + ssl_policy = Security.SecPolicyCreateSSL(True, None) + + policies = ssl_policy + if ssl_context.verify_flags & ssl.VERIFY_CRL_CHECK_CHAIN: + # Add explicit policy requiring positive revocation checks + policies = CoreFoundation.CFArrayCreateMutable( + CoreFoundation.kCFAllocatorDefault, + 0, + ctypes.byref(CoreFoundation.kCFTypeArrayCallBacks), + ) + CoreFoundation.CFArrayAppendValue(policies, ssl_policy) + CoreFoundation.CFRelease(ssl_policy) + revocation_policy = Security.SecPolicyCreateRevocation( + kSecRevocationUseAnyAvailableMethod + | kSecRevocationRequirePositiveResponse + ) + CoreFoundation.CFArrayAppendValue(policies, revocation_policy) + CoreFoundation.CFRelease(revocation_policy) + elif ssl_context.verify_flags & ssl.VERIFY_CRL_CHECK_LEAF: + raise NotImplementedError("VERIFY_CRL_CHECK_LEAF not implemented for macOS") + + certs = None + try: + certs = _der_certs_to_cf_cert_array(cert_chain) + + # Now that we have certificates loaded and a SecPolicy + # we can finally create a SecTrust object! + trust = Security.SecTrustRef() + Security.SecTrustCreateWithCertificates( + certs, policies, ctypes.byref(trust) + ) + + finally: + # The certs are now being held by SecTrust so we can + # release our handles for the array. + if certs: + CoreFoundation.CFRelease(certs) + + # If there are additional trust anchors to load we need to transform + # the list of DER-encoded certificates into a CFArray. + ctx_ca_certs_der: list[bytes] | None = ssl_context.get_ca_certs( + binary_form=True + ) + if ctx_ca_certs_der: + ctx_ca_certs = None + try: + ctx_ca_certs = _der_certs_to_cf_cert_array(ctx_ca_certs_der) + Security.SecTrustSetAnchorCertificates(trust, ctx_ca_certs) + finally: + if ctx_ca_certs: + CoreFoundation.CFRelease(ctx_ca_certs) + + # We always want system certificates. + Security.SecTrustSetAnchorCertificatesOnly(trust, False) + + cf_error = CoreFoundation.CFErrorRef() + sec_trust_eval_result = Security.SecTrustEvaluateWithError( + trust, ctypes.byref(cf_error) + ) + # sec_trust_eval_result is a bool (0 or 1) + # where 1 means that the certs are trusted. + if sec_trust_eval_result == 1: + is_trusted = True + elif sec_trust_eval_result == 0: + is_trusted = False + else: + raise ssl.SSLError( + f"Unknown result from Security.SecTrustEvaluateWithError: {sec_trust_eval_result!r}" + ) + + cf_error_code = 0 + if not is_trusted: + cf_error_code = CoreFoundation.CFErrorGetCode(cf_error) + + # If the error is a known failure that we're + # explicitly okay with from SSLContext configuration + # we can set is_trusted accordingly. + if ssl_context.verify_mode != ssl.CERT_REQUIRED and ( + cf_error_code == CFConst.errSecNotTrusted + or cf_error_code == CFConst.errSecCertificateExpired + ): + is_trusted = True + elif ( + not ssl_context.check_hostname + and cf_error_code == CFConst.errSecHostNameMismatch + ): + is_trusted = True + + # If we're still not trusted then we start to + # construct and raise the SSLCertVerificationError. + if not is_trusted: + cf_error_string_ref = None + try: + cf_error_string_ref = CoreFoundation.CFErrorCopyDescription(cf_error) + + # Can this ever return 'None' if there's a CFError? + cf_error_message = ( + _cf_string_ref_to_str(cf_error_string_ref) + or "Certificate verification failed" + ) + + # TODO: Not sure if we need the SecTrustResultType for anything? + # We only care whether or not it's a success or failure for now. + sec_trust_result_type = Security.SecTrustResultType() + Security.SecTrustGetTrustResult( + trust, ctypes.byref(sec_trust_result_type) + ) + + err = ssl.SSLCertVerificationError(cf_error_message) + err.verify_message = cf_error_message + err.verify_code = cf_error_code + raise err + finally: + if cf_error_string_ref: + CoreFoundation.CFRelease(cf_error_string_ref) + + finally: + if policies: + CoreFoundation.CFRelease(policies) + if trust: + CoreFoundation.CFRelease(trust) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/_openssl.py b/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/_openssl.py new file mode 100644 index 0000000..9951cf7 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/_openssl.py @@ -0,0 +1,66 @@ +import contextlib +import os +import re +import ssl +import typing + +# candidates based on https://github.com/tiran/certifi-system-store by Christian Heimes +_CA_FILE_CANDIDATES = [ + # Alpine, Arch, Fedora 34+, OpenWRT, RHEL 9+, BSD + "/etc/ssl/cert.pem", + # Fedora <= 34, RHEL <= 9, CentOS <= 9 + "/etc/pki/tls/cert.pem", + # Debian, Ubuntu (requires ca-certificates) + "/etc/ssl/certs/ca-certificates.crt", + # SUSE + "/etc/ssl/ca-bundle.pem", +] + +_HASHED_CERT_FILENAME_RE = re.compile(r"^[0-9a-fA-F]{8}\.[0-9]$") + + +@contextlib.contextmanager +def _configure_context(ctx: ssl.SSLContext) -> typing.Iterator[None]: + # First, check whether the default locations from OpenSSL + # seem like they will give us a usable set of CA certs. + # ssl.get_default_verify_paths already takes care of: + # - getting cafile from either the SSL_CERT_FILE env var + # or the path configured when OpenSSL was compiled, + # and verifying that that path exists + # - getting capath from either the SSL_CERT_DIR env var + # or the path configured when OpenSSL was compiled, + # and verifying that that path exists + # In addition we'll check whether capath appears to contain certs. + defaults = ssl.get_default_verify_paths() + if defaults.cafile or (defaults.capath and _capath_contains_certs(defaults.capath)): + ctx.set_default_verify_paths() + else: + # cafile from OpenSSL doesn't exist + # and capath from OpenSSL doesn't contain certs. + # Let's search other common locations instead. + for cafile in _CA_FILE_CANDIDATES: + if os.path.isfile(cafile): + ctx.load_verify_locations(cafile=cafile) + break + + yield + + +def _capath_contains_certs(capath: str) -> bool: + """Check whether capath exists and contains certs in the expected format.""" + if not os.path.isdir(capath): + return False + for name in os.listdir(capath): + if _HASHED_CERT_FILENAME_RE.match(name): + return True + return False + + +def _verify_peercerts_impl( + ssl_context: ssl.SSLContext, + cert_chain: list[bytes], + server_hostname: str | None = None, +) -> None: + # This is a no-op because we've enabled SSLContext's built-in + # verification via verify_mode=CERT_REQUIRED, and don't need to repeat it. + pass diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/_ssl_constants.py b/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/_ssl_constants.py new file mode 100644 index 0000000..b1ee7a3 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/_ssl_constants.py @@ -0,0 +1,31 @@ +import ssl +import sys +import typing + +# Hold on to the original class so we can create it consistently +# even if we inject our own SSLContext into the ssl module. +_original_SSLContext = ssl.SSLContext +_original_super_SSLContext = super(_original_SSLContext, _original_SSLContext) + +# CPython is known to be good, but non-CPython implementations +# may implement SSLContext differently so to be safe we don't +# subclass the SSLContext. + +# This is returned by truststore.SSLContext.__class__() +_truststore_SSLContext_dunder_class: typing.Optional[type] + +# This value is the superclass of truststore.SSLContext. +_truststore_SSLContext_super_class: type + +if sys.implementation.name == "cpython": + _truststore_SSLContext_super_class = _original_SSLContext + _truststore_SSLContext_dunder_class = None +else: + _truststore_SSLContext_super_class = object + _truststore_SSLContext_dunder_class = _original_SSLContext + + +def _set_ssl_context_verify_mode( + ssl_context: ssl.SSLContext, verify_mode: ssl.VerifyMode +) -> None: + _original_super_SSLContext.verify_mode.__set__(ssl_context, verify_mode) # type: ignore[attr-defined] diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/_windows.py b/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/_windows.py new file mode 100644 index 0000000..3d00d46 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/_windows.py @@ -0,0 +1,564 @@ +import contextlib +import ssl +import typing +from ctypes import WinDLL # type: ignore +from ctypes import WinError # type: ignore +from ctypes import ( + POINTER, + Structure, + c_char_p, + c_ulong, + c_void_p, + c_wchar_p, + cast, + create_unicode_buffer, + pointer, + sizeof, +) +from ctypes.wintypes import ( + BOOL, + DWORD, + HANDLE, + LONG, + LPCSTR, + LPCVOID, + LPCWSTR, + LPFILETIME, + LPSTR, + LPWSTR, +) +from typing import TYPE_CHECKING, Any + +from ._ssl_constants import _set_ssl_context_verify_mode + +HCERTCHAINENGINE = HANDLE +HCERTSTORE = HANDLE +HCRYPTPROV_LEGACY = HANDLE + + +class CERT_CONTEXT(Structure): + _fields_ = ( + ("dwCertEncodingType", DWORD), + ("pbCertEncoded", c_void_p), + ("cbCertEncoded", DWORD), + ("pCertInfo", c_void_p), + ("hCertStore", HCERTSTORE), + ) + + +PCERT_CONTEXT = POINTER(CERT_CONTEXT) +PCCERT_CONTEXT = POINTER(PCERT_CONTEXT) + + +class CERT_ENHKEY_USAGE(Structure): + _fields_ = ( + ("cUsageIdentifier", DWORD), + ("rgpszUsageIdentifier", POINTER(LPSTR)), + ) + + +PCERT_ENHKEY_USAGE = POINTER(CERT_ENHKEY_USAGE) + + +class CERT_USAGE_MATCH(Structure): + _fields_ = ( + ("dwType", DWORD), + ("Usage", CERT_ENHKEY_USAGE), + ) + + +class CERT_CHAIN_PARA(Structure): + _fields_ = ( + ("cbSize", DWORD), + ("RequestedUsage", CERT_USAGE_MATCH), + ("RequestedIssuancePolicy", CERT_USAGE_MATCH), + ("dwUrlRetrievalTimeout", DWORD), + ("fCheckRevocationFreshnessTime", BOOL), + ("dwRevocationFreshnessTime", DWORD), + ("pftCacheResync", LPFILETIME), + ("pStrongSignPara", c_void_p), + ("dwStrongSignFlags", DWORD), + ) + + +if TYPE_CHECKING: + PCERT_CHAIN_PARA = pointer[CERT_CHAIN_PARA] # type: ignore[misc] +else: + PCERT_CHAIN_PARA = POINTER(CERT_CHAIN_PARA) + + +class CERT_TRUST_STATUS(Structure): + _fields_ = ( + ("dwErrorStatus", DWORD), + ("dwInfoStatus", DWORD), + ) + + +class CERT_CHAIN_ELEMENT(Structure): + _fields_ = ( + ("cbSize", DWORD), + ("pCertContext", PCERT_CONTEXT), + ("TrustStatus", CERT_TRUST_STATUS), + ("pRevocationInfo", c_void_p), + ("pIssuanceUsage", PCERT_ENHKEY_USAGE), + ("pApplicationUsage", PCERT_ENHKEY_USAGE), + ("pwszExtendedErrorInfo", LPCWSTR), + ) + + +PCERT_CHAIN_ELEMENT = POINTER(CERT_CHAIN_ELEMENT) + + +class CERT_SIMPLE_CHAIN(Structure): + _fields_ = ( + ("cbSize", DWORD), + ("TrustStatus", CERT_TRUST_STATUS), + ("cElement", DWORD), + ("rgpElement", POINTER(PCERT_CHAIN_ELEMENT)), + ("pTrustListInfo", c_void_p), + ("fHasRevocationFreshnessTime", BOOL), + ("dwRevocationFreshnessTime", DWORD), + ) + + +PCERT_SIMPLE_CHAIN = POINTER(CERT_SIMPLE_CHAIN) + + +class CERT_CHAIN_CONTEXT(Structure): + _fields_ = ( + ("cbSize", DWORD), + ("TrustStatus", CERT_TRUST_STATUS), + ("cChain", DWORD), + ("rgpChain", POINTER(PCERT_SIMPLE_CHAIN)), + ("cLowerQualityChainContext", DWORD), + ("rgpLowerQualityChainContext", c_void_p), + ("fHasRevocationFreshnessTime", BOOL), + ("dwRevocationFreshnessTime", DWORD), + ) + + +PCERT_CHAIN_CONTEXT = POINTER(CERT_CHAIN_CONTEXT) +PCCERT_CHAIN_CONTEXT = POINTER(PCERT_CHAIN_CONTEXT) + + +class SSL_EXTRA_CERT_CHAIN_POLICY_PARA(Structure): + _fields_ = ( + ("cbSize", DWORD), + ("dwAuthType", DWORD), + ("fdwChecks", DWORD), + ("pwszServerName", LPCWSTR), + ) + + +class CERT_CHAIN_POLICY_PARA(Structure): + _fields_ = ( + ("cbSize", DWORD), + ("dwFlags", DWORD), + ("pvExtraPolicyPara", c_void_p), + ) + + +PCERT_CHAIN_POLICY_PARA = POINTER(CERT_CHAIN_POLICY_PARA) + + +class CERT_CHAIN_POLICY_STATUS(Structure): + _fields_ = ( + ("cbSize", DWORD), + ("dwError", DWORD), + ("lChainIndex", LONG), + ("lElementIndex", LONG), + ("pvExtraPolicyStatus", c_void_p), + ) + + +PCERT_CHAIN_POLICY_STATUS = POINTER(CERT_CHAIN_POLICY_STATUS) + + +class CERT_CHAIN_ENGINE_CONFIG(Structure): + _fields_ = ( + ("cbSize", DWORD), + ("hRestrictedRoot", HCERTSTORE), + ("hRestrictedTrust", HCERTSTORE), + ("hRestrictedOther", HCERTSTORE), + ("cAdditionalStore", DWORD), + ("rghAdditionalStore", c_void_p), + ("dwFlags", DWORD), + ("dwUrlRetrievalTimeout", DWORD), + ("MaximumCachedCertificates", DWORD), + ("CycleDetectionModulus", DWORD), + ("hExclusiveRoot", HCERTSTORE), + ("hExclusiveTrustedPeople", HCERTSTORE), + ("dwExclusiveFlags", DWORD), + ) + + +PCERT_CHAIN_ENGINE_CONFIG = POINTER(CERT_CHAIN_ENGINE_CONFIG) +PHCERTCHAINENGINE = POINTER(HCERTCHAINENGINE) + +X509_ASN_ENCODING = 0x00000001 +PKCS_7_ASN_ENCODING = 0x00010000 +CERT_STORE_PROV_MEMORY = b"Memory" +CERT_STORE_ADD_USE_EXISTING = 2 +USAGE_MATCH_TYPE_OR = 1 +OID_PKIX_KP_SERVER_AUTH = c_char_p(b"1.3.6.1.5.5.7.3.1") +CERT_CHAIN_REVOCATION_CHECK_END_CERT = 0x10000000 +CERT_CHAIN_REVOCATION_CHECK_CHAIN = 0x20000000 +CERT_CHAIN_POLICY_IGNORE_ALL_NOT_TIME_VALID_FLAGS = 0x00000007 +CERT_CHAIN_POLICY_IGNORE_INVALID_BASIC_CONSTRAINTS_FLAG = 0x00000008 +CERT_CHAIN_POLICY_ALLOW_UNKNOWN_CA_FLAG = 0x00000010 +CERT_CHAIN_POLICY_IGNORE_INVALID_NAME_FLAG = 0x00000040 +CERT_CHAIN_POLICY_IGNORE_WRONG_USAGE_FLAG = 0x00000020 +CERT_CHAIN_POLICY_IGNORE_INVALID_POLICY_FLAG = 0x00000080 +CERT_CHAIN_POLICY_IGNORE_ALL_REV_UNKNOWN_FLAGS = 0x00000F00 +CERT_CHAIN_POLICY_ALLOW_TESTROOT_FLAG = 0x00008000 +CERT_CHAIN_POLICY_TRUST_TESTROOT_FLAG = 0x00004000 +AUTHTYPE_SERVER = 2 +CERT_CHAIN_POLICY_SSL = 4 +FORMAT_MESSAGE_FROM_SYSTEM = 0x00001000 +FORMAT_MESSAGE_IGNORE_INSERTS = 0x00000200 + +# Flags to set for SSLContext.verify_mode=CERT_NONE +CERT_CHAIN_POLICY_VERIFY_MODE_NONE_FLAGS = ( + CERT_CHAIN_POLICY_IGNORE_ALL_NOT_TIME_VALID_FLAGS + | CERT_CHAIN_POLICY_IGNORE_INVALID_BASIC_CONSTRAINTS_FLAG + | CERT_CHAIN_POLICY_ALLOW_UNKNOWN_CA_FLAG + | CERT_CHAIN_POLICY_IGNORE_INVALID_NAME_FLAG + | CERT_CHAIN_POLICY_IGNORE_WRONG_USAGE_FLAG + | CERT_CHAIN_POLICY_IGNORE_INVALID_POLICY_FLAG + | CERT_CHAIN_POLICY_IGNORE_ALL_REV_UNKNOWN_FLAGS + | CERT_CHAIN_POLICY_ALLOW_TESTROOT_FLAG + | CERT_CHAIN_POLICY_TRUST_TESTROOT_FLAG +) + +wincrypt = WinDLL("crypt32.dll") +kernel32 = WinDLL("kernel32.dll") + + +def _handle_win_error(result: bool, _: Any, args: Any) -> Any: + if not result: + # Note, actually raises OSError after calling GetLastError and FormatMessage + raise WinError() + return args + + +CertCreateCertificateChainEngine = wincrypt.CertCreateCertificateChainEngine +CertCreateCertificateChainEngine.argtypes = ( + PCERT_CHAIN_ENGINE_CONFIG, + PHCERTCHAINENGINE, +) +CertCreateCertificateChainEngine.errcheck = _handle_win_error + +CertOpenStore = wincrypt.CertOpenStore +CertOpenStore.argtypes = (LPCSTR, DWORD, HCRYPTPROV_LEGACY, DWORD, c_void_p) +CertOpenStore.restype = HCERTSTORE +CertOpenStore.errcheck = _handle_win_error + +CertAddEncodedCertificateToStore = wincrypt.CertAddEncodedCertificateToStore +CertAddEncodedCertificateToStore.argtypes = ( + HCERTSTORE, + DWORD, + c_char_p, + DWORD, + DWORD, + PCCERT_CONTEXT, +) +CertAddEncodedCertificateToStore.restype = BOOL + +CertCreateCertificateContext = wincrypt.CertCreateCertificateContext +CertCreateCertificateContext.argtypes = (DWORD, c_char_p, DWORD) +CertCreateCertificateContext.restype = PCERT_CONTEXT +CertCreateCertificateContext.errcheck = _handle_win_error + +CertGetCertificateChain = wincrypt.CertGetCertificateChain +CertGetCertificateChain.argtypes = ( + HCERTCHAINENGINE, + PCERT_CONTEXT, + LPFILETIME, + HCERTSTORE, + PCERT_CHAIN_PARA, + DWORD, + c_void_p, + PCCERT_CHAIN_CONTEXT, +) +CertGetCertificateChain.restype = BOOL +CertGetCertificateChain.errcheck = _handle_win_error + +CertVerifyCertificateChainPolicy = wincrypt.CertVerifyCertificateChainPolicy +CertVerifyCertificateChainPolicy.argtypes = ( + c_ulong, + PCERT_CHAIN_CONTEXT, + PCERT_CHAIN_POLICY_PARA, + PCERT_CHAIN_POLICY_STATUS, +) +CertVerifyCertificateChainPolicy.restype = BOOL + +CertCloseStore = wincrypt.CertCloseStore +CertCloseStore.argtypes = (HCERTSTORE, DWORD) +CertCloseStore.restype = BOOL +CertCloseStore.errcheck = _handle_win_error + +CertFreeCertificateChain = wincrypt.CertFreeCertificateChain +CertFreeCertificateChain.argtypes = (PCERT_CHAIN_CONTEXT,) + +CertFreeCertificateContext = wincrypt.CertFreeCertificateContext +CertFreeCertificateContext.argtypes = (PCERT_CONTEXT,) + +CertFreeCertificateChainEngine = wincrypt.CertFreeCertificateChainEngine +CertFreeCertificateChainEngine.argtypes = (HCERTCHAINENGINE,) + +FormatMessageW = kernel32.FormatMessageW +FormatMessageW.argtypes = ( + DWORD, + LPCVOID, + DWORD, + DWORD, + LPWSTR, + DWORD, + c_void_p, +) +FormatMessageW.restype = DWORD + + +def _verify_peercerts_impl( + ssl_context: ssl.SSLContext, + cert_chain: list[bytes], + server_hostname: str | None = None, +) -> None: + """Verify the cert_chain from the server using Windows APIs.""" + + # If the peer didn't send any certificates then + # we can't do verification. Raise an error. + if not cert_chain: + raise ssl.SSLCertVerificationError("Peer sent no certificates to verify") + + pCertContext = None + hIntermediateCertStore = CertOpenStore(CERT_STORE_PROV_MEMORY, 0, None, 0, None) + try: + # Add intermediate certs to an in-memory cert store + for cert_bytes in cert_chain[1:]: + CertAddEncodedCertificateToStore( + hIntermediateCertStore, + X509_ASN_ENCODING | PKCS_7_ASN_ENCODING, + cert_bytes, + len(cert_bytes), + CERT_STORE_ADD_USE_EXISTING, + None, + ) + + # Cert context for leaf cert + leaf_cert = cert_chain[0] + pCertContext = CertCreateCertificateContext( + X509_ASN_ENCODING | PKCS_7_ASN_ENCODING, leaf_cert, len(leaf_cert) + ) + + # Chain params to match certs for serverAuth extended usage + cert_enhkey_usage = CERT_ENHKEY_USAGE() + cert_enhkey_usage.cUsageIdentifier = 1 + cert_enhkey_usage.rgpszUsageIdentifier = (c_char_p * 1)(OID_PKIX_KP_SERVER_AUTH) + cert_usage_match = CERT_USAGE_MATCH() + cert_usage_match.Usage = cert_enhkey_usage + chain_params = CERT_CHAIN_PARA() + chain_params.RequestedUsage = cert_usage_match + chain_params.cbSize = sizeof(chain_params) + pChainPara = pointer(chain_params) + + if ssl_context.verify_flags & ssl.VERIFY_CRL_CHECK_CHAIN: + chain_flags = CERT_CHAIN_REVOCATION_CHECK_CHAIN + elif ssl_context.verify_flags & ssl.VERIFY_CRL_CHECK_LEAF: + chain_flags = CERT_CHAIN_REVOCATION_CHECK_END_CERT + else: + chain_flags = 0 + + try: + # First attempt to verify using the default Windows system trust roots + # (default chain engine). + _get_and_verify_cert_chain( + ssl_context, + None, + hIntermediateCertStore, + pCertContext, + pChainPara, + server_hostname, + chain_flags=chain_flags, + ) + except ssl.SSLCertVerificationError as e: + # If that fails but custom CA certs have been added + # to the SSLContext using load_verify_locations, + # try verifying using a custom chain engine + # that trusts the custom CA certs. + custom_ca_certs: list[bytes] | None = ssl_context.get_ca_certs( + binary_form=True + ) + if custom_ca_certs: + try: + _verify_using_custom_ca_certs( + ssl_context, + custom_ca_certs, + hIntermediateCertStore, + pCertContext, + pChainPara, + server_hostname, + chain_flags=chain_flags, + ) + # Raise the original error, not the new error. + except ssl.SSLCertVerificationError: + raise e from None + else: + raise + finally: + CertCloseStore(hIntermediateCertStore, 0) + if pCertContext: + CertFreeCertificateContext(pCertContext) + + +def _get_and_verify_cert_chain( + ssl_context: ssl.SSLContext, + hChainEngine: HCERTCHAINENGINE | None, + hIntermediateCertStore: HCERTSTORE, + pPeerCertContext: c_void_p, + pChainPara: PCERT_CHAIN_PARA, # type: ignore[valid-type] + server_hostname: str | None, + chain_flags: int, +) -> None: + ppChainContext = None + try: + # Get cert chain + ppChainContext = pointer(PCERT_CHAIN_CONTEXT()) + CertGetCertificateChain( + hChainEngine, # chain engine + pPeerCertContext, # leaf cert context + None, # current system time + hIntermediateCertStore, # additional in-memory cert store + pChainPara, # chain-building parameters + chain_flags, + None, # reserved + ppChainContext, # the resulting chain context + ) + pChainContext = ppChainContext.contents + + # Verify cert chain + ssl_extra_cert_chain_policy_para = SSL_EXTRA_CERT_CHAIN_POLICY_PARA() + ssl_extra_cert_chain_policy_para.cbSize = sizeof( + ssl_extra_cert_chain_policy_para + ) + ssl_extra_cert_chain_policy_para.dwAuthType = AUTHTYPE_SERVER + ssl_extra_cert_chain_policy_para.fdwChecks = 0 + if server_hostname: + ssl_extra_cert_chain_policy_para.pwszServerName = c_wchar_p(server_hostname) + + chain_policy = CERT_CHAIN_POLICY_PARA() + chain_policy.pvExtraPolicyPara = cast( + pointer(ssl_extra_cert_chain_policy_para), c_void_p + ) + if ssl_context.verify_mode == ssl.CERT_NONE: + chain_policy.dwFlags |= CERT_CHAIN_POLICY_VERIFY_MODE_NONE_FLAGS + if not ssl_context.check_hostname: + chain_policy.dwFlags |= CERT_CHAIN_POLICY_IGNORE_INVALID_NAME_FLAG + chain_policy.cbSize = sizeof(chain_policy) + + pPolicyPara = pointer(chain_policy) + policy_status = CERT_CHAIN_POLICY_STATUS() + policy_status.cbSize = sizeof(policy_status) + pPolicyStatus = pointer(policy_status) + CertVerifyCertificateChainPolicy( + CERT_CHAIN_POLICY_SSL, + pChainContext, + pPolicyPara, + pPolicyStatus, + ) + + # Check status + error_code = policy_status.dwError + if error_code: + # Try getting a human readable message for an error code. + error_message_buf = create_unicode_buffer(1024) + error_message_chars = FormatMessageW( + FORMAT_MESSAGE_FROM_SYSTEM | FORMAT_MESSAGE_IGNORE_INSERTS, + None, + error_code, + 0, + error_message_buf, + sizeof(error_message_buf), + None, + ) + + # See if we received a message for the error, + # otherwise we use a generic error with the + # error code and hope that it's search-able. + if error_message_chars <= 0: + error_message = f"Certificate chain policy error {error_code:#x} [{policy_status.lElementIndex}]" + else: + error_message = error_message_buf.value.strip() + + err = ssl.SSLCertVerificationError(error_message) + err.verify_message = error_message + err.verify_code = error_code + raise err from None + finally: + if ppChainContext: + CertFreeCertificateChain(ppChainContext.contents) + + +def _verify_using_custom_ca_certs( + ssl_context: ssl.SSLContext, + custom_ca_certs: list[bytes], + hIntermediateCertStore: HCERTSTORE, + pPeerCertContext: c_void_p, + pChainPara: PCERT_CHAIN_PARA, # type: ignore[valid-type] + server_hostname: str | None, + chain_flags: int, +) -> None: + hChainEngine = None + hRootCertStore = CertOpenStore(CERT_STORE_PROV_MEMORY, 0, None, 0, None) + try: + # Add custom CA certs to an in-memory cert store + for cert_bytes in custom_ca_certs: + CertAddEncodedCertificateToStore( + hRootCertStore, + X509_ASN_ENCODING | PKCS_7_ASN_ENCODING, + cert_bytes, + len(cert_bytes), + CERT_STORE_ADD_USE_EXISTING, + None, + ) + + # Create a custom cert chain engine which exclusively trusts + # certs from our hRootCertStore + cert_chain_engine_config = CERT_CHAIN_ENGINE_CONFIG() + cert_chain_engine_config.cbSize = sizeof(cert_chain_engine_config) + cert_chain_engine_config.hExclusiveRoot = hRootCertStore + pConfig = pointer(cert_chain_engine_config) + phChainEngine = pointer(HCERTCHAINENGINE()) + CertCreateCertificateChainEngine( + pConfig, + phChainEngine, + ) + hChainEngine = phChainEngine.contents + + # Get and verify a cert chain using the custom chain engine + _get_and_verify_cert_chain( + ssl_context, + hChainEngine, + hIntermediateCertStore, + pPeerCertContext, + pChainPara, + server_hostname, + chain_flags, + ) + finally: + if hChainEngine: + CertFreeCertificateChainEngine(hChainEngine) + CertCloseStore(hRootCertStore, 0) + + +@contextlib.contextmanager +def _configure_context(ctx: ssl.SSLContext) -> typing.Iterator[None]: + check_hostname = ctx.check_hostname + verify_mode = ctx.verify_mode + ctx.check_hostname = False + _set_ssl_context_verify_mode(ctx, ssl.CERT_NONE) + try: + yield + finally: + ctx.check_hostname = check_hostname + _set_ssl_context_verify_mode(ctx, verify_mode) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/py.typed b/.venv/lib/python3.12/site-packages/pip/_vendor/truststore/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/typing_extensions.py b/.venv/lib/python3.12/site-packages/pip/_vendor/typing_extensions.py new file mode 100644 index 0000000..e429384 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/typing_extensions.py @@ -0,0 +1,3641 @@ +import abc +import collections +import collections.abc +import contextlib +import functools +import inspect +import operator +import sys +import types as _types +import typing +import warnings + +__all__ = [ + # Super-special typing primitives. + 'Any', + 'ClassVar', + 'Concatenate', + 'Final', + 'LiteralString', + 'ParamSpec', + 'ParamSpecArgs', + 'ParamSpecKwargs', + 'Self', + 'Type', + 'TypeVar', + 'TypeVarTuple', + 'Unpack', + + # ABCs (from collections.abc). + 'Awaitable', + 'AsyncIterator', + 'AsyncIterable', + 'Coroutine', + 'AsyncGenerator', + 'AsyncContextManager', + 'Buffer', + 'ChainMap', + + # Concrete collection types. + 'ContextManager', + 'Counter', + 'Deque', + 'DefaultDict', + 'NamedTuple', + 'OrderedDict', + 'TypedDict', + + # Structural checks, a.k.a. protocols. + 'SupportsAbs', + 'SupportsBytes', + 'SupportsComplex', + 'SupportsFloat', + 'SupportsIndex', + 'SupportsInt', + 'SupportsRound', + + # One-off things. + 'Annotated', + 'assert_never', + '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', + 'overload', + 'override', + 'Protocol', + 'reveal_type', + 'runtime', + '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', + 'NoDefault', + 'Optional', + 'Pattern', + 'Reversible', + 'Sequence', + 'Set', + 'Sized', + 'TextIO', + 'Tuple', + 'Union', + 'ValuesView', + 'cast', + 'no_type_check', + 'no_type_check_decorator', +] + +# for backward compatibility +PEP_560 = True +GenericMeta = type +_PEP_696_IMPLEMENTED = sys.version_info >= (3, 13, 0, "beta") + +# The functions below are modified copies of typing internal helpers. +# They are needed by _ProtocolMeta and they provide support for PEP 646. + + +class _Sentinel: + def __repr__(self): + return "" + + +_marker = _Sentinel() + + +if sys.version_info >= (3, 10): + def _should_collect_from_parameters(t): + return isinstance( + t, (typing._GenericAlias, _types.GenericAlias, _types.UnionType) + ) +elif sys.version_info >= (3, 9): + def _should_collect_from_parameters(t): + return isinstance(t, (typing._GenericAlias, _types.GenericAlias)) +else: + def _should_collect_from_parameters(t): + return isinstance(t, typing._GenericAlias) and not t._special + + +NoReturn = typing.NoReturn + +# Some unconstrained type variables. These are used by the container types. +# (These are not for export.) +T = typing.TypeVar('T') # Any type. +KT = typing.TypeVar('KT') # Key type. +VT = typing.TypeVar('VT') # Value type. +T_co = typing.TypeVar('T_co', covariant=True) # Any type covariant containers. +T_contra = typing.TypeVar('T_contra', contravariant=True) # Ditto contravariant. + + +if sys.version_info >= (3, 11): + from typing import Any +else: + + class _AnyMeta(type): + def __instancecheck__(self, obj): + if self is Any: + raise TypeError("typing_extensions.Any cannot be used with isinstance()") + return super().__instancecheck__(obj) + + def __repr__(self): + if self is Any: + return "typing_extensions.Any" + return super().__repr__() + + class Any(metaclass=_AnyMeta): + """Special type indicating an unconstrained type. + - Any is compatible with every type. + - Any assumed to have all methods. + - All values assumed to be instances of Any. + Note that all the above statements are true from the point of view of + static type checkers. At runtime, Any should not be used with instance + checks. + """ + def __new__(cls, *args, **kwargs): + if cls is Any: + raise TypeError("Any cannot be instantiated") + return super().__new__(cls, *args, **kwargs) + + +ClassVar = typing.ClassVar + + +class _ExtensionsSpecialForm(typing._SpecialForm, _root=True): + def __repr__(self): + return 'typing_extensions.' + self._name + + +Final = typing.Final + +if sys.version_info >= (3, 11): + final = typing.final +else: + # @final exists in 3.8+, but we backport it for all versions + # before 3.11 to keep support for the __final__ attribute. + # See https://bugs.python.org/issue46342 + def final(f): + """This decorator can be used to indicate to type checkers that + the decorated method cannot be overridden, and decorated class + cannot be subclassed. For example: + + class Base: + @final + def done(self) -> None: + ... + class Sub(Base): + def done(self) -> None: # Error reported by type checker + ... + @final + class Leaf: + ... + class Other(Leaf): # Error reported by type checker + ... + + There is no runtime checking of these properties. The decorator + sets the ``__final__`` attribute to ``True`` on the decorated object + to allow runtime introspection. + """ + try: + f.__final__ = 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 f + + +def IntVar(name): + return typing.TypeVar(name) + + +# 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 +else: + 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 _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): + if not isinstance(parameters, tuple): + parameters = (parameters,) + + 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: + + var: Literal[4] = 4 + + The type checker understands that 'var' is literally equal to + the value 4 and no other value. + + Literal[...] cannot be subclassed. There is no runtime + checking verifying that the parameter is actually a value + instead of a type.""") + + +_overload_dummy = typing._overload_dummy + + +if hasattr(typing, "get_overloads"): # 3.11+ + overload = typing.overload + get_overloads = typing.get_overloads + clear_overloads = typing.clear_overloads +else: + # {module: {qualname: {firstlineno: func}}} + _overload_registry = collections.defaultdict( + functools.partial(collections.defaultdict, dict) + ) + + def overload(func): + """Decorator for overloaded functions/methods. + + In a stub file, place two or more stub definitions for the same + function in a row, each decorated with @overload. For example: + + @overload + def utf8(value: None) -> None: ... + @overload + def utf8(value: bytes) -> bytes: ... + @overload + def utf8(value: str) -> bytes: ... + + In a non-stub file (i.e. a regular .py file), do the same but + follow it with an implementation. The implementation should *not* + be decorated with @overload. For example: + + @overload + def utf8(value: None) -> None: ... + @overload + def utf8(value: bytes) -> bytes: ... + @overload + def utf8(value: str) -> bytes: ... + def utf8(value): + # implementation goes here + + The overloads for a function can be retrieved at runtime using the + get_overloads() function. + """ + # classmethod and staticmethod + f = getattr(func, "__func__", func) + try: + _overload_registry[f.__module__][f.__qualname__][ + f.__code__.co_firstlineno + ] = func + except AttributeError: + # Not a normal function; ignore. + pass + return _overload_dummy + + def get_overloads(func): + """Return all defined overloads for *func* as a sequence.""" + # classmethod and staticmethod + f = getattr(func, "__func__", func) + if f.__module__ not in _overload_registry: + return [] + mod_dict = _overload_registry[f.__module__] + if f.__qualname__ not in mod_dict: + return [] + return list(mod_dict[f.__qualname__].values()) + + def clear_overloads(): + """Clear all overloads in the registry.""" + _overload_registry.clear() + + +# This is not a real generic class. Don't use outside annotations. +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 +AsyncIterator = typing.AsyncIterator +Deque = typing.Deque +DefaultDict = typing.DefaultDict +OrderedDict = typing.OrderedDict +Counter = typing.Counter +ChainMap = typing.ChainMap +Text = typing.Text +TYPE_CHECKING = typing.TYPE_CHECKING + + +if sys.version_info >= (3, 13, 0, "beta"): + from typing import AsyncContextManager, AsyncGenerator, ContextManager, Generator +else: + def _is_dunder(attr): + return attr.startswith('__') and attr.endswith('__') + + # Python <3.9 doesn't have typing._SpecialGenericAlias + _special_generic_alias_base = getattr( + typing, "_SpecialGenericAlias", typing._GenericAlias + ) + + class _SpecialGenericAlias(_special_generic_alias_base, _root=True): + def __init__(self, origin, nparams, *, inst=True, name=None, defaults=()): + if _special_generic_alias_base is typing._GenericAlias: + # Python <3.9 + self.__origin__ = origin + self._nparams = nparams + super().__init__(origin, nparams, special=True, inst=inst, name=name) + else: + # Python >= 3.9 + super().__init__(origin, nparams, inst=inst, name=name) + self._defaults = defaults + + def __setattr__(self, attr, val): + allowed_attrs = {'_name', '_inst', '_nparams', '_defaults'} + if _special_generic_alias_base is typing._GenericAlias: + # Python <3.9 + allowed_attrs.add("__origin__") + if _is_dunder(attr) or attr in allowed_attrs: + object.__setattr__(self, attr, val) + else: + setattr(self.__origin__, attr, val) + + @typing._tp_cache + def __getitem__(self, params): + if not isinstance(params, tuple): + params = (params,) + msg = "Parameters to generic types must be types." + params = tuple(typing._type_check(p, msg) for p in params) + if ( + self._defaults + and len(params) < self._nparams + and len(params) + len(self._defaults) >= self._nparams + ): + params = (*params, *self._defaults[len(params) - self._nparams:]) + actual_len = len(params) + + if actual_len != self._nparams: + if self._defaults: + expected = f"at least {self._nparams - len(self._defaults)}" + else: + expected = str(self._nparams) + if not self._nparams: + raise TypeError(f"{self} is not a generic class") + raise TypeError( + f"Too {'many' if actual_len > self._nparams else 'few'}" + f" arguments for {self};" + f" actual {actual_len}, expected {expected}" + ) + return self.copy_with(params) + + _NoneType = type(None) + Generator = _SpecialGenericAlias( + collections.abc.Generator, 3, defaults=(_NoneType, _NoneType) + ) + AsyncGenerator = _SpecialGenericAlias( + collections.abc.AsyncGenerator, 2, defaults=(_NoneType,) + ) + ContextManager = _SpecialGenericAlias( + contextlib.AbstractContextManager, + 2, + name="ContextManager", + defaults=(typing.Optional[bool],) + ) + AsyncContextManager = _SpecialGenericAlias( + contextlib.AbstractAsyncContextManager, + 2, + name="AsyncContextManager", + defaults=(typing.Optional[bool],) + ) + + +_PROTO_ALLOWLIST = { + 'collections.abc': [ + 'Callable', 'Awaitable', 'Iterable', 'Iterator', 'AsyncIterable', + 'Hashable', 'Sized', 'Container', 'Collection', 'Reversible', 'Buffer', + ], + 'contextlib': ['AbstractContextManager', 'AbstractAsyncContextManager'], + 'typing_extensions': ['Buffer'], +} + + +_EXCLUDED_ATTRS = frozenset(typing.EXCLUDED_ATTRIBUTES) | { + "__match_args__", "__protocol_attrs__", "__non_callable_proto_members__", + "__final__", +} + + +def _get_protocol_attrs(cls): + attrs = set() + for base in cls.__mro__[:-1]: # without object + if base.__name__ in {'Protocol', 'Generic'}: + continue + annotations = getattr(base, '__annotations__', {}) + for attr in (*base.__dict__, *annotations): + if (not attr.startswith('_abc_') and attr not in _EXCLUDED_ATTRS): + attrs.add(attr) + return attrs + + +def _caller(depth=2): + try: + return sys._getframe(depth).f_globals.get('__name__', '__main__') + except (AttributeError, ValueError): # For platforms without _getframe() + return None + + +# `__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 +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') + + 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 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 + + 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 + + return False + + 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 + + # 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) + + @classmethod + def _proto_hook(cls, other): + if not cls.__dict__.get('_is_protocol', False): + return NotImplemented + + 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 + + # ...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 + + class Protocol(typing.Generic, metaclass=_ProtocolMeta): + __doc__ = typing.Protocol.__doc__ + __slots__ = () + _is_protocol = True + _is_runtime_protocol = False + + def __init_subclass__(cls, *args, **kwargs): + super().__init_subclass__(*args, **kwargs) + + # Determine if this is a protocol or a concrete subclass. + 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. + if '__subclasshook__' not in cls.__dict__: + cls.__subclasshook__ = _proto_hook + + # Prohibit instantiation for protocol classes + if cls._is_protocol and cls.__init__ is Protocol.__init__: + cls.__init__ = _no_init + + +if sys.version_info >= (3, 13): + runtime_checkable = typing.runtime_checkable +else: + def runtime_checkable(cls): + """Mark a protocol class as a runtime protocol. + + 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 issubclass(cls, typing.Generic) or not getattr(cls, '_is_protocol', False): + raise TypeError(f'@runtime_checkable can be only applied to protocol classes,' + f' got {cls!r}') + cls._is_runtime_protocol = True + + # typing.Protocol classes on <=3.11 break if we execute this block, + # because typing.Protocol classes on <=3.11 don't have a + # `__protocol_attrs__` attribute, and this block relies on the + # `__protocol_attrs__` attribute. Meanwhile, typing.Protocol classes on 3.12.2+ + # break if we *don't* execute this block, because *they* assume that all + # protocol classes have a `__non_callable_proto_members__` attribute + # (which this block sets) + if isinstance(cls, _ProtocolMeta) or sys.version_info >= (3, 12, 2): + # 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 + + +# The "runtime" alias exists for backwards compatibility. +runtime = runtime_checkable + + +# 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 + 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__ = () + + @abc.abstractmethod + 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__ = () + + @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 + + +# Update this to something like >=3.13.0b1 if and when +# PEP 728 is implemented in CPython +_PEP_728_IMPLEMENTED = False + +if _PEP_728_IMPLEMENTED: + # 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" + # keyword with old-style TypedDict(). See https://bugs.python.org/issue42059 + # 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. + # Also on 3.13, PEP 705 adds the ReadOnly[] qualifier. + # PEP 728 (still pending) makes more changes. + TypedDict = typing.TypedDict + _TypedDictMeta = typing._TypedDictMeta + is_typeddict = typing.is_typeddict +else: + # 3.10.0 and later + _TAKES_MODULE = "module" in inspect.signature(typing._type_check).parameters + + 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 __new__(cls, name, bases, ns, *, total=True, closed=False): + """Create new typed dict class object. + + 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(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 = {} + if "__annotations__" in ns: + own_annotations = ns["__annotations__"] + elif "__annotate__" in ns: + # TODO: Use inspect.VALUE here, and make the annotations lazily evaluated + own_annotations = ns["__annotate__"](1) + else: + own_annotations = {} + msg = "TypedDict('Name', {f0: t0, f1: t1, ...}); each t must be a type" + 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: + 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(): + qualifiers = set(_get_typeddict_qualifiers(annotation_type)) + + if Required in qualifiers: + required_keys.add(annotation_key) + 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 + + __call__ = dict # static method + + def __subclasscheck__(cls, other): + # Typed dicts are only for static structural subtyping. + raise TypeError('TypedDict does not support instance and class checks') + + __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. + + Usage:: + + class Point2D(TypedDict): + x: int + y: int + label: str + + a: Point2D = {'x': 1, 'y': 2, 'label': 'good'} # OK + b: Point2D = {'z': 3, 'label': 'bad'} # Fails type check + + assert Point2D(x=1, y=2, label='first') == dict(x=1, y=2, label='first') + + The type info can be accessed via the Point2D.__annotations__ dict, and + the Point2D.__required_keys__ and Point2D.__optional_keys__ frozensets. + TypedDict supports an additional equivalent form:: + + Point2D = TypedDict('Point2D', {'x': int, 'y': int, 'label': str}) + + 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) + else: + _TYPEDDICT_TYPES = (_TypedDictMeta,) + + def is_typeddict(tp): + """Check if an annotation is a TypedDict class + + For example:: + class Film(TypedDict): + title: str + year: int + + is_typeddict(Film) # => True + is_typeddict(Union[list, str]) # => False + """ + # 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, /): + """Assert (to the type checker) that the value is of the given type. + + When the type checker encounters a call to assert_type(), it + emits an error if the value is not of the specified type:: + + def greet(name: str) -> None: + assert_type(name, str) # ok + assert_type(name, int) # type checker error + + At runtime this returns the first argument unchanged and otherwise + does nothing. + """ + return val + + +if hasattr(typing, "ReadOnly"): # 3.13+ + get_type_hints = typing.get_type_hints +else: # <=3.13 + # replaces _strip_annotations() + def _strip_extras(t): + """Strips Annotated, Required and NotRequired from a given type.""" + if isinstance(t, _AnnotatedAlias): + return _strip_extras(t.__origin__) + if hasattr(t, "__origin__") and t.__origin__ in (Required, NotRequired, ReadOnly): + return _strip_extras(t.__args__[0]) + if isinstance(t, typing._GenericAlias): + stripped_args = tuple(_strip_extras(a) for a in t.__args__) + if stripped_args == t.__args__: + return t + return t.copy_with(stripped_args) + 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): + stripped_args = tuple(_strip_extras(a) for a in t.__args__) + if stripped_args == t.__args__: + return t + return functools.reduce(operator.or_, stripped_args) + + return t + + def get_type_hints(obj, globalns=None, localns=None, include_extras=False): + """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, ...]', 'Required[T]' or 'NotRequired[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. + + - 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 hasattr(typing, "Annotated"): # 3.9+ + hint = typing.get_type_hints( + obj, globalns=globalns, localns=localns, include_extras=True + ) + else: # 3.8 + hint = typing.get_type_hints(obj, globalns=globalns, localns=localns) + if include_extras: + return hint + return {k: _strip_extras(t) for k, t in hint.items()} + + +# Python 3.9+ has PEP 593 (Annotated) +if hasattr(typing, 'Annotated'): + Annotated = typing.Annotated + # Not exported and not a public API, but needed for get_origin() and get_args() + # to work. + _AnnotatedAlias = typing._AnnotatedAlias +# 3.8 +else: + class _AnnotatedAlias(typing._GenericAlias, _root=True): + """Runtime representation of an annotated type. + + At its core 'Annotated[t, dec1, dec2, ...]' is an alias for the type 't' + with extra annotations. The alias behaves like a normal typing alias, + instantiating is the same as instantiating the underlying type, binding + it to types is also the same. + """ + def __init__(self, origin, metadata): + if isinstance(origin, _AnnotatedAlias): + metadata = origin.__metadata__ + metadata + origin = origin.__origin__ + super().__init__(origin, origin) + self.__metadata__ = metadata + + def copy_with(self, params): + assert len(params) == 1 + new_type = params[0] + return _AnnotatedAlias(new_type, self.__metadata__) + + def __repr__(self): + return (f"typing_extensions.Annotated[{typing._type_repr(self.__origin__)}, " + f"{', '.join(repr(a) for a in self.__metadata__)}]") + + def __reduce__(self): + return operator.getitem, ( + Annotated, (self.__origin__, *self.__metadata__) + ) + + def __eq__(self, other): + if not isinstance(other, _AnnotatedAlias): + return NotImplemented + if self.__origin__ != other.__origin__: + return False + return self.__metadata__ == other.__metadata__ + + def __hash__(self): + return hash((self.__origin__, self.__metadata__)) + + class Annotated: + """Add context specific metadata to a type. + + Example: Annotated[int, runtime_check.Unsigned] indicates to the + hypothetical runtime_check module that this type is an unsigned int. + Every other consumer of this type can ignore this metadata and treat + this type as int. + + The first argument to Annotated must be a valid type (and will be in + the __origin__ field), the remaining arguments are kept as a tuple in + the __extra__ field. + + Details: + + - It's an error to call `Annotated` with less than two arguments. + - Nested Annotated are flattened:: + + Annotated[Annotated[T, Ann1, Ann2], Ann3] == Annotated[T, Ann1, Ann2, Ann3] + + - Instantiating an annotated type is equivalent to instantiating the + underlying type:: + + Annotated[C, Ann1](5) == C(5) + + - Annotated can be used as a generic type alias:: + + Optimized = Annotated[T, runtime.Optimize()] + Optimized[int] == Annotated[int, runtime.Optimize()] + + OptimizedList = Annotated[List[T], runtime.Optimize()] + OptimizedList[int] == Annotated[List[int], runtime.Optimize()] + """ + + __slots__ = () + + def __new__(cls, *args, **kwargs): + raise TypeError("Type Annotated cannot be instantiated.") + + @typing._tp_cache + def __class_getitem__(cls, params): + if not isinstance(params, tuple) or len(params) < 2: + raise TypeError("Annotated[...] should be used " + "with at least two arguments (a type and an " + "annotation).") + allowed_special_forms = (ClassVar, Final) + if get_origin(params[0]) in allowed_special_forms: + origin = params[0] + else: + msg = "Annotated[t, ...]: t must be a type." + origin = typing._type_check(params[0], msg) + metadata = tuple(params[1:]) + return _AnnotatedAlias(origin, metadata) + + def __init_subclass__(cls, *args, **kwargs): + raise TypeError( + f"Cannot subclass {cls.__module__}.Annotated" + ) + +# Python 3.8 has get_origin() and get_args() but those implementations aren't +# Annotated-aware, so we can't use those. Python 3.9's versions don't support +# ParamSpecArgs and ParamSpecKwargs, so only Python 3.10's versions will do. +if sys.version_info[:2] >= (3, 10): + get_origin = typing.get_origin + get_args = typing.get_args +# 3.8-3.9 +else: + try: + # 3.9+ + from typing import _BaseGenericAlias + except ImportError: + _BaseGenericAlias = typing._GenericAlias + try: + # 3.9+ + from typing import GenericAlias as _typing_GenericAlias + except ImportError: + _typing_GenericAlias = typing._GenericAlias + + def get_origin(tp): + """Get the unsubscripted version of a type. + + This supports generic types, Callable, Tuple, Union, Literal, Final, ClassVar + and Annotated. Return None for unsupported types. Examples:: + + get_origin(Literal[42]) is Literal + get_origin(int) is None + get_origin(ClassVar[int]) is ClassVar + get_origin(Generic) is Generic + get_origin(Generic[T]) is Generic + get_origin(Union[T, int]) is Union + get_origin(List[Tuple[T, T]][int]) == list + get_origin(P.args) is P + """ + if isinstance(tp, _AnnotatedAlias): + return Annotated + if isinstance(tp, (typing._GenericAlias, _typing_GenericAlias, _BaseGenericAlias, + ParamSpecArgs, ParamSpecKwargs)): + return tp.__origin__ + if tp is typing.Generic: + return typing.Generic + return None + + def get_args(tp): + """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 isinstance(tp, _AnnotatedAlias): + return (tp.__origin__, *tp.__metadata__) + if isinstance(tp, (typing._GenericAlias, _typing_GenericAlias)): + if getattr(tp, "_special", False): + return () + res = tp.__args__ + if get_origin(tp) is collections.abc.Callable and res[0] is not Ellipsis: + res = (list(res[:-1]), res[-1]) + return res + return () + + +# 3.10+ +if hasattr(typing, 'TypeAlias'): + TypeAlias = typing.TypeAlias +# 3.9 +elif sys.version_info[:2] >= (3, 9): + @_ExtensionsSpecialForm + def TypeAlias(self, parameters): + """Special marker indicating that an assignment should + be recognized as a proper type alias definition by type + checkers. + + For example:: + + Predicate: TypeAlias = Callable[..., bool] + + It's invalid when used anywhere except as in the example above. + """ + raise TypeError(f"{self} is not subscriptable") +# 3.8 +else: + TypeAlias = _ExtensionsSpecialForm( + 'TypeAlias', + doc="""Special marker indicating that an assignment should + be recognized as a proper type alias definition by type + checkers. + + For example:: + + Predicate: TypeAlias = Callable[..., bool] + + It's invalid when used anywhere except as in the example + above.""" + ) + + +if hasattr(typing, "NoDefault"): + NoDefault = typing.NoDefault +else: + class NoDefaultTypeMeta(type): + def __setattr__(cls, attr, value): + # TypeError is consistent with the behavior of NoneType + raise TypeError( + f"cannot set {attr!r} attribute of immutable type {cls.__name__!r}" + ) + + class NoDefaultType(metaclass=NoDefaultTypeMeta): + """The type of the NoDefault singleton.""" + + __slots__ = () + + def __new__(cls): + return globals().get("NoDefault") or object.__new__(cls) + + def __repr__(self): + return "typing_extensions.NoDefault" + + def __reduce__(self): + return "NoDefault" + + NoDefault = NoDefaultType() + del NoDefaultType, NoDefaultTypeMeta + + +def _set_default(type_param, default): + type_param.has_default = lambda: default is not NoDefault + type_param.__default__ = default + + +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 + + +# 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) + + +if _PEP_696_IMPLEMENTED: + from typing import TypeVar +else: + # Add default and infer_variance parameters from PEP 696 and 695 + class TypeVar(metaclass=_TypeVarLikeMeta): + """Type variable.""" + + _backported_typevarlike = typing.TypeVar + + def __new__(cls, name, *constraints, bound=None, + covariant=False, contravariant=False, + default=NoDefault, 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) + + def _tvar_prepare_subst(alias, args): + if ( + typevar.has_default() + and alias.__parameters__.index(typevar) == len(args) + ): + args += (typevar.__default__,) + return args + + typevar.__typing_prepare_subst__ = _tvar_prepare_subst + return typevar + + 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.8-3.9 +else: + class _Immutable: + """Mixin to indicate that object should not be copied.""" + __slots__ = () + + def __copy__(self): + return self + + def __deepcopy__(self, memo): + return self + + class ParamSpecArgs(_Immutable): + """The args for a ParamSpec object. + + Given a ParamSpec object P, P.args is an instance of ParamSpecArgs. + + ParamSpecArgs objects have a reference back to their ParamSpec: + + P.args.__origin__ is P + + This type is meant for runtime introspection and has no special meaning to + static type checkers. + """ + def __init__(self, origin): + self.__origin__ = origin + + def __repr__(self): + return f"{self.__origin__.__name__}.args" + + def __eq__(self, other): + if not isinstance(other, ParamSpecArgs): + return NotImplemented + return self.__origin__ == other.__origin__ + + class ParamSpecKwargs(_Immutable): + """The kwargs for a ParamSpec object. + + Given a ParamSpec object P, P.kwargs is an instance of ParamSpecKwargs. + + ParamSpecKwargs objects have a reference back to their ParamSpec: + + P.kwargs.__origin__ is P + + This type is meant for runtime introspection and has no special meaning to + static type checkers. + """ + def __init__(self, origin): + self.__origin__ = origin + + def __repr__(self): + return f"{self.__origin__.__name__}.kwargs" + + def __eq__(self, other): + if not isinstance(other, ParamSpecKwargs): + return NotImplemented + return self.__origin__ == other.__origin__ + + +if _PEP_696_IMPLEMENTED: + from typing import ParamSpec + +# 3.10+ +elif hasattr(typing, 'ParamSpec'): + + # Add default parameter - PEP 696 + class ParamSpec(metaclass=_TypeVarLikeMeta): + """Parameter specification.""" + + _backported_typevarlike = typing.ParamSpec + + def __new__(cls, name, *, bound=None, + covariant=False, contravariant=False, + infer_variance=False, default=NoDefault): + 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 + + _set_default(paramspec, default) + _set_module(paramspec) + + def _paramspec_prepare_subst(alias, args): + params = alias.__parameters__ + i = params.index(paramspec) + if i == len(args) and paramspec.has_default(): + args = [*args, paramspec.__default__] + if i >= len(args): + raise TypeError(f"Too few arguments for {alias}") + # Special case where Z[[int, str, bool]] == Z[int, str, bool] in PEP 612. + if len(params) == 1 and not typing._is_param_expr(args[0]): + assert i == 0 + args = (args,) + # Convert lists to tuples to help other libraries cache the results. + elif isinstance(args[i], list): + args = (*args[:i], tuple(args[i]), *args[i + 1:]) + return args + + paramspec.__typing_prepare_subst__ = _paramspec_prepare_subst + return paramspec + + 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. + class ParamSpec(list, _DefaultMixin): + """Parameter specification variable. + + Usage:: + + P = ParamSpec('P') + + Parameter specification variables exist primarily for the benefit of static + type checkers. They are used to forward the parameter types of one + callable to another callable, a pattern commonly found in higher order + functions and decorators. They are only valid when used in ``Concatenate``, + or s the first argument to ``Callable``. In Python 3.10 and higher, + they are also supported in user-defined Generics at runtime. + See class Generic for more information on generic types. An + example for annotating a decorator:: + + T = TypeVar('T') + P = ParamSpec('P') + + def add_logging(f: Callable[P, T]) -> Callable[P, T]: + '''A type-safe decorator to add logging to a function.''' + def inner(*args: P.args, **kwargs: P.kwargs) -> T: + logging.info(f'{f.__name__} was called') + return f(*args, **kwargs) + return inner + + @add_logging + def add_two(x: float, y: float) -> float: + '''Add two numbers together.''' + return x + y + + Parameter specification variables defined with covariant=True or + contravariant=True can be used to declare covariant or contravariant + generic types. These keyword arguments are valid, but their actual semantics + are yet to be decided. See PEP 612 for details. + + Parameter specification variables can be introspected. e.g.: + + P.__name__ == 'T' + P.__bound__ == None + P.__covariant__ == False + P.__contravariant__ == False + + Note that only parameter specification variables defined in global scope can + be pickled. + """ + + # Trick Generic __parameters__. + __class__ = typing.TypeVar + + @property + def args(self): + return ParamSpecArgs(self) + + @property + def kwargs(self): + return ParamSpecKwargs(self) + + def __init__(self, name, *, bound=None, covariant=False, contravariant=False, + infer_variance=False, default=NoDefault): + list.__init__(self, [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: + self.__bound__ = None + _DefaultMixin.__init__(self, default) + + # for pickling: + def_mod = _caller() + if def_mod != 'typing_extensions': + self.__module__ = def_mod + + def __repr__(self): + if self.__infer_variance__: + prefix = '' + elif self.__covariant__: + prefix = '+' + elif self.__contravariant__: + prefix = '-' + else: + prefix = '~' + return prefix + self.__name__ + + def __hash__(self): + return object.__hash__(self) + + def __eq__(self, other): + return self is other + + def __reduce__(self): + return self.__name__ + + # Hack to get typing._type_check to pass. + def __call__(self, *args, **kwargs): + pass + + +# 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): + + # Trick Generic into looking into this for __parameters__. + __class__ = typing._GenericAlias + + # Flag in 3.8. + _special = False + + def __init__(self, origin, args): + super().__init__(args) + self.__origin__ = origin + self.__args__ = args + + def __repr__(self): + _type_repr = typing._type_repr + return (f'{_type_repr(self.__origin__)}' + f'[{", ".join(_type_repr(arg) for arg in self.__args__)}]') + + def __hash__(self): + return hash((self.__origin__, self.__args__)) + + # Hack to get typing._type_check to pass in Generic. + def __call__(self, *args, **kwargs): + pass + + @property + def __parameters__(self): + return tuple( + tp for tp in self.__args__ if isinstance(tp, (typing.TypeVar, ParamSpec)) + ) + + +# 3.8-3.9 +@typing._tp_cache +def _concatenate_getitem(self, parameters): + if parameters == (): + raise TypeError("Cannot take a Concatenate of no types.") + if not isinstance(parameters, tuple): + parameters = (parameters,) + if not isinstance(parameters[-1], ParamSpec): + raise TypeError("The last parameter to Concatenate should be a " + "ParamSpec variable.") + msg = "Concatenate[arg, ...]: each arg must be a type." + parameters = tuple(typing._type_check(p, msg) for p in parameters) + return _ConcatenateGenericAlias(self, parameters) + + +# 3.10+ +if hasattr(typing, 'Concatenate'): + Concatenate = typing.Concatenate + _ConcatenateGenericAlias = typing._ConcatenateGenericAlias +# 3.9 +elif sys.version_info[:2] >= (3, 9): + @_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 + callable. + + For example:: + + Callable[Concatenate[int, P], int] + + See PEP 612 for detailed information. + """ + return _concatenate_getitem(self, parameters) +# 3.8 +else: + class _ConcatenateForm(_ExtensionsSpecialForm, _root=True): + def __getitem__(self, parameters): + return _concatenate_getitem(self, parameters) + + Concatenate = _ConcatenateForm( + 'Concatenate', + doc="""Used in conjunction with ``ParamSpec`` and ``Callable`` to represent a + higher order function which adds, removes or transforms parameters of a + callable. + + For example:: + + Callable[Concatenate[int, P], int] + + See PEP 612 for detailed information. + """) + +# 3.10+ +if hasattr(typing, 'TypeGuard'): + TypeGuard = typing.TypeGuard +# 3.9 +elif sys.version_info[:2] >= (3, 9): + @_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. + At runtime, functions marked this way should return a boolean. + + ``TypeGuard`` 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 ``TypeGuard[...]`` as its + return type to alert static type checkers to this intention. + + Using ``-> TypeGuard`` 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 type inside ``TypeGuard``. + + For example:: + + def is_str(val: Union[str, float]): + # "isinstance" type guard + if isinstance(val, str): + # Type of ``val`` is narrowed to ``str`` + ... + else: + # Else, type of ``val`` is narrowed to ``float``. + ... + + Strict type narrowing is not enforced -- ``TypeB`` need not be a narrower + form of ``TypeA`` (it can even be a wider form) and this may lead to + type-unsafe results. The main reason is to allow for things like + narrowing ``List[object]`` to ``List[str]`` even though the latter is not + a subtype of the former, since ``List`` is invariant. The responsibility of + writing type-safe type guards is left to the user. + + ``TypeGuard`` also works with type variables. For more information, see + PEP 647 (User-Defined Type Guards). + """ + item = typing._type_check(parameters, f'{self} accepts only a single type.') + return typing._GenericAlias(self, (item,)) +# 3.8 +else: + class _TypeGuardForm(_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,)) + + TypeGuard = _TypeGuardForm( + 'TypeGuard', + doc="""Special typing form used to annotate the return type of a user-defined + type guard function. ``TypeGuard`` only accepts a single type argument. + At runtime, functions marked this way should return a boolean. + + ``TypeGuard`` 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 ``TypeGuard[...]`` as its + return type to alert static type checkers to this intention. + + Using ``-> TypeGuard`` 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 type inside ``TypeGuard``. + + For example:: + + def is_str(val: Union[str, float]): + # "isinstance" type guard + if isinstance(val, str): + # Type of ``val`` is narrowed to ``str`` + ... + else: + # Else, type of ``val`` is narrowed to ``float``. + ... + + Strict type narrowing is not enforced -- ``TypeB`` need not be a narrower + form of ``TypeA`` (it can even be a wider form) and this may lead to + type-unsafe results. The main reason is to allow for things like + narrowing ``List[object]`` to ``List[str]`` even though the latter is not + a subtype of the former, since ``List`` is invariant. The responsibility of + writing type-safe type guards is left to the user. + + ``TypeGuard`` also works with type variables. For more information, see + 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): + __slots__ = ('_name', '__doc__', '_getitem') + + def __init__(self, getitem): + self._getitem = getitem + self._name = getitem.__name__ + self.__doc__ = getitem.__doc__ + + def __getattr__(self, item): + if item in {'__name__', '__qualname__'}: + return self._name + + raise AttributeError(item) + + def __mro_entries__(self, bases): + raise TypeError(f"Cannot subclass {self!r}") + + def __repr__(self): + return f'typing_extensions.{self._name}' + + def __reduce__(self): + return self._name + + def __call__(self, *args, **kwds): + raise TypeError(f"Cannot instantiate {self!r}") + + def __or__(self, other): + return typing.Union[self, other] + + def __ror__(self, other): + return typing.Union[other, self] + + def __instancecheck__(self, obj): + raise TypeError(f"{self} cannot be used with isinstance()") + + def __subclasscheck__(self, cls): + raise TypeError(f"{self} cannot be used with issubclass()") + + @typing._tp_cache + def __getitem__(self, parameters): + return self._getitem(self, parameters) + + +if hasattr(typing, "LiteralString"): # 3.11+ + LiteralString = typing.LiteralString +else: + @_SpecialForm + def LiteralString(self, params): + """Represents an arbitrary literal string. + + Example:: + + from pip._vendor.typing_extensions import LiteralString + + def query(sql: LiteralString) -> ...: + ... + + query("SELECT * FROM table") # ok + query(f"SELECT * FROM {input()}") # not ok + + See PEP 675 for details. + + """ + raise TypeError(f"{self} is not subscriptable") + + +if hasattr(typing, "Self"): # 3.11+ + Self = typing.Self +else: + @_SpecialForm + def Self(self, params): + """Used to spell the type of "self" in classes. + + Example:: + + from typing import Self + + class ReturnsSelf: + def parse(self, data: bytes) -> Self: + ... + return self + + """ + + raise TypeError(f"{self} is not subscriptable") + + +if hasattr(typing, "Never"): # 3.11+ + Never = typing.Never +else: + @_SpecialForm + def Never(self, params): + """The bottom type, a type that has no members. + + This can be used to define a function that should never be + called, or a function that never returns:: + + from pip._vendor.typing_extensions import Never + + def never_call_me(arg: Never) -> None: + pass + + def int_or_str(arg: int | str) -> None: + never_call_me(arg) # type checker error + match arg: + case int(): + print("It's an int") + case str(): + print("It's a str") + case _: + never_call_me(arg) # ok, arg is of type Never + + """ + + raise TypeError(f"{self} is not subscriptable") + + +if hasattr(typing, 'Required'): # 3.11+ + Required = typing.Required + NotRequired = typing.NotRequired +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 + as required. For example: + + class Movie(TypedDict, total=False): + title: Required[str] + year: int + + m = Movie( + title='The Matrix', # typechecker error if key is omitted + year=1999, + ) + + There is no runtime checking that a required key is actually provided + when instantiating a related TypedDict. + """ + item = typing._type_check(parameters, f'{self._name} accepts only a single type.') + return typing._GenericAlias(self, (item,)) + + @_ExtensionsSpecialForm + def NotRequired(self, parameters): + """A special typing construct to mark a key of a TypedDict as + potentially missing. For example: + + class Movie(TypedDict): + title: str + year: NotRequired[int] + + m = Movie( + title='The Matrix', # typechecker error if key is omitted + year=1999, + ) + """ + item = typing._type_check(parameters, f'{self._name} accepts only a single type.') + return typing._GenericAlias(self, (item,)) + +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.') + return typing._GenericAlias(self, (item,)) + + Required = _RequiredForm( + 'Required', + doc="""A special typing construct to mark a key of a total=False TypedDict + as required. For example: + + class Movie(TypedDict, total=False): + title: Required[str] + year: int + + m = Movie( + title='The Matrix', # typechecker error if key is omitted + year=1999, + ) + + There is no runtime checking that a required key is actually provided + when instantiating a related TypedDict. + """) + NotRequired = _RequiredForm( + 'NotRequired', + doc="""A special typing construct to mark a key of a TypedDict as + potentially missing. For example: + + class Movie(TypedDict): + title: str + year: NotRequired[int] + + m = Movie( + title='The Matrix', # typechecker error if key is omitted + year=1999, + ) + """) + + +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 + + 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 + + @property + def __typing_unpacked_tuple_args__(self): + assert self.__origin__ is Unpack + assert len(self.__args__) == 1 + arg, = self.__args__ + if isinstance(arg, (typing._GenericAlias, _types.GenericAlias)): + if arg.__origin__ is not tuple: + raise TypeError("Unpack[...] must be used with a tuple type") + return arg.__args__ + return None + + @_UnpackSpecialForm + def Unpack(self, parameters): + 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: # 3.8 + class _UnpackAlias(typing._GenericAlias, _root=True): + __class__ = typing.TypeVar + + 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=_UNPACK_DOC) + + def _is_unpack(obj): + return isinstance(obj, _UnpackAlias) + + +if _PEP_696_IMPLEMENTED: + from typing import TypeVarTuple + +elif hasattr(typing, "TypeVarTuple"): # 3.11+ + + def _unpack_args(*args): + newargs = [] + for arg in args: + subargs = getattr(arg, '__typing_unpacked_tuple_args__', None) + if subargs is not None and not (subargs and subargs[-1] is ...): + newargs.extend(subargs) + else: + newargs.append(arg) + return newargs + + # Add default parameter - PEP 696 + class TypeVarTuple(metaclass=_TypeVarLikeMeta): + """Type variable tuple.""" + + _backported_typevarlike = typing.TypeVarTuple + + def __new__(cls, name, *, default=NoDefault): + tvt = typing.TypeVarTuple(name) + _set_default(tvt, default) + _set_module(tvt) + + def _typevartuple_prepare_subst(alias, args): + params = alias.__parameters__ + typevartuple_index = params.index(tvt) + for param in params[typevartuple_index + 1:]: + if isinstance(param, TypeVarTuple): + raise TypeError( + f"More than one TypeVarTuple parameter in {alias}" + ) + + alen = len(args) + plen = len(params) + left = typevartuple_index + right = plen - typevartuple_index - 1 + var_tuple_index = None + fillarg = None + for k, arg in enumerate(args): + if not isinstance(arg, type): + subargs = getattr(arg, '__typing_unpacked_tuple_args__', None) + if subargs and len(subargs) == 2 and subargs[-1] is ...: + if var_tuple_index is not None: + raise TypeError( + "More than one unpacked " + "arbitrary-length tuple argument" + ) + var_tuple_index = k + fillarg = subargs[0] + if var_tuple_index is not None: + left = min(left, var_tuple_index) + right = min(right, alen - var_tuple_index - 1) + elif left + right > alen: + raise TypeError(f"Too few arguments for {alias};" + f" actual {alen}, expected at least {plen - 1}") + if left == alen - right and tvt.has_default(): + replacement = _unpack_args(tvt.__default__) + else: + replacement = args[left: alen - right] + + return ( + *args[:left], + *([fillarg] * (typevartuple_index - left)), + replacement, + *([fillarg] * (plen - right - left - typevartuple_index - 1)), + *args[alen - right:], + ) + + tvt.__typing_prepare_subst__ = _typevartuple_prepare_subst + return tvt + + def __init_subclass__(self, *args, **kwds): + raise TypeError("Cannot subclass special typing classes") + +else: # <=3.10 + class TypeVarTuple(_DefaultMixin): + """Type variable tuple. + + Usage:: + + Ts = TypeVarTuple('Ts') + + In the same way that a normal type variable is a stand-in for a single + type such as ``int``, a type variable *tuple* is a stand-in for a *tuple* + type such as ``Tuple[int, str]``. + + Type variable tuples can be used in ``Generic`` declarations. + Consider the following example:: + + class Array(Generic[*Ts]): ... + + The ``Ts`` type variable tuple here behaves like ``tuple[T1, T2]``, + where ``T1`` and ``T2`` are type variables. To use these type variables + as type parameters of ``Array``, we must *unpack* the type variable tuple using + the star operator: ``*Ts``. The signature of ``Array`` then behaves + as if we had simply written ``class Array(Generic[T1, T2]): ...``. + In contrast to ``Generic[T1, T2]``, however, ``Generic[*Shape]`` allows + us to parameterise the class with an *arbitrary* number of type parameters. + + Type variable tuples can be used anywhere a normal ``TypeVar`` can. + This includes class definitions, as shown above, as well as function + signatures and variable annotations:: + + class Array(Generic[*Ts]): + + def __init__(self, shape: Tuple[*Ts]): + self._shape: Tuple[*Ts] = shape + + def get_shape(self) -> Tuple[*Ts]: + return self._shape + + shape = (Height(480), Width(640)) + x: Array[Height, Width] = Array(shape) + y = abs(x) # Inferred type is Array[Height, Width] + z = x + x # ... is Array[Height, Width] + x.get_shape() # ... is tuple[Height, Width] + + """ + + # Trick Generic __parameters__. + __class__ = typing.TypeVar + + def __iter__(self): + yield self.__unpacked__ + + def __init__(self, name, *, default=NoDefault): + self.__name__ = name + _DefaultMixin.__init__(self, default) + + # for pickling: + def_mod = _caller() + if def_mod != 'typing_extensions': + self.__module__ = def_mod + + self.__unpacked__ = Unpack[self] + + def __repr__(self): + return self.__name__ + + def __hash__(self): + return object.__hash__(self) + + def __eq__(self, other): + return self is other + + def __reduce__(self): + return self.__name__ + + def __init_subclass__(self, *args, **kwds): + if '_root' not in kwds: + raise TypeError("Cannot subclass special typing classes") + + +if hasattr(typing, "reveal_type"): # 3.11+ + reveal_type = typing.reveal_type +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()``, + it will emit the inferred type of the argument:: + + x: int = 1 + reveal_type(x) + + Running a static type checker (e.g., ``mypy``) on this example + will produce output similar to 'Revealed type is "builtins.int"'. + + At runtime, the function prints the runtime type of the + argument and returns it unchanged. + + """ + print(f"Runtime type is {type(obj).__name__!r}", file=sys.stderr) + return obj + + +if hasattr(typing, "_ASSERT_NEVER_REPR_MAX_LENGTH"): # 3.11+ + _ASSERT_NEVER_REPR_MAX_LENGTH = typing._ASSERT_NEVER_REPR_MAX_LENGTH +else: # <=3.10 + _ASSERT_NEVER_REPR_MAX_LENGTH = 100 + + +if hasattr(typing, "assert_never"): # 3.11+ + assert_never = typing.assert_never +else: # <=3.10 + def assert_never(arg: Never, /) -> Never: + """Assert to the type checker that a line of code is unreachable. + + Example:: + + def int_or_str(arg: int | str) -> None: + match arg: + case int(): + print("It's an int") + case str(): + print("It's a str") + case _: + assert_never(arg) + + If a type checker finds that a call to assert_never() is + reachable, it will emit an error. + + At runtime, this throws an exception when called. + + """ + value = repr(arg) + if len(value) > _ASSERT_NEVER_REPR_MAX_LENGTH: + value = value[:_ASSERT_NEVER_REPR_MAX_LENGTH] + '...' + raise AssertionError(f"Expected code to be unreachable, but got: {value}") + + +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: # <=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]], + ... + ] = (), + **kwargs: typing.Any, + ) -> typing.Callable[[T], T]: + """Decorator that marks a function, class, or metaclass as providing + dataclass-like behavior. + + Example: + + from pip._vendor.typing_extensions import dataclass_transform + + _T = TypeVar("_T") + + # Used on a decorator function + @dataclass_transform() + def create_model(cls: type[_T]) -> type[_T]: + ... + return cls + + @create_model + class CustomerModel: + id: int + name: str + + # Used on a base class + @dataclass_transform() + class ModelBase: ... + + class CustomerModel(ModelBase): + id: int + name: str + + # Used on a metaclass + @dataclass_transform() + class ModelMeta(type): ... + + class ModelBase(metaclass=ModelMeta): ... + + class CustomerModel(ModelBase): + id: int + name: str + + Each of the ``CustomerModel`` classes defined in this example will now + behave similarly to a dataclass created with the ``@dataclasses.dataclass`` + decorator. For example, the type checker will synthesize an ``__init__`` + method. + + The arguments to this decorator can be used to customize this behavior: + - ``eq_default`` indicates whether the ``eq`` parameter is assumed to be + True or False if it is omitted by the caller. + - ``order_default`` indicates whether the ``order`` parameter is + 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()``. + + At runtime, this decorator records its arguments in the + ``__dataclass_transform__`` attribute on the decorated object. + + See PEP 681 for details. + + """ + def decorator(cls_or_fn): + cls_or_fn.__dataclass_transform__ = { + "eq_default": eq_default, + "order_default": order_default, + "kw_only_default": kw_only_default, + "frozen_default": frozen_default, + "field_specifiers": field_specifiers, + "kwargs": kwargs, + } + return cls_or_fn + return decorator + + +if hasattr(typing, "override"): # 3.12+ + override = typing.override +else: # <=3.11 + _F = typing.TypeVar("_F", bound=typing.Callable[..., typing.Any]) + + 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: + pass + + class Child(Base): + @override + def method(self) -> None: + super().method() + + When this decorator is applied to a method, the type checker will + validate that it overrides a method with the same name on a base class. + 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. + + """ + 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 +# Unpack/TypeVarTuple: +# - We want Unpack to be a kind of TypeVar so it gets accepted in +# Generic[Unpack[Ts]] +# - We want it to *not* be treated as a TypeVar for the purposes of +# counting generic parameters, so that when we subscript a generic, +# the runtime doesn't try to substitute the Unpack with the subscripted type. +if not hasattr(typing, "TypeVarTuple"): + def _check_generic(cls, parameters, elen=_marker): + """Check correct count for parameters of a generic cls (internal helper). + + This gives a nice error message in case of count mismatch. + """ + if not elen: + raise TypeError(f"{cls} is not a generic class") + if elen is _marker: + if not hasattr(cls, "__parameters__") or not cls.__parameters__: + raise TypeError(f"{cls} is not a generic class") + elen = len(cls.__parameters__) + alen = len(parameters) + if alen != elen: + expect_val = elen + if hasattr(cls, "__parameters__"): + parameters = [p for p in cls.__parameters__ if not _is_unpack(p)] + num_tv_tuples = sum(isinstance(p, TypeVarTuple) for p in parameters) + if (num_tv_tuples > 0) and (alen >= elen - num_tv_tuples): + return + + # deal with TypeVarLike defaults + # required TypeVarLikes cannot appear after a defaulted one. + if alen < elen: + # since we validate TypeVarLike default in _collect_type_vars + # or _collect_parameters we can safely check parameters[alen] + if ( + getattr(parameters[alen], '__default__', NoDefault) + is not NoDefault + ): + return + + num_default_tv = sum(getattr(p, '__default__', NoDefault) + is not NoDefault for p in parameters) + + elen -= num_default_tv + + expect_val = f"at least {elen}" + + things = "arguments" if sys.version_info >= (3, 10) else "parameters" + raise TypeError(f"Too {'many' if alen > elen else 'few'} {things}" + f" for {cls}; actual {alen}, expected {expect_val}") +else: + # Python 3.11+ + + def _check_generic(cls, parameters, elen): + """Check correct count for parameters of a generic cls (internal helper). + + This gives a nice error message in case of count mismatch. + """ + if not elen: + raise TypeError(f"{cls} is not a generic class") + alen = len(parameters) + if alen != elen: + expect_val = elen + if hasattr(cls, "__parameters__"): + parameters = [p for p in cls.__parameters__ if not _is_unpack(p)] + + # deal with TypeVarLike defaults + # required TypeVarLikes cannot appear after a defaulted one. + if alen < elen: + # since we validate TypeVarLike default in _collect_type_vars + # or _collect_parameters we can safely check parameters[alen] + if ( + getattr(parameters[alen], '__default__', NoDefault) + is not NoDefault + ): + return + + num_default_tv = sum(getattr(p, '__default__', NoDefault) + is not NoDefault for p in parameters) + + elen -= num_default_tv + + expect_val = f"at least {elen}" + + raise TypeError(f"Too {'many' if alen > elen else 'few'} arguments" + f" for {cls}; actual {alen}, expected {expect_val}") + +if not _PEP_696_IMPLEMENTED: + typing._check_generic = _check_generic + + +def _has_generic_or_protocol_as_origin() -> bool: + try: + frame = sys._getframe(2) + # - Catch AttributeError: not all Python implementations have sys._getframe() + # - Catch ValueError: maybe we're called from an unexpected module + # and the call stack isn't deep enough + except (AttributeError, ValueError): + return False # err on the side of leniency + else: + # If we somehow get invoked from outside typing.py, + # also err on the side of leniency + if frame.f_globals.get("__name__") != "typing": + return False + origin = frame.f_locals.get("origin") + # Cannot use "in" because origin may be an object with a buggy __eq__ that + # throws an error. + return origin is typing.Generic or origin is Protocol or origin is typing.Protocol + + +_TYPEVARTUPLE_TYPES = {TypeVarTuple, getattr(typing, "TypeVarTuple", None)} + + +def _is_unpacked_typevartuple(x) -> bool: + if get_origin(x) is not Unpack: + return False + args = get_args(x) + return ( + bool(args) + and len(args) == 1 + and type(args[0]) in _TYPEVARTUPLE_TYPES + ) + + +# Python 3.11+ _collect_type_vars was renamed to _collect_parameters +if hasattr(typing, '_collect_type_vars'): + def _collect_type_vars(types, typevar_types=None): + """Collect all type variable contained in types in order of + first appearance (lexicographic order). For example:: + + _collect_type_vars((T, List[S, T])) == (T, S) + """ + if typevar_types is None: + typevar_types = typing.TypeVar + tvars = [] + + # A required TypeVarLike cannot appear after a TypeVarLike with a default + # if it was a direct call to `Generic[]` or `Protocol[]` + enforce_default_ordering = _has_generic_or_protocol_as_origin() + default_encountered = False + + # Also, a TypeVarLike with a default cannot appear after a TypeVarTuple + type_var_tuple_encountered = False + + for t in types: + if _is_unpacked_typevartuple(t): + type_var_tuple_encountered = True + elif isinstance(t, typevar_types) and t not in tvars: + if enforce_default_ordering: + has_default = getattr(t, '__default__', NoDefault) is not NoDefault + if has_default: + if type_var_tuple_encountered: + raise TypeError('Type parameter with a default' + ' follows TypeVarTuple') + default_encountered = True + elif default_encountered: + raise TypeError(f'Type parameter {t!r} without a default' + ' follows type parameter with a default') + + tvars.append(t) + if _should_collect_from_parameters(t): + tvars.extend([t for t in t.__parameters__ if t not in tvars]) + return tuple(tvars) + + typing._collect_type_vars = _collect_type_vars +else: + def _collect_parameters(args): + """Collect all type variables and parameter specifications in args + in order of first appearance (lexicographic order). + + For example:: + + assert _collect_parameters((T, Callable[P, T])) == (T, P) + """ + parameters = [] + + # A required TypeVarLike cannot appear after a TypeVarLike with default + # if it was a direct call to `Generic[]` or `Protocol[]` + enforce_default_ordering = _has_generic_or_protocol_as_origin() + default_encountered = False + + # Also, a TypeVarLike with a default cannot appear after a TypeVarTuple + type_var_tuple_encountered = False + + for t in args: + if isinstance(t, type): + # We don't want __parameters__ descriptor of a bare Python class. + pass + elif isinstance(t, tuple): + # `t` might be a tuple, when `ParamSpec` is substituted with + # `[T, int]`, or `[int, *Ts]`, etc. + for x in t: + for collected in _collect_parameters([x]): + if collected not in parameters: + parameters.append(collected) + elif hasattr(t, '__typing_subst__'): + if t not in parameters: + if enforce_default_ordering: + has_default = ( + getattr(t, '__default__', NoDefault) is not NoDefault + ) + + if type_var_tuple_encountered and has_default: + raise TypeError('Type parameter with a default' + ' follows TypeVarTuple') + + if has_default: + default_encountered = True + elif default_encountered: + raise TypeError(f'Type parameter {t!r} without a default' + ' follows type parameter with a default') + + parameters.append(t) + else: + if _is_unpacked_typevartuple(t): + type_var_tuple_encountered = True + for x in getattr(t, '__parameters__', ()): + if x not in parameters: + parameters.append(x) + + return tuple(parameters) + + if not _PEP_696_IMPLEMENTED: + typing._collect_parameters = _collect_parameters + +# 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. +# 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 _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") + for n, t in types} + nm_tpl = collections.namedtuple(name, fields, + defaults=defaults, module=module) + nm_tpl.__annotations__ = nm_tpl.__new__.__annotations__ = annotations + # The `_field_types` attribute was removed in 3.9; + # in earlier versions, it is the same as the `__annotations__` attribute + if sys.version_info < (3, 9): + nm_tpl._field_types = annotations + return nm_tpl + + _prohibited_namedtuple_fields = typing._prohibited + _special_namedtuple_fields = frozenset({'__module__', '__name__', '__annotations__'}) + + class _NamedTupleMeta(type): + def __new__(cls, typename, bases, ns): + assert _NamedTuple in bases + for base in bases: + if base is not _NamedTuple and base is not typing.Generic: + raise TypeError( + 'can only inherit from a NamedTuple type and Generic') + bases = tuple(tuple if base is _NamedTuple else base for base in bases) + if "__annotations__" in ns: + types = ns["__annotations__"] + elif "__annotate__" in ns: + # TODO: Use inspect.VALUE here, and make the annotations lazily evaluated + types = ns["__annotate__"](1) + else: + types = {} + default_names = [] + for field_name in types: + if field_name in ns: + default_names.append(field_name) + elif default_names: + raise TypeError(f"Non-default namedtuple field {field_name} " + f"cannot follow default field" + f"{'s' if len(default_names) > 1 else ''} " + f"{', '.join(default_names)}") + nm_tpl = _make_nmtuple( + typename, types.items(), + defaults=[ns[n] for n in default_names], + module=ns['__module__'] + ) + nm_tpl.__bases__ = bases + if typing.Generic in bases: + 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, val in ns.items(): + if key in _prohibited_namedtuple_fields: + raise AttributeError("Cannot overwrite NamedTuple attribute " + 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 + + _NamedTuple = type.__new__(_NamedTupleMeta, 'NamedTuple', (), {}) + + def _namedtuple_mro_entries(bases): + assert NamedTuple in bases + return (_NamedTuple,) + + @_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): # noqa: B024 + """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 pip._vendor.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 + + +_CapsuleType = getattr(_types, "CapsuleType", None) + +if _CapsuleType is None: + try: + import _socket + except ImportError: + pass + else: + _CAPI = getattr(_socket, "CAPI", None) + if _CAPI is not None: + _CapsuleType = type(_CAPI) + +if _CapsuleType is not None: + CapsuleType = _CapsuleType + __all__.append("CapsuleType") + + +# 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 +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/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__init__.py b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__init__.py new file mode 100644 index 0000000..c6fa382 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__init__.py @@ -0,0 +1,102 @@ +""" +Python HTTP library with thread-safe connection pooling, file post support, user friendly, and more +""" +from __future__ import absolute_import + +# Set default logging handler to avoid "No handler found" warnings. +import logging +import warnings +from logging import NullHandler + +from . import exceptions +from ._version import __version__ +from .connectionpool import HTTPConnectionPool, HTTPSConnectionPool, connection_from_url +from .filepost import encode_multipart_formdata +from .poolmanager import PoolManager, ProxyManager, proxy_from_url +from .response import HTTPResponse +from .util.request import make_headers +from .util.retry import Retry +from .util.timeout import Timeout +from .util.url import get_host + +# === NOTE TO REPACKAGERS AND VENDORS === +# Please delete this block, this logic is only +# for urllib3 being distributed via PyPI. +# See: https://github.com/urllib3/urllib3/issues/2680 +try: + import urllib3_secure_extra # type: ignore # noqa: F401 +except ImportError: + pass +else: + warnings.warn( + "'urllib3[secure]' extra is deprecated and will be removed " + "in a future release of urllib3 2.x. Read more in this issue: " + "https://github.com/urllib3/urllib3/issues/2680", + category=DeprecationWarning, + stacklevel=2, + ) + +__author__ = "Andrey Petrov (andrey.petrov@shazow.net)" +__license__ = "MIT" +__version__ = __version__ + +__all__ = ( + "HTTPConnectionPool", + "HTTPSConnectionPool", + "PoolManager", + "ProxyManager", + "HTTPResponse", + "Retry", + "Timeout", + "add_stderr_logger", + "connection_from_url", + "disable_warnings", + "encode_multipart_formdata", + "get_host", + "make_headers", + "proxy_from_url", +) + +logging.getLogger(__name__).addHandler(NullHandler()) + + +def add_stderr_logger(level=logging.DEBUG): + """ + Helper for quickly adding a StreamHandler to the logger. Useful for + debugging. + + Returns the handler after adding it. + """ + # This method needs to be in this __init__.py to get the __name__ correct + # even if urllib3 is vendored within another package. + logger = logging.getLogger(__name__) + handler = logging.StreamHandler() + handler.setFormatter(logging.Formatter("%(asctime)s %(levelname)s %(message)s")) + logger.addHandler(handler) + logger.setLevel(level) + logger.debug("Added a stderr logging handler to logger: %s", __name__) + return handler + + +# ... Clean up. +del NullHandler + + +# All warning filters *must* be appended unless you're really certain that they +# shouldn't be: otherwise, it's very hard for users to use most Python +# mechanisms to silence them. +# SecurityWarning's always go off by default. +warnings.simplefilter("always", exceptions.SecurityWarning, append=True) +# SubjectAltNameWarning's should go off once per host +warnings.simplefilter("default", exceptions.SubjectAltNameWarning, append=True) +# InsecurePlatformWarning's don't vary between requests, so we keep it default. +warnings.simplefilter("default", exceptions.InsecurePlatformWarning, append=True) +# SNIMissingWarnings should go off only once. +warnings.simplefilter("default", exceptions.SNIMissingWarning, append=True) + + +def disable_warnings(category=exceptions.HTTPWarning): + """ + Helper for quickly disabling all urllib3 warnings. + """ + warnings.simplefilter("ignore", category) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f60f3e100e6c9fe1c0d09a0f8ca73f0cd7c66856 GIT binary patch literal 3405 zcmb7G-ESMm5#J+^-(M0XTB2piCtH%m)FvIrEmFaWD}N-iYsreGw9cjJ;lx{#r|j{V zy*o)%ZGZ-f=A{pQD3AmQP!~lX3g?eVffNYPmk^df^%5Zgiaz*_sS=>@Q)ibvQBn{T zxrf=A*`3|l*_q$mKN5*3g753s9+v_Mg#N_@?+bL9y+8O6dJkzxMw+1ch+z0+pTKxO z@ymWbin0i!Nc=`X4!~SM3zDD_l0%#ik+2bwBb*PDs1cK6MqG{?2|2-a5t1}ga*Fd& z(r5I`{YF|&8w2tH*Tu-7k&!c;kCS7@kUYfs1Q|B6a+dQ+a@-h^M>wA%CyY^fR6voA zmt*pn4`FfjW$$XeQR~B!*8frZvA?4O`vLisHYlIQ;IWpGC&1Fbdb4NYad_&n(BW5a zd%E5TR)NP|(OW05ofdm*Jgy{Y$9^lwxi&_Bd_$qioOf@3lS- z)^|Od-uMHo<(`$t{Q&DJi>)xElL0m>4F6Zn1(+H1GAnF&;8|e4Vb+qAs z1FZ|W6Pq}?Shp)?RhnB~UX+NwLRDIq)^)og*%gXa?VP2Suv9dwRa~@nSXeVnqF2jj zrIJoCNR};GPOWBA`>flqCe{qIjc-YwS3Stx%LTOf8TUCFgh3%+;&=4lRN|?f}y*9aZ+cR!Y<~ z6o(SnE{m&0Q^Shk5L>UQ)K*F+H8j;$Ve=TEKRrcIq8$ z)xb{-JI4+6ZLCxvYTz!&fjiiybznlvx`9o{1~y#Awo-wpZT{s9_yZAt;Y|w{9g5#N zBjF93s*-L=8m>`XRBf#BAg=3#NGn*P*f7^Xr&lFaDmgY-fsSC+!jf5%y8B5N@*8>S z4!FUi&sN(N*i^SH2hT_q+pbwNg+dt~*;&aKO{35?+#mT$t8n2bFP?u2*oAUFH_W^# zo3!pmEn6+VP4F5fo71yZjpDkr2p2Wiq-l6Y5c4%I{>-YVo924HitU{1pTDu3OVTjx zMk9>G83D*dG{s0iBWWORzp819WkU?9Ld-He1Z5cO_G!AMt`MxOtF#IkXwew68DON3 zktC2}7gB&lhygHzrM+R$zK87nxm9+lBcCmL3J-4X3kNKM-fVC5;OV~ao^O@i>Bx7$ znm38V)0*I&Zk0;52?>Rz&g0~z*DYLf2s7mSXn4gbm%%O{ zLSXGxROJjJSNS2D0=K~?6g&9k$b z#tK8~BnkI}x#?{V?sZ(7ktVHN#0@bC7Pt|py<0q^+_0jsofXAR9J-qux3K*R;DKs` zhi;_DM#0-|0NgMvy2T2>4e;9na0IxwZm@H*8|pe^vHXMJK6|TBF%4Xxozl>Yl>!5y z!n|%33;8u%T`K?-6lxrdU&udypW&y|iNj5C_`{)A z_PJ*ExzB!d=Sg;HOI+R&qb)Jh6f+OYTjCf<@7{iJ`{DI1@i^meJ-GE*|K(4Hx5S$} zv2>emBzguY&3a^o zO$-8o;D%8k(Gs&wG5h}Xqq%MI9G!-V-1BZoQ8cp%nH5!(4n`{qWjCfHjN}<%L2wae zpaQAb?QS&0#AL5)u~vHkF*yo`S=(h@m!qE>V{42~zd8V^3<}*a?Y1V4ux{M3b&{v} z9S4IoLrgc?RY8~H0Nh=}DiFF=2adyh4TO^;tvlEatkP*(3U67i$YSZHuXWoNwCZ1W zK-!Jn;GOO?PM=$s%x%v3@kPA9-EI?Bj6b1-o2`jyvT?PPa> zDN;+USL$}%+ds49tgOPX$t4zR4SE&*-(1wr`Q=M%(lgGe~D2PE}5O6{VP|3<^R zX#7ibw~6lVqQaNxN)uh#MW=Sr)Giu@sa-VIj>m-H=i_iT4NWRV;8?c tqLBY@d)|k_1OGvS5c#JVW>Jegvsj=1+X?a7W%SAA!1a*-??D0R{{W{?Z9@P6 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/_collections.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/_collections.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..dc46cf07e311905ff7ee3972b1a9fc608b5ea091 GIT binary patch literal 16488 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/_version.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/_version.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..35668fa7ba1c3359092485fb5a1062577e015f8d GIT binary patch literal 218 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 z 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 UeTN;w-#FZdt8IT%WkLA=0oPvxm;e9( literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/exceptions.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/exceptions.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b3a50dce21bbe4556f1e79aec1c44916f023b838 GIT binary patch literal 13493 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 Yd-gvF-oIK+Fwj;-EB?1VFFN@D0ysKH&;S4c literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/filepost.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/__pycache__/filepost.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..25dbd1319527dfde5aa16707545c3a5f618c73ed GIT binary patch literal 4018 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%0D_qGSrh{L4Za8azhvg_+TBd8HtB{ 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/_collections.py b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/_collections.py new file mode 100644 index 0000000..bceb845 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/_collections.py @@ -0,0 +1,355 @@ +from __future__ import absolute_import + +try: + from collections.abc import Mapping, MutableMapping +except ImportError: + from collections import Mapping, MutableMapping +try: + from threading import RLock +except ImportError: # Platform-specific: No threads available + + class RLock: + def __enter__(self): + pass + + def __exit__(self, exc_type, exc_value, traceback): + pass + + +from collections import OrderedDict + +from .exceptions import InvalidHeader +from .packages import six +from .packages.six import iterkeys, itervalues + +__all__ = ["RecentlyUsedContainer", "HTTPHeaderDict"] + + +_Null = object() + + +class RecentlyUsedContainer(MutableMapping): + """ + Provides a thread-safe dict-like container which maintains up to + ``maxsize`` keys while throwing away the least-recently-used keys beyond + ``maxsize``. + + :param maxsize: + Maximum number of recent elements to retain. + + :param dispose_func: + Every time an item is evicted from the container, + ``dispose_func(value)`` is called. Callback which will get called + """ + + ContainerCls = OrderedDict + + def __init__(self, maxsize=10, dispose_func=None): + self._maxsize = maxsize + self.dispose_func = dispose_func + + self._container = self.ContainerCls() + self.lock = RLock() + + def __getitem__(self, key): + # Re-insert the item, moving it to the end of the eviction line. + with self.lock: + item = self._container.pop(key) + self._container[key] = item + return item + + def __setitem__(self, key, value): + evicted_value = _Null + with self.lock: + # Possibly evict the existing value of 'key' + evicted_value = self._container.get(key, _Null) + self._container[key] = value + + # If we didn't evict an existing value, we might have to evict the + # least recently used item from the beginning of the container. + if len(self._container) > self._maxsize: + _key, evicted_value = self._container.popitem(last=False) + + if self.dispose_func and evicted_value is not _Null: + self.dispose_func(evicted_value) + + def __delitem__(self, key): + with self.lock: + value = self._container.pop(key) + + if self.dispose_func: + self.dispose_func(value) + + def __len__(self): + with self.lock: + return len(self._container) + + def __iter__(self): + raise NotImplementedError( + "Iteration over this class is unlikely to be threadsafe." + ) + + def clear(self): + with self.lock: + # Copy pointers to all values, then wipe the mapping + values = list(itervalues(self._container)) + self._container.clear() + + if self.dispose_func: + for value in values: + self.dispose_func(value) + + def keys(self): + with self.lock: + return list(iterkeys(self._container)) + + +class HTTPHeaderDict(MutableMapping): + """ + :param headers: + An iterable of field-value pairs. Must not contain multiple field names + when compared case-insensitively. + + :param kwargs: + Additional field-value pairs to pass in to ``dict.update``. + + A ``dict`` like container for storing HTTP Headers. + + Field names are stored and compared case-insensitively in compliance with + RFC 7230. Iteration provides the first case-sensitive key seen for each + case-insensitive pair. + + Using ``__setitem__`` syntax overwrites fields that compare equal + case-insensitively in order to maintain ``dict``'s api. For fields that + compare equal, instead create a new ``HTTPHeaderDict`` and use ``.add`` + in a loop. + + If multiple fields that are equal case-insensitively are passed to the + constructor or ``.update``, the behavior is undefined and some will be + lost. + + >>> headers = HTTPHeaderDict() + >>> headers.add('Set-Cookie', 'foo=bar') + >>> headers.add('set-cookie', 'baz=quxx') + >>> headers['content-length'] = '7' + >>> headers['SET-cookie'] + 'foo=bar, baz=quxx' + >>> headers['Content-Length'] + '7' + """ + + def __init__(self, headers=None, **kwargs): + super(HTTPHeaderDict, self).__init__() + self._container = OrderedDict() + if headers is not None: + if isinstance(headers, HTTPHeaderDict): + self._copy_from(headers) + else: + self.extend(headers) + if kwargs: + self.extend(kwargs) + + def __setitem__(self, key, val): + self._container[key.lower()] = [key, val] + return self._container[key.lower()] + + def __getitem__(self, key): + val = self._container[key.lower()] + return ", ".join(val[1:]) + + def __delitem__(self, key): + del self._container[key.lower()] + + def __contains__(self, key): + return key.lower() in self._container + + def __eq__(self, other): + if not isinstance(other, Mapping) and not hasattr(other, "keys"): + return False + if not isinstance(other, type(self)): + other = type(self)(other) + return dict((k.lower(), v) for k, v in self.itermerged()) == dict( + (k.lower(), v) for k, v in other.itermerged() + ) + + def __ne__(self, other): + return not self.__eq__(other) + + if six.PY2: # Python 2 + iterkeys = MutableMapping.iterkeys + itervalues = MutableMapping.itervalues + + __marker = object() + + def __len__(self): + return len(self._container) + + def __iter__(self): + # Only provide the originally cased names + for vals in self._container.values(): + yield vals[0] + + def pop(self, key, default=__marker): + """D.pop(k[,d]) -> v, remove specified key and return the corresponding value. + If key is not found, d is returned if given, otherwise KeyError is raised. + """ + # Using the MutableMapping function directly fails due to the private marker. + # Using ordinary dict.pop would expose the internal structures. + # So let's reinvent the wheel. + try: + value = self[key] + except KeyError: + if default is self.__marker: + raise + return default + else: + del self[key] + return value + + def discard(self, key): + try: + del self[key] + except KeyError: + pass + + def add(self, key, val): + """Adds a (name, value) pair, doesn't overwrite the value if it already + exists. + + >>> headers = HTTPHeaderDict(foo='bar') + >>> headers.add('Foo', 'baz') + >>> headers['foo'] + 'bar, baz' + """ + key_lower = key.lower() + new_vals = [key, val] + # Keep the common case aka no item present as fast as possible + vals = self._container.setdefault(key_lower, new_vals) + if new_vals is not vals: + vals.append(val) + + def extend(self, *args, **kwargs): + """Generic import function for any type of header-like object. + Adapted version of MutableMapping.update in order to insert items + with self.add instead of self.__setitem__ + """ + if len(args) > 1: + raise TypeError( + "extend() takes at most 1 positional " + "arguments ({0} given)".format(len(args)) + ) + other = args[0] if len(args) >= 1 else () + + if isinstance(other, HTTPHeaderDict): + for key, val in other.iteritems(): + self.add(key, val) + elif isinstance(other, Mapping): + for key in other: + self.add(key, other[key]) + elif hasattr(other, "keys"): + for key in other.keys(): + self.add(key, other[key]) + else: + for key, value in other: + self.add(key, value) + + for key, value in kwargs.items(): + self.add(key, value) + + def getlist(self, key, default=__marker): + """Returns a list of all the values for the named field. Returns an + empty list if the key doesn't exist.""" + try: + vals = self._container[key.lower()] + except KeyError: + if default is self.__marker: + return [] + return default + else: + return vals[1:] + + def _prepare_for_method_change(self): + """ + Remove content-specific header fields before changing the request + method to GET or HEAD according to RFC 9110, Section 15.4. + """ + content_specific_headers = [ + "Content-Encoding", + "Content-Language", + "Content-Location", + "Content-Type", + "Content-Length", + "Digest", + "Last-Modified", + ] + for header in content_specific_headers: + self.discard(header) + return self + + # Backwards compatibility for httplib + getheaders = getlist + getallmatchingheaders = getlist + iget = getlist + + # Backwards compatibility for http.cookiejar + get_all = getlist + + def __repr__(self): + return "%s(%s)" % (type(self).__name__, dict(self.itermerged())) + + def _copy_from(self, other): + for key in other: + val = other.getlist(key) + if isinstance(val, list): + # Don't need to convert tuples + val = list(val) + self._container[key.lower()] = [key] + val + + def copy(self): + clone = type(self)() + clone._copy_from(self) + return clone + + def iteritems(self): + """Iterate over all header lines, including duplicate ones.""" + for key in self: + vals = self._container[key.lower()] + for val in vals[1:]: + yield vals[0], val + + def itermerged(self): + """Iterate over all headers, merging duplicate ones together.""" + for key in self: + val = self._container[key.lower()] + yield val[0], ", ".join(val[1:]) + + def items(self): + return list(self.iteritems()) + + @classmethod + def from_httplib(cls, message): # Python 2 + """Read headers from a Python 2 httplib message object.""" + # python2.7 does not expose a proper API for exporting multiheaders + # efficiently. This function re-reads raw lines from the message + # object and extracts the multiheaders properly. + obs_fold_continued_leaders = (" ", "\t") + headers = [] + + for line in message.headers: + if line.startswith(obs_fold_continued_leaders): + if not headers: + # We received a header line that starts with OWS as described + # in RFC-7230 S3.2.4. This indicates a multiline header, but + # there exists no previous header to which we can attach it. + raise InvalidHeader( + "Header continuation with no previous header: %s" % line + ) + else: + key, value = headers[-1] + headers[-1] = (key, value + " " + line.strip()) + continue + + key, value = line.split(":", 1) + headers.append((key, value.strip())) + + return cls(headers) diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/_version.py b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/_version.py new file mode 100644 index 0000000..85e725e --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/_version.py @@ -0,0 +1,2 @@ +# This file is protected via CODEOWNERS +__version__ = "1.26.18" diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/connection.py b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/connection.py new file mode 100644 index 0000000..54b96b1 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/connection.py @@ -0,0 +1,572 @@ +from __future__ import absolute_import + +import datetime +import logging +import os +import re +import socket +import warnings +from socket import error as SocketError +from socket import timeout as SocketTimeout + +from .packages import six +from .packages.six.moves.http_client import HTTPConnection as _HTTPConnection +from .packages.six.moves.http_client import HTTPException # noqa: F401 +from .util.proxy import create_proxy_ssl_context + +try: # Compiled with SSL? + import ssl + + BaseSSLError = ssl.SSLError +except (ImportError, AttributeError): # Platform-specific: No SSL. + ssl = None + + class BaseSSLError(BaseException): + pass + + +try: + # Python 3: not a no-op, we're adding this to the namespace so it can be imported. + ConnectionError = ConnectionError +except NameError: + # Python 2 + class ConnectionError(Exception): + pass + + +try: # Python 3: + # Not a no-op, we're adding this to the namespace so it can be imported. + BrokenPipeError = BrokenPipeError +except NameError: # Python 2: + + class BrokenPipeError(Exception): + pass + + +from ._collections import HTTPHeaderDict # noqa (historical, removed in v2) +from ._version import __version__ +from .exceptions import ( + ConnectTimeoutError, + NewConnectionError, + SubjectAltNameWarning, + SystemTimeWarning, +) +from .util import SKIP_HEADER, SKIPPABLE_HEADERS, connection +from .util.ssl_ import ( + assert_fingerprint, + create_urllib3_context, + is_ipaddress, + resolve_cert_reqs, + resolve_ssl_version, + ssl_wrap_socket, +) +from .util.ssl_match_hostname import CertificateError, match_hostname + +log = logging.getLogger(__name__) + +port_by_scheme = {"http": 80, "https": 443} + +# When it comes time to update this value as a part of regular maintenance +# (ie test_recent_date is failing) update it to ~6 months before the current date. +RECENT_DATE = datetime.date(2022, 1, 1) + +_CONTAINS_CONTROL_CHAR_RE = re.compile(r"[^-!#$%&'*+.^_`|~0-9a-zA-Z]") + + +class HTTPConnection(_HTTPConnection, object): + """ + Based on :class:`http.client.HTTPConnection` but provides an extra constructor + backwards-compatibility layer between older and newer Pythons. + + Additional keyword parameters are used to configure attributes of the connection. + Accepted parameters include: + + - ``strict``: See the documentation on :class:`urllib3.connectionpool.HTTPConnectionPool` + - ``source_address``: Set the source address for the current connection. + - ``socket_options``: Set specific options on the underlying socket. If not specified, then + defaults are loaded from ``HTTPConnection.default_socket_options`` which includes disabling + Nagle's algorithm (sets TCP_NODELAY to 1) unless the connection is behind a proxy. + + For example, if you wish to enable TCP Keep Alive in addition to the defaults, + you might pass: + + .. code-block:: python + + HTTPConnection.default_socket_options + [ + (socket.SOL_SOCKET, socket.SO_KEEPALIVE, 1), + ] + + Or you may want to disable the defaults by passing an empty list (e.g., ``[]``). + """ + + default_port = port_by_scheme["http"] + + #: Disable Nagle's algorithm by default. + #: ``[(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)]`` + default_socket_options = [(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)] + + #: Whether this connection verifies the host's certificate. + is_verified = False + + #: Whether this proxy connection (if used) verifies the proxy host's + #: certificate. + proxy_is_verified = None + + def __init__(self, *args, **kw): + if not six.PY2: + kw.pop("strict", None) + + # Pre-set source_address. + self.source_address = kw.get("source_address") + + #: The socket options provided by the user. If no options are + #: provided, we use the default options. + self.socket_options = kw.pop("socket_options", self.default_socket_options) + + # Proxy options provided by the user. + self.proxy = kw.pop("proxy", None) + self.proxy_config = kw.pop("proxy_config", None) + + _HTTPConnection.__init__(self, *args, **kw) + + @property + def host(self): + """ + Getter method to remove any trailing dots that indicate the hostname is an FQDN. + + In general, SSL certificates don't include the trailing dot indicating a + fully-qualified domain name, and thus, they don't validate properly when + checked against a domain name that includes the dot. In addition, some + servers may not expect to receive the trailing dot when provided. + + However, the hostname with trailing dot is critical to DNS resolution; doing a + lookup with the trailing dot will properly only resolve the appropriate FQDN, + whereas a lookup without a trailing dot will search the system's search domain + list. Thus, it's important to keep the original host around for use only in + those cases where it's appropriate (i.e., when doing DNS lookup to establish the + actual TCP connection across which we're going to send HTTP requests). + """ + return self._dns_host.rstrip(".") + + @host.setter + def host(self, value): + """ + Setter for the `host` property. + + We assume that only urllib3 uses the _dns_host attribute; httplib itself + only uses `host`, and it seems reasonable that other libraries follow suit. + """ + self._dns_host = value + + def _new_conn(self): + """Establish a socket connection and set nodelay settings on it. + + :return: New socket connection. + """ + extra_kw = {} + if self.source_address: + extra_kw["source_address"] = self.source_address + + if self.socket_options: + extra_kw["socket_options"] = self.socket_options + + try: + conn = connection.create_connection( + (self._dns_host, self.port), self.timeout, **extra_kw + ) + + except SocketTimeout: + raise ConnectTimeoutError( + self, + "Connection to %s timed out. (connect timeout=%s)" + % (self.host, self.timeout), + ) + + except SocketError as e: + raise NewConnectionError( + self, "Failed to establish a new connection: %s" % e + ) + + return conn + + def _is_using_tunnel(self): + # Google App Engine's httplib does not define _tunnel_host + return getattr(self, "_tunnel_host", None) + + def _prepare_conn(self, conn): + self.sock = conn + if self._is_using_tunnel(): + # TODO: Fix tunnel so it doesn't depend on self.sock state. + self._tunnel() + # Mark this connection as not reusable + self.auto_open = 0 + + def connect(self): + conn = self._new_conn() + self._prepare_conn(conn) + + def putrequest(self, method, url, *args, **kwargs): + """ """ + # Empty docstring because the indentation of CPython's implementation + # is broken but we don't want this method in our documentation. + match = _CONTAINS_CONTROL_CHAR_RE.search(method) + if match: + raise ValueError( + "Method cannot contain non-token characters %r (found at least %r)" + % (method, match.group()) + ) + + return _HTTPConnection.putrequest(self, method, url, *args, **kwargs) + + def putheader(self, header, *values): + """ """ + if not any(isinstance(v, str) and v == SKIP_HEADER for v in values): + _HTTPConnection.putheader(self, header, *values) + elif six.ensure_str(header.lower()) not in SKIPPABLE_HEADERS: + raise ValueError( + "urllib3.util.SKIP_HEADER only supports '%s'" + % ("', '".join(map(str.title, sorted(SKIPPABLE_HEADERS))),) + ) + + def request(self, method, url, body=None, headers=None): + # Update the inner socket's timeout value to send the request. + # This only triggers if the connection is re-used. + if getattr(self, "sock", None) is not None: + self.sock.settimeout(self.timeout) + + if headers is None: + headers = {} + else: + # Avoid modifying the headers passed into .request() + headers = headers.copy() + if "user-agent" not in (six.ensure_str(k.lower()) for k in headers): + headers["User-Agent"] = _get_default_user_agent() + super(HTTPConnection, self).request(method, url, body=body, headers=headers) + + def request_chunked(self, method, url, body=None, headers=None): + """ + Alternative to the common request method, which sends the + body with chunked encoding and not as one block + """ + headers = headers or {} + header_keys = set([six.ensure_str(k.lower()) for k in headers]) + skip_accept_encoding = "accept-encoding" in header_keys + skip_host = "host" in header_keys + self.putrequest( + method, url, skip_accept_encoding=skip_accept_encoding, skip_host=skip_host + ) + if "user-agent" not in header_keys: + self.putheader("User-Agent", _get_default_user_agent()) + for header, value in headers.items(): + self.putheader(header, value) + if "transfer-encoding" not in header_keys: + self.putheader("Transfer-Encoding", "chunked") + self.endheaders() + + if body is not None: + stringish_types = six.string_types + (bytes,) + if isinstance(body, stringish_types): + body = (body,) + for chunk in body: + if not chunk: + continue + if not isinstance(chunk, bytes): + chunk = chunk.encode("utf8") + len_str = hex(len(chunk))[2:] + to_send = bytearray(len_str.encode()) + to_send += b"\r\n" + to_send += chunk + to_send += b"\r\n" + self.send(to_send) + + # After the if clause, to always have a closed body + self.send(b"0\r\n\r\n") + + +class HTTPSConnection(HTTPConnection): + """ + Many of the parameters to this constructor are passed to the underlying SSL + socket by means of :py:func:`urllib3.util.ssl_wrap_socket`. + """ + + default_port = port_by_scheme["https"] + + cert_reqs = None + ca_certs = None + ca_cert_dir = None + ca_cert_data = None + ssl_version = None + assert_fingerprint = None + tls_in_tls_required = False + + def __init__( + self, + host, + port=None, + key_file=None, + cert_file=None, + key_password=None, + strict=None, + timeout=socket._GLOBAL_DEFAULT_TIMEOUT, + ssl_context=None, + server_hostname=None, + **kw + ): + + HTTPConnection.__init__(self, host, port, strict=strict, timeout=timeout, **kw) + + self.key_file = key_file + self.cert_file = cert_file + self.key_password = key_password + self.ssl_context = ssl_context + self.server_hostname = server_hostname + + # Required property for Google AppEngine 1.9.0 which otherwise causes + # HTTPS requests to go out as HTTP. (See Issue #356) + self._protocol = "https" + + def set_cert( + self, + key_file=None, + cert_file=None, + cert_reqs=None, + key_password=None, + ca_certs=None, + assert_hostname=None, + assert_fingerprint=None, + ca_cert_dir=None, + ca_cert_data=None, + ): + """ + This method should only be called once, before the connection is used. + """ + # If cert_reqs is not provided we'll assume CERT_REQUIRED unless we also + # have an SSLContext object in which case we'll use its verify_mode. + if cert_reqs is None: + if self.ssl_context is not None: + cert_reqs = self.ssl_context.verify_mode + else: + cert_reqs = resolve_cert_reqs(None) + + self.key_file = key_file + self.cert_file = cert_file + self.cert_reqs = cert_reqs + self.key_password = key_password + self.assert_hostname = assert_hostname + self.assert_fingerprint = assert_fingerprint + self.ca_certs = ca_certs and os.path.expanduser(ca_certs) + self.ca_cert_dir = ca_cert_dir and os.path.expanduser(ca_cert_dir) + self.ca_cert_data = ca_cert_data + + def connect(self): + # Add certificate verification + self.sock = conn = self._new_conn() + hostname = self.host + tls_in_tls = False + + if self._is_using_tunnel(): + if self.tls_in_tls_required: + self.sock = conn = self._connect_tls_proxy(hostname, conn) + tls_in_tls = True + + # Calls self._set_hostport(), so self.host is + # self._tunnel_host below. + self._tunnel() + # Mark this connection as not reusable + self.auto_open = 0 + + # Override the host with the one we're requesting data from. + hostname = self._tunnel_host + + server_hostname = hostname + if self.server_hostname is not None: + server_hostname = self.server_hostname + + is_time_off = datetime.date.today() < RECENT_DATE + if is_time_off: + warnings.warn( + ( + "System time is way off (before {0}). This will probably " + "lead to SSL verification errors" + ).format(RECENT_DATE), + SystemTimeWarning, + ) + + # Wrap socket using verification with the root certs in + # trusted_root_certs + default_ssl_context = False + if self.ssl_context is None: + default_ssl_context = True + self.ssl_context = create_urllib3_context( + ssl_version=resolve_ssl_version(self.ssl_version), + cert_reqs=resolve_cert_reqs(self.cert_reqs), + ) + + context = self.ssl_context + context.verify_mode = resolve_cert_reqs(self.cert_reqs) + + # Try to load OS default certs if none are given. + # Works well on Windows (requires Python3.4+) + if ( + not self.ca_certs + and not self.ca_cert_dir + and not self.ca_cert_data + and default_ssl_context + and hasattr(context, "load_default_certs") + ): + context.load_default_certs() + + self.sock = ssl_wrap_socket( + sock=conn, + keyfile=self.key_file, + certfile=self.cert_file, + key_password=self.key_password, + ca_certs=self.ca_certs, + ca_cert_dir=self.ca_cert_dir, + ca_cert_data=self.ca_cert_data, + server_hostname=server_hostname, + ssl_context=context, + tls_in_tls=tls_in_tls, + ) + + # If we're using all defaults and the connection + # is TLSv1 or TLSv1.1 we throw a DeprecationWarning + # for the host. + if ( + default_ssl_context + and self.ssl_version is None + and hasattr(self.sock, "version") + and self.sock.version() in {"TLSv1", "TLSv1.1"} + ): + warnings.warn( + "Negotiating TLSv1/TLSv1.1 by default is deprecated " + "and will be disabled in urllib3 v2.0.0. Connecting to " + "'%s' with '%s' can be enabled by explicitly opting-in " + "with 'ssl_version'" % (self.host, self.sock.version()), + DeprecationWarning, + ) + + if self.assert_fingerprint: + assert_fingerprint( + self.sock.getpeercert(binary_form=True), self.assert_fingerprint + ) + elif ( + context.verify_mode != ssl.CERT_NONE + and not getattr(context, "check_hostname", False) + and self.assert_hostname is not False + ): + # While urllib3 attempts to always turn off hostname matching from + # the TLS library, this cannot always be done. So we check whether + # the TLS Library still thinks it's matching hostnames. + cert = self.sock.getpeercert() + if not cert.get("subjectAltName", ()): + warnings.warn( + ( + "Certificate for {0} has no `subjectAltName`, falling back to check for a " + "`commonName` for now. This feature is being removed by major browsers and " + "deprecated by RFC 2818. (See https://github.com/urllib3/urllib3/issues/497 " + "for details.)".format(hostname) + ), + SubjectAltNameWarning, + ) + _match_hostname(cert, self.assert_hostname or server_hostname) + + self.is_verified = ( + context.verify_mode == ssl.CERT_REQUIRED + or self.assert_fingerprint is not None + ) + + def _connect_tls_proxy(self, hostname, conn): + """ + Establish a TLS connection to the proxy using the provided SSL context. + """ + proxy_config = self.proxy_config + ssl_context = proxy_config.ssl_context + if ssl_context: + # If the user provided a proxy context, we assume CA and client + # certificates have already been set + return ssl_wrap_socket( + sock=conn, + server_hostname=hostname, + ssl_context=ssl_context, + ) + + ssl_context = create_proxy_ssl_context( + self.ssl_version, + self.cert_reqs, + self.ca_certs, + self.ca_cert_dir, + self.ca_cert_data, + ) + + # If no cert was provided, use only the default options for server + # certificate validation + socket = ssl_wrap_socket( + sock=conn, + ca_certs=self.ca_certs, + ca_cert_dir=self.ca_cert_dir, + ca_cert_data=self.ca_cert_data, + server_hostname=hostname, + ssl_context=ssl_context, + ) + + if ssl_context.verify_mode != ssl.CERT_NONE and not getattr( + ssl_context, "check_hostname", False + ): + # While urllib3 attempts to always turn off hostname matching from + # the TLS library, this cannot always be done. So we check whether + # the TLS Library still thinks it's matching hostnames. + cert = socket.getpeercert() + if not cert.get("subjectAltName", ()): + warnings.warn( + ( + "Certificate for {0} has no `subjectAltName`, falling back to check for a " + "`commonName` for now. This feature is being removed by major browsers and " + "deprecated by RFC 2818. (See https://github.com/urllib3/urllib3/issues/497 " + "for details.)".format(hostname) + ), + SubjectAltNameWarning, + ) + _match_hostname(cert, hostname) + + self.proxy_is_verified = ssl_context.verify_mode == ssl.CERT_REQUIRED + return socket + + +def _match_hostname(cert, asserted_hostname): + # Our upstream implementation of ssl.match_hostname() + # only applies this normalization to IP addresses so it doesn't + # match DNS SANs so we do the same thing! + stripped_hostname = asserted_hostname.strip("u[]") + if is_ipaddress(stripped_hostname): + asserted_hostname = stripped_hostname + + try: + match_hostname(cert, asserted_hostname) + except CertificateError as e: + log.warning( + "Certificate did not match expected hostname: %s. Certificate: %s", + asserted_hostname, + cert, + ) + # Add cert to exception and reraise so client code can inspect + # the cert when catching the exception, if they want to + e._peer_cert = cert + raise + + +def _get_default_user_agent(): + return "python-urllib3/%s" % __version__ + + +class DummyConnection(object): + """Used to detect a failed ConnectionCls import.""" + + pass + + +if not ssl: + HTTPSConnection = DummyConnection # noqa: F811 + + +VerifiedHTTPSConnection = HTTPSConnection diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/connectionpool.py b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/connectionpool.py new file mode 100644 index 0000000..5a6adcb --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/connectionpool.py @@ -0,0 +1,1137 @@ +from __future__ import absolute_import + +import errno +import logging +import re +import socket +import sys +import warnings +from socket import error as SocketError +from socket import timeout as SocketTimeout + +from ._collections import HTTPHeaderDict +from .connection import ( + BaseSSLError, + BrokenPipeError, + DummyConnection, + HTTPConnection, + HTTPException, + HTTPSConnection, + VerifiedHTTPSConnection, + port_by_scheme, +) +from .exceptions import ( + ClosedPoolError, + EmptyPoolError, + HeaderParsingError, + HostChangedError, + InsecureRequestWarning, + LocationValueError, + MaxRetryError, + NewConnectionError, + ProtocolError, + ProxyError, + ReadTimeoutError, + SSLError, + TimeoutError, +) +from .packages import six +from .packages.six.moves import queue +from .request import RequestMethods +from .response import HTTPResponse +from .util.connection import is_connection_dropped +from .util.proxy import connection_requires_http_tunnel +from .util.queue import LifoQueue +from .util.request import set_file_position +from .util.response import assert_header_parsing +from .util.retry import Retry +from .util.ssl_match_hostname import CertificateError +from .util.timeout import Timeout +from .util.url import Url, _encode_target +from .util.url import _normalize_host as normalize_host +from .util.url import get_host, parse_url + +try: # Platform-specific: Python 3 + import weakref + + weakref_finalize = weakref.finalize +except AttributeError: # Platform-specific: Python 2 + from .packages.backports.weakref_finalize import weakref_finalize + +xrange = six.moves.xrange + +log = logging.getLogger(__name__) + +_Default = object() + + +# Pool objects +class ConnectionPool(object): + """ + Base class for all connection pools, such as + :class:`.HTTPConnectionPool` and :class:`.HTTPSConnectionPool`. + + .. note:: + ConnectionPool.urlopen() does not normalize or percent-encode target URIs + which is useful if your target server doesn't support percent-encoded + target URIs. + """ + + scheme = None + QueueCls = LifoQueue + + def __init__(self, host, port=None): + if not host: + raise LocationValueError("No host specified.") + + self.host = _normalize_host(host, scheme=self.scheme) + self._proxy_host = host.lower() + self.port = port + + def __str__(self): + return "%s(host=%r, port=%r)" % (type(self).__name__, self.host, self.port) + + def __enter__(self): + return self + + def __exit__(self, exc_type, exc_val, exc_tb): + self.close() + # Return False to re-raise any potential exceptions + return False + + def close(self): + """ + Close all pooled connections and disable the pool. + """ + pass + + +# This is taken from http://hg.python.org/cpython/file/7aaba721ebc0/Lib/socket.py#l252 +_blocking_errnos = {errno.EAGAIN, errno.EWOULDBLOCK} + + +class HTTPConnectionPool(ConnectionPool, RequestMethods): + """ + Thread-safe connection pool for one host. + + :param host: + Host used for this HTTP Connection (e.g. "localhost"), passed into + :class:`http.client.HTTPConnection`. + + :param port: + Port used for this HTTP Connection (None is equivalent to 80), passed + into :class:`http.client.HTTPConnection`. + + :param strict: + Causes BadStatusLine to be raised if the status line can't be parsed + as a valid HTTP/1.0 or 1.1 status line, passed into + :class:`http.client.HTTPConnection`. + + .. note:: + Only works in Python 2. This parameter is ignored in Python 3. + + :param timeout: + Socket timeout in seconds for each individual connection. This can + be a float or integer, which sets the timeout for the HTTP request, + or an instance of :class:`urllib3.util.Timeout` which gives you more + fine-grained control over request timeouts. After the constructor has + been parsed, this is always a `urllib3.util.Timeout` object. + + :param maxsize: + Number of connections to save that can be reused. More than 1 is useful + in multithreaded situations. If ``block`` is set to False, more + connections will be created but they will not be saved once they've + been used. + + :param block: + If set to True, no more than ``maxsize`` connections will be used at + a time. When no free connections are available, the call will block + until a connection has been released. This is a useful side effect for + particular multithreaded situations where one does not want to use more + than maxsize connections per host to prevent flooding. + + :param headers: + Headers to include with all requests, unless other headers are given + explicitly. + + :param retries: + Retry configuration to use by default with requests in this pool. + + :param _proxy: + Parsed proxy URL, should not be used directly, instead, see + :class:`urllib3.ProxyManager` + + :param _proxy_headers: + A dictionary with proxy headers, should not be used directly, + instead, see :class:`urllib3.ProxyManager` + + :param \\**conn_kw: + Additional parameters are used to create fresh :class:`urllib3.connection.HTTPConnection`, + :class:`urllib3.connection.HTTPSConnection` instances. + """ + + scheme = "http" + ConnectionCls = HTTPConnection + ResponseCls = HTTPResponse + + def __init__( + self, + host, + port=None, + strict=False, + timeout=Timeout.DEFAULT_TIMEOUT, + maxsize=1, + block=False, + headers=None, + retries=None, + _proxy=None, + _proxy_headers=None, + _proxy_config=None, + **conn_kw + ): + ConnectionPool.__init__(self, host, port) + RequestMethods.__init__(self, headers) + + self.strict = strict + + if not isinstance(timeout, Timeout): + timeout = Timeout.from_float(timeout) + + if retries is None: + retries = Retry.DEFAULT + + self.timeout = timeout + self.retries = retries + + self.pool = self.QueueCls(maxsize) + self.block = block + + self.proxy = _proxy + self.proxy_headers = _proxy_headers or {} + self.proxy_config = _proxy_config + + # Fill the queue up so that doing get() on it will block properly + for _ in xrange(maxsize): + self.pool.put(None) + + # These are mostly for testing and debugging purposes. + self.num_connections = 0 + self.num_requests = 0 + self.conn_kw = conn_kw + + if self.proxy: + # Enable Nagle's algorithm for proxies, to avoid packet fragmentation. + # We cannot know if the user has added default socket options, so we cannot replace the + # list. + self.conn_kw.setdefault("socket_options", []) + + self.conn_kw["proxy"] = self.proxy + self.conn_kw["proxy_config"] = self.proxy_config + + # Do not pass 'self' as callback to 'finalize'. + # Then the 'finalize' would keep an endless living (leak) to self. + # By just passing a reference to the pool allows the garbage collector + # to free self if nobody else has a reference to it. + pool = self.pool + + # Close all the HTTPConnections in the pool before the + # HTTPConnectionPool object is garbage collected. + weakref_finalize(self, _close_pool_connections, pool) + + def _new_conn(self): + """ + Return a fresh :class:`HTTPConnection`. + """ + self.num_connections += 1 + log.debug( + "Starting new HTTP connection (%d): %s:%s", + self.num_connections, + self.host, + self.port or "80", + ) + + conn = self.ConnectionCls( + host=self.host, + port=self.port, + timeout=self.timeout.connect_timeout, + strict=self.strict, + **self.conn_kw + ) + return conn + + def _get_conn(self, timeout=None): + """ + Get a connection. Will return a pooled connection if one is available. + + If no connections are available and :prop:`.block` is ``False``, then a + fresh connection is returned. + + :param timeout: + Seconds to wait before giving up and raising + :class:`urllib3.exceptions.EmptyPoolError` if the pool is empty and + :prop:`.block` is ``True``. + """ + conn = None + try: + conn = self.pool.get(block=self.block, timeout=timeout) + + except AttributeError: # self.pool is None + raise ClosedPoolError(self, "Pool is closed.") + + except queue.Empty: + if self.block: + raise EmptyPoolError( + self, + "Pool reached maximum size and no more connections are allowed.", + ) + pass # Oh well, we'll create a new connection then + + # If this is a persistent connection, check if it got disconnected + if conn and is_connection_dropped(conn): + log.debug("Resetting dropped connection: %s", self.host) + conn.close() + if getattr(conn, "auto_open", 1) == 0: + # This is a proxied connection that has been mutated by + # http.client._tunnel() and cannot be reused (since it would + # attempt to bypass the proxy) + conn = None + + return conn or self._new_conn() + + def _put_conn(self, conn): + """ + Put a connection back into the pool. + + :param conn: + Connection object for the current host and port as returned by + :meth:`._new_conn` or :meth:`._get_conn`. + + If the pool is already full, the connection is closed and discarded + because we exceeded maxsize. If connections are discarded frequently, + then maxsize should be increased. + + If the pool is closed, then the connection will be closed and discarded. + """ + try: + self.pool.put(conn, block=False) + return # Everything is dandy, done. + except AttributeError: + # self.pool is None. + pass + except queue.Full: + # This should never happen if self.block == True + log.warning( + "Connection pool is full, discarding connection: %s. Connection pool size: %s", + self.host, + self.pool.qsize(), + ) + # Connection never got put back into the pool, close it. + if conn: + conn.close() + + def _validate_conn(self, conn): + """ + Called right before a request is made, after the socket is created. + """ + pass + + def _prepare_proxy(self, conn): + # Nothing to do for HTTP connections. + pass + + def _get_timeout(self, timeout): + """Helper that always returns a :class:`urllib3.util.Timeout`""" + if timeout is _Default: + return self.timeout.clone() + + if isinstance(timeout, Timeout): + return timeout.clone() + else: + # User passed us an int/float. This is for backwards compatibility, + # can be removed later + return Timeout.from_float(timeout) + + def _raise_timeout(self, err, url, timeout_value): + """Is the error actually a timeout? Will raise a ReadTimeout or pass""" + + if isinstance(err, SocketTimeout): + raise ReadTimeoutError( + self, url, "Read timed out. (read timeout=%s)" % timeout_value + ) + + # See the above comment about EAGAIN in Python 3. In Python 2 we have + # to specifically catch it and throw the timeout error + if hasattr(err, "errno") and err.errno in _blocking_errnos: + raise ReadTimeoutError( + self, url, "Read timed out. (read timeout=%s)" % timeout_value + ) + + # Catch possible read timeouts thrown as SSL errors. If not the + # case, rethrow the original. We need to do this because of: + # http://bugs.python.org/issue10272 + if "timed out" in str(err) or "did not complete (read)" in str( + err + ): # Python < 2.7.4 + raise ReadTimeoutError( + self, url, "Read timed out. (read timeout=%s)" % timeout_value + ) + + def _make_request( + self, conn, method, url, timeout=_Default, chunked=False, **httplib_request_kw + ): + """ + Perform a request on a given urllib connection object taken from our + pool. + + :param conn: + a connection from one of our connection pools + + :param timeout: + Socket timeout in seconds for the request. This can be a + float or integer, which will set the same timeout value for + the socket connect and the socket read, or an instance of + :class:`urllib3.util.Timeout`, which gives you more fine-grained + control over your timeouts. + """ + self.num_requests += 1 + + timeout_obj = self._get_timeout(timeout) + timeout_obj.start_connect() + conn.timeout = Timeout.resolve_default_timeout(timeout_obj.connect_timeout) + + # Trigger any extra validation we need to do. + try: + self._validate_conn(conn) + except (SocketTimeout, BaseSSLError) as e: + # Py2 raises this as a BaseSSLError, Py3 raises it as socket timeout. + self._raise_timeout(err=e, url=url, timeout_value=conn.timeout) + raise + + # conn.request() calls http.client.*.request, not the method in + # urllib3.request. It also calls makefile (recv) on the socket. + try: + if chunked: + conn.request_chunked(method, url, **httplib_request_kw) + else: + conn.request(method, url, **httplib_request_kw) + + # We are swallowing BrokenPipeError (errno.EPIPE) since the server is + # legitimately able to close the connection after sending a valid response. + # With this behaviour, the received response is still readable. + except BrokenPipeError: + # Python 3 + pass + except IOError as e: + # Python 2 and macOS/Linux + # EPIPE and ESHUTDOWN are BrokenPipeError on Python 2, and EPROTOTYPE is needed on macOS + # https://erickt.github.io/blog/2014/11/19/adventures-in-debugging-a-potential-osx-kernel-bug/ + if e.errno not in { + errno.EPIPE, + errno.ESHUTDOWN, + errno.EPROTOTYPE, + }: + raise + + # Reset the timeout for the recv() on the socket + read_timeout = timeout_obj.read_timeout + + # App Engine doesn't have a sock attr + if getattr(conn, "sock", None): + # In Python 3 socket.py will catch EAGAIN and return None when you + # try and read into the file pointer created by http.client, which + # instead raises a BadStatusLine exception. Instead of catching + # the exception and assuming all BadStatusLine exceptions are read + # timeouts, check for a zero timeout before making the request. + if read_timeout == 0: + raise ReadTimeoutError( + self, url, "Read timed out. (read timeout=%s)" % read_timeout + ) + if read_timeout is Timeout.DEFAULT_TIMEOUT: + conn.sock.settimeout(socket.getdefaulttimeout()) + else: # None or a value + conn.sock.settimeout(read_timeout) + + # Receive the response from the server + try: + try: + # Python 2.7, use buffering of HTTP responses + httplib_response = conn.getresponse(buffering=True) + except TypeError: + # Python 3 + try: + httplib_response = conn.getresponse() + except BaseException as e: + # Remove the TypeError from the exception chain in + # Python 3 (including for exceptions like SystemExit). + # Otherwise it looks like a bug in the code. + six.raise_from(e, None) + except (SocketTimeout, BaseSSLError, SocketError) as e: + self._raise_timeout(err=e, url=url, timeout_value=read_timeout) + raise + + # AppEngine doesn't have a version attr. + http_version = getattr(conn, "_http_vsn_str", "HTTP/?") + log.debug( + '%s://%s:%s "%s %s %s" %s %s', + self.scheme, + self.host, + self.port, + method, + url, + http_version, + httplib_response.status, + httplib_response.length, + ) + + try: + assert_header_parsing(httplib_response.msg) + except (HeaderParsingError, TypeError) as hpe: # Platform-specific: Python 3 + log.warning( + "Failed to parse headers (url=%s): %s", + self._absolute_url(url), + hpe, + exc_info=True, + ) + + return httplib_response + + def _absolute_url(self, path): + return Url(scheme=self.scheme, host=self.host, port=self.port, path=path).url + + def close(self): + """ + Close all pooled connections and disable the pool. + """ + if self.pool is None: + return + # Disable access to the pool + old_pool, self.pool = self.pool, None + + # Close all the HTTPConnections in the pool. + _close_pool_connections(old_pool) + + def is_same_host(self, url): + """ + Check if the given ``url`` is a member of the same host as this + connection pool. + """ + if url.startswith("/"): + return True + + # TODO: Add optional support for socket.gethostbyname checking. + scheme, host, port = get_host(url) + if host is not None: + host = _normalize_host(host, scheme=scheme) + + # Use explicit default port for comparison when none is given + if self.port and not port: + port = port_by_scheme.get(scheme) + elif not self.port and port == port_by_scheme.get(scheme): + port = None + + return (scheme, host, port) == (self.scheme, self.host, self.port) + + def urlopen( + self, + method, + url, + body=None, + headers=None, + retries=None, + redirect=True, + assert_same_host=True, + timeout=_Default, + pool_timeout=None, + release_conn=None, + chunked=False, + body_pos=None, + **response_kw + ): + """ + Get a connection from the pool and perform an HTTP request. This is the + lowest level call for making a request, so you'll need to specify all + the raw details. + + .. note:: + + More commonly, it's appropriate to use a convenience method provided + by :class:`.RequestMethods`, such as :meth:`request`. + + .. note:: + + `release_conn` will only behave as expected if + `preload_content=False` because we want to make + `preload_content=False` the default behaviour someday soon without + breaking backwards compatibility. + + :param method: + HTTP request method (such as GET, POST, PUT, etc.) + + :param url: + The URL to perform the request on. + + :param body: + Data to send in the request body, either :class:`str`, :class:`bytes`, + an iterable of :class:`str`/:class:`bytes`, or a file-like object. + + :param headers: + Dictionary of custom headers to send, such as User-Agent, + If-None-Match, etc. If None, pool headers are used. If provided, + these headers completely replace any pool-specific headers. + + :param retries: + Configure the number of retries to allow before raising a + :class:`~urllib3.exceptions.MaxRetryError` exception. + + Pass ``None`` to retry until you receive a response. Pass a + :class:`~urllib3.util.retry.Retry` object for fine-grained control + over different types of retries. + Pass an integer number to retry connection errors that many times, + but no other types of errors. Pass zero to never retry. + + If ``False``, then retries are disabled and any exception is raised + immediately. Also, instead of raising a MaxRetryError on redirects, + the redirect response will be returned. + + :type retries: :class:`~urllib3.util.retry.Retry`, False, or an int. + + :param redirect: + If True, automatically handle redirects (status codes 301, 302, + 303, 307, 308). Each redirect counts as a retry. Disabling retries + will disable redirect, too. + + :param assert_same_host: + If ``True``, will make sure that the host of the pool requests is + consistent else will raise HostChangedError. When ``False``, you can + use the pool on an HTTP proxy and request foreign hosts. + + :param timeout: + If specified, overrides the default timeout for this one + request. It may be a float (in seconds) or an instance of + :class:`urllib3.util.Timeout`. + + :param pool_timeout: + If set and the pool is set to block=True, then this method will + block for ``pool_timeout`` seconds and raise EmptyPoolError if no + connection is available within the time period. + + :param release_conn: + If False, then the urlopen call will not release the connection + back into the pool once a response is received (but will release if + you read the entire contents of the response such as when + `preload_content=True`). This is useful if you're not preloading + the response's content immediately. You will need to call + ``r.release_conn()`` on the response ``r`` to return the connection + back into the pool. If None, it takes the value of + ``response_kw.get('preload_content', True)``. + + :param chunked: + If True, urllib3 will send the body using chunked transfer + encoding. Otherwise, urllib3 will send the body using the standard + content-length form. Defaults to False. + + :param int body_pos: + Position to seek to in file-like body in the event of a retry or + redirect. Typically this won't need to be set because urllib3 will + auto-populate the value when needed. + + :param \\**response_kw: + Additional parameters are passed to + :meth:`urllib3.response.HTTPResponse.from_httplib` + """ + + parsed_url = parse_url(url) + destination_scheme = parsed_url.scheme + + if headers is None: + headers = self.headers + + if not isinstance(retries, Retry): + retries = Retry.from_int(retries, redirect=redirect, default=self.retries) + + if release_conn is None: + release_conn = response_kw.get("preload_content", True) + + # Check host + if assert_same_host and not self.is_same_host(url): + raise HostChangedError(self, url, retries) + + # Ensure that the URL we're connecting to is properly encoded + if url.startswith("/"): + url = six.ensure_str(_encode_target(url)) + else: + url = six.ensure_str(parsed_url.url) + + conn = None + + # Track whether `conn` needs to be released before + # returning/raising/recursing. Update this variable if necessary, and + # leave `release_conn` constant throughout the function. That way, if + # the function recurses, the original value of `release_conn` will be + # passed down into the recursive call, and its value will be respected. + # + # See issue #651 [1] for details. + # + # [1] + release_this_conn = release_conn + + http_tunnel_required = connection_requires_http_tunnel( + self.proxy, self.proxy_config, destination_scheme + ) + + # Merge the proxy headers. Only done when not using HTTP CONNECT. We + # have to copy the headers dict so we can safely change it without those + # changes being reflected in anyone else's copy. + if not http_tunnel_required: + headers = headers.copy() + headers.update(self.proxy_headers) + + # Must keep the exception bound to a separate variable or else Python 3 + # complains about UnboundLocalError. + err = None + + # Keep track of whether we cleanly exited the except block. This + # ensures we do proper cleanup in finally. + clean_exit = False + + # Rewind body position, if needed. Record current position + # for future rewinds in the event of a redirect/retry. + body_pos = set_file_position(body, body_pos) + + try: + # Request a connection from the queue. + timeout_obj = self._get_timeout(timeout) + conn = self._get_conn(timeout=pool_timeout) + + conn.timeout = timeout_obj.connect_timeout + + is_new_proxy_conn = self.proxy is not None and not getattr( + conn, "sock", None + ) + if is_new_proxy_conn and http_tunnel_required: + self._prepare_proxy(conn) + + # Make the request on the httplib connection object. + httplib_response = self._make_request( + conn, + method, + url, + timeout=timeout_obj, + body=body, + headers=headers, + chunked=chunked, + ) + + # If we're going to release the connection in ``finally:``, then + # the response doesn't need to know about the connection. Otherwise + # it will also try to release it and we'll have a double-release + # mess. + response_conn = conn if not release_conn else None + + # Pass method to Response for length checking + response_kw["request_method"] = method + + # Import httplib's response into our own wrapper object + response = self.ResponseCls.from_httplib( + httplib_response, + pool=self, + connection=response_conn, + retries=retries, + **response_kw + ) + + # Everything went great! + clean_exit = True + + except EmptyPoolError: + # Didn't get a connection from the pool, no need to clean up + clean_exit = True + release_this_conn = False + raise + + except ( + TimeoutError, + HTTPException, + SocketError, + ProtocolError, + BaseSSLError, + SSLError, + CertificateError, + ) as e: + # Discard the connection for these exceptions. It will be + # replaced during the next _get_conn() call. + clean_exit = False + + def _is_ssl_error_message_from_http_proxy(ssl_error): + # We're trying to detect the message 'WRONG_VERSION_NUMBER' but + # SSLErrors are kinda all over the place when it comes to the message, + # so we try to cover our bases here! + message = " ".join(re.split("[^a-z]", str(ssl_error).lower())) + return ( + "wrong version number" in message or "unknown protocol" in message + ) + + # Try to detect a common user error with proxies which is to + # set an HTTP proxy to be HTTPS when it should be 'http://' + # (ie {'http': 'http://proxy', 'https': 'https://proxy'}) + # Instead we add a nice error message and point to a URL. + if ( + isinstance(e, BaseSSLError) + and self.proxy + and _is_ssl_error_message_from_http_proxy(e) + and conn.proxy + and conn.proxy.scheme == "https" + ): + e = ProxyError( + "Your proxy appears to only use HTTP and not HTTPS, " + "try changing your proxy URL to be HTTP. See: " + "https://urllib3.readthedocs.io/en/1.26.x/advanced-usage.html" + "#https-proxy-error-http-proxy", + SSLError(e), + ) + elif isinstance(e, (BaseSSLError, CertificateError)): + e = SSLError(e) + elif isinstance(e, (SocketError, NewConnectionError)) and self.proxy: + e = ProxyError("Cannot connect to proxy.", e) + elif isinstance(e, (SocketError, HTTPException)): + e = ProtocolError("Connection aborted.", e) + + retries = retries.increment( + method, url, error=e, _pool=self, _stacktrace=sys.exc_info()[2] + ) + retries.sleep() + + # Keep track of the error for the retry warning. + err = e + + finally: + if not clean_exit: + # We hit some kind of exception, handled or otherwise. We need + # to throw the connection away unless explicitly told not to. + # Close the connection, set the variable to None, and make sure + # we put the None back in the pool to avoid leaking it. + conn = conn and conn.close() + release_this_conn = True + + if release_this_conn: + # Put the connection back to be reused. If the connection is + # expired then it will be None, which will get replaced with a + # fresh connection during _get_conn. + self._put_conn(conn) + + if not conn: + # Try again + log.warning( + "Retrying (%r) after connection broken by '%r': %s", retries, err, url + ) + return self.urlopen( + method, + url, + body, + headers, + retries, + redirect, + assert_same_host, + timeout=timeout, + pool_timeout=pool_timeout, + release_conn=release_conn, + chunked=chunked, + body_pos=body_pos, + **response_kw + ) + + # Handle redirect? + redirect_location = redirect and response.get_redirect_location() + if redirect_location: + if response.status == 303: + # Change the method according to RFC 9110, Section 15.4.4. + method = "GET" + # And lose the body not to transfer anything sensitive. + body = None + headers = HTTPHeaderDict(headers)._prepare_for_method_change() + + try: + retries = retries.increment(method, url, response=response, _pool=self) + except MaxRetryError: + if retries.raise_on_redirect: + response.drain_conn() + raise + return response + + response.drain_conn() + retries.sleep_for_retry(response) + log.debug("Redirecting %s -> %s", url, redirect_location) + return self.urlopen( + method, + redirect_location, + body, + headers, + retries=retries, + redirect=redirect, + assert_same_host=assert_same_host, + timeout=timeout, + pool_timeout=pool_timeout, + release_conn=release_conn, + chunked=chunked, + body_pos=body_pos, + **response_kw + ) + + # Check if we should retry the HTTP response. + has_retry_after = bool(response.headers.get("Retry-After")) + if retries.is_retry(method, response.status, has_retry_after): + try: + retries = retries.increment(method, url, response=response, _pool=self) + except MaxRetryError: + if retries.raise_on_status: + response.drain_conn() + raise + return response + + response.drain_conn() + retries.sleep(response) + log.debug("Retry: %s", url) + return self.urlopen( + method, + url, + body, + headers, + retries=retries, + redirect=redirect, + assert_same_host=assert_same_host, + timeout=timeout, + pool_timeout=pool_timeout, + release_conn=release_conn, + chunked=chunked, + body_pos=body_pos, + **response_kw + ) + + return response + + +class HTTPSConnectionPool(HTTPConnectionPool): + """ + Same as :class:`.HTTPConnectionPool`, but HTTPS. + + :class:`.HTTPSConnection` uses one of ``assert_fingerprint``, + ``assert_hostname`` and ``host`` in this order to verify connections. + If ``assert_hostname`` is False, no verification is done. + + The ``key_file``, ``cert_file``, ``cert_reqs``, ``ca_certs``, + ``ca_cert_dir``, ``ssl_version``, ``key_password`` are only used if :mod:`ssl` + is available and are fed into :meth:`urllib3.util.ssl_wrap_socket` to upgrade + the connection socket into an SSL socket. + """ + + scheme = "https" + ConnectionCls = HTTPSConnection + + def __init__( + self, + host, + port=None, + strict=False, + timeout=Timeout.DEFAULT_TIMEOUT, + maxsize=1, + block=False, + headers=None, + retries=None, + _proxy=None, + _proxy_headers=None, + key_file=None, + cert_file=None, + cert_reqs=None, + key_password=None, + ca_certs=None, + ssl_version=None, + assert_hostname=None, + assert_fingerprint=None, + ca_cert_dir=None, + **conn_kw + ): + + HTTPConnectionPool.__init__( + self, + host, + port, + strict, + timeout, + maxsize, + block, + headers, + retries, + _proxy, + _proxy_headers, + **conn_kw + ) + + self.key_file = key_file + self.cert_file = cert_file + self.cert_reqs = cert_reqs + self.key_password = key_password + self.ca_certs = ca_certs + self.ca_cert_dir = ca_cert_dir + self.ssl_version = ssl_version + self.assert_hostname = assert_hostname + self.assert_fingerprint = assert_fingerprint + + def _prepare_conn(self, conn): + """ + Prepare the ``connection`` for :meth:`urllib3.util.ssl_wrap_socket` + and establish the tunnel if proxy is used. + """ + + if isinstance(conn, VerifiedHTTPSConnection): + conn.set_cert( + key_file=self.key_file, + key_password=self.key_password, + cert_file=self.cert_file, + cert_reqs=self.cert_reqs, + ca_certs=self.ca_certs, + ca_cert_dir=self.ca_cert_dir, + assert_hostname=self.assert_hostname, + assert_fingerprint=self.assert_fingerprint, + ) + conn.ssl_version = self.ssl_version + return conn + + def _prepare_proxy(self, conn): + """ + Establishes a tunnel connection through HTTP CONNECT. + + Tunnel connection is established early because otherwise httplib would + improperly set Host: header to proxy's IP:port. + """ + + conn.set_tunnel(self._proxy_host, self.port, self.proxy_headers) + + if self.proxy.scheme == "https": + conn.tls_in_tls_required = True + + conn.connect() + + def _new_conn(self): + """ + Return a fresh :class:`http.client.HTTPSConnection`. + """ + self.num_connections += 1 + log.debug( + "Starting new HTTPS connection (%d): %s:%s", + self.num_connections, + self.host, + self.port or "443", + ) + + if not self.ConnectionCls or self.ConnectionCls is DummyConnection: + raise SSLError( + "Can't connect to HTTPS URL because the SSL module is not available." + ) + + actual_host = self.host + actual_port = self.port + if self.proxy is not None: + actual_host = self.proxy.host + actual_port = self.proxy.port + + conn = self.ConnectionCls( + host=actual_host, + port=actual_port, + timeout=self.timeout.connect_timeout, + strict=self.strict, + cert_file=self.cert_file, + key_file=self.key_file, + key_password=self.key_password, + **self.conn_kw + ) + + return self._prepare_conn(conn) + + def _validate_conn(self, conn): + """ + Called right before a request is made, after the socket is created. + """ + super(HTTPSConnectionPool, self)._validate_conn(conn) + + # Force connect early to allow us to validate the connection. + if not getattr(conn, "sock", None): # AppEngine might not have `.sock` + conn.connect() + + if not conn.is_verified: + warnings.warn( + ( + "Unverified HTTPS request is being made to host '%s'. " + "Adding certificate verification is strongly advised. See: " + "https://urllib3.readthedocs.io/en/1.26.x/advanced-usage.html" + "#ssl-warnings" % conn.host + ), + InsecureRequestWarning, + ) + + if getattr(conn, "proxy_is_verified", None) is False: + warnings.warn( + ( + "Unverified HTTPS connection done to an HTTPS proxy. " + "Adding certificate verification is strongly advised. See: " + "https://urllib3.readthedocs.io/en/1.26.x/advanced-usage.html" + "#ssl-warnings" + ), + InsecureRequestWarning, + ) + + +def connection_from_url(url, **kw): + """ + Given a url, return an :class:`.ConnectionPool` instance of its host. + + This is a shortcut for not having to parse out the scheme, host, and port + of the url before creating an :class:`.ConnectionPool` instance. + + :param url: + Absolute URL string that must include the scheme. Port is optional. + + :param \\**kw: + Passes additional parameters to the constructor of the appropriate + :class:`.ConnectionPool`. Useful for specifying things like + timeout, maxsize, headers, etc. + + Example:: + + >>> conn = connection_from_url('http://google.com/') + >>> r = conn.request('GET', '/') + """ + scheme, host, port = get_host(url) + port = port or port_by_scheme.get(scheme, 80) + if scheme == "https": + return HTTPSConnectionPool(host, port=port, **kw) + else: + return HTTPConnectionPool(host, port=port, **kw) + + +def _normalize_host(host, scheme): + """ + Normalize hosts for comparisons and use with sockets. + """ + + host = normalize_host(host, scheme) + + # httplib doesn't like it when we include brackets in IPv6 addresses + # Specifically, if we include brackets but also pass the port then + # httplib crazily doubles up the square brackets on the Host header. + # Instead, we need to make sure we never pass ``None`` as the port. + # However, for backward compatibility reasons we can't actually + # *assert* that. See http://bugs.python.org/issue28539 + if host.startswith("[") and host.endswith("]"): + host = host[1:-1] + return host + + +def _close_pool_connections(pool): + """Drains a queue of connections and closes each one.""" + try: + while True: + conn = pool.get(block=False) + if conn: + conn.close() + except queue.Empty: + pass # Done. diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__init__.py b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..bf72e2b6fc4931994d003764167a86c791b08af7 GIT binary patch literal 198 zcmZ9FQ3}E^42D;yAi@sfgA2M>@dgT>pv*41;?|b58|);WK|G4b@C0LTKAFDyLy|w? zOY+XLRl*w2uWPKInEo}*dGbhxWGzn5gl61Lk@+IjwnZR^fo!i;4a!ysN9`5lJ(?aG zeE~Ow+L|KY?!fDS8&|4(c|#9QJCKZ3mY}1C*@6$4K)fWSHabX|yWzXsx3=mUJkWx_ O3JxF5mQ*0<{z$J1BZq(FvTkvIB?~Ju8uXdK1 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 literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__pycache__/pyopenssl.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__pycache__/pyopenssl.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4e61d12c449794b4a6202fd0e32b676df7610fc5 GIT binary patch literal 24450 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 D%C=+} literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__pycache__/securetransport.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/__pycache__/securetransport.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..86bb5562b5ccc5b69049613022f8c2336e3b3c53 GIT binary patch literal 35553 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 QvY+e;zSzfp(#t^mzq|!|`Tzg` literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_appengine_environ.py b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_appengine_environ.py new file mode 100644 index 0000000..8765b90 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_appengine_environ.py @@ -0,0 +1,36 @@ +""" +This module provides means to detect the App Engine environment. +""" + +import os + + +def is_appengine(): + return is_local_appengine() or is_prod_appengine() + + +def is_appengine_sandbox(): + """Reports if the app is running in the first generation sandbox. + + The second generation runtimes are technically still in a sandbox, but it + is much less restrictive, so generally you shouldn't need to check for it. + see https://cloud.google.com/appengine/docs/standard/runtimes + """ + return is_appengine() and os.environ["APPENGINE_RUNTIME"] == "python27" + + +def is_local_appengine(): + return "APPENGINE_RUNTIME" in os.environ and os.environ.get( + "SERVER_SOFTWARE", "" + ).startswith("Development/") + + +def is_prod_appengine(): + return "APPENGINE_RUNTIME" in os.environ and os.environ.get( + "SERVER_SOFTWARE", "" + ).startswith("Google App Engine/") + + +def is_prod_appengine_mvms(): + """Deprecated.""" + return False diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/__init__.py b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/__pycache__/__init__.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..8f1516932c0bcdc2ceab4f2992db7b14fa7a6951 GIT binary patch literal 215 zcmZ8bK?=e!5KOFs2z`hLyJ)ZC4-|YssA;spHVKm z3%DUP)|AC|2VMuYah1GRH|4=;2ZCg^Md-05ZAk$pAen?$vPa6TjCU3T2%(J*LKJTJ YF87_S`&J!rL2qy>pU9YT&M_nQ1JABJ)Bpeg literal 0 HcmV?d00001 diff --git a/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/__pycache__/bindings.cpython-312.pyc b/.venv/lib/python3.12/site-packages/pip/_vendor/urllib3/contrib/_securetransport/__pycache__/bindings.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..575a86e4bcaa02ae21789ed38bd7e00d652234a2 GIT binary patch literal 17427 zcmb_?3v3)odR`BwNe+kar}z|`Zw@(};ak*WB@Kr|k-HShB`HyABp3|YO>(5+4Ba!7 zMCBYXi$k*Z`JoE}oMQXzO=38@Tf^2mb}R=$pbL^<;RL}@B)p@>I+(MahXNzvp7wHw zP2kJ-S9ec0M??95gwRyg|JPq%{q@&hRex3M-K~XDUSPdB8)#)1LE~u z9mjo(lQ@x+Y*Jptww)*D*{E!f*hM>XKEiM3i}~9HV!?KySh(#F9ot1>(Y8}`ZWoKi z+a+SjcBxppT_%=omy6}w6=DTzpC75*t`e(IE|3Z%)!Q{u z+GK~=E|-WMa+%mESBPEsb>r8AUoUJ;G>Lh8_j(7=GjUonv(snYsz+c^Xggm3b|dbVAz*4*ac|$TPCJa%EHbiVPaoq_IqNq zHS;W#ToNYApgfx8?=4KvUCeWSIRXW`_Mu;L8J z?M$P8ZXy_^ETmi#RwO^u=$X;l%(HNENmy|V8~qCt!6;=R<&v-J@?-j zNM@denM)!Y^Qy5PvwEQQ_3un%qmBj{JWK0b5~udSv`(5>Mkxz3mqa$^6=Mb&<_iPK%(F0aNn~SA zp1?dZv5Zm{W-bX6b5hoJ$3HPzn|T&aE(t46I~!xlY;Tl;+eV4ab}k7E4)gV?6Jz|` zXm93Oy5*9vV6t`opUl=q$%4{>HI+-kf+BaY5vGmSW^Tcucq*5KiQ|!{hc?Xl>?MIJqP; zIJgb?bie%XCW2AQLdqqPL4wEq|A{+q%0lp_p@F;#YBfV)rh>i7tvuo;>* z>m_eR8)0ac~V86}Xx9R*M_L5sCH5lvg1Dhe?Ivd)<(sQnCh2z3@Oxlge!fsrS z3+su!9b}1^uojL=LP)s36+_+HZghQ1h;0ZPC?vwMXj}-PdL4yCD4K{18%k{3xh${m zD)NdFipFxWy*uAhM3klRkV)q9k@;x~s_!ehTnG+!{ z3n8?Y<8e8f2!|q(J=WH*w>(87H!0{uCwo0;yram8#GbIJ#Ntee`!VINa6g>b@;Egc ztjC}d6buP#Aq+{8!f{y=?#W6VgQbC!x=d&zwu_O6qrz%95)me2QK=^`#NzA9-VO#3 z39l(3WzQq{qJkWaDciB#xFE@E2?CGZ2PRCg72Xy$Vv4X92|Wx)H-Sy2Q9|JeWADa2 z!gNf5@}Y#F$f0;F>eghK0`aZbZbTB+NS|mNrc^Xk#(>74)?$e*VQo*?RU%Mmq$du& z*5xQ!61t$}@Vx$iNBR zWSZ}8#kOfgOf5s6+-qZ3iK1)G8>ARa$a=mbuO|qJjIa@lV9n7m;X6{8tz_K;R!|*U zi`^r)GJGK#OF(Tl1Nb*I^fap6MWr`8o7#c>pyT&#OEMI}P2DXD_ z4H-+3JaJ_vAS^FTudMo(0>bRFu(-5vb9O2)CA9mNLASew)!CJqg&QjZB$j;hE4PJ( zX~8#tTX=7Fe#$KbZY?eamY0QvB?dQpeQ|C!0RHT}f9}TA?EE!h5^d)fR)o3P>$58W zURhwB>Tt6Gw4D~N2bTOZK=)0~&dsje*5++`c4eNhrx%t4pRnj#TAB6VnDZ?Oi#L`Q z7nTE1V+zpov-8tS=qYeLFu&qK&)^Axn;?Yc8Q6##QG01bVUa{;Y84A4L4o4xK9rhM0Z*GS7HVF5_mI7w8~R9Kw}5S#k-;h%qH zc43}|oNfekcbM zRNB?*Ahc^#-iw8$;0`n>*}yp$)VJ+dbmW5R#9kbigLJ5=1ydmfE9T*ug(yy*?a=zd zGA*|F?hYv|OJCVMuDn+iAHJdh^r4%{LFkq+H0YUNizh1Imlbx3WtzDKtRUePeLG#Z zhVF%6kQT4Mi{x8e5tl%&{YkdFe*+&r?O(I~Y+kfDK~n7RYuv~BC)l6O`&wSSAdv~q zKd>bTPm{`%@_yTH1S`v22WQG5h-k8Li6TQbQEZeX{%hPrL<&X^QoeyeLC0QxCZH&I zcwsIUlIR4b`J+Q78rsI*w}G92Hk`H4`d!+F?nYzxqry%ICloetm}qFc-<7A-qQ_Sh zU9Q0XMc7}1vZ6#|4_jzo(x*r0!X}4PQrqDo=x*LspqA*TG&}%@DnY1)Sc{4hQxvj< zLUE>AJj)!6v0ZkRC*{;~OlK@UG#DHj50XYIPidSii=F7JdtPj{vRB!W6BM+pZ+Yne z_FfOi*S(&5a`c`Tig|bTa9~77JVV3YcsL;s>|mgwO*!t}3GaA=5R+nxS3ijX5T#SW z8;rA935UKGD|sp0f|=r;ojtXPh8A3xA`zt>s?e)N95c`DbH{vf{=DtW0xgAt%1Yp=}-ATaa=#PQ`J}Ta&+)PzlZysHeZ$fdzCh%s)I#z;l$pf&mP&YseO1B7$$$(HKYH>z)jBD->?{lf<4WH<7#ZeloP$=DBN(J*5)7)&U{Jdypj;9R z{>*MDqSq7#g9ypMuJBJU!?mNEfhbl9a%SF>tQ#xS6W`%plL?eIO58^BPqBl=Ye0RS z`y$Vt@A$&WwG2EF51S_r_y&dUM@;sF0rgFfd)OEqGPR4bm9>cm#*j3`L;Vw=<;wo8p-htwo?O3h-I)FO6EXT=_=RqT}n z(IvHseNwyFFLj7+sZ$(~x9TlDx+2aZ$^on-kS9BODb(GL{ zAO5dc0!k%S5fjoRricd3BdVLhrrd4&wDtQbb8Ll2@A?k`YS2P06oO@(v}JC>f)KUWdcBY9x7- zPOUitNiuQgJmNIf+V{2N5a@`mvJN2XsmrX zv`rfXcUFTXc^x+#CA1d7GX=VxMl^vZ3suOHn+_#HkrNUP zSrQAlPAP1oSIcBYu~=QL(CAgVrcdI?xvSP_9DgK+SA}Z|w&IQ5$Vu*eY#x`bjXkx} zD(hRr@ur^9ShxJLlJIZg&TQDJM3-f64~8DIxO*$nP$YwdR)GgQVLS||wR!`v(A{l0 zfujrd*4a0rEI3<=#S+w&F_8IKhEu1tpNYj2^Eeq031LRpw+syzWm%cQl@dHSfyivCIePh&-kSf@D* z%cu?QbV0ShtEn1P)gi{S+z??onvV<;0P^Y;`me}b7vAqq5vT@=hVTNf;Vd|&DA<;OAeByRfbQ> zScX$?mG@(rPZ&!m(}KZk8vq(BBXm@=ShbBx<3{on@oD_GkWg@&m+v@saDDwrzB^r0 zyMH}pCbf0@^C?QwwP#RjZBO#eX_MJ}Hpw@nTaY%USbAK*H8m&sGpRO6o=pvSl6+sP zr#H!Wri8X6-;%Cv1k4$T)TEk(Bww$m^({%hHhs1u$v35{>-XnUOpb9=&1l%5r&`Mv zfH$TzX)WzQ7eY$tLKhlhx}i16*QJ^v*^tu8Z9Py41NDw2`Tmr9ILW(Go>8+rdLhXV zrG_Vxyf@W1nB;r()GE_Il;nF;E-y@_*Y*t1;C>pJZg-OJNWGbMxJY*`ZGi<~N|v@_ zG|ea<@QvCO((JjusYPD6{%q_f5GVwL3SHY&$4(@az-bJ&__9iZry6JhT+*wgd^GmMv3u=;E9JHXb%_#adrV$TBt=K z9xm{-ps0mNC>~Vv6T3JdRr_{mN44XwFdCHa9u-=x$6|MV1sAJt)8=ct}tka3rvzP_8F*h!;HAey-%lURV>TnK^1d_bUl zc8cEesI(++5Ju)2PPAiTc^R+lyKxetj)_@p^i70Q@1Dw)Cp92exm5{b;2xTFpRc!y zoVdz2T5C?;;?+uo6BGp@ki??_Q=V9X2U>Kc1+!|kg+&ns8+jR+#>)e#R8KU$Mrcn^ z?9F025<)B@g+JN_L({U{(kBb=D^Fmth6I1&Zo;ma=BQN% zJ^>}*1#z{IzPzBMo zs|MpY5FZ5d*6X-V;jvD8rqHHCe=;)BEGjauFs4J3IKi5dDM(dG)5Z7v%R|H3l(Sh| zl0(uoKA);3Fx9Gp`C=5!8Di7f1)}1t5+udMFa#MIlvRV~H&}G>ivbUxk=QI#gIH9b zXxNfL5a3j78(u_#JL@JBsjG#MA@%U!r>n+F?7pH>hp_ql?)Dn_nf~mpxm{eX(`w(~ z>)i&Tv|mVubfXn3tFBOY5T-FY%&OKqnwK|mPohtO8m8K+LuUBK{T6otwlivuzq3ac zV6LsUV0w%g--i#|F~wrwxZ3vCYI@#Ri=Zp>VY0Xm7Qo$g7mBG(1_y(%0Q>O@nlSr5 zS?R;w7kjX_N|_()>lix>o4=E5t6pPf4fT3BioHggZv6>BHv%r}29R%Vao%W$?ZubS zzf$U(cQ_iPcjqoTC%WlCz&5@l(}!Bxp_ky_^vsGK8v4`1hm$rK+qGrM=nJaWsG`wo zyv2l~R=vqq=`_LquP-Xv)oiT||KRSqc{OHYUtQ$HSvprocHI4*k zSQSFr3BgGHNF$vX*SE8SCwr|Sv|v2ap3PpJ$zT%tv?)Dgu3k!9l=P9|3bdD5?TwSg zf+yp{uN;@OH`U7u9$e`k7yo0#2zZdU*}lj-YvX@-nX~o$IamIpyi!}2fKVyeNkv+={;&zy}1&c;J$^W*mq zoUQwXFUxDbx%{~L@#b%A|HJJk{=>6_hqXh8<-_|WDSP>&o)`88)mfP?KJ(c2jVq7m zo>czI0yHWbcx|^A7aVi;{DL2pl-lNPUkF@DZHg~TR?NJ%=auB`JH9C3s+v-WHTjv> z`Sz;3{j%c{uDEi)Fy*X3Qr(o~DpEz2`vs}u>U~GbSp{Zg!+u$+{0#bLq*hzC@A!U6 z^`q%;EbJFCiFC1*^|Gw?(bi#E>wfXe(waxBhovq1&X+Y!kLM3-`jcGc%c_RQ?!&5{ z{c^p_rj8_6pK9q!a*f}I*vw%Kij}FFW=iYMCb{aDmGzJ74=dZDizeIwAi=^dtJ^PT zn!Kzy^Vo4%(Y9Y|YN2;i+mhs}G`v(*BYM|5V8cEx_?x_KB<-k7IjUbe%99mshmLku z=s0wArW^t*4<0&(QjR*5A2|;lO~;i*Jq7zSpYe?dN{{%C;~K8pW76&E!C|605BSa_ zejw#NXHxF;fS0JY1HSDDmjd^wNx9O!eMB`M@XbejSE`3eYE)->eCl~PIkrdwt^?k6 z#1E%N112?;9`q%>lf*!%+;POaQy$i@M)jvhE2`r4y@MpLTju*!aGhlL_%p}% zdOqzvoLoMvTG@Z^Wpy)DN>;W1qiav5|H;B9tIuv7j!k1h)D-N`;ri1%_Vn)aOUZ6# zP<ArKx^Rr3UyCl(az_%RXR;7(lqq@=_%-!<`$pNNpZrAA^`6y^= zmaS)-=c(ga@As~KI&(O6BPrY@$(jSc<_H(X)*h2;PPcoX)<2v0-s-2f4g)unZL3sQ zd%)Ko;T|jWnp6uUKWa7U?Amd^ficD~at@uQnyo5wIGS(Ap`!tgH^}B&_hZbrwt{p| zKG6ts40#We*9`;tfiY4{qh0BdtGZ((hgXQ-bHMkI`wuf8)TtAw7FFI3J^0Qa-GBbK z53k%zdf6y5OK+Sy%2v4e(9wLHZ$HnpbszBVBYq67IB}IND~&MkuN64v^YcqnLzkaBlY{Sl==jXhdEn?ga?mbqQf}xrdg<-^WxA<*f942J zH_ccTM|fUo!RCF0XA6UW7CXfe9&)mCqrM$m{}JDsYQx@0tE*n1ycYBFS>L6DzDsQT z@?giJ&6Kv$0`ahblUT=m3H#hd=sT`}3diO$U6_5uReYy(ZO>b`3u% zCOUJp^qW*?x_|Tuqb*w)WcA%zpFwQ%^_W5UE~*UQb#fDao5>hWk6lepE+t2oiI;Jh zizYQlXf;qj<-mzie_WJ5%mDSdL|8I(j--v*bYFNj^L#VeKTpio7kujx-kthJOsXgC zop^GW==K+U`w?EW21ZS)FFknv2{TK_3;j$Sr&^8bXG5d4UUcYaG;*eykaDyimlo>E zyUlwX%3x}k4OXMPC-5^P9$+IDUNHB@h}}#jjqcU0 z&5TpXk1|mm8tT?DCxfVWa4+PeCG7}8U~Dmy77SR>8(EueiCHu&ZBOe)eU1C6kH_LoD%vdZ%MVeDLc6pd1m+ACuRo603ZOWd4MEH5D;%t;vo*?+RG$O6t)PCfA{q@)1eZ0r>zW9e=(8nP>c;(jE=uwXQXL>P$tCV>3FG$?v zL~eu=dC`{QM|k$Mjo8@JK4NE2$B2VHog+^6bd9*!(>>y5PtS-)w2O|EchWcFoAi(P zCj%n^p0jb1b7G6psr3|{$ZxjZjnplho*D^>u6MYRu;@k{5j}{jMK9tS(TBKJY!v