Skip to content

get

Get a RaBe CRID.

get(timestamp=None, fragment='')

Get a RaBe CRID.

Examples:

You can get a CRID for a specific time.

```python
>>> from datetime import datetime
>>> from pytz import timezone
>>> crid = get(datetime(2020, 3, 1, 00, 00, tzinfo=timezone('Europe/Zurich')))
>>> print(f"version: {crid.version}, start: {crid.start}")
version: v1, start: ...

```

timestamp: Exact time you want a CRID for.
    If left empty, a CRID for the current time is generated.
fragment: Optional fragment to add to the end of the CRID.

CRID: The generated CRID.
Source code in cridlib/get.py 
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
def get(timestamp: datetime | None = None, fragment: str = "") -> CRID:
    """Get a RaBe CRID.

    Examples:
    --------
        You can get a CRID for a specific time.

        ```python
        >>> from datetime import datetime
        >>> from pytz import timezone
        >>> crid = get(datetime(2020, 3, 1, 00, 00, tzinfo=timezone('Europe/Zurich')))
        >>> print(f"version: {crid.version}, start: {crid.start}")
        version: v1, start: ...

        ```

    Args:
    ----
        timestamp: Exact time you want a CRID for.
            If left empty, a CRID for the current time is generated.
        fragment: Optional fragment to add to the end of the CRID.

    Returns:
    -------
        CRID: The generated CRID.

    """
    _now = datetime.now(timezone.utc)
    _ts = timestamp or _now
    _show = ""
    if _ts == _now:
        _show = now.get_show()
    elif _ts < _now:
        _show = past.get_show(past=_ts)
    elif _ts > _now:  # pragma: no cover
        _show = future.get_show(future=_ts)

    if _show:
        _show = canonicalize_show(_show)

    _tscode = f"t=clock={_ts.strftime('%Y%m%dT%H%M%S.%f')[:-4]}Z"
    _fragment = f"{_tscode}{'&' + fragment if fragment else ''}"

    return CRID(f"crid://rabe.ch/v1{'/' + _show if _show else ''}#{_fragment}")