ipspot 0.4__py3-none-any.whl → 0.5__py3-none-any.whl

ipspot/__init__.py

@@ -1,6 +1,7 @@
 # -*- coding: utf-8 -*-
 """ipspot modules."""
-from .params import IPSPOT_VERSION, IPv4API
+from .params import IPSPOT_VERSION, IPv4API, IPv6API
 from .ipv4 import get_private_ipv4, get_public_ipv4, is_ipv4
+from .ipv6 import get_private_ipv6, get_public_ipv6, is_ipv6
 from .utils import is_loopback
 __version__ = IPSPOT_VERSION

ipspot/cli.py

@@ -4,8 +4,9 @@ import argparse
 from typing import Union, Tuple
 from art import tprint
 from .ipv4 import get_public_ipv4, get_private_ipv4
+from .ipv6 import get_public_ipv6, get_private_ipv6
 from .utils import _filter_parameter
-from .params import IPv4API, PARAMETERS_NAME_MAP
+from .params import IPv4API, IPv6API, PARAMETERS_NAME_MAP
 from .params import IPSPOT_OVERVIEW, IPSPOT_REPO, IPSPOT_VERSION
 
 
@@ -17,42 +18,72 @@ def ipspot_info() -> None:  # pragma: no cover
     print("Repo : " + IPSPOT_REPO)
 
 
