icoft 0.4.0__tar.gz

icoft-0.4.0/.github/workflows/publish.yml

@@ -0,0 +1,30 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/icoft
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.x"
+
+      - name: Install build tools
+        run: pip install --upgrade build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

icoft-0.4.0/.gitignore

@@ -0,0 +1,62 @@
+# macOS
+.DS_Store
+._*
+.AppleDouble
+.LSOverride
+
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# IDE and editor files
+.venv
+.ruff_cache
+.lingma/
+.trae/
+.vscode/
+pyrightconfig.json
+
+# Test scripts and temporary files
+scripts/
+test_*.png
+test_*.jpg
+
+# Example files
+examples/
+*.py[cod]
+*$py.class
+*.so
+.Python
+develop-eggs/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.nox/
+.hypothesis/
+*.cover
+*.pyc
+*.pyo
+*.pyd
+*~
+.venv/
+venv/
+ENV/
+env/
+.env/

icoft-0.4.0/.python-version

@@ -0,0 +1 @@
+3.10

icoft-0.4.0/CHANGELOG.md

@@ -0,0 +1,150 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.4.0] - 2026-04-14
+
+### Removed
+- RMBG-1.4 model support (removed due to quality issues)
+- CLI options: `--ai-model`, `--ai-threshold`, `--ai-denoise`, `--hole-fill`, `--hole-fill-threshold`
+- All RMBG-related test scripts in `scripts/` directory
+
+### Changed
+- Simplified AI background removal to use only U²-Net model
+- Improved CLI help text organization (alphabetical order for options)
+- Removed step numbers from processing output
+- Updated command description to mention `-o` option for intermediate output
+
+## [0.3.3] - 2026-04-14
+
+### Removed
+- Unused dependencies: `opencv-python`, `scipy`, `scikit-image`
+- These were legacy dependencies from previous watermark removal algorithm
+
+### Changed
+- Streamlined dependency tree for faster installation and smaller package size
+
+## [0.3.2] - 2026-04-14
+
+### Fixed
+- Fix linter warnings for unused cairosvg imports
+- Use `importlib.util.find_spec()` for module availability checks
+- Add None check for cairosvg.svg2png return value
+- Fix import ordering in generator.py
+
+## [0.3.1] - 2026-04-13
+
+### Fixed
+- Use source filename for output files instead of hardcoded names (e.g., `cogist17.svg` instead of `04_vectorized.svg`)
+- Replace `open()` with `Path.open()` (PTH123)
+- Add `strict=True` to `zip()` calls (B905)
+- Fix type checking issues (crop_margin None type, vtracer imports)
+
+### Removed
+- Unused `import struct` in generator.py
+
+## [0.3.0] - 2026-04-12
+
+### Added
+- Full Windows 10/11 ICO support (8 sizes: 16-256px with PNG compression)
+- Complete macOS Retina ICNS support (10 PNG sizes + ICNS container)
+- Official Linux hicolor specification compliance (8 sizes + SVG)
+- Single file output mode (`-o png` / `-o svg`)
+- Platform names in `--platforms` help text
+- Clear error messages for missing arguments
+
+### Changed
+- Linux icon sizes to official hicolor spec (removed Android sizes, added 256px)
+- Output directory structure documentation with complete file listing
+- `--output` help text to clarify directory vs single file modes
+- CLI examples to use short parameter `-o`
+
+### Removed
+- Complex watermark removal algorithm (`HybridWatermarkRemover`)
+- `-T/--noise-threshold` parameter (smart cutout)
+- `denoise()` method and OpenCV dependency for watermark removal
+- Unrealistic v0.3 roadmap items (batch processing, config files)
+
+### Fixed
+- Windows ICO generation (Pillow bug - manual implementation)
+- macOS ICNS generation (manual implementation with OSType codes)
+- Missing 256px size in Linux icon set
+- Unclear platform parameter names
+- Added `--output=svg` option to save processing result as single SVG
+- Updated CLI help and documentation with new output parameter design
+
+### Removed
+- `-i, --icon` parameter (replaced by `--output=icon`)
+- `-c, --crop` parameter (use `-m/--crop-margin` with explicit value)
+- `-u, --cutout` parameter (functionality merged into noise removal workflow)
+- `-I, --output-intermediate` parameter (redundant with `--output=png`)
+- `--preset` parameter (users can combine parameters directly)
+
+### Fixed
+- Default behavior now correctly generates icons when no parameters specified
+- Parameter logic simplified: configuration parameters auto-enable corresponding steps
+
+## [0.2.0] - 2026-04-12
+
+### Added
+- Unix-style CLI parameter design with composable short options (`-c`, `-u`, `-t`, `-s`, `-i`)
+- Step control parameters:
+  - `-c, --crop`: Crop borders
+  - `-u, --cutout`: Smart cutout to extract subject
+  - `-t, --transparent`: Make background transparent
+  - `-s, --svg`: Vectorize PNG to SVG
+  - `-i, --icon`: Generate platform icons (default)
+- Configuration parameters with auto-enable:
+  - `-m, --crop-margin`: Custom crop margin (default: 5%)
+  - `-T, --cutout-threshold`: Smart cutout sensitivity (0-255, default: 30)
+  - `-B, --bg-threshold`: Background removal tolerance (0-255, default: 10)
+  - `-S, --svg-speckle`: Filter SVG noise (default: 10)
+  - `-P, --svg-precision`: SVG color precision (default: 6)
+- Preset configurations: `--preset=minimal|standard|full|icon`
+- Intermediate output option: `-I, --output-intermediate`
+- Vectorization support with vtracer library
+- SVG background rendering with CairoSVG
+
+### Changed
+- **Breaking**: CLI parameter order changed to Unix convention (options first)
+- Removed `--mode` parameter (replaced by step parameter combinations)
+- Default output behavior: last step determines output type
+- Improved edge artifact removal in smart cutout (erosion for both dark and light backgrounds)
+- Removed Gaussian blur from watermark removal to improve vectorization quality
+
+### Removed
+- `--smooth-edges` option (redundant with vectorization)
+- `smooth_edges()` method from processor
+- Redundant anti-aliasing code
+
+### Fixed
+- Edge artifacts in smart cutout for light backgrounds
+- Black dots in vectorized output (adjusted filter_speckle to 10)
+- SVG background rectangle insertion order
+
+## [0.1.0] - 2026-04-11
+
+### Added
+- Initial release
+- Core image processing:
+  - Automatic border cropping
+  - Background to transparent conversion
+  - Smart cutout (HybridWatermarkRemover algorithm)
+- Multi-platform icon generation:
+  - Windows: `.ico` file (16-256 px)
+  - macOS: `.icns` + `icon_512x512.png`
+  - Linux: PNG icon set (hicolor theme) + SVG
+  - Web: favicon, PWA icons, manifest.json
+- CLI interface with Click and Rich
+- Configuration options: `--margin`, `--platforms`, `--no-crop`, `--no-transparent`
+- Comprehensive test suite (23 tests)
+- Documentation: README.md, project status, design philosophy
+
+[Unreleased]: https://github.com/hexin/icoft/compare/v0.2.2-dev...HEAD
+[0.2.2-dev]: https://github.com/hexin/icoft/compare/v0.2.1-dev...v0.2.2-dev
+[0.2.1-dev]: https://github.com/hexin/icoft/compare/v0.2.0...v0.2.1-dev
+[0.2.0]: https://github.com/hexin/icoft/compare/v0.1.0...v0.2.0
+[0.1.0]: https://github.com/hexin/icoft/releases/tag/v0.1.0

