glue

Glue

Glue is a powerful system setup tool combining using Lua as a configuration language . It provides an intuitive, imperative approach to machine setup and configuration management.

Warning: Glue is still is in prototype phase. Features and APIs may evolve

Overview

Glue seamlessly combines Go + Lua (hence the name) to offer:

• Lua-based configuration language
• Simple, imperative API (inspired by Ansible)
• Extensible module system
• "Blueprint" generation and execution
• Filtering of configuration blocks

Note: Glue is still in prototype phase. Features and APIs may evolve. Please report issues via GitHub.

Quick Start

Glue typically works globally on your system by referencing the glue.lua file in your XDG_CONFIG_HOME folder. Typically that would be ~/.config/glue/glue.lua.

Here's an example of a configuration that sets up some configurations and installs Homebrew packages:

group("configs", function ()
    Copy({
        source = "./configs/alacritty" .. name,
        dest = "~/.config/alacritty",
        strategy = "merge"
    })

    Blockinfile({
        state = true,
        block = read("./configs/zshrc.sh"),
        path = "~/.zshrc"
    })
end)

group("homebrew", function ()
    HomebrewInstall()

    Homebrew({
        taps =  {
            "oven-sh/bun",
            "homebrew/cask-fonts",
        },
        casks = {
            "zen-browser",
            "steam",
            "emacs",
            "love",
        },
        packages = {
            "ffmpeg",
            "watch",
            "httpie",
            "ruby",
            "lua",
        }
    })
end)

CLI Reference

glue [flags] [command]

Commands

Flags

Extending Glue

Glue can be extended through its module system. Create new modules in the modules package using the registry system.

Here's an example of a simple module that prints a message:

Registry.RegisterModule(func(glue *core.Glue) error {
	glue.Plug("print", core.FUNCTION).
		Brief("Print a string").
		Arg("obj", ANY, "the message or object to log").
		Do(func(R Runtime, args *Arguments) (RTValue, error) {
			glue.Log.Info(args.Get(0).String())
			return nil, nil
		})

	return nil
})

Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Submit a pull request

License

GNU General Public License v3.0