README.md
1# Flect
2
3<p align="center">
4<a href="https://godoc.org/github.com/gobuffalo/flect"><img src="https://godoc.org/github.com/gobuffalo/flect?status.svg" alt="GoDoc" /></a>
5<a href="https://dev.azure.com/markbates/buffalo/_build/latest?definitionId=51&branchName=master"><img src="https://dev.azure.com/markbates/buffalo/_apis/build/status/gobuffalo.flect?branchName=master" alt="CI" /></a>
6<a href="https://goreportcard.com/report/github.com/gobuffalo/flect"><img src="https://goreportcard.com/badge/github.com/gobuffalo/flect" alt="Go Report Card" /></a>
7</p>
8
9This is a new inflection engine to replace [https://github.com/markbates/inflect](https://github.com/markbates/inflect) designed to be more modular, more readable, and easier to fix issues on than the original.
10
11## Installation
12
13```bash
14$ go get -u -v github.com/gobuffalo/flect
15```
16
17## `github.com/gobuffalo/flect`
18<a href="https://godoc.org/github.com/gobuffalo/flect"><img src="https://godoc.org/github.com/gobuffalo/flect?status.svg" alt="GoDoc" /></a>
19
20The `github.com/gobuffalo/flect` package contains "basic" inflection tools, like pluralization, singularization, etc...
21
22### The `Ident` Type
23
24In addition to helpful methods that take in a `string` and return a `string`, there is an `Ident` type that can be used to create new, custom, inflection rules.
25
26The `Ident` type contains two fields.
27
28* `Original` - This is the original `string` that was used to create the `Ident`
29* `Parts` - This is a `[]string` that represents all of the "parts" of the string, that have been split apart, making the segments easier to work with
30
31Examples of creating new inflection rules using `Ident` can be found in the `github.com/gobuffalo/flect/name` package.
32
33## `github.com/gobuffalo/flect/name`
34<a href="https://godoc.org/github.com/gobuffalo/flect/name"><img src="https://godoc.org/github.com/gobuffalo/flect/name?status.svg" alt="GoDoc" /></a>
35
36The `github.com/gobuffalo/flect/name` package contains more "business" inflection rules like creating proper names, table names, etc...
37