cargo-cite
is not registered so you will need the following steps:
git clone git@github.com:matbesancon/cargo-cite.git
cd cargo-cite
cargo install --path .
The command cargo cite
will then be available.
Citing software is important to acknowledge the work of others, but also because academic software development depends on it.
One pain point developers have is to find how to cite a given library.
One has to look in the README, documentation or some other file.
A recent experiment in the Julia community is to standardize
citations in one file at the top-level of projects, named CITATION.bib
with all the relevant BibTeX entries for the project.
Multiple entries can be added for different sub-topics related to the
software, as you can see in the Julia repo.
cargo-cite
is an experimental Rust crate to generate a
CITATION.bib
file for a Rust project based on its Cargo.toml file.
It can be yours or someone else's. Once the CITATION.bib
file is created,
feel free to add other entries to it - for example, a software paper
published in the Journal of Open-Source Software.
Say you are using ndarray for your work, but they have not published a CITATION.bib yet:
$ git clone https://github.com/rust-ndarray/ndarray.git
$ cd ndarray
$ cargo cite
A CITATION.bib
file has been created. To add the reference to this file
in the README, run:
$ cargo cite -r
See cargo cite --help
for options.