Safe casting of Python base types
Project description
safe-cast
Safe casting of Python base types.
Badges
docs |
|
---|---|
info |
|
tests |
|
package |
|
other |
Install
pip install safe-cast
Functions
Function |
Purpose |
---|---|
safe_cast(val, to_type, default=None) |
Cast value to requested type, if failed, then used default. |
safe_str(val, default=None) |
Cast value to type string, if failed, then used default. |
safe_float(val, ndigits=2, default=None) |
Cast value to type float, if failed, then used default. |
safe_int(val, default=None) |
Cast value to type int, if failed, then used default. |
safe_dict(val, default=None) |
Cast value to type dictionary, if failed, then used default. |
safe_smart_cast(val) |
Determine type based upon value, and cast to that type. |
safe_cost(val) |
Cast value to type float by 4 decimal points. |
Usage
safe_cast(val, to_type, default=None)
Safely cast a value to type, and if failed, returned default if exists.
Optional: Pass default value. Returned if casting fails.
- param val:
Value to be cast.
- param to_type:
Safely cast to a specific type.
- param default:
Default if casting fails.
- return:
Return casted value or default.
safe_int(val, default=None)
Safely cast a value to an integer.
Optional: Pass default value. Returned if casting fails.
- param val:
Value to be cast to int.
- param default:
Default if casting fails.
- return:
Return int casted value or default.
safe_float(val, ndigits=2, default=None)
Safely cast a value to float, remove ‘,’ if exists to ensure strings “1,234.5” are transformed to become “1234.5”.
Optional: Pass default value. Returned if casting fails.
- param val:
Value to be cast to float.
- param ndigits:
Number of digits in float.
- param default:
Default if casting fails.
- return:
Return float casted value or default.
safe_str(val, default=None)
Safely cast a value to a string.
Optional: Pass default value. Returned if casting fails.
- param val:
Value to be cast to string.
- param default:
Default if casting fails.
- return:
Return string casted value or default.
safe_dict(val, default=None)
Safely cast a value to a dictionary.
Optional: Pass default value. Returned if casting fails.
- param val:
Value to be cast to dictionary.
- param default:
Default if casting fails.
- return:
Return dictionary casted value or default.
safe_smart_cast(val)
Safely cast a value to the best matching type. Optional: Pass default value. Returned if casting fails.
- param val:
Value to be smartly cast.
- return:
Typed value
Release History
0.2.4 (2018-01-25)
migrate to github/tuneinc.
LICENSE: MIT
0.2.3 (2017-12-10)
readthedocs.org
0.2.0 (2017-12-05)
README
0.1.3 (2017-10-31)
Added comments.
0.1.2 (2017-10-19)
Update requirements.txt
0.1.1 (2017-03-15)
Handle empty string -> int/float/dict casting
Added relevant testing
0.1.0 (2017-03-14)
Production ready
Cleanup
0.0.9 (2017-03-14)
Handle None input
0.0.8 (2017-03-12)
Rename package to ‘safe-cast’
0.0.7 (2017-03-09)
Renamed inner package folder to underscore: ‘smart_cast. To comply with Python standard.
Updated casting logic
Updated testing
Activate Continues deployment and testing with Travis.CI
Activate coverage testing: Coveralls.io
0.0.6 (2017-03-08)
Renamed from ‘safecast’ to ‘smart-cast’
0.0.1 (2017-03-07)
Conception
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for safe_cast-0.2.7-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 188aefc2ba5bd479ea24ba1e2cddab7e4c0206c3eae38d42e5ae4c36096dd04a |
|
MD5 | 9efbde152e9ec89344068b3df1807fb7 |
|
BLAKE2b-256 | d4b2378c8728d48897ef40217445fbe3b9d3ac241fa473cad1b1d2d4007dc40c |