π kport v3.2.4 β Release Notes
Release Date: June 15, 2026
Tag: v3.2.4
Previous Version: v3.2.3
Overview
kport 3.2.4 is a packaging and configuration release. It adds cross-platform application icons, improves packaging consistency, enhances VS Code extension configuration, and updates the project license metadata to comply with PEP 621 standards.
π New Features
π¨ Cross-Platform Application Icons
kport now includes professional application icons for all platforms:
New assets:
assets/icons/windows/β Windows.icoformat for installers and system integrationassets/icons/macos/β macOS.icnsformat for app bundlesassets/icons/linux/β PNG icons in multiple sizes (16x16, 32x32, 64x64, 128x128, 256x256)
Icons are integrated into:
- Windows installer (NSIS)
- macOS app bundle and DMG
- Linux package managers (DEB, RPM, Snap)
- VS Code extension marketplace
π¦ Improved VS Code Extension Configuration
Enhanced vscode-extension/ with:
- Refined
package.jsonconfiguration for better marketplace visibility - Updated icon references and branding consistency
- Improved MCP server integration documentation
π Bug Fixes
License metadata compliance (PEP 621)
Root cause: pyproject.toml used non-standard license field format that may not be recognized by modern Python packaging tools.
Fix:
- Updated
project.licenseto comply with PEP 621 standard - License metadata now properly recognized by pip, poetry, and other modern tools
- Verified compatibility with setuptools 70.0+
π CI/CD Improvements
Enhanced packaging workflows:
- Icon assets integrated into all package build scripts
- Improved icon path handling across platforms
- Better validation of icon formats during CI
π Full Changelog
| Commit | Type | Summary |
|---|---|---|
14a027e |
feat | Add cross-platform packaging, application icons, and VS Code extension configuration |
392a1dd |
fix | Update project.license to comply with PEP 621 |
π Backward Compatibility
β Fully backward compatible with kport 3.2.3.
All existing commands, flags, and configurations continue to work without modification.
π¦ Installation
| Platform | Command |
|---|---|
| PyPI | pip install kport==3.2.4 |
| Linux DEB | See Releases |
| Linux RPM | See Releases |
| Linux Snap | snap install kport |
| macOS | See Releases |
| Windows EXE | See Releases |
| Windows Chocolatey | choco install kport |
| VS Code | Extensions marketplace β search "KPort" |
π οΈ For Developers & Maintainers
Building from Source
# Prerequisites check
python kport_orchestrate.py --check
# Build everything
python kport_orchestrate.py --build-all
# Build individual formats
python kport_orchestrate.py --build-pypi # PyPI wheel + sdist
python kport_orchestrate.py --build-vscode # VS Code .vsix
python kport_orchestrate.py --build-snap # Snap packagePublishing
# Publish everything (requires credentials in env)
python kport_orchestrate.py --publish-all
# Publish individually
python publish.py # PyPI (TWINE_PASSWORD required)
python vscode_build.py --publish # VS Code Marketplace (VSCE_PAT required)
python snap_publish.py --publish --channel stable # Snap Store (snapcraft login required)Running Tests
python run_tests.py
# or
pytest tests/ -vSee BUILD_GUIDE.md for full documentation.