difflicious 0.1.0__py3-none-any.whl

difflicious-0.1.0.dist-info/METADATA

@@ -0,0 +1,190 @@
+Metadata-Version: 2.4
+Name: difflicious
+Version: 0.1.0
+Summary: A sleek web-based git diff visualization tool for developers
+Project-URL: Homepage, https://github.com/insipid/difflicious
+Project-URL: Repository, https://github.com/insipid/difflicious
+Project-URL: Issues, https://github.com/insipid/difflicious/issues
+Author-email: Drew <noreply@example.com>
+License: MIT
+License-File: LICENSE
+Keywords: development,diff,git,visualization,web
+Classifier: Development Status :: 3 - Alpha
+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: Topic :: Software Development :: Version Control :: Git
+Classifier: Topic :: Text Processing :: General
+Requires-Python: >=3.9
+Requires-Dist: click>=8.0.0
+Requires-Dist: flask>=2.3.0
+Requires-Dist: jinja-partials>=0.2.0
+Requires-Dist: markupsafe>=2.1.0
+Requires-Dist: pygments>=2.17.0
+Requires-Dist: unidiff>=0.7.5
+Provides-Extra: dev
+Requires-Dist: black>=23.0.0; extra == 'dev'
+Requires-Dist: mypy>=1.0.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Difflicious
+
+A sleek web-based git diff visualization tool used when working locally on branches. Difflicious provides a lightweight local web application that transforms git diffs into an intuitive, interactive experience.
+
+## What is Difflicious?
+
+Difflicious is a developer-focused tool that runs locally and provides a beautiful interface for viewing git changes. Instead of squinting at terminal output, you get a clean, searchable, and toggleable view of your work-in-progress changes.
+
+Perfect for:
+- Reviewing changes before committing
+- Understanding complex diffs across multiple files
+- Quickly navigating through modifications in your current branch
+- Getting a bird's-eye view of your development progress
+
+## Features
+
+- **Side-by-Side Diff Visualization**: Professional-grade side-by-side view with accurate line numbering
+- **Syntax Highlighting**: Beautiful code highlighting for 30+ programming languages using Highlight.js
+- **Intelligent Diff Parsing**: Advanced git diff parser with proper alignment of additions and deletions
+- **Smart UI Controls**: Expand/collapse all buttons with intelligent disabled states
+- **Interactive Interface**: Toggle visibility, search through changes, and filter content
+- **Clean File Paths**: Automatic removal of git diff artifacts (a/, b/ prefixes)
+- **Secure Git Integration**: Safe git command execution with subprocess sanitization
+- **Real-time Status**: Live git repository status and branch information
+- **Modern UI**: Clean Tailwind CSS design with responsive layout
+- **Lightweight**: Minimal infrastructure using Flask backend and Alpine.js frontend
+- **Developer-Friendly**: Designed by developers, for developers
+
+## Installation & Quick Start
+
+### Option 1: Install from PyPI (Recommended)
+```bash
+# Install via pip
+pip install difflicious
+
+# Run the application
+difflicious
+
+# Open your browser to localhost:5000
+```
+
+### Option 2: Docker (Containerized)
+```bash
+# Pull and run the Docker image
+docker run -p 5000:5000 -v $(pwd):/workspace difflicious/difflicious
+
+# Open your browser to localhost:5000
+```
+
+### Option 3: From Source (Development)
+```bash
+# Clone the repository
+git clone https://github.com/insipid/difflicious.git
+cd difflicious
+
+# Install uv if not already installed
+xoxo
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Create virtual environment and install dependencies
+uv sync
+
+# Run the application
+uv run difflicious
+```
+
+## Font Customization
+
+Difflicious supports beautiful programming fonts via Google Fonts CDN integration. You can customize the font used for code and diff content.
+
+### Available Fonts
+
+- **JetBrains Mono** (default) - Designed specifically for developers
+- **Fira Code** - Popular programming font with ligatures
+- **Source Code Pro** - Adobe's professional programming font
+- **IBM Plex Mono** - Modern, clean monospace design
+- **Roboto Mono** - Google's versatile monospace font
+- **Inconsolata** - Humanist monospace font
+
+### Font Configuration
+
+Set the `DIFFLICIOUS_FONT` environment variable to choose your preferred font:
+
+```bash
+# Use Fira Code
+export DIFFLICIOUS_FONT=fira-code
+difflicious
+
+# Use Source Code Pro
+export DIFFLICIOUS_FONT=source-code-pro
+difflicious
+
+# List all available fonts
+difflicious --list-fonts
+```
+
+### Available Font Keys
+
+- `jetbrains-mono` - JetBrains Mono (default)
+- `fira-code` - Fira Code
+- `source-code-pro` - Source Code Pro  
+- `ibm-plex-mono` - IBM Plex Mono
+- `roboto-mono` - Roboto Mono
+- `inconsolata` - Inconsolata
+
+### Disable Google Fonts
+
+If you prefer to use system fonts only (no external CDN requests):
+
+```bash
+export DIFFLICIOUS_DISABLE_GOOGLE_FONTS=true
+difflicious
+```
+
+This will fall back to system monospace fonts like SF Mono, Cascadia Code, Monaco, and Consolas.
+
+## Technology Stack
+
+- **Backend**: Python Flask for minimal setup and excellent git integration
+- **Frontend**: Alpine.js + vanilla CSS for lightweight, declarative UI
+- **Real-time**: Server-Sent Events for live git status updates
+- **Security**: Proper subprocess sanitization for safe git command execution
+- **Distribution**: Modern Python packaging (PyPI) and Docker containers
+- **Development**: uv for fast Python package management and virtual environments
+
+## Development Status
+
+✅ **Production-ready diff visualization** - Advanced side-by-side interface implemented!
+
+### Completed ✅
+- Modern Python project structure with pyproject.toml and uv
+- Flask backend with comprehensive API endpoints
+- Advanced git diff parser with side-by-side structure
+- Professional side-by-side diff visualization interface
+- Secure git command execution wrapper with subprocess sanitization
+- Interactive Alpine.js frontend with Tailwind CSS styling
+- Comprehensive test suite (28 tests, 73% coverage)
+- Real git integration (status, diff, branch detection, parsing)
+
+### Coming Soon 🚧
+- Docker containerization with uv
+- PyPI package publishing
+- Enhanced syntax highlighting for code content
+- Advanced search and filtering capabilities
+- Keyboard shortcuts and accessibility features
+- Server-Sent Events for real-time updates
+
+## Contributing
+
+This project is in early development. More contribution guidelines will be available as the core functionality is completed.
+
+## License
+
+MIT License - see LICENSE file for details.

