Add file_list to Get interface

[Gae24]

Opening as a draft since osx and wayland are still to do.
While Windows would simply return file paths, X11 returns a uri-list, should we maybe decide a single format to use in all platforms?
Close #51

[complexspaces]

I think it would probably be best if we returned PathBuf in these APIs, so is it possible to normalize the Linux contents across the various implementations (ie do they use a standard URI scheme)? On macOS NSUrl lets you extract a path out of it.

As a secondary question: Do I understand that the primary use case for this is to receive a list of file paths that have been drag-and-dropped into an app's window? So for macOS we'd be looking for NSPasteboardTypeFileURL?

[Gae24]

Not just for drag and drop, e.g. when trying to copy a file from file explorer, this is the data placed in the clipboard.

[complexspaces]

Ah right, thanks for clarifying 👍.

[Gae24]

I can't test osx code, so I would like to know if like on Linux file paths are prefixed with file://.

[complexspaces]

I tested the OSX code this morning using a modified example and confirmed it returns file paths, with no prefixes:

[
"/Applications/Keynote.app", 
"/System/Applications/Maps.app", 
"/System/Applications/Messages.app",
"/System/Applications/Notes.app", 
"/Applications/Pages.app"
]

This is because you're using the .path() method on NSUrl which is doing what we want.

[Gae24]

Thank you for testing

[Gae24]

Upon further testing on Linux, since file paths are exposed as text/uri-list they are percent encoded.
I think we should decode them, we can use percent-encoding.
Does macOS has the same behaviour?

[complexspaces]

I think we should decode them, we can use percent-encoding.

That sounds good to me.

Does macOS has the same behaviour?

No, the path function handles converting these to normal characters instead of URL encoded ones. For example this is noted in Apple's documentation:

This property contains the path, unescaped using the stringByReplacingPercentEscapesUsingEncoding: method. If the receiver does not conform to RFC 1808, this property contains nil.

[complexspaces]

Sorry for the delay, this looks good now.

Thanks for the work!

[complexspaces]

Released in v3.5.0 on crates.io.