5 ms·

Lua/APR - proper standard library for Lua

100 points by piranha 15y ago

wildmXranat 15y ago
This is very nice. It's good to see examples weaved into the site on how to use it. If anything, main libapr site could use something a bit better than the Doxygen output manual as reading the unit tests from the actual source is more approachable to me than their documentation.
- xolox 15y ago
  I totally agree on the Doxygen documentation and indeed, while writing the Lua/APR binding the APR unit tests were more useful to me than the public headers and documentation. I must admit I also looked through the implementation here and there, when the documentation didn't explain the 'grand scheme' and there were no tests to read :-(
shubber 15y ago
I have to admit, that's kind of brilliant.
xolox 15y ago
Hi all, author of the Lua/APR binding here. If you have any questions or comments, feel free to post them here. I haven't gotten a lot of feedback on the binding yet so would love to hear what people think about it!
- jolan 15y ago
  Nice job. This fills a big gap in Lua. I think the stewards of Lua are afraid to grow the standard library because most of Lua's early popularity stemmed from how small and embeddable it is.
BasDirks 15y ago
Don't mean to hijack, but could I be referred to a good introduction to Lua? I keep hearing about it, but it's one of the few languages I know NOTHING about, and I have a free weekend!
- justincormack 15y ago
  The reference manual is very well written http://www.lua.org/manual/ http://www.lua.org/manual/
- xolox 15y ago
  The first edition of "Programming in Lua" is available for free online and might make for more interesting reading than the reference manual: http://www.lua.org/pil/ http://www.lua.org/pil/
- reginaldo 15y ago
  When I was getting started I bought the "Programming in Lua"[1] ebook, by the author of Lua himself. There's an older edition available for free online[2]. Then there's of course the lua users wiki and its "Learning Lua" section[3]. I find the wiki a little hard to navigate so I just went ahead and bought the book. IMHO the gems in Chapter 10 (Complete Examples) and the clear explanation of coroutines are alone worth the price. The rest is a very nice bonus too. [1] http://store.feistyduck.com/products/programming-in-lua http://store.feistyduck.com/products/programming-in-lua [2] http://www.lua.org/pil/ http://www.lua.org/pil/ [3] http://lua-users.org/wiki/LearningLua http://lua-users.org/wiki/LearningLua
  - BasDirks 15y ago
    Thank you (and all other commenters) kindly. I purchased the book.
- huyegn 15y ago
  If you liked Kernighan and Ritchie's "The C Programming Language", then you'll love "Programming In Lua". The first edition is available online here: http://www.lua.org/pil/ http://www.lua.org/pil/ Like K&R, it's style is colloquially terse, yet each sentence is chock full of information. It's a great book for someone who's already coming from another language like Python. If you're into graphics programming, then http://love2d.org/ http://love2d.org/ would be the perfect vehicle for you to get into Lua while you read PIL.
- swah 15y ago
compay 15y ago
That's a very useful library, and also great example of how easy it is to hook into C code from Lua. Another one which I prefer personally because it's more comprehensive, is Steve Donovan's Penlight. If you have a background in Python you might enjoy using it: https://github.com/stevedonovan/Penlight https://github.com/stevedonovan/Penlight
- philips 15y ago
  If you are interested in hooking C from Lua or vice versa: I gave a recent talk on the ways of hooking C code from Lua at Open Source Bridge. The slides and code are here: https://github.com/philips/beaming-up-alien https://github.com/philips/beaming-up-alien Sometimes really simple examples can be useful.
davidhollander 15y ago
Only downside with LuaAPR is you're back to writing Apache style servers, with an OS thread for every connection instead of using non-blocking sockets where possible (Didn't find any support for nonblocking sockets or a select\poll variant in the linked docs) For my Lua server [1] I currently use the nixio library from the LuCI project and polling instead[2] Although the downside of both nixio and Lua/APR library is the use of compiled C bindings to manually interact with the virtual machine. The exciting development with LuaJIT is the high performance FFI that allows you to make system calls and create structs directly from in Lua[3], so I am currently considering switching from nixio to ljsyscall when I do a new version [4] [1]https://github.com/davidhollander/ox https://github.com/davidhollander/ox [2]http://neopallium.github.com/nixio/ http://neopallium.github.com/nixio/ [3]http://luajit.org/ext_ffi_tutorial.html http://luajit.org/ext_ffi_tutorial.html [4]https://github.com/justincormack/ljsyscall https://github.com/justincormack/ljsyscall
- drudru11 15y ago
  There is a good reason for the thread per connection architecture and there is a good reason for the polling style arch. The latter being better for static content.
  - davidhollander 15y ago
    I'd contend the opposite, polling is better for dynamic content. Let's say you have 1000 requests for a landing page, and the landing page has a data request that scrapes the entire database to find the popular-maximum-geo-similarity-reccomendation-zone-geo-user-thing list for the entire site, but only updates once every 10 seconds. Ideally, you want to only send at most 1 request to your database every 10 seconds, without having to open a new connection. If you are doing a polling server and have all 1000 clients waiting for the data, you can trigger a callback to all of them when the database reports back without having to recopy data, use shared memory, do more ipc, or context switches. And for the 1000 clients to pause to wait for that single combined data callback, no extra blocking reads\connections to anything were necessary. If by static content you are referring to file transfers, polling does not actually work on regular files in Linux. I believe they will always return ready to read even if reading would block. So usually a thread or forked process is actually required when handling files unless you dont mind disk seeks pausing the entire event loop on your server.
