# Usage
## CLI
```text
$ cargo list -h
!run:../target/release/cargo-list list -h
```
```text
$ cargo list -V
!run:../target/release/cargo-list list -V
```
### List installed external crates
```bash
cargo list
```
### List installed external crates containing `cargo`
```bash
cargo list cargo
```
### List installed external crates beginning with `cargo`
```bash
cargo list ^cargo
```
### List installed external crates ending with `list`
```bash
cargo list 'list$'
```
### List installed external crates matching `cargo-list`
```bash
cargo list '^cargo-list$'
```
### List outdated external crates
```bash
cargo list -o
```
### Update outdated external crates
```bash
cargo list -ou
```
### List the `cargo install` commands to update outdated external crates
```bash
cargo list -oun
```
### List outdated external crates (ignore version requirements)
```bash
cargo list -oI
```
### List outdated external crates (include crates compiled with old Rust)
```bash
cargo list -oR
```
### Update outdated external crates (ignore version requirements and include crate compiled with old Rust)
```bash
cargo list -oIRu
```
### List crates installed via git
```bash
cargo list -k git
```
### List installed local crates
```bash
cargo list -k local
```
### List installed local, git, and external crates
```bash
cargo list -k local -k git -k external
```
or shorter:
```bash
cargo list -a
```
### List outdated crates installed via git
```bash
cargo list -k git -o
```
### List outdated installed local crates
```bash
cargo list -k local -o
```
### List outdated installed local, git, and external crates
```bash
cargo list -k local -k git -k external -o
```
or shorter:
```bash
cargo list -ao
```
### Dump installed external crates to JSON
```bash
cargo list -f json
```
### Dump installed external crates to pretty JSON
```bash
cargo list -f json-pretty
```
### Dump installed external crates to Rust
```bash
cargo list -f rust
```
### Dump installed external crates to pretty Rust
```bash
cargo list -f rust-pretty
```
### Dump outdated installed external crates to JSON
```bash
cargo list -f json -o
```
### Dump outdated installed external crates to pretty JSON
```bash
cargo list -f json-pretty -o
```
### Dump outdated installed external crates to Rust
```bash
cargo list -f rust -o
```
### Dump outdated installed external crates to pretty Rust
```bash
cargo list -f rust-pretty -o
```
## Library
!run:sed 's/^# //' LIBRARY.md
# Changelog
Please read the [`CHANGELOG.md`] in the [repository].
[`CHANGELOG.md`]: https://github.com/qtfkwk/cargo-list/blob/main/CHANGELOG.md
[repository]: https://github.com/qtfkwk/cargo-list