***************************************
*   Filesystem library for Lua 5.x    *
********************************V-1.0**

INSTALLATION

In Luas linit.c add the following declaration:
   LUALIB_API int luaopen_filesys (lua_State*);
right below the #includes and add the following
entry to luaL_Reg lualibs[] before {NULL, NULL}:
   {"filesys", luaopen_filesys},

Recompile, have fun :)

If you're using Linux or Cygwin you may simply add
the object file to the MYLIBS in the Makefile.
If you're using Visual Studio, compile the file as
a static library and link against it when building
the Lua Interpreter.


SECURITY NOTICE
This library provides functions that may cause damage
to your files if used improperly. You may disable those
functions by setting the preprocessor flag
LUA__FILESYS__EXCLUDE_DANGEROUS_FUNCTIONS


PROVIDED FUNCTIONS
- filesys.ls(path)
   If path is a valid system path, returns a table
   where each key corresponds to the name of a
   file or subdirectory found in that path. Each
   value holds another table with only one entry
   "directory", which is set to true if referring
   to a directory and false otherwise.
   If the function fails for whatever reason, it
   returns nil.
- filesys.pwd()
   Returns a string containing the full path of the
   current working directory (./)
- filesys.mkdir(path)
   Creates a new directory at the specified path.
** The following functions are only available if
**  LUA__FILESYS__EXCLUDE_DANGEROUS_FUNCTIONS was not set:
- filesys.rmdir(path)
   Deletes an empty directory.
- filesys.rmfile(path)
   Deletes a single file.
- filesys.rm(path)
   Alias for filesys.rmfile()
- filesys.rename(path, new_path)
   Moves a file or directory from path to new_path.
- filesys.mv(path, new_path)
   Alias for filesys.rename()


CONTACT
http://www.ghulbus-inc.de/projects/lua_filesys/
