Skip to content

json

JSONParser

Bases: SourceParser

The parser the extracts relevant arguments from a JSON file.

Parameters:

  • label (str) –

    The debugging label to indicate an argument was set in a JSON config file.

  • rank (int) –

    The priority of the parser. Generally, we aim between [0,100] for human-readabilty.

Source code in src/argmerge/json.py 
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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
class JSONParser(SourceParser):
    """The parser the extracts relevant arguments from a JSON file.

    params:
        label (str): The debugging label to indicate an argument was set in a JSON
            config file.
        rank (int): The priority of the parser. Generally, we aim between [0,100] for
            human-readabilty.

    """

    label: str = "JSON"
    rank: int = 10

    def __call__(
        cls,
        threshold_kwargs: dict[str, Any],
        change_ledger: dict[str, dict[str, str | int]],
        fpath_json: str | Path,
        debug: bool = False,
    ) -> tuple[dict, dict]:
        """Parse a JSON configuration file for arguments

         Args:
            threshold_kwargs (dict[str, Any]): kwargs passed around the
                @threshold decorator.
            change_ledger (dict[str, dict[str, str  |  int]]): Tracks when kwargs are
                updated inside the @threshold decorator.
            fpath_json (str | Path): The filepath to the JSON configuration file.
            debug (bool, optional): Flag to turn on more logging. Defaults to False.

        Raises:
            ValueError: If filepath extension is not `json`.

        Returns:
            tuple[dict, dict]: an updated `threshold_kwargs` and `change_ledger`.
        """
        _json_kwargs: dict

        if debug:
            LOGGER.remove()
            LOGGER.add(sys.stderr, level="DEBUG")

        LOGGER.debug(f"{threshold_kwargs=}")
        LOGGER.debug(f"{fpath_json=}")

        _fpath_json = Path(fpath_json)
        if _fpath_json == Path(""):
            LOGGER.debug("fpath_json not provided, skipping.")

        else:
            if _fpath_json.suffix != ".json":
                raise ValueError(
                    f"The JSON suffix of '{_fpath_json.as_posix()}' is not correct."
                    " Please use '.json'."
                )

            cls.label = f"JSON ({_fpath_json})"

            with open(fpath_json, "rb") as fy:
                _json_kwargs = json.load(fy)

            LOGGER.debug(f"{_json_kwargs=}")
            threshold_kwargs.update(_json_kwargs)
            LOGGER.debug(f"Updated {threshold_kwargs=}")

            for key in _json_kwargs:
                change_ledger[key] = {"label": cls.label, "rank": cls.rank}

        return threshold_kwargs, change_ledger

__call__ 

__call__(threshold_kwargs, change_ledger, fpath_json, debug=False)

Parse a JSON configuration file for arguments

Args: threshold_kwargs (dict[str, Any]): kwargs passed around the @threshold decorator. change_ledger (dict[str, dict[str, str | int]]): Tracks when kwargs are updated inside the @threshold decorator. fpath_json (str | Path): The filepath to the JSON configuration file. debug (bool, optional): Flag to turn on more logging. Defaults to False.

Raises:

  • ValueError –

    If filepath extension is not json.

Returns:

  • tuple[dict, dict] –

    tuple[dict, dict]: an updated threshold_kwargs and change_ledger.

Source code in src/argmerge/json.py 
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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
def __call__(
    cls,
    threshold_kwargs: dict[str, Any],
    change_ledger: dict[str, dict[str, str | int]],
    fpath_json: str | Path,
    debug: bool = False,
) -> tuple[dict, dict]:
    """Parse a JSON configuration file for arguments

     Args:
        threshold_kwargs (dict[str, Any]): kwargs passed around the
            @threshold decorator.
        change_ledger (dict[str, dict[str, str  |  int]]): Tracks when kwargs are
            updated inside the @threshold decorator.
        fpath_json (str | Path): The filepath to the JSON configuration file.
        debug (bool, optional): Flag to turn on more logging. Defaults to False.

    Raises:
        ValueError: If filepath extension is not `json`.

    Returns:
        tuple[dict, dict]: an updated `threshold_kwargs` and `change_ledger`.
    """
    _json_kwargs: dict

    if debug:
        LOGGER.remove()
        LOGGER.add(sys.stderr, level="DEBUG")

    LOGGER.debug(f"{threshold_kwargs=}")
    LOGGER.debug(f"{fpath_json=}")

    _fpath_json = Path(fpath_json)
    if _fpath_json == Path(""):
        LOGGER.debug("fpath_json not provided, skipping.")

    else:
        if _fpath_json.suffix != ".json":
            raise ValueError(
                f"The JSON suffix of '{_fpath_json.as_posix()}' is not correct."
                " Please use '.json'."
            )

        cls.label = f"JSON ({_fpath_json})"

        with open(fpath_json, "rb") as fy:
            _json_kwargs = json.load(fy)

        LOGGER.debug(f"{_json_kwargs=}")
        threshold_kwargs.update(_json_kwargs)
        LOGGER.debug(f"Updated {threshold_kwargs=}")

        for key in _json_kwargs:
            change_ledger[key] = {"label": cls.label, "rank": cls.rank}

    return threshold_kwargs, change_ledger