tempemail-sdk 1.2.1__tar.gz → 1.2.2.dev0__tar.gz

{tempemail_sdk-1.2.1 → tempemail_sdk-1.2.2.dev0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tempemail-sdk
-Version: 1.2.1
+Version: 1.2.2.dev0
 Summary: 临时邮箱 SDK，所有渠道返回统一标准化格式
 License: GPL-3.0
 Requires-Python: >=3.10
@@ -15,7 +15,7 @@ Requires-Dist: pygments>=2.19.2; extra == "dev"
 
 [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
 
-临时邮箱 SDK（Python），支持 **25** 个邮箱服务提供商，顺序与 `client.py` 中 `ALL_CHANNELS` 一致，返回格式与根目录 README 描述一致（无 `tempmailg`，与 npm/Rust/C 一致）。
+临时邮箱 SDK（Python），支持 **27** 个邮箱服务提供商，顺序与 `client.py` 中 `ALL_CHANNELS` 一致，返回格式与根目录 README 描述一致，并与 Go / npm / Rust / C 对齐。
 
 ## 安装
 
@@ -34,8 +34,10 @@ pip install https://github.com/XxxXTeam/tempmail-sdk/releases/latest/download/te
 | `tempmail` | tempmail.ing | - | 支持自定义有效期 |
 | `tempmail-cn` | tempmail.cn | - | Socket.IO：`request shortid` / `set shortid` / `mail`；`GenerateEmailOptions.domain` 可指定自定义接入域名 |
 | `tmpmails` | tmpmails.com | ✅ | Next.js Server Action 收信；`domain` 可选语言路径 |
+| `tempmailg` | tempmailg.com | ✅ | 独立 `requests.Session` 建邮；`GET /public/{locale}` + `POST /public/get_messages`；Token `tmg1:` + Base64(JSON)；`domain` 可选语言路径 |
 | `ta-easy` | ta-easy.com | ✅ | REST `api-endpoint.ta-easy.com` |
 | `10mail-wangtz` | 10mail.wangtz.cn | - | REST `/api/tempMail`、`/api/emailList`；**默认跳过 TLS 证书校验** |
+| `10minute-one` | 10minutemail.one | ✅ | SSR / JWT + Web API；`GenerateEmailOptions.domain` 可选 |
 | `linshi-email` | linshi-email.com | - | |
 | `linshiyou` | linshiyou.com | ✅ | `NEXUS_TOKEN` + Cookie；HTML 分段解析 |
 | `mffac` | mffac.com | ✅ | mailbox `id`；REST 24h |

{tempemail_sdk-1.2.1 → tempemail_sdk-1.2.2.dev0}/README.md

@@ -2,7 +2,7 @@
 
 [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
 
-临时邮箱 SDK（Python），支持 **25** 个邮箱服务提供商，顺序与 `client.py` 中 `ALL_CHANNELS` 一致，返回格式与根目录 README 描述一致（无 `tempmailg`，与 npm/Rust/C 一致）。
+临时邮箱 SDK（Python），支持 **27** 个邮箱服务提供商，顺序与 `client.py` 中 `ALL_CHANNELS` 一致，返回格式与根目录 README 描述一致，并与 Go / npm / Rust / C 对齐。
 
 ## 安装
 
@@ -21,8 +21,10 @@ pip install https://github.com/XxxXTeam/tempmail-sdk/releases/latest/download/te
 | `tempmail` | tempmail.ing | - | 支持自定义有效期 |
 | `tempmail-cn` | tempmail.cn | - | Socket.IO：`request shortid` / `set shortid` / `mail`；`GenerateEmailOptions.domain` 可指定自定义接入域名 |
 | `tmpmails` | tmpmails.com | ✅ | Next.js Server Action 收信；`domain` 可选语言路径 |
+| `tempmailg` | tempmailg.com | ✅ | 独立 `requests.Session` 建邮；`GET /public/{locale}` + `POST /public/get_messages`；Token `tmg1:` + Base64(JSON)；`domain` 可选语言路径 |
 | `ta-easy` | ta-easy.com | ✅ | REST `api-endpoint.ta-easy.com` |
 | `10mail-wangtz` | 10mail.wangtz.cn | - | REST `/api/tempMail`、`/api/emailList`；**默认跳过 TLS 证书校验** |
+| `10minute-one` | 10minutemail.one | ✅ | SSR / JWT + Web API；`GenerateEmailOptions.domain` 可选 |
 | `linshi-email` | linshi-email.com | - | |
 | `linshiyou` | linshiyou.com | ✅ | `NEXUS_TOKEN` + Cookie；HTML 分段解析 |
 | `mffac` | mffac.com | ✅ | mailbox `id`；REST 24h |

{tempemail_sdk-1.2.1 → tempemail_sdk-1.2.2.dev0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tempemail-sdk"
-version = "1.2.01"
+version = "1.2.02-dev"
 description = "临时邮箱 SDK，所有渠道返回统一标准化格式"
 readme = "README.md"
 license = {text = "GPL-3.0"}

{tempemail_sdk-1.2.1 → tempemail_sdk-1.2.2.dev0}/tempemail_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tempemail-sdk
-Version: 1.2.1
+Version: 1.2.2.dev0
 Summary: 临时邮箱 SDK，所有渠道返回统一标准化格式
 License: GPL-3.0
 Requires-Python: >=3.10
@@ -15,7 +15,7 @@ Requires-Dist: pygments>=2.19.2; extra == "dev"
 
 [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
 
-临时邮箱 SDK（Python），支持 **25** 个邮箱服务提供商，顺序与 `client.py` 中 `ALL_CHANNELS` 一致，返回格式与根目录 README 描述一致（无 `tempmailg`，与 npm/Rust/C 一致）。
+临时邮箱 SDK（Python），支持 **27** 个邮箱服务提供商，顺序与 `client.py` 中 `ALL_CHANNELS` 一致，返回格式与根目录 README 描述一致，并与 Go / npm / Rust / C 对齐。
 
 ## 安装
 
@@ -34,8 +34,10 @@ pip install https://github.com/XxxXTeam/tempmail-sdk/releases/latest/download/te
 | `tempmail` | tempmail.ing | - | 支持自定义有效期 |
 | `tempmail-cn` | tempmail.cn | - | Socket.IO：`request shortid` / `set shortid` / `mail`；`GenerateEmailOptions.domain` 可指定自定义接入域名 |
 | `tmpmails` | tmpmails.com | ✅ | Next.js Server Action 收信；`domain` 可选语言路径 |
+| `tempmailg` | tempmailg.com | ✅ | 独立 `requests.Session` 建邮；`GET /public/{locale}` + `POST /public/get_messages`；Token `tmg1:` + Base64(JSON)；`domain` 可选语言路径 |
 | `ta-easy` | ta-easy.com | ✅ | REST `api-endpoint.ta-easy.com` |
 | `10mail-wangtz` | 10mail.wangtz.cn | - | REST `/api/tempMail`、`/api/emailList`；**默认跳过 TLS 证书校验** |
+| `10minute-one` | 10minutemail.one | ✅ | SSR / JWT + Web API；`GenerateEmailOptions.domain` 可选 |
 | `linshi-email` | linshi-email.com | - | |
 | `linshiyou` | linshiyou.com | ✅ | `NEXUS_TOKEN` + Cookie；HTML 分段解析 |
 | `mffac` | mffac.com | ✅ | mailbox `id`；REST 24h |

{tempemail_sdk-1.2.1 → tempemail_sdk-1.2.2.dev0}/tempemail_sdk.egg-info/SOURCES.txt

@@ -39,6 +39,7 @@ tempmail_sdk/providers/temp_mail_io.py
 tempmail_sdk/providers/tempmail.py
 tempmail_sdk/providers/tempmail_cn.py
 tempmail_sdk/providers/tempmail_lol.py
+tempmail_sdk/providers/tempmailg.py
 tempmail_sdk/providers/temporary_email_org.py
 tempmail_sdk/providers/tenmail_wangtz.py
 tempmail_sdk/providers/tenminute_one.py

{tempemail_sdk-1.2.1 → tempemail_sdk-1.2.2.dev0}/tempmail_sdk/client.py

@@ -14,7 +14,7 @@ from .retry import with_retry, with_retry_with_attempts
 from .telemetry import report_telemetry
 from .logger import get_logger
 from .providers import (
-    tempmail, tempmail_cn, tmpmails, ta_easy, tenmail_wangtz, linshi_email, linshiyou, mffac, tempmail_lol, chatgpt_org_uk,
+    tempmail, tempmail_cn, tmpmails, tempmailg, ta_easy, tenmail_wangtz, linshi_email, linshiyou, mffac, tempmail_lol, chatgpt_org_uk,
     temp_mail_io, awamail, temporary_email_org, mail_tm, mail_cx,
     dropmail, guerrillamail, maildrop, smail_pw,
     boomlify, minmail, vip_215, anonbox, fake_legal, moakt, tenminute_one,
@@ -22,10 +22,10 @@ from .providers import (
 
 # 所有支持的渠道列表
 ALL_CHANNELS = [
-    "tempmail", "tempmail-cn", "tmpmails", "ta-easy", "10mail-wangtz", "linshi-email", "linshiyou", "mffac", "tempmail-lol", "chatgpt-org-uk",
+    "tempmail", "tempmail-cn", "tmpmails", "tempmailg", "ta-easy", "10mail-wangtz", "10minute-one", "linshi-email", "linshiyou", "mffac", "tempmail-lol", "chatgpt-org-uk",
     "temp-mail-io", "awamail", "temporary-email-org", "mail-tm", "mail-cx",
     "dropmail", "guerrillamail", "maildrop", "smail-pw",
-    "boomlify", "minmail", "vip-215", "anonbox", "fake-legal", "moakt", "10minute-one",
+    "boomlify", "minmail", "vip-215", "anonbox", "fake-legal", "moakt",
 ]
 
 # 渠道信息映射表
@@ -33,8 +33,10 @@ CHANNEL_INFO_MAP = {
     "tempmail": ChannelInfo(channel="tempmail", name="TempMail", website="tempmail.ing"),
     "tempmail-cn": ChannelInfo(channel="tempmail-cn", name="TempMail CN", website="tempmail.cn"),
     "tmpmails": ChannelInfo(channel="tmpmails", name="TmpMails", website="tmpmails.com"),
+    "tempmailg": ChannelInfo(channel="tempmailg", name="TempMailG", website="tempmailg.com"),
     "ta-easy": ChannelInfo(channel="ta-easy", name="TA Easy", website="ta-easy.com"),
     "10mail-wangtz": ChannelInfo(channel="10mail-wangtz", name="10mail Wangtz", website="10mail.wangtz.cn"),
+    "10minute-one": ChannelInfo(channel="10minute-one", name="10 Minute Email", website="10minutemail.one"),
     "linshi-email": ChannelInfo(channel="linshi-email", name="临时邮箱", website="linshi-email.com"),
     "linshiyou": ChannelInfo(channel="linshiyou", name="临时邮", website="linshiyou.com"),
     "mffac": ChannelInfo(channel="mffac", name="MFFAC", website="mffac.com"),
@@ -55,7 +57,6 @@ CHANNEL_INFO_MAP = {
     "anonbox": ChannelInfo(channel="anonbox", name="Anonbox", website="anonbox.net"),
     "fake-legal": ChannelInfo(channel="fake-legal", name="Fake Legal", website="fake.legal"),
     "moakt": ChannelInfo(channel="moakt", name="Moakt", website="moakt.com"),
-    "10minute-one": ChannelInfo(channel="10minute-one", name="10 Minute Email", website="10minutemail.one"),
 }
 
 
@@ -137,10 +138,14 @@ def _generate_email_once(channel: str, options: GenerateEmailOptions) -> EmailIn
         return tempmail_cn.generate_email(options.domain)
     elif channel == "tmpmails":
         return tmpmails.generate_email(options.domain)
+    elif channel == "tempmailg":
+        return tempmailg.generate_email(options.domain)
     elif channel == "ta-easy":
         return ta_easy.generate_email()
     elif channel == "10mail-wangtz":
         return tenmail_wangtz.generate_email(options.domain)
+    elif channel == "10minute-one":
+        return tenminute_one.generate_email(options.domain)
     elif channel == "linshi-email":
         return linshi_email.generate_email()
     elif channel == "linshiyou":
@@ -181,8 +186,6 @@ def _generate_email_once(channel: str, options: GenerateEmailOptions) -> EmailIn
         return fake_legal.generate_email(options.domain)
     elif channel == "moakt":
         return moakt.generate_email(options.domain)
-    elif channel == "10minute-one":
-        return tenminute_one.generate_email(options.domain)
     else:
         raise ValueError(f"Unknown channel: {channel}")
 
@@ -253,6 +256,10 @@ def _get_emails_once(channel: str, email: str, token: Optional[str]) -> List[Ema
         if not token:
             raise ValueError("token is required for tmpmails channel")
         return tmpmails.get_emails(email, token)
+    elif channel == "tempmailg":
+        if not token:
+            raise ValueError("token is required for tempmailg channel")
+        return tempmailg.get_emails(email, token)
     elif channel == "ta-easy":
         if not token:
             raise ValueError("token is required for ta-easy channel")

tempemail_sdk-1.2.2.dev0/tempmail_sdk/providers/tempmailg.py

@@ -0,0 +1,197 @@
+"""
+tempmailg.com：独立 Session GET /public/{locale} + POST get_messages；Token 为 tmg1: + base64(JSON)。
+"""
+
+import base64
+import json
+import re
+from typing import List, Optional
+
+import requests
+from urllib.parse import quote
+
+from ..config import get_config
+from ..normalize import normalize_email
+from ..types import EmailInfo, Email
+
+CHANNEL = "tempmailg"
+ORIGIN = "https://tempmailg.com"
+TOK_PREFIX = "tmg1:"
+
+CSRF_RE = re.compile(r'<meta\s+name="csrf-token"\s+content="([^"]+)"', re.I)
+
+_UA = (
+    "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) "
+    "Chrome/146.0.0.0 Safari/537.36 Edg/146.0.0.0"
+)
+
+
+def _ephemeral_session() -> requests.Session:
+    cfg = get_config()
+    s = requests.Session()
+    s.verify = not cfg.insecure
+    if cfg.proxy:
+        s.proxies = {"http": cfg.proxy, "https": cfg.proxy}
+    if cfg.headers:
+        s.headers.update(cfg.headers)
+    return s
+
+
+def _locale(domain: Optional[str]) -> str:
+    s = (domain or "").strip()
+    if not s or any(c in s for c in "/?#\\"):
+        return "zh"
+    return s
+
+
+def _cookie_map(hdr: str) -> dict:
+    m = {}
+    for part in hdr.split(";"):
+        p = part.strip()
+        if "=" in p:
+            k, v = p.split("=", 1)
+            k, v = k.strip(), v.strip()
+            if k:
+                m[k] = v
+    return m
+
+
+def _cookie_hdr_from_map(m: dict) -> str:
+    return "; ".join(f"{k}={m[k]}" for k in sorted(m.keys()))
+
+
+def _merge_set_cookies(prev: str, resp: requests.Response) -> str:
+    m = _cookie_map(prev)
+    for c in resp.cookies.items():
+        m[str(c[0])] = str(c[1])
+    return _cookie_hdr_from_map(m)
+
+
+def _xsrf(cookie_hdr: str) -> str:
+    m = _cookie_map(cookie_hdr)
+    for key in ("XSRF-TOKEN", "xsrf-token"):
+        if key in m:
+            return m[key]
+    for k, v in m.items():
+        if k.lower() == "xsrf-token":
+            return v
+    return ""
+
+
+def _parse_csrf(html: str) -> str:
+    m = CSRF_RE.search(html)
+    if not m or not (t := m.group(1).strip()):
+        raise RuntimeError("tempmailg: csrf-token not found in page")
+    return t
+
+
+def _encode_token(locale: str, cookie_hdr: str, csrf: str) -> str:
+    raw = json.dumps({"l": locale, "c": cookie_hdr, "s": csrf}, separators=(",", ":"))
+    return TOK_PREFIX + base64.b64encode(raw.encode("utf-8")).decode("ascii")
+
+
+def _decode_token(tok: str) -> dict:
+    if not tok.startswith(TOK_PREFIX):
+        raise ValueError("tempmailg: invalid session token")
+    raw = base64.b64decode(tok[len(TOK_PREFIX) :].encode("ascii")).decode("utf-8")
+    o = json.loads(raw)
+    if not o.get("c") or not o.get("s"):
+        raise ValueError("tempmailg: invalid session token")
+    return o
+
+
+def generate_email(domain: Optional[str] = None, **kwargs) -> EmailInfo:
+    loc = _locale(domain)
+    page_url = f"{ORIGIN}/public/{quote(loc, safe='')}"
+    cfg = get_config()
+    timeout = cfg.timeout
+    s = _ephemeral_session()
+
+    r = s.get(
+        page_url,
+        headers={
+            "User-Agent": _UA,
+            "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
+            "Accept-Language": "zh-CN,zh;q=0.9,en;q=0.8",
+            "Cache-Control": "no-cache",
+            "DNT": "1",
+            "Pragma": "no-cache",
+            "Referer": page_url,
+            "Upgrade-Insecure-Requests": "1",
+        },
+        timeout=timeout,
+    )
+    r.raise_for_status()
+    html = r.text
+    csrf = _parse_csrf(html)
+    cookie_hdr = _merge_set_cookies("", r)
+    xsrf = _xsrf(cookie_hdr)
+    if not xsrf:
+        raise RuntimeError("tempmailg: missing XSRF-TOKEN cookie")
+
+    post_url = f"{ORIGIN}/public/get_messages"
+    r2 = s.post(
+        post_url,
+        json={"_token": csrf},
+        headers={
+            "User-Agent": _UA,
+            "Accept": "application/json, text/plain, */*",
+            "Accept-Language": "zh-CN,zh;q=0.9,en;q=0.8",
+            "Content-Type": "application/json",
+            "Origin": ORIGIN,
+            "Referer": page_url,
+            "Cache-Control": "no-cache",
+            "Pragma": "no-cache",
+            "DNT": "1",
+            "Cookie": cookie_hdr,
+            "X-XSRF-TOKEN": xsrf,
+        },
+        timeout=timeout,
+    )
+    r2.raise_for_status()
+    wrap = r2.json()
+    if not wrap.get("status") or not wrap.get("mailbox"):
+        raise RuntimeError("tempmailg: create mailbox failed")
+    cookie_hdr = _merge_set_cookies(cookie_hdr, r2)
+    tok = _encode_token(loc, cookie_hdr, csrf)
+    return EmailInfo(channel=CHANNEL, email=wrap["mailbox"], _token=tok)
+
+
+def get_emails(email: str, token: str) -> List[Email]:
+    o = _decode_token(token)
+    loc = o.get("l") or "zh"
+    page_url = f"{ORIGIN}/public/{quote(str(loc), safe='')}"
+    post_url = f"{ORIGIN}/public/get_messages"
+    cookie_hdr = str(o["c"])
+    xsrf = _xsrf(cookie_hdr)
+    cfg = get_config()
+
+    r = requests.post(
+        post_url,
+        json={"_token": o["s"]},
+        headers={
+            "User-Agent": _UA,
+            "Accept": "application/json, text/plain, */*",
+            "Accept-Language": "zh-CN,zh;q=0.9,en;q=0.8",
+            "Content-Type": "application/json",
+            "Origin": ORIGIN,
+            "Referer": page_url,
+            "Cache-Control": "no-cache",
+            "Pragma": "no-cache",
+            "DNT": "1",
+            "Cookie": cookie_hdr,
+            "X-XSRF-TOKEN": xsrf,
+        },
+        timeout=cfg.timeout,
+        verify=not cfg.insecure,
+        proxies={"http": cfg.proxy, "https": cfg.proxy} if cfg.proxy else None,
+    )
+    r.raise_for_status()
+    wrap = r.json()
+    if not wrap.get("status"):
+        raise RuntimeError("tempmailg: get_messages failed")
+    mb = (wrap.get("mailbox") or "").strip()
+    if mb and mb.lower() != email.strip().lower():
+        raise RuntimeError("tempmailg: mailbox mismatch")
+    messages = wrap.get("messages") or []
+    return [normalize_email(m, email) for m in messages if isinstance(m, dict)]

{tempemail_sdk-1.2.1 → tempemail_sdk-1.2.2.dev0}/tempmail_sdk/types.py

@@ -10,6 +10,7 @@ Channel = Literal[
     "tempmail",
     "tempmail-cn",
     "tmpmails",
+    "tempmailg",
     "ta-easy",
     "10mail-wangtz",
     "10minute-one",