๐ธ SnapForge
Forge your images with a single chain of commands.
A lightweight, fast and intuitive Python library for image processing built on top of Pillow.
Perfect for compressing, resizing, filtering, enhancing and transforming images .
โจ Features
- ๐ผ๏ธ Load and create images
- ๐ Resize and transform images
- ๐ Advanced format conversion
- ๐จ Image mode conversion
- ๐พ Save and optimize images
- ๐ช Image effects
- ๐งฉ Image overlays
- ๐ Image inspection
- ๐ Update checking
- ๐ Chainable API design
- ๐งพ MIT License
๐ Professional Format Converter ๐
The convert method (Storage.convert) Supports more than 8 Formats : JPEG, JPG , PNG, WEBP, GIF, TIFF, BMP, ICO, Gif and etc.
SnapForge supports common Pillow modes such as:
RGBRGBALLAPCMYK1
๐ฆ Installation
You can install SnapForge directly from PyPI using pip:
pip install snapforge
or if you have already installed it :
pip install snapforge --upgarde
๐ Quick Start
Here is a quick example to get you started with SnapForge:
from snapforge import Storage,Geometry,SnapForgeUpdater
version="your_version"
updater = SnapForgeUpdater("snapforge",version)
updater.start_check()
# complete image path
img=Storage.load(r"...\my_image.jpeg")
img=Storage.convert_mode(img,"RGB")
img=Geometry.round_corners(img,40)
img=Storage.convert(img,"png")
img=Storage.save(img,r"...\my_rounded_image.png")
๐ Available Modules
SnapForge is now fully modular ๐ง โ each module has a single responsibility and can be imported independently:
from snapforge import Storage, Geometry, Effects, Overlays, Inspector, SnapForgeUpdater
- ๐ Geometry โ resizing, cropping, rotating and transforming
- ๐พ Storage โ loading, saving and format conversion
- ๐ Inspector โ metadata, histogram and color analysis
- ๐จ Effects โ lighting and filters
- ๐ผ๏ธ Overlays โ text, watermark, borders and blending
- ๐ SnapForgeUpdater โ update checks and version comparison
๐ฆ Available Methods
Here is the complete list of all available methods in each snapforge module:
๐ Geometry
| Method | Description | Example |
|---|---|---|
Geometry.resize(img, w, h) |
Change image dimensions | Geometry.resize(img, 800, 600) |
Geometry.thumbnail(img, w, h) |
Resize while keeping aspect ratio | Geometry.thumbnail(img, 500, 500) |
Geometry.fit(img, w, h) |
Resize and crop to exact dimensions | Geometry.fit(img, 1080, 1080) |
Geometry.crop(img, l, t, r, b) |
Crop image | Geometry.crop(img, 0, 0, 100, 100) |
Geometry.rotate(img, a) |
Rotate image | Geometry.rotate(img, 90) |
Geometry.flip(img, dir) |
Flip image | Geometry.flip(img, "horizontal") |
Geometry.round_corners(img, radius) |
Round image corners | Geometry.round_corners(img, 40) |
๐พ Storage
| Method | Description | Example |
|---|---|---|
Storage.load(path) |
Load image from file | Storage.load("photo.jpg") |
Storage.save(img, name) |
Save image | Storage.save(img, "result.jpg") |
Storage.convert(img, fmt) |
Change image format (PNG, JPG, WEBPโฆ) | Storage.convert(img, "PNG") |
Storage.optimize(img, q) |
Set JPEG quality | Storage.optimize(img, 85) |
Storage.convert_mode(img, q) |
Set JPEG quality | Storage.optimize(img, 85) |
๐ Inspector
| Method | Description | Example |
|---|---|---|
Inspector.get_metadata(img) |
Extract detailed image metadata | Inspector.get_metadata(img) |
Inspector.histogram(img) |
Generate histogram data | Inspector.histogram(img) |
Inspector.compare(img) |
Display metadata and processing summary | Inspector.compare(img) |
Inspector.extract_color_palette(img) |
Get dominant colors as Hex codes | Inspector.extract_color_palette(img) |
๐จ Effects (Lighting & Filters)
| Method | Description | Example |
|---|---|---|
Effects.apply_brightness(img, f) |
Adjust brightness | Effects.apply_brightness(img, 1.2) |
Effects.apply_contrast(img, f) |
Adjust contrast | Effects.apply_contrast(img, 1.5) |
Effects.auto_enhance(img) |
Improve brightness, contrast and sharpness | Effects.auto_enhance(img) |
Effects.invert(img) |
Invert image colors | Effects.invert(img) |
Effects.apply_sepia(img) |
Classic sepia effect | Effects.apply_sepia(img) |
Effects.apply_grayscale(img, f) |
Convert to grayscale | Effects.apply_grayscale(img, 1.0) |
Effects.apply_blur(img, r) |
Gaussian blur | Effects.apply_blur(img, 5.0) |
Effects.apply_sharpen(img, f) |
Sharpen image | Effects.apply_sharpen(img, 1.0) |
Effects.apply_camscanner(img) |
Document scanner effect | Effects.apply_camscanner(img) |
Effects.apply_preset(img, name) |
Apply a professional preset | Effects.apply_preset(img, "vintage") |
Supported presets (Effects.apply_preset):
vintage, cinematic, vibrant, dreamy, noir, warm,, cool
๐ผ๏ธ Overlays
| Method | Description | Example |
|---|---|---|
Overlays.add_watermark(img, path) |
Add watermark | Overlays.add_watermark(img, "logo.png") |
Overlays.add_text(img, text, pos) |
Draw text | Overlays.add_text(img, "Hello!", (50, 50)) |
Overlays.add_border(img, size, color) |
Add border | Overlays.add_border(img, 10, (0, 0, 0)) |
Overlays.double_exposure(img, img2, mode) |
Blend with another image | Overlays.double_exposure(img, "layer.png", "blend") |
๐ SnapForgeUpdater
| Method | Description | Example |
|---|---|---|
SnapForgeUpdater.__init__(package_name, current_version) |
Initialize the updater with the package name and current version | SnapForgeUpdater("snapforge", "3.0.0") |
To check updates run : updater = SnapForgeUpdater("snapforge", your_version) updater.start_check()
๐ ๏ธ Requirements
To use SnapForge, ensure you have the following installed:
- Python: 3.14 or higher
- Dependencies:
Pillow(for image processing)requests(for automatic update checks)packaging(for version comparison logic)
๐ค 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.
๐ More Projects
If you enjoy SnapForge, you might also like these projects ,too:
PixSlim
A Python image ,pdf , word and ... compression library focused on reducing file size while preserving quality.
turtle_shape
The Turtle_Shape library provides ready-made shapes and tools for creating graphics and drawings with Python's Turtle module.
๐ License
Distributed under the MIT License.
โค๏ธ Support
If you find SnapForge useful, your support means a lot!
You can help by:
- ๐ฆ Installing the package and trying it in your projects
- ๐ Sharing feedback and suggestions
- ๐ Reporting bugs and improvements
- ๐ Recommending SnapForge to other Python developers
๐งฉ Every piece of feedback helps make SnapForge better. ๐
๐ค Author
Ali.Shm
Email: fereshteshokoohi1990@gmail.com
Project Maintainer
1 maintainer
Metadata
1 maintainer
Release files for snapforge 3.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| snapforge-3.1.0-cp314-cp314-win_amd64.whl | CPython 3.14 | CPython 3.14 | Windows x86-64 | Details |
Release files / snapforge-3.1.0-cp314-cp314-win_amd64.whl
| Download URL | snapforge-3.1.0-cp314-cp314-win_amd64.whl |
|---|---|
| Size | 201.5 kB |
| Tags | CPython 3.14 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
c501bb76a1ecd7bf646b5054d91d8a71b68d51a787bd3c90d7e7567917c2b940
|
|
BLAKE2b-256 checksum How to use checksums |
fba53e716c4b9376c372297f49055c05eba95c2179cc1c1f5cff4669a86db81d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
Security for snapforge 3.1.0
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.
