Metadata-Version: 1.1
Name: luamb
Version: 0.1.1
Summary: Lua environment manager
Home-page: https://github.com/un-def/luamb
Author: un.def
Author-email: un.def@ya.ru
License: MIT
Description: (🌑) luamb
        =========
        
        Lua environment manager built on top of
        `hererocks <https://github.com/mpeterv/hererocks>`__ and inspired by
        `virtualenvwrapper <https://bitbucket.org/virtualenvwrapper/virtualenvwrapper>`__.
        
        Installation
        ~~~~~~~~~~~~
        
        1. Install ``luamb`` (``hererocks`` will be installed automatically):
        
           ::
        
               $ pip install luamb
        
        2. Create directory for environments:
        
           ::
        
               $ mkdir $HOME/.luambenvs
        
        3. Configure your shell (add these lines to ``~/.bashrc``):
        
           .. code:: shell
        
               # path to directory with environments
               export LUAMB_DIR=$HOME/.luambenvs
        
           .. code:: shell
        
               # optional variables:
               export LUAMB_LUA_DEFAULT=lua5.3        # default Lua version
               export LUAMB_LUAROCKS_DEFAULT=latest   # default LuaRocks version
               LUAMB_COMPLETION=true                  # enable Bash completion
               LUAMB_PYTHON_BIN=/usr/bin/python3      # explicitly set Python executable
        
           .. code:: shell
        
               # make some magic
               source /usr/local/bin/luamb.sh         # default path in Debian if luamb has been installed globally
        
        4. Try to execute in new shell:
        
           ::
        
               $ luamb --help
        
        Examples
        ~~~~~~~~
        
        -  Create environment 'myproject' with latest Lua 5.2 (5.2.4), latest
           LuaRocks and associate it with /home/user/projects/myproject:
        
           ::
        
               $ luamb mk myproject -l 5.2 -r latest -a /home/user/projects/myproject
        
        -  Create environment 'jittest' with LuaJIT 2.0.4, without LuaRocks and
           associate it with /home/user/projects/jitproj:
        
           ::
        
               $ luamb mk jittest -j 2.0.4 -a /home/user/projects/jitproj
        
        -  Set LuaJIT 2.0 (2.0.4) and latest LuaRocks version by default:
        
           ::
        
               $ export LUAMB_LUA_DEFAULT=luajit2.0
               $ export LUAMB_LUAROCKS_DEFAULT=latest
        
        -  Create environment 'newenv' with default versions and without
           associated project directory:
        
           ::
        
               $ luamb mk newenv
        
        -  Create environment 'norocks' with default Lua version (LuaJIT 2.0.4)
           and without LuaRocks (verbose mode):
        
           ::
        
               $ luamb mk norocks --no-luarocks --verbose
        
        -  Activate 'newenv' environment:
        
           ::
        
               $ luamb on newenv
        
        -  Deactivate current environment:
        
           ::
        
               $ luamb off
        
        -  Delete 'myproject' environment (it will remove env dir only, not
           project dir):
        
           ::
        
               $ luamb rm myproject
        
        Commands
        ~~~~~~~~
        
        Each command has one or more alias.
        
        ``on`` \| ``enable`` — activate existing environment
        
        ``off`` \| ``disable`` — deactivate current environment
        
        ``mk`` \| ``new`` \| ``create`` — create new environment
        
        ``rm`` \| ``remove`` \| ``del`` — delete existing environment
        
        ``ls`` \| ``list`` — list all environments
        
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
