"""
Tests that the documentation is generated even when unknown modules, calls, or providers are used.
"""

def exercise_the_api():
    _var1 = my_module
    _var2 = StructureOrProvider
    _var3 = my_module.Structure
    _var4 = my_module.sub_module.Structure
    _var5 = call("", 1, True, ["list"], {"key": "map"})
    _var6 = my_module.call("", 1, True, ["list"], {"key": "map"})
    _var7 = my_module.sub_module.call("xxx", 1, True, ["list"], {"key": "map"})
    _var8 = native.my_native_rule(name = "foo")

exercise_the_api()

def my_rule_impl(ctx):
    return struct()

my_rule = rule(
    implementation = my_rule_impl,
    doc = "This rule does my things.",
    attrs = {
        "first": attr.label(mandatory = True, allow_single_file = True),
        "second": attr.string_dict(mandatory = True),
        "third": attr.output(mandatory = True),
        "fourth": attr.bool(default = False, mandatory = False),
    },
)