mirror of
https://github.com/home-assistant/core
synced 2024-10-01 05:30:36 +02:00
68 lines
1.8 KiB
Python
68 lines
1.8 KiB
Python
"""Network utilities."""
|
|
from __future__ import annotations
|
|
|
|
from ipaddress import IPv4Address, IPv6Address, ip_address, ip_network
|
|
|
|
import yarl
|
|
|
|
# RFC6890 - IP addresses of loopback interfaces
|
|
LOOPBACK_NETWORKS = (
|
|
ip_network("127.0.0.0/8"),
|
|
ip_network("::1/128"),
|
|
ip_network("::ffff:127.0.0.0/104"),
|
|
)
|
|
|
|
# RFC6890 - Address allocation for Private Internets
|
|
PRIVATE_NETWORKS = (
|
|
ip_network("fd00::/8"),
|
|
ip_network("10.0.0.0/8"),
|
|
ip_network("172.16.0.0/12"),
|
|
ip_network("192.168.0.0/16"),
|
|
)
|
|
|
|
# RFC6890 - Link local ranges
|
|
LINK_LOCAL_NETWORK = ip_network("169.254.0.0/16")
|
|
|
|
|
|
def is_loopback(address: IPv4Address | IPv6Address) -> bool:
|
|
"""Check if an address is a loopback address."""
|
|
return any(address in network for network in LOOPBACK_NETWORKS)
|
|
|
|
|
|
def is_private(address: IPv4Address | IPv6Address) -> bool:
|
|
"""Check if an address is a private address."""
|
|
return any(address in network for network in PRIVATE_NETWORKS)
|
|
|
|
|
|
def is_link_local(address: IPv4Address | IPv6Address) -> bool:
|
|
"""Check if an address is link local."""
|
|
return address in LINK_LOCAL_NETWORK
|
|
|
|
|
|
def is_local(address: IPv4Address | IPv6Address) -> bool:
|
|
"""Check if an address is loopback or private."""
|
|
return is_loopback(address) or is_private(address)
|
|
|
|
|
|
def is_invalid(address: IPv4Address | IPv6Address) -> bool:
|
|
"""Check if an address is invalid."""
|
|
return bool(address == ip_address("0.0.0.0"))
|
|
|
|
|
|
def is_ip_address(address: str) -> bool:
|
|
"""Check if a given string is an IP address."""
|
|
try:
|
|
ip_address(address)
|
|
except ValueError:
|
|
return False
|
|
|
|
return True
|
|
|
|
|
|
def normalize_url(address: str) -> str:
|
|
"""Normalize a given URL."""
|
|
url = yarl.URL(address.rstrip("/"))
|
|
if url.is_default_port():
|
|
return str(url.with_port(None))
|
|
return str(url)
|