Add ReadDir function to list local files

[rustyoz]

Adds functionality wanted by @Lynxiayel in this community post

[spf13]

Can you add a test for this?

[rustyoz]

I honestly don't know how I would do that progammatically.
The addition to the docs includes a shortcode that is used in the documentation that uses the command. The command is passed a string with a forward slash included and this works fine on Windows.

At the moment all I can do is say that it has worked for me on both windows and linux with forward and backward slashes used in the path.

[bep]

@rustyoz: This looks fine, but as it is now it is possible to navigate outside the WorkDir. This may sound innocent, and it mostly is, but one could imagine a theme author doing something stupid.

So some thightening of that issue would be nice.

[rustyoz]

I have updated the commit to include a test for parent directory markers ".." which should prevent navigation outside of the working directory

[bep]

@rustyoz I haven't forgotten this. I want this feature. Just want some other to chime on to evaluate if the ".." check is protection good enough.

@spf13

others?

[rustyoz]

All good. It seems like the appveyor test failure was due to a missing newline of all things.

[bep]

Merged in 81e69c4

This is very useful. And thanks for taking the time to write some solid documentation. It's boring, but needed.

[github-actions]

This pull request has been automatically locked since there has not been any recent activity after it was closed. Please open a new issue for related bugs.