Skip to content

yaml_reader

yaml = ruamel.yaml.YAML() module-attribute

ScannerNoAlias

Bases: RoundTripScanner

Custom Scanner that treats * as a regular character instead of alias syntax.

fetch_alias()

Treat * as a plain scalar character instead of alias syntax.

Source code in src/rendercv/schema/yaml_reader.py 
73
74
75
76
def fetch_alias(self):
    """Treat * as a plain scalar character instead of alias syntax."""
    # Instead of scanning as alias, treat as plain scalar
    self.fetch_plain()

read_yaml(file_path_or_contents)

Parse YAML/JSON content from file path or string.

Why

Validation errors must point to exact YAML locations. CommentedMap preserves source coordinates that map Pydantic errors back to input lines, enabling user-friendly error tables showing exactly where mistakes occur in the input file.

Example 
data = read_yaml(pathlib.Path("cv.yaml"))
name = data["cv"]["name"]  # Regular dict access
# Line info also available: data.lc.data["cv"][0] = (line, col)

Parameters:

  • file_path_or_contents (Path | str) –

    File path or raw YAML string.

Returns:

  • CommentedMap –

    Dictionary with line/column metadata for error reporting.

Source code in src/rendercv/schema/yaml_reader.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
55
56
57
58
59
60
61
62
63
64
65
66
67
def read_yaml(file_path_or_contents: pathlib.Path | str) -> CommentedMap:
    """Parse YAML/JSON content from file path or string.

    Why:
        Validation errors must point to exact YAML locations. CommentedMap
        preserves source coordinates that map Pydantic errors back to input
        lines, enabling user-friendly error tables showing exactly where
        mistakes occur in the input file.

    Example:
        ```py
        data = read_yaml(pathlib.Path("cv.yaml"))
        name = data["cv"]["name"]  # Regular dict access
        # Line info also available: data.lc.data["cv"][0] = (line, col)
        ```

    Args:
        file_path_or_contents: File path or raw YAML string.

    Returns:
        Dictionary with line/column metadata for error reporting.
    """
    if isinstance(file_path_or_contents, pathlib.Path):
        # Check if the file exists:
        if not file_path_or_contents.exists():
            message = f"The input file `{file_path_or_contents}` doesn't exist!"
            raise RenderCVUserError(message)

        # Check the file extension:
        accepted_extensions = [".yaml", ".yml", ".json", ".json5"]
        if file_path_or_contents.suffix not in accepted_extensions:
            message = (
                "The input file should have one of the following extensions:"
                f" {', '.join(accepted_extensions)}. The input file is"
                f" {file_path_or_contents.name}."
            )
            raise RenderCVUserError(message)

        file_content = file_path_or_contents.read_text(encoding="utf-8")
    else:
        file_content = file_path_or_contents

    yaml_as_dictionary: CommentedMap = yaml.load(file_content)

    if yaml_as_dictionary is None:
        message = "The input file is empty!"
        raise RenderCVUserError(message)

    if isinstance(yaml_as_dictionary, str):
        message = (
            "You probably meant to pass a path to the YAML file, but you passed as a"
            " string and RenderCV interpreted it as the contents of the YAML file."
            f" Pass the path using `pathlib.Path({file_path_or_contents})`."
        )
        raise RenderCVInternalError(message)

    return yaml_as_dictionary