모듈: 찾고 설치하기

모듈: 찾고 설치하기 (using-modules_finding-installing)

Raku 모듈을 찾고 설치하는 방법을 다루는 문서예요.

필요에 맞는 모듈 찾기

명령행에서 모듈을 찾는 빠른 방법은 zef search를 쓰는 거예요.

zef search WWW

예를 들어 이름에 WWW가 포함된 모듈 목록을 돌려줘요.

모듈은 Raku 생태계(ecosystem)에 등록돼 있고 거기서 검색할 수 있어요. 빠른 검색이 정확히 한 건을 못 찾을 때 특히 유용해요.

모듈 설치하기

zef는 Raku에서 모듈을 설치하는 데 쓰는 프로그램이에요.

zef install WWW

아직 설치되지 않았다면 그 이름의 모듈을 설치해요[1]. 이미 설치돼 있다면 모듈 버전이 설치된 것보다 최신일 때만 재설치해요.

설치된 모듈 찾기

compunit가 모듈을 어디에 둘 것으로 기대하는지는 모듈 설치 프로그램이 아는 몫이에요. 배포판이 제공하는 위치와 현재 홈 디렉터리에 위치가 있을 거예요. 어쨌든 모듈 관리를 설치 프로그램에 맡기는 게 안전한 선택이에요.

cd your-module-dir
zef --force install .

일반 생태계에는 없지만 모듈·패키지 매니저가 관리하거나 정기적으로 필요해서 따로 모아둔 모듈 컬렉션을 가진 경우도 있죠. 그럴 때 use lib 프래그마 대신 RAKULIB 환경변수로 모듈 위치를 가리킬 수 있어요. 예를 들어:

export RAKULIB=/path/to/my-modules,/path/to/more/modules

디렉터리 구분자로 쉼표(',')를 쓰는 점을 주의하세요.

Raku가 모듈을 need·use·require할 때 RAKULIB 경로의 디렉터리들을 검색해요. 점(dot)으로 시작하는 디렉터리는 무시되고, 심볼릭 링크는 따라가요.

모듈 로드 시점의 성능 저하를 피하려면 이 경로에 추가하는 디렉터리가 너무 크지 않게 하는 게 좋아요. 자세한 내용은 여기를 참고하세요.

모듈 관련 문서

모듈을 배포하고 싶다면:

[1] 이미 설치돼 있다면 모듈 버전이 설치된 것보다 최신일 때만 재설치해요.