skip to navigation
skip to content

safe-cast 0.2.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.

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.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
 
File Type Py Version Uploaded on Size
safe-cast-0.2.3.tar.gz (md5) Source 2017-12-10 8KB
safe_cast-0.2.3-py3-none-any.whl (md5) Python Wheel 3.6 2017-12-10 6KB
safe_cast-0.2.3-py3.6.egg (md5) Python Egg 3.6 2017-12-10 5KB