xref: /aosp_15_r20/external/stardoc/test/testdata/multi_level_namespace_test/input.bzl (revision b2fa42943c124aa9c7163734493fc7a7559681cf)
1"""A test that verifies documenting a multi-leveled namespace of functions."""
2
3def _min(integers):
4    """Returns the minimum of given elements.
5
6    Args:
7      integers: A list of integers. Must not be empty.
8
9    Returns:
10      The minimum integer in the given list.
11    """
12    _ignore = [integers]  # @unused
13    return 42
14
15def _does_nothing():
16    """This function does nothing."""
17    pass
18
19my_namespace = struct(
20    dropped_field = "Note this field should not be documented",
21    min = _min,
22    math = struct(min = _min),
23    foo = struct(
24        bar = struct(baz = _does_nothing),
25        num = 12,
26        string = "Hello!",
27    ),
28    one = struct(
29        two = struct(min = _min),
30        three = struct(does_nothing = _does_nothing),
31    ),
32)
33