tung 15y ago
The correct title for this is "Lua/APR: Apache Portable Runtime binding for Lua". I'm pointing this out because I'm tired of seeing submission titles used to make a point instead of describing what's behind the link. This mightn't be a big deal for other people, but personally, I don't like having opinions[#] forced on me like this. [#] The opinion here is that Lua needs a standard library. Maybe it does, maybe it doesn't, but I want to come to that conclusion myself, that's all.
- xolox 15y ago
  This is my fault really, the first paragraph of the homepage contains the following remark: > APR powers software such as the Apache webserver and Subversion and Lua/APR makes the APR operating system interfaces available to Lua, serving as an extended standard library. I wrote that description because I like Lua so much that I want to use it not only for embedding but also for writing standalone scripts. However I found that writing standalone Lua scripts that run on both Windows and UNIX is hard because Lua's standard library contains almost no operating system interfaces (e.g. no directory handling and minimal process handling). Also lots of third party libraries either work on Windows or POSIX systems but not both. After reading your comments and those by compay about Penlight I realized that "standard library" may not be the best way to describe the Lua/APR binding because its focus is really on being an extended operating system interface.
ay 15y ago
Another interesting combination would be: https://github.com/justincormack/ljsyscall https://github.com/justincormack/ljsyscall this would work with LuaJIT: http://luajit.org/ http://luajit.org/ The FFI in LuaJIT is kind of brilliant. Check yourself. EDIT: with FFI in LuaJIT you can jump very comfortably between the high-level Lua code and low-level native calls. It's almost addictive. And the code is running X times faster than the Lua baseline (X between single-digit and triple-digit values).
- malkia 15y ago
  I've made LuaJIT FFI bindings to some "C" precompiled libraries for these platforms: OSX, iOS, Windows, Linux (x86+arm) There libraries are: GLFW, SDL, ZeroMQ, AntTweakBar, and planning on few more. There is also OpenCL and OpenGL and glu. Please visit: http://github.com/malkia/ufo http://github.com/malkia/ufo You should not need to recompile, as I've packaged the binaries.

100 points by piranha 15y ago

This is very nice. It's good to see examples weaved into the site on how to use it. If anything, main libapr site could use something a bit better than the Doxygen output manual as reading the unit tests from the actual source is more approachable to me than their documentation.

xolox 15y ago
I totally agree on the Doxygen documentation and indeed, while writing the Lua/APR binding the APR unit tests were more useful to me than the public headers and documentation. I must admit I also looked through the implementation here and there, when the documentation didn't explain the 'grand scheme' and there were no tests to read :-(

shubber 15y ago

I have to admit, that's kind of brilliant.

xolox 15y ago

Hi all, author of the Lua/APR binding here. If you have any questions or comments, feel free to post them here. I haven't gotten a lot of feedback on the binding yet so would love to hear what people think about it!

jolan 15y ago
Nice job. This fills a big gap in Lua. I think the stewards of Lua are afraid to grow the standard library because most of Lua's early popularity stemmed from how small and embeddable it is.

BasDirks 15y ago

Don't mean to hijack, but could I be referred to a good introduction to Lua? I keep hearing about it, but it's one of the few languages I know NOTHING about, and I have a free weekend!

justincormack 15y ago
The reference manual is very well written http://www.lua.org/manual/ http://www.lua.org/manual/
xolox 15y ago
The first edition of "Programming in Lua" is available for free online and might make for more interesting reading than the reference manual: http://www.lua.org/pil/ http://www.lua.org/pil/
reginaldo 15y ago
When I was getting started I bought the "Programming in Lua"[1] ebook, by the author of Lua himself. There's an older edition available for free online[2]. Then there's of course the lua users wiki and its "Learning Lua" section[3]. I find the wiki a little hard to navigate so I just went ahead and bought the book. IMHO the gems in Chapter 10 (Complete Examples) and the clear explanation of coroutines are alone worth the price. The rest is a very nice bonus too. [1] http://store.feistyduck.com/products/programming-in-lua http://store.feistyduck.com/products/programming-in-lua [2] http://www.lua.org/pil/ http://www.lua.org/pil/ [3] http://lua-users.org/wiki/LearningLua http://lua-users.org/wiki/LearningLua
- BasDirks 15y ago
  Thank you (and all other commenters) kindly. I purchased the book.
