Skip to main content

Colored text output in Python using ANSI escape sequences.

Project description


styled-str is a package for creating strings styled with ANSI escape sequences. The motivation for writing this package was that many existing string-styling modules do not implement logical string behavior, like properly formatting the string, indexing, containment, all of which are useless if they don't ignore the styling.

The Styled object ignores styling and acts on just its content for the following operations:

For an example Styled s = Styled('Hello!', fg='red', style='italic')

  • length, e.g. len(s) => 6
  • formatting, e.g. f'{s:.3}' => 'Hel'
  • indexing, e.g. s[1] => 'e'
  • iteration, e.g. for c in s: => H, e, l, l, o, !
  • reversed, e.g. for c in reversed(s): => !, o, l, l, e, H
  • containment, e.g. only characters of "Hello!" are True for c in s

We would like to have a strings with the same content viewed as distinct though, and so Styled includes styling for the following operations:

For example Styled a = Styled('Hello!', fg='red'); b = Styled('Hello!', bg='blue')

  • equality, e.g. a == b => False
  • comparison, e.g. a < b => True


Install using pip (Python3):

pip3 install styled-str


Import the module and create a string with your desired styles:

from styledstr import Styled

s = Styled('Hello World!', fg='cyan', bg='white', style=['bold', 'underlined'])

# Print it out

# Use it in a larger string
print("He said, '" + str(s) + "'")

# Format it worry-free!
print(f'Title: {s:>20}')


In the following examples, variables prefixed with styled refer to Styled strings, while variables prefixed with regular refer to standard Python strings.

The following builtin functions all work as they normally would on only the underlying string contents:

  • repr(styled)

  • int(styled)

  • float(styled)

  • complex(styled)

  • hash(styled)

  • str(styled) returns a Python string that includes escape sequences for the specified formatting.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for styled-str, version 0.1.0
Filename, size File type Python version Upload date Hashes
Filename, size styled_str-0.1.0-py3-none-any.whl (6.1 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size styled-str-0.1.0.tar.gz (5.5 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page