diff --git a/README.md b/README.md index 978b46d..7d4d020 100644 --- a/README.md +++ b/README.md @@ -2,8 +2,9 @@ [![Godoc Reference](https://godoc.org/github.com/iancoleman/strcase?status.svg)](http://godoc.org/github.com/iancoleman/strcase) [![Build Status](https://travis-ci.org/iancoleman/strcase.svg)](https://travis-ci.org/iancoleman/strcase) [![Coverage](http://gocover.io/_badge/github.com/iancoleman/strcase?0)](http://gocover.io/github.com/iancoleman/strcase) +[![Go Report Card](https://goreportcard.com/badge/github.com/iancoleman/strcase)](https://goreportcard.com/report/github.com/iancoleman/strcase) -strcase is a go package for converting string case to [snake case](https://en.wikipedia.org/wiki/Snake_case) or [camel case](https://en.wikipedia.org/wiki/CamelCase). +strcase is a go package for converting string case to various cases (e.g. [snake case](https://en.wikipedia.org/wiki/Snake_case) or [camel case](https://en.wikipedia.org/wiki/CamelCase)) to see the full conversion table below. ## Example diff --git a/camel.go b/camel.go index 7c2e2b7..9f3381a 100644 --- a/camel.go +++ b/camel.go @@ -58,12 +58,12 @@ func toCamelInitCase(s string, initCase bool) string { return n } -// Converts a string to CamelCase +// ToCamel converts a string to CamelCase func ToCamel(s string) string { return toCamelInitCase(s, true) } -// Converts a string to lowerCamelCase +// ToLowerCamel converts a string to lowerCamelCase func ToLowerCamel(s string) string { if s == "" { return s diff --git a/camel_test.go b/camel_test.go index b62b9c4..92e397b 100644 --- a/camel_test.go +++ b/camel_test.go @@ -30,15 +30,15 @@ import ( func TestToCamel(t *testing.T) { cases := [][]string{ - []string{"test_case", "TestCase"}, - []string{"test", "Test"}, - []string{"TestCase", "TestCase"}, - []string{" test case ", "TestCase"}, - []string{"", ""}, - []string{"many_many_words", "ManyManyWords"}, - []string{"AnyKind of_string", "AnyKindOfString"}, - []string{"odd-fix", "OddFix"}, - []string{"numbers2And55with000", "Numbers2And55With000"}, + {"test_case", "TestCase"}, + {"test", "Test"}, + {"TestCase", "TestCase"}, + {" test case ", "TestCase"}, + {"", ""}, + {"many_many_words", "ManyManyWords"}, + {"AnyKind of_string", "AnyKindOfString"}, + {"odd-fix", "OddFix"}, + {"numbers2And55with000", "Numbers2And55With000"}, } for _, i := range cases { in := i[0] @@ -52,10 +52,10 @@ func TestToCamel(t *testing.T) { func TestToLowerCamel(t *testing.T) { cases := [][]string{ - []string{"foo-bar", "fooBar"}, - []string{"TestCase", "testCase"}, - []string{"", ""}, - []string{"AnyKind of_string", "anyKindOfString"}, + {"foo-bar", "fooBar"}, + {"TestCase", "testCase"}, + {"", ""}, + {"AnyKind of_string", "anyKindOfString"}, } for _, i := range cases { in := i[0] diff --git a/doc.go b/doc.go new file mode 100644 index 0000000..5e1825b --- /dev/null +++ b/doc.go @@ -0,0 +1,12 @@ +// Package strcase converts strings to various cases. See the conversion table below: +// | Function | Result | +// |---------------------------------|--------------------| +// | ToSnake(s) | any_kind_of_string | +// | ToScreamingSnake(s) | ANY_KIND_OF_STRING | +// | ToKebab(s) | any-kind-of-string | +// | ToScreamingKebab(s) | ANY-KIND-OF-STRING | +// | ToDelimited(s, '.') | any.kind.of.string | +// | ToScreamingDelimited(s, '.') | ANY.KIND.OF.STRING | +// | ToCamel(s) | AnyKindOfString | +// | ToLowerCamel(s) | anyKindOfString | +package strcase diff --git a/snake.go b/snake.go index 1d2f520..b553b97 100644 --- a/snake.go +++ b/snake.go @@ -23,39 +23,38 @@ * SOFTWARE. */ -// Package strcase converts strings to snake_case or CamelCase package strcase import ( "strings" ) -// Converts a string to snake_case +// ToSnake converts a string to snake_case func ToSnake(s string) string { return ToDelimited(s, '_') } -// Converts a string to SCREAMING_SNAKE_CASE +// ToScreamingSnake converts a string to SCREAMING_SNAKE_CASE func ToScreamingSnake(s string) string { return ToScreamingDelimited(s, '_', true) } -// Converts a string to kebab-case +// ToKebab converts a string to kebab-case func ToKebab(s string) string { return ToDelimited(s, '-') } -// Converts a string to SCREAMING-KEBAB-CASE +// ToScreamingKebab converts a string to SCREAMING-KEBAB-CASE func ToScreamingKebab(s string) string { return ToScreamingDelimited(s, '-', true) } -// Converts a string to delimited.snake.case (in this case `del = '.'`) +// ToDelimited converts a string to delimited.snake.case (in this case `del = '.'`) func ToDelimited(s string, del uint8) string { return ToScreamingDelimited(s, del, false) } -// Converts a string to SCREAMING.DELIMITED.SNAKE.CASE (in this case `del = '.'; screaming = true`) or delimited.snake.case (in this case `del = '.'; screaming = false`) +// ToScreamingDelimited converts a string to SCREAMING.DELIMITED.SNAKE.CASE (in this case `del = '.'; screaming = true`) or delimited.snake.case (in this case `del = '.'; screaming = false`) func ToScreamingDelimited(s string, del uint8, screaming bool) string { s = addWordBoundariesToNumbers(s) s = strings.Trim(s, " ") diff --git a/snake_test.go b/snake_test.go index 9c0f9d2..37ca332 100644 --- a/snake_test.go +++ b/snake_test.go @@ -31,23 +31,23 @@ import ( func TestToSnake(t *testing.T) { cases := [][]string{ - []string{"testCase", "test_case"}, - []string{"TestCase", "test_case"}, - []string{"Test Case", "test_case"}, - []string{" Test Case", "test_case"}, - []string{"Test Case ", "test_case"}, - []string{" Test Case ", "test_case"}, - []string{"test", "test"}, - []string{"test_case", "test_case"}, - []string{"Test", "test"}, - []string{"", ""}, - []string{"ManyManyWords", "many_many_words"}, - []string{"manyManyWords", "many_many_words"}, - []string{"AnyKind of_string", "any_kind_of_string"}, - []string{"numbers2and55with000", "numbers_2_and_55_with_000"}, - []string{"JSONData", "json_data"}, - []string{"userID", "user_id"}, - []string{"AAAbbb", "aa_abbb"}, + {"testCase", "test_case"}, + {"TestCase", "test_case"}, + {"Test Case", "test_case"}, + {" Test Case", "test_case"}, + {"Test Case ", "test_case"}, + {" Test Case ", "test_case"}, + {"test", "test"}, + {"test_case", "test_case"}, + {"Test", "test"}, + {"", ""}, + {"ManyManyWords", "many_many_words"}, + {"manyManyWords", "many_many_words"}, + {"AnyKind of_string", "any_kind_of_string"}, + {"numbers2and55with000", "numbers_2_and_55_with_000"}, + {"JSONData", "json_data"}, + {"userID", "user_id"}, + {"AAAbbb", "aa_abbb"}, } for _, i := range cases { in := i[0] @@ -61,24 +61,24 @@ func TestToSnake(t *testing.T) { func TestToDelimited(t *testing.T) { cases := [][]string{ - []string{"testCase", "test@case"}, - []string{"TestCase", "test@case"}, - []string{"Test Case", "test@case"}, - []string{" Test Case", "test@case"}, - []string{"Test Case ", "test@case"}, - []string{" Test Case ", "test@case"}, - []string{"test", "test"}, - []string{"test_case", "test@case"}, - []string{"Test", "test"}, - []string{"", ""}, - []string{"ManyManyWords", "many@many@words"}, - []string{"manyManyWords", "many@many@words"}, - []string{"AnyKind of_string", "any@kind@of@string"}, - []string{"numbers2and55with000", "numbers@2@and@55@with@000"}, - []string{"JSONData", "json@data"}, - []string{"userID", "user@id"}, - []string{"AAAbbb", "aa@abbb"}, - []string{"test-case", "test@case"}, + {"testCase", "test@case"}, + {"TestCase", "test@case"}, + {"Test Case", "test@case"}, + {" Test Case", "test@case"}, + {"Test Case ", "test@case"}, + {" Test Case ", "test@case"}, + {"test", "test"}, + {"test_case", "test@case"}, + {"Test", "test"}, + {"", ""}, + {"ManyManyWords", "many@many@words"}, + {"manyManyWords", "many@many@words"}, + {"AnyKind of_string", "any@kind@of@string"}, + {"numbers2and55with000", "numbers@2@and@55@with@000"}, + {"JSONData", "json@data"}, + {"userID", "user@id"}, + {"AAAbbb", "aa@abbb"}, + {"test-case", "test@case"}, } for _, i := range cases { in := i[0] @@ -92,7 +92,7 @@ func TestToDelimited(t *testing.T) { func TestToScreamingSnake(t *testing.T) { cases := [][]string{ - []string{"testCase", "TEST_CASE"}, + {"testCase", "TEST_CASE"}, } for _, i := range cases { in := i[0] @@ -106,7 +106,7 @@ func TestToScreamingSnake(t *testing.T) { func TestToKebab(t *testing.T) { cases := [][]string{ - []string{"testCase", "test-case"}, + {"testCase", "test-case"}, } for _, i := range cases { in := i[0] @@ -120,7 +120,7 @@ func TestToKebab(t *testing.T) { func TestToScreamingKebab(t *testing.T) { cases := [][]string{ - []string{"testCase", "TEST-CASE"}, + {"testCase", "TEST-CASE"}, } for _, i := range cases { in := i[0] @@ -134,7 +134,7 @@ func TestToScreamingKebab(t *testing.T) { func TestToScreamingDelimited(t *testing.T) { cases := [][]string{ - []string{"testCase", "TEST.CASE"}, + {"testCase", "TEST.CASE"}, } for _, i := range cases { in := i[0]