LuaRocks is a package manager for Lua. This project is a web-browser based GUI of LuaRocks that allows users to search for rocks, list installed rocks, install and remove them, view rock details, etc. It uses the LuaRocks API for interfacing with the LuaRocks back-end.
- Install the
luarocks-apibranch. Follow these instructions. - Install
luarock-guiby following these instructions.
NOTE: This project uses the luarocks-api branch of LuaRocks. So, you need to install that branch in order to run luarocks-gui.
Keep in mind that this branch is still under development, so if you come across any API issues then please report them here.
This is temporary until the the API gets merged into the main branch of LuaRocks.
After a successful installation, run:
luarocks gui
This will automatically open up a browser window (of your default browser) and run there.
Note: By default luarocks-gui runs on port 8080.
The web-GUI has 5 main pages:
This page shows the list of rock-trees configured in your current setup.
This page shows the list of rocks installed in all of the rock-trees in your system.
You can filter the results based on a particular rock-tree, or some keyworks/queries.
Each rock has 3 buttons along with it:
- Details: shows further details for a rock.
- Documentation: Opens the directory containing documentation of the rock.
- Remove: Removes the rock from LuaRocks.
This page lets you search for any rock on the internet.
Shows the the list of rocks based on your query.
Each rock has 2 buttons along with it:
- View on luarocks.org: Redirects to luarocks.org and with the same query you entered.
- Install: Installs the rock. (Uses the rock-version and rock-tree you select in the drop-down menus)
This page lets you manage your rockspec with ease.
You can:
- lint a rockspec
- write a new version for an existing rockspec
- write a new rockspec
This page shows you the informantion about luarocks-gui.
This rock depends on:
This project also uses:
This project has been made under Google summer of code 2018 for LuaRocks.
Feedback, pull requests, criticism, contributions, etc. are welcome!