detrack 0.1.0__py3-none-any.whl

detrack/__init__.py

@@ -0,0 +1,4 @@
+from detrack.core import clean, clean_query, DetrackResult
+from detrack.patterns import DEFAULT_PATTERNS
+
+__all__ = ["clean", "clean_query", "DEFAULT_PATTERNS", "DetrackResult"]

detrack/core.py

@@ -0,0 +1,69 @@
+from dataclasses import dataclass
+from urllib.parse import parse_qsl, urlencode, urlsplit, urlunsplit
+from urllib.parse import SplitResult
+
+from detrack.patterns import DEFAULT_PATTERNS
+
+
+@dataclass
+class DetrackResult:
+    url: str
+    parsed_url: SplitResult
+    cleaned_params: dict[str, str]
+    removed_params: list[str]
+
+
+def _filter_pairs(
+    query: str,
+    patterns: list[str] | None = None,
+) -> tuple[list[tuple[str, str]], list[str]]:
+    patterns_set = frozenset(p.lower() for p in (patterns or list(DEFAULT_PATTERNS)))
+    pairs = parse_qsl(query, keep_blank_values=True)
+    cleaned: list[tuple[str, str]] = []
+    removed: list[str] = []
+    for key, val in pairs:
+        if key.lower() in patterns_set:
+            removed.append(key)
+        else:
+            cleaned.append((key, val))
+    return cleaned, removed
+
+
+def clean_query(query: str, patterns: list[str] | None = None) -> str:
+    cleaned, _ = _filter_pairs(query, patterns)
+    return urlencode(cleaned, doseq=True)
+
+
+def clean(url: str, patterns: list[str] | None = None) -> DetrackResult:
+    try:
+        parsed = urlsplit(url)
+        if not parsed.query:
+            return DetrackResult(
+                url=url,
+                parsed_url=parsed,
+                cleaned_params={},
+                removed_params=[],
+            )
+        cleaned_pairs, removed = _filter_pairs(parsed.query, patterns)
+        cleaned_qs = urlencode(cleaned_pairs, doseq=True)
+        cleaned_dict = dict(cleaned_pairs)
+        new_url = urlunsplit((
+            parsed.scheme,
+            parsed.netloc,
+            parsed.path,
+            cleaned_qs,
+            parsed.fragment,
+        ))
+        return DetrackResult(
+            url=new_url,
+            parsed_url=parsed,
+            cleaned_params=cleaned_dict,
+            removed_params=removed,
+        )
+    except Exception:
+        return DetrackResult(
+            url=url,
+            parsed_url=urlsplit(""),
+            cleaned_params={},
+            removed_params=[],
+        )

detrack/patterns.py

@@ -0,0 +1,24 @@
+DEFAULT_PATTERNS = frozenset({
+    # UTM
+    "utm_source", "utm_medium", "utm_campaign", "utm_term", "utm_content",
+    "utm_id", "utm_cid", "utm_reader", "utm_viz", "utm_pubreferrer",
+    "utm_nooverride",
+    # Social
+    "fbclid", "ref", "source", "si", "sns", "social", "origin",
+    # Marketing / Ad
+    "gclid", "gclsrc", "dclid", "msclkid", "wbraid", "gbraid",
+    "mc_cid", "mc_eid", "trk", "vero_conv", "vero_id",
+    "email", "recipient", "campaign_id", "newsletter", "mbid",
+    # Analytics
+    "_ga", "_gl", "_ke", "_hsenc",
+    # Cache busters
+    "_", "cb", "cache", "nocache", "rand", "random", "r", "ts", "_t",
+    "timestamp",
+    # Session / visit
+    "session_id", "sid", "phpsessid", "jsessionid", "view_id", "visit_id",
+    # Redirect
+    "redirect_to", "return_to", "next", "continue",
+    # Misc / platform-specific
+    "yclid", "igshid", "_openstat", "oft_id", "wt_mc", "mtm_source",
+    "mtm_medium", "mtm_campaign", "mtm_keyword", "mtm_content",
+})

detrack-0.1.0.dist-info/METADATA

@@ -0,0 +1,27 @@
+Metadata-Version: 2.4
+Name: detrack
+Version: 0.1.0
+Summary: Strip tracking parameters from URLs. Deterministically. Zero dependencies.
+Author-email: Emiliano Gandini Outeda <emiliano.gandini@protonmail.com>
+License: MIT
+Project-URL: Source, https://github.com/emiliano-gandini-outeda/detrack
+Keywords: seo,tracking,privacy,utm,url-cleaner
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Dynamic: license-file
+
+# detrack
+ Strip tracking parameters from URLs. Deterministically. Zero dependencies.

detrack-0.1.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+detrack/__init__.py,sha256=W-OUl2Oxqa6oyRbPGeYGi2ana3jlCFE3TPeeqhk3_pM,178
+detrack/core.py,sha256=L_0dXYWMHCBa1f8kueyecfbA_gfQwaz8zRXz5jNXAsg,2021
+detrack/patterns.py,sha256=iYK9b-guvJUSdzZYJCyV8czjPlJioTWQ8tS3Jxz-Lvw,975
+detrack-0.1.0.dist-info/licenses/LICENSE,sha256=j-nWtNMq208SfNLoV0UlmFXK9AH3GPZBmZPS5EzZsY4,1080
+detrack-0.1.0.dist-info/METADATA,sha256=o6qJ_b1VxmBL_eSsyGRer-_sRIIu4MDq4jla-HlGxe4,1102
+detrack-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+detrack-0.1.0.dist-info/top_level.txt,sha256=OsYCxrfpA1LozJyqYvPwAFJJOZMOJXMFtB8G5qXWnpQ,8
+detrack-0.1.0.dist-info/RECORD,,

detrack-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
+

detrack-0.1.0.dist-info/licenses/LICENSE

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

detrack-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+detrack