More in-depth docs/API

[jkob]

Hi,

Been toying around with this project for a bit and it's been great. But I'm having trouble figuring out what goes where. For example:

• Where do I define the color to use (the pyfiglet class or the Figlet class?)

Very likely that I'm missing something obvious. But for me, the short "Quickstart" guide on how to use the package (by importing into code) is not very clear.
Maybe this is something that can be accomplished along with #74?

[pwaller]

Thanks for raising this. I agree it's not clear to a newcomer. Improvements welcomed. I don't have time to address the general complaint very well myself but I will review changes which improve the situation. The smaller the changes the better.

At the moment I'd recommend reading the source code if you want to know how it works and the API and have a need which isn't immediately addressed by just poking around. (e.g. search for "color" and look for relevant-looking code).

Addressing your colour question in particular:

pyfiglet/pyfiglet/__init__.py

Lines 69 to 78 in 81f30a5

	def print_figlet(text, font=DEFAULT_FONT, colors=":", **kwargs):
	ansiColors = parse_color(colors)
	if ansiColors:
	sys.stdout.write(ansiColors)
	print(figlet_format(text, font, **kwargs))
	if ansiColors:
	sys.stdout.write(RESET_COLORS.decode('UTF-8', 'replace'))
	sys.stdout.flush()

[pwaller]

Another request from #105, merging into this issue:

Are there any docs containing list of colors, fonts, and functions/classes as well as their args(that the user is supposed to use)?