kachi

Make a protected link unsafe.

Requirements

• Python 3.10+

Installation

pip install kachi

Usage

from kachi import unsafe_link

result = unsafe_link("https://nam01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fexample.com")
print(result)  # https://example.com

Bundled Rules

Rule Schema

Each rule is a YAML file with the following structure:

name: example_rule
filter:
  hostname: example.com # exact match, or /regex/
  path: /redirect # optional, exact match or /regex/
pre_extract: # optional, transforms applied to URL before extraction
  - html_unescape
  - url_decode
extract:
  from: query_param # query_param, path_regex, or url_regex
  keys: [url, u] # for query_param: parameter names to try in order
  pattern: "/L0/(http[^/?#]+)" # for path_regex/url_regex: regex with capture group
  select: first # for query_param: first (default) or last
post_extract: # optional, transforms applied to extracted value
  - url_decode

Filter

• hostname (required): string or list of strings. Exact match or /regex/.
• path (optional): string or list of strings. Exact match or /regex/.

Extract Sources

Transforms