Friendly Formatting

[dvf]

Firstly, this is a fantastic library.

I have a few questions relating to readability of the string output:

• Is it possible to print 1000000.00 USD as 1,000,000.00 USD? (humanize.intcomma module does this)
• Is there a way to print $1000.00 instead of 1000.00 USD?
• Is there a way to strip nanos if they're zeroes? 1000.00 USD -> 1000 USD?

[whiskeyriver]

@dvf

I just came across this library, and even though this question is old I'll answer this in case someone else stumbles across it.

Caveat: Below I give 2 ways to do this using only Python's stdlib. However the locale module is not threadsafe. If you deal with dynamic locales then check out Babel.

Formatting the Money using regular money format

Python's string formatting will handle number grouping:

value = Money("1234567.86", Currency.USD)
f"${value.amount:,}"

Output: '$1,234,567.86'

If you want to use a locale-aware separator just specify n instead of ,:

import locale

locale.setlocale(locale.LC_ALL, 'de_DE.UTF-8')

value = Money("1234567.86", Currency.EUR)
f"{value.amount:n} €"

Output: '1.234.567,86 €'

It's easier to read if you use the locale module's built-in currency handler:

locale.currency(value.amount, symbol=True, grouping=True)

Output: '1.234.567,86 €'

Truncate to an integer if modulo 1 == 0

I struggle to see the use case for this question.

Keep in mind that if you use the locale.currency method for formatting (or probably any currency helper) then you'd always get a decimal output. This means you would need to use string-formatting and handle locale specifics manually.

def maybe_truncate(value: Money) -> int | Decimal:
    if value % 1 == 0:
        return int(value)
    return value.as_decimal()

value = Money("1234567.86", Currency.USD)
f"${maybe_truncate(value):n}"
-> $1,234,567.86

value += 0.14
f"${maybe_truncate(value):n}"
-> $1,234,568