shadow-tools 0.2.2__tar.gz → 0.2.3__tar.gz

{shadow_tools-0.2.2 → shadow_tools-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: shadow-tools
-Version: 0.2.2
+Version: 0.2.3
 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
@@ -75,6 +75,9 @@ from shadowtools import generate_random_ips, reverse_dns
 
 for ip in generate_random_ips(5):
     print(reverse_dns(ip))
+
+# Or look up every generated IP at once.
+print(reverse_dns(generate_random_ips(5)))
 ```
 
 ## AI app helpers

{shadow_tools-0.2.2 → shadow_tools-0.2.3}/README.md

@@ -51,6 +51,9 @@ from shadowtools import generate_random_ips, reverse_dns
 
 for ip in generate_random_ips(5):
     print(reverse_dns(ip))
+
+# Or look up every generated IP at once.
+print(reverse_dns(generate_random_ips(5)))
 ```
 
 ## AI app helpers

{shadow_tools-0.2.2 → shadow_tools-0.2.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "shadow-tools"
-version = "0.2.2"
+version = "0.2.3"
 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.2 → shadow_tools-0.2.3}/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.2"
+__version__ = "0.2.3"
 
 __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.2 → shadow_tools-0.2.3}/src/shadowtools/network.py

@@ -4,6 +4,7 @@ from __future__ import annotations
 import ipaddress
 import random
 import socket
+from collections.abc import Iterable
 
 
 def resolve_dns(hostname: str) -> dict[str, list[str]]:
@@ -17,12 +18,14 @@ def resolve_dns(hostname: str) -> dict[str, list[str]]:
     return {kind: sorted(addresses) for kind, addresses in results.items()}
 
 
-def reverse_dns(ip: str) -> dict[str, object]:
-    """Look up the DNS name assigned to one IPv4 or IPv6 address.
+def reverse_dns(ip: str | Iterable[str]) -> dict[str, object] | list[dict[str, object]]:
+    """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.
     """
+    if not isinstance(ip, str):
+        return [reverse_dns(one_ip) for one_ip in ip]
     address = ipaddress.ip_address(ip)
     try:
         hostname, aliases, _ = socket.gethostbyaddr(str(address))

{shadow_tools-0.2.2 → shadow_tools-0.2.3}/tests/test_core.py

@@ -44,5 +44,6 @@ def test_network_and_ai_helpers():
     assert len(generate_random_ips(3)) == 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 prompt("Hi {name}", name="Will") == "Hi Will"
     assert tool_schema("lookup_dns", "Lookup DNS", {"host": {"type": "string"}})["name"] == "lookup_dns"