Skip to main content

📸 SnapForge

PyPI version License: MIT Python Versions

SnapForge is a lightweight, fast, and intuitive Python library designed for easy image processing tasks. Whether you need to resize, convert, or manipulate images, SnapForge makes it a breeze!

✨ Features

  • 🚀 Fast & Lightweight: Minimal overhead for quick image tasks.
  • 🔄 Format Conversion: Easily switch between JPEG, PNG, BMP, and more.
  • 📏 Smart Resizing: High-quality scaling and resizing capabilities.
  • 🛠️ Easy API: Designed with developer experience in mind—simple commands for complex tasks.
  • 🐍 Pythonic: Follows Python's best practices for a seamless integration.

📦 Installation

You can install SnapForge directly from PyPI using pip:

pip install snapforge


🚀 Quick Start

Here is a quick example to get you started with SnapForge:

import snapforge

# Load an image
img = snapforge.Snapforge("example.jpg")

# Resize the image
resized_img = img.resize(800,600)

# Convert and save the image
resized_img.convert("PNG").save("example_resized.png")

print("Image processed successfully!")

🧾 Feature Showcase (Full Reference)


Here is the complete list of all available methods in SnapForge:

Category	Method	          Description	                              Example
Core	.convert(fmt)	      Change image format (e.g., PNG, JPG)	      .convert("PNG")
	    .resize(w, h)	      Change image dimensions	                  .resize(800, 600)
	     .optimize(q)	      Set compression quality (1-100)	          .optimize(85)
	     .save(name)	      Save the final forged image	              .save("result.jpg")
Lighting .apply_brightness(f) Adjust brightness(factor > 1.0 is brighter) .apply_brightness(1.2)
	     .apply_contrast(f)	  Adjust contrast(factor > 1.0 is higher)     .apply_contrast(1.5)
Filters	 .apply_sepia()	      Apply a classic vintage sepia effect        .apply_sepia()
	     .apply_grayscale(f)  Convert to black & white (0.0 to 1.0)       .apply_grayscale(1.0)
	     .apply_blur(r)	      Apply Gaussian blur with radius r	          .apply_blur(5.0)
	     .apply_sharpen()	  Enhance image sharpness/clarity	          .apply_sharpen()
Extras	 .add_watermark(p)	  Add a watermark image at a position	      .add_watermark("logo.png")


🛠️ Requirements

    Python: 3.7 or higher
    Dependencies: Pillow

🤝 Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

📜 License

Distributed under the MIT License.

👤 Author

Ali.Shm
Project Maintainer

Metadata

Release files for snapforge 0.2.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for snapforge 0.2.1
File Size Uploaded Provenance
snapforge-0.2.1.tar.gz 4.4 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for snapforge 0.2.1
File Interpreter ABI Platform
snapforge-0.2.1-py3-none-any.whl Python 3 none any Details

Total release size: 9.1 kB

Release files / snapforge-0.2.1.tar.gz

Download URL snapforge-0.2.1.tar.gz
Size 4.4 kB
Tags Source
SHA-256 checksum
How to use checksums
d754f6e7eb0cd88bb405aba8955ba38fbfa5dc36a85d387f67f65a3b9aaca14d
BLAKE2b-256 checksum
How to use checksums
04c16905d6bf7378960cdc1f8c8c6d7a39742715e7f107248447c767feace0ca
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.3

Release files / snapforge-0.2.1-py3-none-any.whl

Download URL snapforge-0.2.1-py3-none-any.whl
Size 4.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
51c14ed98128fc1582556746b29960cf964f76294aba1ff6f029e9f72b4a92f3
BLAKE2b-256 checksum
How to use checksums
300601a4192f3ebf1f85c6a800b931ddb50398de2a20396de1868c08d9c83830
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.3

Security for snapforge 0.2.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page