# Rust Inflector
This project is forked from https://github.com/whatisinternet/Inflector. The original author doesn't maintain this anymore.
[![Build Status](https://travis-ci.org/chrislearn/cruet.svg?branch=master)](https://travis-ci.org/chrislearn/cruet) [![Crates.io](https://img.shields.io/crates/v/Inflector.svg)](https://crates.io/crates/cruet)[![Crate downloads](https://img.shields.io/crates/d/cruet.svg)](https://crates.io/crates/cruet)
Adds String based inflections for Rust. Snake, kebab, train, camel,
sentence, class, and title cases as well as ordinalize,
deordinalize, demodulize, deconstantize, foreign key, table case, and pluralize/singularize are supported as both traits and pure functions
acting on &str and String types.
-----
## Documentation:
Documentation can be found here at the README or via rust docs below.
[Rust docs with examples](https://docs.rs/cruet)
-----
## Installation:
### As a [crate](http://crates.io)
```toml
[dependencies]
cruet = "*"
```
### Compile yourself:
1. Install [Rust and cargo](http://doc.crates.io/)
2. git clone https://github.com/chrislearn/cruet
3. Library: cd cruet && cargo build --release --lib
4. You can find the library in target/release
## Usage / Example:
```rust
...
// to use methods like String.to_lower_case();
extern crate cruet;
use cruet::Inflector;
...
fn main() {
...
let camel_case_string: String = "some_string".to_camel_case();
...
}
```
Or
```rust
...
// to use methods like to_snake_case(&str);
extern crate cruet;
// use cruet::cases::classcase::to_class_case;
// use cruet::cases::classcase::is_class_case;
// use cruet::cases::camelcase::to_camel_case;
// use cruet::cases::camelcase::is_camel_case;
// use cruet::cases::pascalcase::to_pascal_case;
// use cruet::cases::pascalcase::is_pascal_case;
// use cruet::cases::screamingsnakecase::to_screamingsnake_case;
// use cruet::cases::screamingsnakecase::is_screamingsnake_case;
// use cruet::cases::snakecase::to_snake_case;
// use cruet::cases::snakecase::is_snake_case;
// use cruet::cases::kebabcase::to_kebab_case;
// use cruet::cases::kebabcase::is_kebab_case;
// use cruet::cases::traincase::to_train_case;
// use cruet::cases::traincase::is_train_case;
// use cruet::cases::sentencecase::to_sentence_case;
// use cruet::cases::sentencecase::is_sentence_case;
// use cruet::cases::titlecase::to_title_case;
// use cruet::cases::titlecase::is_title_case;
// use cruet::cases::tablecase::to_table_case;
// use cruet::cases::tablecase::is_table_case;
// use cruet::numbers::ordinalize::ordinalize;
// use cruet::numbers::deordinalize::deordinalize;
// use cruet::suffix::foreignkey::to_foreign_key;
// use cruet::suffix::foreignkey::is_foreign_key;
// use cruet::string::demodulize::demodulize;
// use cruet::string::deconstantize::deconstantize;
// use cruet::string::pluralize::to_plural;
// use cruet::string::singularize::to_singular;
...
fn main() {
...
let camel_case_string: String = to_camel_case("some_string");
...
}
```
## Advanced installation and usage:
If the project doesn't require singularize, pluralize, class, table, demodulize,
deconstantize. Then in your `cargo.toml` you may wish to specify:
```toml
[dependencies.Inflector]
version = "*"
default-features = false
```
Or
```toml
Inflector = {version="*", default-features=false}
```
To test this crate locally with features off try:
```shell
cargo test --no-default-features
```
## [Contributing](CONTRIBUTING.md)
This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.