clevertitle

CleverTitle: Flexible Smart Title Case Formatter

CleverTitle is a Python function designed to transform strings into flexible title case format while excluding specified words from capitalization. This simple yet powerful tool supports various input styles and offers unmatched flexibility for users with diverse formatting needs.

Features

• Converts strings to a "flexible" title case format.
• Allows exclusions for specific words (e.g., articles, prepositions).
• Handles exclusions provided as:
  • A single word.
  • A list of words.
  • Multiple words as separate arguments.
• Automatically normalizes exclusions to lowercase for consistency.

Importing the Function

from clevertitle import CleverTitle

Example Usages

Example 1: Single exclusion word

formatter = CleverTitle("the")
result = formatter.to_clever_title_case("the quick brown fox jumps over the lazy dog")
print(result)  # Output: "The Quick Brown Fox Jumps Over The Lazy Dog"

Example 2: Multiple exclusions as separate arguments

formatter = CleverTitle("the", "over", "jumps")
result = formatter.to_clever_title_case("the quick brown fox jumps over the lazy dog")
print(result)  # Output: "The Quick Brown Fox Jumps over the Lazy Dog"

Example 3: Exclusions as a list

formatter = CleverTitle(["the", "over", "quick"])
result = formatter.to_clever_title_case("the quick brown fox jumps over the lazy dog")
print(result)  # Output: "The quick Brown Fox Jumps over the Lazy Dog"

Example 4: Combining lists and strings

formatter = CleverTitle(["the", "over"], "jumps")
result = formatter.to_clever_title_case("the quick brown fox jumps over the lazy dog")
print(result)  # Output: "The Quick Brown Fox jumps over the Lazy Dog"

Example 5: No exclusions

formatter = CleverTitle()
result = formatter.to_clever_title_case("the quick brown fox jumps over the lazy dog")
print(result)  # Output: "The Quick Brown Fox Jumps Over The Lazy Dog"

Example 6: Dynamic word splitting

formatter = CleverTitle("brown over quick")
result = formatter.to_clever_title_case("the quick brown fox jumps over the lazy dog")
print(result)  # Output: "The quick brown Fox Jumps over The Lazy Dog"

Example 7: Case insensitivity

formatter = CleverTitle("ThE", "OVer", "QUICK")
result = formatter.to_clever_title_case("the quick brown fox jumps over the lazy dog")
print(result)  # Output: "The quick Brown Fox Jumps over the Lazy Dog"

Example 8: First word always capitalized

formatter = CleverTitle("the", "and")
result = formatter.to_clever_title_case("and then there was light")
print(result)  # Output: "And Then There Was Light"

Example 9: Single word input

formatter = CleverTitle("the")
result = formatter.to_clever_title_case("fox")
print(result)  # Output: "Fox"

Example 10: Empty string input

formatter = CleverTitle("the")
result = formatter.to_clever_title_case("")
print(result)  # Output: ""

Example 11: Large input with many exclusions

exclusions = ["the", "over", "and", "a", "of", "in", "to", "on"]
formatter = CleverTitle(*exclusions)
text = "the history of art in the renaissance and its impact on society"
result = formatter.to_clever_title_case(text)
print(result)  # Output: "The History of Art in the Renaissance and Its Impact on Society"

API Reference

Function: CleverTitle

Constructor

CleverTitle(*exclusions)

• exclusions (str, list, or multiple strings): Words to exclude from capitalization.

Method: to_clever_title_case

to_clever_title_case(text)

• text (str): The input string to format.
• Returns: A string formatted in clever title case.

Author

• Name: Khalid Sulaiman Al-Mulaify
• Email: [e-mail]
• X Account: @Python__Task

License

This project is licensed under the MIT License.