say 1.0.5

Super-simple templated printing. E.g.: say("Hello, {whoever}!", indent=1)

print, format, and %, evolved.

Q: It’s been forty years since C introduced printf() and the basic formatted printing of positional parameters. Isn’t it time for an upgrade?

A: Yes! ZOMG, yes!

say supplements or replaces Python’s print statement/function, format function/method, and % string interpolation operator with simpler, higher-level facilities. For example:

from say import say

x = 12
nums = list(range(4))

say("There are {x} things.")
say("Nums has {len(nums)} items: {nums}")

yields:

There are 12 things.
Nums has 4 items: [0, 1, 2, 3]

At this level, say is basically a simpler, nicer recasting of:

from __future__ import print_function

print("There are {0} things.".format(x))
print("Nums has {0} items: {1}".format(len(nums), nums))

The more items being printed, and the more complicated the format invocation, the more valuable this simple inline specification becomes.

Beyond DRY, Pythonic templates that piggyback the Python’s well-proven format() method, syntax, and underlying engine, say’s virtues include:

• A single output mechanism identical and compatible across Python 2.x and Python 3.x.

• A companion fmt() object for string formatting.

• Higher-order line formatting such as indentation and wrapping built in.

• Convenient methods for common formatting items such as titles, horizontal separators, and vertical whitespace.

• Super-duper template/text aggregator objects for easily building, reading, and writing multi-line texts.

Take it for a test drive today! See also the full documentation at Read the Docs.