tsukina-7mochi/neblua

A tiny zero-dependency bundler for Lua

NebLua

NebLua is a tiny zero-dependency bundler for Lua. Lua 5.3 supported but it may work for Lua 5.4.

Features

• Bundle require, loadfile and dofile functions
• Text import by requireText

Installation

Download single source file from Releases

Usage

Program (recommended)

This is a part of configuration of NebLua's self-build. See /example, ./bundleSelf.lua and /test/bundle/bundle.test.lua

local bundle = require("src.neblua").bundle

bundle {
    entry = "src.neblua",
    output = "./dist/neblua.lua",
    files = {
        "./src/neblua.lua",
        "./src/path.lua",
        "./src/string.lua",
        { path = "./src/templates/template.lua", type = "text" }
    },
    verbose = true,
}

Bundle Options

key	value
rootDir	root directory of source files
entry	entry module name
output	output file name
files	source files
verbose	enable verbose mode

CLI

$ lua neblua-cli [options] [files]

options	value	function
-e, --entry	module name	set entry point
-o, --output	file name	set output file name
--verbose	none	enable verbose mode
-v, --version	none	print version

Plans

• support require
• support loadfile
• support dofile
• error output override
• string require
• automatically add required files
• minify
• tree shaking

neblua's Issues

Automatic module resolution

Feature

Automatically detect files to be bundled (currently given via interface)

Method

• Parse and scan AST to look up require, dofile and load
• Use annotation like --[[ @neblua-import foo.lua ]]