• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1"""A test that verifies documenting a 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]
13    return 42
14
15def _assert_non_empty(some_list, other_list):
16    """Asserts the two given lists are not empty.
17
18    Args:
19      some_list: The first list
20      other_list: The second list
21    """
22    _ignore = [some_list, other_list]
23    fail("Not implemented")
24
25def _join_strings(strings, delimiter = ", "):
26    """Joins the given strings with a delimiter.
27
28    Args:
29      strings: A list of strings to join.
30      delimiter: The delimiter to use
31
32    Returns:
33      The joined string.
34    """
35    _ignore = [strings, delimiter]
36    return ""
37
38my_namespace = struct(
39    dropped_field = "Note this field should not be documented",
40    assert_non_empty = _assert_non_empty,
41    min = _min,
42    join_strings = _join_strings,
43)
44