PyPI - ipspot - Versions diffs - 0.7__tar.gz → 0.8__tar.gz - Mend

ipspot 0.7tar.gz → 0.8tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (29) hide show

{ipspot-0.7 → ipspot-0.8}/CHANGELOG.md +10 -1
{ipspot-0.7 → ipspot-0.8}/PKG-INFO +29 -20
{ipspot-0.7 → ipspot-0.8}/README.md +15 -15
{ipspot-0.7 → ipspot-0.8}/SECURITY.md +2 -2
{ipspot-0.7 → ipspot-0.8}/ipspot/ipv4.py +68 -2
{ipspot-0.7 → ipspot-0.8}/ipspot/ipv6.py +69 -3
{ipspot-0.7 → ipspot-0.8}/ipspot/params.py +8 -4
{ipspot-0.7 → ipspot-0.8}/ipspot.egg-info/PKG-INFO +29 -20
{ipspot-0.7 → ipspot-0.8}/setup.py +7 -7
{ipspot-0.7 → ipspot-0.8}/tests/test_ipv4_api.py +16 -0
{ipspot-0.7 → ipspot-0.8}/tests/test_ipv4_functions.py +12 -51
{ipspot-0.7 → ipspot-0.8}/tests/test_ipv6_api.py +17 -1
{ipspot-0.7 → ipspot-0.8}/AUTHORS.md +0 -0
{ipspot-0.7 → ipspot-0.8}/LICENSE +0 -0
{ipspot-0.7 → ipspot-0.8}/MANIFEST.in +0 -0
{ipspot-0.7 → ipspot-0.8}/dev-requirements.txt +0 -0
{ipspot-0.7 → ipspot-0.8}/ipspot/__init__.py +0 -0
{ipspot-0.7 → ipspot-0.8}/ipspot/__main__.py +0 -0
{ipspot-0.7 → ipspot-0.8}/ipspot/cli.py +0 -0
{ipspot-0.7 → ipspot-0.8}/ipspot/utils.py +0 -0
{ipspot-0.7 → ipspot-0.8}/ipspot.egg-info/SOURCES.txt +0 -0
{ipspot-0.7 → ipspot-0.8}/ipspot.egg-info/dependency_links.txt +0 -0
{ipspot-0.7 → ipspot-0.8}/ipspot.egg-info/entry_points.txt +0 -0
{ipspot-0.7 → ipspot-0.8}/ipspot.egg-info/requires.txt +0 -0
{ipspot-0.7 → ipspot-0.8}/ipspot.egg-info/top_level.txt +0 -0
{ipspot-0.7 → ipspot-0.8}/requirements.txt +0 -0
{ipspot-0.7 → ipspot-0.8}/setup.cfg +0 -0
{ipspot-0.7 → ipspot-0.8}/tests/test_ipv6_functions.py +0 -0
{ipspot-0.7 → ipspot-0.8}/tests/test_utils.py +0 -0

{ipspot-0.7 → ipspot-0.8}/CHANGELOG.md RENAMED Viewed

