From: Bob Halley <halley@dnspython.org>
Date: Wed, 15 Dec 2021 14:46:14 +0000 (-0800)
Subject: add WMI extra; simplify install doc a bit
X-Git-Tag: v2.2.0rc1~13
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=5028ede720380dfbfddb54088e4ea072b140658a;p=thirdparty%2Fdnspython.git

add WMI extra; simplify install doc a bit
---

diff --git a/README.md b/README.md
index 08f3cc1f..a96c1796 100644
--- 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]`
 
diff --git a/pyproject.toml b/pyproject.toml
index c5f72c9c..a81758b1 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -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"]