ncase 0.1.1

Enforce a case style
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92

# 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 the chosen case style on a string and write it to the standard output.

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

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

By default, enforces the random case.

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

## Library

### Install

Add the dependency to your `Cargo.toml`.

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

Or from the command line.

```
% cargo add ncase@0.1
```

### Usage

Use the 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.

```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");
```