Skip to content

Documentation issue: Label - What happens when label sections are blank? #14503

@psigen

Description

@psigen

Documentation URL: https://docs.bazel.build/versions/main/skylark/lib/Label.html

Would it be possible to add documentation around what happens with this API when portions of a label are empty?

Here are some examples I was having trouble with:

  • if no package is specified, i.e. //:abc, does package return "." or "" or None?
  • if the name is not specified, i.e. //pkg, does it automatically set name to "pkg"?
  • if the workspace is not specified, i.e. //pkg:abc, does workspace_name automatically resolve to "" or "__main__" or dynamically resolve to the workspace name specified in WORKSPACE?
  • if the workspace is not specified, i.e. //pkg:abc, does workspace_root get set to "." or None or some other value?

Metadata

Metadata

Assignees

Labels

P2We'll consider working on this in future. (Assignee optional)team-DocumentationDocumentation improvements that cannot be directly linked to other team labelsteam-Rules-APIAPI for writing rules/aspects: providers, runfiles, actions, artifactstype: documentation (cleanup)

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions