summaryrefslogtreecommitdiff
path: root/zephyr/zmake/tests/test_generate_readme.py
blob: e7873f198075afe40530eb256445476bc44d875e (plain)
1
2
3
4
5
6
7
8
9
10
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
# Copyright 2022 The ChromiumOS Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.

"""
Tests for the generate_readme.py file.
"""

import pytest  # pylint:disable=import-error
import zmake.generate_readme as gen_readme


def test_generate_readme_contents():
    """Verify the readme contains at least one known line."""
    readme = gen_readme.generate_readme()

    # Look for a string we know should appear in the README.
    assert "### zmake testall\n" in readme


@pytest.mark.parametrize(
    ["expected_contents", "actual_contents", "return_code"],
    [
        ("abc\ndef\nghi\n", "abc\nghi\n", 1),
        ("abc\ndef\nghi\n", "abc\ndef\nghi\n", 0),
        ("abc\ndef\nghi\n", None, 1),
    ],
)
def test_generate_readme_diff(
    monkeypatch,
    tmp_path,
    zmake_from_dir,
    expected_contents,
    actual_contents,
    return_code,
):
    """Verify that the diff function can detect different text."""

    def generate_readme():
        return expected_contents

    monkeypatch.setattr(gen_readme, "generate_readme", generate_readme)

    readme_file = tmp_path / "README.md"
    if actual_contents is not None:
        readme_file.write_text(actual_contents)

    assert zmake_from_dir.generate_readme(readme_file, diff=True) == return_code


@pytest.mark.parametrize("exist", [False, True])
def test_generate_readme_file(monkeypatch, tmp_path, exist, zmake_from_dir):
    """Verify that README.md can be created if it exists already or not."""

    def generate_readme():
        return "hello\n"

    monkeypatch.setattr(gen_readme, "generate_readme", generate_readme)

    readme_file = tmp_path / "README.md"
    if exist:
        readme_file.write_text("some existing contents\n")

    assert zmake_from_dir.generate_readme(readme_file) == 0
    assert readme_file.read_text() == "hello\n"