[Lua] LuaRocks (Lua Package Manager) 설치하기 (Windows)

LuaRocks는 루아의 패키지 매니저 입니다.

패키지 매니저는 외부 모듈(라이브러리) 등을 생성, 관리하는 역할을 수행합니다.

해당 도구를 이용함으로써 루아에서 외부 모듈을 더 편하게 사용할 수 있게 됩니다.

 

이번 글에서는 LuaRocks의 기본 설정 및 간단한 사용법을 살펴보도록 하겠습니다.

이번 글은 다음 문서들을 참조하고 있습니다.

LuaRocks
Installation instruction for Windows

 

---

 

1. 다운로드 및 파일 배치

 

다음 배포 페이지로 이동합니다.

LuaRocks releases

배포 페이지에서 적절한 OS와 버전을 선택하여 다운로드 후, 압축을 해제합니다.

이번 글에서는 3.11.1버전을 이용합니다.

 

압축을 풀어 나오는 파일은 루아 바이너리와 동일 폴더에 배치해주세요.

이와 같은 형태가 됩니다.

 

2. 설정

 

다운로드 한ㅣㅕㅁ개찬 LuaRocks를 루아 바이너리와 동일한 위치에 배치한 것으로, 바로 사용할 수 있게 되었습니다.

콘솔에서 luarocks를 타이핑 하면 다음과 같은 메시지를 볼 수 있습니다.

이는 luarocks가 lua를 찾지 못했다는 메시지 입니다.

3.11.1버전의 luarocks는 기본적으로 5.4버전의 루아를 참조하고 있습니다.

 

다음 명령어를 통해 이를 수정해주세요

luarocks config lua_version 5.2

이번 글에서 사용하고 있는 루아 버전이 5.2이기때문에 5.2를 기입했습니다.

사용하시는 루아의 버전이 다를 경우, 다르게 입력해주세요 (ex. 5.3.2버전을 사용중인 경우 5.3을 기입)

 

사용중인 버전으로 설정을 변경하고, 해당 버전의 루아 바이너리가 환경변수에 설정되어 있을 경우 다음과 같이 luarocks가 lua를 찾아낸 모습을 볼 수 있습니다.

 

3. 환경 변수 등록하기

 

luarocks는 사용중인 패키지를 luarocks만의 위치에서 관리합니다.

이 경로는 luarocks를 콘솔에 타이핑하여 설정 값에서 확인할 수 있습니다.

해당 경로에서 설치된 모듈들이 관리됩니다.

 

따라서, 루아에서 해당 모듈들을 찾을 수 있도록 환경 변수를 설정해주는 작업이 필요합니다.

추가해야하는 경로는 luarocks에서 제공합니다.

luarocks path

위 명령어를 통해 추가, 편집해야 하는 환경 변수를 확인할 수 있습니다.

환경 변수에 LUA_PATH와 LUA_CPATH를 생성하고, 주어진 문자열로 값을 지정합니다.

 

Win + R키를 통해 환경 변수 편집창으로 진입합니다.

환경 변수에 LUA_PAHT, LUA_CPATH를 이름으로, 콘솔에 있는 문자열을 값으로 환경 변수를 지정해주세요.

 

4. 모듈 관리하기 (검색)

 

LuaRocks를 통해 관리할 수 있는 모듈들은 LuaRocks 홈페이지에서 확인할 수 있습니다.

LuaRocks

보여지는 모듈들 외에도 검색 기능 등을 제공합니다.

 

설치를 원하거나, 상세 설명을 보고싶은 모듈을 클릭하면 아래와 같은 페이지로 이동합니다.

위 이미지는 LuaSQL-MySQL 페이지로 이동한 모습입니다.

luarocks를 통해 모듈을 설치하는 명령어를 제공하고 있습니다.

 

위 방법 외에, luarocks에서도 등록된 모듈을 검색하는 명령어를 제공합니다.

luarocks search {module name}

위 명령어는 지정한 module_name을 포함하는 모듈들을 검색하여 출력합니다.

결과값으로 모듈들의 이름과 버전을 제공합니다. 

 

5. 모듈 관리하기 (설치 및 목록)

 

모듈 설치는 다음과 같은 명령어를 사용합니다.

luarocks install {module name}

명령어를 정상적으로 입력할 경우, luarocks가 모듈을 설치하며 로그 기록을 출력합니다.

위 문단에서 검색한 LuaSQL을 설치 시도한 모습입니다.

설치하려는 PC에 MySQL이 설치되어있지 않아 설치가 실패한 것을 볼 수 있습니다.

 

설치된 모듈들은 다음 명령어로 확인할 수 있습니다.

luarocks list

명령어의 결과로 현재 루아의 버전, 설치된 모듈들의 이름, 버전, 경로를 출력합니다.

해당 결과는 json4lua, luasocket모듈들을 설치한 결과입니다. 

 

6. 모듈 관리하기 (삭제)

 

모듈의 삭제는 다음 명령어를 사용합니다.

luarocks remove {module name}

 

해당 명령어로 모듈을 삭제하면 다음과 같은 메시지가 출력됩니다.

모듈이 삭제되어, list를 통해 확인했을 때 출력되지 않음을 볼 수 있습니다. 

 

---

 

루아의 패키지 매니저 LuaRocks를 설치하고, 이를 이용해 모듈을 설치하는 과정을 살펴보았습니다.

설치한 모듈들은 모듈에 따라 사용법이 다르기 때문에, 모듈의 문서에서 확인해주세요.

 

이번 글이 도움이 되셨기를 바랍니다.

감사합니다.