pysimpleqr

Name	pysimpleqr JSON
Version	0.1.2 JSON
	download
home_page	None
Summary	use qr to transit messages from OS to other devices, e.g. handset
upload_time	2025-08-07 14:35:49
maintainer	None
docs_url	None
author	None
requires_python	>=3.12
license	None
keywords	qr qrcode simpleqr
VCS
bugtrack_url
requirements	No requirements were recorded.
Travis-CI	No Travis.
coveralls test coverage	No coveralls.

            # 🎯 PySimpleQR - Professional QR Code Generator

> **🚀 Vibed and rocks with Trae.ai IDE!** 
Built entirely within Trae.ai's intelligent development environment with AI-powered assistance throughout the development process.

A sleek, modern Python desktop application for generating professional QR codes with advanced features and an intuitive user interface.

## 🎨 Screenshots

![PySimpleQR Main Interface](screenshot.png)

## ✨ Features

### 🖥️ Modern Desktop Application
- **Responsive UI** that adapts to different screen sizes
- **Beautiful color scheme** with professional styling
- **Real-time character counter** with length warnings
- **Intuitive layout** with clear visual hierarchy

### 🔧 Advanced QR Generation
- **High-quality QR code generation** with PIL/Pillow
- **Text truncation** for long content (max 2953 chars)
- **URL escaping** option to prevent auto-detection
- **Plain text mode** toggle for non-URL content

### 🎨 Smart Image Handling
- **Automatic image resizing** to fit preview frame
- **Aspect ratio preservation** during scaling
- **High-quality resampling** with LANCZOS algorithm
- **300x300 optimized display** with responsive sizing

### 📋 Export Options
- **Save QR codes** as PNG files with 95% quality
- **Copy to clipboard** (Windows native + fallback)
- **Test QR generation** with sample content
- **File dialog integration** for easy saving

### ⚡ Enhanced UX
- **Loading indicators** during generation
- **Status bar updates** for user feedback
- **Error handling** with informative messages
- **Keyboard shortcuts** and responsive design

## 🛠️ Installation & Setup

### Prerequisites
- Python 3.12+
- pip or uv package manager

### Quick Start
```bash
# Clone the repository
git clone [your-repo-url]
cd pysimpleqr

# Install dependencies
uv pip install -e .

# Or with pip
pip install -e .

# Run the application
python -m pysimpleqr.main
```

### Dependencies
```bash
# Core dependencies
qrcode[pil]>=7.4.2
Pillow>=10.0.0
FreeSimpleGUI>=5.0.0

# Optional (for Windows clipboard)
pywin32>=306
```

## 🚀 Usage

### Basic Usage
1. **Launch the app**: `python -m pysimpleqr.main`
2. **Enter text**: Type or paste your content in the text area
3. **Generate QR**: Click "✨ QR it" button
4. **Save/Copy**: Use "💾 Save QR" or "📋 Copy QR" buttons

### Advanced Options
- **Plain text mode**: Prevents URL auto-detection by scanners
- **Escape URLs**: Replaces dots and colons to avoid auto-linking
- **Character counter**: Shows remaining capacity with color warnings
- **Test button**: Generates sample QR for quick testing

### Keyboard Shortcuts
- **Generate**: Click "✨ QR it" or press Enter in text area
- **Save**: Ctrl+S or click "💾 Save QR"
- **Copy**: Ctrl+C or click "📋 Copy QR"
- **Close**: Alt+F4 or click "❌ Close"

## 🧪 Development

### Project Structure
```
pysimpleqr/
├── pysimpleqr/
│   ├── __init__.py
│   ├── __main__.py          # Entry point
│   ├── main.py              # GUI application
│   └── qr_core.py           # QR generation logic
├── tests/                   # Comprehensive test suite
├── pyproject.toml          # Project configuration
├── README.md               # This file
└── [other config files]
```

