/opt/alt/python38/share/doc/alt-python38-pycares-4.1.2/ Current File: //opt/alt/python38/share/doc/alt-python38-pycares-4.1.2/PKG-INFO
Metadata-Version: 2.1
Name: pycares
Version: 4.1.2
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
Description: 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
        ----------------------
        
        There are several ways of running the test suite:
        
        - Run the test with the current Python interpreter:
        
          From the toplevel directory, run: ``python tests/tests.py``
        
        - Use Tox to run the test suite in several virtualenvs with several interpreters
        
          From the toplevel directory, run: ``tox -e py36,py37,py38,py39`` this will run the test suite
          on Python 3.6 through 3.9 (you'll need to have them installed beforehand)
        
        
        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.6 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 :-)
        
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.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 :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Description-Content-Type: text/x-rst
Provides-Extra: idna