softcropper 0.1.8

Resize and blur-pad photos to square format for photos

SoftCropper

SoftCropper is a Python tool that automatically resizes rectangular images into squares and adds soft, blurred borders — ideal for prepping images for print or display.

This package is part of the internal tools used at CanvasMagnet for order preparation and production automation.

---

---

📸 Example Results

Before	➡️	After
Baby.webp (600×900)		Output (900×900)
Kid.jpg (1100×733)		Output (1100×1100)

---

🚀 Features

• Pads any image to a perfect square
• Fills padding using soft Gaussian blur from original image
• Automatically saves output in a separate folder

---

📦 Requirements

• Python >= 3.7
• opencv-python
• numpy

🔧 Installation

pip install softcropper

⚙️ Usage

softcropper ./path/input_photos ./path/output_ready --mode blur

• input_photos: folder with png, jpg, jpeg, or webp files
• output_photos: optional (defaults to ./input_photos/output/)
• modes: blur, solid, gradient

✅ Testing

PYTEST_DISABLE_PLUGIN_AUTOLOAD=1 pytest tests/test_softcropper.py -v

📄 Changelog

✨ CHANGELOG.md

🛠️ Makefile Commands

make venv         # create .venv
make install      # install in editable mode
make test         # run unit/integration tests
make build        # build for PyPI
make clean        # remove all build artifacts and caches

🤝 Contribution

Pull requests are welcome! If you'd like to suggest improvements or fix issues, feel free to fork and submit.

Author

Khaled Alam

📧 [e-mail]
🌍 Website | LinkedIn | X(Twitter)