mail2task 0.1.0__tar.gz

mail2task-0.1.0/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,96 @@
+# 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/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "mail2task"
+version = "0.1.0"
+description = "Extract actionable tasks from emails using Python"
+authors = [
+  { name="Eby J Kavungal" }
+]
+readme = "README.md"
+requires-python = ">=3.9"
+
+dependencies = [
+  "dateparser"
+]
+
+[project.scripts]
+mail2task = "mail2task.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]

mail2task-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

mail2task-0.1.0/src/mail2task/__init__.py

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

mail2task-0.1.0/src/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-0.1.0/src/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/src/mail2task.egg-info/PKG-INFO

@@ -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/src/mail2task.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+README.md
+pyproject.toml
+src/mail2task/__init__.py
+src/mail2task/cli.py
+src/mail2task/extractor.py
+src/mail2task/parser.py
+src/mail2task.egg-info/PKG-INFO
+src/mail2task.egg-info/SOURCES.txt
+src/mail2task.egg-info/dependency_links.txt
+src/mail2task.egg-info/entry_points.txt
+src/mail2task.egg-info/requires.txt
+src/mail2task.egg-info/top_level.txt
+tests/test_extractor.py

mail2task-0.1.0/src/mail2task.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

mail2task-0.1.0/src/mail2task.egg-info/entry_points.txt

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

mail2task-0.1.0/src/mail2task.egg-info/requires.txt

@@ -0,0 +1 @@
+dateparser

mail2task-0.1.0/src/mail2task.egg-info/top_level.txt

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

mail2task-0.1.0/tests/test_extractor.py

@@ -0,0 +1,12 @@
+from mail2task import extract_tasks
+
+
+def test_extract_tasks():
+    email = """
+    Please submit the report by Friday.
+    Schedule the meeting tomorrow.
+    """
+
+    tasks = extract_tasks(email)
+
+    assert len(tasks) >= 1