ipspot 0.1__tar.gz → 0.2__tar.gz

{ipspot-0.1 → ipspot-0.2}/CHANGELOG.md

@@ -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.2] - 2025-05-04
+### Added
+- Support [ip.sb](https://api.ip.sb/geoip)
+- `--timeout` argument
+### Changed
+- `README.md` updated
+- Requests header updated
+- Test system modified
 ## [0.1] - 2025-04-25
 ### Added
 - Support [ipinfo.io](https://ipinfo.io)
@@ -16,7 +24,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.1...dev
+[Unreleased]: https://github.com/openscilab/ipspot/compare/v0.2...dev
+[0.2]: https://github.com/openscilab/ipspot/compare/v0.1...v0.2
 [0.1]: https://github.com/openscilab/ipspot/compare/3216fb7...v0.1
 
 

{ipspot-0.1 → ipspot-0.2}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: ipspot
-Version: 0.1
+Version: 0.2
 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.1
+Download-URL: https://github.com/openscilab/ipspot/tarball/v0.2
 Author: IPSpot Development Team
 Author-email: ipspot@openscilab.com
 License: MIT
@@ -55,6 +55,7 @@ Dynamic: summary
 <a href="https://badge.fury.io/py/ipspot"><img src="https://badge.fury.io/py/ipspot.svg" alt="PyPI version"></a>
 <a href="https://www.python.org/"><img src="https://img.shields.io/badge/built%20with-Python3-green.svg" alt="built with Python3"></a>
 <a href="https://github.com/openscilab/ipspot"><img alt="GitHub repo size" src="https://img.shields.io/github/repo-size/openscilab/ipspot"></a>
+<a href="https://discord.gg/yyDV3T4cwU"><img src="https://img.shields.io/discord/1064533716615049236.svg" alt="Discord Channel"></a>
 </div>			
 				
 ## Overview	
@@ -89,17 +90,25 @@ Dynamic: summary
 	</tr>
 </table>
 
+<table>
+	<tr> 
+		<td align="center">Code Quality</td>
+		<td align="center"><a href="https://app.codacy.com/gh/openscilab/ipspot/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade"><img src="https://app.codacy.com/project/badge/Grade/cb2ab6584eb443b8a33da4d4252480bc"/></a></td>
+		<td align="center"><a href="https://www.codefactor.io/repository/github/openscilab/ipspot"><img src="https://www.codefactor.io/repository/github/openscilab/ipspot/badge" alt="CodeFactor"></a></td>
+	</tr>
+</table>
+
 
 ## Installation		
 
 ### Source Code
-- Download [Version 0.1](https://github.com/openscilab/ipspot/archive/v0.1.zip) or [Latest Source](https://github.com/openscilab/ipspot/archive/dev.zip)
+- Download [Version 0.2](https://github.com/openscilab/ipspot/archive/v0.2.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.1`						
+- `pip install ipspot==0.2`						
 
 
 ## Usage
@@ -112,7 +121,7 @@ Dynamic: summary
 >>> from ipspot import get_public_ipv4, IPv4API
 >>> get_public_ipv4(api=IPv4API.IPAPI)
 {'status': True, 'data': {'ip': 'xx.xx.xx.xx', 'api': 'ip-api.com'}}
->>> get_public_ipv4(api=IPv4API.IPAPI, geo=True)
+>>> get_public_ipv4(api=IPv4API.IPAPI, 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}
 ```
 
@@ -133,7 +142,7 @@ Dynamic: summary
 ```console
 > ipspot --version
 
-0.1
+0.2
 ```
 
 #### Info
@@ -148,11 +157,11 @@ Dynamic: summary
 |___||_|    |____/ | .__/  \___/  \__|
                    |_|
 
-__     __     ___      _
-\ \   / / _  / _ \    / |
- \ \ / / (_)| | | |   | |
-  \ V /   _ | |_| | _ | |
-   \_/   (_) \___/ (_)|_|
+__     __     ___      ____
+\ \   / / _  / _ \    |___ \
+ \ \ / / (_)| | | |     __) |
+  \ V /   _ | |_| | _  / __/
+   \_/   (_) \___/ (_)|_____|
 
 
 
@@ -188,7 +197,7 @@ Public IP and Location Info:
 
 #### IPv4 API
 
-ℹ️ `ipv4-api` valid choices: [`auto`, `ipapi`, `ipinfo`]
+ℹ️ `ipv4-api` valid choices: [`auto`, `ipapi`, `ipinfo`, `ipsb`]
 
 ℹ️ The default value: `auto`
 
@@ -231,7 +240,12 @@ Public IP:
 Just fill an issue and describe it. We'll check it ASAP!
 
 - Please complete the issue template
- 			
+
+You can also join our discord server
+
+<a href="https://discord.gg/yyDV3T4cwU">
+  <img src="https://img.shields.io/discord/1064533716615049236.svg?style=for-the-badge" alt="Discord Channel">
+</a>
 
 ## Show Your Support
 								
@@ -253,6 +267,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.2] - 2025-05-04
+### Added
+- Support [ip.sb](https://api.ip.sb/geoip)
+- `--timeout` argument
+### Changed
+- `README.md` updated
+- Requests header updated
+- Test system modified
 ## [0.1] - 2025-04-25
 ### Added
 - Support [ipinfo.io](https://ipinfo.io)
@@ -264,7 +286,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.1...dev
+[Unreleased]: https://github.com/openscilab/ipspot/compare/v0.2...dev
+[0.2]: https://github.com/openscilab/ipspot/compare/v0.1...v0.2
 [0.1]: https://github.com/openscilab/ipspot/compare/3216fb7...v0.1
 
 

{ipspot-0.1 → ipspot-0.2}/README.md

@@ -5,6 +5,7 @@
 <a href="https://badge.fury.io/py/ipspot"><img src="https://badge.fury.io/py/ipspot.svg" alt="PyPI version"></a>
 <a href="https://www.python.org/"><img src="https://img.shields.io/badge/built%20with-Python3-green.svg" alt="built with Python3"></a>
 <a href="https://github.com/openscilab/ipspot"><img alt="GitHub repo size" src="https://img.shields.io/github/repo-size/openscilab/ipspot"></a>
+<a href="https://discord.gg/yyDV3T4cwU"><img src="https://img.shields.io/discord/1064533716615049236.svg" alt="Discord Channel"></a>
 </div>			
 				
 ## Overview	
@@ -39,17 +40,25 @@
 	</tr>
 </table>
 
+<table>
+	<tr> 
+		<td align="center">Code Quality</td>
+		<td align="center"><a href="https://app.codacy.com/gh/openscilab/ipspot/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade"><img src="https://app.codacy.com/project/badge/Grade/cb2ab6584eb443b8a33da4d4252480bc"/></a></td>
+		<td align="center"><a href="https://www.codefactor.io/repository/github/openscilab/ipspot"><img src="https://www.codefactor.io/repository/github/openscilab/ipspot/badge" alt="CodeFactor"></a></td>
+	</tr>
+</table>
+
 
 ## Installation		
 
 ### Source Code
-- Download [Version 0.1](https://github.com/openscilab/ipspot/archive/v0.1.zip) or [Latest Source](https://github.com/openscilab/ipspot/archive/dev.zip)
+- Download [Version 0.2](https://github.com/openscilab/ipspot/archive/v0.2.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.1`						
+- `pip install ipspot==0.2`						
 
 
 ## Usage
@@ -62,7 +71,7 @@
 >>> from ipspot import get_public_ipv4, IPv4API
 >>> get_public_ipv4(api=IPv4API.IPAPI)
 {'status': True, 'data': {'ip': 'xx.xx.xx.xx', 'api': 'ip-api.com'}}
->>> get_public_ipv4(api=IPv4API.IPAPI, geo=True)
+>>> get_public_ipv4(api=IPv4API.IPAPI, 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}
 ```
 
@@ -83,7 +92,7 @@
 ```console
 > ipspot --version
 
-0.1
+0.2
 ```
 
 #### Info
@@ -98,11 +107,11 @@
 |___||_|    |____/ | .__/  \___/  \__|
                    |_|
 
-__     __     ___      _
-\ \   / / _  / _ \    / |
- \ \ / / (_)| | | |   | |
-  \ V /   _ | |_| | _ | |
-   \_/   (_) \___/ (_)|_|
+__     __     ___      ____
+\ \   / / _  / _ \    |___ \
+ \ \ / / (_)| | | |     __) |
+  \ V /   _ | |_| | _  / __/
+   \_/   (_) \___/ (_)|_____|
 
 
 
@@ -138,7 +147,7 @@ Public IP and Location Info:
 
 #### IPv4 API
 
-ℹ️ `ipv4-api` valid choices: [`auto`, `ipapi`, `ipinfo`]
+ℹ️ `ipv4-api` valid choices: [`auto`, `ipapi`, `ipinfo`, `ipsb`]
 
 ℹ️ The default value: `auto`
 
@@ -181,7 +190,12 @@ Public IP:
 Just fill an issue and describe it. We'll check it ASAP!
 
 - Please complete the issue template
- 			
+
+You can also join our discord server
+
+<a href="https://discord.gg/yyDV3T4cwU">
+  <img src="https://img.shields.io/discord/1064533716615049236.svg?style=for-the-badge" alt="Discord Channel">
+</a>
 
 ## Show Your Support
 								

{ipspot-0.1 → ipspot-0.2}/SECURITY.md

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

{ipspot-0.1 → ipspot-0.2}/dev-requirements.txt

@@ -1,6 +1,8 @@
-requests==2.31.0
+requests==2.32.3
 art==6.5
 setuptools>=40.8.0
 vulture>=1.0
 bandit>=1.5.1
 pydocstyle>=3.0.0
+pytest>=4.3.1
+pytest-cov>=2.6.1

{ipspot-0.1 → ipspot-0.2}/ipspot/functions.py

@@ -2,19 +2,19 @@
 """ipspot functions."""
 import argparse
 import socket
-from typing import Union, Dict, Any
+from typing import Union, Dict, Tuple, Any
 import requests
 from art import tprint
-from .params import IPv4API, PARAMETERS_NAME_MAP
+from .params import REQUEST_HEADERS, IPv4API, PARAMETERS_NAME_MAP
 from .params import IPSPOT_OVERVIEW, IPSPOT_REPO, IPSPOT_VERSION
 
 
-def ipspot_info() -> None:
+def ipspot_info() -> None:  # pragma: no cover
     """Print ipspot details."""
     tprint("IPSpot")
     tprint("V:" + IPSPOT_VERSION)
     print(IPSPOT_OVERVIEW)
-    print(IPSPOT_REPO)
+    print("Repo : " + IPSPOT_REPO)
 
 
 def get_private_ipv4() -> Dict[str, Union[bool, Dict[str, str], str]]:
@@ -27,14 +27,46 @@ def get_private_ipv4() -> Dict[str, Union[bool, Dict[str, str], str]]:
         return {"status": False, "error": str(e)}
 
 
-def _ipapi_ipv4(geo: bool=False) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:
+def _ipsb_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]]
+               =5) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:
+    """
+    Get public IP and geolocation using ip.sb.
+
+    :param geo: geolocation flag
+    :param timeout: timeout value for API
+    """
+    try:
+        response = requests.get("https://api.ip.sb/geoip", headers=REQUEST_HEADERS, timeout=timeout)
+        response.raise_for_status()
+        data = response.json()
+        result = {"status": True, "data": {"ip": data.get("ip"), "api": "ip.sb"}}
+        if geo:
+            geo_data = {
+                "city": data.get("city"),
+                "region": data.get("region"),
+                "country": data.get("country"),
+                "country_code": data.get("country_code"),
+                "latitude": data.get("latitude"),
+                "longitude": data.get("longitude"),
+                "organization": data.get("organization"),
+                "timezone": data.get("timezone")
+            }
+            result["data"].update(geo_data)
+        return result
+    except Exception as e:
+        return {"status": False, "error": str(e)}
+
+
+def _ipapi_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]]
+                =5) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:
     """
     Get public IP and geolocation using ip-api.com.
 
     :param geo: geolocation flag
+    :param timeout: timeout value for API
     """
     try:
-        response = requests.get("http://ip-api.com/json/", timeout=5)
+        response = requests.get("http://ip-api.com/json/", headers=REQUEST_HEADERS, timeout=timeout)
         response.raise_for_status()
         data = response.json()
 
@@ -58,14 +90,16 @@ def _ipapi_ipv4(geo: bool=False) -> Dict[str, Union[bool, Dict[str, Union[str, f
         return {"status": False, "error": str(e)}
 
 
-def _ipinfo_ipv4(geo: bool=False) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:
+def _ipinfo_ipv4(geo: bool=False, timeout: Union[float, Tuple[float, float]]
+                 =5) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:
     """
     Get public IP and geolocation using ipinfo.io.
 
     :param geo: geolocation flag
+    :param timeout: timeout value for API
     """
     try:
-        response = requests.get("https://ipinfo.io/json", timeout=5)
+        response = requests.get("https://ipinfo.io/json", headers=REQUEST_HEADERS, timeout=timeout)
         response.raise_for_status()
         data = response.json()
         result = {"status": True, "data": {"ip": data.get("ip"), "api": "ipinfo.io"}}
@@ -87,29 +121,31 @@ def _ipinfo_ipv4(geo: bool=False) -> Dict[str, Union[bool, Dict[str, Union[str,
         return {"status": False, "error": str(e)}
 
 
-def get_public_ipv4(api: IPv4API=IPv4API.AUTO,
-                    geo: bool=False) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:
+def get_public_ipv4(api: IPv4API=IPv4API.AUTO, geo: bool=False,
+                    timeout: Union[float, Tuple[float, float]]=5) -> Dict[str, Union[bool, Dict[str, Union[str, float]], str]]:
     """
     Get public IPv4 and geolocation info based on the selected API.
 
     :param api: public IPv4 API
     :param geo: geolocation flag
+    :param timeout: timeout value for API
     """
     api_map = {
         IPv4API.IPAPI: _ipapi_ipv4,
         IPv4API.IPINFO: _ipinfo_ipv4,
+        IPv4API.IPSB: _ipsb_ipv4
     }
 
     if api == IPv4API.AUTO:
         for _, func in api_map.items():
-            result = func(geo=geo)
+            result = func(geo=geo, timeout=timeout)
             if result["status"]:
                 return result
         return {"status": False, "error": "All attempts failed."}
     else:
         func = api_map.get(api)
         if func:
-            return func(geo=geo)
+            return func(geo=geo, timeout=timeout)
         return {"status": False, "error": "Unsupported API: {api}".format(api=api)}
 
 
@@ -126,12 +162,14 @@ def filter_parameter(parameter: Any) -> Any:
     return parameter
 
 
-def display_ip_info(ipv4_api: IPv4API = IPv4API.AUTO, geo: bool=False) -> None:
+def display_ip_info(ipv4_api: IPv4API = IPv4API.AUTO, geo: bool=False,
+                    timeout: Union[float, Tuple[float, float]]=5) -> None:  # pragma: no cover
     """
     Print collected IP and location data.
 
     :param ipv4_api: public IPv4 API
     :param geo: geolocation flag
+    :param timeout: timeout value for API
     """
     private_result = get_private_ipv4()
     print("Private IP:\n")
@@ -143,7 +181,7 @@ def display_ip_info(ipv4_api: IPv4API = IPv4API.AUTO, geo: bool=False) -> None:
         public_title += " and Location Info"
     public_title += ":\n"
     print(public_title)
-    public_result = get_public_ipv4(ipv4_api, geo=geo)
+    public_result = get_public_ipv4(ipv4_api, geo=geo, timeout=timeout)
     if public_result["status"]:
         for name, parameter in sorted(public_result["data"].items()):
             print(
@@ -154,7 +192,7 @@ def display_ip_info(ipv4_api: IPv4API = IPv4API.AUTO, geo: bool=False) -> None:
         print("  Error: {public_result[error]}".format(public_result=public_result))
 
 
-def main() -> None:
+def main() -> None:  # pragma: no cover
     """CLI main function."""
     parser = argparse.ArgumentParser()
     parser.add_argument(
@@ -167,6 +205,7 @@ def main() -> None:
     parser.add_argument('--info', help='info', nargs="?", const=1)
     parser.add_argument('--version', help='version', nargs="?", const=1)
     parser.add_argument('--no-geo', help='no geolocation data', nargs="?", const=1, default=False)
+    parser.add_argument('--timeout', help='timeout for the API request', type=float, default=5.0)
 
     args = parser.parse_args()
     if args.version:
@@ -176,4 +215,4 @@ def main() -> None:
     else:
         ipv4_api = IPv4API(args.ipv4_api)
         geo = not args.no_geo
-        display_ip_info(ipv4_api=ipv4_api, geo=geo)
+        display_ip_info(ipv4_api=ipv4_api, geo=geo, timeout=args.timeout)

{ipspot-0.1 → ipspot-0.2}/ipspot/params.py

@@ -2,7 +2,7 @@
 """ipspot params."""
 from enum import Enum
 
-IPSPOT_VERSION = "0.1"
+IPSPOT_VERSION = "0.2"
 
 IPSPOT_OVERVIEW = '''
 IPSpot is a Python library for retrieving the current system's IP address and location information.
@@ -10,7 +10,12 @@ It currently supports public and private IPv4 detection using multiple API provi
 Designed with simplicity and modularity in mind, IPSpot offers quick IP and geolocation lookups directly from your machine.
 '''
 
-IPSPOT_REPO = "Repo : https://github.com/openscilab/ipspot"
+IPSPOT_REPO = "https://github.com/openscilab/ipspot"
+
+REQUEST_HEADERS = {
+    'User-Agent': 'IPSpot/{version} ({repo})'.format(version=IPSPOT_VERSION, repo=IPSPOT_REPO),
+    'Accept': 'application/json'
+}
 
 
 class IPv4API(Enum):
@@ -19,6 +24,7 @@ class IPv4API(Enum):
     AUTO = "auto"
     IPAPI = "ipapi"
     IPINFO = "ipinfo"
+    IPSB = "ipsb"
 
 
 PARAMETERS_NAME_MAP = {

{ipspot-0.1 → ipspot-0.2}/ipspot.egg-info/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: ipspot
-Version: 0.1
+Version: 0.2
 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.1
+Download-URL: https://github.com/openscilab/ipspot/tarball/v0.2
 Author: IPSpot Development Team
 Author-email: ipspot@openscilab.com
 License: MIT
@@ -55,6 +55,7 @@ Dynamic: summary
 <a href="https://badge.fury.io/py/ipspot"><img src="https://badge.fury.io/py/ipspot.svg" alt="PyPI version"></a>
 <a href="https://www.python.org/"><img src="https://img.shields.io/badge/built%20with-Python3-green.svg" alt="built with Python3"></a>
 <a href="https://github.com/openscilab/ipspot"><img alt="GitHub repo size" src="https://img.shields.io/github/repo-size/openscilab/ipspot"></a>
+<a href="https://discord.gg/yyDV3T4cwU"><img src="https://img.shields.io/discord/1064533716615049236.svg" alt="Discord Channel"></a>
 </div>			
 				
 ## Overview	
@@ -89,17 +90,25 @@ Dynamic: summary
 	</tr>
 </table>
 
+<table>
+	<tr> 
+		<td align="center">Code Quality</td>
+		<td align="center"><a href="https://app.codacy.com/gh/openscilab/ipspot/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade"><img src="https://app.codacy.com/project/badge/Grade/cb2ab6584eb443b8a33da4d4252480bc"/></a></td>
+		<td align="center"><a href="https://www.codefactor.io/repository/github/openscilab/ipspot"><img src="https://www.codefactor.io/repository/github/openscilab/ipspot/badge" alt="CodeFactor"></a></td>
+	</tr>
+</table>
+
 
 ## Installation		
 
 ### Source Code
-- Download [Version 0.1](https://github.com/openscilab/ipspot/archive/v0.1.zip) or [Latest Source](https://github.com/openscilab/ipspot/archive/dev.zip)
+- Download [Version 0.2](https://github.com/openscilab/ipspot/archive/v0.2.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.1`						
+- `pip install ipspot==0.2`						
 
 
 ## Usage
@@ -112,7 +121,7 @@ Dynamic: summary
 >>> from ipspot import get_public_ipv4, IPv4API
 >>> get_public_ipv4(api=IPv4API.IPAPI)
 {'status': True, 'data': {'ip': 'xx.xx.xx.xx', 'api': 'ip-api.com'}}
->>> get_public_ipv4(api=IPv4API.IPAPI, geo=True)
+>>> get_public_ipv4(api=IPv4API.IPAPI, 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}
 ```
 
@@ -133,7 +142,7 @@ Dynamic: summary
 ```console
 > ipspot --version
 
-0.1
+0.2
 ```
 
 #### Info
@@ -148,11 +157,11 @@ Dynamic: summary
 |___||_|    |____/ | .__/  \___/  \__|
                    |_|
 
-__     __     ___      _
-\ \   / / _  / _ \    / |
- \ \ / / (_)| | | |   | |
-  \ V /   _ | |_| | _ | |
-   \_/   (_) \___/ (_)|_|
+__     __     ___      ____
+\ \   / / _  / _ \    |___ \
+ \ \ / / (_)| | | |     __) |
+  \ V /   _ | |_| | _  / __/
+   \_/   (_) \___/ (_)|_____|
 
 
 
@@ -188,7 +197,7 @@ Public IP and Location Info:
 
 #### IPv4 API
 
-ℹ️ `ipv4-api` valid choices: [`auto`, `ipapi`, `ipinfo`]
+ℹ️ `ipv4-api` valid choices: [`auto`, `ipapi`, `ipinfo`, `ipsb`]
 
 ℹ️ The default value: `auto`
 
@@ -231,7 +240,12 @@ Public IP:
 Just fill an issue and describe it. We'll check it ASAP!
 
 - Please complete the issue template
- 			
+
+You can also join our discord server
+
+<a href="https://discord.gg/yyDV3T4cwU">
+  <img src="https://img.shields.io/discord/1064533716615049236.svg?style=for-the-badge" alt="Discord Channel">
+</a>
 
 ## Show Your Support
 								
@@ -253,6 +267,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.2] - 2025-05-04
+### Added
+- Support [ip.sb](https://api.ip.sb/geoip)
+- `--timeout` argument
+### Changed
+- `README.md` updated
+- Requests header updated
+- Test system modified
 ## [0.1] - 2025-04-25
 ### Added
 - Support [ipinfo.io](https://ipinfo.io)
@@ -264,7 +286,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.1...dev
+[Unreleased]: https://github.com/openscilab/ipspot/compare/v0.2...dev
+[0.2]: https://github.com/openscilab/ipspot/compare/v0.1...v0.2
 [0.1]: https://github.com/openscilab/ipspot/compare/3216fb7...v0.1
 
 

{ipspot-0.1 → ipspot-0.2}/ipspot.egg-info/SOURCES.txt

@@ -16,4 +16,6 @@ ipspot.egg-info/SOURCES.txt
 ipspot.egg-info/dependency_links.txt
 ipspot.egg-info/entry_points.txt
 ipspot.egg-info/requires.txt
-ipspot.egg-info/top_level.txt
+ipspot.egg-info/top_level.txt
+tests/test_functions.py
+tests/test_ipv4.py

{ipspot-0.1 → ipspot-0.2}/setup.py

@@ -32,7 +32,7 @@ def read_description() -> str:
 setup(
     name='ipspot',
     packages=['ipspot'],
-    version='0.1',
+    version='0.2',
     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.1',
+    download_url='https://github.com/openscilab/ipspot/tarball/v0.2',
     keywords="ip ipv4 geo geolocation network location ipspot cli",
     project_urls={
         'Source': 'https://github.com/openscilab/ipspot'

ipspot-0.2/tests/test_functions.py

@@ -0,0 +1,24 @@
+from ipspot.functions import filter_parameter
+
+TEST_CASE_NAME = "Functions tests"
+
+
+def test_filter_parameter1():
+    assert filter_parameter(None) == "N/A"
+
+
+def test_filter_parameter2():
+    assert filter_parameter("") == "N/A"
+
+
+def test_filter_parameter3():
+    assert filter_parameter("   ") == "N/A"
+
+
+def test_filter_parameter4():
+    assert filter_parameter("GB") == "GB"
+
+
+
+
+

ipspot-0.2/tests/test_ipv4.py

@@ -0,0 +1,108 @@
+import re
+from unittest import mock
+from ipspot import get_private_ipv4
+from ipspot import get_public_ipv4, IPv4API
+
+TEST_CASE_NAME = "IPv4 tests"
+IPV4_REGEX = re.compile(r'^(?:[0-9]{1,3}\.){3}[0-9]{1,3}$')
+DATA_ITEMS = {'country_code', 'latitude', 'longitude', 'api', 'country', 'timezone', 'organization', 'region', 'ip', 'city'}
+
+
+def test_private_ipv4_success():
+    result = get_private_ipv4()
+    assert result["status"]
+    assert IPV4_REGEX.match(result["data"]["ip"])
+
+
+def test_private_ipv4_error():
+    with mock.patch("socket.gethostbyname", side_effect=Exception("Test error")):
+        result = get_private_ipv4()
+        assert not result["status"]
+        assert result["error"] == "Test error"
+
+
+def test_public_ipv4_auto_success():
+    result = get_public_ipv4(api=IPv4API.AUTO, geo=True)
+    assert result["status"]
+    assert IPV4_REGEX.match(result["data"]["ip"])
+    assert set(result["data"].keys()) == DATA_ITEMS
+
+
+def test_public_ipv4_auto_timeout_error():
+    result = get_public_ipv4(api=IPv4API.AUTO, geo=True, timeout="5")
+    assert not result["status"]
+
+
+def test_public_ipv4_auto_net_error():
+    with mock.patch("requests.get", side_effect=Exception("No Internet")):
+        result = get_public_ipv4(api=IPv4API.AUTO)
+        assert not result["status"]
+        assert result["error"] == "All attempts failed."
+
+
+def test_public_ipv4_ipapi_success():
+    result = get_public_ipv4(api=IPv4API.IPAPI, geo=True)
+    assert result["status"]
+    assert IPV4_REGEX.match(result["data"]["ip"])
+    assert set(result["data"].keys()) == DATA_ITEMS
+    assert result["data"]["api"] == "ip-api.com"
+
+
+def test_public_ipv4_ipapi_timeout_error():
+    result = get_public_ipv4(api=IPv4API.IPAPI, geo=True, timeout="5")
+    assert not result["status"]
+
+
+def test_public_ipv4_ipapi_net_error():
+    with mock.patch("requests.get", side_effect=Exception("No Internet")):
+        result = get_public_ipv4(api=IPv4API.IPAPI)
+        assert not result["status"]
+        assert result["error"] == "No Internet"
+
+
+def test_public_ipv4_ipinfo_success():
+    result = get_public_ipv4(api=IPv4API.IPINFO, geo=True)
+    assert result["status"]
+    assert IPV4_REGEX.match(result["data"]["ip"])
+    assert set(result["data"].keys()) == DATA_ITEMS
+    assert result["data"]["api"] == "ipinfo.io"
+
+
+def test_public_ipv4_ipinfo_timeout_error():
+    result = get_public_ipv4(api=IPv4API.IPINFO, geo=True, timeout="5")
+    assert not result["status"]
+
+
+def test_public_ipv4_ipinfo_net_error():
+    with mock.patch("requests.get", side_effect=Exception("No Internet")):
+        result = get_public_ipv4(api=IPv4API.IPINFO)
+        assert not result["status"]
+        assert result["error"] == "No Internet"
+
+
+def test_public_ipv4_ipsb_success():
+    result = get_public_ipv4(api=IPv4API.IPSB, geo=True)
+    assert result["status"]
+    assert IPV4_REGEX.match(result["data"]["ip"])
+    assert set(result["data"].keys()) == DATA_ITEMS
+    assert result["data"]["api"] == "ip.sb"
+
+
+def test_public_ipv4_ipsb_timeout_error():
+    result = get_public_ipv4(api=IPv4API.IPSB, geo=True, timeout="5")
+    assert not result["status"]
+
+
+
+def test_public_ipv4_ipsb_net_error():
+    with mock.patch("requests.get", side_effect=Exception("No Internet")):
+        result = get_public_ipv4(api=IPv4API.IPSB)
+        assert not result["status"]
+        assert result["error"] == "No Internet"
+
+
+def test_public_ipv4_api_error():
+    result = get_public_ipv4(api="api1", geo=True)
+    assert not result["status"]
+    assert result["error"] == "Unsupported API: api1"
+