mailauth-records 0.1.0__tar.gz

mailauth_records-0.1.0/.gitignore

@@ -0,0 +1 @@
+.dotfiles

mailauth_records-0.1.0/LICENSE

@@ -0,0 +1,11 @@
+MIT License
+
+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.

mailauth_records-0.1.0/PKG-INFO

@@ -0,0 +1,29 @@
+Metadata-Version: 2.5
+Name: mailauth-records
+Version: 0.1.0
+Summary: Parse SPF, DMARC, MTA-STS and TLS-RPT DNS records into plain Python data (no dependencies)
+Author-email: mailcheck <pypi-n5t87@tuxguard.com>, mailcheck <pypi-nrklb@tuxguard.de>
+Maintainer-email: mailcheck <pypi-4fu64@tuxred.de>, mailcheck <pypi-btnse@ozapftis.cloud>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: dmarc,dns,email,mta-sts,spf,tls-rpt
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Communications :: Email
+Classifier: Topic :: Internet :: Name Service (DNS)
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# mailauth-records
+
+Parse mail-authentication DNS records into plain Python data. No dependencies.
+
+```python
+from mailauth_records import parse_dmarc, parse_spf
+
+parse_dmarc("v=DMARC1; p=reject; rua=mailto:dmarc@example.org")
+# {'v': 'DMARC1', 'p': 'reject', 'rua': ['mailto:dmarc@example.org'], 'sp': 'reject', 'adkim': 'r', 'aspf': 'r', 'pct': 100}
+
+parse_spf("v=spf1 mx ip4:192.0.2.0/24 -all")["all"]   # '-'
+```
+
+Supported: SPF (RFC 7208), DMARC (RFC 7489), MTA-STS (RFC 8461), TLS-RPT (RFC 8460).

mailauth_records-0.1.0/README.md

@@ -0,0 +1,14 @@
+# mailauth-records
+
+Parse mail-authentication DNS records into plain Python data. No dependencies.
+
+```python
+from mailauth_records import parse_dmarc, parse_spf
+
+parse_dmarc("v=DMARC1; p=reject; rua=mailto:dmarc@example.org")
+# {'v': 'DMARC1', 'p': 'reject', 'rua': ['mailto:dmarc@example.org'], 'sp': 'reject', 'adkim': 'r', 'aspf': 'r', 'pct': 100}
+
+parse_spf("v=spf1 mx ip4:192.0.2.0/24 -all")["all"]   # '-'
+```
+
+Supported: SPF (RFC 7208), DMARC (RFC 7489), MTA-STS (RFC 8461), TLS-RPT (RFC 8460).

mailauth_records-0.1.0/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "mailauth-records"
+version = "0.1.0"
+description = "Parse SPF, DMARC, MTA-STS and TLS-RPT DNS records into plain Python data (no dependencies)"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.9"
+authors = [
+  { name = "mailcheck", email = "pypi-n5t87@tuxguard.com" },
+  { name = "mailcheck", email = "pypi-nrklb@tuxguard.de" },
+]
+maintainers = [
+  { name = "mailcheck", email = "pypi-4fu64@tuxred.de" },
+  { name = "mailcheck", email = "pypi-btnse@ozapftis.cloud" },
+]
+keywords = ["dmarc", "spf", "mta-sts", "tls-rpt", "email", "dns"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Topic :: Communications :: Email",
+  "Topic :: Internet :: Name Service (DNS)",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/mailauth_records"]

mailauth_records-0.1.0/src/mailauth_records/__init__.py

@@ -0,0 +1,73 @@
+"""Parse mail-authentication DNS records (SPF, DMARC, MTA-STS, TLS-RPT) into plain Python data.
+
+>>> parse_dmarc("v=DMARC1; p=reject; rua=mailto:dmarc@example.org; adkim=s")["p"]
+'reject'
+>>> parse_spf("v=spf1 mx ip4:192.0.2.0/24 -all")["all"]
+'-'
+"""
+from __future__ import annotations
+
+__all__ = ["parse_tags", "parse_dmarc", "parse_spf", "parse_mta_sts", "parse_tlsrpt"]
+__version__ = "0.1.0"
+
+
+def parse_tags(record: str) -> dict[str, str]:
+    """Generic 'k=v; k=v' tag list (DMARC, MTA-STS, TLS-RPT). Keys are lower-cased, values stripped."""
+    out: dict[str, str] = {}
+    for part in record.split(";"):
+        if "=" in part:
+            k, v = part.split("=", 1)
+            out[k.strip().lower()] = v.strip()
+    return out
+
+
+def parse_dmarc(record: str) -> dict:
+    """DMARC record -> dict with defaults (RFC 7489: p required, sp=p, adkim/aspf=r, pct=100)."""
+    t = parse_tags(record)
+    if t.get("v", "").upper() != "DMARC1":
+        raise ValueError("not a DMARC record")
+    t.setdefault("sp", t.get("p", "none"))
+    t.setdefault("adkim", "r")
+    t.setdefault("aspf", "r")
+    t["pct"] = int(t.get("pct", "100"))
+    for k in ("rua", "ruf"):
+        if k in t:
+            t[k] = [u.strip() for u in t[k].split(",") if u.strip()]
+    return t
+
+
+def parse_spf(record: str) -> dict:
+    """SPF record -> {'mechanisms': [(qualifier, mechanism, value)], 'modifiers': {...}, 'all': qualifier|None}."""
+    terms = record.split()
+    if not terms or terms[0].lower() != "v=spf1":
+        raise ValueError("not an SPF record")
+    mechs, mods, allq = [], {}, None
+    for term in terms[1:]:
+        if "=" in term and ":" not in term.split("=", 1)[0]:
+            k, v = term.split("=", 1)
+            mods[k.lower()] = v
+            continue
+        q = term[0] if term[0] in "+-~?" else "+"
+        body = term[1:] if term[0] in "+-~?" else term
+        name, _, value = body.partition(":")
+        if name.lower() == "all":
+            allq = q
+        mechs.append((q, name.lower(), value or None))
+    return {"mechanisms": mechs, "modifiers": mods, "all": allq}
+
+
+def parse_mta_sts(record: str) -> dict[str, str]:
+    """_mta-sts TXT record (RFC 8461), e.g. 'v=STSv1; id=20240101'."""
+    t = parse_tags(record)
+    if t.get("v") != "STSv1":
+        raise ValueError("not an MTA-STS record")
+    return t
+
+
+def parse_tlsrpt(record: str) -> dict:
+    """_smtp._tls TXT record (RFC 8460), e.g. 'v=TLSRPTv1; rua=mailto:tls@example.org'."""
+    t = parse_tags(record)
+    if t.get("v") != "TLSRPTv1":
+        raise ValueError("not a TLS-RPT record")
+    t["rua"] = [u.strip() for u in t.get("rua", "").split(",") if u.strip()]
+    return t