base on A luxurious package manager for Lua <h1 align="center"> <br> <a href="https://nvim-neorocks.github.io/tutorial/getting-started"><img src="./lux-logo.svg" alt="Lux" width="200"></a> <br> <br> <span>Lux</span> </h1> <h4 align="center">A luxurious package manager for <a href="https://www.lua.org/" target="_blank">Lua</a>.</h4> <p align="center"> <img alt="GitHub Actions Workflow Status" src="https://img.shields.io/github/actions/workflow/status/nvim-neorocks/lux/integration-tests.yml?style=for-the-badge"> <img alt="GitHub Top Language" src="https://img.shields.io/github/languages/top/nvim-neorocks/lux?style=for-the-badge"> <img alt="GitHub License" src="https://img.shields.io/github/license/nvim-neorocks/lux?style=for-the-badge"> </p> <p align="center"> <a href="#star2-key-features">Key Features</a> • <a href="#gear-how-to-use">How To Use</a> • <a href="#bar_chart-comparison-with-luarocks">Comparison with Luarocks</a> • <a href="#bulb-you-may-also-like">Related Projects</a> • <a href="#green_heart-contributing">Contributing</a> </p> ## :star2: Key Features * Create and manage Lua projects - Easily manage dependencies, build steps and more through the `lux.toml` file. * Parallel builds and installs :rocket: * Add/remove dependencies with simple CLI commands * Automatic generation of rockspecs - Say goodbye to managing 10 different rockspec files in your source code :tada: * Integrated code formatting via `lx fmt` - Powered by [stylua](https://github.com/JohnnyMorganz/StyLua). * Easily specify compatible Lua versions - Lux will take care of Lua header installation automatically - Forget about users complaining they have the wrong Lua headers installed on their system * Automatic code linting via `lx check` - Powered by `luacheck`. * Powerful lockfile support - Makes for fully reproducible developer environments. - Makes Lux easy to integrate with Nix! * Fully compatible - Works with existing luarocks packages. - Have a complex rockspec that you don't want to rewrite to TOML? No problem! Lux allows the creation of an `extra.rockspec` file, everything just works. - Have a very complex build script? Lux can shell out to `luarocks` if it knows it has to preserve maximum compatibility. > [!WARNING] > > **Lux, while generally functional, is a work in progress > and does not have a `1.0` release yet.** ## :gear: How To Use Feel free to consult the [documentation](https://nvim-neorocks.github.io/tutorial/getting-started) on how to get started with Lux! It features a tutorial and several guides to make you good at managing Lua projects. ## :bar_chart: Comparison with `luarocks` As this project is still a work in progress, some luarocks features have not been (fully) implemented yet. On the other hand, lux has some features that are not present in luarocks. The following table provides a brief comparison: | | lux | luarocks v3.11.1 | | --- | --- | --- | | project format | TOML / Lua | Lua | | add/remove dependencies | :white_check_mark: | :x: | | parallel builds/installs | :white_check_mark: | :x: | | proper lockfile support with integrity checks | :white_check_mark: | :x: (basic, dependency versions only) | | run tests with busted | :white_check_mark: | :white_check_mark: | | linting with luacheck | :white_check_mark: | :x: | | code formatting with stylua | :white_check_mark: | :x: | | automatic lua detection/installation | :white_check_mark: | :x: | | default build specs | :white_check_mark: | :white_check_mark: | | custom build backends | :white_check_mark:[^1] | :white_check_mark: | | `rust-mlua` build spec | :white_check_mark: (builtin) | :white_check_mark: (external build backend) | | `treesitter-parser` build spec | :white_check_mark: (builtin) | :white_check_mark: (external build backend) | | install pre-built binary rocks | :white_check_mark: | :white_check_mark: | | install multiple packages with a single command | :white_check_mark: | :x: | | install packages using version constraints | :white_check_mark: | :x: | | auto-detect external dependencies and Lua headers with `pkg-config` | :white_check_mark: | :x: | | resolve multiple versions of the same dependency at runtime | :white_check_mark: | :white_check_mark: | | pack and upload pre-built binary rocks | :white_check_mark: | :white_check_mark: | | luarocks.org manifest namespaces | :white_check_mark: | :white_check_mark: | | luarocks.org dev packages | :white_check_mark: | :white_check_mark: | | versioning | SemVer[^3] | arbitrary | | rockspecs with CVS/Mercurial/SVN/SSCM sources | :x: (YAGNI[^2]) | :white_check_mark: | | static type checking | :x: (planned) | :x: | [^1]: Supported via a compatibility layer that uses luarocks as a backend. [^2]: [You Aren't Gonna Need It.](https://martinfowler.com/bliki/Yagni.html) [^3]: Mostly compatible with the luarocks version parser, which allows an arbitrary number of version components. To comply with SemVer, we treat anything after the third version component (except for the specrev) as a prerelease/build version. ## :wrench: Building from source Dependencies: - `openssl` - `libgit2` - `gnupg`, `libgpg-error` and `gpgme` (*nix only) - `lua` (optional, if building without the `vendored-lua` feature) We recommend building with the `vendored-lua` feature enabled: ```bash cargo build --features vendored-lua ``` ## :bulb: You may also like... - [luarocks](https://github.com/luarocks/luarocks) - The original Lua package manager - [rocks.nvim](https://github.com/nvim-neorocks/rocks.nvim) - A Neovim plugin manager that uses `luarocks` under the hood, and will soon be undergoing a rewrite to use Lux instead. ## :purple_heart: Credits Credits go to the Luarocks team for maintaining [luarocks](https://github.com/luarocks/luarocks) and [luarocks.org](https://luarocks.org) for as long as they have. Without their prior work Lux would not be possible. ## :green_heart: Contributing Contributions are more than welcome! See [CONTRIBUTING.md](./CONTRIBUTING.md) for a guide. ## :book: License - Lux is licensed under [MIT](./LICENSE). - The Lux logo © 2025 by Kai Jakobi is licensed under [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/). ", Assign "at most 3 tags" to the expected json: {"id":"13407","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"