Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

`0.9.0`

Breaking changes

Added two new process spawning functions - process.create and process.exec, removing the previous process.spawn API completely. (#211)

To migrate from process.spawn, use the new process.exec API which retains the same behavior as the old function.

The new process.create function is a non-blocking process creation API and can be used to interactively read and write stdio of the process.
```
local child = process.create("program", {
  "cli-argument",
  "other-cli-argument"
})

-- Writing to stdin
child.stdin:write("Hello from Lune!")

-- Reading from stdout
local data = child.stdout:read()
print(buffer.tostring(data))
```
WebSocket methods in net.socket and net.serve now use standard Lua method calling convention and colon syntax. This means socket.send(...) is now socket:send(...), socket.close(...) is now socket:close(...), and so on.
Runtime::run now returns a more useful value instead of an ExitCode (#178)

Changed

Documentation comments for several standard library properties have been improved (#248, #250)
Error messages no longer contain redundant or duplicate stack trace information

`0.8.9` - October 7th, 2024

Changed

Updated to Luau version 0.640

`0.8.8` - August 22nd, 2024

Fixed

Fixed errors when deserializing Lighting.AttributesSerialize by updating rbx-dom dependencies (#245)

`0.8.7` - August 10th, 2024

Added

Added a compression level option to serde.compress (#224)
Added missing vector methods to the roblox library (#228)

Changed

Updated to Luau version 0.635
Updated to rbx-dom database version 0.634

Fixed

Fixed fs.readDir with trailing forward-slash on Windows (#220)
Fixed __type and __tostring metamethods not always being respected when formatting tables

`0.8.6` - June 23rd, 2024

Added

Added a builtin API for hashing and calculating HMACs as part of the serde library (#193)

Basic usage:
```
local serde = require("@lune/serde")
local hash = serde.hash("sha256", "a message to hash")
local hmac = serde.hmac("sha256", "a message to hash", "a secret string")

print(hash)
print(hmac)
```
The returned hashes are sequences of lowercase hexadecimal digits. The following algorithms are supported: md5, sha1, sha224, sha256, sha384, sha512, sha3-224, sha3-256, sha3-384, sha3-512, blake3
Added two new options to luau.load:
- codegenEnabled - whether or not codegen should be enabled for the loaded chunk.
- injectGlobals - whether or not to inject globals into a passed environment.
By default, globals are injected and codegen is disabled. Check the documentation for the luau standard library for more information.
Implemented support for floor division operator / __idiv for the Vector2 and Vector3 types in the roblox standard library (#196)
Fixed the _VERSION global containing an incorrect Lune version string.

Changed

Sandboxing and codegen in the Luau VM is now fully enabled, resulting in up to 2x or faster code execution. This should not result in any behavior differences in Lune, but if it does, please open an issue.
Improved formatting of custom error objects (such as when fs.readFile returns an error) when printed or formatted using stdio.format.

Fixed

Fixed __type and __tostring metamethods on userdatas and tables not being respected when printed or formatted using stdio.format.

`0.8.5` - June 1st, 2024

Changed

Improved table pretty formatting when using print, warn, and stdio.format:
- Keys are sorted numerically / alphabetically when possible.
- Keys of different types are put in distinct sections for mixed tables.
- Tables that are arrays no longer display their keys.
- Empty tables are no longer spread across lines.

Fixed

Fixed formatted values in tables not being separated by newlines.
Fixed panicking (crashing) when using process.spawn with a program that does not exist.
Fixed instance:SetAttribute("name", nil) throwing an error and not removing the attribute.

`0.8.4` - May 12th, 2024

Added

Added a builtin API for regular expressions.

Example basic usage:

local Regex = require("@lune/regex")

local re = Regex.new("hello")

if re:isMatch("hello, world!") then
	print("Matched!")
end

local caps = re:captures("hello, world! hello, again!")

print(#caps) -- 2
print(caps:get(1)) -- "hello"
print(caps:get(2)) -- "hello"
print(caps:get(3)) -- nil

Check out the documentation for more details.

Added support for buffers as arguments in builtin APIs (#148)

This includes APIs such as fs.writeFile, serde.encode, and more.
Added support for cross-compilation of standalone binaries (#162)

You can now compile standalone binaries for other platforms by passing an additional target argument to the build subcommand:
```
lune build my-file.luau --output my-bin --target windows-x86_64
```
Currently supported targets are the same as the ones included with each release of Lune on GitHub. Check releases for a full list of targets.
Added stdio.readToEnd() for reading the entire stdin passed to Lune

Changed

Split the repository into modular crates instead of a monolith. (#188)

If you previously depended on Lune as a crate, nothing about it has changed for version 0.8.4, but now each individual sub-crate has also been published and is available for use:
- lune (old)
- lune-utils
- lune-roblox
- lune-std-* for every builtin library
When depending on the main lune crate, each builtin library also has a feature flag that can be toggled in the format std-*.

In general, this should mean that it is now much easier to make your own Lune builtin, publish your own flavor of a Lune CLI, or take advantage of all the work that has been done for Lune as a runtime when making your own Rust programs.
Changed the User-Agent header in net.request to be more descriptive (#186)
Updated to Luau version 0.622.

Fixed

Fixed not being able to decompress lz4 format in high compression mode
Fixed stack overflow for tables with circular keys (#183)
Fixed net.serve no longer accepting ipv6 addresses
Fixed headers in net.serve being raw bytes instead of strings

`0.8.3` - April 15th, 2024

Fixed

Fixed require not throwing syntax errors (#168)
Fixed require caching not working correctly (#171)
Fixed case-sensitivity issue in require with aliases (#173)
Fixed itertools dependency being marked optional even though it is mandatory (#176)
Fixed test cases for the net built-in library on Windows (#177)

`0.8.2` - March 12th, 2024

Fixed

Fixed REPL panicking after the first evaluation / run.
Fixed globals reloading on each run in the REPL, causing unnecessary slowdowns.
Fixed net.serve requests no longer being plain tables in Lune 0.8.1, breaking usage of things such as table.clone.

`0.8.1` - March 11th, 2024

Added

Added the ability to specify an address in net.serve. (#142)

Changed

Update to Luau version 0.616.
Major performance improvements when using a large amount of threads / asynchronous Lune APIs. (#165)
Minor performance improvements and less overhead for net.serve and net.socket. (#165)

Fixed

Fixed fs.copy not working with empty dirs. (#155)
Fixed stack overflow when printing tables with cyclic references. (#158)
Fixed not being able to yield in net.serve handlers without blocking other requests. (#165)
Fixed various scheduler issues / panics. (#165)

`0.8.0` - January 14th, 2024

Breaking Changes

The Lune CLI now uses subcommands instead of flag options:
- lune script_name arg1 arg2 arg3 -> lune run script_name arg1 arg2 arg3
- lune --list -> lune list
- lune --setup -> lune setup
This unfortunately hurts ergonomics for quickly running scripts but is a necessary change to allow us to add more commands, such as the new build subcommand.
The createdAt, modifiedAt, and accessedAt properties returned from fs.metadata are now DateTime values instead of numbers.
The Lune struct has been renamed to Runtime in the Lune rust crate.

Added

Added support for compiling single Lune scripts into standalone executables! (#140)

Example usage:
```
-- my_cool_script.luau
print("Hello, standalone!")
```
```
> lune build my_cool_script.luau
# Creates `my_cool_script.exe` (Windows) or `my_cool_script` (macOS / Linux)
```
```
> ./my_cool_script.exe # Windows
> ./my_cool_script # macOS / Linux
> "Hello, standalone!"
```
To compile scripts that use require and reference multiple files, a bundler such as darklua should preferrably be used. You may also distribute files alongside the standalone binary, they will still be able to be require-d. This limitation will be lifted in the future and Lune will automatically bundle any referenced scripts.

Added support for path aliases using .luaurc config files!

For full documentation and reference, check out the official Luau RFC, but here's a quick example:

// .luaurc
{
  "aliases": {
    "modules": "./some/long/path/to/modules"
  }
}

-- ./some/long/path/to/modules/foo.luau
return { World = "World!" }

-- ./anywhere/you/want/my_script.luau
local mod = require("@modules/foo")
print("Hello, " .. mod.World)

Added support for multiple values for a single query, and multiple values for a single header, in net.request. This is a part of the HTTP specification that is not widely used but that may be useful in certain cases. To clarify:

Single values remain unchanged and will work exactly the same as before.

-- https://example.com/?foo=bar&baz=qux
local net = require("@lune/net")
net.request({
    url = "example.com",
    query = {
        foo = "bar",
        baz = "qux",
    }
})

Multiple values on a single query / header are represented as an ordered array of strings.

-- https://example.com/?foo=first&foo=second&foo=third&bar=baz
local net = require("@lune/net")
net.request({
    url = "example.com",
    query = {
        foo = { "first", "second", "third" },
        bar = "baz",
    }
})

Changed

Update to Luau version 0.606.

Fixed

Fixed the print and warn global functions yielding the thread, preventing them from being used in places such as the callback to table.sort.
Fixed the overwrite option for fs.move not correctly removing existing files / directories. (#133)

`0.7.11` - October 29th, 2023

Changed

Update to Luau version 0.601.

Fixed

Fixed roblox.getAuthCookie not being compatible with the latest cookie format by upgrading rbx_cookie.

`0.7.10` - October 25th, 2023

Added

Added the GetDebugId instance method to the roblox built-in. This will return the internal id used by the instance, and as the name implies, it should be primarily used for debugging purposes and cases where you need a globally unique identifier for an instance. It is guaranteed to be a 32-digit hexadecimal string.

Fixed

Fixed issues with SecurityCapabilities on instances in the roblox built-in by upgrading rbx-dom.

`0.7.9` - October 21st, 2023

Added

Added implementProperty and implementMethod to the roblox built-in library to fill in missing functionality that Lune does not aim to implement itself.

Example usage:

local roblox = require("@lune/roblox")

local part = roblox.Instance.new("Part")

roblox.implementMethod("BasePart", "TestMethod", function(_, ...)
    print("Tried to call TestMethod with", ...)
end)

part:TestMethod("Hello", "world!")

Changed

Update to Luau version 0.599.
Stdio options when using process.spawn can now be set with more granularity, allowing stderr & stdout to be disabled individually and completely to improve memory usage when they are not being used.

`0.7.8` - October 5th, 2023

Added

Added a new datetime built-in library for handling date & time values, parsing, formatting, and more. (#94)

Example usage:

local DateTime = require("@lune/datetime")

-- Creates a DateTime for the current exact moment in time
local now = DateTime.now()

-- Formats the current moment in time as an ISO 8601 string
print(now:toIsoDate())

-- Formats the current moment in time, using the local
-- time, the French locale, and the specified time string
print(now:formatLocalTime("%A, %d %B %Y", "fr"))

-- Returns a specific moment in time as a DateTime instance
local someDayInTheFuture = DateTime.fromLocalTime({
    year = 3033,
    month = 8,
    day = 26,
    hour = 16,
    minute = 56,
    second = 28,
    millisecond = 892,
})

-- Extracts the current local date & time as separate values (same values as above table)
print(now:toLocalTime())

-- Returns a DateTime instance from a given float, where the whole
-- denotes the seconds and the fraction denotes the milliseconds
-- Note that the fraction for millis here is completely optional
DateTime.fromUnixTimestamp(871978212313.321)

-- Extracts the current universal (UTC) date & time as separate values
print(now:toUniversalTime())

Added support for passing stdin in process.spawn (#106)
Added support for setting a custom environment in load options for luau.load, not subject to getfenv / setfenv deoptimizations
Added Terrain:GetMaterialColor and Terrain:SetMaterialColor (#93)
Added support for a variable number of arguments for CFrame methods (#85)

Changed

Update to Luau version 0.596.
Update to rbx-dom database version 0.596.
process.spawn now uses powershell instead of /bin/bash as the shell on Windows, with shell = true.
CFrame and Vector3 values are now rounded to the nearest 2 ^ 16 decimal place to reduce floating point errors and diff noise. Note that this does not affect intermediate calculations done in lua, and only happens when a property value is set on an Instance.

Fixed

Fixed the process built-in library not loading correctly when using Lune in REPL mode.
Fixed list subcommand not listing global scripts without a local .lune / lune directory present.
Fixed net.serve stopping when the returned ServeHandle is garbage collected.
Fixed missing trailing newline when using the warn global.
Fixed constructor for CFrame in the roblox built-in library not parsing the 12-arg overload correctly. (#102)
Fixed various functions for CFrame in the roblox built-in library being incorrect, specifically row-column ordering and some flipped signs. (#103)
Fixed cross-service Instance references disappearing when using the roblox built-in library (#117)

`0.7.7` - August 23rd, 2023

Added

Added a REPL to Lune. (#83)

This allows you to run scripts within Lune without writing files!

Example usage, inside your favorite terminal:

# 1. Run the Lune executable, without any arguments
lune

# 2. You will be shown the current Lune version and a blank prompt arrow:
Lune v0.7.7
>

# 3. Start typing, and hit enter when you want to run your script!
#    Your script will run until completion and output things along the way.
> print(2 + 3)
5
> print("Hello, lune changelog!")
Hello, lune changelog!

# 4. You can also set variables that will get preserved between runs.
#    Note that local variables do not get preserved here.
> myVariable = 123
> print(myVariable)
123

# 5. Press either of these key combinations to exit the REPL:
#    - Ctrl + D
#    - Ctrl + C

Added a new luau built-in library for manually compiling and loading Luau source code. (#82)

Example usage:

local luau = require("@lune/luau")

local bytecode = luau.compile("print('Hello, World!')")
local callableFn = luau.load(bytecode)

callableFn()

-- Additionally, we can skip the bytecode generation and
-- load a callable function directly from the code itself.
local callableFn2 = luau.load("print('Hello, World!')")

callableFn2()

Changed

Update to Luau version 0.591.
Lune's internal task scheduler and require functionality has been completely rewritten.
The new scheduler is much more stable, conforms to a larger test suite, and has a few additional benefits:
- Built-in libraries are now lazily loaded, meaning nothing gets allocated until the built-in library gets loaded using require("@lune/builtin-name"). This also improves startup times slightly.
- Spawned processes using process.spawn now run on different thread(s), freeing up resources for the main thread where luau runs.
- Serving requests using net.serve now processes requests on background threads, also freeing up resources. In the future, this will also allow us to offload heavy tasks such as compression/decompression to background threads.
- Groundwork for custom / user-defined require aliases has been implemented, as well as absolute / cwd-relative requires. These will both be exposed as options and be made available to use some time in the future.
When using the serde built-in library, keys are now sorted during serialization. This means that the output of encode is now completely deterministic, and wont cause issues when committing generated files to git etc.

Fixed

Fixed not being able to pass arguments to the thread using coroutine.resume. (#86)
Fixed a large number of long-standing issues, from the task scheduler rewrite:
- Fixed require hanging indefinitely when the module being require-d uses an async function in its main body.
- Fixed background tasks (such as net.serve) not keeping Lune alive even if there are no lua threads to run.
- Fixed spurious panics and error messages such as Tried to resume next queued future but none are queued.
- Fixed not being able to catch non-string errors properly, errors were accidentally being wrapped in an opaque userdata type.

`0.7.6` - August 9th, 2023

Changed

Update to Luau version 0.588
Enabled Luau JIT backend for potential performance improvements 🚀
If you run into any strange behavior please open an issue!

Fixed

Fixed publishing of the Lune library to crates.io
Fixed serde.decode deserializing null values as userdata instead of nil.
Fixed not being able to require files with multiple extensions, eg. module.spec.luau was not require-able using require("module.spec").
Fixed instances and roblox built-in library APIs erroring when used asynchronously/concurrently.

`0.7.5` - July 22nd, 2023

Added

Lune now has a new documentation site!
This addresses new APIs from version 0.7.0 not being available on the docs site, brings much improved searching functionality, and will help us keep documentation more up-to-date going forward with a more automated process. You can check out the new site at lune-org.github.io.

Added fs.copy to recursively copy files and directories.

Example usage:

local fs = require("@lune/fs")

fs.writeDir("myCoolDir")
fs.writeFile("myCoolDir/myAwesomeFile.json", "{}")

fs.copy("myCoolDir", "myCoolDir2")

assert(fs.isDir("myCoolDir2"))
assert(fs.isFile("myCoolDir2/myAwesomeFile.json"))
assert(fs.readFile("myCoolDir2/myAwesomeFile.json") == "{}")

Added fs.metadata to get metadata about files and directories.

Example usage:

local fs = require("@lune/fs")

fs.writeFile("myAwesomeFile.json", "{}")

local meta = fs.metadata("myAwesomeFile.json")

print(meta.exists) --> true
print(meta.kind) --> "file"
print(meta.createdAt) --> 1689848548.0577152 (unix timestamp)
print(meta.permissions) --> { readOnly: false }

Added roblox.getReflectionDatabase to access the builtin database containing information about classes and enums.

Example usage:

local roblox = require("@lune/roblox")

local db = roblox.getReflectionDatabase()

print("There are", #db:GetClassNames(), "classes in the reflection database")

print("All base instance properties:")

local class = db:GetClass("Instance")
for name, prop in class.Properties do
	print(string.format(
		"- %s with datatype %s and default value %s",
		prop.Name,
		prop.Datatype,
		tostring(class.DefaultProperties[prop.Name])
	))
end

Added support for running directories with an init.luau or init.lua file in them in the CLI.

Changed

Update to Luau version 0.583

Fixed

Fixed publishing of Lune to crates.io by migrating away from a monorepo.
Fixed crashes when writing a very deeply nested Instance to a file. (#62)
Fixed not being able to read & write to WebSocket objects at the same time. (#68)
Fixed tab character at the start of a script causing it not to parse correctly. (#72)

`0.7.4` - July 7th, 2023

Added

Added support for CFrame and Font types in attributes when using the roblox builtin.

Fixed

Fixed roblox.serializeModel still keeping some unique ids.

`0.7.3` - July 5th, 2023

Changed

When using roblox.serializeModel, Lune will no longer keep internal unique ids.
This is consistent with what Roblox does and prevents Lune from always generating a new and unique file.
This previously caused unnecessary diffs when using git or other kinds of source control. (Relevant issue)

`0.7.2` - June 28th, 2023

Added

Added support for init files in directories, similar to Rojo, or index.js / mod.rs in JavaScript / Rust.
This means that placing a file named init.luau or init.lua in a directory will now let you require that directory.

Changed

The lune --setup command is now much more user-friendly.
Update to Luau version 0.581

`0.7.1` - June 17th, 2023

Added

Added support for TLS in websockets, enabling usage of wss://-prefixed URLs. (#57)

Fixed

Fixed closeCode erroring when being accessed on websockets. (#57)
Fixed issues with UniqueId when using the roblox builtin by downgrading rbx-dom.

`0.7.0` - June 12th, 2023

Breaking Changes

Globals for the fs, net, process, stdio, and task builtins have been removed, and the require("@lune/...") syntax is now the only way to access builtin libraries. If you have previously been using a global such as fs directly, you will now need to put local fs = require("@lune/fs") at the top of the file instead.
Migrated several functions in the roblox builtin to new, more flexible APIs:
- readPlaceFile -> deserializePlace
- readModelFile -> deserializeModel
- writePlaceFile -> serializePlace
- writeModelFile -> serializeModel
These new APIs no longer use file paths, meaning to use them with files you must first read them using the fs builtin.
Removed CollectionService and its methods from the roblox builtin library - new instance methods have been added as replacements.
Removed Instance:FindFirstDescendant which was a method that was never enabled in the official Roblox API and will soon be removed.
Use the second argument of the already existing find methods instead to find descendants.
Removed the global printinfo function - it was generally not used, and did not work as intended. Use the stdio builtin for formatting and logging instead.
Removed support for Windows on ARM - it's more trouble than its worth right now, we may revisit it later.

Added

Added serde.compress and serde.decompress for compressing and decompressing strings using one of several compression formats: brotli, gzip, lz4, or zlib.

Example usage:

local INPUT = string.rep("Input string to compress", 16) -- Repeated string 16 times for the purposes of this example

local serde = require("@lune/serde")

local compressed = serde.compress("gzip", INPUT)
local decompressed = serde.decompress("gzip", compressed)

assert(decompressed == INPUT)

Added automatic decompression for compressed responses when using net.request. This behavior can be disabled by passing options = { decompress = false } in request params.
Added support for finding scripts in the current home directory. This means that if you have a script called script-name.luau, you can place it in the following location:
- C:\Users\YourName\.lune\script-name.luau (Windows)
- /Users/YourName/.lune/script-name.luau (macOS)
- /home/YourName/.lune/script-name.luau (Linux)
And then run it using lune script-name from any directory you are currently in.
Added several new instance methods in the roblox builtin library:
Implemented the second argument of the FindFirstChild / FindFirstChildOfClass / FindFirstChildWhichIsA instance methods.

Changed

Update to Luau version 0.579
Both stdio.write and stdio.ewrite now support writing arbitrary bytes, instead of only valid UTF-8.

Fixed

Fixed stdio.write and stdio.ewrite not being flushed and causing output to be interleaved. (#47)
Fixed typeof returning userdata for roblox types such as Instance, Vector3, ...

`0.6.7` - May 14th, 2023

Added

Replaced all of the separate typedef & documentation generation commands with a unified lune --setup command.

This command will generate type definition files for all of the builtins and will work with the new require("@lune/...") syntax. Note that this also means that there is no longer any way to generate type definitions for globals - this is because they will be removed in the next major release in favor of the beforementioned syntax.
New releases now include prebuilt binaries for arm64 / aarch64!
These new binaries will have names with the following format:
- lune-windows-0.6.7-aarch64.exe
- lune-linux-0.6.7-aarch64
- lune-macos-0.6.7-aarch64
Added global types to documentation site

`0.6.6` - April 30th, 2023

Added

Added tracing / logging for rare and hard to diagnose error cases, which can be configured using the env var RUST_LOG.

Changed

The _VERSION global now follows a consistent format Lune x.y.z+luau to allow libraries to check against it for version requirements.

Examples:
- Lune 0.0.0+0
- Lune 1.0.0+500
- Lune 0.11.22+9999
Updated to Luau version 0.573
Updated rbx-dom to support reading and writing Font datatypes

Fixed

Fixed _G not being a readable & writable table
Fixed _G containing normal globals such as print, math, ...
Fixed using instances as keys in tables

`0.6.5` - March 27th, 2023

Changed

Functions such as print, warn, ... now respect __tostring metamethods.

Fixed

Fixed access of roblox instance properties such as Workspace.Terrain, game.Workspace that are actually links to child instances.
These properties are always guaranteed to exist, and they are not always properly set, meaning they must be found through an internal lookup.
Fixed issues with the CFrame.lookAt and CFrame.new(Vector3, Vector3) constructors.
Fixed issues with CFrame math operations returning rotation angles in the wrong order.

`0.6.4` - March 26th, 2023

Fixed

Fixed instances with attributes not saving if they contain integer attributes.
Fixed attributes not being set properly if the instance has an empty attributes property.
Fixed error messages for reading & writing roblox files not containing the full error message.
Fixed crash when trying to access an instance reference property that points to a destroyed instance.
Fixed crash when trying to save instances that contain unsupported attribute types.

`0.6.3` - March 26th, 2023

Added

Added support for instance tags & CollectionService in the roblox built-in.
Currently implemented methods are listed on the docs site.

Fixed

Fixed accessing a destroyed instance printing an error message even if placed inside a pcall.
Fixed cloned instances not having correct instance reference properties set (ObjectValue.Value, Motor6D.Part0, ...)
Fixed Instance::GetDescendants returning the same thing as Instance::GetChildren.

`0.6.2` - March 25th, 2023

This release adds some new features and fixes for the roblox built-in.

Added

Added GetAttribute, GetAttributes and SetAttribute methods for instances.
Added support for getting & setting properties that are instance references.

Changed

Improved handling of optional property types such as optional cframes & default physical properties.

Fixed

Fixed handling of instance properties that are serialized as binary strings.

`0.6.1` - March 22nd, 2023

Fixed

Fixed writePlaceFile and writeModelFile in the new roblox built-in making mysterious "ROOT" instances.

`0.6.0` - March 22nd, 2023

Added

Added a roblox built-in

If you're familiar with Remodel, this new built-in contains more or less the same APIs, integrated into Lune.
There are just too many new APIs to list in this changelog, so head over to the docs sit to learn more!
Added a serde built-in

This built-in contains previously available functions encode and decode from the net global.
The plan is for this built-in to contain more serialization and encoding functionality in the future.
require has been reimplemented and overhauled in several ways:
- New built-ins such as roblox and serde can only be imported using require("@lune/roblox"), require("@lune/serde"), ...
- Previous globals such as fs, net and others can now also be imported using require("@lune/fs"), require("@lune/net"), ...
- Requiring a script is now completely asynchronous and will not block lua threads other than the caller.
- Requiring a script will no longer error when using async APIs in the main body of the required script.
All new built-ins will be added using this syntax and new built-ins will no longer be available in the global scope, and current globals will stay available as globals until proper editor and LSP support is available to ensure Lune users have a good development experience. This is the first step towards moving away from adding each library as a global, and allowing Lune to have more built-in libraries in general.

Behavior otherwise stays the same, and requires are still relative to file unless the special @ prefix is used.
Added net.urlEncode and net.urlDecode for URL-encoding and decoding strings

Changed

Renamed the global info function to printinfo to make it less ambiguous

Removed

Removed experimental net.encode and net.decode functions, since they are now available using require("@lune/serde")
Removed option to preserve default Luau require behavior

`0.5.6` - March 11th, 2023

Added

Added support for shebangs at the top of a script, meaning scripts such as this one will now run without throwing a syntax error:
```
#!/usr/bin/env lune

print("Hello, world!")
```

Fixed

Fixed fs.writeFile and fs.readFile not working with strings / files that are invalid utf-8

`0.5.5` - March 8th, 2023

Added

Added support for running scripts by passing absolute file paths in the CLI
- This does not have the restriction of scripts having to use the .luau or .lua extension, since it is presumed that if you pass an absolute path you know exactly what you are doing

Changed

Improved error messages for passing invalid file names / file paths substantially - they now include helpful formatting to make file names distinct from file extensions, and give suggestions on how to solve the problem
Improved general formatting of error messages, both in the CLI and for Luau scripts being run

Fixed

Fixed the CLI being a bit too picky about file names when trying to run files in lune or .lune directories
Fixed documentation misses from large changes made in version 0.5.0

`0.5.4` - March 7th, 2023

Added

Added support for reading scripts from stdin by passing "-" as the script name
Added support for close codes in the net WebSocket APIs:
- A close code can be sent by passing it to socket.close
- A received close code can be checked with the socket.closeCode value, which is populated after a socket has been closed - note that using socket.close will not set the close code value, it is only set when received and is guaranteed to exist after closure

Changed

Update to Luau version 0.566

Fixed

Fixed scripts having to be valid utf8, they may now use any kind of encoding that base Luau supports
The net WebSocket APIs will no longer return nil for partial messages being received in socket.next, and will instead wait for the full message to arrive

`0.5.3` - February 26th, 2023

Fixed

Fixed lune --generate-selene-types generating an invalid Selene definitions file
Fixed type definition parsing issues on Windows

`0.5.2` - February 26th, 2023

Fixed

Fixed crash when using stdio.color() or stdio.style() in a CI environment or non-interactive terminal

`0.5.1` - February 25th, 2023

Added

Added net.encode and net.decode which are equivalent to net.jsonEncode and net.jsonDecode, but with support for more formats.

WARNING: Unstable API

This API is unstable and may change or be removed in the next major version of Lune. The purpose of making a new release with these functions is to gather feedback from the community, and potentially replace the JSON-specific encoding and decoding utilities.

Example usage:
```
local toml = net.decode("toml", [[
[package]
name = "my-cool-toml-package"
version = "0.1.0"

[values]
epic = true
]])

assert(toml.package.name == "my-cool-toml-package")
assert(toml.package.version == "0.1.0")
assert(toml.values.epic == true)
```

Fixed

Fixed indentation of closing curly bracket when printing tables

`0.5.0` - February 23rd, 2023

Added

Added auto-generated API reference pages and documentation using GitHub wiki pages
Added support for query in net.request parameters, which enables usage of query parameters in URLs without having to manually URL encode values.
Added a new function fs.move to move / rename a file or directory from one path to another.
Implemented a new task scheduler which resolves several long-standing issues:
- Issues with yielding across the C-call/metamethod boundary no longer occur when calling certain async APIs that Lune provides.
- Ordering of interleaved calls to task.spawn/task.defer is now completely deterministic, deferring is now guaranteed to run last even in these cases.
- The minimum wait time possible when using task.wait and minimum delay time using task.delay are now much smaller, and only limited by the underlying OS implementation. For most systems this means task.wait and task.delay are now accurate down to about 5 milliseconds or less.

Changed

Type definitions are now bundled as part of the Lune executable, meaning they no longer need to be downloaded.
- lune --generate-selene-types will generate the Selene type definitions file, replacing lune --download-selene-types
- lune --generate-luau-types will generate the Luau type definitions file, replacing lune --download-luau-types
Improved accuracy of Selene type definitions, strongly typed arrays are now used where possible
Improved error handling and messages for net.serve
Improved error handling and messages for stdio.prompt
File path representations on Windows now use legacy paths instead of UNC paths wherever possible, preventing some confusing cases where file paths don't work as expected

Fixed

Fixed process.cwd not having the correct ending path separator on Windows
Fixed remaining edge cases where the task and coroutine libraries weren't interoperable
Fixed task.delay keeping the script running even if it was cancelled using task.cancel
Fixed stdio.prompt blocking all other lua threads while prompting for input

`0.4.0` - February 11th, 2023

Added

Web Sockets

net now supports web sockets for both clients and servers!
Note that the web socket object is identical on both client and server, but how you retrieve a web socket object is different.

Server API

The server web socket API is an extension of the existing net.serve function.
This allows for serving both normal HTTP requests and web socket requests on the same port.

Example usage:

net.serve(8080, {
    handleRequest = function(request)
        return "Hello, world!"
    end,
    handleWebSocket = function(socket)
        task.delay(10, function()
            socket.send("Timed out!")
            socket.close()
        end)
        -- The message will be nil when the socket has closed
        repeat
            local messageFromClient = socket.next()
            if messageFromClient == "Ping" then
                socket.send("Pong")
            end
        until messageFromClient == nil
    end,
})

Client API

Example usage:

local socket = net.socket("ws://localhost:8080")

socket.send("Ping")

task.delay(5, function()
    socket.close()
end)

-- The message will be nil when the socket has closed
repeat
    local messageFromServer = socket.next()
    if messageFromServer == "Ping" then
        socket.send("Pong")
    end
until messageFromServer == nil

Changed

net.serve now returns a NetServeHandle which can be used to stop serving requests safely.

Example usage:

local handle = net.serve(8080, function()
    return "Hello, world!"
end)

print("Shutting down after 1 second...")
task.wait(1)
handle.stop()
print("Shut down succesfully")

The third and optional argument of process.spawn is now a global type ProcessSpawnOptions.
Setting cwd in the options for process.spawn to a path starting with a tilde (~) will now use a path relative to the platform-specific home / user directory.
NetRequest query parameters value has been changed to be a table of key-value pairs similar to process.env. If any query parameter is specified more than once in the request url, the value chosen will be the last one that was specified.
The internal http client for net.request now reuses headers and connections for more efficient requests.
Refactored the Lune rust crate to be much more user-friendly and documented all of the public functions.

Fixed

Fixed process.spawn blocking all lua threads if the spawned child process yields.

`0.3.0` - February 6th, 2023

Added

Added a new global stdio which replaces console
Added stdio.write which writes a string directly to stdout, without any newlines
Added stdio.ewrite which writes a string directly to stderr, without any newlines

Added stdio.prompt which will prompt the user for different kinds of input

Example usage:

local text = stdio.prompt()

local text2 = stdio.prompt("text", "Please write some text")

local didConfirm = stdio.prompt("confirm", "Please confirm this action")

local optionIndex = stdio.prompt("select", "Please select an option", { "one", "two", "three" })

local optionIndices = stdio.prompt(
    "multiselect",
    "Please select one or more options",
    { "one", "two", "three", "four", "five" }
)

Changed

Migrated console.setColor/resetColor and console.setStyle/resetStyle to stdio.color and stdio.style to allow for more flexibility in custom printing using ANSI color codes. Check the documentation for new usage and behavior.
Migrated the pretty-printing and formatting behavior of console.log/info/warn/error to the standard Luau printing functions.

Removed

Removed printing functions console.log/info/warn/error in favor of regular global functions for printing.

Fixed

Fixed scripts hanging indefinitely on error

`0.2.2` - February 5th, 2023

Added

Added global types for networking & child process APIs
- net.request gets NetFetchParams and NetFetchResponse for its argument and return value
- net.serve gets NetRequest and NetResponse for the handler function argument and return value
- process.spawn gets ProcessSpawnOptions for its third and optional parameter

Changed

Reorganize repository structure to take advantage of cargo workspaces, improves compile times

`0.2.1` - February 3rd, 2023

Added

Added support for string interpolation syntax (update to Luau 0.561)

Added network server functionality using net.serve

Example usage:

net.serve(8080, function(request)
    print(`Got a {request.method} request at {request.path}!`)

    local data = net.jsonDecode(request.body)

    -- For simple text responses with a 200 status
    return "OK"

    -- For anything else
    return {
        status = 203,
        headers = { ["Content-Type"] = "application/json" },
        body = net.jsonEncode({
            message = "echo",
            data = data,
        })
    }
end)

Changed

Improved type definitions file for Selene, now including constants like process.env + tags such as readonly and mustuse wherever applicable

Fixed

Fixed type definitions file for Selene not including all API members and parameters
Fixed process.exit exiting at the first yield instead of exiting instantly as it should

`0.2.0` - January 28th, 2023

Added

Added full documentation for all global APIs provided by Lune! This includes over 200 lines of pure documentation about behavior & error cases for all of the current 35 constants & functions. Check the README to find out how to enable documentation in your editor.
Added a third argument options for process.spawn:
- cwd - The current working directory for the process
- env - Extra environment variables to give to the process
- shell - Whether to run in a shell or not - set to true to run using the default shell, or a string to run using a specific shell
- stdio - How to treat output and error streams from the child process - set to "inherit" to pass output and error streams to the current process
Added process.cwd, the path to the current working directory in which the Lune script is running

`0.1.3` - January 25th, 2023

Added

Added a --list subcommand to list scripts found in the lune or .lune directory.

`0.1.2` - January 24th, 2023

Added

Added automatic publishing of the Lune library to crates.io

Fixed

Fixed scripts that terminate instantly sometimes hanging

`0.1.1` - January 24th, 2023

Fixed

Fixed errors containing ./ and / or ../ in the middle of file paths
Potential fix for spawned processes that yield erroring with "attempt to yield across metamethod/c-call boundary"

`0.1.0` - January 24th, 2023

Added

task now supports passing arguments in task.spawn / task.delay / task.defer
require now uses paths relative to the file instead of being relative to the current directory, which is consistent with almost all other languages but not original Lua / Luau - this is a breaking change but will allow for proper packaging of third-party modules and more in the future.
- NOTE: If you still want to use the default Lua behavior instead of relative paths, set the environment variable LUAU_PWD_REQUIRE to true

Changed

Improved error message when an invalid file path is passed to require
Much improved error formatting and stack traces

Fixed

Fixed downloading of type definitions making json files instead of the proper format
Process termination will now always make sure all lua state is cleaned up before exiting, in all cases

`0.0.6` - January 23rd, 2023

Added

Initial implementation of Roblox's task library, with some caveats:
- Minimum wait / delay time is currently set to 10ms, subject to change
- It is not yet possible to pass arguments to tasks created using task.spawn / task.delay / task.defer
- Timings for task.defer are flaky and deferred tasks are not (yet) guaranteed to run after spawned tasks
With all that said, everything else should be stable!
- Mixing and matching the coroutine library with task works in all cases
- process.exit() will stop all spawned / delayed / deferred threads and exit the process
- Lune is guaranteed to keep running until there are no longer any waiting threads
If any of the abovementioned things do not work as expected, it is a bug, please file an issue!

Fixed

Potential fix for spawned processes that yield erroring with "attempt to yield across metamethod/c-call boundary"

`0.0.5` - January 22nd, 2023

Added

Added full test suites for all Lune globals to ensure correct behavior
Added library version of Lune that can be used from other Rust projects

Changed

Large internal changes to allow for implementing the task library.
Improved general formatting of errors to make them more readable & glanceable
Improved output formatting of non-primitive types
Improved output formatting of empty tables

Fixed

Fixed double stack trace for certain kinds of errors

`0.0.4` - January 21st, 2023

Added

Added process.args for inspecting values given to Lune when running (read only)
Added process.env which is a plain table where you can get & set environment variables

Changed

Improved error formatting & added proper file name to stack traces

Removed

Removed ... for process arguments, use process.args instead
Removed individual functions for getting & setting environment variables, use process.env instead

`0.0.3` - January 20th, 2023

Added

Added networking functions under net

Example usage:

local apiResult = net.request({
	url = "https://jsonplaceholder.typicode.com/posts/1",
	method = "PATCH",
	headers = {
		["Content-Type"] = "application/json",
	},
	body = net.jsonEncode({
		title = "foo",
		body = "bar",
	}),
})

local apiResponse = net.jsonDecode(apiResult.body)
assert(apiResponse.title == "foo", "Invalid json response")
assert(apiResponse.body == "bar", "Invalid json response")

Added console logging & coloring functions under console

This piece of code:
```
local tab = { Integer = 1234, Hello = { "World" } }
console.log(tab)
```
Will print the following formatted text to the console, with syntax highlighting:
```
{
    Integer = 1234,
    Hello = {
        "World",
    }
}
```
Additional utility functions exist with the same behavior but that also print out a colored tag together with any data given to them: console.info, console.warn, console.error - These print out prefix tags [INFO], [WARN], [ERROR] in blue, orange, and red, respectively.

Changed

The json api is now part of net
- json.encode becomes net.jsonEncode
- json.decode become net.jsonDecode

Fixed

Fixed JSON decode not working properly

`0.0.2` - January 19th, 2023

Added

Added support for command-line parameters to scripts

These can be accessed as a vararg in the root of a script:
```
local firstArg: string, secondArg: string = ...
print(firstArg, secondArg)
```
Added CLI parameters for downloading type definitions:
- lune --download-selene-types to download Selene types to the current directory
- lune --download-luau-types to download Luau types to the current directory
These files will be downloaded as lune.yml and luneTypes.d.luau respectively and are also available in each release on GitHub.

`0.0.1` - January 18th, 2023

Initial Release

Files

CHANGELOG.md

Latest commit

History

CHANGELOG.md

File metadata and controls

Changelog

0.9.0

Breaking changes

Changed

0.8.9 - October 7th, 2024

Changed

0.8.8 - August 22nd, 2024

Fixed

0.8.7 - August 10th, 2024

Added

Changed

Fixed

0.8.6 - June 23rd, 2024

Added

Changed

Fixed

0.8.5 - June 1st, 2024

Changed

Fixed

0.8.4 - May 12th, 2024

Added

Changed

Fixed

0.8.3 - April 15th, 2024

Fixed

0.8.2 - March 12th, 2024

Fixed

0.8.1 - March 11th, 2024

Added

Changed

Fixed

0.8.0 - January 14th, 2024

Breaking Changes

Added

Changed

Fixed

0.7.11 - October 29th, 2023

Changed

Fixed

0.7.10 - October 25th, 2023

Added

Fixed

0.7.9 - October 21st, 2023

Added

Changed

0.7.8 - October 5th, 2023

Added

Changed

Fixed

0.7.7 - August 23rd, 2023

Added

Changed

Fixed

0.7.6 - August 9th, 2023

Changed

Fixed

0.7.5 - July 22nd, 2023

Added

Changed

Fixed

0.7.4 - July 7th, 2023

Added

Fixed

0.7.3 - July 5th, 2023

Changed

0.7.2 - June 28th, 2023

Added

Changed

0.7.1 - June 17th, 2023

Added

Fixed

0.7.0 - June 12th, 2023

Breaking Changes

Added

`0.9.0`

`0.8.9` - October 7th, 2024

`0.8.8` - August 22nd, 2024

`0.8.7` - August 10th, 2024

`0.8.6` - June 23rd, 2024

`0.8.5` - June 1st, 2024

`0.8.4` - May 12th, 2024

`0.8.3` - April 15th, 2024

`0.8.2` - March 12th, 2024

`0.8.1` - March 11th, 2024

`0.8.0` - January 14th, 2024

`0.7.11` - October 29th, 2023

`0.7.10` - October 25th, 2023

`0.7.9` - October 21st, 2023

`0.7.8` - October 5th, 2023

`0.7.7` - August 23rd, 2023

`0.7.6` - August 9th, 2023

`0.7.5` - July 22nd, 2023

`0.7.4` - July 7th, 2023

`0.7.3` - July 5th, 2023

`0.7.2` - June 28th, 2023

`0.7.1` - June 17th, 2023

`0.7.0` - June 12th, 2023

`0.6.7` - May 14th, 2023

`0.6.6` - April 30th, 2023

`0.6.5` - March 27th, 2023

`0.6.4` - March 26th, 2023

`0.6.3` - March 26th, 2023

`0.6.2` - March 25th, 2023

`0.6.1` - March 22nd, 2023

`0.6.0` - March 22nd, 2023

`0.5.6` - March 11th, 2023

`0.5.5` - March 8th, 2023

`0.5.4` - March 7th, 2023

`0.5.3` - February 26th, 2023

`0.5.2` - February 26th, 2023

`0.5.1` - February 25th, 2023

`0.5.0` - February 23rd, 2023

`0.4.0` - February 11th, 2023

`0.3.0` - February 6th, 2023

`0.2.2` - February 5th, 2023