pycares 4.9.0__cp310-cp310-win_arm64.whl

pycares/__main__.py

@@ -0,0 +1,84 @@
+
+import collections.abc
+import pycares
+import select
+import socket
+import sys
+
+
+def wait_channel(channel):
+    while True:
+        read_fds, write_fds = channel.getsock()
+        if not read_fds and not write_fds:
+            break
+        timeout = channel.timeout()
+        if not timeout:
+            channel.process_fd(pycares.ARES_SOCKET_BAD, pycares.ARES_SOCKET_BAD)
+            continue
+        rlist, wlist, xlist = select.select(read_fds, write_fds, [], timeout)
+        for fd in rlist:
+            channel.process_fd(fd, pycares.ARES_SOCKET_BAD)
+        for fd in wlist:
+            channel.process_fd(pycares.ARES_SOCKET_BAD, fd)
+
+
+def cb(result, error):
+    if error is not None:
+        print('Error: (%d) %s' % (error, pycares.errno.strerror(error)))
+    else:
+        parts = [
+            ';; QUESTION SECTION:',
+            ';%s\t\t\tIN\t%s' % (hostname, qtype.upper()),
+            '',
+            ';; ANSWER SECTION:'
+        ]
+
+        if not isinstance(result, collections.abc.Iterable):
+            result = [result]
+
+        for r in result:
+            txt = '%s\t\t%d\tIN\t%s' % (hostname, r.ttl, r.type)
+            if r.type in ('A', 'AAAA'):
+                parts.append('%s\t%s' % (txt, r.host))
+            elif r.type == 'CAA':
+                parts.append('%s\t%d %s "%s"' % (txt, r.critical, r.property, r.value))
+            elif r.type == 'CNAME':
+                parts.append('%s\t%s' % (txt, r.cname))
+            elif r.type == 'MX':
+                parts.append('%s\t%d %s' % (txt, r.priority, r.host))
+            elif r.type == 'NAPTR':
+                parts.append('%s\t%d %d "%s" "%s" "%s" %s' % (txt, r.order, r.preference, r.flags, r.service, r.regex, r.replacement))
+            elif r.type == 'NS':
+                parts.append('%s\t%s' % (txt, r.host))
+            elif r.type == 'PTR':
+                parts.append('%s\t%s' % (txt, r.name))
+            elif r.type == 'SOA':
+                parts.append('%s\t%s %s %d %d %d %d %d' % (txt, r.nsname, r.hostmaster, r.serial, r.refresh, r.retry, r.expires, r.minttl))
+            elif r.type == 'SRV':
+                parts.append('%s\t%d %d %d %s' % (txt, r.priority, r.weight, r.port, r.host))
+            elif r.type == 'TXT':
+                parts.append('%s\t"%s"' % (txt, r.text))
+
+        print('\n'.join(parts))
+
+
+channel = pycares.Channel()
+
+if len(sys.argv) not in (2, 3):
+    print('Invalid arguments! Usage: python -m pycares [query_type] hostname')
+    sys.exit(1)
+
+if len(sys.argv) == 2:
+    _, hostname = sys.argv
+    qtype = 'A'
+else:
+    _, qtype, hostname = sys.argv
+
+try:
+    query_type = getattr(pycares, 'QUERY_TYPE_%s' % qtype.upper())
+except Exception:
+    print('Invalid query type: %s' % qtype)
+    sys.exit(1)
+
+channel.query(hostname, query_type, cb)
+wait_channel(channel)

pycares/_version.py

@@ -0,0 +1,2 @@
+
+__version__ = '4.9.0'

pycares/errno.py

