mail2task 0.1.0__py3-none-any.whl

mail2task/__init__.py

@@ -0,0 +1 @@
+from .extractor import extract_tasks

mail2task/cli.py

@@ -0,0 +1,25 @@
+import sys
+import json
+from .extractor import extract_tasks
+
+
+def main():
+    if len(sys.argv) < 2:
+        print("Usage: mail2task <file>")
+        return
+
+    file_path = sys.argv[1]
+
+    try:
+        with open(file_path, "r", encoding="utf-8") as f:
+            content = f.read()
+
+        tasks = extract_tasks(content)
+
+        print(json.dumps(tasks, indent=2))
+
+    except FileNotFoundError:
+        print(f"File not found: {file_path}")
+
+    except Exception as e:
+        print(f"Error: {e}")

mail2task/extractor.py

@@ -0,0 +1,100 @@
+import re
+import dateparser
+
+
+ACTION_WORDS = [
+    "submit",
+    "schedule",
+    "send",
+    "complete",
+    "review",
+    "update",
+    "prepare",
+    "finish",
+    "call",
+    "email",
+    "organize",
+    "create",
+    "fix"
+]
+
+
+PRIORITY_KEYWORDS = {
+    "high": ["urgent", "asap", "important", "immediately"],
+    "medium": ["soon", "priority"],
+    "low": ["later", "whenever"]
+}
+
+
+def clean_text(text: str):
+    return re.sub(r"\s+", " ", text).strip()
+
+
+def detect_priority(text: str):
+    text_lower = text.lower()
+
+    for level, keywords in PRIORITY_KEYWORDS.items():
+        for keyword in keywords:
+            if keyword in text_lower:
+                return level
+
+    return "normal"
+
+
+def extract_due_date(text: str):
+    date = dateparser.parse(
+        text,
+        settings={"PREFER_DATES_FROM": "future"}
+    )
+
+    if date:
+        return date.isoformat()
+
+    return None
+
+
+def is_task_sentence(text: str):
+    text_lower = text.lower()
+
+    return any(word in text_lower for word in ACTION_WORDS)
+
+
+def extract_tasks(email_text: str):
+    lines = email_text.splitlines()
+
+    tasks = []
+    seen_titles = set()
+
+    for line in lines:
+        line = clean_text(line)
+
+        if not line:
+            continue
+
+        if len(line.split()) < 3:
+            continue
+
+        if not is_task_sentence(line):
+            continue
+
+        title = re.sub(
+            r"\b(please|kindly)\b",
+            "",
+            line,
+            flags=re.IGNORECASE
+        ).strip()
+
+        if title.lower() in seen_titles:
+            continue
+
+        seen_titles.add(title.lower())
+
+        task = {
+            "title": title,
+            "due_date": extract_due_date(line),
+            "priority": detect_priority(line)
+        }
+
+        tasks.append(task)
+
+    return tasks

mail2task-0.1.0.dist-info/METADATA

@@ -0,0 +1,105 @@
+Metadata-Version: 2.4
+Name: mail2task
+Version: 0.1.0
+Summary: Extract actionable tasks from emails using Python
+Author: Eby J Kavungal
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: dateparser
+
+# mail2task
+
+Extract actionable tasks from messy emails using Python.
+
+## Features
+
+- Extract task-like sentences
+- Detect due dates
+- Detect priority levels
+- Clean JSON output
+- CLI support
+
+---
+
+## Installation
+
+```bash
+pip install mail2task
+```
+
+---
+
+## Usage
+
+### Python
+
+```python
+from mail2task import extract_tasks
+
+email = """
+Please submit the compliance report by Friday.
+
+Schedule the onboarding meeting tomorrow.
+"""
+
+tasks = extract_tasks(email)
+
+print(tasks)
+```
+
+---
+
+### CLI
+
+Create a text file:
+
+```text
+Please submit the report by Friday.
+Schedule the client call tomorrow.
+```
+
+Run:
+
+```bash
+mail2task sample_email.txt
+```
+
+Output:
+
+```json
+[
+  {
+    "title": "submit the report by Friday.",
+    "due_date": "2026-05-29T00:00:00",
+    "priority": "normal"
+  }
+]
+```
+
+---
+
+## Example Use Cases
+
+- Email automation
+- Productivity apps
+- AI assistants
+- CRM workflows
+- Task management systems
+
+---
+
+## Project Structure
+
+```text
+mail2task/
+├── src/
+├── tests/
+├── README.md
+├── pyproject.toml
+```
+
+---
+
+## License
+
+MIT License

mail2task-0.1.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+mail2task/__init__.py,sha256=2cfFK7DT48oa9jyWMRvHKY-EmLKY8WMwDdKZUa3K2ic,36
+mail2task/cli.py,sha256=LHphbntchelvB12WnyDETS2JejOnkmc4AlzLFp_qYGQ,525
+mail2task/extractor.py,sha256=DIb7Ovh8cAGXXKHg2XV_9PpBxATpPRscDr234ovM8aw,1892
+mail2task/parser.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mail2task-0.1.0.dist-info/METADATA,sha256=y4CF4QpTqZOg3EZi6GOGMgkKGC8Ae288vWiYY4WXxqw,1399
+mail2task-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+mail2task-0.1.0.dist-info/entry_points.txt,sha256=CpFA9n2w2k1_X2cug9DjJMWc1OqhFQ2bSouyCYf7QAg,49
+mail2task-0.1.0.dist-info/top_level.txt,sha256=0aeUtznLFv-fC6dMinhqQeOb6U-60ExXa1sRoJk6SZQ,10
+mail2task-0.1.0.dist-info/RECORD,,

mail2task-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

mail2task-0.1.0.dist-info/entry_points.txt

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

mail2task-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+mail2task