### Running Tests
```bash
# Run all tests
pytest

# Run with coverage
pytest --cov=pysimpleqr tests/

# Run specific test file
pytest tests/test_main.py
```

### Development Features
- **78 comprehensive tests** covering all functionality
- **Mock testing** for GUI components
- **Error handling validation**
- **Cross-platform compatibility**

## 🎯 Recent Updates

### Latest Features (v2.0)
- ✅ **Smart image resizing** - QR codes automatically fit the preview frame
- ✅ **URL escaping** - Prevent unwanted URL detection by scanners
- ✅ **Enhanced error handling** - Better user feedback and recovery
- ✅ **Improved UI responsiveness** - Better layout on different screen sizes
- ✅ **Test button** - Quick QR generation for testing purposes
- ✅ **Clipboard integration** - Native Windows + fallback support

### Technical Improvements
- **Aspect ratio preservation** during image scaling
- **High-quality resampling** with LANCZOS algorithm
- **Optimized memory usage** with proper image handling
- **Comprehensive test coverage** with 78+ tests

## 🖥️ System Requirements

### Supported Platforms
- **Windows** (full feature support)
- **Linux** (with X11/Wayland)
- **macOS** (with tkinter support)

## 🤝 Contributing

We welcome contributions! Please see:
- **Issues**: Report bugs or request features
- **Pull Requests**: Submit improvements
- **Discussions**: Share ideas and feedback

## 📄 License

This project is open source and available under the [MIT License](LICENSE).

## 🔗 Links

- **Homepage**: [GitHub Repository]
- **Issues**: [GitHub Issues]
- **Documentation**: [Project Wiki]

---

<div align="center">

**Built with ❤️ using Trae.ai IDE**

*This project was developed entirely within Trae.ai's intelligent development environment, leveraging AI-powered coding assistance for rapid development and high-quality code generation.*

