Textcase is a comprehensive text case conversion library written in Python, designed to facilitate the transformation of string formats seamlessly. With textcase, users can effortlessly convert between various case styles such as snake_case, CONSTANT_CASE, kebab-case, camelCase, PascalCase, lowercase, uppercase, title case, and sentence case.

Key Features

• Flexible Conversion: Utilize the textcase.convert function to convert any string into the desired case format. For example:

from textcase import case, convert

print(convert("ronnie james dio", case.SNAKE))     # ronnie_james_dio
print(convert("Ronnie_James_dio", case.CONSTANT))  # RONNIE_JAMES_DIO

• Custom Word Boundaries: Define specific boundaries for splitting strings based on case conventions. This is especially useful for identifiers with digits and acronyms.

from textcase import boundary, case, convert

print(convert("2020-04-16_my_cat_cali", case.TITLE))                          # 2020 04 16 My Cat Cali
print(convert("scale2D", case.SNAKE, (boundary.LOWER_DIGIT,)))              # scale_2d

• Supports Non-ASCII Characters: The library can handle non-ASCII characters, ensuring accurate conversion across different languages without assumptions about language specifics.

print(convert("GranatÄpfel", case.KEBAB))    # granat-äpfel
print(convert("ПЕРСПЕКТИВА24", case.TITLE))  # Перспектива 24

• Boundary Specificity: For complex cases, textcase allows for stringent control over how strings are split and joined by utilizing custom boundary definitions and case formats.

from textcase.boundary import Boundary

DOT = Boundary(
    satisfies=lambda text: text.startswith("."),
    length=1,
)
print(convert("coolers.revenge", DOT_CASE))  # Coolers Revenge

• Case Detection: The library includes tools to verify the case format of a given string, aiding in validation processes.

from textcase import is_case

print(is_case("css-class-name", case.KEBAB))  # True

API Overview

The library is structured into several modules:

• textcase.boundary: Contains definitions for word splitting conditions.
• textcase.case: Defines various case formats for text transformation.
• textcase.converter: Provides utilities for converting text across different cases.

Through textcase, Python developers gain a powerful tool for string manipulation that accommodates various formatting needs, making it ideal for processing identifiers, filenames, and more.