-def display_ip_info(ipv4_api: IPv4API = IPv4API.AUTO_SAFE, geo: bool=False,
+def display_ip_info(ipv4_api: IPv4API = IPv4API.AUTO_SAFE,
+                    ipv6_api: IPv6API = IPv6API.AUTO_SAFE,
+                    geo: bool=False,
                     timeout: Union[float, Tuple[float, float]]=5,
                     max_retries: int = 0, retry_delay: float = 1.0) -> None:  # pragma: no cover
     """
     Print collected IP and location data.
 
     :param ipv4_api: public IPv4 API
+    :param ipv6_api: public IPv6 API
     :param geo: geolocation flag
     :param timeout: timeout value for API
     :param max_retries: number of retries
     :param retry_delay: delay between retries (in seconds)
     """
-    private_result = get_private_ipv4()
     print("Private IP:\n")
-    print("  IP: {private_result[data][ip]}".format(private_result=private_result) if private_result["status"]
-          else "  Error: {private_result[error]}".format(private_result=private_result))
+    private_ipv4_result = get_private_ipv4()
+    if private_ipv4_result["status"]:
+        private_ipv4 = private_ipv4_result["data"]["ip"]
+    else:
+        private_ipv4 = private_ipv4_result["error"]
+    print("  IPv4: {private_ipv4}\n".format(private_ipv4=private_ipv4))
+
+    private_ipv6_result = get_private_ipv6()
+    if private_ipv6_result["status"]:
+        private_ipv6 = private_ipv6_result["data"]["ip"]
+    else:
+        private_ipv6 = private_ipv6_result["error"]
+    print("  IPv6: {private_ipv6}".format(private_ipv6=private_ipv6))
 
     public_title = "\nPublic IP"
     if geo:
         public_title += " and Location Info"
     public_title += ":\n"
     print(public_title)
-    public_result = get_public_ipv4(
+    print("  IPv4:\n")
+    public_ipv4_result = get_public_ipv4(
         ipv4_api,
         geo=geo,
         timeout=timeout,
         max_retries=max_retries,
         retry_delay=retry_delay)
-    if public_result["status"]:
-        for name, parameter in sorted(public_result["data"].items()):
+    if public_ipv4_result["status"]:
+        for name, parameter in sorted(public_ipv4_result["data"].items()):
             print(
-                "  {name}: {parameter}".format(
+                "    {name}: {parameter}".format(
                     name=PARAMETERS_NAME_MAP[name],
                     parameter=_filter_parameter(parameter)))
     else:
-        print("  Error: {public_result[error]}".format(public_result=public_result))
+        print("    Error: {public_ipv4_result[error]}".format(public_ipv4_result=public_ipv4_result))
+
+    print("\n  IPv6:\n")
+    public_ipv6_result = get_public_ipv6(
+        ipv6_api,
+        geo=geo,
+        timeout=timeout,
+        max_retries=max_retries,
+        retry_delay=retry_delay)
+    if public_ipv6_result["status"]:
+        for name, parameter in sorted(public_ipv6_result["data"].items()):
+            print(
+                "    {name}: {parameter}".format(
+                    name=PARAMETERS_NAME_MAP[name],
+                    parameter=_filter_parameter(parameter)))
+    else:
+        print("    Error: {public_ipv6_result[error]}".format(public_ipv6_result=public_ipv6_result))
 
 
 def main() -> None:  # pragma: no cover
@@ -65,6 +96,13 @@ def main() -> None:  # pragma: no cover
         choices=[
             x.value for x in IPv4API],
         default=IPv4API.AUTO_SAFE.value)
+    parser.add_argument(
+        '--ipv6-api',
+        help='public IPv6 API',
+        type=str.lower,
+        choices=[
+            x.value for x in IPv6API],
+        default=IPv6API.AUTO_SAFE.value)
     parser.add_argument('--info', help='info', nargs="?", const=1)
     parser.add_argument('--version', help='version', nargs="?", const=1)
     parser.add_argument('--no-geo', help='no geolocation data', nargs="?", const=1, default=False)
@@ -79,9 +117,11 @@ def main() -> None:  # pragma: no cover
         ipspot_info()
     else:
         ipv4_api = IPv4API(args.ipv4_api)
+        ipv6_api = IPv6API(args.ipv6_api)
         geo = not args.no_geo
         display_ip_info(
             ipv4_api=ipv4_api,
+            ipv6_api=ipv6_api,
             geo=geo,
             timeout=args.timeout,
             max_retries=args.max_retries,

ipspot/ipv4.py

@@ -180,7 +180,7 @@ def _my_ip_io_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]]
         return {"status": False, "error": str(e)}
 
 
-def _ifconfig_co_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]]
+def _ifconfig_co_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]]  # very low rate limit
                       =5) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:
     """
     Get public IP and geolocation using ifconfig.co.
@@ -436,6 +436,94 @@ def _freeipapi_com_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, floa
         return {"status": False, "error": str(e)}
 
 
+def _ipquery_io_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]]=5
+                     ) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:
+    """
+    Get public IP and geolocation using ipquery.io.
+
+    :param geo: geolocation flag
+    :param timeout: timeout value for API
+    """
+    try:
+        data = _get_json_ipv4_forced(url="https://api.ipquery.io/?format=json", timeout=timeout)
+        result = {"status": True, "data": {"ip": data["ip"], "api": "ipquery.io"}}
+        if geo:
+            loc = data.get("location", {})
+            isp = data.get("isp", {})
+            geo_data = {
+                "city": loc.get("city"),
+                "region": loc.get("state"),
+                "country": loc.get("country"),
+                "country_code": loc.get("country_code"),
+                "latitude": loc.get("latitude"),
+                "longitude": loc.get("longitude"),
+                "timezone": loc.get("timezone"),
+                "organization": isp.get("org"),
+            }
+            result["data"].update(geo_data)
+        return result
+    except Exception as e:
+        return {"status": False, "error": str(e)}
+
+
+def _ipwho_is_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]]=5
+                   ) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:
+    """
+    Get public IP and geolocation using ipwho.is.
+
+    :param geo: geolocation flag
+    :param timeout: timeout value for API
+    """
+    try:
+        data = _get_json_ipv4_forced(url="https://ipwho.is", timeout=timeout)
+        result = {"status": True, "data": {"ip": data["ip"], "api": "ipwho.is"}}
+        if geo:
+            connection = data.get("connection", {})
+            timezone = data.get("timezone", {})
+            geo_data = {
+                "city": data.get("city"),
+                "region": data.get("region"),
+                "country": data.get("country"),
+                "country_code": data.get("country_code"),
+                "latitude": data.get("latitude"),
+                "longitude": data.get("longitude"),
+                "organization": connection.get("org"),
+                "timezone": timezone.get("id")
+            }
+            result["data"].update(geo_data)
+        return result
+    except Exception as e:
+        return {"status": False, "error": str(e)}
+
+
+def _wtfismyip_com_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]]=5
+                        ) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:
+    """
+    Get public IP and geolocation using wtfismyip.com.
+
+    :param geo: geolocation flag
+    :param timeout: timeout value for API
+    """
+    try:
+        data = _get_json_standard(url="https://json.ipv4.wtfismyip.com", timeout=timeout)
+        result = {"status": True, "data": {"ip": data["YourFuckingIPAddress"], "api": "wtfismyip.com"}}
+        if geo:
+            geo_data = {
+                "city": data.get("YourFuckingCity"),
+                "region": None,
+                "country": data.get("YourFuckingCountry"),
+                "country_code": data.get("YourFuckingCountryCode"),
+                "latitude": None,
+                "longitude": None,
+                "organization": data.get("YourFuckingISP"),
+                "timezone": None
+            }
+            result["data"].update(geo_data)
+        return result
+    except Exception as e:
+        return {"status": False, "error": str(e)}
+
+
 IPV4_API_MAP = {
     IPv4API.IFCONFIG_CO: {
         "thread_safe": False,
@@ -497,6 +585,21 @@ IPV4_API_MAP = {
         "geo": True,
         "function": _myip_la_ipv4,
     },
+    IPv4API.IPQUERY_IO: {
+        "thread_safe": False,
+        "geo": True,
+        "function": _ipquery_io_ipv4,
+    },
+    IPv4API.IPWHO_IS: {
+        "thread_safe": False,
+        "geo": True,
+        "function": _ipwho_is_ipv4,
+    },
+    IPv4API.WTFISMYIP_COM: {
+        "thread_safe": True,
+        "geo": True,
+        "function": _wtfismyip_com_ipv4
+    },
 }
 
 

ipspot/ipv6.py

@@ -0,0 +1,245 @@
+# -*- coding: utf-8 -*-
+"""ipspot ipv6 functions."""
+import ipaddress
+import socket
+from typing import Union, Dict, List, Tuple
+from .params import IPv6API
+from .utils import is_loopback, _get_json_standard, _attempt_with_retries
+
+
+def is_ipv6(ip: str) -> bool:
+    """
+    Check if the given input is a valid IPv6 address.
+
+    :param ip: input IP
+    """
+    if not isinstance(ip, str):
+        return False
+    try:
+        _ = ipaddress.IPv6Address(ip)
+        return True
+    except Exception:
+        return False
+
+
+def get_private_ipv6() -> Dict[str, Union[bool, Dict[str, str], str]]:
+    """Retrieve the private IPv6 address."""
+    try:
+        with socket.socket(socket.AF_INET6, socket.SOCK_DGRAM) as s:
+            s.connect(("2001:4860:4860::8888", 80))
+            private_ip = s.getsockname()[0]
+            private_ip = private_ip.split("%")[0]
+        if is_ipv6(private_ip) and not is_loopback(private_ip):
+            return {"status": True, "data": {"ip": private_ip}}
+        return {"status": False, "error": "Could not identify a non-loopback IPv6 address for this system."}
+    except Exception as e:
+        return {"status": False, "error": str(e)}
+
+
+def _ip_sb_ipv6(geo: bool=False, timeout: Union[float, Tuple[float, float]]
+                =5) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:
+    """
+    Get public IP and geolocation using ip.sb.
+
+    :param geo: geolocation flag
+    :param timeout: timeout value for API
+    """
+    try:
+        data = _get_json_standard(url="https://api-ipv6.ip.sb/geoip", timeout=timeout)
+        result = {"status": True, "data": {"ip": data["ip"], "api": "ip.sb"}}
+        if geo:
+            geo_data = {
+                "city": data.get("city"),
+                "region": data.get("region"),
+                "country": data.get("country"),
+                "country_code": data.get("country_code"),
+                "latitude": data.get("latitude"),
+                "longitude": data.get("longitude"),
+                "organization": data.get("organization"),
+                "timezone": data.get("timezone")
+            }
+            result["data"].update(geo_data)
+        return result
+    except Exception as e:
+        return {"status": False, "error": str(e)}
+
+
+def _ident_me_ipv6(geo: bool=False, timeout: Union[float, Tuple[float, float]]
+                   =5) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:
+    """
+    Get public IP and geolocation using ident.me.
+
+    :param geo: geolocation flag
+    :param timeout: timeout value for API
+    """
+    try:
+        data = _get_json_standard(url="https://6.ident.me/json", timeout=timeout)
+        result = {"status": True, "data": {"ip": data["ip"], "api": "ident.me"}}
+        if geo:
+            geo_data = {
+                "city": data.get("city"),
+                "region": None,
+                "country": data.get("country"),
+                "country_code": data.get("cc"),
+                "latitude": data.get("latitude"),
+                "longitude": data.get("longitude"),
+                "organization": data.get("aso"),
+                "timezone": data.get("tz")
+            }
+            result["data"].update(geo_data)
+        return result
+    except Exception as e:
+        return {"status": False, "error": str(e)}
+
+
+def _tnedi_me_ipv6(geo: bool=False, timeout: Union[float, Tuple[float, float]]
+                   =5) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:
+    """
+    Get public IP and geolocation using tnedi.me.
+
+    :param geo: geolocation flag
+    :param timeout: timeout value for API
+    """
+    try:
+        data = _get_json_standard(url="https://6.tnedi.me/json", timeout=timeout)
+        result = {"status": True, "data": {"ip": data["ip"], "api": "tnedi.me"}}
+        if geo:
+            geo_data = {
+                "city": data.get("city"),
+                "region": None,
+                "country": data.get("country"),
+                "country_code": data.get("cc"),
+                "latitude": data.get("latitude"),
+                "longitude": data.get("longitude"),
+                "organization": data.get("aso"),
+                "timezone": data.get("tz")
+            }
+            result["data"].update(geo_data)
+        return result
+    except Exception as e:
+        return {"status": False, "error": str(e)}
+
+
+def _ipleak_net_ipv6(geo: bool=False, timeout: Union[float, Tuple[float, float]]
+                     =5) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:
+    """
+    Get public IP and geolocation using ipleak.net.
+
+    :param geo: geolocation flag
+    :param timeout: timeout value for API
+    """
+    try:
+        data = _get_json_standard(url="https://ipv6.ipleak.net/json/", timeout=timeout)
+        result = {"status": True, "data": {"ip": data["ip"], "api": "ipleak.net"}}
+        if geo:
+            geo_data = {
+                "city": data.get("city_name"),
+                "region": data.get("region_name"),
+                "country": data.get("country_name"),
+                "country_code": data.get("country_code"),
+                "latitude": data.get("latitude"),
+                "longitude": data.get("longitude"),
+                "organization": data.get("isp_name"),
+                "timezone": data.get("time_zone")
+            }
+            result["data"].update(geo_data)
+        return result
+    except Exception as e:
+        return {"status": False, "error": str(e)}
+
+
+def _my_ip_io_ipv6(geo: bool=False, timeout: Union[float, Tuple[float, float]]
+                   =5) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:
+    """
+    Get public IP and geolocation using my-ip.io.
+
+    :param geo: geolocation flag
+    :param timeout: timeout value for API
+    """
+    try:
+        data = _get_json_standard(url="https://api6.my-ip.io/v2/ip.json", timeout=timeout)
+        result = {"status": True, "data": {"ip": data["ip"], "api": "my-ip.io"}}
+        if geo:
+            geo_data = {
+                "city": data.get("city"),
+                "region": data.get("region"),
+                "country": data.get("country", {}).get("name"),
+                "country_code": data.get("country", {}).get("code"),
+                "latitude": data.get("location", {}).get("lat"),
+                "longitude": data.get("location", {}).get("lon"),
+                "organization": data.get("asn", {}).get("name"),
+                "timezone": data.get("timeZone")
+            }
+            result["data"].update(geo_data)
+        return result
+    except Exception as e:
+        return {"status": False, "error": str(e)}
+
+
+IPV6_API_MAP = {
+    IPv6API.IP_SB: {
+        "thread_safe": True,
+        "geo": True,
+        "function": _ip_sb_ipv6
+    },
+    IPv6API.IDENT_ME: {
+        "thread_safe": True,
+        "geo": True,
+        "function": _ident_me_ipv6
+    },
+    IPv6API.TNEDI_ME: {
+        "thread_safe": True,
+        "geo": True,
+        "function": _tnedi_me_ipv6
+    },
+    IPv6API.IPLEAK_NET: {
+        "thread_safe": True,
+        "geo": True,
+        "function": _ipleak_net_ipv6
+    },
+    IPv6API.MY_IP_IO: {
+        "thread_safe": True,
+        "geo": True,
+        "function": _my_ip_io_ipv6
+    },
+}
+
+
+def get_public_ipv6(api: IPv6API=IPv6API.AUTO_SAFE, geo: bool=False,
+                    timeout: Union[float, Tuple[float, float]]=5,
+                    max_retries: int = 0,
+                    retry_delay: float = 1.0) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:
+    """
+    Get public IPv6 and geolocation info based on the selected API.
+
+    :param api: public IPv6 API
+    :param geo: geolocation flag
+    :param timeout: timeout value for API
+    :param max_retries: number of retries
+    :param retry_delay: delay between retries (in seconds)
+    """
+    if api in [IPv6API.AUTO, IPv6API.AUTO_SAFE]:
+        for _, api_data in IPV6_API_MAP.items():
+            if api == IPv6API.AUTO_SAFE and not api_data["thread_safe"]:
+                continue
+            func = api_data["function"]
+            result = _attempt_with_retries(
+                func=func,
+                max_retries=max_retries,
+                retry_delay=retry_delay,
+                geo=geo,
+                timeout=timeout)
+            if result["status"]:
+                return result
+        return {"status": False, "error": "All attempts failed."}
+    else:
+        api_data = IPV6_API_MAP.get(api)
+        if api_data:
+            func = api_data["function"]
+            return _attempt_with_retries(
+                func=func,
+                max_retries=max_retries,
+                retry_delay=retry_delay,
+                geo=geo,
+                timeout=timeout)
+        return {"status": False, "error": "Unsupported API: {api}".format(api=api)}

ipspot/params.py

@@ -2,7 +2,7 @@
 """ipspot params."""
 from enum import Enum
 
-IPSPOT_VERSION = "0.4"
+IPSPOT_VERSION = "0.5"
 
 IPSPOT_OVERVIEW = '''
 IPSpot is a Python library for retrieving the current system's IP address and location information.
@@ -35,6 +35,21 @@ class IPv4API(Enum):
     REALLYFREEGEOIP_ORG = "reallyfreegeoip.org"
     MYIP_LA = "myip.la"
     FREEIPAPI_COM = "freeipapi.com"
+    IPQUERY_IO = "ipquery.io"
+    IPWHO_IS = "ipwho.is"
+    WTFISMYIP_COM = "wtfismyip.com"
+
+
+class IPv6API(Enum):
+    """Public IPv6 API enum."""
+
+    AUTO = "auto"
+    AUTO_SAFE = "auto-safe"
+    IP_SB = "ip.sb"
+    IDENT_ME = "ident.me"
+    TNEDI_ME = "tnedi.me"
+    IPLEAK_NET = "ipleak.net"
+    MY_IP_IO = "my-ip.io"
 
 
 PARAMETERS_NAME_MAP = {

{ipspot-0.4.dist-info → ipspot-0.5.dist-info}/METADATA

@@ -1,15 +1,15 @@
 Metadata-Version: 2.4
 Name: ipspot
-Version: 0.4
+Version: 0.5
 Summary: IPSpot: A Python Tool to Fetch the System's IP Address
 Home-page: https://github.com/openscilab/ipspot
-Download-URL: https://github.com/openscilab/ipspot/tarball/v0.4
+Download-URL: https://github.com/openscilab/ipspot/tarball/v0.5
 Author: IPSpot Development Team
 Author-email: ipspot@openscilab.com
 License: MIT
 Project-URL: Source, https://github.com/openscilab/ipspot
 Keywords: ip ipv4 geo geolocation network location ipspot cli
-Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Development Status :: 3 - Alpha
 Classifier: Natural Language :: English
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
@@ -102,13 +102,13 @@ Dynamic: summary
 ## Installation		
 
 ### Source Code
-- Download [Version 0.4](https://github.com/openscilab/ipspot/archive/v0.4.zip) or [Latest Source](https://github.com/openscilab/ipspot/archive/dev.zip)
+- Download [Version 0.5](https://github.com/openscilab/ipspot/archive/v0.5.zip) or [Latest Source](https://github.com/openscilab/ipspot/archive/dev.zip)
 - `pip install .`				
 
 ### PyPI
 
 - Check [Python Packaging User Guide](https://packaging.python.org/installing/)     
-- `pip install ipspot==0.4`						
+- `pip install ipspot==0.5`						
 
 
 ## Usage
@@ -135,6 +135,26 @@ Dynamic: summary
 {'status': True, 'data': {'ip': '10.36.18.154'}}
 ```
 
+#### Public IPv6
+
+```pycon
+>>> from ipspot import get_public_ipv6, IPv6API
+>>> get_public_ipv6(api=IPv6API.IP_SB)
+{'data': {'api': 'ip.sb', 'ip': 'xx:xx:xx:xx::xx'}, 'status': True}
+>>> get_public_ipv6(api=IPv6API.IP_SB, geo=True, timeout=10)
+{'data': {'latitude': 51.2993, 'region': None, 'city': None, 'country_code': 'DE', 'api': 'ip.sb', 'longitude': 9.491, 'country': 'Germany', 'organization': 'Hetzner Online', 'timezone': 'Europe/Berlin', 'ip': 'xx:xx:xx:xx::xx'}, 'status': True}
+>>> get_public_ipv6(api=IPv6API.IP_SB, geo=True, timeout=10, max_retries=5, retry_delay=4)
+{'data': {'latitude': 51.2993, 'region': None, 'city': None, 'country_code': 'DE', 'api': 'ip.sb', 'longitude': 9.491, 'country': 'Germany', 'organization': 'Hetzner Online', 'timezone': 'Europe/Berlin', 'ip': 'xx:xx:xx:xx::xx'}, 'status': True}
+```
+
+#### Private IPv6
+
+```pycon
+>>> from ipspot import get_private_ipv6
+>>> get_private_ipv6()
+{'status': True, 'data': {'ip': 'fe80::e1bd:f78:b233:21c9'}}
+```
+
 ### CLI
 
 ℹ️ You can use `ipspot` or `python -m ipspot` to run this program
@@ -144,7 +164,7 @@ Dynamic: summary
 ```console
 > ipspot --version
 
-0.4
+0.5
 ```
 
 #### Info
@@ -159,11 +179,11 @@ Dynamic: summary
 |___||_|    |____/ | .__/  \___/  \__|
                    |_|
 
-__     __     ___      _  _
-\ \   / / _  / _ \    | || |
- \ \ / / (_)| | | |   | || |_
-  \ V /   _ | |_| | _ |__   _|
-   \_/   (_) \___/ (_)   |_|
+__     __     ___      ____
+\ \   / / _  / _ \    | ___|
+ \ \ / / (_)| | | |   |___ \
+  \ V /   _ | |_| | _  ___) |
+   \_/   (_) \___/ (_)|____/
 
 
 
@@ -181,7 +201,9 @@ Repo : https://github.com/openscilab/ipspot
 > ipspot
 Private IP:
 
-  10.36.18.154
+  IPv4: 192.168.1.35
+
+  IPv6: fe80::e1bd:f78:b233:21c9
 
 Public IP and Location Info:
 
@@ -199,7 +221,7 @@ Public IP and Location Info:
 
 #### IPv4 API
 
-ℹ️ `ipv4-api` valid choices: [`auto-safe`, `auto`, `ip-api.com`, `ipinfo.io`, `ip.sb`, `ident.me`, `tnedi.me`, `ipapi.co`, `ipleak.net`, `my-ip.io`, `ifconfig.co`, `reallyfreegeoip.org`, `freeipapi.com`, `myip.la`]
+ℹ️ `ipv4-api` valid choices: [`auto-safe`, `auto`, `ip-api.com`, `ipinfo.io`, `ip.sb`, `ident.me`, `tnedi.me`, `ipapi.co`, `ipleak.net`, `my-ip.io`, `ifconfig.co`, `reallyfreegeoip.org`, `freeipapi.com`, `myip.la`, `ipquery.io`, `ipwho.is`, `wtfismyip.com`]
 
 ℹ️ The default value: `auto-safe`
 
@@ -207,20 +229,80 @@ Public IP and Location Info:
 > ipspot --ipv4-api="ipinfo.io"
 Private IP:
 
-  10.36.18.154
+  IPv4: 192.168.1.35
+
+  IPv6: fe80::e1bd:f78:b233:21c9
 
 Public IP and Location Info:
 
-  API: ipinfo.io
-  City: Leatherhead
-  Country: N/A
-  Country Code: GB
-  IP: xx.xx.xx.xx
-  Latitude: 51.2965
-  Longitude: -0.3338
-  Organization: AS212238 Datacamp Limited
-  Region: England
-  Timezone: Europe/London
+  IPv4:
+
+    API: ipinfo.io
+    City: Nuremberg
+    Country: Germany
+    Country Code: DE
+    IP: xx.xx.xx.xx
+    Latitude: 49.4527
+    Longitude: 11.0783
+    Organization: Hetzner Online GmbH
+    Region: Bavaria
+    Timezone: Europe/Berlin
+
+  IPv6:
+
+    API: ip.sb
+    City: N/A
+    Country: Germany
+    Country Code: DE
+    IP: xx:xx:xx:xx::xx
+    Latitude: 51.2993
+    Longitude: 9.491
+    Organization: Hetzner Online
+    Region: N/A
+    Timezone: Europe/Berlin
+```
+
+#### IPv6 API
+
+ℹ️ `ipv6-api` valid choices: [`auto-safe`, `auto`, `ip.sb`, `ident.me`, `tnedi.me`, `ipleak.net`, `my-ip.io`]
+
+ℹ️ The default value: `auto-safe`
+
+```console
+> ipspot --ipv6-api="ip.sb"
+Private IP:
+
+  IPv4: 192.168.1.35
+
+  IPv6: fe80::e1bd:f78:b233:21c9
+
+Public IP and Location Info:
+
+  IPv4:
+
+    API: ipinfo.io
+    City: Nuremberg
+    Country: Germany
+    Country Code: DE
+    IP: xx.xx.xx.xx
+    Latitude: 49.4527
+    Longitude: 11.0783
+    Organization: Hetzner Online GmbH
+    Region: Bavaria
+    Timezone: Europe/Berlin
+
+  IPv6:
+
+    API: ip.sb
+    City: N/A
+    Country: Germany
+    Country Code: DE
+    IP: xx:xx:xx:xx::xx
+    Latitude: 51.2993
+    Longitude: 9.491
+    Organization: Hetzner Online
+    Region: N/A
+    Timezone: Europe/Berlin
 ```
 
 #### No Geolocation
@@ -229,12 +311,21 @@ Public IP and Location Info:
 > ipspot --no-geo
 Private IP:
 
-  IP: 10.36.18.154
+  IPv4: 192.168.1.35
+
+  IPv6: fe80::5c40:769f:22de:c196
 
 Public IP:
 
-  API: ipinfo.io
-  IP: xx.xx.xx.xx
+  IPv4:
+
+    API: tnedi.me
+    IP: xx.xx.xx.xx
+
+  IPv6:
+
+    API: ip.sb
+    IP: xx:xx:xx:xx::xx
 ```
 
 ## Issues & Bug Reports			
@@ -269,6 +360,25 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
+## [0.5] - 2025-10-17
+### Added
+- `setup-warp` action
+- Support [ipwho.is](https://ipwho.is/)
+- Support [ipquery.io](http://api.ipquery.io/?format=json)
+- Support [wtfismyip.com](https://wtfismyip.com/json)
+- Support [ident.me](https://ident.me/json) IPv6 API
+- Support [tnedi.me](https://tnedi.me/json) IPv6 API
+- Support [ip.sb](https://api.ip.sb/geoip) IPv6 API
+- Support [ipleak.net](https://ipleak.net/json/) IPv6 API
+- Support [my-ip.io](https://www.my-ip.io/) IPv6 API
+- `is_ipv6` function
+- `get_private_ipv6` function
+- `get_public_ipv6` function
+- `IPv6API` enum
+- `--ipv6-api` argument
+### Changed
+- Test system modified
+- `README.md` updated
 ## [0.4] - 2025-06-09
 ### Added
 - Support [ipapi.co](https://ipapi.co/json/)
@@ -328,7 +438,8 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 - `--no-geo` argument
 - Logo
 
-[Unreleased]: https://github.com/openscilab/ipspot/compare/v0.4...dev
+[Unreleased]: https://github.com/openscilab/ipspot/compare/v0.5...dev
+[0.5]: https://github.com/openscilab/ipspot/compare/v0.4...v0.5
 [0.4]: https://github.com/openscilab/ipspot/compare/v0.3...v0.4
 [0.3]: https://github.com/openscilab/ipspot/compare/v0.2...v0.3
 [0.2]: https://github.com/openscilab/ipspot/compare/v0.1...v0.2

ipspot-0.5.dist-info/RECORD

@@ -0,0 +1,14 @@
+ipspot/__init__.py,sha256=B47uAOAidLkXps1A4zDig6NN2kB3HcdMC20UOrrEfB4,281
+ipspot/__main__.py,sha256=xKHY_tc94SWktkIHV0O9YADAHPZvT8yXOFSm_L2yMno,105
+ipspot/cli.py,sha256=MdyMh-9miuT8zQgklVrvsimaXnqD17sviWRJbUWlk58,4637
+ipspot/ipv4.py,sha256=-HGv-yAsFI56I06qNFDquVVGP9ZhfWwih1Vs3JtemZQ,23825
+ipspot/ipv6.py,sha256=svGgydUUSoXeuT2hLgi5CDDy3n2PtV-b6uDvP5t_iKI,8754
+ipspot/params.py,sha256=PVnz3F1jB5aIle_fScGoF-0MfREhMxcTCXGEXmimUQs,1741
+ipspot/utils.py,sha256=YtkyWGljpFc72rSGljsARjlVrF9hkE7Gl78_5uex1yI,1870
+ipspot-0.5.dist-info/licenses/AUTHORS.md,sha256=5ZvxP1KnuVkurB4psQDSqnqiAyn44q1aeiXUsnYgps4,411
+ipspot-0.5.dist-info/licenses/LICENSE,sha256=0aOd4wzZRoSH_35UZXRHS7alPFTtuFEBJrajLuonEIw,1067
+ipspot-0.5.dist-info/METADATA,sha256=Sbzs3OQ0QZH22X8bNrcLxWbYb1zKBtKwbPf9AVAEon0,13824
+ipspot-0.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+ipspot-0.5.dist-info/entry_points.txt,sha256=DJVLepYr8H3UcvWekU5Jy-tcr_xmWrphzgWGNOd3hlk,43
+ipspot-0.5.dist-info/top_level.txt,sha256=v0WgE1z2iCy_bXU53fVcllwHLTvGNBIvq8u3KPC2_Sc,7
+ipspot-0.5.dist-info/RECORD,,

ipspot-0.4.dist-info/RECORD

@@ -1,13 +0,0 @@
-ipspot/__init__.py,sha256=e_1FqqNDD9eoDVw9eKL_1pS7du-Sei3lm6A4UFjYiUo,211
-ipspot/__main__.py,sha256=xKHY_tc94SWktkIHV0O9YADAHPZvT8yXOFSm_L2yMno,105
-ipspot/cli.py,sha256=M23l9ftqKbdDGhb906q4ywJmcjkHW3VWijyXj76APC4,3222
-ipspot/ipv4.py,sha256=zGFvzD2GeM2lFxMWc6lcCphBaj5qY0kxiHE0FBhDoTc,19998
-ipspot/params.py,sha256=hdArSL10EEq4vtfxA51ftCkn5WfsAzsxdoX1T11yCdQ,1419
-ipspot/utils.py,sha256=YtkyWGljpFc72rSGljsARjlVrF9hkE7Gl78_5uex1yI,1870
-ipspot-0.4.dist-info/licenses/AUTHORS.md,sha256=5ZvxP1KnuVkurB4psQDSqnqiAyn44q1aeiXUsnYgps4,411
-ipspot-0.4.dist-info/licenses/LICENSE,sha256=0aOd4wzZRoSH_35UZXRHS7alPFTtuFEBJrajLuonEIw,1067
-ipspot-0.4.dist-info/METADATA,sha256=8D5MqjjxrCDU60BDPikNoX75iE5bMKVMQX_kFw03WiU,10875
-ipspot-0.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-ipspot-0.4.dist-info/entry_points.txt,sha256=DJVLepYr8H3UcvWekU5Jy-tcr_xmWrphzgWGNOd3hlk,43
-ipspot-0.4.dist-info/top_level.txt,sha256=v0WgE1z2iCy_bXU53fVcllwHLTvGNBIvq8u3KPC2_Sc,7
-ipspot-0.4.dist-info/RECORD,,