Provide a current user home directory API in FileSystem

[0xTim]

Currently NIOFileSystem offers current working directory and temp working directory as a way to get various directories. It would be great to provide an API to get the user's current working directory, equivalent to FileManager.default.homeDirectoryForCurrentUser

[rnro]

Thanks for the issue Tim, I'm curious do you currently have any workarounds for this, is it blocking any functionality?

[0xTim]

Nothing really blocking at the moment, workaround is either read $HOME or just use the FileManager API

[rnro]

Thanks for the context 🙏

[Lukasa]

If anyone feels like tackling this from the OSS side, the strategy is this:

1. First check the value of the HOME environment variable. If set, assume that's the home directory.
2. If not set, use getpwuid_r with the return value of getuid() and load the home directory from there.

[cnaples79]

Im working on this issue.