</div>

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "pysimpleqr",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.12",
    "maintainer_email": null,
    "keywords": "qr, qrcode, simpleqr",
    "author": null,
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/23/a0/210ae6f8dc53c5fa5cb5b57eedc2e253ff6d7101959aa9194896b174de39/pysimpleqr-0.1.2.tar.gz",
    "platform": null,
    "description": "# \ud83c\udfaf PySimpleQR - Professional QR Code Generator\r\n\r\n> **\ud83d\ude80 Vibed and rocks with Trae.ai IDE!** \r\nBuilt entirely within Trae.ai's intelligent development environment with AI-powered assistance throughout the development process.\r\n\r\nA sleek, modern Python desktop application for generating professional QR codes with advanced features and an intuitive user interface.\r\n\r\n## \ud83c\udfa8 Screenshots\r\n\r\n![PySimpleQR Main Interface](screenshot.png)\r\n\r\n## \u2728 Features\r\n\r\n### \ud83d\udda5\ufe0f Modern Desktop Application\r\n- **Responsive UI** that adapts to different screen sizes\r\n- **Beautiful color scheme** with professional styling\r\n- **Real-time character counter** with length warnings\r\n- **Intuitive layout** with clear visual hierarchy\r\n\r\n### \ud83d\udd27 Advanced QR Generation\r\n- **High-quality QR code generation** with PIL/Pillow\r\n- **Text truncation** for long content (max 2953 chars)\r\n- **URL escaping** option to prevent auto-detection\r\n- **Plain text mode** toggle for non-URL content\r\n\r\n### \ud83c\udfa8 Smart Image Handling\r\n- **Automatic image resizing** to fit preview frame\r\n- **Aspect ratio preservation** during scaling\r\n- **High-quality resampling** with LANCZOS algorithm\r\n- **300x300 optimized display** with responsive sizing\r\n\r\n### \ud83d\udccb Export Options\r\n- **Save QR codes** as PNG files with 95% quality\r\n- **Copy to clipboard** (Windows native + fallback)\r\n- **Test QR generation** with sample content\r\n- **File dialog integration** for easy saving\r\n\r\n### \u26a1 Enhanced UX\r\n- **Loading indicators** during generation\r\n- **Status bar updates** for user feedback\r\n- **Error handling** with informative messages\r\n- **Keyboard shortcuts** and responsive design\r\n\r\n## \ud83d\udee0\ufe0f Installation & Setup\r\n\r\n### Prerequisites\r\n- Python 3.12+\r\n- pip or uv package manager\r\n\r\n### Quick Start\r\n```bash\r\n# Clone the repository\r\ngit clone [your-repo-url]\r\ncd pysimpleqr\r\n\r\n# Install dependencies\r\nuv pip install -e .\r\n\r\n# Or with pip\r\npip install -e .\r\n\r\n# Run the application\r\npython -m pysimpleqr.main\r\n```\r\n\r\n### Dependencies\r\n```bash\r\n# Core dependencies\r\nqrcode[pil]>=7.4.2\r\nPillow>=10.0.0\r\nFreeSimpleGUI>=5.0.0\r\n\r\n# Optional (for Windows clipboard)\r\npywin32>=306\r\n```\r\n\r\n## \ud83d\ude80 Usage\r\n\r\n### Basic Usage\r\n1. **Launch the app**: `python -m pysimpleqr.main`\r\n2. **Enter text**: Type or paste your content in the text area\r\n3. **Generate QR**: Click \"\u2728 QR it\" button\r\n4. **Save/Copy**: Use \"\ud83d\udcbe Save QR\" or \"\ud83d\udccb Copy QR\" buttons\r\n\r\n### Advanced Options\r\n- **Plain text mode**: Prevents URL auto-detection by scanners\r\n- **Escape URLs**: Replaces dots and colons to avoid auto-linking\r\n- **Character counter**: Shows remaining capacity with color warnings\r\n- **Test button**: Generates sample QR for quick testing\r\n\r\n### Keyboard Shortcuts\r\n- **Generate**: Click \"\u2728 QR it\" or press Enter in text area\r\n- **Save**: Ctrl+S or click \"\ud83d\udcbe Save QR\"\r\n- **Copy**: Ctrl+C or click \"\ud83d\udccb Copy QR\"\r\n- **Close**: Alt+F4 or click \"\u274c Close\"\r\n\r\n## \ud83e\uddea Development\r\n\r\n### Project Structure\r\n```\r\npysimpleqr/\r\n\u251c\u2500\u2500 pysimpleqr/\r\n\u2502   \u251c\u2500\u2500 __init__.py\r\n\u2502   \u251c\u2500\u2500 __main__.py          # Entry point\r\n\u2502   \u251c\u2500\u2500 main.py              # GUI application\r\n\u2502   \u2514\u2500\u2500 qr_core.py           # QR generation logic\r\n\u251c\u2500\u2500 tests/                   # Comprehensive test suite\r\n\u251c\u2500\u2500 pyproject.toml          # Project configuration\r\n\u251c\u2500\u2500 README.md               # This file\r\n\u2514\u2500\u2500 [other config files]\r\n```\r\n\r\n### Running Tests\r\n```bash\r\n# Run all tests\r\npytest\r\n\r\n# Run with coverage\r\npytest --cov=pysimpleqr tests/\r\n\r\n# Run specific test file\r\npytest tests/test_main.py\r\n```\r\n\r\n### Development Features\r\n- **78 comprehensive tests** covering all functionality\r\n- **Mock testing** for GUI components\r\n- **Error handling validation**\r\n- **Cross-platform compatibility**\r\n\r\n## \ud83c\udfaf Recent Updates\r\n\r\n### Latest Features (v2.0)\r\n- \u2705 **Smart image resizing** - QR codes automatically fit the preview frame\r\n- \u2705 **URL escaping** - Prevent unwanted URL detection by scanners\r\n- \u2705 **Enhanced error handling** - Better user feedback and recovery\r\n- \u2705 **Improved UI responsiveness** - Better layout on different screen sizes\r\n- \u2705 **Test button** - Quick QR generation for testing purposes\r\n- \u2705 **Clipboard integration** - Native Windows + fallback support\r\n\r\n### Technical Improvements\r\n- **Aspect ratio preservation** during image scaling\r\n- **High-quality resampling** with LANCZOS algorithm\r\n- **Optimized memory usage** with proper image handling\r\n- **Comprehensive test coverage** with 78+ tests\r\n\r\n## \ud83d\udda5\ufe0f System Requirements\r\n\r\n### Supported Platforms\r\n- **Windows** (full feature support)\r\n- **Linux** (with X11/Wayland)\r\n- **macOS** (with tkinter support)\r\n\r\n## \ud83e\udd1d Contributing\r\n\r\nWe welcome contributions! Please see:\r\n- **Issues**: Report bugs or request features\r\n- **Pull Requests**: Submit improvements\r\n- **Discussions**: Share ideas and feedback\r\n\r\n## \ud83d\udcc4 License\r\n\r\nThis project is open source and available under the [MIT License](LICENSE).\r\n\r\n## \ud83d\udd17 Links\r\n\r\n- **Homepage**: [GitHub Repository]\r\n- **Issues**: [GitHub Issues]\r\n- **Documentation**: [Project Wiki]\r\n\r\n---\r\n\r\n<div align=\"center\">\r\n\r\n**Built with \u2764\ufe0f using Trae.ai IDE**\r\n\r\n*This project was developed entirely within Trae.ai's intelligent development environment, leveraging AI-powered coding assistance for rapid development and high-quality code generation.*\r\n\r\n</div>\r\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "use qr to transit messages from OS to other devices, e.g. handset",
    "version": "0.1.2",
    "project_urls": {
        "Homepage": "https://github.com/fxyzbtc/pysimpleqr",
        "Repository": "https://github.com/fxyzbtc/pysimpleqr"
    },
    "split_keywords": [
        "qr",
        " qrcode",
        " simpleqr"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "88fbf1c5bd3a94a266c67248f4349ad2448d7f05426e28ebbf1a96d2dfb3278b",
                "md5": "32e0e65ade3730520dff14487fd06386",
                "sha256": "875f014c6ff55f4d257ae25b02b18c5b0ac297543d360ad5c96136e5f742957c"
            },
            "downloads": -1,
            "filename": "pysimpleqr-0.1.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "32e0e65ade3730520dff14487fd06386",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.12",
            "size": 11656,
            "upload_time": "2025-08-07T14:35:47",
            "upload_time_iso_8601": "2025-08-07T14:35:47.512867Z",
            "url": "https://files.pythonhosted.org/packages/88/fb/f1c5bd3a94a266c67248f4349ad2448d7f05426e28ebbf1a96d2dfb3278b/pysimpleqr-0.1.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "23a0210ae6f8dc53c5fa5cb5b57eedc2e253ff6d7101959aa9194896b174de39",
                "md5": "f773f06bbdf3f720ff86ddb13a237bba",
                "sha256": "bada4e0128bac9c43ff260b33a02ab1c4c834825ea5494023d56ad720a92085b"
            },
            "downloads": -1,
            "filename": "pysimpleqr-0.1.2.tar.gz",
            "has_sig": false,
            "md5_digest": "f773f06bbdf3f720ff86ddb13a237bba",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.12",
            "size": 21601,
            "upload_time": "2025-08-07T14:35:49",
            "upload_time_iso_8601": "2025-08-07T14:35:49.038684Z",
            "url": "https://files.pythonhosted.org/packages/23/a0/210ae6f8dc53c5fa5cb5b57eedc2e253ff6d7101959aa9194896b174de39/pysimpleqr-0.1.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-08-07 14:35:49",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "fxyzbtc",
    "github_project": "pysimpleqr",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "pysimpleqr"
}