git-ew 0.1.0__py3-none-any.whl

git_ew/templates/index.html

@@ -0,0 +1,44 @@
+{% extends "base.html" %}
+
+{% block title %}Threads - git-ew{% endblock %}
+
+{% block content %}
+<div class="threads-list">
+    <div class="threads-header">
+        <h2>Threads</h2>
+    </div>
+
+    {% if threads %}
+        <div class="thread-items">
+            {% for thread in threads %}
+            <div class="thread-item">
+                <div class="thread-icon">
+                    {% if thread.is_patch %}
+                    <span class="icon icon-patch" title="Patch">📝</span>
+                    {% else %}
+                    <span class="icon icon-discussion" title="Discussion">💬</span>
+                    {% endif %}
+                </div>
+                <div class="thread-content">
+                    <div class="thread-title">
+                        <a href="/thread/{{ thread.id }}" class="thread-link">
+                            {{ thread.subject }}
+                        </a>
+                    </div>
+                    <div class="thread-meta">
+                        <span class="thread-date">
+                            Updated {{ thread.updated_at.strftime('%Y-%m-%d %H:%M') }}
+                        </span>
+                    </div>
+                </div>
+            </div>
+            {% endfor %}
+        </div>
+    {% else %}
+        <div class="empty-state">
+            <p>No threads found.</p>
+            <p>Click "Sync Emails" to fetch threads from your email sources.</p>
+        </div>
+    {% endif %}
+</div>
+{% endblock %}

git_ew/templates/thread.html

@@ -0,0 +1,153 @@
+{% extends "base.html" %}
+
+{% block title %}{{ thread.subject }} - git-ew{% endblock %}
+
+{% macro render_message(item) %}
+<div class="message-wrapper">
+    <div class="message" data-message-id="{{ item.message.message_id }}">
+        <div class="message-header">
+            <div class="message-info">
+                <button class="collapse-btn" onclick="toggleSubthread(event, '{{ item.message.message_id }}')" title="Toggle subthread">
+                    <span class="collapse-icon">▼</span>
+                </button>
+                <div class="message-author">
+                    <strong>{{ item.message.from_name }}</strong>
+                    <span class="message-email">&lt;{{ item.message.from_email }}&gt;</span>
+                </div>
+            </div>
+            <div class="message-date">
+                <code>{{ item.message.message_id }}</code>
+                <span>{{ item.message.date.strftime('%Y-%m-%d %H:%M') }}</span>
+            </div>
+        </div>
+    <div class="message-body">
+        {# TODO: Option to render Markdown (`|safe`) #}
+        <div class="message-text">{{ item.body }}</div>
+        {% if item.quoted_body %}
+        <details class="quoted-section">
+            <summary>Show quoted text</summary>
+            <pre class="quoted-text">{{ item.quoted_body }}</pre>
+        </details>
+        {% endif %}
+    </div>
+        {% if item.message.is_patch and item.message.patch_content %}
+        <div class="message-patch">
+            <details>
+                <summary>View Patch</summary>
+                <pre class="patch-content">{{ item.message.patch_content }}</pre>
+            </details>
+        </div>
+        {% endif %}
+        <div class="message-actions">
+            <button class="btn btn-sm btn-reply" onclick="replyToMessage('{{ item.message.message_id }}', '{{ item.message.from_name }}')">
+                Reply
+            </button>
+        </div>
+    </div>
+    {% if item.children %}
+    <div class="message-children">
+        {% for child in item.children %}
+            {{ render_message(child) }}
+        {% endfor %}
+    </div>
+    {% endif %}
+</div>
+{% endmacro %}
+
+{% block content %}
+<div class="thread-view">
+    <div class="thread-header">
+        <div class="thread-title-row">
+            <h2>{{ thread.subject }}</h2>
+        </div>
+        <div class="thread-meta">
+            {% if thread.is_patch %}
+            <span class="badge badge-patch">Patch</span>
+            {% endif %}
+            <span class="thread-date">
+                Created {{ thread.created_at.strftime('%Y-%m-%d %H:%M') }}
+            </span>
+        </div>
+    </div>
+
+    <div class="messages-container">
+        {% for item in messages %}
+            {{ render_message(item) }}
+        {% endfor %}
+    </div>
+
+    <div class="reply-form" id="reply-form" style="display: none;">
+        <h3>Reply to <span id="reply-to-name"></span></h3>
+        <form onsubmit="submitReply(event)">
+            <input type="hidden" id="reply-to-id" name="in_reply_to">
+            <div class="form-group">
+                <label for="reply-body">Message (plain text):</label>
+                <textarea id="reply-body" name="body" rows="10" required placeholder="Write your reply here..."></textarea>
+            </div>
+            <div class="form-actions">
+                <button type="submit" class="btn btn-primary">Send Reply</button>
+                <button type="button" class="btn btn-secondary" onclick="cancelReply()">Cancel</button>
+            </div>
+        </form>
+    </div>
+</div>
+{% endblock %}
+
+{% block scripts %}
+<script>
+const threadId = {{ thread.id }};
+
+function toggleSubthread(event, messageId) {
+    event.preventDefault();
+    event.stopPropagation();
+
+    const messageElement = document.querySelector(`[data-message-id="${messageId}"]`);
+    const button = event.target.closest('.collapse-btn');
+
+    messageElement.classList.toggle('collapsed');
+    button.querySelector('.collapse-icon').textContent = messageElement.classList.contains('collapsed') ? '▶' : '▼';
+}
+
+function replyToMessage(messageId, authorName) {
+    document.getElementById('reply-form').style.display = 'block';
+    document.getElementById('reply-to-id').value = messageId;
+    document.getElementById('reply-to-name').textContent = authorName;
+    document.getElementById('reply-body').focus();
+}
+
+function cancelReply() {
+    document.getElementById('reply-form').style.display = 'none';
+    document.getElementById('reply-body').value = '';
+}
+
+async function submitReply(event) {
+    event.preventDefault();
+
+    const formData = {
+        body: document.getElementById('reply-body').value,
+        in_reply_to: document.getElementById('reply-to-id').value || null
+    };
+
+    try {
+        const response = await fetch(`/api/thread/${threadId}/comment`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify(formData)
+        });
+
+        if (response.ok) {
+            alert('Reply sent successfully!');
+            location.reload();
+        } else {
+            const error = await response.json();
+            alert('Failed to send reply: ' + (error.detail || 'Unknown error'));
+        }
+    } catch (error) {
+        alert('Failed to send reply: ' + error.message);
+    }
+}
+
+</script>
+{% endblock %}