@@ -5,6 +5,14 @@ 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.8] - 2026-02-05
+### Added
+- Support [wtfismyip.com](https://wtfismyip.com/json) IPv6 API
+- Support [myip.wtf](https://myip.wtf/) IPv6 API
+- Support [myip.wtf](https://myip.wtf/) IPv4 API
+- Support [db-ip.com](https://api.db-ip.com/v2/free/self) IPv4 API
+### Changed
+- `README.md` updated
 ## [0.7] - 2025-12-09
 ### Added
 - `--backoff-factor` argument
@@ -108,7 +116,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.7...dev
+[Unreleased]: https://github.com/openscilab/ipspot/compare/v0.8...dev
+[0.8]: https://github.com/openscilab/ipspot/compare/v0.7...v0.8
 [0.7]: https://github.com/openscilab/ipspot/compare/v0.6...v0.7
 [0.6]: https://github.com/openscilab/ipspot/compare/v0.5...v0.6
 [0.5]: https://github.com/openscilab/ipspot/compare/v0.4...v0.5

{ipspot-0.7 → ipspot-0.8}/PKG-INFO RENAMED Viewed

@@ -1,14 +1,14 @@
 Metadata-Version: 2.4
 Name: ipspot
-Version: 0.7
-Summary: IPSpot: A Python Tool to Fetch the System's IP Address
+Version: 0.8
+Summary: IPSpot: Retrieve IPv4/IPv6 Addresses with Geolocation Data
 Home-page: https://github.com/openscilab/ipspot
-Download-URL: https://github.com/openscilab/ipspot/tarball/v0.7
+Download-URL: https://github.com/openscilab/ipspot/tarball/v0.8
 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
+Keywords: ip ipv4 ipv6 geo geolocation network location ipspot cli
 Classifier: Development Status :: 4 - Beta
 Classifier: Natural Language :: English
 Classifier: License :: OSI Approved :: MIT License
@@ -51,7 +51,7 @@ Dynamic: summary
 <div align="center">
 <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>
+<h1>IPSpot: Retrieve IPv4/IPv6 Addresses with Geolocation Data</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>
@@ -63,7 +63,7 @@ Dynamic: summary
 ## Overview
 <p align="justify">
-<b>IPSpot</b> is a Python library for retrieving the current system's IP address and location information. It currently supports public and private <b>IPv4</b> detection using multiple API providers with a fallback mechanism for reliability. Designed with simplicity and modularity in mind, <b>IPSpot</b> offers quick IP and geolocation lookups directly from your machine.
+<b>IPSpot</b> is a Python library for retrieving the current system's IP data and detailed location information such as region, longitude, and latitude. It supports both public and private <b>IPv4</b> and <b>IPv6</b> detection through multiple API providers, using a fallback mechanism for improved reliability. It has a simple and modular design, making it easy to perform fast IP, geolocation, provider, and regional lookups directly from your machine.
 </p>
 <table>
@@ -104,13 +104,13 @@ Dynamic: summary
 ## Installation
 ### Source Code
-- Download [Version 0.7](https://github.com/openscilab/ipspot/archive/v0.7.zip) or [Latest Source](https://github.com/openscilab/ipspot/archive/dev.zip)
+- Download [Version 0.8](https://github.com/openscilab/ipspot/archive/v0.8.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.7`
+- `pip install ipspot==0.8`
 ## Usage
@@ -166,7 +166,7 @@ Dynamic: summary
 ```console
 > ipspot --version
-0.7
+0.8
 ```
 #### Info
@@ -181,17 +181,17 @@ Dynamic: summary
 |___||_|    |____/ | .__/  \___/  \__|
                    |_|
-__     __     ___      _____
-\ \   / / _  / _ \    |___  |
- \ \ / / (_)| | | |      / /
-  \ V /   _ | |_| | _   / /
-   \_/   (_) \___/ (_) /_/
+__     __     ___       ___
+\ \   / / _  / _ \     ( _ )
+ \ \ / / (_)| | | |    / _ \
+  \ V /   _ | |_| | _ | (_) |
+   \_/   (_) \___/ (_) \___/
-IPSpot is a Python library for retrieving the current system's IP address and location information.
-It currently supports public and private IPv4 detection using multiple API providers with a fallback mechanism for reliability.
-Designed with simplicity and modularity in mind, IPSpot offers quick IP and geolocation lookups directly from your machine.
+IPSpot is a Python library for retrieving the current system's IP data and detailed location information such as region, longitude, and latitude.
+It supports both public and private IPv4 and IPv6 detection through multiple API providers, using a fallback mechanism for improved reliability.
+It has a simple and modular design, making it easy to perform fast IP, geolocation, provider, and regional lookups directly from your machine.
 Repo : https://github.com/openscilab/ipspot
@@ -238,7 +238,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`, `ipquery.io`, `ipwho.is`, `wtfismyip.com`]
+ℹ️ `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`, `myip.wtf`, `db-ip.com`]
 ℹ️ The default value: `auto-safe`
@@ -281,7 +281,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`, `ifconfig.co`, `reallyfreegeoip.org`, `myip.la`, `freeipapi.com`]
+ℹ️ `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`, `wtfismyip.com`, `myip.wtf`]
 ℹ️ The default value: `auto-safe`
@@ -377,6 +377,14 @@ 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.8] - 2026-02-05
+### Added
+- Support [wtfismyip.com](https://wtfismyip.com/json) IPv6 API
+- Support [myip.wtf](https://myip.wtf/) IPv6 API
+- Support [myip.wtf](https://myip.wtf/) IPv4 API
+- Support [db-ip.com](https://api.db-ip.com/v2/free/self) IPv4 API
+### Changed
+- `README.md` updated
 ## [0.7] - 2025-12-09
 ### Added
 - `--backoff-factor` argument
@@ -480,7 +488,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.7...dev
+[Unreleased]: https://github.com/openscilab/ipspot/compare/v0.8...dev
+[0.8]: https://github.com/openscilab/ipspot/compare/v0.7...v0.8
 [0.7]: https://github.com/openscilab/ipspot/compare/v0.6...v0.7
 [0.6]: https://github.com/openscilab/ipspot/compare/v0.5...v0.6
 [0.5]: https://github.com/openscilab/ipspot/compare/v0.4...v0.5

{ipspot-0.7 → ipspot-0.8}/README.md RENAMED Viewed

@@ -1,6 +1,6 @@
 <div align="center">
 <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>
+<h1>IPSpot: Retrieve IPv4/IPv6 Addresses with Geolocation Data</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>
@@ -12,7 +12,7 @@
 ## Overview
 <p align="justify">
-<b>IPSpot</b> is a Python library for retrieving the current system's IP address and location information. It currently supports public and private <b>IPv4</b> detection using multiple API providers with a fallback mechanism for reliability. Designed with simplicity and modularity in mind, <b>IPSpot</b> offers quick IP and geolocation lookups directly from your machine.
+<b>IPSpot</b> is a Python library for retrieving the current system's IP data and detailed location information such as region, longitude, and latitude. It supports both public and private <b>IPv4</b> and <b>IPv6</b> detection through multiple API providers, using a fallback mechanism for improved reliability. It has a simple and modular design, making it easy to perform fast IP, geolocation, provider, and regional lookups directly from your machine.
 </p>
 <table>
@@ -53,13 +53,13 @@
 ## Installation
 ### Source Code
-- Download [Version 0.7](https://github.com/openscilab/ipspot/archive/v0.7.zip) or [Latest Source](https://github.com/openscilab/ipspot/archive/dev.zip)
+- Download [Version 0.8](https://github.com/openscilab/ipspot/archive/v0.8.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.7`
+- `pip install ipspot==0.8`
 ## Usage
@@ -115,7 +115,7 @@
 ```console
 > ipspot --version
-0.7
+0.8
 ```
 #### Info
@@ -130,17 +130,17 @@
 |___||_|    |____/ | .__/  \___/  \__|
                    |_|
-__     __     ___      _____
-\ \   / / _  / _ \    |___  |
- \ \ / / (_)| | | |      / /
-  \ V /   _ | |_| | _   / /
-   \_/   (_) \___/ (_) /_/
+__     __     ___       ___
+\ \   / / _  / _ \     ( _ )
+ \ \ / / (_)| | | |    / _ \
+  \ V /   _ | |_| | _ | (_) |
+   \_/   (_) \___/ (_) \___/
-IPSpot is a Python library for retrieving the current system's IP address and location information.
-It currently supports public and private IPv4 detection using multiple API providers with a fallback mechanism for reliability.
-Designed with simplicity and modularity in mind, IPSpot offers quick IP and geolocation lookups directly from your machine.
+IPSpot is a Python library for retrieving the current system's IP data and detailed location information such as region, longitude, and latitude.
+It supports both public and private IPv4 and IPv6 detection through multiple API providers, using a fallback mechanism for improved reliability.
+It has a simple and modular design, making it easy to perform fast IP, geolocation, provider, and regional lookups directly from your machine.
 Repo : https://github.com/openscilab/ipspot
@@ -187,7 +187,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`, `ipquery.io`, `ipwho.is`, `wtfismyip.com`]
+ℹ️ `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`, `myip.wtf`, `db-ip.com`]
 ℹ️ The default value: `auto-safe`
@@ -230,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`, `ifconfig.co`, `reallyfreegeoip.org`, `myip.la`, `freeipapi.com`]
+ℹ️ `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`, `wtfismyip.com`, `myip.wtf`]
 ℹ️ The default value: `auto-safe`

{ipspot-0.7 → ipspot-0.8}/SECURITY.md RENAMED Viewed

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

{ipspot-0.7 → ipspot-0.8}/ipspot/ipv4.py RENAMED Viewed

@@ -466,6 +466,62 @@ def _wtfismyip_com_ipv4(geo: bool, timeout: Union[float, Tuple[float, float]]
         return {"status": False, "error": str(e)}
+def _myip_wtf_ipv4(geo: bool, timeout: Union[float, Tuple[float, float]]
+                   ) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:
+    """
+    Get public IP and geolocation using myip.wtf.
+    :param geo: geolocation flag
+    :param timeout: timeout value for API
+    """
+    try:
+        data = _get_json_standard(url="https://json.ipv4.myip.wtf", timeout=timeout)
+        result = {"status": True, "data": {"ip": data["YourFuckingIPAddress"], "api": "myip.wtf"}}
+        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)}
+def _db_ip_com_ipv4(geo: bool, timeout: Union[float, Tuple[float, float]]
+                    ) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:
+    """
+    Get public IP and geolocation using db-ip.com.
+    :param geo: geolocation flag
+    :param timeout: timeout value for API
+    """
+    try:
+        data = _get_json_force_ip(url="https://api.db-ip.com/v2/free/self", timeout=timeout, version="ipv4")
+        result = {"status": True, "data": {"ip": data["ipAddress"], "api": "db-ip.com"}}
+        if geo:
+            geo_data = {
+                "city": data.get("city"),
+                "region": data.get("stateProv"),
+                "country": data.get("countryName"),
+                "country_code": data.get("countryCode"),
+                "latitude": None,  # not provided by free API
+                "longitude": None,  # not provided by free API
+                "organization": None,  # not provided by free API
+                "timezone": None  # not provided by free API
+            }
+            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,
@@ -542,11 +598,21 @@ IPV4_API_MAP = {
         "geo": True,
         "function": _wtfismyip_com_ipv4
     },
+    IPv4API.MYIP_WTF: {
+        "thread_safe": True,
+        "geo": True,
+        "function": _myip_wtf_ipv4
+    },
+    IPv4API.DB_IP_COM: {
+        "thread_safe": False,
+        "geo": True,
+        "function": _db_ip_com_ipv4
+    },
 }
-def get_public_ipv4(api: IPv4API=IPv4API.AUTO_SAFE, geo: bool=False,
-                    timeout: Union[float, Tuple[float, float]]=5,
+def get_public_ipv4(api: IPv4API = IPv4API.AUTO_SAFE, geo: bool = False,
+                    timeout: Union[float, Tuple[float, float]] = 5,
                     max_retries: int = 0,
                     retry_delay: float = 1.0,
                     backoff_factor: float = 1.0) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:

{ipspot-0.7 → ipspot-0.8}/ipspot/ipv6.py RENAMED Viewed

@@ -292,6 +292,62 @@ def _freeipapi_com_ipv6(geo: bool, timeout: Union[float, Tuple[float, float]]
         return {"status": False, "error": str(e)}
+def _wtfismyip_com_ipv6(geo: bool, timeout: Union[float, Tuple[float, float]]
+                        ) -> 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.ipv6.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)}
+def _myip_wtf_ipv6(geo: bool, timeout: Union[float, Tuple[float, float]]
+                   ) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:
+    """
+    Get public IP and geolocation using myip.wtf.
+    :param geo: geolocation flag
+    :param timeout: timeout value for API
+    """
+    try:
+        data = _get_json_standard(url="https://json.ipv6.myip.wtf", timeout=timeout)
+        result = {"status": True, "data": {"ip": data["YourFuckingIPAddress"], "api": "myip.wtf"}}
+        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)}
 IPV6_API_MAP = {
     IPv6API.IP_SB: {
         "thread_safe": True,
@@ -337,12 +393,22 @@ IPV6_API_MAP = {
         "thread_safe": False,
         "geo": True,
         "function": _freeipapi_com_ipv6
-    }
+    },
+    IPv6API.WTFISMYIP_COM: {
+        "thread_safe": True,
+        "geo": True,
+        "function": _wtfismyip_com_ipv6
+    },
+    IPv6API.MYIP_WTF: {
+        "thread_safe": True,
+        "geo": True,
+        "function": _myip_wtf_ipv6
+    },
 }
-def get_public_ipv6(api: IPv6API=IPv6API.AUTO_SAFE, geo: bool=False,
-                    timeout: Union[float, Tuple[float, float]]=5,
+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,
                     backoff_factor: float = 1.0) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:

{ipspot-0.7 → ipspot-0.8}/ipspot/params.py RENAMED Viewed

@@ -2,12 +2,12 @@
 """ipspot params."""
 from enum import Enum
-IPSPOT_VERSION = "0.7"
+IPSPOT_VERSION = "0.8"
 IPSPOT_OVERVIEW = '''
-IPSpot is a Python library for retrieving the current system's IP address and location information.
-It currently supports public and private IPv4 detection using multiple API providers with a fallback mechanism for reliability.
-Designed with simplicity and modularity in mind, IPSpot offers quick IP and geolocation lookups directly from your machine.
+IPSpot is a Python library for retrieving the current system's IP data and detailed location information such as region, longitude, and latitude.
+It supports both public and private IPv4 and IPv6 detection through multiple API providers, using a fallback mechanism for improved reliability.
+It has a simple and modular design, making it easy to perform fast IP, geolocation, provider, and regional lookups directly from your machine.
 '''
 IPSPOT_REPO = "https://github.com/openscilab/ipspot"
@@ -38,6 +38,8 @@ class IPv4API(Enum):
     IPQUERY_IO = "ipquery.io"
     IPWHO_IS = "ipwho.is"
     WTFISMYIP_COM = "wtfismyip.com"
+    MYIP_WTF = "myip.wtf"
+    DB_IP_COM = "db-ip.com"
 class IPv6API(Enum):
@@ -54,6 +56,8 @@ class IPv6API(Enum):
     REALLYFREEGEOIP_ORG = "reallyfreegeoip.org"
     MYIP_LA = "myip.la"
     FREEIPAPI_COM = "freeipapi.com"
+    WTFISMYIP_COM = "wtfismyip.com"
+    MYIP_WTF = "myip.wtf"
 PARAMETERS_NAME_MAP = {

{ipspot-0.7 → ipspot-0.8}/ipspot.egg-info/PKG-INFO RENAMED Viewed

@@ -1,14 +1,14 @@
 Metadata-Version: 2.4
 Name: ipspot
-Version: 0.7
-Summary: IPSpot: A Python Tool to Fetch the System's IP Address
+Version: 0.8
+Summary: IPSpot: Retrieve IPv4/IPv6 Addresses with Geolocation Data
 Home-page: https://github.com/openscilab/ipspot
-Download-URL: https://github.com/openscilab/ipspot/tarball/v0.7
+Download-URL: https://github.com/openscilab/ipspot/tarball/v0.8
 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
+Keywords: ip ipv4 ipv6 geo geolocation network location ipspot cli
 Classifier: Development Status :: 4 - Beta
 Classifier: Natural Language :: English
 Classifier: License :: OSI Approved :: MIT License
@@ -51,7 +51,7 @@ Dynamic: summary
 <div align="center">
 <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>
+<h1>IPSpot: Retrieve IPv4/IPv6 Addresses with Geolocation Data</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>
@@ -63,7 +63,7 @@ Dynamic: summary
 ## Overview
 <p align="justify">
-<b>IPSpot</b> is a Python library for retrieving the current system's IP address and location information. It currently supports public and private <b>IPv4</b> detection using multiple API providers with a fallback mechanism for reliability. Designed with simplicity and modularity in mind, <b>IPSpot</b> offers quick IP and geolocation lookups directly from your machine.
+<b>IPSpot</b> is a Python library for retrieving the current system's IP data and detailed location information such as region, longitude, and latitude. It supports both public and private <b>IPv4</b> and <b>IPv6</b> detection through multiple API providers, using a fallback mechanism for improved reliability. It has a simple and modular design, making it easy to perform fast IP, geolocation, provider, and regional lookups directly from your machine.
 </p>
 <table>
@@ -104,13 +104,13 @@ Dynamic: summary
 ## Installation
 ### Source Code
-- Download [Version 0.7](https://github.com/openscilab/ipspot/archive/v0.7.zip) or [Latest Source](https://github.com/openscilab/ipspot/archive/dev.zip)
+- Download [Version 0.8](https://github.com/openscilab/ipspot/archive/v0.8.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.7`
+- `pip install ipspot==0.8`
 ## Usage
@@ -166,7 +166,7 @@ Dynamic: summary
 ```console
 > ipspot --version
-0.7
+0.8
 ```
 #### Info
@@ -181,17 +181,17 @@ Dynamic: summary
 |___||_|    |____/ | .__/  \___/  \__|
                    |_|
-__     __     ___      _____
-\ \   / / _  / _ \    |___  |
- \ \ / / (_)| | | |      / /
-  \ V /   _ | |_| | _   / /
-   \_/   (_) \___/ (_) /_/
+__     __     ___       ___
+\ \   / / _  / _ \     ( _ )
+ \ \ / / (_)| | | |    / _ \
+  \ V /   _ | |_| | _ | (_) |
+   \_/   (_) \___/ (_) \___/
-IPSpot is a Python library for retrieving the current system's IP address and location information.
-It currently supports public and private IPv4 detection using multiple API providers with a fallback mechanism for reliability.
-Designed with simplicity and modularity in mind, IPSpot offers quick IP and geolocation lookups directly from your machine.
+IPSpot is a Python library for retrieving the current system's IP data and detailed location information such as region, longitude, and latitude.
+It supports both public and private IPv4 and IPv6 detection through multiple API providers, using a fallback mechanism for improved reliability.
+It has a simple and modular design, making it easy to perform fast IP, geolocation, provider, and regional lookups directly from your machine.
 Repo : https://github.com/openscilab/ipspot
@@ -238,7 +238,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`, `ipquery.io`, `ipwho.is`, `wtfismyip.com`]
+ℹ️ `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`, `myip.wtf`, `db-ip.com`]
 ℹ️ The default value: `auto-safe`
@@ -281,7 +281,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`, `ifconfig.co`, `reallyfreegeoip.org`, `myip.la`, `freeipapi.com`]
+ℹ️ `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`, `wtfismyip.com`, `myip.wtf`]
 ℹ️ The default value: `auto-safe`
@@ -377,6 +377,14 @@ 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.8] - 2026-02-05
+### Added
+- Support [wtfismyip.com](https://wtfismyip.com/json) IPv6 API
+- Support [myip.wtf](https://myip.wtf/) IPv6 API
+- Support [myip.wtf](https://myip.wtf/) IPv4 API
+- Support [db-ip.com](https://api.db-ip.com/v2/free/self) IPv4 API
+### Changed
+- `README.md` updated
 ## [0.7] - 2025-12-09
 ### Added
 - `--backoff-factor` argument
@@ -480,7 +488,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.7...dev
+[Unreleased]: https://github.com/openscilab/ipspot/compare/v0.8...dev
+[0.8]: https://github.com/openscilab/ipspot/compare/v0.7...v0.8
 [0.7]: https://github.com/openscilab/ipspot/compare/v0.6...v0.7
 [0.6]: https://github.com/openscilab/ipspot/compare/v0.5...v0.6
 [0.5]: https://github.com/openscilab/ipspot/compare/v0.4...v0.5

{ipspot-0.7 → ipspot-0.8}/setup.py RENAMED Viewed

@@ -24,24 +24,24 @@ def read_description() -> str:
             description += c.read()
         return description
     except Exception:
-        return '''IPSpot is a Python library for retrieving the current system's IP address and location information.
-        It currently supports public and local IPv4 detection using multiple API providers with a fallback mechanism for reliability.
-        Designed with simplicity and modularity in mind, IPSpot offers quick IP and geolocation lookups directly from your machine.'''
+        return '''IPSpot is a Python library for retrieving the current system's IP data and detailed location information such as region, longitude, and latitude.
+        It supports both public and private IPv4 and IPv6 detection through multiple API providers, using a fallback mechanism for improved reliability.
+        It has a simple and modular design, making it easy to perform fast IP, geolocation, provider, and regional lookups directly from your machine.'''
 setup(
     name='ipspot',
     packages=['ipspot'],
-    version='0.7',
-    description='IPSpot: A Python Tool to Fetch the System\'s IP Address',
+    version='0.8',
+    description='IPSpot: Retrieve IPv4/IPv6 Addresses with Geolocation Data',
     long_description=read_description(),
     long_description_content_type='text/markdown',
     include_package_data=True,
     author='IPSpot Development Team',
     author_email='ipspot@openscilab.com',
     url='https://github.com/openscilab/ipspot',
-    download_url='https://github.com/openscilab/ipspot/tarball/v0.7',
-    keywords="ip ipv4 geo geolocation network location ipspot cli",
+    download_url='https://github.com/openscilab/ipspot/tarball/v0.8',
+    keywords="ip ipv4 ipv6 geo geolocation network location ipspot cli",
     project_urls={
         'Source': 'https://github.com/openscilab/ipspot'
     },

{ipspot-0.7 → ipspot-0.8}/tests/test_ipv4_api.py RENAMED Viewed

@@ -137,3 +137,19 @@ def test_public_ipv4_wtfismyip_com_success():
     assert is_ipv4(result["data"]["ip"])
     assert set(result["data"].keys()) == DATA_ITEMS
     assert result["data"]["api"] == "wtfismyip.com"
+def test_public_ipv4_myip_wtf_success():
+    result = get_public_ipv4(api=IPv4API.MYIP_WTF, geo=True, timeout=40, max_retries=4, retry_delay=90, backoff_factor=1.1)
+    assert result["status"]
+    assert is_ipv4(result["data"]["ip"])
+    assert set(result["data"].keys()) == DATA_ITEMS
+    assert result["data"]["api"] == "myip.wtf"
+def test_public_ipv4_db_ip_com_success():
+    result = get_public_ipv4(api=IPv4API.DB_IP_COM, geo=True, timeout=40, max_retries=4, retry_delay=90, backoff_factor=1.1)
+    assert result["status"]
+    assert is_ipv4(result["data"]["ip"])
+    assert set(result["data"].keys()) == DATA_ITEMS
+    assert result["data"]["api"] == "db-ip.com"

{ipspot-0.7 → ipspot-0.8}/tests/test_ipv4_functions.py RENAMED Viewed

@@ -75,9 +75,6 @@ def test_get_private_ipv4_exception():
         assert result["error"] == "Test error"
 def test_public_ipv4_auto_timeout_error():
     result = get_public_ipv4(api=IPv4API.AUTO, geo=True, timeout="5")
     assert not result["status"]
@@ -90,9 +87,6 @@ def test_public_ipv4_auto_net_error():
         assert result["error"] == "All attempts failed."
 def test_public_ipv4_auto_safe_timeout_error():
     result = get_public_ipv4(api=IPv4API.AUTO_SAFE, geo=True, timeout="5")
     assert not result["status"]
@@ -105,9 +99,6 @@ def test_public_ipv4_auto_safe_net_error():
         assert result["error"] == "All attempts failed."
 def test_public_ipv4_ipapi_co_timeout_error():
     result = get_public_ipv4(api=IPv4API.IPAPI_CO, geo=True, timeout="5")
     assert not result["status"]
@@ -120,9 +111,6 @@ def test_public_ipv4_ipapi_co_net_error():
         assert result["error"] == "No Internet"
 def test_public_ipv4_ipleak_net_timeout_error():
     result = get_public_ipv4(api=IPv4API.IPLEAK_NET, geo=True, timeout="5")
     assert not result["status"]
@@ -135,9 +123,6 @@ def test_public_ipv4_ipleak_net_net_error():
         assert result["error"] == "No Internet"
 def test_public_ipv4_my_ip_io_timeout_error():
     result = get_public_ipv4(api=IPv4API.MY_IP_IO, geo=True, timeout="5")
     assert not result["status"]
@@ -150,9 +135,6 @@ def test_public_ipv4_my_ip_io_net_error():
         assert result["error"] == "No Internet"
 def test_public_ipv4_ifconfig_co_timeout_error():
     result = get_public_ipv4(api=IPv4API.IFCONFIG_CO, geo=True, timeout="5")
     assert not result["status"]
@@ -165,9 +147,6 @@ def test_public_ipv4_ifconfig_co_net_error():
         assert result["error"] == "No Internet"
 def test_public_ipv4_myip_la_timeout_error():
     result = get_public_ipv4(api=IPv4API.MYIP_LA, geo=True, timeout="5")
     assert not result["status"]
@@ -180,9 +159,6 @@ def test_public_ipv4_myip_la_net_error():
         assert result["error"] == "No Internet"
 def test_public_ipv4_ipquery_io_timeout_error():
     result = get_public_ipv4(api=IPv4API.IPQUERY_IO, geo=True, timeout="5")
     assert not result["status"]
@@ -195,9 +171,6 @@ def test_public_ipv4_ipquery_io_net_error():
         assert result["error"] == "No Internet"
 def test_public_ipv4_ipwho_is_timeout_error():
     result = get_public_ipv4(api=IPv4API.IPWHO_IS, geo=True, timeout="5")
     assert not result["status"]
@@ -210,9 +183,6 @@ def test_public_ipv4_ipwho_is_net_error():
         assert result["error"] == "No Internet"
 def test_public_ipv4_freeipapi_com_timeout_error():
     result = get_public_ipv4(api=IPv4API.FREEIPAPI_COM, geo=True, timeout="5")
     assert not result["status"]
@@ -225,9 +195,6 @@ def test_public_ipv4_freeipapi_com_net_error():
         assert result["error"] == "No Internet"
 def test_public_ipv4_ip_api_com_timeout_error():
     result = get_public_ipv4(api=IPv4API.IP_API_COM, geo=True, timeout="5")
     assert not result["status"]
@@ -240,9 +207,6 @@ def test_public_ipv4_ip_api_com_net_error():
         assert result["error"] == "No Internet"
 def test_public_ipv4_ipinfo_io_timeout_error():
     result = get_public_ipv4(api=IPv4API.IPINFO_IO, geo=True, timeout="5")
     assert not result["status"]
@@ -255,15 +219,11 @@ def test_public_ipv4_ipinfo_io_net_error():
         assert result["error"] == "No Internet"
 def test_public_ipv4_ip_sb_timeout_error():
     result = get_public_ipv4(api=IPv4API.IP_SB, geo=True, timeout="5")
     assert not result["status"]
 def test_public_ipv4_ip_sb_net_error():
     with mock.patch.object(requests.Session, "get", side_effect=Exception("No Internet")):
         result = get_public_ipv4(api=IPv4API.IP_SB)
@@ -271,9 +231,6 @@ def test_public_ipv4_ip_sb_net_error():
         assert result["error"] == "No Internet"
 def test_public_ipv4_ident_me_timeout_error():
     result = get_public_ipv4(api=IPv4API.IDENT_ME, geo=True, timeout="5")
     assert not result["status"]
@@ -286,9 +243,6 @@ def test_public_ipv4_ident_me_net_error():
         assert result["error"] == "No Internet"
 def test_public_ipv4_tnedi_me_timeout_error():
     result = get_public_ipv4(api=IPv4API.TNEDI_ME, geo=True, timeout="5")
     assert not result["status"]
@@ -307,9 +261,6 @@ def test_public_ipv4_api_error():
     assert result["error"] == "Unsupported API: api1"
 def test_public_ipv4_reallyfreegeoip_org_timeout_error():
     result = get_public_ipv4(api=IPv4API.REALLYFREEGEOIP_ORG, geo=True, timeout="5")
     assert not result["status"]
@@ -322,8 +273,6 @@ def test_public_ipv4_reallyfreegeoip_org_net_error():
         assert result["error"] == "No Internet"
 def test_public_ipv4_wtfismyip_com_timeout_error():
     result = get_public_ipv4(api=IPv4API.WTFISMYIP_COM, geo=True, timeout="5")
     assert not result["status"]
@@ -334,3 +283,15 @@ def test_public_ipv4_wtfismyip_com_net_error():
         result = get_public_ipv4(api=IPv4API.WTFISMYIP_COM)
         assert not result["status"]
         assert result["error"] == "No Internet"
+def test_public_ipv4_db_ip_com_timeout_error():
+    result = get_public_ipv4(api=IPv4API.DB_IP_COM, geo=True, timeout="5")
+    assert not result["status"]
+def test_public_ipv4_db_ip_com_net_error():
+    with mock.patch.object(requests.Session, "get", side_effect=Exception("No Internet")):
+        result = get_public_ipv4(api=IPv4API.DB_IP_COM)
+        assert not result["status"]
+        assert result["error"] == "No Internet"

{ipspot-0.7 → ipspot-0.8}/tests/test_ipv6_api.py RENAMED Viewed

@@ -76,6 +76,14 @@ def test_public_freeipapi_com_success():
     assert result["data"]["api"] == "freeipapi.com"
+def test_public_ipv6_wtfismyip_com_success():
+    result = get_public_ipv6(api=IPv6API.WTFISMYIP_COM, geo=True, timeout=40, max_retries=4, retry_delay=90, backoff_factor=1.1)
+    assert result["status"]
+    assert is_ipv6(result["data"]["ip"])
+    assert set(result["data"].keys()) == DATA_ITEMS
+    assert result["data"]["api"] == "wtfismyip.com"
 def test_public_ipv6_auto_success():
     result = get_public_ipv6(api=IPv6API.AUTO, geo=True, timeout=40, max_retries=4, retry_delay=90, backoff_factor=1.1)
     assert result["status"]
@@ -87,4 +95,12 @@ def test_public_ipv6_auto_safe_success():
     result = get_public_ipv6(api=IPv6API.AUTO_SAFE, geo=True, timeout=40, max_retries=4, retry_delay=90, backoff_factor=1.1)
     assert result["status"]
     assert is_ipv6(result["data"]["ip"])
-    assert set(result["data"].keys()) == DATA_ITEMS
+    assert set(result["data"].keys()) == DATA_ITEMS
+def test_public_ipv6_myip_wtf_success():
+    result = get_public_ipv6(api=IPv6API.MYIP_WTF, geo=True, timeout=40, max_retries=4, retry_delay=90, backoff_factor=1.1)
+    assert result["status"]
+    assert is_ipv6(result["data"]["ip"])
+    assert set(result["data"].keys()) == DATA_ITEMS
+    assert result["data"]["api"] == "myip.wtf"