difflicious-0.1.0.dist-info/RECORD

@@ -0,0 +1,32 @@
+difflicious/__init__.py,sha256=Npx_GS-QsbJarHUbaxNcyT6T_XKDlRtO9F4SC7FQtfc,225
+difflicious/app.py,sha256=de27J605UF6vT0dUKnWWTT1jkyGEGfrawolAr5IgWuI,20243
+difflicious/cli.py,sha256=SuzfjxzdePaqTWOSHpBDJIrZizLsWhCAcf6lWQf4EjM,2391
+difflicious/diff_parser.py,sha256=rEa-57Sic-BD1OZwOXIiEwJU24jDi83qg7pvVk7ae-8,17604
+difflicious/dummy_data.json,sha256=PWSdISbuRzgLgc7AGzClItjO7dERXP6XSfkRYUe7huI,2606
+difflicious/git_operations.py,sha256=lTXgCUM1X80xaK34eYnINiceApthNUXFb9viNp9-AYU,37530
+difflicious/services/__init__.py,sha256=Wxhqj5pmwQdjXDEdy2KcbBPZHBvKAAmOH5sK9Q17hvY,51
+difflicious/services/base_service.py,sha256=PunvoJwILcQ14skYhiX6yYRgbj4NflP78up_K0CVkOc,995
+difflicious/services/diff_service.py,sha256=a2xp2QSciM1qvfLuWyACdTaY7IWcmQS5xWfOjbqBfbM,16130
+difflicious/services/exceptions.py,sha256=p74eXZ46O0J-vQ4hFhiIRZbCcQIfPEmLHkcQQbzCc_A,334
+difflicious/services/git_service.py,sha256=dhzmcUMmIFlU3dDrkCkPRbTI_4YBUCSuM6PqDuCZIso,4504
+difflicious/services/syntax_service.py,sha256=OFVLOz0MrVTQDRGrCjmEdLJQnTowKm1-f4jbytiOGEg,5625
+difflicious/services/template_service.py,sha256=lW4wAqp9C1r_ngkhFK1Z-c8mN5QddH2Gn5cPEv9S2kk,15386
+difflicious/static/css/styles.css,sha256=T2UkMMtkYqvAqBjUQhGJ9PzytuIaw1Zd6JX52iozsSI,21866
+difflicious/static/css/tailwind.css,sha256=es_PPn8acfVBJ7keY5sSWkzCg8ezHsW9axbZV0MNfXI,13906
+difflicious/static/css/tailwind.input.css,sha256=CpVsNPuOef8MsdFdgpIdkSmoMs09XPdFCCph7RL31Ao,96
+difflicious/static/js/app.js,sha256=QcpMngfa7wnk2Bg-aePZNcmPhtl496eA797IuMAj3Yg,40375
+difflicious/static/js/diff-interactions.js,sha256=8zNTQCLbhbJL0MXCGQQ_FS35jOmXQoUQ01HzwraRs2M,69315
+difflicious/templates/base.html,sha256=P0NTJmJfNCt3_VH_txEYqjhzVXPTfyJOYAdwegwlxzw,1692
+difflicious/templates/diff_file.html,sha256=pliksc-XKGUpL1Zwhjc1dh_HiBA1Br4ZexPu-B1900c,4469
+difflicious/templates/diff_groups.html,sha256=NZiCzeDZkBQj6uiYS97t24UjIniOvVa58QmR1FN5vbQ,1286
+difflicious/templates/diff_hunk.html,sha256=W8qwPVj1Qjo7TJeyIpmIDOCUQj6y7erRCbjYVmUm1c4,9919
+difflicious/templates/index.html,sha256=Az1P5OyD46ybZo11PtykdsiIQxFOLmPRX7o9eUrpJP4,1947
+difflicious/templates/partials/empty_state.html,sha256=P7wwG5avrOwB5gHEQLvw2QHesXRWRw8Z9JbyJYIOSdo,1263
+difflicious/templates/partials/global_controls.html,sha256=qx0YoVjENZKH0svE381HLMrauTTPSqjeE7Hejw4HPbQ,1535
+difflicious/templates/partials/loading_state.html,sha256=r8ZqoeFfkmZFwH4Ruj7wXabbJk0PgMYtwbSy9yGZqdc,297
+difflicious/templates/partials/toolbar.html,sha256=xXUoDBhViqmf5zZwZPC4pr5uHXejo9h-RIj8-uRyZ24,10818
+difflicious-0.1.0.dist-info/METADATA,sha256=wCzldABrBxK_m-tTerR6pQLccQVDiG05dtW2B2A_6FQ,6731
+difflicious-0.1.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+difflicious-0.1.0.dist-info/entry_points.txt,sha256=uU-dNhvVWb2ZcD5nmY6rA9TmwLnMZTQ9qDmtZKhEavY,53
+difflicious-0.1.0.dist-info/licenses/LICENSE,sha256=yx9XSSR3ZKKrTqInWDAsvszNXnaiy-w85vb2A5iodMc,1067
+difflicious-0.1.0.dist-info/RECORD,,

difflicious-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.27.0
+Root-Is-Purelib: true
+Tag: py3-none-any

difflicious-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+difflicious = difflicious.cli:main

difflicious-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Drew Amato
+
+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.