git_ew-0.1.0.dist-info/METADATA

@@ -0,0 +1,291 @@
+Metadata-Version: 2.4
+Name: git-ew
+Version: 0.1.0
+Summary: Git Email Workflow
+Author-Email: Timothée Mazzucotelli <dev@pawamoy.fr>
+License-Expression: ISC
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Topic :: Documentation
+Classifier: Topic :: Software Development
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
+Project-URL: Homepage, https://pawamoy.github.io/git-ew
+Project-URL: Documentation, https://pawamoy.github.io/git-ew
+Project-URL: Changelog, https://pawamoy.github.io/git-ew/changelog
+Project-URL: Repository, https://github.com/pawamoy/git-ew
+Project-URL: Issues, https://github.com/pawamoy/git-ew/issues
+Project-URL: Discussions, https://github.com/pawamoy/git-ew/discussions
+Project-URL: Gitter, https://gitter.im/git-ew/community
+Project-URL: Funding, https://github.com/sponsors/pawamoy
+Requires-Python: >=3.12
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: uvicorn[standard]>=0.32.0; python_version < "3.15"
+Requires-Dist: uvicorn>=0.32.0; python_version >= "3.15"
+Requires-Dist: sqlalchemy>=2.0.0
+Requires-Dist: alembic>=1.13.0
+Requires-Dist: aiosqlite<0.22.0,>=0.20.0
+Requires-Dist: jinja2>=3.1.0
+Requires-Dist: python-multipart>=0.0.9
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: aiofiles>=24.1.0
+Requires-Dist: markdown>=3.5.0
+Requires-Dist: pymdown-extensions>=10.0.0
+Description-Content-Type: text/markdown
+
+# git-ew
+
+[![ci](https://github.com/pawamoy/git-ew/workflows/ci/badge.svg)](https://github.com/pawamoy/git-ew/actions?query=workflow%3Aci)
+[![documentation](https://img.shields.io/badge/docs-zensical-FF9100.svg?style=flat)](https://pawamoy.github.io/git-ew/)
+[![pypi version](https://img.shields.io/pypi/v/git-ew.svg)](https://pypi.org/project/git-ew/)
+[![gitter](https://img.shields.io/badge/matrix-chat-4DB798.svg?style=flat)](https://app.gitter.im/#/room/#git-ew:gitter.im)
+
+Git Email Workflow - A GitHub-like web interface for email-based git workflows
+
+> [!NOTE]
+> This project is developed with the assistance of LLMs / coding agents. It's not fully functional yet. My main use of it will be to continue my contribution of a ZSH_XTRACEFD feature to Zsh, through their zsh-workers mailing list.
+
+## Overview
+
+**git-ew** provides a GitHub-style web interface for email-based git workflows. It organizes emails into threads, handles infinite nesting, and allows posting comments via plain-text emails.
+
+![screenshot](https://github.com/user-attachments/assets/d94cdee4-898f-4f1f-be0e-c513714508e6)
+
+### Features
+
+- GitHub-like interface for viewing threads and patches
+- Email integration (maildir, mbox, public archives)
+- Threaded discussions with infinite nesting support
+- Automatic patch detection and display
+- Plain-text email replies with proper headers
+- Thread flattening for long linear chains
+- SQLite backend with async FastAPI
+
+## Installation
+
+```bash
+pip install git-ew
+```
+
+With [`uv`](https://docs.astral.sh/uv/):
+
+```bash
+uv tool install git-ew
+```
+
+## Getting Started
+
+### Quick Demo
+
+Try git-ew with sample data:
+
+```bash
+git-ew init
+python scripts/create_sample_data.py
+git-ew serve
+```
+
+Open http://127.0.0.1:8000 to view sample threads.
+
+### Setup
+
+Initialize the database:
+
+```bash
+git-ew init
+```
+
+Use the interactive setup wizard:
+
+```bash
+git-ew config
+```
+
+Or configure manually:
+
+```python
+import asyncio
+from git_ew._internal.database import Database
+from git_ew._internal.models import EmailSource
+import json
+
+async def setup():
+    db = Database()
+    await db.init_db()
+
+    # Configure SMTP for sending emails
+    await db.set_config("email_config", {
+        "smtp_host": "smtp.gmail.com",
+        "smtp_port": 587,
+        "from_email": "you@example.com",
+        "from_name": "Your Name",
+        "username": "you@example.com",
+        "password": "your-app-password",  # Use app password for Gmail
+        "use_tls": True
+    })
+
+    # Add email source - Maildir
+    async with db.session() as session:
+        source = EmailSource(
+            name="my-inbox",
+            source_type="maildir",
+            config=json.dumps({"path": "/path/to/maildir"}),
+            enabled=True
+        )
+        session.add(source)
+
+    # Or add email source - Mbox
+    async with db.session() as session:
+        source = EmailSource(
+            name="mailing-list",
+            source_type="mbox",
+            config=json.dumps({"path": "/path/to/archive.mbox"}),
+            enabled=True
+        )
+        session.add(source)
+
+asyncio.run(setup())
+```
+
+### Usage
+
+Start the server:
+
+```bash
+git-ew serve                          # Default: http://127.0.0.1:8000
+git-ew serve --host 0.0.0.0           # Listen on all interfaces
+git-ew serve --port 3000              # Custom port
+git-ew serve --reload                 # Auto-reload (development)
+```
+
+Access the web interface and click "Sync Emails" to fetch messages from configured sources.
+
+### Configuration Details
+
+#### Email Sources
+
+**Maildir** (local mail folders):
+
+```json
+{"path": "/home/user/.mail/INBOX"}
+```
+
+**Mbox** (archive files):
+
+```json
+{"path": "/path/to/mailing-list.mbox"}
+```
+
+**Public Inbox** (coming soon):
+
+```json
+{"url": "https://example.org/archive/"}
+```
+
+#### SMTP Providers
+
+**Gmail**: Enable 2FA and generate an [app password](https://myaccount.google.com/apppasswords)
+
+**Outlook/Office365**: Use regular or app-specific password
+
+**Custom SMTP**: Any server supporting STARTTLS
+
+**Fastmail**: Use a Fastmail app password with mail access enabled. Configure SMTP as
+`smtp.fastmail.com` on port `587` with TLS, and configure an IMAP source using
+`imap.fastmail.com` on port `993` with the folders `INBOX` and `Sent`.
+
+To download and ingest zsh-workers archives into the database:
+
+```bash
+git-ew ingest zsh-workers --since 2026-03-18
+```
+
+#### Command Line
+
+```bash
+git-ew init          # Initialize database
+git-ew serve         # Start web server
+git-ew sync          # Sync emails from sources
+```
+
+## How It Works
+
+### Email Fetching
+
+git-ew can fetch emails from various sources:
+
+- **Maildir**: Local maildir folders
+- **Mbox**: Mbox archive files
+- **Public Archives**: Public-inbox archives (coming soon)
+
+### Thread Organization
+
+Emails are organized into threads based on their `Message-ID`, `In-Reply-To`, and `References` headers. The system:
+
+1. Groups related emails into threads
+2. Builds a tree structure with infinite nesting support
+3. Detects linear chains (single replies) and marks them for flattening
+4. Renders threads with proper indentation and visual hierarchy
+
+### Sending Emails
+
+When you post a comment through the web interface:
+
+1. The comment is sent as a **plain-text email** (no HTML)
+2. Proper email headers are set (`In-Reply-To`, `References`)
+3. The email is stored in the local database
+4. Email threading is maintained correctly
+
+### Patch Detection
+
+git-ew automatically detects patches in emails by looking for:
+
+- Git diff format (`diff --git`)
+- Unified diff format (`---` and `+++`)
+- `[PATCH]` in the subject line
+
+Patches are displayed with syntax highlighting and can be viewed/hidden.
+
+## Architecture
+
+```
+git-ew/
+├── models.py           # SQLAlchemy database models
+├── database.py         # Database operations
+├── email_parser.py     # Email parsing utilities
+├── email_fetcher.py    # Fetch emails from various sources
+├── email_sender.py     # Send emails via SMTP
+├── thread_utils.py     # Thread organization and flattening
+├── app.py             # FastAPI application
+├── cli.py             # Command-line interface
+├── templates/         # Jinja2 HTML templates
+│   ├── base.html
+│   ├── index.html
+│   └── thread.html
+└── static/            # CSS and JavaScript
+    ├── css/style.css
+    └── js/main.js
+```
+
+## API Endpoints
+
+- `GET /` - List threads
+- `GET /thread/{id}` - View thread details
+- `POST /api/thread/{id}/comment` - Post a comment (sends email)
+- `POST /api/thread/{id}` - Update thread (e.g., close/reopen)
+- `POST /api/sync` - Sync emails from sources
+- `GET /api/threads` - Get threads as JSON
+- `GET /api/thread/{id}` - Get thread details as JSON
+
+## Sponsors
+
+<!-- sponsors-start -->
+<!-- sponsors-end -->

git_ew-0.1.0.dist-info/RECORD

@@ -0,0 +1,30 @@
+git_ew-0.1.0.dist-info/METADATA,sha256=9pP8MoaTaiuvxahc7FwvskRA-t_yFGqdUgnJrWXQaoE,8573
+git_ew-0.1.0.dist-info/WHEEL,sha256=IuIk3wbaEnFH1cx75iM2R1CmliRI3dFLXTbRakgvgFQ,90
+git_ew-0.1.0.dist-info/entry_points.txt,sha256=j11TvmXkuMdDhLb59XWffVDgAGj3mbZSilsIGCFEinM,55
+git_ew-0.1.0.dist-info/licenses/LICENSE,sha256=I3KB1-ErGw-w8Lv5cPRgpAQKNKPv_CpOJvpYunP93-E,771
+git_ew/__init__.py,sha256=k0WK-LEu7zA6S2rmc4m6CvMfQhSAidvzTt7NvqT1j0U,4065
+git_ew/__main__.py,sha256=ERyH_XWsQni1DzuRxFphCOGAPzCSpAXsgMudT73gkUQ,1179
+git_ew/_internal/__init__.py,sha256=LH7HQJydqOYIxZva6Nc0p5zeUpQAxcvUyEwiajkZkdQ,831
+git_ew/_internal/app.py,sha256=kfS_eDxKGZi8bPIOH0chAft3hVUKH_HCeX-JapdjQME,13009
+git_ew/_internal/cli.py,sha256=zjZvDHMtoNG3YhXzCx3K1xjgO2P0Xak4kGL22ZKRVA0,8211
+git_ew/_internal/config.py,sha256=aHlbreajf7LknYF1DU9LOAxbbETdKmnDx5A1eGMxjm8,5836
+git_ew/_internal/database.py,sha256=pjH3Ka599QLB_HX1YIvguSeD774rtSnET_dGEz-Kes0,9925
+git_ew/_internal/debug.py,sha256=FX1GGczGTFdTSh6Lu4DN4O9g4L3_D-N6XTr_VJGtacU,3835
+git_ew/_internal/email_fetcher.py,sha256=LLnguwguTwJI9MlrhsX9WMyuWP4mcIiMg939EYbYn_8,10644
+git_ew/_internal/email_parser.py,sha256=DjfhhQQ4UZBG-zZxnKLN9IXhCeWLcXamNIVEB3eXDuE,8431
+git_ew/_internal/email_sender.py,sha256=jyzIZTbU-InjGnL95X0Stiws3COiY89iZCKU2nMGRj0,7129
+git_ew/_internal/mailing_lists/__init__.py,sha256=fpeHW2ls_srClMUHwiBNTiBGV4ri9SAQStWaW39TW8o,859
+git_ew/_internal/mailing_lists/zsh_workers/__init__.py,sha256=LH7HQJydqOYIxZva6Nc0p5zeUpQAxcvUyEwiajkZkdQ,831
+git_ew/_internal/mailing_lists/zsh_workers/ingest.py,sha256=xulVC_Mv4kJno4h5ecqHVZtzTcY-e4iTVZvbuDhH56s,15346
+git_ew/_internal/mailing_lists/zsh_workers/sync_archives.py,sha256=igRl3IKE2-LXuUla_c8bH3kCbrRUHzHTTcc3vTOCs3g,10388
+git_ew/_internal/models.py,sha256=NSMvt4SBeHY0QrWdWMcxchBoJi9HhhhP3G6Zzhr5KA4,5969
+git_ew/_internal/secrets.py,sha256=vCJq0KvgcaBPcB30UCi3I7PWEWIVqkuLZv8A6MunAGs,2025
+git_ew/_internal/sync.py,sha256=hbtd8fRsUPqZhTgZQBATuLWPguvUiZfASs7anePBWak,5155
+git_ew/_internal/thread_utils.py,sha256=VMAcpoeCIzfU2lUFACkCNoa89JFnBZU1poX9whtJ3GI,5308
+git_ew/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+git_ew/static/css/style.css,sha256=e9D_hrmmamXKPk6BZvrf_hPC1z3v9XGQadkw7ouLPxA,11150
+git_ew/static/js/main.js,sha256=FrEJjQEbZj6LRHRtQLEVSejsth_3m6HFtNqazitzc7o,1376
+git_ew/templates/base.html,sha256=6t6QaGHRjWE-yrGp9XplErx6x7RGEmRE-Pono7OBHEA,1032
+git_ew/templates/index.html,sha256=ZnH-dIz9v-t7yLw8jFCV2jWgWbBQ5ofbDxXYtRRQM2o,1483
+git_ew/templates/thread.html,sha256=2COk2Ix6SrZNRYFOGsDx9TmBNFgS3O5Gi6wKYc1DHaM,5356
+git_ew-0.1.0.dist-info/RECORD,,

git_ew-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: pdm-backend (2.5.0)
+Root-Is-Purelib: true
+Tag: py3-none-any

git_ew-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,5 @@
+[console_scripts]
+git-ew = git_ew:main
+
+[gui_scripts]
+

git_ew-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2026, Timothée Mazzucotelli and contributors
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.