Crystal 언어의 종속성 관리자입니다.
Crystal 애플리케이션과 라이브러리의 루트에는 다음과 같은 shard.yml
파일이 있어야 합니다.
name : shards
version : 0.1.0
dependencies :
openssl :
github : datanoise/openssl.cr
branch : master
development_dependencies :
minitest :
git : https://github.com/ysbaddaden/minitest.cr.git
version : ~> 0.3.1
license : MIT
Git 리포지토리에서 라이브러리를 설치하는 경우 리포지토리에는 v
접두사가 붙은 semver와 유사한 형식을 따르는 버전 태그가 있어야 합니다. 예: v1.2.3
, v2.0.0-rc1
또는 v2017.04.1
.
shard.yml
형식에 대한 자세한 내용은 SPEC을 참조하세요.
샤드는 일반적으로 Crystal 자체(예: Homebrew 및 Debian 패키지)와 함께 배포됩니다. 또는 시스템에 shards
패키지를 사용할 수 있습니다.
동일한 페이지에서 소스 tarball을 다운로드하거나 저장소를 복제한 다음 make release=1
실행하고 bin/shards
PATH
에 복사할 수 있습니다. 예를 들면 /usr/local/bin
입니다.
이제 프로젝트에 대한 shard.yml
생성할 준비가 되었습니다(자세한 내용은 SPEC 참조). shards init
입력하여 프로젝트에 대한 예제 shard.yml
파일을 생성할 수 있습니다.
shards install
실행하여 종속성을 설치하면 종속성이 shard.lock
파일에 잠깁니다. 버전 관리에서 shard.yml
과 shard.lock
모두 확인해야 합니다. 그러면 추가 shards install
항상 잠긴 버전이 설치되어 컴퓨터 전체에서 재현 가능한 설치가 이루어집니다.
옵션과 함께 다른 명령을 나열하려면 shards --help
실행하십시오.
즐거운 해킹!
이러한 요구 사항은 샤드 컴파일에만 필요합니다.
결정
운영 체제에 대한 지침은 https://crystal-lang.org/install/을 참조하세요.
molinillo
몰리 molinillo
조각은 크리스탈 경로에 있어야 합니다. https://github.com/crystal-lang/crystal-molinillo에서 사용할 수 있습니다. 기존 shards
바이너리를 사용하여 설치하거나( shards install
실행) lib/crystal-molinillo
에서 저장소를 확인할 수 있습니다( make lib
).
libyaml
Debian/Ubuntu Linux에서는 libyaml-dev
패키지를 설치할 수 있습니다.
Mac OS X에서는 brew install libyaml
과 함께 homebrew를 사용하여 설치할 수 있습니다. 그런 다음 LIBRARY_PATH
환경 변수에 /usr/local/lib
있는지 확인하세요(예: export LIBRARY_PATH="/usr/local/lib:$LIBRARY_PATH"
). Homebrew 설치에 따라 경로를 조정하십시오.
asciidoctor
맨페이지를 작성하는 데 필요합니다.
샤드를 구축하고 개발하려면 make
사용하는 것이 좋습니다. Makefile
컴파일 및 테스트를 위한 레시피가 포함되어 있습니다. make
사용하여 빌드하면 소스 종속성 molinillo
설치되는 것도 보장됩니다. 이 문제를 직접 처리할 필요는 없습니다.
make bin/shards
실행하여 바이너리를 빌드합니다.
release=1
(최적화 적용)static=1
(musl-libc에서만 작동)debug=1
make install
실행하여 바이너리를 설치합니다. 대상 경로는 PREFIX
사용하여 조정할 수 있습니다(기본값: PREFIX=/usr/bin
).
테스트 스위트를 실행하려면 make test
실행하십시오.
make test_unit
단위 테스트를 실행합니다( ./spec/unit
).make test_integration
bin/shards
에서 통합 테스트( ./spec/integration
)를 실행합니다. 맨페이지를 빌드하려면 make docs
실행하세요.
이 저장소에는 빌드 및 테스트에 필요한 모든 도구를 사용하여 재현 가능한 환경을 쉽게 설정할 수 있게 해주는 devenv.sh에 대한 구성이 포함되어 있습니다.
devenv shell
실행하십시오. 자동 쉘 활성화를 위한 후크도 포함되어 있습니다. direnv
설치되어 있는 경우 repo 폴더에 들어가면 devenv 환경이 자동으로 로드됩니다.
Apache 라이센스 버전 2.0에 따라 라이센스가 부여되었습니다. 자세한 내용은 라이센스를 참조하세요.