https://github.com/zigai/strto
Type-guided parsing library for converting strings to Python objects
https://github.com/zigai/strto
string-parser type-hints
Last synced: 5 months ago
JSON representation
Type-guided parsing library for converting strings to Python objects
- Host: GitHub
- URL: https://github.com/zigai/strto
- Owner: zigai
- License: mit
- Created: 2023-04-09T12:20:57.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2025-07-12T22:40:37.000Z (6 months ago)
- Last Synced: 2025-07-13T00:17:17.261Z (6 months ago)
- Topics: string-parser, type-hints
- Language: Python
- Homepage:
- Size: 78.1 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# strto
[](https://github.com/zigai/strto/actions/workflows/tests.yml)
[](https://badge.fury.io/py/strto)
[](https://pepy.tech/project/strto)
[](https://github.com/zigai/strto/blob/master/LICENSE)
`strto` is a Python library for parsing strings into Python objects based on types and type annotations.
## Installation
#### From PyPi
```sh
pip install strto
```
#### From source
```sh
pip install git+https://github.com/zigai/strto.git
```
## Examples
```python
>>> from strto import get_parser
>>> parser = get_parser()
>>> parser.parse("5", int)
5
>>> parser.parse("1.5", int | float)
1.5
>>> parser.parse("1,2,3,4,5", list[int])
[1, 2, 3, 4, 5]
>>> parser.parse('{"a":1,"b":2,"c":3}', dict[str, int])
{'a': 1, 'b': 2, 'c': 3}
import datetime
>>> parser.parse("2022.07.19", datetime.date)
datetime.date(2022, 7, 19)
>>> parser.parse("0:5:1", range)
range(0, 5, 1)
>>> import enum
>>> class Color(enum.Enum):
... RED = 1
... GREEN = 2
... BLUE = 3
>>> parser.parse("RED", Color)
Color.RED
```
### Add custom parser
```python
from dataclasses import dataclass
from strto import ParserBase, get_parser
@dataclass
class NetworkAddress:
host: str
port: int
class NetworkAddressParser(ParserBase):
def parse(self, value: str) -> NetworkAddress:
host, port = value.rsplit(":")
return NetworkAddress(host=host, port=int(port))
parser = get_parser()
parser.add(NetworkAddress, NetworkAddressParser())
result = parser.parse("example.com:8080", NetworkAddress)
print(result) # NetworkAddress(host='example.com', port=8080)
# You can also use a function
def parse_network_address(value: str) -> NetworkAddress:
host, port = value.rsplit(":")
return NetworkAddress(host=host, port=int(port))
parser = get_parser()
parser.add(NetworkAddress, parse_network_address)
result = parser.parse("example.com:8080", NetworkAddress)
print(result) # NetworkAddress(host='example.com', port=8080)
```
## License
[MIT License](https://github.com/zigai/strto/blob/master/LICENSE)