huyegn 15y ago
If you liked Kernighan and Ritchie's "The C Programming Language", then you'll love "Programming In Lua". The first edition is available online here: http://www.lua.org/pil/ http://www.lua.org/pil/ Like K&R, it's style is colloquially terse, yet each sentence is chock full of information. It's a great book for someone who's already coming from another language like Python. If you're into graphics programming, then http://love2d.org/ http://love2d.org/ would be the perfect vehicle for you to get into Lua while you read PIL.
swah 15y ago

compay 15y ago

That's a very useful library, and also great example of how easy it is to hook into C code from Lua. Another one which I prefer personally because it's more comprehensive, is Steve Donovan's Penlight. If you have a background in Python you might enjoy using it: https://github.com/stevedonovan/Penlight https://github.com/stevedonovan/Penlight

philips 15y ago
If you are interested in hooking C from Lua or vice versa: I gave a recent talk on the ways of hooking C code from Lua at Open Source Bridge. The slides and code are here: https://github.com/philips/beaming-up-alien https://github.com/philips/beaming-up-alien Sometimes really simple examples can be useful.

davidhollander 15y ago

Only downside with LuaAPR is you're back to writing Apache style servers, with an OS thread for every connection instead of using non-blocking sockets where possible (Didn't find any support for nonblocking sockets or a select\poll variant in the linked docs) For my Lua server [1] I currently use the nixio library from the LuCI project and polling instead[2] Although the downside of both nixio and Lua/APR library is the use of compiled C bindings to manually interact with the virtual machine. The exciting development with LuaJIT is the high performance FFI that allows you to make system calls and create structs directly from in Lua[3], so I am currently considering switching from nixio to ljsyscall when I do a new version [4] [1]https://github.com/davidhollander/ox https://github.com/davidhollander/ox [2]http://neopallium.github.com/nixio/ http://neopallium.github.com/nixio/ [3]http://luajit.org/ext_ffi_tutorial.html http://luajit.org/ext_ffi_tutorial.html [4]https://github.com/justincormack/ljsyscall https://github.com/justincormack/ljsyscall

drudru11 15y ago
There is a good reason for the thread per connection architecture and there is a good reason for the polling style arch. The latter being better for static content.
- davidhollander 15y ago
  I'd contend the opposite, polling is better for dynamic content. Let's say you have 1000 requests for a landing page, and the landing page has a data request that scrapes the entire database to find the popular-maximum-geo-similarity-reccomendation-zone-geo-user-thing list for the entire site, but only updates once every 10 seconds. Ideally, you want to only send at most 1 request to your database every 10 seconds, without having to open a new connection. If you are doing a polling server and have all 1000 clients waiting for the data, you can trigger a callback to all of them when the database reports back without having to recopy data, use shared memory, do more ipc, or context switches. And for the 1000 clients to pause to wait for that single combined data callback, no extra blocking reads\connections to anything were necessary. If by static content you are referring to file transfers, polling does not actually work on regular files in Linux. I believe they will always return ready to read even if reading would block. So usually a thread or forked process is actually required when handling files unless you dont mind disk seeks pausing the entire event loop on your server.

tung 15y ago

The correct title for this is "Lua/APR: Apache Portable Runtime binding for Lua". I'm pointing this out because I'm tired of seeing submission titles used to make a point instead of describing what's behind the link. This mightn't be a big deal for other people, but personally, I don't like having opinions[#] forced on me like this. [#] The opinion here is that Lua needs a standard library. Maybe it does, maybe it doesn't, but I want to come to that conclusion myself, that's all.

xolox 15y ago
This is my fault really, the first paragraph of the homepage contains the following remark: > APR powers software such as the Apache webserver and Subversion and Lua/APR makes the APR operating system interfaces available to Lua, serving as an extended standard library. I wrote that description because I like Lua so much that I want to use it not only for embedding but also for writing standalone scripts. However I found that writing standalone Lua scripts that run on both Windows and UNIX is hard because Lua's standard library contains almost no operating system interfaces (e.g. no directory handling and minimal process handling). Also lots of third party libraries either work on Windows or POSIX systems but not both. After reading your comments and those by compay about Penlight I realized that "standard library" may not be the best way to describe the Lua/APR binding because its focus is really on being an extended operating system interface.

ay 15y ago

Another interesting combination would be: https://github.com/justincormack/ljsyscall https://github.com/justincormack/ljsyscall this would work with LuaJIT: http://luajit.org/ http://luajit.org/ The FFI in LuaJIT is kind of brilliant. Check yourself. EDIT: with FFI in LuaJIT you can jump very comfortably between the high-level Lua code and low-level native calls. It's almost addictive. And the code is running X times faster than the Lua baseline (X between single-digit and triple-digit values).

malkia 15y ago
I've made LuaJIT FFI bindings to some "C" precompiled libraries for these platforms: OSX, iOS, Windows, Linux (x86+arm) There libraries are: GLFW, SDL, ZeroMQ, AntTweakBar, and planning on few more. There is also OpenCL and OpenGL and glu. Please visit: http://github.com/malkia/ufo http://github.com/malkia/ufo You should not need to recompile, as I've packaged the binaries.