cargo-x
=======

[![Build Status](https://api.travis-ci.org/liuchong/cargo-x.svg?branch=master)](https://travis-ci.org/liuchong/cargo-x)
[![APACHE licensed](https://img.shields.io/badge/license-apache%202.0-blue.svg)](./LICENSE-APACHE)
[![MIT licensed](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE-MIT)
[![crates.io](https://meritbadge.herokuapp.com/cargo-x)](https://crates.io/crates/cargo-x)
[![Released API docs](https://docs.rs/cargo-x/badge.svg)](https://docs.rs/cargo-x)

A very simple third-party cargo subcommand to execute a custom command

## Usage

1. install cargo-x

```
cargo install cargo-x
```

or upgrade

```
cargo install -f cargo-x
```

2. write a config file `x.toml` in `"name = detail"` format like

```
ls = "ls -ltr"
```

or same lines in file `~/.x.toml`,

or in `[package.metadata.x]` section in `Cargo.toml` file.

***note*** that `DO NOT` use key x like `x = "any command"`, `cargo-x x` will run into problem,
because it does not know if it is using `cargo-x x` or `cargo x`.

3. use cargo-x

```
cargo x ls
# or
cargo-x ls
# or
x ls
```

## License

Licensed under either of these:

 * Apache License Version 2.0 [LICENSE-APACHE](LICENSE-APACHE)
 * MIT License [LICENSE-MIT](LICENSE-MIT)

### Contributing

Please sign a cla, thanks!