icoft-0.4.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Icoft
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

icoft-0.4.0/PKG-INFO

@@ -0,0 +1,285 @@
+Metadata-Version: 2.4
+Name: icoft
+Version: 0.4.0
+Summary: From AI Logo to Full-Platform App Icons - CLI Tool
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: click>=8.1.0
+Requires-Dist: numpy>=1.24.0
+Requires-Dist: onnxruntime>=1.19.0
+Requires-Dist: pillow>=10.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: vtracer>=0.6.0
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
+Requires-Dist: pytest>=7.4.0; extra == 'dev'
+Provides-Extra: vector
+Requires-Dist: cairosvg>=2.7.0; extra == 'vector'
+Description-Content-Type: text/markdown
+
+# Icoft - Icon Forge
+
+**From Single Image to Full-Platform App Icons**
+
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Version](https://img.shields.io/pypi/v/icoft.svg)](https://pypi.org/project/icoft/)
+
+Icoft is a command-line tool that converts a single image (PNG, JPG, JPEG, WEBP) into icons for all platforms (Windows, macOS, Linux, Web), or performs image processing tasks like cropping, background removal, and vectorization.
+
+## Features
+
+- **Icon Generation**: Complete icon sets for Windows, macOS, Linux, and Web
+- **Image Cropping**: Manual border removal with customizable margins
+- **Background Removal**: Convert solid-color backgrounds to transparent
+- **Vectorization**: High-quality PNG to SVG conversion (vector tracing or embedded PNG)
+- **Flexible Output**: Generate full icon sets or single processed images
+- **CLI Friendly**: Unix-style composable parameters with Rich terminal output
+
+## Installation
+
+```bash
+# Clone the repository
+git clone <repository-url>
+cd icoft
+
+# Install with uv (recommended)
+uv sync
+
+# Or install with pip
+pip install -e .
+```
+
+## Quick Start
+
+```bash
+# Generate full icon set (default)
+icoft source_file.png dest_dir/
+
+# Crop and generate icons
+icoft -m 10% source_file.png dest_dir/
+
+# Background removal + crop + icons
+icoft -m 10% -t source_file.png dest_dir/
+
+# Output single processed PNG
+icoft -m 10% source_file.png output.png -o png
+
+# Output single SVG (auto-vectorizes with vector tracing)
+icoft source_file.png output.svg -o svg
+
+# Output single SVG with embedded PNG (preserves gradients perfectly)
+icoft source_file.png output.svg -s embed -o svg
+
+# Crop + background removal + SVG
+icoft -m 10% -t source_file.png output.svg -o svg
+
+# Generate icons for specific platforms only
+icoft source_file.png icons/ -p windows,web
+icoft source_file.png icons/ -p macos,linux
+```
+
+## Usage Examples
+
+### Example 1: Generate Full Icon Set
+
+```bash
+# Generate icons for all platforms
+icoft source_file.png dest_dir/
+```
+
+Output structure:
+
+```
+dest_dir/
+├── windows/
+│   └── app.ico                              # Windows ICO (8 sizes: 16-256px)
+├── macos/
+│   ├── app.icns                             # macOS ICNS container
+│   ├── icon_16x16.png                       # 16×16 @1x
+│   ├── icon_16x16@2x.png                    # 16×16 @2x (32×32)
+│   ├── icon_32x32.png                       # 32×32 @1x
+│   ├── icon_32x32@2x.png                    # 32×32 @2x (64×64)
+│   ├── icon_128x128.png                     # 128×128 @1x
+│   ├── icon_128x128@2x.png                  # 128×128 @2x (256×256)
+│   ├── icon_256x256.png                     # 256×256 @1x
+│   ├── icon_256x256@2x.png                  # 256×256 @2x (512×512)
+│   ├── icon_512x512.png                     # 512×512 @1x
+│   └── icon_512x512@2x.png                  # 512×512 @2x (1024×1024)
+├── linux/
+│   └── hicolor/
+│       ├── 16x16/apps/app.png
+│       ├── 22x22/apps/app.png
+│       ├── 24x24/apps/app.png
+│       ├── 32x32/apps/app.png
+│       ├── 48x48/apps/app.png
+│       ├── 64x64/apps/app.png
+│       ├── 128x128/apps/app.png
+│       ├── 256x256/apps/app.png
+│       └── scalable/apps/app.svg
+└── web/
+    ├── favicon.ico                          # Browser favicon
+    ├── apple-touch-icon.png                 # iOS home screen icon
+    ├── icon-192x192.png                     # PWA icon
+    ├── icon-512x512.png                     # PWA icon
+    └── manifest.json                        # PWA manifest
+```
+
+### Example 2: Crop and Remove Background
+
+```bash
+# For images with solid-color borders and backgrounds
+icoft -m 10% -t source_file.png dest_dir/
+```
+
+This performs:
+
+1. Crop borders with 10% margin
+2. Make background transparent
+3. Generate full icon set
+
+### Example 3: Output Single Processed Image
+
+```bash
+# Crop and save as PNG
+icoft -m 10% source_file.png cropped.png -o png
+
+# Background removal and save as PNG
+icoft -t source_file.png transparent.png -o png
+
+# Crop + background removal + vectorization to SVG
+icoft -m 10% -t source_file.png output.svg -o svg
+```
+
+### Example 4: CI/CD Pipeline
+
+```yaml
+# .github/workflows/release.yml
+- name: Generate icons
+  run: |
+    pip install icoft
+    icoft logo.png resources/icons/
+```
+
+## Command-Line Options
+
+```
+Usage: icoft [OPTIONS] SOURCE_FILE DEST_DIR
+       icoft [OPTIONS] SOURCE_FILE OUTPUT_FILE -o FORMAT
+
+Icoft - From Single Image to Full-Platform App Icons.
+
+Output Modes:
+  DEST_DIR              Generate full icon set for selected platforms
+  OUTPUT_FILE -o png    Save processed image as single PNG
+  OUTPUT_FILE -o svg    Save processed image as single SVG (auto-vectorizes)
+
+Options:
+  -m, --crop-margin        Margin for cropping (e.g., 5%, 10px)
+  -t, --transparent        Make background transparent
+  -B, --bg-threshold=10    Background threshold (0-255)
+  -s, --svg=normal       Enable SVG output: normal (vector tracing) or embed (PNG in SVG)
+  -S, --svg-speckle=10   Filter SVG noise (1-100, only for 'normal' mode)
+  -P, --svg-precision=6  SVG color precision (1-16, only for 'normal' mode)
+  -o, --output=icon        Output format: icon, png, svg
+  -p, --platforms=all      Platforms: windows, macos, linux, web
+  -V, --version            Show version
+  -h, --help               Show help message
+```
+
+## Development
+
+### Setup Development Environment
+
+```bash
+# Install with dev dependencies
+uv sync --extra dev
+
+# Run tests
+uv run pytest tests/ -v
+
+# Run linter
+uv run ruff check .
+
+# Run formatter
+uv run ruff format .
+
+# Run type checker
+uv run pyright .
+```
+
+### Project Structure
+
+```
+icoft/
+├── src/icoft/
+│   ├── cli.py              # CLI entry point
+│   ├── core/
+│   │   ├── processor.py    # Image preprocessing
+│   │   └── generator.py    # Icon generation
+│   └── platforms/          # Platform-specific modules
+├── tests/
+│   ├── test_cli.py
+│   ├── test_processor.py
+│   └── test_generator.py
+├── docs/
+└── examples/
+```
+
+## Roadmap
+
+### v0.3.2 (Current)
+
+- ✅ Unix-style CLI parameter design
+- ✅ Step-by-step processing control
+- ✅ Dual-mode SVG generation: `normal` (vector tracing for lossless scaling) and `embed` (PNG embedding for gradient preservation)
+- ✅ Smart cutout improvements
+- ✅ Edge artifact removal
+- ✅ Configuration parameters with auto-enable
+- ✅ Single file output mode (-o png/svg)
+- ✅ Improved CLI help and error messages
+- ✅ AI-based background removal (U²-Net)
+
+### v0.5.0 (Planned)
+
+- [ ] Improve edge detection for better cropping
+- [ ] Support more input formats (WEBP, AVIF)
+- [ ] Optimize SVG output quality
+- [ ] Add progress indicators for long operations
+- [ ] Support custom icon sizes
+- [ ] Add platform-specific output options
+- [ ] Improve error messages
+
+### v1.0.0 (Future)
+
+- [ ] iOS icon optimization
+- [ ] Android adaptive icons
+- [ ] Full UWP/WinUI 3 support (14 sizes + 3 themes + tiles)
+- [ ] CI/CD integration templates
+- [ ] GUI application (optional)
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
+3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
+4. Push to the branch (`git push origin feature/AmazingFeature`)
+5. Open a Pull Request
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.
+
+## Acknowledgments
+
+- Built with [Click](https://click.palletsprojects.com/) for CLI
+- Image processing powered by [Pillow](https://pillow.readthedocs.io/) and [OpenCV](https://opencv.org/)
+- Terminal output美化 with [Rich](https://rich.readthedocs.io/)
+
+***
+
+**Icoft** = **Icon** + **Forge** 🛠️
+
+Made with ❤️ for developers everywhere