Safe casting of Python base types
Project description
safe-cast
Safe casting of Python base types.
Badges
docs |
|
---|---|
info |
|
tests |
|
package |
|
other |
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. |
safe_fraction(val) |
Cast fraction to type float, if failed, then used default. |
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
safe_fraction(fraction, ndigits=2, default=None)
Safely cast a fraction string to float.
Optional: Pass default value. Returned if casting fails.
- param fraction:
Value of fraction 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.
Release History
0.3.2 (2018-02-16)
Python 2.7 supported
Travis CI testing both Python 2.7 and 3.6.
0.3.1 (2018-02-15)
migrate to github/TuneLab.
0.3.0 (2018-02-05)
Added safe_fraction.
Verbose exceptions handling.
More examples.
More tests.
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.3.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 926e4b9f1c2c4383e3d18ff526312d5a21f71c44c418be4859d462a8d06ba899 |
|
MD5 | 98940b7e529e6b14029ae0f6b3160e2a |
|
BLAKE2b-256 | dc86b0bc0ab177c325128a2b8719e02820103f7aae8be18ce40a80352f63f98d |