Repository files navigation

MoonScript is a programmer friendly language that compiles intoLua. It gives you the power of the fastest scriptinglanguage combined with a rich set of features. It runs on Lua 5.1 and above,including alternative runtimes like LuaJIT.

Seehttps://moonscript.org.

Online demo/compiler athttps://moonscript.org/compiler.

We have a Discord for those interested in MoonScript and related projects. You can join us here:https://discord.gg/Y75ZXrD

MoonScript is a self-hosted compiler, meaning it's written in MoonScript itself. When contributing, please follow the following guidelines:

1. Edit.moon files, never modify the alongside.lua files directly
2. After making changes to.moon files, run the compiler to regenerate the corresponding.lua files
3. Both.moon and.lua files are included in the repository to ensure that:
   • Users can install and use MoonScript without having to compile it themselves
   • The compiler bootstrapping process works consistently

It's helpful to have a separate installation of MoonScript should you breaksomething and you need to re-build the MoonScript with a working version ofMoonScript. You can check out the repo in another directory, or install itusing LuaRocks to have a separate working version.

Tests are written in MoonScript and useBusted.In order to run the tests you must have MoonScript andLoadkit installed.

To run tests, execute from the root directory:

busted

Writing specs is a bit more complicated. Check outthe spec writing guide.

Precompiled versions of MoonScript are provided for Windows. You can find themin theGitHub releases page.(Scroll down to thewin32- tags.

The build code can be found in thebinariesbranch

• Vim
• Textadept
• Sublime/Textmate
• Emacs

Copyright (C) 2025 by Leaf Corcoran

Permission is hereby granted, free of charge, to any person obtaining a copyof this software and associated documentation files (the "Software"), to dealin the Software without restriction, including without limitation the rightsto use, copy, modify, merge, publish, distribute, sublicense, and/or sellcopies of the Software, and to permit persons to whom the Software isfurnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included inall copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS ORIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THEAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHERLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS INTHE SOFTWARE.