imgcmprs 0.1.0__py3-none-any.whl → 0.1.1__py3-none-any.whl

imgcmprs-0.1.1.dist-info/METADATA

@@ -0,0 +1,110 @@
+Metadata-Version: 2.4
+Name: imgcmprs
+Version: 0.1.1
+Summary: Fast, safe CLI to compress JPEG & PNG, lossless/lossy, batch or single images.
+Author: Eyad Mohammed
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: Pillow
+Dynamic: author
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# img
+
+A fast, easy-to-use Python CLI tool for compressing JPEG and PNG images with both lossless and lossy modes.
+
+---
+
+## Features
+- Compresses images individually or in bulk (folders)
+- Supports JPEG and PNG
+- **Lossless mode** (`-l`): Optimizes files without visible quality loss
+- **Lossy mode** (`-q`): Reduce file size by lowering image quality
+- Recursive directory support
+- Custom output folder
+- Prompts to delete originals after compression
+- Skips replacement if compressed file is larger
+- Cross-platform, requires Python 3.7+
+
+---
+
+## Installation
+
+1. Install Python 3.7+
+2. Clone this repo and install:
+   ```bash
+   pip install -e .
+   # Or for user-local install:
+   pip install --user .
+   ```
+
+---
+
+## Usage
+
+### Compress a single image (lossy, 60% quality):
+
+```bash
+img -i myphoto.jpg -q 60
+```
+
+### Compress a folder (lossless, best for PNG):
+
+```bash
+img -i images/ -o optimized/ -l -r
+```
+
+### Options (Single-letter flags)
+| Flag | Meaning                        | Example                   |
+|------|--------------------------------|---------------------------|
+| -i   | Input file or folder (required)| `-i mypic.jpg`            |
+| -o   | Output file or folder (optional)| `-o compressed/`         |
+| -q   | JPEG quality (default 60; ignored in lossless mode)| `-q 80` |
+| -l   | Use lossless compression       | `-l`                      |
+| -r   | Recursively process folders    | `-r`                      |
+
+- All flags are **single-letter** for speed and ease: `-i`, `-o`, `-q`, `-l`, `-r`.
+- After compressing, you will be **prompted to delete the original files**.
+- If the compressed file is larger, the original is kept and a warning is printed.
+
+---
+
+## Requirements
+- Python 3.7+
+- Pillow (`pip install Pillow`)
+
+---
+
+## Notes
+- Lossless for PNG is truly lossless; for JPEG, uses `quality=100` with optimizations (minor effect but no further visual loss).
+- Output defaults to `_compressed` directory if not specified for folders.
+- Re-run with `-l` to optimize previously compressed images further (if possible).
+
+---
+
+## Publishing to PyPI
+
+1. **Ensure you have an account on [PyPI](https://pypi.org/).**
+2. **Install required tools:**
+    ```bash
+    pip install build twine
+    ```
+3. **Build your package:**
+    ```bash
+    python -m build
+    ```
+    This creates a `dist/` folder with your distributable files (tar.gz and .whl).
+4. **Upload to PyPI:**
+    ```bash
+    python -m twine upload dist/*
+    ```
+5. **Enter your PyPI credentials when prompted.**
+
+---
+
+## License
+MIT

imgcmprs-0.1.1.dist-info/RECORD

@@ -0,0 +1,8 @@
+imgcmprs/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+imgcmprs/__main__.py,sha256=Eisst5VBCByPJapyMDtOUk5acdHYHZCDLeX2hPYSvYA,74
+imgcmprs/img_compress.py,sha256=Cf85lESgNvA_04bZRDbWnY19MRMuf9Ut1QphiDNJP_g,7840
+imgcmprs-0.1.1.dist-info/METADATA,sha256=-nxlCeUg_TM8UyssixS9Fq911MbTsIV5tF54yyuRge4,3019
+imgcmprs-0.1.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+imgcmprs-0.1.1.dist-info/entry_points.txt,sha256=YjgihZeWdWEFCxM9YNipeRN89ZQSzzX-ug2Vih-5Qi4,51
+imgcmprs-0.1.1.dist-info/top_level.txt,sha256=_XIlYusRXoBCj1vxMvtaSgG9ZAVM1-7C1SQCJQ1GFKU,9
+imgcmprs-0.1.1.dist-info/RECORD,,

imgcmprs-0.1.0.dist-info/METADATA

@@ -1,11 +0,0 @@
-Metadata-Version: 2.4
-Name: imgcmprs
-Version: 0.1.0
-Summary: A CLI tool for compressing images (JPEG, PNG)
-Author: Your Name
-Requires-Python: >=3.7
-Requires-Dist: Pillow
-Dynamic: author
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary

imgcmprs-0.1.0.dist-info/RECORD

@@ -1,8 +0,0 @@
-imgcmprs/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-imgcmprs/__main__.py,sha256=Eisst5VBCByPJapyMDtOUk5acdHYHZCDLeX2hPYSvYA,74
-imgcmprs/img_compress.py,sha256=Cf85lESgNvA_04bZRDbWnY19MRMuf9Ut1QphiDNJP_g,7840
-imgcmprs-0.1.0.dist-info/METADATA,sha256=9JpKytDWbdNjerobZlTwCKjZCGlAf3cOrFDUB1j9jME,262
-imgcmprs-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-imgcmprs-0.1.0.dist-info/entry_points.txt,sha256=YjgihZeWdWEFCxM9YNipeRN89ZQSzzX-ug2Vih-5Qi4,51
-imgcmprs-0.1.0.dist-info/top_level.txt,sha256=_XIlYusRXoBCj1vxMvtaSgG9ZAVM1-7C1SQCJQ1GFKU,9
-imgcmprs-0.1.0.dist-info/RECORD,,