Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

Safe casting of Python base types

Project description

safe-cast

Safe casting of Python base types.

Badges

docs Documentation Status License Status
info Hit Count Contributors
tests Travis Code Coverage Status
package PyPI Package latest release Supported versions
other Requirements Status

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.4 (2018-04-20)

  • Update requirements.txt

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

This version
History Node

0.3.4

History Node

0.3.3

History Node

0.3.2

History Node

0.3.1

History Node

0.3.0

History Node

0.2.8

History Node

0.2.7

History Node

0.2.3

History Node

0.2.2

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
safe_cast-0.3.4-py3-none-any.whl (4.4 kB) Copy SHA256 hash SHA256 Wheel 3.6 Apr 20, 2018
safe-cast-0.3.4.tar.gz (6.2 kB) Copy SHA256 hash SHA256 Source None Apr 20, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page