{"id":15289278,"url":"https://github.com/un-def/luamb","last_synced_at":"2025-04-13T09:22:04.838Z","repository":{"id":62577082,"uuid":"63639786","full_name":"un-def/luamb","owner":"un-def","description":"Lua environment manager","archived":false,"fork":false,"pushed_at":"2024-05-04T12:35:30.000Z","size":68,"stargazers_count":17,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-14T09:11:27.137Z","etag":null,"topics":["environment-manager","hererocks","lua","version-manager","virtualenvwrapper"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/un-def.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2016-07-18T21:54:44.000Z","updated_at":"2024-10-25T18:18:48.000Z","dependencies_parsed_at":"2024-04-15T11:37:01.198Z","dependency_job_id":null,"html_url":"https://github.com/un-def/luamb","commit_stats":{"total_commits":58,"total_committers":1,"mean_commits":58.0,"dds":0.0,"last_synced_commit":"eec3969eda1b225e26a138c25720182754e9ec54"},"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/un-def%2Fluamb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/un-def%2Fluamb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/un-def%2Fluamb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/un-def%2Fluamb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/un-def","download_url":"https://codeload.github.com/un-def/luamb/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248689382,"owners_count":21145923,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["environment-manager","hererocks","lua","version-manager","virtualenvwrapper"],"created_at":"2024-09-30T16:00:11.967Z","updated_at":"2025-04-13T09:22:04.813Z","avatar_url":"https://github.com/un-def.png","language":"Python","readme":"# (🌑) luamb\n\nLua environment manager built on top of [hererocks](https://github.com/luarocks/hererocks) and inspired by [virtualenvwrapper](https://bitbucket.org/virtualenvwrapper/virtualenvwrapper).\n\n\n## Supported shells\n\n  * Bash\n  * Zsh\n\n\n## Installation\n\n  1. Install luamb using `pip`:\n\n      ```sh\n      pip install [--user] luamb\n      ```\n\n      or `pipx`:\n\n      ```sh\n      pipx install luamb\n      ```\n\n  2. Set up your shell — add the following to `~/.bashrc` or `~/.zshrc`:\n\n      ```sh\n      source \u003c(luamb shellsrc)\n      ```\n\n  3. Install hererocks:\n\n      ```sh\n      luamb update\n      ```\n\n\n## Configuration\n\nluamb is configured via environment variables.\n\n  * `LUAMB_HOME`\n\n    A directory where luamb stores its data (hererocks, environments, etc.). The default value is `$XDG_DATA_HOME/luamb` (usually `~/.local/share/luamb`) on Linux and `~/Library/Application Support/luamb` on macOS.\n\n  * `LUAMB_ENVS_DIR`\n\n    A directory where luamb stores environments. The default value is `$LUAMB_HOME/envs`.\n\n  * `LUAMB_LUA_DEFAULT`\n\n    A default Lua interpreter/version. The format is `interpreter version_specifier`, e.g., `lua 5.3`, `luajit @v2.1`, `moonjit /path/to`, `raptorjit latest`.\n\n  * `LUAMB_LUAROCKS_DEFAULT`\n\n    A default LuaRocks version, e.g, `latest`, `3.11.0`.\n\n  * `LUAMB_DISABLE_COMPLETION`\n\n    Set to `true` to disable shell completions.\n\n  * `LUAMB_PYTHON_BIN`\n\n    If the luamb executable is not in `PATH`, set `LUAMB_PYTHON_BIN` to the Python executable with the `luamb` package installed and change the shell initialization command:\n\n    ```sh\n    export LUAMB_PYTHON_BIN=/path/to/bin/python\n    source \u003c(\"$LUAMB_PYTHON_BIN\" -m luamb shellsrc)\n    ```\n\n\n## Examples\n\n  * Create an environment 'myproject' with the latest Lua 5.2, the latest LuaRocks and associate it with /home/user/projects/myproject:\n\n    ```sh\n    luamb mk myproject -l 5.2 -r latest -a /home/user/projects/myproject\n    ```\n\n  * Create an environment 'jittest' with LuaJIT 2.0.4, without LuaRocks and associate it with /home/user/projects/jitproj:\n\n    ```sh\n    luamb mk jittest -j 2.0.4 -a /home/user/projects/jitproj\n    ```\n\n  * Set the latest LuaJIT 2.0 and the latest LuaRocks as default versions:\n\n    ```sh\n    export LUAMB_LUA_DEFAULT='luajit 2.0'\n    export LUAMB_LUAROCKS_DEFAULT=latest\n    ```\n\n  * Create an environment 'newenv' with the default versions and without associated project directory:\n\n    ```sh\n    luamb mk newenv\n    ```\n\n  * Create an environment 'norocks' with the default Lua version and without LuaRocks (verbose mode):\n\n    ```sh\n    luamb mk norocks --no-luarocks --verbose\n    ```\n\n  * Activate the 'newenv' environment:\n\n    ```sh\n    luamb on newenv\n    ```\n\n  * Deactivate the current environment:\n\n    ```sh\n    luamb off\n    ```\n\n  * Delete the 'myproject' environment (it will remove the environment directory only, not the project one):\n\n    ```sh\n    luamb rm myproject\n    ```\n\n\n## Commands\n\n  * `on` | `enable` | `activate` — activate an environment\n  * `off` | `disable` | `deactivate` — deactivate the current environment\n  * `mk` | `new` | `create` — create a new environment\n  * `rm` | `remove` | `del` | `delete` — remove an environment\n  * `info` | `show` — Show the details for a single virtualenv\n  * `ls` | `list` — list all of the environments\n  * `update` — install/update the `hererocks` script\n  * `shellsrc` — print the shell initialization code\n\n\n## Version history\n\nSee [CHANGELOG.md](https://github.com/un-def/luamb/blob/master/CHANGELOG.md).\n\n\n## License\n\nThe [MIT License](https://github.com/un-def/luamb/blob/master/LICENSE).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fun-def%2Fluamb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fun-def%2Fluamb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fun-def%2Fluamb/lists"}