openmail 0.1.5__py3-none-any.whl

openmail-0.1.5.dist-info/METADATA

@@ -0,0 +1,180 @@
+Metadata-Version: 2.4
+Name: openmail
+Version: 0.1.5
+Summary: API for managing your email
+License-File: LICENSE
+Requires-Python: >=3.8
+Requires-Dist: beautifulsoup4
+Requires-Dist: langchain
+Requires-Dist: langchain-anthropic
+Requires-Dist: langchain-core
+Requires-Dist: langchain-google-genai
+Requires-Dist: langchain-groq
+Requires-Dist: langchain-openai
+Requires-Dist: langchain-xai
+Requires-Dist: pydantic
+Requires-Dist: requests
+Provides-Extra: dev
+Requires-Dist: black; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Provides-Extra: test
+Requires-Dist: pytest; extra == 'test'
+Provides-Extra: web
+Requires-Dist: fastapi[standard]; extra == 'web'
+Requires-Dist: jinja2; extra == 'web'
+Requires-Dist: python-dotenv; extra == 'web'
+Requires-Dist: python-multipart; extra == 'web'
+Requires-Dist: uvicorn; extra == 'web'
+Description-Content-Type: text/markdown
+
+# OpenMail
+
+OpenMail is a lightweight, extensible Python toolkit for working with email systems using **IMAP** (reading, searching, triage) and **SMTP** (sending and composing), with optional **LLM-powered assistance** for summarization, replies, prioritization, and intelligent search.
+
+The package is designed with a clean separation of concerns:
+- **Transport**: IMAP and SMTP clients
+- **Coordination**: a single high-level manager
+- **Query building**: fluent, lazy IMAP queries
+- **Intelligence**: optional LLM-based workflows
+
+OpenMail is suitable for building inbox tools, assistants, dashboards, CRMs, helpdesks, or personal productivity systems.
+
+---
+
+## 📦 Installation
+
+```
+pip install openmail
+```
+
+---
+
+## 🧱 Package Architecture
+
+OpenMail exposes three main high-level components:
+
+| Component | Purpose |
+|---|---|
+| **EmailManager** | Coordinates IMAP & SMTP for sending, fetching, replying, forwarding, and mailbox operations |
+| **EmailQuery** | Fluent, lazy IMAP query builder |
+| **EmailAssistant** | Optional LLM-powered assistant for summarization, replies, search, and analysis |
+
+Each component is documented in detail in its own markdown file.  
+This document only provides a **high-level overview and initialization examples**.
+
+---
+
+## 🔌 EmailManager
+
+`EmailManager` is the central orchestration layer.  
+It combines an IMAP client and an SMTP client into a single, consistent API.
+
+### Basic Initialization
+
+```
+from openmail.smtp import SMTPClient
+from openmail.imap import IMAPClient
+from openmail.auth import PasswordAuth
+from openmail import EmailManager
+
+auth = PasswordAuth(
+    username="you@example.com",
+    password="app_password",
+)
+
+imap = IMAPClient(
+    host="imap.example.com",
+    port=993,
+    auth=auth,
+)
+
+smtp = SMTPClient(
+    host="smtp.example.com",
+    port=587,
+    auth=auth,
+)
+
+manager = EmailManager(
+    imap=imap,
+    smtp=smtp,
+)
+```
+
+`EmailManager` is responsible for:
+- Sending and composing messages
+- Fetching messages and threads
+- Replying, reply-all, forwarding
+- Flags, folders, triage, unsubscribe helpers
+
+➡️ See [docs/EmailManager.md](docs/EmailManager.md) for the full API and workflows.
+
+---
+
+## 🔎 EmailQuery
+
+`EmailQuery` is a fluent builder for IMAP searches.  
+It is **lazy**: no IMAP call is made until you execute the query.
+
+### Basic Initialization
+
+You normally create it from `EmailManager`:
+
+```
+q = manager.imap_query(mailbox="INBOX")
+```
+
+### Example Usage
+
+```
+q = (
+    manager.imap_query()
+           .from_any("alerts@example.com")
+           .recent_unread(7)
+)
+
+page, messages = q.fetch()
+```
+
+`EmailQuery` focuses only on **search construction and execution**.
+
+➡️ See [docs/EmailQuery.md](docs/EmailQuery.md) for all available filters and execution options.
+
+---
+
+## 🤖 EmailAssistant
+
+`EmailAssistant` provides optional **LLM-powered intelligence** on top of email data.  
+It does not send or fetch emails by itself; it operates on `EmailMessage` objects.
+
+### Basic Initialization
+
+```
+from openmail import EmailAssistant
+
+assistant = EmailAssistant()
+```
+
+### With Persona Customization
+
+```
+from openmail import EmailAssistant, EmailAssistantProfile
+
+profile = EmailAssistantProfile(
+    name="Alex",
+    role="Support Engineer",
+    company="ExampleCorp",
+    tone="friendly",
+)
+
+assistant = EmailAssistant(profile=profile)
+```
+
+`EmailAssistant` supports:
+- Email summarization (single, multi, thread)
+- Reply and follow-up generation
+- Task extraction
+- Prioritization and classification
+- Natural-language IMAP search construction
+- Phishing detection and sender trust evaluation
+
+➡️ See [docs/EmailAssistant.md](docs/EmailAssistant.md) for supported providers, models, and all methods.

