Pixslim 1.0.0__tar.gz

pixslim-1.0.0/PKG-INFO

@@ -0,0 +1,115 @@
+Metadata-Version: 2.4
+Name: Pixslim
+Version: 1.0.0
+Summary: A lightweight Python package for compressing JPG, JPEG, and PNG images.
+Author: Fatemeh SHM
+License: MIT
+Keywords: image,compress,compression,jpg,jpeg,png,pillow
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: Pillow>=10.0.0
+
+# PixSlim
+
+**PixSlim** is a lightweight and easy-to-use Python package for compressing **JPG**, **JPEG**, and **PNG** images while trying to reach a target file size.
+
+## ✨ Features
+
+- 📦 Compress JPG, JPEG, and PNG images
+- 🎯 Target file size in KB
+- 🖼️ Automatically reduces image dimensions if needed
+- ⚡ Simple and beginner-friendly API
+- 🐍 Built with Pillow
+
+## Installation
+
+```bash
+pip install pixslim
+```
+
+## Requirements
+
+- Python 3.9+
+- Pillow
+
+## Usage
+
+```python
+from pixslim import Compressor
+
+compressor = Compressor(target_kb=500)
+
+result = compressor.compress(
+    "photo.png",
+    "photo_small.png"
+)
+
+print(result)
+```
+
+Example output:
+
+```python
+{
+    "original_kb": 1356.42,
+    "final_kb": 492.18,
+    "reduction_percent": 63.71,
+    "quality": None,
+    "size": (1920, 1080)
+}
+```
+
+## Supported Formats
+
+| Input | Output |
+|--------|--------|
+| JPG | JPG |
+| JPEG | JPEG |
+| PNG | PNG |
+
+## Parameters
+
+### Compressor(target_kb=500)
+
+| Parameter | Type | Description |
+|----------|------|-------------|
+| target_kb | int | Desired maximum file size in KB |
+
+### compress(input_file, output_file)
+
+| Parameter | Type | Description |
+|----------|------|-------------|
+| input_file | str | Input image path |
+| output_file | str | Output image path |
+
+## Example
+
+```python
+from pixslim import Compressor
+
+compressor = Compressor(target_kb=300)
+
+compressor.compress(
+    "image.jpg",
+    "image_small.jpg"
+)
+```
+
+## License
+
+This project is licensed under the MIT License.
+
+##Author
+
+**Fatemeh SHM**

pixslim-1.0.0/Pixslim/__init__.py

@@ -0,0 +1,3 @@
+from .compressor import compressor
+
+__version__="1.0.0"

pixslim-1.0.0/Pixslim/compressor.py

@@ -0,0 +1,88 @@
+from PIL import Image
+import os
+
+
+class compressor:
+    """Compress JPG, JPEG and PNG images.
+    🌼Reducing file size🌼"""
+
+    def __init__(self, target_kb=500):
+        self.target_kb = target_kb
+
+    def compress(self, input_file, output_file):
+        try:
+            image = Image.open(input_file)
+        except Exception as e:
+            raise ValueError(f"Cannot open image: {e}")
+
+        ext = os.path.splitext(output_file)[1].lower()
+
+        if ext not in (".jpg", ".jpeg", ".png"):
+            raise ValueError("Only JPG, JPEG and PNG files are supported.")
+
+        # JPEG باید RGB باشد
+        if ext in (".jpg", ".jpeg") and image.mode != "RGB":
+            image = image.convert("RGB")
+
+        original_kb = os.path.getsize(input_file) / 1024
+        quality = 95
+
+        while True:
+
+            if ext in (".jpg", ".jpeg"):
+                image.save(
+                    output_file,
+                    format="JPEG",
+                    optimize=True,
+                    quality=quality
+                )
+
+            else:  # PNG
+                image.save(
+                    output_file,
+                    format="PNG",
+                    optimize=True,
+                    compress_level=9
+                )
+
+            final_kb = os.path.getsize(output_file) / 1024
+
+            if final_kb <= self.target_kb:
+                break
+
+            # کاهش کیفیت فقط برای JPEG
+            if ext in (".jpg", ".jpeg") and quality > 20:
+                quality -= 5
+                continue
+
+            # اگر هنوز حجم زیاد بود، اندازه تصویر را کم کن
+            width, height = image.size
+
+            if width < 100 or height < 100:
+                break
+
+            image = image.resize(
+                (int(width * 0.9), int(height * 0.9)),
+                Image.Resampling.LANCZOS
+            )
+
+        reduction = (1 - final_kb / original_kb) * 100
+
+        return {
+            "original_kb": round(original_kb, 2),
+            "final_kb": round(final_kb, 2),
+            "reduction_percent": round(reduction, 2),
+            "quality": quality if ext in (".jpg", ".jpeg") else None,
+            "size": image.size
+        }
+
+if __name__ == "__main__":
+
+    compressor = compressor(target_kb=500)
+
+    result = compressor.compress(
+        r"C:\Users\Almahdi Laptop\OneDrive\Pictures\f.png",
+        r"C:\Users\Almahdi Laptop\OneDrive\Pictures\photo_small.png"
+    )
+
+    print(result)

pixslim-1.0.0/Pixslim.egg-info/PKG-INFO

