NLua is a fork project of LuaInterface (from Fábio Mascarenhas/Craig Presti).
Example: using NLua from command line.
NLua allows the usage of Lua from C#, on Windows, Linux, Mac, iOS , Android, Windows Phone 7 and 8.
[16]: http://nvlabs.github.com/cub/download-icon.png (Download for Windows Phone Silverlight 8 (ARM+x86))
[18]: http://nvlabs.github.com/cub/download-icon.png (Download for Windows Phone 8 (RT) (ARM+x86))
| Build Status | Download | |
|---|---|---|
| Linux |  |
|
| OSX |  |
|
| iOS | |
|
| Android | |
|
| Win32 | |
|
| Win64 | |
|
| .NET Pure C# | |
|
| WP8 (Silverlight) | ![dwn_wpsl8][16] | |
| WP8 (WinRT) | ![dwn_wp8][18] | |
| Windows Phone 7 | |
|
| Unity3D | |
Unity3D support branch: unity3d by Riley G.
Windows: We don't have a CI Server for Windows yet. To build NLua you will need msysgit, CMake and NUnit http://screencast.com/t/rYuDtCdFG7
string script = @"
local s = Scriptable (""My String Parameter"")
s:DoSomething ()
print (s.Param1)
local ret = s:SumOfLengths (""Name"", 10);
print (tostring(ret))
Scriptable.Print(""Hello NLua"")
s.Param3 = 0.5;
local p2 = tostring(s.Param3)
print (p2)
";
using (Lua lua = new Lua ()) {
lua.LoadCLRPackage ();
lua.DoString (@" import ('NLuaSample') ");
lua ["gValue"] = "This is a global value"; // You can set a global value.
var returns = lua.DoString (script);
Console.WriteLine (returns);
}Copyright (c) 2014 Vinicius Jarina (viniciusjarina@gmail.com)
- Added support to WinRT (Windows Phone 8)
- Added support to Unity3D
- Update Lua 5.2.3 with latest patches
- Fixed support to Unicode strings (UTF-8)
- Fixed x86/x64 issue.
- Fixed overload issue
- Fixed support to Debug and DebugHook APIs
- Added support to operators call
- Fixed access to keys with .
- Fixed issue with ValueTypes
- Update Lua to 5.2.3
- Update to Xamarin components store. (http://components.xamarin.com/view/NLua)
- NuGet Package (https://www.nuget.org/packages/NLua/)
- Port to Android 15+ (armeabi, v7a, x86)
- Updated Lua 5.2.2 (patch 7)
- Lot of Bug fixes.
- Port to WP7 (Thanks to Mangatome)
- NLua now using Lua 5.2.2
- Bug fixes.
- Forked from LuaInterface 2.0.4
- Added iOS support using KeraLua (C# P/Invoke Lua)
###Help NLua### If you are using NLua, consider helping with some easy todo items.
- Windows CI server.
- Port to other platforms (using a csproj/sln for each platform like RestSharp/MonoGame/Cocos2d-XNA) * Unity Pro (using p/invoke) * Port NLua to use LuaJIT
- Create a NuGet package
- Fix warnings/Gendarme/FxCop issues.
- Contributing
- NLua uses the Mono Code-Style http://www.mono-project.com/Coding_Guidelines .
- Please, do not change the line-end or re-indent the code.
- Run the tests before you push.
- Avoid pushing style changes (unless they are really needed), renaming and move code.
Copyright (c) 2003-2006 Fabio Mascarenhas de Queiroz
Maintainer: Craig Presti, craig@vastpark.com
lua51.dll and lua51.exe are Copyright (c) 2005 Tecgraf, PUC-Rio
-
Look at src/TestNLua/TestLua to see an example of usage from C# (optionally you can run this from inside the NLua solution using the debugger).
Also provides a good example of how to override .NET methods of Lua and usage of NLua from within your .NET application. -
Look at samples/testluaform.lua to see examples of how to use .NET inside Lua
-
More installation and usage instructions in the doc/guide.pdf file.
- Fix: Private methods accessible via LuaInterface
- Fix: Method overload lookup failures
- Fix: Lua DoFile memory leaks when file not found (submitted by Paul Moore)
- Fix: Lua Dispose not freeing memory (submitted by Paul Moore)
- Fix: Better support for accessing indexers
- Fix: Parsing error for MBCS characters (qingrui.li)
- Fix: Dispose errors originating from LuaTable, LuaFunction, LuaUserData
- Fix: LuaInterface no longer disposes the state when passed one via the overloaded constructor
- Added: LoadString and LoadFile (submitted by Paul Moore)
- Added: Overloaded DoString
- Added: Lua debugging support (rostermeier)
- Apparently the 2.0 built binaries had an issue for some users, this is just a rebuild with the lua sources pulled into the LuaInterface.zip
- The base lua5.1.2 library is now built as entirely manged code. LuaInterface is now pure CIL
- Various adapters to connect the older x86 version of lua are no longer needed
- Performance fixes contributed by Toby Lawrence, Oliver Nemoz and Craig Presti
- Internal lua panics (due to API violations) now throw LuaExceptions into .net
- If .net code throws an exception into Lua and lua does not handle it, the original exception is forwarded back out to .net land.
- Fix bug in the Lua 5.1.1 gmatch C code - it was improperly assuming gmatch only works with tables.
- Overriding C# methods from Lua is fixed (broken with .net 2.0!)
- Registering static C# functions for Lua is fixed (broken with Lua-5.1.1)
- Rebuilt to fix linking problems with the binaries included in 1.5.1
- RegisterFunction has been leaking things onto the stack
Fix a serious bug w.r.t. garbage collection - made especially apparent with the new lua5.1 switch: If you were very unlucky with timing sometimes Lua would loose track of pointers to CLR functions.
When I added support for static methods, I allowed the user to use either a
colon or a dot to separate the method from the class name. This was not
correct - it broke disambiguation between overloaded static methods.
Therefore, LuaInterface is now more strict: If you want to call a static
method, you must use dot to separate the method name from the class name. Of
course you can still use a colon if an instance is being used.
Static method calls are now much faster (due to better caching).
LuaInterface is now updated to be based on Lua5.1.1. You can either use your own build/binaries for Lua5.1.1 or use the version distributed here. (Lots of thanks to Steffen Itterheim for this work!)
LuaInterface.Lua no longer has OpenLibs etc... The base mechanism for library loading for Lua has changed, and we haven't yet broken appart the library loading for LuaInterface. Instead, all standard Lua libraries are automatically loaded at start up.
Fixed a bug where calls of some static methods would reference an invalid pointer.
Fixed a bug when strings with embedded null characters are passed in or out of Lua (Thanks to Daniel N�ri for the report & fix!)
The native components in LuaInterface (i.e. Lua51 and the loader) are both built as release builds - to prevent problems loading standard windows libraries.
Note: You do not need to download/build lua-5.1.1.zip unless you want to modify Lua internals (a built version of lua51.dll is included in the regular LuaInterface distribution)
Note: Fabio area of interest has moved off in other directions (hopefully only temporarily). I've talked with Fabio and he's said he's okay with me doing a new release with various fixes I've made over the last few months. Changes since 1.3:
Visual Studio 2005/.Net 2.0 is supported.
Compat-5.1 is modified to expect backslash as the path seperator.
LuaInterface will now work correctly with Generic C# classes.
CLR inner types are now supported.
Fixed a problem where sometimes Lua proxy objects would be associated with the wrong CLR object.
If a CLR class has an array accessor, the elements can be accessed using the regular Lua indexing interface.
Add CLRPackage.lua to the samples directory. This class makes it much easier to automatically load referenced assemblies. In the next release this loading will be automatic.
To see an quick demonstration of LuaInterface, cd into nlua/samples and then type: ....\Built\debug\LuaRunner.exe testluaform.lua
Various other minor fixes that I've forgotten. I'll keep better track next time.
Note: LuaInterface is still based on Lua 5.0.2. If someone really wants us to upgrade to Lua 5.1 please send me a note. In the mean time, I'm also distributing a version of Lua 5.0.2 with an appropriate VS 2005 project file. You do not need to download this file unless you want to modify Lua internals (a built version of lua50.dll is included in the regular LuaInterface distribution)
LuaInterface now works with LuaBinaries Release 2 (http://luabinaries.luaforge.net) and Compat-5.1 Release 3 (http://luaforge.net/projects/compat). The loader DLL is now called luanet.dll, and does not need a nlua.lua file anymore (just put LuaInterface.dll in the GAC, luanet.dll in your package.cpath, and do require"luanet").
Fixed a bug in the treatment of the char type (thanks to Ron Scott).
LuaInterface.dll now has a strong name, and can be put in the GAC (thanks to Ivan Voras).
You can now use foreach with instances of LuaTable (thanks to Zachary Landau).
There is an alternate form of loading assemblies and importing types (based on an anonymous contribution in the Lua wiki). Check the _alt files in the samples folder.
Now checks if two LuaInterface.Lua instances are trying to share the same Lua state, and throws an exception if this is the case. Also included readonly clauses in public members of the Lua and ObjectTranslator classes.
This version includes the source of LuaInterfaceLoader.dll, with VS.Net 2003 project files.
LuaInterface now can be loaded as a module, so you can use the lua standalone interpreter to run scripts. Thanks to Paul Winwood for this idea and sample code showing how to load the CLR from a C++ program. The module is "nlua". Make sure Lua can find nlua.lua, and LuaInterfaceLoader.dll is either in the current directory or the GAC. The samples now load LuaInterface as a module, in its own namespace.
The get_method_bysig, get_constructor_bysig and make_object were changed: now you pass the names of the types to them, instead of the types themselves. E.g:
get_method_bysig(obj,"method","System.String")
instead of
String = import_type("System.String") get_method_bysig(obj,"method",String)
Make sure the assemblies of the types you are passing have been loaded, or the call will fail. The test cases in src/TestLuaInterface/TestLua.cs have examples of the new functions.