openmail-0.1.5.dist-info/RECORD

@@ -0,0 +1,67 @@
+openmail/__init__.py,sha256=kQtfm2PqEiq8OEXjqJbJIrmcvTDIXjGLywvfzndffqg,283
+openmail/config.py,sha256=ucT1dF-0uJmc47DMIuFaVoWFE1yDrY6od18oTVICuXI,542
+openmail/email_assistant.py,sha256=hZBFjAPdqpda3Y1Yp1N0oGdQd4iJoznrCqJooIzeblo,11806
+openmail/email_manager.py,sha256=HiXdltGiHdBWPjwge5zeBctKNtn7UbWKGhC7YKHKmwc,23778
+openmail/email_query.py,sha256=aMvvA0xChkj6TEcs-jbI5KA668gB6RMusV4iG5aQZF0,8297
+openmail/errors.py,sha256=SdqxFcEMR5SJZZ2jeBcOvbtrGtiK9atTNiomS-RI6Uc,253
+openmail/logger.py,sha256=CLpcGg3i9V9VQB9tyBRbzYHApaA_UGUQ3JB4PiQnrXc,521
+openmail/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+openmail/types.py,sha256=DpojiorsNJUF62jkwgrVg2Zmi-ARgMTmTWLko2GsHiI,596
+openmail/assistants/__init__.py,sha256=AntEtNQV42ADPzhlzIui-z0t138QUW0Guh9rmqgWZ4E,1819
+openmail/assistants/classify_emails.py,sha256=G79mrVURMx8xKiIawX-3be7LdxZuDL4sceTUrzU79kQ,2309
+openmail/assistants/compose_email.py,sha256=ytytyjhYWljpdtt2Nq3feUhLaLat_57U_kIJUjpA7m0,1194
+openmail/assistants/detect_phishing_for_email.py,sha256=DGVqVaoKuBQ2Ks1pYmRVGwrZXoqJUdecAL53dP8ZMyw,1886
+openmail/assistants/evaluate_sender_trust_for_email.py,sha256=GKftmMoGRXUfEWeEfbykt7hzKUKiby9yanRlaXrm1M8,1831
+openmail/assistants/extract_tasks_from_emails.py,sha256=Mnf0oGpMuA9d65gyHzB6rri3YG5lrzleqQBXI31idf8,4253
+openmail/assistants/generate_follow_up_for_email.py,sha256=tgmvOeI8tFPE20x8cpYcWBvavWYkJnOyFzhkCkxq6qc,1465
+openmail/assistants/natural_language_query.py,sha256=1zzFhqU58SqQFFsKNeJRmPAvtXJlBn3jRNuZ8BRA5Yk,23313
+openmail/assistants/prioritize_emails.py,sha256=NI9HYwuOvpi6rjqJnoITT2fqfpUVi8_i95uVVeGl00M,2523
+openmail/assistants/reply.py,sha256=nXWRgcXrLq-6BeJp6GWT_ALcZT-8Rw0vzeAxlEZZTw4,1606
+openmail/assistants/reply_suggestions.py,sha256=5_XgOwJeP1kjAapp4OVH6oi4Nh0KFQlTC2pQKUjOkE8,1350
+openmail/assistants/rewrite_email.py,sha256=HtEKG9qYVlhe16nskrrXHGnpBKtZjKf9SXiHDgjx4dQ,1266
+openmail/assistants/summarize_attachments_for_email.py,sha256=_UdGKavZ9xiQ9MJ5N8XcU5SlNKfP1S2pl6xImS3QCPo,2944
+openmail/assistants/summarize_thread_emails.py,sha256=kUSoNDMp_14XEoNJznMmxiSG2HoQddgGBA1O2aJCNv4,1614
+openmail/assistants/summary.py,sha256=1n85A9yCr-ufXz02-aJ-jdjlmvgfph2ty6zh1EpXlTk,1162
+openmail/assistants/summary_multi.py,sha256=DQ44LPKQaySxJWBs959gB9adDx_Uvi9crr02JHNhNnY,1572
+openmail/assistants/translate_email.py,sha256=FOFUXnpeWoV-4wkfQdllsRF9hhdxAt7qpW4n3ugSWMY,1411
+openmail/auth/__init__.py,sha256=mi-R50ziAvG20DaCkMoFXyVR5LZrt12NddES7j5k618,287
+openmail/auth/base.py,sha256=Kw-pCOqtijn5d2YqDZDIEzgCG6F4oEkmuzD9yR7xBjo,737
+openmail/auth/no_auth.py,sha256=X0d-Amz4jYBeGfDJ9yBXzJ4ztHCj5GNrWLLWKnDxQzs,455
+openmail/auth/oauth2.py,sha256=pmTDgGbR35Pxd13ANZk_-n8q_HJS2p0K7QtjOWRwc1M,1991
+openmail/auth/password.py,sha256=VbjtwcC4t7q2u5rmvctMbINGqe87qpRY4oZvHLw87O0,782
+openmail/imap/__init__.py,sha256=Ah1yUW4h9OkYM5v1rO666IgwCGD50ZzS8-CQeltsuXQ,201
+openmail/imap/attachment_parts.py,sha256=qeRBLk4EEKNgYcFR-1tDVOMZ56B2cqcICxDpqoorfcw,1775
+openmail/imap/bodystructure.py,sha256=TqaZH2_n2pn7ayvUL7eMhmfvdPJjU6g-NLAcivuTeCk,8866
+openmail/imap/client.py,sha256=qmioHgvufxPOwICdPwLlQS8Rr4UlaUJPKYfGerqP0vg,28394
+openmail/imap/fetch_response.py,sha256=xJzyvew2-7TGbYNcb2ZITmdlV5KQ4fs4wxxn2sfPw18,3327
+openmail/imap/inline_cid.py,sha256=_Tb6B4WtQyUjQhmtR7xpLdgvMTQoASyPCkBIxNfy6rg,2841
+openmail/imap/pagination.py,sha256=hwCxt-tERiXpoYMcgO1p6oLLnaboGj2EQ_ps4Z367Ok,413
+openmail/imap/parser.py,sha256=0_b9CEqEzvnVxesrB_OuvTpQXlPNJw6Kaf9HbnIZONs,9785
+openmail/imap/query.py,sha256=BSA0Z5gS2RLssRb4HuP9H-0ThIMy2C4DuRSBsPD4fiQ,6128
+openmail/llm/__init__.py,sha256=UyVDb6OUz1OAFVxPB3ev_E0760hxSday5wD1my99vqc,66
+openmail/llm/claude.py,sha256=zYHKe3CZhp9GClhl759IH8MSx7hkzvx8CiIEOtBuQ70,880
+openmail/llm/costs.py,sha256=vDgeVdHtfu3cBlTuFtw0rlIl7X5bkvOHD7bO0BdcCes,4647
+openmail/llm/gemini.py,sha256=nhasXz-sny6IEdI8ig63DimeG6pKXTrQNkg7IPyOHgI,945
+openmail/llm/gpt.py,sha256=6495mfPCaWb1RaaomTEod9Q0jKgOMic7KU0ozSiBLaE,869
+openmail/llm/groq.py,sha256=DH5Y4nHgCGaVhC5iRmV6fa_5tc_sEi9q5GtYq5FaT5A,911
+openmail/llm/model.py,sha256=ZbKS8UQzcgBaP8oElEO0JARWRa6OvqT1vcKkFj1Jmwk,4445
+openmail/llm/xai.py,sha256=rPZ4bACcYFCIG-_Y77ZTUV4jrWqxsuDp7Grrjdr0GrA,859
+openmail/models/__init__.py,sha256=vjXN7gq2L76wXtJxDLYl2gFr6WNIFDfgnXOa8KZ71xc,517
+openmail/models/attachment.py,sha256=3cJObSYRNT8pOfWtXU1buYELTYa7Pks6wPnv5Lk7z9A,4184
+openmail/models/message.py,sha256=qTXN2Z_6xhEau31_c3ixK-J8YhnjV2Hw3vsiqjDET4A,3455
+openmail/models/subscription.py,sha256=_hjYiV51dIZNL3iGgWSi56Ng5psDGhlCMhq92UW00uU,1106
+openmail/models/task.py,sha256=4B0hYtqJvKDzOOkx81Ly5RviipgHUUpXGUm9lf-KEkw,683
+openmail/smtp/__init__.py,sha256=VQC2DFBjUSDJyAXe8HSzvS4ZhW5otbt_-mzVXooSCF0,154
+openmail/smtp/builder.py,sha256=nzwLmY2cZTG-3vdBR9mLM37bYLPzLM3DAdYhIAl5Ftw,1246
+openmail/smtp/client.py,sha256=68S8Laybyyc71FkypOUsrIh5juhOtHfJpGDWNx-MGLg,7626
+openmail/smtp/templates.py,sha256=aWxdLbWDaZKZCc5cVXX0zFmvVYj7JnypvUzujeOVz18,448
+openmail/subscription/__init__.py,sha256=-dHRDCFMHZF-Eui6Vcyin9WHDUCdXTkBkNi0fqHmq-Q,196
+openmail/subscription/detector.py,sha256=9FkjX18C6d4BwGom0CdpEtFyf8pFW1OXsmxMe9B_J0M,1559
+openmail/subscription/parser.py,sha256=zeuorhc_WeY-5ohE4dk7vBTPBkX6SUveOKsvFQ9J-0k,821
+openmail/subscription/service.py,sha256=brpjPFE2gGRLonQGsipx_Omptde2z8EVDwbEDD7CzhA,7872
+openmail/utils/__init__.py,sha256=fS-5nzamMwi657FiO2xUyrkp2_twYa0EOh1A0KwkMN0,850
+openmail/utils/utils.py,sha256=CuxTLKVruYuL4SXXyTwBj_Yy7E0BEr052S0SlYAnHcs,8601
+openmail-0.1.5.dist-info/METADATA,sha256=1cujOBC9u7tqMi0tNjJAEJEOxTgi6PlxNuEEn9tlFqI,4575
+openmail-0.1.5.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+openmail-0.1.5.dist-info/licenses/LICENSE,sha256=2htf3uSWeEqDLhxmsfC_sIw2GI6mlS4-qsMGR_9mxok,1066
+openmail-0.1.5.dist-info/RECORD,,

openmail-0.1.5.dist-info/WHEEL

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

openmail-0.1.5.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Luigi Liu
+
+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.