https://github.com/lysnikolaou/snakecamel
A small utility to camelize (convert to camel-case) or snakeize (convert to snake-case) any object
https://github.com/lysnikolaou/snakecamel
camelcase camelcase-to-snakecase python3 python310 snakecase snakecase-to-camelcase utility utility-library
Last synced: 4 months ago
JSON representation
A small utility to camelize (convert to camel-case) or snakeize (convert to snake-case) any object
- Host: GitHub
- URL: https://github.com/lysnikolaou/snakecamel
- Owner: lysnikolaou
- License: mit
- Created: 2022-07-31T13:50:05.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2023-03-06T20:29:20.000Z (almost 3 years ago)
- Last Synced: 2025-06-09T12:06:34.352Z (7 months ago)
- Topics: camelcase, camelcase-to-snakecase, python3, python310, snakecase, snakecase-to-camelcase, utility, utility-library
- Language: Python
- Homepage:
- Size: 89.8 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# snakecamel
[](https://github.com/lysnikolaou/snakecamel/actions/workflows/test.yml)
[](https://codecov.io/gh/lysnikolaou/snakecamel)
A small utility to camelize (convert to camel-case) or snakeize (convert to snake-case) any object.
This is a very early-stage project & for the time-being is only there as a personal utility.
## Usage
```python
import snakecamel
>>> snakecamel.camelize("simple_string")
'simpleString
>>> snakecamel.snakeize("simpleString")
'simple_string'
```
### General notes
1. The library is designed to be very forgiving. It does not raise upon encountering an unknown type, it
just skips it. This way, you can pass arbitrary objects to it & everything that can be camelized/snakeized,
will be.
```python
>>> import snakecamel
>>> snakecamel.camelize(50)
50
>>> from datetime import date
>>> snakecamel.camelize({"hello_world": "hello_world", 50: 50, date.today(): "today"})
{'helloWorld': 'hello_world', 50: 50, datetime.date(2022, 7, 31): 'today'}
```
2. The library will try to re-construct the type you pass to it, so that if you pass
different kinds of iterables, you'll get the same type returned. Unfortunately, that still
does not work with mappings.
```python
>>> import snakecamel
>>> snakecamel.camelize(["simple_string"])
['simpleString']
>>> snakecamel.camelize({"simple_string"})
{'simpleString'}
>>> snakecamel.camelize(("simple_string",))
('simpleString',)
>>> snakecamel.camelize("simple_string")
'simpleString'
```
3. When camelizing/snakeizing mappings, you can choose to do so with keys only or keys & values.
```python
>>> import snakecamel
>>> snakecamel.camelize({"simple_key": "simple_value"})
{'simpleKey': 'simple_value'}
>>> snakecamel.camelize({"simple_key": "simple_value"}, camelize_mapping_values=True)
{'simpleKey': 'simpleValue'}
```
4. You can shoose between capitalized or non-capitalized camel case.
```python
>>> import snakecamel
>>> snakecamel.camelize("simple_string")
'simpleString'
>>> snakecamel.camelize("simple_string", capitalized=True)
'SimpleString'
```
When snakeizing, you _need_ to pass `capitalized=True`, if you want the first letter of a
capitalized camel-case word to be lowercased.
```python
>>> snakecamel.snakeize("simpleString")
'simple_string'
>>> snakecamel.snakeize("simpleString", capitalized=True)
'simple_string'
>>> snakecamel.snakeize("SimpleString")
'Simple_string'
>>> snakecamel.snakeize("SimpleString", capitalized=True)
'simple_string'
```
5. When camelizing, you can choose whether you're stripping leading/trailing underscores or not.
```python
import snakecamel
>>> import snakecamel
>>> snakecamel.camelize("_simple_string_")
'_simpleString_'
>>> snakecamel.camelize("_simple_string_", strip_underscores=True)
'simpleString'
```