Add title case

CHANGELOG.md

@@ -5,6 +5,7 @@
 ### Features
 
 - Adds `sentence_case`, see [#38](https://github.com/sobolevn/recase/pull/38)
+- Adds `title_case`, see [#38](https://github.com/sobolevn/recase/pull/39)
 
 ### Misc
 

README.md

@@ -98,6 +98,15 @@ Recase.to_sentence("SomeValue") # => "Some value"
 Recase.to_sentence("some value") # => "Some value"
 ```
 
+### Title
+
+Title case applies a "Title Style" to all words in a sentence.
+
+
+```elixir
+Recase.to_title("some-value") # => "Some Value"
+Recase.to_title("some value") # => "Some Value"
+```
 
 ## Changelog
 

lib/recase.ex

@@ -13,7 +13,8 @@ defmodule Recase do
     PascalCase,
     PathCase,
     SentenceCase,
-    SnakeCase
+    SnakeCase,
+    TitleCase
   }
 
   @doc """
@@ -129,4 +130,18 @@ defmodule Recase do
   """
   @spec to_sentence(String.t) :: String.t
   def to_sentence(value), do: SentenceCase.convert(value)
+
+  @doc """
+  Converts string to Title Case
+
+  ## Examples
+
+      iex> Recase.to_title("SomeValue")
+      "Some Value"
+
+      iex> Recase.to_title("some value")
+      "Some Value"
+  """
+  @spec to_title(String.t) :: String.t
+  def to_title(value), do: TitleCase.convert(value)
 end

lib/recase/cases/title_case.ex

@@ -0,0 +1,25 @@
+defmodule Recase.TitleCase do
+    @moduledoc """
+    Module to convert strings to `Title Case`.
+
+    This module should not be used directly.
+
+    Read about `Title Case` here:
+    https://en.wikipedia.org/wiki/Letter_case#Title_case
+    """
+
+    alias Recase.SnakeCase
+
+    @sep " "
+
+    @spec convert(String.t) :: String.t
+    def convert(""), do: ""
+    def convert(value) do
+      value
+      |> SnakeCase.convert
+      |> String.replace("_", @sep)
+      |> String.split()
+      |> Enum.map(&(String.capitalize(&1)))
+      |> Enum.join(@sep)
+    end
+  end

test/recase_test.exs

@@ -34,4 +34,8 @@ defmodule RecaseTest do
   test "should convert to Sentence case" do
     assert Recase.to_sentence("Some Value") == "Some value"
   end
+
+  test "should convert to Title Case" do
+    assert Recase.to_title("Some Value") == "Some Value"
+  end
 end

test/recase_test/title_case_test.exs

@@ -0,0 +1,23 @@
+defmodule Recase.TitleCaseTest do
+  use ExUnit.Case
+
+  import Recase.TitleCase
+
+  doctest Recase.TitleCase
+
+  test "should title case usual text" do
+    assert convert("title case") == "Title Case"
+    assert convert("titleCase") == "Title Case"
+    assert convert("title_Case") == "Title Case"
+    assert convert("titleCase") == "Title Case"
+    assert convert("title.Case") == "Title Case"
+    assert convert("title case") == "Title Case"
+    assert convert("--title-case--") == "Title Case"
+    assert convert("title#case") == "Title Case"
+    assert convert("title?!case") == "Title Case"
+  end
+
+  test "should return empty string" do
+    assert convert("") == ""
+  end
+end