safe-cast 0.3.3

Safe casting of Python base types

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