Here we describe the standard distribution. If the -standard doesn't meet your needs, we refer you to the Lua -discussion list, where any question about the package scheme -will likely already have been answered.
-On Unix systems, the standard distribution uses two base -directories, one for system dependent files, and another for system -independent files. Let's call these directories <CDIR> -and <LDIR>, respectively. -For example, in my laptp, Lua 5.1 is configured to -use '/usr/local/lib/lua/5.1' for -<CDIR> and '/usr/local/share/lua/5.1' for -<LDIR>. On Windows, <CDIR> -usually points to the directory where the Lua executable is -found, and <LDIR> points to a -lua/ directory inside <CDIR>. (These -settings can be overridden by environment variables -LUA_PATH and LUA_CPATH. See the Lua -documentation for details.) Here is the standard LuaSocket -distribution directory structure:
+LuaSocket can be easily installed using LuaRocks, the Lua package manager.
+Run the following command in your terminal:
-<LDIR>/ltn12.lua -<LDIR>/socket.lua -<CDIR>/socket/core.dll -<LDIR>/socket/http.lua -<LDIR>/socket/tp.lua -<LDIR>/socket/ftp.lua -<LDIR>/socket/smtp.lua -<LDIR>/socket/url.lua -<LDIR>/mime.lua -<CDIR>/mime/core.dll +luarocks install luasocket-
Naturally, on Unix systems, core.dll -would be replaced by core.so. -
+To verify that LuaSocket is installed correctly, open Lua and run:
+
+ local socket = require("socket")
+ print(socket._VERSION)
+ If you see output like LuaSocket 3.0, the installation was successful.
-With the above setup, and an interpreter with shared library support, -it should be easy to use LuaSocket. Just fire the interpreter and use the -require function to gain access to whatever module you need:
- -
-Lua 5.2.2 Copyright (C) 1994-2013 Lua.org, PUC-Rio
-> socket = require("socket")
-> print(socket._VERSION)
---> LuaSocket 3.1.0
-
-
-Each module loads their dependencies automatically, so you only need to -load the modules you directly depend upon:
- -
-Lua 5.2.2 Copyright (C) 1994-2013 Lua.org, PUC-Rio
-> http = require("socket.http")
-> print(http.request("http://www.impa.br/~diego/software/luasocket"))
---> homepage gets dumped to terminal
-
+For more details, visit the LuaSocket GitHub repository.