Metadata-Version: 2.0
Name: clr
Version: 1.0.3
Summary: 🌈 Terminal string styling
Home-page: https://github.com/lmittmann/clr
Author: lmittmann
Author-email: UNKNOWN
License: MIT
Keywords: clr,color,ansi,terminal styling,chalk
Platform: UNKNOWN

clr
===

|Build Status| |PyPI version|

**clr** is a simple terminal string styling library. Its API is a port of the popular
`chalk <https://github.com/chalk/chalk>`__ module for javascript.


Install
-------

::

    $ pip install clr


Usage
-----

.. code:: py

    import clr

    print(clr.red.bold('Hello world!'))


API
---

clr.\ ``style*[.style](*objects, sep=' ')``
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Chain `styles <#styles>`__ and call the last one as a method with an argument. Order doesn't matter, and later styles
take precedence in case of a conflict, e.g. ``clr.red.yellow.green`` is equivalent to ``clr.green``.

Multiple arguments will be separated by ``sep``, a space by default.


Styles
------

+---------------------+-------------------------------------+-------------------------------------------+
| Modifiers           | Colors                              | Background colors                         |
+=====================+===============+=====================+==================+========================+
| - ``bold``          | - ``black``   | - ``light_black``   | - ``on_black``   | - ``on_light_black``   |
| - ``dim``           | - ``red``     | - ``light_red``     | - ``on_red``     | - ``on_light_red``     |
| - ``italic``        | - ``green``   | - ``light_green``   | - ``on_green``   | - ``on_light_green``   |
| - ``underline``     | - ``yellow``  | - ``light_yellow``  | - ``on_yellow``  | - ``on_light_yellow``  |
| - ``inverse``       | - ``blue``    | - ``light_blue``    | - ``on_blue``    | - ``on_light_blue``    |
| - ``hidden``        | - ``magenta`` | - ``light_magenta`` | - ``on_magenta`` | - ``on_light_magenta`` |
| - ``strikethrough`` | - ``cyan``    | - ``light_cyan``    | - ``on_cyan``    | - ``on_light_cyan``    |
|                     | - ``white``   | - ``light_white``   | - ``on_white``   | - ``on_light_white``   |
+---------------------+---------------+---------------------+------------------+------------------------+


.. |Build Status| image:: https://travis-ci.org/lmittmann/clr.svg?branch=master
    :target: https://travis-ci.org/lmittmann/clr
.. |PyPI version| image:: https://img.shields.io/pypi/v/clr.svg
    :target: https://pypi.python.org/pypi/clr


