Module gears.filesystem

Filesystem module for gears

Functions

mkdir (dir) Create a directory
file_readable (filename) Check if a file exists, is readable and not a directory.
dir_readable (path) Check if a path exists, is readable and a directory.
is_dir (path) Check if a path is a directory.
get_xdg_config_home () Get the config home according to the XDG basedir specification.
get_xdg_cache_home () Get the cache home according to the XDG basedir specification.
get_configuration_dir () Get the path to the user’s config dir.
get_cache_dir () Get the path to a directory that should be used for caching data.
get_themes_dir () Get the path to the directory where themes are installed.
get_awesome_icon_dir () Get the path to the directory where our icons are installed.
get_dir (d) Get the user’s config or cache dir.


Functions

Methods
mkdir (dir)
Create a directory

Returns:

    (true, nil) on success, (false, err) on failure
file_readable (filename)
Check if a file exists, is readable and not a directory.
  • filename string The file path.

Returns:

    boolean True if file exists and is readable.
dir_readable (path)
Check if a path exists, is readable and a directory.
  • path string The directory path.

Returns:

    boolean True if path exists and is readable.
is_dir (path)
Check if a path is a directory.
  • path string The directory path

Returns:

    boolean True if path exists and is a directory.
get_xdg_config_home ()
Get the config home according to the XDG basedir specification.

Returns:

    the config home (XDG_CONFIG_HOME) with a slash at the end.
get_xdg_cache_home ()
Get the cache home according to the XDG basedir specification.

Returns:

    the cache home (XDG_CACHE_HOME) with a slash at the end.
get_configuration_dir ()
Get the path to the user’s config dir. This is the directory containing the configuration file (“rc.lua”).

Returns:

    A string with the requested path with a slash at the end.
get_cache_dir ()
Get the path to a directory that should be used for caching data.

Returns:

    A string with the requested path with a slash at the end.
get_themes_dir ()
Get the path to the directory where themes are installed.

Returns:

    A string with the requested path with a slash at the end.
get_awesome_icon_dir ()
Get the path to the directory where our icons are installed.

Returns:

    A string with the requested path with a slash at the end.
get_dir (d)
Get the user’s config or cache dir. It first checks XDG_CONFIG_HOME / XDG_CACHE_HOME, but then goes with the default paths.
  • d The directory to get (either “config” or “cache”).

Returns:

    A string containing the requested path.
generated by LDoc 1.4.6 Last updated 2017-03-19 21:33:58