ipspot 0.6__tar.gz → 0.7__tar.gz

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

@@ -5,6 +5,17 @@ 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.7] - 2025-12-09
+### Added
+- `--backoff-factor` argument
+### Changed
+- CLI messages updated
+- `Python 3.14` added to `test.yml`
+- Internal functions default values removed
+- `README.md` updated
+- Test system modified
+- `ipspot_info` function renamed to `_print_ipspot_info`
+- `display_ip_info` function renamed to `_print_report`
 ## [0.6] - 2025-11-18
 ### Added
 - `ForceIPHTTPAdapter` class
@@ -97,7 +108,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.6...dev
+[Unreleased]: https://github.com/openscilab/ipspot/compare/v0.7...dev
+[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
 [0.4]: https://github.com/openscilab/ipspot/compare/v0.3...v0.4

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

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: ipspot
-Version: 0.6
+Version: 0.7
 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.6
+Download-URL: https://github.com/openscilab/ipspot/tarball/v0.7
 Author: IPSpot Development Team
 Author-email: ipspot@openscilab.com
 License: MIT
@@ -20,6 +20,7 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Education
 Classifier: Intended Audience :: End Users/Desktop
@@ -103,13 +104,13 @@ Dynamic: summary
 ## Installation		
 
 ### Source Code
-- Download [Version 0.6](https://github.com/openscilab/ipspot/archive/v0.6.zip) or [Latest Source](https://github.com/openscilab/ipspot/archive/dev.zip)
+- Download [Version 0.7](https://github.com/openscilab/ipspot/archive/v0.7.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.6`						
+- `pip install ipspot==0.7`						
 
 
 ## Usage
@@ -124,7 +125,7 @@ Dynamic: summary
 {'status': True, 'data': {'ip': 'xx.xx.xx.xx', 'api': 'ip-api.com'}}
 >>> get_public_ipv4(api=IPv4API.IP_API_COM, geo=True, timeout=10)
 {'data': {'country_code': 'GB', 'latitude': 50.9097, 'longitude': -1.4043, 'api': 'ip-api.com', 'country': 'United Kingdom', 'timezone': 'Europe/London', 'organization': '', 'region': 'England', 'ip': 'xx.xx.xx.xx', 'city': 'Southampton'}, 'status': True}
->>> get_public_ipv4(api=IPv4API.IP_API_COM, geo=True, timeout=10, max_retries=5, retry_delay=4)
+>>> get_public_ipv4(api=IPv4API.IP_API_COM, geo=True, timeout=10, max_retries=5, retry_delay=4, backoff_factor=1.2)
 {'data': {'country_code': 'GB', 'latitude': 50.9097, 'longitude': -1.4043, 'api': 'ip-api.com', 'country': 'United Kingdom', 'timezone': 'Europe/London', 'organization': '', 'region': 'England', 'ip': 'xx.xx.xx.xx', 'city': 'Southampton'}, 'status': True}
 ```
 
@@ -144,7 +145,7 @@ Dynamic: summary
 {'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)
+>>> get_public_ipv6(api=IPv6API.IP_SB, geo=True, timeout=10, max_retries=5, retry_delay=4, backoff_factor=1.2)
 {'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}
 ```
 
@@ -165,7 +166,7 @@ Dynamic: summary
 ```console
 > ipspot --version
 
-0.6
+0.7
 ```
 
 #### Info
@@ -173,18 +174,18 @@ Dynamic: summary
 ```console
 > ipspot --info
 
- ___  ____   ____                 _
-|_ _||  _ \ / ___|  _ __    ___  | |_
+ ___  ____   ____                 _   
+|_ _||  _ \ / ___|  _ __    ___  | |_ 
  | | | |_) |\___ \ | '_ \  / _ \ | __|
- | | |  __/  ___) || |_) || (_) || |_
+ | | |  __/  ___) || |_) || (_) || |_ 
 |___||_|    |____/ | .__/  \___/  \__|
-                   |_|
+                   |_|                
 
-__     __     ___       __
-\ \   / / _  / _ \     / /_
- \ \ / / (_)| | | |   | '_ \
-  \ V /   _ | |_| | _ | (_) |
-   \_/   (_) \___/ (_) \___/
+__     __     ___      _____ 
+\ \   / / _  / _ \    |___  |
+ \ \ / / (_)| | | |      / / 
+  \ V /   _ | |_| | _   / /  
+   \_/   (_) \___/ (_) /_/ 
 
 
 
@@ -376,6 +377,17 @@ 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.7] - 2025-12-09
+### Added
+- `--backoff-factor` argument
+### Changed
+- CLI messages updated
+- `Python 3.14` added to `test.yml`
+- Internal functions default values removed
+- `README.md` updated
+- Test system modified
+- `ipspot_info` function renamed to `_print_ipspot_info`
+- `display_ip_info` function renamed to `_print_report`
 ## [0.6] - 2025-11-18
 ### Added
 - `ForceIPHTTPAdapter` class
@@ -468,7 +480,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.6...dev
+[Unreleased]: https://github.com/openscilab/ipspot/compare/v0.7...dev
+[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
 [0.4]: https://github.com/openscilab/ipspot/compare/v0.3...v0.4

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

@@ -53,13 +53,13 @@
 ## Installation		
 
 ### Source Code
-- Download [Version 0.6](https://github.com/openscilab/ipspot/archive/v0.6.zip) or [Latest Source](https://github.com/openscilab/ipspot/archive/dev.zip)
+- Download [Version 0.7](https://github.com/openscilab/ipspot/archive/v0.7.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.6`						
+- `pip install ipspot==0.7`						
 
 
 ## Usage
@@ -74,7 +74,7 @@
 {'status': True, 'data': {'ip': 'xx.xx.xx.xx', 'api': 'ip-api.com'}}
 >>> get_public_ipv4(api=IPv4API.IP_API_COM, geo=True, timeout=10)
 {'data': {'country_code': 'GB', 'latitude': 50.9097, 'longitude': -1.4043, 'api': 'ip-api.com', 'country': 'United Kingdom', 'timezone': 'Europe/London', 'organization': '', 'region': 'England', 'ip': 'xx.xx.xx.xx', 'city': 'Southampton'}, 'status': True}
->>> get_public_ipv4(api=IPv4API.IP_API_COM, geo=True, timeout=10, max_retries=5, retry_delay=4)
+>>> get_public_ipv4(api=IPv4API.IP_API_COM, geo=True, timeout=10, max_retries=5, retry_delay=4, backoff_factor=1.2)
 {'data': {'country_code': 'GB', 'latitude': 50.9097, 'longitude': -1.4043, 'api': 'ip-api.com', 'country': 'United Kingdom', 'timezone': 'Europe/London', 'organization': '', 'region': 'England', 'ip': 'xx.xx.xx.xx', 'city': 'Southampton'}, 'status': True}
 ```
 
@@ -94,7 +94,7 @@
 {'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)
+>>> get_public_ipv6(api=IPv6API.IP_SB, geo=True, timeout=10, max_retries=5, retry_delay=4, backoff_factor=1.2)
 {'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}
 ```
 
@@ -115,7 +115,7 @@
 ```console
 > ipspot --version
 
-0.6
+0.7
 ```
 
 #### Info
@@ -123,18 +123,18 @@
 ```console
 > ipspot --info
 
- ___  ____   ____                 _
-|_ _||  _ \ / ___|  _ __    ___  | |_
+ ___  ____   ____                 _   
+|_ _||  _ \ / ___|  _ __    ___  | |_ 
  | | | |_) |\___ \ | '_ \  / _ \ | __|
- | | |  __/  ___) || |_) || (_) || |_
+ | | |  __/  ___) || |_) || (_) || |_ 
 |___||_|    |____/ | .__/  \___/  \__|
-                   |_|
+                   |_|                
 
-__     __     ___       __
-\ \   / / _  / _ \     / /_
- \ \ / / (_)| | | |   | '_ \
-  \ V /   _ | |_| | _ | (_) |
-   \_/   (_) \___/ (_) \___/
+__     __     ___      _____ 
+\ \   / / _  / _ \    |___  |
+ \ \ / / (_)| | | |      / / 
+  \ V /   _ | |_| | _   / /  
+   \_/   (_) \___/ (_) /_/ 
 
 
 

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

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

{ipspot-0.6 → ipspot-0.7}/ipspot/cli.py

@@ -8,9 +8,11 @@ from .ipv6 import get_public_ipv6, get_private_ipv6
 from .utils import _filter_parameter
 from .params import IPv4API, IPv6API, PARAMETERS_NAME_MAP
 from .params import IPSPOT_OVERVIEW, IPSPOT_REPO, IPSPOT_VERSION
+from .params import PUBLIC_IPV4_ERROR, PRIVATE_IPV4_ERROR
+from .params import PUBLIC_IPV6_ERROR, PRIVATE_IPV6_ERROR
 
 
-def ipspot_info() -> None:  # pragma: no cover
+def _print_ipspot_info() -> None:  # pragma: no cover
     """Print ipspot details."""
     tprint("IPSpot")
     tprint("V:" + IPSPOT_VERSION)
@@ -18,11 +20,13 @@ def ipspot_info() -> None:  # pragma: no cover
     print("Repo : " + IPSPOT_REPO)
 
 
-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
+def _print_report(ipv4_api: IPv4API,
+                  ipv6_api: IPv6API,
+                  geo: bool,
+                  timeout: Union[float, Tuple[float, float]],
+                  max_retries: int,
+                  retry_delay: float,
+                  backoff_factor: float) -> None:  # pragma: no cover
     """
     Print collected IP and location data.
 
@@ -32,20 +36,21 @@ def display_ip_info(ipv4_api: IPv4API = IPv4API.AUTO_SAFE,
     :param timeout: timeout value for API
     :param max_retries: number of retries
     :param retry_delay: delay between retries (in seconds)
+    :param backoff_factor: backoff factor
     """
     print("Private IP:\n")
     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"]
+        private_ipv4 = PRIVATE_IPV4_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"]
+        private_ipv6 = PRIVATE_IPV6_ERROR
     print("  IPv6: {private_ipv6}".format(private_ipv6=private_ipv6))
 
     public_title = "\nPublic IP"
@@ -59,7 +64,8 @@ def display_ip_info(ipv4_api: IPv4API = IPv4API.AUTO_SAFE,
         geo=geo,
         timeout=timeout,
         max_retries=max_retries,
-        retry_delay=retry_delay)
+        retry_delay=retry_delay,
+        backoff_factor=backoff_factor)
     if public_ipv4_result["status"]:
         for name, parameter in sorted(public_ipv4_result["data"].items()):
             print(
@@ -67,7 +73,7 @@ def display_ip_info(ipv4_api: IPv4API = IPv4API.AUTO_SAFE,
                     name=PARAMETERS_NAME_MAP[name],
                     parameter=_filter_parameter(parameter)))
     else:
-        print("    Error: {public_ipv4_result[error]}".format(public_ipv4_result=public_ipv4_result))
+        print("    Error: {public_ipv4_result}".format(public_ipv4_result=PUBLIC_IPV4_ERROR))
 
     print("\n  IPv6:\n")
     public_ipv6_result = get_public_ipv6(
@@ -75,7 +81,8 @@ def display_ip_info(ipv4_api: IPv4API = IPv4API.AUTO_SAFE,
         geo=geo,
         timeout=timeout,
         max_retries=max_retries,
-        retry_delay=retry_delay)
+        retry_delay=retry_delay,
+        backoff_factor=backoff_factor)
     if public_ipv6_result["status"]:
         for name, parameter in sorted(public_ipv6_result["data"].items()):
             print(
@@ -83,7 +90,7 @@ def display_ip_info(ipv4_api: IPv4API = IPv4API.AUTO_SAFE,
                     name=PARAMETERS_NAME_MAP[name],
                     parameter=_filter_parameter(parameter)))
     else:
-        print("    Error: {public_ipv6_result[error]}".format(public_ipv6_result=public_ipv6_result))
+        print("    Error: {public_ipv6_result}".format(public_ipv6_result=PUBLIC_IPV6_ERROR))
 
 
 def main() -> None:  # pragma: no cover
@@ -109,20 +116,22 @@ def main() -> None:  # pragma: no cover
     parser.add_argument('--timeout', help='timeout for the API request', type=float, default=5.0)
     parser.add_argument('--max-retries', help='number of retries', type=int, default=0)
     parser.add_argument('--retry-delay', help='delay between retries (in seconds)', type=float, default=1.0)
+    parser.add_argument('--backoff-factor', help='backoff factor', type=float, default=1.0)
 
     args = parser.parse_args()
     if args.version:
         print(IPSPOT_VERSION)
     elif args.info:
-        ipspot_info()
+        _print_ipspot_info()
     else:
         ipv4_api = IPv4API(args.ipv4_api)
         ipv6_api = IPv6API(args.ipv6_api)
         geo = not args.no_geo
-        display_ip_info(
+        _print_report(
             ipv4_api=ipv4_api,
             ipv6_api=ipv6_api,
             geo=geo,
             timeout=args.timeout,
             max_retries=args.max_retries,
-            retry_delay=args.retry_delay)
+            retry_delay=args.retry_delay,
+            backoff_factor=args.backoff_factor)

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

@@ -36,8 +36,8 @@ def get_private_ipv4() -> Dict[str, Union[bool, Dict[str, str], str]]:
         return {"status": False, "error": str(e)}
 
 
-def _ip_sb_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]]
-                =5) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:
+def _ip_sb_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 ip.sb.
 
@@ -64,8 +64,8 @@ def _ip_sb_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]]
         return {"status": False, "error": str(e)}
 
 
-def _ipleak_net_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]]
-                     =5) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:
+def _ipleak_net_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 ipleak.net.
 
@@ -92,8 +92,8 @@ def _ipleak_net_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]]
         return {"status": False, "error": str(e)}
 
 
-def _my_ip_io_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]]
-                   =5) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:
+def _my_ip_io_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 my-ip.io.
 
@@ -120,8 +120,9 @@ 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]]  # very low rate limit
-                      =5) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:
+# very low rate limit
+def _ifconfig_co_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 ifconfig.co.
 
@@ -148,8 +149,8 @@ def _ifconfig_co_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]
         return {"status": False, "error": str(e)}
 
 
-def _ipapi_co_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]]
-                   =5) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:
+def _ipapi_co_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 ipapi.co.
 
@@ -176,8 +177,8 @@ def _ipapi_co_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]]
         return {"status": False, "error": str(e)}
 
 
-def _ip_api_com_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]]
-                     =5) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:
+def _ip_api_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 ip-api.com.
 
@@ -206,8 +207,8 @@ def _ip_api_com_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]]
         return {"status": False, "error": str(e)}
 
 
-def _ipinfo_io_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]]
-                    =5) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:
+def _ipinfo_io_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 ipinfo.io.
 
@@ -235,8 +236,8 @@ def _ipinfo_io_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]]
         return {"status": False, "error": str(e)}
 
 
-def _reallyfreegeoip_org_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]]
-                              =5) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:
+def _reallyfreegeoip_org_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 reallyfreegeoip.org.
 
@@ -263,8 +264,8 @@ def _reallyfreegeoip_org_ipv4(geo: bool=False, timeout: Union[float, Tuple[float
         return {"status": False, "error": str(e)}
 
 
-def _ident_me_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]]
-                   =5) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:
+def _ident_me_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 ident.me.
 
@@ -291,8 +292,8 @@ def _ident_me_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]]
         return {"status": False, "error": str(e)}
 
 
-def _tnedi_me_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]]
-                   =5) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:
+def _tnedi_me_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 tnedi.me.
 
@@ -319,7 +320,7 @@ def _tnedi_me_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]]
         return {"status": False, "error": str(e)}
 
 
-def _myip_la_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]]=5
+def _myip_la_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.la.
@@ -348,7 +349,7 @@ def _myip_la_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]]=5
         return {"status": False, "error": str(e)}
 
 
-def _freeipapi_com_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]]=5
+def _freeipapi_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 freeipapi.com.
@@ -377,7 +378,7 @@ 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
+def _ipquery_io_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 ipquery.io.
@@ -407,7 +408,7 @@ def _ipquery_io_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]]
         return {"status": False, "error": str(e)}
 
 
-def _ipwho_is_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]]=5
+def _ipwho_is_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 ipwho.is.
@@ -437,7 +438,7 @@ def _ipwho_is_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]]=5
         return {"status": False, "error": str(e)}
 
 
-def _wtfismyip_com_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]]=5
+def _wtfismyip_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 wtfismyip.com.
@@ -547,7 +548,8 @@ IPV4_API_MAP = {
 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) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:
+                    retry_delay: float = 1.0,
+                    backoff_factor: float = 1.0) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:
     """
     Get public IPv4 and geolocation info based on the selected API.
 
@@ -556,6 +558,7 @@ def get_public_ipv4(api: IPv4API=IPv4API.AUTO_SAFE, geo: bool=False,
     :param timeout: timeout value for API
     :param max_retries: number of retries
     :param retry_delay: delay between retries (in seconds)
+    :param backoff_factor: backoff factor
     """
     if api in [IPv4API.AUTO, IPv4API.AUTO_SAFE]:
         for _, api_data in IPV4_API_MAP.items():
@@ -566,6 +569,7 @@ def get_public_ipv4(api: IPv4API=IPv4API.AUTO_SAFE, geo: bool=False,
                 func=func,
                 max_retries=max_retries,
                 retry_delay=retry_delay,
+                backoff_factor=backoff_factor,
                 geo=geo,
                 timeout=timeout)
             if result["status"]:
@@ -579,6 +583,7 @@ def get_public_ipv4(api: IPv4API=IPv4API.AUTO_SAFE, geo: bool=False,
                 func=func,
                 max_retries=max_retries,
                 retry_delay=retry_delay,
+                backoff_factor=backoff_factor,
                 geo=geo,
                 timeout=timeout)
         return {"status": False, "error": "Unsupported API: {api}".format(api=api)}

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

@@ -37,8 +37,8 @@ def get_private_ipv6() -> Dict[str, Union[bool, Dict[str, str], str]]:
         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]]:
+def _ip_sb_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 ip.sb.
 
@@ -65,8 +65,8 @@ def _ip_sb_ipv6(geo: bool=False, timeout: Union[float, Tuple[float, float]]
         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]]:
+def _ident_me_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 ident.me.
 
@@ -93,8 +93,8 @@ def _ident_me_ipv6(geo: bool=False, timeout: Union[float, Tuple[float, float]]
         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]]:
+def _tnedi_me_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 tnedi.me.
 
@@ -121,8 +121,8 @@ def _tnedi_me_ipv6(geo: bool=False, timeout: Union[float, Tuple[float, float]]
         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]]:
+def _ipleak_net_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 ipleak.net.
 
@@ -149,8 +149,8 @@ def _ipleak_net_ipv6(geo: bool=False, timeout: Union[float, Tuple[float, float]]
         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]]:
+def _my_ip_io_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 my-ip.io.
 
@@ -177,8 +177,9 @@ 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]]:
+# very low rate limit
+def _ifconfig_co_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 ifconfig.co.
 
@@ -205,8 +206,8 @@ def _ifconfig_co_ipv6(geo: bool=False, timeout: Union[float, Tuple[float, float]
         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]]:
+def _reallyfreegeoip_org_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 reallyfreegeoip.org.
 
@@ -233,8 +234,8 @@ def _reallyfreegeoip_org_ipv6(geo: bool=False, timeout: Union[float, Tuple[float
         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]]:
+def _myip_la_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.la.
 
@@ -262,8 +263,8 @@ def _myip_la_ipv6(geo: bool=False, timeout: Union[float, Tuple[float, float]]
         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]]:
+def _freeipapi_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 freeipapi.com.
 
@@ -343,7 +344,8 @@ IPV6_API_MAP = {
 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]]:
+                    retry_delay: float = 1.0,
+                    backoff_factor: float = 1.0) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:
     """
     Get public IPv6 and geolocation info based on the selected API.
 
@@ -352,6 +354,7 @@ def get_public_ipv6(api: IPv6API=IPv6API.AUTO_SAFE, geo: bool=False,
     :param timeout: timeout value for API
     :param max_retries: number of retries
     :param retry_delay: delay between retries (in seconds)
+    :param backoff_factor: backoff factor
     """
     if api in [IPv6API.AUTO, IPv6API.AUTO_SAFE]:
         for _, api_data in IPV6_API_MAP.items():
@@ -362,6 +365,7 @@ def get_public_ipv6(api: IPv6API=IPv6API.AUTO_SAFE, geo: bool=False,
                 func=func,
                 max_retries=max_retries,
                 retry_delay=retry_delay,
+                backoff_factor=backoff_factor,
                 geo=geo,
                 timeout=timeout)
             if result["status"]:
@@ -375,6 +379,7 @@ def get_public_ipv6(api: IPv6API=IPv6API.AUTO_SAFE, geo: bool=False,
                 func=func,
                 max_retries=max_retries,
                 retry_delay=retry_delay,
+                backoff_factor=backoff_factor,
                 geo=geo,
                 timeout=timeout)
         return {"status": False, "error": "Unsupported API: {api}".format(api=api)}

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

@@ -2,7 +2,7 @@
 """ipspot params."""
 from enum import Enum
 
-IPSPOT_VERSION = "0.6"
+IPSPOT_VERSION = "0.7"
 
 IPSPOT_OVERVIEW = '''
 IPSpot is a Python library for retrieving the current system's IP address and location information.
@@ -68,3 +68,8 @@ PARAMETERS_NAME_MAP = {
     "organization": "Organization",
     "api": "API"
 }
+
+PUBLIC_IPV4_ERROR = "Unable to retrieve public IPv4 information."
+PRIVATE_IPV4_ERROR = "Unable to retrieve private IPv4 address."
+PUBLIC_IPV6_ERROR = "Unable to retrieve public IPv6 information."
+PRIVATE_IPV6_ERROR = "Unable to retrieve private IPv6 address."

{ipspot-0.6 → ipspot-0.7}/ipspot/utils.py

@@ -74,22 +74,27 @@ def _get_json_force_ip(url: str, timeout: Union[float, Tuple[float, float]],
 def _attempt_with_retries(
         func: Callable,
         max_retries: int,
-        retry_delay: float, **kwargs: dict) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:
+        retry_delay: float,
+        backoff_factor: 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 backoff_factor: backoff factor
     :param kwargs: keyword arguments to pass to the function
     """
     max_retries = max(0, max_retries)
     result = {"status": False, "error": ""}
+    next_delay = retry_delay
     for attempt in range(max_retries + 1):
         result = func(**kwargs)
         if result["status"]:
             break
-        time.sleep(retry_delay)
+        time.sleep(next_delay)
+        next_delay *= backoff_factor
     return result
 
 

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

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: ipspot
-Version: 0.6
+Version: 0.7
 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.6
+Download-URL: https://github.com/openscilab/ipspot/tarball/v0.7
 Author: IPSpot Development Team
 Author-email: ipspot@openscilab.com
 License: MIT
@@ -20,6 +20,7 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Education
 Classifier: Intended Audience :: End Users/Desktop
@@ -103,13 +104,13 @@ Dynamic: summary
 ## Installation		
 
 ### Source Code
-- Download [Version 0.6](https://github.com/openscilab/ipspot/archive/v0.6.zip) or [Latest Source](https://github.com/openscilab/ipspot/archive/dev.zip)
+- Download [Version 0.7](https://github.com/openscilab/ipspot/archive/v0.7.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.6`						
+- `pip install ipspot==0.7`						
 
 
 ## Usage
@@ -124,7 +125,7 @@ Dynamic: summary
 {'status': True, 'data': {'ip': 'xx.xx.xx.xx', 'api': 'ip-api.com'}}
 >>> get_public_ipv4(api=IPv4API.IP_API_COM, geo=True, timeout=10)
 {'data': {'country_code': 'GB', 'latitude': 50.9097, 'longitude': -1.4043, 'api': 'ip-api.com', 'country': 'United Kingdom', 'timezone': 'Europe/London', 'organization': '', 'region': 'England', 'ip': 'xx.xx.xx.xx', 'city': 'Southampton'}, 'status': True}
->>> get_public_ipv4(api=IPv4API.IP_API_COM, geo=True, timeout=10, max_retries=5, retry_delay=4)
+>>> get_public_ipv4(api=IPv4API.IP_API_COM, geo=True, timeout=10, max_retries=5, retry_delay=4, backoff_factor=1.2)
 {'data': {'country_code': 'GB', 'latitude': 50.9097, 'longitude': -1.4043, 'api': 'ip-api.com', 'country': 'United Kingdom', 'timezone': 'Europe/London', 'organization': '', 'region': 'England', 'ip': 'xx.xx.xx.xx', 'city': 'Southampton'}, 'status': True}
 ```
 
@@ -144,7 +145,7 @@ Dynamic: summary
 {'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)
+>>> get_public_ipv6(api=IPv6API.IP_SB, geo=True, timeout=10, max_retries=5, retry_delay=4, backoff_factor=1.2)
 {'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}
 ```
 
@@ -165,7 +166,7 @@ Dynamic: summary
 ```console
 > ipspot --version
 
-0.6
+0.7
 ```
 
 #### Info
@@ -173,18 +174,18 @@ Dynamic: summary
 ```console
 > ipspot --info
 
- ___  ____   ____                 _
-|_ _||  _ \ / ___|  _ __    ___  | |_
+ ___  ____   ____                 _   
+|_ _||  _ \ / ___|  _ __    ___  | |_ 
  | | | |_) |\___ \ | '_ \  / _ \ | __|
- | | |  __/  ___) || |_) || (_) || |_
+ | | |  __/  ___) || |_) || (_) || |_ 
 |___||_|    |____/ | .__/  \___/  \__|
-                   |_|
+                   |_|                
 
-__     __     ___       __
-\ \   / / _  / _ \     / /_
- \ \ / / (_)| | | |   | '_ \
-  \ V /   _ | |_| | _ | (_) |
-   \_/   (_) \___/ (_) \___/
+__     __     ___      _____ 
+\ \   / / _  / _ \    |___  |
+ \ \ / / (_)| | | |      / / 
+  \ V /   _ | |_| | _   / /  
+   \_/   (_) \___/ (_) /_/ 
 
 
 
@@ -376,6 +377,17 @@ 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.7] - 2025-12-09
+### Added
+- `--backoff-factor` argument
+### Changed
+- CLI messages updated
+- `Python 3.14` added to `test.yml`
+- Internal functions default values removed
+- `README.md` updated
+- Test system modified
+- `ipspot_info` function renamed to `_print_ipspot_info`
+- `display_ip_info` function renamed to `_print_report`
 ## [0.6] - 2025-11-18
 ### Added
 - `ForceIPHTTPAdapter` class
@@ -468,7 +480,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.6...dev
+[Unreleased]: https://github.com/openscilab/ipspot/compare/v0.7...dev
+[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
 [0.4]: https://github.com/openscilab/ipspot/compare/v0.3...v0.4

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

@@ -32,7 +32,7 @@ def read_description() -> str:
 setup(
     name='ipspot',
     packages=['ipspot'],
-    version='0.6',
+    version='0.7',
     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.6',
+    download_url='https://github.com/openscilab/ipspot/tarball/v0.7',
     keywords="ip ipv4 geo geolocation network location ipspot cli",
     project_urls={
         'Source': 'https://github.com/openscilab/ipspot'
@@ -59,6 +59,7 @@ setup(
         'Programming Language :: Python :: 3.11',
         'Programming Language :: Python :: 3.12',
         'Programming Language :: Python :: 3.13',
+        'Programming Language :: Python :: 3.14',
         'Intended Audience :: Developers',
         'Intended Audience :: Education',
         'Intended Audience :: End Users/Desktop',

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

@@ -20,7 +20,7 @@ def test_public_ipv4_auto_safe_success():
 
 
 def test_public_ipv4_ipapi_co_success():
-    result = get_public_ipv4(api=IPv4API.IPAPI_CO, geo=True, timeout=40, max_retries=4, retry_delay=90)
+    result = get_public_ipv4(api=IPv4API.IPAPI_CO, 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
@@ -28,7 +28,7 @@ def test_public_ipv4_ipapi_co_success():
 
 
 def test_public_ipv4_ipleak_net_success():
-    result = get_public_ipv4(api=IPv4API.IPLEAK_NET, geo=True, timeout=40, max_retries=4, retry_delay=90)
+    result = get_public_ipv4(api=IPv4API.IPLEAK_NET, 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
@@ -36,7 +36,7 @@ def test_public_ipv4_ipleak_net_success():
 
 
 def test_public_ipv4_my_ip_io_success():
-    result = get_public_ipv4(api=IPv4API.MY_IP_IO, geo=True, timeout=40, max_retries=4, retry_delay=90)
+    result = get_public_ipv4(api=IPv4API.MY_IP_IO, 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
@@ -44,7 +44,7 @@ def test_public_ipv4_my_ip_io_success():
 
 
 def test_public_ipv4_ifconfig_co_success():
-    result = get_public_ipv4(api=IPv4API.IFCONFIG_CO, geo=True, timeout=40, max_retries=4, retry_delay=90)
+    result = get_public_ipv4(api=IPv4API.IFCONFIG_CO, 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
@@ -52,7 +52,7 @@ def test_public_ipv4_ifconfig_co_success():
 
 
 def test_public_ipv4_myip_la_success():
-    result = get_public_ipv4(api=IPv4API.MYIP_LA, geo=True, timeout=40, max_retries=4, retry_delay=90)
+    result = get_public_ipv4(api=IPv4API.MYIP_LA, 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
@@ -60,7 +60,7 @@ def test_public_ipv4_myip_la_success():
 
 
 def test_public_ipv4_ipquery_io_success():
-    result = get_public_ipv4(api=IPv4API.IPQUERY_IO, geo=True, timeout=40, max_retries=4, retry_delay=90)
+    result = get_public_ipv4(api=IPv4API.IPQUERY_IO, 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
@@ -68,7 +68,7 @@ def test_public_ipv4_ipquery_io_success():
 
 
 def test_public_ipv4_ipwho_is_success():
-    result = get_public_ipv4(api=IPv4API.IPWHO_IS, geo=True, timeout=40, max_retries=4, retry_delay=90)
+    result = get_public_ipv4(api=IPv4API.IPWHO_IS, 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
@@ -76,7 +76,7 @@ def test_public_ipv4_ipwho_is_success():
 
 
 def test_public_ipv4_freeipapi_com_success():
-    result = get_public_ipv4(api=IPv4API.FREEIPAPI_COM, geo=True, timeout=40, max_retries=4, retry_delay=90)
+    result = get_public_ipv4(api=IPv4API.FREEIPAPI_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
@@ -84,7 +84,7 @@ def test_public_ipv4_freeipapi_com_success():
 
 
 def test_public_ipv4_ip_api_com_success():
-    result = get_public_ipv4(api=IPv4API.IP_API_COM, geo=True, timeout=40, max_retries=4, retry_delay=90)
+    result = get_public_ipv4(api=IPv4API.IP_API_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
@@ -92,7 +92,7 @@ def test_public_ipv4_ip_api_com_success():
 
 
 def test_public_ipv4_ipinfo_io_success():
-    result = get_public_ipv4(api=IPv4API.IPINFO_IO, geo=True, timeout=40, max_retries=4, retry_delay=90)
+    result = get_public_ipv4(api=IPv4API.IPINFO_IO, 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
@@ -100,7 +100,7 @@ def test_public_ipv4_ipinfo_io_success():
 
 
 def test_public_ipv4_ip_sb_success():
-    result = get_public_ipv4(api=IPv4API.IP_SB, geo=True, timeout=40, max_retries=4, retry_delay=90)
+    result = get_public_ipv4(api=IPv4API.IP_SB, 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
@@ -108,7 +108,7 @@ def test_public_ipv4_ip_sb_success():
 
 
 def test_public_ipv4_ident_me_success():
-    result = get_public_ipv4(api=IPv4API.IDENT_ME, geo=True, timeout=40, max_retries=4, retry_delay=90)
+    result = get_public_ipv4(api=IPv4API.IDENT_ME, 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
@@ -116,7 +116,7 @@ def test_public_ipv4_ident_me_success():
 
 
 def test_public_ipv4_tnedi_me_success():
-    result = get_public_ipv4(api=IPv4API.TNEDI_ME, geo=True, timeout=40, max_retries=4, retry_delay=90)
+    result = get_public_ipv4(api=IPv4API.TNEDI_ME, 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
@@ -124,7 +124,7 @@ def test_public_ipv4_tnedi_me_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)
+    result = get_public_ipv4(api=IPv4API.REALLYFREEGEOIP_ORG, 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
@@ -132,7 +132,7 @@ def test_public_ipv4_reallyfreegeoip_org_success():
 
 
 def test_public_ipv4_wtfismyip_com_success():
-    result = get_public_ipv4(api=IPv4API.WTFISMYIP_COM, geo=True, timeout=40, max_retries=4, retry_delay=90)
+    result = get_public_ipv4(api=IPv4API.WTFISMYIP_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

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

@@ -13,7 +13,7 @@ def test_public_ipv6_ip_sb_success():
 
 
 def test_public_ipv6_ident_me_success():
-    result = get_public_ipv6(api=IPv6API.IDENT_ME, geo=True, timeout=40, max_retries=4, retry_delay=90)
+    result = get_public_ipv6(api=IPv6API.IDENT_ME, 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
@@ -21,7 +21,7 @@ def test_public_ipv6_ident_me_success():
 
 
 def test_public_ipv6_tnedi_me_success():
-    result = get_public_ipv6(api=IPv6API.TNEDI_ME, geo=True, timeout=40, max_retries=4, retry_delay=90)
+    result = get_public_ipv6(api=IPv6API.TNEDI_ME, 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
@@ -29,7 +29,7 @@ def test_public_ipv6_tnedi_me_success():
 
 
 def test_public_ipv6_ipleak_net_success():
-    result = get_public_ipv6(api=IPv6API.IPLEAK_NET, geo=True, timeout=40, max_retries=4, retry_delay=90)
+    result = get_public_ipv6(api=IPv6API.IPLEAK_NET, 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
@@ -37,7 +37,7 @@ def test_public_ipv6_ipleak_net_success():
 
 
 def test_public_ipv6_my_ip_io_success():
-    result = get_public_ipv6(api=IPv6API.MY_IP_IO, geo=True, timeout=40, max_retries=4, retry_delay=90)
+    result = get_public_ipv6(api=IPv6API.MY_IP_IO, 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
@@ -45,7 +45,7 @@ def test_public_ipv6_my_ip_io_success():
 
 
 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)
+    result = get_public_ipv6(api=IPv6API.IFCONFIG_CO, 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
@@ -53,7 +53,7 @@ def test_public_ipv6_ifconfig_co_success():
 
 
 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)
+    result = get_public_ipv6(api=IPv6API.REALLYFREEGEOIP_ORG, 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
@@ -61,7 +61,7 @@ def test_public_ipv6_reallyfreegeoip_org_success():
 
 
 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)
+    result = get_public_ipv6(api=IPv6API.MYIP_LA, 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
@@ -69,7 +69,7 @@ def test_public_ipv6_myip_la_success():
 
 
 def test_public_freeipapi_com_success():
-    result = get_public_ipv6(api=IPv6API.FREEIPAPI_COM, geo=True, timeout=40, max_retries=4, retry_delay=90)
+    result = get_public_ipv6(api=IPv6API.FREEIPAPI_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
@@ -77,14 +77,14 @@ def test_public_freeipapi_com_success():
 
 
 def test_public_ipv6_auto_success():
-    result = get_public_ipv6(api=IPv6API.AUTO, geo=True, timeout=40, max_retries=4, retry_delay=90)
+    result = get_public_ipv6(api=IPv6API.AUTO, 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
 
 
 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)
+    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

{ipspot-0.6 → ipspot-0.7}/tests/test_utils.py

@@ -21,7 +21,7 @@ def test_filter_parameter4():
 
 def test_attempt_with_retries1():
     mock_func = Mock(return_value={"status": True, "data": {"message": "ok"}})
-    result = _attempt_with_retries(mock_func, max_retries=3, retry_delay=0.01)
+    result = _attempt_with_retries(mock_func, max_retries=3, retry_delay=0.01, backoff_factor=1.3)
     assert result["status"] is True
     assert mock_func.call_count == 1
 
@@ -31,33 +31,33 @@ def test_attempt_with_retries2():
         {"status": False, "error": "fail again"},
         {"status": True, "data": {"message": "ok"}}
     ])
-    result = _attempt_with_retries(mock_func, max_retries=5, retry_delay=0.01)
+    result = _attempt_with_retries(mock_func, max_retries=5, retry_delay=0.01, backoff_factor=1.3)
     assert result["status"] is True
     assert mock_func.call_count == 3
 
 def test_attempt_with_retries3():
     mock_func = Mock(return_value={"status": False, "error": "permanent failure"})
-    result = _attempt_with_retries(mock_func, max_retries=2, retry_delay=0.01)
+    result = _attempt_with_retries(mock_func, max_retries=2, retry_delay=0.01, backoff_factor=1.3)
     assert result["status"] is False
     assert result["error"] == "permanent failure"
     assert mock_func.call_count == 3
 
 def test_attempt_with_retries4():
     mock_func = Mock(return_value={"status": False, "error": "no retry"})
-    result = _attempt_with_retries(mock_func, max_retries=0, retry_delay=0.01)
+    result = _attempt_with_retries(mock_func, max_retries=0, retry_delay=0.01, backoff_factor=1.3)
     assert result["status"] is False
     assert mock_func.call_count == 1
 
 def test_attempt_with_retries5():
     mock_func = Mock(return_value={"status": False, "error": "invalid"})
-    result = _attempt_with_retries(mock_func, max_retries=-5, retry_delay=0.01)
+    result = _attempt_with_retries(mock_func, max_retries=-5, retry_delay=0.01, backoff_factor=1.3)
     assert result["status"] is False
     assert mock_func.call_count == 1
 
 def test_attempt_with_retries6():
     def example_func(x, y):
         return {"status": x + y > 0, "data": {"sum": x + y} if x + y > 0 else {}, "error": "" if x + y > 0 else "negative"}
-    result = _attempt_with_retries(example_func, max_retries=1, retry_delay=0.01, x=1, y=2)
+    result = _attempt_with_retries(example_func, max_retries=1, retry_delay=0.01, backoff_factor=1.3, x=1, y=2)
     assert result["status"] is True
     assert result["data"]["sum"] == 3