Dependency manager for the Crystal language.
Crystal applications and libraries are expected to have a
shard.yml file at their root looking like this:
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
When libraries are installed from Git repositories, the repository is expected to have version tags following a semver-like format, prefixed with a
Please see the SPEC for more details about the
Shards is usually distributed with Crystal itself (e.g. Homebrew and Debian packages). Alternatively, a
shards package may be available for your system.
You can download a source tarball from the same page (or clone the repository) then run
make release=1and copy
bin/shards into your
PATH. For example
You are now ready to create a
shard.yml for your projects (see details in SPEC). You can type
shards init to have an example
shard.yml file created for your project.
shards install to install your dependencies, which will lock your dependencies into a
shard.lock file. You should check both
shard.lock into version control, so further
shards install will always install locked versions, achieving reproducible installations across computers.
shards --help to list other commands with their options.
These requirements are only for compiling Shards.
Please refer to https://crystal-lang.org/install/ for instructions for your operating system.
On Debian/Ubuntu Linux you may install the
On Mac OS X you may install it using homebrew with
brew install libyamlthen make sure to have
LIBRARY_PATHenvironment variable (eg:
export LIBRARY_PATH="/usr/local/lib:$LIBRARY_PATH"). Please adjust the path per your Homebrew installation.
Needed for building manpages.
Licensed under the Apache License, Version 2.0. See LICENSE for details.
- 12 days ago
- May 20, 2015
Mon, 21 Jun 2021 15:34:45 GMT