mirror of
https://github.com/lunarmodules/luasocket.git
synced 2025-07-13 14:14:30 +02:00
Compare commits
4 Commits
3e56a29aee
...
master
Author | SHA1 | Date | |
---|---|---|---|
4844a48fbf | |||
c37e273d68 | |||
138f06e88a | |||
47e5bd71a9 |
4
.github/workflows/build.yml
vendored
4
.github/workflows/build.yml
vendored
@ -25,8 +25,10 @@ jobs:
|
||||
uses: luarocks/gh-actions-lua@v10
|
||||
with:
|
||||
luaVersion: ${{ matrix.luaVersion }}
|
||||
buildCache: false
|
||||
- name: Setup ‘luarocks’
|
||||
uses: luarocks/gh-actions-luarocks@v5
|
||||
# master branch until tagged release has luajit & msvcrt fixes
|
||||
uses: luarocks/gh-actions-luarocks@master
|
||||
- name: Make and install
|
||||
run: |
|
||||
luarocks make -- luasocket-scm-3.rockspec
|
||||
|
@ -37,70 +37,30 @@ Installation">
|
||||
|
||||
<!-- installation ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
|
||||
|
||||
<h2>Installation</h2>
|
||||
<h2>Installation via luarocks</h2>
|
||||
|
||||
<p> 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. </p>
|
||||
|
||||
<h3>Directory structure</h3>
|
||||
|
||||
<p> 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 <tt><CDIR></tt>
|
||||
and <tt><LDIR></tt>, respectively.
|
||||
For example, in my laptp, Lua 5.1 is configured to
|
||||
use '<tt>/usr/local/lib/lua/5.1</tt>' for
|
||||
<tt><CDIR></tt> and '<tt>/usr/local/share/lua/5.1</tt>' for
|
||||
<tt><LDIR></tt>. On Windows, <tt><CDIR></tt>
|
||||
usually points to the directory where the Lua executable is
|
||||
found, and <tt><LDIR></tt> points to a
|
||||
<tt>lua/</tt> directory inside <tt><CDIR></tt>. (These
|
||||
settings can be overridden by environment variables
|
||||
<tt>LUA_PATH</tt> and <tt>LUA_CPATH</tt>. See the Lua
|
||||
documentation for details.) Here is the standard LuaSocket
|
||||
distribution directory structure:</p>
|
||||
<p>LuaSocket can be easily installed using <a href="https://luarocks.org/" target="_blank">LuaRocks</a>, the Lua package manager.</p>
|
||||
|
||||
<h3>Installing via LuaRocks</h3>
|
||||
|
||||
<p>Run the following command in your terminal:</p>
|
||||
<pre class=example>
|
||||
<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
|
||||
</pre>
|
||||
|
||||
<p> Naturally, on Unix systems, <tt>core.dll</tt>
|
||||
would be replaced by <tt>core.so</tt>.
|
||||
</p>
|
||||
<h3>Verification</h3>
|
||||
<p>To verify that LuaSocket is installed correctly, open Lua and run:</p>
|
||||
<pre class=example><code>
|
||||
local socket = require("socket")
|
||||
print(socket._VERSION)
|
||||
</code></pre>
|
||||
|
||||
<h3>Using LuaSocket</h3>
|
||||
<p>If you see output like <strong>LuaSocket 3.0</strong>, the installation was successful.</p>
|
||||
|
||||
<p> 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
|
||||
<tt>require</tt> function to gain access to whatever module you need:</p>
|
||||
|
||||
<pre class=example>
|
||||
Lua 5.2.2 Copyright (C) 1994-2013 Lua.org, PUC-Rio
|
||||
> socket = require("socket")
|
||||
> print(socket._VERSION)
|
||||
--> LuaSocket 3.1.0
|
||||
</pre>
|
||||
|
||||
<p> Each module loads their dependencies automatically, so you only need to
|
||||
load the modules you directly depend upon: </p>
|
||||
|
||||
<pre class=example>
|
||||
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
|
||||
</pre>
|
||||
<h3>More Information</h3>
|
||||
<p>For more details, visit the <a href="https://github.com/lunarmodules/luasocket" target="_blank">LuaSocket GitHub repository</a>.</p>
|
||||
|
||||
<!-- footer +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
|
||||
|
||||
|
2
makefile
2
makefile
@ -10,7 +10,7 @@
|
||||
# print print the build settings
|
||||
|
||||
PLAT?= linux
|
||||
PLATS= macosx linux win32 win64 mingw freebsd solaris
|
||||
PLATS= macosx linux win32 win64 mingw freebsd solaris ucrt64
|
||||
|
||||
all: $(PLAT)
|
||||
|
||||
|
27
src/makefile
27
src/makefile
@ -74,6 +74,13 @@ LUAPREFIX_mingw?=/usr
|
||||
CDIR_mingw?=lua/$(LUAV)
|
||||
LDIR_mingw?=lua/$(LUAV)/lua
|
||||
|
||||
# where lua headers are found for ucrt64 builds
|
||||
# LUAINC_ucrt64:
|
||||
LUAINC_ucrt64?=/ucrt64/include
|
||||
LUALIB_ucrt64?=/ucrt64/bin/lua$(subst .,,$(LUAV)).dll
|
||||
LUAPREFIX_ucrt64?=/ucrt64
|
||||
CDIR_ucrt64?=lib/lua/$(LUAV)
|
||||
LDIR_ucrt64?=share/lua/$(LUAV)
|
||||
|
||||
# LUAINC_win32:
|
||||
# LUALIB_win32:
|
||||
@ -153,7 +160,7 @@ print:
|
||||
#------
|
||||
# Supported platforms
|
||||
#
|
||||
PLATS= macosx linux win32 win64 mingw solaris
|
||||
PLATS= macosx linux win32 win64 mingw solaris ucrt64
|
||||
|
||||
#------
|
||||
# Compiler and linker settings
|
||||
@ -219,6 +226,21 @@ LDFLAGS_mingw= $(LUALIB) -shared -Wl,-s -lws2_32 -o
|
||||
LD_mingw=gcc
|
||||
SOCKET_mingw=wsocket.o
|
||||
|
||||
#------
|
||||
# Compiler and linker settings
|
||||
# for ucrt64
|
||||
SO_ucrt64=dll
|
||||
O_ucrt64=o
|
||||
CC_ucrt64=gcc
|
||||
DEF_ucrt64= -DLUASOCKET_$(DEBUG) \
|
||||
-DWINVER=0x0501
|
||||
CFLAGS_ucrt64= -I$(LUAINC) $(DEF) -Wall -O2 -fno-common
|
||||
# \
|
||||
-fvisibility=hidden
|
||||
LDFLAGS_ucrt64= $(LUALIB) -shared -Wl,-s -lws2_32 -o
|
||||
LD_ucrt64=gcc
|
||||
SOCKET_ucrt64=wsocket.o
|
||||
|
||||
|
||||
#------
|
||||
# Compiler and linker settings
|
||||
@ -384,6 +406,9 @@ linux:
|
||||
mingw:
|
||||
$(MAKE) all PLAT=mingw
|
||||
|
||||
ucrt64:
|
||||
$(MAKE) all PLAT=ucrt64
|
||||
|
||||
solaris:
|
||||
$(MAKE) all-unix PLAT=solaris
|
||||
|
||||
|
Reference in New Issue
Block a user