@@ -0,0 +1,69 @@
+from typing import Union
+
+from ._cares import ffi as _ffi, lib as _lib
+from .utils import maybe_str
+
+ARES_SUCCESS = _lib.ARES_SUCCESS
+# error codes
+ARES_ENODATA = _lib.ARES_ENODATA
+ARES_EFORMERR = _lib.ARES_EFORMERR
+ARES_ESERVFAIL = _lib.ARES_ESERVFAIL
+ARES_ENOTFOUND = _lib.ARES_ENOTFOUND
+ARES_ENOTIMP = _lib.ARES_ENOTIMP
+ARES_EREFUSED = _lib.ARES_EREFUSED
+ARES_EBADQUERY = _lib.ARES_EBADQUERY
+ARES_EBADNAME = _lib.ARES_EBADNAME
+ARES_EBADFAMILY = _lib.ARES_EBADFAMILY
+ARES_EBADRESP = _lib.ARES_EBADRESP
+ARES_ECONNREFUSED = _lib.ARES_ECONNREFUSED
+ARES_ETIMEOUT = _lib.ARES_ETIMEOUT
+ARES_EOF = _lib.ARES_EOF
+ARES_EFILE = _lib.ARES_EFILE
+ARES_ENOMEM = _lib.ARES_ENOMEM
+ARES_EDESTRUCTION = _lib.ARES_EDESTRUCTION
+ARES_EBADSTR = _lib.ARES_EBADSTR
+ARES_EBADFLAGS = _lib.ARES_EBADFLAGS
+ARES_ENONAME = _lib.ARES_ENONAME
+ARES_EBADHINTS = _lib.ARES_EBADHINTS
+ARES_ENOTINITIALIZED = _lib.ARES_ENOTINITIALIZED
+ARES_ELOADIPHLPAPI = _lib.ARES_ELOADIPHLPAPI
+ARES_EADDRGETNETWORKPARAMS = _lib.ARES_EADDRGETNETWORKPARAMS
+ARES_ECANCELLED = _lib.ARES_ECANCELLED
+ARES_ESERVICE = _lib.ARES_ESERVICE
+
+errorcode = {
+    ARES_SUCCESS: "ARES_SUCCESS",
+    # error codes
+    ARES_ENODATA: "ARES_ENODATA",
+    ARES_EFORMERR: "ARES_EFORMERR",
+    ARES_ESERVFAIL: "ARES_ESERVFAIL",
+    ARES_ENOTFOUND: "ARES_ENOTFOUND",
+    ARES_ENOTIMP: "ARES_ENOTIMP",
+    ARES_EREFUSED: "ARES_EREFUSED",
+    ARES_EBADQUERY: "ARES_EBADQUERY",
+    ARES_EBADNAME: "ARES_EBADNAME",
+    ARES_EBADFAMILY: "ARES_EBADFAMILY",
+    ARES_EBADRESP: "ARES_EBADRESP",
+    ARES_ECONNREFUSED: "ARES_ECONNREFUSED",
+    ARES_ETIMEOUT: "ARES_ETIMEOUT",
+    ARES_EOF: "ARES_EOF",
+    ARES_EFILE: "ARES_EFILE",
+    ARES_ENOMEM: "ARES_ENOMEM",
+    ARES_EDESTRUCTION: "ARES_EDESTRUCTION",
+    ARES_EBADSTR: "ARES_EBADSTR",
+    ARES_EBADFLAGS: "ARES_EBADFLAGS",
+    ARES_ENONAME: "ARES_ENONAME",
+    ARES_EBADHINTS: "ARES_EBADHINTS",
+    ARES_ENOTINITIALIZED: "ARES_ENOTINITIALIZED",
+    ARES_ELOADIPHLPAPI: "ARES_ELOADIPHLPAPI",
+    ARES_EADDRGETNETWORKPARAMS: "ARES_EADDRGETNETWORKPARAMS",
+    ARES_ECANCELLED: "ARES_ECANCELLED",
+    ARES_ESERVICE: "ARES_ESERVICE",
+}
+
+
+def strerror(code: int) -> Union[str, bytes]:
+    return maybe_str(_ffi.string(_lib.ares_strerror(code)))
+
+
+__all__ = ("errorcode", "strerror", *errorcode.values())

pycares/utils.py

@@ -0,0 +1,53 @@
+
+from typing import Union
+
+try:
+    import idna as idna2008
+except ImportError:
+    idna2008 = None
+
+
+def ascii_bytes(data):
+    if isinstance(data, str):
+        return data.encode('ascii')
+    if isinstance(data, bytes):
+        return data
+    raise TypeError('only str (ascii encoding) and bytes are supported')
+
+
+def maybe_str(data):
+    if isinstance(data, str):
+        return data
+    if isinstance(data, bytes):
+        try:
+            return data.decode('ascii')
+        except UnicodeDecodeError:
+            return data
+    raise TypeError('only str (ascii encoding) and bytes are supported')
+
+
+def parse_name_idna2008(name: str) -> str:
+    parts = name.split('.')
+    r = []
+    for part in parts:
+        if part.isascii():
+            r.append(part.encode('ascii'))
+        else:
+            r.append(idna2008.encode(part))
+    return b'.'.join(r)
+
+
+def parse_name(name: Union[str, bytes]) -> bytes:
+    if isinstance(name, str):
+        if name.isascii():
+            return name.encode('ascii')
+        if idna2008 is not None:
+            return parse_name_idna2008(name)
+        return name.encode('idna')
+    if isinstance(name, bytes):
+        return name
+    raise TypeError('only str and bytes are supported')
+
+
+__all__ = ['ascii_bytes', 'maybe_str', 'parse_name']
+

pycares-4.9.0.dist-info/METADATA

