@spec get_latest_cursor(Magpie.Client.t(), binary()) :: Magpie.response()

A way to quickly get a cursor for the folder's state.

##Example

Magpie.Files.ListFolder.get_latest_cursor client, ""

More info at: https://www.dropbox.com/developers/documentation/http/documentation#files-list_revisions

@spec list_folder(Magpie.Client.t(), binary()) :: Magpie.response()

Starts returning the contents of a folder.

##Example

Magpie.Files.ListFolder.list_folder client, "/path"

More info at: https://www.dropbox.com/developers/documentation/http/documentation#files-list_folder

@spec list_folder_continue(Magpie.Client.t(), binary()) :: Magpie.response()

Once a cursor has been retrieved from list_folder, use this to paginate through all files and retrieve updates to the folder, following the same rules as documented for list_folder.

##Example

Magpie.Files.ListFolder.list_folder_continue client, ""

More info at: https://www.dropbox.com/developers/documentation/http/documentation#files-list_folder-continue

@spec list_revisions(Magpie.Client.t(), binary(), number()) :: Magpie.response()

Return revisions of a file.

##Example

Magpie.Files.ListFolder.list_revisions client, ""

More info at: https://www.dropbox.com/developers/documentation/http/documentation#files-list_revisions

@spec longpoll(Magpie.Client.t(), binary()) :: Magpie.response()

A longpoll endpoint to wait for changes on an account.

##Example

Magpie.Files.ListFolder.longpoll client, ""

More info at: https://www.dropbox.com/developers/documentation/http/documentation#files-list_folder-longpoll

Returns a lazy Stream over all entries of a folder, fetching pages through list_folder/2 + list_folder_continue/2 on demand — no cursor handling needed. Raises Magpie.Error if a page request fails.

Example

client
|> Magpie.Files.ListFolder.stream("/Photos")
|> Stream.filter(&(&1[".tag"] == "file"))
|> Enum.map(& &1["name"])