@@ -0,0 +1,115 @@
+Metadata-Version: 2.4
+Name: Pixslim
+Version: 1.0.0
+Summary: A lightweight Python package for compressing JPG, JPEG, and PNG images.
+Author: Fatemeh SHM
+License: MIT
+Keywords: image,compress,compression,jpg,jpeg,png,pillow
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: Pillow>=10.0.0
+
+# PixSlim
+
+**PixSlim** is a lightweight and easy-to-use Python package for compressing **JPG**, **JPEG**, and **PNG** images while trying to reach a target file size.
+
+## ✨ Features
+
+- 📦 Compress JPG, JPEG, and PNG images
+- 🎯 Target file size in KB
+- 🖼️ Automatically reduces image dimensions if needed
+- ⚡ Simple and beginner-friendly API
+- 🐍 Built with Pillow
+
+## Installation
+
+```bash
+pip install pixslim
+```
+
+## Requirements
+
+- Python 3.9+
+- Pillow
+
+## Usage
+
+```python
+from pixslim import Compressor
+
+compressor = Compressor(target_kb=500)
+
+result = compressor.compress(
+    "photo.png",
+    "photo_small.png"
+)
+
+print(result)
+```
+
+Example output:
+
+```python
+{
+    "original_kb": 1356.42,
+    "final_kb": 492.18,
+    "reduction_percent": 63.71,
+    "quality": None,
+    "size": (1920, 1080)
+}
+```
+
+## Supported Formats
+
+| Input | Output |
+|--------|--------|
+| JPG | JPG |
+| JPEG | JPEG |
+| PNG | PNG |
+
+## Parameters
+
+### Compressor(target_kb=500)
+
+| Parameter | Type | Description |
+|----------|------|-------------|
+| target_kb | int | Desired maximum file size in KB |
+
+### compress(input_file, output_file)
+
+| Parameter | Type | Description |
+|----------|------|-------------|
+| input_file | str | Input image path |
+| output_file | str | Output image path |
+
+## Example
+
+```python
+from pixslim import Compressor
+
+compressor = Compressor(target_kb=300)
+
+compressor.compress(
+    "image.jpg",
+    "image_small.jpg"
+)
+```
+
+## License
+
+This project is licensed under the MIT License.
+
+##Author
+
+**Fatemeh SHM**

pixslim-1.0.0/Pixslim.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+pyproject.toml
+Pixslim/__init__.py
+Pixslim/compressor.py
+Pixslim.egg-info/PKG-INFO
+Pixslim.egg-info/SOURCES.txt
+Pixslim.egg-info/dependency_links.txt
+Pixslim.egg-info/requires.txt
+Pixslim.egg-info/top_level.txt

pixslim-1.0.0/Pixslim.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pixslim-1.0.0/Pixslim.egg-info/requires.txt

@@ -0,0 +1 @@
+Pillow>=10.0.0

pixslim-1.0.0/Pixslim.egg-info/top_level.txt

@@ -0,0 +1 @@
+Pixslim

pixslim-1.0.0/README.md

@@ -0,0 +1,93 @@
+# PixSlim
+
+**PixSlim** is a lightweight and easy-to-use Python package for compressing **JPG**, **JPEG**, and **PNG** images while trying to reach a target file size.
+
+## ✨ Features
+
+- 📦 Compress JPG, JPEG, and PNG images
+- 🎯 Target file size in KB
+- 🖼️ Automatically reduces image dimensions if needed
+- ⚡ Simple and beginner-friendly API
+- 🐍 Built with Pillow
+
+## Installation
+
+```bash
+pip install pixslim
+```
+
+## Requirements
+
+- Python 3.9+
+- Pillow
+
+## Usage
+
+```python
+from pixslim import Compressor
+
+compressor = Compressor(target_kb=500)
+
+result = compressor.compress(
+    "photo.png",
+    "photo_small.png"
+)
+
+print(result)
+```
+
+Example output:
+
+```python
+{
+    "original_kb": 1356.42,
+    "final_kb": 492.18,
+    "reduction_percent": 63.71,
+    "quality": None,
+    "size": (1920, 1080)
+}
+```
+
+## Supported Formats
+
+| Input | Output |
+|--------|--------|
+| JPG | JPG |
+| JPEG | JPEG |
+| PNG | PNG |
+
+## Parameters
+
+### Compressor(target_kb=500)
+
+| Parameter | Type | Description |
+|----------|------|-------------|
+| target_kb | int | Desired maximum file size in KB |
+
+### compress(input_file, output_file)
+
+| Parameter | Type | Description |
+|----------|------|-------------|
+| input_file | str | Input image path |
+| output_file | str | Output image path |
+
+## Example
+
+```python
+from pixslim import Compressor
+
+compressor = Compressor(target_kb=300)
+
+compressor.compress(
+    "image.jpg",
+    "image_small.jpg"
+)
+```
+
+## License
+
+This project is licensed under the MIT License.
+
+##Author
+
+**Fatemeh SHM**

pixslim-1.0.0/pyproject.toml

@@ -0,0 +1,46 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "Pixslim"
+version = "1.0.0"
+description = "A lightweight Python package for compressing JPG, JPEG, and PNG images."
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+
+authors = [
+    { name = "Fatemeh SHM" }
+]
+
+keywords = [
+    "image",
+    "compress",
+    "compression",
+    "jpg",
+    "jpeg",
+    "png",
+    "pillow"
+]
+
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Operating System :: OS Independent",
+    "Topic :: Multimedia :: Graphics",
+    "Topic :: Software Development :: Libraries :: Python Modules"
+]
+
+dependencies = [
+    "Pillow>=10.0.0"
+]
+
+[tool.setuptools.packages.find]
+include = ["Pixslim"]

pixslim-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+