z3c.form Support

This package also provides support for integration with the z3c.form package. In particular it implements a data converter from the Currency field to any widget accepting a unicode string.

>>> from z3c.currency import converter
>>> conv = converter.CurrencyConverter(price, None)
>>> conv
<DataConverter from Currency to NoneType>

The converter easily produces a string from any value:

>>> conv.toWidgetValue(decimal.Decimal(12))
'12'
>>> conv.toWidgetValue(decimal.Decimal(1200))
'1,200'
>>> conv.toWidgetValue(decimal.Decimal(-12))
'-12'
>>> conv.toWidgetValue(decimal.Decimal('-12.0'))
'-12.00'
>>> conv.toWidgetValue(decimal.Decimal('-12.00'))
'-12.00'

Note that always two decimal places are printed. You can also set the precision to DOLLARS:

>>> conv.field.precision = interfaces.DOLLARS

>>> conv.toWidgetValue(decimal.Decimal(12))
'12'
>>> conv.toWidgetValue(decimal.Decimal('12.00'))
'12'

Let’s try sub-cents as well:

>>> conv.field.precision = interfaces.SUBCENTS

>>> conv.toWidgetValue(decimal.Decimal('12.00'))
'12.00'
>>> conv.toWidgetValue(decimal.Decimal('12'))
'12'
>>> conv.toWidgetValue(decimal.Decimal('12.0001'))
'12.0001'

If the value is missing, then handle it gracefully.

>>> conv.toWidgetValue(None)
''

Let’s now parse a value. The parser is a little bit flexible, not only accepting the output values, …

>>> conv.field.precision = interfaces.CENTS
>>> conv.toFieldValue('12')
Decimal('12.00')
>>> conv.toFieldValue('1,200')
Decimal('1200.00')
>>> conv.toFieldValue('-12')
Decimal('-12.00')
>>> conv.toFieldValue('-12.00')
Decimal('-12.00')

>>> conv.field.precision = interfaces.DOLLARS
>>> conv.toFieldValue('12')
Decimal('12')
>>> conv.toFieldValue('12.00')
Decimal('12')

>>> conv.field.precision = interfaces.SUBCENTS
>>> conv.toFieldValue('12')
Decimal('12')
>>> conv.toFieldValue('12.00')
Decimal('12.00')
>>> conv.toFieldValue('12.0000')
Decimal('12.0000')
>>> conv.toFieldValue('12.0001')
Decimal('12.0001')

but also other input values:

>>> conv.toFieldValue('1200')
Decimal('1200')

If the browser sends an empty string, then handle it gracefully.

>>> conv.toFieldValue('')

2.0 (2023-02-08)

• Drop support for Python 2.7, 3.5, 3.6.

• Add support for Python 3.8, 3.9, 3.10, 3.11.

• Drop deprecated support for running the tests using python setup.py test.

1.2.0 (2018-11-14)

• Python 3.6 and 3.7 support. Drop Python 2.6.

• Tests now run with python setup.py test.

1.1.1 (2015-11-09)

• Standardize namespace __init__

1.1.0 (2013-09-27)

• Added new precision value “sub-cents” (interfaces.SUBCENTS), which allows precision beyond pennies, which is needed for financial and other business applications.

1.0.0 (2013-08-16)

• Updated Trove classifiers.

• Moved code to GitHub.

• Changed validation to raise custom validation errors, since the upstream code looks at the doc string of the exception instead of the first argument.

• Improved converter to

  • Ensure proper precision of decimal after initial parsing.

  • Format the value to the proper precision.

• Changed “precision” field in ICurrency interface to be a choice, so that UIs generate nicely.

• Cleaned up code a little bit.

0.1.0 (2007-09-12)

• Initial Release

  • Implementation of Currency field supporting precision and a unit.

  • Implementation of data converter.