flect

package module

v0.1.0 Latest Latest Go to latest Published: Feb 12, 2019 License: MIT Imports: 13 Imported by: 312

Details

Valid go.mod file

The Go module system was introduced in Go 1.11 and is the official dependency management solution for Go.
Redistributable license

Redistributable licenses place minimal restrictions on how software can be used, modified, and redistributed.
Tagged version

Modules with tagged versions give importers more predictable builds.
Stable version

When a project reaches major version v1 it is considered stable.
Learn more about best practices

Repository

github.com/gobuffalo/flect

Links

Open Source Insights

README ¶

Flect

This is a new inflection engine to replace https://github.com/markbates/inflect designed to be more modular, more readable, and easier to fix issues on than the original.

Installation

$ go get -u -v github.com/gobuffalo/flect

`github.com/gobuffalo/flect`

The github.com/gobuffalo/flect package contains "basic" inflection tools, like pluralization, singularization, etc...

The `Ident` Type

In 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.

The Ident type contains two fields.

Original - This is the original string that was used to create the Ident
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

Examples of creating new inflection rules using Ident can be found in the github.com/gobuffalo/flect/name package.

`github.com/gobuffalo/flect/name`

The github.com/gobuffalo/flect/name package contains more "business" inflection rules like creating proper names, table names, etc...

Documentation ¶

Overview ¶

Package flect 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.

Index ¶

Constants
func AddPlural(suffix string, repl string)
func AddSingular(ext string, repl string)
func Camelize(s string) string
func Capitalize(s string) string
func Dasherize(s string) string
func LoadAcronyms(r io.Reader) error
func LoadInflections(r io.Reader) error
func Ordinalize(s string) string
func Pascalize(s string) string
func Pluralize(s string) string
func Singularize(s string) string
func Titleize(s string) string
func Underscore(s string) string
type CustomDataParser
type Ident
- func New(s string) Ident

Constants ¶

View Source

const Version = "v0.0.1"

Version holds Flect version number

Variables ¶

This section is empty.

Functions ¶

func AddPlural ¶

func AddPlural(suffix string, repl string)

AddPlural adds a rule that will replace the given suffix with the replacement suffix.

func AddSingular ¶

func AddSingular(ext string, repl string)

AddSingular adds a rule that will replace the given suffix with the replacement suffix.

func Camelize ¶

func Camelize(s string) string

Camelize returns a camelize version of a string

bob dylan = bobDylan
widget_id = widgetID
WidgetID = widgetID

func Capitalize ¶

func Capitalize(s string) string

Capitalize will cap the first letter of string

user = User
bob dylan = Bob dylan
widget_id = Widget_id

func Dasherize ¶

func Dasherize(s string) string

Dasherize returns an alphanumeric, lowercased, dashed string

Donald E. Knuth = donald-e-knuth
Test with + sign = test-with-sign
admin/WidgetID = admin-widget-id

func LoadAcronyms ¶

func LoadAcronyms(r io.Reader) error

LoadAcronyms loads rules from io.Reader param

func LoadInflections ¶

func LoadInflections(r io.Reader) error

LoadInflections loads rules from io.Reader param

func Ordinalize ¶

func Ordinalize(s string) string

Ordinalize converts a number to an ordinal version

42 = 42nd
45 = 45th
1 = 1st

func Pascalize ¶

func Pascalize(s string) string

Pascalize returns a string with each segment capitalized

user = User
bob dylan = BobDylan
widget_id = WidgetID

func Pluralize ¶

func Pluralize(s string) string

Pluralize returns a plural version of the string

user = users
person = people
datum = data

func Singularize ¶

func Singularize(s string) string

Singularize returns a singular version of the string

users = user
data = datum
people = person

func Titleize ¶

func Titleize(s string) string

Titleize will capitalize the start of each part

"Nice to see you!" = "Nice To See You!"
"i've read a book! have you?" = "I've Read A Book! Have You?"
"This is `code` ok" = "This Is `code` OK"

func Underscore ¶

func Underscore(s string) string

Underscore a string

bob dylan = bob_dylan
Nice to see you! = nice_to_see_you
widgetID = widget_id

Types ¶

type CustomDataParser ¶

type CustomDataParser func(io.Reader) error

CustomDataParser are functions that parse data like acronyms or plurals in the shape of a io.Reader it receives.

type Ident ¶

type Ident struct {
	Original string
	Parts    []string
}

Ident represents the string and it's parts

func New ¶

func New(s string) Ident

New creates a new Ident from the string

func (Ident) Camelize ¶

func (i Ident) Camelize() Ident