fluminus v2.0.2 Fluminus.API.File View Source
Provides an abstraction over a file/directory in LumiNUS, and operations possible on them using LumiNUS API.
Struct fields:
:id
- id of the file:name
- the name of the file:directory?
- whether this file is a directory:children
-nil
indicated the need to fetch, otherwise it contains a list of its children. ifdirectory?
isfalse
, then this field contains an empty list.:allow_upload?
- whether this is a student submission folder.:multimedia?
- whether this is a multimedia file.
Link to this section Summary
Functions
Downloads the given file to the location specified by path
.
Creates a Elixir.Fluminus.API.File
struct from the API response retrieved by Lesson
.
Creates Elixir.Fluminus.API.File
struct from a Module
.
Obtains the download url for a given file.
Loads the children of a given Elixir.Fluminus.API.File
struct.
Link to this section Types
Specs
Link to this section Functions
Specs
download(t(), Fluminus.Authorization.t(), Path.t(), bool()) :: :ok | {:error, :exists | any()}
Downloads the given file to the location specified by path
.
This function will return {:error, :exists}
if the file already exists in the given path
Specs
Creates a Elixir.Fluminus.API.File
struct from the API response retrieved by Lesson
.
Specs
from_module(Fluminus.API.Module.t(), Fluminus.Authorization.t()) :: {:ok, t()} | :error
Creates Elixir.Fluminus.API.File
struct from a Module
.
Specs
get_download_url(t(), Fluminus.Authorization.t()) :: {:ok, String.t()} | {:error, any()}
Obtains the download url for a given file.
Note that the download url of a directory is a url to that directory zipped.
Specs
load_children(t(), Fluminus.Authorization.t()) :: {:ok, t()} | :error
Loads the children of a given Elixir.Fluminus.API.File
struct.