Skip to content

io

io

I/O utilities for JSON and JSONL files.

load_json(path)

Load a JSON file.

Source code in autochecklist/utils/io.py 
 8
 9
10
11
def load_json(path: Union[str, Path]) -> Any:
    """Load a JSON file."""
    with open(path, "r", encoding="utf-8") as f:
        return json.load(f)

save_json(path, data, indent=2)

Save data to a JSON file.

Source code in autochecklist/utils/io.py 
14
15
16
17
def save_json(path: Union[str, Path], data: Any, indent: int = 2) -> None:
    """Save data to a JSON file."""
    with open(path, "w", encoding="utf-8") as f:
        json.dump(data, f, indent=indent, ensure_ascii=False)

load_jsonl(path)

Load a JSONL file as a list of dictionaries.

Source code in autochecklist/utils/io.py 
20
21
22
23
24
25
26
27
28
def load_jsonl(path: Union[str, Path]) -> List[Dict[str, Any]]:
    """Load a JSONL file as a list of dictionaries."""
    items = []
    with open(path, "r", encoding="utf-8") as f:
        for line in f:
            line = line.strip()
            if line:
                items.append(json.loads(line))
    return items

iter_jsonl(path)

Iterate over a JSONL file, yielding one item at a time.

Source code in autochecklist/utils/io.py 
31
32
33
34
35
36
37
def iter_jsonl(path: Union[str, Path]) -> Iterator[Dict[str, Any]]:
    """Iterate over a JSONL file, yielding one item at a time."""
    with open(path, "r", encoding="utf-8") as f:
        for line in f:
            line = line.strip()
            if line:
                yield json.loads(line)

save_jsonl(path, data)

Save a list of dictionaries to a JSONL file.

Source code in autochecklist/utils/io.py 
40
41
42
43
44
def save_jsonl(path: Union[str, Path], data: List[Dict[str, Any]]) -> None:
    """Save a list of dictionaries to a JSONL file."""
    with open(path, "w", encoding="utf-8") as f:
        for item in data:
            f.write(json.dumps(item, ensure_ascii=False) + "\n")

append_jsonl(path, item)

Append a single item to a JSONL file.

Source code in autochecklist/utils/io.py 
47
48
49
50
def append_jsonl(path: Union[str, Path], item: Dict[str, Any]) -> None:
    """Append a single item to a JSONL file."""
    with open(path, "a", encoding="utf-8") as f:
        f.write(json.dumps(item, ensure_ascii=False) + "\n")