Permalink
Browse files

updated docs and rockspecs for WSAPI 1.3

  • Loading branch information...
1 parent 194355e commit f5fded3639c8e113b184ee800f05ca31a467b1cd Fabio Mascarenhas committed Mar 18, 2010
View
@@ -19,7 +19,7 @@ tries to follow standard Lua idioms.
WSAPI is free software and uses the same license as Lua 5.1
Status
-Current version is 1.2. It was developed for Lua 5.1.
+Current version is 1.3. It was developed for Lua 5.1.
Download
WSAPI can be downloaded from its LuaForge page. You can also get WSAPI using LuaRocks:
@@ -30,6 +30,22 @@ WSAPI CVS and bug tracker are available at its Github page.
History
+WSAPI 1.3 [18/Mar/2010]
+ * Fixed segmentation fault when non-string is provided to lfcgi.getenv() (thanks to mkottman@github)
+ * Added CGILua bootstrap to wsapi.sapi, so CGILua can run without a kepler_init module present
+ * Added an `extra_vars` paremeter to wsapi.xavante.makeHandler and wsapi.xavante.makeGenericHandler, to
+ let you pass extra variables in the WSAPI environment
+ * Added `overwrite` option to wsapi.request that tells the parameter parser to overwrite repeated parameters
+ instead of collecting them in a list
+ * Added a parameter `isolated` to the persistent generic loaders that controls whether you isolate
+ each script in a Lua state or not
+ * Added parameters to the persistent generic loaders that let the user control the life cycle of Lua
+ states: `period` sets how long WSAPI should wait between collecting stale states, and `ttl` sets the
+ period after which a state becomes stale
+ * Fixed bug in wsapi.ringer that didn't let you use wsapi.input:read inside the response iterator
+ * Parameter `vars` for the WSAPI generic loaders that which variables WSAPI should check to get the physical
+ path of the script, and in which order. Defaults tro trying SCRIPT_FILENAME first and PATH_TRANSLATED second
+
WSAPI 1.2 [27/Oct/2009]
* Adds time-based collection of Lua states to FCGI and Xavante launchers
* Adds "wsapi" laucher script, to start a Xavante WSAPI server
View
@@ -62,7 +62,7 @@
<h2>Status</h2>
-<p>Current version is 1.2. It was developed for Lua 5.1.</p>
+<p>Current version is 1.3. It was developed for Lua 5.1.</p>
<h2>Download</h2>
@@ -77,12 +77,12 @@
<h3>Unix Installer Script</h3>
<p>You can also get an installer script that installs Lua+LuaRocks+WSAPI
-<a href="http://cloud.github.com/downloads/keplerproject/wsapi-install-1.2.0.tar.gz">here</a>. See
+<a href="http://github.com/downloads/keplerproject/wsapi/wsapi-install-1.3.0.tar.gz">here</a>. See
the <a href="manual.html">manual</a> for installation instructions.</p>
<h3>Customizing the installer</h3>
-<p>There is a section of wsapi-install-1.2 with the parameters that
+<p>There is a section of wsapi-install-1.3 with the parameters that
control the installer: </p>
@@ -94,7 +94,7 @@
PACKAGE_OPT=wsapi
PACKAGE_ROCK=wsapi-xavante
INSTALLER_VERSION=0.6
-PACKAGE_VERSION=1.2
+PACKAGE_VERSION=1.3
LUAROCKS_REPO=http://luarocks.org/repositories/rocks
LUAROCKS_URL=http://www.luarocks.org/releases/luarocks-2.0.1.tar.gz
LUAROCKS_VERSION=2.0.1
@@ -116,7 +116,7 @@
<p>Now to make the tarball, put the installer script in an empty folder and run: </p>
-<pre>
+<pre class = "example">
bash ./your-install-script --prefix=/tmp/anything --bootstrap
</pre>
@@ -131,6 +131,25 @@
<h2>History</h2>
+<p><strong>WSAPI 1.3</strong> [18/Mar/2010]</p>
+
+<ul>
+ <li>Fixed segmentation fault when non-string is provided to lfcgi.getenv() (thanks to mkottman@github)</li>
+ <li>Added CGILua bootstrap to wsapi.sapi, so CGILua can run without a kepler_init module present</li>
+ <li>Added an <code>extra_vars</code> paremeter to wsapi.xavante.makeHandler and wsapi.xavante.makeGenericHandler, to
+ let you pass extra variables in the WSAPI environment</li>
+ <li>Added <code>overwrite</code> option to wsapi.request that tells the parameter parser to overwrite repeated parameters
+ instead of collecting them in a list </li>
+ <li>Added a parameter <code>isolated</code> to the persistent generic loaders that controls whether you isolate
+ each script in a Lua state or not</li>
+ <li>Added parameters to the persistent generic loaders that let the user control the life cycle of Lua
+ states: <code>period</code> sets how long WSAPI should wait between collecting stale states, and <code>ttl</code> sets the
+ period after which a state becomes stale</li>
+ <li>Fixed bug in wsapi.ringer that didn't let you use wsapi.input:read inside the response iterator</li>
+ <li>Parameter <code>vars</code> for the WSAPI generic loaders that which variables WSAPI should check to get the physical
+ path of the script, and in which order. Defaults tro trying SCRIPT_FILENAME first and PATH_TRANSLATED second</li>
+</ul>
+
<p><strong>WSAPI 1.2</strong> [27/Oct/2009]</p>
<ul>
View
@@ -17,7 +17,7 @@ WSAPI is free software and uses the same license as Lua 5.1
## Status
-Current version is 1.2. It was developed for Lua 5.1.
+Current version is 1.3. It was developed for Lua 5.1.
## Download
@@ -30,12 +30,12 @@ luarocks install wsapi-xavante
### Unix Installer Script
You can also get an installer script that installs Lua+LuaRocks+WSAPI
-[here](http://cloud.github.com/downloads/keplerproject/wsapi-install-1.2.0.tar.gz). See
+[here](http://github.com/downloads/keplerproject/wsapi/wsapi-install-1.3.0.tar.gz). See
the [manual](manual.html) for installation instructions.
### Customizing the installer
-There is a section of wsapi-install-1.2 with the parameters that
+There is a section of wsapi-install-1.3 with the parameters that
control the installer:
<pre class="example">
@@ -46,7 +46,7 @@ PACKAGE=WSAPI
PACKAGE_OPT=wsapi
PACKAGE_ROCK=wsapi-xavante
INSTALLER_VERSION=0.6
-PACKAGE_VERSION=1.2
+PACKAGE_VERSION=1.3
LUAROCKS_REPO=http://luarocks.org/repositories/rocks
LUAROCKS_URL=http://www.luarocks.org/releases/luarocks-2.0.1.tar.gz
LUAROCKS_VERSION=2.0.1
@@ -66,7 +66,7 @@ won't go into that.
Now to make the tarball, put the installer script in an empty folder and run:
-<pre>
+<pre class = "example">
bash ./your-install-script --prefix=/tmp/anything --bootstrap
</pre>
@@ -80,6 +80,23 @@ WSAPI sources and bug tracker are available at its [Github](http://github.com/ke
## History
+**WSAPI 1.3** [18/Mar/2010]
+
+* Fixed segmentation fault when non-string is provided to lfcgi.getenv() (thanks to mkottman@github)
+* Added CGILua bootstrap to wsapi.sapi, so CGILua can run without a kepler_init module present
+* Added an `extra_vars` paremeter to wsapi.xavante.makeHandler and wsapi.xavante.makeGenericHandler, to
+ let you pass extra variables in the WSAPI environment
+* Added `overwrite` option to wsapi.request that tells the parameter parser to overwrite repeated parameters
+ instead of collecting them in a list
+* Added a parameter `isolated` to the persistent generic loaders that controls whether you isolate
+ each script in a Lua state or not
+* Added parameters to the persistent generic loaders that let the user control the life cycle of Lua
+ states: `period` sets how long WSAPI should wait between collecting stale states, and `ttl` sets the
+ period after which a state becomes stale
+* Fixed bug in wsapi.ringer that didn't let you use wsapi.input:read inside the response iterator
+* Parameter `vars` for the WSAPI generic loaders that which variables WSAPI should check to get the physical
+ path of the script, and in which order. Defaults tro trying SCRIPT\_FILENAME first and PATH\_TRANSLATED second
+
**WSAPI 1.2** [27/Oct/2009]
* Adds time-based collection of Lua states to FCGI and Xavante launchers
@@ -51,8 +51,8 @@
<h2>Request</h2>
<p><strong>wsapi.request.new(*wsapi_env<em>, [</em>options*])</strong> - creates a new request object wrapping *wsapi_env<em>; *options</em> is an (optional) table of extra options
-for the request, the only option currently supported is *delay_post*, if set
-this won't process the POST data on creation of the request</p>
+for the request; the *delay_post* option tells wsapi.request to not process POST data on creation, and the <em>overwrite</em>
+option tells WSAPI to overwrite input parameters with the same name instead of collecting them in a list</p>
<p><strong>req:parse<em>post</em>data()</strong> - processed the POST data in case the processing
was delayed by passing *delay_post = true* on creation of the request</p>
View
@@ -6,8 +6,8 @@ To use these libraries just `require` them in your application or framework.
## Request
**wsapi.request.new(*wsapi_env*, [*options*])** - creates a new request object wrapping *wsapi_env*; *options* is an (optional) table of extra options
-for the request, the only option currently supported is *delay_post*, if set
-this won't process the POST data on creation of the request
+for the request; the *delay_post* option tells wsapi.request to not process POST data on creation, and the *overwrite*
+option tells WSAPI to overwrite input parameters with the same name instead of collecting them in a list
**req:parse_post_data()** - processed the POST data in case the processing
was delayed by passing *delay_post = true* on creation of the request
View
@@ -83,7 +83,7 @@
<hr/>
-<p>Copyright &copy; 2007 Kepler Project.</p>
+<p>Copyright &copy; 2007-2010 Kepler Project.</p>
View
@@ -27,7 +27,7 @@ Andr&eacute; Carregal.
The implementation is not derived from licensed software.</p>
<hr/>
-<p>Copyright &copy; 2007 Kepler Project.</p>
+<p>Copyright &copy; 2007-2010 Kepler Project.</p>
<p>Permission is hereby granted, free of charge, to any person
obtaining a copy of this software and associated documentation
View
@@ -55,7 +55,7 @@
local Rocks repository.</p>
<p>There is an all-in-one installer script that installs Lua, LuaRocks, and <code>wsapi-xavante</code> in
-a single step. Download the <a href="http://cloud.github.com/downloads/keplerproject/wsapi-install-1.2.0.tar.gz">tarball</a>,
+a single step. Download the <a href="http://github.com/downloads/keplerproject/wsapi/wsapi-install-1.3.0.tar.gz">tarball</a>,
unpack it, then run the provided <code>wsapi-install</code> script in its path. Run <code>wsapi-install --help</code> for
installation options.</p>
View
@@ -10,7 +10,7 @@ The WSAPI rock copies samples, docs and support files to it's path inside your
local Rocks repository.
There is an all-in-one installer script that installs Lua, LuaRocks, and `wsapi-xavante` in
-a single step. Download the [tarball](http://cloud.github.com/downloads/keplerproject/wsapi-install-1.2.0.tar.gz),
+a single step. Download the [tarball](http://github.com/downloads/keplerproject/wsapi/wsapi-install-1.3.0.tar.gz),
unpack it, then run the provided `wsapi-install` script in its path. Run `wsapi-install --help` for
installation options.
@@ -12,10 +12,10 @@ description = {
homepage = "http://www.keplerproject.org/wsapi"
}
-dependencies = { "luafilesystem >= 1.4.2" }
+dependencies = { "luafilesystem >= 1.5.0" }
source = {
- url = "http://cloud.github.com/downloads/keplerproject/wsapi/wsapi-1.2.tar.gz"
+ url = "http://github.com/downloads/keplerproject/wsapi/wsapi-1.2.tar.gz"
}
build = {
@@ -0,0 +1,34 @@
+package = "WSAPI"
+
+version = "1.3-1"
+
+description = {
+ summary = "Lua Web Server API",
+ detailed = [[
+ WSAPI is an API that abstracts the web server from Lua web applications. This is the rock
+ that contains the base WSAPI libraries plus the CGI adapters.
+ ]],
+ license = "MIT/X11",
+ homepage = "http://www.keplerproject.org/wsapi"
+}
+
+dependencies = { "luafilesystem >= 1.5.0" }
+
+source = {
+ url = "http://github.com/downloads/keplerproject/wsapi/wsapi-1.3.tar.gz"
+}
+
+build = {
+ type = "builtin",
+ modules = {
+ ["wsapi.common"] = "src/wsapi/common.lua",
+ ["wsapi.request"] = "src/wsapi/request.lua",
+ ["wsapi.response"] = "src/wsapi/response.lua",
+ ["wsapi.util"] = "src/wsapi/util.lua",
+ ["wsapi.cgi"] = "src/wsapi/cgi.lua",
+ ["wsapi.sapi"] = "src/wsapi/sapi.lua",
+ ["wsapi.ringer"] = "src/wsapi/ringer.lua",
+ },
+ copy_directories = { "samples", "doc", "tests" },
+ install = { bin = { "src/launcher/wsapi.cgi" } }
+}
@@ -25,7 +25,7 @@ external_dependencies = {
}
source = {
- url = "http://cloud.github.com/downloads/keplerproject/wsapi/wsapi-1.2.tar.gz"
+ url = "http://github.com/downloads/keplerproject/wsapi/wsapi-1.2.tar.gz"
}
build = {
@@ -0,0 +1,43 @@
+package = "WSAPI-FCGI"
+
+version = "cvs-2"
+
+description = {
+ summary = "Lua Web Server API FastCGI Adapter",
+ detailed = [[
+ WSAPI is an API that abstracts the web server from Lua web applications. This
+ is the rock that contains the FCGI module lfcgi.
+ ]],
+ license = "MIT/X11",
+ homepage = "http://www.keplerproject.org/wsapi"
+}
+
+dependencies = { "wsapi >= 1.3", "rings >= 1.2.3", "coxpcall >= 1.13" }
+
+external_dependencies = {
+ platforms = {
+ unix = {
+ FASTCGI = {
+ header = "fcgi_stdio.h"
+ }
+ }
+ }
+}
+
+source = {
+ url = "http://github.com/downloads/keplerproject/wsapi/wsapi-1.3.tar.gz"
+}
+
+build = {
+ type = "builtin",
+ modules = {
+ ["wsapi.fastcgi"] = "src/wsapi/fastcgi.lua",
+ lfcgi = {
+ sources = "src/fastcgi/lfcgi.c",
+ libraries = "fcgi",
+ incdirs = "$(FASTCGI_INCDIR)",
+ libdirs = "$(FASTCGI_LIBDIR)"
+ }
+ },
+ install = { bin = { "src/launcher/wsapi.fcgi" } }
+}
@@ -29,9 +29,7 @@ source = {
}
build = {
- platforms = {
- unix = {
- type = "module",
+ type = "builtin",
modules = {
["wsapi.fastcgi"] = "src/wsapi/fastcgi.lua",
lfcgi = {
@@ -42,22 +40,4 @@ build = {
}
},
install = { bin = { "src/launcher/wsapi.fcgi" } }
- },
- win32 = {
- type = "make",
- install_target = "install-fcgi",
- build_pass = true,
- build_target = "fcgi",
- build_variables = {
- LUA_INCLUDE = "$(LUA_INCDIR)",
- LUA_LIB = "$(LUA_LIBDIR)\\lua5.1.lib",
- LIB_OPTION = "$(LUA_LIBDIR)\\lua5.1.lib $(FASTCGI_DIR)\\libfcgi\\Release\\fcgi_stdio.obj $(FASTCGI_DIR)\\libfcgi\\Release\\os_win32.obj $(FASTCGI_DIR)\\libfcgi\\Release\\fcgiapp.obj",
- CFLAGS = "$(CFLAGS) /I$(FASTCGI_DIR)\\include",
- },
- install_variables = {
- LUA_LIBDIR = "$(LIBDIR)",
- BIN_DIR = "$(BINDIR)"
- }
- }
- }
}
@@ -15,7 +15,7 @@ description = {
dependencies = { "wsapi >= 1.2", "rings >= 1.2.3", "coxpcall >= 1.13", "xavante >= 2.1.0" }
source = {
- url = "http://cloud.github.com/downloads/keplerproject/wsapi/wsapi-1.2.tar.gz"
+ url = "http://github.com/downloads/keplerproject/wsapi/wsapi-1.2.tar.gz"
}
build = {
@@ -0,0 +1,27 @@
+package = "WSAPI-Xavante"
+
+version = "cvs-1"
+
+description = {
+ summary = "Lua Web Server API - Xavante Handler",
+ detailed = [[
+ WSAPI is an API that abstracts the web server from Lua web applications. This is the rock
+ that contains the Xavante adapter and launcher.
+ ]],
+ license = "MIT/X11",
+ homepage = "http://www.keplerproject.org/wsapi"
+}
+
+dependencies = { "wsapi >= 1.3", "rings >= 1.2.3", "coxpcall >= 1.13", "xavante >= 2.1.0" }
+
+source = {
+ url = "http://github.com/downloads/keplerproject/wsapi/wsapi-1.3.tar.gz"
+}
+
+build = {
+ type = "builtin",
+ modules = {
+ ["wsapi.xavante"] = "src/wsapi/xavante.lua"
+ },
+ install = { bin = { "src/launcher/wsapi" } }
+}
Oops, something went wrong. Retry.

0 comments on commit f5fded3

Please sign in to comment.