Skip to main content

A module to handle different formats of image input

Project description

Image Input Handler

image-input-handler is a versatile Python package designed to simplify the handling of various image inputs. It supports images from multiple sources including file paths, URLs, and base64 encoded strings. It adjusts image channels according to user needs and includes functionality for checking compatibility and enabling debug mode, making it an essential tool for projects involving image processing.


  • Handle images from URLs, file paths, and base64 strings.
  • Automatic adjustment of image channels.
  • Support for image masks.
  • Compatibility checks to ensure image inputs can be processed.
  • Debug mode for detailed operational logging, aiding in troubleshooting and development.
  • Easy integration with popular libraries such as NumPy, OpenCV, and PIL.


Install image-input-handler using pip:

bash pip install image-input-handler


Below is a basic example of how to use image-input-handler:

from image_input_handler import UniversalImageInputHandler

# Initialize the handler with a local file path, enabling debug mode
handler = UniversalImageInputHandler('path/to/your/image.png', debug=True)

# For URL based images
url_handler = UniversalImageInputHandler('')

# For base64 encoded images
base64_handler = UniversalImageInputHandler('base64_encoded_string_here', img_is_a_mask=True)

# Access the processed image
processed_image = handler.img

# Check if the image is compatible
if handler.COMPATIBLE:
    print("The image is compatible.")
    print("The image is not compatible.")

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

image_input_handler-0.4.0.tar.gz (4.1 kB view hashes)

Uploaded Source

Built Distribution

image_input_handler-0.4.0-py3-none-any.whl (4.0 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page