---
title: "case-converter | pypx"
description: "A string case conversion package."
canonical_url: "https://pypx.app/packages/case-converter"
meta:
  "og:description": "A string case conversion package."
  "og:image": "https://pypx.app/_og/d/h_630%2Cc_PackageCard%2Cname_case-converter%2Cversion_1.2.0%2Csummary_A%2Bstring%2Bcase%2Bconversion%2Bpackage.%2Clicense_MIT%2BLicense%2Cp_Ii9wYWNrYWdlcy9jYXNlLWNvbnZlcnRlciI%2Cs_AQRN4Rvb8J29UsWl.png"
  "og:image:height": "630"
  "og:image:type": image/png
  "og:image:width": "1200"
  "og:title": "case-converter 1.2.0"
  "twitter:image": "https://pypx.app/_og/d/h_630%2Cc_PackageCard%2Cname_case-converter%2Cversion_1.2.0%2Csummary_A%2Bstring%2Bcase%2Bconversion%2Bpackage.%2Clicense_MIT%2BLicense%2Cp_Ii9wYWNrYWdlcy9jYXNlLWNvbnZlcnRlciI%2Cs_AQRN4Rvb8J29UsWl.png"
---

> Index of every page on this site: [llms.txt](https://pypx.app/llms.txt)

# **case-converter**

v1.2.0

A string case conversion package.

16 KBpy3-none-anyMIT License

[** Diff **](https://pypx.app/packages/case-converter/diff)

`$ uv add case-converter`

# Case Converter

[![pipline](https://img.shields.io/gitlab/pipeline/chrisdoherty4/python-case-converter)](https://gitlab.com/chrisdoherty4/python-case-converter/-/pipelines) [![wheel](https://img.shields.io/pypi/wheel/case-converter)](https://pypi.org/project/case-converter/) ![coverage](https://gitlab.com/chrisdoherty4/python-case-converter/badges/master/coverage.svg) ![license](https://img.shields.io/github/license/chrisdoherty4/python-case-converter)

A robust python package for transforming string cases such as `Hello, world!` into `helloWorld` (camelcase).

## General usage

```
from caseconverter import camelcase

camelcase("Hello, world!") # output: helloWorld
```

## Available conversions

### `camelcase`

```
from caseconverter import camelcase

camelcase("Hello, world!")
```

```
helloWorld
```

### `cobolcase`

```
from caseconverter import cobolcase

cobolcase("Hello, world!")
```

```
HELLO-WORLD
```

### `flatcase`

```
from caseconverter import flatcase

flatcase("Hello, world!")
```

```
helloworld
```

### `kebabcase`

```
from caseconverter import kebabcase

kebabcase("Hello, world!")
```

```
hello-world
```

### `macrocase`

```
from caseconverter import macrocase

macrocase("Hello, world!")
```

```
HELLO_WORLD
```

#### Additional options

`delims_only : bool` - Only consider delimiters as boundaries (default: `False`).

### `pascalcase`

```
from caseconverter import pascalcase

pascalcase("Hello, world!")
```

```
HelloWorld
```

### `snakecase`

```
from caseconverter import snakecase

snakecase("Hello, world!")
```

```
hello_world
```

### `titlecase`

```
from caseconverter import titlecase

titlecase("Hello, world!")
```

```
Hello World
```

## Options for all conversions

### Stripping punctuation

Punctuation is stripped when doing a case conversion. However, should you wish to keep the punctuation you can do so by passing `strip_punctuation=False`.

```
camelcase("Hello, world!", strip_punctuation=False) # output: hello,World!
```

### Delimeter customization

Default delimiters used to denote a token boundary.

```
DELIMITERS = " -_"
```

You can pass `delims` to each case conversion function to specify a custom set of delimiters.

```
# Use a pipe `|` as the only delimiter.
camelcase("Hello,|world!", delims="|") # output: helloWorld
```

## Behavior

### Delimiters

If multiple delimeter characters are identified next to eachother they will be considered as a single delimeter. For example, `-_` contains 2 different delimeter characters and is considered a single delimeter.

### Boundary definitions

| Name | Description |
| --- | --- |
| OnDelimeterUppercaseNext | On a delimieter, upper case the following character |
| OnDelimeterLowercaseNext | On a delimeter, lower case the following character |
| OnUpperPrecededByLowerAppendUpper | On an upper case character followed by a lower case character, append the upper case character |
| OnUpperPrecededByLowerAppendLower | On an upper case character preceeded by a lower case character append the lower case character |
| OnUpperPrecededByUpperAppendJoin | On an upper case caharacter preceeded by an upper append the join character. Join characters are context dependent. Example: macro cast join character is `_` |
| OnUpperPrecededByUpperAppendCurrent | On an upper case character preceeded by an upper case character append the upper case character |

## Contributing

1. Write clean code.
2. Write new tests for new use-cases.
3. Test your code before raising a PR.
4. Use [black](https://pypi.org/project/black/) to format your code.

## **Details **

<dl>

<dt>Version</dt>
<dd>1.2.0</dd>

<dt>License</dt>
<dd>MIT License</dd>

<dt>Maintainer</dt>
<dd>Chris Doherty</dd></dl>

## **Links**

- [Homepage](https://github.com/chrisdoherty4/python-case-converter)
- [View on PyPI](https://pypi.org/project/case-converter/)

## **Maintainers **

- Chris Doherty · [chris@chrisdoherty.io](mailto:chris@chrisdoherty.io)

```json
{"@context":"https://schema.org","@graph":[{"@id":"https://pypx.app/#website","@type":"WebSite","description":"The Python Package Index, reimagined. Fast search, dependency insights, download trends, and changelogs — all in one place.","name":"pypx","url":"https://pypx.app/"},{"@id":"https://pypx.app/packages/case-converter#webpage","@type":"WebPage","description":"A string case conversion package.","name":"case-converter","url":"https://pypx.app/packages/case-converter","isPartOf":{"@id":"https://pypx.app/#website"},"potentialAction":[{"@type":"ReadAction","target":["https://pypx.app/packages/case-converter"]}]},{"@id":"https://pypx.app/packages/case-converter#/schema/software-application/1","@type":"SoftwareApplication","applicationCategory":"DeveloperApplication","description":"A string case conversion package.","license":"MIT License","name":"case-converter","softwareVersion":"1.2.0"}]}
```

## Sitemap

See the full [sitemap](https://pypx.app/sitemap.md) for all pages.
