# crin

(**cr**ate **in**formation)

A handy CLI for the [crates.io](https://crates.io) API

<img src="https://github.com/joseluis/crin/blob/master/res/screenshot.png?raw=true" width="860"  height="630"/>

## Features

- Colorful, condensed & parseable output
- Show crate information
- Search for crates
- Show crates summary
- User configuration file (in TOML)
  - Manage custom lists of crates

### Planned features

- improved search
  - filter by keyword & category
  - sort alphabetically or by downloads
  - choose the page and results per page
- show dependencies
- show version list
  - download any version
- customize colors

## Usage examples

### Show Crate Information
```sh
$ crin show regex-syntax

# If you want to show the number of reverse dependencies  use `-r` or `--reverse`:
$ crin show -r regex-syntax

# If you want the full list of reverse dependencies use `-rr` or `--reverse --reverse`:
$ crin show  -rr regex-syntax
```

### Search
```sh
$ crin search network
```


### Summary

```sh
$ crin summary

# More details on new crates
$ crin summary new
```

### Lists

```sh
$ crin list                      # show your existing lists
$ crin list new devlist          # create a new list named 'devlist'
$ crin list add devlist reqwest  # add the crate to your list
$ crin list add devlist clap     # add another crate
$ crin list show devlist -i      # show information about each crate
$ crin list rem devlist clap     # remove the crate from your list

$ crin list help                 # for more...
```


### Help
```
$ crin help
$ crin help crate
$ crin help summary new
$ crin help list
```

## Installation

```sh
$ cargo install crin
```