Add script for setting random wallpaper

[kubouch]

This PR adds a script for setting a random wallpaper from a directory and drawing custom overlay text over it.

Also proposes a table in the README with short descriptions of the scripts included.

[fdncred]

i like your table and link. i'll have to do that for mine that i just added. thanks!

[kubouch]

It just came to my mind, we can change the table into better format later, if necessary.

[fdncred]

It would be nice to have a script to auto generate the readme table from files. Not sure exactly how to get it into the readme. Maybe just link to a table of contents md file from the readme?

[kubouch]

This would be a perfect use case for nudoc. There could even be examples that could be ran as a CI job for example.

But for now, I think some header with required version and description would do (maybe other fields?). It could be a separate file but I think it's best if it's directly in README. In the README file, you could define e.g. toc_start and toc_end anchors (I've done this once but can't recall the exact syntax; anyway, these anchors are invisible in the rendered README). The table of contents would then overwrite all lines between the two anchors.

For example, the header could be denoted by ## (the name field is not necessary since you can just use the file name):

#!/usr/bin/env nu
#
## version: 0.25.1
## description: Short description what this script does.
#
# Longer description that doesn't go to README
# ...

def do_stuff[stuff] {
}
...

Then, to generate the entries, you'd run:

open MyScript.nu | lines | where $(str starts-with '##') | str ltrim -c '#' | split column ':' 

It might need some pivot so you can collect from more files. Nushell can already format to .md so generating a table should be simple. Then you'd insert it into README between the two anchors. Generating the link to the file should also be simple since you iterate over them so you'd use $it and path commands.

Not sure if it's worth the effort but might be a fun nu exercise :-D .

[fdncred]

I do also agree that it would be overkill but I'd love for there to be multiple overkill scripts in here. I want to show off what nushell and nu can do as a language and how big scripts can be refactored into multiple custom commands.