Camel_SNAKE-kebab

A Clojure library for word case conversions.

News

2014-07-28: 0.2.0

• Supports ClojureScript!
• Has new regex-free internals.
• Handles non-ASCII chars better.
• Breaking change: The namespace camel-snake-kebab has been renamed to camel-snake-kebab.core.

Examples

(use 'camel-snake-kebab.core)

(->CamelCase 'flux-capacitor)
; => 'FluxCapacitor

(->SNAKE_CASE "I am constant")
; => "I_AM_CONSTANT"

(->kebab-case :object_id)
; => :object-id

(->HTTP-Header-Case "x-ssl-cipher")
; => "X-SSL-Cipher"

There are also functions that convert the value type for you:

(->kebab-case-keyword "object_id")
; => :object-id

Installation

1. Add the following to your project.clj :dependencies:

[camel-snake-kebab "0.2.5"]

2. Add the following to your namespace declaration:

:require [camel-snake-kebab.core :refer :all]

Available Conversion Functions

• ->CamelCase
• ->camelCase
• ->SNAKE_CASE
• ->Snake_case
• ->snake_case
• ->kebab-case
• ->Camel_Snake_Case
• ->HTTP-Header-Case

You should be able to figure out all what all of them do.

Yeah, and then there are the type-converting functions:

• ->CamelCase{Keyword, String, Symbol}
• ->camelCase{Keyword, String, Symbol}
• ->SNAKE_CASE_{KEYWORD, STRING, SYMBOL}
• ->Snake_case_{keyword, string, symbol}
• ->snake_case_{keyword, string, symbol}
• ->kebab-case-{keyword, string, symbol}
• ->Camel_Snake_Case_{Keyword, String, Symbol}
• ->HTTP-Header-Case-{Keyword, String, Symbol}

Notes

• Namespaced keywords and symbols will be rejected with an exception.

• This library has function names that only differ in case and will not work if you AOT compile it to a case-insensitive filesystem (on e.g. Windows and OS X). lein ring uberwar always uses AOT and is therefore not compatible with this library on these systems. See #15 and lein-ring#120 for details.

Serving Suggestions

With JSON

(require '[clojure.data.json :as json])

(json/read-str "{\"firstName\":\"John\",\"lastName\":\"Smith\"}" :key-fn ->kebab-case-keyword)
; => {:first-name "John", :last-name "Smith"}

; And back:

(json/write-str {:first-name "John", :last-name "Smith"} :key-fn ->camelCaseString)
; => "{\"firstName\":\"John\",\"lastName\":\"Smith\"}"

With Plain Maps

(require '[camel-snake-kebab.extras :refer [transform-keys]])

(transform-keys ->kebab-case-keyword {"firstName" "John", "lastName" "Smith"})
; => {:first-name "John", :last-name "Smith"}

; And back:

(transform-keys ->camelCaseString {:first-name "John", :last-name "Smith"})
; => {"firstName" "John", "lastName" "Smith"}

With JavaBeans

(require '[camel-snake-kebab.extras :refer [transform-keys]])

(->> (java.util.Date.)
     (bean)
     (transform-keys ->kebab-case)
     :timezone-offset)
; => -120

With Memoization

If you're going to do case conversion in a hot spot, use core.memoize to avoid doing the same conversions over and over again.

(use 'clojure.core.memoize)
(use 'criterium.core)

(def memoized->kebab-case
  (memo-fifo ->kebab-case 512))

(quick-bench (->kebab-case "firstName"))
; ... Execution time mean : 6,384971 µs ...

(quick-bench (memoized->kebab-case "firstName"))
; ... Execution time mean : 700,146806 ns ...

Further Reading

• ToCamelCaseorUnderscore
• Wikipedia about usage of letter case in computer programming

Alternatives

• org.tobereplaced/lettercase
• com.google.common.base.CaseFormat

License

Copyright (C) 2012-2014 the AUTHORS.

Distributed under the Eclipse Public License, the same as Clojure.