Initial commit: 首次建仓，建立目录结构

2026-06-11 23:49:54 +08:00
commit 4038a476b5
9396 changed files with 2372905 additions and 0 deletions
--- a/dashboard/venv/lib/python3.12/site-packages/pycares-5.0.1.dist-info/METADATA
+++ b/dashboard/venv/lib/python3.12/site-packages/pycares-5.0.1.dist-info/METADATA
@ -0,0 +1,146 @@
+Metadata-Version: 2.4
+Name: pycares
+Version: 5.0.1
+Summary: Python interface for c-ares
+Author-email: Saúl Ibarra Corretgé <s@saghul.net>
+License-Expression: MIT
+Project-URL: Homepage, http://github.com/saghul/pycares
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+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 :: 3.14
+Classifier: Programming Language :: Python :: Free Threading :: 3 - Stable
+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; python_version < "3.14"
+Requires-Dist: cffi>=2.0.0b1; python_version >= "3.14"
+Provides-Extra: idna
+Requires-Dist: idna>=2.1; extra == "idna"
+Dynamic: license-file
+
+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 queries
+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.