shadow-tools 0.2.4__tar.gz → 0.2.5__tar.gz

{shadow_tools-0.2.4 → shadow_tools-0.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: shadow-tools
-Version: 0.2.4
+Version: 0.2.5
 Summary: A practical all-in-one Python toolkit for HTTP, WebSockets, files, data, validation, async work, and CLIs.
 Project-URL: Homepage, https://github.com/WilliamLaurento/shadow-tools
 Project-URL: Issues, https://github.com/WilliamLaurento/shadow-tools/issues
@@ -74,11 +74,12 @@ Reverse-DNS lookup for IP addresses:
 ```python
 from shadowtools import generate_random_ips, reverse_dns
 
-for ip in generate_random_ips(5):
-    print(reverse_dns(ip))
+for result in reverse_dns(generate_random_ips(5)):
+    print(result)  # only IPs with hostnames are shown
 
 # Or look up every generated IP at once.
 print(reverse_dns(generate_random_ips(5)))
+print(reverse_dns(generate_random_ips(5), only_hostnames=False))  # include misses
 ```
 
 ## AI app helpers

{shadow_tools-0.2.4 → shadow_tools-0.2.5}/README.md

@@ -50,11 +50,12 @@ Reverse-DNS lookup for IP addresses:
 ```python
 from shadowtools import generate_random_ips, reverse_dns
 
-for ip in generate_random_ips(5):
-    print(reverse_dns(ip))
+for result in reverse_dns(generate_random_ips(5)):
+    print(result)  # only IPs with hostnames are shown
 
 # Or look up every generated IP at once.
 print(reverse_dns(generate_random_ips(5)))
+print(reverse_dns(generate_random_ips(5), only_hostnames=False))  # include misses
 ```
 
 ## AI app helpers

{shadow_tools-0.2.4 → shadow_tools-0.2.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "shadow-tools"
-version = "0.2.4"
+version = "0.2.5"
 description = "A practical all-in-one Python toolkit for HTTP, WebSockets, files, data, validation, async work, and CLIs."
 readme = "README.md"
 requires-python = ">=3.10"

{shadow_tools-0.2.4 → shadow_tools-0.2.5}/src/shadowtools/__init__.py

@@ -6,7 +6,7 @@ from .http import get, request
 from .network import generate_random_ips, generate_test_ips, is_subdomain_of, make_subdomain, resolve_dns, reverse_dns
 from .validation import is_email, is_url, require_keys
 
-__version__ = "0.2.4"
+__version__ = "0.2.5"
 
 __all__ = [
     "append_text", "ensure_dir", "generate_random_ips", "generate_test_ips", "get", "is_email", "is_subdomain_of", "is_url", "make_subdomain", "read_csv",

{shadow_tools-0.2.4 → shadow_tools-0.2.5}/src/shadowtools/network.py

@@ -18,20 +18,22 @@ def resolve_dns(hostname: str) -> dict[str, list[str]]:
     return {kind: sorted(addresses) for kind, addresses in results.items()}
 
 
-def reverse_dns(ip: str | Iterable[str]) -> dict[str, object] | list[dict[str, object]]:
+def reverse_dns(ip: str | Iterable[str], *, only_hostnames: bool = True) -> dict[str, object] | list[dict[str, object]] | None:
     """Look up DNS names for one IP address or each address in a list.
 
-    An address without a PTR record returns ``hostname: None`` instead of
-    raising an exception.
+    List lookups return only results with a hostname by default. Set
+    ``only_hostnames=False`` to include addresses without PTR records.
     """
     if not isinstance(ip, str):
-        return [reverse_dns(one_ip) for one_ip in ip]
+        results = [reverse_dns(one_ip, only_hostnames=False) for one_ip in ip]
+        return [result for result in results if not only_hostnames or result["hostname"]]
     address = ipaddress.ip_address(ip)
     try:
         hostname, aliases, _ = socket.gethostbyaddr(str(address))
         return {"ip": str(address), "hostname": hostname, "aliases": aliases}
     except (socket.herror, socket.gaierror):
-        return {"ip": str(address), "hostname": None, "aliases": []}
+        result = {"ip": str(address), "hostname": None, "aliases": []}
+        return None if only_hostnames else result
 
 
 def is_subdomain_of(hostname: str, domain: str) -> bool:

{shadow_tools-0.2.4 → shadow_tools-0.2.5}/tests/test_core.py

@@ -44,7 +44,8 @@ def test_network_and_ai_helpers():
     assert generate_test_ips(1)[0].startswith("192.0.2.")
     assert all(ipaddress.ip_address(ip).is_global for ip in generate_random_ips(3))
     assert len(generate_random_ips(2, family=6)) == 2
-    assert reverse_dns("0.0.0.0")["hostname"] is None
-    assert len(reverse_dns(["0.0.0.0", "127.0.0.1"])) == 2
+    assert reverse_dns("0.0.0.0") is None
+    assert reverse_dns("0.0.0.0", only_hostnames=False)["hostname"] is None
+    assert all(item["hostname"] for item in reverse_dns(["0.0.0.0", "127.0.0.1"]))
     assert prompt("Hi {name}", name="Will") == "Hi Will"
     assert tool_schema("lookup_dns", "Lookup DNS", {"host": {"type": "string"}})["name"] == "lookup_dns"