Metadata-Version: 2.1
Name: case-converter
Version: 1.0.1
Summary: A string case conversion package.
Home-page: https://github.com/chrisdoherty4/python-case-converter
Author: Chris Doherty
Author-email: chris@chrisdoherty.io
License: UNKNOWN
Keywords: case,convert,converter,string
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Topic :: Utilities
Classifier: Topic :: Text Processing
Classifier: Programming Language :: Python :: 3
Description-Content-Type: text/markdown

# Case Converter

![pipline](https://gitlab.com/chrisdoherty4/python-case-converter/badges/master/pipeline.svg)

A python package for transforming string cases such as `Hell, world!` into
camel case, `helloWorld`.

## General usage

Import a case conversion helper function, or the conversion object itself.

```python
from caseconverter import camel_case, Camel

camel_case("Hello, world!") # helloWorld
Camel("Hello, world!").convert() # helloWorld
```

#### Customizing delimiters

There are a set of default delimiters used to denote a character boundary.
These delimiters are defined in caseconverter.py as `DELIMITER`.

```python
from caseconverter import camel_case

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

#### Stripping punctuation

Generally, 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`.

```python
from caseconverter import camel_case

camel_case("Hello, world!", strip_punctuation=False) # hello,World!
```

## Available conversions

### Camel case

```text
Hello, world! => helloWorld
```

### Pascal case

```text
Hello, world! => HelloWorld
```

### Snake case

```text
Hello, world! => hello_world
```

### Flat case

```text
Hello, world! => helloworld
```

### Kebab case

```text
Hello, world! => hello-world
```

### Cobol case

```text
Hello, world! => HELLO-WORLD
```

### Macro case

```text
Hello, world! => HELLO_WORLD
```

## 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.


