"""Input file to test <angle bracket bugs>

See https://github.com/bazelbuild/skydoc/issues/186
and https://github.com/bazelbuild/stardoc/issues/132"""

def bracket_function(param = "<default>"):
    """Dummy docstring with <brackets>.

    This rule runs checks on <angle brackets>.

    Args:
        param: an arg with **formatted** docstring, <default> by default.

    Returns:
        some <angled> brackets

    Deprecated:
        deprecated for <reasons>
    """
    return param

# buildifier: disable=unsorted-dict-items
bracketuse = provider(
    doc = "Information with <brackets>",
    fields = {
        "foo": "A string representing <foo>",
        "bar": "A string representing bar",
        "baz": "A string representing baz",
    },
)

def _rule_impl(ctx):
    _ignore = [ctx]  # @unused
    return []

my_anglebrac = rule(
    implementation = _rule_impl,
    doc = "Rule with <brackets>",
    attrs = {
        "useless": attr.string(
            doc = "Args with some tags: <tag1>, <tag2>",
            default = "Find <brackets>",
        ),
    },
)

def _bracket_aspect_impl(ctx):
    _ignore = [ctx]  # @unused
    return []

bracket_aspect = aspect(
    implementation = _bracket_aspect_impl,
    doc = "Aspect with <brackets>",
    attr_aspects = ["deps"],
    attrs = {
        "brackets": attr.string(
            doc = "Attribute with <brackets>",
            default = "<default>",
        ),
    },
)