# ncase [ɪn'keɪs] — enforce a case style

## Why?

So that I could

```
% for f in *.pdf; do
	mv "$f" "$(ncase -s `basename "$f" .pdf`).pdf"
done
```

## Binary

### Install

```
% cargo install ncase
```

### Usage

Enforce a case style on a string and write that to the standard output

```
% ncase --pascal this is a test string
ThisIsATestString
```

```
% ncase --lower ThisIsATestString
this is a test string
```

If built with the `rand` feature, enforce `rANdOm cASe` by default

```
% ncase this is a test string
ThiS IS A tesT stRINg
```

Otherwise, enforce `tOGGLE cASE` by default

```
% ncase this is a test string
tHIS iS a tEST sTRING
```

## Library

### Install

Add the dependency to your `Cargo.toml`

```toml
[dependencies]
ncase = "0.2"
```

Or from the command line

```
% cargo add ncase@0.2
```

### Usage

Use the free functions for one-off case conversions

```rust
assert_eq!(ncase::camel("camel case"), "camelCase");
assert_eq!(ncase::snake("snake case"), "snake_case");
```

Use `Words` if you need to convert one string into many case styles

```rust
use ncase::Words;

let s = "Lorem ipsum dolor sit amet";
let w = Words::from(s);

assert_eq!(w.kebab(), "lorem-ipsum-dolor-sit-amet");
assert_eq!(w.title(), "Lorem Ipsum Dolor Sit Amet");
```

Or if you want to use the separator regex (requires the `regex` feature)

```rust
use ncase::Words;
use regex::Regex;

let s = "Lorem, ipsum (dolor _sit)_ amet";
let sep = Regex::new(r"[\pP\s]+").unwrap();
let w = Words::with_separator(s, &sep);

assert_eq!(w.lower(), "lorem ipsum dolor sit amet");
assert_eq!(w.upper(), "LOREM IPSUM DOLOR SIT AMET");
```