.. |logo| image:: https://beeware.org/static/images/defaultlogo.png :width: 72px :target: https://beeware.org

.. |pyversions| image:: https://img.shields.io/pypi/pyversions/travertino.svg :target: https://pypi.python.org/pypi/travertino :alt: Python Versions

.. |version| image:: https://img.shields.io/pypi/v/travertino.svg :target: https://pypi.python.org/pypi/travertino :alt: Project version

.. |maturity| image:: https://img.shields.io/pypi/status/travertino.svg :target: https://pypi.python.org/pypi/travertino :alt: Project status

.. |license| image:: https://img.shields.io/pypi/l/travertino.svg :target: https://github.com/beeware/travertino/blob/main/LICENSE :alt: BSD License

.. |ci| image:: https://github.com/beeware/travertino/workflows/CI/badge.svg?branch=main :target: https://github.com/beeware/travertino/actions :alt: Build Status

.. |social| image:: https://img.shields.io/discord/836455665257021440?label=Discord%20Chat&logo=discord&style=plastic :target: https://beeware.org/bee/chat/ :alt: Discord server

|logo|

Travertino

|pyversions| |version| |maturity| |license| |ci| |social|

Travertino is a set of constants and utilities for describing user interfaces, including:

• colors
• directions
• text alignment
• sizes

Usage

Install Travertino:

$ pip install travertino

Then in your python code, import and use it::

>>> from travertino.colors import color, rgb,

# Define a new color as an RGB triple
>>> red = rgb(0xff, 0x00, 0x00)

# Parse a color from a string
>>> color('#dead00')
rgb(0xde, 0xad, 0x00)

# Reference a pre-defined color
>>> color('RebeccaPurple')
rgb(102, 51, 153)

Community

Travertino is part of the BeeWare suite_. You can talk to the community through:

• @[email protected] on Mastodon <https://fosstodon.org/@beeware>__

• Discord <https://beeware.org/bee/chat/>__

We foster a welcoming and respectful community as described in our BeeWare Community Code of Conduct_.

Contributing

If you experience problems with Travertino, log them on GitHub. If you want to contribute code, please fork the code and submit a pull request_.

Travertino uses Pre-commit <https://pre-commit.com/>__ and TownCrier <https://pypi.org/project/towncrier/>__ to help maintain code quality. For details on how to use these tools as part of your development environment, see the Briefcase code contribution guide <https://briefcase.readthedocs.io/en/stable/how-to/contribute-code.html>__. Although that document is for a different project, the details about setting up your development environment are the same.

.. _BeeWare suite: https://beeware.org .. _Read The Docs: https://travertino.readthedocs.io .. _BeeWare Community Code of Conduct: https://beeware.org/community/behavior/ .. _log them on Github: https://github.com/beeware/travertino/issues .. _fork the code: https://github.com/beeware/travertino .. _submit a pull request: https://github.com/beeware/travertino/pulls