Package gbp :: Module format

[hide private]
[frames] | no frames]

# Module format

Format a message

Functions | [hide private]

format_str(msg, args) Format a string with the given dict. |

Variables | [hide private]

| __package__ = ``'``gbp``'``

Function Details | [hide private]

### format_str(msg, args)

Format a string with the given dict. Be a bit more verbose than default python about the error cause.

    >>> format_str("%(foo)", {})
    Traceback (most recent call last):
    ...
    GbpError: Failed to format %(foo): Missing value 'foo' in {}
    >>> format_str("%(foo)", {'foo': 'bar'})
    Traceback (most recent call last):
    ...
    GbpError: Failed to format %(foo) with {'foo': 'bar'}: incomplete format
    >>> format_str("A %(foo)s is a %(bar)s", {'foo': 'dog', 'bar': 'mamal'})
    'A dog is a mamal'