]> git.ipfire.org Git - thirdparty/dnspython.git/commitdiff
add WMI extra; simplify install doc a bit
authorBob Halley <halley@dnspython.org>
Wed, 15 Dec 2021 14:46:14 +0000 (06:46 -0800)
committerBob Halley <halley@dnspython.org>
Wed, 15 Dec 2021 14:46:14 +0000 (06:46 -0800)
README.md
pyproject.toml

index 08f3cc1f5a82f14ea8f298d54cafe8ad46467e0b..a96c179674c0d6f8b959cfcac97717190aade795 100644 (file)
--- a/README.md
+++ b/README.md
@@ -42,22 +42,31 @@ information about the changes in this release.
   `sudo python setup.py install`
 * To install the latest from the master branch, run `pip install git+https://github.com/rthalley/dnspython.git`
 
-If you want to use DNS-over-HTTPS, you must run
+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, you must run
+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, you must run
+If you want to use the Trio asynchronous I/O package, run
 `pip install dnspython[trio]`.
 
-If you want to use the Curio asynchronous I/O package, you must run
+If you want to use the Curio asynchronous I/O package, run
 `pip install dnspython[curio]`.
 
+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]`.
+
 Note that you can install any combination of the above, e.g.:
 `pip install dnspython[doh,dnssec,idna]`
 
index c5f72c9cd366650621b61f34947a85ec7af08199..a81758b133919798b7377ee774e41e9db3eea185 100644 (file)
@@ -39,6 +39,7 @@ cryptography = {version=">=2.6,<37.0", optional=true}
 trio = {version=">=0.14,<0.20", optional=true}
 curio = {version="^1.2", optional=true}
 sniffio = {version="^1.1", optional=true}
+wmi = {version="^1.5.1", optional=true}
 
 [tool.poetry.dev-dependencies]
 mypy = "^0.910"
@@ -57,6 +58,7 @@ idna = ['idna']
 dnssec = ['cryptography']
 trio = ['trio']
 curio = ['curio', 'sniffio']
+wmi = ['wmi']
 
 [build-system]
 requires = ["poetry-core"]