TypePigeon is a Python type converter focused on converting values between various Python data types.
pip install typepigeon
- convert values directly from one Python type to another with
to_type()
- convert values to JSON format with
to_json()
- convert generic aliases (
List[str]
) to simple collection types ([str]
) withsubscripted_type()
With TypePigeon, you can convert simple values from one type to another:
import typepigeon
typepigeon.to_type(0.55, str)
'0.55'
typepigeon.to_type(1, float)
1.0
typepigeon.to_type([1], str)
'[1]'
Additionally, you can also cast values into a collection:
import typepigeon
typepigeon.to_type([1, 2.0, '3'], [int])
[1, 2, 3]
typepigeon.to_type('[1, 2, 3]', (int, str, float))
[1, '2', 3.0]
typepigeon.to_type({'a': 2.5, 'b': 4, 3: '18'}, {str: float})
{'a': 2.5, 'b': 4.0, '3': 18.0}
Some commonly-used classes such as datetime
and CRS
are also supported:
from datetime import datetime, timedelta
from pyproj import CRS
import typepigeon
typepigeon.to_type(datetime(2021, 3, 26), str)
'2021-03-26 00:00:00'
typepigeon.to_type('20210326', datetime)
datetime(2021, 3, 26)
typepigeon.to_type('01:13:20:00', timedelta)
timedelta(days=1, hours=13, minutes=20, seconds=0)
typepigeon.to_type(timedelta(hours=1), str)
'01:00:00.0'
typepigeon.to_type(timedelta(hours=1), int)
3600
typepigeon.to_type(CRS.from_epsg(4326), int)
4326
typepigeon.to_type(CRS.from_epsg(4326), str)
'GEOGCRS["WGS 84",ENSEMBLE["World Geodetic System 1984 ensemble",MEMBER["World Geodetic System 1984 (Transit)"],MEMBER["World Geodetic System 1984 (G730)"],MEMBER["World Geodetic System 1984 (G873)"],MEMBER["World Geodetic System 1984 (G1150)"],MEMBER["World Geodetic System 1984 (G1674)"],MEMBER["World Geodetic System 1984 (G1762)"],ELLIPSOID["WGS 84",6378137,298.257223563,LENGTHUNIT["metre",1]],ENSEMBLEACCURACY[2.0]],PRIMEM["Greenwich",0,ANGLEUNIT["degree",0.0174532925199433]],CS[ellipsoidal,2],AXIS["geodetic latitude (Lat)",north,ORDER[1],ANGLEUNIT["degree",0.0174532925199433]],AXIS["geodetic longitude (Lon)",east,ORDER[2],ANGLEUNIT["degree",0.0174532925199433]],USAGE[SCOPE["Horizontal component of 3D system."],AREA["World."],BBOX[-90,-180,90,180]],ID["EPSG",4326]]'
typepigeon.to_type(4326, CRS)
CRS.from_epsg(4326)
from datetime import datetime
import typepigeon
typepigeon.to_json(5)
5
typepigeon.to_json('5')
'5'
typepigeon.to_json(datetime(2021, 3, 26))
'2021-03-26 00:00:00'
typepigeon.to_json([5, '6', {3: datetime(2021, 3, 27)}])
[5, '6', {3: '2021-03-27 00:00:00'}]
typepigeon.to_json({'test': [5, '6', {3: datetime(2021, 3, 27)}]})
{'test': [5, '6', {3: '2021-03-27 00:00:00'}]}
import typepigeon.types
from typing import Dict, List, Tuple
import typepigeon
typepigeon.types.subscripted_type(List[str])
[str]
typepigeon.types.subscripted_type(Dict[str, float])
{str: float}
typepigeon.types.subscripted_type({str: (Dict[int, str], str)})
{str: ({int: str}, str)}