tamcolors 1.3.0

about

This library standardizes console color output across multiple platforms. It also can get keyboard inputs without interrupting the console output and can run a console application at ~25 FPS.

pip install tamcolors

links

• github

• pypi

• read the docs

• youtube

• patreon

• facebook

table tennis example

import tamcolors
tamcolors.examples.tabletennis.run()

basic example

import tamcolors
tamcolors.examples.basic.run()

import tamcolors
from tamcolors.tam_io.tam_colors import *
tamcolors.printc("Hello", "World!", ("light blue", "white"), same_color=True)
name = tamcolors.inputc("Whats Your Name? >>> ", ("light aqua", "gray"))
tamcolors.clear()
tamcolors.printc("Hello, ", ("default", "default"), name, (GREEN, WHITE), "!", ("gray", "light aqua"), sep="")

icon example

import tamcolors
tamcolors.examples.icon.run()

from tamcolors import tam, tam_tools, tam_io


class BootLogo(tam.tam_loop.TAMFrame):
    def __init__(self):
        super().__init__(fps=10,
                         char=" ",
                         foreground_color=tam_io.tam_colors.GREEN,
                         background_color=tam_io.tam_colors.BLACK,
                         min_width=57, max_width=57, min_height=20, max_height=20)

        self.icon = tam_tools.tam_fade.tam_fade_in(surface=tam_tools.tam_icon.get_icon(),
                                                   char=" ",
                                                   foreground_color=tam_io.tam_colors.BLACK,
                                                   background_color=tam_io.tam_colors.BLACK)
        self.wait = 10

    def update(self, tam_loop, keys, loop_data, *args):

        if not self.icon.done():
            self.icon.slide()
        else:
            self.wait -= 1

        if self.wait == 0:
            tam_loop.done()

    def draw(self, tam_surface, loop_data, *args):
        tam_surface.clear()

        tam_surface.draw_onto(self.icon.peak(), 0, 0)


tam.tam_loop.TAMLoop(BootLogo()).run()

versions of Python currently supported

• 3.9

• 3.8

• 3.7

• 3.6

platforms tested on

• Windows 10

• Ubuntu 20.04

• macOS 10.15.5

goals

• add IO event bus

• support “get_keyboard_name” on macOS - Objective-C -> C++ -> Python

• support “key state mode” on macOS - Objective-C -> C++ -> Python

• add SHIFT KEY and other keys

long term goals

• build a community that builds fun terminal games

• make and change fonts at run time

• add .wav support

3.0.2 goals

• clean up code

• add more tests

• add wiki

3.0.1 goals

• make and change fonts at run time

• add SHIFT KEY and other keys

3.0.0 goals

• update tamtools

• add SPA, LAT, GER and FRE keyboard maps

• supports Python 3.9

• supports Python 3.8

• supports Python 3.7

• supports Python 3.6

2.1.0 goals

• update tamloop

• update tamframe

• add IO event bus

• supports Python 3.9

• supports Python 3.8

• supports Python 3.7

• supports Python 3.6

2.0.0 goals

• add .wav support

• add .wav tests

• supports Python 3.9

• supports Python 3.8

• supports Python 3.7

• supports Python 3.6

what defines a release?

• x.?.? - tamcolors has matured to a new level of capability.

• ?.x.? - Backwards compatibility was broken for most programs.

• ?.?.x - Most programs should still run in this release.

• All releases can have new features, bug fixes, depreciation and new tests.

versions

1.3.0

• 2/5/2021

• fixed exit clear

• added wait_key

• added frame_done

• added multi console example

• added key state keyboard mode Only for Windows

• made tam_loop multi console friendly

• renamed items from buffer to surface

• updated tamcolors icon

• supports GER_GERMAN, FRE_FRENCH, SPA_SPANISH, LAT_SPANISH, … Keyboards - Only for Windows and Linux

• supports Python 3.9

• supports Python 3.8

• supports Python 3.7

• supports Python 3.6

1.2.0

• 11/3/2020

• added tam_loop profiler

• added TCP IO (dummy console)

• save/rest Windows buffer size on exit

• cleaned up c/c++

• added sandy check examples

• added new color mode “MODE_16_PAL_256”

• added “preferred_mode”argument to TAMLoop

• cleaned up win dll selection process

• added .ci testing

• supports Python 3.9

• supports Python 3.8

• supports Python 3.7

• supports Python 3.6

1.1.1

• 10/10/2020

• added tam utils

• added compress utils module

• added encryption utils module

• added identifier utils module

• added log utils module

• added transport optimizer utils module

• added immutable cache utils module

• added slow tests

• added tcp utils module

• fixed macOS terminal cursor

• fixed windows missing dll

• added dependencies licences

• supports Python 3.9

• supports Python 3.8

• supports Python 3.7

• supports Python 3.6

1.1.0

• 9/7/2020

• fixed macOS!

• broke up IO into drivers

• added terminal identifier

• added 256 color mode

• added rgb color mode

• added RGBA

• added Color

• supports Python 3.8

• supports Python 3.7

• supports Python 3.6

1.0.4

• 8/13/2020

• added more examples

• bdist_wheel for Linux

• cleaned up win_tam, uni_tam and any_tam

• added alpha color for TAMBuffer

• set and get rgb value of color (fixed PowerShell colors)

• supports Python 3.8

• supports Python 3.7

• supports Python 3.6

• dropped support for Python 3.5

1.0.3

• 7/29/2020

• tamcolors

• bdist_wheel for macOS

• added more examples

• added documentation

• added tests for tam_basic

• added default console colors

• supports Python 3.8

• supports Python 3.7

• supports Python 3.6

• supports Python 3.5

1.0.2

• 7/22/2020

• tamcolors is now very usable

• bdist_wheel for Windows

• added non interrupting keyboard input

• added TAMLoop

• added tam_tools

• added tests

• supports Python 3.8

• supports Python 3.7

• supports Python 3.6

• supports Python 3.5

0.2.0

• 2/1/2018

• tamcolors proof of concept

• added printc

• added inputc

• added textBuffer

• supports Python 3.6