FindMyIP 2.0.1

Find your IP address (both internal and external) or check your connection state.

Find My IP

Find My IP is a user-friendly Python package that helps you find both your internal (local) and external IP addresses. It also lets you check your internet connection status effortlessly. By importing FindMyIP into your script, you can easily retrieve your IP addresses and quickly determine if your internet is connected. It's a simple and convenient tool for developers to use in their projects.

Installing

To get started with Find My IP, you have two options for installation:

1. Download from GitHub: You can download the module directly from the GitHub repository.

2. Install with pip: Alternatively, you can use pip to install the package effortlessly. Open your terminal or command prompt and run the following command:

pip install FindMyIP

With just a simple installation step, you'll be ready to utilize Find My IP in your Python projects!

How to use

Using Find My IP is straightforward. Here's a step-by-step guide to help you get started:

• Import the module and create an instance::

  from FindMyIP import FindMyIP
  
  ip_finder = FindMyIP()
  

• Check Internet Connection Status: To determine if your internet is connected or disconnected, use the internet() method:

  >>> print(ip_finder.internet())
  
  # Output:
    # True  # If the internet is connected.
    # False # If the internet is disconnected.
  

• Retrieve Local IP Address: To find your local (internal) IP address, use the internal() method:

  >>> local_ip = ip_finder.internal()
  >>> print(local_ip)
  
  # Output: 192.168.1.102 (Example value)
  

• Retrieve External IP Address: To get your external IP address, use the external() method:

  >>> real_ip = ip_finder.external()
  >>> print(real_ip)
  
  # Output:
    # 82.212.251.142  # When connected to the internet
    # None            # When not connected to the internet
  

Logging:

Find My IP uses logging to provide useful debugging information. If an error occurs (e.g., no internet connection), it will be logged automatically.

With these simple steps, you can easily find your IP addresses and check your internet connection status using the Find My IP package in your Python projects. Happy coding!

Change Log:

We're continuously improving Find My IP to ensure the best experience. Here's a summary of the recent updates:

• v 1.1.0:

  • Initial Release

• v 1.2.0:

  • Minor bug fixed
    • Addressed a false positive issue in the internet function.
  • Improved code documentation
    • Added more comments to enhance code readability and understanding.

• v 2.0.0:

  • Recoding as a class
  • Improve error handling
  • Get errors as log

Stay tuned for more updates as we continue to enhance Find My IP to meet your needs!