ipspot 0.5__tar.gz → 0.6__tar.gz

{ipspot-0.5 → ipspot-0.6}/CHANGELOG.md

@@ -5,6 +5,20 @@ 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.6] - 2025-11-18
+### Added
+- `ForceIPHTTPAdapter` class
+- `_get_json_force_ip` function
+- Support [ifconfig.co](https://ifconfig.co/json) IPv6 API
+- Support [reallyfreegeoip.org](https://reallyfreegeoip.org/json/) IPv6 API
+- Support [myip.la](https://api.myip.la/en?json) IPv6 API
+- Support [freeipapi.com](https://freeipapi.com/api/json) IPv6 API
+### Changed
+- [freeipapi.com](https://freeipapi.com/api/json) IPv4 API bug fixed
+- `README.md` updated
+### Removed
+- `IPv4HTTPAdapter` class
+- `_get_json_ipv4_forced` function
 ## [0.5] - 2025-10-17
 ### Added
 - `setup-warp` action
@@ -83,7 +97,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.5...dev
+[Unreleased]: https://github.com/openscilab/ipspot/compare/v0.6...dev
+[0.6]: https://github.com/openscilab/ipspot/compare/v0.5...v0.6
 [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

{ipspot-0.5 → ipspot-0.6}/PKG-INFO

@@ -1,15 +1,15 @@
 Metadata-Version: 2.4
 Name: ipspot
-Version: 0.5
+Version: 0.6
 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.5
+Download-URL: https://github.com/openscilab/ipspot/tarball/v0.6
 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 :: 3 - Alpha
+Classifier: Development Status :: 4 - Beta
 Classifier: Natural Language :: English
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
@@ -52,6 +52,7 @@ Dynamic: summary
 <img src="https://github.com/openscilab/ipspot/raw/main/otherfiles/logo.png" width="350">
 <h1>IPSpot: A Python Tool to Fetch the System's IP Address</h1>
 <br/>
+<a href="https://codecov.io/gh/openscilab/ipspot"><img src="https://codecov.io/gh/openscilab/ipspot/graph/badge.svg?token=XCFKASULS8"></a>
 <a href="https://badge.fury.io/py/ipspot"><img src="https://badge.fury.io/py/ipspot.svg" alt="PyPI version"></a>
 <a href="https://www.python.org/"><img src="https://img.shields.io/badge/built%20with-Python3-green.svg" alt="built with Python3"></a>
 <a href="https://github.com/openscilab/ipspot"><img alt="GitHub repo size" src="https://img.shields.io/github/repo-size/openscilab/ipspot"></a>
@@ -102,13 +103,13 @@ Dynamic: summary
 ## Installation		
 
 ### Source Code
-- Download [Version 0.5](https://github.com/openscilab/ipspot/archive/v0.5.zip) or [Latest Source](https://github.com/openscilab/ipspot/archive/dev.zip)
+- Download [Version 0.6](https://github.com/openscilab/ipspot/archive/v0.6.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.5`						
+- `pip install ipspot==0.6`						
 
 
 ## Usage
@@ -164,7 +165,7 @@ Dynamic: summary
 ```console
 > ipspot --version
 
-0.5
+0.6
 ```
 
 #### Info
@@ -179,11 +180,11 @@ Dynamic: summary
 |___||_|    |____/ | .__/  \___/  \__|
                    |_|
 
-__     __     ___      ____
-\ \   / / _  / _ \    | ___|
- \ \ / / (_)| | | |   |___ \
-  \ V /   _ | |_| | _  ___) |
-   \_/   (_) \___/ (_)|____/
+__     __     ___       __
+\ \   / / _  / _ \     / /_
+ \ \ / / (_)| | | |   | '_ \
+  \ V /   _ | |_| | _ | (_) |
+   \_/   (_) \___/ (_) \___/
 
 
 
@@ -207,16 +208,31 @@ Private IP:
 
 Public IP and Location Info:
 
-  API: ip-api.com
-  City: Southampton
-  Country: United Kingdom
-  Country Code: GB
-  IP: xx.xx.xx.xx
-  Latitude: 50.9097
-  Longitude: -1.4043
-  Organization: N/A
-  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
 ```
 
 #### IPv4 API
@@ -264,7 +280,7 @@ Public IP and Location Info:
 
 #### IPv6 API
 
-ℹ️ `ipv6-api` valid choices: [`auto-safe`, `auto`, `ip.sb`, `ident.me`, `tnedi.me`, `ipleak.net`, `my-ip.io`]
+ℹ️ `ipv6-api` valid choices: [`auto-safe`, `auto`, `ip.sb`, `ident.me`, `tnedi.me`, `ipleak.net`, `my-ip.io`, `ifconfig.co`, `reallyfreegeoip.org`, `myip.la`, `freeipapi.com`]
 
 ℹ️ The default value: `auto-safe`
 
@@ -360,6 +376,20 @@ 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.6] - 2025-11-18
+### Added
+- `ForceIPHTTPAdapter` class
+- `_get_json_force_ip` function
+- Support [ifconfig.co](https://ifconfig.co/json) IPv6 API
+- Support [reallyfreegeoip.org](https://reallyfreegeoip.org/json/) IPv6 API
+- Support [myip.la](https://api.myip.la/en?json) IPv6 API
+- Support [freeipapi.com](https://freeipapi.com/api/json) IPv6 API
+### Changed
+- [freeipapi.com](https://freeipapi.com/api/json) IPv4 API bug fixed
+- `README.md` updated
+### Removed
+- `IPv4HTTPAdapter` class
+- `_get_json_ipv4_forced` function
 ## [0.5] - 2025-10-17
 ### Added
 - `setup-warp` action
@@ -438,7 +468,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.5...dev
+[Unreleased]: https://github.com/openscilab/ipspot/compare/v0.6...dev
+[0.6]: https://github.com/openscilab/ipspot/compare/v0.5...v0.6
 [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

{ipspot-0.5 → ipspot-0.6}/README.md

@@ -2,6 +2,7 @@
 <img src="https://github.com/openscilab/ipspot/raw/main/otherfiles/logo.png" width="350">
 <h1>IPSpot: A Python Tool to Fetch the System's IP Address</h1>
 <br/>
+<a href="https://codecov.io/gh/openscilab/ipspot"><img src="https://codecov.io/gh/openscilab/ipspot/graph/badge.svg?token=XCFKASULS8"></a>
 <a href="https://badge.fury.io/py/ipspot"><img src="https://badge.fury.io/py/ipspot.svg" alt="PyPI version"></a>
 <a href="https://www.python.org/"><img src="https://img.shields.io/badge/built%20with-Python3-green.svg" alt="built with Python3"></a>
 <a href="https://github.com/openscilab/ipspot"><img alt="GitHub repo size" src="https://img.shields.io/github/repo-size/openscilab/ipspot"></a>
@@ -52,13 +53,13 @@
 ## Installation		
 
 ### Source Code
-- Download [Version 0.5](https://github.com/openscilab/ipspot/archive/v0.5.zip) or [Latest Source](https://github.com/openscilab/ipspot/archive/dev.zip)
+- Download [Version 0.6](https://github.com/openscilab/ipspot/archive/v0.6.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.5`						
+- `pip install ipspot==0.6`						
 
 
 ## Usage
@@ -114,7 +115,7 @@
 ```console
 > ipspot --version
 
-0.5
+0.6
 ```
 
 #### Info
@@ -129,11 +130,11 @@
 |___||_|    |____/ | .__/  \___/  \__|
                    |_|
 
-__     __     ___      ____
-\ \   / / _  / _ \    | ___|
- \ \ / / (_)| | | |   |___ \
-  \ V /   _ | |_| | _  ___) |
-   \_/   (_) \___/ (_)|____/
+__     __     ___       __
+\ \   / / _  / _ \     / /_
+ \ \ / / (_)| | | |   | '_ \
+  \ V /   _ | |_| | _ | (_) |
+   \_/   (_) \___/ (_) \___/
 
 
 
@@ -157,16 +158,31 @@ Private IP:
 
 Public IP and Location Info:
 
-  API: ip-api.com
-  City: Southampton
-  Country: United Kingdom
-  Country Code: GB
-  IP: xx.xx.xx.xx
-  Latitude: 50.9097
-  Longitude: -1.4043
-  Organization: N/A
-  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
 ```
 
 #### IPv4 API
@@ -214,7 +230,7 @@ Public IP and Location Info:
 
 #### IPv6 API
 
-ℹ️ `ipv6-api` valid choices: [`auto-safe`, `auto`, `ip.sb`, `ident.me`, `tnedi.me`, `ipleak.net`, `my-ip.io`]
+ℹ️ `ipv6-api` valid choices: [`auto-safe`, `auto`, `ip.sb`, `ident.me`, `tnedi.me`, `ipleak.net`, `my-ip.io`, `ifconfig.co`, `reallyfreegeoip.org`, `myip.la`, `freeipapi.com`]
 
 ℹ️ The default value: `auto-safe`
 

{ipspot-0.5 → ipspot-0.6}/SECURITY.md

@@ -4,8 +4,8 @@
 
 | Version       | Supported          |
 | ------------- | ------------------ |
-| 0.5           | :white_check_mark: |
-| < 0.5         | :x:                |
+| 0.6           | :white_check_mark: |
+| < 0.6         | :x:                |
 
 ## Reporting a Vulnerability
 

{ipspot-0.5 → ipspot-0.6}/ipspot/ipv4.py

@@ -3,69 +3,9 @@
 import ipaddress
 import socket
 from typing import Union, Dict, List, Tuple
-import requests
-from requests.adapters import HTTPAdapter
-from urllib3.poolmanager import PoolManager
-from .utils import is_loopback, _get_json_standard, _attempt_with_retries
-from .params import REQUEST_HEADERS, IPv4API
-
-
-class IPv4HTTPAdapter(HTTPAdapter):
-    """A custom HTTPAdapter that enforces the use of IPv4 for DNS resolution during HTTP(S) requests using the requests library."""
-
-    def init_poolmanager(self, connections: int, maxsize: int, block: bool = False, **kwargs: dict) -> None:
-        """
-        Initialize the connection pool manager using a temporary override of socket.getaddrinfo to ensure only IPv4 addresses are used.
-
-        :param connections: the number of connection pools to cache
-        :param maxsize: the maximum number of connections to save in the pool
-        :param block: whether the connections should block when reaching the max size
-        :param kwargs: additional keyword arguments for the PoolManager
-        """
-        self.poolmanager = PoolManager(
-            num_pools=connections,
-            maxsize=maxsize,
-            block=block,
-            socket_options=self._ipv4_socket_options(),
-            **kwargs
-        )
-
-    def _ipv4_socket_options(self) -> list:
-        """
-        Temporarily patches socket.getaddrinfo to filter only IPv4 addresses (AF_INET).
-
-        :return: an empty list of socket options; DNS patching occurs here
-        """
-        original_getaddrinfo = socket.getaddrinfo
-
-        def ipv4_only_getaddrinfo(*args: list, **kwargs: dict) -> List[Tuple]:
-            results = original_getaddrinfo(*args, **kwargs)
-            return [res for res in results if res[0] == socket.AF_INET]
-
-        self._original_getaddrinfo = socket.getaddrinfo
-        socket.getaddrinfo = ipv4_only_getaddrinfo
-
-        return []
-
-    def __del__(self) -> None:
-        """Restores the original socket.getaddrinfo function upon adapter deletion."""
-        if hasattr(self, "_original_getaddrinfo"):
-            socket.getaddrinfo = self._original_getaddrinfo
-
-
-def _get_json_ipv4_forced(url: str, timeout: Union[float, Tuple[float, float]]) -> dict:
-    """
-    Send GET request with forced IPv4 using IPv4HTTPAdapter that returns JSON response.
-
-    :param url: API url
-    :param timeout: timeout value for API
-    """
-    with requests.Session() as session:
-        session.mount("http://", IPv4HTTPAdapter())
-        session.mount("https://", IPv4HTTPAdapter())
-        response = session.get(url, headers=REQUEST_HEADERS, timeout=timeout)
-        response.raise_for_status()
-        return response.json()
+from .utils import is_loopback, _attempt_with_retries
+from .utils import _get_json_standard, _get_json_force_ip
+from .params import IPv4API
 
 
 def is_ipv4(ip: str) -> bool:
@@ -189,7 +129,7 @@ def _ifconfig_co_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]
     :param timeout: timeout value for API
     """
     try:
-        data = _get_json_ipv4_forced(url="https://ifconfig.co/json", timeout=timeout)
+        data = _get_json_force_ip(url="https://ifconfig.co/json", timeout=timeout, version="ipv4")
         result = {"status": True, "data": {"ip": data["ip"], "api": "ifconfig.co"}}
         if geo:
             geo_data = {
@@ -217,7 +157,7 @@ def _ipapi_co_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]]
     :param timeout: timeout value for API
     """
     try:
-        data = _get_json_ipv4_forced(url="https://ipapi.co/json/", timeout=timeout)
+        data = _get_json_force_ip(url="https://ipapi.co/json/", timeout=timeout, version="ipv4")
         result = {"status": True, "data": {"ip": data["ip"], "api": "ipapi.co"}}
         if geo:
             geo_data = {
@@ -245,7 +185,7 @@ def _ip_api_com_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]]
     :param timeout: timeout value for API
     """
     try:
-        data = _get_json_ipv4_forced(url="http://ip-api.com/json/", timeout=timeout)
+        data = _get_json_force_ip(url="http://ip-api.com/json/", timeout=timeout, version="ipv4")
         if data.get("status") != "success":
             return {"status": False, "error": "ip-api lookup failed"}
         result = {"status": True, "data": {"ip": data["query"], "api": "ip-api.com"}}
@@ -275,7 +215,7 @@ def _ipinfo_io_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]]
     :param timeout: timeout value for API
     """
     try:
-        data = _get_json_ipv4_forced(url="https://ipinfo.io/json", timeout=timeout)
+        data = _get_json_force_ip(url="https://ipinfo.io/json", timeout=timeout, version="ipv4")
         result = {"status": True, "data": {"ip": data["ip"], "api": "ipinfo.io"}}
         if geo:
             loc = data.get("loc", "").split(",")
@@ -304,7 +244,7 @@ def _reallyfreegeoip_org_ipv4(geo: bool=False, timeout: Union[float, Tuple[float
     :param timeout: timeout value for API
     """
     try:
-        data = _get_json_ipv4_forced(url="https://reallyfreegeoip.org/json/", timeout=timeout)
+        data = _get_json_force_ip(url="https://reallyfreegeoip.org/json/", timeout=timeout, version="ipv4")
         result = {"status": True, "data": {"ip": data["ip"], "api": "reallyfreegeoip.org"}}
         if geo:
             geo_data = {
@@ -388,7 +328,7 @@ def _myip_la_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]]=5
     :param timeout: timeout value for API
     """
     try:
-        data = _get_json_ipv4_forced(url="https://api.myip.la/en?json", timeout=timeout)
+        data = _get_json_force_ip(url="https://api.myip.la/en?json", timeout=timeout, version="ipv4")
         result = {"status": True, "data": {"ip": data["ip"], "api": "myip.la"}}
         if geo:
             loc = data.get("location", {})
@@ -417,8 +357,9 @@ def _freeipapi_com_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, floa
     :param timeout: timeout value for API
     """
     try:
-        data = _get_json_ipv4_forced(url="https://freeipapi.com/api/json", timeout=timeout)
+        data = _get_json_force_ip(url="https://freeipapi.com/api/json", timeout=timeout, version="ipv4")
         result = {"status": True, "data": {"ip": data["ipAddress"], "api": "freeipapi.com"}}
+        tzs = data.get("timeZones", [])
         if geo:
             geo_data = {
                 "city": data.get("cityName"),
@@ -427,8 +368,8 @@ def _freeipapi_com_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, floa
                 "country_code": data.get("countryCode"),
                 "latitude": data.get("latitude"),
                 "longitude": data.get("longitude"),
-                "organization": None,
-                "timezone": data.get("timeZone")
+                "organization": data.get("asnOrganization"),
+                "timezone": tzs[0] if len(tzs) > 0 else None
             }
             result["data"].update(geo_data)
         return result
@@ -445,7 +386,7 @@ def _ipquery_io_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]]
     :param timeout: timeout value for API
     """
     try:
-        data = _get_json_ipv4_forced(url="https://api.ipquery.io/?format=json", timeout=timeout)
+        data = _get_json_force_ip(url="https://api.ipquery.io/?format=json", timeout=timeout, version="ipv4")
         result = {"status": True, "data": {"ip": data["ip"], "api": "ipquery.io"}}
         if geo:
             loc = data.get("location", {})
@@ -475,7 +416,7 @@ def _ipwho_is_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]]=5
     :param timeout: timeout value for API
     """
     try:
-        data = _get_json_ipv4_forced(url="https://ipwho.is", timeout=timeout)
+        data = _get_json_force_ip(url="https://ipwho.is", timeout=timeout, version="ipv4")
         result = {"status": True, "data": {"ip": data["ip"], "api": "ipwho.is"}}
         if geo:
             connection = data.get("connection", {})

{ipspot-0.5 → ipspot-0.6}/ipspot/ipv6.py

@@ -4,7 +4,8 @@ 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
+from .utils import is_loopback, _attempt_with_retries
+from .utils import _get_json_standard, _get_json_force_ip
 
 
 def is_ipv6(ip: str) -> bool:
@@ -176,6 +177,120 @@ def _my_ip_io_ipv6(geo: bool=False, timeout: Union[float, Tuple[float, float]]
         return {"status": False, "error": str(e)}
 
 
+def _ifconfig_co_ipv6(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.
+
+    :param geo: geolocation flag
+    :param timeout: timeout value for API
+    """
+    try:
+        data = _get_json_force_ip(url="https://ifconfig.co/json", timeout=timeout, version="ipv6")
+        result = {"status": True, "data": {"ip": data["ip"], "api": "ifconfig.co"}}
+        if geo:
+            geo_data = {
+                "city": data.get("city"),
+                "region": data.get("region_name"),
+                "country": data.get("country"),
+                "country_code": data.get("country_iso"),
+                "latitude": data.get("latitude"),
+                "longitude": data.get("longitude"),
+                "organization": data.get("asn_org"),
+                "timezone": data.get("time_zone")
+            }
+            result["data"].update(geo_data)
+        return result
+    except Exception as e:
+        return {"status": False, "error": str(e)}
+
+
+def _reallyfreegeoip_org_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 reallyfreegeoip.org.
+
+    :param geo: geolocation flag
+    :param timeout: timeout value for API
+    """
+    try:
+        data = _get_json_force_ip(url="https://reallyfreegeoip.org/json/", timeout=timeout, version="ipv6")
+        result = {"status": True, "data": {"ip": data["ip"], "api": "reallyfreegeoip.org"}}
+        if geo:
+            geo_data = {
+                "city": data.get("city"),
+                "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": None,  # does not provide organization
+                "timezone": data.get("time_zone")
+            }
+            result["data"].update(geo_data)
+        return result
+    except Exception as e:
+        return {"status": False, "error": str(e)}
+
+
+def _myip_la_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 myip.la.
+
+    :param geo: geolocation flag
+    :param timeout: timeout value for API
+    """
+    try:
+        data = _get_json_force_ip(url="https://api.myip.la/en?json", timeout=timeout, version="ipv6")
+        result = {"status": True, "data": {"ip": data["ip"], "api": "myip.la"}}
+        if geo:
+            loc = data.get("location", {})
+            geo_data = {
+                "city": loc.get("city"),
+                "region": loc.get("province"),
+                "country": loc.get("country_name"),
+                "country_code": loc.get("country_code"),
+                "latitude": float(loc.get("latitude")) if loc.get("latitude") else None,
+                "longitude": float(loc.get("longitude")) if loc.get("longitude") else None,
+                "organization": None,
+                "timezone": None
+            }
+            result["data"].update(geo_data)
+        return result
+    except Exception as e:
+        return {"status": False, "error": str(e)}
+
+
+def _freeipapi_com_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 freeipapi.com.
+
+    :param geo: geolocation flag
+    :param timeout: timeout value for API
+    """
+    try:
+        data = _get_json_force_ip(url="https://free.freeipapi.com/api/json", timeout=timeout, version="ipv6")
+        result = {"status": True, "data": {"ip": data["ipAddress"], "api": "freeipapi.com"}}
+        tzs = data.get("timeZones", [])
+        if geo:
+            geo_data = {
+                "city": data.get("cityName"),
+                "region": data.get("regionName"),
+                "country": data.get("countryName"),
+                "country_code": data.get("countryCode"),
+                "latitude": data.get("latitude"),
+                "longitude": data.get("longitude"),
+                "organization": data.get("asnOrganization"),
+                "timezone": tzs[0] if len(tzs) > 0 else None
+            }
+            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,
@@ -202,6 +317,26 @@ IPV6_API_MAP = {
         "geo": True,
         "function": _my_ip_io_ipv6
     },
+    IPv6API.IFCONFIG_CO: {
+        "thread_safe": False,
+        "geo": True,
+        "function": _ifconfig_co_ipv6
+    },
+    IPv6API.REALLYFREEGEOIP_ORG: {
+        "thread_safe": False,
+        "geo": True,
+        "function": _reallyfreegeoip_org_ipv6
+    },
+    IPv6API.MYIP_LA: {
+        "thread_safe": False,
+        "geo": True,
+        "function": _myip_la_ipv6
+    },
+    IPv6API.FREEIPAPI_COM: {
+        "thread_safe": False,
+        "geo": True,
+        "function": _freeipapi_com_ipv6
+    }
 }
 
 

{ipspot-0.5 → ipspot-0.6}/ipspot/params.py

@@ -2,7 +2,7 @@
 """ipspot params."""
 from enum import Enum
 
-IPSPOT_VERSION = "0.5"
+IPSPOT_VERSION = "0.6"
 
 IPSPOT_OVERVIEW = '''
 IPSpot is a Python library for retrieving the current system's IP address and location information.
@@ -50,6 +50,10 @@ class IPv6API(Enum):
     TNEDI_ME = "tnedi.me"
     IPLEAK_NET = "ipleak.net"
     MY_IP_IO = "my-ip.io"
+    IFCONFIG_CO = "ifconfig.co"
+    REALLYFREEGEOIP_ORG = "reallyfreegeoip.org"
+    MYIP_LA = "myip.la"
+    FREEIPAPI_COM = "freeipapi.com"
 
 
 PARAMETERS_NAME_MAP = {

ipspot-0.6/ipspot/utils.py

@@ -0,0 +1,132 @@
+# -*- coding: utf-8 -*-
+"""ipspot utils."""
+import time
+import ipaddress
+import socket
+import requests
+from requests.adapters import HTTPAdapter
+from typing import Callable, Dict
+from typing import Union, Tuple, Any, List
+from .params import REQUEST_HEADERS
+
+
+class ForceIPHTTPAdapter(HTTPAdapter):
+    """A custom HTTPAdapter that enforces IPv4 or IPv6 DNS resolution for HTTP(S) requests."""
+
+    def __init__(self, version: str = "ipv4", *args: list, **kwargs: dict) -> None:
+        """
+        Initialize the adapter with the desired IP version.
+
+        :param version: 'ipv4' or 'ipv6' to select address family
+        :param args: additional list arguments for the HTTPAdapter
+        :param kwargs: additional keyword arguments for the HTTPAdapter
+        """
+        self.version = version.lower()
+        if self.version not in ("ipv4", "ipv6"):
+            raise ValueError("version must be either 'ipv4' or 'ipv6'")
+        super().__init__(*args, **kwargs)
+
+    def send(self, *args: list, **kwargs: dict) -> Any:
+        """
+        Override send method to apply the monkey patch only during the request.
+
+        :param args: additional list arguments for the send method
+        :param kwargs: additional keyword arguments for the send method
+        """
+        family = socket.AF_INET if self.version == "ipv4" else socket.AF_INET6
+        original_getaddrinfo = socket.getaddrinfo
+
+        def filtered_getaddrinfo(*gargs: list, **gkwargs: dict) -> List[Tuple]:
+            """
+            Filter getaddrinfo.
+
+            :param gargs: additional list arguments for the original_getaddrinfo function
+            :param gkwargs: additional keyword arguments for the original_getaddrinfo function
+            """
+            results = original_getaddrinfo(*gargs, **gkwargs)
+            return [res for res in results if res[0] == family]
+
+        socket.getaddrinfo = filtered_getaddrinfo
+        try:
+            response = super().send(*args, **kwargs)
+        finally:
+            socket.getaddrinfo = original_getaddrinfo
+        return response
+
+
+def _get_json_force_ip(url: str, timeout: Union[float, Tuple[float, float]],
+                       version: str = "ipv4") -> dict:
+    """
+    Send GET request with forced IPv4/IPv6 using ForceIPHTTPAdapter that returns JSON response.
+
+    :param url: API url
+    :param timeout: timeout value for API
+    :param version: 'ipv4' or 'ipv6' to select address family
+    """
+    with requests.Session() as session:
+        session.mount("http://", ForceIPHTTPAdapter(version=version))
+        session.mount("https://", ForceIPHTTPAdapter(version=version))
+        response = session.get(url, headers=REQUEST_HEADERS, timeout=timeout)
+        response.raise_for_status()
+        return response.json()
+
+
+def _attempt_with_retries(
+        func: Callable,
+        max_retries: int,
+        retry_delay: float, **kwargs: dict) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:
+    """
+    Attempt a function call with retries and delay.
+
+    :param func: function to execute
+    :param max_retries: number of retries
+    :param retry_delay: delay between retries (in seconds)
+    :param kwargs: keyword arguments to pass to the function
+    """
+    max_retries = max(0, max_retries)
+    result = {"status": False, "error": ""}
+    for attempt in range(max_retries + 1):
+        result = func(**kwargs)
+        if result["status"]:
+            break
+        time.sleep(retry_delay)
+    return result
+
+
+def is_loopback(ip: str) -> bool:
+    """
+    Check if the given input IP is a loopback address.
+
+    :param ip: input IP
+    """
+    try:
+        ip_object = ipaddress.ip_address(ip)
+        return ip_object.is_loopback
+    except Exception:
+        return False
+
+
+def _filter_parameter(parameter: Any) -> Any:
+    """
+    Filter input parameter.
+
+    :param parameter: input parameter
+    """
+    if parameter is None:
+        return "N/A"
+    if isinstance(parameter, str) and len(parameter.strip()) == 0:
+        return "N/A"
+    return parameter
+
+
+def _get_json_standard(url: str, timeout: Union[float, Tuple[float, float]]) -> dict:
+    """
+    Send standard GET request that returns JSON response.
+
+    :param url: API url
+    :param timeout: timeout value for API
+    """
+    with requests.Session() as session:
+        response = session.get(url, headers=REQUEST_HEADERS, timeout=timeout)
+        response.raise_for_status()
+        return response.json()

{ipspot-0.5 → ipspot-0.6}/ipspot.egg-info/PKG-INFO

@@ -1,15 +1,15 @@
 Metadata-Version: 2.4
 Name: ipspot
-Version: 0.5
+Version: 0.6
 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.5
+Download-URL: https://github.com/openscilab/ipspot/tarball/v0.6
 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 :: 3 - Alpha
+Classifier: Development Status :: 4 - Beta
 Classifier: Natural Language :: English
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
@@ -52,6 +52,7 @@ Dynamic: summary
 <img src="https://github.com/openscilab/ipspot/raw/main/otherfiles/logo.png" width="350">
 <h1>IPSpot: A Python Tool to Fetch the System's IP Address</h1>
 <br/>
+<a href="https://codecov.io/gh/openscilab/ipspot"><img src="https://codecov.io/gh/openscilab/ipspot/graph/badge.svg?token=XCFKASULS8"></a>
 <a href="https://badge.fury.io/py/ipspot"><img src="https://badge.fury.io/py/ipspot.svg" alt="PyPI version"></a>
 <a href="https://www.python.org/"><img src="https://img.shields.io/badge/built%20with-Python3-green.svg" alt="built with Python3"></a>
 <a href="https://github.com/openscilab/ipspot"><img alt="GitHub repo size" src="https://img.shields.io/github/repo-size/openscilab/ipspot"></a>
@@ -102,13 +103,13 @@ Dynamic: summary
 ## Installation		
 
 ### Source Code
-- Download [Version 0.5](https://github.com/openscilab/ipspot/archive/v0.5.zip) or [Latest Source](https://github.com/openscilab/ipspot/archive/dev.zip)
+- Download [Version 0.6](https://github.com/openscilab/ipspot/archive/v0.6.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.5`						
+- `pip install ipspot==0.6`						
 
 
 ## Usage
@@ -164,7 +165,7 @@ Dynamic: summary
 ```console
 > ipspot --version
 
-0.5
+0.6
 ```
 
 #### Info
@@ -179,11 +180,11 @@ Dynamic: summary
 |___||_|    |____/ | .__/  \___/  \__|
                    |_|
 
-__     __     ___      ____
-\ \   / / _  / _ \    | ___|
- \ \ / / (_)| | | |   |___ \
-  \ V /   _ | |_| | _  ___) |
-   \_/   (_) \___/ (_)|____/
+__     __     ___       __
+\ \   / / _  / _ \     / /_
+ \ \ / / (_)| | | |   | '_ \
+  \ V /   _ | |_| | _ | (_) |
+   \_/   (_) \___/ (_) \___/
 
 
 
@@ -207,16 +208,31 @@ Private IP:
 
 Public IP and Location Info:
 
-  API: ip-api.com
-  City: Southampton
-  Country: United Kingdom
-  Country Code: GB
-  IP: xx.xx.xx.xx
-  Latitude: 50.9097
-  Longitude: -1.4043
-  Organization: N/A
-  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
 ```
 
 #### IPv4 API
@@ -264,7 +280,7 @@ Public IP and Location Info:
 
 #### IPv6 API
 
-ℹ️ `ipv6-api` valid choices: [`auto-safe`, `auto`, `ip.sb`, `ident.me`, `tnedi.me`, `ipleak.net`, `my-ip.io`]
+ℹ️ `ipv6-api` valid choices: [`auto-safe`, `auto`, `ip.sb`, `ident.me`, `tnedi.me`, `ipleak.net`, `my-ip.io`, `ifconfig.co`, `reallyfreegeoip.org`, `myip.la`, `freeipapi.com`]
 
 ℹ️ The default value: `auto-safe`
 
@@ -360,6 +376,20 @@ 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.6] - 2025-11-18
+### Added
+- `ForceIPHTTPAdapter` class
+- `_get_json_force_ip` function
+- Support [ifconfig.co](https://ifconfig.co/json) IPv6 API
+- Support [reallyfreegeoip.org](https://reallyfreegeoip.org/json/) IPv6 API
+- Support [myip.la](https://api.myip.la/en?json) IPv6 API
+- Support [freeipapi.com](https://freeipapi.com/api/json) IPv6 API
+### Changed
+- [freeipapi.com](https://freeipapi.com/api/json) IPv4 API bug fixed
+- `README.md` updated
+### Removed
+- `IPv4HTTPAdapter` class
+- `_get_json_ipv4_forced` function
 ## [0.5] - 2025-10-17
 ### Added
 - `setup-warp` action
@@ -438,7 +468,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.5...dev
+[Unreleased]: https://github.com/openscilab/ipspot/compare/v0.6...dev
+[0.6]: https://github.com/openscilab/ipspot/compare/v0.5...v0.6
 [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

{ipspot-0.5 → ipspot-0.6}/setup.py

@@ -32,7 +32,7 @@ def read_description() -> str:
 setup(
     name='ipspot',
     packages=['ipspot'],
-    version='0.5',
+    version='0.6',
     description='IPSpot: A Python Tool to Fetch the System\'s IP Address',
     long_description=read_description(),
     long_description_content_type='text/markdown',
@@ -40,7 +40,7 @@ setup(
     author='IPSpot Development Team',
     author_email='ipspot@openscilab.com',
     url='https://github.com/openscilab/ipspot',
-    download_url='https://github.com/openscilab/ipspot/tarball/v0.5',
+    download_url='https://github.com/openscilab/ipspot/tarball/v0.6',
     keywords="ip ipv4 geo geolocation network location ipspot cli",
     project_urls={
         'Source': 'https://github.com/openscilab/ipspot'
@@ -48,7 +48,7 @@ setup(
     install_requires=get_requires(),
     python_requires='>=3.7',
     classifiers=[
-        'Development Status :: 3 - Alpha',
+        'Development Status :: 4 - Beta',
         'Natural Language :: English',
         'License :: OSI Approved :: MIT License',
         'Operating System :: OS Independent',

{ipspot-0.5 → ipspot-0.6}/tests/test_ipv4_api.py

@@ -123,7 +123,7 @@ def test_public_ipv4_tnedi_me_success():
     assert result["data"]["api"] == "tnedi.me"
 
 
-def test_public_ipv4__reallyfreegeoip_org_success():
+def test_public_ipv4_reallyfreegeoip_org_success():
     result = get_public_ipv4(api=IPv4API.REALLYFREEGEOIP_ORG, geo=True, timeout=40, max_retries=4, retry_delay=90)
     assert result["status"]
     assert is_ipv4(result["data"]["ip"])

{ipspot-0.5 → ipspot-0.6}/tests/test_ipv6_api.py

@@ -44,6 +44,38 @@ def test_public_ipv6_my_ip_io_success():
     assert result["data"]["api"] == "my-ip.io"
 
 
+def test_public_ipv6_ifconfig_co_success():
+    result = get_public_ipv6(api=IPv6API.IFCONFIG_CO, geo=True, timeout=40, max_retries=4, retry_delay=90)
+    assert result["status"]
+    assert is_ipv6(result["data"]["ip"])
+    assert set(result["data"].keys()) == DATA_ITEMS
+    assert result["data"]["api"] == "ifconfig.co"
+
+
+def test_public_ipv6_reallyfreegeoip_org_success():
+    result = get_public_ipv6(api=IPv6API.REALLYFREEGEOIP_ORG, geo=True, timeout=40, max_retries=4, retry_delay=90)
+    assert result["status"]
+    assert is_ipv6(result["data"]["ip"])
+    assert set(result["data"].keys()) == DATA_ITEMS
+    assert result["data"]["api"] == "reallyfreegeoip.org"
+
+
+def test_public_ipv6_myip_la_success():
+    result = get_public_ipv6(api=IPv6API.MYIP_LA, geo=True, timeout=40, max_retries=4, retry_delay=90)
+    assert result["status"]
+    assert is_ipv6(result["data"]["ip"])
+    assert set(result["data"].keys()) == DATA_ITEMS
+    assert result["data"]["api"] == "myip.la"
+
+
+def test_public_freeipapi_com_success():
+    result = get_public_ipv6(api=IPv6API.FREEIPAPI_COM, geo=True, timeout=40, max_retries=4, retry_delay=90)
+    assert result["status"]
+    assert is_ipv6(result["data"]["ip"])
+    assert set(result["data"].keys()) == DATA_ITEMS
+    assert result["data"]["api"] == "freeipapi.com"
+
+
 def test_public_ipv6_auto_success():
     result = get_public_ipv6(api=IPv6API.AUTO, geo=True, timeout=40, max_retries=4, retry_delay=90)
     assert result["status"]

ipspot-0.5/ipspot/utils.py

@@ -1,69 +0,0 @@
-# -*- coding: utf-8 -*-
-"""ipspot utils."""
-import time
-import ipaddress
-import requests
-from typing import Callable, Dict
-from typing import Union, Tuple, Any
-from .params import REQUEST_HEADERS
-
-
-def _attempt_with_retries(
-        func: Callable,
-        max_retries: int,
-        retry_delay: float, **kwargs: dict) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:
-    """
-    Attempt a function call with retries and delay.
-
-    :param func: function to execute
-    :param max_retries: number of retries
-    :param retry_delay: delay between retries (in seconds)
-    :param kwargs: keyword arguments to pass to the function
-    """
-    max_retries = max(0, max_retries)
-    result = {"status": False, "error": ""}
-    for attempt in range(max_retries + 1):
-        result = func(**kwargs)
-        if result["status"]:
-            break
-        time.sleep(retry_delay)
-    return result
-
-
-def is_loopback(ip: str) -> bool:
-    """
-    Check if the given input IP is a loopback address.
-
-    :param ip: input IP
-    """
-    try:
-        ip_object = ipaddress.ip_address(ip)
-        return ip_object.is_loopback
-    except Exception:
-        return False
-
-
-def _filter_parameter(parameter: Any) -> Any:
-    """
-    Filter input parameter.
-
-    :param parameter: input parameter
-    """
-    if parameter is None:
-        return "N/A"
-    if isinstance(parameter, str) and len(parameter.strip()) == 0:
-        return "N/A"
-    return parameter
-
-
-def _get_json_standard(url: str, timeout: Union[float, Tuple[float, float]]) -> dict:
-    """
-    Send standard GET request that returns JSON response.
-
-    :param url: API url
-    :param timeout: timeout value for API
-    """
-    with requests.Session() as session:
-        response = session.get(url, headers=REQUEST_HEADERS, timeout=timeout)
-        response.raise_for_status()
-        return response.json()