@@ -0,0 +1,164 @@
+Metadata-Version: 2.4
+Name: pycares
+Version: 4.9.0
+Summary: Python interface for c-ares
+Home-page: http://github.com/saghul/pycares
+Author: Saúl Ibarra Corretgé
+Author-email: s@saghul.net
+License: MIT
+Platform: POSIX
+Platform: Microsoft Windows
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+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.13
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Requires-Python: >=3.9
+Description-Content-Type: text/x-rst
+License-File: LICENSE
+Requires-Dist: cffi>=1.5.0
+Provides-Extra: idna
+Requires-Dist: idna>=2.1; extra == "idna"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: platform
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+Looking for new maintainers
+===========================
+
+https://github.com/saghul/pycares/issues/139
+
+pycares: Python interface for c-ares
+====================================
+
+pycares is a Python module which provides an interface to c-ares.
+`c-ares <https://c-ares.org>`_ is a C library that performs
+DNS requests and name resolutions asynchronously.
+
+
+Documentation
+-------------
+
+http://readthedocs.org/docs/pycares/
+
+
+Bundled c-ares
+--------------
+
+pycares currently bundles c-ares as a submodule for ease of building. Using the system
+provided c-ares is possible if the ``PYCARES_USE_SYSTEM_LIB`` environment variable is
+set to ``1`` when building.
+
+NOTE: Versions prior to 4.0.0 used to embed a modified c-ares with extended TTL support.
+That is no longer the case and as a result only A and AAAA records will have TTL information.
+Follow this PR in uppstream c-ares, looks like TTLs will be added: https://github.com/c-ares/c-ares/pull/393
+
+
+Installation
+------------
+
+GNU/Linux, macOS, Windows, others:
+
+::
+
+    pip install pycares
+
+FreeBSD:
+
+::
+
+    cd /usr/ports/dns/py-pycares && make install
+
+
+IDNA 2008 support
+^^^^^^^^^^^^^^^^^
+
+If the ``idna`` package is installed, pycares will support IDNA 2008 encoding otherwise the builtin idna codec will be used,
+which provides IDNA 2003 support.
+
+You can force this at installation time as follows:
+
+::
+
+   pip install pycares[idna]
+
+
+Running the test suite
+----------------------
+
+From the top level directory, run: ``python -m unittest -v``
+
+NOTE: Running the tests requires internet access and are somewhat environment sensitive because real DNS quesries
+are made, there is no mocking. If you observe a failure that the CI cannot reproduce, please try to setup an
+environment as close as the current CI.
+
+
+Using it from the cli, a la dig
+-------------------------------
+
+This module can be used directly from the command line in a similar fashion to dig (limited, of course):
+
+::
+
+   $ python -m pycares google.com
+   ;; QUESTION SECTION:
+   ;google.com			IN	A
+
+   ;; ANSWER SECTION:
+   google.com		300	IN	A	172.217.17.142
+
+   $ python -m pycares mx google.com
+   ;; QUESTION SECTION:
+   ;google.com			IN	MX
+
+   ;; ANSWER SECTION:
+   google.com		600	IN	MX	50 alt4.aspmx.l.google.com
+   google.com		600	IN	MX	10 aspmx.l.google.com
+   google.com		600	IN	MX	40 alt3.aspmx.l.google.com
+   google.com		600	IN	MX	20 alt1.aspmx.l.google.com
+   google.com		600	IN	MX	30 alt2.aspmx.l.google.com
+
+
+Author
+------
+
+Saúl Ibarra Corretgé <s@saghul.net>
+
+
+License
+-------
+
+Unless stated otherwise on-file pycares uses the MIT license, check LICENSE file.
+
+
+Supported Python versions
+-------------------------
+
+Python >= 3.9 are supported. Both CPython and PyPy are supported.
+
+
+Contributing
+------------
+
+If you'd like to contribute, fork the project, make a patch and send a pull
+request. Have a look at the surrounding code and please, make yours look
+alike :-)

pycares-4.9.0.dist-info/RECORD

@@ -0,0 +1,12 @@
+pycares/__init__.py,sha256=ArtBS_p6Q3mzSQLymfl2Ai5l04bwZfPnVJoEKDmVDXQ,39309
+pycares/__main__.py,sha256=-WwwGX4NQ8hpOqrNuCy59quCQJt7IAwQXdQjga5s4WA,2880
+pycares/_cares.pyd,sha256=PGda8yiNifo62YZIZ7HrhdFZH8F_BgT5O5vucwjPc_w,234496
+pycares/_version.py,sha256=cwSQF2Mr2Air7lTld14ORbGvBY9YVvupK2KA0SGv9wo,25
+pycares/errno.py,sha256=32f2SnSjYACq7peW9Iqb7cvDvwup6LDpNMWGHWhLnWI,2340
+pycares/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pycares/utils.py,sha256=ZzjEdkygbU3_B1g4SVwlDS949PhttJG2gK735_6G5Ps,1344
+pycares-4.9.0.dist-info/licenses/LICENSE,sha256=ZzIVbIpf5QFzaiLCDSjxhvH5EViAWLVO-W4ZgBzWvb8,1090
+pycares-4.9.0.dist-info/METADATA,sha256=o2LlsAJHZbyF8M9vohunxfn1fl6nPArn9mL4rpT-hdg,4622
+pycares-4.9.0.dist-info/WHEEL,sha256=3VTbmYeim8AL3qTE9jWZKYc9au-xBJE3sdtKTLGutAo,101
+pycares-4.9.0.dist-info/top_level.txt,sha256=nIeo7L2XUVBQZO2YE6pH7tlKaBWTfmmRcXbqe_NWYCw,15
+pycares-4.9.0.dist-info/RECORD,,

pycares-4.9.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: false
+Tag: cp310-cp310-win_arm64
+

pycares-4.9.0.dist-info/licenses/LICENSE

@@ -0,0 +1,20 @@
+Copyright (C) 2012 by Saúl Ibarra Corretgé
+
+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.
+

pycares-4.9.0.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+_cares
+pycares