Tags

1. Concept
2. Examples
   1. show and config
   2. check and link

Concept

Tags are used to conditionally parse targets by following these rules:

• A target can have zero or more tags
• A target with no tags will always be parsed
• A target with one or more tags will only be parsed if any of its tags is passed to the parsing command

Examples

show and config

$ ls
tagged untagged pilgo.yml
$ plg show
.
├── tagged   <- /home/me/.config/tagged
└── untagged <- /home/me/.config/untagged
$ plg config -tags test tagged
$ plg show
.
└── untagged <- /home/me/.config/untagged
$ plg show -tags test
.
├── tagged   <- /home/me/.config/tagged
└── untagged <- /home/me/.config/untagged

check and link

$ ls
tagged untagged pilgo.yml
$ plg check
.
├── tagged   <- /home/me/.config/tagged   (READY)
└── untagged <- /home/me/.config/untagged (READY)
$ plg config -tags test tagged
$ plg check
.
└── untagged <- /home/me/.config/untagged (READY)
$ plg link
$ plg check
.
└── untagged <- /home/me/.config/untagged (DONE)
$ plg check -tags test
.
├── tagged   <- /home/me/.config/tagged   (READY)
└── untagged <- /home/me/.config/untagged (DONE)
$ plg link -tags test
$ plg check -tags test
.
├── tagged   <- /home/me/.config/tagged   (DONE)
└── untagged <- /home/me/.config/untagged (DONE)