Skip to content

bovine.utils

activity_pub_object_id_from_html_body(body)

Determines the object identifier from the html body by parsing it and looking for link tags with rel=”alternate” and type application/activity+json

Source code in bovine/bovine/utils/__init__.py 
58
59
60
61
62
63
64
65
66
67
68
69
70
def activity_pub_object_id_from_html_body(body: str) -> str | None:
    """Determines the object identifier from the html body
    by parsing it and looking for link tags with rel="alternate"
    and type application/activity+json"""

    soup = BeautifulSoup(body, features="lxml")
    element = soup.find(
        "link", attrs={"rel": "alternate", "type": "application/activity+json"}
    )
    if not element:
        return None

    return element.attrs.get("href")

check_max_offset_now(dt, minutes=5)

Checks that offset of a datetime to now to be less than minutes

Source code in bovine/bovine/utils/__init__.py 
84
85
86
87
88
89
90
91
92
93
94
95
def check_max_offset_now(dt: datetime, minutes: int = 5) -> bool:
    """Checks that offset of a datetime to now to be less than minutes"""

    now = datetime.now(tz=timezone.utc)

    if dt > now + timedelta(minutes=minutes):
        return False

    if dt < now - timedelta(minutes=minutes):
        return False

    return True

get_gmt_now()

Returns the current time in UTC as a GMT formatted string as used in the HTTP Date header

Source code in bovine/bovine/utils/__init__.py 
73
74
75
76
def get_gmt_now() -> str:
    """Returns the current time in UTC as a GMT formatted string as used
    in the HTTP Date header"""
    return datetime.now(tz=timezone.utc).strftime(GMT_STRING)

now_isoformat()

Returns now in Isoformat, e.g. “2023-05-31T18:11:35Z”, to be used as the value of published

Source code in bovine/bovine/utils/__init__.py 
49
50
51
52
53
54
55
def now_isoformat() -> str:
    """Returns now in Isoformat, e.g. "2023-05-31T18:11:35Z", to be used as the value
    of published"""
    return (
        datetime.now(tz=timezone.utc).replace(microsecond=0, tzinfo=None).isoformat()
        + "Z"
    )

parse_fediverse_handle(account)

Splits fediverse handle in name and domain Supported forms are:

  • user@domain -> (user, domain)
  • @user@domain -> (user, domain)
  • acct:user@domain -> (user, domain)
Source code in bovine/bovine/utils/__init__.py 
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
def parse_fediverse_handle(account: str) -> Tuple[str, Optional[str]]:
    """Splits fediverse handle in name and domain Supported forms are:

    * user@domain -> (user, domain)
    * @user@domain -> (user, domain)
    * acct:user@domain -> (user, domain)
    """
    if account[0] == "@":
        account = account[1:]
    account = account.removeprefix("acct:")

    if "@" in account:
        user, domain = account.split("@", 1)
        return user, domain
    return account, None

parse_gmt(date_string)

Parses a GMT formatted string as used in HTTP Date header

Source code in bovine/bovine/utils/__init__.py 
79
80
81
def parse_gmt(date_string: str) -> datetime:
    """Parses a GMT formatted string as used in HTTP Date header"""
    return datetime.strptime(date_string, GMT_STRING).replace(tzinfo=timezone.utc)

pydantic_to_json(obj)

Transforms a pydantic object from bovine.models into a dictionary, that can be serialized as json

Source code in bovine/bovine/utils/__init__.py 
16
17
18
19
def pydantic_to_json(obj) -> dict:
    """Transforms a pydantic object from [bovine.models][bovine.models]
    into a dictionary, that can be serialized as json"""
    return obj.model_dump(mode="json", exclude_none=True)

webfinger_response_json(account, url)

helper to generate a webfinger response

Source code in bovine/bovine/utils/__init__.py 
22
23
24
25
26
27
28
29
def webfinger_response_json(account: str, url: str) -> dict:
    """helper to generate a webfinger response"""
    return pydantic_to_json(
        JrdData(
            subject=account,
            links=[JrdLink(href=url, rel="self", type="application/activity+json")],
        )
    )